@axiom-lattice/protocols 2.1.5 → 2.1.6

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @axiom-lattice/protocols@2.1.5 build /home/runner/work/agentic/agentic/packages/protocols
+> @axiom-lattice/protocols@2.1.6 build /home/runner/work/agentic/agentic/packages/protocols
 > tsup src/index.ts --format cjs,esm --dts --sourcemap
 
 CLI Building entry: src/index.ts
@@ -8,13 +8,13 @@
 CLI Target: es2020
 CJS Build start
 ESM Build start
-CJS dist/index.js     3.57 KB
-CJS dist/index.js.map 10.43 KB
-CJS ⚡️ Build success in 42ms
-ESM dist/index.mjs     2.26 KB
-ESM dist/index.mjs.map 9.85 KB
-ESM ⚡️ Build success in 43ms
+ESM dist/index.mjs     1.92 KB
+ESM dist/index.mjs.map 8.37 KB
+ESM ⚡️ Build success in 52ms
+CJS dist/index.js     3.20 KB
+CJS dist/index.js.map 9.08 KB
+CJS ⚡️ Build success in 53ms
 DTS Build start
-DTS ⚡️ Build success in 2258ms
-DTS dist/index.d.ts  13.44 KB
-DTS dist/index.d.mts 13.44 KB
+DTS ⚡️ Build success in 2897ms
+DTS dist/index.d.ts  19.40 KB
+DTS dist/index.d.mts 19.40 KB

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @axiom-lattice/protocols
 
+## 2.1.6
+
+### Patch Changes
+
+- 7d8f3f5: enhance lattice
+
 ## 2.1.5
 
 ### Patch Changes

package/dist/index.d.mts

@@ -4,6 +4,9 @@ import { BaseChatModel } from '@langchain/core/language_models/chat_models';
 import { BaseMessage as BaseMessage$1 } from '@langchain/core/messages';
 import { ChatResult } from '@langchain/core/outputs';
 import { CompiledStateGraph } from '@langchain/langgraph';
+import { Embeddings } from '@langchain/core/embeddings';
+import { VectorStore } from '@langchain/core/vectorstores';
+import { DocumentInterface } from '@langchain/core/documents';
 
 /**
  * BaseLatticeProtocol
@@ -257,55 +260,6 @@ interface MemoryLatticeProtocol extends BaseLatticeProtocol<MemoryConfig, Memory
     clear: () => Promise<void>;
 }
 
-/**
- * StorageLatticeProtocol
- *
- * 存储Lattice的协议，用于数据持久化和状态管理
- */
-
-/**
- * 存储类型枚举
- */
-declare enum StorageType {
-    MEMORY = "memory",
-    LOCAL = "local",
-    DATABASE = "database",
-    CLOUD = "cloud",
-    DISTRIBUTED = "distributed"
-}
-/**
- * 存储配置接口
- */
-interface StorageConfig {
-    name: string;
-    description: string;
-    type: StorageType;
-    connectionString?: string;
-    options?: Record<string, any>;
-}
-/**
- * 存储客户端接口
- */
-interface StorageClient {
-    set: (key: string, value: any) => Promise<void>;
-    get: (key: string) => Promise<any>;
-    has: (key: string) => Promise<boolean>;
-    delete: (key: string) => Promise<boolean>;
-    clear: () => Promise<void>;
-    transaction: <T>(operations: () => Promise<T>) => Promise<T>;
-}
-/**
- * 存储Lattice协议接口
- */
-interface StorageLatticeProtocol extends BaseLatticeProtocol<StorageConfig, StorageClient> {
-    set: (key: string, value: any) => Promise<void>;
-    get: (key: string) => Promise<any>;
-    has: (key: string) => Promise<boolean>;
-    delete: (key: string) => Promise<boolean>;
-    clear: () => Promise<void>;
-    transaction: <T>(operations: () => Promise<T>) => Promise<T>;
-}
-
 /**
  * UILatticeProtocol
  *
@@ -410,6 +364,62 @@ interface QueueLatticeProtocol extends BaseLatticeProtocol<QueueConfig, QueueCli
     }>;
 }
 
+/**
+ * EmbeddingsLatticeProtocol
+ *
+ * Embeddings Lattice protocol for defining unified interface for embedding models
+ */
+
+/**
+ * Embeddings configuration interface
+ */
+interface EmbeddingsConfig {
+    name: string;
+    description?: string;
+    dimensions?: number;
+    maxChunkSize?: number;
+}
+/**
+ * Embeddings Lattice protocol interface
+ */
+interface EmbeddingsLatticeProtocol extends BaseLatticeProtocol<EmbeddingsConfig, Embeddings> {
+    embedDocuments: (texts: string[]) => Promise<number[][]>;
+    embedQuery: (text: string) => Promise<number[]>;
+}
+
+/**
+ * VectorStoreLatticeProtocol
+ *
+ * VectorStore Lattice protocol for defining unified interface for vector store implementations
+ */
+
+/**
+ * VectorStore configuration interface
+ */
+interface VectorStoreConfig {
+    name: string;
+    description?: string;
+    type?: string;
+    config?: Record<string, any>;
+}
+/**
+ * VectorStore Lattice protocol interface
+ */
+interface VectorStoreLatticeProtocol extends BaseLatticeProtocol<VectorStoreConfig, VectorStore> {
+    addVectors: (vectors: number[][], documents: DocumentInterface[], options?: Record<string, any>) => Promise<string[] | void>;
+    addDocuments: (documents: DocumentInterface[], options?: Record<string, any>) => Promise<string[] | void>;
+    delete: (params?: Record<string, any>) => Promise<void>;
+    similaritySearchVectorWithScore: (query: number[], k: number, filter?: VectorStore["FilterType"]) => Promise<[DocumentInterface, number][]>;
+    similaritySearch: (query: string, k?: number, filter?: VectorStore["FilterType"]) => Promise<DocumentInterface[]>;
+    similaritySearchWithScore: (query: string, k?: number, filter?: VectorStore["FilterType"]) => Promise<[DocumentInterface, number][]>;
+    maxMarginalRelevanceSearch?: (query: string, options: {
+        k: number;
+        fetchK?: number;
+        lambda?: number;
+        filter?: VectorStore["FilterType"];
+    }) => Promise<DocumentInterface[]>;
+}
+
 /**
  * MessageProtocol
  *
@@ -513,6 +523,193 @@ interface MessageChunk {
  */
 type Message = UserMessage | AssistantMessage | SystemMessage | ToolMessage | DeveloperMessage;
 
+/**
+ * ThreadStoreProtocol
+ *
+ * Thread store protocol definitions for the Axiom Lattice framework
+ * Provides standardized interfaces for thread management across all implementations
+ */
+/**
+ * Thread type definition
+ */
+interface Thread {
+    /**
+     * Thread identifier
+     */
+    id: string;
+    /**
+     * Assistant identifier this thread belongs to
+     */
+    assistantId: string;
+    /**
+     * Thread metadata
+     */
+    metadata?: Record<string, any>;
+    /**
+     * Thread creation timestamp
+     */
+    createdAt: Date;
+    /**
+     * Thread last update timestamp
+     */
+    updatedAt: Date;
+}
+/**
+ * Create thread request type
+ */
+interface CreateThreadRequest {
+    /**
+     * Thread metadata
+     */
+    metadata?: Record<string, any>;
+}
+/**
+ * ThreadStore interface
+ * Provides CRUD operations for thread data
+ * All operations are scoped to an assistant ID
+ */
+interface ThreadStore {
+    /**
+     * Get all threads for a specific assistant
+     * @param assistantId Assistant identifier
+     * @returns Array of threads for the assistant
+     */
+    getThreadsByAssistantId(assistantId: string): Promise<Thread[]>;
+    /**
+     * Get a thread by ID for a specific assistant
+     * @param assistantId Assistant identifier
+     * @param threadId Thread identifier
+     * @returns Thread if found, undefined otherwise
+     */
+    getThreadById(assistantId: string, threadId: string): Promise<Thread | undefined>;
+    /**
+     * Create a new thread for an assistant
+     * @param assistantId Assistant identifier
+     * @param threadId Thread identifier
+     * @param data Thread creation data
+     * @returns Created thread
+     */
+    createThread(assistantId: string, threadId: string, data: CreateThreadRequest): Promise<Thread>;
+    /**
+     * Update an existing thread
+     * @param assistantId Assistant identifier
+     * @param threadId Thread identifier
+     * @param updates Partial thread data to update
+     * @returns Updated thread if found, null otherwise
+     */
+    updateThread(assistantId: string, threadId: string, updates: Partial<CreateThreadRequest>): Promise<Thread | null>;
+    /**
+     * Delete a thread by ID
+     * @param assistantId Assistant identifier
+     * @param threadId Thread identifier
+     * @returns true if deleted, false otherwise
+     */
+    deleteThread(assistantId: string, threadId: string): Promise<boolean>;
+    /**
+     * Check if thread exists
+     * @param assistantId Assistant identifier
+     * @param threadId Thread identifier
+     * @returns true if thread exists, false otherwise
+     */
+    hasThread(assistantId: string, threadId: string): Promise<boolean>;
+}
+
+/**
+ * AssistantStoreProtocol
+ *
+ * Assistant store protocol definitions for the Axiom Lattice framework
+ * Provides standardized interfaces for assistant management across all implementations
+ */
+/**
+ * Assistant type definition
+ */
+interface Assistant {
+    /**
+     * Assistant identifier
+     */
+    id: string;
+    /**
+     * Assistant name
+     */
+    name: string;
+    /**
+     * Assistant description
+     */
+    description?: string;
+    /**
+     * Graph definition for the assistant
+     */
+    graphDefinition: any;
+    /**
+     * Assistant creation timestamp
+     */
+    createdAt: Date;
+    /**
+     * Assistant last update timestamp
+     */
+    updatedAt: Date;
+}
+/**
+ * Create assistant request type
+ */
+interface CreateAssistantRequest {
+    /**
+     * Assistant name
+     */
+    name: string;
+    /**
+     * Assistant description
+     */
+    description?: string;
+    /**
+     * Graph definition for the assistant
+     */
+    graphDefinition: any;
+}
+/**
+ * AssistantStore interface
+ * Provides CRUD operations for assistant data
+ */
+interface AssistantStore {
+    /**
+     * Get all assistants
+     * @returns Array of all assistants
+     */
+    getAllAssistants(): Promise<Assistant[]>;
+    /**
+     * Get assistant by ID
+     * @param id Assistant identifier
+     * @returns Assistant if found, undefined otherwise
+     */
+    getAssistantById(id: string): Promise<Assistant | null>;
+    /**
+     * Create a new assistant
+     * @param id Assistant identifier
+     * @param data Assistant creation data
+     * @returns Created assistant
+     */
+    createAssistant(id: string, data: CreateAssistantRequest): Promise<Assistant>;
+    /**
+     * Update an existing assistant
+     * @param id Assistant identifier
+     * @param updates Partial assistant data to update
+     * @returns Updated assistant if found, null otherwise
+     */
+    updateAssistant(id: string, updates: Partial<CreateAssistantRequest>): Promise<Assistant | null>;
+    /**
+     * Delete an assistant by ID
+     * @param id Assistant identifier
+     * @returns true if deleted, false otherwise
+     */
+    deleteAssistant(id: string): Promise<boolean>;
+    /**
+     * Check if assistant exists
+     * @param id Assistant identifier
+     * @returns true if assistant exists, false otherwise
+     */
+    hasAssistant(id: string): Promise<boolean>;
+}
+
 /**
  * 通用类型定义
  *
@@ -576,4 +773,4 @@ type Timestamp = number;
  */
 type Callback<T = any, R = void> = (data: T) => R | Promise<R>;
 
