@ai-agent-forge/agent-forge 0.85.0

package/dist/plugins/subagent-task/runner-entry.d.ts

@@ -0,0 +1,35 @@
+/**
+ * subagent-task runner 进程入口（D-045 / pooled 切片增量 2）。
+ *
+ * 把一个 headless 进程变成 runner：stdio 上跑 `createSubagentTaskServer`，会话工厂
+ * 由宿主注入（生产侧装配 `createAgentSession` + `HEADLESS_INTERACTION_HOST`，
+ * 测试注入 fake）。进程退出时清理全部未终态 session。
+ *
+ * 约定：本函数持有进程直到 stdin 关闭或 dispose；不自行打印日志到 stdout
+ * （stdout 是协议通道），诊断走 stderr。
+ */
+import type { Readable, Writable } from "node:stream";
+import { type SubagentTaskEnvelopeV1, type SubagentTaskSessionV1 } from "@agent-forge/protocol/subagent";
+export interface SubagentTaskRunnerOptionsV1 {
+    readonly input: Readable;
+    readonly output: Writable;
+    /** 会话工厂：生产侧装配真实 AgentSession，测试注入 fake（同一契约）。 */
+    createSession(request: {
+        prompt: string;
+        profile?: unknown;
+        parentSessionId?: string;
+    }): Promise<SubagentTaskSessionV1>;
+    readonly maxMessages?: number;
+    readonly maxResultBytes?: number;
+    /** 诊断出口（默认 stderr）；协议通道之外的日志一律走这里。 */
+    readonly log?: (message: string) => void;
+}
+export interface SubagentTaskRunnerHandleV1 {
+    /** 读到 stdin 关闭为止；runner 进程通常 await 它以保持存活。 */
+    done: Promise<void>;
+    dispose(): Promise<void>;
+}
+export declare function runSubagentTaskRunner(options: SubagentTaskRunnerOptionsV1): SubagentTaskRunnerHandleV1;
+/** 供 runner 侧调试/测试使用：把信封写到 stderr 的可读形式（不污染 stdout 协议通道）。 */
+export declare function describeSubagentTaskEnvelopeV1(env: SubagentTaskEnvelopeV1): string;
+//# sourceMappingURL=runner-entry.d.ts.map

package/dist/plugins/subagent-task/runner-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-entry.d.ts","sourceRoot":"","sources":["../../../src/plugins/subagent-task/runner-entry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAGN,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,MAAM,gCAAgC,CAAC;AAExC,MAAM,WAAW,2BAA2B;IAC3C,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,iGAAiD;IACjD,aAAa,CAAC,OAAO,EAAE;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,eAAe,CAAC,EAAE,MAAM,CAAC;KACzB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,sFAAsC;IACtC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,0BAA0B;IAC1C,kFAA8C;IAC9C,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACpB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,2BAA2B,GAAG,0BAA0B,CA+BtG;AAED,uHAA6D;AAC7D,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,sBAAsB,GAAG,MAAM,CAIlF","sourcesContent":["/**\n * subagent-task runner 进程入口（D-045 / pooled 切片增量 2）。\n *\n * 把一个 headless 进程变成 runner：stdio 上跑 `createSubagentTaskServer`，会话工厂\n * 由宿主注入（生产侧装配 `createAgentSession` + `HEADLESS_INTERACTION_HOST`，\n * 测试注入 fake）。进程退出时清理全部未终态 session。\n *\n * 约定：本函数持有进程直到 stdin 关闭或 dispose；不自行打印日志到 stdout\n * （stdout 是协议通道），诊断走 stderr。\n */\nimport type { Readable, Writable } from \"node:stream\";\nimport {\n\tcreateSubagentTaskServer,\n\tcreateSubagentTaskStdioChannelV1,\n\ttype SubagentTaskEnvelopeV1,\n\ttype SubagentTaskSessionV1,\n} from \"@agent-forge/protocol/subagent\";\n\nexport interface SubagentTaskRunnerOptionsV1 {\n\treadonly input: Readable;\n\treadonly output: Writable;\n\t/** 会话工厂：生产侧装配真实 AgentSession，测试注入 fake（同一契约）。 */\n\tcreateSession(request: {\n\t\tprompt: string;\n\t\tprofile?: unknown;\n\t\tparentSessionId?: string;\n\t}): Promise<SubagentTaskSessionV1>;\n\treadonly maxMessages?: number;\n\treadonly maxResultBytes?: number;\n\t/** 诊断出口（默认 stderr）；协议通道之外的日志一律走这里。 */\n\treadonly log?: (message: string) => void;\n}\n\nexport interface SubagentTaskRunnerHandleV1 {\n\t/** 读到 stdin 关闭为止；runner 进程通常 await 它以保持存活。 */\n\tdone: Promise<void>;\n\tdispose(): Promise<void>;\n}\n\nexport function runSubagentTaskRunner(options: SubagentTaskRunnerOptionsV1): SubagentTaskRunnerHandleV1 {\n\tconst log = options.log ?? ((message: string): void => void process.stderr.write(`${message}\\n`));\n\tconst channel = createSubagentTaskStdioChannelV1({ input: options.input, output: options.output });\n\tconst server = createSubagentTaskServer(\n\t\t{\n\t\t\tcreateSession: options.createSession,\n\t\t\t...(options.maxMessages === undefined ? {} : { maxMessages: options.maxMessages }),\n\t\t\t...(options.maxResultBytes === undefined ? {} : { maxResultBytes: options.maxResultBytes }),\n\t\t},\n\t\tchannel,\n\t);\n\n\tconst done = (async () => {\n\t\ttry {\n\t\t\tfor await (const env of channel) {\n\t\t\t\tawait server.handle(env);\n\t\t\t}\n\t\t\tlog(\"subagent runner: input closed\");\n\t\t} catch (error) {\n\t\t\tlog(`subagent runner: channel failed: ${error instanceof Error ? error.message : String(error)}`);\n\t\t} finally {\n\t\t\tawait server.dispose();\n\t\t}\n\t})();\n\n\treturn {\n\t\tdone,\n\t\tasync dispose(): Promise<void> {\n\t\t\tawait server.dispose();\n\t\t},\n\t};\n}\n\n/** 供 runner 侧调试/测试使用：把信封写到 stderr 的可读形式（不污染 stdout 协议通道）。 */\nexport function describeSubagentTaskEnvelopeV1(env: SubagentTaskEnvelopeV1): string {\n\tif (env.kind === \"request\") return `request ${env.op} id=${env.id} task=${env.taskId ?? \"-\"}`;\n\tif (env.kind === \"event\") return `event ${env.type} task=${env.taskId} seq=${env.seq}`;\n\treturn `response id=${env.id} ok=${env.ok}`;\n}\n"]}

package/dist/plugins/subagent-task/runner-entry.js

