@caupulican/pi-adaptative 0.94.0 → 0.95.0

package/dist/core/autonomy/worker-tool-adapter-registry.d.ts

@@ -0,0 +1,65 @@
+import type { AgentTool } from "@caupulican/pi-agent-core";
+import type { TSchema } from "typebox";
+import type { ArtifactStore } from "../context/context-artifacts.ts";
+import { type CredentialExposureBoundary } from "../secrets/credential-exposure-guard.ts";
+import { type RunToolkitScriptDependencies } from "../tools/run-toolkit-script.ts";
+import { type ReadOnlySkillBroker } from "../tools/skill.ts";
+import { type SkillAuditToolOptions } from "../tools/skill-audit.ts";
+/**
+ * Host-owned inputs available while constructing one fresh worker tool.
+ *
+ * An adapter is deliberately a factory, not a live AgentTool. This keeps worker retries and
+ * concurrent lanes from sharing mutable foreground/session state. The host owns the broker
+ * callbacks and is responsible for preserving its cancellation and credential boundaries.
+ */
+export interface WorkerToolAdapterContext {
+    cwd: string;
+    signal?: AbortSignal;
+    credentialBoundary?: CredentialExposureBoundary;
+}
+export type WorkerToolAdapterFactory = (context: WorkerToolAdapterContext) => AgentTool<TSchema, unknown>;
+export interface WorkerToolAdapter {
+    readonly name: string;
+    readonly description: string;
+    readonly create: WorkerToolAdapterFactory;
+}
+/** Root/session controls are never brokered into a leaf, even when a host registers factories. */
+export declare const WORKER_TOOL_ADAPTER_FORBIDDEN_NAMES: ReadonlySet<string>;
+/** Adapter names with host-owned factories; explicit profiles must have these active in foreground. */
+export declare const WORKER_TOOL_ADAPTER_NAMES: ReadonlySet<string>;
+export type WorkerToolAdapterMaterialization = {
+    ok: true;
+    tool: AgentTool<TSchema, unknown>;
+} | {
+    ok: false;
+    reason: string;
+};
+export interface WorkerToolAdapterSources {
+    /** Session-owned packed output store; retrieval is bounded and identifier-only. */
+    artifactStore?: ArtifactStore;
+    /** Host-owned script registry and bounded executor. */
+    runToolkitScript?: RunToolkitScriptDependencies;
+    /** Optional brokered read-only skill surface. */
+    skill?: ReadOnlySkillBroker;
+    /** Optional read-only skill audit broker with host-path redaction. */
+    skillAudit?: Pick<SkillAuditToolOptions, "getSkills" | "maxSkills" | "maxComparisonPairs" | "maxDraftFieldChars"> & Required<Pick<SkillAuditToolOptions, "redactPath">>;
+}
+/**
+ * Registry for the small set of foreground capabilities that can be brokered safely to a leaf
+ * worker. It owns no session state and never clones or returns the foreground tool instance.
+ *
+ * Extension/MCP tools must be registered explicitly by a host broker. A missing registration is
+ * a deterministic unsupported result so an omitted inherited tool cannot silently disappear.
+ */
+export declare class WorkerToolAdapterRegistry {
+    private readonly adapters;
+    register(adapter: WorkerToolAdapter): this;
+    has(name: string): boolean;
+    names(): readonly string[];
+    description(name: string): string | undefined;
+    materialize(name: string, context: WorkerToolAdapterContext): WorkerToolAdapterMaterialization;
+}
+/** Build the default safe adapters from host-owned brokers. Omitted sources stay unsupported. */
+export declare function createWorkerToolAdapterRegistry(sources?: WorkerToolAdapterSources): WorkerToolAdapterRegistry;
+export declare function unsupportedWorkerToolReason(name: string): string;
+//# sourceMappingURL=worker-tool-adapter-registry.d.ts.map

