@ai-agent-forge/agent-forge 0.85.0

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

@@ -0,0 +1,26 @@
+import type { OperationHandler, OperationTerminalStatus } from "./capability-runtime-types.ts";
+import type { OperationHandle, OperationProgress, OperationStatus, OutputArtifactErrorCode } from "./public-api.ts";
+export declare class OutputArtifactError extends Error {
+    readonly code: OutputArtifactErrorCode;
+    constructor(code: OutputArtifactErrorCode, message: string);
+}
+export declare class RuntimeOperation<TResult> implements OperationHandle<TResult> {
+    readonly id: string;
+    private currentStatus;
+    private readonly controller;
+    private readonly execution;
+    private resultPromise;
+    private cancelResult;
+    private cancellationReason;
+    private readonly reportStatus;
+    private readonly reportTerminal;
+    private readonly reportProgress;
+    constructor(id: string, handler: OperationHandler, input: unknown, onStatus: (status: OperationStatus) => void, onTerminal: (status: OperationTerminalStatus) => void, onProgress: (progress: OperationProgress) => boolean);
+    get signal(): AbortSignal;
+    status(): OperationStatus;
+    get result(): Promise<TResult>;
+    cancel(reason?: string): Promise<void>;
+    private setStatus;
+}
+export declare function cancellationError(reason?: unknown): Error;
+//# sourceMappingURL=capability-runtime-operation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capability-runtime-operation.d.ts","sourceRoot":"","sources":["../../../src/core/extensions/capability-runtime-operation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC/F,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAEpH,qBAAa,mBAAoB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;IAEvC,YAAY,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,MAAM,EAIzD;CACD;AAED,qBAAa,gBAAgB,CAAC,OAAO,CAAE,YAAW,eAAe,CAAC,OAAO,CAAC;IACzE,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAC7C,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,YAAY,CAA0C;IAC9D,OAAO,CAAC,kBAAkB,CAAU;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoC;IACjE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA4C;IAC3E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA2C;IAE1E,YACC,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,EAC3C,UAAU,EAAE,CAAC,MAAM,EAAE,uBAAuB,KAAK,IAAI,EACrD,UAAU,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,OAAO,EA0BpD;IAED,IAAI,MAAM,IAAI,WAAW,CAExB;IAED,MAAM,IAAI,eAAe,CAExB;IAED,IAAI,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAS7B;IAEK,MAAM,CAAC,MAAM,SAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAOhD;IAED,OAAO,CAAC,SAAS;CAQjB;AAED,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,OAAqB,GAAG,KAAK,CAGtE","sourcesContent":["import type { OperationHandler, OperationTerminalStatus } from \"./capability-runtime-types.ts\";\nimport type { OperationHandle, OperationProgress, OperationStatus, OutputArtifactErrorCode } from \"./public-api.ts\";\n\nexport class OutputArtifactError extends Error {\n\treadonly code: OutputArtifactErrorCode;\n\n\tconstructor(code: OutputArtifactErrorCode, message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"OutputArtifactError\";\n\t\tthis.code = code;\n\t}\n}\n\nexport class RuntimeOperation<TResult> implements OperationHandle<TResult> {\n\tpublic readonly id: string;\n\tprivate currentStatus: OperationStatus = \"queued\";\n\tprivate readonly controller = new AbortController();\n\tprivate readonly execution: Promise<TResult>;\n\tprivate resultPromise: Promise<TResult> | undefined;\n\tprivate cancelResult: ((reason: unknown) => void) | undefined;\n\tprivate cancellationReason: unknown;\n\tprivate readonly reportStatus: (status: OperationStatus) => void;\n\tprivate readonly reportTerminal: (status: OperationTerminalStatus) => void;\n\tprivate readonly reportProgress: (progress: OperationProgress) => boolean;\n\n\tconstructor(\n\t\tid: string,\n\t\thandler: OperationHandler,\n\t\tinput: unknown,\n\t\tonStatus: (status: OperationStatus) => void,\n\t\tonTerminal: (status: OperationTerminalStatus) => void,\n\t\tonProgress: (progress: OperationProgress) => boolean,\n\t) {\n\t\tthis.id = id;\n\t\tthis.reportStatus = onStatus;\n\t\tthis.reportTerminal = onTerminal;\n\t\tthis.reportProgress = onProgress;\n\t\tthis.execution = Promise.resolve()\n\t\t\t.then(async () => {\n\t\t\t\tif (this.controller.signal.aborted) throw cancellationError(this.controller.signal.reason);\n\t\t\t\tthis.setStatus(\"running\", onStatus);\n\t\t\t\treturn (await handler(input, {\n\t\t\t\t\toperationId: this.id,\n\t\t\t\t\tsignal: this.controller.signal,\n\t\t\t\t\treportProgress: (progress) =>\n\t\t\t\t\t\tthis.currentStatus === \"running\" && !this.controller.signal.aborted && this.reportProgress(progress),\n\t\t\t\t})) as TResult;\n\t\t\t})\n\t\t\t.then((result) => {\n\t\t\t\tif (this.currentStatus !== \"cancelled\") this.setStatus(\"succeeded\", onStatus);\n\t\t\t\treturn result;\n\t\t\t})\n\t\t\t.catch((error: unknown) => {\n\t\t\t\tif (this.currentStatus !== \"cancelled\") this.setStatus(\"failed\", onStatus);\n\t\t\t\tthrow error;\n\t\t\t});\n\t\tvoid this.execution.catch(() => {});\n\t}\n\n\tget signal(): AbortSignal {\n\t\treturn this.controller.signal;\n\t}\n\n\tstatus(): OperationStatus {\n\t\treturn this.currentStatus;\n\t}\n\n\tget result(): Promise<TResult> {\n\t\tif (!this.resultPromise) {\n\t\t\tconst cancellation = new Promise<TResult>((_, reject) => {\n\t\t\t\tthis.cancelResult = reject;\n\t\t\t\tif (this.cancellationReason !== undefined) reject(cancellationError(this.cancellationReason));\n\t\t\t});\n\t\t\tthis.resultPromise = Promise.race([this.execution, cancellation]);\n\t\t}\n\t\treturn this.resultPromise;\n\t}\n\n\tasync cancel(reason = \"cancelled\"): Promise<void> {\n\t\tif (this.currentStatus === \"queued\" || this.currentStatus === \"running\") {\n\t\t\tthis.cancellationReason = reason;\n\t\t\tthis.controller.abort(reason);\n\t\t\tthis.setStatus(\"cancelled\", this.reportStatus);\n\t\t\tthis.cancelResult?.(cancellationError(reason));\n\t\t}\n\t}\n\n\tprivate setStatus(status: OperationStatus, onStatus: (status: OperationStatus) => void): void {\n\t\tif (this.currentStatus === status) return;\n\t\tthis.currentStatus = status;\n\t\tonStatus(status);\n\t\tif (status === \"succeeded\" || status === \"failed\" || status === \"cancelled\") {\n\t\t\tthis.reportTerminal(status);\n\t\t}\n\t}\n}\n\nexport function cancellationError(reason: unknown = \"cancelled\"): Error {\n\tif (reason instanceof Error) return reason;\n\treturn new Error(typeof reason === \"string\" ? reason : \"cancelled\");\n}\n"]}

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

