@axiom-lattice/protocols 4.0.0 → 4.0.1

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @axiom-lattice/protocols@4.0.0 build /home/runner/work/agentic/agentic/packages/protocols
+> @axiom-lattice/protocols@4.0.1 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     12.80 KB
-ESM dist/index.mjs.map 57.44 KB
-ESM ⚡️ Build success in 182ms
-CJS dist/index.js     14.69 KB
-CJS dist/index.js.map 59.96 KB
-CJS ⚡️ Build success in 186ms
+ESM dist/index.mjs     15.02 KB
+ESM dist/index.mjs.map 65.29 KB
+ESM ⚡️ Build success in 160ms
+CJS dist/index.js     16.98 KB
+CJS dist/index.js.map 67.90 KB
+CJS ⚡️ Build success in 161ms
 DTS Build start
-DTS ⚡️ Build success in 11445ms
-DTS dist/index.d.ts  148.90 KB
-DTS dist/index.d.mts 148.90 KB
+DTS ⚡️ Build success in 13938ms
+DTS dist/index.d.ts  156.11 KB
+DTS dist/index.d.mts 156.11 KB

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @axiom-lattice/protocols
 
+## 4.0.1
+
+### Patch Changes
+
+- b44b480: Add managed Agent Web App publications, an isolated public runtime with project, model, thread, attachment and HITL boundaries, management SDK methods, and a dedicated React SDK Web App entry with composable hooks and widget components. Share authorized Agent execution, close-aware SSE transport, neutral file-reference formatting, and review decision state without merging Console and external authentication contexts.
+- 3401a97: fix web
+
 ## 4.0.0
 
 ### Major Changes

package/dist/index.d.mts

@@ -4446,6 +4446,213 @@ interface IConversationStore {
     deleteConversation(conversationId: string): Promise<void>;
 }
 
