@axiom-lattice/protocols 4.3.2 → 4.4.0

package/dist/index.d.ts

@@ -1117,6 +1117,24 @@ interface UserMessage extends BaseMessage {
         id: string;
     }>;
 }
+/**
+ * UI-only rich payload for a tool call.
+ *
+ * Populated by the client-side message merger from the tool message's raw
+ * LangChain `artifact` and non-text content blocks. It is never part of the
+ * model-visible text: the model only sees `ToolCall.response`.
+ */
+interface ToolCallUi {
+    /** MCP `CallToolResult.structuredContent`, when the tool produced one. */
+    structuredContent?: unknown;
+    /** MCP `CallToolResult._meta`, when present. */
+    meta?: Record<string, unknown>;
+    /** Non-text content blocks (image / audio / resource / file). */
+    contentBlocks?: Array<{
+        type: string;
+        [key: string]: unknown;
+    }>;
+}
 /**
  * Tool call interface
  */
@@ -1126,6 +1144,12 @@ interface ToolCall {
     args: Record<string, any>;
     type: "tool_call";
     response?: string;
+    /** UI-only rich result (MCP Apps). Never part of the model-visible text. */
+    ui?: ToolCallUi;
+    /** Execution status reported by the client-side message merger. */
+    status?: "success" | "pending" | "error";
+    /** Correlation id of the originating tool message (internal). */
+    original_tool_message_id?: string;
 }
 /**
  * Assistant message interface
@@ -1208,6 +1232,12 @@ interface MessageChunk {
             }>;
         };
         tool_call_id?: string;
+        /**
+         * Raw LangChain tool message `artifact` (e.g. MCP `structuredContent`
+         * and non-text content blocks). Present on `tool` chunks; consumed by the
+         * client-side message merger to populate `ToolCall.ui`.
+         */
+        artifact?: unknown;
     };
 }
 /**
@@ -3558,14 +3588,65 @@ interface VectorStoreProvider {
     dropTable?(tableName: string): Promise<void>;
 }
 
+/** Display modes supported by MCP Apps. */
+type McpUiDisplayMode = "inline" | "fullscreen" | "pip";
+/** CSP origins declared by a UI resource. */
+interface McpUiCsp {
+    connectDomains?: string[];
+    resourceDomains?: string[];
+    frameDomains?: string[];
+    baseUriDomains?: string[];
+}
+/** Sandbox permissions requested by a UI resource. */
+interface McpUiPermissions {
+    camera?: boolean;
+    microphone?: boolean;
+    geolocation?: boolean;
+    clipboardWrite?: boolean;
+}
+/** A UI ref carried in the `mcp_app` content fence. */
+type McpUiRef = {
+    kind: "mcp";
+    serverKey: string;
+    resourceUri: string;
+    displayMode: McpUiDisplayMode;
+    title?: string;
+    /**
+     * Retained only for backward compatibility with pre-unification
+     * messages; no longer emitted. Rich tool results now travel via
+     * `ToolCall.ui`.
+     */
+    structuredContent?: unknown;
+} | {
+    kind: "plugin";
+    pluginType: string;
+    resource: string;
+    displayMode: McpUiDisplayMode;
+    title?: string;
+};
+/** Resolved UI resource body returned by the gateway. */
+interface McpUiResourcePayload {
+    mimeType: string;
+    html: string;
+    csp?: McpUiCsp;
+    permissions?: McpUiPermissions;
+    prefersBorder?: boolean;
+    stale?: boolean;
+}
+/** Type guard for a parsed `McpUiRef`. */
+declare function isMcpUiRef(value: unknown): value is McpUiRef;
+/** Parse and normalize an unknown value into a `McpUiRef`, or `null`. */
+declare function parseMcpUiRef(value: unknown): McpUiRef | null;
+
 /**
  * MenuProtocol
  *
  * Defines types and registry interface for per-tenant customizable menu items.
  * Menu items are merged with built-in defaults at the React SDK layer.
  */
+
 type MenuTarget = 'sidebar' | 'workspace';