-export { type AgentClient, type AgentConfig, type AgentConfigWithTools, type AgentLatticeProtocol, AgentType, type AssistantMessage, type BaseLatticeProtocol, type BaseMessage, type Callback, type DeepAgentConfig, type DeveloperMessage, type FilterCondition, type GraphBuildOptions, type ID, type InterruptMessage, type LLMConfig, type LatticeError, type LatticeEventBus, type LatticeMessage, type MemoryClient, type MemoryConfig, type MemoryLatticeProtocol, MemoryType, type Message, type MessageChunk, type ModelLatticeProtocol, type PaginatedResult, type PaginationParams, type PlanExecuteAgentConfig, type QueryParams, type QueueClient, type QueueConfig, type QueueLatticeProtocol, type QueueResult, QueueType, type ReactAgentConfig, type Result, type SequentialAgentConfig, type StorageClient, type StorageConfig, type StorageLatticeProtocol, StorageType, type SystemMessage, type Timestamp, type ToolCall, type ToolConfig, type ToolExecutor, type ToolLatticeProtocol, type ToolMessage, type UIComponent, UIComponentType, type UIConfig, type UILatticeProtocol, type UserMessage, getSubAgentsFromConfig, getToolsFromConfig, hasTools, isDeepAgentConfig };
+export { type AgentClient, type AgentConfig, type AgentConfigWithTools, type AgentLatticeProtocol, AgentType, type Assistant, type AssistantMessage, type AssistantStore, type BaseLatticeProtocol, type BaseMessage, type Callback, type CreateAssistantRequest, type CreateThreadRequest, type DeepAgentConfig, type DeveloperMessage, type EmbeddingsConfig, type EmbeddingsLatticeProtocol, type FilterCondition, type GraphBuildOptions, type ID, type InterruptMessage, type LLMConfig, type LatticeError, type LatticeEventBus, type LatticeMessage, type MemoryClient, type MemoryConfig, type MemoryLatticeProtocol, MemoryType, type Message, type MessageChunk, type ModelLatticeProtocol, type PaginatedResult, type PaginationParams, type PlanExecuteAgentConfig, type QueryParams, type QueueClient, type QueueConfig, type QueueLatticeProtocol, type QueueResult, QueueType, type ReactAgentConfig, type Result, type SequentialAgentConfig, type SystemMessage, type Thread, type ThreadStore, type Timestamp, type ToolCall, type ToolConfig, type ToolExecutor, type ToolLatticeProtocol, type ToolMessage, type UIComponent, UIComponentType, type UIConfig, type UILatticeProtocol, type UserMessage, type VectorStoreConfig, type VectorStoreLatticeProtocol, getSubAgentsFromConfig, getToolsFromConfig, hasTools, isDeepAgentConfig };

package/dist/index.d.ts

@@ -4,6 +4,9 @@ import { BaseChatModel } from '@langchain/core/language_models/chat_models';
 import { BaseMessage as BaseMessage$1 } from '@langchain/core/messages';
 import { ChatResult } from '@langchain/core/outputs';
 import { CompiledStateGraph } from '@langchain/langgraph';
+import { Embeddings } from '@langchain/core/embeddings';
+import { VectorStore } from '@langchain/core/vectorstores';
+import { DocumentInterface } from '@langchain/core/documents';
 
 /**
  * BaseLatticeProtocol
@@ -257,55 +260,6 @@ interface MemoryLatticeProtocol extends BaseLatticeProtocol<MemoryConfig, Memory
     clear: () => Promise<void>;
 }
 
-/**
- * StorageLatticeProtocol
- *
- * 存储Lattice的协议，用于数据持久化和状态管理
- */
-
-/**
- * 存储类型枚举
- */
-declare enum StorageType {
-    MEMORY = "memory",
-    LOCAL = "local",
-    DATABASE = "database",
-    CLOUD = "cloud",
-    DISTRIBUTED = "distributed"
-}
-/**
- * 存储配置接口
- */
-interface StorageConfig {
-    name: string;
-    description: string;
-    type: StorageType;
-    connectionString?: string;
-    options?: Record<string, any>;
-}
-/**
- * 存储客户端接口
- */
-interface StorageClient {
-    set: (key: string, value: any) => Promise<void>;
-    get: (key: string) => Promise<any>;
-    has: (key: string) => Promise<boolean>;
-    delete: (key: string) => Promise<boolean>;
-    clear: () => Promise<void>;
-    transaction: <T>(operations: () => Promise<T>) => Promise<T>;
-}
-/**
- * 存储Lattice协议接口
- */
-interface StorageLatticeProtocol extends BaseLatticeProtocol<StorageConfig, StorageClient> {
-    set: (key: string, value: any) => Promise<void>;
-    get: (key: string) => Promise<any>;
-    has: (key: string) => Promise<boolean>;
-    delete: (key: string) => Promise<boolean>;
-    clear: () => Promise<void>;
-    transaction: <T>(operations: () => Promise<T>) => Promise<T>;
-}
-
 /**
  * UILatticeProtocol
  *
@@ -410,6 +364,62 @@ interface QueueLatticeProtocol extends BaseLatticeProtocol<QueueConfig, QueueCli
     }>;
 }
 
+/**
+ * EmbeddingsLatticeProtocol
+ *
+ * Embeddings Lattice protocol for defining unified interface for embedding models
+ */
+
+/**
+ * Embeddings configuration interface
+ */
+interface EmbeddingsConfig {
+    name: string;
+    description?: string;
+    dimensions?: number;
+    maxChunkSize?: number;
+}
+/**
+ * Embeddings Lattice protocol interface
+ */
+interface EmbeddingsLatticeProtocol extends BaseLatticeProtocol<EmbeddingsConfig, Embeddings> {
+    embedDocuments: (texts: string[]) => Promise<number[][]>;
+    embedQuery: (text: string) => Promise<number[]>;
+}
+
+/**
+ * VectorStoreLatticeProtocol
+ *
+ * VectorStore Lattice protocol for defining unified interface for vector store implementations
+ */
+
+/**
+ * VectorStore configuration interface
+ */
+interface VectorStoreConfig {
+    name: string;
+    description?: string;
+    type?: string;
+    config?: Record<string, any>;
+}
+/**
+ * VectorStore Lattice protocol interface
+ */
+interface VectorStoreLatticeProtocol extends BaseLatticeProtocol<VectorStoreConfig, VectorStore> {
+    addVectors: (vectors: number[][], documents: DocumentInterface[], options?: Record<string, any>) => Promise<string[] | void>;
+    addDocuments: (documents: DocumentInterface[], options?: Record<string, any>) => Promise<string[] | void>;
+    delete: (params?: Record<string, any>) => Promise<void>;
+    similaritySearchVectorWithScore: (query: number[], k: number, filter?: VectorStore["FilterType"]) => Promise<[DocumentInterface, number][]>;
+    similaritySearch: (query: string, k?: number, filter?: VectorStore["FilterType"]) => Promise<DocumentInterface[]>;
+    similaritySearchWithScore: (query: string, k?: number, filter?: VectorStore["FilterType"]) => Promise<[DocumentInterface, number][]>;
+    maxMarginalRelevanceSearch?: (query: string, options: {
+        k: number;
+        fetchK?: number;
+        lambda?: number;
+        filter?: VectorStore["FilterType"];
+    }) => Promise<DocumentInterface[]>;
+}
+
 /**
  * MessageProtocol
  *
@@ -513,6 +523,193 @@ interface MessageChunk {
  */
 type Message = UserMessage | AssistantMessage | SystemMessage | ToolMessage | DeveloperMessage;
 
+/**
+ * ThreadStoreProtocol
+ *
+ * Thread store protocol definitions for the Axiom Lattice framework
+ * Provides standardized interfaces for thread management across all implementations
+ */
+/**
+ * Thread type definition
+ */
+interface Thread {
+    /**
+     * Thread identifier
+     */
+    id: string;
+    /**
+     * Assistant identifier this thread belongs to
+     */
+    assistantId: string;
+    /**
+     * Thread metadata
+     */
+    metadata?: Record<string, any>;
+    /**
+     * Thread creation timestamp
+     */
+    createdAt: Date;
+    /**
+     * Thread last update timestamp
+     */
+    updatedAt: Date;
+}
+/**
+ * Create thread request type
+ */
+interface CreateThreadRequest {
+    /**
+     * Thread metadata
+     */
+    metadata?: Record<string, any>;
+}
+/**
+ * ThreadStore interface
+ * Provides CRUD operations for thread data
+ * All operations are scoped to an assistant ID
+ */
+interface ThreadStore {
+    /**
+     * Get all threads for a specific assistant
+     * @param assistantId Assistant identifier
+     * @returns Array of threads for the assistant
+     */
+    getThreadsByAssistantId(assistantId: string): Promise<Thread[]>;
+    /**
+     * Get a thread by ID for a specific assistant
+     * @param assistantId Assistant identifier
+     * @param threadId Thread identifier
+     * @returns Thread if found, undefined otherwise
+     */
+    getThreadById(assistantId: string, threadId: string): Promise<Thread | undefined>;
+    /**
+     * Create a new thread for an assistant
+     * @param assistantId Assistant identifier
+     * @param threadId Thread identifier
+     * @param data Thread creation data
+     * @returns Created thread
+     */
+    createThread(assistantId: string, threadId: string, data: CreateThreadRequest): Promise<Thread>;
+    /**
+     * Update an existing thread
+     * @param assistantId Assistant identifier
+     * @param threadId Thread identifier
+     * @param updates Partial thread data to update
+     * @returns Updated thread if found, null otherwise
+     */
+    updateThread(assistantId: string, threadId: string, updates: Partial<CreateThreadRequest>): Promise<Thread | null>;
+    /**
+     * Delete a thread by ID
+     * @param assistantId Assistant identifier
+     * @param threadId Thread identifier
+     * @returns true if deleted, false otherwise
+     */
+    deleteThread(assistantId: string, threadId: string): Promise<boolean>;
+    /**
+     * Check if thread exists
+     * @param assistantId Assistant identifier
+     * @param threadId Thread identifier
+     * @returns true if thread exists, false otherwise
+     */
+    hasThread(assistantId: string, threadId: string): Promise<boolean>;
+}
+
+/**
+ * AssistantStoreProtocol
+ *
+ * Assistant store protocol definitions for the Axiom Lattice framework
+ * Provides standardized interfaces for assistant management across all implementations
+ */
+/**
+ * Assistant type definition
+ */
+interface Assistant {
+    /**
+     * Assistant identifier
+     */
+    id: string;
+    /**
+     * Assistant name
+     */
+    name: string;
+    /**
+     * Assistant description
+     */
+    description?: string;
+    /**
+     * Graph definition for the assistant
+     */
+    graphDefinition: any;
+    /**
+     * Assistant creation timestamp
+     */
+    createdAt: Date;
+    /**
+     * Assistant last update timestamp
+     */
+    updatedAt: Date;
+}
+/**
+ * Create assistant request type
+ */
+interface CreateAssistantRequest {
+    /**
+     * Assistant name
+     */
+    name: string;
+    /**
+     * Assistant description
+     */
+    description?: string;
+    /**
+     * Graph definition for the assistant
+     */
+    graphDefinition: any;
+}
+/**
+ * AssistantStore interface
+ * Provides CRUD operations for assistant data
+ */
+interface AssistantStore {
+    /**
+     * Get all assistants
+     * @returns Array of all assistants
+     */
+    getAllAssistants(): Promise<Assistant[]>;
+    /**
+     * Get assistant by ID
+     * @param id Assistant identifier
+     * @returns Assistant if found, undefined otherwise
+     */
+    getAssistantById(id: string): Promise<Assistant | null>;
+    /**
+     * Create a new assistant
+     * @param id Assistant identifier
+     * @param data Assistant creation data
+     * @returns Created assistant
+     */
+    createAssistant(id: string, data: CreateAssistantRequest): Promise<Assistant>;
+    /**
+     * Update an existing assistant
+     * @param id Assistant identifier
+     * @param updates Partial assistant data to update
+     * @returns Updated assistant if found, null otherwise
+     */
+    updateAssistant(id: string, updates: Partial<CreateAssistantRequest>): Promise<Assistant | null>;
+    /**
+     * Delete an assistant by ID
+     * @param id Assistant identifier
+     * @returns true if deleted, false otherwise
+     */
+    deleteAssistant(id: string): Promise<boolean>;
+    /**
+     * Check if assistant exists
+     * @param id Assistant identifier
+     * @returns true if assistant exists, false otherwise
+     */
+    hasAssistant(id: string): Promise<boolean>;
+}
+
 /**
  * 通用类型定义
  *
@@ -576,4 +773,4 @@ type Timestamp = number;
  */
 type Callback<T = any, R = void> = (data: T) => R | Promise<R>;
 
