@axiom-lattice/protocols 2.1.20 → 2.1.22

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.22 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.76 KB
+CJS ⚡️ Build success in 72ms
 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.49 KB
+ESM ⚡️ Build success in 73ms
 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 2793ms
+DTS dist/index.d.ts  75.87 KB
+DTS dist/index.d.mts 75.87 KB

package/CHANGELOG.md

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

package/dist/index.d.mts

@@ -93,6 +93,7 @@ interface ToolLatticeProtocol extends BaseLatticeProtocol<ToolConfig, Structured
 interface LLMConfig {
     provider: "azure" | "openai" | "deepseek" | "siliconcloud" | "volcengine";
     model: string;
+    displayName?: string;
     maxTokens?: number;
     temperature?: number;
     timeout?: number;
@@ -101,6 +102,8 @@ interface LLMConfig {
     apiKeyEnvName?: string;
     apiKey?: string;
     baseURL?: string;
+    modelKwargs?: Record<string, any>;
+    extra?: Record<string, any>;
 }
 /**
  * 模型Lattice协议接口
@@ -182,14 +185,42 @@ 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" | "claw";
 interface AgentMiddlewareConfig {
     id: string;
     type: MiddlewareType;
     name: string;
     description: string;
     enabled: boolean;
-    config: SandboxMiddlewareConfig | CodeEvalMiddlewareConfig | BrowserMiddlewareConfig | SqlMiddlewareConfig | MetricsMiddlewareConfig | Record<string, any>;
+    config: SandboxMiddlewareConfig | CodeEvalMiddlewareConfig | BrowserMiddlewareConfig | SqlMiddlewareConfig | MetricsMiddlewareConfig | ClawMiddlewareConfig | 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;
+}
+/**
+ * Claw Middleware 配置
+ * 用于配置 bootstrap 文件管理行为
+ */
+interface ClawMiddlewareConfig {
+    /** 是否启用 bootstrap 文件注入（默认：true） */
+    injectBootstrapFiles?: boolean;
+    /** 自定义 bootstrap 文件内容 */
+    bootstrapFiles?: BootstrapFilesConfig;
 }
 /**
  * REACT agent configuration
@@ -496,6 +527,7 @@ interface ScheduledTaskDefinition {
     taskId: string;
     taskType: string;
     payload: Record<string, any>;
+    tenantId: string;
     assistantId?: string;
     threadId?: string;
     executionType: ScheduleExecutionType;
@@ -527,6 +559,7 @@ interface ScheduleOnceOptions {
     executeAt?: number;
     delayMs?: number;
     maxRetries?: number;
+    tenantId?: string;
     assistantId?: string;
     threadId?: string;
     metadata?: Record<string, any>;
@@ -540,6 +573,7 @@ interface ScheduleCronOptions {
     maxRuns?: number;
     expiresAt?: number;
     maxRetries?: number;
+    tenantId?: string;
     assistantId?: string;
     threadId?: string;
     metadata?: Record<string, any>;
@@ -2125,6 +2159,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 +2184,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 +2235,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 +2734,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 ClawMiddlewareConfig, 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

@@ -93,6 +93,7 @@ interface ToolLatticeProtocol extends BaseLatticeProtocol<ToolConfig, Structured
 interface LLMConfig {
     provider: "azure" | "openai" | "deepseek" | "siliconcloud" | "volcengine";
     model: string;
+    displayName?: string;
     maxTokens?: number;
     temperature?: number;
     timeout?: number;
@@ -101,6 +102,8 @@ interface LLMConfig {
     apiKeyEnvName?: string;
     apiKey?: string;
     baseURL?: string;
+    modelKwargs?: Record<string, any>;
+    extra?: Record<string, any>;
 }
 /**
  * 模型Lattice协议接口
@@ -182,14 +185,42 @@ 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" | "claw";
 interface AgentMiddlewareConfig {
     id: string;
     type: MiddlewareType;
     name: string;
     description: string;
     enabled: boolean;
-    config: SandboxMiddlewareConfig | CodeEvalMiddlewareConfig | BrowserMiddlewareConfig | SqlMiddlewareConfig | MetricsMiddlewareConfig | Record<string, any>;
+    config: SandboxMiddlewareConfig | CodeEvalMiddlewareConfig | BrowserMiddlewareConfig | SqlMiddlewareConfig | MetricsMiddlewareConfig | ClawMiddlewareConfig | 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;
+}
+/**
+ * Claw Middleware 配置
+ * 用于配置 bootstrap 文件管理行为
+ */
+interface ClawMiddlewareConfig {
+    /** 是否启用 bootstrap 文件注入（默认：true） */
+    injectBootstrapFiles?: boolean;
+    /** 自定义 bootstrap 文件内容 */
+    bootstrapFiles?: BootstrapFilesConfig;
 }
 /**
  * REACT agent configuration
@@ -496,6 +527,7 @@ interface ScheduledTaskDefinition {
     taskId: string;
     taskType: string;
     payload: Record<string, any>;
+    tenantId: string;
     assistantId?: string;
     threadId?: string;
     executionType: ScheduleExecutionType;
@@ -527,6 +559,7 @@ interface ScheduleOnceOptions {
     executeAt?: number;
     delayMs?: number;
     maxRetries?: number;
+    tenantId?: string;
     assistantId?: string;
     threadId?: string;
     metadata?: Record<string, any>;
@@ -540,6 +573,7 @@ interface ScheduleCronOptions {
     maxRuns?: number;
     expiresAt?: number;
     maxRetries?: number;
+    tenantId?: string;
     assistantId?: string;
     threadId?: string;
     metadata?: Record<string, any>;
@@ -2125,6 +2159,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 +2184,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 +2235,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 +2734,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 ClawMiddlewareConfig, 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 };