+/** Lifecycle state of an Agent Web App publication. */
+type AgentWebAppStatus = "draft" | "active" | "disabled";
+/** Project and model boundaries exposed by an Agent Web App. */
+interface AgentWebAppScope {
+    defaultProjectId: string;
+    allowedProjectIds: string[];
+    defaultModelKey?: string;
+    allowedModelKeys?: string[];
+}
+/** Runtime capabilities enabled for an Agent Web App. */
+interface AgentWebAppFeatures {
+    projectSelector: boolean;
+    modelSelector: boolean;
+    threadManagement: boolean;
+    attachments: boolean;
+    hitl: boolean;
+    genUI: boolean;
+}
+/** Optional display customization for an Agent Web App. */
+interface AgentWebAppAppearance {
+    title?: string;
+    welcomeMessage?: string;
+    primaryColor?: string;
+}
+/** Persisted React SDK publication of an assistant. */
+interface AgentWebApp {
+    id: string;
+    tenantId: string;
+    assistantId: string;
+    name: string;
+    description?: string;
+    status: AgentWebAppStatus;
+    integration: {
+        type: "react_sdk";
+    };
+    scope: AgentWebAppScope;
+    features: AgentWebAppFeatures;
+    appearance: AgentWebAppAppearance;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/** Client-provided fields used to create an Agent Web App. */
+interface CreateAgentWebAppInput {
+    assistantId: string;
+    name: string;
+    description?: string;
+    integration: {
+        type: "react_sdk";
+    };
+    scope: AgentWebAppScope;
+    features: AgentWebAppFeatures;
+    appearance: AgentWebAppAppearance;
+}
+/** Editable fields accepted when updating an Agent Web App. Nested objects use merge semantics. */
+interface UpdateAgentWebAppInput {
+    name?: string;
+    description?: string;
+    scope?: Partial<AgentWebAppScope>;
+    features?: Partial<AgentWebAppFeatures>;
+    appearance?: Partial<AgentWebAppAppearance>;
+}
+/** Internal persistence patch. Nested objects are complete replacements when provided. */
+interface AgentWebAppStorePatch {
+    name?: string;
+    description?: string;
+    scope?: AgentWebAppScope;
+    features?: AgentWebAppFeatures;
+    appearance?: AgentWebAppAppearance;
+    status?: AgentWebAppStatus;
+}
+/** Optional optimistic concurrency guard for an Agent Web App update. */
+interface AgentWebAppUpdateOptions {
+    /** Update only when the persisted timestamp exactly matches this snapshot. */
+    expectedUpdatedAt?: Date;
+}
+/** Tenant-scoped persistence operations for Agent Web Apps. */
+interface AgentWebAppStore {
+    list(tenantId: string, assistantId?: string): Promise<AgentWebApp[]>;
+    getById(tenantId: string, webAppId: string): Promise<AgentWebApp | null>;
+    /**
+     * Resolve a globally identifiable publication for an external runtime request.
+     *
+     * The returned record still carries its owning tenant; callers must derive all
+     * tenant scope from that record and must not accept a tenant from the browser.
+     */
+    findById(webAppId: string): Promise<AgentWebApp | null>;
+    create(tenantId: string, input: CreateAgentWebAppInput): Promise<AgentWebApp>;
+    update(tenantId: string, webAppId: string, patch: AgentWebAppStorePatch, options?: AgentWebAppUpdateOptions): Promise<AgentWebApp | null>;
+    delete(tenantId: string, webAppId: string): Promise<boolean>;
+}
+
+/** Server-owned metadata that isolates an external user's Web App thread. */
+interface AgentWebAppThreadMetadata {
+    source: "web_app";
+    webAppId: string;
+    userId: string;
+    projectId: string;
+    label?: string;
+}
+/** Public, redacted projection of a thread owned by an Agent Web App identity. */
+interface AgentWebAppRuntimeThread {
+    id: string;
+    projectId: string;
+    label?: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/** Reviewed public message projection. Structured internal content is not exposed. */
+interface AgentWebAppRuntimeMessage {
+    id: string;
+    role: "human" | "ai";
+    content?: string | AgentWebAppGenUIBlock[];
+}
+interface AgentWebAppCalloutWidget {
+    kind: "callout";
+    text: string;
+    title?: string;
+    tone?: "info" | "success" | "warning";
+}
+interface AgentWebAppTableWidget {
+    kind: "table";
+    columns: string[];
+    rows: string[][];
+    caption?: string;
+}
+/** V1 declarative GenUI block. It deliberately has no HTML, URL, or executable fields. */
+interface AgentWebAppGenUIBlock {
+    type: "widget";
+    widget: AgentWebAppCalloutWidget | AgentWebAppTableWidget;
+}
+/** Public initialization data available to an external Agent Web App. */
+interface AgentWebAppBootstrap {
+    webApp: {
+        id: string;
+        name: string;
+        description?: string;
+        assistant: {
+            id: string;
+            name: string;
+            description?: string;
+        };
+        defaultProjectId: string;
+        defaultModelKey?: string;
+        features: AgentWebAppFeatures;
+        appearance: AgentWebAppAppearance;
+        identityAssurance: "unverified";
+    };
+    projects: Array<{
+        id: string;
+        name: string;
+    }>;
+    models: Array<{
+        key: string;
+        label: string;
+    }>;
+    /** Latest owned thread, created implicitly only when thread management is disabled. */
+    thread?: AgentWebAppRuntimeThread;
+}
+/** Human-in-the-loop interruption exposed through the Web App runtime. */
+interface AgentWebAppInterrupt {
+    id: string;
+    type: string;
+    prompt: string;
+    data?: Record<string, unknown>;
+}
+/**
+ * Stable machine-readable error codes returned by the Web App runtime.
+ *
+ * `INVALID_REQUEST` covers redacted request-validation failures and
+ * `INTERNAL_ERROR` covers redacted unexpected server failures.
+ */
+type AgentWebAppErrorCode = "WEB_APP_NOT_FOUND" | "WEB_APP_DISABLED" | "USER_ID_REQUIRED" | "INVALID_USER_ID" | "PROJECT_NOT_ALLOWED" | "PROJECT_SELECTOR_DISABLED" | "MODEL_NOT_ALLOWED" | "FEATURE_DISABLED" | "THREAD_NOT_FOUND" | "STREAM_CONFLICT" | "STREAM_FAILED" | "INVALID_REQUEST" | "INTERNAL_ERROR";
+/** Public error payload returned by the Web App runtime. */
+interface AgentWebAppError {
+    code: AgentWebAppErrorCode;
+    message: string;
+    retryable: boolean;
+}
+/** Stable stream events projected from internal agent execution output. */
+type AgentWebAppStreamEvent = {
+    type: "message.delta";
+    text: string;
+} | {
+    type: "message.completed";
+    messageId: string;
+} | {
+    type: "tool.started";
+    id: string;
+    name: string;
+} | {
+    type: "tool.completed";
+    id: string;
+} | {
+    type: "interrupt.created";
+    interrupt: AgentWebAppInterrupt;
+} | {
+    type: "genui.render";
+    block: AgentWebAppGenUIBlock;
+} | {
+    type: "error";
+    error: AgentWebAppError;
+} | {
+    type: "stream.completed";
+};
+/** Validate and copy one strict public GenUI block at a trust boundary. */
+declare function parseAgentWebAppGenUIBlock(value: unknown): AgentWebAppGenUIBlock | undefined;
+
 /**
  * YAML Workflow DSL — linear model with parallel blocks
  *
@@ -4922,4 +5129,4 @@ type Timestamp = number;
  */
 type Callback<T = any, R = void> = (data: T) => R | Promise<R>;
 
-export { type A2AApiKeyEntry, type A2AApiKeyRecord, type A2AApiKeyStore, type A2AAuthContext, type A2AExposure, type A2ARemoteAgentConfig, type AgentClient, type AgentConfig, type AgentConfigWithTools, type AgentLatticeProtocol, type AgentMenuConfig, 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 Collection, type CollectionField, type CollectionFieldType, type CollectionMiddlewareConfig, type CollectionSchema, type CollectionStore, type ConnectionEntry, type ConnectionStore, type ConversationRecord, type CreateA2AApiKeyInput, type CreateAssistantRequest, type CreateBindingInput, 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 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 HtmlMenuConfig, type IConversationStore, type ID, type InboundMessage, type InternalAgentNode, type InternalBaseNode, type InternalDSL, type InternalEdge, type InternalInput, type InternalInputNode, type InternalMapNode, type InternalNode, type InternalNodeConfig, type InternalOutput, type InternalState, type InternalStateField, type InternalTerminalNode, type InterruptMessage, type InterruptPolicy, 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, 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 OutboundMessage, 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 PluginToolMeta, type ProcessingAgentConfig, type Project, type ProjectFilter, type ProjectKind, type ProjectStore, type QueryParams, type QueryResultFormat, type QueryWorkflowRunsOptions, type QueryWorkflowRunsResult, type QueueClient, type QueueConfig, type QueueLatticeProtocol, type QueueResult, QueueType, type ReactAgentConfig, type ReplyTarget, type ResourceAddress, type ResourceResolver, type Result, type RunStep, type STTClient, type STTConfig, type STTModelLatticeProtocol, 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 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 TaskFileRef, type TaskHandler, type TaskItem, type TaskListFilter, 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 UIComponent, UIComponentType, type UIConfig, type UILatticeProtocol, type UpdateChannelInstallationRequest, type UpdateCollectionRequest, type UpdateDatabaseConfigRequest, type UpdateMcpServerConfigRequest, type UpdateMenuItemInput, type UpdateMetricsServerConfigRequest, type UpdateProjectRequest, type UpdateRunStepRequest, type UpdateTaskRequest, 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 VectorStoreCreateParams, type VectorStoreLatticeProtocol, type VectorStoreProvider, type WechatChannelInstallationConfig, type WorkflowAgentConfig, type WorkflowRun, type WorkflowRunStatus, type WorkflowTrackingStore, type Workspace, type WorkspaceStore, type YamlAgentStep, type YamlMapStep, type YamlParallelBlock, type YamlTopLevelStep, type YamlWorkflow, getSubAgentsFromConfig, getToolsFromConfig, hasTools, isA2ARemoteAgentConfig, isDeepAgentConfig, isProcessingAgentConfig, isTeamAgentConfig, isWorkflowAgentConfig, parseTaskBeliefState, replaceTaskBeliefState, taskBeliefStatesEqual };
+export { type A2AApiKeyEntry, type A2AApiKeyRecord, type A2AApiKeyStore, type A2AAuthContext, type A2AExposure, 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 AgentWebAppInterrupt, type AgentWebAppRuntimeMessage, type AgentWebAppRuntimeThread, type AgentWebAppScope, type AgentWebAppStatus, type AgentWebAppStore, type AgentWebAppStorePatch, type AgentWebAppStreamEvent, type AgentWebAppTableWidget, type AgentWebAppThreadMetadata, type AgentWebAppUpdateOptions, 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 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 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 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 HtmlMenuConfig, type IConversationStore, type ID, type InboundMessage, type InternalAgentNode, type InternalBaseNode, type InternalDSL, type InternalEdge, type InternalInput, type InternalInputNode, type InternalMapNode, type InternalNode, type InternalNodeConfig, type InternalOutput, type InternalState, type InternalStateField, type InternalTerminalNode, type InterruptMessage, type InterruptPolicy, 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, 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 OutboundMessage, 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 PluginToolMeta, type ProcessingAgentConfig, type Project, type ProjectFilter, type ProjectKind, type ProjectStore, type QueryParams, type QueryResultFormat, type QueryWorkflowRunsOptions, type QueryWorkflowRunsResult, type QueueClient, type QueueConfig, type QueueLatticeProtocol, type QueueResult, QueueType, type ReactAgentConfig, type ReplyTarget, type ResourceAddress, type ResourceResolver, type Result, type RunStep, type STTClient, type STTConfig, type STTModelLatticeProtocol, 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 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 TaskFileRef, type TaskHandler, type TaskItem, type TaskListFilter, 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 UIComponent, UIComponentType, type UIConfig, type UILatticeProtocol, type UpdateAgentWebAppInput, type UpdateChannelInstallationRequest, type UpdateCollectionRequest, type UpdateDatabaseConfigRequest, type UpdateMcpServerConfigRequest, type UpdateMenuItemInput, type UpdateMetricsServerConfigRequest, type UpdateProjectRequest, type UpdateRunStepRequest, type UpdateTaskRequest, 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 VectorStoreCreateParams, type VectorStoreLatticeProtocol, type VectorStoreProvider, type WechatChannelInstallationConfig, type WorkflowAgentConfig, type WorkflowRun, type WorkflowRunStatus, type WorkflowTrackingStore, type Workspace, type WorkspaceStore, type YamlAgentStep, type YamlMapStep, type YamlParallelBlock, type YamlTopLevelStep, type YamlWorkflow, getSubAgentsFromConfig, getToolsFromConfig, hasTools, isA2ARemoteAgentConfig, isDeepAgentConfig, isProcessingAgentConfig, isTeamAgentConfig, isWorkflowAgentConfig, parseAgentWebAppGenUIBlock, parseTaskBeliefState, replaceTaskBeliefState, taskBeliefStatesEqual };

package/dist/index.d.ts

@@ -4446,6 +4446,213 @@ interface IConversationStore {
     deleteConversation(conversationId: string): Promise<void>;
 }
 
+/** Lifecycle state of an Agent Web App publication. */
+type AgentWebAppStatus = "draft" | "active" | "disabled";
+/** Project and model boundaries exposed by an Agent Web App. */
+interface AgentWebAppScope {
+    defaultProjectId: string;
+    allowedProjectIds: string[];
+    defaultModelKey?: string;
+    allowedModelKeys?: string[];
+}
+/** Runtime capabilities enabled for an Agent Web App. */
+interface AgentWebAppFeatures {
+    projectSelector: boolean;
+    modelSelector: boolean;
+    threadManagement: boolean;
+    attachments: boolean;
+    hitl: boolean;
+    genUI: boolean;
+}
+/** Optional display customization for an Agent Web App. */
+interface AgentWebAppAppearance {
+    title?: string;
+    welcomeMessage?: string;
+    primaryColor?: string;
+}
+/** Persisted React SDK publication of an assistant. */
+interface AgentWebApp {
+    id: string;
+    tenantId: string;
+    assistantId: string;
+    name: string;
+    description?: string;
+    status: AgentWebAppStatus;
+    integration: {
+        type: "react_sdk";
+    };
+    scope: AgentWebAppScope;
+    features: AgentWebAppFeatures;
+    appearance: AgentWebAppAppearance;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/** Client-provided fields used to create an Agent Web App. */
+interface CreateAgentWebAppInput {
+    assistantId: string;
+    name: string;
+    description?: string;
+    integration: {
+        type: "react_sdk";
+    };
+    scope: AgentWebAppScope;
+    features: AgentWebAppFeatures;
+    appearance: AgentWebAppAppearance;
+}
+/** Editable fields accepted when updating an Agent Web App. Nested objects use merge semantics. */
+interface UpdateAgentWebAppInput {
+    name?: string;
+    description?: string;
+    scope?: Partial<AgentWebAppScope>;
+    features?: Partial<AgentWebAppFeatures>;
+    appearance?: Partial<AgentWebAppAppearance>;
+}
+/** Internal persistence patch. Nested objects are complete replacements when provided. */
+interface AgentWebAppStorePatch {
+    name?: string;
+    description?: string;
+    scope?: AgentWebAppScope;
+    features?: AgentWebAppFeatures;
+    appearance?: AgentWebAppAppearance;
+    status?: AgentWebAppStatus;
+}
+/** Optional optimistic concurrency guard for an Agent Web App update. */
+interface AgentWebAppUpdateOptions {
+    /** Update only when the persisted timestamp exactly matches this snapshot. */
+    expectedUpdatedAt?: Date;
+}
+/** Tenant-scoped persistence operations for Agent Web Apps. */
+interface AgentWebAppStore {
+    list(tenantId: string, assistantId?: string): Promise<AgentWebApp[]>;
+    getById(tenantId: string, webAppId: string): Promise<AgentWebApp | null>;
+    /**
+     * Resolve a globally identifiable publication for an external runtime request.
+     *
+     * The returned record still carries its owning tenant; callers must derive all
+     * tenant scope from that record and must not accept a tenant from the browser.
+     */
+    findById(webAppId: string): Promise<AgentWebApp | null>;
+    create(tenantId: string, input: CreateAgentWebAppInput): Promise<AgentWebApp>;
+    update(tenantId: string, webAppId: string, patch: AgentWebAppStorePatch, options?: AgentWebAppUpdateOptions): Promise<AgentWebApp | null>;
+    delete(tenantId: string, webAppId: string): Promise<boolean>;
+}
+
+/** Server-owned metadata that isolates an external user's Web App thread. */
+interface AgentWebAppThreadMetadata {
+    source: "web_app";
+    webAppId: string;
+    userId: string;
+    projectId: string;
+    label?: string;
+}
+/** Public, redacted projection of a thread owned by an Agent Web App identity. */
+interface AgentWebAppRuntimeThread {
+    id: string;
+    projectId: string;
+    label?: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/** Reviewed public message projection. Structured internal content is not exposed. */
+interface AgentWebAppRuntimeMessage {
+    id: string;
+    role: "human" | "ai";
+    content?: string | AgentWebAppGenUIBlock[];
+}
+interface AgentWebAppCalloutWidget {
+    kind: "callout";
+    text: string;
+    title?: string;
+    tone?: "info" | "success" | "warning";
+}
+interface AgentWebAppTableWidget {
+    kind: "table";
+    columns: string[];
+    rows: string[][];
+    caption?: string;
+}
+/** V1 declarative GenUI block. It deliberately has no HTML, URL, or executable fields. */
+interface AgentWebAppGenUIBlock {
+    type: "widget";
+    widget: AgentWebAppCalloutWidget | AgentWebAppTableWidget;
+}
+/** Public initialization data available to an external Agent Web App. */
+interface AgentWebAppBootstrap {
+    webApp: {
+        id: string;
+        name: string;
+        description?: string;
+        assistant: {
+            id: string;
+            name: string;
+            description?: string;
+        };
+        defaultProjectId: string;
+        defaultModelKey?: string;
+        features: AgentWebAppFeatures;
+        appearance: AgentWebAppAppearance;
+        identityAssurance: "unverified";
+    };
+    projects: Array<{
+        id: string;
+        name: string;
+    }>;
+    models: Array<{
+        key: string;
+        label: string;
+    }>;
+    /** Latest owned thread, created implicitly only when thread management is disabled. */
+    thread?: AgentWebAppRuntimeThread;
+}
+/** Human-in-the-loop interruption exposed through the Web App runtime. */
+interface AgentWebAppInterrupt {
+    id: string;
+    type: string;
+    prompt: string;
+    data?: Record<string, unknown>;
+}
+/**
+ * Stable machine-readable error codes returned by the Web App runtime.
+ *
+ * `INVALID_REQUEST` covers redacted request-validation failures and
+ * `INTERNAL_ERROR` covers redacted unexpected server failures.
+ */
+type AgentWebAppErrorCode = "WEB_APP_NOT_FOUND" | "WEB_APP_DISABLED" | "USER_ID_REQUIRED" | "INVALID_USER_ID" | "PROJECT_NOT_ALLOWED" | "PROJECT_SELECTOR_DISABLED" | "MODEL_NOT_ALLOWED" | "FEATURE_DISABLED" | "THREAD_NOT_FOUND" | "STREAM_CONFLICT" | "STREAM_FAILED" | "INVALID_REQUEST" | "INTERNAL_ERROR";
+/** Public error payload returned by the Web App runtime. */
+interface AgentWebAppError {
+    code: AgentWebAppErrorCode;
+    message: string;
+    retryable: boolean;
+}
+/** Stable stream events projected from internal agent execution output. */
+type AgentWebAppStreamEvent = {
+    type: "message.delta";
+    text: string;
+} | {
+    type: "message.completed";
+    messageId: string;
+} | {
+    type: "tool.started";
+    id: string;
+    name: string;
+} | {
+    type: "tool.completed";
+    id: string;
+} | {
+    type: "interrupt.created";
+    interrupt: AgentWebAppInterrupt;
+} | {
+    type: "genui.render";
+    block: AgentWebAppGenUIBlock;
+} | {
+    type: "error";
+    error: AgentWebAppError;
+} | {
+    type: "stream.completed";
+};
+/** Validate and copy one strict public GenUI block at a trust boundary. */
+declare function parseAgentWebAppGenUIBlock(value: unknown): AgentWebAppGenUIBlock | undefined;
+
 /**
  * YAML Workflow DSL — linear model with parallel blocks
  *
@@ -4922,4 +5129,4 @@ type Timestamp = number;
  */
 type Callback<T = any, R = void> = (data: T) => R | Promise<R>;
 
-export { type A2AApiKeyEntry, type A2AApiKeyRecord, type A2AApiKeyStore, type A2AAuthContext, type A2AExposure, type A2ARemoteAgentConfig, type AgentClient, type AgentConfig, type AgentConfigWithTools, type AgentLatticeProtocol, type AgentMenuConfig, 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 Collection, type CollectionField, type CollectionFieldType, type CollectionMiddlewareConfig, type CollectionSchema, type CollectionStore, type ConnectionEntry, type ConnectionStore, type ConversationRecord, type CreateA2AApiKeyInput, type CreateAssistantRequest, type CreateBindingInput, 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 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 HtmlMenuConfig, type IConversationStore, type ID, type InboundMessage, type InternalAgentNode, type InternalBaseNode, type InternalDSL, type InternalEdge, type InternalInput, type InternalInputNode, type InternalMapNode, type InternalNode, type InternalNodeConfig, type InternalOutput, type InternalState, type InternalStateField, type InternalTerminalNode, type InterruptMessage, type InterruptPolicy, 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, 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 OutboundMessage, 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 PluginToolMeta, type ProcessingAgentConfig, type Project, type ProjectFilter, type ProjectKind, type ProjectStore, type QueryParams, type QueryResultFormat, type QueryWorkflowRunsOptions, type QueryWorkflowRunsResult, type QueueClient, type QueueConfig, type QueueLatticeProtocol, type QueueResult, QueueType, type ReactAgentConfig, type ReplyTarget, type ResourceAddress, type ResourceResolver, type Result, type RunStep, type STTClient, type STTConfig, type STTModelLatticeProtocol, 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 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 TaskFileRef, type TaskHandler, type TaskItem, type TaskListFilter, 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 UIComponent, UIComponentType, type UIConfig, type UILatticeProtocol, type UpdateChannelInstallationRequest, type UpdateCollectionRequest, type UpdateDatabaseConfigRequest, type UpdateMcpServerConfigRequest, type UpdateMenuItemInput, type UpdateMetricsServerConfigRequest, type UpdateProjectRequest, type UpdateRunStepRequest, type UpdateTaskRequest, 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 VectorStoreCreateParams, type VectorStoreLatticeProtocol, type VectorStoreProvider, type WechatChannelInstallationConfig, type WorkflowAgentConfig, type WorkflowRun, type WorkflowRunStatus, type WorkflowTrackingStore, type Workspace, type WorkspaceStore, type YamlAgentStep, type YamlMapStep, type YamlParallelBlock, type YamlTopLevelStep, type YamlWorkflow, getSubAgentsFromConfig, getToolsFromConfig, hasTools, isA2ARemoteAgentConfig, isDeepAgentConfig, isProcessingAgentConfig, isTeamAgentConfig, isWorkflowAgentConfig, parseTaskBeliefState, replaceTaskBeliefState, taskBeliefStatesEqual };
+export { type A2AApiKeyEntry, type A2AApiKeyRecord, type A2AApiKeyStore, type A2AAuthContext, type A2AExposure, 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 AgentWebAppInterrupt, type AgentWebAppRuntimeMessage, type AgentWebAppRuntimeThread, type AgentWebAppScope, type AgentWebAppStatus, type AgentWebAppStore, type AgentWebAppStorePatch, type AgentWebAppStreamEvent, type AgentWebAppTableWidget, type AgentWebAppThreadMetadata, type AgentWebAppUpdateOptions, 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 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 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 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 HtmlMenuConfig, type IConversationStore, type ID, type InboundMessage, type InternalAgentNode, type InternalBaseNode, type InternalDSL, type InternalEdge, type InternalInput, type InternalInputNode, type InternalMapNode, type InternalNode, type InternalNodeConfig, type InternalOutput, type InternalState, type InternalStateField, type InternalTerminalNode, type InterruptMessage, type InterruptPolicy, 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, 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 OutboundMessage, 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 PluginToolMeta, type ProcessingAgentConfig, type Project, type ProjectFilter, type ProjectKind, type ProjectStore, type QueryParams, type QueryResultFormat, type QueryWorkflowRunsOptions, type QueryWorkflowRunsResult, type QueueClient, type QueueConfig, type QueueLatticeProtocol, type QueueResult, QueueType, type ReactAgentConfig, type ReplyTarget, type ResourceAddress, type ResourceResolver, type Result, type RunStep, type STTClient, type STTConfig, type STTModelLatticeProtocol, 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 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 TaskFileRef, type TaskHandler, type TaskItem, type TaskListFilter, 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 UIComponent, UIComponentType, type UIConfig, type UILatticeProtocol, type UpdateAgentWebAppInput, type UpdateChannelInstallationRequest, type UpdateCollectionRequest, type UpdateDatabaseConfigRequest, type UpdateMcpServerConfigRequest, type UpdateMenuItemInput, type UpdateMetricsServerConfigRequest, type UpdateProjectRequest, type UpdateRunStepRequest, type UpdateTaskRequest, 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 VectorStoreCreateParams, type VectorStoreLatticeProtocol, type VectorStoreProvider, type WechatChannelInstallationConfig, type WorkflowAgentConfig, type WorkflowRun, type WorkflowRunStatus, type WorkflowTrackingStore, type Workspace, type WorkspaceStore, type YamlAgentStep, type YamlMapStep, type YamlParallelBlock, type YamlTopLevelStep, type YamlWorkflow, getSubAgentsFromConfig, getToolsFromConfig, hasTools, isA2ARemoteAgentConfig, isDeepAgentConfig, isProcessingAgentConfig, isTeamAgentConfig, isWorkflowAgentConfig, parseAgentWebAppGenUIBlock, parseTaskBeliefState, replaceTaskBeliefState, taskBeliefStatesEqual };

package/dist/index.js

@@ -38,6 +38,7 @@ __export(index_exports, {
   isProcessingAgentConfig: () => isProcessingAgentConfig,
   isTeamAgentConfig: () => isTeamAgentConfig,
   isWorkflowAgentConfig: () => isWorkflowAgentConfig,
+  parseAgentWebAppGenUIBlock: () => parseAgentWebAppGenUIBlock,
   parseTaskBeliefState: () => parseTaskBeliefState,
   replaceTaskBeliefState: () => replaceTaskBeliefState,
   taskBeliefStatesEqual: () => taskBeliefStatesEqual
@@ -389,6 +390,44 @@ function replaceTaskBeliefState(markdown, state) {
   const trailingBreaks = after.length === 0 ? "" : after.startsWith("\n") ? "\n" : "\n\n";
   return before + leadingBreaks + replacement + trailingBreaks + after;
 }
+
+// src/AgentWebAppRuntimeProtocol.ts
+var MAX_WIDGET_TEXT = 2e3;
+var MAX_TABLE_COLUMNS = 12;
+var MAX_TABLE_ROWS = 100;
+function parseAgentWebAppGenUIBlock(value) {
+  if (!isExactRecord(value, ["type", "widget"]) || value.type !== "widget" || !isRecord(value.widget)) return void 0;
+  const widget = value.widget;
+  if (widget.kind === "callout") {
+    if (!hasOnlyKeys(widget, ["kind", "text"], ["title", "tone"]) || !boundedText(widget.text)) return void 0;
+    if (widget.title !== void 0 && !boundedText(widget.title)) return void 0;
+    if (widget.tone !== void 0 && widget.tone !== "info" && widget.tone !== "success" && widget.tone !== "warning") return void 0;
+    return { type: "widget", widget: { kind: "callout", text: widget.text, ...typeof widget.title === "string" ? { title: widget.title } : {}, ...widget.tone ? { tone: widget.tone } : {} } };
+  }
+  if (widget.kind === "table") {
+    if (!hasOnlyKeys(widget, ["kind", "columns", "rows"], ["caption"]) || !Array.isArray(widget.columns) || !Array.isArray(widget.rows)) return void 0;
+    const columns = widget.columns;
+    const rows = widget.rows;
+    if (columns.length === 0 || columns.length > MAX_TABLE_COLUMNS || !columns.every(boundedText)) return void 0;
+    if (rows.length > MAX_TABLE_ROWS || !rows.every((row) => Array.isArray(row) && row.length === columns.length && row.every(boundedText))) return void 0;
+    if (widget.caption !== void 0 && !boundedText(widget.caption)) return void 0;
+    return { type: "widget", widget: { kind: "table", columns: [...columns], rows: rows.map((row) => [...row]), ...typeof widget.caption === "string" ? { caption: widget.caption } : {} } };
+  }
+  return void 0;
+}
+function boundedText(value) {
+  return typeof value === "string" && value.length <= MAX_WIDGET_TEXT;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isExactRecord(value, keys) {
+  return isRecord(value) && Object.keys(value).length === keys.length && keys.every((key) => key in value);
+}
+function hasOnlyKeys(value, required, optional) {
+  const keys = Object.keys(value);
+  return required.every((key) => key in value) && keys.every((key) => required.includes(key) || optional.includes(key));
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AgentType,
@@ -409,6 +448,7 @@ function replaceTaskBeliefState(markdown, state) {
   isProcessingAgentConfig,
   isTeamAgentConfig,
   isWorkflowAgentConfig,
+  parseAgentWebAppGenUIBlock,
   parseTaskBeliefState,
   replaceTaskBeliefState,
   taskBeliefStatesEqual