@ai-agent-forge/agent-forge 0.85.0

package/dist/core/extensions/capability-runtime-types.d.ts

@@ -0,0 +1,303 @@
+import type { DurableServiceV1 } from "../../durable/durable-service.ts";
+import type { ObservabilityHostAdapterV1, TraceSinkOptionsV1 } from "../../plugins/observability-types.ts";
+import type { LifecycleDeliveryQueue } from "./lifecycle-delivery-queue.ts";
+import type { AgentCompositionAPI, AgentDefinition, AgentInstance, AgentLoopHookForV1, AgentLoopHookHandlerV1, AgentLoopHookPositionV1, AgentModelInvocationResultV1, AgentRunLoopStrategyDecisionV1, AgentRunLoopStrategyRequestV1, AgentRunLoopStrategyV1, AgentTaskAdapter, AgentTaskSessionSummaryV1, AgentTaskSessionViewV1, BranchSummaryPolicy, BranchSummaryResult, CapabilityAPI, CapabilityCommandContext, CapabilityCommandDefinition, CapabilityCommandResult, CapabilityProviderHandler, CapabilityToolContext, CompactionPolicy, CompactionPolicyDecision, CompactionPolicyRequest, CompactionPreparationRequest, CompactionSummaryRequest, CompactionSummaryResult, ContextOperationOptions, ContextStrategy, ContributionChangeEvent, ContributionEntry, ContributionLifecycle, ContributionPointDefinition, CredentialAPI, DiagnosticsSpanSnapshot, DisposableRegistration, EventEnvelope, ExecutionFactsV1, HostCapabilities, InteractionHostV1, LifecycleAfterCommitHandler, LifecycleDeliverySnapshot, LifecycleDispatchRequest, LifecycleDispatchResult, LifecycleEvent, LifecycleEventDefinition, LifecycleExecuteHandler, LifecycleObserveHandler, LifecycleRegistrationKind, LifecycleTransformHandler, LoggerRecord, OperationExecutionContext, OperationHandle, OperationStatus, OutputArtifactRef, OverflowPolicy, OverflowPolicyDecision, OverflowPolicyRequest, PluginCapabilityDeclaration, PluginConfigValue, PluginManifest, PluginRejection, ProviderHeaderTransform, ProviderHeaderTransformRequest, RetryClassificationRequest, RetryPolicy, RetryPolicyDecision, RetryPolicyRequest, RetryScheduleV1, RuntimeInspectorLifecycleDeliveryReportSnapshot, RuntimeInspectorSnapshot, SessionAPI, SkillDefinition, StateChange } from "./public-api.ts";
+/** Host trace service injection (D-075 S4 second batch observability host contract). */
+export interface TraceServiceV1 {
+    readonly adapter: ObservabilityHostAdapterV1;
+    readonly options?: TraceSinkOptionsV1;
+}
+export type OperationHandler = (input: unknown, context: OperationExecutionContext) => unknown | Promise<unknown>;
+export interface CapabilityRuntimeOptions {
+    clock?: () => number;
+    /** Test-only override for generated runtime identifiers; omitted in production. */
+    idFactory?: (kind: string, sequence: number) => string;
+    /** Test-only observer for every lifecycle dispatch, including detached runtime facts. */
+    onLifecycleDispatch?: (request: LifecycleDispatchRequest<unknown>, settled: Promise<LifecycleDispatchResult<unknown>>) => void;
+    /** Observes each committed output artifact; host adapters may mirror it into durable storage. The runtime stays storage-agnostic. */
+    onOutputArtifactCommit?: (artifact: {
+        readonly ref: OutputArtifactRef;
+        readonly bytes: Uint8Array;
+    }) => void;
+    /**
+     * 运行时工具表变更钩子：工具表发生任何变更（注册、同名替换、卸载、替换链恢复，
+     * 以及插件装卸引发的表变更）后同步调用一次。缺省不传 = 行为不变；回调异常经
+     * 运行时既有错误通道记录，不打断注册本身。
+     */
+    onToolRegistryChange?: () => void;
+    /**
+     * 运行时 invoke 面传给工具 execute 的第二参上下文（additive；现有单参工具不受
+     * 影响）。宿主注入后，经 runtime.invokeTool 调用的工具收到 `{ cwd }`（与会话
+     * cwd 同源，对应命令面 CapabilityCommandContext.cwd）；未注入时第二参保持 undefined。
+     */
+    toolExecutionContext?: CapabilityToolContext;
+    /**
+     * 插件日志记录宿主转发通道（会话轨迹 plugin.log 镜像，设计 §5.3/§7.2）：每条
+     * 经 LoggerAPI 写入并通过校验的记录在入运行时内存环后同步转发一次。回调契约：
+     * 回调内不得调用 LoggerAPI（防自递归）；回调抛错由运行时直接吞掉，不打断
+     * 调用方，也绝不经 recordLog 再记录。缺省不传 = 行为不变。
+     */
+    onLogRecord?: (record: LoggerRecord) => void;
+    session?: SessionAPI;
+    agents?: AgentTaskAdapter;
+    /**
+     * 会话回读器（D-060 S2/S3）：宿主注入后 `api.agents.session(sessionId)` 才存在。
+     * 作用域（只放行本会话的子会话）由宿主在读取器内部强制；内核不做假设。
+     */
+    agentSessionReader?: (sessionId: string) => Promise<AgentTaskSessionViewV1 | undefined>;
+    /**
+     * 列出宿主会话**自己的**子代理会话摘要（按最近活动倒序，D-060 模型面盘点通道）。
+     * 注入后 `agents.list()` 才存在；作用域由宿主强制（宿主只回自己会话的子会话）。
+     */
+    agentSessionLister?: () => Promise<AgentTaskSessionSummaryV1[]>;
+    /**
+     * Durable replay channel for agent task terminal outcomes. When present,
+     * every settle persists a frozen record under the deterministic artifact id
+     * `agent-task:<taskId>`; `api.agents.result(taskId)` reads it back across
+     * runtime rebuilds. The host owns the writer claim lifecycle: the writer
+     * must have claimed on the store before the first settle, or persist fails
+     * loudly with the store's `not_writer` error.
+     */
+    agentResults?: {
+        readonly store: DurableServiceV1;
+        readonly writerId: string;
+    };
+    credentials?: CredentialAPI;
+    interaction?: InteractionHostV1;
+    composition?: AgentCompositionAPI;
+    /** Host-provided model runtime for agent-composition model/tool facades. */
+    modelRuntime?: {
+        /** Provider-agnostic facts about the current session model. */
+        getModelFacts(): {
+            provider: string;
+            id: string;
+            contextWindow: number;
+            maxTokens: number;
+            reasoning: boolean;
+        } | undefined;
+        /** Single-shot model invocation. The host resolves model, auth, transport and cache routing. */
+        invoke: (input: {
+            systemPrompt?: string;
+            prompt: string;
+            maxTokens?: number;
+            thinkingLevel?: string;
+        }, options?: {
+            signal?: AbortSignal;
+        }) => Promise<AgentModelInvocationResultV1>;
+    };
+    /**
+     * Parent-session cancel fence (D-044 §4.2). Consulted once per agent-task
+     * creation: the returned signal (when present) cancels that task if it fires,
+     * or immediately cancels tasks created after it already fired. The host
+     * refreshes the fence epoch so tasks submitted after an aborted turn bind to
+     * the next signal instead of an already-spent one. Absent = no cascade.
+     */
+    parentSignal?: () => AbortSignal | undefined;
+    /**
+     * Host trace service (D-075 S4 second batch): injected on hosts running
+     * session trace collection. Exposed to plugins as `api.trace` (the
+     * adapter) plus `api.traceSinkOptions`; absent = plugins see neither and
+     * stay trace-free.
+     */
+    trace?: TraceServiceV1;
+}
+export interface RegisteredCapability<T> {
+    owner: string;
+    ownerToken: symbol;
+    value: T;
+}
+export interface RegisteredPluginCapability {
+    declaration: PluginCapabilityDeclaration;
+    owner: string;
+    ownerToken: symbol;
+    handler: CapabilityProviderHandler;
+}
+export interface APIState {
+    active: boolean;
+    owner: string;
+    ownerToken: symbol;
+    compositionInstances?: Set<AgentInstance>;
+    compositionDefinitions?: Set<AgentDefinition>;
+}
+export interface StoredOutputArtifact {
+    ref: OutputArtifactRef;
+    bytes: Uint8Array;
+    ownerToken: symbol;
+}
+export interface StoredContributionPoint<TValue = unknown> {
+    owner: string;
+    ownerToken: symbol;
+    definition: ContributionPointDefinition<TValue>;
+    entries: Map<string, StoredContributionEntry<TValue>>;
+    subscribers: Map<string, {
+        ownerToken: symbol;
+        handler: (event: ContributionChangeEvent<TValue>) => void | Promise<void>;
+    }>;
+}
+export interface StoredContributionEntry<TValue = unknown> extends ContributionEntry<TValue> {
+    ownerToken: symbol;
+}
+export interface StoredLifecycleDefinition<TData = unknown> {
+    owner: string;
+    ownerToken: symbol;
+    definition: LifecycleEventDefinition<TData>;
+}
+export interface StoredLifecycleRegistration<TData = unknown> {
+    id: string;
+    owner: string;
+    ownerToken: symbol;
+    kind: LifecycleRegistrationKind;
+    sequence: number;
+    handler: LifecycleObserveHandler<TData> | LifecycleTransformHandler<TData> | LifecycleExecuteHandler<TData> | LifecycleAfterCommitHandler<TData>;
+    delivery: LifecycleDeliverySnapshot;
+    queue?: LifecycleDeliveryQueue<QueuedLifecycleDelivery<TData>>;
+}
+export interface QueuedLifecycleDelivery<TData> {
+    readonly event: LifecycleEvent<TData>;
+    readonly signal?: AbortSignal;
+}
+export interface StoredState {
+    value: PluginConfigValue;
+    revision: number;
+}
+export interface StateWatcher {
+    owner: string;
+    ownerToken: symbol;
+    prefix?: string;
+    handler: (change: StateChange) => void;
+}
+/**
+ * Terminal statuses the runtime executor itself can produce. `timed_out` is
+ * excluded: the executor has no watchdog — a caller-imposed deadline aborts
+ * through cancel() and settles cancelled, while a host-declared timed_out
+ * enters only through the public contract's complete() path (D-043).
+ */
+export type OperationTerminalStatus = Exclude<OperationStatus, "queued" | "running" | "timed_out">;
+export interface CapabilityRuntime {
+    readonly host: HostCapabilities;
+    resolvePluginCapabilityOrder(manifests: readonly PluginManifest[]): readonly PluginManifest[];
+    createAPI(manifest: PluginManifest): CapabilityAPI;
+    revokeAPI(api: CapabilityAPI): void;
+    /** Revoke every API produced by this runtime, including direct host-created APIs. */
+    revokeAllAPIs(): void;
+    /** Revoke APIs and await disposal of every registration owned by this runtime. */
+    disposeAll(): Promise<void>;
+    disposePlugin(id: string): Promise<void>;
+    /** Synchronous cleanup for synchronous bootstrap factories only. */
+    disposePluginSync(id: string): void;
+    listTools(): readonly {
+        name: string;
+        definition: unknown;
+        source: string;
+        readonlySafe: boolean;
+    }[];
+    listCommands(): readonly {
+        definition: CapabilityCommandDefinition;
+        source: string;
+    }[];
+    listSkills(): readonly {
+        definition: SkillDefinition;
+        source: string;
+    }[];
+    listContributionPoints(): readonly {
+        id: string;
+        version: number;
+        schema: string;
+        lifecycle: ContributionLifecycle;
+        owner: string;
+    }[];
+    listContributions(pointId: string, version: number): readonly ContributionEntry[];
+    hasLifecycleEvent(id: string, version: number): boolean;
+    dispatchLifecycle<TData>(request: LifecycleDispatchRequest<TData>): Promise<LifecycleDispatchResult<TData>>;
+    /**
+     * Record one startup plugin rejection (D-028): the rejection stays visible in
+     * the inspector snapshot and, when defined, as a plugin.rejected@1 lifecycle
+     * fact. Recording must never fail the remaining startup path.
+     */
+    recordPluginRejection(rejection: PluginRejection): Promise<void>;
+    listPluginCapabilities(options?: {
+        kind?: PluginCapabilityDeclaration["kind"];
+    }): readonly {
+        declaration: PluginCapabilityDeclaration;
+        owner: string;
+    }[];
+    validateExecutionFacts(facts: unknown): ExecutionFactsV1;
+    validateRetrySchedule(schedule: unknown): RetryScheduleV1;
+    hasRetryPolicy(name: string): boolean;
+    classifyRetry(name: string, request: RetryClassificationRequest): Promise<boolean>;
+    decideRetry(name: string, request: RetryPolicyRequest): Promise<RetryPolicyDecision>;
+    hasCompactionPolicy(name: string): boolean;
+    decideCompaction(name: string, request: CompactionPolicyRequest): Promise<CompactionPolicyDecision>;
+    prepareCompaction(name: string, request: CompactionPreparationRequest): Promise<unknown | undefined>;
+    summarizeCompaction(name: string, request: CompactionSummaryRequest): Promise<CompactionSummaryResult>;
+    hasOverflowPolicy(name: string): boolean;
+    decideOverflow(name: string, request: OverflowPolicyRequest): Promise<OverflowPolicyDecision>;
+    hasBranchSummaryPolicy(name: string): boolean;
+    summarizeBranch(name: string, request: Parameters<BranchSummaryPolicy["summarize"]>[0]): Promise<BranchSummaryResult>;
+    /** Ordered loop-hook links for one position, filtered by active owners, in registration order. */
+    getLoopHookChain<P extends AgentLoopHookPositionV1>(position: P): readonly AgentLoopHookForV1<P>[];
+    hasRunLoopStrategy(name: string): boolean;
+    decideRunLoop(name: string, request: AgentRunLoopStrategyRequestV1): Promise<AgentRunLoopStrategyDecisionV1>;
+    invokeTool(name: string, input: unknown, options?: {
+        readonly signal?: AbortSignal;
+    }): Promise<unknown>;
+    hasCommand(name: string): boolean;
+    invokeCommand(name: string, args: string, options?: CapabilityCommandContext): Promise<CapabilityCommandResult | undefined>;
+    hasRpcMethod(name: string): boolean;
+    dispatchRpc(name: string, input: unknown): Promise<unknown>;
+    hasContextStrategy(name: string): boolean;
+    transformContext(name: string, context: unknown, options?: ContextOperationOptions): Promise<unknown>;
+    snapshotContext(name: string, context: unknown, options?: ContextOperationOptions): Promise<unknown>;
+    restoreContext(name: string, snapshot: unknown, options?: ContextOperationOptions): Promise<unknown>;
+    replaceContext(name: string, context: unknown, options?: ContextOperationOptions): Promise<unknown>;
+    transformProviderHeaders(request: ProviderHeaderTransformRequest): Promise<Record<string, string | null>>;
+    getOperationStatus(id: string): OperationStatus | undefined;
+    drainLifecycleDeliveries(): Promise<void>;
+    inspect(): RuntimeInspectorSnapshot;
+}
+/**
+ * Mutable state container shared by the capability runtime entry, the lifecycle
+ * dispatch module, and the runtime inspector. Field order is irrelevant; every
+ * map, set, and array is created once per runtime and mutated in place.
+ */
+export interface CapabilityRuntimeState {
+    readonly tools: Map<string, RegisteredCapability<unknown>>;
+    readonly skills: Map<string, RegisteredCapability<SkillDefinition>>;
+    readonly retryPolicies: Map<string, RegisteredCapability<RetryPolicy>>;
+    readonly compactionPolicies: Map<string, RegisteredCapability<CompactionPolicy>>;
+    readonly overflowPolicies: Map<string, RegisteredCapability<OverflowPolicy>>;
+    readonly branchSummaryPolicies: Map<string, RegisteredCapability<BranchSummaryPolicy>>;
+    readonly runLoopStrategies: Map<string, RegisteredCapability<AgentRunLoopStrategyV1>>;
+    readonly loopHooks: Map<AgentLoopHookPositionV1, RegisteredCapability<AgentLoopHookHandlerV1>[]>;
+    readonly commands: Map<string, RegisteredCapability<CapabilityCommandDefinition>>;
+    readonly operations: Map<string, RegisteredCapability<OperationHandler>>;
+    readonly rpcMethods: Map<string, RegisteredCapability<(input: unknown) => unknown | Promise<unknown>>>;
+    readonly contextStrategies: Map<string, RegisteredCapability<ContextStrategy>>;
+    readonly pluginCapabilities: Map<string, RegisteredPluginCapability>;
+    readonly providerHeaderTransforms: Map<string, RegisteredCapability<ProviderHeaderTransform>>;
+    readonly contributionPoints: Map<string, StoredContributionPoint<unknown>>;
+    readonly lifecycleDefinitions: Map<string, StoredLifecycleDefinition>;
+    readonly lifecycleRegistrations: Map<string, Map<string, StoredLifecycleRegistration>>;
+    readonly subscribers: Map<string, Map<string, RegisteredCapability<(event: EventEnvelope) => void | Promise<void>>>>;
+    readonly statuses: Map<string, OperationStatus>;
+    readonly activeOperationsByOwnerToken: Map<symbol, Set<OperationHandle<unknown>>>;
+    readonly pluginRegistrations: Map<string, Set<DisposableRegistration>>;
+    readonly apiStates: Map<CapabilityAPI, APIState>;
+    readonly activeOwnerTokens: Set<symbol>;
+    readonly outputArtifacts: Map<string, StoredOutputArtifact>;
+    readonly stateByOwner: Map<string, Map<string, StoredState>>;
+    readonly stateRevisionsByOwner: Map<string, Map<string, number>>;
+    readonly stateWatchers: Map<string, Map<string, StateWatcher>>;
+    /** Instance-private state namespaces keyed by owner, then instance id; cleared on instance disposal. */
+    readonly stateByInstance: Map<string, Map<string, Map<string, StoredState>>>;
+    readonly stateRevisionsByInstance: Map<string, Map<string, Map<string, number>>>;
+    readonly stateWatchersByInstance: Map<string, Map<string, Map<string, StateWatcher>>>;
+    readonly logs: LoggerRecord[];
+    readonly spans: Map<string, DiagnosticsSpanSnapshot>;
+    readonly lifecycleReports: RuntimeInspectorLifecycleDeliveryReportSnapshot[];
+    readonly lifecycleDeliveryQueues: Set<LifecycleDeliveryQueue<QueuedLifecycleDelivery<unknown>>>;
+    readonly pluginRejections: PluginRejection[];
+    /** Lifecycle event sequence; incremented by both the runtime entry and the dispatch module. */
+    eventSequence: number;
+}
+//# sourceMappingURL=capability-runtime-types.d.ts.map

