@axiom-lattice/protocols 2.0.0 → 2.1.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @axiom-lattice/protocols@2.0.0 build /home/runner/work/agentic/agentic/packages/protocols
+> @axiom-lattice/protocols@2.1.0 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     2.67 KB
-CJS dist/index.js.map 6.50 KB
-CJS ⚡️ Build success in 40ms
-ESM dist/index.mjs     1.56 KB
-ESM dist/index.mjs.map 5.98 KB
-ESM ⚡️ Build success in 41ms
+CJS dist/index.js     3.34 KB
+CJS dist/index.js.map 8.90 KB
+CJS ⚡️ Build success in 38ms
+ESM dist/index.mjs     2.06 KB
+ESM dist/index.mjs.map 8.37 KB
+ESM ⚡️ Build success in 39ms
 DTS Build start
-DTS ⚡️ Build success in 2454ms
-DTS dist/index.d.ts  10.37 KB
-DTS dist/index.d.mts 10.37 KB
+DTS ⚡️ Build success in 2277ms
+DTS dist/index.d.ts  12.11 KB
+DTS dist/index.d.mts 12.11 KB

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @axiom-lattice/protocols
 
+## 2.1.0
+
+### Minor Changes
+
+- a6ec6b6: enhance deepagent and ui
+
+## 2.0.1
+
+### Patch Changes
+
+- 31df9b6: enhance deep agent
+
 ## 2.0.0
 
 ### Major Changes

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { StructuredTool } from '@langchain/core/tools';
-import z, { ZodSchema } from 'zod';
+import { ZodSchema, ZodObject } from 'zod';
 import { BaseChatModel } from '@langchain/core/language_models/chat_models';
 import { BaseMessage as BaseMessage$1 } from '@langchain/core/messages';
 import { ChatResult } from '@langchain/core/outputs';
@@ -123,19 +123,70 @@ declare enum AgentType {
     SEQUENTIAL = "sequential"
 }
 /**
- * 智能体配置接口
+ * Base agent configuration shared by all agent types
  */
-interface AgentConfig {
+interface BaseAgentConfig {
     key: string;
     name: string;
     description: string;
-    type: AgentType;
-    tools?: string[];
-    subAgents?: string[];
     prompt: string;
-    schema?: z.ZodObject<any, any, any, any, any>;
+    schema?: ZodObject<any, any, any, any, any>;
     modelKey?: string;
 }
+/**
+ * REACT agent configuration
+ */
+interface ReactAgentConfig extends BaseAgentConfig {
+    type: AgentType.REACT;
+    tools?: string[];
+}
+/**
+ * DEEP_AGENT configuration - only this type supports subAgents
+ */
+interface DeepAgentConfig extends BaseAgentConfig {
+    type: AgentType.DEEP_AGENT;
+    tools?: string[];
+    subAgents?: string[];
+    internalSubAgents?: AgentConfig[];
+}
+/**
+ * PLAN_EXECUTE agent configuration
+ */
+interface PlanExecuteAgentConfig extends BaseAgentConfig {
+    type: AgentType.PLAN_EXECUTE;
+    tools?: string[];
+}
+/**
+ * SEQUENTIAL agent configuration
+ */
+interface SequentialAgentConfig extends BaseAgentConfig {
+    type: AgentType.SEQUENTIAL;
+}
+/**
+ * Agent configuration union type
+ * Different agent types have different configuration options
+ */
+type AgentConfig = ReactAgentConfig | DeepAgentConfig | PlanExecuteAgentConfig | SequentialAgentConfig;
+/**
+ * Agent configuration with tools property
+ */
+type AgentConfigWithTools = ReactAgentConfig | DeepAgentConfig | PlanExecuteAgentConfig;
+/**
+ * Type guard to check if config has tools property
+ */
+declare function hasTools(config: AgentConfig): config is AgentConfigWithTools;
+/**
+ * Type guard to check if config is DeepAgentConfig (has subAgents)
+ */
+declare function isDeepAgentConfig(config: AgentConfig): config is DeepAgentConfig;
+/**
+ * Get tools from config safely
+ */
+declare function getToolsFromConfig(config: AgentConfig): string[];
+/**
+ * Get subAgents from config safely (only DeepAgentConfig has subAgents)
+ */
+declare function getSubAgentsFromConfig(config: AgentConfig): string[];
 /**
  * 智能体客户端类型
  */
@@ -465,4 +516,4 @@ type Timestamp = number;
  */
 type Callback<T = any, R = void> = (data: T) => R | Promise<R>;
 
-export { type AgentClient, type AgentConfig, type AgentLatticeProtocol, AgentType, type AssistantMessage, type BaseLatticeProtocol, type BaseMessage, type Callback, type DeveloperMessage, type FilterCondition, type GraphBuildOptions, type ID, 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 QueryParams, type Result, 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 };
+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 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 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 };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { StructuredTool } from '@langchain/core/tools';
-import z, { ZodSchema } from 'zod';
+import { ZodSchema, ZodObject } from 'zod';
 import { BaseChatModel } from '@langchain/core/language_models/chat_models';
 import { BaseMessage as BaseMessage$1 } from '@langchain/core/messages';
 import { ChatResult } from '@langchain/core/outputs';
