@axiom-lattice/protocols 2.1.20 → 2.1.21

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @axiom-lattice/protocols@2.1.20 build /home/runner/work/agentic/agentic/packages/protocols
+> @axiom-lattice/protocols@2.1.21 build /home/runner/work/agentic/agentic/packages/protocols
 > tsup src/index.ts --format cjs,esm --dts --sourcemap
 
 CLI Building entry: src/index.ts
@@ -9,12 +9,12 @@
 CJS Build start
 ESM Build start
 CJS dist/index.js     5.20 KB
-CJS dist/index.js.map 31.74 KB
-CJS ⚡️ Build success in 66ms
+CJS dist/index.js.map 32.36 KB
+CJS ⚡️ Build success in 68ms
 ESM dist/index.mjs     3.67 KB
-ESM dist/index.mjs.map 30.47 KB
-ESM ⚡️ Build success in 67ms
+ESM dist/index.mjs.map 31.09 KB
+ESM ⚡️ Build success in 69ms
 DTS Build start
-DTS ⚡️ Build success in 2739ms
-DTS dist/index.d.ts  72.94 KB
-DTS dist/index.d.mts 72.94 KB
+DTS ⚡️ Build success in 3039ms
+DTS dist/index.d.ts  75.49 KB
+DTS dist/index.d.mts 75.49 KB

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @axiom-lattice/protocols
 
+## 2.1.21
+
+### Patch Changes
+
+- 1502b21: update all
+
 ## 2.1.20
 
 ### Patch Changes

package/dist/index.d.mts

@@ -101,6 +101,8 @@ interface LLMConfig {
     apiKeyEnvName?: string;
     apiKey?: string;
     baseURL?: string;
+    modelKwargs?: Record<string, any>;
+    extra?: Record<string, any>;
 }
 /**
  * 模型Lattice协议接口
@@ -182,7 +184,7 @@ interface MetricsMiddlewareConfig {
     /** Optional descriptions for each server */
     serverDescriptions?: Record<string, string>;
 }
-type MiddlewareType = "filesystem" | "code_eval" | "browser" | "sql" | "skill" | "http" | "custom" | "metrics" | "ask_user_to_clarify";
+type MiddlewareType = "filesystem" | "code_eval" | "browser" | "sql" | "skill" | "http" | "custom" | "metrics" | "ask_user_to_clarify" | "widget";
 interface AgentMiddlewareConfig {
     id: string;
     type: MiddlewareType;
@@ -191,6 +193,24 @@ interface AgentMiddlewareConfig {
     enabled: boolean;
     config: SandboxMiddlewareConfig | CodeEvalMiddlewareConfig | BrowserMiddlewareConfig | SqlMiddlewareConfig | MetricsMiddlewareConfig | Record<string, any>;
 }
+/**
+ * Bootstrap file configuration
+ * Defines default content for project bootstrap files
+ */
+interface BootstrapFilesConfig {
+    /** Default content for AGENTS.md - operating instructions */
+    agents?: string;
+    /** Default content for SOUL.md - personality and tone */
+    soul?: string;
+    /** Default content for IDENTITY.md - agent identity */
+    identity?: string;
+    /** Default content for USER.md - user preferences */
+    user?: string;
+    /** Default content for TOOLS.md - tool documentation */
+    tools?: string;
+    /** Default content for BOOTSTRAP.md - first-run tasks */
+    bootstrap?: string;
+}
 /**
  * REACT agent configuration
  */
@@ -2125,6 +2145,17 @@ interface SemanticMetricsFilter {
     /** Values for the filter */
     values: (string | number | boolean)[];
 }
+/**
+ * Query result format options
+ */
+type QueryResultFormat = 'array' | 'object' | 'both';
+/**
+ * Column definition
+ */
+interface MetricColumn {
+    name: string;
+    type: string;
+}
 /**
  * Request body for semantic metrics query
  */
@@ -2139,63 +2170,44 @@ interface SemanticMetricsQueryRequest {
     filters?: SemanticMetricsFilter[];
     /** Optional result limit */
     limit?: number;
-}
-/**
- * Single data point in semantic metrics query response
- */
-interface SemanticMetricDataPoint {
-    /** Timestamp in milliseconds */
-    timestamp?: number;
-    /** Metric value */
-    value: number;
-    /** Metric name */
-    metricName?: string;
-    /** Additional dimension values */
-    labels?: Record<string, string>;
-    /** Group by dimension values */
-    groupByValues?: Record<string, string>;
-}
-/**
- * AI Hints for a single metric result
- */
-interface SemanticMetricAiHints {
-    polarity: string;
-    valueInterpretation: string;
-    thresholds?: Array<{
-        metric: string;
-        operator: string;
-        value: number;
-        level: string;
-    }>;
-    suggestedFollowup?: string[];
-}
-/**
- * Single metric result from semantic metrics query
- */
-interface SemanticMetricResult {
-    metricName: string;
-    displayName: string;
-    dataType: string;
-    format: string;
-    polarity: string;
-    columns: string[];
-    rows: Array<Record<string, unknown>>;
-    rowCount: number;
-    executionTimeMs: number;
-    aiHints: SemanticMetricAiHints;
+    /** Optional format specification - defaults to 'array' */
+    format?: QueryResultFormat;
 }
 /**
  * Response from semantic metrics query
+ *
+ * Note: The actual API response format has changed from the original design.
+ * It now returns a flat structure with columns and rows arrays.
+ *
+ * Based on format parameter:
+ * - 'array' (default): returns rows as array of arrays
+ * - 'object': returns rowsObject as array of objects
+ * - 'both': returns both formats
  */
 interface SemanticMetricsQueryResponse {
-    /** Data source ID that was queried */
-    datasourceId: string | number;
-    /** Data source name */
-    datasourceName?: string;
-    /** Query results for each metric */
-    results: SemanticMetricResult[];
-    /** Total execution time in ms */
-    totalExecutionTimeMs?: number;
+    /** Semantic model name that was queried */
+    semanticModel: string;
+    /** Column definitions with name and type */
+    columns: MetricColumn[];
+    /** Number of rows returned */
+    rowCount: number;
+    /** Execution time in milliseconds */
+    executionTimeMs?: number;
+    /**
+     * Data rows as arrays (each row is an array of values corresponding to columns)
+     * Present when format is 'array' or 'both'
+     */
+    rows?: Array<Array<unknown>>;
+    /**
+     * Data rows as objects (each row is {columnName: value})
+     * Present when format is 'object' or 'both'
+     */
+    rowsObject?: Array<Record<string, unknown>>;
+    /** Debug information (optional) */
+    debug?: {
+        sql?: string;
+        params?: unknown;
+    };
 }
 /**
  * Request body for executing custom SQL query
@@ -2209,22 +2221,83 @@ interface ExecuteSqlQueryRequest {
     params?: Record<string, string | number | boolean>;
     /** Optional result limit */
     limit?: number;
+    /** Optional format specification - defaults to 'object' */
+    format?: QueryResultFormat;
 }
 /**
  * Response from custom SQL query execution
+ *
+ * Based on format parameter:
+ * - 'object' (default): returns rowsObject as array of objects
+ * - 'array': returns rows as array of arrays
+ * - 'both': returns both formats
  */
 interface ExecuteSqlQueryResponse {
     /** Data source ID that was queried */
     datasourceId: string | number;
     /** Data source name */
     datasourceName?: string;
-    result: {
-        executedSql: string;
-        columns: string[];
-        rows: Array<Record<string, unknown>>;
-        rowCount: number;
-        executionTimeMs: number;
-    };
+    /** Name of the queried table (if applicable) */
+    tableName?: string;
+    /** Column names in order */
+    columns: string[];
+    /** Number of rows returned */
+    rowCount: number;
+    /** Execution time in milliseconds */
+    executionTimeMs: number;
+    /** Executed SQL query */
+    executedSql: string;
+    /**
+     * Data rows as arrays
+     * Present when format is 'array' or 'both'
+     */
+    rows?: Array<Array<unknown>>;
+    /**
+     * Data rows as objects (each row is {columnName: value})
+     * Present when format is 'object' or 'both'
+     */
+    rowsObject?: Array<Record<string, unknown>>;
+}
+/**
+ * Request body for table query
+ */
+interface TableQueryRequest {
+    /** Table name to query */
+    tableName: string;
+    /** Optional result limit */
+    limit?: number;
+    /** Optional format specification - defaults to 'object' */
+    format?: QueryResultFormat;
+}
+/**
+ * Response from table query
+ *
+ * Based on format parameter:
+ * - 'object' (default): returns rowsObject as array of objects (API native format)
+ * - 'array': returns rows as array of arrays
+ * - 'both': returns both formats
+ */
+interface TableQueryResponse {
+    /** Name of the queried table */
+    tableName: string;
+    /** Column names in order */
+    columns: string[];
+    /** Number of rows returned */
+    rowCount: number;
+    /** Execution time in milliseconds */
+    executionTimeMs: number;
+    /** Executed SQL query */
+    executedSql: string;
+    /**
+     * Data rows as arrays
+     * Present when format is 'array' or 'both'
+     */
+    rows?: Array<Array<unknown>>;
+    /**
+     * Data rows as objects (each row is {columnName: value})
+     * Present when format is 'object' or 'both' (API native format)
+     */
+    rowsObject?: Array<Record<string, unknown>>;
 }
 /**
  * MetricsServerConfigStore interface
@@ -2647,4 +2720,4 @@ type Timestamp = number;
  */
 type Callback<T = any, R = void> = (data: T) => R | Promise<R>;
 
-export { type AgentClient, type AgentConfig, type AgentConfigWithTools, type AgentLatticeProtocol, type AgentMiddlewareConfig, type AgentRunConfig, AgentType, type Assistant, type AssistantMessage, type AssistantStore, type AvailableModule, type BaseLatticeProtocol, type BaseMessage, type BrowserMiddlewareConfig, type Callback, type CodeEvalMiddlewareConfig, type CreateAssistantRequest, type CreateDatabaseConfigRequest, type CreateMcpServerConfigRequest, type CreateMetricsServerConfigRequest, type CreateProjectRequest, type CreateSkillRequest, type CreateTenantRequest, type CreateThreadRequest, type CreateUserRequest, type CreateUserTenantLinkRequest, type CreateWorkspaceRequest, type DataSource, type DatabaseConfig, type DatabaseConfigEntry, type DatabaseConfigStore, type DatabaseType, type DeepAgentConfig, type DeveloperMessage, type EmbeddingsConfig, type EmbeddingsLatticeProtocol, type ExecuteSqlQueryRequest, type ExecuteSqlQueryResponse, type FilterCondition, type GraphBuildOptions, type ID, type InterruptMessage, type LLMConfig, type LatticeError, type LatticeEventBus, type LatticeMessage, type LoggerClient, type LoggerConfig, type LoggerContext, type LoggerLatticeProtocol, LoggerType, type McpClient, type McpClientOptions, type McpConnectionStatus, type McpLatticeMessage, type McpLatticeProtocol, McpMessageType, type McpServerConfig, type McpServerConfigEntry, type McpServerConfigStore, type McpStats, type McpTool, type McpToolResult, type McpTransportType, type MemoryClient, type MemoryConfig, type MemoryLatticeProtocol, MemoryType, type Message, type MessageChunk, type MetricDataPoint, type MetricMeta, type MetricQueryResult, type MetricsMiddlewareConfig, type MetricsServerConfig, type MetricsServerConfigEntry, type MetricsServerConfigStore, type MetricsServerType, type MiddlewareType, type ModelLatticeProtocol, type PaginatedResult, type PaginationParams, type PinoFileOptions, type Project, type ProjectStore, type QueryParams, type QueueClient, type QueueConfig, type QueueLatticeProtocol, type QueueResult, QueueType, type ReactAgentConfig, type Result, type SandboxMiddlewareConfig, type ScheduleClient, type ScheduleConfig, type ScheduleCronOptions, ScheduleExecutionType, type ScheduleLatticeProtocol, type ScheduleOnceOptions, type ScheduleStorage, ScheduleType, type ScheduledTaskDefinition, ScheduledTaskStatus, type SemanticMetricAiHints, type SemanticMetricDataPoint, type SemanticMetricResult, type SemanticMetricsFilter, type SemanticMetricsQueryRequest, type SemanticMetricsQueryResponse, type SemanticMetricsServerConfig, type Skill, type SkillClient, type SkillClientType, type SkillConfig, type SkillLatticeProtocol, type SkillStore, type SqlMiddlewareConfig, type StorageType, type SystemMessage, type TaskHandler, type TeamAgentConfig, type TeamTeammateConfig, type Tenant, type TenantStatus, type TenantStore, type TestMcpServerToolsResponse, type Thread, type ThreadStore, type Timestamp, type ToolCall, type ToolConfig, type ToolExecutor, type ToolLatticeProtocol, type ToolMessage, type UIComponent, UIComponentType, type UIConfig, type UILatticeProtocol, type UpdateDatabaseConfigRequest, type UpdateMcpServerConfigRequest, type UpdateMetricsServerConfigRequest, type UpdateProjectRequest, type UpdateTenantRequest, type UpdateUserRequest, type UpdateUserTenantLinkRequest, type UpdateWorkspaceRequest, type User, type UserMessage, type UserStatus, type UserStore, type UserTenantLink, type UserTenantLinkStore, type UserTenantRole, type VectorStoreConfig, type VectorStoreLatticeProtocol, type Workspace, type WorkspaceStore, getSubAgentsFromConfig, getToolsFromConfig, hasTools, isDeepAgentConfig, isTeamAgentConfig };
+export { type AgentClient, type AgentConfig, type AgentConfigWithTools, type AgentLatticeProtocol, type AgentMiddlewareConfig, type AgentRunConfig, AgentType, type Assistant, type AssistantMessage, type AssistantStore, type AvailableModule, type BaseLatticeProtocol, type BaseMessage, type BootstrapFilesConfig, type BrowserMiddlewareConfig, type Callback, type CodeEvalMiddlewareConfig, type CreateAssistantRequest, type CreateDatabaseConfigRequest, type CreateMcpServerConfigRequest, type CreateMetricsServerConfigRequest, type CreateProjectRequest, type CreateSkillRequest, type CreateTenantRequest, type CreateThreadRequest, type CreateUserRequest, type CreateUserTenantLinkRequest, type CreateWorkspaceRequest, type DataSource, type DatabaseConfig, type DatabaseConfigEntry, type DatabaseConfigStore, type DatabaseType, type DeepAgentConfig, type DeveloperMessage, type EmbeddingsConfig, type EmbeddingsLatticeProtocol, type ExecuteSqlQueryRequest, type ExecuteSqlQueryResponse, type FilterCondition, type GraphBuildOptions, type ID, type InterruptMessage, type LLMConfig, type LatticeError, type LatticeEventBus, type LatticeMessage, type LoggerClient, type LoggerConfig, type LoggerContext, type LoggerLatticeProtocol, LoggerType, type McpClient, type McpClientOptions, type McpConnectionStatus, type McpLatticeMessage, type McpLatticeProtocol, McpMessageType, type McpServerConfig, type McpServerConfigEntry, type McpServerConfigStore, type McpStats, type McpTool, type McpToolResult, type McpTransportType, type MemoryClient, type MemoryConfig, type MemoryLatticeProtocol, MemoryType, type Message, type MessageChunk, type MetricColumn, type MetricDataPoint, type MetricMeta, type MetricQueryResult, type MetricsMiddlewareConfig, type MetricsServerConfig, type MetricsServerConfigEntry, type MetricsServerConfigStore, type MetricsServerType, type MiddlewareType, type ModelLatticeProtocol, type PaginatedResult, type PaginationParams, type PinoFileOptions, type Project, type ProjectStore, type QueryParams, type QueryResultFormat, type QueueClient, type QueueConfig, type QueueLatticeProtocol, type QueueResult, QueueType, type ReactAgentConfig, type Result, type SandboxMiddlewareConfig, type ScheduleClient, type ScheduleConfig, type ScheduleCronOptions, ScheduleExecutionType, type ScheduleLatticeProtocol, type ScheduleOnceOptions, type ScheduleStorage, ScheduleType, type ScheduledTaskDefinition, ScheduledTaskStatus, type SemanticMetricsFilter, type SemanticMetricsQueryRequest, type SemanticMetricsQueryResponse, type SemanticMetricsServerConfig, type Skill, type SkillClient, type SkillClientType, type SkillConfig, type SkillLatticeProtocol, type SkillStore, type SqlMiddlewareConfig, type StorageType, type SystemMessage, type TableQueryRequest, type TableQueryResponse, type TaskHandler, type TeamAgentConfig, type TeamTeammateConfig, type Tenant, type TenantStatus, type TenantStore, type TestMcpServerToolsResponse, type Thread, type ThreadStore, type Timestamp, type ToolCall, type ToolConfig, type ToolExecutor, type ToolLatticeProtocol, type ToolMessage, type UIComponent, UIComponentType, type UIConfig, type UILatticeProtocol, type UpdateDatabaseConfigRequest, type UpdateMcpServerConfigRequest, type UpdateMetricsServerConfigRequest, type UpdateProjectRequest, type UpdateTenantRequest, type UpdateUserRequest, type UpdateUserTenantLinkRequest, type UpdateWorkspaceRequest, type User, type UserMessage, type UserStatus, type UserStore, type UserTenantLink, type UserTenantLinkStore, type UserTenantRole, type VectorStoreConfig, type VectorStoreLatticeProtocol, type Workspace, type WorkspaceStore, getSubAgentsFromConfig, getToolsFromConfig, hasTools, isDeepAgentConfig, isTeamAgentConfig };

package/dist/index.d.ts

@@ -101,6 +101,8 @@ interface LLMConfig {
     apiKeyEnvName?: string;
     apiKey?: string;
     baseURL?: string;
+    modelKwargs?: Record<string, any>;
+    extra?: Record<string, any>;
 }
 /**
  * 模型Lattice协议接口
@@ -182,7 +184,7 @@ interface MetricsMiddlewareConfig {
     /** Optional descriptions for each server */
     serverDescriptions?: Record<string, string>;
 }