package/dist/core/extensions/capability-runtime-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-runtime-types.d.ts","sourceRoot":"","sources":["../../../src/core/extensions/capability-runtime-types.ts"],"names":[],"mappings":"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","sourcesContent":["import type { DurableServiceV1 } from \"../../durable/durable-service.ts\";\nimport type { ObservabilityHostAdapterV1, TraceSinkOptionsV1 } from \"../../plugins/observability-types.ts\";\nimport type { LifecycleDeliveryQueue } from \"./lifecycle-delivery-queue.ts\";\nimport type {\n\tAgentCompositionAPI,\n\tAgentDefinition,\n\tAgentInstance,\n\tAgentLoopHookForV1,\n\tAgentLoopHookHandlerV1,\n\tAgentLoopHookPositionV1,\n\tAgentModelInvocationResultV1,\n\tAgentRunLoopStrategyDecisionV1,\n\tAgentRunLoopStrategyRequestV1,\n\tAgentRunLoopStrategyV1,\n\tAgentTaskAdapter,\n\tAgentTaskSessionSummaryV1,\n\tAgentTaskSessionViewV1,\n\tBranchSummaryPolicy,\n\tBranchSummaryResult,\n\tCapabilityAPI,\n\tCapabilityCommandContext,\n\tCapabilityCommandDefinition,\n\tCapabilityCommandResult,\n\tCapabilityProviderHandler,\n\tCapabilityToolContext,\n\tCompactionPolicy,\n\tCompactionPolicyDecision,\n\tCompactionPolicyRequest,\n\tCompactionPreparationRequest,\n\tCompactionSummaryRequest,\n\tCompactionSummaryResult,\n\tContextOperationOptions,\n\tContextStrategy,\n\tContributionChangeEvent,\n\tContributionEntry,\n\tContributionLifecycle,\n\tContributionPointDefinition,\n\tCredentialAPI,\n\tDiagnosticsSpanSnapshot,\n\tDisposableRegistration,\n\tEventEnvelope,\n\tExecutionFactsV1,\n\tHostCapabilities,\n\tInteractionHostV1,\n\tLifecycleAfterCommitHandler,\n\tLifecycleDeliverySnapshot,\n\tLifecycleDispatchRequest,\n\tLifecycleDispatchResult,\n\tLifecycleEvent,\n\tLifecycleEventDefinition,\n\tLifecycleExecuteHandler,\n\tLifecycleObserveHandler,\n\tLifecycleRegistrationKind,\n\tLifecycleTransformHandler,\n\tLoggerRecord,\n\tOperationExecutionContext,\n\tOperationHandle,\n\tOperationStatus,\n\tOutputArtifactRef,\n\tOverflowPolicy,\n\tOverflowPolicyDecision,\n\tOverflowPolicyRequest,\n\tPluginCapabilityDeclaration,\n\tPluginConfigValue,\n\tPluginManifest,\n\tPluginRejection,\n\tProviderHeaderTransform,\n\tProviderHeaderTransformRequest,\n\tRetryClassificationRequest,\n\tRetryPolicy,\n\tRetryPolicyDecision,\n\tRetryPolicyRequest,\n\tRetryScheduleV1,\n\tRuntimeInspectorLifecycleDeliveryReportSnapshot,\n\tRuntimeInspectorSnapshot,\n\tSessionAPI,\n\tSkillDefinition,\n\tStateChange,\n} from \"./public-api.ts\";\n\n/** Host trace service injection (D-075 S4 second batch observability host contract). */\nexport interface TraceServiceV1 {\n\treadonly adapter: ObservabilityHostAdapterV1;\n\treadonly options?: TraceSinkOptionsV1;\n}\n\nexport type OperationHandler = (input: unknown, context: OperationExecutionContext) => unknown | Promise<unknown>;\n\nexport interface CapabilityRuntimeOptions {\n\tclock?: () => number;\n\t/** Test-only override for generated runtime identifiers; omitted in production. */\n\tidFactory?: (kind: string, sequence: number) => string;\n\t/** Test-only observer for every lifecycle dispatch, including detached runtime facts. */\n\tonLifecycleDispatch?: (\n\t\trequest: LifecycleDispatchRequest<unknown>,\n\t\tsettled: Promise<LifecycleDispatchResult<unknown>>,\n\t) => void;\n\t/** Observes each committed output artifact; host adapters may mirror it into durable storage. The runtime stays storage-agnostic. */\n\tonOutputArtifactCommit?: (artifact: { readonly ref: OutputArtifactRef; readonly bytes: Uint8Array }) => void;\n\t/**\n\t * 运行时工具表变更钩子：工具表发生任何变更（注册、同名替换、卸载、替换链恢复，\n\t * 以及插件装卸引发的表变更）后同步调用一次。缺省不传 = 行为不变；回调异常经\n\t * 运行时既有错误通道记录，不打断注册本身。\n\t */\n\tonToolRegistryChange?: () => void;\n\t/**\n\t * 运行时 invoke 面传给工具 execute 的第二参上下文（additive；现有单参工具不受\n\t * 影响）。宿主注入后，经 runtime.invokeTool 调用的工具收到 `{ cwd }`（与会话\n\t * cwd 同源，对应命令面 CapabilityCommandContext.cwd）；未注入时第二参保持 undefined。\n\t */\n\ttoolExecutionContext?: CapabilityToolContext;\n\t/**\n\t * 插件日志记录宿主转发通道（会话轨迹 plugin.log 镜像，设计 §5.3/§7.2）：每条\n\t * 经 LoggerAPI 写入并通过校验的记录在入运行时内存环后同步转发一次。回调契约：\n\t * 回调内不得调用 LoggerAPI（防自递归）；回调抛错由运行时直接吞掉，不打断\n\t * 调用方，也绝不经 recordLog 再记录。缺省不传 = 行为不变。\n\t */\n\tonLogRecord?: (record: LoggerRecord) => void;\n\tsession?: SessionAPI;\n\tagents?: AgentTaskAdapter;\n\t/**\n\t * 会话回读器（D-060 S2/S3）：宿主注入后 `api.agents.session(sessionId)` 才存在。\n\t * 作用域（只放行本会话的子会话）由宿主在读取器内部强制；内核不做假设。\n\t */\n\tagentSessionReader?: (sessionId: string) => Promise<AgentTaskSessionViewV1 | undefined>;\n\t/**\n\t * 列出宿主会话**自己的**子代理会话摘要（按最近活动倒序，D-060 模型面盘点通道）。\n\t * 注入后 `agents.list()` 才存在；作用域由宿主强制（宿主只回自己会话的子会话）。\n\t */\n\tagentSessionLister?: () => Promise<AgentTaskSessionSummaryV1[]>;\n\t/**\n\t * Durable replay channel for agent task terminal outcomes. When present,\n\t * every settle persists a frozen record under the deterministic artifact id\n\t * `agent-task:<taskId>`; `api.agents.result(taskId)` reads it back across\n\t * runtime rebuilds. The host owns the writer claim lifecycle: the writer\n\t * must have claimed on the store before the first settle, or persist fails\n\t * loudly with the store's `not_writer` error.\n\t */\n\tagentResults?: {\n\t\treadonly store: DurableServiceV1;\n\t\treadonly writerId: string;\n\t};\n\tcredentials?: CredentialAPI;\n\tinteraction?: InteractionHostV1;\n\tcomposition?: AgentCompositionAPI;\n\t/** Host-provided model runtime for agent-composition model/tool facades. */\n\tmodelRuntime?: {\n\t\t/** Provider-agnostic facts about the current session model. */\n\t\tgetModelFacts():\n\t\t\t| { provider: string; id: string; contextWindow: number; maxTokens: number; reasoning: boolean }\n\t\t\t| undefined;\n\t\t/** Single-shot model invocation. The host resolves model, auth, transport and cache routing. */\n\t\tinvoke: (\n\t\t\tinput: { systemPrompt?: string; prompt: string; maxTokens?: number; thinkingLevel?: string },\n\t\t\toptions?: { signal?: AbortSignal },\n\t\t) => Promise<AgentModelInvocationResultV1>;\n\t};\n\t/**\n\t * Parent-session cancel fence (D-044 §4.2). Consulted once per agent-task\n\t * creation: the returned signal (when present) cancels that task if it fires,\n\t * or immediately cancels tasks created after it already fired. The host\n\t * refreshes the fence epoch so tasks submitted after an aborted turn bind to\n\t * the next signal instead of an already-spent one. Absent = no cascade.\n\t */\n\tparentSignal?: () => AbortSignal | undefined;\n\t/**\n\t * Host trace service (D-075 S4 second batch): injected on hosts running\n\t * session trace collection. Exposed to plugins as `api.trace` (the\n\t * adapter) plus `api.traceSinkOptions`; absent = plugins see neither and\n\t * stay trace-free.\n\t */\n\ttrace?: TraceServiceV1;\n}\n\nexport interface RegisteredCapability<T> {\n\towner: string;\n\townerToken: symbol;\n\tvalue: T;\n}\n\nexport interface RegisteredPluginCapability {\n\tdeclaration: PluginCapabilityDeclaration;\n\towner: string;\n\townerToken: symbol;\n\thandler: CapabilityProviderHandler;\n}\n\nexport interface APIState {\n\tactive: boolean;\n\towner: string;\n\townerToken: symbol;\n\tcompositionInstances?: Set<AgentInstance>;\n\tcompositionDefinitions?: Set<AgentDefinition>;\n}\n\nexport interface StoredOutputArtifact {\n\tref: OutputArtifactRef;\n\tbytes: Uint8Array;\n\townerToken: symbol;\n}\n\nexport interface StoredContributionPoint<TValue = unknown> {\n\towner: string;\n\townerToken: symbol;\n\tdefinition: ContributionPointDefinition<TValue>;\n\tentries: Map<string, StoredContributionEntry<TValue>>;\n\tsubscribers: Map<\n\t\tstring,\n\t\t{ ownerToken: symbol; handler: (event: ContributionChangeEvent<TValue>) => void | Promise<void> }\n\t>;\n}\n\nexport interface StoredContributionEntry<TValue = unknown> extends ContributionEntry<TValue> {\n\townerToken: symbol;\n}\n\nexport interface StoredLifecycleDefinition<TData = unknown> {\n\towner: string;\n\townerToken: symbol;\n\tdefinition: LifecycleEventDefinition<TData>;\n}\n\nexport interface StoredLifecycleRegistration<TData = unknown> {\n\tid: string;\n\towner: string;\n\townerToken: symbol;\n\tkind: LifecycleRegistrationKind;\n\tsequence: number;\n\thandler:\n\t\t| LifecycleObserveHandler<TData>\n\t\t| LifecycleTransformHandler<TData>\n\t\t| LifecycleExecuteHandler<TData>\n\t\t| LifecycleAfterCommitHandler<TData>;\n\tdelivery: LifecycleDeliverySnapshot;\n\tqueue?: LifecycleDeliveryQueue<QueuedLifecycleDelivery<TData>>;\n}\n\nexport interface QueuedLifecycleDelivery<TData> {\n\treadonly event: LifecycleEvent<TData>;\n\treadonly signal?: AbortSignal;\n}\n\nexport interface StoredState {\n\tvalue: PluginConfigValue;\n\trevision: number;\n}\n\nexport interface StateWatcher {\n\towner: string;\n\townerToken: symbol;\n\tprefix?: string;\n\thandler: (change: StateChange) => void;\n}\n\n/**\n * Terminal statuses the runtime executor itself can produce. `timed_out` is\n * excluded: the executor has no watchdog — a caller-imposed deadline aborts\n * through cancel() and settles cancelled, while a host-declared timed_out\n * enters only through the public contract's complete() path (D-043).\n */\nexport type OperationTerminalStatus = Exclude<OperationStatus, \"queued\" | \"running\" | \"timed_out\">;\n\nexport interface CapabilityRuntime {\n\treadonly host: HostCapabilities;\n\tresolvePluginCapabilityOrder(manifests: readonly PluginManifest[]): readonly PluginManifest[];\n\tcreateAPI(manifest: PluginManifest): CapabilityAPI;\n\trevokeAPI(api: CapabilityAPI): void;\n\t/** Revoke every API produced by this runtime, including direct host-created APIs. */\n\trevokeAllAPIs(): void;\n\t/** Revoke APIs and await disposal of every registration owned by this runtime. */\n\tdisposeAll(): Promise<void>;\n\tdisposePlugin(id: string): Promise<void>;\n\t/** Synchronous cleanup for synchronous bootstrap factories only. */\n\tdisposePluginSync(id: string): void;\n\tlistTools(): readonly { name: string; definition: unknown; source: string; readonlySafe: boolean }[];\n\tlistCommands(): readonly { definition: CapabilityCommandDefinition; source: string }[];\n\tlistSkills(): readonly { definition: SkillDefinition; source: string }[];\n\tlistContributionPoints(): readonly {\n\t\tid: string;\n\t\tversion: number;\n\t\tschema: string;\n\t\tlifecycle: ContributionLifecycle;\n\t\towner: string;\n\t}[];\n\tlistContributions(pointId: string, version: number): readonly ContributionEntry[];\n\thasLifecycleEvent(id: string, version: number): boolean;\n\tdispatchLifecycle<TData>(request: LifecycleDispatchRequest<TData>): Promise<LifecycleDispatchResult<TData>>;\n\t/**\n\t * Record one startup plugin rejection (D-028): the rejection stays visible in\n\t * the inspector snapshot and, when defined, as a plugin.rejected@1 lifecycle\n\t * fact. Recording must never fail the remaining startup path.\n\t */\n\trecordPluginRejection(rejection: PluginRejection): Promise<void>;\n\tlistPluginCapabilities(options?: { kind?: PluginCapabilityDeclaration[\"kind\"] }): readonly {\n\t\tdeclaration: PluginCapabilityDeclaration;\n\t\towner: string;\n\t}[];\n\tvalidateExecutionFacts(facts: unknown): ExecutionFactsV1;\n\tvalidateRetrySchedule(schedule: unknown): RetryScheduleV1;\n\thasRetryPolicy(name: string): boolean;\n\tclassifyRetry(name: string, request: RetryClassificationRequest): Promise<boolean>;\n\tdecideRetry(name: string, request: RetryPolicyRequest): Promise<RetryPolicyDecision>;\n\thasCompactionPolicy(name: string): boolean;\n\tdecideCompaction(name: string, request: CompactionPolicyRequest): Promise<CompactionPolicyDecision>;\n\tprepareCompaction(name: string, request: CompactionPreparationRequest): Promise<unknown | undefined>;\n\tsummarizeCompaction(name: string, request: CompactionSummaryRequest): Promise<CompactionSummaryResult>;\n\thasOverflowPolicy(name: string): boolean;\n\tdecideOverflow(name: string, request: OverflowPolicyRequest): Promise<OverflowPolicyDecision>;\n\thasBranchSummaryPolicy(name: string): boolean;\n\tsummarizeBranch(\n\t\tname: string,\n\t\trequest: Parameters<BranchSummaryPolicy[\"summarize\"]>[0],\n\t): Promise<BranchSummaryResult>;\n\t/** Ordered loop-hook links for one position, filtered by active owners, in registration order. */\n\tgetLoopHookChain<P extends AgentLoopHookPositionV1>(position: P): readonly AgentLoopHookForV1<P>[];\n\thasRunLoopStrategy(name: string): boolean;\n\tdecideRunLoop(name: string, request: AgentRunLoopStrategyRequestV1): Promise<AgentRunLoopStrategyDecisionV1>;\n\tinvokeTool(name: string, input: unknown, options?: { readonly signal?: AbortSignal }): Promise<unknown>;\n\thasCommand(name: string): boolean;\n\tinvokeCommand(\n\t\tname: string,\n\t\targs: string,\n\t\toptions?: CapabilityCommandContext,\n\t): Promise<CapabilityCommandResult | undefined>;\n\thasRpcMethod(name: string): boolean;\n\tdispatchRpc(name: string, input: unknown): Promise<unknown>;\n\thasContextStrategy(name: string): boolean;\n\ttransformContext(name: string, context: unknown, options?: ContextOperationOptions): Promise<unknown>;\n\tsnapshotContext(name: string, context: unknown, options?: ContextOperationOptions): Promise<unknown>;\n\trestoreContext(name: string, snapshot: unknown, options?: ContextOperationOptions): Promise<unknown>;\n\treplaceContext(name: string, context: unknown, options?: ContextOperationOptions): Promise<unknown>;\n\ttransformProviderHeaders(request: ProviderHeaderTransformRequest): Promise<Record<string, string | null>>;\n\tgetOperationStatus(id: string): OperationStatus | undefined;\n\tdrainLifecycleDeliveries(): Promise<void>;\n\tinspect(): RuntimeInspectorSnapshot;\n}\n\n/**\n * Mutable state container shared by the capability runtime entry, the lifecycle\n * dispatch module, and the runtime inspector. Field order is irrelevant; every\n * map, set, and array is created once per runtime and mutated in place.\n */\nexport interface CapabilityRuntimeState {\n\treadonly tools: Map<string, RegisteredCapability<unknown>>;\n\treadonly skills: Map<string, RegisteredCapability<SkillDefinition>>;\n\treadonly retryPolicies: Map<string, RegisteredCapability<RetryPolicy>>;\n\treadonly compactionPolicies: Map<string, RegisteredCapability<CompactionPolicy>>;\n\treadonly overflowPolicies: Map<string, RegisteredCapability<OverflowPolicy>>;\n\treadonly branchSummaryPolicies: Map<string, RegisteredCapability<BranchSummaryPolicy>>;\n\treadonly runLoopStrategies: Map<string, RegisteredCapability<AgentRunLoopStrategyV1>>;\n\treadonly loopHooks: Map<AgentLoopHookPositionV1, RegisteredCapability<AgentLoopHookHandlerV1>[]>;\n\treadonly commands: Map<string, RegisteredCapability<CapabilityCommandDefinition>>;\n\treadonly operations: Map<string, RegisteredCapability<OperationHandler>>;\n\treadonly rpcMethods: Map<string, RegisteredCapability<(input: unknown) => unknown | Promise<unknown>>>;\n\treadonly contextStrategies: Map<string, RegisteredCapability<ContextStrategy>>;\n\treadonly pluginCapabilities: Map<string, RegisteredPluginCapability>;\n\treadonly providerHeaderTransforms: Map<string, RegisteredCapability<ProviderHeaderTransform>>;\n\treadonly contributionPoints: Map<string, StoredContributionPoint<unknown>>;\n\treadonly lifecycleDefinitions: Map<string, StoredLifecycleDefinition>;\n\treadonly lifecycleRegistrations: Map<string, Map<string, StoredLifecycleRegistration>>;\n\treadonly subscribers: Map<string, Map<string, RegisteredCapability<(event: EventEnvelope) => void | Promise<void>>>>;\n\treadonly statuses: Map<string, OperationStatus>;\n\treadonly activeOperationsByOwnerToken: Map<symbol, Set<OperationHandle<unknown>>>;\n\treadonly pluginRegistrations: Map<string, Set<DisposableRegistration>>;\n\treadonly apiStates: Map<CapabilityAPI, APIState>;\n\treadonly activeOwnerTokens: Set<symbol>;\n\treadonly outputArtifacts: Map<string, StoredOutputArtifact>;\n\treadonly stateByOwner: Map<string, Map<string, StoredState>>;\n\treadonly stateRevisionsByOwner: Map<string, Map<string, number>>;\n\treadonly stateWatchers: Map<string, Map<string, StateWatcher>>;\n\t/** Instance-private state namespaces keyed by owner, then instance id; cleared on instance disposal. */\n\treadonly stateByInstance: Map<string, Map<string, Map<string, StoredState>>>;\n\treadonly stateRevisionsByInstance: Map<string, Map<string, Map<string, number>>>;\n\treadonly stateWatchersByInstance: Map<string, Map<string, Map<string, StateWatcher>>>;\n\treadonly logs: LoggerRecord[];\n\treadonly spans: Map<string, DiagnosticsSpanSnapshot>;\n\treadonly lifecycleReports: RuntimeInspectorLifecycleDeliveryReportSnapshot[];\n\treadonly lifecycleDeliveryQueues: Set<LifecycleDeliveryQueue<QueuedLifecycleDelivery<unknown>>>;\n\treadonly pluginRejections: PluginRejection[];\n\t/** Lifecycle event sequence; incremented by both the runtime entry and the dispatch module. */\n\teventSequence: number;\n}\n"]}