@@ -123,19 +123,70 @@ declare enum AgentType {
     SEQUENTIAL = "sequential"
 }
 /**
- * 智能体配置接口
+ * Base agent configuration shared by all agent types
  */
-interface AgentConfig {
+interface BaseAgentConfig {
     key: string;
     name: string;
     description: string;
-    type: AgentType;
-    tools?: string[];
-    subAgents?: string[];
     prompt: string;
-    schema?: z.ZodObject<any, any, any, any, any>;
+    schema?: ZodObject<any, any, any, any, any>;
     modelKey?: string;
 }
+/**
+ * REACT agent configuration
+ */
+interface ReactAgentConfig extends BaseAgentConfig {
+    type: AgentType.REACT;
+    tools?: string[];
+}
+/**
+ * DEEP_AGENT configuration - only this type supports subAgents
+ */
+interface DeepAgentConfig extends BaseAgentConfig {
+    type: AgentType.DEEP_AGENT;
+    tools?: string[];
+    subAgents?: string[];
+    internalSubAgents?: AgentConfig[];
+}
+/**
+ * PLAN_EXECUTE agent configuration
+ */
+interface PlanExecuteAgentConfig extends BaseAgentConfig {
+    type: AgentType.PLAN_EXECUTE;
+    tools?: string[];
+}
+/**
+ * SEQUENTIAL agent configuration
+ */
+interface SequentialAgentConfig extends BaseAgentConfig {
+    type: AgentType.SEQUENTIAL;
+}
+/**
+ * Agent configuration union type
+ * Different agent types have different configuration options
+ */
+type AgentConfig = ReactAgentConfig | DeepAgentConfig | PlanExecuteAgentConfig | SequentialAgentConfig;
+/**
+ * Agent configuration with tools property
+ */
+type AgentConfigWithTools = ReactAgentConfig | DeepAgentConfig | PlanExecuteAgentConfig;
+/**
+ * Type guard to check if config has tools property
+ */
+declare function hasTools(config: AgentConfig): config is AgentConfigWithTools;
+/**
+ * Type guard to check if config is DeepAgentConfig (has subAgents)
+ */
+declare function isDeepAgentConfig(config: AgentConfig): config is DeepAgentConfig;
+/**
+ * Get tools from config safely
+ */
+declare function getToolsFromConfig(config: AgentConfig): string[];
+/**
+ * Get subAgents from config safely (only DeepAgentConfig has subAgents)
+ */
+declare function getSubAgentsFromConfig(config: AgentConfig): string[];
 /**
  * 智能体客户端类型
  */
@@ -465,4 +516,4 @@ type Timestamp = number;
  */
 type Callback<T = any, R = void> = (data: T) => R | Promise<R>;
 
-export { type AgentClient, type AgentConfig, type AgentLatticeProtocol, AgentType, type AssistantMessage, type BaseLatticeProtocol, type BaseMessage, type Callback, type DeveloperMessage, type FilterCondition, type GraphBuildOptions, type ID, 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 QueryParams, type Result, 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 };
+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 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 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 };