@@ -0,0 +1,88 @@
+export class OutputArtifactError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "OutputArtifactError";
+        this.code = code;
+    }
+}
+export class RuntimeOperation {
+    id;
+    currentStatus = "queued";
+    controller = new AbortController();
+    execution;
+    resultPromise;
+    cancelResult;
+    cancellationReason;
+    reportStatus;
+    reportTerminal;
+    reportProgress;
+    constructor(id, handler, input, onStatus, onTerminal, onProgress) {
+        this.id = id;
+        this.reportStatus = onStatus;
+        this.reportTerminal = onTerminal;
+        this.reportProgress = onProgress;
+        this.execution = Promise.resolve()
+            .then(async () => {
+            if (this.controller.signal.aborted)
+                throw cancellationError(this.controller.signal.reason);
+            this.setStatus("running", onStatus);
+            return (await handler(input, {
+                operationId: this.id,
+                signal: this.controller.signal,
+                reportProgress: (progress) => this.currentStatus === "running" && !this.controller.signal.aborted && this.reportProgress(progress),
+            }));
+        })
+            .then((result) => {
+            if (this.currentStatus !== "cancelled")
+                this.setStatus("succeeded", onStatus);
+            return result;
+        })
+            .catch((error) => {
+            if (this.currentStatus !== "cancelled")
+                this.setStatus("failed", onStatus);
+            throw error;
+        });
+        void this.execution.catch(() => { });
+    }
+    get signal() {
+        return this.controller.signal;
+    }
+    status() {
+        return this.currentStatus;
+    }
+    get result() {
+        if (!this.resultPromise) {
+            const cancellation = new Promise((_, reject) => {
+                this.cancelResult = reject;
+                if (this.cancellationReason !== undefined)
+                    reject(cancellationError(this.cancellationReason));
+            });
+            this.resultPromise = Promise.race([this.execution, cancellation]);
+        }
+        return this.resultPromise;
+    }
+    async cancel(reason = "cancelled") {
+        if (this.currentStatus === "queued" || this.currentStatus === "running") {
+            this.cancellationReason = reason;
+            this.controller.abort(reason);
+            this.setStatus("cancelled", this.reportStatus);
+            this.cancelResult?.(cancellationError(reason));
+        }
+    }
+    setStatus(status, onStatus) {
+        if (this.currentStatus === status)
+            return;
+        this.currentStatus = status;
+        onStatus(status);
+        if (status === "succeeded" || status === "failed" || status === "cancelled") {
+            this.reportTerminal(status);
+        }
+    }
+}
+export function cancellationError(reason = "cancelled") {
+    if (reason instanceof Error)
+        return reason;
+    return new Error(typeof reason === "string" ? reason : "cancelled");
+}
+//# sourceMappingURL=capability-runtime-operation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capability-runtime-operation.js","sourceRoot":"","sources":["../../../src/core/extensions/capability-runtime-operation.ts"],"names":[],"mappings":"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","sourcesContent":["import type { OperationHandler, OperationTerminalStatus } from \"./capability-runtime-types.ts\";\nimport type { OperationHandle, OperationProgress, OperationStatus, OutputArtifactErrorCode } from \"./public-api.ts\";\n\nexport class OutputArtifactError extends Error {\n\treadonly code: OutputArtifactErrorCode;\n\n\tconstructor(code: OutputArtifactErrorCode, message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"OutputArtifactError\";\n\t\tthis.code = code;\n\t}\n}\n\nexport class RuntimeOperation<TResult> implements OperationHandle<TResult> {\n\tpublic readonly id: string;\n\tprivate currentStatus: OperationStatus = \"queued\";\n\tprivate readonly controller = new AbortController();\n\tprivate readonly execution: Promise<TResult>;\n\tprivate resultPromise: Promise<TResult> | undefined;\n\tprivate cancelResult: ((reason: unknown) => void) | undefined;\n\tprivate cancellationReason: unknown;\n\tprivate readonly reportStatus: (status: OperationStatus) => void;\n\tprivate readonly reportTerminal: (status: OperationTerminalStatus) => void;\n\tprivate readonly reportProgress: (progress: OperationProgress) => boolean;\n\n\tconstructor(\n\t\tid: string,\n\t\thandler: OperationHandler,\n\t\tinput: unknown,\n\t\tonStatus: (status: OperationStatus) => void,\n\t\tonTerminal: (status: OperationTerminalStatus) => void,\n\t\tonProgress: (progress: OperationProgress) => boolean,\n\t) {\n\t\tthis.id = id;\n\t\tthis.reportStatus = onStatus;\n\t\tthis.reportTerminal = onTerminal;\n\t\tthis.reportProgress = onProgress;\n\t\tthis.execution = Promise.resolve()\n\t\t\t.then(async () => {\n\t\t\t\tif (this.controller.signal.aborted) throw cancellationError(this.controller.signal.reason);\n\t\t\t\tthis.setStatus(\"running\", onStatus);\n\t\t\t\treturn (await handler(input, {\n\t\t\t\t\toperationId: this.id,\n\t\t\t\t\tsignal: this.controller.signal,\n\t\t\t\t\treportProgress: (progress) =>\n\t\t\t\t\t\tthis.currentStatus === \"running\" && !this.controller.signal.aborted && this.reportProgress(progress),\n\t\t\t\t})) as TResult;\n\t\t\t})\n\t\t\t.then((result) => {\n\t\t\t\tif (this.currentStatus !== \"cancelled\") this.setStatus(\"succeeded\", onStatus);\n\t\t\t\treturn result;\n\t\t\t})\n\t\t\t.catch((error: unknown) => {\n\t\t\t\tif (this.currentStatus !== \"cancelled\") this.setStatus(\"failed\", onStatus);\n\t\t\t\tthrow error;\n\t\t\t});\n\t\tvoid this.execution.catch(() => {});\n\t}\n\n\tget signal(): AbortSignal {\n\t\treturn this.controller.signal;\n\t}\n\n\tstatus(): OperationStatus {\n\t\treturn this.currentStatus;\n\t}\n\n\tget result(): Promise<TResult> {\n\t\tif (!this.resultPromise) {\n\t\t\tconst cancellation = new Promise<TResult>((_, reject) => {\n\t\t\t\tthis.cancelResult = reject;\n\t\t\t\tif (this.cancellationReason !== undefined) reject(cancellationError(this.cancellationReason));\n\t\t\t});\n\t\t\tthis.resultPromise = Promise.race([this.execution, cancellation]);\n\t\t}\n\t\treturn this.resultPromise;\n\t}\n\n\tasync cancel(reason = \"cancelled\"): Promise<void> {\n\t\tif (this.currentStatus === \"queued\" || this.currentStatus === \"running\") {\n\t\t\tthis.cancellationReason = reason;\n\t\t\tthis.controller.abort(reason);\n\t\t\tthis.setStatus(\"cancelled\", this.reportStatus);\n\t\t\tthis.cancelResult?.(cancellationError(reason));\n\t\t}\n\t}\n\n\tprivate setStatus(status: OperationStatus, onStatus: (status: OperationStatus) => void): void {\n\t\tif (this.currentStatus === status) return;\n\t\tthis.currentStatus = status;\n\t\tonStatus(status);\n\t\tif (status === \"succeeded\" || status === \"failed\" || status === \"cancelled\") {\n\t\t\tthis.reportTerminal(status);\n\t\t}\n\t}\n}\n\nexport function cancellationError(reason: unknown = \"cancelled\"): Error {\n\tif (reason instanceof Error) return reason;\n\treturn new Error(typeof reason === \"string\" ? reason : \"cancelled\");\n}\n"]}

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