-export { type AgentClient, type AgentConfig, type AgentConfigWithTools, type AgentLatticeProtocol, AgentType, type AssistantMessage, type BaseLatticeProtocol, type BaseMessage, type Callback, type DeepAgentConfig, type DeveloperMessage, type FilterCondition, type GraphBuildOptions, type ID, type InterruptMessage, type LLMConfig, type LatticeError, type LatticeEventBus, type LatticeMessage, type MemoryClient, type MemoryConfig, type MemoryLatticeProtocol, MemoryType, type Message, type MessageChunk, type ModelLatticeProtocol, type PaginatedResult, type PaginationParams, type PlanExecuteAgentConfig, type QueryParams, type QueueClient, type QueueConfig, type QueueLatticeProtocol, type QueueResult, QueueType, type ReactAgentConfig, type Result, type SequentialAgentConfig, type StorageClient, type StorageConfig, type StorageLatticeProtocol, StorageType, type SystemMessage, type Timestamp, type ToolCall, type ToolConfig, type ToolExecutor, type ToolLatticeProtocol, type ToolMessage, type UIComponent, UIComponentType, type UIConfig, type UILatticeProtocol, type UserMessage, getSubAgentsFromConfig, getToolsFromConfig, hasTools, isDeepAgentConfig };
+export { type AgentClient, type AgentConfig, type AgentConfigWithTools, type AgentLatticeProtocol, AgentType, type Assistant, type AssistantMessage, type AssistantStore, type BaseLatticeProtocol, type BaseMessage, type Callback, type CreateAssistantRequest, type CreateThreadRequest, type DeepAgentConfig, type DeveloperMessage, type EmbeddingsConfig, type EmbeddingsLatticeProtocol, type FilterCondition, type GraphBuildOptions, type ID, type InterruptMessage, type LLMConfig, type LatticeError, type LatticeEventBus, type LatticeMessage, type MemoryClient, type MemoryConfig, type MemoryLatticeProtocol, MemoryType, type Message, type MessageChunk, type ModelLatticeProtocol, type PaginatedResult, type PaginationParams, type PlanExecuteAgentConfig, type QueryParams, type QueueClient, type QueueConfig, type QueueLatticeProtocol, type QueueResult, QueueType, type ReactAgentConfig, type Result, type SequentialAgentConfig, type SystemMessage, type Thread, type ThreadStore, type Timestamp, type ToolCall, type ToolConfig, type ToolExecutor, type ToolLatticeProtocol, type ToolMessage, type UIComponent, UIComponentType, type UIConfig, type UILatticeProtocol, type UserMessage, type VectorStoreConfig, type VectorStoreLatticeProtocol, getSubAgentsFromConfig, getToolsFromConfig, hasTools, isDeepAgentConfig };

package/dist/index.js

