@axiom-lattice/core 2.1.15 → 2.1.17

package/dist/index.d.mts

@@ -5,7 +5,7 @@ import { BaseChatModel, BaseChatModelCallOptions } from '@langchain/core/languag
 import { BaseLanguageModelInput } from '@langchain/core/language_models/base';
 import { CallbackManagerForLLMRun } from '@langchain/core/callbacks/manager';
 import { ChatResult } from '@langchain/core/outputs';
-import { LLMConfig, ToolConfig, ToolExecutor, AgentConfig, GraphBuildOptions, MessageChunk, QueueLatticeProtocol, QueueConfig, QueueClient, QueueResult, ScheduleLatticeProtocol, ScheduleConfig, ScheduleClient, ScheduleStorage, TaskHandler, ScheduleOnceOptions, ScheduleCronOptions, ScheduledTaskDefinition, ScheduledTaskStatus, ScheduleExecutionType, ThreadStore, AssistantStore, Thread, CreateThreadRequest, Assistant, CreateAssistantRequest, LoggerLatticeProtocol, LoggerConfig, LoggerClient, LoggerContext } from '@axiom-lattice/protocols';
+import { LLMConfig, ToolConfig, ToolExecutor, AgentConfig, GraphBuildOptions, MessageChunk, QueueLatticeProtocol, QueueConfig, QueueClient, QueueResult, ScheduleLatticeProtocol, ScheduleConfig, ScheduleClient, ScheduleStorage, TaskHandler, ScheduleOnceOptions, ScheduleCronOptions, ScheduledTaskDefinition, ScheduledTaskStatus, ScheduleExecutionType, ThreadStore, AssistantStore, SkillStore, Thread, CreateThreadRequest, Assistant, CreateAssistantRequest, Skill, CreateSkillRequest, LoggerLatticeProtocol, LoggerConfig, LoggerClient, LoggerContext, SkillConfig, SkillClient, ConnectedSandboxConfig } from '@axiom-lattice/protocols';
 import * as protocols from '@axiom-lattice/protocols';
 export { protocols as Protocols };
 export { AgentConfig, AgentType, GraphBuildOptions, MemoryType } from '@axiom-lattice/protocols';
@@ -17,6 +17,8 @@ import { BaseCheckpointSaver } from '@langchain/langgraph-checkpoint';
 import { ReplaySubject } from 'rxjs';
 import { Embeddings } from '@langchain/core/embeddings';
 import { VectorStore } from '@langchain/core/vectorstores';
+import { Connection, MultiServerMCPClient } from '@langchain/mcp-adapters';
+import { SandboxClient } from '@agent-infra/sandbox';
 
 /**
  * BaseLatticeManager - 抽象基类，为各种Lattice管理器提供通用功能
@@ -440,6 +442,12 @@ declare class ToolLatticeManager extends BaseLatticeManager<ToolLattice> {
      * 获取所有工具定义
      */
     getAllToolDefinitions(): ToolDefinition[];