@@ -0,0 +1,11 @@
+import type { RuntimeInspectorErrorSnapshot } from "./public-api.ts";
+export declare function lifecycleErrorSnapshot(error: unknown, seen?: Set<object>): RuntimeInspectorErrorSnapshot;
+export declare function detachedSnapshot<T>(value: T): T;
+/**
+ * Snapshot a public definition without structured-cloning its callable fields.
+ * Tool and command definitions intentionally contain executable functions;
+ * callers may invoke those functions, but must not be able to mutate the
+ * definition object held by the runtime through a list*() result.
+ */
+export declare function definitionSnapshot<T>(value: T): T;
+//# sourceMappingURL=capability-runtime-snapshot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capability-runtime-snapshot.d.ts","sourceRoot":"","sources":["../../../src/core/extensions/capability-runtime-snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAC;AAErE,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,cAAoB,GAAG,6BAA6B,CA0B9G;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAU/C;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAyBjD","sourcesContent":["import type { RuntimeInspectorErrorSnapshot } from \"./public-api.ts\";\n\nexport function lifecycleErrorSnapshot(error: unknown, seen = new Set<object>()): RuntimeInspectorErrorSnapshot {\n\tif (error instanceof Error) {\n\t\tif (seen.has(error)) return { name: \"Error\", message: \"[circular cause]\" };\n\t\tseen.add(error);\n\t\tconst cause = (error as Error & { cause?: unknown }).cause;\n\t\treturn {\n\t\t\tname: typeof error.name === \"string\" && error.name ? error.name : \"Error\",\n\t\t\tmessage: typeof error.message === \"string\" ? error.message : \"\",\n\t\t\t...((error as Error & { code?: unknown }).code === undefined\n\t\t\t\t? {}\n\t\t\t\t: { code: String((error as Error & { code?: unknown }).code) }),\n\t\t\t...(cause === undefined ? {} : { cause: lifecycleErrorSnapshot(cause, seen) }),\n\t\t};\n\t}\n\tif (typeof error === \"string\") return { name: \"string\", message: error };\n\tif (error === null) return { name: \"null\", message: \"null\" };\n\tif (error === undefined) return { name: \"undefined\", message: \"undefined\" };\n\tif (\n\t\ttypeof error === \"number\" ||\n\t\ttypeof error === \"boolean\" ||\n\t\ttypeof error === \"bigint\" ||\n\t\ttypeof error === \"symbol\"\n\t) {\n\t\treturn { name: typeof error, message: String(error) };\n\t}\n\treturn { name: typeof error, message: `[${typeof error}]` };\n}\n\nexport function detachedSnapshot<T>(value: T): T {\n\tconst clone = structuredClone(value);\n\tconst freeze = (candidate: unknown): void => {\n\t\tif (!candidate || typeof candidate !== \"object\") return;\n\t\tif (ArrayBuffer.isView(candidate)) return;\n\t\tfor (const child of Object.values(candidate as Record<string, unknown>)) freeze(child);\n\t\tObject.freeze(candidate);\n\t};\n\tfreeze(clone);\n\treturn clone;\n}\n\n/**\n * Snapshot a public definition without structured-cloning its callable fields.\n * Tool and command definitions intentionally contain executable functions;\n * callers may invoke those functions, but must not be able to mutate the\n * definition object held by the runtime through a list*() result.\n */\nexport function definitionSnapshot<T>(value: T): T {\n\tconst seen = new WeakMap<object, unknown>();\n\tconst clone = (candidate: unknown): unknown => {\n\t\tif (candidate === null || typeof candidate !== \"object\") return candidate;\n\t\tconst existing = seen.get(candidate);\n\t\tif (existing !== undefined) return existing;\n\t\tif (Array.isArray(candidate)) {\n\t\t\tconst result: unknown[] = new Array(candidate.length);\n\t\t\tseen.set(candidate, result);\n\t\t\tfor (let index = 0; index < candidate.length; index++) {\n\t\t\t\tif (index in candidate) result[index] = clone(candidate[index]);\n\t\t\t}\n\t\t\treturn Object.freeze(result);\n\t\t}\n\t\tconst result = Object.create(Object.getPrototypeOf(candidate)) as Record<PropertyKey, unknown>;\n\t\tseen.set(candidate, result);\n\t\tfor (const key of Reflect.ownKeys(candidate)) {\n\t\t\tconst descriptor = Object.getOwnPropertyDescriptor(candidate, key);\n\t\t\tif (!descriptor || key === \"length\") continue;\n\t\t\tif (\"value\" in descriptor) descriptor.value = clone(descriptor.value);\n\t\t\tObject.defineProperty(result, key, descriptor);\n\t\t}\n\t\treturn Object.freeze(result);\n\t};\n\treturn clone(value) as T;\n}\n"]}

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

@@ -0,0 +1,81 @@
+export function lifecycleErrorSnapshot(error, seen = new Set()) {
+    if (error instanceof Error) {
+        if (seen.has(error))
+            return { name: "Error", message: "[circular cause]" };
+        seen.add(error);
+        const cause = error.cause;
+        return {
+            name: typeof error.name === "string" && error.name ? error.name : "Error",
+            message: typeof error.message === "string" ? error.message : "",
+            ...(error.code === undefined
+                ? {}
+                : { code: String(error.code) }),
+            ...(cause === undefined ? {} : { cause: lifecycleErrorSnapshot(cause, seen) }),
+        };
+    }
+    if (typeof error === "string")
+        return { name: "string", message: error };
+    if (error === null)
+        return { name: "null", message: "null" };
+    if (error === undefined)
+        return { name: "undefined", message: "undefined" };
+    if (typeof error === "number" ||
+        typeof error === "boolean" ||
+        typeof error === "bigint" ||
+        typeof error === "symbol") {
+        return { name: typeof error, message: String(error) };
+    }
+    return { name: typeof error, message: `[${typeof error}]` };
+}
+export function detachedSnapshot(value) {
+    const clone = structuredClone(value);
+    const freeze = (candidate) => {
+        if (!candidate || typeof candidate !== "object")
+            return;
+        if (ArrayBuffer.isView(candidate))
+            return;
+        for (const child of Object.values(candidate))
+            freeze(child);
+        Object.freeze(candidate);
+    };
+    freeze(clone);
+    return clone;
+}
+/**
+ * Snapshot a public definition without structured-cloning its callable fields.
+ * Tool and command definitions intentionally contain executable functions;
+ * callers may invoke those functions, but must not be able to mutate the
+ * definition object held by the runtime through a list*() result.
+ */
+export function definitionSnapshot(value) {
+    const seen = new WeakMap();
+    const clone = (candidate) => {
+        if (candidate === null || typeof candidate !== "object")
+            return candidate;
+        const existing = seen.get(candidate);
+        if (existing !== undefined)
+            return existing;
+        if (Array.isArray(candidate)) {
+            const result = new Array(candidate.length);
+            seen.set(candidate, result);
+            for (let index = 0; index < candidate.length; index++) {
+                if (index in candidate)
+                    result[index] = clone(candidate[index]);
+            }
+            return Object.freeze(result);
+        }
+        const result = Object.create(Object.getPrototypeOf(candidate));
+        seen.set(candidate, result);
+        for (const key of Reflect.ownKeys(candidate)) {
+            const descriptor = Object.getOwnPropertyDescriptor(candidate, key);
+            if (!descriptor || key === "length")
+                continue;
+            if ("value" in descriptor)
+                descriptor.value = clone(descriptor.value);
+            Object.defineProperty(result, key, descriptor);
+        }
+        return Object.freeze(result);
+    };
+    return clone(value);
+}
+//# sourceMappingURL=capability-runtime-snapshot.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capability-runtime-snapshot.js","sourceRoot":"","sources":["../../../src/core/extensions/capability-runtime-snapshot.ts"],"names":[],"mappings":"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","sourcesContent":["import type { RuntimeInspectorErrorSnapshot } from \"./public-api.ts\";\n\nexport function lifecycleErrorSnapshot(error: unknown, seen = new Set<object>()): RuntimeInspectorErrorSnapshot {\n\tif (error instanceof Error) {\n\t\tif (seen.has(error)) return { name: \"Error\", message: \"[circular cause]\" };\n\t\tseen.add(error);\n\t\tconst cause = (error as Error & { cause?: unknown }).cause;\n\t\treturn {\n\t\t\tname: typeof error.name === \"string\" && error.name ? error.name : \"Error\",\n\t\t\tmessage: typeof error.message === \"string\" ? error.message : \"\",\n\t\t\t...((error as Error & { code?: unknown }).code === undefined\n\t\t\t\t? {}\n\t\t\t\t: { code: String((error as Error & { code?: unknown }).code) }),\n\t\t\t...(cause === undefined ? {} : { cause: lifecycleErrorSnapshot(cause, seen) }),\n\t\t};\n\t}\n\tif (typeof error === \"string\") return { name: \"string\", message: error };\n\tif (error === null) return { name: \"null\", message: \"null\" };\n\tif (error === undefined) return { name: \"undefined\", message: \"undefined\" };\n\tif (\n\t\ttypeof error === \"number\" ||\n\t\ttypeof error === \"boolean\" ||\n\t\ttypeof error === \"bigint\" ||\n\t\ttypeof error === \"symbol\"\n\t) {\n\t\treturn { name: typeof error, message: String(error) };\n\t}\n\treturn { name: typeof error, message: `[${typeof error}]` };\n}\n\nexport function detachedSnapshot<T>(value: T): T {\n\tconst clone = structuredClone(value);\n\tconst freeze = (candidate: unknown): void => {\n\t\tif (!candidate || typeof candidate !== \"object\") return;\n\t\tif (ArrayBuffer.isView(candidate)) return;\n\t\tfor (const child of Object.values(candidate as Record<string, unknown>)) freeze(child);\n\t\tObject.freeze(candidate);\n\t};\n\tfreeze(clone);\n\treturn clone;\n}\n\n/**\n * Snapshot a public definition without structured-cloning its callable fields.\n * Tool and command definitions intentionally contain executable functions;\n * callers may invoke those functions, but must not be able to mutate the\n * definition object held by the runtime through a list*() result.\n */\nexport function definitionSnapshot<T>(value: T): T {\n\tconst seen = new WeakMap<object, unknown>();\n\tconst clone = (candidate: unknown): unknown => {\n\t\tif (candidate === null || typeof candidate !== \"object\") return candidate;\n\t\tconst existing = seen.get(candidate);\n\t\tif (existing !== undefined) return existing;\n\t\tif (Array.isArray(candidate)) {\n\t\t\tconst result: unknown[] = new Array(candidate.length);\n\t\t\tseen.set(candidate, result);\n\t\t\tfor (let index = 0; index < candidate.length; index++) {\n\t\t\t\tif (index in candidate) result[index] = clone(candidate[index]);\n\t\t\t}\n\t\t\treturn Object.freeze(result);\n\t\t}\n\t\tconst result = Object.create(Object.getPrototypeOf(candidate)) as Record<PropertyKey, unknown>;\n\t\tseen.set(candidate, result);\n\t\tfor (const key of Reflect.ownKeys(candidate)) {\n\t\t\tconst descriptor = Object.getOwnPropertyDescriptor(candidate, key);\n\t\t\tif (!descriptor || key === \"length\") continue;\n\t\t\tif (\"value\" in descriptor) descriptor.value = clone(descriptor.value);\n\t\t\tObject.defineProperty(result, key, descriptor);\n\t\t}\n\t\treturn Object.freeze(result);\n\t};\n\treturn clone(value) as T;\n}\n"]}

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

