lingshu-sdk-core 0.10.0

Stable facade for Lingshu agent runtime — used by Rust, Python, and Node.js SDKs
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

#![allow(clippy::result_large_err)]

//! # lingshu-sdk-core
//!
//! Stable facade between the Lingshu agent runtime and language-specific SDKs.
//!
//! This crate provides a **semver-stable** API surface that wraps the internal
//! `lingshu-core`, `lingshu-tools`, and `lingshu-state` crates. All foreign
//! bindings (PyO3, napi-rs) depend on this crate rather than on internals directly,
//! so internal refactors do not break downstream SDKs.
//!
//! # Quick Start (Rust)
//!
//! ```rust,no_run
//! use lingshu_sdk_core::{SdkAgent, SdkConfig, SdkError};
//!
//! # async fn example() -> Result<(), SdkError> {
//! let agent = SdkAgent::new("anthropic/claude-sonnet-4")?;
//! let reply = agent.chat("What is Lingshu?").await?;
//! println!("{reply}");
//! # Ok(())
//! # }
//! ```

pub mod agent;
pub mod config;
pub mod convert;
pub mod error;
pub mod memory;
pub mod session;
pub mod tools;
pub mod types;

// ── Re-exports (public SDK surface) ──────────────────────────────────

pub use agent::SdkAgent;
pub use agent::SdkAgentBuilder;
pub use agent::SessionExport;
pub use config::SdkConfig;
pub use error::SdkError;
pub use memory::MemoryManager;
pub use session::SdkSession;
pub use tools::SdkToolRegistry;

// Re-export core types that are part of the public API
pub use lingshu_core::agent::{
    AgentBuilder, ApprovalChoice, ConversationResult, IsolatedAgentOptions, SessionSnapshot,
    StreamEvent,
};
pub use lingshu_types::{
    AgentError, Content, ContentPart, Cost, Message, OriginChat, Platform, Role, ToolCall,
    ToolError, ToolErrorRecord, ToolSchema, Usage,
};

// Re-export session types
pub use lingshu_state::{SessionRecord, SessionSearchHit, SessionStats, SessionSummary};

// Re-export profile/home directory utilities
pub use lingshu_core::config::{lingshu_home, ensure_lingshu_home};

// Re-export tool handler trait and context for custom tools
pub use lingshu_tools::registry::{ToolContext, ToolHandler};

// Re-export the provider factory for advanced usage
pub use lingshu_tools::create_provider_for_model;