@@ -0,0 +1,39 @@
+import { createSubagentTaskServer, createSubagentTaskStdioChannelV1, } from "@agent-forge/protocol/subagent";
+export function runSubagentTaskRunner(options) {
+    const log = options.log ?? ((message) => void process.stderr.write(`${message}\n`));
+    const channel = createSubagentTaskStdioChannelV1({ input: options.input, output: options.output });
+    const server = createSubagentTaskServer({
+        createSession: options.createSession,
+        ...(options.maxMessages === undefined ? {} : { maxMessages: options.maxMessages }),
+        ...(options.maxResultBytes === undefined ? {} : { maxResultBytes: options.maxResultBytes }),
+    }, channel);
+    const done = (async () => {
+        try {
+            for await (const env of channel) {
+                await server.handle(env);
+            }
+            log("subagent runner: input closed");
+        }
+        catch (error) {
+            log(`subagent runner: channel failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        finally {
+            await server.dispose();
+        }
+    })();
+    return {
+        done,
+        async dispose() {
+            await server.dispose();
+        },
+    };
+}
+/** 供 runner 侧调试/测试使用：把信封写到 stderr 的可读形式（不污染 stdout 协议通道）。 */
+export function describeSubagentTaskEnvelopeV1(env) {
+    if (env.kind === "request")
+        return `request ${env.op} id=${env.id} task=${env.taskId ?? "-"}`;
+    if (env.kind === "event")
+        return `event ${env.type} task=${env.taskId} seq=${env.seq}`;
+    return `response id=${env.id} ok=${env.ok}`;
+}
+//# sourceMappingURL=runner-entry.js.map

package/dist/plugins/subagent-task/runner-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-entry.js","sourceRoot":"","sources":["../../../src/plugins/subagent-task/runner-entry.ts"],"names":[],"mappings":"AAWA,OAAO,EACN,wBAAwB,EACxB,gCAAgC,GAGhC,MAAM,gCAAgC,CAAC;AAuBxC,MAAM,UAAU,qBAAqB,CAAC,OAAoC,EAA8B;IACvG,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,OAAe,EAAQ,EAAE,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC,CAAC;IAClG,MAAM,OAAO,GAAG,gCAAgC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACnG,MAAM,MAAM,GAAG,wBAAwB,CACtC;QACC,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,GAAG,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;QAClF,GAAG,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC;KAC3F,EACD,OAAO,CACP,CAAC;IAEF,MAAM,IAAI,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;QACzB,IAAI,CAAC;YACJ,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;gBACjC,MAAM,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC1B,CAAC;YACD,GAAG,CAAC,+BAA+B,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,GAAG,CAAC,oCAAoC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACnG,CAAC;gBAAS,CAAC;YACV,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QACxB,CAAC;IAAA,CACD,CAAC,EAAE,CAAC;IAEL,OAAO;QACN,IAAI;QACJ,KAAK,CAAC,OAAO,GAAkB;YAC9B,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QAAA,CACvB;KACD,CAAC;AAAA,CACF;AAED,uHAA6D;AAC7D,MAAM,UAAU,8BAA8B,CAAC,GAA2B,EAAU;IACnF,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,WAAW,GAAG,CAAC,EAAE,OAAO,GAAG,CAAC,EAAE,SAAS,GAAG,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;IAC9F,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,SAAS,GAAG,CAAC,IAAI,SAAS,GAAG,CAAC,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,CAAC;IACvF,OAAO,eAAe,GAAG,CAAC,EAAE,OAAO,GAAG,CAAC,EAAE,EAAE,CAAC;AAAA,CAC5C","sourcesContent":["/**\n * subagent-task runner 进程入口（D-045 / pooled 切片增量 2）。\n *\n * 把一个 headless 进程变成 runner：stdio 上跑 `createSubagentTaskServer`，会话工厂\n * 由宿主注入（生产侧装配 `createAgentSession` + `HEADLESS_INTERACTION_HOST`，\n * 测试注入 fake）。进程退出时清理全部未终态 session。\n *\n * 约定：本函数持有进程直到 stdin 关闭或 dispose；不自行打印日志到 stdout\n * （stdout 是协议通道），诊断走 stderr。\n */\nimport type { Readable, Writable } from \"node:stream\";\nimport {\n\tcreateSubagentTaskServer,\n\tcreateSubagentTaskStdioChannelV1,\n\ttype SubagentTaskEnvelopeV1,\n\ttype SubagentTaskSessionV1,\n} from \"@agent-forge/protocol/subagent\";\n\nexport interface SubagentTaskRunnerOptionsV1 {\n\treadonly input: Readable;\n\treadonly output: Writable;\n\t/** 会话工厂：生产侧装配真实 AgentSession，测试注入 fake（同一契约）。 */\n\tcreateSession(request: {\n\t\tprompt: string;\n\t\tprofile?: unknown;\n\t\tparentSessionId?: string;\n\t}): Promise<SubagentTaskSessionV1>;\n\treadonly maxMessages?: number;\n\treadonly maxResultBytes?: number;\n\t/** 诊断出口（默认 stderr）；协议通道之外的日志一律走这里。 */\n\treadonly log?: (message: string) => void;\n}\n\nexport interface SubagentTaskRunnerHandleV1 {\n\t/** 读到 stdin 关闭为止；runner 进程通常 await 它以保持存活。 */\n\tdone: Promise<void>;\n\tdispose(): Promise<void>;\n}\n\nexport function runSubagentTaskRunner(options: SubagentTaskRunnerOptionsV1): SubagentTaskRunnerHandleV1 {\n\tconst log = options.log ?? ((message: string): void => void process.stderr.write(`${message}\\n`));\n\tconst channel = createSubagentTaskStdioChannelV1({ input: options.input, output: options.output });\n\tconst server = createSubagentTaskServer(\n\t\t{\n\t\t\tcreateSession: options.createSession,\n\t\t\t...(options.maxMessages === undefined ? {} : { maxMessages: options.maxMessages }),\n\t\t\t...(options.maxResultBytes === undefined ? {} : { maxResultBytes: options.maxResultBytes }),\n\t\t},\n\t\tchannel,\n\t);\n\n\tconst done = (async () => {\n\t\ttry {\n\t\t\tfor await (const env of channel) {\n\t\t\t\tawait server.handle(env);\n\t\t\t}\n\t\t\tlog(\"subagent runner: input closed\");\n\t\t} catch (error) {\n\t\t\tlog(`subagent runner: channel failed: ${error instanceof Error ? error.message : String(error)}`);\n\t\t} finally {\n\t\t\tawait server.dispose();\n\t\t}\n\t})();\n\n\treturn {\n\t\tdone,\n\t\tasync dispose(): Promise<void> {\n\t\t\tawait server.dispose();\n\t\t},\n\t};\n}\n\n/** 供 runner 侧调试/测试使用：把信封写到 stderr 的可读形式（不污染 stdout 协议通道）。 */\nexport function describeSubagentTaskEnvelopeV1(env: SubagentTaskEnvelopeV1): string {\n\tif (env.kind === \"request\") return `request ${env.op} id=${env.id} task=${env.taskId ?? \"-\"}`;\n\tif (env.kind === \"event\") return `event ${env.type} task=${env.taskId} seq=${env.seq}`;\n\treturn `response id=${env.id} ok=${env.ok}`;\n}\n"]}

package/dist/plugins/subagent-task/session-factory.d.ts

@@ -0,0 +1,57 @@
+/**
+ * subagent-task 会话工厂（D-045 / pooled 切片增量 2b）。
+ *
+ * 把真实 AgentSession（`createAgentSession` 产物）适配成 runner server 使用的
+ * `SubagentTaskSessionV1`：`prompt()` 的 `PromptOutcome.aborted` 正常终局映射为
+ * `{ status: "aborted" }`（与本地 SDK child 适配器同一语义来源）；signal 中止经
+ * `session.abort()` 中断；dispose 释放会话。宿主以结构类型注入会话，本文件不直接
+ * 依赖 AgentSession 类，便于测试与解耦。
+ */
+import type { SubagentTaskAppliedProfileV1, SubagentTaskSessionV1 } from "@agent-forge/protocol/subagent";
+/** 会话宿主最小面（AgentSession 的结构子集）。 */
+export interface SubagentTaskSessionHostV1 {
+    prompt(text: string, options?: {
+        expandPromptTemplates?: boolean;
+    }): Promise<{
+        status: "done";
+    } | {
+        status: "aborted";
+        reason: string;
+    }>;
+    /** 中断 in-flight 回合；reason 取会话的 TurnAbortReason 词汇（本地 child 路径同样不透传调度器 reason）。 */
+    abort(reason?: "interrupted" | "replaced"): Promise<void>;
+    dispose(): Promise<void>;
+    getMessages(): readonly unknown[];
+    getSessionId(): string;
+    /**
+     * 可选的进度订阅（订阅会话事件）；缺省 = 无 progress 事件。
+     * D-044 §5.6 的进度源就是这里：宿主把会话事件流转成"回合级 step"提示。
+     */
+    onProgress?: (handler: (message: string) => void) => (() => void) | undefined;
+    /**
+     * 可选的叶子会话事实（工具面/模型/模式）：带档案的 create 由 server 侧核验，
+     * 缺失即视为"无法自证"并拒绝该 create。
+     */
+    facts?: () => SubagentTaskAppliedProfileV1;
+    /** 父→子引导（D-060 S5 pooled parity）：转发叶子会话自身的 steer 语义；缺省 = 不支持。 */
+    steer?: (text: string) => Promise<void>;
+}
+export interface SubagentTaskSessionFactoryOptionsV1 {
+    /** 每任务新建一个独立会话（runner 内并发承载多个任务）；`profile` 为上游档案（可能缺省）。 */
+    createSession(request: {
+        profile?: unknown;
+        parentSessionId?: string;
+        /** resume 目标（D-060 S5 pooled parity）：打开既有会话文件续写而非新建。 */
+        resumeSessionId?: string;
+        /** 回合级血缘：创建子会话的父回合 correlationId，仅 create 新建消费（resume 不适用）。 */
+        parentTraceId?: string;
+    }): Promise<SubagentTaskSessionHostV1>;
+}
+export declare function createSubagentTaskSessionFactoryV1(options: SubagentTaskSessionFactoryOptionsV1): (request: {
+    prompt: string;
+    profile?: unknown;
+    parentSessionId?: string;
+    resumeSessionId?: string;
+    parentTraceId?: string;
+}) => Promise<SubagentTaskSessionV1>;
+//# sourceMappingURL=session-factory.d.ts.map

package/dist/plugins/subagent-task/session-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-factory.d.ts","sourceRoot":"","sources":["../../../src/plugins/subagent-task/session-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,4BAA4B,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAE1G,iEAAmC;AACnC,MAAM,WAAW,yBAAyB;IACzC,MAAM,CACL,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,qBAAqB,CAAC,EAAE,OAAO,CAAA;KAAE,GAC3C,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,MAAM,EAAE,SAAS,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvE,sIAAkF;IAClF,KAAK,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,WAAW,IAAI,SAAS,OAAO,EAAE,CAAC;IAClC,YAAY,IAAI,MAAM,CAAC;IACvB;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IAC9E;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,4BAA4B,CAAC;IAC3C,qHAAiE;IACjE,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,mCAAmC;IACnD,iIAA2D;IAC3D,aAAa,CAAC,OAAO,EAAE;QACtB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,gGAAwD;QACxD,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,qHAA+D;QAC/D,aAAa,CAAC,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;CACvC;AAED,wBAAgB,kCAAkC,CACjD,OAAO,EAAE,mCAAmC,GAC1C,CAAC,OAAO,EAAE;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAgDnC","sourcesContent":["/**\n * subagent-task 会话工厂（D-045 / pooled 切片增量 2b）。\n *\n * 把真实 AgentSession（`createAgentSession` 产物）适配成 runner server 使用的\n * `SubagentTaskSessionV1`：`prompt()` 的 `PromptOutcome.aborted` 正常终局映射为\n * `{ status: \"aborted\" }`（与本地 SDK child 适配器同一语义来源）；signal 中止经\n * `session.abort()` 中断；dispose 释放会话。宿主以结构类型注入会话，本文件不直接\n * 依赖 AgentSession 类，便于测试与解耦。\n */\nimport type { SubagentTaskAppliedProfileV1, SubagentTaskSessionV1 } from \"@agent-forge/protocol/subagent\";\n\n/** 会话宿主最小面（AgentSession 的结构子集）。 */\nexport interface SubagentTaskSessionHostV1 {\n\tprompt(\n\t\ttext: string,\n\t\toptions?: { expandPromptTemplates?: boolean },\n\t): Promise<{ status: \"done\" } | { status: \"aborted\"; reason: string }>;\n\t/** 中断 in-flight 回合；reason 取会话的 TurnAbortReason 词汇（本地 child 路径同样不透传调度器 reason）。 */\n\tabort(reason?: \"interrupted\" | \"replaced\"): Promise<void>;\n\tdispose(): Promise<void>;\n\tgetMessages(): readonly unknown[];\n\tgetSessionId(): string;\n\t/**\n\t * 可选的进度订阅（订阅会话事件）；缺省 = 无 progress 事件。\n\t * D-044 §5.6 的进度源就是这里：宿主把会话事件流转成\"回合级 step\"提示。\n\t */\n\tonProgress?: (handler: (message: string) => void) => (() => void) | undefined;\n\t/**\n\t * 可选的叶子会话事实（工具面/模型/模式）：带档案的 create 由 server 侧核验，\n\t * 缺失即视为\"无法自证\"并拒绝该 create。\n\t */\n\tfacts?: () => SubagentTaskAppliedProfileV1;\n\t/** 父→子引导（D-060 S5 pooled parity）：转发叶子会话自身的 steer 语义；缺省 = 不支持。 */\n\tsteer?: (text: string) => Promise<void>;\n}\n\nexport interface SubagentTaskSessionFactoryOptionsV1 {\n\t/** 每任务新建一个独立会话（runner 内并发承载多个任务）；`profile` 为上游档案（可能缺省）。 */\n\tcreateSession(request: {\n\t\tprofile?: unknown;\n\t\tparentSessionId?: string;\n\t\t/** resume 目标（D-060 S5 pooled parity）：打开既有会话文件续写而非新建。 */\n\t\tresumeSessionId?: string;\n\t\t/** 回合级血缘：创建子会话的父回合 correlationId，仅 create 新建消费（resume 不适用）。 */\n\t\tparentTraceId?: string;\n\t}): Promise<SubagentTaskSessionHostV1>;\n}\n\nexport function createSubagentTaskSessionFactoryV1(\n\toptions: SubagentTaskSessionFactoryOptionsV1,\n): (request: {\n\tprompt: string;\n\tprofile?: unknown;\n\tparentSessionId?: string;\n\tresumeSessionId?: string;\n\tparentTraceId?: string;\n}) => Promise<SubagentTaskSessionV1> {\n\treturn async (request) => {\n\t\tconst host = await options.createSession({\n\t\t\t...(request.profile === undefined ? {} : { profile: request.profile }),\n\t\t\t...(request.parentSessionId === undefined ? {} : { parentSessionId: request.parentSessionId }),\n\t\t\t...(request.resumeSessionId === undefined ? {} : { resumeSessionId: request.resumeSessionId }),\n\t\t\t...(request.parentTraceId === undefined ? {} : { parentTraceId: request.parentTraceId }),\n\t\t});\n\t\tconst session: SubagentTaskSessionV1 = {\n\t\t\trun: async (prompt, signal) => {\n\t\t\t\tvoid request;\n\t\t\t\tconst abort = (): void => {\n\t\t\t\t\t// 会话侧 reason 词汇受限（interrupted | replaced）：调度器的取消原因不透传，\n\t\t\t\t\t// 与本地 SDK child 适配器的 abort() 语义一致。\n\t\t\t\t\tvoid host.abort(\"interrupted\").catch(() => {});\n\t\t\t\t};\n\t\t\t\tif (signal.aborted) {\n\t\t\t\t\tawait abort();\n\t\t\t\t\treturn { status: \"aborted\", reason: \"interrupted\" };\n\t\t\t\t}\n\t\t\t\tsignal.addEventListener(\"abort\", abort, { once: true });\n\t\t\t\ttry {\n\t\t\t\t\tconst outcome = await host.prompt(prompt, { expandPromptTemplates: false });\n\t\t\t\t\treturn outcome.status === \"done\" ? { status: \"done\" } : { status: \"aborted\", reason: outcome.reason };\n\t\t\t\t} finally {\n\t\t\t\t\tsignal.removeEventListener(\"abort\", abort);\n\t\t\t\t}\n\t\t\t},\n\t\t\tcancel: async () => {\n\t\t\t\tawait host.abort(\"interrupted\");\n\t\t\t},\n\t\t\tdispose: async () => {\n\t\t\t\tawait host.dispose();\n\t\t\t},\n\t\t\tgetMessages: () => host.getMessages(),\n\t\t\tgetSessionId: () => host.getSessionId(),\n\t\t};\n\t\tif (host.onProgress !== undefined) {\n\t\t\tsession.onProgress = (handler) => host.onProgress?.(handler);\n\t\t}\n\t\tif (host.facts !== undefined) {\n\t\t\tsession.facts = () => host.facts?.() ?? {};\n\t\t}\n\t\tif (host.steer !== undefined) {\n\t\t\tsession.steer = (text) => host.steer?.(text) ?? Promise.resolve();\n\t\t}\n\t\treturn session;\n\t};\n}\n"]}

package/dist/plugins/subagent-task/session-factory.js

@@ -0,0 +1,51 @@
+export function createSubagentTaskSessionFactoryV1(options) {
+    return async (request) => {
+        const host = await options.createSession({
+            ...(request.profile === undefined ? {} : { profile: request.profile }),
+            ...(request.parentSessionId === undefined ? {} : { parentSessionId: request.parentSessionId }),
+            ...(request.resumeSessionId === undefined ? {} : { resumeSessionId: request.resumeSessionId }),
+            ...(request.parentTraceId === undefined ? {} : { parentTraceId: request.parentTraceId }),
+        });
+        const session = {
+            run: async (prompt, signal) => {
+                void request;
+                const abort = () => {
+                    // 会话侧 reason 词汇受限（interrupted | replaced）：调度器的取消原因不透传，
+                    // 与本地 SDK child 适配器的 abort() 语义一致。
+                    void host.abort("interrupted").catch(() => { });
+                };
+                if (signal.aborted) {
+                    await abort();
+                    return { status: "aborted", reason: "interrupted" };
+                }
+                signal.addEventListener("abort", abort, { once: true });
+                try {
+                    const outcome = await host.prompt(prompt, { expandPromptTemplates: false });
+                    return outcome.status === "done" ? { status: "done" } : { status: "aborted", reason: outcome.reason };
+                }
+                finally {
+                    signal.removeEventListener("abort", abort);
+                }
+            },
+            cancel: async () => {
+                await host.abort("interrupted");
+            },
+            dispose: async () => {
+                await host.dispose();
+            },
+            getMessages: () => host.getMessages(),
+            getSessionId: () => host.getSessionId(),
+        };
+        if (host.onProgress !== undefined) {
+            session.onProgress = (handler) => host.onProgress?.(handler);
+        }
+        if (host.facts !== undefined) {
+            session.facts = () => host.facts?.() ?? {};
+        }
+        if (host.steer !== undefined) {
+            session.steer = (text) => host.steer?.(text) ?? Promise.resolve();
+        }
+        return session;
+    };
+}
+//# sourceMappingURL=session-factory.js.map

package/dist/plugins/subagent-task/session-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-factory.js","sourceRoot":"","sources":["../../../src/plugins/subagent-task/session-factory.ts"],"names":[],"mappings":"AAgDA,MAAM,UAAU,kCAAkC,CACjD,OAA4C,EAOR;IACpC,OAAO,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC;YACxC,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;YACtE,GAAG,CAAC,OAAO,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC;YAC9F,GAAG,CAAC,OAAO,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC;YAC9F,GAAG,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC;SACxF,CAAC,CAAC;QACH,MAAM,OAAO,GAA0B;YACtC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;gBAC9B,KAAK,OAAO,CAAC;gBACb,MAAM,KAAK,GAAG,GAAS,EAAE,CAAC;oBACzB,mGAAuD;oBACvD,2DAAmC;oBACnC,KAAK,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAC,CAAC,CAAC,CAAC;gBAAA,CAC/C,CAAC;gBACF,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBACpB,MAAM,KAAK,EAAE,CAAC;oBACd,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;gBACrD,CAAC;gBACD,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;gBACxD,IAAI,CAAC;oBACJ,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,qBAAqB,EAAE,KAAK,EAAE,CAAC,CAAC;oBAC5E,OAAO,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;gBACvG,CAAC;wBAAS,CAAC;oBACV,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;gBAC5C,CAAC;YAAA,CACD;YACD,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC;gBACnB,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;YAAA,CAChC;YACD,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;gBACpB,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;YAAA,CACrB;YACD,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE;YACrC,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE;SACvC,CAAC;QACF,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACnC,OAAO,CAAC,UAAU,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO,CAAC,KAAK,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC;QAC5C,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO,CAAC,KAAK,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACnE,CAAC;QACD,OAAO,OAAO,CAAC;IAAA,CACf,CAAC;AAAA,CACF","sourcesContent":["/**\n * subagent-task 会话工厂（D-045 / pooled 切片增量 2b）。\n *\n * 把真实 AgentSession（`createAgentSession` 产物）适配成 runner server 使用的\n * `SubagentTaskSessionV1`：`prompt()` 的 `PromptOutcome.aborted` 正常终局映射为\n * `{ status: \"aborted\" }`（与本地 SDK child 适配器同一语义来源）；signal 中止经\n * `session.abort()` 中断；dispose 释放会话。宿主以结构类型注入会话，本文件不直接\n * 依赖 AgentSession 类，便于测试与解耦。\n */\nimport type { SubagentTaskAppliedProfileV1, SubagentTaskSessionV1 } from \"@agent-forge/protocol/subagent\";\n\n/** 会话宿主最小面（AgentSession 的结构子集）。 */\nexport interface SubagentTaskSessionHostV1 {\n\tprompt(\n\t\ttext: string,\n\t\toptions?: { expandPromptTemplates?: boolean },\n\t): Promise<{ status: \"done\" } | { status: \"aborted\"; reason: string }>;\n\t/** 中断 in-flight 回合；reason 取会话的 TurnAbortReason 词汇（本地 child 路径同样不透传调度器 reason）。 */\n\tabort(reason?: \"interrupted\" | \"replaced\"): Promise<void>;\n\tdispose(): Promise<void>;\n\tgetMessages(): readonly unknown[];\n\tgetSessionId(): string;\n\t/**\n\t * 可选的进度订阅（订阅会话事件）；缺省 = 无 progress 事件。\n\t * D-044 §5.6 的进度源就是这里：宿主把会话事件流转成\"回合级 step\"提示。\n\t */\n\tonProgress?: (handler: (message: string) => void) => (() => void) | undefined;\n\t/**\n\t * 可选的叶子会话事实（工具面/模型/模式）：带档案的 create 由 server 侧核验，\n\t * 缺失即视为\"无法自证\"并拒绝该 create。\n\t */\n\tfacts?: () => SubagentTaskAppliedProfileV1;\n\t/** 父→子引导（D-060 S5 pooled parity）：转发叶子会话自身的 steer 语义；缺省 = 不支持。 */\n\tsteer?: (text: string) => Promise<void>;\n}\n\nexport interface SubagentTaskSessionFactoryOptionsV1 {\n\t/** 每任务新建一个独立会话（runner 内并发承载多个任务）；`profile` 为上游档案（可能缺省）。 */\n\tcreateSession(request: {\n\t\tprofile?: unknown;\n\t\tparentSessionId?: string;\n\t\t/** resume 目标（D-060 S5 pooled parity）：打开既有会话文件续写而非新建。 */\n\t\tresumeSessionId?: string;\n\t\t/** 回合级血缘：创建子会话的父回合 correlationId，仅 create 新建消费（resume 不适用）。 */\n\t\tparentTraceId?: string;\n\t}): Promise<SubagentTaskSessionHostV1>;\n}\n\nexport function createSubagentTaskSessionFactoryV1(\n\toptions: SubagentTaskSessionFactoryOptionsV1,\n): (request: {\n\tprompt: string;\n\tprofile?: unknown;\n\tparentSessionId?: string;\n\tresumeSessionId?: string;\n\tparentTraceId?: string;\n}) => Promise<SubagentTaskSessionV1> {\n\treturn async (request) => {\n\t\tconst host = await options.createSession({\n\t\t\t...(request.profile === undefined ? {} : { profile: request.profile }),\n\t\t\t...(request.parentSessionId === undefined ? {} : { parentSessionId: request.parentSessionId }),\n\t\t\t...(request.resumeSessionId === undefined ? {} : { resumeSessionId: request.resumeSessionId }),\n\t\t\t...(request.parentTraceId === undefined ? {} : { parentTraceId: request.parentTraceId }),\n\t\t});\n\t\tconst session: SubagentTaskSessionV1 = {\n\t\t\trun: async (prompt, signal) => {\n\t\t\t\tvoid request;\n\t\t\t\tconst abort = (): void => {\n\t\t\t\t\t// 会话侧 reason 词汇受限（interrupted | replaced）：调度器的取消原因不透传，\n\t\t\t\t\t// 与本地 SDK child 适配器的 abort() 语义一致。\n\t\t\t\t\tvoid host.abort(\"interrupted\").catch(() => {});\n\t\t\t\t};\n\t\t\t\tif (signal.aborted) {\n\t\t\t\t\tawait abort();\n\t\t\t\t\treturn { status: \"aborted\", reason: \"interrupted\" };\n\t\t\t\t}\n\t\t\t\tsignal.addEventListener(\"abort\", abort, { once: true });\n\t\t\t\ttry {\n\t\t\t\t\tconst outcome = await host.prompt(prompt, { expandPromptTemplates: false });\n\t\t\t\t\treturn outcome.status === \"done\" ? { status: \"done\" } : { status: \"aborted\", reason: outcome.reason };\n\t\t\t\t} finally {\n\t\t\t\t\tsignal.removeEventListener(\"abort\", abort);\n\t\t\t\t}\n\t\t\t},\n\t\t\tcancel: async () => {\n\t\t\t\tawait host.abort(\"interrupted\");\n\t\t\t},\n\t\t\tdispose: async () => {\n\t\t\t\tawait host.dispose();\n\t\t\t},\n\t\t\tgetMessages: () => host.getMessages(),\n\t\t\tgetSessionId: () => host.getSessionId(),\n\t\t};\n\t\tif (host.onProgress !== undefined) {\n\t\t\tsession.onProgress = (handler) => host.onProgress?.(handler);\n\t\t}\n\t\tif (host.facts !== undefined) {\n\t\t\tsession.facts = () => host.facts?.() ?? {};\n\t\t}\n\t\tif (host.steer !== undefined) {\n\t\t\tsession.steer = (text) => host.steer?.(text) ?? Promise.resolve();\n\t\t}\n\t\treturn session;\n\t};\n}\n"]}