@@ -0,0 +1,34 @@
+import type { CapabilityRuntimeState, RegisteredCapability, RegisteredPluginCapability } from "./capability-runtime-types.ts";
+import type { OperationHandle } from "./public-api.ts";
+/**
+ * Create the mutable state container for one capability runtime. Every map,
+ * set, and array is created once and mutated in place; `eventSequence` is the
+ * single mutable primitive shared with the lifecycle dispatch module.
+ */
+export declare function createCapabilityRuntimeState(): CapabilityRuntimeState;
+/**
+ * A synchronous bootstrap plugin violated its lifecycle contract after its
+ * disposer had already run. The synchronous caller receives a contract error;
+ * observe a later rejection too so it cannot become an unhandled promise.
+ */
+export declare function observeUnexpectedAsyncCleanup(result: PromiseLike<void>, pluginId: string): void;
+export declare function createRevokedCapabilityError(owner: string): Error;
+export declare function isRevokedCapabilityError(error: unknown): boolean;
+export declare function assertRegisteredCapabilityActive<T>(state: CapabilityRuntimeState, registered: RegisteredCapability<T>): void;
+/**
+ * Invoke an extension-owned callback with a lifecycle check before and after
+ * awaiting it. A callback that resolves after its owner is revoked must not
+ * publish a late result, and its rejection is normalized to the lifecycle
+ * error so callers can distinguish revocation from plugin failures.
+ */
+export declare function invokeRegisteredCapability<T, TResult>(state: CapabilityRuntimeState, registered: RegisteredCapability<T>, invoke: (value: T) => TResult | PromiseLike<TResult>): Promise<TResult>;
+/**
+ * Invoke a policy with its optional host cancellation signal. The signal is
+ * checked before dispatch and after the policy settles; revocation remains
+ * the stronger lifecycle error when both happen during one invocation.
+ */
+export declare function invokeRegisteredCapabilityWithSignal<T, TResult>(state: CapabilityRuntimeState, registered: RegisteredCapability<T>, signal: AbortSignal | undefined, invoke: (value: T) => TResult | PromiseLike<TResult>): Promise<TResult>;
+export declare function invokePluginCapability<TResult>(state: CapabilityRuntimeState, registered: RegisteredPluginCapability, input: unknown, signal: AbortSignal): Promise<TResult>;
+export declare function trackOperation<TResult>(state: CapabilityRuntimeState, ownerTokens: readonly symbol[], handle: OperationHandle<TResult>): OperationHandle<TResult>;
+export declare function cancelOwnedOperations(state: CapabilityRuntimeState, ownerToken: symbol, owner: string): void;
+//# sourceMappingURL=capability-runtime-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capability-runtime-store.d.ts","sourceRoot":"","sources":["../../../src/core/extensions/capability-runtime-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEX,sBAAsB,EAGtB,oBAAoB,EACpB,0BAA0B,EAO1B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAaX,eAAe,EAQf,MAAM,iBAAiB,CAAC;AAEzB;;;;GAIG;AACH,wBAAgB,4BAA4B,IAAI,sBAAsB,CAuCrE;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAI/F;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAEjE;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEhE;AAED,wBAAgB,gCAAgC,CAAC,CAAC,EACjD,KAAK,EAAE,sBAAsB,EAC7B,UAAU,EAAE,oBAAoB,CAAC,CAAC,CAAC,GACjC,IAAI,CAIN;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAAC,CAAC,EAAE,OAAO,EAC1D,KAAK,EAAE,sBAAsB,EAC7B,UAAU,EAAE,oBAAoB,CAAC,CAAC,CAAC,EACnC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,GAClD,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED;;;;GAIG;AACH,wBAAsB,oCAAoC,CAAC,CAAC,EAAE,OAAO,EACpE,KAAK,EAAE,sBAAsB,EAC7B,UAAU,EAAE,oBAAoB,CAAC,CAAC,CAAC,EACnC,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,GAClD,OAAO,CAAC,OAAO,CAAC,CAalB;AAED,wBAAsB,sBAAsB,CAAC,OAAO,EACnD,KAAK,EAAE,sBAAsB,EAC7B,UAAU,EAAE,0BAA0B,EACtC,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,WAAW,GACjB,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED,wBAAgB,cAAc,CAAC,OAAO,EACrC,KAAK,EAAE,sBAAsB,EAC7B,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,GAC9B,eAAe,CAAC,OAAO,CAAC,CAgB1B;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAM5G","sourcesContent":["import { cancellationError } from \"./capability-runtime-operation.ts\";\nimport { detachedSnapshot } from \"./capability-runtime-snapshot.ts\";\nimport type {\n\tAPIState,\n\tCapabilityRuntimeState,\n\tOperationHandler,\n\tQueuedLifecycleDelivery,\n\tRegisteredCapability,\n\tRegisteredPluginCapability,\n\tStateWatcher,\n\tStoredContributionPoint,\n\tStoredLifecycleDefinition,\n\tStoredLifecycleRegistration,\n\tStoredOutputArtifact,\n\tStoredState,\n} from \"./capability-runtime-types.ts\";\nimport type { LifecycleDeliveryQueue } from \"./lifecycle-delivery-queue.ts\";\nimport type {\n\tAgentLoopHookHandlerV1,\n\tAgentLoopHookPositionV1,\n\tAgentRunLoopStrategyV1,\n\tBranchSummaryPolicy,\n\tCapabilityAPI,\n\tCapabilityCommandDefinition,\n\tCompactionPolicy,\n\tContextStrategy,\n\tDiagnosticsSpanSnapshot,\n\tDisposableRegistration,\n\tEventEnvelope,\n\tLoggerRecord,\n\tOperationHandle,\n\tOperationStatus,\n\tOverflowPolicy,\n\tPluginRejection,\n\tProviderHeaderTransform,\n\tRetryPolicy,\n\tRuntimeInspectorLifecycleDeliveryReportSnapshot,\n\tSkillDefinition,\n} from \"./public-api.ts\";\n\n/**\n * Create the mutable state container for one capability runtime. Every map,\n * set, and array is created once and mutated in place; `eventSequence` is the\n * single mutable primitive shared with the lifecycle dispatch module.\n */\nexport function createCapabilityRuntimeState(): CapabilityRuntimeState {\n\treturn {\n\t\ttools: new Map<string, RegisteredCapability<unknown>>(),\n\t\tskills: new Map<string, RegisteredCapability<SkillDefinition>>(),\n\t\tretryPolicies: new Map<string, RegisteredCapability<RetryPolicy>>(),\n\t\tcompactionPolicies: new Map<string, RegisteredCapability<CompactionPolicy>>(),\n\t\toverflowPolicies: new Map<string, RegisteredCapability<OverflowPolicy>>(),\n\t\tbranchSummaryPolicies: new Map<string, RegisteredCapability<BranchSummaryPolicy>>(),\n\t\trunLoopStrategies: new Map<string, RegisteredCapability<AgentRunLoopStrategyV1>>(),\n\t\tloopHooks: new Map<AgentLoopHookPositionV1, RegisteredCapability<AgentLoopHookHandlerV1>[]>(),\n\t\tcommands: new Map<string, RegisteredCapability<CapabilityCommandDefinition>>(),\n\t\toperations: new Map<string, RegisteredCapability<OperationHandler>>(),\n\t\trpcMethods: new Map<string, RegisteredCapability<(input: unknown) => unknown | Promise<unknown>>>(),\n\t\tcontextStrategies: new Map<string, RegisteredCapability<ContextStrategy>>(),\n\t\tpluginCapabilities: new Map<string, RegisteredPluginCapability>(),\n\t\tproviderHeaderTransforms: new Map<string, RegisteredCapability<ProviderHeaderTransform>>(),\n\t\tcontributionPoints: new Map<string, StoredContributionPoint<unknown>>(),\n\t\tlifecycleDefinitions: new Map<string, StoredLifecycleDefinition>(),\n\t\tlifecycleRegistrations: new Map<string, Map<string, StoredLifecycleRegistration>>(),\n\t\tsubscribers: new Map<string, Map<string, RegisteredCapability<(event: EventEnvelope) => void | Promise<void>>>>(),\n\t\tstatuses: new Map<string, OperationStatus>(),\n\t\tactiveOperationsByOwnerToken: new Map<symbol, Set<OperationHandle<unknown>>>(),\n\t\tpluginRegistrations: new Map<string, Set<DisposableRegistration>>(),\n\t\tapiStates: new Map<CapabilityAPI, APIState>(),\n\t\tactiveOwnerTokens: new Set<symbol>(),\n\t\toutputArtifacts: new Map<string, StoredOutputArtifact>(),\n\t\tstateByOwner: new Map<string, Map<string, StoredState>>(),\n\t\tstateRevisionsByOwner: new Map<string, Map<string, number>>(),\n\t\tstateWatchers: new Map<string, Map<string, StateWatcher>>(),\n\t\tstateByInstance: new Map<string, Map<string, Map<string, StoredState>>>(),\n\t\tstateRevisionsByInstance: new Map<string, Map<string, Map<string, number>>>(),\n\t\tstateWatchersByInstance: new Map<string, Map<string, Map<string, StateWatcher>>>(),\n\t\tlogs: [] as LoggerRecord[],\n\t\tspans: new Map<string, DiagnosticsSpanSnapshot>(),\n\t\tlifecycleReports: [] as RuntimeInspectorLifecycleDeliveryReportSnapshot[],\n\t\tlifecycleDeliveryQueues: new Set<LifecycleDeliveryQueue<QueuedLifecycleDelivery<unknown>>>(),\n\t\tpluginRejections: [] as PluginRejection[],\n\t\teventSequence: 0,\n\t};\n}\n\n/**\n * A synchronous bootstrap plugin violated its lifecycle contract after its\n * disposer had already run. The synchronous caller receives a contract error;\n * observe a later rejection too so it cannot become an unhandled promise.\n */\nexport function observeUnexpectedAsyncCleanup(result: PromiseLike<void>, pluginId: string): void {\n\tvoid Promise.resolve(result).catch((error) => {\n\t\tconsole.error(`Asynchronous cleanup rejected after synchronous plugin disposal was rejected: ${pluginId}`, error);\n\t});\n}\n\nexport function createRevokedCapabilityError(owner: string): Error {\n\treturn new Error(`Capability API is revoked: ${owner}`);\n}\n\nexport function isRevokedCapabilityError(error: unknown): boolean {\n\treturn error instanceof Error && error.message.startsWith(\"Capability API is revoked: \");\n}\n\nexport function assertRegisteredCapabilityActive<T>(\n\tstate: CapabilityRuntimeState,\n\tregistered: RegisteredCapability<T>,\n): void {\n\tif (!state.activeOwnerTokens.has(registered.ownerToken)) {\n\t\tthrow createRevokedCapabilityError(registered.owner);\n\t}\n}\n\n/**\n * Invoke an extension-owned callback with a lifecycle check before and after\n * awaiting it. A callback that resolves after its owner is revoked must not\n * publish a late result, and its rejection is normalized to the lifecycle\n * error so callers can distinguish revocation from plugin failures.\n */\nexport async function invokeRegisteredCapability<T, TResult>(\n\tstate: CapabilityRuntimeState,\n\tregistered: RegisteredCapability<T>,\n\tinvoke: (value: T) => TResult | PromiseLike<TResult>,\n): Promise<TResult> {\n\tassertRegisteredCapabilityActive(state, registered);\n\ttry {\n\t\tconst result = await invoke(registered.value);\n\t\tassertRegisteredCapabilityActive(state, registered);\n\t\treturn result;\n\t} catch (error) {\n\t\tif (!state.activeOwnerTokens.has(registered.ownerToken)) {\n\t\t\tthrow createRevokedCapabilityError(registered.owner);\n\t\t}\n\t\tthrow error;\n\t}\n}\n\n/**\n * Invoke a policy with its optional host cancellation signal. The signal is\n * checked before dispatch and after the policy settles; revocation remains\n * the stronger lifecycle error when both happen during one invocation.\n */\nexport async function invokeRegisteredCapabilityWithSignal<T, TResult>(\n\tstate: CapabilityRuntimeState,\n\tregistered: RegisteredCapability<T>,\n\tsignal: AbortSignal | undefined,\n\tinvoke: (value: T) => TResult | PromiseLike<TResult>,\n): Promise<TResult> {\n\tif (signal?.aborted) throw cancellationError(signal.reason);\n\ttry {\n\t\tconst result = await invokeRegisteredCapability(state, registered, invoke);\n\t\tif (signal?.aborted) throw cancellationError(signal.reason);\n\t\treturn result;\n\t} catch (error) {\n\t\tif (!state.activeOwnerTokens.has(registered.ownerToken)) {\n\t\t\tthrow createRevokedCapabilityError(registered.owner);\n\t\t}\n\t\tif (signal?.aborted) throw cancellationError(signal.reason);\n\t\tthrow error;\n\t}\n}\n\nexport async function invokePluginCapability<TResult>(\n\tstate: CapabilityRuntimeState,\n\tregistered: RegisteredPluginCapability,\n\tinput: unknown,\n\tsignal: AbortSignal,\n): Promise<TResult> {\n\tassertRegisteredCapabilityActive(state, registered as unknown as RegisteredCapability<unknown>);\n\ttry {\n\t\tconst result = await registered.handler(detachedSnapshot(input), { signal });\n\t\tassertRegisteredCapabilityActive(state, registered as unknown as RegisteredCapability<unknown>);\n\t\treturn detachedSnapshot(result) as TResult;\n\t} catch (error) {\n\t\tif (!state.activeOwnerTokens.has(registered.ownerToken)) throw createRevokedCapabilityError(registered.owner);\n\t\tthrow error;\n\t}\n}\n\nexport function trackOperation<TResult>(\n\tstate: CapabilityRuntimeState,\n\townerTokens: readonly symbol[],\n\thandle: OperationHandle<TResult>,\n): OperationHandle<TResult> {\n\tfor (const ownerToken of ownerTokens) {\n\t\tconst handles = state.activeOperationsByOwnerToken.get(ownerToken) ?? new Set<OperationHandle<unknown>>();\n\t\thandles.add(handle as OperationHandle<unknown>);\n\t\tstate.activeOperationsByOwnerToken.set(ownerToken, handles);\n\t}\n\tconst remove = () => {\n\t\tfor (const ownerToken of ownerTokens) {\n\t\t\tconst handles = state.activeOperationsByOwnerToken.get(ownerToken);\n\t\t\tif (!handles) continue;\n\t\t\thandles.delete(handle as OperationHandle<unknown>);\n\t\t\tif (handles.size === 0) state.activeOperationsByOwnerToken.delete(ownerToken);\n\t\t}\n\t};\n\tvoid handle.result.then(remove, remove);\n\treturn handle;\n}\n\nexport function cancelOwnedOperations(state: CapabilityRuntimeState, ownerToken: symbol, owner: string): void {\n\tconst handles = state.activeOperationsByOwnerToken.get(ownerToken);\n\tif (!handles) return;\n\tstate.activeOperationsByOwnerToken.delete(ownerToken);\n\tconst reason = createRevokedCapabilityError(owner);\n\tfor (const handle of handles) void handle.cancel(reason.message);\n}\n"]}

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

