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#![allow(clippy::upper_case_acronyms)] // LLM, VLM, etc. are standard AI terminology
43#![allow(clippy::type_complexity)] // Complex types in auth are necessary for the API
44
45pub mod agency;
46pub mod browser;
47pub mod cli;
48pub mod commands;
49pub mod database;
50pub mod error;
51pub mod integrations;
52pub mod mcp;
53pub mod models;
54pub mod providers;
55pub mod storage;
56pub mod tui;
57pub mod workspace;
58
59// Re-export commonly used items
60pub use cli::{
61    Cli, Commands, ExportCommands, FetchCommands, FindCommands, GitCommands, ImportCommands,
62    ListCommands, MergeCommands, MigrationCommands, MoveCommands, ProviderCommands, RunCommands,
63    ShowCommands,
64};
65pub use database::{ChatDatabase, ShareLinkInfo, ShareLinkParser, ShareLinkProvider};
66pub use error::CsmError;
67pub use models::{
68    ChatMessage, ChatRequest, ChatSession, ChatSessionIndex, ChatSessionIndexEntry,
69    SessionWithPath, Workspace, WorkspaceJson,
70};
71pub use providers::{
72    CsmConfig, GenericMessage, GenericSession, ProviderConfig, ProviderRegistry, ProviderType,
73};
74pub use storage::{
75    add_session_to_index, backup_workspace_sessions, is_vscode_running, read_chat_session_index,
76    register_all_sessions_from_directory, write_chat_session_index,
77};
78pub use workspace::{
79    decode_workspace_folder, discover_workspaces, find_workspace_by_path,
80    get_chat_sessions_from_workspace, get_workspace_by_hash, get_workspace_by_path,
81    get_workspace_storage_path, normalize_path,
82};
83