package/dist/profile/child-facade.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Child Agent lifecycle adapter (2.2b).
+ *
+ * Spawns child agents bound to their parent via the composition's
+ * `parentInstanceId`, with cancel/wait and an independently replayable result
+ * reference (`childInstanceId` + `revision`). Only the public
+ * `AgentCompositionAPI` is consumed.
+ */
+import type { AgentCompositionAPI } from "../core/extensions/public-api.ts";
+export interface ChildAgentResultRefV1 {
+    readonly childInstanceId: string;
+    readonly revision: number;
+}
+export interface ChildAgentTurnV1<TResult = unknown> {
+    readonly childInstanceId: string;
+    /** Stable, replayable identity of the turn result. */
+    readonly resultRef: () => ChildAgentResultRefV1 | undefined;
+    wait(): Promise<{
+        readonly status: "succeeded" | "failed" | "cancelled" | "disposed";
+        readonly output?: TResult;
+        readonly revision: number;
+        readonly error?: Error;
+    }>;
+    cancel(reason?: string): Promise<void>;
+}
+export interface ChildAgentFacadeV1<TInput = unknown, TResult = unknown> {
+    readonly childDefinitionId: string;
+    spawnChild(input: TInput, options?: {
+        readonly signal?: AbortSignal;
+    }): ChildAgentTurnV1<TResult>;
+}
+export declare function createChildAgentFacade<TInput, TResult = unknown>(options: {
+    readonly composition: AgentCompositionAPI;
+    readonly parentInstanceId: string;
+    readonly childDefinitionId?: string;
+    readonly childVersion?: number;
+    readonly owner?: string;
+    /** The child turn implementation (deterministic in tests). */
+    readonly run: (input: TInput, context: {
+        readonly parentInstanceId: string;
+        readonly signal?: AbortSignal;
+    }) => Promise<TResult> | TResult;
+}): ChildAgentFacadeV1<TInput, TResult>;
+//# sourceMappingURL=child-facade.d.ts.map