package/dist/core/autonomy/worker-tool-adapter-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-tool-adapter-registry.d.ts","sourceRoot":"","sources":["../../../src/core/autonomy/worker-tool-adapter-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAErE,OAAO,EAAE,KAAK,0BAA0B,EAA6B,MAAM,yCAAyC,CAAC;AAErH,OAAO,EAEN,KAAK,4BAA4B,EACjC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAqC,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAChG,OAAO,EAKN,KAAK,qBAAqB,EAC1B,MAAM,yBAAyB,CAAC;AAGjC;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,kBAAkB,CAAC,EAAE,0BAA0B,CAAC;CAChD;AAED,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,EAAE,wBAAwB,KAAK,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAE1G,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;CAC1C;AAED,kGAAkG;AAClG,eAAO,MAAM,mCAAmC,EAAE,WAAW,CAAC,MAAM,CAuBlE,CAAC;AAEH,uGAAuG;AACvG,eAAO,MAAM,yBAAyB,EAAE,WAAW,CAAC,MAAM,CAKxD,CAAC;AAEH,MAAM,MAAM,gCAAgC,GACzC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;CAAE,GAC/C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjC,MAAM,WAAW,wBAAwB;IACxC,mFAAmF;IACnF,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,uDAAuD;IACvD,gBAAgB,CAAC,EAAE,4BAA4B,CAAC;IAChD,iDAAiD;IACjD,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B,sEAAsE;IACtE,UAAU,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,WAAW,GAAG,WAAW,GAAG,oBAAoB,GAAG,oBAAoB,CAAC,GAChH,QAAQ,CAAC,IAAI,CAAC,qBAAqB,EAAE,YAAY,CAAC,CAAC,CAAC;CACrD;AAED;;;;;;GAMG;AACH,qBAAa,yBAAyB;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwC;IAEjE,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CASzC;IAED,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzB;IAED,KAAK,IAAI,SAAS,MAAM,EAAE,CAEzB;IAED,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE5C;IAED,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,wBAAwB,GAAG,gCAAgC,CAkB7F;CACD;AAED,iGAAiG;AACjG,wBAAgB,+BAA+B,CAAC,OAAO,GAAE,wBAA6B,GAAG,yBAAyB,CAgEjH;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhE"}

package/dist/core/autonomy/worker-tool-adapter-registry.js

