@axiom-lattice/protocols 2.1.39 → 2.1.40

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @axiom-lattice/protocols@2.1.39 build /home/runner/work/agentic/agentic/packages/protocols
+> @axiom-lattice/protocols@2.1.40 build /home/runner/work/agentic/agentic/packages/protocols
 > tsup src/index.ts --format cjs,esm --dts --sourcemap
 
 CLI Building entry: src/index.ts
@@ -8,13 +8,13 @@
 CLI Target: es2020
 CJS Build start
 ESM Build start
-ESM dist/index.mjs     4.12 KB
-ESM dist/index.mjs.map 35.65 KB
-ESM ⚡️ Build success in 132ms
-CJS dist/index.js     5.75 KB
-CJS dist/index.js.map 37.16 KB
-CJS ⚡️ Build success in 133ms
+ESM dist/index.mjs     4.63 KB
+ESM dist/index.mjs.map 41.44 KB
+ESM ⚡️ Build success in 218ms
+CJS dist/index.js     6.48 KB
+CJS dist/index.js.map 43.04 KB
+CJS ⚡️ Build success in 221ms
 DTS Build start
-DTS ⚡️ Build success in 9189ms
-DTS dist/index.d.ts  92.21 KB
-DTS dist/index.d.mts 92.21 KB
+DTS ⚡️ Build success in 9959ms
+DTS dist/index.d.ts  99.35 KB
+DTS dist/index.d.mts 99.35 KB

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @axiom-lattice/protocols
 
+## 2.1.40
+
+### Patch Changes
+
+- b7cd409: enhance more features a2a, cli
+
 ## 2.1.39
 
 ### Patch Changes

package/dist/index.d.mts

@@ -127,7 +127,9 @@ declare enum AgentType {
     REACT = "react",
     DEEP_AGENT = "deep_agent",
     TEAM = "team",
-    PROCESSING = "processing"
+    PROCESSING = "processing",
+    /** Remote A2A agent — delegates to an external A2A-compatible server */
+    A2A_REMOTE = "a2a_remote"
 }
 /**
  * Runtime configuration that will be injected into LangGraphRunnableConfig.configurable
@@ -291,15 +293,45 @@ interface TeamAgentConfig extends BaseAgentConfig {
  * Type guard to check if config is TeamAgentConfig
  */
 declare function isTeamAgentConfig(config: AgentConfig): config is TeamAgentConfig;
+/**
+ * A2A_REMOTE agent configuration — delegates to an external A2A server.
+ *
+ * This agent type wraps a remote A2A endpoint so orchestrators can treat
+ * external agents the same as local LangGraph agents.
+ */
+interface A2ARemoteAgentConfig extends BaseAgentConfig {
+    type: AgentType.A2A_REMOTE;
+    /**
+     * URL of the remote agent's agent card (e.g. http://host:3000/.well-known/agent-card.json).
+     * The builder fetches this card to discover the JSON-RPC endpoint.
+     */
+    agentCardUrl: string;
+    /**
+     * Optional API key sent as Bearer token or X-API-Key header.
+     */
+    apiKey?: string;
+    /**
+     * HTTP timeout in milliseconds (default: 300_000 = 5 min).
+     */
+    timeout?: number;
+    /**
+     * Optional tool keys (not used by the builder, but included for type compatibility).
+     */
+    tools?: string[];
+}
+/**
+ * Type guard to check if config is A2ARemoteAgentConfig
+ */
+declare function isA2ARemoteAgentConfig(config: AgentConfig): config is A2ARemoteAgentConfig;
 /**
  * Agent configuration union type
  * Different agent types have different configuration options
  */
-type AgentConfig = ReactAgentConfig | DeepAgentConfig | TeamAgentConfig | ProcessingAgentConfig;
+type AgentConfig = ReactAgentConfig | DeepAgentConfig | TeamAgentConfig | ProcessingAgentConfig | A2ARemoteAgentConfig;
 /**
  * Agent configuration with tools property
  */
-type AgentConfigWithTools = ReactAgentConfig | DeepAgentConfig | TeamAgentConfig | ProcessingAgentConfig;
+type AgentConfigWithTools = ReactAgentConfig | DeepAgentConfig | TeamAgentConfig | ProcessingAgentConfig | A2ARemoteAgentConfig;
 /**
  * Type guard to check if config has tools property
  */
@@ -1772,6 +1804,8 @@ interface Project {
     workspaceId: string;
     name: string;
     description?: string;
+    /** Application-specific configuration stored as JSON */
+    config?: Record<string, unknown>;
     createdAt: Date;
     updatedAt: Date;
 }
