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 colors;
49pub mod commands;
50pub mod database;
51pub mod error;
52pub mod integrations;
53pub mod mcp;
54pub mod models;
55pub mod providers;
56pub mod storage;
57pub mod tui;
58pub mod workspace;
59
60// Re-export commonly used items
61pub use cli::{
62    Cli, Commands, ExportCommands, FetchCommands, FindCommands, GitCommands, ImportCommands,
63    ListCommands, MergeCommands, MigrationCommands, MoveCommands, ProviderCommands, RunCommands,
64    ShowCommands,
65};
66pub use colors::{line, separator, Status, StyledText};
67pub use database::{ChatDatabase, ShareLinkInfo, ShareLinkParser, ShareLinkProvider};
68pub use error::CsmError;
69pub use models::{
70    ChatMessage, ChatRequest, ChatSession, ChatSessionIndex, ChatSessionIndexEntry,
71    SessionWithPath, Workspace, WorkspaceJson,
72};
73pub use providers::{
74    CsmConfig, GenericMessage, GenericSession, ProviderConfig, ProviderRegistry, ProviderType,
75};
76pub use storage::{
77    add_session_to_index, backup_workspace_sessions, is_vscode_running, read_chat_session_index,
78    register_all_sessions_from_directory, write_chat_session_index,
79};
80pub use workspace::{
81    decode_workspace_folder, discover_workspaces, find_workspace_by_path,
82    get_chat_sessions_from_workspace, get_workspace_by_hash, get_workspace_by_path,
83    get_workspace_storage_path, normalize_path,
84};