@@ -0,0 +1,153 @@
+import { cancellationError } from "./capability-runtime-operation.js";
+import { detachedSnapshot } from "./capability-runtime-snapshot.js";
+/**
+ * Create the mutable state container for one capability runtime. Every map,
+ * set, and array is created once and mutated in place; `eventSequence` is the
+ * single mutable primitive shared with the lifecycle dispatch module.
+ */
+export function createCapabilityRuntimeState() {
+    return {
+        tools: new Map(),
+        skills: new Map(),
+        retryPolicies: new Map(),
+        compactionPolicies: new Map(),
+        overflowPolicies: new Map(),
+        branchSummaryPolicies: new Map(),
+        runLoopStrategies: new Map(),
+        loopHooks: new Map(),
+        commands: new Map(),
+        operations: new Map(),
+        rpcMethods: new Map(),
+        contextStrategies: new Map(),
+        pluginCapabilities: new Map(),
+        providerHeaderTransforms: new Map(),
+        contributionPoints: new Map(),
+        lifecycleDefinitions: new Map(),
+        lifecycleRegistrations: new Map(),
+        subscribers: new Map(),
+        statuses: new Map(),
+        activeOperationsByOwnerToken: new Map(),
+        pluginRegistrations: new Map(),
+        apiStates: new Map(),
+        activeOwnerTokens: new Set(),
+        outputArtifacts: new Map(),
+        stateByOwner: new Map(),
+        stateRevisionsByOwner: new Map(),
+        stateWatchers: new Map(),
+        stateByInstance: new Map(),
+        stateRevisionsByInstance: new Map(),
+        stateWatchersByInstance: new Map(),
+        logs: [],
+        spans: new Map(),
+        lifecycleReports: [],
+        lifecycleDeliveryQueues: new Set(),
+        pluginRejections: [],
+        eventSequence: 0,
+    };
+}
+/**
+ * A synchronous bootstrap plugin violated its lifecycle contract after its
+ * disposer had already run. The synchronous caller receives a contract error;
+ * observe a later rejection too so it cannot become an unhandled promise.
+ */
+export function observeUnexpectedAsyncCleanup(result, pluginId) {
+    void Promise.resolve(result).catch((error) => {
+        console.error(`Asynchronous cleanup rejected after synchronous plugin disposal was rejected: ${pluginId}`, error);
+    });
+}
+export function createRevokedCapabilityError(owner) {
+    return new Error(`Capability API is revoked: ${owner}`);
+}
+export function isRevokedCapabilityError(error) {
+    return error instanceof Error && error.message.startsWith("Capability API is revoked: ");
+}
+export function assertRegisteredCapabilityActive(state, registered) {
+    if (!state.activeOwnerTokens.has(registered.ownerToken)) {
+        throw createRevokedCapabilityError(registered.owner);
+    }
+}
+/**
+ * Invoke an extension-owned callback with a lifecycle check before and after
+ * awaiting it. A callback that resolves after its owner is revoked must not
+ * publish a late result, and its rejection is normalized to the lifecycle
+ * error so callers can distinguish revocation from plugin failures.
+ */
+export async function invokeRegisteredCapability(state, registered, invoke) {
+    assertRegisteredCapabilityActive(state, registered);
+    try {
+        const result = await invoke(registered.value);
+        assertRegisteredCapabilityActive(state, registered);
+        return result;
+    }
+    catch (error) {
+        if (!state.activeOwnerTokens.has(registered.ownerToken)) {
+            throw createRevokedCapabilityError(registered.owner);
+        }
+        throw error;
+    }
+}
+/**
+ * Invoke a policy with its optional host cancellation signal. The signal is
+ * checked before dispatch and after the policy settles; revocation remains
+ * the stronger lifecycle error when both happen during one invocation.
+ */
+export async function invokeRegisteredCapabilityWithSignal(state, registered, signal, invoke) {
+    if (signal?.aborted)
+        throw cancellationError(signal.reason);
+    try {
+        const result = await invokeRegisteredCapability(state, registered, invoke);
+        if (signal?.aborted)
+            throw cancellationError(signal.reason);
+        return result;
+    }
+    catch (error) {
+        if (!state.activeOwnerTokens.has(registered.ownerToken)) {
+            throw createRevokedCapabilityError(registered.owner);
+        }
+        if (signal?.aborted)
+            throw cancellationError(signal.reason);
+        throw error;
+    }
+}
+export async function invokePluginCapability(state, registered, input, signal) {
+    assertRegisteredCapabilityActive(state, registered);
+    try {
+        const result = await registered.handler(detachedSnapshot(input), { signal });
+        assertRegisteredCapabilityActive(state, registered);
+        return detachedSnapshot(result);
+    }
+    catch (error) {
+        if (!state.activeOwnerTokens.has(registered.ownerToken))
+            throw createRevokedCapabilityError(registered.owner);
+        throw error;
+    }
+}
+export function trackOperation(state, ownerTokens, handle) {
+    for (const ownerToken of ownerTokens) {
+        const handles = state.activeOperationsByOwnerToken.get(ownerToken) ?? new Set();
+        handles.add(handle);
+        state.activeOperationsByOwnerToken.set(ownerToken, handles);
+    }
+    const remove = () => {
+        for (const ownerToken of ownerTokens) {
+            const handles = state.activeOperationsByOwnerToken.get(ownerToken);
+            if (!handles)
+                continue;
+            handles.delete(handle);
+            if (handles.size === 0)
+                state.activeOperationsByOwnerToken.delete(ownerToken);
+        }
+    };
+    void handle.result.then(remove, remove);
+    return handle;
+}
+export function cancelOwnedOperations(state, ownerToken, owner) {
+    const handles = state.activeOperationsByOwnerToken.get(ownerToken);
+    if (!handles)
+        return;
+    state.activeOperationsByOwnerToken.delete(ownerToken);
+    const reason = createRevokedCapabilityError(owner);
+    for (const handle of handles)
+        void handle.cancel(reason.message);
+}
+//# sourceMappingURL=capability-runtime-store.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capability-runtime-store.js","sourceRoot":"","sources":["../../../src/core/extensions/capability-runtime-store.ts"],"names":[],"mappings":"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","sourcesContent":["import { cancellationError } from \"./capability-runtime-operation.ts\";\nimport { detachedSnapshot } from \"./capability-runtime-snapshot.ts\";\nimport type {\n\tAPIState,\n\tCapabilityRuntimeState,\n\tOperationHandler,\n\tQueuedLifecycleDelivery,\n\tRegisteredCapability,\n\tRegisteredPluginCapability,\n\tStateWatcher,\n\tStoredContributionPoint,\n\tStoredLifecycleDefinition,\n\tStoredLifecycleRegistration,\n\tStoredOutputArtifact,\n\tStoredState,\n} from \"./capability-runtime-types.ts\";\nimport type { LifecycleDeliveryQueue } from \"./lifecycle-delivery-queue.ts\";\nimport type {\n\tAgentLoopHookHandlerV1,\n\tAgentLoopHookPositionV1,\n\tAgentRunLoopStrategyV1,\n\tBranchSummaryPolicy,\n\tCapabilityAPI,\n\tCapabilityCommandDefinition,\n\tCompactionPolicy,\n\tContextStrategy,\n\tDiagnosticsSpanSnapshot,\n\tDisposableRegistration,\n\tEventEnvelope,\n\tLoggerRecord,\n\tOperationHandle,\n\tOperationStatus,\n\tOverflowPolicy,\n\tPluginRejection,\n\tProviderHeaderTransform,\n\tRetryPolicy,\n\tRuntimeInspectorLifecycleDeliveryReportSnapshot,\n\tSkillDefinition,\n} from \"./public-api.ts\";\n\n/**\n * Create the mutable state container for one capability runtime. Every map,\n * set, and array is created once and mutated in place; `eventSequence` is the\n * single mutable primitive shared with the lifecycle dispatch module.\n */\nexport function createCapabilityRuntimeState(): CapabilityRuntimeState {\n\treturn {\n\t\ttools: new Map<string, RegisteredCapability<unknown>>(),\n\t\tskills: new Map<string, RegisteredCapability<SkillDefinition>>(),\n\t\tretryPolicies: new Map<string, RegisteredCapability<RetryPolicy>>(),\n\t\tcompactionPolicies: new Map<string, RegisteredCapability<CompactionPolicy>>(),\n\t\toverflowPolicies: new Map<string, RegisteredCapability<OverflowPolicy>>(),\n\t\tbranchSummaryPolicies: new Map<string, RegisteredCapability<BranchSummaryPolicy>>(),\n\t\trunLoopStrategies: new Map<string, RegisteredCapability<AgentRunLoopStrategyV1>>(),\n\t\tloopHooks: new Map<AgentLoopHookPositionV1, RegisteredCapability<AgentLoopHookHandlerV1>[]>(),\n\t\tcommands: new Map<string, RegisteredCapability<CapabilityCommandDefinition>>(),\n\t\toperations: new Map<string, RegisteredCapability<OperationHandler>>(),\n\t\trpcMethods: new Map<string, RegisteredCapability<(input: unknown) => unknown | Promise<unknown>>>(),\n\t\tcontextStrategies: new Map<string, RegisteredCapability<ContextStrategy>>(),\n\t\tpluginCapabilities: new Map<string, RegisteredPluginCapability>(),\n\t\tproviderHeaderTransforms: new Map<string, RegisteredCapability<ProviderHeaderTransform>>(),\n\t\tcontributionPoints: new Map<string, StoredContributionPoint<unknown>>(),\n\t\tlifecycleDefinitions: new Map<string, StoredLifecycleDefinition>(),\n\t\tlifecycleRegistrations: new Map<string, Map<string, StoredLifecycleRegistration>>(),\n\t\tsubscribers: new Map<string, Map<string, RegisteredCapability<(event: EventEnvelope) => void | Promise<void>>>>(),\n\t\tstatuses: new Map<string, OperationStatus>(),\n\t\tactiveOperationsByOwnerToken: new Map<symbol, Set<OperationHandle<unknown>>>(),\n\t\tpluginRegistrations: new Map<string, Set<DisposableRegistration>>(),\n\t\tapiStates: new Map<CapabilityAPI, APIState>(),\n\t\tactiveOwnerTokens: new Set<symbol>(),\n\t\toutputArtifacts: new Map<string, StoredOutputArtifact>(),\n\t\tstateByOwner: new Map<string, Map<string, StoredState>>(),\n\t\tstateRevisionsByOwner: new Map<string, Map<string, number>>(),\n\t\tstateWatchers: new Map<string, Map<string, StateWatcher>>(),\n\t\tstateByInstance: new Map<string, Map<string, Map<string, StoredState>>>(),\n\t\tstateRevisionsByInstance: new Map<string, Map<string, Map<string, number>>>(),\n\t\tstateWatchersByInstance: new Map<string, Map<string, Map<string, StateWatcher>>>(),\n\t\tlogs: [] as LoggerRecord[],\n\t\tspans: new Map<string, DiagnosticsSpanSnapshot>(),\n\t\tlifecycleReports: [] as RuntimeInspectorLifecycleDeliveryReportSnapshot[],\n\t\tlifecycleDeliveryQueues: new Set<LifecycleDeliveryQueue<QueuedLifecycleDelivery<unknown>>>(),\n\t\tpluginRejections: [] as PluginRejection[],\n\t\teventSequence: 0,\n\t};\n}\n\n/**\n * A synchronous bootstrap plugin violated its lifecycle contract after its\n * disposer had already run. The synchronous caller receives a contract error;\n * observe a later rejection too so it cannot become an unhandled promise.\n */\nexport function observeUnexpectedAsyncCleanup(result: PromiseLike<void>, pluginId: string): void {\n\tvoid Promise.resolve(result).catch((error) => {\n\t\tconsole.error(`Asynchronous cleanup rejected after synchronous plugin disposal was rejected: ${pluginId}`, error);\n\t});\n}\n\nexport function createRevokedCapabilityError(owner: string): Error {\n\treturn new Error(`Capability API is revoked: ${owner}`);\n}\n\nexport function isRevokedCapabilityError(error: unknown): boolean {\n\treturn error instanceof Error && error.message.startsWith(\"Capability API is revoked: \");\n}\n\nexport function assertRegisteredCapabilityActive<T>(\n\tstate: CapabilityRuntimeState,\n\tregistered: RegisteredCapability<T>,\n): void {\n\tif (!state.activeOwnerTokens.has(registered.ownerToken)) {\n\t\tthrow createRevokedCapabilityError(registered.owner);\n\t}\n}\n\n/**\n * Invoke an extension-owned callback with a lifecycle check before and after\n * awaiting it. A callback that resolves after its owner is revoked must not\n * publish a late result, and its rejection is normalized to the lifecycle\n * error so callers can distinguish revocation from plugin failures.\n */\nexport async function invokeRegisteredCapability<T, TResult>(\n\tstate: CapabilityRuntimeState,\n\tregistered: RegisteredCapability<T>,\n\tinvoke: (value: T) => TResult | PromiseLike<TResult>,\n): Promise<TResult> {\n\tassertRegisteredCapabilityActive(state, registered);\n\ttry {\n\t\tconst result = await invoke(registered.value);\n\t\tassertRegisteredCapabilityActive(state, registered);\n\t\treturn result;\n\t} catch (error) {\n\t\tif (!state.activeOwnerTokens.has(registered.ownerToken)) {\n\t\t\tthrow createRevokedCapabilityError(registered.owner);\n\t\t}\n\t\tthrow error;\n\t}\n}\n\n/**\n * Invoke a policy with its optional host cancellation signal. The signal is\n * checked before dispatch and after the policy settles; revocation remains\n * the stronger lifecycle error when both happen during one invocation.\n */\nexport async function invokeRegisteredCapabilityWithSignal<T, TResult>(\n\tstate: CapabilityRuntimeState,\n\tregistered: RegisteredCapability<T>,\n\tsignal: AbortSignal | undefined,\n\tinvoke: (value: T) => TResult | PromiseLike<TResult>,\n): Promise<TResult> {\n\tif (signal?.aborted) throw cancellationError(signal.reason);\n\ttry {\n\t\tconst result = await invokeRegisteredCapability(state, registered, invoke);\n\t\tif (signal?.aborted) throw cancellationError(signal.reason);\n\t\treturn result;\n\t} catch (error) {\n\t\tif (!state.activeOwnerTokens.has(registered.ownerToken)) {\n\t\t\tthrow createRevokedCapabilityError(registered.owner);\n\t\t}\n\t\tif (signal?.aborted) throw cancellationError(signal.reason);\n\t\tthrow error;\n\t}\n}\n\nexport async function invokePluginCapability<TResult>(\n\tstate: CapabilityRuntimeState,\n\tregistered: RegisteredPluginCapability,\n\tinput: unknown,\n\tsignal: AbortSignal,\n): Promise<TResult> {\n\tassertRegisteredCapabilityActive(state, registered as unknown as RegisteredCapability<unknown>);\n\ttry {\n\t\tconst result = await registered.handler(detachedSnapshot(input), { signal });\n\t\tassertRegisteredCapabilityActive(state, registered as unknown as RegisteredCapability<unknown>);\n\t\treturn detachedSnapshot(result) as TResult;\n\t} catch (error) {\n\t\tif (!state.activeOwnerTokens.has(registered.ownerToken)) throw createRevokedCapabilityError(registered.owner);\n\t\tthrow error;\n\t}\n}\n\nexport function trackOperation<TResult>(\n\tstate: CapabilityRuntimeState,\n\townerTokens: readonly symbol[],\n\thandle: OperationHandle<TResult>,\n): OperationHandle<TResult> {\n\tfor (const ownerToken of ownerTokens) {\n\t\tconst handles = state.activeOperationsByOwnerToken.get(ownerToken) ?? new Set<OperationHandle<unknown>>();\n\t\thandles.add(handle as OperationHandle<unknown>);\n\t\tstate.activeOperationsByOwnerToken.set(ownerToken, handles);\n\t}\n\tconst remove = () => {\n\t\tfor (const ownerToken of ownerTokens) {\n\t\t\tconst handles = state.activeOperationsByOwnerToken.get(ownerToken);\n\t\t\tif (!handles) continue;\n\t\t\thandles.delete(handle as OperationHandle<unknown>);\n\t\t\tif (handles.size === 0) state.activeOperationsByOwnerToken.delete(ownerToken);\n\t\t}\n\t};\n\tvoid handle.result.then(remove, remove);\n\treturn handle;\n}\n\nexport function cancelOwnedOperations(state: CapabilityRuntimeState, ownerToken: symbol, owner: string): void {\n\tconst handles = state.activeOperationsByOwnerToken.get(ownerToken);\n\tif (!handles) return;\n\tstate.activeOperationsByOwnerToken.delete(ownerToken);\n\tconst reason = createRevokedCapabilityError(owner);\n\tfor (const handle of handles) void handle.cancel(reason.message);\n}\n"]}

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