@@ -1781,13 +1815,21 @@ interface Project {
 interface CreateProjectRequest {
     name: string;
     description?: string;
+    /** Application-specific configuration stored as JSON (optional) */
+    config?: Record<string, unknown>;
 }
 /**
  * Update project request type
+ *
+ * @remarks
+ * - The `config` field uses **replace** semantics: if provided, it completely
+ *   overwrites the existing config. To preserve the current config, omit this field.
  */
 interface UpdateProjectRequest {
     name?: string;
     description?: string;
+    /** Application-specific configuration stored as JSON (replaces existing if provided) */
+    config?: Record<string, unknown>;
 }
 /**
  * ProjectStore interface
@@ -3142,6 +3184,201 @@ interface ChannelAdapter<TConfig = unknown> {
     sendReply(replyTarget: ReplyTarget, message: OutboundMessage, installation: ChannelInstallation): Promise<void>;
 }
 
+/**
+ * A2AProtocol - Google Agent-to-Agent Protocol type definitions
+ *
+ * Based on the A2A open protocol spec for AI agent interoperability.
+ * @see https://github.com/google/A2A
+ */
+interface A2ASkill {
+    id: string;
+    name: string;
+    description: string;
+    tags: string[];
+    examples: string[];
+}
+interface A2ACapabilities {
+    streaming: boolean;
+    pushNotifications: boolean;
+    stateTransitionHistory: boolean;
+}
+interface A2AProvider {
+    organization: string;
+    url?: string;
+}
+interface AgentCard {
+    name: string;
+    description: string;
+    url: string;
+    provider: A2AProvider;
+    version: string;
+    documentationUrl?: string;
+    capabilities: A2ACapabilities;
+    defaultInputModes: string[];
+    defaultOutputModes: string[];
+    skills: A2ASkill[];
+}
+interface A2ATextPart {
+    type: "text";
+    text: string;
+}
+interface A2AFilePart {
+    type: "file";
+    file: {
+        name: string;
+        mimeType: string;
+        bytes?: string;
+        uri?: string;
+    };
+}
+interface A2ADataPart {
+    type: "data";
+    data: Record<string, unknown>;
+}
+type A2APart = A2ATextPart | A2AFilePart | A2ADataPart;
+interface A2AMessage {
+    role: "user" | "agent";
+    parts: A2APart[];
+    metadata?: Record<string, unknown>;
+}
+type A2ATaskState = "working" | "input-required" | "completed" | "failed" | "canceled" | "rejected";
+interface A2ATaskStatus {
+    state: A2ATaskState;
+    message?: A2AMessage;
+    timestamp: string;
+}
+interface A2AArtifact {
+    name?: string;
+    description?: string;
+    parts: A2APart[];
+    metadata?: Record<string, unknown>;
+}
+interface A2ATask {
+    id: string;
+    sessionId?: string;
+    status: A2ATaskStatus;
+    artifacts: A2AArtifact[];
+    history?: A2AMessage[];
+    metadata?: Record<string, unknown>;
+}
+interface A2ATaskSendRequest {
+    id?: string;
+    sessionId?: string;
+    message: A2AMessage;
+    pushNotification?: A2APushNotification;
+    historyLength?: number;
+    metadata?: Record<string, unknown>;
+}
+interface A2APushNotification {
+    url: string;
+    token?: string;
+}
+interface A2ATaskUpdatePayload {
+    id: string;
+    sessionId?: string;
+    status: A2ATaskStatus;
+    final?: boolean;
+    metadata?: Record<string, unknown>;
+}
+interface A2ATaskArtifactUpdatePayload {
+    id: string;
+    sessionId?: string;
+    artifact: A2AArtifact;
+    final?: boolean;
+    metadata?: Record<string, unknown>;
+}
+type A2ASSEEvent = {
+    event: "task";
+    data: A2ATaskUpdatePayload;
+} | {
+    event: "status-update";
+    data: A2ATaskUpdatePayload;
+} | {
+    event: "artifact-update";
+    data: A2ATaskArtifactUpdatePayload;
+} | {
+    event: "error";
+    data: {
+        code: string;
+        message: string;
+    };
+};
+interface A2AConfig {
+    agentName: string;
+    agentDescription: string;
+    agentUrl: string;
+    organization: string;
+    version?: string;
+    capabilities?: Partial<A2ACapabilities>;
+    defaultInputModes?: string[];
+    defaultOutputModes?: string[];
+    skills?: A2ASkill[];
+    apiKeyMap: Map<string, A2AApiKeyEntry>;
+}
+interface A2AApiKeyEntry {
+    key: string;
+    tenantId?: string;
+    projectId?: string;
+    workspaceId?: string;
+}
+declare const A2A_DEFAULT_CAPABILITIES: A2ACapabilities;
+declare const A2A_DEFAULT_INPUT_MODES: string[];
+declare const A2A_DEFAULT_OUTPUT_MODES: string[];
+interface A2AAuthContext {
+    authenticated: boolean;
+    apiKey?: string;
+    tenantId?: string;
+    projectId?: string;
+    workspaceId?: string;
+    source?: "bearer" | "x-api-key";
+}
+
+/**
+ * A2AApiKeyStoreProtocol
+ *
+ * Persistence interface for A2A API keys with tenant/project/workspace scoping.
+ */
+
+interface A2AApiKeyRecord {
+    id: string;
+    key: string;
+    tenantId: string;
+    projectId?: string;
+    workspaceId?: string;
+    label?: string;
+    enabled: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+}
+interface CreateA2AApiKeyInput {
+    tenantId: string;
+    projectId?: string;
+    workspaceId?: string;
+    label?: string;
+}
+interface A2AApiKeyStore {
+    /** Look up a key record by its bearer token value (for auth). */
+    findByKey(key: string): Promise<A2AApiKeyRecord | null>;
+    /** List all keys, optionally filtered by tenant. */
+    list(params: {
+        tenantId?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<A2AApiKeyRecord[]>;
+    /** Create a new key. The store is responsible for generating the key value. */
+    create(input: CreateA2AApiKeyInput): Promise<A2AApiKeyRecord>;
+    /** Disable a key (soft delete — never hard-delete to preserve audit trail). */
+    disable(id: string): Promise<A2AApiKeyRecord>;
+    /** Enable a previously disabled key. */
+    enable(id: string): Promise<A2AApiKeyRecord>;
+    /** Rotate a key: generate new value, return new record. */
+    rotate(id: string): Promise<A2AApiKeyRecord>;
+    /** Delete a key permanently. */
+    delete(id: string): Promise<void>;
+    /** Bulk load all active keys into a lookup Map (used at startup). */
+    loadIntoMap(): Promise<Map<string, A2AApiKeyEntry>>;
+}
+
 /**
  * 通用类型定义
  *
@@ -3205,4 +3442,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 Attachment, type AvailableModule, type BaseLatticeProtocol, type BaseMessage, type Binding, type BindingRegistry, type BootstrapFilesConfig, type BrowserMiddlewareConfig, type Callback, type ChannelAdapter, type ChannelInstallation, type ChannelInstallationStore, type ChannelInstallationType, type ClawMiddlewareConfig, type CodeEvalMiddlewareConfig, type CreateAssistantRequest, type CreateBindingInput, type CreateChannelInstallationRequest, type CreateDatabaseConfigRequest, type CreateEvalCaseRequest, type CreateEvalProjectRequest, type CreateEvalRunRequest, type CreateEvalSuiteRequest, type CreateMcpServerConfigRequest, type CreateMetricsServerConfigRequest, type CreateProjectRequest, type CreateRunStepRequest, type CreateSkillRequest, type CreateTenantRequest, type CreateThreadRequest, type CreateUserRequest, type CreateUserTenantLinkRequest, type CreateWorkflowRunRequest, type CreateWorkspaceRequest, type DataSource, type DatabaseConfig, type DatabaseConfigEntry, type DatabaseConfigStore, type DatabaseType, type DeepAgentConfig, type DeveloperMessage, type DispatchResult, type EmbeddingsConfig, type EmbeddingsLatticeProtocol, type EvalCase, type EvalProject, type EvalProjectReport, type EvalRun, type EvalRunResult, type EvalStore, type EvalSuite, type ExecuteSqlQueryRequest, type ExecuteSqlQueryResponse, type FilterCondition, type GraphBuildOptions, type ID, type InboundMessage, type InterruptMessage, type LLMConfig, type LarkChannelInstallationConfig, 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 MessageChunkType, MessageChunkTypes, type MessageContext, type MessageMiddleware, type MetricColumn, type MetricDataPoint, type MetricMeta, type MetricQueryResult, type MetricsMiddlewareConfig, type MetricsServerConfig, type MetricsServerConfigEntry, type MetricsServerConfigStore, type MetricsServerType, type MiddlewareType, type ModelLatticeProtocol, type OutboundMessage, type PaginatedResult, type PaginationParams, type PinoFileOptions, type ProcessingAgentConfig, type Project, type ProjectStore, type QueryParams, type QueryResultFormat, type QueueClient, type QueueConfig, type QueueLatticeProtocol, type QueueResult, QueueType, type ReactAgentConfig, type ReplyTarget, type Result, type RunStep, type SandboxMiddlewareConfig, type ScheduleClient, type ScheduleConfig, type ScheduleCronOptions, ScheduleExecutionType, type ScheduleLatticeProtocol, type ScheduleOnceOptions, type ScheduleStorage, ScheduleType, type ScheduledTaskDefinition, ScheduledTaskStatus, type SchedulerMiddlewareConfig, type SemanticMetricsFilter, type SemanticMetricsQueryRequest, type SemanticMetricsQueryResponse, type SemanticMetricsServerConfig, type Skill, type SkillClient, type SkillClientType, type SkillConfig, type SkillLatticeProtocol, type SkillStore, type SkillStoreContext, type SqlMiddlewareConfig, type StepStatus, type StepType, 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 TopologyEdge, type UIComponent, UIComponentType, type UIConfig, type UILatticeProtocol, type UpdateChannelInstallationRequest, type UpdateDatabaseConfigRequest, type UpdateMcpServerConfigRequest, type UpdateMetricsServerConfigRequest, type UpdateProjectRequest, type UpdateRunStepRequest, type UpdateTenantRequest, type UpdateUserRequest, type UpdateUserTenantLinkRequest, type UpdateWorkflowRunRequest, type UpdateWorkspaceRequest, type User, type UserMessage, type UserStatus, type UserStore, type UserTenantLink, type UserTenantLinkStore, type UserTenantRole, type VectorStoreConfig, type VectorStoreLatticeProtocol, type WorkflowRun, type WorkflowRunStatus, type WorkflowTrackingStore, type Workspace, type WorkspaceStore, getSubAgentsFromConfig, getToolsFromConfig, hasTools, isDeepAgentConfig, isProcessingAgentConfig, isTeamAgentConfig };
+export { type A2AApiKeyEntry, type A2AApiKeyRecord, type A2AApiKeyStore, type A2AArtifact, type A2AAuthContext, type A2ACapabilities, type A2AConfig, type A2ADataPart, type A2AFilePart, type A2AMessage, type A2APart, type A2AProvider, type A2APushNotification, type A2ARemoteAgentConfig, type A2ASSEEvent, type A2ASkill, type A2ATask, type A2ATaskArtifactUpdatePayload, type A2ATaskSendRequest, type A2ATaskState, type A2ATaskStatus, type A2ATaskUpdatePayload, type A2ATextPart, A2A_DEFAULT_CAPABILITIES, A2A_DEFAULT_INPUT_MODES, A2A_DEFAULT_OUTPUT_MODES, type AgentCard, type AgentClient, type AgentConfig, type AgentConfigWithTools, type AgentLatticeProtocol, type AgentMiddlewareConfig, type AgentRunConfig, AgentType, type Assistant, type AssistantMessage, type AssistantStore, type Attachment, type AvailableModule, type BaseLatticeProtocol, type BaseMessage, type Binding, type BindingRegistry, type BootstrapFilesConfig, type BrowserMiddlewareConfig, type Callback, type ChannelAdapter, type ChannelInstallation, type ChannelInstallationStore, type ChannelInstallationType, type ClawMiddlewareConfig, type CodeEvalMiddlewareConfig, type CreateA2AApiKeyInput, type CreateAssistantRequest, type CreateBindingInput, type CreateChannelInstallationRequest, type CreateDatabaseConfigRequest, type CreateEvalCaseRequest, type CreateEvalProjectRequest, type CreateEvalRunRequest, type CreateEvalSuiteRequest, type CreateMcpServerConfigRequest, type CreateMetricsServerConfigRequest, type CreateProjectRequest, type CreateRunStepRequest, type CreateSkillRequest, type CreateTenantRequest, type CreateThreadRequest, type CreateUserRequest, type CreateUserTenantLinkRequest, type CreateWorkflowRunRequest, type CreateWorkspaceRequest, type DataSource, type DatabaseConfig, type DatabaseConfigEntry, type DatabaseConfigStore, type DatabaseType, type DeepAgentConfig, type DeveloperMessage, type DispatchResult, type EmbeddingsConfig, type EmbeddingsLatticeProtocol, type EvalCase, type EvalProject, type EvalProjectReport, type EvalRun, type EvalRunResult, type EvalStore, type EvalSuite, type ExecuteSqlQueryRequest, type ExecuteSqlQueryResponse, type FilterCondition, type GraphBuildOptions, type ID, type InboundMessage, type InterruptMessage, type LLMConfig, type LarkChannelInstallationConfig, 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 MessageChunkType, MessageChunkTypes, type MessageContext, type MessageMiddleware, type MetricColumn, type MetricDataPoint, type MetricMeta, type MetricQueryResult, type MetricsMiddlewareConfig, type MetricsServerConfig, type MetricsServerConfigEntry, type MetricsServerConfigStore, type MetricsServerType, type MiddlewareType, type ModelLatticeProtocol, type OutboundMessage, type PaginatedResult, type PaginationParams, type PinoFileOptions, type ProcessingAgentConfig, type Project, type ProjectStore, type QueryParams, type QueryResultFormat, type QueueClient, type QueueConfig, type QueueLatticeProtocol, type QueueResult, QueueType, type ReactAgentConfig, type ReplyTarget, type Result, type RunStep, type SandboxMiddlewareConfig, type ScheduleClient, type ScheduleConfig, type ScheduleCronOptions, ScheduleExecutionType, type ScheduleLatticeProtocol, type ScheduleOnceOptions, type ScheduleStorage, ScheduleType, type ScheduledTaskDefinition, ScheduledTaskStatus, type SchedulerMiddlewareConfig, type SemanticMetricsFilter, type SemanticMetricsQueryRequest, type SemanticMetricsQueryResponse, type SemanticMetricsServerConfig, type Skill, type SkillClient, type SkillClientType, type SkillConfig, type SkillLatticeProtocol, type SkillStore, type SkillStoreContext, type SqlMiddlewareConfig, type StepStatus, type StepType, 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 TopologyEdge, type UIComponent, UIComponentType, type UIConfig, type UILatticeProtocol, type UpdateChannelInstallationRequest, type UpdateDatabaseConfigRequest, type UpdateMcpServerConfigRequest, type UpdateMetricsServerConfigRequest, type UpdateProjectRequest, type UpdateRunStepRequest, type UpdateTenantRequest, type UpdateUserRequest, type UpdateUserTenantLinkRequest, type UpdateWorkflowRunRequest, type UpdateWorkspaceRequest, type User, type UserMessage, type UserStatus, type UserStore, type UserTenantLink, type UserTenantLinkStore, type UserTenantRole, type VectorStoreConfig, type VectorStoreLatticeProtocol, type WorkflowRun, type WorkflowRunStatus, type WorkflowTrackingStore, type Workspace, type WorkspaceStore, getSubAgentsFromConfig, getToolsFromConfig, hasTools, isA2ARemoteAgentConfig, isDeepAgentConfig, isProcessingAgentConfig, isTeamAgentConfig };

package/dist/index.d.ts

@@ -127,7 +127,9 @@ declare enum AgentType {
     REACT = "react",
     DEEP_AGENT = "deep_agent",
     TEAM = "team",
-    PROCESSING = "processing"
+    PROCESSING = "processing",
+    /** Remote A2A agent — delegates to an external A2A-compatible server */
+    A2A_REMOTE = "a2a_remote"
 }
 /**
  * Runtime configuration that will be injected into LangGraphRunnableConfig.configurable
@@ -291,15 +293,45 @@ interface TeamAgentConfig extends BaseAgentConfig {
  * Type guard to check if config is TeamAgentConfig
  */
 declare function isTeamAgentConfig(config: AgentConfig): config is TeamAgentConfig;
+/**
+ * A2A_REMOTE agent configuration — delegates to an external A2A server.
+ *
+ * This agent type wraps a remote A2A endpoint so orchestrators can treat
+ * external agents the same as local LangGraph agents.
+ */
+interface A2ARemoteAgentConfig extends BaseAgentConfig {
+    type: AgentType.A2A_REMOTE;
+    /**
+     * URL of the remote agent's agent card (e.g. http://host:3000/.well-known/agent-card.json).
+     * The builder fetches this card to discover the JSON-RPC endpoint.
+     */
+    agentCardUrl: string;
+    /**
+     * Optional API key sent as Bearer token or X-API-Key header.
+     */
+    apiKey?: string;
+    /**
+     * HTTP timeout in milliseconds (default: 300_000 = 5 min).
+     */
+    timeout?: number;
+    /**
+     * Optional tool keys (not used by the builder, but included for type compatibility).
+     */
+    tools?: string[];
+}
+/**
+ * Type guard to check if config is A2ARemoteAgentConfig
+ */
+declare function isA2ARemoteAgentConfig(config: AgentConfig): config is A2ARemoteAgentConfig;
 /**
  * Agent configuration union type
  * Different agent types have different configuration options
  */
-type AgentConfig = ReactAgentConfig | DeepAgentConfig | TeamAgentConfig | ProcessingAgentConfig;
+type AgentConfig = ReactAgentConfig | DeepAgentConfig | TeamAgentConfig | ProcessingAgentConfig | A2ARemoteAgentConfig;
 /**
  * Agent configuration with tools property
  */
-type AgentConfigWithTools = ReactAgentConfig | DeepAgentConfig | TeamAgentConfig | ProcessingAgentConfig;
+type AgentConfigWithTools = ReactAgentConfig | DeepAgentConfig | TeamAgentConfig | ProcessingAgentConfig | A2ARemoteAgentConfig;
 /**
  * Type guard to check if config has tools property
  */
@@ -1772,6 +1804,8 @@ interface Project {
     workspaceId: string;
     name: string;
     description?: string;
+    /** Application-specific configuration stored as JSON */
+    config?: Record<string, unknown>;
     createdAt: Date;
     updatedAt: Date;
 }
@@ -1781,13 +1815,21 @@ interface Project {
 interface CreateProjectRequest {
     name: string;
     description?: string;
+    /** Application-specific configuration stored as JSON (optional) */
+    config?: Record<string, unknown>;
 }
 /**
  * Update project request type
+ *
+ * @remarks
+ * - The `config` field uses **replace** semantics: if provided, it completely
+ *   overwrites the existing config. To preserve the current config, omit this field.
  */
 interface UpdateProjectRequest {
     name?: string;
     description?: string;
+    /** Application-specific configuration stored as JSON (replaces existing if provided) */
+    config?: Record<string, unknown>;
 }
 /**
  * ProjectStore interface
@@ -3142,6 +3184,201 @@ interface ChannelAdapter<TConfig = unknown> {
     sendReply(replyTarget: ReplyTarget, message: OutboundMessage, installation: ChannelInstallation): Promise<void>;
 }
 
+/**
+ * A2AProtocol - Google Agent-to-Agent Protocol type definitions
+ *
+ * Based on the A2A open protocol spec for AI agent interoperability.
+ * @see https://github.com/google/A2A
+ */
+interface A2ASkill {
+    id: string;
+    name: string;
+    description: string;
+    tags: string[];
+    examples: string[];
+}
+interface A2ACapabilities {
+    streaming: boolean;
+    pushNotifications: boolean;
+    stateTransitionHistory: boolean;
+}
+interface A2AProvider {
+    organization: string;
+    url?: string;
+}
+interface AgentCard {
+    name: string;
+    description: string;
+    url: string;
+    provider: A2AProvider;
+    version: string;
+    documentationUrl?: string;
+    capabilities: A2ACapabilities;
+    defaultInputModes: string[];
+    defaultOutputModes: string[];
+    skills: A2ASkill[];
+}
+interface A2ATextPart {
+    type: "text";
+    text: string;
+}
+interface A2AFilePart {
+    type: "file";
+    file: {
+        name: string;
+        mimeType: string;
+        bytes?: string;
+        uri?: string;
+    };
+}
+interface A2ADataPart {
+    type: "data";
+    data: Record<string, unknown>;
+}
+type A2APart = A2ATextPart | A2AFilePart | A2ADataPart;
+interface A2AMessage {
+    role: "user" | "agent";
+    parts: A2APart[];
+    metadata?: Record<string, unknown>;
+}
+type A2ATaskState = "working" | "input-required" | "completed" | "failed" | "canceled" | "rejected";
+interface A2ATaskStatus {
+    state: A2ATaskState;
+    message?: A2AMessage;
+    timestamp: string;
+}
+interface A2AArtifact {
+    name?: string;
+    description?: string;
+    parts: A2APart[];
+    metadata?: Record<string, unknown>;
+}
+interface A2ATask {
+    id: string;
+    sessionId?: string;
+    status: A2ATaskStatus;
+    artifacts: A2AArtifact[];
+    history?: A2AMessage[];
+    metadata?: Record<string, unknown>;
+}
+interface A2ATaskSendRequest {
+    id?: string;
+    sessionId?: string;
+    message: A2AMessage;
+    pushNotification?: A2APushNotification;
+    historyLength?: number;
+    metadata?: Record<string, unknown>;
+}
+interface A2APushNotification {
+    url: string;
+    token?: string;
+}
+interface A2ATaskUpdatePayload {
+    id: string;
+    sessionId?: string;
+    status: A2ATaskStatus;
+    final?: boolean;
+    metadata?: Record<string, unknown>;
+}
+interface A2ATaskArtifactUpdatePayload {
+    id: string;
+    sessionId?: string;
+    artifact: A2AArtifact;
+    final?: boolean;
+    metadata?: Record<string, unknown>;
+}
+type A2ASSEEvent = {
+    event: "task";
+    data: A2ATaskUpdatePayload;
+} | {
+    event: "status-update";
+    data: A2ATaskUpdatePayload;
+} | {
+    event: "artifact-update";
+    data: A2ATaskArtifactUpdatePayload;
+} | {
+    event: "error";
+    data: {
+        code: string;
+        message: string;
+    };
+};
+interface A2AConfig {
+    agentName: string;
+    agentDescription: string;
+    agentUrl: string;
+    organization: string;
+    version?: string;
+    capabilities?: Partial<A2ACapabilities>;
+    defaultInputModes?: string[];
+    defaultOutputModes?: string[];
+    skills?: A2ASkill[];
+    apiKeyMap: Map<string, A2AApiKeyEntry>;
+}
+interface A2AApiKeyEntry {
+    key: string;
+    tenantId?: string;
+    projectId?: string;
+    workspaceId?: string;
+}
+declare const A2A_DEFAULT_CAPABILITIES: A2ACapabilities;
+declare const A2A_DEFAULT_INPUT_MODES: string[];
+declare const A2A_DEFAULT_OUTPUT_MODES: string[];
+interface A2AAuthContext {
+    authenticated: boolean;
+    apiKey?: string;
+    tenantId?: string;
+    projectId?: string;
+    workspaceId?: string;
+    source?: "bearer" | "x-api-key";
+}
+
+/**
+ * A2AApiKeyStoreProtocol
+ *
+ * Persistence interface for A2A API keys with tenant/project/workspace scoping.
+ */
+
+interface A2AApiKeyRecord {
+    id: string;
+    key: string;
+    tenantId: string;
+    projectId?: string;
+    workspaceId?: string;
+    label?: string;
+    enabled: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+}
+interface CreateA2AApiKeyInput {
+    tenantId: string;
+    projectId?: string;
+    workspaceId?: string;
+    label?: string;
+}
+interface A2AApiKeyStore {
+    /** Look up a key record by its bearer token value (for auth). */
+    findByKey(key: string): Promise<A2AApiKeyRecord | null>;
+    /** List all keys, optionally filtered by tenant. */
+    list(params: {
+        tenantId?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<A2AApiKeyRecord[]>;
+    /** Create a new key. The store is responsible for generating the key value. */
+    create(input: CreateA2AApiKeyInput): Promise<A2AApiKeyRecord>;
+    /** Disable a key (soft delete — never hard-delete to preserve audit trail). */
+    disable(id: string): Promise<A2AApiKeyRecord>;
+    /** Enable a previously disabled key. */
+    enable(id: string): Promise<A2AApiKeyRecord>;
+    /** Rotate a key: generate new value, return new record. */
+    rotate(id: string): Promise<A2AApiKeyRecord>;
+    /** Delete a key permanently. */
+    delete(id: string): Promise<void>;
+    /** Bulk load all active keys into a lookup Map (used at startup). */
+    loadIntoMap(): Promise<Map<string, A2AApiKeyEntry>>;
+}
+
 /**
  * 通用类型定义
  *
@@ -3205,4 +3442,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 Attachment, type AvailableModule, type BaseLatticeProtocol, type BaseMessage, type Binding, type BindingRegistry, type BootstrapFilesConfig, type BrowserMiddlewareConfig, type Callback, type ChannelAdapter, type ChannelInstallation, type ChannelInstallationStore, type ChannelInstallationType, type ClawMiddlewareConfig, type CodeEvalMiddlewareConfig, type CreateAssistantRequest, type CreateBindingInput, type CreateChannelInstallationRequest, type CreateDatabaseConfigRequest, type CreateEvalCaseRequest, type CreateEvalProjectRequest, type CreateEvalRunRequest, type CreateEvalSuiteRequest, type CreateMcpServerConfigRequest, type CreateMetricsServerConfigRequest, type CreateProjectRequest, type CreateRunStepRequest, type CreateSkillRequest, type CreateTenantRequest, type CreateThreadRequest, type CreateUserRequest, type CreateUserTenantLinkRequest, type CreateWorkflowRunRequest, type CreateWorkspaceRequest, type DataSource, type DatabaseConfig, type DatabaseConfigEntry, type DatabaseConfigStore, type DatabaseType, type DeepAgentConfig, type DeveloperMessage, type DispatchResult, type EmbeddingsConfig, type EmbeddingsLatticeProtocol, type EvalCase, type EvalProject, type EvalProjectReport, type EvalRun, type EvalRunResult, type EvalStore, type EvalSuite, type ExecuteSqlQueryRequest, type ExecuteSqlQueryResponse, type FilterCondition, type GraphBuildOptions, type ID, type InboundMessage, type InterruptMessage, type LLMConfig, type LarkChannelInstallationConfig, 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 MessageChunkType, MessageChunkTypes, type MessageContext, type MessageMiddleware, type MetricColumn, type MetricDataPoint, type MetricMeta, type MetricQueryResult, type MetricsMiddlewareConfig, type MetricsServerConfig, type MetricsServerConfigEntry, type MetricsServerConfigStore, type MetricsServerType, type MiddlewareType, type ModelLatticeProtocol, type OutboundMessage, type PaginatedResult, type PaginationParams, type PinoFileOptions, type ProcessingAgentConfig, type Project, type ProjectStore, type QueryParams, type QueryResultFormat, type QueueClient, type QueueConfig, type QueueLatticeProtocol, type QueueResult, QueueType, type ReactAgentConfig, type ReplyTarget, type Result, type RunStep, type SandboxMiddlewareConfig, type ScheduleClient, type ScheduleConfig, type ScheduleCronOptions, ScheduleExecutionType, type ScheduleLatticeProtocol, type ScheduleOnceOptions, type ScheduleStorage, ScheduleType, type ScheduledTaskDefinition, ScheduledTaskStatus, type SchedulerMiddlewareConfig, type SemanticMetricsFilter, type SemanticMetricsQueryRequest, type SemanticMetricsQueryResponse, type SemanticMetricsServerConfig, type Skill, type SkillClient, type SkillClientType, type SkillConfig, type SkillLatticeProtocol, type SkillStore, type SkillStoreContext, type SqlMiddlewareConfig, type StepStatus, type StepType, 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 TopologyEdge, type UIComponent, UIComponentType, type UIConfig, type UILatticeProtocol, type UpdateChannelInstallationRequest, type UpdateDatabaseConfigRequest, type UpdateMcpServerConfigRequest, type UpdateMetricsServerConfigRequest, type UpdateProjectRequest, type UpdateRunStepRequest, type UpdateTenantRequest, type UpdateUserRequest, type UpdateUserTenantLinkRequest, type UpdateWorkflowRunRequest, type UpdateWorkspaceRequest, type User, type UserMessage, type UserStatus, type UserStore, type UserTenantLink, type UserTenantLinkStore, type UserTenantRole, type VectorStoreConfig, type VectorStoreLatticeProtocol, type WorkflowRun, type WorkflowRunStatus, type WorkflowTrackingStore, type Workspace, type WorkspaceStore, getSubAgentsFromConfig, getToolsFromConfig, hasTools, isDeepAgentConfig, isProcessingAgentConfig, isTeamAgentConfig };
+export { type A2AApiKeyEntry, type A2AApiKeyRecord, type A2AApiKeyStore, type A2AArtifact, type A2AAuthContext, type A2ACapabilities, type A2AConfig, type A2ADataPart, type A2AFilePart, type A2AMessage, type A2APart, type A2AProvider, type A2APushNotification, type A2ARemoteAgentConfig, type A2ASSEEvent, type A2ASkill, type A2ATask, type A2ATaskArtifactUpdatePayload, type A2ATaskSendRequest, type A2ATaskState, type A2ATaskStatus, type A2ATaskUpdatePayload, type A2ATextPart, A2A_DEFAULT_CAPABILITIES, A2A_DEFAULT_INPUT_MODES, A2A_DEFAULT_OUTPUT_MODES, type AgentCard, type AgentClient, type AgentConfig, type AgentConfigWithTools, type AgentLatticeProtocol, type AgentMiddlewareConfig, type AgentRunConfig, AgentType, type Assistant, type AssistantMessage, type AssistantStore, type Attachment, type AvailableModule, type BaseLatticeProtocol, type BaseMessage, type Binding, type BindingRegistry, type BootstrapFilesConfig, type BrowserMiddlewareConfig, type Callback, type ChannelAdapter, type ChannelInstallation, type ChannelInstallationStore, type ChannelInstallationType, type ClawMiddlewareConfig, type CodeEvalMiddlewareConfig, type CreateA2AApiKeyInput, type CreateAssistantRequest, type CreateBindingInput, type CreateChannelInstallationRequest, type CreateDatabaseConfigRequest, type CreateEvalCaseRequest, type CreateEvalProjectRequest, type CreateEvalRunRequest, type CreateEvalSuiteRequest, type CreateMcpServerConfigRequest, type CreateMetricsServerConfigRequest, type CreateProjectRequest, type CreateRunStepRequest, type CreateSkillRequest, type CreateTenantRequest, type CreateThreadRequest, type CreateUserRequest, type CreateUserTenantLinkRequest, type CreateWorkflowRunRequest, type CreateWorkspaceRequest, type DataSource, type DatabaseConfig, type DatabaseConfigEntry, type DatabaseConfigStore, type DatabaseType, type DeepAgentConfig, type DeveloperMessage, type DispatchResult, type EmbeddingsConfig, type EmbeddingsLatticeProtocol, type EvalCase, type EvalProject, type EvalProjectReport, type EvalRun, type EvalRunResult, type EvalStore, type EvalSuite, type ExecuteSqlQueryRequest, type ExecuteSqlQueryResponse, type FilterCondition, type GraphBuildOptions, type ID, type InboundMessage, type InterruptMessage, type LLMConfig, type LarkChannelInstallationConfig, 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 MessageChunkType, MessageChunkTypes, type MessageContext, type MessageMiddleware, type MetricColumn, type MetricDataPoint, type MetricMeta, type MetricQueryResult, type MetricsMiddlewareConfig, type MetricsServerConfig, type MetricsServerConfigEntry, type MetricsServerConfigStore, type MetricsServerType, type MiddlewareType, type ModelLatticeProtocol, type OutboundMessage, type PaginatedResult, type PaginationParams, type PinoFileOptions, type ProcessingAgentConfig, type Project, type ProjectStore, type QueryParams, type QueryResultFormat, type QueueClient, type QueueConfig, type QueueLatticeProtocol, type QueueResult, QueueType, type ReactAgentConfig, type ReplyTarget, type Result, type RunStep, type SandboxMiddlewareConfig, type ScheduleClient, type ScheduleConfig, type ScheduleCronOptions, ScheduleExecutionType, type ScheduleLatticeProtocol, type ScheduleOnceOptions, type ScheduleStorage, ScheduleType, type ScheduledTaskDefinition, ScheduledTaskStatus, type SchedulerMiddlewareConfig, type SemanticMetricsFilter, type SemanticMetricsQueryRequest, type SemanticMetricsQueryResponse, type SemanticMetricsServerConfig, type Skill, type SkillClient, type SkillClientType, type SkillConfig, type SkillLatticeProtocol, type SkillStore, type SkillStoreContext, type SqlMiddlewareConfig, type StepStatus, type StepType, 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 TopologyEdge, type UIComponent, UIComponentType, type UIConfig, type UILatticeProtocol, type UpdateChannelInstallationRequest, type UpdateDatabaseConfigRequest, type UpdateMcpServerConfigRequest, type UpdateMetricsServerConfigRequest, type UpdateProjectRequest, type UpdateRunStepRequest, type UpdateTenantRequest, type UpdateUserRequest, type UpdateUserTenantLinkRequest, type UpdateWorkflowRunRequest, type UpdateWorkspaceRequest, type User, type UserMessage, type UserStatus, type UserStore, type UserTenantLink, type UserTenantLinkStore, type UserTenantRole, type VectorStoreConfig, type VectorStoreLatticeProtocol, type WorkflowRun, type WorkflowRunStatus, type WorkflowTrackingStore, type Workspace, type WorkspaceStore, getSubAgentsFromConfig, getToolsFromConfig, hasTools, isA2ARemoteAgentConfig, isDeepAgentConfig, isProcessingAgentConfig, isTeamAgentConfig };