@axiom-lattice/protocols 6.2.0 → 6.3.0

package/dist/index.d.ts

@@ -4533,6 +4533,8 @@ type McpUiRef = {
     resourceUri: string;
     displayMode: McpUiDisplayMode;
     title?: string;
+    /** Tool that produced the UI resource (1..128 chars), when known. */
+    toolName?: string;
     /**
      * Retained only for backward compatibility with pre-unification
      * messages; no longer emitted. Rich tool results now travel via
@@ -4545,6 +4547,8 @@ type McpUiRef = {
     resource: string;
     displayMode: McpUiDisplayMode;
     title?: string;
+    /** Tool that produced the UI resource (1..128 chars), when known. */
+    toolName?: string;
     /** Opaque HMAC-signed run/connection scope (1..4096 chars); never contains secrets. */
     scope?: string;
 };
@@ -4599,6 +4603,7 @@ type McpAppMenuConfig = {
     resourceUri: string;
     displayMode?: McpUiDisplayMode;
     title?: string;
+    toolName?: string;
     toolInput?: Record<string, unknown>;
     toolResult?: unknown;
     ui?: ToolCallUi;
@@ -4608,6 +4613,7 @@ type McpAppMenuConfig = {
     resource: string;
     displayMode?: McpUiDisplayMode;
     title?: string;
+    toolName?: string;
     /** Signed scope copied from the ref so a pinned App can keep calling. */
     scope?: string;
     toolInput?: Record<string, unknown>;
@@ -5759,6 +5765,16 @@ interface ChannelAdapter<TConfig = unknown> {
  * OpenProtocol — contracts for the Open API surface (unified external
  * capability invocation). See docs/superpowers/specs/2026-09-07-open-platform-api-design.md.
  */
+/** Resource constraints attached to a grant (domain-specific). */
+interface OpenGrantSelector {
+    /** Sandbox self-binding, set only on server-minted sandbox tokens. */
+    sandbox?: "self";
+    /**
+     * Connection keys of this domain's connection type (the plugin type).
+     * Absent/empty keeps the legacy connect-all behavior.
+     */
+    connections?: string[];
+}
 /** Authorization grant: default-deny; a grant covers one capability domain. */
 interface OpenGrant {
     domain: string;
@@ -5767,9 +5783,7 @@ interface OpenGrant {
      * Absent/empty = every action in the domain.
      */
     items?: string[];
-    selector?: {
-        sandbox?: "self";
-    };
+    selector?: OpenGrantSelector;
 }
 /** Execution context synthesized from a verified credential — never from the caller. */
 interface OpenExecutionContext {
@@ -5777,6 +5791,8 @@ interface OpenExecutionContext {
     projectId: string;
     /** Addressing only, not an authorization dimension (see design §6.2). */
     workspaceId?: string;
+    /** Connection keys pinned by the covering grant (plugin domains only). */
+    connectionKeys?: string[];
     /** Synthesized run identity (mirrors the Agent path's runConfig; plugin tools resolve their own connections). */
     runConfig: Record<string, unknown>;
 }
@@ -5817,6 +5833,14 @@ interface OpenCatalogItem {
         destructiveHint: boolean;
     };
 }
+/** A tenant connection selectable for a connection-backed plugin domain. */
+interface OpenCatalogConnection {
+    /** Connection key, stable within `(tenantId, domain type)`. */
+    key: string;
+    /** Human-readable connection name. */
+    name: string;
+    description?: string;
+}
 interface OpenCatalogDomain {
     domain: string;
     label: string;
@@ -5826,6 +5850,10 @@ interface OpenCatalogDomain {
     /** How grant items are chosen: per-action or per-instance. */
     itemKind: "action" | "instance";
     items: OpenCatalogItem[];
+    /** True when this domain's tools resolve tenant connections. */
+    connectionBacked?: boolean;
+    /** Tenant connections selectable for this domain (connection-backed only). */
+    connections?: OpenCatalogConnection[];
 }
 /** Full grantable capability catalog for a tenant (drives the key picker). */
 interface OpenCatalog {
@@ -7577,6 +7605,8 @@ interface InternalNodeConfig {
  * Provides project-grained, provider-agnostic resource location
  * and file resolution types for the sandbox lattice.
  */
+/** Discriminator for the kind of resource a share points at. */
+type ShareKind = "file" | "mcpApp";
 /** Sandbox resource location — project-grained, provider-agnostic. */
 interface ResourceAddress {
     volume: string;
@@ -7588,10 +7618,37 @@ interface ResourceResolver {
 }
 /** Visibility level for resource shares. */
 type ShareVisibility = "public" | "password" | "internal";
-/** Persisted record of a resource share within a project. */
-interface ShareRecord {
+/** Live target of the MCP App a share points at. */
+interface McpAppShareApp {
+    /** Where the App comes from. */
+    kind: "plugin" | "mcp";
+    /** Initial invocation tool; required for tool shares, optional for invocation shares. */
+    toolName?: string;
+    displayMode?: McpUiDisplayMode;
+    title?: string;
+    /** Plugin-sourced Apps. */
+    pluginType?: string;
+    resource?: string;
+    /** HMAC-signed scope; persisted on the share record, never emitted in bootstrap. */
+    scope?: string;
+    /** MCP-server-sourced Apps. */
+    serverKey?: string;
+    resourceUri?: string;
+    /**
+     * Initial tool arguments. Stored so a shared link can re-run the tool on
+     * every open; the tool result itself is never persisted.
+     */
+    toolInput?: Record<string, unknown>;
+}
+/** App share target stored in the reuse of the `address` column. */
+interface McpAppShareTarget {
+    kind: "mcpApp";
+    app: McpAppShareApp;
+}
+/** Share target: either a file location or an App target. */
+type ShareTarget = ResourceAddress | McpAppShareTarget;
+interface ShareRecordBase {
     token: string;
-    address: ResourceAddress;
     title: string | null;
     createdBy: string;
     tenantId: string;
@@ -7610,8 +7667,23 @@ interface ShareRecord {
     createdAt: Date;
     version: number;
 }
-/** Client-provided payload for creating a new resource share. */
-interface CreateShareRequest {
+/** Persisted record of a file share within a project. */
+interface FileShareRecord extends ShareRecordBase {
+    kind: "file";
+    address: ResourceAddress;
+}
+/** Persisted record of an MCP App share within a project. */
+interface McpAppShareRecord extends ShareRecordBase {
+    kind: "mcpApp";
+    address: McpAppShareTarget;
+    /** App shares V1 do not support `internal`. */
+    visibility: "public" | "password";
+}
+/** Persisted record of a resource share within a project. */
+type ShareRecord = FileShareRecord | McpAppShareRecord;
+/** Client-provided payload for creating a new file share. */
+interface CreateFileShareRequest {
+    kind?: "file";
     resourcePath: string;
     assistantId?: string;
     visibility?: ShareVisibility;
@@ -7622,21 +7694,72 @@ interface CreateShareRequest {
     /** Extra Open-door grants for sandbox tokens minted for this share. */
     openGrants?: OpenGrant[];
 }
+/** Client-provided payload for creating a new MCP App share. */
+interface CreateMcpAppShareRequest {
+    kind: "mcpApp";
+    app: McpAppShareApp;
+    title?: string;
+    /** Required: `public` or `password`; there is no default. */
+    visibility: "public" | "password";
+    password?: string;
+    expiresAt?: string;
+    maxAccess?: number;
+}
+/** Client-provided payload for creating a new resource share. */
+type CreateShareRequest = CreateFileShareRequest | CreateMcpAppShareRequest;
 /** Response returned to clients after a share is created. */
 interface ShareResult {
     token: string;
     url: string;
 }
+/** Mutable fields of a persisted share record. */
+interface ShareRecordPatch {
+    title?: string;
+    expiresAt?: Date | null;
+    maxAccess?: number | null;
+    revoked?: boolean;
+    visibility?: ShareVisibility;
+    passwordHash?: string | null;
+}
+/** Store insert shape for a new share record. */
+type CreateShareRecord = Omit<FileShareRecord, "accessCount" | "createdAt" | "version"> | Omit<McpAppShareRecord, "accessCount" | "createdAt" | "version">;
 /** Store interface for persisting and querying resource shares. */
 interface SharedResourceStore {
     findByToken(token: string): Promise<ShareRecord | null>;
-    create(record: Omit<ShareRecord, "accessCount" | "createdAt" | "version">): Promise<ShareRecord>;
-    update(token: string, patch: Partial<Pick<ShareRecord, "title" | "expiresAt" | "maxAccess" | "revoked" | "visibility" | "passwordHash">>): Promise<void>;
+    create(record: CreateShareRecord): Promise<ShareRecord>;
+    update(token: string, patch: ShareRecordPatch): Promise<void>;
     listByUser(tenantId: string, userId: string): Promise<ShareRecord[]>;
     incrementAccess(token: string): Promise<void>;
     atomicIncrementAccess(token: string): Promise<boolean>;
 }
 
+/** Public-facing description of a shared MCP App. */
+interface McpAppShareBootstrap {
+    title: string | null;
+    visibility: "public" | "password";
+    app: {
+        kind: "plugin" | "mcp";
+        toolName?: string;
+        ref: McpUiRef;
+        /** Initial arguments re-executed on every open. */
+        toolInput?: Record<string, unknown>;
+        /** Fresh tool result produced for this bootstrap. */
+        toolResult?: unknown;
+    };
+}
+/** Share card payload rendered inside an MCP App. */
+interface ShareCardData {
+    token: string;
+    /** Relative gateway path; the host resolves it against its origin. */
+    path: string;
+    /** Optional absolute URL from a deployment-level public base URL. */
+    url?: string;
+    title: string;
+    visibility: "public" | "password";
+    password?: string;
+    warnings?: string[];
+}
+
 /**
  * Plugin Connection 字段 schema（驱动前端表单渲染）
  */
@@ -8405,4 +8528,4 @@ interface LangfuseObservabilityDashboardPayload {
     tools: LangfuseToolBreakdownRow[];
 }
 
-export { type A2AApiKeyEntry, type A2AApiKeyRecord, type A2AApiKeyStore, type A2AAuthContext, type A2AEventCursor, type A2ARemoteAgentConfig, AFFINITY_ECHO_HEADER, AFFINITY_MISS_CODE, AGENT_AFFINITY_HEADER, ASR_DEFAULT_KEY, type AgentClient, type AgentConfig, type AgentConfigWithTools, type AgentInterrupt, 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, CHANNEL_REPLY_JOB_LIST_LIMIT_DEFAULT, CHANNEL_REPLY_JOB_LIST_LIMIT_MAX, CHANNEL_REPLY_JOB_LIST_LIMIT_MIN, 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 ChannelReplyJob, type ChannelReplyJobStatus, type ChannelReplyJobStore, type CheckpointMaintenance, type CheckpointStorage, 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 CreateChannelReplyJobInput, type CreateCollectionRequest, type CreateConversationInput, type CreateDatabaseConfigRequest, type CreateEvalCaseRequest, type CreateEvalProjectRequest, type CreateEvalRunRequest, type CreateEvalSuiteRequest, type CreateMcpServerConfigRequest, type CreateMenuItemInput, type CreateMetricsServerConfigRequest, type CreateModelProviderRequest, 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, DEFAULT_MODEL_KEY, type DataSource, type DatabaseConfig, type DatabaseConfigEntry, type DatabaseConfigStore, type DatabaseType, type DeepAgentConfig, type DescriptorDataValue, type DeveloperMessage, type DiscoveredModel, type DispatchResult, DuplicateChannelBindingSubjectError, EMBEDDING_DEFAULT_KEY, 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 InterruptAnswerKey, type InterruptMessage, type InterruptPolicy, InvalidProjectCapabilityBundleConfigError, LANGFUSE_OBSERVABILITY_DASHBOARD_VERSION, type LLMConfig, type LangfuseAgentBreakdownRow, type LangfuseModelBreakdownRow, type LangfuseModelCostSeries, type LangfuseObservabilityDashboardPayload, type LangfuseObservabilitySeriesPoint, type LangfuseToolBreakdownRow, type LarkChannelInstallationConfig, type LatticeError, type LatticeEventBus, type LatticeMessage, type LeaseRecord, type LeaseStore, 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 ModelDiscoveryResult, type ModelKind, type ModelLatticeProtocol, type ModelProviderApiStyle, type ModelProviderEntry, type ModelProviderErrorCode, type ModelProviderLlmProvider, type ModelProviderModelEntry, type ModelProviderProbeRequest, type ModelProviderProbeResult, type ModelProviderPublicEntry, type ModelProviderStatus, type ModelProviderStore, type ModelProviderUpstreamErrorCode, type ModelProviderWireProtocol, type ModelSelection, OBSERVABILITY_DASHBOARD_ELEMENT_KEY_PREFIX, type ObservabilityDashboardEnvelope, type ObservabilityDashboardInput, type ObservabilityDashboardRange, type ObservabilityDashboardResult, 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, type OutboundStreamChunk, type OutboxEvent, type OutboxStore, 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 PluginDeployment, type PluginDeploymentMode, type PluginDeploymentStatus, type PluginDeploymentStore, 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 ProviderModelInput, type PublicChannelInstallationType, type QueryParams, type QueryResultFormat, type QueryWorkflowRunsOptions, type QueryWorkflowRunsResult, type QueueClient, type QueueConfig, type QueueLatticeProtocol, type QueueResult, QueueType, type QueuedExecutionMode, REPLICA_HEADER, type ReactAgentConfig, type ReplyTarget, type ResourceAddress, type ResourceResolver, type Result, type RunCancelSignal, type RunScope, type RunStep, STORE_IDENTITY_SEPARATOR, 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 StoreItem, type StoreProtocol, type StorePutInput, type StoreSearchInput, StoreValidationError, 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 Tenant, type TenantModelCatalog, type TenantModelPublicEntry, type TenantStatus, type TenantStore, type TestMcpServerToolsResponse, type Thread, type ThreadCheckpointStorage, 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 UpdateModelProviderRequest, 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 WecomChannelInstallationConfig, type WorkflowAgentConfig, type WorkflowRun, type WorkflowRunStatus, type WorkflowTrackingStore, type Workspace, type WorkspaceStore, type YamlAgentStep, type YamlMapStep, type YamlParallelBlock, type YamlTopLevelStep, type YamlWorkflow, a2aEventCursorSchema, affinityEchoHeaders, assertGenericProjectConfig, assertStoreIdentity, assertStoreNamespacePrefix, assertValidCreateChannelReplyJobInput, buildAffinityMissChunk, createAgentWebAppStreamProjectionContext, descriptorDataValue, effectiveGrants, firstNonEmptyString, getSubAgentsFromConfig, getToolsFromConfig, hasTools, interruptAnswerKeySchema, isA2ARemoteAgentConfig, isDeepAgentConfig, isExecutionResultEventKey, isMcpUiRef, isProcessingAgentConfig, isProjectRoomEventId, isWorkflowAgentConfig, isWorkspacePublicRoomProjectId, normalizeChannelReplyJobListLimit, normalizeTaskMetadataScalar, observabilityDashboardElementKey, parseAgentWebAppGenUIBlock, parseMcpUiRef, parseModelKey, parseProjectRoomEventId, parseQueuedExecutionMode, parseTaskBeliefState, parseTrustedRunContext, projectAgentWebAppChunk, projectRoomUserEventScope, replaceTaskBeliefState, requireProjectTaskWorkItemStore, resolveRunScope, runCancelSignalSchema, snapshotExactArray, snapshotExactRecord, snapshotProjectRoomBotMembershipRealtime, snapshotProjectRoomMembershipRealtime, snapshotProjectRoomMessageRealtime, storeExpiresAt, storePaginationValue, taskBeliefStatesEqual, threadAffinityHeaders, toModelKey, toProjectRoomPublicBotMembership, toProjectRoomPublicMembership, toProjectRoomPublicMessage };
+export { type A2AApiKeyEntry, type A2AApiKeyRecord, type A2AApiKeyStore, type A2AAuthContext, type A2AEventCursor, type A2ARemoteAgentConfig, AFFINITY_ECHO_HEADER, AFFINITY_MISS_CODE, AGENT_AFFINITY_HEADER, ASR_DEFAULT_KEY, type AgentClient, type AgentConfig, type AgentConfigWithTools, type AgentInterrupt, 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, CHANNEL_REPLY_JOB_LIST_LIMIT_DEFAULT, CHANNEL_REPLY_JOB_LIST_LIMIT_MAX, CHANNEL_REPLY_JOB_LIST_LIMIT_MIN, 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 ChannelReplyJob, type ChannelReplyJobStatus, type ChannelReplyJobStore, type CheckpointMaintenance, type CheckpointStorage, 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 CreateChannelReplyJobInput, type CreateCollectionRequest, type CreateConversationInput, type CreateDatabaseConfigRequest, type CreateEvalCaseRequest, type CreateEvalProjectRequest, type CreateEvalRunRequest, type CreateEvalSuiteRequest, type CreateFileShareRequest, type CreateMcpAppShareRequest, type CreateMcpServerConfigRequest, type CreateMenuItemInput, type CreateMetricsServerConfigRequest, type CreateModelProviderRequest, type CreateProjectRequest, type CreateRunStepRequest, type CreateShareRecord, type CreateShareRequest, type CreateSkillRequest, type CreateTaskRequest, type CreateTenantRequest, type CreateThreadRequest, type CreateUserRequest, type CreateUserTenantLinkRequest, type CreateWorkItemIfAbsentRequest, type CreateWorkItemRequest, type CreateWorkflowRunRequest, type CreateWorkspaceRequest, type CustomMenuConfig, DEFAULT_MODEL_KEY, type DataSource, type DatabaseConfig, type DatabaseConfigEntry, type DatabaseConfigStore, type DatabaseType, type DeepAgentConfig, type DescriptorDataValue, type DeveloperMessage, type DiscoveredModel, type DispatchResult, DuplicateChannelBindingSubjectError, EMBEDDING_DEFAULT_KEY, 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 FileShareRecord, 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 InterruptAnswerKey, type InterruptMessage, type InterruptPolicy, InvalidProjectCapabilityBundleConfigError, LANGFUSE_OBSERVABILITY_DASHBOARD_VERSION, type LLMConfig, type LangfuseAgentBreakdownRow, type LangfuseModelBreakdownRow, type LangfuseModelCostSeries, type LangfuseObservabilityDashboardPayload, type LangfuseObservabilitySeriesPoint, type LangfuseToolBreakdownRow, type LarkChannelInstallationConfig, type LatticeError, type LatticeEventBus, type LatticeMessage, type LeaseRecord, type LeaseStore, 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 McpAppShareApp, type McpAppShareBootstrap, type McpAppShareRecord, type McpAppShareTarget, 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 ModelDiscoveryResult, type ModelKind, type ModelLatticeProtocol, type ModelProviderApiStyle, type ModelProviderEntry, type ModelProviderErrorCode, type ModelProviderLlmProvider, type ModelProviderModelEntry, type ModelProviderProbeRequest, type ModelProviderProbeResult, type ModelProviderPublicEntry, type ModelProviderStatus, type ModelProviderStore, type ModelProviderUpstreamErrorCode, type ModelProviderWireProtocol, type ModelSelection, OBSERVABILITY_DASHBOARD_ELEMENT_KEY_PREFIX, type ObservabilityDashboardEnvelope, type ObservabilityDashboardInput, type ObservabilityDashboardRange, type ObservabilityDashboardResult, type OpenAuditAppendInput, type OpenAuditQuery, type OpenAuditRecord, type OpenAuditStore, type OpenCapabilitySource, type OpenCatalog, type OpenCatalogConnection, type OpenCatalogDomain, type OpenCatalogItem, type OpenCredentialKind, type OpenExecutionContext, type OpenExecutionResult, type OpenGrant, type OpenGrantSelector, type OutboundMessage, type OutboundStreamChunk, type OutboxEvent, type OutboxStore, 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 PluginDeployment, type PluginDeploymentMode, type PluginDeploymentStatus, type PluginDeploymentStore, 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 ProviderModelInput, type PublicChannelInstallationType, type QueryParams, type QueryResultFormat, type QueryWorkflowRunsOptions, type QueryWorkflowRunsResult, type QueueClient, type QueueConfig, type QueueLatticeProtocol, type QueueResult, QueueType, type QueuedExecutionMode, REPLICA_HEADER, type ReactAgentConfig, type ReplyTarget, type ResourceAddress, type ResourceResolver, type Result, type RunCancelSignal, type RunScope, type RunStep, STORE_IDENTITY_SEPARATOR, 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 ShareCardData, type ShareKind, type ShareRecord, type ShareRecordPatch, type ShareResult, type ShareTarget, 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 StoreItem, type StoreProtocol, type StorePutInput, type StoreSearchInput, StoreValidationError, 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 Tenant, type TenantModelCatalog, type TenantModelPublicEntry, type TenantStatus, type TenantStore, type TestMcpServerToolsResponse, type Thread, type ThreadCheckpointStorage, 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 UpdateModelProviderRequest, 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 WecomChannelInstallationConfig, type WorkflowAgentConfig, type WorkflowRun, type WorkflowRunStatus, type WorkflowTrackingStore, type Workspace, type WorkspaceStore, type YamlAgentStep, type YamlMapStep, type YamlParallelBlock, type YamlTopLevelStep, type YamlWorkflow, a2aEventCursorSchema, affinityEchoHeaders, assertGenericProjectConfig, assertStoreIdentity, assertStoreNamespacePrefix, assertValidCreateChannelReplyJobInput, buildAffinityMissChunk, createAgentWebAppStreamProjectionContext, descriptorDataValue, effectiveGrants, firstNonEmptyString, getSubAgentsFromConfig, getToolsFromConfig, hasTools, interruptAnswerKeySchema, isA2ARemoteAgentConfig, isDeepAgentConfig, isExecutionResultEventKey, isMcpUiRef, isProcessingAgentConfig, isProjectRoomEventId, isWorkflowAgentConfig, isWorkspacePublicRoomProjectId, normalizeChannelReplyJobListLimit, normalizeTaskMetadataScalar, observabilityDashboardElementKey, parseAgentWebAppGenUIBlock, parseMcpUiRef, parseModelKey, parseProjectRoomEventId, parseQueuedExecutionMode, parseTaskBeliefState, parseTrustedRunContext, projectAgentWebAppChunk, projectRoomUserEventScope, replaceTaskBeliefState, requireProjectTaskWorkItemStore, resolveRunScope, runCancelSignalSchema, snapshotExactArray, snapshotExactRecord, snapshotProjectRoomBotMembershipRealtime, snapshotProjectRoomMembershipRealtime, snapshotProjectRoomMessageRealtime, storeExpiresAt, storePaginationValue, taskBeliefStatesEqual, threadAffinityHeaders, toModelKey, toProjectRoomPublicBotMembership, toProjectRoomPublicMembership, toProjectRoomPublicMessage };

package/dist/index.js

@@ -1221,6 +1221,7 @@ function effectiveGrants(record) {
 // src/McpUiProtocol.ts
 var MODES = ["inline", "fullscreen", "pip"];
 var MAX_MCP_UI_SCOPE_LENGTH = 4096;
+var MAX_MCP_UI_TOOL_NAME_LENGTH = 128;
 var isObj = (v) => typeof v === "object" && v !== null;
 function isMcpUiRef(value) {
   return parseMcpUiRef(value) !== null;
@@ -1229,6 +1230,7 @@ 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;
+  const toolName = typeof value.toolName === "string" && value.toolName.length > 0 && value.toolName.length <= MAX_MCP_UI_TOOL_NAME_LENGTH ? value.toolName : void 0;
   if (value.kind === "mcp" && typeof value.serverKey === "string" && typeof value.resourceUri === "string") {
     return {
       kind: "mcp",
@@ -1236,6 +1238,7 @@ function parseMcpUiRef(value) {
       resourceUri: value.resourceUri,
       displayMode,
       ...title ? { title } : {},
+      ...toolName ? { toolName } : {},
       ...value.structuredContent !== void 0 ? { structuredContent: value.structuredContent } : {}
     };
   }
@@ -1247,6 +1250,7 @@ function parseMcpUiRef(value) {
       resource: value.resource,
       displayMode,
       ...title ? { title } : {},
+      ...toolName ? { toolName } : {},
       ...scope ? { scope } : {}
     };
   }