package/dist/index.js

@@ -23,7 +23,11 @@ __export(index_exports, {
   AgentType: () => AgentType,
   MemoryType: () => MemoryType,
   StorageType: () => StorageType,
-  UIComponentType: () => UIComponentType
+  UIComponentType: () => UIComponentType,
+  getSubAgentsFromConfig: () => getSubAgentsFromConfig,
+  getToolsFromConfig: () => getToolsFromConfig,
+  hasTools: () => hasTools,
+  isDeepAgentConfig: () => isDeepAgentConfig
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -35,6 +39,24 @@ var AgentType = /* @__PURE__ */ ((AgentType2) => {
   AgentType2["SEQUENTIAL"] = "sequential";
   return AgentType2;
 })(AgentType || {});
+function hasTools(config) {
+  return config.type !== "sequential" /* SEQUENTIAL */;
+}
+function isDeepAgentConfig(config) {
+  return config.type === "deep_agent" /* DEEP_AGENT */;
+}
+function getToolsFromConfig(config) {
+  if (hasTools(config)) {
+    return config.tools || [];
+  }
+  return [];
+}
+function getSubAgentsFromConfig(config) {
+  if (isDeepAgentConfig(config)) {
+    return config.subAgents || [];
+  }
+  return [];
+}
 
 // src/MemoryLatticeProtocol.ts
 var MemoryType = /* @__PURE__ */ ((MemoryType2) => {
@@ -75,6 +97,10 @@ var UIComponentType = /* @__PURE__ */ ((UIComponentType2) => {
   AgentType,
   MemoryType,
   StorageType,
-  UIComponentType
+  UIComponentType,
+  getSubAgentsFromConfig,
+  getToolsFromConfig,
+  hasTools,
+  isDeepAgentConfig
 });
 //# sourceMappingURL=index.js.map

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"],"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 \"./MessageProtocol\";\n\n// 导出通用类型\nexport * from \"./types\";\n","/**\n * AgentLatticeProtocol\n *\n * 智能体Lattice的协议，定义了智能体的行为和组合方式\n */\n\nimport { CompiledStateGraph } from \"@langchain/langgraph\";\nimport z, { 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 * 智能体配置接口\n */\nexport interface AgentConfig {\n  key: string; // 唯一键\n  name: string; // 名称\n  description: string; // 描述\n  type: AgentType; // 智能体类型\n  tools?: string[]; // 使用的工具列表\n  subAgents?: string[]; // 子智能体列表\n  prompt: string; // 提示词\n  schema?: z.ZodObject<any, any, any, any, any>; // 输入验证模式\n  modelKey?: string; // 使用的模型键\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"],"mappings":";;;;;;;;;;;;;;;;;;;;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;;;ACFL,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;","names":["AgentType","MemoryType","StorageType","UIComponentType"]}
+{"version":3,"sources":["../src/index.ts","../src/AgentLatticeProtocol.ts","../src/MemoryLatticeProtocol.ts","../src/StorageLatticeProtocol.ts","../src/UILatticeProtocol.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 \"./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"],"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,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;","names":["AgentType","MemoryType","StorageType","UIComponentType"]}

package/dist/index.mjs

@@ -6,6 +6,24 @@ var AgentType = /* @__PURE__ */ ((AgentType2) => {
   AgentType2["SEQUENTIAL"] = "sequential";
   return AgentType2;
 })(AgentType || {});
+function hasTools(config) {
+  return config.type !== "sequential" /* SEQUENTIAL */;
+}
+function isDeepAgentConfig(config) {
+  return config.type === "deep_agent" /* DEEP_AGENT */;
+}
+function getToolsFromConfig(config) {
+  if (hasTools(config)) {
+    return config.tools || [];
+  }
+  return [];
+}
+function getSubAgentsFromConfig(config) {
+  if (isDeepAgentConfig(config)) {
+    return config.subAgents || [];
+  }
+  return [];
+}
 
 // src/MemoryLatticeProtocol.ts
 var MemoryType = /* @__PURE__ */ ((MemoryType2) => {
@@ -45,6 +63,10 @@ export {
   AgentType,
   MemoryType,
   StorageType,
-  UIComponentType
+  UIComponentType,
+  getSubAgentsFromConfig,
+  getToolsFromConfig,
+  hasTools,
+  isDeepAgentConfig
 };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/AgentLatticeProtocol.ts","../src/MemoryLatticeProtocol.ts","../src/StorageLatticeProtocol.ts","../src/UILatticeProtocol.ts"],"sourcesContent":["/**\n * AgentLatticeProtocol\n *\n * 智能体Lattice的协议，定义了智能体的行为和组合方式\n */\n\nimport { CompiledStateGraph } from \"@langchain/langgraph\";\nimport z, { 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 * 智能体配置接口\n */\nexport interface AgentConfig {\n  key: string; // 唯一键\n  name: string; // 名称\n  description: string; // 描述\n  type: AgentType; // 智能体类型\n  tools?: string[]; // 使用的工具列表\n  subAgents?: string[]; // 子智能体列表\n  prompt: string; // 提示词\n  schema?: z.ZodObject<any, any, any, any, any>; // 输入验证模式\n  modelKey?: string; // 使用的模型键\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"],"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;;;ACFL,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;","names":["AgentType","MemoryType","StorageType","UIComponentType"]}
+{"version":3,"sources":["../src/AgentLatticeProtocol.ts","../src/MemoryLatticeProtocol.ts","../src/StorageLatticeProtocol.ts","../src/UILatticeProtocol.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"],"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;","names":["AgentType","MemoryType","StorageType","UIComponentType"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axiom-lattice/protocols",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Unified protocol type definitions for Axiom Lattice framework",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -21,9 +21,9 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@langchain/core": "^0.3.72",
-    "@langchain/langgraph": "^0.4.6",
-    "zod": "^3.24.2"
+    "@langchain/core": "1.1.4",
+    "@langchain/langgraph": "1.0.4",
+    "zod": "3.25.76"
   },
   "devDependencies": {
     "@types/jest": "^29.5.12",
@@ -34,9 +34,9 @@
     "typescript": "^5.4.2"
   },
   "peerDependencies": {
-    "@langchain/core": "^0.3.72",
-    "@langchain/langgraph": "^0.4.6",
-    "zod": "^3.24.2"
+    "@langchain/core": "1.1.4",
+    "@langchain/langgraph": "1.0.4",
+    "zod": "3.25.76"
   },
   "scripts": {
     "build": "tsup src/index.ts --format cjs,esm --dts --sourcemap",

package/src/AgentLatticeProtocol.ts

@@ -5,7 +5,7 @@
  */
 
 import { CompiledStateGraph } from "@langchain/langgraph";
-import z, { ZodSchema } from "zod";
+import z, { ZodObject, ZodSchema } from "zod";
 import { BaseLatticeProtocol } from "./BaseLatticeProtocol";
 
 /**
@@ -19,18 +19,102 @@ export enum AgentType {
 }
 
 /**
- * 智能体配置接口
+ * Base agent configuration shared by all agent types
  */
-export interface AgentConfig {
-  key: string; // 唯一键
-  name: string; // 名称
-  description: string; // 描述
-  type: AgentType; // 智能体类型
-  tools?: string[]; // 使用的工具列表
-  subAgents?: string[]; // 子智能体列表
-  prompt: string; // 提示词
-  schema?: z.ZodObject<any, any, any, any, any>; // 输入验证模式
-  modelKey?: string; // 使用的模型键
+interface BaseAgentConfig {
+  key: string; // Unique key
+  name: string; // Name
+  description: string; // Description
+  prompt: string; // Prompt
+  schema?: ZodObject<any, any, any, any, any>; // Input validation schema
+  modelKey?: string; // Model key to use
+}
+
+/**
+ * REACT agent configuration
+ */
+export interface ReactAgentConfig extends BaseAgentConfig {
+  type: AgentType.REACT;
+  tools?: string[]; // Tool list
+}
+
+/**
+ * DEEP_AGENT configuration - only this type supports subAgents
+ */
+export interface DeepAgentConfig extends BaseAgentConfig {
+  type: AgentType.DEEP_AGENT;
+  tools?: string[]; // Tool list
+  subAgents?: string[]; // Sub-agent list (unique to DEEP_AGENT)
+  internalSubAgents?: AgentConfig[]; // Internal sub-agent list (unique to DEEP_AGENT)
+}
+
+/**
+ * PLAN_EXECUTE agent configuration
+ */
+export interface PlanExecuteAgentConfig extends BaseAgentConfig {
+  type: AgentType.PLAN_EXECUTE;
+  tools?: string[]; // Tool list
+}
+
+/**
+ * SEQUENTIAL agent configuration
+ */
+export interface SequentialAgentConfig extends BaseAgentConfig {
+  type: AgentType.SEQUENTIAL;
+}
+
+/**
+ * Agent configuration union type
+ * Different agent types have different configuration options
+ */
+export type AgentConfig =
+  | ReactAgentConfig
+  | DeepAgentConfig
+  | PlanExecuteAgentConfig
+  | SequentialAgentConfig;
+
+/**
+ * Agent configuration with tools property
+ */
+export type AgentConfigWithTools =
+  | ReactAgentConfig
+  | DeepAgentConfig
+  | PlanExecuteAgentConfig;
+
+/**
+ * Type guard to check if config has tools property
+ */
+export function hasTools(config: AgentConfig): config is AgentConfigWithTools {
+  return config.type !== AgentType.SEQUENTIAL;
+}
+
+/**
+ * Type guard to check if config is DeepAgentConfig (has subAgents)
+ */
+export function isDeepAgentConfig(
+  config: AgentConfig
+): config is DeepAgentConfig {
+  return config.type === AgentType.DEEP_AGENT;
+}
+
+/**
+ * Get tools from config safely
+ */
+export function getToolsFromConfig(config: AgentConfig): string[] {
+  if (hasTools(config)) {
+    return config.tools || [];
+  }
+  return [];
+}
+
+/**
+ * Get subAgents from config safely (only DeepAgentConfig has subAgents)
+ */
+export function getSubAgentsFromConfig(config: AgentConfig): string[] {
+  if (isDeepAgentConfig(config)) {
+    return config.subAgents || [];
+  }
+  return [];
 }
 
 /**

package/src/examples/MessageProtocolExample.ts

@@ -1,183 +0,0 @@
-/**
- * MessageProtocol Example
- *
- * Demonstrates how to use MessageProtocol for message interaction
- */
-
-import {
-  Message,
-  UserMessage,
-  AssistantMessage,
-  SystemMessage,
-  ToolMessage,
-  ToolCall,
-  MessageEventType,
-  MessagesSnapshotEvent,
-} from "../MessageProtocol";
-
-// Example 1: Basic message interaction
-function basicMessageExample() {
-  // Create a simple conversation
-  const conversation: Message[] = [
-    // System message
-    {
-      id: "sys_1",
-      role: "system",
-      content: "You are a helpful AI assistant.",
-    },
-
-    // User message
-    {
-      id: "user_1",
-      role: "user",
-      content: "Can you help me check the weather in New York?",
-    },
-
-    // Assistant message (with tool call)
-    {
-      id: "asst_1",
-      role: "assistant",
-      content: "Let me check the weather for you.",
-      toolCalls: [
-        {
-          id: "tool_call_1",
-          type: "function",
-          function: {
-            name: "get_weather",
-            arguments: '{"location": "New York", "unit": "celsius"}',
-          },
-        },
-      ],
-    },
-
-    // Tool message (tool execution result)
-    {
-      id: "tool_1",
-      role: "tool",
-      content:
-        '{"temperature": 22, "condition": "Partly Cloudy", "humidity": 65}',
-      toolCallId: "tool_call_1",
-    },
-
-    // Assistant final response
-    {
-      id: "asst_2",
-      role: "assistant",
-      content:
-        "The weather in New York is partly cloudy with a temperature of 22°C and 65% humidity.",
-    },
-  ];
-
-  return conversation;
-}
-
-// Example 2: Message conversion (vendor neutrality)
-function vendorNeutralityExample() {
-  const agUiMessages = basicMessageExample();
-
-  // Convert to OpenAI format
-  const openaiMessages = agUiMessages
-    .filter((msg) => ["user", "system", "assistant"].includes(msg.role))
-    .map((msg) => ({
-      role: msg.role as "user" | "system" | "assistant",
-      content: msg.content || "",
-      // Map tool calls if present
-      ...(msg.role === "assistant" && (msg as AssistantMessage).toolCalls
-        ? {
-            tool_calls: (msg as AssistantMessage).toolCalls?.map((tc) => ({
-              id: tc.id,
-              type: tc.type,
-              function: {
-                name: tc.function.name,
-                arguments: tc.function.arguments,
-              },
-            })),
-          }
-        : {}),
-    }));
-
-  return { agUiMessages, openaiMessages };
-}
-
-// Example 3: Message event handling
-function messageEventsExample() {
-  // Message snapshot event
-  const snapshotEvent: MessagesSnapshotEvent = {
-    type: MessageEventType.MESSAGES_SNAPSHOT,
-    messages: basicMessageExample(),
-  };
-
-  // Handle events
-  function handleEvent(event: any) {
-    switch (event.type) {
-      case MessageEventType.MESSAGES_SNAPSHOT:
-        console.log(
-          "Received message snapshot with",
-          event.messages.length,
-          "messages"
-        );
-        break;
-      case MessageEventType.TEXT_MESSAGE_START:
-        console.log(
-          "New message started:",
-          event.messageId,
-          "role:",
-          event.role
-        );
-        break;
-      case MessageEventType.TEXT_MESSAGE_CONTENT:
-        console.log("Message content:", event.messageId, "delta:", event.delta);
-        break;
-      case MessageEventType.TEXT_MESSAGE_END:
-        console.log("Message ended:", event.messageId);
-        break;
-      // Other event handling...
-    }
-  }
-
-  // Simulate event handling
-  handleEvent(snapshotEvent);
-}
-
-// Example 4: Streaming message handling
-function streamingMessageExample() {
-  // Simulate streaming message processing
-  const messageId = "stream_msg_1";
-  const chunks = [
-    "Hello",
-    ", I am ",
-    "an AI assistant",
-    ". How ",
-    "can I help ",
-    "you today?",
-  ];
-
-  // Start message
-  console.log({
-    type: MessageEventType.TEXT_MESSAGE_START,
-    messageId,
-    role: "assistant",
-  });
-
-  // Stream content
-  chunks.forEach((chunk) => {
-    console.log({
-      type: MessageEventType.TEXT_MESSAGE_CONTENT,
-      messageId,
-      delta: chunk,
-    });
-  });
-
-  // End message
-  console.log({
-    type: MessageEventType.TEXT_MESSAGE_END,
-    messageId,
-  });
-}
-
-export {
-  basicMessageExample,
-  vendorNeutralityExample,
-  messageEventsExample,
-  streamingMessageExample,
-};