package/dist/profile/child-facade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-facade.d.ts","sourceRoot":"","sources":["../../src/profile/child-facade.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAE5E,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB,CAAC,OAAO,GAAG,OAAO;IAClD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,sDAAsD;IACtD,QAAQ,CAAC,SAAS,EAAE,MAAM,qBAAqB,GAAG,SAAS,CAAC;IAC5D,IAAI,IAAI,OAAO,CAAC;QACf,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,CAAC;QACnE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;KACvB,CAAC,CAAC;IACH,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,kBAAkB,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IACtE,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;CAClG;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,EAAE,OAAO,EAAE;IAC1E,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAC;IAC1C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,8DAA8D;IAC9D,QAAQ,CAAC,GAAG,EAAE,CACb,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;QAAE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,KACzE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAChC,GAAG,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAwDtC","sourcesContent":["/**\n * Child Agent lifecycle adapter (2.2b).\n *\n * Spawns child agents bound to their parent via the composition's\n * `parentInstanceId`, with cancel/wait and an independently replayable result\n * reference (`childInstanceId` + `revision`). Only the public\n * `AgentCompositionAPI` is consumed.\n */\nimport type { AgentCompositionAPI } from \"../core/extensions/public-api.ts\";\n\nexport interface ChildAgentResultRefV1 {\n\treadonly childInstanceId: string;\n\treadonly revision: number;\n}\n\nexport interface ChildAgentTurnV1<TResult = unknown> {\n\treadonly childInstanceId: string;\n\t/** Stable, replayable identity of the turn result. */\n\treadonly resultRef: () => ChildAgentResultRefV1 | undefined;\n\twait(): Promise<{\n\t\treadonly status: \"succeeded\" | \"failed\" | \"cancelled\" | \"disposed\";\n\t\treadonly output?: TResult;\n\t\treadonly revision: number;\n\t\treadonly error?: Error;\n\t}>;\n\tcancel(reason?: string): Promise<void>;\n}\n\nexport interface ChildAgentFacadeV1<TInput = unknown, TResult = unknown> {\n\treadonly childDefinitionId: string;\n\tspawnChild(input: TInput, options?: { readonly signal?: AbortSignal }): ChildAgentTurnV1<TResult>;\n}\n\nexport function createChildAgentFacade<TInput, TResult = unknown>(options: {\n\treadonly composition: AgentCompositionAPI;\n\treadonly parentInstanceId: string;\n\treadonly childDefinitionId?: string;\n\treadonly childVersion?: number;\n\treadonly owner?: string;\n\t/** The child turn implementation (deterministic in tests). */\n\treadonly run: (\n\t\tinput: TInput,\n\t\tcontext: { readonly parentInstanceId: string; readonly signal?: AbortSignal },\n\t) => Promise<TResult> | TResult;\n}): ChildAgentFacadeV1<TInput, TResult> {\n\tconst childDefinitionId = options.childDefinitionId ?? \"child-agent-controller\";\n\tconst owner = options.owner ?? \"parent\";\n\tconst definition = options.composition.define({\n\t\tid: childDefinitionId,\n\t\tversion: options.childVersion ?? 1,\n\t\trole: \"child-agent-controller\",\n\t\trun: (input: TInput, context: { readonly signal?: AbortSignal }) =>\n\t\t\toptions.run(input, { parentInstanceId: options.parentInstanceId, signal: context?.signal }),\n\t});\n\n\treturn {\n\t\tchildDefinitionId,\n\t\tspawnChild(input, spawnOptions): ChildAgentTurnV1<TResult> {\n\t\t\tconst instance = options.composition.create<TInput, TResult>(definition, {\n\t\t\t\tparentInstanceId: options.parentInstanceId,\n\t\t\t});\n\t\t\tconst childInstanceId = instance.id;\n\t\t\tlet settledRevision: number | undefined;\n\t\t\tconst leasePromise = instance.acquireControllerLease(owner);\n\t\t\tconst runPromise = leasePromise.then(async (lease) => {\n\t\t\t\ttry {\n\t\t\t\t\tconst operation = instance.run(input, { lease, signal: spawnOptions?.signal });\n\t\t\t\t\tawait operation.result;\n\t\t\t\t} catch {\n\t\t\t\t\t// run() can reject when the instance was cancelled or disposed\n\t\t\t\t\t// mid-flight; instance.wait() below yields the terminal status.\n\t\t\t\t}\n\t\t\t\tconst instanceResult = await instance.wait();\n\t\t\t\tsettledRevision = instanceResult.revision;\n\t\t\t\tif (lease.isActive()) await lease.release();\n\t\t\t\treturn {\n\t\t\t\t\tstatus: instanceResult.status,\n\t\t\t\t\t...(instanceResult.output !== undefined ? { output: instanceResult.output } : {}),\n\t\t\t\t\t...(instanceResult.error !== undefined\n\t\t\t\t\t\t? {\n\t\t\t\t\t\t\t\terror:\n\t\t\t\t\t\t\t\t\tinstanceResult.error instanceof Error\n\t\t\t\t\t\t\t\t\t\t? instanceResult.error\n\t\t\t\t\t\t\t\t\t\t: new Error(String(instanceResult.error)),\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t: {}),\n\t\t\t\t\trevision: instanceResult.revision,\n\t\t\t\t};\n\t\t\t});\n\t\t\treturn {\n\t\t\t\tchildInstanceId,\n\t\t\t\tresultRef: () =>\n\t\t\t\t\tsettledRevision === undefined\n\t\t\t\t\t\t? undefined\n\t\t\t\t\t\t: Object.freeze({ childInstanceId, revision: settledRevision }),\n\t\t\t\twait: () => runPromise,\n\t\t\t\tcancel: (reason?: string) => instance.cancel(reason),\n\t\t\t};\n\t\t},\n\t};\n}\n"]}