@@ -0,0 +1,145 @@
+import { ROOT_MEMORY_TOOL_NAME, WORKER_MEMORY_READ_TOOL_NAME } from "../memory/worker-memory-tools.js";
+import { isProtectedCredentialPath } from "../secrets/credential-exposure-guard.js";
+import { createArtifactRetrieveTool } from "../tools/artifact-retrieve.js";
+import { createRunToolkitScriptToolDefinition, } from "../tools/run-toolkit-script.js";
+import { createReadOnlySkillToolDefinition } from "../tools/skill.js";
+import { createSkillAuditToolDefinition, DEFAULT_WORKER_SKILL_AUDIT_MAX_COMPARISON_PAIRS, DEFAULT_WORKER_SKILL_AUDIT_MAX_DRAFT_FIELD_CHARS, DEFAULT_WORKER_SKILL_AUDIT_MAX_SKILLS, } from "../tools/skill-audit.js";
+import { wrapToolDefinition } from "../tools/tool-definition-wrapper.js";
+/** Root/session controls are never brokered into a leaf, even when a host registers factories. */
+export const WORKER_TOOL_ADAPTER_FORBIDDEN_NAMES = new Set([
+    "delegate",
+    "tmux_dispatch",
+    "tmux_agent_manager",
+    "context_scout",
+    ROOT_MEMORY_TOOL_NAME,
+    WORKER_MEMORY_READ_TOOL_NAME,
+    "goal",
+    "get_goal",
+    "update_goal",
+    "task_steps",
+    "pipeline",
+    "tool_task",
+    "ask_question",
+    "secret_store",
+    "settings",
+    "session",
+    "credential",
+    "model_fitness",
+    "improvement_loop",
+    "skillify",
+    "extensionify",
+    "worktree_sync",
+]);
+/** Adapter names with host-owned factories; explicit profiles must have these active in foreground. */
+export const WORKER_TOOL_ADAPTER_NAMES = new Set([
+    "artifact_retrieve",
+    "run_toolkit_script",
+    "skill",
+    "skill_audit",
+]);
+/**
+ * Registry for the small set of foreground capabilities that can be brokered safely to a leaf
+ * worker. It owns no session state and never clones or returns the foreground tool instance.
+ *
+ * Extension/MCP tools must be registered explicitly by a host broker. A missing registration is
+ * a deterministic unsupported result so an omitted inherited tool cannot silently disappear.
+ */
+export class WorkerToolAdapterRegistry {
+    constructor() {
+        this.adapters = new Map();
+    }
+    register(adapter) {
+        const name = adapter.name.trim();
+        if (!name)
+            throw new TypeError("Worker tool adapter name must not be empty.");
+        if (WORKER_TOOL_ADAPTER_FORBIDDEN_NAMES.has(name.toLowerCase())) {
+            throw new Error(`worker_tool_adapter_forbidden:${name}`);
+        }
+        if (this.adapters.has(name))
+            throw new Error(`Duplicate worker tool adapter: ${name}`);
+        this.adapters.set(name, Object.freeze({ ...adapter, name }));
+        return this;
+    }
+    has(name) {
+        return this.adapters.has(name);
+    }
+    names() {
+        return [...this.adapters.keys()];
+    }
+    description(name) {
+        return this.adapters.get(name)?.description;
+    }
+    materialize(name, context) {
+        const adapter = this.adapters.get(name);
+        if (!adapter)
+            return { ok: false, reason: unsupportedWorkerToolReason(name) };
+        try {
+            const tool = adapter.create({ ...context });
+            if (tool.name !== name) {
+                return {
+                    ok: false,
+                    reason: `worker_tool_adapter_contract_violation:${name}:created=${tool.name}`,
+                };
+            }
+            return { ok: true, tool };
+        }
+        catch (error) {
+            return {
+                ok: false,
+                reason: `worker_tool_adapter_failed:${name}:${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    }
+}
+/** Build the default safe adapters from host-owned brokers. Omitted sources stay unsupported. */
+export function createWorkerToolAdapterRegistry(sources = {}) {
+    const registry = new WorkerToolAdapterRegistry();
+    if (sources.artifactStore) {
+        registry.register({
+            name: "artifact_retrieve",
+            description: "Retrieve a bounded slice from a host-owned packed tool-output artifact.",
+            create: (context) => createArtifactRetrieveTool(context.cwd, { artifactStore: sources.artifactStore }),
+        });
+    }
+    if (sources.runToolkitScript) {
+        registry.register({
+            name: "run_toolkit_script",
+            description: "Run a registered toolkit script through the host-owned bounded executor.",
+            create: (context) => {
+                const dependencies = sources.runToolkitScript;
+                return wrapToolDefinition(createRunToolkitScriptToolDefinition({
+                    ...dependencies,
+                    getScripts: () => dependencies
+                        .getScripts()
+                        .filter((script) => !context.credentialBoundary ||
+                        !isProtectedCredentialPath(script.path, context.cwd, context.credentialBoundary)),
+                }));
+            },
+        });
+    }
+    if (sources.skill) {
+        registry.register({
+            name: "skill",
+            description: "Use the host-owned read-only skill broker.",
+            create: () => wrapToolDefinition(createReadOnlySkillToolDefinition(sources.skill)),
+        });
+    }
+    if (sources.skillAudit) {
+        const skillAudit = sources.skillAudit;
+        registry.register({
+            name: "skill_audit",
+            description: "Audit skills through the host-owned read-only broker.",
+            create: (context) => wrapToolDefinition(createSkillAuditToolDefinition(context.cwd, {
+                ...skillAudit,
+                maxSkills: Math.min(skillAudit.maxSkills ?? DEFAULT_WORKER_SKILL_AUDIT_MAX_SKILLS, DEFAULT_WORKER_SKILL_AUDIT_MAX_SKILLS),
+                maxComparisonPairs: Math.min(skillAudit.maxComparisonPairs ?? DEFAULT_WORKER_SKILL_AUDIT_MAX_COMPARISON_PAIRS, DEFAULT_WORKER_SKILL_AUDIT_MAX_COMPARISON_PAIRS),
+                maxDraftFieldChars: Math.min(skillAudit.maxDraftFieldChars ?? DEFAULT_WORKER_SKILL_AUDIT_MAX_DRAFT_FIELD_CHARS, DEFAULT_WORKER_SKILL_AUDIT_MAX_DRAFT_FIELD_CHARS),
+            })),
+        });
+    }
+    return registry;
+}
+export function unsupportedWorkerToolReason(name) {
+    return `worker_tool_adapter_unavailable:${name}`;
+}
+//# sourceMappingURL=worker-tool-adapter-registry.js.map

package/dist/core/autonomy/worker-tool-adapter-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-tool-adapter-registry.js","sourceRoot":"","sources":["../../../src/core/autonomy/worker-tool-adapter-registry.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentTool } from \"@caupulican/pi-agent-core\";\nimport type { TSchema } from \"typebox\";\nimport type { ArtifactStore } from \"../context/context-artifacts.ts\";\nimport { ROOT_MEMORY_TOOL_NAME, WORKER_MEMORY_READ_TOOL_NAME } from \"../memory/worker-memory-tools.ts\";\nimport { type CredentialExposureBoundary, isProtectedCredentialPath } from \"../secrets/credential-exposure-guard.ts\";\nimport { createArtifactRetrieveTool } from \"../tools/artifact-retrieve.ts\";\nimport {\n\tcreateRunToolkitScriptToolDefinition,\n\ttype RunToolkitScriptDependencies,\n} from \"../tools/run-toolkit-script.ts\";\nimport { createReadOnlySkillToolDefinition, type ReadOnlySkillBroker } from \"../tools/skill.ts\";\nimport {\n\tcreateSkillAuditToolDefinition,\n\tDEFAULT_WORKER_SKILL_AUDIT_MAX_COMPARISON_PAIRS,\n\tDEFAULT_WORKER_SKILL_AUDIT_MAX_DRAFT_FIELD_CHARS,\n\tDEFAULT_WORKER_SKILL_AUDIT_MAX_SKILLS,\n\ttype SkillAuditToolOptions,\n} from \"../tools/skill-audit.ts\";\nimport { wrapToolDefinition } from \"../tools/tool-definition-wrapper.ts\";\n\n/**\n * Host-owned inputs available while constructing one fresh worker tool.\n *\n * An adapter is deliberately a factory, not a live AgentTool. This keeps worker retries and\n * concurrent lanes from sharing mutable foreground/session state. The host owns the broker\n * callbacks and is responsible for preserving its cancellation and credential boundaries.\n */\nexport interface WorkerToolAdapterContext {\n\tcwd: string;\n\tsignal?: AbortSignal;\n\tcredentialBoundary?: CredentialExposureBoundary;\n}\n\nexport type WorkerToolAdapterFactory = (context: WorkerToolAdapterContext) => AgentTool<TSchema, unknown>;\n\nexport interface WorkerToolAdapter {\n\treadonly name: string;\n\treadonly description: string;\n\treadonly create: WorkerToolAdapterFactory;\n}\n\n/** Root/session controls are never brokered into a leaf, even when a host registers factories. */\nexport const WORKER_TOOL_ADAPTER_FORBIDDEN_NAMES: ReadonlySet<string> = new Set([\n\t\"delegate\",\n\t\"tmux_dispatch\",\n\t\"tmux_agent_manager\",\n\t\"context_scout\",\n\tROOT_MEMORY_TOOL_NAME,\n\tWORKER_MEMORY_READ_TOOL_NAME,\n\t\"goal\",\n\t\"get_goal\",\n\t\"update_goal\",\n\t\"task_steps\",\n\t\"pipeline\",\n\t\"tool_task\",\n\t\"ask_question\",\n\t\"secret_store\",\n\t\"settings\",\n\t\"session\",\n\t\"credential\",\n\t\"model_fitness\",\n\t\"improvement_loop\",\n\t\"skillify\",\n\t\"extensionify\",\n\t\"worktree_sync\",\n]);\n\n/** Adapter names with host-owned factories; explicit profiles must have these active in foreground. */\nexport const WORKER_TOOL_ADAPTER_NAMES: ReadonlySet<string> = new Set([\n\t\"artifact_retrieve\",\n\t\"run_toolkit_script\",\n\t\"skill\",\n\t\"skill_audit\",\n]);\n\nexport type WorkerToolAdapterMaterialization =\n\t| { ok: true; tool: AgentTool<TSchema, unknown> }\n\t| { ok: false; reason: string };\n\nexport interface WorkerToolAdapterSources {\n\t/** Session-owned packed output store; retrieval is bounded and identifier-only. */\n\tartifactStore?: ArtifactStore;\n\t/** Host-owned script registry and bounded executor. */\n\trunToolkitScript?: RunToolkitScriptDependencies;\n\t/** Optional brokered read-only skill surface. */\n\tskill?: ReadOnlySkillBroker;\n\t/** Optional read-only skill audit broker with host-path redaction. */\n\tskillAudit?: Pick<SkillAuditToolOptions, \"getSkills\" | \"maxSkills\" | \"maxComparisonPairs\" | \"maxDraftFieldChars\"> &\n\t\tRequired<Pick<SkillAuditToolOptions, \"redactPath\">>;\n}\n\n/**\n * Registry for the small set of foreground capabilities that can be brokered safely to a leaf\n * worker. It owns no session state and never clones or returns the foreground tool instance.\n *\n * Extension/MCP tools must be registered explicitly by a host broker. A missing registration is\n * a deterministic unsupported result so an omitted inherited tool cannot silently disappear.\n */\nexport class WorkerToolAdapterRegistry {\n\tprivate readonly adapters = new Map<string, WorkerToolAdapter>();\n\n\tregister(adapter: WorkerToolAdapter): this {\n\t\tconst name = adapter.name.trim();\n\t\tif (!name) throw new TypeError(\"Worker tool adapter name must not be empty.\");\n\t\tif (WORKER_TOOL_ADAPTER_FORBIDDEN_NAMES.has(name.toLowerCase())) {\n\t\t\tthrow new Error(`worker_tool_adapter_forbidden:${name}`);\n\t\t}\n\t\tif (this.adapters.has(name)) throw new Error(`Duplicate worker tool adapter: ${name}`);\n\t\tthis.adapters.set(name, Object.freeze({ ...adapter, name }));\n\t\treturn this;\n\t}\n\n\thas(name: string): boolean {\n\t\treturn this.adapters.has(name);\n\t}\n\n\tnames(): readonly string[] {\n\t\treturn [...this.adapters.keys()];\n\t}\n\n\tdescription(name: string): string | undefined {\n\t\treturn this.adapters.get(name)?.description;\n\t}\n\n\tmaterialize(name: string, context: WorkerToolAdapterContext): WorkerToolAdapterMaterialization {\n\t\tconst adapter = this.adapters.get(name);\n\t\tif (!adapter) return { ok: false, reason: unsupportedWorkerToolReason(name) };\n\t\ttry {\n\t\t\tconst tool = adapter.create({ ...context });\n\t\t\tif (tool.name !== name) {\n\t\t\t\treturn {\n\t\t\t\t\tok: false,\n\t\t\t\t\treason: `worker_tool_adapter_contract_violation:${name}:created=${tool.name}`,\n\t\t\t\t};\n\t\t\t}\n\t\t\treturn { ok: true, tool };\n\t\t} catch (error) {\n\t\t\treturn {\n\t\t\t\tok: false,\n\t\t\t\treason: `worker_tool_adapter_failed:${name}:${error instanceof Error ? error.message : String(error)}`,\n\t\t\t};\n\t\t}\n\t}\n}\n\n/** Build the default safe adapters from host-owned brokers. Omitted sources stay unsupported. */\nexport function createWorkerToolAdapterRegistry(sources: WorkerToolAdapterSources = {}): WorkerToolAdapterRegistry {\n\tconst registry = new WorkerToolAdapterRegistry();\n\tif (sources.artifactStore) {\n\t\tregistry.register({\n\t\t\tname: \"artifact_retrieve\",\n\t\t\tdescription: \"Retrieve a bounded slice from a host-owned packed tool-output artifact.\",\n\t\t\tcreate: (context) => createArtifactRetrieveTool(context.cwd, { artifactStore: sources.artifactStore }),\n\t\t});\n\t}\n\tif (sources.runToolkitScript) {\n\t\tregistry.register({\n\t\t\tname: \"run_toolkit_script\",\n\t\t\tdescription: \"Run a registered toolkit script through the host-owned bounded executor.\",\n\t\t\tcreate: (context) => {\n\t\t\t\tconst dependencies = sources.runToolkitScript!;\n\t\t\t\treturn wrapToolDefinition(\n\t\t\t\t\tcreateRunToolkitScriptToolDefinition({\n\t\t\t\t\t\t...dependencies,\n\t\t\t\t\t\tgetScripts: () =>\n\t\t\t\t\t\t\tdependencies\n\t\t\t\t\t\t\t\t.getScripts()\n\t\t\t\t\t\t\t\t.filter(\n\t\t\t\t\t\t\t\t\t(script) =>\n\t\t\t\t\t\t\t\t\t\t!context.credentialBoundary ||\n\t\t\t\t\t\t\t\t\t\t!isProtectedCredentialPath(script.path, context.cwd, context.credentialBoundary),\n\t\t\t\t\t\t\t\t),\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t},\n\t\t});\n\t}\n\tif (sources.skill) {\n\t\tregistry.register({\n\t\t\tname: \"skill\",\n\t\t\tdescription: \"Use the host-owned read-only skill broker.\",\n\t\t\tcreate: () => wrapToolDefinition(createReadOnlySkillToolDefinition(sources.skill!)),\n\t\t});\n\t}\n\tif (sources.skillAudit) {\n\t\tconst skillAudit = sources.skillAudit;\n\t\tregistry.register({\n\t\t\tname: \"skill_audit\",\n\t\t\tdescription: \"Audit skills through the host-owned read-only broker.\",\n\t\t\tcreate: (context) =>\n\t\t\t\twrapToolDefinition(\n\t\t\t\t\tcreateSkillAuditToolDefinition(context.cwd, {\n\t\t\t\t\t\t...skillAudit,\n\t\t\t\t\t\tmaxSkills: Math.min(\n\t\t\t\t\t\t\tskillAudit.maxSkills ?? DEFAULT_WORKER_SKILL_AUDIT_MAX_SKILLS,\n\t\t\t\t\t\t\tDEFAULT_WORKER_SKILL_AUDIT_MAX_SKILLS,\n\t\t\t\t\t\t),\n\t\t\t\t\t\tmaxComparisonPairs: Math.min(\n\t\t\t\t\t\t\tskillAudit.maxComparisonPairs ?? DEFAULT_WORKER_SKILL_AUDIT_MAX_COMPARISON_PAIRS,\n\t\t\t\t\t\t\tDEFAULT_WORKER_SKILL_AUDIT_MAX_COMPARISON_PAIRS,\n\t\t\t\t\t\t),\n\t\t\t\t\t\tmaxDraftFieldChars: Math.min(\n\t\t\t\t\t\t\tskillAudit.maxDraftFieldChars ?? DEFAULT_WORKER_SKILL_AUDIT_MAX_DRAFT_FIELD_CHARS,\n\t\t\t\t\t\t\tDEFAULT_WORKER_SKILL_AUDIT_MAX_DRAFT_FIELD_CHARS,\n\t\t\t\t\t\t),\n\t\t\t\t\t}),\n\t\t\t\t),\n\t\t});\n\t}\n\treturn registry;\n}\n\nexport function unsupportedWorkerToolReason(name: string): string {\n\treturn `worker_tool_adapter_unavailable:${name}`;\n}\n"]}

package/dist/core/background-lane-controller.d.ts

@@ -66,6 +66,8 @@ export declare class BackgroundLaneController implements WorkerAgentControlPort
     private _workerLifecycle;
     /** Shared terminal outbox for managed and in-process workers; lazy under UAC omission. */
     private _workerNotifications;
+    /** Active event waits consume matching terminal edges before a redundant parent wake is admitted. */
+    private readonly _workerWaitConsumers;
     private readonly deps;
     /** Emit a warning without ever throwing — used from disposal-adjacent persistence where a
      * listener failure (or a bare test double missing `emit`) must never block or crash cleanup. */
@@ -75,6 +77,12 @@ export declare class BackgroundLaneController implements WorkerAgentControlPort
     private _getWorkerController;
     private _getWorkerLifecycle;
     private _getWorkerNotificationCoordinator;
+    private _workerAgentIdForRecord;
+    private _isWorkerTerminalAwaited;
+    private _retainWorkerWaitConsumers;
+    /** Observe only logical-agent terminals explicitly exposed by a bounded model result. */
+    observeWorkerAgentTerminals(agentIds: readonly string[]): void;
+    observeWorkerTerminalRecords(records: readonly LaneRecord[]): void;
     /**
      * Backfills a durable notification for every record about to be flushed, through the SAME
      * durable notification store `_getWorkerLifecycle()` already replays from on construction
@@ -156,7 +164,7 @@ export declare class BackgroundLaneController implements WorkerAgentControlPort
         context?: string;
         goalId?: string;
     }): Promise<ResearchLaneRunOutcome>;
-    /** Start a durable recursive agent with inherited, preset, or model-selected authority. */
+    /** Start a durable leaf worker with inherited, preset, or model-selected authority. */
     startWorkerDelegation(request: WorkerDelegationRequest): {
         started: false;
         skipReason: string;

package/dist/core/background-lane-controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"background-lane-controller.d.ts","sourceRoot":"","sources":["../../src/core/background-lane-controller.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"background-lane-controller.d.ts","sourceRoot":"","sources":["../../src/core/background-lane-controller.ts"],"names":[],"mappings":"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"}

package/dist/core/background-lane-controller.js

@@ -13,7 +13,7 @@
  * delegations; goal auto-continue itself only ever asks the session to `continueGoalLoop`, so this
  * controller never touches `prompt()`, the last-assistant-message, retry, or streaming state.
  */
-import { LaneTracker } from "./autonomy/lane-tracker.js";
+import { isLaneTerminalStatus, LaneTracker } from "./autonomy/lane-tracker.js";
 import { appendLaneRecordSnapshot, getLatestLaneRecordSnapshots } from "./autonomy/session-lane-record.js";
 import { ManagedLaneController } from "./delegation/managed-lane-controller.js";
 import { WorkerDelegationController, } from "./delegation/worker-delegation-controller.js";
@@ -43,6 +43,8 @@ export class BackgroundLaneController {
     constructor(deps) {
         /** Live lane registry — the real source for AutonomyStatusSnapshot.activeLaneCount. */
         this._laneTracker = new LaneTracker();
+        /** Active event waits consume matching terminal edges before a redundant parent wake is admitted. */
+        this._workerWaitConsumers = new Map();
         this.deps = deps;
         this._laneModels = new LaneModelResolver(deps);
         this._research = new ResearchLaneController(deps, this._laneTracker, this._laneModels);
@@ -102,9 +104,45 @@ export class BackgroundLaneController {
             notify: (records) => this.deps.notifyWorkerTerminalHandoff(records),
             warn: (message) => this._safeWarn(message),
             markDurableDelivered: (notificationIds) => this._workerLifecycle?.markNotificationsDelivered(notificationIds),
+            isObserved: (record) => this._isWorkerTerminalAwaited(record),
         });
         return this._workerNotifications;
     }
+    _workerAgentIdForRecord(record) {
+        const attempt = this._workerLifecycle?.getActiveAttempt(record.laneId) ??
+            this._workerLifecycle?.getManagedAttempt(record.laneId);
+        return attempt?.agentId ?? attempt?.dispatch.logicalLaneId ?? record.laneId;
+    }
+    _isWorkerTerminalAwaited(record) {
+        return (this._workerWaitConsumers.get(this._workerAgentIdForRecord(record)) ?? 0) > 0;
+    }
+    _retainWorkerWaitConsumers(agentIds) {
+        const unique = [...new Set(agentIds)];
+        for (const agentId of unique) {
+            this._workerWaitConsumers.set(agentId, (this._workerWaitConsumers.get(agentId) ?? 0) + 1);
+        }
+        return () => {
+            for (const agentId of unique) {
+                const remaining = (this._workerWaitConsumers.get(agentId) ?? 1) - 1;
+                if (remaining > 0)
+                    this._workerWaitConsumers.set(agentId, remaining);
+                else
+                    this._workerWaitConsumers.delete(agentId);
+            }
+        };
+    }
+    /** Observe only logical-agent terminals explicitly exposed by a bounded model result. */
+    observeWorkerAgentTerminals(agentIds) {
+        if (!this._workerLifecycle)
+            return;
+        const targets = new Set(agentIds);
+        this.observeWorkerTerminalRecords(this.getLaneRecords().filter((record) => isLaneTerminalStatus(record.status) && targets.has(this._workerAgentIdForRecord(record))));
+    }
+    observeWorkerTerminalRecords(records) {
+        const terminal = records.filter((record) => isLaneTerminalStatus(record.status));
+        if (terminal.length > 0)
+            this._getWorkerNotificationCoordinator().observeTerminals(terminal);
+    }
     /**
      * Backfills a durable notification for every record about to be flushed, through the SAME
      * durable notification store `_getWorkerLifecycle()` already replays from on construction
@@ -270,7 +308,7 @@ export class BackgroundLaneController {
     async runResearchLaneOnce(request) {
         return this._research.runOnce(request);
     }
-    /** Start a durable recursive agent with inherited, preset, or model-selected authority. */
+    /** Start a durable leaf worker with inherited, preset, or model-selected authority. */
     startWorkerDelegation(request) {
         return this._getWorkerController().start(request);
     }
@@ -288,12 +326,16 @@ export class BackgroundLaneController {
     getWorkerAgentActivity(agentId, scope) {
         if (!this.deps.isDelegateToolActive())
             throw new Error("Worker delegation control is unavailable in this UAC surface.");
-        return this._getWorkerController().getAgentControl().getWorkerAgentActivity(agentId, scope);
+        const activity = this._getWorkerController().getAgentControl().getWorkerAgentActivity(agentId, scope);
+        this.observeWorkerAgentTerminals([agentId]);
+        return activity;
     }
     readWorkerAgentTranscript(agentId, options) {
         if (!this.deps.isDelegateToolActive())
             throw new Error("Worker delegation control is unavailable in this UAC surface.");
-        return this._getWorkerController().getAgentControl().readWorkerAgentTranscript(agentId, options);
+        const page = this._getWorkerController().getAgentControl().readWorkerAgentTranscript(agentId, options);
+        this.observeWorkerAgentTerminals([agentId]);
+        return page;
     }
     sendWorkerAgentMessage(agentId, message, options) {
         if (!this.deps.isDelegateToolActive())
@@ -370,12 +412,40 @@ export class BackgroundLaneController {
     waitForWorkerAgent(agentId, timeoutMs, scope) {
         if (!this.deps.isDelegateToolActive())
             throw new Error("Worker delegation control is unavailable in this UAC surface.");
-        return this._getWorkerController().getAgentControl().waitForWorkerAgent(agentId, timeoutMs, scope);
+        const release = this._retainWorkerWaitConsumers([agentId]);
+        let wait;
+        try {
+            wait = this._getWorkerController().getAgentControl().waitForWorkerAgent(agentId, timeoutMs, scope);
+        }
+        catch (error) {
+            release();
+            throw error;
+        }
+        return wait
+            .then((result) => {
+            this.observeWorkerAgentTerminals([agentId]);
+            return result;
+        })
+            .finally(release);
     }
     waitForWorkerAgents(agentIds, mode, timeoutMs, scope) {
         if (!this.deps.isDelegateToolActive())
             throw new Error("Worker delegation control is unavailable in this UAC surface.");
-        return this._getWorkerController().getAgentControl().waitForWorkerAgents(agentIds, mode, timeoutMs, scope);
+        const release = this._retainWorkerWaitConsumers(agentIds);
+        let wait;
+        try {
+            wait = this._getWorkerController().getAgentControl().waitForWorkerAgents(agentIds, mode, timeoutMs, scope);
+        }
+        catch (error) {
+            release();
+            throw error;
+        }
+        return wait
+            .then((result) => {
+            this.observeWorkerAgentTerminals(agentIds);
+            return result;
+        })
+            .finally(release);
     }
     broadcastWorkerAgentMessage(agentIds, message, options) {
         if (!this.deps.isDelegateToolActive())