+    /**
+     * 注册已有的StructuredTool到Lattice
+     * @param key Lattice键名
+     * @param tool 已有的StructuredTool实例
+     */
+    registerExistingTool(key: string, tool: StructuredTool): void;
     /**
      * 验证工具输入参数
      * @param key Lattice键名
@@ -449,6 +457,7 @@ declare class ToolLatticeManager extends BaseLatticeManager<ToolLattice> {
 }
 declare const toolLatticeManager: ToolLatticeManager;
 declare const registerToolLattice: (key: string, config: ToolConfig, executor: ToolExecutor) => void;
+declare const registerExistingTool: (key: string, tool: StructuredTool) => void;
 declare const getToolLattice: (key: string) => ToolLattice | undefined;
 declare const getToolDefinition: (key: string) => ToolConfig;
 declare const getToolClient: (key: string) => StructuredTool<_langchain_core_tools.ToolSchemaBase, any, any, any>;
@@ -1179,6 +1188,7 @@ declare function describeCronExpression(expression: string): string;
 type StoreTypeMap = {
     thread: ThreadStore;
     assistant: AssistantStore;
+    skill: SkillStore;
 };
 /**
  * Store type keys
@@ -1361,6 +1371,99 @@ declare class InMemoryAssistantStore implements AssistantStore {
     clear(): void;
 }
 
+/**
+ * FileSystemSkillStore
+ *
+ * Filesystem-based implementation of SkillStore
+ * Stores each skill as a Markdown file with YAML frontmatter
+ */
+
+/**
+ * FileSystemSkillStore options
+ */
+interface FileSystemSkillStoreOptions {
+    /**
+     * Root directory path for storing skills
+     * Can be absolute or relative path (relative to current working directory)
+     * @default "lattice_store/skills"
+     */
+    rootDir?: string;
+}
+/**
+ * Filesystem-based implementation of SkillStore
+ */
+declare class FileSystemSkillStore implements SkillStore {
+    private rootDir;
+    constructor(options?: FileSystemSkillStoreOptions);
+    /**
+     * Ensure the root directory exists
+     */
+    private ensureDirectoryExists;
+    /**
+     * Get directory path for a skill name
+     * Name is used as the directory name, and SKILL.md is the fixed filename
+     */
+    private getSkillDirectoryPath;
+    /**
+     * Get file path for a skill name
+     * File is always named SKILL.md inside the name directory
+     */
+    private getSkillFilePath;
+    /**
+     * Read skill from file
+     * Uses name as the directory name and reads SKILL.md from it
+     */
+    private readSkillFile;
+    /**
+     * Write skill to file
+     * Creates directory with name and writes SKILL.md inside it
+     */
+    private writeSkillFile;
+    /**
+     * Get all skills
+     */
+    getAllSkills(): Promise<Skill[]>;
+    /**
+     * Get skill by ID
+     * ID should equal name (name is used for path addressing)
+     */
+    getSkillById(id: string): Promise<Skill | null>;
+    /**
+     * Create a new skill
+     * id should equal name (name is used for path addressing)
+     */
+    createSkill(id: string, data: CreateSkillRequest): Promise<Skill>;
+    /**
+     * Update an existing skill
+     */
+    updateSkill(id: string, updates: Partial<CreateSkillRequest>): Promise<Skill | null>;
+    /**
+     * Delete a skill by ID
+     * Deletes the entire directory (name is the directory name)
+     */
+    deleteSkill(id: string): Promise<boolean>;
+    /**
+     * Check if skill exists
+     */
+    hasSkill(id: string): Promise<boolean>;
+    /**
+     * Search skills by metadata
+     */
+    searchByMetadata(metadataKey: string, metadataValue: string): Promise<Skill[]>;
+    /**
+     * Filter skills by compatibility
+     */
+    filterByCompatibility(compatibility: string): Promise<Skill[]>;
+    /**
+     * Filter skills by license
+     */
+    filterByLicense(license: string): Promise<Skill[]>;
+    /**
+     * Get sub-skills of a parent skill
+     */
+    getSubSkills(parentSkillName: string): Promise<Skill[]>;
+}
+
 /**
  * Embeddings Lattice Interface
  * Defines the structure of an embeddings lattice entry
@@ -1629,6 +1732,306 @@ declare class ConsoleLoggerClient implements LoggerClient {
     child(options: Partial<LoggerConfig>): LoggerClient;
 }
 
+/**
+ * SkillLatticeManager
+ *
+ * Skill Lattice manager for registering and managing skill components
+ */
+
+/**
+ * Skill Lattice interface
+ */
+interface SkillLattice {
+    key: string;
+    config: SkillConfig;
+    client: SkillClient | null;
+}
+/**
+ * SkillLatticeManager - Singleton skill Lattice manager
+ * Responsible for registering and managing various skill Lattices
+ */
+declare class SkillLatticeManager extends BaseLatticeManager<SkillLattice> {
+    private static _instance;
+    private storeKey?;
+    /**
+     * Get SkillLatticeManager singleton instance
+     */
+    static getInstance(): SkillLatticeManager;
+    /**
+     * Get Lattice type prefix
+     */
+    protected getLatticeType(): string;
+    /**
+     * Configure store for persistence
+     * @param storeKey Store key name registered in StoreLatticeManager
+     */
+    configureStore(storeKey: string): void;
+    /**
+     * Get configured store
+     * @returns SkillStore instance if configured, null otherwise
+     */
+    private getStore;
+    /**
+     * Inject store into client if client supports it
+     * @param client Skill client instance
+     * @param store Store instance to inject
+     */
+    private injectStoreIntoClient;
+    /**
+     * Register a skill Lattice
+     * @param key Lattice key name
+     * @param config Skill configuration
+     * @param client Optional skill client implementation
+     */
+    registerLattice(key: string, config: SkillConfig, client?: SkillClient): Promise<void>;
+    /**
+     * Get skill Lattice by key
+     * @param key Lattice key name
+     */
+    getSkillLattice(key: string): SkillLattice | undefined;
+    /**
+     * Get all skill Lattices from store
+     * Always reads from the configured store and merges with in-memory clients
+     */
+    getAllLattices(): Promise<SkillLattice[]>;
+    /**
+     * Check if Lattice exists
+     * @param key Lattice key name
+     */
+    hasLattice(key: string): boolean;
+    /**
+     * Remove Lattice
+     * @param key Lattice key name
+     */
+    removeLattice(key: string): Promise<boolean>;
+    /**
+     * Clear all Lattices
+     */
+    clearLattices(): void;
+    /**
+     * Get Lattice count
+     */
+    getLatticeCount(): number;
+    /**
+     * Get Lattice key name list
+     */
+    getLatticeKeys(): string[];
+    /**
+     * Get skill configuration
+     * @param key Lattice key name
+     */
+    getSkillConfig(key: string): SkillConfig;
+    /**
+     * Get skill client
+     * Ensures client has store access if store is configured
+     * @param key Lattice key name
+     */
+    getSkillClient(key: string): SkillClient | null;
+    /**
+     * Get all skill configurations from store
+     * Always reads from the configured store, not from memory
+     */
+    getAllSkillConfigs(): Promise<SkillConfig[]>;
+    /**
+     * Search skills by metadata
+     * @param metadataKey Metadata key to search for
+     * @param metadataValue Metadata value to match
+     */
+    searchByMetadata(metadataKey: string, metadataValue: string): Promise<SkillLattice[]>;
+    /**
+     * Filter skills by compatibility
+     * @param compatibility Compatibility string to filter by
+     */
+    filterByCompatibility(compatibility: string): Promise<SkillLattice[]>;
+    /**
+     * Filter skills by license
+     * @param license License string to filter by
+     */
+    filterByLicense(license: string): Promise<SkillLattice[]>;
+    /**
+     * Load skills from configured store
+     * This method loads all skills from the store and registers them in memory
+     */
+    loadFromStore(): Promise<void>;
+    /**
+     * Update skill in store
+     * @param key Skill key
+     * @param updates Partial skill data to update
+     */
+    updateSkillInStore(key: string, updates: Partial<SkillConfig>): Promise<void>;
+}
+declare const skillLatticeManager: SkillLatticeManager;
+
+/**
+ * Skill name validator
+ * Validates skill names according to the specification:
+ * - 1-64 characters
+ * - Lowercase alphanumeric with single hyphen separators
+ * - Not start or end with -
+ * - Not contain consecutive --
+ * - Match the directory name that contains SKILL.md
+ * - Regex: ^[a-z0-9]+(-[a-z0-9]+)*$
+ */
+/**
+ * Validate skill name
+ * @param name Skill name to validate
+ * @returns true if valid, false otherwise
+ */
+declare function isValidSkillName(name: string): boolean;
+/**
+ * Validate skill name and throw error if invalid
+ * @param name Skill name to validate
+ * @throws Error if name is invalid
+ */
+declare function validateSkillName(name: string): void;
+
+/**
+ * McpLatticeManager
+ *
+ * MCP Lattice Manager - Manages MCP client connections using MultiServerMCPClient
+ * Follows the singleton pattern for global access
+ */
+
+interface McpServerInfo {
+    name: string;
+    connection: Connection;
+}
+interface McpLatticeInterface {
+    client: MultiServerMCPClient;
+    servers: Map<string, McpServerInfo>;
+}
+declare class McpLatticeManager extends BaseLatticeManager<McpLatticeInterface> {
+    private static _instance;
+    private client;
+    private servers;
+    static getInstance(): McpLatticeManager;
+    protected getLatticeType(): string;
+    registerServers(servers: McpServerInfo[]): void;
+    addServer(name: string, connection: Connection): void;
+    removeServer(name: string): boolean;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+    getAllTools(): Promise<any[]>;
+    getServerNames(): string[];
+    hasServer(name: string): boolean;
+    /**
+     * 将 MCP 工具注册到 Tool Lattice
+     * @param prefix 工具键名前缀，用于区分不同服务器的工具
+     */
+    registerToolsToToolLattice(prefix?: string): Promise<void>;
+}
+declare const mcpManager: McpLatticeManager;
+
+interface SandboxManagerProtocol {
+    createSandbox(sandboxName: string): Promise<SandboxClient>;
+    deleteSandbox(sandboxName: string): Promise<void>;
+    getSandbox(sandboxName: string): Promise<SandboxClient>;
+    listSandboxes(): Promise<SandboxClient[]>;
+    getSandboxStatus(sandboxName: string): Promise<string>;
+    getSandboxFromConfig(config: RunSandboxConfig): Promise<SandboxClient>;
+}
+interface RunSandboxConfig {
+    assistant_id: string;
+    sandboxConfig: ConnectedSandboxConfig;
+    thread_id: string;
+}
+
+/**
+ * SandboxLatticeManager
+ *
+ * Sandbox Lattice manager for registering and managing sandbox services
+ * Supports creating, deleting, and managing sandbox instances
+ */
+
+/**
+ * SandboxLatticeManager - Singleton sandbox Lattice manager
+ * Responsible for registering and managing various sandbox service Lattices
+ */
+declare class SandboxLatticeManager extends BaseLatticeManager<SandboxManagerProtocol> {
+    private static _instance;
+    /**
+     * Get SandboxLatticeManager singleton instance
+     */
+    static getInstance(): SandboxLatticeManager;
+    /**
+     * Get Lattice type prefix
+     */
+    protected getLatticeType(): string;
+    /**
+     * Register sandbox Lattice
+     * @param key Lattice key name
+     * @param manager Optional sandbox manager. If not provided, will create a default one.
+     * @param baseURL Base URL for sandbox service (used when creating default manager)
+     */
+    registerLattice(key: string, config: {
+        manager?: SandboxManagerProtocol;
+        baseURL?: string;
+    }): void;
+    /**
+     * Get SandboxLattice
+     * @param key Lattice key name
+     */
+    getSandboxLattice(key: string): SandboxManagerProtocol;
+    /**
+     * Get all Lattices
+     */
+    getAllLattices(): SandboxManagerProtocol[];
+    /**
+     * Check if Lattice exists
+     * @param key Lattice key name
+     */
+    hasLattice(key: string): boolean;
+    /**
+     * Remove Lattice
+     * @param key Lattice key name
+     */
+    removeLattice(key: string): boolean;
+    /**
+     * Clear all Lattices
+     */
+    clearLattices(): void;
+    /**
+     * Get Lattice count
+     */
+    getLatticeCount(): number;
+    /**
+     * Get Lattice key list
+     */
+    getLatticeKeys(): string[];
+}
+declare const sandboxLatticeManager: SandboxLatticeManager;
+declare const getSandBoxManager: (key?: string) => SandboxManagerProtocol;
+
+/**
+ * Sandbox name normalization utility
+ *
+ * Normalizes sandbox names to comply with RFC 1123 subdomain naming requirements:
+ * - Only lowercase alphanumeric characters, '-' or '.'
+ * - Must start and end with an alphanumeric character
+ * - No underscores or other special characters
+ */
+/**
+ * Normalize a sandbox name to be RFC 1123 compliant
+ *
+ * @param name - The sandbox name to normalize
+ * @returns Normalized sandbox name that complies with RFC 1123 subdomain rules
+ *
+ * @example
+ * normalizeSandboxName("sandbox_agent") // returns "sandbox-agent"
+ * normalizeSandboxName("My-Sandbox") // returns "my-sandbox"
+ * normalizeSandboxName("test.sandbox") // returns "test.sandbox"
+ * normalizeSandboxName("_invalid_") // returns "invalid"
+ */
+declare function normalizeSandboxName(name: string): string;
+/**
+ * Validate if a sandbox name is RFC 1123 compliant
+ *
+ * @param name - The sandbox name to validate
+ * @returns true if the name is valid, false otherwise
+ */
+declare function isValidSandboxName(name: string): boolean;
+
 /**
  * Event bus service
  * Used for event publishing and subscription between internal system components
@@ -1686,4 +2089,4 @@ declare class AgentManager {
 
 declare const AGENT_TASK_EVENT = "agent:execute";
 
-export { AGENT_TASK_EVENT, type AgentClient, type AgentLattice, AgentLatticeManager, AgentManager, type BufferStats, type Chunk, ChunkBuffer, ChunkBufferLatticeManager, type ColumnInfo, ConsoleLoggerClient, type CronFields, type DatabaseConfig, type DatabaseType, DefaultScheduleClient, type EmbeddingsLatticeInterface, EmbeddingsLatticeManager, type ISqlDatabase, InMemoryAssistantStore, InMemoryChunkBuffer, InMemoryThreadStore, type LoggerLattice, LoggerLatticeManager, MemoryLatticeManager, MemoryQueueClient, MemoryScheduleStorage, type ModelConfig, type ModelLatticeInterface, ModelLatticeManager, PinoLoggerClient, PostgresDatabase, type QueryResult, type QueueLattice, QueueLatticeManager, type ScheduleLattice, ScheduleLatticeManager, SqlDatabaseManager, type StoreLattice, StoreLatticeManager, type StoreType, type StoreTypeMap, type TableInfo, type TableSchema, type ThreadBuffer, type ThreadBufferConfig, ThreadStatus, type ToolDefinition, type ToolLattice, ToolLatticeManager, type VectorStoreLatticeInterface, VectorStoreLatticeManager, agentLatticeManager, describeCronExpression, embeddingsLatticeManager, eventBus, eventBus as eventBusDefault, getAgentClient, getAgentConfig, getAgentLattice, getAllAgentConfigs, getAllToolDefinitions, getCheckpointSaver, getChunkBuffer, getEmbeddingsClient, getEmbeddingsLattice, getLoggerLattice, getModelLattice, getNextCronTime, getQueueLattice, getScheduleLattice, getStoreLattice, getToolClient, getToolDefinition, getToolLattice, getVectorStoreClient, getVectorStoreLattice, hasChunkBuffer, isValidCronExpression, loggerLatticeManager, modelLatticeManager, parseCronExpression, queueLatticeManager, registerAgentLattice, registerAgentLattices, registerCheckpointSaver, registerChunkBuffer, registerEmbeddingsLattice, registerLoggerLattice, registerModelLattice, registerQueueLattice, registerScheduleLattice, registerStoreLattice, registerToolLattice, registerVectorStoreLattice, scheduleLatticeManager, sqlDatabaseManager, storeLatticeManager, toolLatticeManager, validateAgentInput, validateToolInput, vectorStoreLatticeManager };
+export { AGENT_TASK_EVENT, type AgentClient, type AgentLattice, AgentLatticeManager, AgentManager, type BufferStats, type Chunk, ChunkBuffer, ChunkBufferLatticeManager, type ColumnInfo, ConsoleLoggerClient, type CronFields, type DatabaseConfig, type DatabaseType, DefaultScheduleClient, type EmbeddingsLatticeInterface, EmbeddingsLatticeManager, FileSystemSkillStore, type FileSystemSkillStoreOptions, type ISqlDatabase, InMemoryAssistantStore, InMemoryChunkBuffer, InMemoryThreadStore, type LoggerLattice, LoggerLatticeManager, type McpLatticeInterface, McpLatticeManager, type McpServerInfo, MemoryLatticeManager, MemoryQueueClient, MemoryScheduleStorage, type ModelConfig, type ModelLatticeInterface, ModelLatticeManager, PinoLoggerClient, PostgresDatabase, type QueryResult, type QueueLattice, QueueLatticeManager, type RunSandboxConfig, SandboxLatticeManager, type SandboxManagerProtocol, type ScheduleLattice, ScheduleLatticeManager, type SkillLattice, SkillLatticeManager, SqlDatabaseManager, type StoreLattice, StoreLatticeManager, type StoreType, type StoreTypeMap, type TableInfo, type TableSchema, type ThreadBuffer, type ThreadBufferConfig, ThreadStatus, type ToolDefinition, type ToolLattice, ToolLatticeManager, type VectorStoreLatticeInterface, VectorStoreLatticeManager, agentLatticeManager, describeCronExpression, embeddingsLatticeManager, eventBus, eventBus as eventBusDefault, getAgentClient, getAgentConfig, getAgentLattice, getAllAgentConfigs, getAllToolDefinitions, getCheckpointSaver, getChunkBuffer, getEmbeddingsClient, getEmbeddingsLattice, getLoggerLattice, getModelLattice, getNextCronTime, getQueueLattice, getSandBoxManager, getScheduleLattice, getStoreLattice, getToolClient, getToolDefinition, getToolLattice, getVectorStoreClient, getVectorStoreLattice, hasChunkBuffer, isValidCronExpression, isValidSandboxName, isValidSkillName, loggerLatticeManager, mcpManager, modelLatticeManager, normalizeSandboxName, parseCronExpression, queueLatticeManager, registerAgentLattice, registerAgentLattices, registerCheckpointSaver, registerChunkBuffer, registerEmbeddingsLattice, registerExistingTool, registerLoggerLattice, registerModelLattice, registerQueueLattice, registerScheduleLattice, registerStoreLattice, registerToolLattice, registerVectorStoreLattice, sandboxLatticeManager, scheduleLatticeManager, skillLatticeManager, sqlDatabaseManager, storeLatticeManager, toolLatticeManager, validateAgentInput, validateSkillName, validateToolInput, vectorStoreLatticeManager };