package/dist/core/extensions/capability-runtime-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=capability-runtime-types.js.map

package/dist/core/extensions/capability-runtime-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-runtime-types.js","sourceRoot":"","sources":["../../../src/core/extensions/capability-runtime-types.ts"],"names":[],"mappings":"","sourcesContent":["import type { DurableServiceV1 } from \"../../durable/durable-service.ts\";\nimport type { ObservabilityHostAdapterV1, TraceSinkOptionsV1 } from \"../../plugins/observability-types.ts\";\nimport type { LifecycleDeliveryQueue } from \"./lifecycle-delivery-queue.ts\";\nimport type {\n\tAgentCompositionAPI,\n\tAgentDefinition,\n\tAgentInstance,\n\tAgentLoopHookForV1,\n\tAgentLoopHookHandlerV1,\n\tAgentLoopHookPositionV1,\n\tAgentModelInvocationResultV1,\n\tAgentRunLoopStrategyDecisionV1,\n\tAgentRunLoopStrategyRequestV1,\n\tAgentRunLoopStrategyV1,\n\tAgentTaskAdapter,\n\tAgentTaskSessionSummaryV1,\n\tAgentTaskSessionViewV1,\n\tBranchSummaryPolicy,\n\tBranchSummaryResult,\n\tCapabilityAPI,\n\tCapabilityCommandContext,\n\tCapabilityCommandDefinition,\n\tCapabilityCommandResult,\n\tCapabilityProviderHandler,\n\tCapabilityToolContext,\n\tCompactionPolicy,\n\tCompactionPolicyDecision,\n\tCompactionPolicyRequest,\n\tCompactionPreparationRequest,\n\tCompactionSummaryRequest,\n\tCompactionSummaryResult,\n\tContextOperationOptions,\n\tContextStrategy,\n\tContributionChangeEvent,\n\tContributionEntry,\n\tContributionLifecycle,\n\tContributionPointDefinition,\n\tCredentialAPI,\n\tDiagnosticsSpanSnapshot,\n\tDisposableRegistration,\n\tEventEnvelope,\n\tExecutionFactsV1,\n\tHostCapabilities,\n\tInteractionHostV1,\n\tLifecycleAfterCommitHandler,\n\tLifecycleDeliverySnapshot,\n\tLifecycleDispatchRequest,\n\tLifecycleDispatchResult,\n\tLifecycleEvent,\n\tLifecycleEventDefinition,\n\tLifecycleExecuteHandler,\n\tLifecycleObserveHandler,\n\tLifecycleRegistrationKind,\n\tLifecycleTransformHandler,\n\tLoggerRecord,\n\tOperationExecutionContext,\n\tOperationHandle,\n\tOperationStatus,\n\tOutputArtifactRef,\n\tOverflowPolicy,\n\tOverflowPolicyDecision,\n\tOverflowPolicyRequest,\n\tPluginCapabilityDeclaration,\n\tPluginConfigValue,\n\tPluginManifest,\n\tPluginRejection,\n\tProviderHeaderTransform,\n\tProviderHeaderTransformRequest,\n\tRetryClassificationRequest,\n\tRetryPolicy,\n\tRetryPolicyDecision,\n\tRetryPolicyRequest,\n\tRetryScheduleV1,\n\tRuntimeInspectorLifecycleDeliveryReportSnapshot,\n\tRuntimeInspectorSnapshot,\n\tSessionAPI,\n\tSkillDefinition,\n\tStateChange,\n} from \"./public-api.ts\";\n\n/** Host trace service injection (D-075 S4 second batch observability host contract). */\nexport interface TraceServiceV1 {\n\treadonly adapter: ObservabilityHostAdapterV1;\n\treadonly options?: TraceSinkOptionsV1;\n}\n\nexport type OperationHandler = (input: unknown, context: OperationExecutionContext) => unknown | Promise<unknown>;\n\nexport interface CapabilityRuntimeOptions {\n\tclock?: () => number;\n\t/** Test-only override for generated runtime identifiers; omitted in production. */\n\tidFactory?: (kind: string, sequence: number) => string;\n\t/** Test-only observer for every lifecycle dispatch, including detached runtime facts. */\n\tonLifecycleDispatch?: (\n\t\trequest: LifecycleDispatchRequest<unknown>,\n\t\tsettled: Promise<LifecycleDispatchResult<unknown>>,\n\t) => void;\n\t/** Observes each committed output artifact; host adapters may mirror it into durable storage. The runtime stays storage-agnostic. */\n\tonOutputArtifactCommit?: (artifact: { readonly ref: OutputArtifactRef; readonly bytes: Uint8Array }) => void;\n\t/**\n\t * 运行时工具表变更钩子：工具表发生任何变更（注册、同名替换、卸载、替换链恢复，\n\t * 以及插件装卸引发的表变更）后同步调用一次。缺省不传 = 行为不变；回调异常经\n\t * 运行时既有错误通道记录，不打断注册本身。\n\t */\n\tonToolRegistryChange?: () => void;\n\t/**\n\t * 运行时 invoke 面传给工具 execute 的第二参上下文（additive；现有单参工具不受\n\t * 影响）。宿主注入后，经 runtime.invokeTool 调用的工具收到 `{ cwd }`（与会话\n\t * cwd 同源，对应命令面 CapabilityCommandContext.cwd）；未注入时第二参保持 undefined。\n\t */\n\ttoolExecutionContext?: CapabilityToolContext;\n\t/**\n\t * 插件日志记录宿主转发通道（会话轨迹 plugin.log 镜像，设计 §5.3/§7.2）：每条\n\t * 经 LoggerAPI 写入并通过校验的记录在入运行时内存环后同步转发一次。回调契约：\n\t * 回调内不得调用 LoggerAPI（防自递归）；回调抛错由运行时直接吞掉，不打断\n\t * 调用方，也绝不经 recordLog 再记录。缺省不传 = 行为不变。\n\t */\n\tonLogRecord?: (record: LoggerRecord) => void;\n\tsession?: SessionAPI;\n\tagents?: AgentTaskAdapter;\n\t/**\n\t * 会话回读器（D-060 S2/S3）：宿主注入后 `api.agents.session(sessionId)` 才存在。\n\t * 作用域（只放行本会话的子会话）由宿主在读取器内部强制；内核不做假设。\n\t */\n\tagentSessionReader?: (sessionId: string) => Promise<AgentTaskSessionViewV1 | undefined>;\n\t/**\n\t * 列出宿主会话**自己的**子代理会话摘要（按最近活动倒序，D-060 模型面盘点通道）。\n\t * 注入后 `agents.list()` 才存在；作用域由宿主强制（宿主只回自己会话的子会话）。\n\t */\n\tagentSessionLister?: () => Promise<AgentTaskSessionSummaryV1[]>;\n\t/**\n\t * Durable replay channel for agent task terminal outcomes. When present,\n\t * every settle persists a frozen record under the deterministic artifact id\n\t * `agent-task:<taskId>`; `api.agents.result(taskId)` reads it back across\n\t * runtime rebuilds. The host owns the writer claim lifecycle: the writer\n\t * must have claimed on the store before the first settle, or persist fails\n\t * loudly with the store's `not_writer` error.\n\t */\n\tagentResults?: {\n\t\treadonly store: DurableServiceV1;\n\t\treadonly writerId: string;\n\t};\n\tcredentials?: CredentialAPI;\n\tinteraction?: InteractionHostV1;\n\tcomposition?: AgentCompositionAPI;\n\t/** Host-provided model runtime for agent-composition model/tool facades. */\n\tmodelRuntime?: {\n\t\t/** Provider-agnostic facts about the current session model. */\n\t\tgetModelFacts():\n\t\t\t| { provider: string; id: string; contextWindow: number; maxTokens: number; reasoning: boolean }\n\t\t\t| undefined;\n\t\t/** Single-shot model invocation. The host resolves model, auth, transport and cache routing. */\n\t\tinvoke: (\n\t\t\tinput: { systemPrompt?: string; prompt: string; maxTokens?: number; thinkingLevel?: string },\n\t\t\toptions?: { signal?: AbortSignal },\n\t\t) => Promise<AgentModelInvocationResultV1>;\n\t};\n\t/**\n\t * Parent-session cancel fence (D-044 §4.2). Consulted once per agent-task\n\t * creation: the returned signal (when present) cancels that task if it fires,\n\t * or immediately cancels tasks created after it already fired. The host\n\t * refreshes the fence epoch so tasks submitted after an aborted turn bind to\n\t * the next signal instead of an already-spent one. Absent = no cascade.\n\t */\n\tparentSignal?: () => AbortSignal | undefined;\n\t/**\n\t * Host trace service (D-075 S4 second batch): injected on hosts running\n\t * session trace collection. Exposed to plugins as `api.trace` (the\n\t * adapter) plus `api.traceSinkOptions`; absent = plugins see neither and\n\t * stay trace-free.\n\t */\n\ttrace?: TraceServiceV1;\n}\n\nexport interface RegisteredCapability<T> {\n\towner: string;\n\townerToken: symbol;\n\tvalue: T;\n}\n\nexport interface RegisteredPluginCapability {\n\tdeclaration: PluginCapabilityDeclaration;\n\towner: string;\n\townerToken: symbol;\n\thandler: CapabilityProviderHandler;\n}\n\nexport interface APIState {\n\tactive: boolean;\n\towner: string;\n\townerToken: symbol;\n\tcompositionInstances?: Set<AgentInstance>;\n\tcompositionDefinitions?: Set<AgentDefinition>;\n}\n\nexport interface StoredOutputArtifact {\n\tref: OutputArtifactRef;\n\tbytes: Uint8Array;\n\townerToken: symbol;\n}\n\nexport interface StoredContributionPoint<TValue = unknown> {\n\towner: string;\n\townerToken: symbol;\n\tdefinition: ContributionPointDefinition<TValue>;\n\tentries: Map<string, StoredContributionEntry<TValue>>;\n\tsubscribers: Map<\n\t\tstring,\n\t\t{ ownerToken: symbol; handler: (event: ContributionChangeEvent<TValue>) => void | Promise<void> }\n\t>;\n}\n\nexport interface StoredContributionEntry<TValue = unknown> extends ContributionEntry<TValue> {\n\townerToken: symbol;\n}\n\nexport interface StoredLifecycleDefinition<TData = unknown> {\n\towner: string;\n\townerToken: symbol;\n\tdefinition: LifecycleEventDefinition<TData>;\n}\n\nexport interface StoredLifecycleRegistration<TData = unknown> {\n\tid: string;\n\towner: string;\n\townerToken: symbol;\n\tkind: LifecycleRegistrationKind;\n\tsequence: number;\n\thandler:\n\t\t| LifecycleObserveHandler<TData>\n\t\t| LifecycleTransformHandler<TData>\n\t\t| LifecycleExecuteHandler<TData>\n\t\t| LifecycleAfterCommitHandler<TData>;\n\tdelivery: LifecycleDeliverySnapshot;\n\tqueue?: LifecycleDeliveryQueue<QueuedLifecycleDelivery<TData>>;\n}\n\nexport interface QueuedLifecycleDelivery<TData> {\n\treadonly event: LifecycleEvent<TData>;\n\treadonly signal?: AbortSignal;\n}\n\nexport interface StoredState {\n\tvalue: PluginConfigValue;\n\trevision: number;\n}\n\nexport interface StateWatcher {\n\towner: string;\n\townerToken: symbol;\n\tprefix?: string;\n\thandler: (change: StateChange) => void;\n}\n\n/**\n * Terminal statuses the runtime executor itself can produce. `timed_out` is\n * excluded: the executor has no watchdog — a caller-imposed deadline aborts\n * through cancel() and settles cancelled, while a host-declared timed_out\n * enters only through the public contract's complete() path (D-043).\n */\nexport type OperationTerminalStatus = Exclude<OperationStatus, \"queued\" | \"running\" | \"timed_out\">;\n\nexport interface CapabilityRuntime {\n\treadonly host: HostCapabilities;\n\tresolvePluginCapabilityOrder(manifests: readonly PluginManifest[]): readonly PluginManifest[];\n\tcreateAPI(manifest: PluginManifest): CapabilityAPI;\n\trevokeAPI(api: CapabilityAPI): void;\n\t/** Revoke every API produced by this runtime, including direct host-created APIs. */\n\trevokeAllAPIs(): void;\n\t/** Revoke APIs and await disposal of every registration owned by this runtime. */\n\tdisposeAll(): Promise<void>;\n\tdisposePlugin(id: string): Promise<void>;\n\t/** Synchronous cleanup for synchronous bootstrap factories only. */\n\tdisposePluginSync(id: string): void;\n\tlistTools(): readonly { name: string; definition: unknown; source: string; readonlySafe: boolean }[];\n\tlistCommands(): readonly { definition: CapabilityCommandDefinition; source: string }[];\n\tlistSkills(): readonly { definition: SkillDefinition; source: string }[];\n\tlistContributionPoints(): readonly {\n\t\tid: string;\n\t\tversion: number;\n\t\tschema: string;\n\t\tlifecycle: ContributionLifecycle;\n\t\towner: string;\n\t}[];\n\tlistContributions(pointId: string, version: number): readonly ContributionEntry[];\n\thasLifecycleEvent(id: string, version: number): boolean;\n\tdispatchLifecycle<TData>(request: LifecycleDispatchRequest<TData>): Promise<LifecycleDispatchResult<TData>>;\n\t/**\n\t * Record one startup plugin rejection (D-028): the rejection stays visible in\n\t * the inspector snapshot and, when defined, as a plugin.rejected@1 lifecycle\n\t * fact. Recording must never fail the remaining startup path.\n\t */\n\trecordPluginRejection(rejection: PluginRejection): Promise<void>;\n\tlistPluginCapabilities(options?: { kind?: PluginCapabilityDeclaration[\"kind\"] }): readonly {\n\t\tdeclaration: PluginCapabilityDeclaration;\n\t\towner: string;\n\t}[];\n\tvalidateExecutionFacts(facts: unknown): ExecutionFactsV1;\n\tvalidateRetrySchedule(schedule: unknown): RetryScheduleV1;\n\thasRetryPolicy(name: string): boolean;\n\tclassifyRetry(name: string, request: RetryClassificationRequest): Promise<boolean>;\n\tdecideRetry(name: string, request: RetryPolicyRequest): Promise<RetryPolicyDecision>;\n\thasCompactionPolicy(name: string): boolean;\n\tdecideCompaction(name: string, request: CompactionPolicyRequest): Promise<CompactionPolicyDecision>;\n\tprepareCompaction(name: string, request: CompactionPreparationRequest): Promise<unknown | undefined>;\n\tsummarizeCompaction(name: string, request: CompactionSummaryRequest): Promise<CompactionSummaryResult>;\n\thasOverflowPolicy(name: string): boolean;\n\tdecideOverflow(name: string, request: OverflowPolicyRequest): Promise<OverflowPolicyDecision>;\n\thasBranchSummaryPolicy(name: string): boolean;\n\tsummarizeBranch(\n\t\tname: string,\n\t\trequest: Parameters<BranchSummaryPolicy[\"summarize\"]>[0],\n\t): Promise<BranchSummaryResult>;\n\t/** Ordered loop-hook links for one position, filtered by active owners, in registration order. */\n\tgetLoopHookChain<P extends AgentLoopHookPositionV1>(position: P): readonly AgentLoopHookForV1<P>[];\n\thasRunLoopStrategy(name: string): boolean;\n\tdecideRunLoop(name: string, request: AgentRunLoopStrategyRequestV1): Promise<AgentRunLoopStrategyDecisionV1>;\n\tinvokeTool(name: string, input: unknown, options?: { readonly signal?: AbortSignal }): Promise<unknown>;\n\thasCommand(name: string): boolean;\n\tinvokeCommand(\n\t\tname: string,\n\t\targs: string,\n\t\toptions?: CapabilityCommandContext,\n\t): Promise<CapabilityCommandResult | undefined>;\n\thasRpcMethod(name: string): boolean;\n\tdispatchRpc(name: string, input: unknown): Promise<unknown>;\n\thasContextStrategy(name: string): boolean;\n\ttransformContext(name: string, context: unknown, options?: ContextOperationOptions): Promise<unknown>;\n\tsnapshotContext(name: string, context: unknown, options?: ContextOperationOptions): Promise<unknown>;\n\trestoreContext(name: string, snapshot: unknown, options?: ContextOperationOptions): Promise<unknown>;\n\treplaceContext(name: string, context: unknown, options?: ContextOperationOptions): Promise<unknown>;\n\ttransformProviderHeaders(request: ProviderHeaderTransformRequest): Promise<Record<string, string | null>>;\n\tgetOperationStatus(id: string): OperationStatus | undefined;\n\tdrainLifecycleDeliveries(): Promise<void>;\n\tinspect(): RuntimeInspectorSnapshot;\n}\n\n/**\n * Mutable state container shared by the capability runtime entry, the lifecycle\n * dispatch module, and the runtime inspector. Field order is irrelevant; every\n * map, set, and array is created once per runtime and mutated in place.\n */\nexport interface CapabilityRuntimeState {\n\treadonly tools: Map<string, RegisteredCapability<unknown>>;\n\treadonly skills: Map<string, RegisteredCapability<SkillDefinition>>;\n\treadonly retryPolicies: Map<string, RegisteredCapability<RetryPolicy>>;\n\treadonly compactionPolicies: Map<string, RegisteredCapability<CompactionPolicy>>;\n\treadonly overflowPolicies: Map<string, RegisteredCapability<OverflowPolicy>>;\n\treadonly branchSummaryPolicies: Map<string, RegisteredCapability<BranchSummaryPolicy>>;\n\treadonly runLoopStrategies: Map<string, RegisteredCapability<AgentRunLoopStrategyV1>>;\n\treadonly loopHooks: Map<AgentLoopHookPositionV1, RegisteredCapability<AgentLoopHookHandlerV1>[]>;\n\treadonly commands: Map<string, RegisteredCapability<CapabilityCommandDefinition>>;\n\treadonly operations: Map<string, RegisteredCapability<OperationHandler>>;\n\treadonly rpcMethods: Map<string, RegisteredCapability<(input: unknown) => unknown | Promise<unknown>>>;\n\treadonly contextStrategies: Map<string, RegisteredCapability<ContextStrategy>>;\n\treadonly pluginCapabilities: Map<string, RegisteredPluginCapability>;\n\treadonly providerHeaderTransforms: Map<string, RegisteredCapability<ProviderHeaderTransform>>;\n\treadonly contributionPoints: Map<string, StoredContributionPoint<unknown>>;\n\treadonly lifecycleDefinitions: Map<string, StoredLifecycleDefinition>;\n\treadonly lifecycleRegistrations: Map<string, Map<string, StoredLifecycleRegistration>>;\n\treadonly subscribers: Map<string, Map<string, RegisteredCapability<(event: EventEnvelope) => void | Promise<void>>>>;\n\treadonly statuses: Map<string, OperationStatus>;\n\treadonly activeOperationsByOwnerToken: Map<symbol, Set<OperationHandle<unknown>>>;\n\treadonly pluginRegistrations: Map<string, Set<DisposableRegistration>>;\n\treadonly apiStates: Map<CapabilityAPI, APIState>;\n\treadonly activeOwnerTokens: Set<symbol>;\n\treadonly outputArtifacts: Map<string, StoredOutputArtifact>;\n\treadonly stateByOwner: Map<string, Map<string, StoredState>>;\n\treadonly stateRevisionsByOwner: Map<string, Map<string, number>>;\n\treadonly stateWatchers: Map<string, Map<string, StateWatcher>>;\n\t/** Instance-private state namespaces keyed by owner, then instance id; cleared on instance disposal. */\n\treadonly stateByInstance: Map<string, Map<string, Map<string, StoredState>>>;\n\treadonly stateRevisionsByInstance: Map<string, Map<string, Map<string, number>>>;\n\treadonly stateWatchersByInstance: Map<string, Map<string, Map<string, StateWatcher>>>;\n\treadonly logs: LoggerRecord[];\n\treadonly spans: Map<string, DiagnosticsSpanSnapshot>;\n\treadonly lifecycleReports: RuntimeInspectorLifecycleDeliveryReportSnapshot[];\n\treadonly lifecycleDeliveryQueues: Set<LifecycleDeliveryQueue<QueuedLifecycleDelivery<unknown>>>;\n\treadonly pluginRejections: PluginRejection[];\n\t/** Lifecycle event sequence; incremented by both the runtime entry and the dispatch module. */\n\teventSequence: number;\n}\n"]}