package/dist/profile/child-facade.js

@@ -0,0 +1,56 @@
+export function createChildAgentFacade(options) {
+    const childDefinitionId = options.childDefinitionId ?? "child-agent-controller";
+    const owner = options.owner ?? "parent";
+    const definition = options.composition.define({
+        id: childDefinitionId,
+        version: options.childVersion ?? 1,
+        role: "child-agent-controller",
+        run: (input, context) => options.run(input, { parentInstanceId: options.parentInstanceId, signal: context?.signal }),
+    });
+    return {
+        childDefinitionId,
+        spawnChild(input, spawnOptions) {
+            const instance = options.composition.create(definition, {
+                parentInstanceId: options.parentInstanceId,
+            });
+            const childInstanceId = instance.id;
+            let settledRevision;
+            const leasePromise = instance.acquireControllerLease(owner);
+            const runPromise = leasePromise.then(async (lease) => {
+                try {
+                    const operation = instance.run(input, { lease, signal: spawnOptions?.signal });
+                    await operation.result;
+                }
+                catch {
+                    // run() can reject when the instance was cancelled or disposed
+                    // mid-flight; instance.wait() below yields the terminal status.
+                }
+                const instanceResult = await instance.wait();
+                settledRevision = instanceResult.revision;
+                if (lease.isActive())
+                    await lease.release();
+                return {
+                    status: instanceResult.status,
+                    ...(instanceResult.output !== undefined ? { output: instanceResult.output } : {}),
+                    ...(instanceResult.error !== undefined
+                        ? {
+                            error: instanceResult.error instanceof Error
+                                ? instanceResult.error
+                                : new Error(String(instanceResult.error)),
+                        }
+                        : {}),
+                    revision: instanceResult.revision,
+                };
+            });
+            return {
+                childInstanceId,
+                resultRef: () => settledRevision === undefined
+                    ? undefined
+                    : Object.freeze({ childInstanceId, revision: settledRevision }),
+                wait: () => runPromise,
+                cancel: (reason) => instance.cancel(reason),
+            };
+        },
+    };
+}
+//# sourceMappingURL=child-facade.js.map

package/dist/profile/child-facade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-facade.js","sourceRoot":"","sources":["../../src/profile/child-facade.ts"],"names":[],"mappings":"AAiCA,MAAM,UAAU,sBAAsB,CAA4B,OAWjE,EAAuC;IACvC,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,wBAAwB,CAAC;IAChF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,QAAQ,CAAC;IACxC,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC;QAC7C,EAAE,EAAE,iBAAiB;QACrB,OAAO,EAAE,OAAO,CAAC,YAAY,IAAI,CAAC;QAClC,IAAI,EAAE,wBAAwB;QAC9B,GAAG,EAAE,CAAC,KAAa,EAAE,OAA0C,EAAE,EAAE,CAClE,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;KAC5F,CAAC,CAAC;IAEH,OAAO;QACN,iBAAiB;QACjB,UAAU,CAAC,KAAK,EAAE,YAAY,EAA6B;YAC1D,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAkB,UAAU,EAAE;gBACxE,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;aAC1C,CAAC,CAAC;YACH,MAAM,eAAe,GAAG,QAAQ,CAAC,EAAE,CAAC;YACpC,IAAI,eAAmC,CAAC;YACxC,MAAM,YAAY,GAAG,QAAQ,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC;YAC5D,MAAM,UAAU,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC;gBACrD,IAAI,CAAC;oBACJ,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC;oBAC/E,MAAM,SAAS,CAAC,MAAM,CAAC;gBACxB,CAAC;gBAAC,MAAM,CAAC;oBACR,+DAA+D;oBAC/D,gEAAgE;gBACjE,CAAC;gBACD,MAAM,cAAc,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAC7C,eAAe,GAAG,cAAc,CAAC,QAAQ,CAAC;gBAC1C,IAAI,KAAK,CAAC,QAAQ,EAAE;oBAAE,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;gBAC5C,OAAO;oBACN,MAAM,EAAE,cAAc,CAAC,MAAM;oBAC7B,GAAG,CAAC,cAAc,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACjF,GAAG,CAAC,cAAc,CAAC,KAAK,KAAK,SAAS;wBACrC,CAAC,CAAC;4BACA,KAAK,EACJ,cAAc,CAAC,KAAK,YAAY,KAAK;gCACpC,CAAC,CAAC,cAAc,CAAC,KAAK;gCACtB,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;yBAC3C;wBACF,CAAC,CAAC,EAAE,CAAC;oBACN,QAAQ,EAAE,cAAc,CAAC,QAAQ;iBACjC,CAAC;YAAA,CACF,CAAC,CAAC;YACH,OAAO;gBACN,eAAe;gBACf,SAAS,EAAE,GAAG,EAAE,CACf,eAAe,KAAK,SAAS;oBAC5B,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,eAAe,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC;gBACjE,IAAI,EAAE,GAAG,EAAE,CAAC,UAAU;gBACtB,MAAM,EAAE,CAAC,MAAe,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;aACpD,CAAC;QAAA,CACF;KACD,CAAC;AAAA,CACF","sourcesContent":["/**\n * Child Agent lifecycle adapter (2.2b).\n *\n * Spawns child agents bound to their parent via the composition's\n * `parentInstanceId`, with cancel/wait and an independently replayable result\n * reference (`childInstanceId` + `revision`). Only the public\n * `AgentCompositionAPI` is consumed.\n */\nimport type { AgentCompositionAPI } from \"../core/extensions/public-api.ts\";\n\nexport interface ChildAgentResultRefV1 {\n\treadonly childInstanceId: string;\n\treadonly revision: number;\n}\n\nexport interface ChildAgentTurnV1<TResult = unknown> {\n\treadonly childInstanceId: string;\n\t/** Stable, replayable identity of the turn result. */\n\treadonly resultRef: () => ChildAgentResultRefV1 | undefined;\n\twait(): Promise<{\n\t\treadonly status: \"succeeded\" | \"failed\" | \"cancelled\" | \"disposed\";\n\t\treadonly output?: TResult;\n\t\treadonly revision: number;\n\t\treadonly error?: Error;\n\t}>;\n\tcancel(reason?: string): Promise<void>;\n}\n\nexport interface ChildAgentFacadeV1<TInput = unknown, TResult = unknown> {\n\treadonly childDefinitionId: string;\n\tspawnChild(input: TInput, options?: { readonly signal?: AbortSignal }): ChildAgentTurnV1<TResult>;\n}\n\nexport function createChildAgentFacade<TInput, TResult = unknown>(options: {\n\treadonly composition: AgentCompositionAPI;\n\treadonly parentInstanceId: string;\n\treadonly childDefinitionId?: string;\n\treadonly childVersion?: number;\n\treadonly owner?: string;\n\t/** The child turn implementation (deterministic in tests). */\n\treadonly run: (\n\t\tinput: TInput,\n\t\tcontext: { readonly parentInstanceId: string; readonly signal?: AbortSignal },\n\t) => Promise<TResult> | TResult;\n}): ChildAgentFacadeV1<TInput, TResult> {\n\tconst childDefinitionId = options.childDefinitionId ?? \"child-agent-controller\";\n\tconst owner = options.owner ?? \"parent\";\n\tconst definition = options.composition.define({\n\t\tid: childDefinitionId,\n\t\tversion: options.childVersion ?? 1,\n\t\trole: \"child-agent-controller\",\n\t\trun: (input: TInput, context: { readonly signal?: AbortSignal }) =>\n\t\t\toptions.run(input, { parentInstanceId: options.parentInstanceId, signal: context?.signal }),\n\t});\n\n\treturn {\n\t\tchildDefinitionId,\n\t\tspawnChild(input, spawnOptions): ChildAgentTurnV1<TResult> {\n\t\t\tconst instance = options.composition.create<TInput, TResult>(definition, {\n\t\t\t\tparentInstanceId: options.parentInstanceId,\n\t\t\t});\n\t\t\tconst childInstanceId = instance.id;\n\t\t\tlet settledRevision: number | undefined;\n\t\t\tconst leasePromise = instance.acquireControllerLease(owner);\n\t\t\tconst runPromise = leasePromise.then(async (lease) => {\n\t\t\t\ttry {\n\t\t\t\t\tconst operation = instance.run(input, { lease, signal: spawnOptions?.signal });\n\t\t\t\t\tawait operation.result;\n\t\t\t\t} catch {\n\t\t\t\t\t// run() can reject when the instance was cancelled or disposed\n\t\t\t\t\t// mid-flight; instance.wait() below yields the terminal status.\n\t\t\t\t}\n\t\t\t\tconst instanceResult = await instance.wait();\n\t\t\t\tsettledRevision = instanceResult.revision;\n\t\t\t\tif (lease.isActive()) await lease.release();\n\t\t\t\treturn {\n\t\t\t\t\tstatus: instanceResult.status,\n\t\t\t\t\t...(instanceResult.output !== undefined ? { output: instanceResult.output } : {}),\n\t\t\t\t\t...(instanceResult.error !== undefined\n\t\t\t\t\t\t? {\n\t\t\t\t\t\t\t\terror:\n\t\t\t\t\t\t\t\t\tinstanceResult.error instanceof Error\n\t\t\t\t\t\t\t\t\t\t? instanceResult.error\n\t\t\t\t\t\t\t\t\t\t: new Error(String(instanceResult.error)),\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t: {}),\n\t\t\t\t\trevision: instanceResult.revision,\n\t\t\t\t};\n\t\t\t});\n\t\t\treturn {\n\t\t\t\tchildInstanceId,\n\t\t\t\tresultRef: () =>\n\t\t\t\t\tsettledRevision === undefined\n\t\t\t\t\t\t? undefined\n\t\t\t\t\t\t: Object.freeze({ childInstanceId, revision: settledRevision }),\n\t\t\t\twait: () => runPromise,\n\t\t\t\tcancel: (reason?: string) => instance.cancel(reason),\n\t\t\t};\n\t\t},\n\t};\n}\n"]}