-type MenuContentType = 'agent' | 'html' | 'custom';
+type MenuContentType = 'agent' | 'html' | 'custom' | 'file' | 'mcpApp';
 interface AgentMenuConfig {
     agentId: string;
     workspaceId?: string;
@@ -3579,7 +3660,43 @@ interface HtmlMenuConfig {
 interface CustomMenuConfig {
     componentKey: string;
 }
-type MenuContentConfig = AgentMenuConfig | HtmlMenuConfig | CustomMenuConfig;
+/**
+ * A pinned MCP App menu item.
+ *
+ * The identity (`kind` + server/plugin + resource) is enough to re-open the
+ * App; `toolInput` lets a self-refreshing App re-run the same query. The pin
+ * flow also captures the current `toolResult` and `ui` so the pinned view has
+ * the same initial data as the chat view did (an App that refreshes itself can
+ * still re-query).
+ */
+type McpAppMenuConfig = {
+    kind: 'mcp';
+    serverKey: string;
+    resourceUri: string;
+    displayMode?: McpUiDisplayMode;
+    title?: string;
+    toolInput?: Record<string, unknown>;
+    toolResult?: unknown;
+    ui?: ToolCallUi;
+} | {
+    kind: 'plugin';
+    pluginType: string;
+    resource: string;
+    displayMode?: McpUiDisplayMode;
+    title?: string;
+    toolInput?: Record<string, unknown>;
+    toolResult?: unknown;
+    ui?: ToolCallUi;
+};
+/** A pinned workspace file rendered by the file viewer. */
+interface FileMenuConfig {
+    resourcePath: string;
+    fileName?: string;
+    workspaceId?: string;
+    projectId?: string;
+    assistantId?: string;
+}
+type MenuContentConfig = AgentMenuConfig | HtmlMenuConfig | CustomMenuConfig | FileMenuConfig | McpAppMenuConfig;
 interface MenuItem {
     id: string;
     tenantId: string;
@@ -4109,6 +4226,19 @@ interface UpdateTaskRequest {
     /** File references attached to this task */
     files?: TaskFileRef[];
 }
+/**
+ * Normalizes a task metadata scalar to its JSON text form so every task store
+ * backend compares metadata filters identically.
+ *
+ * The contract is JSON scalar value equality, type-tolerant: `1` and `"1"`
+ * are equal, `true` and `"true"` are equal, and `true` never equals `1`.
+ * PostgreSQL's `metadata->>` naturally yields this form; InMemory and SQLite
+ * use this helper to match it.
+ *
+ * @param value Candidate filter or stored metadata value.
+ * @returns JSON text form for string/number/boolean, otherwise `undefined`.
+ */
+declare function normalizeTaskMetadataScalar(value: unknown): string | undefined;
 /**
  * Task list filter criteria
  */
@@ -4654,7 +4784,7 @@ interface OpenExecutionContext {
     projectId: string;
     /** Addressing only, not an authorization dimension (see design §6.2). */
     workspaceId?: string;
-    /** Synthesized runConfig (mirrors the Agent path, incl. _resolvedConnections). */
+    /** Synthesized run identity (mirrors the Agent path's runConfig; plugin tools resolve their own connections). */
     runConfig: Record<string, unknown>;
 }
 interface OpenExecutionResult {
@@ -5170,9 +5300,9 @@ interface InternalCreateCapabilityBundleInput extends Omit<CreateCapabilityBundl
 interface UpdateCapabilityBundleInput extends Partial<CreateCapabilityBundleInput> {
     expectedUpdatedAt: string;
 }
-/** Store input retained for internal maintenance callers that may omit CAS. */
+/** Store input for updating a bundle; the stable key is immutable and the revision is always required for CAS. */
 interface InternalUpdateCapabilityBundleInput extends Partial<CreateCapabilityBundleInput> {
-    expectedUpdatedAt?: string;
+    expectedUpdatedAt: string;
 }
 /** Result returned when an update's expected revision no longer matches. */
 interface CapabilityBundleUpdateConflict {
@@ -5190,8 +5320,7 @@ interface CapabilityBundleStore {
     getManyByIds(tenantId: string, ids: string[]): Promise<CapabilityBundle[]>;
     /** Creates a bundle for a tenant. */
     create(tenantId: string, input: InternalCreateCapabilityBundleInput): Promise<CapabilityBundle>;
-    /** Updates a bundle, or returns null when it does not exist. */
-    /** Omitted expectedUpdatedAt is reserved for internal maintenance callers. */
+    /** Updates a bundle with mandatory revision CAS, or returns null when it does not exist. */
     update(tenantId: string, id: string, input: InternalUpdateCapabilityBundleInput): Promise<CapabilityBundle | CapabilityBundleUpdateConflict | null>;
     /** Atomically deletes a bundle unless a tenant project references it. */
     deleteIfUnreferenced(tenantId: string, id: string): Promise<CapabilityBundleDeleteResult>;
@@ -6126,6 +6255,35 @@ interface PluginConnection {
     /** 资源发现面板标题 */
     resourceLabel?: string;
 }
+/**
+ * UI declaration for a plugin tool: an HTML file rendered as an MCP App when
+ * the tool runs.
+ *
+ * @property resource - Safe relative path (within the plugin directory) to an `.html` file.
+ * @property displayMode - Preferred display mode; defaults to `inline` (resolved by the compiler).
+ * @property csp - Origins the UI needs (see `McpUiCsp`).
+ * @property permissions - Sandbox permissions requested (see `McpUiPermissions`).
+ * @property prefersBorder - Visual boundary preference.
+ */
+interface PluginToolUi {
+    resource: string;
+    displayMode?: McpUiDisplayMode;
+    csp?: McpUiCsp;
+    permissions?: McpUiPermissions;
+    prefersBorder?: boolean;
+}
+/**
+ * Inline UI resource served by a GLOBAL (non-sandbox) plugin.
+ *
+ * @property html - Full HTML document served for a `ui://` resource.
+ * @property mimeType - Defaults to `text/html;profile=mcp-app` when omitted.
+ * @property csp - Origins the UI needs.
+ */
+interface PluginUiResource {
+    html: string;
+    mimeType?: string;
+    csp?: McpUiCsp;
+}
 /**
  * 工具元信息（用于前端 allowedTools 筛选）
  *
@@ -6138,6 +6296,8 @@ interface PluginToolMeta {
     description: string;
     /** When true, this tool surfaces on the Open API (MCP) surface. */
     expose?: boolean;
+    /** Optional UI (HTML) declaration for this tool. */
+    ui?: PluginToolUi;
 }
 /** Open-surface exposure entry with MCP annotation hints. */
 interface PluginOpenExposeTool {
@@ -6204,6 +6364,8 @@ interface PluginMeta {
     icon?: string;
     /** 工具清单（可选，middleware 能自动提取时不需要写） */
     tools?: PluginToolMeta[];
+    /** Inline `ui://` resources for this plugin's tool UIs (global plugins only). */
+    uiResources?: Record<string, PluginUiResource>;
     /**
      * Open 面（MCP）暴露的工具名清单——独立于 tools 声明，一行即生长。
      * 声明后 OpenCredentialService 的 grants 匹配 domain=<meta.type>。
@@ -6352,6 +6514,8 @@ interface SandboxPluginToolDef {
     destructive?: boolean;
     timeoutMs?: number;
     maxResultBytes?: number;
+    /** Optional UI (HTML) rendered as an MCP App when this tool runs. */
+    ui?: PluginToolUi;
 }
 /**
  * Connection capability contributed by a sandbox plugin. `test`/`discover`
@@ -6473,6 +6637,12 @@ interface ProjectRoomTrustedRunContext {
     role: "coordinator" | "specialist";
     title: string;
     responsibility?: string;
+    /**
+     * Host-provided provenance string, persisted unchanged. Optional; a non-empty string when present;
+     * `undefined` is treated as absent. Core copies and compares this value without interpreting or
+     * naming any specific value (ADR-118).
+     */
+    source?: string;
 }
 /** Trusted Project Task identity persisted with a privileged queue message. */
 interface ProjectTaskTrustedRunContext {
@@ -6485,6 +6655,12 @@ interface ProjectTaskTrustedRunContext {
     taskId: string;
     threadId: string;
     inputMessageId: string;
+    /**
+     * Host-provided provenance string, persisted unchanged. Optional; a non-empty string when present;
+     * `undefined` is treated as absent. Core copies and compares this value without interpreting or
+     * naming any specific value (ADR-118).
+     */
+    source?: string;
 }
 /** Host-authenticated metadata that cannot be supplied through public Agent APIs. */
 interface TrustedRunContext {
@@ -6508,4 +6684,4 @@ declare function parseTrustedRunContext(value: unknown): TrustedRunContext;
  */
 declare function parseQueuedExecutionMode(value: unknown): QueuedExecutionMode;
 
-export { type A2AApiKeyEntry, type A2AApiKeyRecord, type A2AApiKeyStore, type A2AAuthContext, type A2ARemoteAgentConfig, type AgentClient, type AgentConfig, type AgentConfigWithTools, type AgentLatticeProtocol, type AgentMenuConfig, type AgentMiddlewareConfig, type AgentRunConfig, AgentType, type AgentWebApp, type AgentWebAppAppearance, type AgentWebAppBootstrap, type AgentWebAppCalloutWidget, type AgentWebAppError, type AgentWebAppErrorCode, type AgentWebAppFeatures, type AgentWebAppGenUIBlock, type AgentWebAppIdentityAssurance, type AgentWebAppIdentityConfig, type AgentWebAppIdentityPolicy, type AgentWebAppInterrupt, type AgentWebAppIssuerConfig, type AgentWebAppQuickPrompt, type AgentWebAppRuntimeMessage, type AgentWebAppRuntimeThread, type AgentWebAppScope, type AgentWebAppStatus, type AgentWebAppStore, type AgentWebAppStorePatch, type AgentWebAppStreamEvent, type AgentWebAppStreamProjectionContext, type AgentWebAppTableWidget, type AgentWebAppThreadMetadata, type AgentWebAppUpdateOptions, type Assistant, type AssistantMessage, type AssistantStore, type Attachment, type AvailableModule, type BaseLatticeProtocol, type BaseMessage, type Binding, type BindingListParams, type BindingMutablePatch, type BindingRegistry, type BootstrapFilesConfig, type BrowserMiddlewareConfig, type Callback, type CapabilityBundle, type CapabilityBundleDeleteResult, type CapabilityBundleStore, type CapabilityBundleUpdateConflict, type CapabilityFieldSource, type CapabilityOverride, type CapabilityPreview, type CapabilityPreviewIssue, type CapabilityRuntime, type ChannelAdapter, type ChannelBindingMigrationConflict, ChannelBindingMigrationConflictError, type ChannelInstallation, type ChannelInstallationStore, type ChannelInstallationType, type ClawMiddlewareConfig, type CodeEvalMiddlewareConfig, type Collection, type CollectionField, type CollectionFieldType, type CollectionMiddlewareConfig, type CollectionSchema, type CollectionStore, type ConnectionEntry, type ConnectionStore, type ConversationRecord, type CreateA2AApiKeyInput, type CreateAgentWebAppInput, type CreateAssistantRequest, type CreateBindingInput, type CreateCapabilityBundleInput, type CreateChannelInstallationInput, type CreateChannelInstallationRequest, type CreateCollectionRequest, type CreateConversationInput, type CreateDatabaseConfigRequest, type CreateEvalCaseRequest, type CreateEvalProjectRequest, type CreateEvalRunRequest, type CreateEvalSuiteRequest, type CreateMcpServerConfigRequest, type CreateMenuItemInput, type CreateMetricsServerConfigRequest, type CreateProjectRequest, type CreateRunStepRequest, type CreateShareRequest, type CreateSkillRequest, type CreateTaskRequest, type CreateTenantRequest, type CreateThreadRequest, type CreateUserRequest, type CreateUserTenantLinkRequest, type CreateWorkItemIfAbsentRequest, type CreateWorkItemRequest, type CreateWorkflowRunRequest, type CreateWorkspaceRequest, type CustomMenuConfig, type DataSource, type DatabaseConfig, type DatabaseConfigEntry, type DatabaseConfigStore, type DatabaseType, type DeepAgentConfig, type DescriptorDataValue, type DeveloperMessage, type DispatchResult, DuplicateChannelBindingSubjectError, EXECUTION_RESULT_EVENT_KEY_PATTERN, EXECUTION_RESULT_EVENT_KEY_PATTERN_SOURCE, EXECUTION_RESULT_EVENT_KEY_PREFIX, type EmbeddingsConfig, type EmbeddingsLatticeProtocol, type EvalCase, type EvalProject, type EvalProjectReport, type EvalRun, type EvalRunResult, type EvalStore, type EvalSuite, type ExecuteSqlQueryRequest, type ExecuteSqlQueryResponse, type ExpectedCapabilityBundleRevisions, type FilterCondition, type GraphBuildOptions, type HtmlMenuConfig, type IConversationStore, type ID, type InboundMessage, type InternalAgentNode, type InternalBaseNode, type InternalCreateCapabilityBundleInput, type InternalDSL, type InternalEdge, type InternalInput, type InternalInputNode, type InternalMapNode, type InternalNode, type InternalNodeConfig, type InternalOutput, type InternalState, type InternalStateField, type InternalTerminalNode, type InternalUpdateCapabilityBundleInput, type InterruptMessage, type InterruptPolicy, InvalidProjectCapabilityBundleConfigError, type LLMConfig, type LarkChannelInstallationConfig, type LatticeError, type LatticeEventBus, type LatticeMessage, type LocalA2AProviderId, type LocalA2AProviderState, type LocalA2AProviderStatus, type LocalA2ATemplateDefinition, type LocalRuntimeConfig, type LoggerClient, type LoggerConfig, type LoggerContext, type LoggerLatticeProtocol, LoggerType, MAX_PENDING_EXECUTION_RESULTS_LIMIT, 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 MenuContentConfig, type MenuContentType, type MenuItem, type MenuRegistry, type MenuTarget, 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 OpenAuditAppendInput, type OpenAuditQuery, type OpenAuditRecord, type OpenAuditStore, type OpenCapabilitySource, type OpenCatalog, type OpenCatalogDomain, type OpenCatalogItem, type OpenCredentialKind, type OpenExecutionContext, type OpenExecutionResult, type OpenGrant, type OutboundMessage, PROJECT_ROOM_TASK_DELEGATED_LABEL, PROJECT_ROOM_TASK_DELEGATED_SEPARATOR, PROJECT_ROOM_USER_CHANNEL_PROJECT, PROJECT_TASK_LIFECYCLE_ACTIONS, type PaginatedResult, type PaginationParams, type PinoFileOptions, type Plugin, type PluginConnection, type PluginConnectionFieldSchema, type PluginConnectionTestResult, type PluginContext, type PluginDiscoveredResource, type PluginMeta, type PluginMetaOutput, type PluginMiddlewareFactory, type PluginSkillDefinition, type PluginSkillResource, type PluginStandardConnectionConfig, type PluginToolMeta, type ProcessingAgentConfig, type Project, type ProjectBotMembership, type ProjectBotMembershipStatus, type ProjectBotMembershipStore, type ProjectBotRole, type ProjectCapabilityConfig, type ProjectFilter, type ProjectHumanRole, type ProjectKind, type ProjectLifecycleEventCursor, type ProjectLifecycleEventQuery, type ProjectMembership, type ProjectMembershipMutationResult, type ProjectMembershipStatus, type ProjectMembershipStore, type ProjectRoom, ProjectRoomBrokerCapacityError, type ProjectRoomBusinessEvent, type ProjectRoomBusinessEventDraft, type ProjectRoomControlEvent, ProjectRoomCursorError, type ProjectRoomEventBrokerProtocol, type ProjectRoomEventId, type ProjectRoomEventOf, type ProjectRoomEventScope, type ProjectRoomEventSubscription, type ProjectRoomMembershipAffectedEvent, type ProjectRoomMembershipChangedEvent, type ProjectRoomMention, type ProjectRoomMessage, type ProjectRoomMessageAuthor, type ProjectRoomMessageCreatedEvent, type ProjectRoomMessageCursor, type ProjectRoomMessageSource, type ProjectRoomMessageStore, type ProjectRoomPublicBotMembership, type ProjectRoomPublicMembership, type ProjectRoomPublicMessage, type ProjectRoomReadChangedEvent, type ProjectRoomReadState, type ProjectRoomReadStateStore, type ProjectRoomRealtimeActor, type ProjectRoomRosterChangedEvent, type ProjectRoomScopedBusinessEvent, type ProjectRoomSseWritable, type ProjectRoomStore, type ProjectRoomTaskChangedEvent, type ProjectRoomThreadMetadata, type ProjectRoomTrustedRunContext, type ProjectStore, type ProjectTaskLifecycleAction, ProjectTaskStoreUnsupportedError, type ProjectTaskThreadMetadata, type ProjectTaskTrustedRunContext, type ProjectTaskWorkItemStore, type PublicChannelInstallationType, type QueryParams, type QueryResultFormat, type QueryWorkflowRunsOptions, type QueryWorkflowRunsResult, type QueueClient, type QueueConfig, type QueueLatticeProtocol, type QueueResult, QueueType, type QueuedExecutionMode, type ReactAgentConfig, type ReplyTarget, type ResourceAddress, type ResourceResolver, type Result, type RunStep, type STTClient, type STTConfig, type STTModelLatticeProtocol, type SandboxMiddlewareConfig, type SandboxPluginConnectionDef, type SandboxPluginDiagnostic, type SandboxPluginManifest, type SandboxPluginToolDef, 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 ShareRecord, type ShareResult, type ShareVisibility, type SharedResourceStore, 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 TaskBeliefDiagnosticCode, type TaskBeliefEntry, type TaskBeliefParseFailure, type TaskBeliefParseResult, type TaskBeliefParseSuccess, type TaskBeliefState, type TaskDependentListQuery, type TaskFileRef, type TaskHandler, type TaskItem, type TaskListFilter, type TaskMutationSnapshot, type TaskStore, type TaskWorkItem, type TaskWorkItemListFilter, type TaskWorkItemStore, 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 TranscriptionResult, type TrustedRunContext, type UIComponent, UIComponentType, type UIConfig, type UILatticeProtocol, type UpdateA2AApiKeyInput, type UpdateAgentWebAppInput, type UpdateCapabilityBundleInput, type UpdateChannelInstallationRequest, type UpdateCollectionRequest, type UpdateDatabaseConfigRequest, type UpdateMcpServerConfigRequest, type UpdateMenuItemInput, type UpdateMetricsServerConfigRequest, type UpdateProjectCapabilityBundlesResult, type UpdateProjectRequest, type UpdateRunStepRequest, type UpdateTaskRequest, type UpdateTenantRequest, type UpdateUserRequest, type UpdateUserTenantLinkRequest, type UpdateWorkflowRunRequest, type UpdateWorkspaceRequest, type User, type UserMessage, type UserPushSubscription, type UserPushSubscriptionStore, type UserStatus, type UserStore, type UserTenantLink, type UserTenantLinkStore, type UserTenantRole, type VectorStoreConfig, type VectorStoreCreateParams, type VectorStoreLatticeProtocol, type VectorStoreProvider, WORKSPACE_PUBLIC_ROOM_PROJECT_PREFIX, type WechatChannelInstallationConfig, type WorkflowAgentConfig, type WorkflowRun, type WorkflowRunStatus, type WorkflowTrackingStore, type Workspace, type WorkspaceStore, type YamlAgentStep, type YamlMapStep, type YamlParallelBlock, type YamlTopLevelStep, type YamlWorkflow, assertGenericProjectConfig, createAgentWebAppStreamProjectionContext, descriptorDataValue, effectiveGrants, getSubAgentsFromConfig, getToolsFromConfig, hasTools, isA2ARemoteAgentConfig, isDeepAgentConfig, isExecutionResultEventKey, isProcessingAgentConfig, isProjectRoomEventId, isTeamAgentConfig, isWorkflowAgentConfig, isWorkspacePublicRoomProjectId, parseAgentWebAppGenUIBlock, parseProjectRoomEventId, parseQueuedExecutionMode, parseTaskBeliefState, parseTrustedRunContext, projectAgentWebAppChunk, projectRoomUserEventScope, replaceTaskBeliefState, requireProjectTaskWorkItemStore, snapshotExactArray, snapshotExactRecord, snapshotProjectRoomBotMembershipRealtime, snapshotProjectRoomMembershipRealtime, snapshotProjectRoomMessageRealtime, taskBeliefStatesEqual, toProjectRoomPublicBotMembership, toProjectRoomPublicMembership, toProjectRoomPublicMessage };
+export { type A2AApiKeyEntry, type A2AApiKeyRecord, type A2AApiKeyStore, type A2AAuthContext, type A2ARemoteAgentConfig, type AgentClient, type AgentConfig, type AgentConfigWithTools, type AgentLatticeProtocol, type AgentMenuConfig, type AgentMiddlewareConfig, type AgentRunConfig, AgentType, type AgentWebApp, type AgentWebAppAppearance, type AgentWebAppBootstrap, type AgentWebAppCalloutWidget, type AgentWebAppError, type AgentWebAppErrorCode, type AgentWebAppFeatures, type AgentWebAppGenUIBlock, type AgentWebAppIdentityAssurance, type AgentWebAppIdentityConfig, type AgentWebAppIdentityPolicy, type AgentWebAppInterrupt, type AgentWebAppIssuerConfig, type AgentWebAppQuickPrompt, type AgentWebAppRuntimeMessage, type AgentWebAppRuntimeThread, type AgentWebAppScope, type AgentWebAppStatus, type AgentWebAppStore, type AgentWebAppStorePatch, type AgentWebAppStreamEvent, type AgentWebAppStreamProjectionContext, type AgentWebAppTableWidget, type AgentWebAppThreadMetadata, type AgentWebAppUpdateOptions, type Assistant, type AssistantMessage, type AssistantStore, type Attachment, type AvailableModule, type BaseLatticeProtocol, type BaseMessage, type Binding, type BindingListParams, type BindingMutablePatch, type BindingRegistry, type BootstrapFilesConfig, type BrowserMiddlewareConfig, type Callback, type CapabilityBundle, type CapabilityBundleDeleteResult, type CapabilityBundleStore, type CapabilityBundleUpdateConflict, type CapabilityFieldSource, type CapabilityOverride, type CapabilityPreview, type CapabilityPreviewIssue, type CapabilityRuntime, type ChannelAdapter, type ChannelBindingMigrationConflict, ChannelBindingMigrationConflictError, type ChannelInstallation, type ChannelInstallationStore, type ChannelInstallationType, type ClawMiddlewareConfig, type CodeEvalMiddlewareConfig, type Collection, type CollectionField, type CollectionFieldType, type CollectionMiddlewareConfig, type CollectionSchema, type CollectionStore, type ConnectionEntry, type ConnectionStore, type ConversationRecord, type CreateA2AApiKeyInput, type CreateAgentWebAppInput, type CreateAssistantRequest, type CreateBindingInput, type CreateCapabilityBundleInput, type CreateChannelInstallationInput, type CreateChannelInstallationRequest, type CreateCollectionRequest, type CreateConversationInput, type CreateDatabaseConfigRequest, type CreateEvalCaseRequest, type CreateEvalProjectRequest, type CreateEvalRunRequest, type CreateEvalSuiteRequest, type CreateMcpServerConfigRequest, type CreateMenuItemInput, type CreateMetricsServerConfigRequest, type CreateProjectRequest, type CreateRunStepRequest, type CreateShareRequest, type CreateSkillRequest, type CreateTaskRequest, type CreateTenantRequest, type CreateThreadRequest, type CreateUserRequest, type CreateUserTenantLinkRequest, type CreateWorkItemIfAbsentRequest, type CreateWorkItemRequest, type CreateWorkflowRunRequest, type CreateWorkspaceRequest, type CustomMenuConfig, type DataSource, type DatabaseConfig, type DatabaseConfigEntry, type DatabaseConfigStore, type DatabaseType, type DeepAgentConfig, type DescriptorDataValue, type DeveloperMessage, type DispatchResult, DuplicateChannelBindingSubjectError, EXECUTION_RESULT_EVENT_KEY_PATTERN, EXECUTION_RESULT_EVENT_KEY_PATTERN_SOURCE, EXECUTION_RESULT_EVENT_KEY_PREFIX, type EmbeddingsConfig, type EmbeddingsLatticeProtocol, type EvalCase, type EvalProject, type EvalProjectReport, type EvalRun, type EvalRunResult, type EvalStore, type EvalSuite, type ExecuteSqlQueryRequest, type ExecuteSqlQueryResponse, type ExpectedCapabilityBundleRevisions, type FileMenuConfig, type FilterCondition, type GraphBuildOptions, type HtmlMenuConfig, type IConversationStore, type ID, type InboundMessage, type InternalAgentNode, type InternalBaseNode, type InternalCreateCapabilityBundleInput, type InternalDSL, type InternalEdge, type InternalInput, type InternalInputNode, type InternalMapNode, type InternalNode, type InternalNodeConfig, type InternalOutput, type InternalState, type InternalStateField, type InternalTerminalNode, type InternalUpdateCapabilityBundleInput, type InterruptMessage, type InterruptPolicy, InvalidProjectCapabilityBundleConfigError, type LLMConfig, type LarkChannelInstallationConfig, type LatticeError, type LatticeEventBus, type LatticeMessage, type LocalA2AProviderId, type LocalA2AProviderState, type LocalA2AProviderStatus, type LocalA2ATemplateDefinition, type LocalRuntimeConfig, type LoggerClient, type LoggerConfig, type LoggerContext, type LoggerLatticeProtocol, LoggerType, MAX_PENDING_EXECUTION_RESULTS_LIMIT, type McpAppMenuConfig, 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 McpUiCsp, type McpUiDisplayMode, type McpUiPermissions, type McpUiRef, type McpUiResourcePayload, type MemoryClient, type MemoryConfig, type MemoryLatticeProtocol, MemoryType, type MenuContentConfig, type MenuContentType, type MenuItem, type MenuRegistry, type MenuTarget, 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 OpenAuditAppendInput, type OpenAuditQuery, type OpenAuditRecord, type OpenAuditStore, type OpenCapabilitySource, type OpenCatalog, type OpenCatalogDomain, type OpenCatalogItem, type OpenCredentialKind, type OpenExecutionContext, type OpenExecutionResult, type OpenGrant, type OutboundMessage, PROJECT_ROOM_TASK_DELEGATED_LABEL, PROJECT_ROOM_TASK_DELEGATED_SEPARATOR, PROJECT_ROOM_USER_CHANNEL_PROJECT, PROJECT_TASK_LIFECYCLE_ACTIONS, type PaginatedResult, type PaginationParams, type PinoFileOptions, type Plugin, type PluginConnection, type PluginConnectionFieldSchema, type PluginConnectionTestResult, type PluginContext, type PluginDiscoveredResource, type PluginMeta, type PluginMetaOutput, type PluginMiddlewareFactory, type PluginSkillDefinition, type PluginSkillResource, type PluginStandardConnectionConfig, type PluginToolMeta, type PluginToolUi, type PluginUiResource, type ProcessingAgentConfig, type Project, type ProjectBotMembership, type ProjectBotMembershipStatus, type ProjectBotMembershipStore, type ProjectBotRole, type ProjectCapabilityConfig, type ProjectFilter, type ProjectHumanRole, type ProjectKind, type ProjectLifecycleEventCursor, type ProjectLifecycleEventQuery, type ProjectMembership, type ProjectMembershipMutationResult, type ProjectMembershipStatus, type ProjectMembershipStore, type ProjectRoom, ProjectRoomBrokerCapacityError, type ProjectRoomBusinessEvent, type ProjectRoomBusinessEventDraft, type ProjectRoomControlEvent, ProjectRoomCursorError, type ProjectRoomEventBrokerProtocol, type ProjectRoomEventId, type ProjectRoomEventOf, type ProjectRoomEventScope, type ProjectRoomEventSubscription, type ProjectRoomMembershipAffectedEvent, type ProjectRoomMembershipChangedEvent, type ProjectRoomMention, type ProjectRoomMessage, type ProjectRoomMessageAuthor, type ProjectRoomMessageCreatedEvent, type ProjectRoomMessageCursor, type ProjectRoomMessageSource, type ProjectRoomMessageStore, type ProjectRoomPublicBotMembership, type ProjectRoomPublicMembership, type ProjectRoomPublicMessage, type ProjectRoomReadChangedEvent, type ProjectRoomReadState, type ProjectRoomReadStateStore, type ProjectRoomRealtimeActor, type ProjectRoomRosterChangedEvent, type ProjectRoomScopedBusinessEvent, type ProjectRoomSseWritable, type ProjectRoomStore, type ProjectRoomTaskChangedEvent, type ProjectRoomThreadMetadata, type ProjectRoomTrustedRunContext, type ProjectStore, type ProjectTaskLifecycleAction, ProjectTaskStoreUnsupportedError, type ProjectTaskThreadMetadata, type ProjectTaskTrustedRunContext, type ProjectTaskWorkItemStore, type PublicChannelInstallationType, type QueryParams, type QueryResultFormat, type QueryWorkflowRunsOptions, type QueryWorkflowRunsResult, type QueueClient, type QueueConfig, type QueueLatticeProtocol, type QueueResult, QueueType, type QueuedExecutionMode, type ReactAgentConfig, type ReplyTarget, type ResourceAddress, type ResourceResolver, type Result, type RunStep, type STTClient, type STTConfig, type STTModelLatticeProtocol, type SandboxMiddlewareConfig, type SandboxPluginConnectionDef, type SandboxPluginDiagnostic, type SandboxPluginManifest, type SandboxPluginToolDef, 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 ShareRecord, type ShareResult, type ShareVisibility, type SharedResourceStore, 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 TaskBeliefDiagnosticCode, type TaskBeliefEntry, type TaskBeliefParseFailure, type TaskBeliefParseResult, type TaskBeliefParseSuccess, type TaskBeliefState, type TaskDependentListQuery, type TaskFileRef, type TaskHandler, type TaskItem, type TaskListFilter, type TaskMutationSnapshot, type TaskStore, type TaskWorkItem, type TaskWorkItemListFilter, type TaskWorkItemStore, type TeamAgentConfig, type TeamTeammateConfig, type Tenant, type TenantStatus, type TenantStore, type TestMcpServerToolsResponse, type Thread, type ThreadStore, type Timestamp, type ToolCall, type ToolCallUi, type ToolConfig, type ToolExecutor, type ToolLatticeProtocol, type ToolMessage, type TopologyEdge, type TranscriptionResult, type TrustedRunContext, type UIComponent, UIComponentType, type UIConfig, type UILatticeProtocol, type UpdateA2AApiKeyInput, type UpdateAgentWebAppInput, type UpdateCapabilityBundleInput, type UpdateChannelInstallationRequest, type UpdateCollectionRequest, type UpdateDatabaseConfigRequest, type UpdateMcpServerConfigRequest, type UpdateMenuItemInput, type UpdateMetricsServerConfigRequest, type UpdateProjectCapabilityBundlesResult, type UpdateProjectRequest, type UpdateRunStepRequest, type UpdateTaskRequest, type UpdateTenantRequest, type UpdateUserRequest, type UpdateUserTenantLinkRequest, type UpdateWorkflowRunRequest, type UpdateWorkspaceRequest, type User, type UserMessage, type UserPushSubscription, type UserPushSubscriptionStore, type UserStatus, type UserStore, type UserTenantLink, type UserTenantLinkStore, type UserTenantRole, type VectorStoreConfig, type VectorStoreCreateParams, type VectorStoreLatticeProtocol, type VectorStoreProvider, WORKSPACE_PUBLIC_ROOM_PROJECT_PREFIX, type WechatChannelInstallationConfig, type WorkflowAgentConfig, type WorkflowRun, type WorkflowRunStatus, type WorkflowTrackingStore, type Workspace, type WorkspaceStore, type YamlAgentStep, type YamlMapStep, type YamlParallelBlock, type YamlTopLevelStep, type YamlWorkflow, assertGenericProjectConfig, createAgentWebAppStreamProjectionContext, descriptorDataValue, effectiveGrants, getSubAgentsFromConfig, getToolsFromConfig, hasTools, isA2ARemoteAgentConfig, isDeepAgentConfig, isExecutionResultEventKey, isMcpUiRef, isProcessingAgentConfig, isProjectRoomEventId, isTeamAgentConfig, isWorkflowAgentConfig, isWorkspacePublicRoomProjectId, normalizeTaskMetadataScalar, parseAgentWebAppGenUIBlock, parseMcpUiRef, parseProjectRoomEventId, parseQueuedExecutionMode, parseTaskBeliefState, parseTrustedRunContext, projectAgentWebAppChunk, projectRoomUserEventScope, replaceTaskBeliefState, requireProjectTaskWorkItemStore, snapshotExactArray, snapshotExactRecord, snapshotProjectRoomBotMembershipRealtime, snapshotProjectRoomMembershipRealtime, snapshotProjectRoomMessageRealtime, taskBeliefStatesEqual, toProjectRoomPublicBotMembership, toProjectRoomPublicMembership, toProjectRoomPublicMessage };

package/dist/index.js

@@ -55,12 +55,15 @@ __export(index_exports, {
   isA2ARemoteAgentConfig: () => isA2ARemoteAgentConfig,
   isDeepAgentConfig: () => isDeepAgentConfig,
   isExecutionResultEventKey: () => isExecutionResultEventKey,
+  isMcpUiRef: () => isMcpUiRef,
   isProcessingAgentConfig: () => isProcessingAgentConfig,
   isProjectRoomEventId: () => isProjectRoomEventId,
   isTeamAgentConfig: () => isTeamAgentConfig,
   isWorkflowAgentConfig: () => isWorkflowAgentConfig,
   isWorkspacePublicRoomProjectId: () => isWorkspacePublicRoomProjectId,
+  normalizeTaskMetadataScalar: () => normalizeTaskMetadataScalar,
   parseAgentWebAppGenUIBlock: () => parseAgentWebAppGenUIBlock,
+  parseMcpUiRef: () => parseMcpUiRef,
   parseProjectRoomEventId: () => parseProjectRoomEventId,
   parseQueuedExecutionMode: () => parseQueuedExecutionMode,
   parseTaskBeliefState: () => parseTaskBeliefState,
@@ -244,6 +247,14 @@ var ChannelBindingMigrationConflictError = class extends Error {
   }
 };
 
+// src/TaskStoreProtocol.ts
+function normalizeTaskMetadataScalar(value) {
+  if (typeof value === "string") return value;
+  if (typeof value === "number") return Number.isFinite(value) ? String(value) : void 0;
+  if (typeof value === "boolean") return value ? "true" : "false";
+  return void 0;
+}
+
 // src/TaskWorkItemProtocol.ts
 var EXECUTION_RESULT_EVENT_KEY_PREFIX = "execution-result:";
 var EXECUTION_RESULT_EVENT_KEY_PATTERN_SOURCE = "^execution-result:[A-Za-z0-9._:-]+$";
@@ -913,23 +924,26 @@ function parseTrustedRunContext(value) {
       "threadId",
       "inputMessageId"
     ];
-    const projectTaskValues = snapshotExactRecord(contextValues.projectTask, requiredKeys2);
-    if (!projectTaskValues || requiredKeys2.some((key) => typeof projectTaskValues[key] !== "string" || projectTaskValues[key].length === 0)) {
+    const projectTaskValues = snapshotExactRecord(contextValues.projectTask, requiredKeys2, ["source"]);
+    const projectTaskHasSource = projectTaskValues !== void 0 && Object.prototype.hasOwnProperty.call(projectTaskValues, "source");
+    if (!projectTaskValues || requiredKeys2.some((key) => typeof projectTaskValues[key] !== "string" || projectTaskValues[key].length === 0) || projectTaskHasSource && projectTaskValues.source !== void 0 && (typeof projectTaskValues.source !== "string" || projectTaskValues.source.length === 0)) {
       throw new Error("Invalid trusted agent run context");
     }
-    return {
-      projectTask: {
-        tenantId: projectTaskValues.tenantId,
-        workspaceId: projectTaskValues.workspaceId,
-        projectId: projectTaskValues.projectId,
-        roomId: projectTaskValues.roomId,
-        membershipId: projectTaskValues.membershipId,
-        assistantId: projectTaskValues.assistantId,
-        taskId: projectTaskValues.taskId,
-        threadId: projectTaskValues.threadId,
-        inputMessageId: projectTaskValues.inputMessageId
-      }
+    const parsedProjectTask = {
+      tenantId: projectTaskValues.tenantId,
+      workspaceId: projectTaskValues.workspaceId,
+      projectId: projectTaskValues.projectId,
+      roomId: projectTaskValues.roomId,
+      membershipId: projectTaskValues.membershipId,
+      assistantId: projectTaskValues.assistantId,
+      taskId: projectTaskValues.taskId,
+      threadId: projectTaskValues.threadId,
+      inputMessageId: projectTaskValues.inputMessageId
     };
+    if (projectTaskHasSource && typeof projectTaskValues.source === "string") {
+      parsedProjectTask.source = projectTaskValues.source;
+    }
+    return { projectTask: parsedProjectTask };
   }
   const projectRoomValue = contextValues?.projectRoom;
   const requiredKeys = [
@@ -944,9 +958,10 @@ function parseTrustedRunContext(value) {
     "role",
     "title"
   ];
-  const projectRoomValues = snapshotExactRecord(projectRoomValue, requiredKeys, ["responsibility"]);
+  const projectRoomValues = snapshotExactRecord(projectRoomValue, requiredKeys, ["responsibility", "source"]);
   const hasResponsibility = projectRoomValues !== void 0 && Object.prototype.hasOwnProperty.call(projectRoomValues, "responsibility");
-  if (!projectRoomValues || requiredKeys.some((key) => typeof projectRoomValues[key] !== "string" || projectRoomValues[key].length === 0) || hasResponsibility && projectRoomValues.responsibility !== void 0 && (typeof projectRoomValues.responsibility !== "string" || projectRoomValues.responsibility.length === 0) || projectRoomValues.role !== "coordinator" && projectRoomValues.role !== "specialist") {
+  const hasSource = projectRoomValues !== void 0 && Object.prototype.hasOwnProperty.call(projectRoomValues, "source");
+  if (!projectRoomValues || requiredKeys.some((key) => typeof projectRoomValues[key] !== "string" || projectRoomValues[key].length === 0) || hasResponsibility && projectRoomValues.responsibility !== void 0 && (typeof projectRoomValues.responsibility !== "string" || projectRoomValues.responsibility.length === 0) || hasSource && projectRoomValues.source !== void 0 && (typeof projectRoomValues.source !== "string" || projectRoomValues.source.length === 0) || projectRoomValues.role !== "coordinator" && projectRoomValues.role !== "specialist") {
     throw new Error("Invalid trusted agent run context");
   }
   const parsedProjectRoom = {
@@ -964,6 +979,9 @@ function parseTrustedRunContext(value) {
   if (hasResponsibility && typeof projectRoomValues.responsibility === "string") {
     parsedProjectRoom.responsibility = projectRoomValues.responsibility;
   }
+  if (hasSource && typeof projectRoomValues.source === "string") {
+    parsedProjectRoom.source = projectRoomValues.source;
+  }
   return { projectRoom: parsedProjectRoom };
 }
 function parseQueuedExecutionMode(value) {
@@ -979,6 +997,32 @@ function effectiveGrants(record) {
   }
   return [{ domain: "agent" }];
 }
+
+// src/McpUiProtocol.ts
+var MODES = ["inline", "fullscreen", "pip"];
+var isObj = (v) => typeof v === "object" && v !== null;
+function isMcpUiRef(value) {
+  return parseMcpUiRef(value) !== null;
+}
+function parseMcpUiRef(value) {
+  if (!isObj(value)) return null;
+  const displayMode = MODES.includes(value.displayMode) ? value.displayMode : "inline";
+  const title = typeof value.title === "string" ? value.title : void 0;
+  if (value.kind === "mcp" && typeof value.serverKey === "string" && typeof value.resourceUri === "string") {
+    return {
+      kind: "mcp",
+      serverKey: value.serverKey,
+      resourceUri: value.resourceUri,
+      displayMode,
+      ...title ? { title } : {},
+      ...value.structuredContent !== void 0 ? { structuredContent: value.structuredContent } : {}
+    };
+  }
+  if (value.kind === "plugin" && typeof value.pluginType === "string" && typeof value.resource === "string") {
+    return { kind: "plugin", pluginType: value.pluginType, resource: value.resource, displayMode, ...title ? { title } : {} };
+  }
+  return null;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AgentType,
@@ -1016,12 +1060,15 @@ function effectiveGrants(record) {
   isA2ARemoteAgentConfig,
   isDeepAgentConfig,
   isExecutionResultEventKey,
+  isMcpUiRef,
   isProcessingAgentConfig,
   isProjectRoomEventId,
   isTeamAgentConfig,
   isWorkflowAgentConfig,
   isWorkspacePublicRoomProjectId,
+  normalizeTaskMetadataScalar,
   parseAgentWebAppGenUIBlock,
+  parseMcpUiRef,
   parseProjectRoomEventId,
   parseQueuedExecutionMode,
   parseTaskBeliefState,