@@ -0,0 +1,10 @@
+import type { CapabilityToolContext } from "./public-api.ts";
+export type CapabilityToolHandler = (input: unknown, context?: CapabilityToolContext, signal?: AbortSignal) => unknown | Promise<unknown>;
+/**
+ * Preserves unary tool calls while exposing the host-injected tool context and
+ * cancellation through the public runtime facade. The context stays undefined
+ * when the host does not configure CapabilityRuntimeOptions.toolExecutionContext,
+ * so single-parameter tools and dual-call-convention tools keep their shape.
+ */
+export declare function invokeCapabilityTool(handler: CapabilityToolHandler, input: unknown, context: CapabilityToolContext | undefined, signal: AbortSignal | undefined): unknown | Promise<unknown>;
+//# sourceMappingURL=capability-runtime-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capability-runtime-tool.d.ts","sourceRoot":"","sources":["../../../src/core/extensions/capability-runtime-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAE7D,MAAM,MAAM,qBAAqB,GAAG,CACnC,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,qBAAqB,EAC/B,MAAM,CAAC,EAAE,WAAW,KAChB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEhC;;;;;GAKG;AACH,wBAAgB,oBAAoB,CACnC,OAAO,EAAE,qBAAqB,EAC9B,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,qBAAqB,GAAG,SAAS,EAC1C,MAAM,EAAE,WAAW,GAAG,SAAS,GAC7B,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAE5B","sourcesContent":["import type { CapabilityToolContext } from \"./public-api.ts\";\n\nexport type CapabilityToolHandler = (\n\tinput: unknown,\n\tcontext?: CapabilityToolContext,\n\tsignal?: AbortSignal,\n) => unknown | Promise<unknown>;\n\n/**\n * Preserves unary tool calls while exposing the host-injected tool context and\n * cancellation through the public runtime facade. The context stays undefined\n * when the host does not configure CapabilityRuntimeOptions.toolExecutionContext,\n * so single-parameter tools and dual-call-convention tools keep their shape.\n */\nexport function invokeCapabilityTool(\n\thandler: CapabilityToolHandler,\n\tinput: unknown,\n\tcontext: CapabilityToolContext | undefined,\n\tsignal: AbortSignal | undefined,\n): unknown | Promise<unknown> {\n\treturn signal === undefined ? handler(input, context) : handler(input, context, signal);\n}\n"]}

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