package/dist/profile/dependency-wiring.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Profile dependency wiring (2.5a) — resolves every resolved plugin's
+ * capability references (Skill/tool/MCP-capability IDs) against the host's
+ * available capability registry BEFORE a session is created.
+ *
+ * Resolution is exact-version: a reference is satisfied only when the
+ * registry offers the same capability ID at exactly the requested version.
+ * Missing or version-mismatched capabilities produce a structured `missing`
+ * result so session creation can fail up front — never a half-wired session.
+ * Plugins listed in `disabledPluginIds` are skipped as a whole (their
+ * references are reported as `skipped_disabled`), which lets a profile drop
+ * a plugin without touching the kernel or the other plugins. The same input
+ * always resolves identically.
+ */
+import type { ResolvedPluginManifestV1 } from "./identity.ts";
+export interface AvailableCapabilityV1 {
+    readonly id: string;
+    readonly version: number;
+}
+export interface WiredCapabilityV1 {
+    readonly id: string;
+    readonly version: number;
+}
+export interface PluginWiringResultV1 {
+    readonly pluginId: string;
+    readonly pluginVersion: string;
+    readonly status: "wired" | "skipped_disabled";
+    readonly wired: readonly WiredCapabilityV1[];
+}
+export interface MissingDependencyV1 {
+    readonly pluginId: string;
+    readonly capabilityId: string;
+    readonly requestedVersion: number;
+    /** Undefined when the capability is entirely absent from the registry. */
+    readonly availableVersion?: number;
+    readonly reason: "missing" | "version_mismatch";
+}
+export interface ProfileDependencyWiringV1 {
+    readonly status: "wired" | "missing";
+    readonly plugins: readonly PluginWiringResultV1[];
+    readonly missing: readonly MissingDependencyV1[];
+}
+export declare function wireProfileDependencies(input: {
+    readonly resolvedPlugins: readonly ResolvedPluginManifestV1[];
+    readonly availableCapabilities: readonly AvailableCapabilityV1[];
+    readonly disabledPluginIds?: readonly string[];
+}): ProfileDependencyWiringV1;
+//# sourceMappingURL=dependency-wiring.d.ts.map

package/dist/profile/dependency-wiring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-wiring.d.ts","sourceRoot":"","sources":["../../src/profile/dependency-wiring.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAE9D,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,kBAAkB,CAAC;IAC9C,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,0EAA0E;IAC1E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,kBAAkB,CAAC;CAChD;AAED,MAAM,WAAW,yBAAyB;IACzC,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACjD;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC9C,QAAQ,CAAC,eAAe,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAC9D,QAAQ,CAAC,qBAAqB,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACjE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/C,GAAG,yBAAyB,CAuD5B","sourcesContent":["/**\n * Profile dependency wiring (2.5a) — resolves every resolved plugin's\n * capability references (Skill/tool/MCP-capability IDs) against the host's\n * available capability registry BEFORE a session is created.\n *\n * Resolution is exact-version: a reference is satisfied only when the\n * registry offers the same capability ID at exactly the requested version.\n * Missing or version-mismatched capabilities produce a structured `missing`\n * result so session creation can fail up front — never a half-wired session.\n * Plugins listed in `disabledPluginIds` are skipped as a whole (their\n * references are reported as `skipped_disabled`), which lets a profile drop\n * a plugin without touching the kernel or the other plugins. The same input\n * always resolves identically.\n */\nimport type { ResolvedPluginManifestV1 } from \"./identity.ts\";\n\nexport interface AvailableCapabilityV1 {\n\treadonly id: string;\n\treadonly version: number;\n}\n\nexport interface WiredCapabilityV1 {\n\treadonly id: string;\n\treadonly version: number;\n}\n\nexport interface PluginWiringResultV1 {\n\treadonly pluginId: string;\n\treadonly pluginVersion: string;\n\treadonly status: \"wired\" | \"skipped_disabled\";\n\treadonly wired: readonly WiredCapabilityV1[];\n}\n\nexport interface MissingDependencyV1 {\n\treadonly pluginId: string;\n\treadonly capabilityId: string;\n\treadonly requestedVersion: number;\n\t/** Undefined when the capability is entirely absent from the registry. */\n\treadonly availableVersion?: number;\n\treadonly reason: \"missing\" | \"version_mismatch\";\n}\n\nexport interface ProfileDependencyWiringV1 {\n\treadonly status: \"wired\" | \"missing\";\n\treadonly plugins: readonly PluginWiringResultV1[];\n\treadonly missing: readonly MissingDependencyV1[];\n}\n\nexport function wireProfileDependencies(input: {\n\treadonly resolvedPlugins: readonly ResolvedPluginManifestV1[];\n\treadonly availableCapabilities: readonly AvailableCapabilityV1[];\n\treadonly disabledPluginIds?: readonly string[];\n}): ProfileDependencyWiringV1 {\n\tconst registry = new Map<string, number>();\n\tfor (const capability of input.availableCapabilities) {\n\t\tregistry.set(capability.id, capability.version);\n\t}\n\tconst disabled = new Set(input.disabledPluginIds ?? []);\n\n\tconst plugins: PluginWiringResultV1[] = [];\n\tconst missing: MissingDependencyV1[] = [];\n\n\tfor (const plugin of input.resolvedPlugins) {\n\t\tif (disabled.has(plugin.pluginId)) {\n\t\t\tplugins.push({\n\t\t\t\tpluginId: plugin.pluginId,\n\t\t\t\tpluginVersion: plugin.pluginVersion,\n\t\t\t\tstatus: \"skipped_disabled\",\n\t\t\t\twired: [],\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\t\tconst wired: WiredCapabilityV1[] = [];\n\t\tfor (const reference of plugin.capabilityRefs) {\n\t\t\tconst availableVersion = registry.get(reference.id);\n\t\t\tif (availableVersion === undefined) {\n\t\t\t\tmissing.push({\n\t\t\t\t\tpluginId: plugin.pluginId,\n\t\t\t\t\tcapabilityId: reference.id,\n\t\t\t\t\trequestedVersion: reference.version,\n\t\t\t\t\treason: \"missing\",\n\t\t\t\t});\n\t\t\t} else if (availableVersion !== reference.version) {\n\t\t\t\tmissing.push({\n\t\t\t\t\tpluginId: plugin.pluginId,\n\t\t\t\t\tcapabilityId: reference.id,\n\t\t\t\t\trequestedVersion: reference.version,\n\t\t\t\t\tavailableVersion,\n\t\t\t\t\treason: \"version_mismatch\",\n\t\t\t\t});\n\t\t\t} else {\n\t\t\t\twired.push({ id: reference.id, version: reference.version });\n\t\t\t}\n\t\t}\n\t\tplugins.push({\n\t\t\tpluginId: plugin.pluginId,\n\t\t\tpluginVersion: plugin.pluginVersion,\n\t\t\tstatus: \"wired\",\n\t\t\twired,\n\t\t});\n\t}\n\n\treturn {\n\t\tstatus: missing.length > 0 ? \"missing\" : \"wired\",\n\t\tplugins,\n\t\tmissing,\n\t};\n}\n"]}