@@ -23,7 +23,6 @@ __export(index_exports, {
   AgentType: () => AgentType,
   MemoryType: () => MemoryType,
   QueueType: () => QueueType,
-  StorageType: () => StorageType,
   UIComponentType: () => UIComponentType,
   getSubAgentsFromConfig: () => getSubAgentsFromConfig,
   getToolsFromConfig: () => getToolsFromConfig,
@@ -69,16 +68,6 @@ var MemoryType = /* @__PURE__ */ ((MemoryType2) => {
   return MemoryType2;
 })(MemoryType || {});
 
-// src/StorageLatticeProtocol.ts
-var StorageType = /* @__PURE__ */ ((StorageType2) => {
-  StorageType2["MEMORY"] = "memory";
-  StorageType2["LOCAL"] = "local";
-  StorageType2["DATABASE"] = "database";
-  StorageType2["CLOUD"] = "cloud";
-  StorageType2["DISTRIBUTED"] = "distributed";
-  return StorageType2;
-})(StorageType || {});
-
 // src/UILatticeProtocol.ts
 var UIComponentType = /* @__PURE__ */ ((UIComponentType2) => {
   UIComponentType2["CONTAINER"] = "container";
@@ -105,7 +94,6 @@ var QueueType = /* @__PURE__ */ ((QueueType2) => {
   AgentType,
   MemoryType,
   QueueType,
-  StorageType,
   UIComponentType,
   getSubAgentsFromConfig,
   getToolsFromConfig,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/AgentLatticeProtocol.ts","../src/MemoryLatticeProtocol.ts","../src/StorageLatticeProtocol.ts","../src/UILatticeProtocol.ts","../src/QueueLatticeProtocol.ts"],"sourcesContent":["/**\n * Protocols\n *\n * 导出所有Lattice协议接口，为整个系统提供统一的接口规范\n */\n\nexport * from \"./BaseLatticeProtocol\";\nexport * from \"./ToolLatticeProtocol\";\nexport * from \"./ModelLatticeProtocol\";\nexport * from \"./AgentLatticeProtocol\";\nexport * from \"./MemoryLatticeProtocol\";\nexport * from \"./StorageLatticeProtocol\";\nexport * from \"./UILatticeProtocol\";\nexport * from \"./QueueLatticeProtocol\";\nexport * from \"./MessageProtocol\";\n\n// 导出通用类型\nexport * from \"./types\";\n","/**\n * AgentLatticeProtocol\n *\n * 智能体Lattice的协议，定义了智能体的行为和组合方式\n */\n\nimport { CompiledStateGraph } from \"@langchain/langgraph\";\nimport z, { ZodObject, ZodSchema } from \"zod\";\nimport { BaseLatticeProtocol } from \"./BaseLatticeProtocol\";\n\n/**\n * 智能体类型枚举\n */\nexport enum AgentType {\n  REACT = \"react\",\n  DEEP_AGENT = \"deep_agent\",\n  PLAN_EXECUTE = \"plan_execute\",\n  SEQUENTIAL = \"sequential\",\n}\n\n/**\n * Base agent configuration shared by all agent types\n */\ninterface BaseAgentConfig {\n  key: string; // Unique key\n  name: string; // Name\n  description: string; // Description\n  prompt: string; // Prompt\n  schema?: ZodObject<any, any, any, any, any>; // Input validation schema\n  modelKey?: string; // Model key to use\n}\n\n/**\n * REACT agent configuration\n */\nexport interface ReactAgentConfig extends BaseAgentConfig {\n  type: AgentType.REACT;\n  tools?: string[]; // Tool list\n}\n\n/**\n * DEEP_AGENT configuration - only this type supports subAgents\n */\nexport interface DeepAgentConfig extends BaseAgentConfig {\n  type: AgentType.DEEP_AGENT;\n  tools?: string[]; // Tool list\n  subAgents?: string[]; // Sub-agent list (unique to DEEP_AGENT)\n  internalSubAgents?: AgentConfig[]; // Internal sub-agent list (unique to DEEP_AGENT)\n}\n\n/**\n * PLAN_EXECUTE agent configuration\n */\nexport interface PlanExecuteAgentConfig extends BaseAgentConfig {\n  type: AgentType.PLAN_EXECUTE;\n  tools?: string[]; // Tool list\n}\n\n/**\n * SEQUENTIAL agent configuration\n */\nexport interface SequentialAgentConfig extends BaseAgentConfig {\n  type: AgentType.SEQUENTIAL;\n}\n\n/**\n * Agent configuration union type\n * Different agent types have different configuration options\n */\nexport type AgentConfig =\n  | ReactAgentConfig\n  | DeepAgentConfig\n  | PlanExecuteAgentConfig\n  | SequentialAgentConfig;\n\n/**\n * Agent configuration with tools property\n */\nexport type AgentConfigWithTools =\n  | ReactAgentConfig\n  | DeepAgentConfig\n  | PlanExecuteAgentConfig;\n\n/**\n * Type guard to check if config has tools property\n */\nexport function hasTools(config: AgentConfig): config is AgentConfigWithTools {\n  return config.type !== AgentType.SEQUENTIAL;\n}\n\n/**\n * Type guard to check if config is DeepAgentConfig (has subAgents)\n */\nexport function isDeepAgentConfig(\n  config: AgentConfig\n): config is DeepAgentConfig {\n  return config.type === AgentType.DEEP_AGENT;\n}\n\n/**\n * Get tools from config safely\n */\nexport function getToolsFromConfig(config: AgentConfig): string[] {\n  if (hasTools(config)) {\n    return config.tools || [];\n  }\n  return [];\n}\n\n/**\n * Get subAgents from config safely (only DeepAgentConfig has subAgents)\n */\nexport function getSubAgentsFromConfig(config: AgentConfig): string[] {\n  if (isDeepAgentConfig(config)) {\n    return config.subAgents || [];\n  }\n  return [];\n}\n\n/**\n * 智能体客户端类型\n */\nexport type AgentClient = CompiledStateGraph<any, any, any, any, any>;\n\n/**\n * Graph构建选项\n */\nexport interface GraphBuildOptions {\n  overrideTools?: string[];\n  overrideModel?: string;\n  metadata?: Record<string, any>;\n}\n\n/**\n * 智能体Lattice协议接口\n */\nexport interface AgentLatticeProtocol\n  extends BaseLatticeProtocol<AgentConfig, AgentClient> {\n  // 智能体执行函数\n  invoke: (input: any, options?: any) => Promise<any>;\n\n  // 构建智能体图\n  buildGraph: (options?: GraphBuildOptions) => Promise<AgentClient>;\n}\n","/**\n * MemoryLatticeProtocol\n *\n * 记忆Lattice的协议，用于管理智能体的上下文和记忆\n */\n\nimport { BaseLatticeProtocol } from \"./BaseLatticeProtocol\";\n\n/**\n * 记忆类型枚举\n */\nexport enum MemoryType {\n  SHORT_TERM = \"short_term\",\n  LONG_TERM = \"long_term\",\n  EPISODIC = \"episodic\",\n  SEMANTIC = \"semantic\",\n  WORKING = \"working\",\n}\n\n/**\n * 记忆配置接口\n */\nexport interface MemoryConfig {\n  name: string; // 名称\n  description: string; // 描述\n  type: MemoryType; // 记忆类型\n  ttl?: number; // 生存时间\n  capacity?: number; // 容量限制\n}\n\n/**\n * 记忆客户端接口\n */\nexport interface MemoryClient {\n  add: (key: string, value: any) => Promise<void>;\n  get: (key: string) => Promise<any>;\n  update: (key: string, value: any) => Promise<void>;\n  delete: (key: string) => Promise<void>;\n  search: (query: string, options?: any) => Promise<any[]>;\n  clear: () => Promise<void>;\n}\n\n/**\n * 记忆Lattice协议接口\n */\nexport interface MemoryLatticeProtocol\n  extends BaseLatticeProtocol<MemoryConfig, MemoryClient> {\n  // 记忆操作方法\n  add: (key: string, value: any) => Promise<void>;\n  get: (key: string) => Promise<any>;\n  update: (key: string, value: any) => Promise<void>;\n  delete: (key: string) => Promise<void>;\n  search: (query: string, options?: any) => Promise<any[]>;\n  clear: () => Promise<void>;\n}\n","/**\n * StorageLatticeProtocol\n *\n * 存储Lattice的协议，用于数据持久化和状态管理\n */\n\nimport { BaseLatticeProtocol } from \"./BaseLatticeProtocol\";\n\n/**\n * 存储类型枚举\n */\nexport enum StorageType {\n  MEMORY = \"memory\",\n  LOCAL = \"local\",\n  DATABASE = \"database\",\n  CLOUD = \"cloud\",\n  DISTRIBUTED = \"distributed\",\n}\n\n/**\n * 存储配置接口\n */\nexport interface StorageConfig {\n  name: string; // 名称\n  description: string; // 描述\n  type: StorageType; // 存储类型\n  connectionString?: string; // 连接字符串\n  options?: Record<string, any>; // 其他选项\n}\n\n/**\n * 存储客户端接口\n */\nexport interface StorageClient {\n  set: (key: string, value: any) => Promise<void>;\n  get: (key: string) => Promise<any>;\n  has: (key: string) => Promise<boolean>;\n  delete: (key: string) => Promise<boolean>;\n  clear: () => Promise<void>;\n  transaction: <T>(operations: () => Promise<T>) => Promise<T>;\n}\n\n/**\n * 存储Lattice协议接口\n */\nexport interface StorageLatticeProtocol\n  extends BaseLatticeProtocol<StorageConfig, StorageClient> {\n  // 存储操作方法\n  set: (key: string, value: any) => Promise<void>;\n  get: (key: string) => Promise<any>;\n  has: (key: string) => Promise<boolean>;\n  delete: (key: string) => Promise<boolean>;\n  clear: () => Promise<void>;\n  transaction: <T>(operations: () => Promise<T>) => Promise<T>;\n}\n","/**\n * UILatticeProtocol\n *\n * UI Lattice的协议，用于定义用户界面组件\n */\n\nimport { BaseLatticeProtocol } from \"./BaseLatticeProtocol\";\n\n/**\n * UI组件类型枚举\n */\nexport enum UIComponentType {\n  CONTAINER = \"container\",\n  INPUT = \"input\",\n  BUTTON = \"button\",\n  LIST = \"list\",\n  TABLE = \"table\",\n  CHART = \"chart\",\n  FORM = \"form\",\n  CARD = \"card\",\n  MODAL = \"modal\",\n  CUSTOM = \"custom\",\n}\n\n/**\n * UI配置接口\n */\nexport interface UIConfig {\n  name: string; // 组件名称\n  description: string; // 组件描述\n  type: UIComponentType; // 组件类型\n  props?: Record<string, any>; // 组件属性\n  children?: string[]; // 子组件列表\n}\n\n/**\n * UI组件接口\n * 使用泛型以适应不同的UI框架(React, Vue等)\n */\nexport interface UIComponent<T = any> {\n  render: (props?: any) => T;\n  addEventListener: (event: string, handler: Function) => void;\n  removeEventListener: (event: string, handler: Function) => void;\n}\n\n/**\n * UI Lattice协议接口\n */\nexport interface UILatticeProtocol<T = any>\n  extends BaseLatticeProtocol<UIConfig, UIComponent<T>> {\n  // UI渲染方法\n  render: (props?: any) => T;\n\n  // 事件处理\n  addEventListener: (event: string, handler: Function) => void;\n  removeEventListener: (event: string, handler: Function) => void;\n}\n","/**\n * QueueLatticeProtocol\n *\n * Queue Lattice protocol for task queue management\n */\n\nimport { BaseLatticeProtocol } from \"./BaseLatticeProtocol\";\n\n/**\n * Queue service type enumeration\n */\nexport enum QueueType {\n  MEMORY = \"memory\",\n  REDIS = \"redis\",\n}\n\n/**\n * Queue configuration interface\n */\nexport interface QueueConfig {\n  name: string; // Queue name\n  description: string; // Queue description\n  type: QueueType; // Queue service type\n  queueName?: string; // Specific queue name (e.g., \"tasks\")\n  options?: Record<string, any>; // Additional options (e.g., Redis connection options)\n}\n\n/**\n * Queue operation result interface\n */\nexport interface QueueResult<T = any> {\n  data: T | null;\n  error: any | null;\n}\n\n/**\n * Queue client interface\n */\nexport interface QueueClient {\n  push: (item: any) => Promise<QueueResult<number>>;\n  pop: () => Promise<QueueResult<any>>;\n  createQueue?: () => Promise<{ success: boolean; queue_name?: string; error?: any }>;\n}\n\n/**\n * Queue Lattice protocol interface\n */\nexport interface QueueLatticeProtocol\n  extends BaseLatticeProtocol<QueueConfig, QueueClient> {\n  // Queue operations\n  push: (item: any) => Promise<QueueResult<number>>;\n  pop: () => Promise<QueueResult<any>>;\n  createQueue?: () => Promise<{ success: boolean; queue_name?: string; error?: any }>;\n}\n\n\n\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACaO,IAAK,YAAL,kBAAKA,eAAL;AACL,EAAAA,WAAA,WAAQ;AACR,EAAAA,WAAA,gBAAa;AACb,EAAAA,WAAA,kBAAe;AACf,EAAAA,WAAA,gBAAa;AAJH,SAAAA;AAAA,GAAA;AAyEL,SAAS,SAAS,QAAqD;AAC5E,SAAO,OAAO,SAAS;AACzB;AAKO,SAAS,kBACd,QAC2B;AAC3B,SAAO,OAAO,SAAS;AACzB;AAKO,SAAS,mBAAmB,QAA+B;AAChE,MAAI,SAAS,MAAM,GAAG;AACpB,WAAO,OAAO,SAAS,CAAC;AAAA,EAC1B;AACA,SAAO,CAAC;AACV;AAKO,SAAS,uBAAuB,QAA+B;AACpE,MAAI,kBAAkB,MAAM,GAAG;AAC7B,WAAO,OAAO,aAAa,CAAC;AAAA,EAC9B;AACA,SAAO,CAAC;AACV;;;AC1GO,IAAK,aAAL,kBAAKC,gBAAL;AACL,EAAAA,YAAA,gBAAa;AACb,EAAAA,YAAA,eAAY;AACZ,EAAAA,YAAA,cAAW;AACX,EAAAA,YAAA,cAAW;AACX,EAAAA,YAAA,aAAU;AALA,SAAAA;AAAA,GAAA;;;ACAL,IAAK,cAAL,kBAAKC,iBAAL;AACL,EAAAA,aAAA,YAAS;AACT,EAAAA,aAAA,WAAQ;AACR,EAAAA,aAAA,cAAW;AACX,EAAAA,aAAA,WAAQ;AACR,EAAAA,aAAA,iBAAc;AALJ,SAAAA;AAAA,GAAA;;;ACAL,IAAK,kBAAL,kBAAKC,qBAAL;AACL,EAAAA,iBAAA,eAAY;AACZ,EAAAA,iBAAA,WAAQ;AACR,EAAAA,iBAAA,YAAS;AACT,EAAAA,iBAAA,UAAO;AACP,EAAAA,iBAAA,WAAQ;AACR,EAAAA,iBAAA,WAAQ;AACR,EAAAA,iBAAA,UAAO;AACP,EAAAA,iBAAA,UAAO;AACP,EAAAA,iBAAA,WAAQ;AACR,EAAAA,iBAAA,YAAS;AAVC,SAAAA;AAAA,GAAA;;;ACAL,IAAK,YAAL,kBAAKC,eAAL;AACL,EAAAA,WAAA,YAAS;AACT,EAAAA,WAAA,WAAQ;AAFE,SAAAA;AAAA,GAAA;","names":["AgentType","MemoryType","StorageType","UIComponentType","QueueType"]}
+{"version":3,"sources":["../src/index.ts","../src/AgentLatticeProtocol.ts","../src/MemoryLatticeProtocol.ts","../src/UILatticeProtocol.ts","../src/QueueLatticeProtocol.ts"],"sourcesContent":["/**\n * Protocols\n *\n * 导出所有Lattice协议接口，为整个系统提供统一的接口规范\n */\n\nexport * from \"./BaseLatticeProtocol\";\nexport * from \"./ToolLatticeProtocol\";\nexport * from \"./ModelLatticeProtocol\";\nexport * from \"./AgentLatticeProtocol\";\nexport * from \"./MemoryLatticeProtocol\";\nexport * from \"./UILatticeProtocol\";\nexport * from \"./QueueLatticeProtocol\";\nexport * from \"./EmbeddingsLatticeProtocol\";\nexport * from \"./VectorStoreLatticeProtocol\";\nexport * from \"./MessageProtocol\";\nexport * from \"./ThreadStoreProtocol\";\nexport * from \"./AssistantStoreProtocol\";\n\n// 导出通用类型\nexport * from \"./types\";\n","/**\n * AgentLatticeProtocol\n *\n * 智能体Lattice的协议，定义了智能体的行为和组合方式\n */\n\nimport { CompiledStateGraph } from \"@langchain/langgraph\";\nimport z, { ZodObject, ZodSchema } from \"zod\";\nimport { BaseLatticeProtocol } from \"./BaseLatticeProtocol\";\n\n/**\n * 智能体类型枚举\n */\nexport enum AgentType {\n  REACT = \"react\",\n  DEEP_AGENT = \"deep_agent\",\n  PLAN_EXECUTE = \"plan_execute\",\n  SEQUENTIAL = \"sequential\",\n}\n\n/**\n * Base agent configuration shared by all agent types\n */\ninterface BaseAgentConfig {\n  key: string; // Unique key\n  name: string; // Name\n  description: string; // Description\n  prompt: string; // Prompt\n  schema?: ZodObject<any, any, any, any, any>; // Input validation schema\n  modelKey?: string; // Model key to use\n}\n\n/**\n * REACT agent configuration\n */\nexport interface ReactAgentConfig extends BaseAgentConfig {\n  type: AgentType.REACT;\n  tools?: string[]; // Tool list\n}\n\n/**\n * DEEP_AGENT configuration - only this type supports subAgents\n */\nexport interface DeepAgentConfig extends BaseAgentConfig {\n  type: AgentType.DEEP_AGENT;\n  tools?: string[]; // Tool list\n  subAgents?: string[]; // Sub-agent list (unique to DEEP_AGENT)\n  internalSubAgents?: AgentConfig[]; // Internal sub-agent list (unique to DEEP_AGENT)\n}\n\n/**\n * PLAN_EXECUTE agent configuration\n */\nexport interface PlanExecuteAgentConfig extends BaseAgentConfig {\n  type: AgentType.PLAN_EXECUTE;\n  tools?: string[]; // Tool list\n}\n\n/**\n * SEQUENTIAL agent configuration\n */\nexport interface SequentialAgentConfig extends BaseAgentConfig {\n  type: AgentType.SEQUENTIAL;\n}\n\n/**\n * Agent configuration union type\n * Different agent types have different configuration options\n */\nexport type AgentConfig =\n  | ReactAgentConfig\n  | DeepAgentConfig\n  | PlanExecuteAgentConfig\n  | SequentialAgentConfig;\n\n/**\n * Agent configuration with tools property\n */\nexport type AgentConfigWithTools =\n  | ReactAgentConfig\n  | DeepAgentConfig\n  | PlanExecuteAgentConfig;\n\n/**\n * Type guard to check if config has tools property\n */\nexport function hasTools(config: AgentConfig): config is AgentConfigWithTools {\n  return config.type !== AgentType.SEQUENTIAL;\n}\n\n/**\n * Type guard to check if config is DeepAgentConfig (has subAgents)\n */\nexport function isDeepAgentConfig(\n  config: AgentConfig\n): config is DeepAgentConfig {\n  return config.type === AgentType.DEEP_AGENT;\n}\n\n/**\n * Get tools from config safely\n */\nexport function getToolsFromConfig(config: AgentConfig): string[] {\n  if (hasTools(config)) {\n    return config.tools || [];\n  }\n  return [];\n}\n\n/**\n * Get subAgents from config safely (only DeepAgentConfig has subAgents)\n */\nexport function getSubAgentsFromConfig(config: AgentConfig): string[] {\n  if (isDeepAgentConfig(config)) {\n    return config.subAgents || [];\n  }\n  return [];\n}\n\n/**\n * 智能体客户端类型\n */\nexport type AgentClient = CompiledStateGraph<any, any, any, any, any>;\n\n/**\n * Graph构建选项\n */\nexport interface GraphBuildOptions {\n  overrideTools?: string[];\n  overrideModel?: string;\n  metadata?: Record<string, any>;\n}\n\n/**\n * 智能体Lattice协议接口\n */\nexport interface AgentLatticeProtocol\n  extends BaseLatticeProtocol<AgentConfig, AgentClient> {\n  // 智能体执行函数\n  invoke: (input: any, options?: any) => Promise<any>;\n\n  // 构建智能体图\n  buildGraph: (options?: GraphBuildOptions) => Promise<AgentClient>;\n}\n","/**\n * MemoryLatticeProtocol\n *\n * 记忆Lattice的协议，用于管理智能体的上下文和记忆\n */\n\nimport { BaseLatticeProtocol } from \"./BaseLatticeProtocol\";\n\n/**\n * 记忆类型枚举\n */\nexport enum MemoryType {\n  SHORT_TERM = \"short_term\",\n  LONG_TERM = \"long_term\",\n  EPISODIC = \"episodic\",\n  SEMANTIC = \"semantic\",\n  WORKING = \"working\",\n}\n\n/**\n * 记忆配置接口\n */\nexport interface MemoryConfig {\n  name: string; // 名称\n  description: string; // 描述\n  type: MemoryType; // 记忆类型\n  ttl?: number; // 生存时间\n  capacity?: number; // 容量限制\n}\n\n/**\n * 记忆客户端接口\n */\nexport interface MemoryClient {\n  add: (key: string, value: any) => Promise<void>;\n  get: (key: string) => Promise<any>;\n  update: (key: string, value: any) => Promise<void>;\n  delete: (key: string) => Promise<void>;\n  search: (query: string, options?: any) => Promise<any[]>;\n  clear: () => Promise<void>;\n}\n\n/**\n * 记忆Lattice协议接口\n */\nexport interface MemoryLatticeProtocol\n  extends BaseLatticeProtocol<MemoryConfig, MemoryClient> {\n  // 记忆操作方法\n  add: (key: string, value: any) => Promise<void>;\n  get: (key: string) => Promise<any>;\n  update: (key: string, value: any) => Promise<void>;\n  delete: (key: string) => Promise<void>;\n  search: (query: string, options?: any) => Promise<any[]>;\n  clear: () => Promise<void>;\n}\n","/**\n * UILatticeProtocol\n *\n * UI Lattice的协议，用于定义用户界面组件\n */\n\nimport { BaseLatticeProtocol } from \"./BaseLatticeProtocol\";\n\n/**\n * UI组件类型枚举\n */\nexport enum UIComponentType {\n  CONTAINER = \"container\",\n  INPUT = \"input\",\n  BUTTON = \"button\",\n  LIST = \"list\",\n  TABLE = \"table\",\n  CHART = \"chart\",\n  FORM = \"form\",\n  CARD = \"card\",\n  MODAL = \"modal\",\n  CUSTOM = \"custom\",\n}\n\n/**\n * UI配置接口\n */\nexport interface UIConfig {\n  name: string; // 组件名称\n  description: string; // 组件描述\n  type: UIComponentType; // 组件类型\n  props?: Record<string, any>; // 组件属性\n  children?: string[]; // 子组件列表\n}\n\n/**\n * UI组件接口\n * 使用泛型以适应不同的UI框架(React, Vue等)\n */\nexport interface UIComponent<T = any> {\n  render: (props?: any) => T;\n  addEventListener: (event: string, handler: Function) => void;\n  removeEventListener: (event: string, handler: Function) => void;\n}\n\n/**\n * UI Lattice协议接口\n */\nexport interface UILatticeProtocol<T = any>\n  extends BaseLatticeProtocol<UIConfig, UIComponent<T>> {\n  // UI渲染方法\n  render: (props?: any) => T;\n\n  // 事件处理\n  addEventListener: (event: string, handler: Function) => void;\n  removeEventListener: (event: string, handler: Function) => void;\n}\n","/**\n * QueueLatticeProtocol\n *\n * Queue Lattice protocol for task queue management\n */\n\nimport { BaseLatticeProtocol } from \"./BaseLatticeProtocol\";\n\n/**\n * Queue service type enumeration\n */\nexport enum QueueType {\n  MEMORY = \"memory\",\n  REDIS = \"redis\",\n}\n\n/**\n * Queue configuration interface\n */\nexport interface QueueConfig {\n  name: string; // Queue name\n  description: string; // Queue description\n  type: QueueType; // Queue service type\n  queueName?: string; // Specific queue name (e.g., \"tasks\")\n  options?: Record<string, any>; // Additional options (e.g., Redis connection options)\n}\n\n/**\n * Queue operation result interface\n */\nexport interface QueueResult<T = any> {\n  data: T | null;\n  error: any | null;\n}\n\n/**\n * Queue client interface\n */\nexport interface QueueClient {\n  push: (item: any) => Promise<QueueResult<number>>;\n  pop: () => Promise<QueueResult<any>>;\n  createQueue?: () => Promise<{ success: boolean; queue_name?: string; error?: any }>;\n}\n\n/**\n * Queue Lattice protocol interface\n */\nexport interface QueueLatticeProtocol\n  extends BaseLatticeProtocol<QueueConfig, QueueClient> {\n  // Queue operations\n  push: (item: any) => Promise<QueueResult<number>>;\n  pop: () => Promise<QueueResult<any>>;\n  createQueue?: () => Promise<{ success: boolean; queue_name?: string; error?: any }>;\n}\n\n\n\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACaO,IAAK,YAAL,kBAAKA,eAAL;AACL,EAAAA,WAAA,WAAQ;AACR,EAAAA,WAAA,gBAAa;AACb,EAAAA,WAAA,kBAAe;AACf,EAAAA,WAAA,gBAAa;AAJH,SAAAA;AAAA,GAAA;AAyEL,SAAS,SAAS,QAAqD;AAC5E,SAAO,OAAO,SAAS;AACzB;AAKO,SAAS,kBACd,QAC2B;AAC3B,SAAO,OAAO,SAAS;AACzB;AAKO,SAAS,mBAAmB,QAA+B;AAChE,MAAI,SAAS,MAAM,GAAG;AACpB,WAAO,OAAO,SAAS,CAAC;AAAA,EAC1B;AACA,SAAO,CAAC;AACV;AAKO,SAAS,uBAAuB,QAA+B;AACpE,MAAI,kBAAkB,MAAM,GAAG;AAC7B,WAAO,OAAO,aAAa,CAAC;AAAA,EAC9B;AACA,SAAO,CAAC;AACV;;;AC1GO,IAAK,aAAL,kBAAKC,gBAAL;AACL,EAAAA,YAAA,gBAAa;AACb,EAAAA,YAAA,eAAY;AACZ,EAAAA,YAAA,cAAW;AACX,EAAAA,YAAA,cAAW;AACX,EAAAA,YAAA,aAAU;AALA,SAAAA;AAAA,GAAA;;;ACAL,IAAK,kBAAL,kBAAKC,qBAAL;AACL,EAAAA,iBAAA,eAAY;AACZ,EAAAA,iBAAA,WAAQ;AACR,EAAAA,iBAAA,YAAS;AACT,EAAAA,iBAAA,UAAO;AACP,EAAAA,iBAAA,WAAQ;AACR,EAAAA,iBAAA,WAAQ;AACR,EAAAA,iBAAA,UAAO;AACP,EAAAA,iBAAA,UAAO;AACP,EAAAA,iBAAA,WAAQ;AACR,EAAAA,iBAAA,YAAS;AAVC,SAAAA;AAAA,GAAA;;;ACAL,IAAK,YAAL,kBAAKC,eAAL;AACL,EAAAA,WAAA,YAAS;AACT,EAAAA,WAAA,WAAQ;AAFE,SAAAA;AAAA,GAAA;","names":["AgentType","MemoryType","UIComponentType","QueueType"]}

package/dist/index.mjs

@@ -35,16 +35,6 @@ var MemoryType = /* @__PURE__ */ ((MemoryType2) => {
   return MemoryType2;
 })(MemoryType || {});
 
-// src/StorageLatticeProtocol.ts
-var StorageType = /* @__PURE__ */ ((StorageType2) => {
-  StorageType2["MEMORY"] = "memory";
-  StorageType2["LOCAL"] = "local";
-  StorageType2["DATABASE"] = "database";
-  StorageType2["CLOUD"] = "cloud";
-  StorageType2["DISTRIBUTED"] = "distributed";
-  return StorageType2;
-})(StorageType || {});
-
 // src/UILatticeProtocol.ts
 var UIComponentType = /* @__PURE__ */ ((UIComponentType2) => {
   UIComponentType2["CONTAINER"] = "container";
@@ -70,7 +60,6 @@ export {
   AgentType,
   MemoryType,
   QueueType,
-  StorageType,
   UIComponentType,
   getSubAgentsFromConfig,
   getToolsFromConfig,

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/AgentLatticeProtocol.ts","../src/MemoryLatticeProtocol.ts","../src/StorageLatticeProtocol.ts","../src/UILatticeProtocol.ts","../src/QueueLatticeProtocol.ts"],"sourcesContent":["/**\n * AgentLatticeProtocol\n *\n * 智能体Lattice的协议，定义了智能体的行为和组合方式\n */\n\nimport { CompiledStateGraph } from \"@langchain/langgraph\";\nimport z, { ZodObject, ZodSchema } from \"zod\";\nimport { BaseLatticeProtocol } from \"./BaseLatticeProtocol\";\n\n/**\n * 智能体类型枚举\n */\nexport enum AgentType {\n  REACT = \"react\",\n  DEEP_AGENT = \"deep_agent\",\n  PLAN_EXECUTE = \"plan_execute\",\n  SEQUENTIAL = \"sequential\",\n}\n\n/**\n * Base agent configuration shared by all agent types\n */\ninterface BaseAgentConfig {\n  key: string; // Unique key\n  name: string; // Name\n  description: string; // Description\n  prompt: string; // Prompt\n  schema?: ZodObject<any, any, any, any, any>; // Input validation schema\n  modelKey?: string; // Model key to use\n}\n\n/**\n * REACT agent configuration\n */\nexport interface ReactAgentConfig extends BaseAgentConfig {\n  type: AgentType.REACT;\n  tools?: string[]; // Tool list\n}\n\n/**\n * DEEP_AGENT configuration - only this type supports subAgents\n */\nexport interface DeepAgentConfig extends BaseAgentConfig {\n  type: AgentType.DEEP_AGENT;\n  tools?: string[]; // Tool list\n  subAgents?: string[]; // Sub-agent list (unique to DEEP_AGENT)\n  internalSubAgents?: AgentConfig[]; // Internal sub-agent list (unique to DEEP_AGENT)\n}\n\n/**\n * PLAN_EXECUTE agent configuration\n */\nexport interface PlanExecuteAgentConfig extends BaseAgentConfig {\n  type: AgentType.PLAN_EXECUTE;\n  tools?: string[]; // Tool list\n}\n\n/**\n * SEQUENTIAL agent configuration\n */\nexport interface SequentialAgentConfig extends BaseAgentConfig {\n  type: AgentType.SEQUENTIAL;\n}\n\n/**\n * Agent configuration union type\n * Different agent types have different configuration options\n */\nexport type AgentConfig =\n  | ReactAgentConfig\n  | DeepAgentConfig\n  | PlanExecuteAgentConfig\n  | SequentialAgentConfig;\n\n/**\n * Agent configuration with tools property\n */\nexport type AgentConfigWithTools =\n  | ReactAgentConfig\n  | DeepAgentConfig\n  | PlanExecuteAgentConfig;\n\n/**\n * Type guard to check if config has tools property\n */\nexport function hasTools(config: AgentConfig): config is AgentConfigWithTools {\n  return config.type !== AgentType.SEQUENTIAL;\n}\n\n/**\n * Type guard to check if config is DeepAgentConfig (has subAgents)\n */\nexport function isDeepAgentConfig(\n  config: AgentConfig\n): config is DeepAgentConfig {\n  return config.type === AgentType.DEEP_AGENT;\n}\n\n/**\n * Get tools from config safely\n */\nexport function getToolsFromConfig(config: AgentConfig): string[] {\n  if (hasTools(config)) {\n    return config.tools || [];\n  }\n  return [];\n}\n\n/**\n * Get subAgents from config safely (only DeepAgentConfig has subAgents)\n */\nexport function getSubAgentsFromConfig(config: AgentConfig): string[] {\n  if (isDeepAgentConfig(config)) {\n    return config.subAgents || [];\n  }\n  return [];\n}\n\n/**\n * 智能体客户端类型\n */\nexport type AgentClient = CompiledStateGraph<any, any, any, any, any>;\n\n/**\n * Graph构建选项\n */\nexport interface GraphBuildOptions {\n  overrideTools?: string[];\n  overrideModel?: string;\n  metadata?: Record<string, any>;\n}\n\n/**\n * 智能体Lattice协议接口\n */\nexport interface AgentLatticeProtocol\n  extends BaseLatticeProtocol<AgentConfig, AgentClient> {\n  // 智能体执行函数\n  invoke: (input: any, options?: any) => Promise<any>;\n\n  // 构建智能体图\n  buildGraph: (options?: GraphBuildOptions) => Promise<AgentClient>;\n}\n","/**\n * MemoryLatticeProtocol\n *\n * 记忆Lattice的协议，用于管理智能体的上下文和记忆\n */\n\nimport { BaseLatticeProtocol } from \"./BaseLatticeProtocol\";\n\n/**\n * 记忆类型枚举\n */\nexport enum MemoryType {\n  SHORT_TERM = \"short_term\",\n  LONG_TERM = \"long_term\",\n  EPISODIC = \"episodic\",\n  SEMANTIC = \"semantic\",\n  WORKING = \"working\",\n}\n\n/**\n * 记忆配置接口\n */\nexport interface MemoryConfig {\n  name: string; // 名称\n  description: string; // 描述\n  type: MemoryType; // 记忆类型\n  ttl?: number; // 生存时间\n  capacity?: number; // 容量限制\n}\n\n/**\n * 记忆客户端接口\n */\nexport interface MemoryClient {\n  add: (key: string, value: any) => Promise<void>;\n  get: (key: string) => Promise<any>;\n  update: (key: string, value: any) => Promise<void>;\n  delete: (key: string) => Promise<void>;\n  search: (query: string, options?: any) => Promise<any[]>;\n  clear: () => Promise<void>;\n}\n\n/**\n * 记忆Lattice协议接口\n */\nexport interface MemoryLatticeProtocol\n  extends BaseLatticeProtocol<MemoryConfig, MemoryClient> {\n  // 记忆操作方法\n  add: (key: string, value: any) => Promise<void>;\n  get: (key: string) => Promise<any>;\n  update: (key: string, value: any) => Promise<void>;\n  delete: (key: string) => Promise<void>;\n  search: (query: string, options?: any) => Promise<any[]>;\n  clear: () => Promise<void>;\n}\n","/**\n * StorageLatticeProtocol\n *\n * 存储Lattice的协议，用于数据持久化和状态管理\n */\n\nimport { BaseLatticeProtocol } from \"./BaseLatticeProtocol\";\n\n/**\n * 存储类型枚举\n */\nexport enum StorageType {\n  MEMORY = \"memory\",\n  LOCAL = \"local\",\n  DATABASE = \"database\",\n  CLOUD = \"cloud\",\n  DISTRIBUTED = \"distributed\",\n}\n\n/**\n * 存储配置接口\n */\nexport interface StorageConfig {\n  name: string; // 名称\n  description: string; // 描述\n  type: StorageType; // 存储类型\n  connectionString?: string; // 连接字符串\n  options?: Record<string, any>; // 其他选项\n}\n\n/**\n * 存储客户端接口\n */\nexport interface StorageClient {\n  set: (key: string, value: any) => Promise<void>;\n  get: (key: string) => Promise<any>;\n  has: (key: string) => Promise<boolean>;\n  delete: (key: string) => Promise<boolean>;\n  clear: () => Promise<void>;\n  transaction: <T>(operations: () => Promise<T>) => Promise<T>;\n}\n\n/**\n * 存储Lattice协议接口\n */\nexport interface StorageLatticeProtocol\n  extends BaseLatticeProtocol<StorageConfig, StorageClient> {\n  // 存储操作方法\n  set: (key: string, value: any) => Promise<void>;\n  get: (key: string) => Promise<any>;\n  has: (key: string) => Promise<boolean>;\n  delete: (key: string) => Promise<boolean>;\n  clear: () => Promise<void>;\n  transaction: <T>(operations: () => Promise<T>) => Promise<T>;\n}\n","/**\n * UILatticeProtocol\n *\n * UI Lattice的协议，用于定义用户界面组件\n */\n\nimport { BaseLatticeProtocol } from \"./BaseLatticeProtocol\";\n\n/**\n * UI组件类型枚举\n */\nexport enum UIComponentType {\n  CONTAINER = \"container\",\n  INPUT = \"input\",\n  BUTTON = \"button\",\n  LIST = \"list\",\n  TABLE = \"table\",\n  CHART = \"chart\",\n  FORM = \"form\",\n  CARD = \"card\",\n  MODAL = \"modal\",\n  CUSTOM = \"custom\",\n}\n\n/**\n * UI配置接口\n */\nexport interface UIConfig {\n  name: string; // 组件名称\n  description: string; // 组件描述\n  type: UIComponentType; // 组件类型\n  props?: Record<string, any>; // 组件属性\n  children?: string[]; // 子组件列表\n}\n\n/**\n * UI组件接口\n * 使用泛型以适应不同的UI框架(React, Vue等)\n */\nexport interface UIComponent<T = any> {\n  render: (props?: any) => T;\n  addEventListener: (event: string, handler: Function) => void;\n  removeEventListener: (event: string, handler: Function) => void;\n}\n\n/**\n * UI Lattice协议接口\n */\nexport interface UILatticeProtocol<T = any>\n  extends BaseLatticeProtocol<UIConfig, UIComponent<T>> {\n  // UI渲染方法\n  render: (props?: any) => T;\n\n  // 事件处理\n  addEventListener: (event: string, handler: Function) => void;\n  removeEventListener: (event: string, handler: Function) => void;\n}\n","/**\n * QueueLatticeProtocol\n *\n * Queue Lattice protocol for task queue management\n */\n\nimport { BaseLatticeProtocol } from \"./BaseLatticeProtocol\";\n\n/**\n * Queue service type enumeration\n */\nexport enum QueueType {\n  MEMORY = \"memory\",\n  REDIS = \"redis\",\n}\n\n/**\n * Queue configuration interface\n */\nexport interface QueueConfig {\n  name: string; // Queue name\n  description: string; // Queue description\n  type: QueueType; // Queue service type\n  queueName?: string; // Specific queue name (e.g., \"tasks\")\n  options?: Record<string, any>; // Additional options (e.g., Redis connection options)\n}\n\n/**\n * Queue operation result interface\n */\nexport interface QueueResult<T = any> {\n  data: T | null;\n  error: any | null;\n}\n\n/**\n * Queue client interface\n */\nexport interface QueueClient {\n  push: (item: any) => Promise<QueueResult<number>>;\n  pop: () => Promise<QueueResult<any>>;\n  createQueue?: () => Promise<{ success: boolean; queue_name?: string; error?: any }>;\n}\n\n/**\n * Queue Lattice protocol interface\n */\nexport interface QueueLatticeProtocol\n  extends BaseLatticeProtocol<QueueConfig, QueueClient> {\n  // Queue operations\n  push: (item: any) => Promise<QueueResult<number>>;\n  pop: () => Promise<QueueResult<any>>;\n  createQueue?: () => Promise<{ success: boolean; queue_name?: string; error?: any }>;\n}\n\n\n\n"],"mappings":";AAaO,IAAK,YAAL,kBAAKA,eAAL;AACL,EAAAA,WAAA,WAAQ;AACR,EAAAA,WAAA,gBAAa;AACb,EAAAA,WAAA,kBAAe;AACf,EAAAA,WAAA,gBAAa;AAJH,SAAAA;AAAA,GAAA;AAyEL,SAAS,SAAS,QAAqD;AAC5E,SAAO,OAAO,SAAS;AACzB;AAKO,SAAS,kBACd,QAC2B;AAC3B,SAAO,OAAO,SAAS;AACzB;AAKO,SAAS,mBAAmB,QAA+B;AAChE,MAAI,SAAS,MAAM,GAAG;AACpB,WAAO,OAAO,SAAS,CAAC;AAAA,EAC1B;AACA,SAAO,CAAC;AACV;AAKO,SAAS,uBAAuB,QAA+B;AACpE,MAAI,kBAAkB,MAAM,GAAG;AAC7B,WAAO,OAAO,aAAa,CAAC;AAAA,EAC9B;AACA,SAAO,CAAC;AACV;;;AC1GO,IAAK,aAAL,kBAAKC,gBAAL;AACL,EAAAA,YAAA,gBAAa;AACb,EAAAA,YAAA,eAAY;AACZ,EAAAA,YAAA,cAAW;AACX,EAAAA,YAAA,cAAW;AACX,EAAAA,YAAA,aAAU;AALA,SAAAA;AAAA,GAAA;;;ACAL,IAAK,cAAL,kBAAKC,iBAAL;AACL,EAAAA,aAAA,YAAS;AACT,EAAAA,aAAA,WAAQ;AACR,EAAAA,aAAA,cAAW;AACX,EAAAA,aAAA,WAAQ;AACR,EAAAA,aAAA,iBAAc;AALJ,SAAAA;AAAA,GAAA;;;ACAL,IAAK,kBAAL,kBAAKC,qBAAL;AACL,EAAAA,iBAAA,eAAY;AACZ,EAAAA,iBAAA,WAAQ;AACR,EAAAA,iBAAA,YAAS;AACT,EAAAA,iBAAA,UAAO;AACP,EAAAA,iBAAA,WAAQ;AACR,EAAAA,iBAAA,WAAQ;AACR,EAAAA,iBAAA,UAAO;AACP,EAAAA,iBAAA,UAAO;AACP,EAAAA,iBAAA,WAAQ;AACR,EAAAA,iBAAA,YAAS;AAVC,SAAAA;AAAA,GAAA;;;ACAL,IAAK,YAAL,kBAAKC,eAAL;AACL,EAAAA,WAAA,YAAS;AACT,EAAAA,WAAA,WAAQ;AAFE,SAAAA;AAAA,GAAA;","names":["AgentType","MemoryType","StorageType","UIComponentType","QueueType"]}
+{"version":3,"sources":["../src/AgentLatticeProtocol.ts","../src/MemoryLatticeProtocol.ts","../src/UILatticeProtocol.ts","../src/QueueLatticeProtocol.ts"],"sourcesContent":["/**\n * AgentLatticeProtocol\n *\n * 智能体Lattice的协议，定义了智能体的行为和组合方式\n */\n\nimport { CompiledStateGraph } from \"@langchain/langgraph\";\nimport z, { ZodObject, ZodSchema } from \"zod\";\nimport { BaseLatticeProtocol } from \"./BaseLatticeProtocol\";\n\n/**\n * 智能体类型枚举\n */\nexport enum AgentType {\n  REACT = \"react\",\n  DEEP_AGENT = \"deep_agent\",\n  PLAN_EXECUTE = \"plan_execute\",\n  SEQUENTIAL = \"sequential\",\n}\n\n/**\n * Base agent configuration shared by all agent types\n */\ninterface BaseAgentConfig {\n  key: string; // Unique key\n  name: string; // Name\n  description: string; // Description\n  prompt: string; // Prompt\n  schema?: ZodObject<any, any, any, any, any>; // Input validation schema\n  modelKey?: string; // Model key to use\n}\n\n/**\n * REACT agent configuration\n */\nexport interface ReactAgentConfig extends BaseAgentConfig {\n  type: AgentType.REACT;\n  tools?: string[]; // Tool list\n}\n\n/**\n * DEEP_AGENT configuration - only this type supports subAgents\n */\nexport interface DeepAgentConfig extends BaseAgentConfig {\n  type: AgentType.DEEP_AGENT;\n  tools?: string[]; // Tool list\n  subAgents?: string[]; // Sub-agent list (unique to DEEP_AGENT)\n  internalSubAgents?: AgentConfig[]; // Internal sub-agent list (unique to DEEP_AGENT)\n}\n\n/**\n * PLAN_EXECUTE agent configuration\n */\nexport interface PlanExecuteAgentConfig extends BaseAgentConfig {\n  type: AgentType.PLAN_EXECUTE;\n  tools?: string[]; // Tool list\n}\n\n/**\n * SEQUENTIAL agent configuration\n */\nexport interface SequentialAgentConfig extends BaseAgentConfig {\n  type: AgentType.SEQUENTIAL;\n}\n\n/**\n * Agent configuration union type\n * Different agent types have different configuration options\n */\nexport type AgentConfig =\n  | ReactAgentConfig\n  | DeepAgentConfig\n  | PlanExecuteAgentConfig\n  | SequentialAgentConfig;\n\n/**\n * Agent configuration with tools property\n */\nexport type AgentConfigWithTools =\n  | ReactAgentConfig\n  | DeepAgentConfig\n  | PlanExecuteAgentConfig;\n\n/**\n * Type guard to check if config has tools property\n */\nexport function hasTools(config: AgentConfig): config is AgentConfigWithTools {\n  return config.type !== AgentType.SEQUENTIAL;\n}\n\n/**\n * Type guard to check if config is DeepAgentConfig (has subAgents)\n */\nexport function isDeepAgentConfig(\n  config: AgentConfig\n): config is DeepAgentConfig {\n  return config.type === AgentType.DEEP_AGENT;\n}\n\n/**\n * Get tools from config safely\n */\nexport function getToolsFromConfig(config: AgentConfig): string[] {\n  if (hasTools(config)) {\n    return config.tools || [];\n  }\n  return [];\n}\n\n/**\n * Get subAgents from config safely (only DeepAgentConfig has subAgents)\n */\nexport function getSubAgentsFromConfig(config: AgentConfig): string[] {\n  if (isDeepAgentConfig(config)) {\n    return config.subAgents || [];\n  }\n  return [];\n}\n\n/**\n * 智能体客户端类型\n */\nexport type AgentClient = CompiledStateGraph<any, any, any, any, any>;\n\n/**\n * Graph构建选项\n */\nexport interface GraphBuildOptions {\n  overrideTools?: string[];\n  overrideModel?: string;\n  metadata?: Record<string, any>;\n}\n\n/**\n * 智能体Lattice协议接口\n */\nexport interface AgentLatticeProtocol\n  extends BaseLatticeProtocol<AgentConfig, AgentClient> {\n  // 智能体执行函数\n  invoke: (input: any, options?: any) => Promise<any>;\n\n  // 构建智能体图\n  buildGraph: (options?: GraphBuildOptions) => Promise<AgentClient>;\n}\n","/**\n * MemoryLatticeProtocol\n *\n * 记忆Lattice的协议，用于管理智能体的上下文和记忆\n */\n\nimport { BaseLatticeProtocol } from \"./BaseLatticeProtocol\";\n\n/**\n * 记忆类型枚举\n */\nexport enum MemoryType {\n  SHORT_TERM = \"short_term\",\n  LONG_TERM = \"long_term\",\n  EPISODIC = \"episodic\",\n  SEMANTIC = \"semantic\",\n  WORKING = \"working\",\n}\n\n/**\n * 记忆配置接口\n */\nexport interface MemoryConfig {\n  name: string; // 名称\n  description: string; // 描述\n  type: MemoryType; // 记忆类型\n  ttl?: number; // 生存时间\n  capacity?: number; // 容量限制\n}\n\n/**\n * 记忆客户端接口\n */\nexport interface MemoryClient {\n  add: (key: string, value: any) => Promise<void>;\n  get: (key: string) => Promise<any>;\n  update: (key: string, value: any) => Promise<void>;\n  delete: (key: string) => Promise<void>;\n  search: (query: string, options?: any) => Promise<any[]>;\n  clear: () => Promise<void>;\n}\n\n/**\n * 记忆Lattice协议接口\n */\nexport interface MemoryLatticeProtocol\n  extends BaseLatticeProtocol<MemoryConfig, MemoryClient> {\n  // 记忆操作方法\n  add: (key: string, value: any) => Promise<void>;\n  get: (key: string) => Promise<any>;\n  update: (key: string, value: any) => Promise<void>;\n  delete: (key: string) => Promise<void>;\n  search: (query: string, options?: any) => Promise<any[]>;\n  clear: () => Promise<void>;\n}\n","/**\n * UILatticeProtocol\n *\n * UI Lattice的协议，用于定义用户界面组件\n */\n\nimport { BaseLatticeProtocol } from \"./BaseLatticeProtocol\";\n\n/**\n * UI组件类型枚举\n */\nexport enum UIComponentType {\n  CONTAINER = \"container\",\n  INPUT = \"input\",\n  BUTTON = \"button\",\n  LIST = \"list\",\n  TABLE = \"table\",\n  CHART = \"chart\",\n  FORM = \"form\",\n  CARD = \"card\",\n  MODAL = \"modal\",\n  CUSTOM = \"custom\",\n}\n\n/**\n * UI配置接口\n */\nexport interface UIConfig {\n  name: string; // 组件名称\n  description: string; // 组件描述\n  type: UIComponentType; // 组件类型\n  props?: Record<string, any>; // 组件属性\n  children?: string[]; // 子组件列表\n}\n\n/**\n * UI组件接口\n * 使用泛型以适应不同的UI框架(React, Vue等)\n */\nexport interface UIComponent<T = any> {\n  render: (props?: any) => T;\n  addEventListener: (event: string, handler: Function) => void;\n  removeEventListener: (event: string, handler: Function) => void;\n}\n\n/**\n * UI Lattice协议接口\n */\nexport interface UILatticeProtocol<T = any>\n  extends BaseLatticeProtocol<UIConfig, UIComponent<T>> {\n  // UI渲染方法\n  render: (props?: any) => T;\n\n  // 事件处理\n  addEventListener: (event: string, handler: Function) => void;\n  removeEventListener: (event: string, handler: Function) => void;\n}\n","/**\n * QueueLatticeProtocol\n *\n * Queue Lattice protocol for task queue management\n */\n\nimport { BaseLatticeProtocol } from \"./BaseLatticeProtocol\";\n\n/**\n * Queue service type enumeration\n */\nexport enum QueueType {\n  MEMORY = \"memory\",\n  REDIS = \"redis\",\n}\n\n/**\n * Queue configuration interface\n */\nexport interface QueueConfig {\n  name: string; // Queue name\n  description: string; // Queue description\n  type: QueueType; // Queue service type\n  queueName?: string; // Specific queue name (e.g., \"tasks\")\n  options?: Record<string, any>; // Additional options (e.g., Redis connection options)\n}\n\n/**\n * Queue operation result interface\n */\nexport interface QueueResult<T = any> {\n  data: T | null;\n  error: any | null;\n}\n\n/**\n * Queue client interface\n */\nexport interface QueueClient {\n  push: (item: any) => Promise<QueueResult<number>>;\n  pop: () => Promise<QueueResult<any>>;\n  createQueue?: () => Promise<{ success: boolean; queue_name?: string; error?: any }>;\n}\n\n/**\n * Queue Lattice protocol interface\n */\nexport interface QueueLatticeProtocol\n  extends BaseLatticeProtocol<QueueConfig, QueueClient> {\n  // Queue operations\n  push: (item: any) => Promise<QueueResult<number>>;\n  pop: () => Promise<QueueResult<any>>;\n  createQueue?: () => Promise<{ success: boolean; queue_name?: string; error?: any }>;\n}\n\n\n\n"],"mappings":";AAaO,IAAK,YAAL,kBAAKA,eAAL;AACL,EAAAA,WAAA,WAAQ;AACR,EAAAA,WAAA,gBAAa;AACb,EAAAA,WAAA,kBAAe;AACf,EAAAA,WAAA,gBAAa;AAJH,SAAAA;AAAA,GAAA;AAyEL,SAAS,SAAS,QAAqD;AAC5E,SAAO,OAAO,SAAS;AACzB;AAKO,SAAS,kBACd,QAC2B;AAC3B,SAAO,OAAO,SAAS;AACzB;AAKO,SAAS,mBAAmB,QAA+B;AAChE,MAAI,SAAS,MAAM,GAAG;AACpB,WAAO,OAAO,SAAS,CAAC;AAAA,EAC1B;AACA,SAAO,CAAC;AACV;AAKO,SAAS,uBAAuB,QAA+B;AACpE,MAAI,kBAAkB,MAAM,GAAG;AAC7B,WAAO,OAAO,aAAa,CAAC;AAAA,EAC9B;AACA,SAAO,CAAC;AACV;;;AC1GO,IAAK,aAAL,kBAAKC,gBAAL;AACL,EAAAA,YAAA,gBAAa;AACb,EAAAA,YAAA,eAAY;AACZ,EAAAA,YAAA,cAAW;AACX,EAAAA,YAAA,cAAW;AACX,EAAAA,YAAA,aAAU;AALA,SAAAA;AAAA,GAAA;;;ACAL,IAAK,kBAAL,kBAAKC,qBAAL;AACL,EAAAA,iBAAA,eAAY;AACZ,EAAAA,iBAAA,WAAQ;AACR,EAAAA,iBAAA,YAAS;AACT,EAAAA,iBAAA,UAAO;AACP,EAAAA,iBAAA,WAAQ;AACR,EAAAA,iBAAA,WAAQ;AACR,EAAAA,iBAAA,UAAO;AACP,EAAAA,iBAAA,UAAO;AACP,EAAAA,iBAAA,WAAQ;AACR,EAAAA,iBAAA,YAAS;AAVC,SAAAA;AAAA,GAAA;;;ACAL,IAAK,YAAL,kBAAKC,eAAL;AACL,EAAAA,WAAA,YAAS;AACT,EAAAA,WAAA,WAAQ;AAFE,SAAAA;AAAA,GAAA;","names":["AgentType","MemoryType","UIComponentType","QueueType"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axiom-lattice/protocols",
-  "version": "2.1.5",
+  "version": "2.1.6",
   "description": "Unified protocol type definitions for Axiom Lattice framework",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/AssistantStoreProtocol.ts

@@ -0,0 +1,113 @@
+/**
+ * AssistantStoreProtocol
+ *
+ * Assistant store protocol definitions for the Axiom Lattice framework
+ * Provides standardized interfaces for assistant management across all implementations
+ */
+
+/**
+ * Assistant type definition
+ */
+export interface Assistant {
+  /**
+   * Assistant identifier
+   */
+  id: string;
+
+  /**
+   * Assistant name
+   */
+  name: string;
+
+  /**
+   * Assistant description
+   */
+  description?: string;
+
+  /**
+   * Graph definition for the assistant
+   */
+  graphDefinition: any;
+
+  /**
+   * Assistant creation timestamp
+   */
+  createdAt: Date;
+
+  /**
+   * Assistant last update timestamp
+   */
+  updatedAt: Date;
+}
+
+/**
+ * Create assistant request type
+ */
+export interface CreateAssistantRequest {
+  /**
+   * Assistant name
+   */
+  name: string;
+
+  /**
+   * Assistant description
+   */
+  description?: string;
+
+  /**
+   * Graph definition for the assistant
+   */
+  graphDefinition: any;
+}
+
+/**
+ * AssistantStore interface
+ * Provides CRUD operations for assistant data
+ */
+export interface AssistantStore {
+  /**
+   * Get all assistants
+   * @returns Array of all assistants
+   */
+  getAllAssistants(): Promise<Assistant[]>;
+
+  /**
+   * Get assistant by ID
+   * @param id Assistant identifier
+   * @returns Assistant if found, undefined otherwise
+   */
+  getAssistantById(id: string): Promise<Assistant | null>;
+
+  /**
+   * Create a new assistant
+   * @param id Assistant identifier
+   * @param data Assistant creation data
+   * @returns Created assistant
+   */
+  createAssistant(id: string, data: CreateAssistantRequest): Promise<Assistant>;
+
+  /**
+   * Update an existing assistant
+   * @param id Assistant identifier
+   * @param updates Partial assistant data to update
+   * @returns Updated assistant if found, null otherwise
+   */
+  updateAssistant(
+    id: string,
+    updates: Partial<CreateAssistantRequest>
+  ): Promise<Assistant | null>;
+
+  /**
+   * Delete an assistant by ID
+   * @param id Assistant identifier
+   * @returns true if deleted, false otherwise
+   */
+  deleteAssistant(id: string): Promise<boolean>;
+
+  /**
+   * Check if assistant exists
+   * @param id Assistant identifier
+   * @returns true if assistant exists, false otherwise
+   */
+  hasAssistant(id: string): Promise<boolean>;
+}

package/src/EmbeddingsLatticeProtocol.ts

@@ -0,0 +1,30 @@
+/**
+ * EmbeddingsLatticeProtocol
+ *
+ * Embeddings Lattice protocol for defining unified interface for embedding models
+ */
+
+import { Embeddings } from "@langchain/core/embeddings";
+import { BaseLatticeProtocol } from "./BaseLatticeProtocol";
+
+/**
+ * Embeddings configuration interface
+ */
+export interface EmbeddingsConfig {
+  name: string; // Embeddings model name
+  description?: string; // Description of the embeddings model
+  dimensions?: number; // Embedding dimensions
+  maxChunkSize?: number; // Maximum chunk size for embedding
+}
+
+/**
+ * Embeddings Lattice protocol interface
+ */
+export interface EmbeddingsLatticeProtocol
+  extends BaseLatticeProtocol<EmbeddingsConfig, Embeddings> {
+  // Embed documents into vectors
+  embedDocuments: (texts: string[]) => Promise<number[][]>;
+
+  // Embed a single query into a vector
+  embedQuery: (text: string) => Promise<number[]>;
+}

package/src/ThreadStoreProtocol.ts

@@ -0,0 +1,113 @@
+/**
+ * ThreadStoreProtocol
+ *
+ * Thread store protocol definitions for the Axiom Lattice framework
+ * Provides standardized interfaces for thread management across all implementations
+ */
+
+/**
+ * Thread type definition
+ */
+export interface Thread {
+  /**
+   * Thread identifier
+   */
+  id: string;
+
+  /**
+   * Assistant identifier this thread belongs to
+   */
+  assistantId: string;
+
+  /**
+   * Thread metadata
+   */
+  metadata?: Record<string, any>;
+
+  /**
+   * Thread creation timestamp
+   */
+  createdAt: Date;
+
+  /**
+   * Thread last update timestamp
+   */
+  updatedAt: Date;
+}
+
+/**
+ * Create thread request type
+ */
+export interface CreateThreadRequest {
+  /**
+   * Thread metadata
+   */
+  metadata?: Record<string, any>;
+}
+
+/**
+ * ThreadStore interface
+ * Provides CRUD operations for thread data
+ * All operations are scoped to an assistant ID
+ */
+export interface ThreadStore {
+  /**
+   * Get all threads for a specific assistant
+   * @param assistantId Assistant identifier
+   * @returns Array of threads for the assistant
+   */
+  getThreadsByAssistantId(assistantId: string): Promise<Thread[]>;
+
+  /**
+   * Get a thread by ID for a specific assistant
+   * @param assistantId Assistant identifier
+   * @param threadId Thread identifier
+   * @returns Thread if found, undefined otherwise
+   */
+  getThreadById(
+    assistantId: string,
+    threadId: string
+  ): Promise<Thread | undefined>;
+
+  /**
+   * Create a new thread for an assistant
+   * @param assistantId Assistant identifier
+   * @param threadId Thread identifier
+   * @param data Thread creation data
+   * @returns Created thread
+   */
+  createThread(
+    assistantId: string,
+    threadId: string,
+    data: CreateThreadRequest
+  ): Promise<Thread>;
+
+  /**
+   * Update an existing thread
+   * @param assistantId Assistant identifier
+   * @param threadId Thread identifier
+   * @param updates Partial thread data to update
+   * @returns Updated thread if found, null otherwise
+   */
+  updateThread(
+    assistantId: string,
+    threadId: string,
+    updates: Partial<CreateThreadRequest>
+  ): Promise<Thread | null>;
+
+  /**
+   * Delete a thread by ID
+   * @param assistantId Assistant identifier
+   * @param threadId Thread identifier
+   * @returns true if deleted, false otherwise
+   */
+  deleteThread(assistantId: string, threadId: string): Promise<boolean>;
+
+  /**
+   * Check if thread exists
+   * @param assistantId Assistant identifier
+   * @param threadId Thread identifier
+   * @returns true if thread exists, false otherwise
+   */
+  hasThread(assistantId: string, threadId: string): Promise<boolean>;
+}

package/src/VectorStoreLatticeProtocol.ts

@@ -0,0 +1,73 @@
+/**
+ * VectorStoreLatticeProtocol
+ *
+ * VectorStore Lattice protocol for defining unified interface for vector store implementations
+ */
+
+import { VectorStore } from "@langchain/core/vectorstores";
+import { DocumentInterface } from "@langchain/core/documents";
+import { BaseLatticeProtocol } from "./BaseLatticeProtocol";
+
+/**
+ * VectorStore configuration interface
+ */
+export interface VectorStoreConfig {
+  name: string; // VectorStore name
+  description?: string; // Description of the vector store
+  type?: string; // Vector store type (e.g., "pinecone", "chroma", "pgvector")
+  config?: Record<string, any>; // Configuration for the vector store
+}
+
+/**
+ * VectorStore Lattice protocol interface
+ */
+export interface VectorStoreLatticeProtocol
+  extends BaseLatticeProtocol<VectorStoreConfig, VectorStore> {
+  // Add precomputed vectors and documents
+  addVectors: (
+    vectors: number[][],
+    documents: DocumentInterface[],
+    options?: Record<string, any>
+  ) => Promise<string[] | void>;
+
+  // Add documents (will be embedded automatically)
+  addDocuments: (
+    documents: DocumentInterface[],
+    options?: Record<string, any>
+  ) => Promise<string[] | void>;
+
+  // Delete documents by parameters
+  delete: (params?: Record<string, any>) => Promise<void>;
+
+  // Similarity search with vector query
+  similaritySearchVectorWithScore: (
+    query: number[],
+    k: number,
+    filter?: VectorStore["FilterType"]
+  ) => Promise<[DocumentInterface, number][]>;
+
+  // Similarity search with text query
+  similaritySearch: (
+    query: string,
+    k?: number,
+    filter?: VectorStore["FilterType"]
+  ) => Promise<DocumentInterface[]>;
+
+  // Similarity search with text query and scores
+  similaritySearchWithScore: (
+    query: string,
+    k?: number,
+    filter?: VectorStore["FilterType"]
+  ) => Promise<[DocumentInterface, number][]>;
+
+  // Maximal marginal relevance search (optional)
+  maxMarginalRelevanceSearch?: (
+    query: string,
+    options: {
+      k: number;
+      fetchK?: number;
+      lambda?: number;
+      filter?: VectorStore["FilterType"];
+    }
+  ) => Promise<DocumentInterface[]>;
+}

package/src/index.ts

@@ -9,10 +9,13 @@ export * from "./ToolLatticeProtocol";
 export * from "./ModelLatticeProtocol";
 export * from "./AgentLatticeProtocol";
 export * from "./MemoryLatticeProtocol";
-export * from "./StorageLatticeProtocol";
 export * from "./UILatticeProtocol";
 export * from "./QueueLatticeProtocol";
+export * from "./EmbeddingsLatticeProtocol";
+export * from "./VectorStoreLatticeProtocol";
 export * from "./MessageProtocol";
+export * from "./ThreadStoreProtocol";
+export * from "./AssistantStoreProtocol";
 
 // 导出通用类型
 export * from "./types";

package/src/StorageLatticeProtocol.ts

@@ -1,55 +0,0 @@
-/**
- * StorageLatticeProtocol
- *
- * 存储Lattice的协议，用于数据持久化和状态管理
- */
-
-import { BaseLatticeProtocol } from "./BaseLatticeProtocol";
-
-/**
- * 存储类型枚举
- */
-export enum StorageType {
-  MEMORY = "memory",
-  LOCAL = "local",
-  DATABASE = "database",
-  CLOUD = "cloud",
-  DISTRIBUTED = "distributed",
-}
-
-/**
- * 存储配置接口
- */
-export interface StorageConfig {
-  name: string; // 名称
-  description: string; // 描述
-  type: StorageType; // 存储类型
-  connectionString?: string; // 连接字符串
-  options?: Record<string, any>; // 其他选项
-}
-
-/**
- * 存储客户端接口
- */
-export interface StorageClient {
-  set: (key: string, value: any) => Promise<void>;
-  get: (key: string) => Promise<any>;
-  has: (key: string) => Promise<boolean>;
-  delete: (key: string) => Promise<boolean>;
-  clear: () => Promise<void>;
-  transaction: <T>(operations: () => Promise<T>) => Promise<T>;
-}
-
-/**
- * 存储Lattice协议接口
- */
-export interface StorageLatticeProtocol
-  extends BaseLatticeProtocol<StorageConfig, StorageClient> {
-  // 存储操作方法
-  set: (key: string, value: any) => Promise<void>;
-  get: (key: string) => Promise<any>;
-  has: (key: string) => Promise<boolean>;
-  delete: (key: string) => Promise<boolean>;
-  clear: () => Promise<void>;
-  transaction: <T>(operations: () => Promise<T>) => Promise<T>;
-}