@@ -0,0 +1,10 @@
+/**
+ * Preserves unary tool calls while exposing the host-injected tool context and
+ * cancellation through the public runtime facade. The context stays undefined
+ * when the host does not configure CapabilityRuntimeOptions.toolExecutionContext,
+ * so single-parameter tools and dual-call-convention tools keep their shape.
+ */
+export function invokeCapabilityTool(handler, input, context, signal) {
+    return signal === undefined ? handler(input, context) : handler(input, context, signal);
+}
+//# sourceMappingURL=capability-runtime-tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capability-runtime-tool.js","sourceRoot":"","sources":["../../../src/core/extensions/capability-runtime-tool.ts"],"names":[],"mappings":"AAQA;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CACnC,OAA8B,EAC9B,KAAc,EACd,OAA0C,EAC1C,MAA+B,EACF;IAC7B,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAAA,CACxF","sourcesContent":["import type { CapabilityToolContext } from \"./public-api.ts\";\n\nexport type CapabilityToolHandler = (\n\tinput: unknown,\n\tcontext?: CapabilityToolContext,\n\tsignal?: AbortSignal,\n) => unknown | Promise<unknown>;\n\n/**\n * Preserves unary tool calls while exposing the host-injected tool context and\n * cancellation through the public runtime facade. The context stays undefined\n * when the host does not configure CapabilityRuntimeOptions.toolExecutionContext,\n * so single-parameter tools and dual-call-convention tools keep their shape.\n */\nexport function invokeCapabilityTool(\n\thandler: CapabilityToolHandler,\n\tinput: unknown,\n\tcontext: CapabilityToolContext | undefined,\n\tsignal: AbortSignal | undefined,\n): unknown | Promise<unknown> {\n\treturn signal === undefined ? handler(input, context) : handler(input, context, signal);\n}\n"]}