package/dist/profile/dependency-wiring.js

@@ -0,0 +1,56 @@
+export function wireProfileDependencies(input) {
+    const registry = new Map();
+    for (const capability of input.availableCapabilities) {
+        registry.set(capability.id, capability.version);
+    }
+    const disabled = new Set(input.disabledPluginIds ?? []);
+    const plugins = [];
+    const missing = [];
+    for (const plugin of input.resolvedPlugins) {
+        if (disabled.has(plugin.pluginId)) {
+            plugins.push({
+                pluginId: plugin.pluginId,
+                pluginVersion: plugin.pluginVersion,
+                status: "skipped_disabled",
+                wired: [],
+            });
+            continue;
+        }
+        const wired = [];
+        for (const reference of plugin.capabilityRefs) {
+            const availableVersion = registry.get(reference.id);
+            if (availableVersion === undefined) {
+                missing.push({
+                    pluginId: plugin.pluginId,
+                    capabilityId: reference.id,
+                    requestedVersion: reference.version,
+                    reason: "missing",
+                });
+            }
+            else if (availableVersion !== reference.version) {
+                missing.push({
+                    pluginId: plugin.pluginId,
+                    capabilityId: reference.id,
+                    requestedVersion: reference.version,
+                    availableVersion,
+                    reason: "version_mismatch",
+                });
+            }
+            else {
+                wired.push({ id: reference.id, version: reference.version });
+            }
+        }
+        plugins.push({
+            pluginId: plugin.pluginId,
+            pluginVersion: plugin.pluginVersion,
+            status: "wired",
+            wired,
+        });
+    }
+    return {
+        status: missing.length > 0 ? "missing" : "wired",
+        plugins,
+        missing,
+    };
+}
+//# sourceMappingURL=dependency-wiring.js.map

package/dist/profile/dependency-wiring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-wiring.js","sourceRoot":"","sources":["../../src/profile/dependency-wiring.ts"],"names":[],"mappings":"AAgDA,MAAM,UAAU,uBAAuB,CAAC,KAIvC,EAA6B;IAC7B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3C,KAAK,MAAM,UAAU,IAAI,KAAK,CAAC,qBAAqB,EAAE,CAAC;QACtD,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IACjD,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;IAExD,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,MAAM,OAAO,GAA0B,EAAE,CAAC;IAE1C,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;QAC5C,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YACnC,OAAO,CAAC,IAAI,CAAC;gBACZ,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,aAAa,EAAE,MAAM,CAAC,aAAa;gBACnC,MAAM,EAAE,kBAAkB;gBAC1B,KAAK,EAAE,EAAE;aACT,CAAC,CAAC;YACH,SAAS;QACV,CAAC;QACD,MAAM,KAAK,GAAwB,EAAE,CAAC;QACtC,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;YAC/C,MAAM,gBAAgB,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YACpD,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;gBACpC,OAAO,CAAC,IAAI,CAAC;oBACZ,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,YAAY,EAAE,SAAS,CAAC,EAAE;oBAC1B,gBAAgB,EAAE,SAAS,CAAC,OAAO;oBACnC,MAAM,EAAE,SAAS;iBACjB,CAAC,CAAC;YACJ,CAAC;iBAAM,IAAI,gBAAgB,KAAK,SAAS,CAAC,OAAO,EAAE,CAAC;gBACnD,OAAO,CAAC,IAAI,CAAC;oBACZ,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,YAAY,EAAE,SAAS,CAAC,EAAE;oBAC1B,gBAAgB,EAAE,SAAS,CAAC,OAAO;oBACnC,gBAAgB;oBAChB,MAAM,EAAE,kBAAkB;iBAC1B,CAAC,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACP,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,SAAS,CAAC,EAAE,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;YAC9D,CAAC;QACF,CAAC;QACD,OAAO,CAAC,IAAI,CAAC;YACZ,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,MAAM,EAAE,OAAO;YACf,KAAK;SACL,CAAC,CAAC;IACJ,CAAC;IAED,OAAO;QACN,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO;QAChD,OAAO;QACP,OAAO;KACP,CAAC;AAAA,CACF","sourcesContent":["/**\n * Profile dependency wiring (2.5a) — resolves every resolved plugin's\n * capability references (Skill/tool/MCP-capability IDs) against the host's\n * available capability registry BEFORE a session is created.\n *\n * Resolution is exact-version: a reference is satisfied only when the\n * registry offers the same capability ID at exactly the requested version.\n * Missing or version-mismatched capabilities produce a structured `missing`\n * result so session creation can fail up front — never a half-wired session.\n * Plugins listed in `disabledPluginIds` are skipped as a whole (their\n * references are reported as `skipped_disabled`), which lets a profile drop\n * a plugin without touching the kernel or the other plugins. The same input\n * always resolves identically.\n */\nimport type { ResolvedPluginManifestV1 } from \"./identity.ts\";\n\nexport interface AvailableCapabilityV1 {\n\treadonly id: string;\n\treadonly version: number;\n}\n\nexport interface WiredCapabilityV1 {\n\treadonly id: string;\n\treadonly version: number;\n}\n\nexport interface PluginWiringResultV1 {\n\treadonly pluginId: string;\n\treadonly pluginVersion: string;\n\treadonly status: \"wired\" | \"skipped_disabled\";\n\treadonly wired: readonly WiredCapabilityV1[];\n}\n\nexport interface MissingDependencyV1 {\n\treadonly pluginId: string;\n\treadonly capabilityId: string;\n\treadonly requestedVersion: number;\n\t/** Undefined when the capability is entirely absent from the registry. */\n\treadonly availableVersion?: number;\n\treadonly reason: \"missing\" | \"version_mismatch\";\n}\n\nexport interface ProfileDependencyWiringV1 {\n\treadonly status: \"wired\" | \"missing\";\n\treadonly plugins: readonly PluginWiringResultV1[];\n\treadonly missing: readonly MissingDependencyV1[];\n}\n\nexport function wireProfileDependencies(input: {\n\treadonly resolvedPlugins: readonly ResolvedPluginManifestV1[];\n\treadonly availableCapabilities: readonly AvailableCapabilityV1[];\n\treadonly disabledPluginIds?: readonly string[];\n}): ProfileDependencyWiringV1 {\n\tconst registry = new Map<string, number>();\n\tfor (const capability of input.availableCapabilities) {\n\t\tregistry.set(capability.id, capability.version);\n\t}\n\tconst disabled = new Set(input.disabledPluginIds ?? []);\n\n\tconst plugins: PluginWiringResultV1[] = [];\n\tconst missing: MissingDependencyV1[] = [];\n\n\tfor (const plugin of input.resolvedPlugins) {\n\t\tif (disabled.has(plugin.pluginId)) {\n\t\t\tplugins.push({\n\t\t\t\tpluginId: plugin.pluginId,\n\t\t\t\tpluginVersion: plugin.pluginVersion,\n\t\t\t\tstatus: \"skipped_disabled\",\n\t\t\t\twired: [],\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\t\tconst wired: WiredCapabilityV1[] = [];\n\t\tfor (const reference of plugin.capabilityRefs) {\n\t\t\tconst availableVersion = registry.get(reference.id);\n\t\t\tif (availableVersion === undefined) {\n\t\t\t\tmissing.push({\n\t\t\t\t\tpluginId: plugin.pluginId,\n\t\t\t\t\tcapabilityId: reference.id,\n\t\t\t\t\trequestedVersion: reference.version,\n\t\t\t\t\treason: \"missing\",\n\t\t\t\t});\n\t\t\t} else if (availableVersion !== reference.version) {\n\t\t\t\tmissing.push({\n\t\t\t\t\tpluginId: plugin.pluginId,\n\t\t\t\t\tcapabilityId: reference.id,\n\t\t\t\t\trequestedVersion: reference.version,\n\t\t\t\t\tavailableVersion,\n\t\t\t\t\treason: \"version_mismatch\",\n\t\t\t\t});\n\t\t\t} else {\n\t\t\t\twired.push({ id: reference.id, version: reference.version });\n\t\t\t}\n\t\t}\n\t\tplugins.push({\n\t\t\tpluginId: plugin.pluginId,\n\t\t\tpluginVersion: plugin.pluginVersion,\n\t\t\tstatus: \"wired\",\n\t\t\twired,\n\t\t});\n\t}\n\n\treturn {\n\t\tstatus: missing.length > 0 ? \"missing\" : \"wired\",\n\t\tplugins,\n\t\tmissing,\n\t};\n}\n"]}