-type MiddlewareType = "filesystem" | "code_eval" | "browser" | "sql" | "skill" | "http" | "custom" | "metrics" | "ask_user_to_clarify";
+type MiddlewareType = "filesystem" | "code_eval" | "browser" | "sql" | "skill" | "http" | "custom" | "metrics" | "ask_user_to_clarify" | "widget";
 interface AgentMiddlewareConfig {
     id: string;
     type: MiddlewareType;
@@ -191,6 +193,24 @@ interface AgentMiddlewareConfig {
     enabled: boolean;
     config: SandboxMiddlewareConfig | CodeEvalMiddlewareConfig | BrowserMiddlewareConfig | SqlMiddlewareConfig | MetricsMiddlewareConfig | Record<string, any>;
 }
+/**
+ * Bootstrap file configuration
+ * Defines default content for project bootstrap files
+ */
+interface BootstrapFilesConfig {
+    /** Default content for AGENTS.md - operating instructions */
+    agents?: string;
+    /** Default content for SOUL.md - personality and tone */
+    soul?: string;
+    /** Default content for IDENTITY.md - agent identity */
+    identity?: string;
+    /** Default content for USER.md - user preferences */
+    user?: string;
+    /** Default content for TOOLS.md - tool documentation */
+    tools?: string;
+    /** Default content for BOOTSTRAP.md - first-run tasks */
+    bootstrap?: string;
+}
 /**
  * REACT agent configuration
  */
@@ -2125,6 +2145,17 @@ interface SemanticMetricsFilter {
     /** Values for the filter */
     values: (string | number | boolean)[];
 }
+/**
+ * Query result format options
+ */
+type QueryResultFormat = 'array' | 'object' | 'both';
+/**
+ * Column definition
+ */
+interface MetricColumn {
+    name: string;
+    type: string;
+}
 /**
  * Request body for semantic metrics query
  */
@@ -2139,63 +2170,44 @@ interface SemanticMetricsQueryRequest {
     filters?: SemanticMetricsFilter[];
     /** Optional result limit */
     limit?: number;
-}
-/**
- * Single data point in semantic metrics query response
- */
-interface SemanticMetricDataPoint {
-    /** Timestamp in milliseconds */
-    timestamp?: number;
-    /** Metric value */
-    value: number;
-    /** Metric name */
-    metricName?: string;
-    /** Additional dimension values */
-    labels?: Record<string, string>;
-    /** Group by dimension values */
-    groupByValues?: Record<string, string>;
-}
-/**
- * AI Hints for a single metric result
- */
-interface SemanticMetricAiHints {
-    polarity: string;
-    valueInterpretation: string;
-    thresholds?: Array<{
-        metric: string;
-        operator: string;
-        value: number;
-        level: string;
-    }>;
-    suggestedFollowup?: string[];
-}
-/**
- * Single metric result from semantic metrics query
- */
-interface SemanticMetricResult {
-    metricName: string;
-    displayName: string;
-    dataType: string;
-    format: string;
-    polarity: string;
-    columns: string[];
-    rows: Array<Record<string, unknown>>;
-    rowCount: number;
-    executionTimeMs: number;
-    aiHints: SemanticMetricAiHints;
+    /** Optional format specification - defaults to 'array' */
+    format?: QueryResultFormat;
 }
 /**
  * Response from semantic metrics query
+ *
+ * Note: The actual API response format has changed from the original design.
+ * It now returns a flat structure with columns and rows arrays.
+ *
+ * Based on format parameter:
+ * - 'array' (default): returns rows as array of arrays
+ * - 'object': returns rowsObject as array of objects
+ * - 'both': returns both formats
  */
 interface SemanticMetricsQueryResponse {
-    /** Data source ID that was queried */
-    datasourceId: string | number;
-    /** Data source name */
-    datasourceName?: string;
-    /** Query results for each metric */
-    results: SemanticMetricResult[];
-    /** Total execution time in ms */
-    totalExecutionTimeMs?: number;
+    /** Semantic model name that was queried */
+    semanticModel: string;
+    /** Column definitions with name and type */
+    columns: MetricColumn[];
+    /** Number of rows returned */
+    rowCount: number;
+    /** Execution time in milliseconds */
+    executionTimeMs?: number;
+    /**
+     * Data rows as arrays (each row is an array of values corresponding to columns)
+     * Present when format is 'array' or 'both'
+     */
+    rows?: Array<Array<unknown>>;
+    /**
+     * Data rows as objects (each row is {columnName: value})
+     * Present when format is 'object' or 'both'
+     */
+    rowsObject?: Array<Record<string, unknown>>;
+    /** Debug information (optional) */
+    debug?: {
+        sql?: string;
+        params?: unknown;
+    };
 }
 /**
  * Request body for executing custom SQL query
@@ -2209,22 +2221,83 @@ interface ExecuteSqlQueryRequest {
     params?: Record<string, string | number | boolean>;
     /** Optional result limit */
     limit?: number;
+    /** Optional format specification - defaults to 'object' */
+    format?: QueryResultFormat;
 }
 /**
  * Response from custom SQL query execution
+ *
+ * Based on format parameter:
+ * - 'object' (default): returns rowsObject as array of objects
+ * - 'array': returns rows as array of arrays
+ * - 'both': returns both formats
  */
 interface ExecuteSqlQueryResponse {
     /** Data source ID that was queried */
     datasourceId: string | number;
     /** Data source name */
     datasourceName?: string;
-    result: {
-        executedSql: string;
-        columns: string[];
-        rows: Array<Record<string, unknown>>;
-        rowCount: number;
-        executionTimeMs: number;
-    };
+    /** Name of the queried table (if applicable) */
+    tableName?: string;
+    /** Column names in order */
+    columns: string[];
+    /** Number of rows returned */
+    rowCount: number;
+    /** Execution time in milliseconds */
+    executionTimeMs: number;
+    /** Executed SQL query */
+    executedSql: string;
+    /**
+     * Data rows as arrays
+     * Present when format is 'array' or 'both'
+     */
+    rows?: Array<Array<unknown>>;
+    /**
+     * Data rows as objects (each row is {columnName: value})
+     * Present when format is 'object' or 'both'
+     */
+    rowsObject?: Array<Record<string, unknown>>;
+}
+/**
+ * Request body for table query
+ */
+interface TableQueryRequest {
+    /** Table name to query */
+    tableName: string;
+    /** Optional result limit */
+    limit?: number;
+    /** Optional format specification - defaults to 'object' */
+    format?: QueryResultFormat;
+}
+/**
+ * Response from table query
+ *
+ * Based on format parameter:
+ * - 'object' (default): returns rowsObject as array of objects (API native format)
+ * - 'array': returns rows as array of arrays
+ * - 'both': returns both formats
+ */
+interface TableQueryResponse {
+    /** Name of the queried table */
+    tableName: string;
+    /** Column names in order */
+    columns: string[];
+    /** Number of rows returned */
+    rowCount: number;
+    /** Execution time in milliseconds */
+    executionTimeMs: number;
+    /** Executed SQL query */
+    executedSql: string;
+    /**
+     * Data rows as arrays
+     * Present when format is 'array' or 'both'
+     */
+    rows?: Array<Array<unknown>>;
+    /**
+     * Data rows as objects (each row is {columnName: value})
+     * Present when format is 'object' or 'both' (API native format)
+     */
+    rowsObject?: Array<Record<string, unknown>>;
 }
 /**
  * MetricsServerConfigStore interface
@@ -2647,4 +2720,4 @@ type Timestamp = number;
  */
 type Callback<T = any, R = void> = (data: T) => R | Promise<R>;
 
