@axiom-lattice/protocols 4.0.1 → 4.1.1

package/dist/index.d.ts

@@ -1478,6 +1478,34 @@ interface Skill {
      * Creates a hierarchical tree structure for organizing skills
      */
     subSkills?: string[];
+    /**
+     * Source of the skill (optional)
+     * e.g. "builtin-plugin" for read-only plugin-provided skills
+     */
+    source?: string;
+    /**
+     * Owning plugin type (optional)
+     * Set for skills contributed by a registered plugin
+     */
+    pluginType?: string;
+    /**
+     * Plugin skill bundle version (optional)
+     * Set for skills contributed by a registered plugin
+     */
+    version?: string;
+    /**
+     * Resource catalog (optional)
+     * Safe relative paths of a plugin skill's bundled resources with their MIME types
+     */
+    resourcePaths?: Array<{
+        path: string;
+        mimeType?: string;
+    }>;
+    /**
+     * Read-only flag (optional)
+     * True for immutable sources (e.g. plugin-provided skills) that cannot be created/updated/deleted
+     */
+    readOnly?: boolean;
     /**
      * Skill creation timestamp
      */
@@ -2028,12 +2056,34 @@ interface UpdateProjectRequest {
     /** Project classification */
     kind?: ProjectKind;
 }
+/** Error raised when generic project writes attempt to change capability Bundle references. */
+declare class InvalidProjectCapabilityBundleConfigError extends Error {
+    /** Stable machine-readable error code. */
+    readonly code: "INVALID_BUNDLE_CONFIG";
+    /** Creates the reserved-config error returned by generic Project writes. */
+    constructor();
+}
+/** Rejects capability Bundle references supplied through generic Project config writes. */
+declare function assertGenericProjectConfig(config: Record<string, unknown> | undefined): void;
 /**
  * Filter options for listing projects within a workspace
  */
 interface ProjectFilter {
     kind?: ProjectKind;
 }
+/** Atomic result of replacing a Project's capability Bundle IDs. */
+type UpdateProjectCapabilityBundlesResult = {
+    status: "updated";
+    project: Project;
+} | {
+    status: "project_not_found";
+} | {
+    status: "bundle_not_found";
+} | {
+    status: "bundle_conflict";
+};
+/** Revision preconditions for the bundles reviewed before project assignment. */
+type ExpectedCapabilityBundleRevisions = Record<string, string>;
 /**
  * ProjectStore interface
  * Provides CRUD operations for project data
@@ -2043,7 +2093,11 @@ interface ProjectStore {
     getProjectById(tenantId: string, id: string): Promise<Project | null>;
     createProject(tenantId: string, workspaceId: string, id: string, data: CreateProjectRequest): Promise<Project>;
     updateProject(tenantId: string, id: string, updates: UpdateProjectRequest): Promise<Project | null>;
+    /** Omitted expectedRevisions is reserved for internal maintenance callers. */
+    updateCapabilityBundleIds(tenantId: string, projectId: string, bundleIds: string[], expectedRevisions?: ExpectedCapabilityBundleRevisions): Promise<UpdateProjectCapabilityBundlesResult>;
     deleteProject(tenantId: string, id: string): Promise<boolean>;
+    /** Returns whether a tenant project references the given capability bundle. */
+    isCapabilityBundleReferenced(tenantId: string, bundleId: string): Promise<boolean>;
 }
 
 /**
@@ -4155,9 +4209,51 @@ interface TaskWorkItemListFilter {
     limit?: number;
     offset?: number;
 }
+/** Canonical prefix for public task execution-result event identities. */
+declare const EXECUTION_RESULT_EVENT_KEY_PREFIX = "execution-result:";
+/**
+ * Portable regular-expression source for canonical execution-result event keys.
+ *
+ * The entire key is the literal `execution-result:` prefix followed by a nonempty
+ * suffix containing only ASCII letters, digits, period, underscore, colon, or hyphen.
+ * Colon is intentionally allowed so callers can compose structured suffixes.
+ */
+declare const EXECUTION_RESULT_EVENT_KEY_PATTERN_SOURCE = "^execution-result:[A-Za-z0-9._:-]+$";
+/** Compiled runtime expression for canonical execution-result event keys. */
+declare const EXECUTION_RESULT_EVENT_KEY_PATTERN: RegExp;
+/** Maximum pending execution-result rows accepted by one store query. */
+declare const MAX_PENDING_EXECUTION_RESULTS_LIMIT = 1000;
+/**
+ * Determines whether a runtime value is a canonical execution-result event key.
+ *
+ * @param value Runtime value to validate.
+ * @returns True only for the portable canonical ASCII grammar.
+ */
+declare function isExecutionResultEventKey(value: unknown): value is string;
 interface TaskWorkItemStore {
     create(params: CreateWorkItemRequest): Promise<TaskWorkItem>;
     list(filter: TaskWorkItemListFilter): Promise<TaskWorkItem[]>;
+    /**
+     * List the newest bounded set of execution results awaiting reconciliation.
+     *
+     * Only `execution_result` items with a canonical ASCII
+     * `execution-result:[A-Za-z0-9._:-]+` event key are returned. An item is excluded when
+     * a task-scoped `execution_reconciled` item has a
+     * `detail.executionResultId` equal to that event key. Results are ordered by
+     * `createdAt` descending and then `id` descending for deterministic ties.
+     *
+     * @param params Tenant/task scope and required maximum number of rows.
+     * @returns At most `limit` pending execution-result work items, newest first.
+     * @throws RangeError with code `INVALID_LIMIT` unless limit is a safe integer from zero through
+     * {@link MAX_PENDING_EXECUTION_RESULTS_LIMIT}.
+     * @remarks Optional optimization. Stores that omit it remain compatible; callers may use a
+     * bounded, non-authoritative fallback through the pre-existing list and event-key methods.
+     */
+    listPendingExecutionResults?(params: {
+        tenantId: string;
+        taskId: string;
+        limit: number;
+    }): Promise<TaskWorkItem[]>;
     /**
      * Find an event by deterministic identity without list pagination.
      *
@@ -4177,7 +4273,12 @@ interface TaskWorkItemStore {
     createIfAbsentByEventKey(params: CreateWorkItemIfAbsentRequest): Promise<TaskWorkItem>;
 }
 
-/** A single canonical belief recorded in a task description. */
+/**
+ * A single canonical belief recorded in a task description.
+ *
+ * `probability` is retained as the persisted field name, but task guidance uses
+ * it as an evidence-support percentage rather than a calibrated probability.
+ */
 interface TaskBeliefEntry {
     key: string;
     probability: number;
@@ -4653,6 +4754,152 @@ type AgentWebAppStreamEvent = {
 /** Validate and copy one strict public GenUI block at a trust boundary. */
 declare function parseAgentWebAppGenUIBlock(value: unknown): AgentWebAppGenUIBlock | undefined;
 
+/**
+ * Capability bundle persistence protocol.
+ *
+ * A capability bundle is a tenant-scoped, flat collection of middleware
+ * configurations that can be selected by a project.
+ */
+
+/** A tenant-scoped collection of middleware configurations. */
+interface CapabilityBundle {
+    /** Stable bundle identifier. */
+    readonly id: string;
+    /** Tenant that owns the bundle. */
+    tenantId: string;
+    /** Tenant-local unique key. */
+    key: string;
+    /** Human-readable bundle name. */
+    name: string;
+    /** Optional bundle description. */
+    description?: string;
+    /** Middleware configurations contained in the bundle. */
+    capabilities: AgentMiddlewareConfig[];
+    /** Creation timestamp in ISO string format. */
+    createdAt: string;
+    /** Last update timestamp in ISO string format. */
+    updatedAt: string;
+}
+/** Public input used to create a capability bundle; the tenant-local key is generated internally. */
+interface CreateCapabilityBundleInput {
+    /** Human-readable bundle name. */
+    name: string;
+    /** Optional bundle description. */
+    description?: string;
+    /** Middleware configurations contained in the bundle. */
+    capabilities: AgentMiddlewareConfig[];
+}
+/** Input with a generated key used by persistence implementations. */
+interface InternalCreateCapabilityBundleInput extends Omit<CreateCapabilityBundleInput, "key"> {
+    key: string;
+}
+/** Public partial bundle update; the stable key is immutable and the revision is mandatory for gateway updates. */
+interface UpdateCapabilityBundleInput extends Partial<CreateCapabilityBundleInput> {
+    expectedUpdatedAt: string;
+}
+/** Store input retained for internal maintenance callers that may omit CAS. */
+interface InternalUpdateCapabilityBundleInput extends Partial<CreateCapabilityBundleInput> {
+    expectedUpdatedAt?: string;
+}
+/** Result returned when an update's expected revision no longer matches. */
+interface CapabilityBundleUpdateConflict {
+    status: "conflict";
+}
+/** Result of deleting a bundle only when no tenant project references it. */
+type CapabilityBundleDeleteResult = "deleted" | "not_found" | "in_use";
+/** Persistence operations for tenant-scoped capability bundles. */
+interface CapabilityBundleStore {
+    /** Lists all bundles owned by a tenant. */
+    listByTenant(tenantId: string): Promise<CapabilityBundle[]>;
+    /** Gets one bundle by tenant and identifier. */
+    getById(tenantId: string, id: string): Promise<CapabilityBundle | null>;
+    /** Gets bundles by tenant and identifiers. */
+    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. */
+    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>;
+}
+
+/**
+ * Capability runtime and preview protocol definitions.
+ *
+ * These contracts describe the resolved middleware runtime and the
+ * provenance data exposed while composing project bundles.
+ */
+
+/** Project configuration selecting ordered capability bundles. */
+interface ProjectCapabilityConfig {
+    /** Bundle identifiers in composition order. */
+    capabilityBundleIds: string[];
+}
+/** Resolved middleware available to an agent execution. */
+interface CapabilityRuntime {
+    /** Revision identifying the resolved capability set. */
+    revision: string;
+    /** Middleware indexed by middleware identifier. */
+    middleware: Record<string, AgentMiddlewareConfig>;
+}
+/** Provenance for a resolved capability field. */
+interface CapabilityFieldSource {
+    /** Middleware type owning the field. */
+    capabilityType: string;
+    /** RFC 6901 escaped JSON Pointer path of the field within the middleware configuration. */
+    fieldPath: string;
+    /** Bundle that supplied the field value. */
+    sourceBundleId: string;
+    /** Supplied field value. */
+    value: unknown;
+}
+/** A later bundle value replacing an earlier field value. */
+interface CapabilityOverride {
+    /** Middleware type owning the field. */
+    capabilityType: string;
+    /** RFC 6901 escaped JSON Pointer path of the overridden field. */
+    fieldPath: string;
+    /** Value supplied by the earlier bundle. */
+    previousValue: unknown;
+    /** Value supplied by the later bundle. */
+    nextValue: unknown;
+    /** Bundle that supplied the later value. */
+    sourceBundleId: string;
+}
+/** A warning or error produced while previewing bundle composition. */
+interface CapabilityPreviewIssue {
+    /** Stable issue code. */
+    code: string;
+    /** Human-readable issue description. */
+    message: string;
+    /** Related bundle, when applicable. */
+    bundleId?: string;
+    /** Related middleware type, when applicable. */
+    capabilityType?: string;
+    /** Related middleware field path, when applicable. */
+    fieldPath?: string;
+}
+/** Result of composing capability bundles for a project. */
+interface CapabilityPreview {
+    /** Bundle identifiers in composition order. */
+    bundleIds: string[];
+    /** Composed middleware configurations. */
+    capabilities: AgentMiddlewareConfig[];
+    /** Field replacements detected during composition. */
+    overrides: CapabilityOverride[];
+    /** Field-level provenance for composed values. */
+    sources: CapabilityFieldSource[];
+    /** Non-blocking composition issues. */
+    warnings: CapabilityPreviewIssue[];
+    /** Blocking composition issues. */
+    errors: CapabilityPreviewIssue[];
+    /** Revision identifying this preview. */
+    revision: string;
+    /** Bundle content revisions captured by this preview. */
+    bundleRevisions?: Record<string, string>;
+}
+
 /**
  * YAML Workflow DSL — linear model with parallel blocks
  *
@@ -4927,18 +5174,59 @@ interface PluginConnection {
 }
 /**
  * 工具元信息（用于前端 allowedTools 筛选）
+ *
+ * New connection-backed plugin tools that select one connection must accept
+ * the selected key as `args.connectionKey`. Existing legacy tools retain their
+ * established resource argument names.
  */
 interface PluginToolMeta {
     name: string;
     description: string;
 }
+/**
+ * A text file included in a plugin skill bundle.
+ *
+ * @property content - Text content written to the skill resource file.
+ * @property mimeType - Optional MIME type for consumers that need it.
+ */
+interface PluginSkillResource {
+    content: string;
+    mimeType?: string;
+}
+/**
+ * Versioned definition of a plugin-provided skill.
+ *
+ * @property version - Bundle version used to detect resource updates.
+ * @property content - Complete SKILL.md markdown content.
+ * @property resources - Optional text resources keyed by safe relative paths.
+ */
+interface PluginSkillDefinition {
+    version: string;
+    content: string;
+    resources?: Record<string, PluginSkillResource>;
+}
+/**
+ * Standard configuration for a new connection-backed plugin.
+ *
+ * `PluginMeta.type` is also the Connection Store type. `connections` selects
+ * connection keys of that type; `connectAll` opts into using all available
+ * connections of that type. Do not add a separate connection or resource type
+ * or selector field to this configuration.
+ */
+type PluginStandardConnectionConfig = {
+    connections: string[];
+    connectAll?: boolean;
+};
 /**
  * 插件元数据（开发者声明）
  *
  * connectionSchema 不在此类型中——由 serializePluginMeta 自动推导后注入 PluginMetaOutput。
  */
 interface PluginMeta {
-    /** 插件唯一标识，如 "erp" */
+    /**
+     * 插件唯一标识，如 "erp"; for connection-backed plugins this is also the
+     * Connection Store type.
+     */
     type: string;
     /** 显示名称 */
     name: string;
@@ -4952,9 +5240,13 @@ interface PluginMeta {
     icon?: string;
     /** 工具清单（可选，middleware 能自动提取时不需要写） */
     tools?: PluginToolMeta[];
-    /** 中间件配置 schema（用于 agent 配置面板） */
+    /**
+     * 中间件配置 schema（用于 agent 配置面板）。新的 connection-backed
+     * plugins use `connections: string[]` and optional `connectAll?: boolean`.
+     * Do not introduce connectionType, resourceType, or resourceSelector fields.
+     */
     configSchema?: Record<string, unknown>;
-    /** 默认配置 */
+    /** 默认配置；connection-backed plugins use PluginStandardConnectionConfig. */
     defaultConfig?: Record<string, unknown>;
     /** 推荐配置的 companion 插件 */
     recommends?: string[];
@@ -4964,6 +5256,8 @@ interface PluginMeta {
      * 第三方插件可自定义分类名，前端会原样显示；未提供时归入 "Other"。
      */
     category?: string;
+    /** Whether this plugin's middleware may be included in capability bundles. */
+    capabilityBundleEligible?: boolean;
 }
 /**
  * 插件元数据输出（API 返回格式）
@@ -4992,7 +5286,7 @@ interface PluginMetaOutput extends PluginMeta {
  * const myPlugin: Plugin = {
  *   meta: { ... },
  *   middleware: (config, context) => {
- *     const skills = context?.pluginSkillContents ?? {};
+ *     const skills = context?.pluginSkills ?? {};
  *     return createMyMiddleware({ ...config, pluginSkills: skills });
  *   },
  * };
@@ -5000,12 +5294,14 @@ interface PluginMetaOutput extends PluginMeta {
  */
 interface PluginContext {
     /**
-     * Cross-plugin aggregated skill contents (SKILL.md, keyed by skill name).
+     * Cross-plugin aggregated skill bundles, keyed by skill name.
      * Collected from all enabled plugins before the main middleware loop.
      * Most plugins should ignore this; only cross-plugin coordination
      * middleware (e.g. skillMiddleware) consumes it.
      */
-    pluginSkillContents?: Record<string, string>;
+    pluginSkills?: Record<string, PluginSkillDefinition>;
+    /** Owning plugin type for each enabled plugin skill bundle. */
+    pluginSkillOwners?: Record<string, string>;
 }
 /**
  * Factory function that creates middleware from plugin config.
@@ -5051,7 +5347,7 @@ interface Plugin {
      * 名称必须以 "{pluginType}-" 为前缀，注册时校验。
      * Builder 在构建中间件之前从所有启用的插件中收集。
      */
-    skills?: Record<string, string>;
+    skills?: Record<string, PluginSkillDefinition>;
     /**
      * 插件贡献的 Agent 定义（以 agent key 为键）。
      * 在租户首次访问时通过 ensurePluginAgentsForTenant 按租户注册到
@@ -5129,4 +5425,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 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 };
+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 CapabilityBundle, type CapabilityBundleDeleteResult, type CapabilityBundleStore, type CapabilityBundleUpdateConflict, type CapabilityFieldSource, type CapabilityOverride, type CapabilityPreview, type CapabilityPreviewIssue, type CapabilityRuntime, 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 CreateCapabilityBundleInput, 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, 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 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 PluginSkillDefinition, type PluginSkillResource, type PluginStandardConnectionConfig, type PluginToolMeta, type ProcessingAgentConfig, type Project, type ProjectCapabilityConfig, 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 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 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, assertGenericProjectConfig, getSubAgentsFromConfig, getToolsFromConfig, hasTools, isA2ARemoteAgentConfig, isDeepAgentConfig, isExecutionResultEventKey, isProcessingAgentConfig, isTeamAgentConfig, isWorkflowAgentConfig, parseAgentWebAppGenUIBlock, parseTaskBeliefState, replaceTaskBeliefState, taskBeliefStatesEqual };

package/dist/index.js

@@ -21,7 +21,12 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   AgentType: () => AgentType,
+  EXECUTION_RESULT_EVENT_KEY_PATTERN: () => EXECUTION_RESULT_EVENT_KEY_PATTERN,
+  EXECUTION_RESULT_EVENT_KEY_PATTERN_SOURCE: () => EXECUTION_RESULT_EVENT_KEY_PATTERN_SOURCE,
+  EXECUTION_RESULT_EVENT_KEY_PREFIX: () => EXECUTION_RESULT_EVENT_KEY_PREFIX,
+  InvalidProjectCapabilityBundleConfigError: () => InvalidProjectCapabilityBundleConfigError,
   LoggerType: () => LoggerType,
+  MAX_PENDING_EXECUTION_RESULTS_LIMIT: () => MAX_PENDING_EXECUTION_RESULTS_LIMIT,
   McpMessageType: () => McpMessageType,
   MemoryType: () => MemoryType,
   MessageChunkTypes: () => MessageChunkTypes,
@@ -30,11 +35,13 @@ __export(index_exports, {
   ScheduleType: () => ScheduleType,
   ScheduledTaskStatus: () => ScheduledTaskStatus,
   UIComponentType: () => UIComponentType,
+  assertGenericProjectConfig: () => assertGenericProjectConfig,
   getSubAgentsFromConfig: () => getSubAgentsFromConfig,
   getToolsFromConfig: () => getToolsFromConfig,
   hasTools: () => hasTools,
   isA2ARemoteAgentConfig: () => isA2ARemoteAgentConfig,
   isDeepAgentConfig: () => isDeepAgentConfig,
+  isExecutionResultEventKey: () => isExecutionResultEventKey,
   isProcessingAgentConfig: () => isProcessingAgentConfig,
   isTeamAgentConfig: () => isTeamAgentConfig,
   isWorkflowAgentConfig: () => isWorkflowAgentConfig,
@@ -172,6 +179,31 @@ var McpMessageType = /* @__PURE__ */ ((McpMessageType2) => {
   return McpMessageType2;
 })(McpMessageType || {});
 
+// src/WorkspaceStoreProtocol.ts
+var InvalidProjectCapabilityBundleConfigError = class extends Error {
+  /** Creates the reserved-config error returned by generic Project writes. */
+  constructor() {
+    super("Use the project capability-bundles endpoint to update capability bundle IDs");
+    /** Stable machine-readable error code. */
+    this.code = "INVALID_BUNDLE_CONFIG";
+    this.name = "InvalidProjectCapabilityBundleConfigError";
+  }
+};
+function assertGenericProjectConfig(config) {
+  if (config !== void 0 && Object.prototype.hasOwnProperty.call(config, "capabilityBundleIds")) {
+    throw new InvalidProjectCapabilityBundleConfigError();
+  }
+}
+
+// src/TaskWorkItemProtocol.ts
+var EXECUTION_RESULT_EVENT_KEY_PREFIX = "execution-result:";
+var EXECUTION_RESULT_EVENT_KEY_PATTERN_SOURCE = "^execution-result:[A-Za-z0-9._:-]+$";
+var EXECUTION_RESULT_EVENT_KEY_PATTERN = new RegExp(EXECUTION_RESULT_EVENT_KEY_PATTERN_SOURCE);
+var MAX_PENDING_EXECUTION_RESULTS_LIMIT = 1e3;
+function isExecutionResultEventKey(value) {
+  return typeof value === "string" && EXECUTION_RESULT_EVENT_KEY_PATTERN.test(value);
+}
+
 // src/TaskBeliefProtocol.ts
 var BELIEF_HEADING = "## Belief State";
 var ACCEPTANCE_HEADING = "## Acceptance Criteria";
@@ -431,7 +463,12 @@ function hasOnlyKeys(value, required, optional) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AgentType,
+  EXECUTION_RESULT_EVENT_KEY_PATTERN,
+  EXECUTION_RESULT_EVENT_KEY_PATTERN_SOURCE,
+  EXECUTION_RESULT_EVENT_KEY_PREFIX,
+  InvalidProjectCapabilityBundleConfigError,
   LoggerType,
+  MAX_PENDING_EXECUTION_RESULTS_LIMIT,
   McpMessageType,
   MemoryType,
   MessageChunkTypes,
@@ -440,11 +477,13 @@ function hasOnlyKeys(value, required, optional) {
   ScheduleType,
   ScheduledTaskStatus,
   UIComponentType,
+  assertGenericProjectConfig,
   getSubAgentsFromConfig,
   getToolsFromConfig,
   hasTools,
   isA2ARemoteAgentConfig,
   isDeepAgentConfig,
+  isExecutionResultEventKey,
   isProcessingAgentConfig,
   isTeamAgentConfig,
   isWorkflowAgentConfig,