chasm_cli/lib.rs
1// Copyright (c) 2024-2026 Nervosys LLC
2// SPDX-License-Identifier: Apache-2.0
3//! Chat System Manager (CSM) - Library
4//!
5//! A library for managing and merging chat sessions across workspaces and LLM providers.
6//!
7//! ## Supported Providers
8//!
9//! - **VS Code Copilot Chat** - Default, file-based sessions
10//! - **Cursor** - Cursor IDE chat sessions
11//! - **Ollama** - Local LLM inference
12//! - **vLLM** - High-performance LLM serving
13//! - **Azure AI Foundry** - Microsoft's AI platform (Foundry Local)
14//! - **LM Studio** - Local model runner
15//! - **LocalAI** - Drop-in OpenAI replacement
16//! - **Text Generation WebUI** - oobabooga's web interface
17//! - **Jan.ai** - Open source ChatGPT alternative
18//! - **GPT4All** - Local privacy-focused AI
19//! - **Llamafile** - Portable executable LLMs
20//!
21//! ## Agent Development Kit (Agency)
22//!
23//! The `Agency` module provides a Rust-native framework for building AI agents:
24//!
25//! ```rust,ignore
26//! use csm::Agency::{Agent, AgentBuilder, Runtime, Tool};
27//!
28//! let agent = AgentBuilder::new("assistant")
29//! .instruction("You are a helpful assistant.")
30//! .model("gemini-2.5-flash")
31//! .tool(Tool::web_search())
32//! .build();
33//!
34//! let runtime = Runtime::new()?;
35//! runtime.register_agent(agent);
36//! let result = runtime.run("assistant", "Hello!").await?;
37//! ```
38
39// Library modules export public APIs for external use - suppress dead_code warnings
40#![allow(dead_code)]
41#![allow(unused_imports)]
42
43pub mod agency;
44pub mod browser;
45pub mod cli;
46pub mod commands;
47pub mod database;
48pub mod error;
49pub mod integrations;
50pub mod mcp;
51pub mod models;
52pub mod providers;
53pub mod storage;
54pub mod tui;
55pub mod workspace;
56
57// Re-export commonly used items
58pub use cli::{
59 Cli, Commands, ExportCommands, FetchCommands, FindCommands, GitCommands, ImportCommands,
60 ListCommands, MergeCommands, MigrationCommands, MoveCommands, ProviderCommands, RunCommands,
61 ShowCommands,
62};
63pub use database::{ChatDatabase, ShareLinkInfo, ShareLinkParser, ShareLinkProvider};
64pub use error::CsmError;
65pub use models::{
66 ChatMessage, ChatRequest, ChatSession, ChatSessionIndex, ChatSessionIndexEntry,
67 SessionWithPath, Workspace, WorkspaceJson,
68};
69pub use providers::{
70 CsmConfig, GenericMessage, GenericSession, ProviderConfig, ProviderRegistry, ProviderType,
71};
72pub use storage::{
73 add_session_to_index, backup_workspace_sessions, is_vscode_running, read_chat_session_index,
74 register_all_sessions_from_directory, write_chat_session_index,
75};
76pub use workspace::{
77 decode_workspace_folder, discover_workspaces, find_workspace_by_path,
78 get_chat_sessions_from_workspace, get_workspace_by_hash, get_workspace_by_path,
79 get_workspace_storage_path, normalize_path,
80};