@axiom-lattice/protocols 2.1.5 → 2.1.7

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.7 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
+CJS dist/index.js     3.42 KB
+CJS dist/index.js.map 12.14 KB
+CJS ⚡️ Build success in 44ms
+ESM dist/index.mjs     2.11 KB
+ESM dist/index.mjs.map 11.38 KB
+ESM ⚡️ Build success in 45ms
 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 2322ms
+DTS dist/index.d.ts  22.08 KB
+DTS dist/index.d.mts 22.08 KB

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @axiom-lattice/protocols
 
+## 2.1.7
+
+### Patch Changes
+
+- e26be9a: publish web
+
+## 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,154 @@ interface QueueLatticeProtocol extends BaseLatticeProtocol<QueueConfig, QueueCli
     }>;
 }
 
+/**
+ * ScheduleLatticeProtocol
+ *
+ * Schedule Lattice protocol for delayed task execution management
+ */
+
+/**
+ * Schedule service type enumeration
+ */
+declare enum ScheduleType {
+    MEMORY = "memory"
+}
+/**
+ * Schedule configuration interface
+ */
+interface ScheduleConfig {
+    name: string;
+    description: string;
+    type: ScheduleType;
+    options?: Record<string, any>;
+}
+/**
+ * Scheduled task information interface
+ */
+interface ScheduledTaskInfo {
+    taskId: string;
+    scheduledAt: number;
+    timeoutMs: number;
+    remainingMs: number;
+}
+/**
+ * Schedule client interface
+ */
+interface ScheduleClient {
+    /**
+     * Register a function to be executed after the specified timeout
+     * @param taskId - Unique identifier for the task
+     * @param callback - Function to execute when timeout expires
+     * @param timeoutMs - Delay in milliseconds before execution
+     * @returns true if registered successfully
+     */
+    register: (taskId: string, callback: () => void | Promise<void>, timeoutMs: number) => boolean;
+    /**
+     * Cancel a scheduled task by its ID
+     * @param taskId - The task identifier to cancel
+     * @returns true if task was found and cancelled, false otherwise
+     */
+    cancel: (taskId: string) => boolean;
+    /**
+     * Check if a task is currently scheduled
+     * @param taskId - The task identifier to check
+     */
+    has: (taskId: string) => boolean;
+    /**
+     * Get the remaining time in milliseconds for a scheduled task
+     * @param taskId - The task identifier
+     * @returns Remaining time in ms, or -1 if task not found
+     */
+    getRemainingTime: (taskId: string) => number;
+    /**
+     * Get the count of currently scheduled tasks
+     */
+    getTaskCount: () => number;
+    /**
+     * Get all scheduled task IDs
+     */
+    getTaskIds: () => string[];
+    /**
+     * Cancel all scheduled tasks
+     */
+    cancelAll: () => void;
+    /**
+     * Get task information
+     * @param taskId - The task identifier
+     * @returns Task info or null if not found
+     */
+    getTaskInfo?: (taskId: string) => ScheduledTaskInfo | null;
+}
+/**
+ * Schedule Lattice protocol interface
+ */
+interface ScheduleLatticeProtocol extends BaseLatticeProtocol<ScheduleConfig, ScheduleClient> {
+    register: (taskId: string, callback: () => void | Promise<void>, timeoutMs: number) => boolean;
+    cancel: (taskId: string) => boolean;
+    has: (taskId: string) => boolean;
+    getRemainingTime: (taskId: string) => number;
+    getTaskCount: () => number;
+    getTaskIds: () => string[];
+    cancelAll: () => void;
+    getTaskInfo?: (taskId: string) => ScheduledTaskInfo | null;
+}
+
+/**
+ * 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 +615,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 +865,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 ScheduleClient, type ScheduleConfig, type ScheduleLatticeProtocol, ScheduleType, type ScheduledTaskInfo, 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 };