package/dist/profile/domain-recovery.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Domain recovery for branches and restarts (5.2a/5.2b).
+ *
+ * Branch recovery (5.2a): plans are bound to a branch via the 2.3c plugin;
+ * recovering a session on branch B must touch ONLY plans whose branch is B
+ * — other-branch plans stay ledgered but are reported as skipped and never
+ * written to. Restart recovery (5.2b): replaying a domain's history into a
+ * fresh store restores revision, evidence, and terminal state exactly; the
+ * recovery report records the before/after facts so a restart is auditable.
+ * Multi-Agent scheduling is out of scope.
+ */
+import type { GoalPluginV1, GoalV1 } from "./goal-plugin.ts";
+import type { PlanPluginV1, PlanV1 } from "./plan-plugin.ts";
+import type { TodoPluginV1, TodoV1 } from "./todo-plugin.ts";
+export interface PlanBranchRecoveryEntryV1 {
+    readonly planId: string;
+    readonly outcome: "recovered" | "terminal_kept" | "skipped_other_branch";
+    readonly branch: string;
+    readonly statusBefore: string;
+}
+export interface PlanBranchRecoveryReportV1 {
+    readonly currentBranch: string;
+    readonly entries: readonly PlanBranchRecoveryEntryV1[];
+}
+export interface DomainRestartRecordV1 {
+    readonly domain: "goal" | "plan" | "todo";
+    readonly entityId: string;
+    readonly statusAfter: string;
+    readonly revisionAfter: number;
+    readonly evidenceCount: number;
+    readonly terminal: boolean;
+}
+export interface DomainRestartReportV1 {
+    readonly records: readonly DomainRestartRecordV1[];
+    /** True when every restored entity matches the state it had before the restart. */
+    readonly identical: boolean;
+}
+/**
+ * 5.2a — recovers plans for the current branch. Plans on other branches are
+ * reported and left untouched (no scans, no writes). Terminal plans on the
+ * current branch are kept as-is; draft/active plans are recovered through
+ * the plugin's own ledger-derived state (no shadow writes).
+ */
+export declare function recoverPlansForBranch(plans: readonly PlanV1[], currentBranch: string): PlanBranchRecoveryReportV1;
+/**
+ * 5.2b — restores goal/plan/todo state after a restart by replaying each
+ * entity's history into a fresh store (the caller performs the replay via
+ * the plugin attached to the rebuilt store) and comparing against the
+ * pre-restart snapshots.
+ */
+export declare function buildRestartReport(snapshots: {
+    readonly goal?: readonly GoalV1[];
+    readonly plan?: readonly PlanV1[];
+    readonly todo?: readonly TodoV1[];
+}, restored: {
+    readonly goals: GoalPluginV1;
+    readonly plans: PlanPluginV1;
+    readonly todos: TodoPluginV1;
+}, owner: string): DomainRestartReportV1;
+//# sourceMappingURL=domain-recovery.d.ts.map

package/dist/profile/domain-recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-recovery.d.ts","sourceRoot":"","sources":["../../src/profile/domain-recovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE7D,MAAM,WAAW,yBAAyB;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,eAAe,GAAG,sBAAsB,CAAC;IACzE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,0BAA0B;IAC1C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,SAAS,yBAAyB,EAAE,CAAC;CACvD;AAED,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,mFAAmF;IACnF,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC5B;AAMD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,aAAa,EAAE,MAAM,GAAG,0BAA0B,CAmBjH;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CACjC,SAAS,EAAE;IACV,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC,EACD,QAAQ,EAAE;IACT,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;CAC7B,EACD,KAAK,EAAE,MAAM,GACX,qBAAqB,CA4FvB","sourcesContent":["/**\n * Domain recovery for branches and restarts (5.2a/5.2b).\n *\n * Branch recovery (5.2a): plans are bound to a branch via the 2.3c plugin;\n * recovering a session on branch B must touch ONLY plans whose branch is B\n * — other-branch plans stay ledgered but are reported as skipped and never\n * written to. Restart recovery (5.2b): replaying a domain's history into a\n * fresh store restores revision, evidence, and terminal state exactly; the\n * recovery report records the before/after facts so a restart is auditable.\n * Multi-Agent scheduling is out of scope.\n */\nimport type { GoalPluginV1, GoalV1 } from \"./goal-plugin.ts\";\nimport type { PlanPluginV1, PlanV1 } from \"./plan-plugin.ts\";\nimport type { TodoPluginV1, TodoV1 } from \"./todo-plugin.ts\";\n\nexport interface PlanBranchRecoveryEntryV1 {\n\treadonly planId: string;\n\treadonly outcome: \"recovered\" | \"terminal_kept\" | \"skipped_other_branch\";\n\treadonly branch: string;\n\treadonly statusBefore: string;\n}\n\nexport interface PlanBranchRecoveryReportV1 {\n\treadonly currentBranch: string;\n\treadonly entries: readonly PlanBranchRecoveryEntryV1[];\n}\n\nexport interface DomainRestartRecordV1 {\n\treadonly domain: \"goal\" | \"plan\" | \"todo\";\n\treadonly entityId: string;\n\treadonly statusAfter: string;\n\treadonly revisionAfter: number;\n\treadonly evidenceCount: number;\n\treadonly terminal: boolean;\n}\n\nexport interface DomainRestartReportV1 {\n\treadonly records: readonly DomainRestartRecordV1[];\n\t/** True when every restored entity matches the state it had before the restart. */\n\treadonly identical: boolean;\n}\n\nconst GOAL_TERMINAL = new Set([\"achieved\", \"archived\"]);\nconst PLAN_TERMINAL = new Set([\"completed\", \"discarded\"]);\nconst TODO_TERMINAL = new Set([\"completed\", \"cancelled\"]);\n\n/**\n * 5.2a — recovers plans for the current branch. Plans on other branches are\n * reported and left untouched (no scans, no writes). Terminal plans on the\n * current branch are kept as-is; draft/active plans are recovered through\n * the plugin's own ledger-derived state (no shadow writes).\n */\nexport function recoverPlansForBranch(plans: readonly PlanV1[], currentBranch: string): PlanBranchRecoveryReportV1 {\n\tconst entries = plans.map((plan): PlanBranchRecoveryEntryV1 => {\n\t\tconst terminal = PLAN_TERMINAL.has(plan.status);\n\t\tif (plan.branch !== currentBranch) {\n\t\t\treturn {\n\t\t\t\tplanId: plan.planId,\n\t\t\t\toutcome: \"skipped_other_branch\",\n\t\t\t\tbranch: plan.branch,\n\t\t\t\tstatusBefore: plan.status,\n\t\t\t};\n\t\t}\n\t\treturn {\n\t\t\tplanId: plan.planId,\n\t\t\toutcome: terminal ? \"terminal_kept\" : \"recovered\",\n\t\t\tbranch: plan.branch,\n\t\t\tstatusBefore: plan.status,\n\t\t};\n\t});\n\treturn { currentBranch, entries: Object.freeze(entries) };\n}\n\n/**\n * 5.2b — restores goal/plan/todo state after a restart by replaying each\n * entity's history into a fresh store (the caller performs the replay via\n * the plugin attached to the rebuilt store) and comparing against the\n * pre-restart snapshots.\n */\nexport function buildRestartReport(\n\tsnapshots: {\n\t\treadonly goal?: readonly GoalV1[];\n\t\treadonly plan?: readonly PlanV1[];\n\t\treadonly todo?: readonly TodoV1[];\n\t},\n\trestored: {\n\t\treadonly goals: GoalPluginV1;\n\t\treadonly plans: PlanPluginV1;\n\t\treadonly todos: TodoPluginV1;\n\t},\n\towner: string,\n): DomainRestartReportV1 {\n\tconst records: DomainRestartRecordV1[] = [];\n\tlet identical = true;\n\tconst compare = (\n\t\tdomain: \"goal\" | \"plan\" | \"todo\",\n\t\tentityId: string,\n\t\tstatusAfter: string,\n\t\trevisionAfter: number,\n\t\tevidenceCount: number,\n\t\tterminal: boolean,\n\t\tstatusBefore: string,\n\t\trevisionBefore: number,\n\t): void => {\n\t\tif (statusAfter !== statusBefore || revisionAfter !== revisionBefore) identical = false;\n\t\trecords.push({ domain, entityId, statusAfter, revisionAfter, evidenceCount, terminal });\n\t};\n\tfor (const goal of snapshots.goal ?? []) {\n\t\tconst after = restored.goals.get(goal.goalId, owner);\n\t\tif (!after) {\n\t\t\tidentical = false;\n\t\t\trecords.push({\n\t\t\t\tdomain: \"goal\",\n\t\t\t\tentityId: goal.goalId,\n\t\t\t\tstatusAfter: \"missing\",\n\t\t\t\trevisionAfter: 0,\n\t\t\t\tevidenceCount: 0,\n\t\t\t\tterminal: false,\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\t\tcompare(\n\t\t\t\"goal\",\n\t\t\tgoal.goalId,\n\t\t\tafter.status,\n\t\t\tafter.revision,\n\t\t\tafter.evidence.length,\n\t\t\tGOAL_TERMINAL.has(after.status),\n\t\t\tgoal.status,\n\t\t\tgoal.revision,\n\t\t);\n\t}\n\tfor (const plan of snapshots.plan ?? []) {\n\t\tconst after = restored.plans.get(plan.planId, owner);\n\t\tif (!after) {\n\t\t\tidentical = false;\n\t\t\trecords.push({\n\t\t\t\tdomain: \"plan\",\n\t\t\t\tentityId: plan.planId,\n\t\t\t\tstatusAfter: \"missing\",\n\t\t\t\trevisionAfter: 0,\n\t\t\t\tevidenceCount: 0,\n\t\t\t\tterminal: false,\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\t\tcompare(\n\t\t\t\"plan\",\n\t\t\tplan.planId,\n\t\t\tafter.status,\n\t\t\tafter.revisionNo,\n\t\t\tafter.evidence.length,\n\t\t\tPLAN_TERMINAL.has(after.status),\n\t\t\tplan.status,\n\t\t\tplan.revisionNo,\n\t\t);\n\t}\n\tfor (const todo of snapshots.todo ?? []) {\n\t\tconst after = restored.todos.get(todo.todoId, owner);\n\t\tif (!after) {\n\t\t\tidentical = false;\n\t\t\trecords.push({\n\t\t\t\tdomain: \"todo\",\n\t\t\t\tentityId: todo.todoId,\n\t\t\t\tstatusAfter: \"missing\",\n\t\t\t\trevisionAfter: 0,\n\t\t\t\tevidenceCount: 0,\n\t\t\t\tterminal: false,\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\t\tcompare(\n\t\t\t\"todo\",\n\t\t\ttodo.todoId,\n\t\t\tafter.status,\n\t\t\tafter.revision,\n\t\t\tafter.evidence.length,\n\t\t\tTODO_TERMINAL.has(after.status),\n\t\t\ttodo.status,\n\t\t\ttodo.revision,\n\t\t);\n\t}\n\treturn { records: Object.freeze(records), identical };\n}\n"]}