-export { type AgentClient, type AgentConfig, type AgentConfigWithTools, type AgentLatticeProtocol, type AgentMiddlewareConfig, type AgentRunConfig, AgentType, type Assistant, type AssistantMessage, type AssistantStore, type AvailableModule, type BaseLatticeProtocol, type BaseMessage, type BrowserMiddlewareConfig, type Callback, type CodeEvalMiddlewareConfig, type CreateAssistantRequest, type CreateDatabaseConfigRequest, type CreateMcpServerConfigRequest, type CreateMetricsServerConfigRequest, type CreateProjectRequest, type CreateSkillRequest, type CreateTenantRequest, type CreateThreadRequest, type CreateUserRequest, type CreateUserTenantLinkRequest, type CreateWorkspaceRequest, type DataSource, type DatabaseConfig, type DatabaseConfigEntry, type DatabaseConfigStore, type DatabaseType, type DeepAgentConfig, type DeveloperMessage, type EmbeddingsConfig, type EmbeddingsLatticeProtocol, type ExecuteSqlQueryRequest, type ExecuteSqlQueryResponse, type FilterCondition, type GraphBuildOptions, type ID, type InterruptMessage, type LLMConfig, type LatticeError, type LatticeEventBus, type LatticeMessage, type LoggerClient, type LoggerConfig, type LoggerContext, type LoggerLatticeProtocol, LoggerType, type McpClient, type McpClientOptions, type McpConnectionStatus, type McpLatticeMessage, type McpLatticeProtocol, McpMessageType, type McpServerConfig, type McpServerConfigEntry, type McpServerConfigStore, type McpStats, type McpTool, type McpToolResult, type McpTransportType, type MemoryClient, type MemoryConfig, type MemoryLatticeProtocol, MemoryType, type Message, type MessageChunk, type MetricDataPoint, type MetricMeta, type MetricQueryResult, type MetricsMiddlewareConfig, type MetricsServerConfig, type MetricsServerConfigEntry, type MetricsServerConfigStore, type MetricsServerType, type MiddlewareType, type ModelLatticeProtocol, type PaginatedResult, type PaginationParams, type PinoFileOptions, type Project, type ProjectStore, type QueryParams, type QueueClient, type QueueConfig, type QueueLatticeProtocol, type QueueResult, QueueType, type ReactAgentConfig, type Result, type SandboxMiddlewareConfig, type ScheduleClient, type ScheduleConfig, type ScheduleCronOptions, ScheduleExecutionType, type ScheduleLatticeProtocol, type ScheduleOnceOptions, type ScheduleStorage, ScheduleType, type ScheduledTaskDefinition, ScheduledTaskStatus, type SemanticMetricAiHints, type SemanticMetricDataPoint, type SemanticMetricResult, type SemanticMetricsFilter, type SemanticMetricsQueryRequest, type SemanticMetricsQueryResponse, type SemanticMetricsServerConfig, type Skill, type SkillClient, type SkillClientType, type SkillConfig, type SkillLatticeProtocol, type SkillStore, type SqlMiddlewareConfig, type StorageType, type SystemMessage, type TaskHandler, type TeamAgentConfig, type TeamTeammateConfig, type Tenant, type TenantStatus, type TenantStore, type TestMcpServerToolsResponse, type Thread, type ThreadStore, type Timestamp, type ToolCall, type ToolConfig, type ToolExecutor, type ToolLatticeProtocol, type ToolMessage, type UIComponent, UIComponentType, type UIConfig, type UILatticeProtocol, type UpdateDatabaseConfigRequest, type UpdateMcpServerConfigRequest, type UpdateMetricsServerConfigRequest, type UpdateProjectRequest, type UpdateTenantRequest, type UpdateUserRequest, type UpdateUserTenantLinkRequest, type UpdateWorkspaceRequest, type User, type UserMessage, type UserStatus, type UserStore, type UserTenantLink, type UserTenantLinkStore, type UserTenantRole, type VectorStoreConfig, type VectorStoreLatticeProtocol, type Workspace, type WorkspaceStore, getSubAgentsFromConfig, getToolsFromConfig, hasTools, isDeepAgentConfig, isTeamAgentConfig };
+export { type AgentClient, type AgentConfig, type AgentConfigWithTools, type AgentLatticeProtocol, type AgentMiddlewareConfig, type AgentRunConfig, AgentType, type Assistant, type AssistantMessage, type AssistantStore, type AvailableModule, type BaseLatticeProtocol, type BaseMessage, type BootstrapFilesConfig, type BrowserMiddlewareConfig, type Callback, type CodeEvalMiddlewareConfig, type CreateAssistantRequest, type CreateDatabaseConfigRequest, type CreateMcpServerConfigRequest, type CreateMetricsServerConfigRequest, type CreateProjectRequest, type CreateSkillRequest, type CreateTenantRequest, type CreateThreadRequest, type CreateUserRequest, type CreateUserTenantLinkRequest, type CreateWorkspaceRequest, type DataSource, type DatabaseConfig, type DatabaseConfigEntry, type DatabaseConfigStore, type DatabaseType, type DeepAgentConfig, type DeveloperMessage, type EmbeddingsConfig, type EmbeddingsLatticeProtocol, type ExecuteSqlQueryRequest, type ExecuteSqlQueryResponse, type FilterCondition, type GraphBuildOptions, type ID, type InterruptMessage, type LLMConfig, type LatticeError, type LatticeEventBus, type LatticeMessage, type LoggerClient, type LoggerConfig, type LoggerContext, type LoggerLatticeProtocol, LoggerType, type McpClient, type McpClientOptions, type McpConnectionStatus, type McpLatticeMessage, type McpLatticeProtocol, McpMessageType, type McpServerConfig, type McpServerConfigEntry, type McpServerConfigStore, type McpStats, type McpTool, type McpToolResult, type McpTransportType, type MemoryClient, type MemoryConfig, type MemoryLatticeProtocol, MemoryType, type Message, type MessageChunk, type MetricColumn, type MetricDataPoint, type MetricMeta, type MetricQueryResult, type MetricsMiddlewareConfig, type MetricsServerConfig, type MetricsServerConfigEntry, type MetricsServerConfigStore, type MetricsServerType, type MiddlewareType, type ModelLatticeProtocol, type PaginatedResult, type PaginationParams, type PinoFileOptions, type Project, type ProjectStore, type QueryParams, type QueryResultFormat, type QueueClient, type QueueConfig, type QueueLatticeProtocol, type QueueResult, QueueType, type ReactAgentConfig, type Result, type SandboxMiddlewareConfig, type ScheduleClient, type ScheduleConfig, type ScheduleCronOptions, ScheduleExecutionType, type ScheduleLatticeProtocol, type ScheduleOnceOptions, type ScheduleStorage, ScheduleType, type ScheduledTaskDefinition, ScheduledTaskStatus, type SemanticMetricsFilter, type SemanticMetricsQueryRequest, type SemanticMetricsQueryResponse, type SemanticMetricsServerConfig, type Skill, type SkillClient, type SkillClientType, type SkillConfig, type SkillLatticeProtocol, type SkillStore, type SqlMiddlewareConfig, type StorageType, type SystemMessage, type TableQueryRequest, type TableQueryResponse, type TaskHandler, type TeamAgentConfig, type TeamTeammateConfig, type Tenant, type TenantStatus, type TenantStore, type TestMcpServerToolsResponse, type Thread, type ThreadStore, type Timestamp, type ToolCall, type ToolConfig, type ToolExecutor, type ToolLatticeProtocol, type ToolMessage, type UIComponent, UIComponentType, type UIConfig, type UILatticeProtocol, type UpdateDatabaseConfigRequest, type UpdateMcpServerConfigRequest, type UpdateMetricsServerConfigRequest, type UpdateProjectRequest, type UpdateTenantRequest, type UpdateUserRequest, type UpdateUserTenantLinkRequest, type UpdateWorkspaceRequest, type User, type UserMessage, type UserStatus, type UserStore, type UserTenantLink, type UserTenantLinkStore, type UserTenantRole, type VectorStoreConfig, type VectorStoreLatticeProtocol, type Workspace, type WorkspaceStore, getSubAgentsFromConfig, getToolsFromConfig, hasTools, isDeepAgentConfig, isTeamAgentConfig };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/AgentLatticeProtocol.ts","../src/MemoryLatticeProtocol.ts","../src/UILatticeProtocol.ts","../src/QueueLatticeProtocol.ts","../src/ScheduleLatticeProtocol.ts","../src/LoggerLatticeProtocol.ts","../src/McpLatticeProtocol.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 \"./ScheduleLatticeProtocol\";\nexport * from \"./EmbeddingsLatticeProtocol\";\nexport * from \"./VectorStoreLatticeProtocol\";\nexport * from \"./LoggerLatticeProtocol\";\nexport * from \"./MessageProtocol\";\nexport * from \"./ThreadStoreProtocol\";\nexport * from \"./AssistantStoreProtocol\";\nexport * from \"./SkillLatticeProtocol\";\nexport * from \"./SkillStoreProtocol\";\nexport * from \"./McpLatticeProtocol\";\nexport * from \"./WorkspaceStoreProtocol\";\nexport * from \"./TenantStoreProtocol\";\nexport * from \"./DatabaseConfigStoreProtocol\";\nexport * from \"./MetricsServerConfigStoreProtocol\";\nexport * from \"./McpServerConfigStoreProtocol\";\nexport * from \"./UserStoreProtocol\";\nexport * from \"./UserTenantLinkProtocol\";\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  TEAM = \"team\",\n}\n\n/**\n * Runtime configuration that will be injected into LangGraphRunnableConfig.configurable\n * Tools can access these values via config.configurable.runConfig\n */\nexport interface AgentRunConfig {\n  /** Database key for SQL tools (registered via sqlDatabaseManager) */\n  databaseKey?: string;\n  /** Any additional runtime configuration */\n  [key: string]: any;\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  /**\n   * Key of the parent agent to inherit configuration from.\n   * When set, unspecified fields are inherited from the parent agent's config.\n   * Child's explicitly set fields override the parent's.\n   */\n  extendsAgent?: string;\n  schema?: ZodObject<any, any, any, any, any>; // Input validation schema\n  modelKey?: string; // Model key to use\n  /**\n   * Runtime configuration to inject into tool execution context\n   * Will be available in tools via config.configurable.runConfig\n   */\n  runConfig?: AgentRunConfig;\n  skillCategories?: string[];\n  middleware?: AgentMiddlewareConfig[];\n}\n\nexport type AvailableModule = \"filesystem\" | \"code_eval\" | \"browser\";\n\nexport interface SandboxMiddlewareConfig {\n  isolatedLevel: \"agent\" | \"thread\" | \"global\";\n  modules: AvailableModule[];\n}\n\nexport interface CodeEvalMiddlewareConfig {\n  isolatedLevel: \"agent\" | \"thread\" | \"global\";\n  timeout: number;\n  memoryLimit: number;\n}\n\nexport interface BrowserMiddlewareConfig {\n  isolatedLevel: \"agent\" | \"thread\" | \"global\";\n  headless: boolean;\n}\n\nexport interface SqlMiddlewareConfig {\n  databaseKeys?: string[];\n}\n\nexport interface MetricsMiddlewareConfig {\n  /** List of configured metrics server keys */\n  serverKeys: string[];\n  /** Optional descriptions for each server */\n  serverDescriptions?: Record<string, string>;\n}\n\nexport type MiddlewareType = \"filesystem\" | \"code_eval\" | \"browser\" | \"sql\" | \"skill\" | \"http\" | \"custom\" | \"metrics\" | \"ask_user_to_clarify\";\n\nexport interface AgentMiddlewareConfig {\n  id: string;\n  type: MiddlewareType;\n  name: string;\n  description: string;\n  enabled: boolean;\n  config: SandboxMiddlewareConfig | CodeEvalMiddlewareConfig | BrowserMiddlewareConfig | SqlMiddlewareConfig | MetricsMiddlewareConfig | Record<string, any>;\n}\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\n/**\n * Team teammate configuration -- describes an available teammate.\n */\nexport interface TeamTeammateConfig {\n  /** Unique name for this teammate (used as agent ID) */\n  name: string;\n  /** Role category (e.g. \"research\", \"writing\", \"review\") */\n  role: string;\n  /** Human-readable description of what this teammate does */\n  description: string;\n  /** Tool keys this teammate has access to */\n  tools?: string[];\n  /** Custom system prompt for this teammate */\n  prompt?: string;\n  /** Model key override for this teammate */\n  modelKey?: string;\n}\n\n/**\n * TEAM agent configuration -- a team lead that dynamically creates teammates.\n * Teammates are created on-the-fly from create_team tool input (name, role, description).\n */\nexport interface TeamAgentConfig extends BaseAgentConfig {\n  type: AgentType.TEAM;\n  /** Tool keys available to the team lead */\n  tools?: string[];\n  /** Maximum number of teammates running concurrently */\n  maxConcurrency?: number;\n  /**\n   * Schedule lattice key for polling task list / mailbox.\n   * When set, teammates use ScheduleLattice for periodic polling instead of event-driven wait.\n   */\n  scheduleLatticeKey?: string;\n  /** Poll interval in ms when using schedule lattice (default: 5000) */\n  pollIntervalMs?: number;\n}\n\n/**\n * Type guard to check if config is TeamAgentConfig\n */\nexport function isTeamAgentConfig(\n  config: AgentConfig\n): config is TeamAgentConfig {\n  return config.type === AgentType.TEAM;\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  | TeamAgentConfig\n\n/**\n * Agent configuration with tools property\n */\nexport type AgentConfigWithTools =\n  | ReactAgentConfig\n  | DeepAgentConfig\n  | TeamAgentConfig\n\n/**\n * Type guard to check if config has tools property\n */\nexport function hasTools(config: AgentConfig): config is AgentConfigWithTools {\n  return true\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","/**\n * ScheduleLatticeProtocol\n *\n * Schedule Lattice protocol for delayed and recurring task execution management\n * Supports persistence and recovery after service restart\n * Supports both one-time delayed tasks and cron-style recurring tasks\n */\n\nimport { BaseLatticeProtocol } from \"./BaseLatticeProtocol\";\n\n/**\n * Schedule service type enumeration\n */\nexport enum ScheduleType {\n  MEMORY = \"memory\",\n  POSTGRES = \"postgres\",\n  REDIS = \"redis\",\n}\n\n/**\n * Schedule execution type - one-time or recurring\n */\nexport enum ScheduleExecutionType {\n  ONCE = \"once\", // Execute once at specified time\n  CRON = \"cron\", // Recurring based on cron expression\n}\n\n/**\n * Task status enumeration\n */\nexport enum ScheduledTaskStatus {\n  PENDING = \"pending\", // Waiting to be executed\n  RUNNING = \"running\", // Currently executing\n  COMPLETED = \"completed\", // Successfully completed (for ONCE type)\n  FAILED = \"failed\", // Execution failed\n  CANCELLED = \"cancelled\", // Manually cancelled\n  PAUSED = \"paused\", // Paused (for CRON type)\n}\n\n/**\n * Schedule configuration interface\n */\nexport interface ScheduleConfig {\n  name: string;\n  description: string;\n  type: ScheduleType;\n  storage?: ScheduleStorage; // Optional storage for persistence\n  options?: Record<string, any>;\n}\n\n/**\n * Scheduled task definition - fully serializable\n * Supports both one-time and cron-style recurring tasks\n */\nexport interface ScheduledTaskDefinition {\n  taskId: string;\n  taskType: string; // Maps to a registered handler\n  payload: Record<string, any>; // JSON-serializable data passed to handler\n\n  // Context fields for querying\n  assistantId?: string; // Which assistant created/owns this task\n  threadId?: string; // Which thread this task belongs to\n\n  // Execution configuration\n  executionType: ScheduleExecutionType;\n\n  // For ONCE type - execute at specific time or after delay\n  executeAt?: number; // Timestamp when to execute\n  delayMs?: number; // Original delay in milliseconds (for reference)\n\n  // For CRON type - recurring schedule\n  cronExpression?: string; // Cron format: \"0 9 * * *\" (min hour day month weekday)\n  timezone?: string; // Timezone: \"Asia/Shanghai\", defaults to system timezone\n  nextRunAt?: number; // Next calculated execution time\n  lastRunAt?: number; // Last execution time\n\n  // Execution tracking\n  status: ScheduledTaskStatus;\n  runCount: number; // How many times executed\n  maxRuns?: number; // Max executions (null/undefined = infinite for cron, 1 for once)\n\n  // Error handling\n  retryCount: number; // Current retry count\n  maxRetries: number; // Maximum retry attempts\n  lastError?: string; // Last error message if failed\n\n  // Timestamps\n  createdAt: number;\n  updatedAt: number;\n  expiresAt?: number; // When to stop (for cron, optional)\n\n  metadata?: Record<string, any>; // Additional metadata\n}\n\n/**\n * Task handler function type\n */\nexport type TaskHandler = (\n  payload: Record<string, any>,\n  taskInfo: ScheduledTaskDefinition\n) => void | Promise<void>;\n\n/**\n * Options for scheduling a one-time task\n */\nexport interface ScheduleOnceOptions {\n  executeAt?: number; // Absolute timestamp to execute\n  delayMs?: number; // OR relative delay from now\n  maxRetries?: number; // Max retry attempts (default: 0)\n  assistantId?: string; // Which assistant created/owns this task\n  threadId?: string; // Which thread this task belongs to\n  metadata?: Record<string, any>;\n}\n\n/**\n * Options for scheduling a cron task\n */\nexport interface ScheduleCronOptions {\n  cronExpression: string; // Cron expression: \"0 9 * * *\"\n  timezone?: string; // Timezone: \"Asia/Shanghai\"\n  maxRuns?: number; // Max executions (undefined = infinite)\n  expiresAt?: number; // Stop after this timestamp\n  maxRetries?: number; // Max retry attempts per run (default: 0)\n  assistantId?: string; // Which assistant created/owns this task\n  threadId?: string; // Which thread this task belongs to\n  metadata?: Record<string, any>;\n}\n\n/**\n * Schedule storage interface for persistence\n */\nexport interface ScheduleStorage {\n  /**\n   * Save a new task\n   */\n  save(task: ScheduledTaskDefinition): Promise<void>;\n\n  /**\n   * Get task by ID\n   */\n  get(taskId: string): Promise<ScheduledTaskDefinition | null>;\n\n  /**\n   * Update task\n   */\n  update(\n    taskId: string,\n    updates: Partial<ScheduledTaskDefinition>\n  ): Promise<void>;\n\n  /**\n   * Delete task\n   */\n  delete(taskId: string): Promise<void>;\n\n  /**\n   * Get all pending/active tasks (for recovery)\n   * Returns tasks with status: PENDING or PAUSED\n   */\n  getActiveTasks(): Promise<ScheduledTaskDefinition[]>;\n\n  /**\n   * Get tasks by type\n   */\n  getTasksByType(taskType: string): Promise<ScheduledTaskDefinition[]>;\n\n  /**\n   * Get tasks by status\n   */\n  getTasksByStatus(\n    status: ScheduledTaskStatus\n  ): Promise<ScheduledTaskDefinition[]>;\n\n  /**\n   * Get tasks by execution type\n   */\n  getTasksByExecutionType(\n    executionType: ScheduleExecutionType\n  ): Promise<ScheduledTaskDefinition[]>;\n\n  /**\n   * Get tasks by assistant ID\n   */\n  getTasksByAssistantId(\n    assistantId: string\n  ): Promise<ScheduledTaskDefinition[]>;\n\n  /**\n   * Get tasks by thread ID\n   */\n  getTasksByThreadId(threadId: string): Promise<ScheduledTaskDefinition[]>;\n\n  /**\n   * Get all tasks (with optional filters)\n   */\n  getAllTasks(filters?: {\n    tenantId?: string;\n    status?: ScheduledTaskStatus;\n    executionType?: ScheduleExecutionType;\n    taskType?: string;\n    assistantId?: string;\n    threadId?: string;\n    limit?: number;\n    offset?: number;\n  }): Promise<ScheduledTaskDefinition[]>;\n\n  /**\n   * Count tasks (with optional filters)\n   */\n  countTasks(filters?: {\n    tenantId?: string;\n    status?: ScheduledTaskStatus;\n    executionType?: ScheduleExecutionType;\n    taskType?: string;\n    assistantId?: string;\n    threadId?: string;\n  }): Promise<number>;\n\n  /**\n   * Delete completed/cancelled tasks older than specified time\n   * Useful for cleanup\n   */\n  deleteOldTasks(olderThanMs: number): Promise<number>;\n}\n\n/**\n * Schedule client interface\n */\nexport interface ScheduleClient {\n  // ===== Handler Registration =====\n\n  /**\n   * Register a handler for a task type\n   * Must be called before scheduling tasks of this type\n   */\n  registerHandler(taskType: string, handler: TaskHandler): void;\n\n  /**\n   * Unregister a handler\n   */\n  unregisterHandler(taskType: string): boolean;\n\n  /**\n   * Check if a handler is registered\n   */\n  hasHandler(taskType: string): boolean;\n\n  /**\n   * Get all registered handler types\n   */\n  getHandlerTypes(): string[];\n\n  // ===== One-time Task Scheduling =====\n\n  /**\n   * Schedule a one-time task\n   * @param taskId - Unique identifier for the task\n   * @param taskType - Type of task (must have a registered handler)\n   * @param payload - Data to pass to the handler (must be JSON-serializable)\n   * @param options - Execution options (executeAt or delayMs required)\n   */\n  scheduleOnce(\n    taskId: string,\n    taskType: string,\n    payload: Record<string, any>,\n    options: ScheduleOnceOptions\n  ): Promise<boolean>;\n\n  // ===== Cron Task Scheduling =====\n\n  /**\n   * Schedule a recurring cron task\n   * @param taskId - Unique identifier for the task\n   * @param taskType - Type of task (must have a registered handler)\n   * @param payload - Data to pass to the handler (must be JSON-serializable)\n   * @param options - Cron options (cronExpression required)\n   */\n  scheduleCron(\n    taskId: string,\n    taskType: string,\n    payload: Record<string, any>,\n    options: ScheduleCronOptions\n  ): Promise<boolean>;\n\n  // ===== Task Management =====\n\n  /**\n   * Cancel a scheduled task\n   */\n  cancel(taskId: string): Promise<boolean>;\n\n  /**\n   * Pause a cron task (only for CRON type)\n   */\n  pause(taskId: string): Promise<boolean>;\n\n  /**\n   * Resume a paused cron task (only for CRON type)\n   */\n  resume(taskId: string): Promise<boolean>;\n\n  /**\n   * Check if a task exists\n   */\n  has(taskId: string): Promise<boolean>;\n\n  /**\n   * Get task information\n   */\n  getTask(taskId: string): Promise<ScheduledTaskDefinition | null>;\n\n  /**\n   * Get remaining time until next execution\n   * Returns -1 if task not found or already executed\n   */\n  getRemainingTime(taskId: string): Promise<number>;\n\n  /**\n   * Get count of active tasks (pending + paused)\n   */\n  getActiveTaskCount(): Promise<number>;\n\n  /**\n   * Get all active task IDs\n   */\n  getActiveTaskIds(): Promise<string[]>;\n\n  /**\n   * Cancel all active tasks\n   */\n  cancelAll(): Promise<void>;\n\n  // ===== Recovery =====\n\n  /**\n   * Restore active tasks from storage (call on service startup)\n   * Re-schedules all pending tasks with their remaining time\n   * Re-schedules all cron tasks for their next run\n   * @returns Number of tasks restored\n   */\n  restore(): Promise<number>;\n\n  // ===== Storage =====\n\n  /**\n   * Set the storage backend\n   */\n  setStorage(storage: ScheduleStorage): void;\n\n  /**\n   * Get current storage backend\n   */\n  getStorage(): ScheduleStorage | null;\n}\n\n/**\n * Schedule Lattice protocol interface\n */\nexport interface ScheduleLatticeProtocol\n  extends BaseLatticeProtocol<ScheduleConfig, ScheduleClient> {\n  // Handler registration\n  registerHandler: (taskType: string, handler: TaskHandler) => void;\n  unregisterHandler: (taskType: string) => boolean;\n  hasHandler: (taskType: string) => boolean;\n  getHandlerTypes: () => string[];\n\n  // One-time task scheduling\n  scheduleOnce: (\n    taskId: string,\n    taskType: string,\n    payload: Record<string, any>,\n    options: ScheduleOnceOptions\n  ) => Promise<boolean>;\n\n  // Cron task scheduling\n  scheduleCron: (\n    taskId: string,\n    taskType: string,\n    payload: Record<string, any>,\n    options: ScheduleCronOptions\n  ) => Promise<boolean>;\n\n  // Task management\n  cancel: (taskId: string) => Promise<boolean>;\n  pause: (taskId: string) => Promise<boolean>;\n  resume: (taskId: string) => Promise<boolean>;\n  has: (taskId: string) => Promise<boolean>;\n  getTask: (taskId: string) => Promise<ScheduledTaskDefinition | null>;\n  getRemainingTime: (taskId: string) => Promise<number>;\n  getActiveTaskCount: () => Promise<number>;\n  getActiveTaskIds: () => Promise<string[]>;\n  cancelAll: () => Promise<void>;\n\n  // Recovery\n  restore: () => Promise<number>;\n}\n","/**\n * LoggerLatticeProtocol\n *\n * Logger Lattice protocol for logging management\n */\n\nimport { BaseLatticeProtocol } from \"./BaseLatticeProtocol\";\n\n/**\n * Logger service type enumeration\n */\nexport enum LoggerType {\n  PINO = \"pino\",\n  CONSOLE = \"console\",\n  CUSTOM = \"custom\",\n}\n\n/**\n * Logger context interface\n */\nexport interface LoggerContext {\n  \"x-user-id\"?: string;\n  \"x-tenant-id\"?: string;\n  \"x-request-id\"?: string;\n  \"x-task-id\"?: string;\n  \"x-thread-id\"?: string;\n  [key: string]: any;\n}\n\n/**\n * Pino logger file transport options\n */\nexport interface PinoFileOptions {\n  file?: string; // Log file path (e.g., \"./logs/app.log\" or \"./logs/app\")\n  frequency?: \"daily\" | \"hourly\" | \"minutely\" | string; // Log rotation frequency\n  mkdir?: boolean; // Create directory if not exists\n  size?: string; // Max file size (e.g., \"10M\", \"100K\")\n  maxFiles?: number; // Maximum number of log files to keep\n}\n\n/**\n * Logger configuration interface\n */\nexport interface LoggerConfig {\n  name: string; // Logger name\n  description?: string; // Logger description\n  type: LoggerType; // Logger service type\n  serviceName?: string; // Service name (e.g., \"lattice-gateway\")\n  loggerName?: string; // Logger instance name (e.g., \"fastify-server\")\n  context?: LoggerContext; // Initial context\n  // File logging options (for PINO type)\n  file?: string | PinoFileOptions; // Log file path or detailed file options\n  // Additional options (e.g., pino config, custom logger settings)\n  options?: Record<string, any>;\n}\n\n/**\n * Logger client interface\n */\nexport interface LoggerClient {\n  info: (msg: string, obj?: object) => void;\n  error: (msg: string, obj?: object | Error) => void;\n  warn: (msg: string, obj?: object) => void;\n  debug: (msg: string, obj?: object) => void;\n  updateContext?: (context: Partial<LoggerContext>) => void;\n  child?: (options: Partial<LoggerConfig>) => LoggerClient;\n}\n\n/**\n * Logger Lattice protocol interface\n */\nexport interface LoggerLatticeProtocol\n  extends BaseLatticeProtocol<LoggerConfig, LoggerClient> {\n  // Logger operations\n  info: (msg: string, obj?: object) => void;\n  error: (msg: string, obj?: object | Error) => void;\n  warn: (msg: string, obj?: object) => void;\n  debug: (msg: string, obj?: object) => void;\n  updateContext?: (context: Partial<LoggerContext>) => void;\n  child?: (options: Partial<LoggerConfig>) => LoggerClient;\n}\n","/**\n * McpLatticeProtocol\n *\n * Model Context Protocol (MCP) lattice protocol for integrating MCP servers\n * with the Lattice framework. Provides standardized interfaces for MCP\n * client connections, tool discovery, and remote execution.\n */\n\nimport { BaseLatticeProtocol, LatticeMessage } from \"./BaseLatticeProtocol\";\n\n/**\n * MCP transport type\n */\nexport type McpTransportType = \"stdio\" | \"streamable_http\" | \"sse\";\n\n/**\n * MCP server configuration\n */\nexport interface McpServerConfig {\n  /** Server name */\n  name: string;\n  /** Server version */\n  version: string;\n  /** Transport type */\n  transport: McpTransportType;\n  /** Command for stdio transport (e.g., \"npx\", \"python\") */\n  command?: string;\n  /** Arguments for stdio transport */\n  args?: string[];\n  /** URL for HTTP/SSE transport */\n  url?: string;\n  /** Environment variables */\n  env?: Record<string, string>;\n  /** Connection timeout in milliseconds */\n  timeout?: number;\n  /** Retry attempts on connection failure */\n  retryAttempts?: number;\n}\n\n/**\n * MCP tool definition\n */\nexport interface McpTool {\n  /** Tool name */\n  name: string;\n  /** Tool description */\n  description: string;\n  /** Input schema */\n  inputSchema: {\n    type: \"object\";\n    properties: Record<string, any>;\n    required?: string[];\n  };\n  /** Tool metadata */\n  metadata?: Record<string, any>;\n}\n\n/**\n * MCP tool call result\n */\nexport interface McpToolResult {\n  /** Whether the call was successful */\n  success: boolean;\n  /** Result content */\n  content: Array<{\n    type: \"text\" | \"image\" | \"audio\" | \"resource\";\n    data: any;\n    mimeType?: string;\n  }>;\n  /** Error message if failed */\n  error?: string;\n  /** Execution metadata */\n  metadata?: {\n    duration: number;\n    tokens?: number;\n    model?: string;\n  };\n}\n\n/**\n * MCP client interface\n */\nexport interface McpClient {\n  /** Client name */\n  name: string;\n  /** Client version */\n  version: string;\n  /** Server configuration */\n  serverConfig: McpServerConfig;\n  \n  /**\n   * Connect to MCP server\n   */\n  connect(): Promise<void>;\n  \n  /**\n   * Disconnect from MCP server\n   */\n  disconnect(): Promise<void>;\n  \n  /**\n   * Check if connected\n   */\n  isConnected(): boolean;\n  \n  /**\n   * List available tools\n   */\n  listTools(): Promise<McpTool[]>;\n  \n  /**\n   * Call a tool\n   */\n  callTool(name: string, arguments_: Record<string, any>): Promise<McpToolResult>;\n  \n  /**\n   * Subscribe to server notifications\n   */\n  subscribe(topic: string, handler: (data: any) => void): void;\n  \n  /**\n   * Unsubscribe from server notifications\n   */\n  unsubscribe(topic: string): void;\n  \n  /**\n   * Get client statistics\n   */\n  getStats(): McpStats;\n  \n  /**\n   * Get connection status\n   */\n  getStatus(): McpConnectionStatus;\n}\n\n/**\n * MCP client options\n */\nexport interface McpClientOptions {\n  /** Client name */\n  name: string;\n  /** Client version */\n  version: string;\n  /** Server configuration */\n  serverConfig: McpServerConfig;\n  /** Auto-connect on initialization */\n  autoConnect?: boolean;\n  /** Error handler */\n  onError?: (error: Error) => void;\n  /** Connection status handler */\n  onStatusChange?: (status: McpConnectionStatus) => void;\n}\n\n/**\n * MCP Lattice protocol interface\n */\nexport interface McpLatticeProtocol\n  extends BaseLatticeProtocol<McpServerConfig, McpClient> {\n  /**\n   * Server configuration\n   */\n  config: McpServerConfig;\n  \n  /**\n   * MCP client instance\n   */\n  client: McpClient;\n  \n  /**\n   * Connect to MCP server\n   */\n  connect(): Promise<void>;\n  \n  /**\n   * Disconnect from MCP server\n   */\n  disconnect(): Promise<void>;\n  \n  /**\n   * Get available tools\n   */\n  getTools(): Promise<McpTool[]>;\n  \n  /**\n   * Execute a tool\n   */\n  executeTool(\n    name: string,\n    arguments_: Record<string, any>\n  ): Promise<McpToolResult>;\n  \n  /**\n   * Execute with automatic retries\n   */\n  executeToolWithRetry(\n    name: string,\n    arguments_: Record<string, any>,\n    maxRetries?: number\n  ): Promise<McpToolResult>;\n  \n  /**\n   * Get protocol version\n   */\n  getProtocolVersion(): string;\n  \n  /**\n   * Health check\n   */\n  healthCheck(): Promise<boolean>;\n}\n\n/**\n * MCP message types\n */\nexport enum McpMessageType {\n  CONNECT = \"mcp:connect\",\n  DISCONNECT = \"mcp:disconnect\",\n  LIST_TOOLS = \"mcp:list_tools\",\n  CALL_TOOL = \"mcp:call_tool\",\n  TOOL_RESULT = \"mcp:tool_result\",\n  NOTIFICATION = \"mcp:notification\",\n  ERROR = \"mcp:error\",\n  HEALTH_CHECK = \"mcp:health_check\",\n}\n\n/**\n * MCP Lattice message\n */\nexport interface McpLatticeMessage extends LatticeMessage {\n  type: McpMessageType;\n  payload: {\n    toolName?: string;\n    arguments?: Record<string, any>;\n    result?: McpToolResult;\n    tools?: McpTool[];\n    error?: string;\n  };\n}\n\n/**\n * MCP connection status\n */\nexport type McpConnectionStatus =\n  | \"disconnected\"\n  | \"connecting\"\n  | \"connected\"\n  | \"reconnecting\"\n  | \"error\";\n\n/**\n * MCP statistics\n */\nexport interface McpStats {\n  totalCalls: number;\n  successfulCalls: number;\n  failedCalls: number;\n  averageLatency: number;\n  lastCallTimestamp: number;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;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,UAAO;AAHG,SAAAA;AAAA,GAAA;AA+IL,SAAS,kBACd,QAC2B;AAC3B,SAAO,OAAO,SAAS;AACzB;AAsBO,SAAS,SAAS,QAAqD;AAC5E,SAAO;AACT;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;;;AC1MO,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;;;ACEL,IAAK,eAAL,kBAAKC,kBAAL;AACL,EAAAA,cAAA,YAAS;AACT,EAAAA,cAAA,cAAW;AACX,EAAAA,cAAA,WAAQ;AAHE,SAAAA;AAAA,GAAA;AASL,IAAK,wBAAL,kBAAKC,2BAAL;AACL,EAAAA,uBAAA,UAAO;AACP,EAAAA,uBAAA,UAAO;AAFG,SAAAA;AAAA,GAAA;AAQL,IAAK,sBAAL,kBAAKC,yBAAL;AACL,EAAAA,qBAAA,aAAU;AACV,EAAAA,qBAAA,aAAU;AACV,EAAAA,qBAAA,eAAY;AACZ,EAAAA,qBAAA,YAAS;AACT,EAAAA,qBAAA,eAAY;AACZ,EAAAA,qBAAA,YAAS;AANC,SAAAA;AAAA,GAAA;;;ACnBL,IAAK,aAAL,kBAAKC,gBAAL;AACL,EAAAA,YAAA,UAAO;AACP,EAAAA,YAAA,aAAU;AACV,EAAAA,YAAA,YAAS;AAHC,SAAAA;AAAA,GAAA;;;AC4ML,IAAK,iBAAL,kBAAKC,oBAAL;AACL,EAAAA,gBAAA,aAAU;AACV,EAAAA,gBAAA,gBAAa;AACb,EAAAA,gBAAA,gBAAa;AACb,EAAAA,gBAAA,eAAY;AACZ,EAAAA,gBAAA,iBAAc;AACd,EAAAA,gBAAA,kBAAe;AACf,EAAAA,gBAAA,WAAQ;AACR,EAAAA,gBAAA,kBAAe;AARL,SAAAA;AAAA,GAAA;","names":["AgentType","MemoryType","UIComponentType","QueueType","ScheduleType","ScheduleExecutionType","ScheduledTaskStatus","LoggerType","McpMessageType"]}
+{"version":3,"sources":["../src/index.ts","../src/AgentLatticeProtocol.ts","../src/MemoryLatticeProtocol.ts","../src/UILatticeProtocol.ts","../src/QueueLatticeProtocol.ts","../src/ScheduleLatticeProtocol.ts","../src/LoggerLatticeProtocol.ts","../src/McpLatticeProtocol.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 \"./ScheduleLatticeProtocol\";\nexport * from \"./EmbeddingsLatticeProtocol\";\nexport * from \"./VectorStoreLatticeProtocol\";\nexport * from \"./LoggerLatticeProtocol\";\nexport * from \"./MessageProtocol\";\nexport * from \"./ThreadStoreProtocol\";\nexport * from \"./AssistantStoreProtocol\";\nexport * from \"./SkillLatticeProtocol\";\nexport * from \"./SkillStoreProtocol\";\nexport * from \"./McpLatticeProtocol\";\nexport * from \"./WorkspaceStoreProtocol\";\nexport * from \"./TenantStoreProtocol\";\nexport * from \"./DatabaseConfigStoreProtocol\";\nexport * from \"./MetricsServerConfigStoreProtocol\";\nexport * from \"./McpServerConfigStoreProtocol\";\nexport * from \"./UserStoreProtocol\";\nexport * from \"./UserTenantLinkProtocol\";\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  TEAM = \"team\",\n}\n\n/**\n * Runtime configuration that will be injected into LangGraphRunnableConfig.configurable\n * Tools can access these values via config.configurable.runConfig\n */\nexport interface AgentRunConfig {\n  /** Database key for SQL tools (registered via sqlDatabaseManager) */\n  databaseKey?: string;\n  /** Any additional runtime configuration */\n  [key: string]: any;\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  /**\n   * Key of the parent agent to inherit configuration from.\n   * When set, unspecified fields are inherited from the parent agent's config.\n   * Child's explicitly set fields override the parent's.\n   */\n  extendsAgent?: string;\n  schema?: ZodObject<any, any, any, any, any>; // Input validation schema\n  modelKey?: string; // Model key to use\n  /**\n   * Runtime configuration to inject into tool execution context\n   * Will be available in tools via config.configurable.runConfig\n   */\n  runConfig?: AgentRunConfig;\n  skillCategories?: string[];\n  middleware?: AgentMiddlewareConfig[];\n}\n\nexport type AvailableModule = \"filesystem\" | \"code_eval\" | \"browser\";\n\nexport interface SandboxMiddlewareConfig {\n  isolatedLevel: \"agent\" | \"thread\" | \"global\";\n  modules: AvailableModule[];\n}\n\nexport interface CodeEvalMiddlewareConfig {\n  isolatedLevel: \"agent\" | \"thread\" | \"global\";\n  timeout: number;\n  memoryLimit: number;\n}\n\nexport interface BrowserMiddlewareConfig {\n  isolatedLevel: \"agent\" | \"thread\" | \"global\";\n  headless: boolean;\n}\n\nexport interface SqlMiddlewareConfig {\n  databaseKeys?: string[];\n}\n\nexport interface MetricsMiddlewareConfig {\n  /** List of configured metrics server keys */\n  serverKeys: string[];\n  /** Optional descriptions for each server */\n  serverDescriptions?: Record<string, string>;\n}\n\nexport type MiddlewareType = \"filesystem\" | \"code_eval\" | \"browser\" | \"sql\" | \"skill\" | \"http\" | \"custom\" | \"metrics\" | \"ask_user_to_clarify\" | \"widget\";\n\nexport interface AgentMiddlewareConfig {\n  id: string;\n  type: MiddlewareType;\n  name: string;\n  description: string;\n  enabled: boolean;\n  config: SandboxMiddlewareConfig | CodeEvalMiddlewareConfig | BrowserMiddlewareConfig | SqlMiddlewareConfig | MetricsMiddlewareConfig | Record<string, any>;\n}\n\n/**\n * Bootstrap file configuration\n * Defines default content for project bootstrap files\n */\nexport interface BootstrapFilesConfig {\n  /** Default content for AGENTS.md - operating instructions */\n  agents?: string;\n  /** Default content for SOUL.md - personality and tone */\n  soul?: string;\n  /** Default content for IDENTITY.md - agent identity */\n  identity?: string;\n  /** Default content for USER.md - user preferences */\n  user?: string;\n  /** Default content for TOOLS.md - tool documentation */\n  tools?: string;\n  /** Default content for BOOTSTRAP.md - first-run tasks */\n  bootstrap?: string;\n}\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\n/**\n * Team teammate configuration -- describes an available teammate.\n */\nexport interface TeamTeammateConfig {\n  /** Unique name for this teammate (used as agent ID) */\n  name: string;\n  /** Role category (e.g. \"research\", \"writing\", \"review\") */\n  role: string;\n  /** Human-readable description of what this teammate does */\n  description: string;\n  /** Tool keys this teammate has access to */\n  tools?: string[];\n  /** Custom system prompt for this teammate */\n  prompt?: string;\n  /** Model key override for this teammate */\n  modelKey?: string;\n}\n\n/**\n * TEAM agent configuration -- a team lead that dynamically creates teammates.\n * Teammates are created on-the-fly from create_team tool input (name, role, description).\n */\nexport interface TeamAgentConfig extends BaseAgentConfig {\n  type: AgentType.TEAM;\n  /** Tool keys available to the team lead */\n  tools?: string[];\n  /** Maximum number of teammates running concurrently */\n  maxConcurrency?: number;\n  /**\n   * Schedule lattice key for polling task list / mailbox.\n   * When set, teammates use ScheduleLattice for periodic polling instead of event-driven wait.\n   */\n  scheduleLatticeKey?: string;\n  /** Poll interval in ms when using schedule lattice (default: 5000) */\n  pollIntervalMs?: number;\n}\n\n/**\n * Type guard to check if config is TeamAgentConfig\n */\nexport function isTeamAgentConfig(\n  config: AgentConfig\n): config is TeamAgentConfig {\n  return config.type === AgentType.TEAM;\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  | TeamAgentConfig\n\n/**\n * Agent configuration with tools property\n */\nexport type AgentConfigWithTools =\n  | ReactAgentConfig\n  | DeepAgentConfig\n  | TeamAgentConfig\n\n/**\n * Type guard to check if config has tools property\n */\nexport function hasTools(config: AgentConfig): config is AgentConfigWithTools {\n  return true\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","/**\n * ScheduleLatticeProtocol\n *\n * Schedule Lattice protocol for delayed and recurring task execution management\n * Supports persistence and recovery after service restart\n * Supports both one-time delayed tasks and cron-style recurring tasks\n */\n\nimport { BaseLatticeProtocol } from \"./BaseLatticeProtocol\";\n\n/**\n * Schedule service type enumeration\n */\nexport enum ScheduleType {\n  MEMORY = \"memory\",\n  POSTGRES = \"postgres\",\n  REDIS = \"redis\",\n}\n\n/**\n * Schedule execution type - one-time or recurring\n */\nexport enum ScheduleExecutionType {\n  ONCE = \"once\", // Execute once at specified time\n  CRON = \"cron\", // Recurring based on cron expression\n}\n\n/**\n * Task status enumeration\n */\nexport enum ScheduledTaskStatus {\n  PENDING = \"pending\", // Waiting to be executed\n  RUNNING = \"running\", // Currently executing\n  COMPLETED = \"completed\", // Successfully completed (for ONCE type)\n  FAILED = \"failed\", // Execution failed\n  CANCELLED = \"cancelled\", // Manually cancelled\n  PAUSED = \"paused\", // Paused (for CRON type)\n}\n\n/**\n * Schedule configuration interface\n */\nexport interface ScheduleConfig {\n  name: string;\n  description: string;\n  type: ScheduleType;\n  storage?: ScheduleStorage; // Optional storage for persistence\n  options?: Record<string, any>;\n}\n\n/**\n * Scheduled task definition - fully serializable\n * Supports both one-time and cron-style recurring tasks\n */\nexport interface ScheduledTaskDefinition {\n  taskId: string;\n  taskType: string; // Maps to a registered handler\n  payload: Record<string, any>; // JSON-serializable data passed to handler\n\n  // Context fields for querying\n  assistantId?: string; // Which assistant created/owns this task\n  threadId?: string; // Which thread this task belongs to\n\n  // Execution configuration\n  executionType: ScheduleExecutionType;\n\n  // For ONCE type - execute at specific time or after delay\n  executeAt?: number; // Timestamp when to execute\n  delayMs?: number; // Original delay in milliseconds (for reference)\n\n  // For CRON type - recurring schedule\n  cronExpression?: string; // Cron format: \"0 9 * * *\" (min hour day month weekday)\n  timezone?: string; // Timezone: \"Asia/Shanghai\", defaults to system timezone\n  nextRunAt?: number; // Next calculated execution time\n  lastRunAt?: number; // Last execution time\n\n  // Execution tracking\n  status: ScheduledTaskStatus;\n  runCount: number; // How many times executed\n  maxRuns?: number; // Max executions (null/undefined = infinite for cron, 1 for once)\n\n  // Error handling\n  retryCount: number; // Current retry count\n  maxRetries: number; // Maximum retry attempts\n  lastError?: string; // Last error message if failed\n\n  // Timestamps\n  createdAt: number;\n  updatedAt: number;\n  expiresAt?: number; // When to stop (for cron, optional)\n\n  metadata?: Record<string, any>; // Additional metadata\n}\n\n/**\n * Task handler function type\n */\nexport type TaskHandler = (\n  payload: Record<string, any>,\n  taskInfo: ScheduledTaskDefinition\n) => void | Promise<void>;\n\n/**\n * Options for scheduling a one-time task\n */\nexport interface ScheduleOnceOptions {\n  executeAt?: number; // Absolute timestamp to execute\n  delayMs?: number; // OR relative delay from now\n  maxRetries?: number; // Max retry attempts (default: 0)\n  assistantId?: string; // Which assistant created/owns this task\n  threadId?: string; // Which thread this task belongs to\n  metadata?: Record<string, any>;\n}\n\n/**\n * Options for scheduling a cron task\n */\nexport interface ScheduleCronOptions {\n  cronExpression: string; // Cron expression: \"0 9 * * *\"\n  timezone?: string; // Timezone: \"Asia/Shanghai\"\n  maxRuns?: number; // Max executions (undefined = infinite)\n  expiresAt?: number; // Stop after this timestamp\n  maxRetries?: number; // Max retry attempts per run (default: 0)\n  assistantId?: string; // Which assistant created/owns this task\n  threadId?: string; // Which thread this task belongs to\n  metadata?: Record<string, any>;\n}\n\n/**\n * Schedule storage interface for persistence\n */\nexport interface ScheduleStorage {\n  /**\n   * Save a new task\n   */\n  save(task: ScheduledTaskDefinition): Promise<void>;\n\n  /**\n   * Get task by ID\n   */\n  get(taskId: string): Promise<ScheduledTaskDefinition | null>;\n\n  /**\n   * Update task\n   */\n  update(\n    taskId: string,\n    updates: Partial<ScheduledTaskDefinition>\n  ): Promise<void>;\n\n  /**\n   * Delete task\n   */\n  delete(taskId: string): Promise<void>;\n\n  /**\n   * Get all pending/active tasks (for recovery)\n   * Returns tasks with status: PENDING or PAUSED\n   */\n  getActiveTasks(): Promise<ScheduledTaskDefinition[]>;\n\n  /**\n   * Get tasks by type\n   */\n  getTasksByType(taskType: string): Promise<ScheduledTaskDefinition[]>;\n\n  /**\n   * Get tasks by status\n   */\n  getTasksByStatus(\n    status: ScheduledTaskStatus\n  ): Promise<ScheduledTaskDefinition[]>;\n\n  /**\n   * Get tasks by execution type\n   */\n  getTasksByExecutionType(\n    executionType: ScheduleExecutionType\n  ): Promise<ScheduledTaskDefinition[]>;\n\n  /**\n   * Get tasks by assistant ID\n   */\n  getTasksByAssistantId(\n    assistantId: string\n  ): Promise<ScheduledTaskDefinition[]>;\n\n  /**\n   * Get tasks by thread ID\n   */\n  getTasksByThreadId(threadId: string): Promise<ScheduledTaskDefinition[]>;\n\n  /**\n   * Get all tasks (with optional filters)\n   */\n  getAllTasks(filters?: {\n    tenantId?: string;\n    status?: ScheduledTaskStatus;\n    executionType?: ScheduleExecutionType;\n    taskType?: string;\n    assistantId?: string;\n    threadId?: string;\n    limit?: number;\n    offset?: number;\n  }): Promise<ScheduledTaskDefinition[]>;\n\n  /**\n   * Count tasks (with optional filters)\n   */\n  countTasks(filters?: {\n    tenantId?: string;\n    status?: ScheduledTaskStatus;\n    executionType?: ScheduleExecutionType;\n    taskType?: string;\n    assistantId?: string;\n    threadId?: string;\n  }): Promise<number>;\n\n  /**\n   * Delete completed/cancelled tasks older than specified time\n   * Useful for cleanup\n   */\n  deleteOldTasks(olderThanMs: number): Promise<number>;\n}\n\n/**\n * Schedule client interface\n */\nexport interface ScheduleClient {\n  // ===== Handler Registration =====\n\n  /**\n   * Register a handler for a task type\n   * Must be called before scheduling tasks of this type\n   */\n  registerHandler(taskType: string, handler: TaskHandler): void;\n\n  /**\n   * Unregister a handler\n   */\n  unregisterHandler(taskType: string): boolean;\n\n  /**\n   * Check if a handler is registered\n   */\n  hasHandler(taskType: string): boolean;\n\n  /**\n   * Get all registered handler types\n   */\n  getHandlerTypes(): string[];\n\n  // ===== One-time Task Scheduling =====\n\n  /**\n   * Schedule a one-time task\n   * @param taskId - Unique identifier for the task\n   * @param taskType - Type of task (must have a registered handler)\n   * @param payload - Data to pass to the handler (must be JSON-serializable)\n   * @param options - Execution options (executeAt or delayMs required)\n   */\n  scheduleOnce(\n    taskId: string,\n    taskType: string,\n    payload: Record<string, any>,\n    options: ScheduleOnceOptions\n  ): Promise<boolean>;\n\n  // ===== Cron Task Scheduling =====\n\n  /**\n   * Schedule a recurring cron task\n   * @param taskId - Unique identifier for the task\n   * @param taskType - Type of task (must have a registered handler)\n   * @param payload - Data to pass to the handler (must be JSON-serializable)\n   * @param options - Cron options (cronExpression required)\n   */\n  scheduleCron(\n    taskId: string,\n    taskType: string,\n    payload: Record<string, any>,\n    options: ScheduleCronOptions\n  ): Promise<boolean>;\n\n  // ===== Task Management =====\n\n  /**\n   * Cancel a scheduled task\n   */\n  cancel(taskId: string): Promise<boolean>;\n\n  /**\n   * Pause a cron task (only for CRON type)\n   */\n  pause(taskId: string): Promise<boolean>;\n\n  /**\n   * Resume a paused cron task (only for CRON type)\n   */\n  resume(taskId: string): Promise<boolean>;\n\n  /**\n   * Check if a task exists\n   */\n  has(taskId: string): Promise<boolean>;\n\n  /**\n   * Get task information\n   */\n  getTask(taskId: string): Promise<ScheduledTaskDefinition | null>;\n\n  /**\n   * Get remaining time until next execution\n   * Returns -1 if task not found or already executed\n   */\n  getRemainingTime(taskId: string): Promise<number>;\n\n  /**\n   * Get count of active tasks (pending + paused)\n   */\n  getActiveTaskCount(): Promise<number>;\n\n  /**\n   * Get all active task IDs\n   */\n  getActiveTaskIds(): Promise<string[]>;\n\n  /**\n   * Cancel all active tasks\n   */\n  cancelAll(): Promise<void>;\n\n  // ===== Recovery =====\n\n  /**\n   * Restore active tasks from storage (call on service startup)\n   * Re-schedules all pending tasks with their remaining time\n   * Re-schedules all cron tasks for their next run\n   * @returns Number of tasks restored\n   */\n  restore(): Promise<number>;\n\n  // ===== Storage =====\n\n  /**\n   * Set the storage backend\n   */\n  setStorage(storage: ScheduleStorage): void;\n\n  /**\n   * Get current storage backend\n   */\n  getStorage(): ScheduleStorage | null;\n}\n\n/**\n * Schedule Lattice protocol interface\n */\nexport interface ScheduleLatticeProtocol\n  extends BaseLatticeProtocol<ScheduleConfig, ScheduleClient> {\n  // Handler registration\n  registerHandler: (taskType: string, handler: TaskHandler) => void;\n  unregisterHandler: (taskType: string) => boolean;\n  hasHandler: (taskType: string) => boolean;\n  getHandlerTypes: () => string[];\n\n  // One-time task scheduling\n  scheduleOnce: (\n    taskId: string,\n    taskType: string,\n    payload: Record<string, any>,\n    options: ScheduleOnceOptions\n  ) => Promise<boolean>;\n\n  // Cron task scheduling\n  scheduleCron: (\n    taskId: string,\n    taskType: string,\n    payload: Record<string, any>,\n    options: ScheduleCronOptions\n  ) => Promise<boolean>;\n\n  // Task management\n  cancel: (taskId: string) => Promise<boolean>;\n  pause: (taskId: string) => Promise<boolean>;\n  resume: (taskId: string) => Promise<boolean>;\n  has: (taskId: string) => Promise<boolean>;\n  getTask: (taskId: string) => Promise<ScheduledTaskDefinition | null>;\n  getRemainingTime: (taskId: string) => Promise<number>;\n  getActiveTaskCount: () => Promise<number>;\n  getActiveTaskIds: () => Promise<string[]>;\n  cancelAll: () => Promise<void>;\n\n  // Recovery\n  restore: () => Promise<number>;\n}\n","/**\n * LoggerLatticeProtocol\n *\n * Logger Lattice protocol for logging management\n */\n\nimport { BaseLatticeProtocol } from \"./BaseLatticeProtocol\";\n\n/**\n * Logger service type enumeration\n */\nexport enum LoggerType {\n  PINO = \"pino\",\n  CONSOLE = \"console\",\n  CUSTOM = \"custom\",\n}\n\n/**\n * Logger context interface\n */\nexport interface LoggerContext {\n  \"x-user-id\"?: string;\n  \"x-tenant-id\"?: string;\n  \"x-request-id\"?: string;\n  \"x-task-id\"?: string;\n  \"x-thread-id\"?: string;\n  [key: string]: any;\n}\n\n/**\n * Pino logger file transport options\n */\nexport interface PinoFileOptions {\n  file?: string; // Log file path (e.g., \"./logs/app.log\" or \"./logs/app\")\n  frequency?: \"daily\" | \"hourly\" | \"minutely\" | string; // Log rotation frequency\n  mkdir?: boolean; // Create directory if not exists\n  size?: string; // Max file size (e.g., \"10M\", \"100K\")\n  maxFiles?: number; // Maximum number of log files to keep\n}\n\n/**\n * Logger configuration interface\n */\nexport interface LoggerConfig {\n  name: string; // Logger name\n  description?: string; // Logger description\n  type: LoggerType; // Logger service type\n  serviceName?: string; // Service name (e.g., \"lattice-gateway\")\n  loggerName?: string; // Logger instance name (e.g., \"fastify-server\")\n  context?: LoggerContext; // Initial context\n  // File logging options (for PINO type)\n  file?: string | PinoFileOptions; // Log file path or detailed file options\n  // Additional options (e.g., pino config, custom logger settings)\n  options?: Record<string, any>;\n}\n\n/**\n * Logger client interface\n */\nexport interface LoggerClient {\n  info: (msg: string, obj?: object) => void;\n  error: (msg: string, obj?: object | Error) => void;\n  warn: (msg: string, obj?: object) => void;\n  debug: (msg: string, obj?: object) => void;\n  updateContext?: (context: Partial<LoggerContext>) => void;\n  child?: (options: Partial<LoggerConfig>) => LoggerClient;\n}\n\n/**\n * Logger Lattice protocol interface\n */\nexport interface LoggerLatticeProtocol\n  extends BaseLatticeProtocol<LoggerConfig, LoggerClient> {\n  // Logger operations\n  info: (msg: string, obj?: object) => void;\n  error: (msg: string, obj?: object | Error) => void;\n  warn: (msg: string, obj?: object) => void;\n  debug: (msg: string, obj?: object) => void;\n  updateContext?: (context: Partial<LoggerContext>) => void;\n  child?: (options: Partial<LoggerConfig>) => LoggerClient;\n}\n","/**\n * McpLatticeProtocol\n *\n * Model Context Protocol (MCP) lattice protocol for integrating MCP servers\n * with the Lattice framework. Provides standardized interfaces for MCP\n * client connections, tool discovery, and remote execution.\n */\n\nimport { BaseLatticeProtocol, LatticeMessage } from \"./BaseLatticeProtocol\";\n\n/**\n * MCP transport type\n */\nexport type McpTransportType = \"stdio\" | \"streamable_http\" | \"sse\";\n\n/**\n * MCP server configuration\n */\nexport interface McpServerConfig {\n  /** Server name */\n  name: string;\n  /** Server version */\n  version: string;\n  /** Transport type */\n  transport: McpTransportType;\n  /** Command for stdio transport (e.g., \"npx\", \"python\") */\n  command?: string;\n  /** Arguments for stdio transport */\n  args?: string[];\n  /** URL for HTTP/SSE transport */\n  url?: string;\n  /** Environment variables */\n  env?: Record<string, string>;\n  /** Connection timeout in milliseconds */\n  timeout?: number;\n  /** Retry attempts on connection failure */\n  retryAttempts?: number;\n}\n\n/**\n * MCP tool definition\n */\nexport interface McpTool {\n  /** Tool name */\n  name: string;\n  /** Tool description */\n  description: string;\n  /** Input schema */\n  inputSchema: {\n    type: \"object\";\n    properties: Record<string, any>;\n    required?: string[];\n  };\n  /** Tool metadata */\n  metadata?: Record<string, any>;\n}\n\n/**\n * MCP tool call result\n */\nexport interface McpToolResult {\n  /** Whether the call was successful */\n  success: boolean;\n  /** Result content */\n  content: Array<{\n    type: \"text\" | \"image\" | \"audio\" | \"resource\";\n    data: any;\n    mimeType?: string;\n  }>;\n  /** Error message if failed */\n  error?: string;\n  /** Execution metadata */\n  metadata?: {\n    duration: number;\n    tokens?: number;\n    model?: string;\n  };\n}\n\n/**\n * MCP client interface\n */\nexport interface McpClient {\n  /** Client name */\n  name: string;\n  /** Client version */\n  version: string;\n  /** Server configuration */\n  serverConfig: McpServerConfig;\n  \n  /**\n   * Connect to MCP server\n   */\n  connect(): Promise<void>;\n  \n  /**\n   * Disconnect from MCP server\n   */\n  disconnect(): Promise<void>;\n  \n  /**\n   * Check if connected\n   */\n  isConnected(): boolean;\n  \n  /**\n   * List available tools\n   */\n  listTools(): Promise<McpTool[]>;\n  \n  /**\n   * Call a tool\n   */\n  callTool(name: string, arguments_: Record<string, any>): Promise<McpToolResult>;\n  \n  /**\n   * Subscribe to server notifications\n   */\n  subscribe(topic: string, handler: (data: any) => void): void;\n  \n  /**\n   * Unsubscribe from server notifications\n   */\n  unsubscribe(topic: string): void;\n  \n  /**\n   * Get client statistics\n   */\n  getStats(): McpStats;\n  \n  /**\n   * Get connection status\n   */\n  getStatus(): McpConnectionStatus;\n}\n\n/**\n * MCP client options\n */\nexport interface McpClientOptions {\n  /** Client name */\n  name: string;\n  /** Client version */\n  version: string;\n  /** Server configuration */\n  serverConfig: McpServerConfig;\n  /** Auto-connect on initialization */\n  autoConnect?: boolean;\n  /** Error handler */\n  onError?: (error: Error) => void;\n  /** Connection status handler */\n  onStatusChange?: (status: McpConnectionStatus) => void;\n}\n\n/**\n * MCP Lattice protocol interface\n */\nexport interface McpLatticeProtocol\n  extends BaseLatticeProtocol<McpServerConfig, McpClient> {\n  /**\n   * Server configuration\n   */\n  config: McpServerConfig;\n  \n  /**\n   * MCP client instance\n   */\n  client: McpClient;\n  \n  /**\n   * Connect to MCP server\n   */\n  connect(): Promise<void>;\n  \n  /**\n   * Disconnect from MCP server\n   */\n  disconnect(): Promise<void>;\n  \n  /**\n   * Get available tools\n   */\n  getTools(): Promise<McpTool[]>;\n  \n  /**\n   * Execute a tool\n   */\n  executeTool(\n    name: string,\n    arguments_: Record<string, any>\n  ): Promise<McpToolResult>;\n  \n  /**\n   * Execute with automatic retries\n   */\n  executeToolWithRetry(\n    name: string,\n    arguments_: Record<string, any>,\n    maxRetries?: number\n  ): Promise<McpToolResult>;\n  \n  /**\n   * Get protocol version\n   */\n  getProtocolVersion(): string;\n  \n  /**\n   * Health check\n   */\n  healthCheck(): Promise<boolean>;\n}\n\n/**\n * MCP message types\n */\nexport enum McpMessageType {\n  CONNECT = \"mcp:connect\",\n  DISCONNECT = \"mcp:disconnect\",\n  LIST_TOOLS = \"mcp:list_tools\",\n  CALL_TOOL = \"mcp:call_tool\",\n  TOOL_RESULT = \"mcp:tool_result\",\n  NOTIFICATION = \"mcp:notification\",\n  ERROR = \"mcp:error\",\n  HEALTH_CHECK = \"mcp:health_check\",\n}\n\n/**\n * MCP Lattice message\n */\nexport interface McpLatticeMessage extends LatticeMessage {\n  type: McpMessageType;\n  payload: {\n    toolName?: string;\n    arguments?: Record<string, any>;\n    result?: McpToolResult;\n    tools?: McpTool[];\n    error?: string;\n  };\n}\n\n/**\n * MCP connection status\n */\nexport type McpConnectionStatus =\n  | \"disconnected\"\n  | \"connecting\"\n  | \"connected\"\n  | \"reconnecting\"\n  | \"error\";\n\n/**\n * MCP statistics\n */\nexport interface McpStats {\n  totalCalls: number;\n  successfulCalls: number;\n  failedCalls: number;\n  averageLatency: number;\n  lastCallTimestamp: number;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;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,UAAO;AAHG,SAAAA;AAAA,GAAA;AAkKL,SAAS,kBACd,QAC2B;AAC3B,SAAO,OAAO,SAAS;AACzB;AAsBO,SAAS,SAAS,QAAqD;AAC5E,SAAO;AACT;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;;;AC7NO,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;;;ACEL,IAAK,eAAL,kBAAKC,kBAAL;AACL,EAAAA,cAAA,YAAS;AACT,EAAAA,cAAA,cAAW;AACX,EAAAA,cAAA,WAAQ;AAHE,SAAAA;AAAA,GAAA;AASL,IAAK,wBAAL,kBAAKC,2BAAL;AACL,EAAAA,uBAAA,UAAO;AACP,EAAAA,uBAAA,UAAO;AAFG,SAAAA;AAAA,GAAA;AAQL,IAAK,sBAAL,kBAAKC,yBAAL;AACL,EAAAA,qBAAA,aAAU;AACV,EAAAA,qBAAA,aAAU;AACV,EAAAA,qBAAA,eAAY;AACZ,EAAAA,qBAAA,YAAS;AACT,EAAAA,qBAAA,eAAY;AACZ,EAAAA,qBAAA,YAAS;AANC,SAAAA;AAAA,GAAA;;;ACnBL,IAAK,aAAL,kBAAKC,gBAAL;AACL,EAAAA,YAAA,UAAO;AACP,EAAAA,YAAA,aAAU;AACV,EAAAA,YAAA,YAAS;AAHC,SAAAA;AAAA,GAAA;;;AC4ML,IAAK,iBAAL,kBAAKC,oBAAL;AACL,EAAAA,gBAAA,aAAU;AACV,EAAAA,gBAAA,gBAAa;AACb,EAAAA,gBAAA,gBAAa;AACb,EAAAA,gBAAA,eAAY;AACZ,EAAAA,gBAAA,iBAAc;AACd,EAAAA,gBAAA,kBAAe;AACf,EAAAA,gBAAA,WAAQ;AACR,EAAAA,gBAAA,kBAAe;AARL,SAAAA;AAAA,GAAA;","names":["AgentType","MemoryType","UIComponentType","QueueType","ScheduleType","ScheduleExecutionType","ScheduledTaskStatus","LoggerType","McpMessageType"]}

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/AgentLatticeProtocol.ts","../src/MemoryLatticeProtocol.ts","../src/UILatticeProtocol.ts","../src/QueueLatticeProtocol.ts","../src/ScheduleLatticeProtocol.ts","../src/LoggerLatticeProtocol.ts","../src/McpLatticeProtocol.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  TEAM = \"team\",\n}\n\n/**\n * Runtime configuration that will be injected into LangGraphRunnableConfig.configurable\n * Tools can access these values via config.configurable.runConfig\n */\nexport interface AgentRunConfig {\n  /** Database key for SQL tools (registered via sqlDatabaseManager) */\n  databaseKey?: string;\n  /** Any additional runtime configuration */\n  [key: string]: any;\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  /**\n   * Key of the parent agent to inherit configuration from.\n   * When set, unspecified fields are inherited from the parent agent's config.\n   * Child's explicitly set fields override the parent's.\n   */\n  extendsAgent?: string;\n  schema?: ZodObject<any, any, any, any, any>; // Input validation schema\n  modelKey?: string; // Model key to use\n  /**\n   * Runtime configuration to inject into tool execution context\n   * Will be available in tools via config.configurable.runConfig\n   */\n  runConfig?: AgentRunConfig;\n  skillCategories?: string[];\n  middleware?: AgentMiddlewareConfig[];\n}\n\nexport type AvailableModule = \"filesystem\" | \"code_eval\" | \"browser\";\n\nexport interface SandboxMiddlewareConfig {\n  isolatedLevel: \"agent\" | \"thread\" | \"global\";\n  modules: AvailableModule[];\n}\n\nexport interface CodeEvalMiddlewareConfig {\n  isolatedLevel: \"agent\" | \"thread\" | \"global\";\n  timeout: number;\n  memoryLimit: number;\n}\n\nexport interface BrowserMiddlewareConfig {\n  isolatedLevel: \"agent\" | \"thread\" | \"global\";\n  headless: boolean;\n}\n\nexport interface SqlMiddlewareConfig {\n  databaseKeys?: string[];\n}\n\nexport interface MetricsMiddlewareConfig {\n  /** List of configured metrics server keys */\n  serverKeys: string[];\n  /** Optional descriptions for each server */\n  serverDescriptions?: Record<string, string>;\n}\n\nexport type MiddlewareType = \"filesystem\" | \"code_eval\" | \"browser\" | \"sql\" | \"skill\" | \"http\" | \"custom\" | \"metrics\" | \"ask_user_to_clarify\";\n\nexport interface AgentMiddlewareConfig {\n  id: string;\n  type: MiddlewareType;\n  name: string;\n  description: string;\n  enabled: boolean;\n  config: SandboxMiddlewareConfig | CodeEvalMiddlewareConfig | BrowserMiddlewareConfig | SqlMiddlewareConfig | MetricsMiddlewareConfig | Record<string, any>;\n}\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\n/**\n * Team teammate configuration -- describes an available teammate.\n */\nexport interface TeamTeammateConfig {\n  /** Unique name for this teammate (used as agent ID) */\n  name: string;\n  /** Role category (e.g. \"research\", \"writing\", \"review\") */\n  role: string;\n  /** Human-readable description of what this teammate does */\n  description: string;\n  /** Tool keys this teammate has access to */\n  tools?: string[];\n  /** Custom system prompt for this teammate */\n  prompt?: string;\n  /** Model key override for this teammate */\n  modelKey?: string;\n}\n\n/**\n * TEAM agent configuration -- a team lead that dynamically creates teammates.\n * Teammates are created on-the-fly from create_team tool input (name, role, description).\n */\nexport interface TeamAgentConfig extends BaseAgentConfig {\n  type: AgentType.TEAM;\n  /** Tool keys available to the team lead */\n  tools?: string[];\n  /** Maximum number of teammates running concurrently */\n  maxConcurrency?: number;\n  /**\n   * Schedule lattice key for polling task list / mailbox.\n   * When set, teammates use ScheduleLattice for periodic polling instead of event-driven wait.\n   */\n  scheduleLatticeKey?: string;\n  /** Poll interval in ms when using schedule lattice (default: 5000) */\n  pollIntervalMs?: number;\n}\n\n/**\n * Type guard to check if config is TeamAgentConfig\n */\nexport function isTeamAgentConfig(\n  config: AgentConfig\n): config is TeamAgentConfig {\n  return config.type === AgentType.TEAM;\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  | TeamAgentConfig\n\n/**\n * Agent configuration with tools property\n */\nexport type AgentConfigWithTools =\n  | ReactAgentConfig\n  | DeepAgentConfig\n  | TeamAgentConfig\n\n/**\n * Type guard to check if config has tools property\n */\nexport function hasTools(config: AgentConfig): config is AgentConfigWithTools {\n  return true\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","/**\n * ScheduleLatticeProtocol\n *\n * Schedule Lattice protocol for delayed and recurring task execution management\n * Supports persistence and recovery after service restart\n * Supports both one-time delayed tasks and cron-style recurring tasks\n */\n\nimport { BaseLatticeProtocol } from \"./BaseLatticeProtocol\";\n\n/**\n * Schedule service type enumeration\n */\nexport enum ScheduleType {\n  MEMORY = \"memory\",\n  POSTGRES = \"postgres\",\n  REDIS = \"redis\",\n}\n\n/**\n * Schedule execution type - one-time or recurring\n */\nexport enum ScheduleExecutionType {\n  ONCE = \"once\", // Execute once at specified time\n  CRON = \"cron\", // Recurring based on cron expression\n}\n\n/**\n * Task status enumeration\n */\nexport enum ScheduledTaskStatus {\n  PENDING = \"pending\", // Waiting to be executed\n  RUNNING = \"running\", // Currently executing\n  COMPLETED = \"completed\", // Successfully completed (for ONCE type)\n  FAILED = \"failed\", // Execution failed\n  CANCELLED = \"cancelled\", // Manually cancelled\n  PAUSED = \"paused\", // Paused (for CRON type)\n}\n\n/**\n * Schedule configuration interface\n */\nexport interface ScheduleConfig {\n  name: string;\n  description: string;\n  type: ScheduleType;\n  storage?: ScheduleStorage; // Optional storage for persistence\n  options?: Record<string, any>;\n}\n\n/**\n * Scheduled task definition - fully serializable\n * Supports both one-time and cron-style recurring tasks\n */\nexport interface ScheduledTaskDefinition {\n  taskId: string;\n  taskType: string; // Maps to a registered handler\n  payload: Record<string, any>; // JSON-serializable data passed to handler\n\n  // Context fields for querying\n  assistantId?: string; // Which assistant created/owns this task\n  threadId?: string; // Which thread this task belongs to\n\n  // Execution configuration\n  executionType: ScheduleExecutionType;\n\n  // For ONCE type - execute at specific time or after delay\n  executeAt?: number; // Timestamp when to execute\n  delayMs?: number; // Original delay in milliseconds (for reference)\n\n  // For CRON type - recurring schedule\n  cronExpression?: string; // Cron format: \"0 9 * * *\" (min hour day month weekday)\n  timezone?: string; // Timezone: \"Asia/Shanghai\", defaults to system timezone\n  nextRunAt?: number; // Next calculated execution time\n  lastRunAt?: number; // Last execution time\n\n  // Execution tracking\n  status: ScheduledTaskStatus;\n  runCount: number; // How many times executed\n  maxRuns?: number; // Max executions (null/undefined = infinite for cron, 1 for once)\n\n  // Error handling\n  retryCount: number; // Current retry count\n  maxRetries: number; // Maximum retry attempts\n  lastError?: string; // Last error message if failed\n\n  // Timestamps\n  createdAt: number;\n  updatedAt: number;\n  expiresAt?: number; // When to stop (for cron, optional)\n\n  metadata?: Record<string, any>; // Additional metadata\n}\n\n/**\n * Task handler function type\n */\nexport type TaskHandler = (\n  payload: Record<string, any>,\n  taskInfo: ScheduledTaskDefinition\n) => void | Promise<void>;\n\n/**\n * Options for scheduling a one-time task\n */\nexport interface ScheduleOnceOptions {\n  executeAt?: number; // Absolute timestamp to execute\n  delayMs?: number; // OR relative delay from now\n  maxRetries?: number; // Max retry attempts (default: 0)\n  assistantId?: string; // Which assistant created/owns this task\n  threadId?: string; // Which thread this task belongs to\n  metadata?: Record<string, any>;\n}\n\n/**\n * Options for scheduling a cron task\n */\nexport interface ScheduleCronOptions {\n  cronExpression: string; // Cron expression: \"0 9 * * *\"\n  timezone?: string; // Timezone: \"Asia/Shanghai\"\n  maxRuns?: number; // Max executions (undefined = infinite)\n  expiresAt?: number; // Stop after this timestamp\n  maxRetries?: number; // Max retry attempts per run (default: 0)\n  assistantId?: string; // Which assistant created/owns this task\n  threadId?: string; // Which thread this task belongs to\n  metadata?: Record<string, any>;\n}\n\n/**\n * Schedule storage interface for persistence\n */\nexport interface ScheduleStorage {\n  /**\n   * Save a new task\n   */\n  save(task: ScheduledTaskDefinition): Promise<void>;\n\n  /**\n   * Get task by ID\n   */\n  get(taskId: string): Promise<ScheduledTaskDefinition | null>;\n\n  /**\n   * Update task\n   */\n  update(\n    taskId: string,\n    updates: Partial<ScheduledTaskDefinition>\n  ): Promise<void>;\n\n  /**\n   * Delete task\n   */\n  delete(taskId: string): Promise<void>;\n\n  /**\n   * Get all pending/active tasks (for recovery)\n   * Returns tasks with status: PENDING or PAUSED\n   */\n  getActiveTasks(): Promise<ScheduledTaskDefinition[]>;\n\n  /**\n   * Get tasks by type\n   */\n  getTasksByType(taskType: string): Promise<ScheduledTaskDefinition[]>;\n\n  /**\n   * Get tasks by status\n   */\n  getTasksByStatus(\n    status: ScheduledTaskStatus\n  ): Promise<ScheduledTaskDefinition[]>;\n\n  /**\n   * Get tasks by execution type\n   */\n  getTasksByExecutionType(\n    executionType: ScheduleExecutionType\n  ): Promise<ScheduledTaskDefinition[]>;\n\n  /**\n   * Get tasks by assistant ID\n   */\n  getTasksByAssistantId(\n    assistantId: string\n  ): Promise<ScheduledTaskDefinition[]>;\n\n  /**\n   * Get tasks by thread ID\n   */\n  getTasksByThreadId(threadId: string): Promise<ScheduledTaskDefinition[]>;\n\n  /**\n   * Get all tasks (with optional filters)\n   */\n  getAllTasks(filters?: {\n    tenantId?: string;\n    status?: ScheduledTaskStatus;\n    executionType?: ScheduleExecutionType;\n    taskType?: string;\n    assistantId?: string;\n    threadId?: string;\n    limit?: number;\n    offset?: number;\n  }): Promise<ScheduledTaskDefinition[]>;\n\n  /**\n   * Count tasks (with optional filters)\n   */\n  countTasks(filters?: {\n    tenantId?: string;\n    status?: ScheduledTaskStatus;\n    executionType?: ScheduleExecutionType;\n    taskType?: string;\n    assistantId?: string;\n    threadId?: string;\n  }): Promise<number>;\n\n  /**\n   * Delete completed/cancelled tasks older than specified time\n   * Useful for cleanup\n   */\n  deleteOldTasks(olderThanMs: number): Promise<number>;\n}\n\n/**\n * Schedule client interface\n */\nexport interface ScheduleClient {\n  // ===== Handler Registration =====\n\n  /**\n   * Register a handler for a task type\n   * Must be called before scheduling tasks of this type\n   */\n  registerHandler(taskType: string, handler: TaskHandler): void;\n\n  /**\n   * Unregister a handler\n   */\n  unregisterHandler(taskType: string): boolean;\n\n  /**\n   * Check if a handler is registered\n   */\n  hasHandler(taskType: string): boolean;\n\n  /**\n   * Get all registered handler types\n   */\n  getHandlerTypes(): string[];\n\n  // ===== One-time Task Scheduling =====\n\n  /**\n   * Schedule a one-time task\n   * @param taskId - Unique identifier for the task\n   * @param taskType - Type of task (must have a registered handler)\n   * @param payload - Data to pass to the handler (must be JSON-serializable)\n   * @param options - Execution options (executeAt or delayMs required)\n   */\n  scheduleOnce(\n    taskId: string,\n    taskType: string,\n    payload: Record<string, any>,\n    options: ScheduleOnceOptions\n  ): Promise<boolean>;\n\n  // ===== Cron Task Scheduling =====\n\n  /**\n   * Schedule a recurring cron task\n   * @param taskId - Unique identifier for the task\n   * @param taskType - Type of task (must have a registered handler)\n   * @param payload - Data to pass to the handler (must be JSON-serializable)\n   * @param options - Cron options (cronExpression required)\n   */\n  scheduleCron(\n    taskId: string,\n    taskType: string,\n    payload: Record<string, any>,\n    options: ScheduleCronOptions\n  ): Promise<boolean>;\n\n  // ===== Task Management =====\n\n  /**\n   * Cancel a scheduled task\n   */\n  cancel(taskId: string): Promise<boolean>;\n\n  /**\n   * Pause a cron task (only for CRON type)\n   */\n  pause(taskId: string): Promise<boolean>;\n\n  /**\n   * Resume a paused cron task (only for CRON type)\n   */\n  resume(taskId: string): Promise<boolean>;\n\n  /**\n   * Check if a task exists\n   */\n  has(taskId: string): Promise<boolean>;\n\n  /**\n   * Get task information\n   */\n  getTask(taskId: string): Promise<ScheduledTaskDefinition | null>;\n\n  /**\n   * Get remaining time until next execution\n   * Returns -1 if task not found or already executed\n   */\n  getRemainingTime(taskId: string): Promise<number>;\n\n  /**\n   * Get count of active tasks (pending + paused)\n   */\n  getActiveTaskCount(): Promise<number>;\n\n  /**\n   * Get all active task IDs\n   */\n  getActiveTaskIds(): Promise<string[]>;\n\n  /**\n   * Cancel all active tasks\n   */\n  cancelAll(): Promise<void>;\n\n  // ===== Recovery =====\n\n  /**\n   * Restore active tasks from storage (call on service startup)\n   * Re-schedules all pending tasks with their remaining time\n   * Re-schedules all cron tasks for their next run\n   * @returns Number of tasks restored\n   */\n  restore(): Promise<number>;\n\n  // ===== Storage =====\n\n  /**\n   * Set the storage backend\n   */\n  setStorage(storage: ScheduleStorage): void;\n\n  /**\n   * Get current storage backend\n   */\n  getStorage(): ScheduleStorage | null;\n}\n\n/**\n * Schedule Lattice protocol interface\n */\nexport interface ScheduleLatticeProtocol\n  extends BaseLatticeProtocol<ScheduleConfig, ScheduleClient> {\n  // Handler registration\n  registerHandler: (taskType: string, handler: TaskHandler) => void;\n  unregisterHandler: (taskType: string) => boolean;\n  hasHandler: (taskType: string) => boolean;\n  getHandlerTypes: () => string[];\n\n  // One-time task scheduling\n  scheduleOnce: (\n    taskId: string,\n    taskType: string,\n    payload: Record<string, any>,\n    options: ScheduleOnceOptions\n  ) => Promise<boolean>;\n\n  // Cron task scheduling\n  scheduleCron: (\n    taskId: string,\n    taskType: string,\n    payload: Record<string, any>,\n    options: ScheduleCronOptions\n  ) => Promise<boolean>;\n\n  // Task management\n  cancel: (taskId: string) => Promise<boolean>;\n  pause: (taskId: string) => Promise<boolean>;\n  resume: (taskId: string) => Promise<boolean>;\n  has: (taskId: string) => Promise<boolean>;\n  getTask: (taskId: string) => Promise<ScheduledTaskDefinition | null>;\n  getRemainingTime: (taskId: string) => Promise<number>;\n  getActiveTaskCount: () => Promise<number>;\n  getActiveTaskIds: () => Promise<string[]>;\n  cancelAll: () => Promise<void>;\n\n  // Recovery\n  restore: () => Promise<number>;\n}\n","/**\n * LoggerLatticeProtocol\n *\n * Logger Lattice protocol for logging management\n */\n\nimport { BaseLatticeProtocol } from \"./BaseLatticeProtocol\";\n\n/**\n * Logger service type enumeration\n */\nexport enum LoggerType {\n  PINO = \"pino\",\n  CONSOLE = \"console\",\n  CUSTOM = \"custom\",\n}\n\n/**\n * Logger context interface\n */\nexport interface LoggerContext {\n  \"x-user-id\"?: string;\n  \"x-tenant-id\"?: string;\n  \"x-request-id\"?: string;\n  \"x-task-id\"?: string;\n  \"x-thread-id\"?: string;\n  [key: string]: any;\n}\n\n/**\n * Pino logger file transport options\n */\nexport interface PinoFileOptions {\n  file?: string; // Log file path (e.g., \"./logs/app.log\" or \"./logs/app\")\n  frequency?: \"daily\" | \"hourly\" | \"minutely\" | string; // Log rotation frequency\n  mkdir?: boolean; // Create directory if not exists\n  size?: string; // Max file size (e.g., \"10M\", \"100K\")\n  maxFiles?: number; // Maximum number of log files to keep\n}\n\n/**\n * Logger configuration interface\n */\nexport interface LoggerConfig {\n  name: string; // Logger name\n  description?: string; // Logger description\n  type: LoggerType; // Logger service type\n  serviceName?: string; // Service name (e.g., \"lattice-gateway\")\n  loggerName?: string; // Logger instance name (e.g., \"fastify-server\")\n  context?: LoggerContext; // Initial context\n  // File logging options (for PINO type)\n  file?: string | PinoFileOptions; // Log file path or detailed file options\n  // Additional options (e.g., pino config, custom logger settings)\n  options?: Record<string, any>;\n}\n\n/**\n * Logger client interface\n */\nexport interface LoggerClient {\n  info: (msg: string, obj?: object) => void;\n  error: (msg: string, obj?: object | Error) => void;\n  warn: (msg: string, obj?: object) => void;\n  debug: (msg: string, obj?: object) => void;\n  updateContext?: (context: Partial<LoggerContext>) => void;\n  child?: (options: Partial<LoggerConfig>) => LoggerClient;\n}\n\n/**\n * Logger Lattice protocol interface\n */\nexport interface LoggerLatticeProtocol\n  extends BaseLatticeProtocol<LoggerConfig, LoggerClient> {\n  // Logger operations\n  info: (msg: string, obj?: object) => void;\n  error: (msg: string, obj?: object | Error) => void;\n  warn: (msg: string, obj?: object) => void;\n  debug: (msg: string, obj?: object) => void;\n  updateContext?: (context: Partial<LoggerContext>) => void;\n  child?: (options: Partial<LoggerConfig>) => LoggerClient;\n}\n","/**\n * McpLatticeProtocol\n *\n * Model Context Protocol (MCP) lattice protocol for integrating MCP servers\n * with the Lattice framework. Provides standardized interfaces for MCP\n * client connections, tool discovery, and remote execution.\n */\n\nimport { BaseLatticeProtocol, LatticeMessage } from \"./BaseLatticeProtocol\";\n\n/**\n * MCP transport type\n */\nexport type McpTransportType = \"stdio\" | \"streamable_http\" | \"sse\";\n\n/**\n * MCP server configuration\n */\nexport interface McpServerConfig {\n  /** Server name */\n  name: string;\n  /** Server version */\n  version: string;\n  /** Transport type */\n  transport: McpTransportType;\n  /** Command for stdio transport (e.g., \"npx\", \"python\") */\n  command?: string;\n  /** Arguments for stdio transport */\n  args?: string[];\n  /** URL for HTTP/SSE transport */\n  url?: string;\n  /** Environment variables */\n  env?: Record<string, string>;\n  /** Connection timeout in milliseconds */\n  timeout?: number;\n  /** Retry attempts on connection failure */\n  retryAttempts?: number;\n}\n\n/**\n * MCP tool definition\n */\nexport interface McpTool {\n  /** Tool name */\n  name: string;\n  /** Tool description */\n  description: string;\n  /** Input schema */\n  inputSchema: {\n    type: \"object\";\n    properties: Record<string, any>;\n    required?: string[];\n  };\n  /** Tool metadata */\n  metadata?: Record<string, any>;\n}\n\n/**\n * MCP tool call result\n */\nexport interface McpToolResult {\n  /** Whether the call was successful */\n  success: boolean;\n  /** Result content */\n  content: Array<{\n    type: \"text\" | \"image\" | \"audio\" | \"resource\";\n    data: any;\n    mimeType?: string;\n  }>;\n  /** Error message if failed */\n  error?: string;\n  /** Execution metadata */\n  metadata?: {\n    duration: number;\n    tokens?: number;\n    model?: string;\n  };\n}\n\n/**\n * MCP client interface\n */\nexport interface McpClient {\n  /** Client name */\n  name: string;\n  /** Client version */\n  version: string;\n  /** Server configuration */\n  serverConfig: McpServerConfig;\n  \n  /**\n   * Connect to MCP server\n   */\n  connect(): Promise<void>;\n  \n  /**\n   * Disconnect from MCP server\n   */\n  disconnect(): Promise<void>;\n  \n  /**\n   * Check if connected\n   */\n  isConnected(): boolean;\n  \n  /**\n   * List available tools\n   */\n  listTools(): Promise<McpTool[]>;\n  \n  /**\n   * Call a tool\n   */\n  callTool(name: string, arguments_: Record<string, any>): Promise<McpToolResult>;\n  \n  /**\n   * Subscribe to server notifications\n   */\n  subscribe(topic: string, handler: (data: any) => void): void;\n  \n  /**\n   * Unsubscribe from server notifications\n   */\n  unsubscribe(topic: string): void;\n  \n  /**\n   * Get client statistics\n   */\n  getStats(): McpStats;\n  \n  /**\n   * Get connection status\n   */\n  getStatus(): McpConnectionStatus;\n}\n\n/**\n * MCP client options\n */\nexport interface McpClientOptions {\n  /** Client name */\n  name: string;\n  /** Client version */\n  version: string;\n  /** Server configuration */\n  serverConfig: McpServerConfig;\n  /** Auto-connect on initialization */\n  autoConnect?: boolean;\n  /** Error handler */\n  onError?: (error: Error) => void;\n  /** Connection status handler */\n  onStatusChange?: (status: McpConnectionStatus) => void;\n}\n\n/**\n * MCP Lattice protocol interface\n */\nexport interface McpLatticeProtocol\n  extends BaseLatticeProtocol<McpServerConfig, McpClient> {\n  /**\n   * Server configuration\n   */\n  config: McpServerConfig;\n  \n  /**\n   * MCP client instance\n   */\n  client: McpClient;\n  \n  /**\n   * Connect to MCP server\n   */\n  connect(): Promise<void>;\n  \n  /**\n   * Disconnect from MCP server\n   */\n  disconnect(): Promise<void>;\n  \n  /**\n   * Get available tools\n   */\n  getTools(): Promise<McpTool[]>;\n  \n  /**\n   * Execute a tool\n   */\n  executeTool(\n    name: string,\n    arguments_: Record<string, any>\n  ): Promise<McpToolResult>;\n  \n  /**\n   * Execute with automatic retries\n   */\n  executeToolWithRetry(\n    name: string,\n    arguments_: Record<string, any>,\n    maxRetries?: number\n  ): Promise<McpToolResult>;\n  \n  /**\n   * Get protocol version\n   */\n  getProtocolVersion(): string;\n  \n  /**\n   * Health check\n   */\n  healthCheck(): Promise<boolean>;\n}\n\n/**\n * MCP message types\n */\nexport enum McpMessageType {\n  CONNECT = \"mcp:connect\",\n  DISCONNECT = \"mcp:disconnect\",\n  LIST_TOOLS = \"mcp:list_tools\",\n  CALL_TOOL = \"mcp:call_tool\",\n  TOOL_RESULT = \"mcp:tool_result\",\n  NOTIFICATION = \"mcp:notification\",\n  ERROR = \"mcp:error\",\n  HEALTH_CHECK = \"mcp:health_check\",\n}\n\n/**\n * MCP Lattice message\n */\nexport interface McpLatticeMessage extends LatticeMessage {\n  type: McpMessageType;\n  payload: {\n    toolName?: string;\n    arguments?: Record<string, any>;\n    result?: McpToolResult;\n    tools?: McpTool[];\n    error?: string;\n  };\n}\n\n/**\n * MCP connection status\n */\nexport type McpConnectionStatus =\n  | \"disconnected\"\n  | \"connecting\"\n  | \"connected\"\n  | \"reconnecting\"\n  | \"error\";\n\n/**\n * MCP statistics\n */\nexport interface McpStats {\n  totalCalls: number;\n  successfulCalls: number;\n  failedCalls: number;\n  averageLatency: number;\n  lastCallTimestamp: number;\n}\n"],"mappings":";AAaO,IAAK,YAAL,kBAAKA,eAAL;AACL,EAAAA,WAAA,WAAQ;AACR,EAAAA,WAAA,gBAAa;AACb,EAAAA,WAAA,UAAO;AAHG,SAAAA;AAAA,GAAA;AA+IL,SAAS,kBACd,QAC2B;AAC3B,SAAO,OAAO,SAAS;AACzB;AAsBO,SAAS,SAAS,QAAqD;AAC5E,SAAO;AACT;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;;;AC1MO,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;;;ACEL,IAAK,eAAL,kBAAKC,kBAAL;AACL,EAAAA,cAAA,YAAS;AACT,EAAAA,cAAA,cAAW;AACX,EAAAA,cAAA,WAAQ;AAHE,SAAAA;AAAA,GAAA;AASL,IAAK,wBAAL,kBAAKC,2BAAL;AACL,EAAAA,uBAAA,UAAO;AACP,EAAAA,uBAAA,UAAO;AAFG,SAAAA;AAAA,GAAA;AAQL,IAAK,sBAAL,kBAAKC,yBAAL;AACL,EAAAA,qBAAA,aAAU;AACV,EAAAA,qBAAA,aAAU;AACV,EAAAA,qBAAA,eAAY;AACZ,EAAAA,qBAAA,YAAS;AACT,EAAAA,qBAAA,eAAY;AACZ,EAAAA,qBAAA,YAAS;AANC,SAAAA;AAAA,GAAA;;;ACnBL,IAAK,aAAL,kBAAKC,gBAAL;AACL,EAAAA,YAAA,UAAO;AACP,EAAAA,YAAA,aAAU;AACV,EAAAA,YAAA,YAAS;AAHC,SAAAA;AAAA,GAAA;;;AC4ML,IAAK,iBAAL,kBAAKC,oBAAL;AACL,EAAAA,gBAAA,aAAU;AACV,EAAAA,gBAAA,gBAAa;AACb,EAAAA,gBAAA,gBAAa;AACb,EAAAA,gBAAA,eAAY;AACZ,EAAAA,gBAAA,iBAAc;AACd,EAAAA,gBAAA,kBAAe;AACf,EAAAA,gBAAA,WAAQ;AACR,EAAAA,gBAAA,kBAAe;AARL,SAAAA;AAAA,GAAA;","names":["AgentType","MemoryType","UIComponentType","QueueType","ScheduleType","ScheduleExecutionType","ScheduledTaskStatus","LoggerType","McpMessageType"]}
+{"version":3,"sources":["../src/AgentLatticeProtocol.ts","../src/MemoryLatticeProtocol.ts","../src/UILatticeProtocol.ts","../src/QueueLatticeProtocol.ts","../src/ScheduleLatticeProtocol.ts","../src/LoggerLatticeProtocol.ts","../src/McpLatticeProtocol.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  TEAM = \"team\",\n}\n\n/**\n * Runtime configuration that will be injected into LangGraphRunnableConfig.configurable\n * Tools can access these values via config.configurable.runConfig\n */\nexport interface AgentRunConfig {\n  /** Database key for SQL tools (registered via sqlDatabaseManager) */\n  databaseKey?: string;\n  /** Any additional runtime configuration */\n  [key: string]: any;\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  /**\n   * Key of the parent agent to inherit configuration from.\n   * When set, unspecified fields are inherited from the parent agent's config.\n   * Child's explicitly set fields override the parent's.\n   */\n  extendsAgent?: string;\n  schema?: ZodObject<any, any, any, any, any>; // Input validation schema\n  modelKey?: string; // Model key to use\n  /**\n   * Runtime configuration to inject into tool execution context\n   * Will be available in tools via config.configurable.runConfig\n   */\n  runConfig?: AgentRunConfig;\n  skillCategories?: string[];\n  middleware?: AgentMiddlewareConfig[];\n}\n\nexport type AvailableModule = \"filesystem\" | \"code_eval\" | \"browser\";\n\nexport interface SandboxMiddlewareConfig {\n  isolatedLevel: \"agent\" | \"thread\" | \"global\";\n  modules: AvailableModule[];\n}\n\nexport interface CodeEvalMiddlewareConfig {\n  isolatedLevel: \"agent\" | \"thread\" | \"global\";\n  timeout: number;\n  memoryLimit: number;\n}\n\nexport interface BrowserMiddlewareConfig {\n  isolatedLevel: \"agent\" | \"thread\" | \"global\";\n  headless: boolean;\n}\n\nexport interface SqlMiddlewareConfig {\n  databaseKeys?: string[];\n}\n\nexport interface MetricsMiddlewareConfig {\n  /** List of configured metrics server keys */\n  serverKeys: string[];\n  /** Optional descriptions for each server */\n  serverDescriptions?: Record<string, string>;\n}\n\nexport type MiddlewareType = \"filesystem\" | \"code_eval\" | \"browser\" | \"sql\" | \"skill\" | \"http\" | \"custom\" | \"metrics\" | \"ask_user_to_clarify\" | \"widget\";\n\nexport interface AgentMiddlewareConfig {\n  id: string;\n  type: MiddlewareType;\n  name: string;\n  description: string;\n  enabled: boolean;\n  config: SandboxMiddlewareConfig | CodeEvalMiddlewareConfig | BrowserMiddlewareConfig | SqlMiddlewareConfig | MetricsMiddlewareConfig | Record<string, any>;\n}\n\n/**\n * Bootstrap file configuration\n * Defines default content for project bootstrap files\n */\nexport interface BootstrapFilesConfig {\n  /** Default content for AGENTS.md - operating instructions */\n  agents?: string;\n  /** Default content for SOUL.md - personality and tone */\n  soul?: string;\n  /** Default content for IDENTITY.md - agent identity */\n  identity?: string;\n  /** Default content for USER.md - user preferences */\n  user?: string;\n  /** Default content for TOOLS.md - tool documentation */\n  tools?: string;\n  /** Default content for BOOTSTRAP.md - first-run tasks */\n  bootstrap?: string;\n}\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\n/**\n * Team teammate configuration -- describes an available teammate.\n */\nexport interface TeamTeammateConfig {\n  /** Unique name for this teammate (used as agent ID) */\n  name: string;\n  /** Role category (e.g. \"research\", \"writing\", \"review\") */\n  role: string;\n  /** Human-readable description of what this teammate does */\n  description: string;\n  /** Tool keys this teammate has access to */\n  tools?: string[];\n  /** Custom system prompt for this teammate */\n  prompt?: string;\n  /** Model key override for this teammate */\n  modelKey?: string;\n}\n\n/**\n * TEAM agent configuration -- a team lead that dynamically creates teammates.\n * Teammates are created on-the-fly from create_team tool input (name, role, description).\n */\nexport interface TeamAgentConfig extends BaseAgentConfig {\n  type: AgentType.TEAM;\n  /** Tool keys available to the team lead */\n  tools?: string[];\n  /** Maximum number of teammates running concurrently */\n  maxConcurrency?: number;\n  /**\n   * Schedule lattice key for polling task list / mailbox.\n   * When set, teammates use ScheduleLattice for periodic polling instead of event-driven wait.\n   */\n  scheduleLatticeKey?: string;\n  /** Poll interval in ms when using schedule lattice (default: 5000) */\n  pollIntervalMs?: number;\n}\n\n/**\n * Type guard to check if config is TeamAgentConfig\n */\nexport function isTeamAgentConfig(\n  config: AgentConfig\n): config is TeamAgentConfig {\n  return config.type === AgentType.TEAM;\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  | TeamAgentConfig\n\n/**\n * Agent configuration with tools property\n */\nexport type AgentConfigWithTools =\n  | ReactAgentConfig\n  | DeepAgentConfig\n  | TeamAgentConfig\n\n/**\n * Type guard to check if config has tools property\n */\nexport function hasTools(config: AgentConfig): config is AgentConfigWithTools {\n  return true\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","/**\n * ScheduleLatticeProtocol\n *\n * Schedule Lattice protocol for delayed and recurring task execution management\n * Supports persistence and recovery after service restart\n * Supports both one-time delayed tasks and cron-style recurring tasks\n */\n\nimport { BaseLatticeProtocol } from \"./BaseLatticeProtocol\";\n\n/**\n * Schedule service type enumeration\n */\nexport enum ScheduleType {\n  MEMORY = \"memory\",\n  POSTGRES = \"postgres\",\n  REDIS = \"redis\",\n}\n\n/**\n * Schedule execution type - one-time or recurring\n */\nexport enum ScheduleExecutionType {\n  ONCE = \"once\", // Execute once at specified time\n  CRON = \"cron\", // Recurring based on cron expression\n}\n\n/**\n * Task status enumeration\n */\nexport enum ScheduledTaskStatus {\n  PENDING = \"pending\", // Waiting to be executed\n  RUNNING = \"running\", // Currently executing\n  COMPLETED = \"completed\", // Successfully completed (for ONCE type)\n  FAILED = \"failed\", // Execution failed\n  CANCELLED = \"cancelled\", // Manually cancelled\n  PAUSED = \"paused\", // Paused (for CRON type)\n}\n\n/**\n * Schedule configuration interface\n */\nexport interface ScheduleConfig {\n  name: string;\n  description: string;\n  type: ScheduleType;\n  storage?: ScheduleStorage; // Optional storage for persistence\n  options?: Record<string, any>;\n}\n\n/**\n * Scheduled task definition - fully serializable\n * Supports both one-time and cron-style recurring tasks\n */\nexport interface ScheduledTaskDefinition {\n  taskId: string;\n  taskType: string; // Maps to a registered handler\n  payload: Record<string, any>; // JSON-serializable data passed to handler\n\n  // Context fields for querying\n  assistantId?: string; // Which assistant created/owns this task\n  threadId?: string; // Which thread this task belongs to\n\n  // Execution configuration\n  executionType: ScheduleExecutionType;\n\n  // For ONCE type - execute at specific time or after delay\n  executeAt?: number; // Timestamp when to execute\n  delayMs?: number; // Original delay in milliseconds (for reference)\n\n  // For CRON type - recurring schedule\n  cronExpression?: string; // Cron format: \"0 9 * * *\" (min hour day month weekday)\n  timezone?: string; // Timezone: \"Asia/Shanghai\", defaults to system timezone\n  nextRunAt?: number; // Next calculated execution time\n  lastRunAt?: number; // Last execution time\n\n  // Execution tracking\n  status: ScheduledTaskStatus;\n  runCount: number; // How many times executed\n  maxRuns?: number; // Max executions (null/undefined = infinite for cron, 1 for once)\n\n  // Error handling\n  retryCount: number; // Current retry count\n  maxRetries: number; // Maximum retry attempts\n  lastError?: string; // Last error message if failed\n\n  // Timestamps\n  createdAt: number;\n  updatedAt: number;\n  expiresAt?: number; // When to stop (for cron, optional)\n\n  metadata?: Record<string, any>; // Additional metadata\n}\n\n/**\n * Task handler function type\n */\nexport type TaskHandler = (\n  payload: Record<string, any>,\n  taskInfo: ScheduledTaskDefinition\n) => void | Promise<void>;\n\n/**\n * Options for scheduling a one-time task\n */\nexport interface ScheduleOnceOptions {\n  executeAt?: number; // Absolute timestamp to execute\n  delayMs?: number; // OR relative delay from now\n  maxRetries?: number; // Max retry attempts (default: 0)\n  assistantId?: string; // Which assistant created/owns this task\n  threadId?: string; // Which thread this task belongs to\n  metadata?: Record<string, any>;\n}\n\n/**\n * Options for scheduling a cron task\n */\nexport interface ScheduleCronOptions {\n  cronExpression: string; // Cron expression: \"0 9 * * *\"\n  timezone?: string; // Timezone: \"Asia/Shanghai\"\n  maxRuns?: number; // Max executions (undefined = infinite)\n  expiresAt?: number; // Stop after this timestamp\n  maxRetries?: number; // Max retry attempts per run (default: 0)\n  assistantId?: string; // Which assistant created/owns this task\n  threadId?: string; // Which thread this task belongs to\n  metadata?: Record<string, any>;\n}\n\n/**\n * Schedule storage interface for persistence\n */\nexport interface ScheduleStorage {\n  /**\n   * Save a new task\n   */\n  save(task: ScheduledTaskDefinition): Promise<void>;\n\n  /**\n   * Get task by ID\n   */\n  get(taskId: string): Promise<ScheduledTaskDefinition | null>;\n\n  /**\n   * Update task\n   */\n  update(\n    taskId: string,\n    updates: Partial<ScheduledTaskDefinition>\n  ): Promise<void>;\n\n  /**\n   * Delete task\n   */\n  delete(taskId: string): Promise<void>;\n\n  /**\n   * Get all pending/active tasks (for recovery)\n   * Returns tasks with status: PENDING or PAUSED\n   */\n  getActiveTasks(): Promise<ScheduledTaskDefinition[]>;\n\n  /**\n   * Get tasks by type\n   */\n  getTasksByType(taskType: string): Promise<ScheduledTaskDefinition[]>;\n\n  /**\n   * Get tasks by status\n   */\n  getTasksByStatus(\n    status: ScheduledTaskStatus\n  ): Promise<ScheduledTaskDefinition[]>;\n\n  /**\n   * Get tasks by execution type\n   */\n  getTasksByExecutionType(\n    executionType: ScheduleExecutionType\n  ): Promise<ScheduledTaskDefinition[]>;\n\n  /**\n   * Get tasks by assistant ID\n   */\n  getTasksByAssistantId(\n    assistantId: string\n  ): Promise<ScheduledTaskDefinition[]>;\n\n  /**\n   * Get tasks by thread ID\n   */\n  getTasksByThreadId(threadId: string): Promise<ScheduledTaskDefinition[]>;\n\n  /**\n   * Get all tasks (with optional filters)\n   */\n  getAllTasks(filters?: {\n    tenantId?: string;\n    status?: ScheduledTaskStatus;\n    executionType?: ScheduleExecutionType;\n    taskType?: string;\n    assistantId?: string;\n    threadId?: string;\n    limit?: number;\n    offset?: number;\n  }): Promise<ScheduledTaskDefinition[]>;\n\n  /**\n   * Count tasks (with optional filters)\n   */\n  countTasks(filters?: {\n    tenantId?: string;\n    status?: ScheduledTaskStatus;\n    executionType?: ScheduleExecutionType;\n    taskType?: string;\n    assistantId?: string;\n    threadId?: string;\n  }): Promise<number>;\n\n  /**\n   * Delete completed/cancelled tasks older than specified time\n   * Useful for cleanup\n   */\n  deleteOldTasks(olderThanMs: number): Promise<number>;\n}\n\n/**\n * Schedule client interface\n */\nexport interface ScheduleClient {\n  // ===== Handler Registration =====\n\n  /**\n   * Register a handler for a task type\n   * Must be called before scheduling tasks of this type\n   */\n  registerHandler(taskType: string, handler: TaskHandler): void;\n\n  /**\n   * Unregister a handler\n   */\n  unregisterHandler(taskType: string): boolean;\n\n  /**\n   * Check if a handler is registered\n   */\n  hasHandler(taskType: string): boolean;\n\n  /**\n   * Get all registered handler types\n   */\n  getHandlerTypes(): string[];\n\n  // ===== One-time Task Scheduling =====\n\n  /**\n   * Schedule a one-time task\n   * @param taskId - Unique identifier for the task\n   * @param taskType - Type of task (must have a registered handler)\n   * @param payload - Data to pass to the handler (must be JSON-serializable)\n   * @param options - Execution options (executeAt or delayMs required)\n   */\n  scheduleOnce(\n    taskId: string,\n    taskType: string,\n    payload: Record<string, any>,\n    options: ScheduleOnceOptions\n  ): Promise<boolean>;\n\n  // ===== Cron Task Scheduling =====\n\n  /**\n   * Schedule a recurring cron task\n   * @param taskId - Unique identifier for the task\n   * @param taskType - Type of task (must have a registered handler)\n   * @param payload - Data to pass to the handler (must be JSON-serializable)\n   * @param options - Cron options (cronExpression required)\n   */\n  scheduleCron(\n    taskId: string,\n    taskType: string,\n    payload: Record<string, any>,\n    options: ScheduleCronOptions\n  ): Promise<boolean>;\n\n  // ===== Task Management =====\n\n  /**\n   * Cancel a scheduled task\n   */\n  cancel(taskId: string): Promise<boolean>;\n\n  /**\n   * Pause a cron task (only for CRON type)\n   */\n  pause(taskId: string): Promise<boolean>;\n\n  /**\n   * Resume a paused cron task (only for CRON type)\n   */\n  resume(taskId: string): Promise<boolean>;\n\n  /**\n   * Check if a task exists\n   */\n  has(taskId: string): Promise<boolean>;\n\n  /**\n   * Get task information\n   */\n  getTask(taskId: string): Promise<ScheduledTaskDefinition | null>;\n\n  /**\n   * Get remaining time until next execution\n   * Returns -1 if task not found or already executed\n   */\n  getRemainingTime(taskId: string): Promise<number>;\n\n  /**\n   * Get count of active tasks (pending + paused)\n   */\n  getActiveTaskCount(): Promise<number>;\n\n  /**\n   * Get all active task IDs\n   */\n  getActiveTaskIds(): Promise<string[]>;\n\n  /**\n   * Cancel all active tasks\n   */\n  cancelAll(): Promise<void>;\n\n  // ===== Recovery =====\n\n  /**\n   * Restore active tasks from storage (call on service startup)\n   * Re-schedules all pending tasks with their remaining time\n   * Re-schedules all cron tasks for their next run\n   * @returns Number of tasks restored\n   */\n  restore(): Promise<number>;\n\n  // ===== Storage =====\n\n  /**\n   * Set the storage backend\n   */\n  setStorage(storage: ScheduleStorage): void;\n\n  /**\n   * Get current storage backend\n   */\n  getStorage(): ScheduleStorage | null;\n}\n\n/**\n * Schedule Lattice protocol interface\n */\nexport interface ScheduleLatticeProtocol\n  extends BaseLatticeProtocol<ScheduleConfig, ScheduleClient> {\n  // Handler registration\n  registerHandler: (taskType: string, handler: TaskHandler) => void;\n  unregisterHandler: (taskType: string) => boolean;\n  hasHandler: (taskType: string) => boolean;\n  getHandlerTypes: () => string[];\n\n  // One-time task scheduling\n  scheduleOnce: (\n    taskId: string,\n    taskType: string,\n    payload: Record<string, any>,\n    options: ScheduleOnceOptions\n  ) => Promise<boolean>;\n\n  // Cron task scheduling\n  scheduleCron: (\n    taskId: string,\n    taskType: string,\n    payload: Record<string, any>,\n    options: ScheduleCronOptions\n  ) => Promise<boolean>;\n\n  // Task management\n  cancel: (taskId: string) => Promise<boolean>;\n  pause: (taskId: string) => Promise<boolean>;\n  resume: (taskId: string) => Promise<boolean>;\n  has: (taskId: string) => Promise<boolean>;\n  getTask: (taskId: string) => Promise<ScheduledTaskDefinition | null>;\n  getRemainingTime: (taskId: string) => Promise<number>;\n  getActiveTaskCount: () => Promise<number>;\n  getActiveTaskIds: () => Promise<string[]>;\n  cancelAll: () => Promise<void>;\n\n  // Recovery\n  restore: () => Promise<number>;\n}\n","/**\n * LoggerLatticeProtocol\n *\n * Logger Lattice protocol for logging management\n */\n\nimport { BaseLatticeProtocol } from \"./BaseLatticeProtocol\";\n\n/**\n * Logger service type enumeration\n */\nexport enum LoggerType {\n  PINO = \"pino\",\n  CONSOLE = \"console\",\n  CUSTOM = \"custom\",\n}\n\n/**\n * Logger context interface\n */\nexport interface LoggerContext {\n  \"x-user-id\"?: string;\n  \"x-tenant-id\"?: string;\n  \"x-request-id\"?: string;\n  \"x-task-id\"?: string;\n  \"x-thread-id\"?: string;\n  [key: string]: any;\n}\n\n/**\n * Pino logger file transport options\n */\nexport interface PinoFileOptions {\n  file?: string; // Log file path (e.g., \"./logs/app.log\" or \"./logs/app\")\n  frequency?: \"daily\" | \"hourly\" | \"minutely\" | string; // Log rotation frequency\n  mkdir?: boolean; // Create directory if not exists\n  size?: string; // Max file size (e.g., \"10M\", \"100K\")\n  maxFiles?: number; // Maximum number of log files to keep\n}\n\n/**\n * Logger configuration interface\n */\nexport interface LoggerConfig {\n  name: string; // Logger name\n  description?: string; // Logger description\n  type: LoggerType; // Logger service type\n  serviceName?: string; // Service name (e.g., \"lattice-gateway\")\n  loggerName?: string; // Logger instance name (e.g., \"fastify-server\")\n  context?: LoggerContext; // Initial context\n  // File logging options (for PINO type)\n  file?: string | PinoFileOptions; // Log file path or detailed file options\n  // Additional options (e.g., pino config, custom logger settings)\n  options?: Record<string, any>;\n}\n\n/**\n * Logger client interface\n */\nexport interface LoggerClient {\n  info: (msg: string, obj?: object) => void;\n  error: (msg: string, obj?: object | Error) => void;\n  warn: (msg: string, obj?: object) => void;\n  debug: (msg: string, obj?: object) => void;\n  updateContext?: (context: Partial<LoggerContext>) => void;\n  child?: (options: Partial<LoggerConfig>) => LoggerClient;\n}\n\n/**\n * Logger Lattice protocol interface\n */\nexport interface LoggerLatticeProtocol\n  extends BaseLatticeProtocol<LoggerConfig, LoggerClient> {\n  // Logger operations\n  info: (msg: string, obj?: object) => void;\n  error: (msg: string, obj?: object | Error) => void;\n  warn: (msg: string, obj?: object) => void;\n  debug: (msg: string, obj?: object) => void;\n  updateContext?: (context: Partial<LoggerContext>) => void;\n  child?: (options: Partial<LoggerConfig>) => LoggerClient;\n}\n","/**\n * McpLatticeProtocol\n *\n * Model Context Protocol (MCP) lattice protocol for integrating MCP servers\n * with the Lattice framework. Provides standardized interfaces for MCP\n * client connections, tool discovery, and remote execution.\n */\n\nimport { BaseLatticeProtocol, LatticeMessage } from \"./BaseLatticeProtocol\";\n\n/**\n * MCP transport type\n */\nexport type McpTransportType = \"stdio\" | \"streamable_http\" | \"sse\";\n\n/**\n * MCP server configuration\n */\nexport interface McpServerConfig {\n  /** Server name */\n  name: string;\n  /** Server version */\n  version: string;\n  /** Transport type */\n  transport: McpTransportType;\n  /** Command for stdio transport (e.g., \"npx\", \"python\") */\n  command?: string;\n  /** Arguments for stdio transport */\n  args?: string[];\n  /** URL for HTTP/SSE transport */\n  url?: string;\n  /** Environment variables */\n  env?: Record<string, string>;\n  /** Connection timeout in milliseconds */\n  timeout?: number;\n  /** Retry attempts on connection failure */\n  retryAttempts?: number;\n}\n\n/**\n * MCP tool definition\n */\nexport interface McpTool {\n  /** Tool name */\n  name: string;\n  /** Tool description */\n  description: string;\n  /** Input schema */\n  inputSchema: {\n    type: \"object\";\n    properties: Record<string, any>;\n    required?: string[];\n  };\n  /** Tool metadata */\n  metadata?: Record<string, any>;\n}\n\n/**\n * MCP tool call result\n */\nexport interface McpToolResult {\n  /** Whether the call was successful */\n  success: boolean;\n  /** Result content */\n  content: Array<{\n    type: \"text\" | \"image\" | \"audio\" | \"resource\";\n    data: any;\n    mimeType?: string;\n  }>;\n  /** Error message if failed */\n  error?: string;\n  /** Execution metadata */\n  metadata?: {\n    duration: number;\n    tokens?: number;\n    model?: string;\n  };\n}\n\n/**\n * MCP client interface\n */\nexport interface McpClient {\n  /** Client name */\n  name: string;\n  /** Client version */\n  version: string;\n  /** Server configuration */\n  serverConfig: McpServerConfig;\n  \n  /**\n   * Connect to MCP server\n   */\n  connect(): Promise<void>;\n  \n  /**\n   * Disconnect from MCP server\n   */\n  disconnect(): Promise<void>;\n  \n  /**\n   * Check if connected\n   */\n  isConnected(): boolean;\n  \n  /**\n   * List available tools\n   */\n  listTools(): Promise<McpTool[]>;\n  \n  /**\n   * Call a tool\n   */\n  callTool(name: string, arguments_: Record<string, any>): Promise<McpToolResult>;\n  \n  /**\n   * Subscribe to server notifications\n   */\n  subscribe(topic: string, handler: (data: any) => void): void;\n  \n  /**\n   * Unsubscribe from server notifications\n   */\n  unsubscribe(topic: string): void;\n  \n  /**\n   * Get client statistics\n   */\n  getStats(): McpStats;\n  \n  /**\n   * Get connection status\n   */\n  getStatus(): McpConnectionStatus;\n}\n\n/**\n * MCP client options\n */\nexport interface McpClientOptions {\n  /** Client name */\n  name: string;\n  /** Client version */\n  version: string;\n  /** Server configuration */\n  serverConfig: McpServerConfig;\n  /** Auto-connect on initialization */\n  autoConnect?: boolean;\n  /** Error handler */\n  onError?: (error: Error) => void;\n  /** Connection status handler */\n  onStatusChange?: (status: McpConnectionStatus) => void;\n}\n\n/**\n * MCP Lattice protocol interface\n */\nexport interface McpLatticeProtocol\n  extends BaseLatticeProtocol<McpServerConfig, McpClient> {\n  /**\n   * Server configuration\n   */\n  config: McpServerConfig;\n  \n  /**\n   * MCP client instance\n   */\n  client: McpClient;\n  \n  /**\n   * Connect to MCP server\n   */\n  connect(): Promise<void>;\n  \n  /**\n   * Disconnect from MCP server\n   */\n  disconnect(): Promise<void>;\n  \n  /**\n   * Get available tools\n   */\n  getTools(): Promise<McpTool[]>;\n  \n  /**\n   * Execute a tool\n   */\n  executeTool(\n    name: string,\n    arguments_: Record<string, any>\n  ): Promise<McpToolResult>;\n  \n  /**\n   * Execute with automatic retries\n   */\n  executeToolWithRetry(\n    name: string,\n    arguments_: Record<string, any>,\n    maxRetries?: number\n  ): Promise<McpToolResult>;\n  \n  /**\n   * Get protocol version\n   */\n  getProtocolVersion(): string;\n  \n  /**\n   * Health check\n   */\n  healthCheck(): Promise<boolean>;\n}\n\n/**\n * MCP message types\n */\nexport enum McpMessageType {\n  CONNECT = \"mcp:connect\",\n  DISCONNECT = \"mcp:disconnect\",\n  LIST_TOOLS = \"mcp:list_tools\",\n  CALL_TOOL = \"mcp:call_tool\",\n  TOOL_RESULT = \"mcp:tool_result\",\n  NOTIFICATION = \"mcp:notification\",\n  ERROR = \"mcp:error\",\n  HEALTH_CHECK = \"mcp:health_check\",\n}\n\n/**\n * MCP Lattice message\n */\nexport interface McpLatticeMessage extends LatticeMessage {\n  type: McpMessageType;\n  payload: {\n    toolName?: string;\n    arguments?: Record<string, any>;\n    result?: McpToolResult;\n    tools?: McpTool[];\n    error?: string;\n  };\n}\n\n/**\n * MCP connection status\n */\nexport type McpConnectionStatus =\n  | \"disconnected\"\n  | \"connecting\"\n  | \"connected\"\n  | \"reconnecting\"\n  | \"error\";\n\n/**\n * MCP statistics\n */\nexport interface McpStats {\n  totalCalls: number;\n  successfulCalls: number;\n  failedCalls: number;\n  averageLatency: number;\n  lastCallTimestamp: number;\n}\n"],"mappings":";AAaO,IAAK,YAAL,kBAAKA,eAAL;AACL,EAAAA,WAAA,WAAQ;AACR,EAAAA,WAAA,gBAAa;AACb,EAAAA,WAAA,UAAO;AAHG,SAAAA;AAAA,GAAA;AAkKL,SAAS,kBACd,QAC2B;AAC3B,SAAO,OAAO,SAAS;AACzB;AAsBO,SAAS,SAAS,QAAqD;AAC5E,SAAO;AACT;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;;;AC7NO,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;;;ACEL,IAAK,eAAL,kBAAKC,kBAAL;AACL,EAAAA,cAAA,YAAS;AACT,EAAAA,cAAA,cAAW;AACX,EAAAA,cAAA,WAAQ;AAHE,SAAAA;AAAA,GAAA;AASL,IAAK,wBAAL,kBAAKC,2BAAL;AACL,EAAAA,uBAAA,UAAO;AACP,EAAAA,uBAAA,UAAO;AAFG,SAAAA;AAAA,GAAA;AAQL,IAAK,sBAAL,kBAAKC,yBAAL;AACL,EAAAA,qBAAA,aAAU;AACV,EAAAA,qBAAA,aAAU;AACV,EAAAA,qBAAA,eAAY;AACZ,EAAAA,qBAAA,YAAS;AACT,EAAAA,qBAAA,eAAY;AACZ,EAAAA,qBAAA,YAAS;AANC,SAAAA;AAAA,GAAA;;;ACnBL,IAAK,aAAL,kBAAKC,gBAAL;AACL,EAAAA,YAAA,UAAO;AACP,EAAAA,YAAA,aAAU;AACV,EAAAA,YAAA,YAAS;AAHC,SAAAA;AAAA,GAAA;;;AC4ML,IAAK,iBAAL,kBAAKC,oBAAL;AACL,EAAAA,gBAAA,aAAU;AACV,EAAAA,gBAAA,gBAAa;AACb,EAAAA,gBAAA,gBAAa;AACb,EAAAA,gBAAA,eAAY;AACZ,EAAAA,gBAAA,iBAAc;AACd,EAAAA,gBAAA,kBAAe;AACf,EAAAA,gBAAA,WAAQ;AACR,EAAAA,gBAAA,kBAAe;AARL,SAAAA;AAAA,GAAA;","names":["AgentType","MemoryType","UIComponentType","QueueType","ScheduleType","ScheduleExecutionType","ScheduledTaskStatus","LoggerType","McpMessageType"]}