package/dist/core/extensions/capability-runtime-validation.d.ts

@@ -0,0 +1,35 @@
+import type { AgentTaskCreateRequest, CapabilityCommandDefinition, CapabilityCommandResult, ContributionPointDefinition, CredentialResolveRequest, ExecutionFactsV1, HostCapabilities, InteractionNotifyLevel, InteractionRequestV1, LifecycleEventDefinition, LifecyclePhase, LifecycleRegistrationKind, RetryScheduleV1 } from "./public-api.ts";
+export declare const lifecyclePhases: Set<LifecyclePhase>;
+export declare const lifecycleRegistrationKinds: Set<LifecycleRegistrationKind>;
+export declare function validateContributionPointDefinition<TValue>(definition: ContributionPointDefinition<TValue>): ContributionPointDefinition<TValue>;
+export declare function contributionPointKey(id: string, version: number): string;
+export declare function lifecycleEventKey(id: string, version: number): string;
+export declare function validateLifecycleEventDefinition<TData>(definition: LifecycleEventDefinition<TData>): LifecycleEventDefinition<TData>;
+export declare function stableTextCompare(left: string, right: string): number;
+export declare function validateCredentialRequest(request: CredentialResolveRequest): void;
+export declare function validateInteractionNotifyRequest(request: {
+    message: string;
+    level?: InteractionNotifyLevel;
+}): void;
+export declare function validateInteractionRequest(request: InteractionRequestV1): void;
+export declare function validateInteractionTimeoutMs(timeoutMs: number | undefined): void;
+/**
+ * Strictly validates host-supplied execution facts and returns an immutable,
+ * detached V1 value. It performs no state lookup and grants no commit right.
+ */
+export declare function validateExecutionFactsV1(value: unknown): ExecutionFactsV1;
+/**
+ * Strictly validates a retry decision bound to one execution boundary. A
+ * scheduled retry is one-based; a stop outcome cannot request a delay.
+ */
+export declare function validateRetryScheduleV1(value: unknown): RetryScheduleV1;
+export declare function assertHost(host: unknown): asserts host is HostCapabilities;
+/** Read the owning plugin's readonly-mode declaration off a tool definition (宪法 §6). */
+export declare function toolReadonlySafe(definition: unknown): boolean;
+export declare function capabilityName(value: unknown, kind: string): string;
+export declare function validateCommandDefinition(definition: CapabilityCommandDefinition): CapabilityCommandDefinition;
+export declare function validateCommandResult(value: unknown, commandName: string): CapabilityCommandResult | undefined;
+export declare function asHandler(value: unknown, kind: string): (...args: unknown[]) => unknown | Promise<unknown>;
+export declare function assertAgentTaskRequest(request: AgentTaskCreateRequest): void;
+export declare function validateProviderHeaders(headers: unknown, source: string): Record<string, string | null>;
+//# sourceMappingURL=capability-runtime-validation.d.ts.map