package/package.json

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

package/src/AgentLatticeProtocol.ts

@@ -82,7 +82,7 @@ export interface MetricsMiddlewareConfig {
   serverDescriptions?: Record<string, string>;
 }
 
-export type MiddlewareType = "filesystem" | "code_eval" | "browser" | "sql" | "skill" | "http" | "custom" | "metrics" | "ask_user_to_clarify";
+export type MiddlewareType = "filesystem" | "code_eval" | "browser" | "sql" | "skill" | "http" | "custom" | "metrics" | "ask_user_to_clarify" | "widget";
 
 export interface AgentMiddlewareConfig {
   id: string;
@@ -93,6 +93,25 @@ export interface AgentMiddlewareConfig {
   config: SandboxMiddlewareConfig | CodeEvalMiddlewareConfig | BrowserMiddlewareConfig | SqlMiddlewareConfig | MetricsMiddlewareConfig | Record<string, any>;
 }
 
+/**
+ * Bootstrap file configuration
+ * Defines default content for project bootstrap files
+ */
+export interface BootstrapFilesConfig {
+  /** Default content for AGENTS.md - operating instructions */
+  agents?: string;
+  /** Default content for SOUL.md - personality and tone */
+  soul?: string;
+  /** Default content for IDENTITY.md - agent identity */
+  identity?: string;
+  /** Default content for USER.md - user preferences */
+  user?: string;
+  /** Default content for TOOLS.md - tool documentation */
+  tools?: string;
+  /** Default content for BOOTSTRAP.md - first-run tasks */
+  bootstrap?: string;
+}
+
 
 /**
  * REACT agent configuration

package/src/MetricsServerConfigStoreProtocol.ts

@@ -222,6 +222,19 @@ export interface SemanticMetricsFilter {
   values: (string | number | boolean)[];
 }
 
+/**
+ * Query result format options
+ */
+export type QueryResultFormat = 'array' | 'object' | 'both';
+
+/**
+ * Column definition
+ */
+export interface MetricColumn {
+  name: string;
+  type: string;  // 'date', 'numeric', 'string', 'varchar', 'boolean', etc.
+}
+
 /**
  * Request body for semantic metrics query
  */
@@ -236,67 +249,45 @@ export interface SemanticMetricsQueryRequest {
   filters?: SemanticMetricsFilter[];
   /** Optional result limit */
   limit?: number;
-}
-
-/**
- * Single data point in semantic metrics query response
- */
-export interface SemanticMetricDataPoint {
-  /** Timestamp in milliseconds */
-  timestamp?: number;
-  /** Metric value */
-  value: number;
-  /** Metric name */
-  metricName?: string;
-  /** Additional dimension values */
-  labels?: Record<string, string>;
-  /** Group by dimension values */
-  groupByValues?: Record<string, string>;
-}
-
-/**
- * AI Hints for a single metric result
- */
-export interface SemanticMetricAiHints {
-  polarity: string;
-  valueInterpretation: string;
-  thresholds?: Array<{
-    metric: string;
-    operator: string;
-    value: number;
-    level: string;
-  }>;
-  suggestedFollowup?: string[];
-}
-
-/**
- * Single metric result from semantic metrics query
- */
-export interface SemanticMetricResult {
-  metricName: string;
-  displayName: string;
-  dataType: string;
-  format: string;
-  polarity: string;
-  columns: string[];
-  rows: Array<Record<string, unknown>>;
-  rowCount: number;
-  executionTimeMs: number;
-  aiHints: SemanticMetricAiHints;
+  /** Optional format specification - defaults to 'array' */
+  format?: QueryResultFormat;
 }
 
 /**
  * Response from semantic metrics query
+ * 
+ * Note: The actual API response format has changed from the original design.
+ * It now returns a flat structure with columns and rows arrays.
+ * 
+ * Based on format parameter:
+ * - 'array' (default): returns rows as array of arrays
+ * - 'object': returns rowsObject as array of objects  
+ * - 'both': returns both formats
  */
 export interface SemanticMetricsQueryResponse {
-  /** Data source ID that was queried */
-  datasourceId: string | number;
-  /** Data source name */
-  datasourceName?: string;
-  /** Query results for each metric */
-  results: SemanticMetricResult[];
-  /** Total execution time in ms */
-  totalExecutionTimeMs?: number;
+  /** Semantic model name that was queried */
+  semanticModel: string;
+  /** Column definitions with name and type */
+  columns: MetricColumn[];
+  /** Number of rows returned */
+  rowCount: number;
+  /** Execution time in milliseconds */
+  executionTimeMs?: number;
+  /** 
+   * Data rows as arrays (each row is an array of values corresponding to columns)
+   * Present when format is 'array' or 'both'
+   */
+  rows?: Array<Array<unknown>>;
+  /**
+   * Data rows as objects (each row is {columnName: value})
+   * Present when format is 'object' or 'both'
+   */
+  rowsObject?: Array<Record<string, unknown>>;
+  /** Debug information (optional) */
+  debug?: {
+    sql?: string;
+    params?: unknown;
+  };
 }
 
 /**
@@ -311,23 +302,86 @@ export interface ExecuteSqlQueryRequest {
   params?: Record<string, string | number | boolean>;
   /** Optional result limit */
   limit?: number;
+  /** Optional format specification - defaults to 'object' */
+  format?: QueryResultFormat;
 }
 
 /**
  * Response from custom SQL query execution
+ *
+ * Based on format parameter:
+ * - 'object' (default): returns rowsObject as array of objects
+ * - 'array': returns rows as array of arrays
+ * - 'both': returns both formats
  */
 export interface ExecuteSqlQueryResponse {
   /** Data source ID that was queried */
   datasourceId: string | number;
   /** Data source name */
   datasourceName?: string;
-  result: {
-    executedSql: string;
-    columns: string[];
-    rows: Array<Record<string, unknown>>;
-    rowCount: number;
-    executionTimeMs: number;
-  }
+  /** Name of the queried table (if applicable) */
+  tableName?: string;
+  /** Column names in order */
+  columns: string[];
+  /** Number of rows returned */
+  rowCount: number;
+  /** Execution time in milliseconds */
+  executionTimeMs: number;
+  /** Executed SQL query */
+  executedSql: string;
+  /**
+   * Data rows as arrays
+   * Present when format is 'array' or 'both'
+   */
+  rows?: Array<Array<unknown>>;
+  /**
+   * Data rows as objects (each row is {columnName: value})
+   * Present when format is 'object' or 'both'
+   */
+  rowsObject?: Array<Record<string, unknown>>;
+}
+
+/**
+ * Request body for table query
+ */
+export interface TableQueryRequest {
+  /** Table name to query */
+  tableName: string;
+  /** Optional result limit */
+  limit?: number;
+  /** Optional format specification - defaults to 'object' */
+  format?: QueryResultFormat;
+}
+
+/**
+ * Response from table query
+ *
+ * Based on format parameter:
+ * - 'object' (default): returns rowsObject as array of objects (API native format)
+ * - 'array': returns rows as array of arrays
+ * - 'both': returns both formats
+ */
+export interface TableQueryResponse {
+  /** Name of the queried table */
+  tableName: string;
+  /** Column names in order */
+  columns: string[];
+  /** Number of rows returned */
+  rowCount: number;
+  /** Execution time in milliseconds */
+  executionTimeMs: number;
+  /** Executed SQL query */
+  executedSql: string;
+  /**
+   * Data rows as arrays
+   * Present when format is 'array' or 'both'
+   */
+  rows?: Array<Array<unknown>>;
+  /**
+   * Data rows as objects (each row is {columnName: value})
+   * Present when format is 'object' or 'both' (API native format)
+   */
+  rowsObject?: Array<Record<string, unknown>>;
 }
 
 /**

package/src/ModelLatticeProtocol.ts

@@ -24,6 +24,8 @@ export interface LLMConfig {
   apiKeyEnvName?: string;
   apiKey?: string;
   baseURL?: string;
+  modelKwargs?: Record<string, any>;
+  extra?: Record<string, any>
 }
 
 /**