package/dist/core/extensions/capability-runtime-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-runtime-validation.d.ts","sourceRoot":"","sources":["../../../src/core/extensions/capability-runtime-validation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,sBAAsB,EACtB,2BAA2B,EAC3B,uBAAuB,EAEvB,2BAA2B,EAC3B,wBAAwB,EACxB,gBAAgB,EAEhB,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,cAAc,EACd,yBAAyB,EACzB,eAAe,EAEf,MAAM,iBAAiB,CAAC;AAKzB,eAAO,MAAM,eAAe,qBAA6D,CAAC;AAC1F,eAAO,MAAM,0BAA0B,gCAKrC,CAAC;AAEH,wBAAgB,mCAAmC,CAAC,MAAM,EACzD,UAAU,EAAE,2BAA2B,CAAC,MAAM,CAAC,GAC7C,2BAA2B,CAAC,MAAM,CAAC,CAoBrC;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,wBAAgB,gCAAgC,CAAC,KAAK,EACrD,UAAU,EAAE,wBAAwB,CAAC,KAAK,CAAC,GACzC,wBAAwB,CAAC,KAAK,CAAC,CAwDjC;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAOjF;AAID,wBAAgB,gCAAgC,CAAC,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,sBAAsB,CAAA;CAAE,GAAG,IAAI,CAOnH;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAiC9E;AAED,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAKhF;AA0ED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAoBzE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAsBvE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,IAAI,gBAAgB,CA0B1E;AAED,6FAAwF;AACxF,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAE7D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAKnE;AAED,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,2BAA2B,GAAG,2BAA2B,CAkB9G;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS,CA6B9G;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAU1G;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAO5E;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAYvG","sourcesContent":["import { isPluginConfigValue } from \"./capability-runtime-manifest.ts\";\nimport type {\n\tAgentTaskCreateRequest,\n\tCapabilityCommandDefinition,\n\tCapabilityCommandResult,\n\tContributionLifecycle,\n\tContributionPointDefinition,\n\tCredentialResolveRequest,\n\tExecutionFactsV1,\n\tExecutionPhaseV1,\n\tHostCapabilities,\n\tInteractionNotifyLevel,\n\tInteractionRequestV1,\n\tLifecycleEventDefinition,\n\tLifecyclePhase,\n\tLifecycleRegistrationKind,\n\tRetryScheduleV1,\n\tSessionRevisionV1,\n} from \"./public-api.ts\";\nimport { EXPERIMENTAL_PUBLIC_API_VERSION } from \"./public-api.ts\";\n\nconst contributionLifecycles = new Set<ContributionLifecycle>([\"observe\", \"transform\", \"execute\", \"after-commit\"]);\n\nexport const lifecyclePhases = new Set<LifecyclePhase>([\"raw\", \"candidate\", \"committed\"]);\nexport const lifecycleRegistrationKinds = new Set<LifecycleRegistrationKind>([\n\t\"observe\",\n\t\"transform\",\n\t\"execute\",\n\t\"after-commit\",\n]);\n\nexport function validateContributionPointDefinition<TValue>(\n\tdefinition: ContributionPointDefinition<TValue>,\n): ContributionPointDefinition<TValue> {\n\tif (!definition || typeof definition !== \"object\") {\n\t\tthrow new Error(\"Contribution point definition is required\");\n\t}\n\tif (typeof definition.id !== \"string\" || !definition.id.trim()) {\n\t\tthrow new Error(\"Contribution point requires a non-empty id\");\n\t}\n\tif (!Number.isSafeInteger(definition.version) || definition.version < 1) {\n\t\tthrow new Error(\"Contribution point version must be a positive safe integer\");\n\t}\n\tif (typeof definition.schema !== \"string\" || !definition.schema.trim()) {\n\t\tthrow new Error(\"Contribution point requires a non-empty schema\");\n\t}\n\tif (definition.lifecycle !== undefined && !contributionLifecycles.has(definition.lifecycle)) {\n\t\tthrow new Error(`Contribution point lifecycle is invalid: ${String(definition.lifecycle)}`);\n\t}\n\tif (typeof definition.validate !== \"function\") {\n\t\tthrow new Error(\"Contribution point requires a validate function\");\n\t}\n\treturn definition;\n}\n\nexport function contributionPointKey(id: string, version: number): string {\n\treturn `${id}@${version}`;\n}\n\nexport function lifecycleEventKey(id: string, version: number): string {\n\treturn `${id}@${version}`;\n}\n\nexport function validateLifecycleEventDefinition<TData>(\n\tdefinition: LifecycleEventDefinition<TData>,\n): LifecycleEventDefinition<TData> {\n\tif (!definition || typeof definition !== \"object\") throw new Error(\"Lifecycle event definition is required\");\n\tif (typeof definition.id !== \"string\" || !definition.id.trim()) {\n\t\tthrow new Error(\"Lifecycle event requires a non-empty id\");\n\t}\n\tif (!Number.isSafeInteger(definition.version) || definition.version < 1) {\n\t\tthrow new Error(\"Lifecycle event version must be a positive safe integer\");\n\t}\n\tif (!lifecyclePhases.has(definition.phase)) {\n\t\tthrow new Error(`Lifecycle event phase is invalid: ${String(definition.phase)}`);\n\t}\n\tconst allowedPhases = definition.allowedPhases;\n\tif (\n\t\tallowedPhases !== undefined &&\n\t\t(!Array.isArray(allowedPhases) ||\n\t\t\tallowedPhases.length === 0 ||\n\t\t\tallowedPhases.some((phase) => !lifecyclePhases.has(phase)))\n\t) {\n\t\tthrow new Error(\"Lifecycle event allowedPhases must be a non-empty array of valid phases when provided\");\n\t}\n\tif (allowedPhases && new Set(allowedPhases).size !== allowedPhases.length) {\n\t\tthrow new Error(\"Lifecycle event allowedPhases must not contain duplicates\");\n\t}\n\tif (allowedPhases && !allowedPhases.includes(definition.phase)) {\n\t\tthrow new Error(\"Lifecycle event allowedPhases must include phase\");\n\t}\n\tif (typeof definition.schema !== \"string\" || !definition.schema.trim()) {\n\t\tthrow new Error(\"Lifecycle event requires a non-empty schema\");\n\t}\n\tif (typeof definition.validate !== \"function\") {\n\t\tthrow new Error(\"Lifecycle event requires a validate function\");\n\t}\n\tconst allowedRegistrationKinds = definition.allowedRegistrationKinds;\n\tif (\n\t\tallowedRegistrationKinds !== undefined &&\n\t\t(!Array.isArray(allowedRegistrationKinds) || allowedRegistrationKinds.length === 0)\n\t) {\n\t\tthrow new Error(\"Lifecycle event allowedRegistrationKinds must be a non-empty array when provided\");\n\t}\n\tif (allowedRegistrationKinds?.some((kind) => !lifecycleRegistrationKinds.has(kind))) {\n\t\tthrow new Error(\"Lifecycle event allowedRegistrationKinds contains an invalid registration kind\");\n\t}\n\tif (allowedRegistrationKinds && new Set(allowedRegistrationKinds).size !== allowedRegistrationKinds.length) {\n\t\tthrow new Error(\"Lifecycle event allowedRegistrationKinds must not contain duplicates\");\n\t}\n\treturn Object.freeze({\n\t\tid: definition.id,\n\t\tversion: definition.version,\n\t\tphase: definition.phase,\n\t\t...(allowedPhases === undefined ? {} : { allowedPhases: Object.freeze([...allowedPhases]) }),\n\t\tschema: definition.schema,\n\t\t...(allowedRegistrationKinds === undefined\n\t\t\t? {}\n\t\t\t: { allowedRegistrationKinds: Object.freeze([...allowedRegistrationKinds]) }),\n\t\tvalidate: definition.validate,\n\t});\n}\n\nexport function stableTextCompare(left: string, right: string): number {\n\treturn left < right ? -1 : left > right ? 1 : 0;\n}\n\nexport function validateCredentialRequest(request: CredentialResolveRequest): void {\n\tif (!request || typeof request.providerId !== \"string\" || !request.providerId.trim()) {\n\t\tthrow new Error(\"Credential resolution requires a non-empty providerId\");\n\t}\n\tif (request.minValidityMs !== undefined && (!Number.isFinite(request.minValidityMs) || request.minValidityMs < 0)) {\n\t\tthrow new Error(\"Credential minValidityMs must be a non-negative finite number\");\n\t}\n}\n\nconst INTERACTION_NOTIFY_LEVELS = new Set<InteractionNotifyLevel>([\"info\", \"warning\", \"error\"]);\n\nexport function validateInteractionNotifyRequest(request: { message: string; level?: InteractionNotifyLevel }): void {\n\tif (!request || typeof request !== \"object\" || typeof request.message !== \"string\" || !request.message.trim()) {\n\t\tthrow new Error(\"Interaction notify requires a non-empty message\");\n\t}\n\tif (request.level !== undefined && !INTERACTION_NOTIFY_LEVELS.has(request.level)) {\n\t\tthrow new Error(\"Interaction notify level must be info, warning, or error\");\n\t}\n}\n\nexport function validateInteractionRequest(request: InteractionRequestV1): void {\n\tif (!request || typeof request !== \"object\") {\n\t\tthrow new Error(\"Interaction request must be an object with a known kind\");\n\t}\n\tswitch (request.kind) {\n\t\tcase \"notify\":\n\t\t\tvalidateInteractionNotifyRequest(request);\n\t\t\treturn;\n\t\tcase \"confirm\":\n\t\t\tassertNonEmptyString(request.title, \"Interaction confirm title\");\n\t\t\tassertNonEmptyString(request.message, \"Interaction confirm message\");\n\t\t\treturn;\n\t\tcase \"select\":\n\t\t\tassertNonEmptyString(request.title, \"Interaction select title\");\n\t\t\tif (!Array.isArray(request.options) || request.options.length === 0) {\n\t\t\t\tthrow new Error(\"Interaction select requires a non-empty options array\");\n\t\t\t}\n\t\t\tif (request.options.some((option) => typeof option !== \"string\" || !option.trim())) {\n\t\t\t\tthrow new Error(\"Interaction select options must be non-empty strings\");\n\t\t\t}\n\t\t\treturn;\n\t\tcase \"input\":\n\t\t\tassertNonEmptyString(request.title, \"Interaction input title\");\n\t\t\tif (request.placeholder !== undefined && typeof request.placeholder !== \"string\") {\n\t\t\t\tthrow new Error(\"Interaction input placeholder must be a string\");\n\t\t\t}\n\t\t\tif (request.defaultValue !== undefined && typeof request.defaultValue !== \"string\") {\n\t\t\t\tthrow new Error(\"Interaction input defaultValue must be a string\");\n\t\t\t}\n\t\t\treturn;\n\t\tdefault:\n\t\t\tthrow new Error(\"Interaction request requires a known kind: notify, confirm, select, or input\");\n\t}\n}\n\nexport function validateInteractionTimeoutMs(timeoutMs: number | undefined): void {\n\tif (timeoutMs === undefined) return;\n\tif (!Number.isSafeInteger(timeoutMs) || timeoutMs <= 0) {\n\t\tthrow new Error(\"Interaction timeoutMs must be a positive integer\");\n\t}\n}\n\nconst EXECUTION_FACT_KEYS = [\"version\", \"operationId\", \"sessionId\", \"inputRevision\", \"phase\"] as const;\nconst RETRY_SCHEDULE_KEYS = [...EXECUTION_FACT_KEYS, \"action\", \"attempt\", \"delayMs\"] as const;\nconst executionPhases = new Set<ExecutionPhaseV1>([\n\t\"agent\",\n\t\"compaction\",\n\t\"overflow\",\n\t\"retry\",\n\t\"branch_summary\",\n\t\"reload\",\n\t\"tree\",\n]);\n\nfunction assertPlainRecord(value: unknown, label: string): Record<string, unknown> {\n\tif (\n\t\t!value ||\n\t\ttypeof value !== \"object\" ||\n\t\tArray.isArray(value) ||\n\t\tObject.getPrototypeOf(value) !== Object.prototype\n\t) {\n\t\tthrow new Error(`${label} must be a plain object`);\n\t}\n\treturn value as Record<string, unknown>;\n}\n\nfunction assertExactKeys(value: Record<string, unknown>, keys: readonly string[], label: string): void {\n\tconst allowed = new Set(keys);\n\tconst unexpected = Object.keys(value).filter((key) => !allowed.has(key));\n\tif (unexpected.length > 0) {\n\t\tthrow new Error(`${label} has unsupported fields: ${unexpected.join(\", \")}`);\n\t}\n\tconst missing = keys.filter((key) => !(key in value));\n\tif (missing.length > 0) {\n\t\tthrow new Error(`${label} is missing required fields: ${missing.join(\", \")}`);\n\t}\n}\n\nfunction assertNonEmptyString(value: unknown, label: string): asserts value is string {\n\tif (typeof value !== \"string\" || !value.trim()) throw new Error(`${label} must be a non-empty string`);\n}\n\nfunction assertNonNegativeSafeInteger(value: unknown, label: string): asserts value is number {\n\tif (typeof value !== \"number\" || !Number.isSafeInteger(value) || value < 0) {\n\t\tthrow new Error(`${label} must be a non-negative safe integer`);\n\t}\n}\n\nfunction assertNonNegativeFinite(value: unknown, label: string): asserts value is number {\n\tif (typeof value !== \"number\" || !Number.isFinite(value) || value < 0) {\n\t\tthrow new Error(`${label} must be a non-negative finite number`);\n\t}\n}\n\nfunction validateSessionRevisionV1(value: unknown, label: string): SessionRevisionV1 {\n\tconst revision = assertPlainRecord(value, label);\n\tassertExactKeys(revision, [\"version\", \"sessionId\", \"sequence\", \"leafId\"], label);\n\tif (revision.version !== 1) throw new Error(`${label}.version must be 1`);\n\tassertNonEmptyString(revision.sessionId, `${label}.sessionId`);\n\tassertNonNegativeSafeInteger(revision.sequence, `${label}.sequence`);\n\tif (typeof revision.leafId !== \"string\" && revision.leafId !== null) {\n\t\tthrow new Error(`${label}.leafId must be a string or null`);\n\t}\n\tif (typeof revision.leafId === \"string\" && !revision.leafId.trim()) {\n\t\tthrow new Error(`${label}.leafId must be a non-empty string or null`);\n\t}\n\treturn Object.freeze({\n\t\tversion: 1,\n\t\tsessionId: revision.sessionId,\n\t\tsequence: revision.sequence,\n\t\tleafId: revision.leafId,\n\t});\n}\n\n/**\n * Strictly validates host-supplied execution facts and returns an immutable,\n * detached V1 value. It performs no state lookup and grants no commit right.\n */\nexport function validateExecutionFactsV1(value: unknown): ExecutionFactsV1 {\n\tconst facts = assertPlainRecord(value, \"Execution facts\");\n\tassertExactKeys(facts, EXECUTION_FACT_KEYS, \"Execution facts\");\n\tif (facts.version !== 1) throw new Error(\"Execution facts.version must be 1\");\n\tassertNonEmptyString(facts.operationId, \"Execution facts.operationId\");\n\tassertNonEmptyString(facts.sessionId, \"Execution facts.sessionId\");\n\tif (typeof facts.phase !== \"string\" || !executionPhases.has(facts.phase as ExecutionPhaseV1)) {\n\t\tthrow new Error(\"Execution facts.phase is invalid\");\n\t}\n\tconst inputRevision = validateSessionRevisionV1(facts.inputRevision, \"Execution facts.inputRevision\");\n\tif (inputRevision.sessionId !== facts.sessionId) {\n\t\tthrow new Error(\"Execution facts.inputRevision.sessionId must match Execution facts.sessionId\");\n\t}\n\treturn Object.freeze({\n\t\tversion: 1,\n\t\toperationId: facts.operationId,\n\t\tsessionId: facts.sessionId,\n\t\tinputRevision,\n\t\tphase: facts.phase as ExecutionPhaseV1,\n\t});\n}\n\n/**\n * Strictly validates a retry decision bound to one execution boundary. A\n * scheduled retry is one-based; a stop outcome cannot request a delay.\n */\nexport function validateRetryScheduleV1(value: unknown): RetryScheduleV1 {\n\tconst schedule = assertPlainRecord(value, \"Retry schedule\");\n\tassertExactKeys(schedule, RETRY_SCHEDULE_KEYS, \"Retry schedule\");\n\tconst facts = validateExecutionFactsV1({\n\t\tversion: schedule.version,\n\t\toperationId: schedule.operationId,\n\t\tsessionId: schedule.sessionId,\n\t\tinputRevision: schedule.inputRevision,\n\t\tphase: schedule.phase,\n\t});\n\tif (schedule.action !== \"retry\" && schedule.action !== \"stop\") {\n\t\tthrow new Error(\"Retry schedule.action must be retry or stop\");\n\t}\n\tassertNonNegativeSafeInteger(schedule.attempt, \"Retry schedule.attempt\");\n\tassertNonNegativeFinite(schedule.delayMs, \"Retry schedule.delayMs\");\n\tif (schedule.action === \"retry\" && schedule.attempt === 0) {\n\t\tthrow new Error(\"Retry schedule.retry requires a one-based attempt\");\n\t}\n\tif (schedule.action === \"stop\" && schedule.delayMs !== 0) {\n\t\tthrow new Error(\"Retry schedule.stop must have delayMs 0\");\n\t}\n\treturn Object.freeze({ ...facts, action: schedule.action, attempt: schedule.attempt, delayMs: schedule.delayMs });\n}\n\nexport function assertHost(host: unknown): asserts host is HostCapabilities {\n\tif (!host || typeof host !== \"object\" || Array.isArray(host)) {\n\t\tthrow new Error(\"Host capabilities must be an object\");\n\t}\n\tconst candidate = host as Partial<HostCapabilities>;\n\tif (candidate.apiVersion !== EXPERIMENTAL_PUBLIC_API_VERSION) {\n\t\tthrow new Error(`Unsupported host API version: ${candidate.apiVersion}`);\n\t}\n\tif (candidate.mode !== \"readonly\" && candidate.mode !== \"full-control\") {\n\t\tthrow new Error(\"Host mode must be readonly or full-control\");\n\t}\n\tif (\n\t\t!Array.isArray(candidate.features) ||\n\t\tcandidate.features.some((feature) => typeof feature !== \"string\" || !feature.trim())\n\t) {\n\t\tthrow new Error(\"Host features must be an array of non-empty strings\");\n\t}\n\tif (\n\t\t!Array.isArray(candidate.transports) ||\n\t\tcandidate.transports.some(\n\t\t\t(transport) =>\n\t\t\t\ttransport !== \"in-process\" && transport !== \"stdio\" && transport !== \"http\" && transport !== \"rpc\",\n\t\t)\n\t) {\n\t\tthrow new Error(\"Host transports must be an array of supported transports\");\n\t}\n}\n\n/** Read the owning plugin's readonly-mode declaration off a tool definition (宪法 §6). */\nexport function toolReadonlySafe(definition: unknown): boolean {\n\treturn (definition as { readonlySafe?: unknown } | undefined)?.readonlySafe === true;\n}\n\nexport function capabilityName(value: unknown, kind: string): string {\n\tif (!value || typeof value !== \"object\" || !(\"name\" in value) || typeof value.name !== \"string\" || !value.name) {\n\t\tthrow new Error(`${kind} definition requires a non-empty name`);\n\t}\n\treturn value.name;\n}\n\nexport function validateCommandDefinition(definition: CapabilityCommandDefinition): CapabilityCommandDefinition {\n\tif (!definition || typeof definition !== \"object\") {\n\t\tthrow new Error(\"Command requires a definition\");\n\t}\n\tconst { name, description, argumentHint, execute } = definition;\n\tif (typeof name !== \"string\" || !name || name.startsWith(\"/\") || /\\s/.test(name)) {\n\t\tthrow new Error(\"Command definition requires a non-empty name without slash or whitespace\");\n\t}\n\tif (typeof description !== \"string\" || !description.trim()) {\n\t\tthrow new Error(\"Command definition requires a non-empty description\");\n\t}\n\tif (argumentHint !== undefined && typeof argumentHint !== \"string\") {\n\t\tthrow new Error(\"Command definition argumentHint must be a string\");\n\t}\n\tif (typeof execute !== \"function\") {\n\t\tthrow new Error(\"Command definition requires an execute function\");\n\t}\n\treturn definition;\n}\n\nexport function validateCommandResult(value: unknown, commandName: string): CapabilityCommandResult | undefined {\n\tif (value === undefined) return undefined;\n\tif (!value || typeof value !== \"object\" || Array.isArray(value)) {\n\t\tthrow new Error(`Capability command returned an invalid result: ${commandName}`);\n\t}\n\tconst result = value as Partial<CapabilityCommandResult>;\n\tif (result.status !== \"success\" && result.status !== \"error\") {\n\t\tthrow new Error(`Capability command returned an invalid status: ${commandName}`);\n\t}\n\tif (typeof result.message !== \"string\") {\n\t\tthrow new Error(`Capability command returned an invalid message: ${commandName}`);\n\t}\n\tif (\n\t\tresult.links !== undefined &&\n\t\t(!Array.isArray(result.links) ||\n\t\t\tresult.links.some(\n\t\t\t\t(link) =>\n\t\t\t\t\t!link ||\n\t\t\t\t\ttypeof link !== \"object\" ||\n\t\t\t\t\ttypeof (link as { label?: unknown }).label !== \"string\" ||\n\t\t\t\t\ttypeof (link as { url?: unknown }).url !== \"string\",\n\t\t\t))\n\t) {\n\t\tthrow new Error(`Capability command returned invalid links: ${commandName}`);\n\t}\n\tif (result.data !== undefined && !isPluginConfigValue(result.data)) {\n\t\tthrow new Error(`Capability command returned non-serializable data: ${commandName}`);\n\t}\n\treturn value as CapabilityCommandResult;\n}\n\nexport function asHandler(value: unknown, kind: string): (...args: unknown[]) => unknown | Promise<unknown> {\n\tif (typeof value === \"function\") return value as (...args: unknown[]) => unknown | Promise<unknown>;\n\tif (value && typeof value === \"object\") {\n\t\tconst handlers = value as Record<string, unknown>;\n\t\tfor (const key of [\"execute\", \"run\", \"handler\"] as const) {\n\t\t\tconst candidate = handlers[key];\n\t\t\tif (typeof candidate === \"function\") return candidate as (...args: unknown[]) => unknown | Promise<unknown>;\n\t\t}\n\t}\n\tthrow new Error(`${kind} requires a callable handler`);\n}\n\nexport function assertAgentTaskRequest(request: AgentTaskCreateRequest): void {\n\tif (!request || typeof request.prompt !== \"string\" || !request.prompt.trim()) {\n\t\tthrow new Error(\"Agent task requires a non-empty prompt\");\n\t}\n\tif (request.metadata !== undefined && (typeof request.metadata !== \"object\" || Array.isArray(request.metadata))) {\n\t\tthrow new Error(\"Agent task metadata must be an object\");\n\t}\n}\n\nexport function validateProviderHeaders(headers: unknown, source: string): Record<string, string | null> {\n\tif (!headers || typeof headers !== \"object\" || Array.isArray(headers)) {\n\t\tthrow new Error(`Provider header transform returned invalid headers: ${source}`);\n\t}\n\tconst validated: Record<string, string | null> = {};\n\tfor (const [name, value] of Object.entries(headers)) {\n\t\tif (!name || (typeof value !== \"string\" && value !== null)) {\n\t\t\tthrow new Error(`Provider header transform returned invalid headers: ${source}`);\n\t\t}\n\t\tvalidated[name] = value;\n\t}\n\treturn validated;\n}\n"]}