agentic-engineering-harness 0.6.21 → 0.6.23

package/dist/workers/promptPolicy.js

@@ -8,6 +8,8 @@ export function compileAgentPromptPolicy(selection, contract, options) {
         if (!hasTraceableAcceptance(contract))
             skills.delete("acceptance-traceability");
     }
+    if (contractRepair && selection.logicalAgent === "operation-supervisor")
+        skills.clear();
     if (contractRepair)
         skills.add("structured-output-delivery");
     return {
@@ -27,19 +29,25 @@ export function nativeSchemaEnforced(selection, transport) {
 }
 export function outputContractContext(contractName, nativeSchema, repair = false) {
     if (repair) {
-        return `AEH output contract: ${contractName}. This is a serialization-repair turn; structured-output-delivery governs the exact marker format.`;
+        return [
+            `AEH output contract: ${contractName}. This is a serialization-repair turn.`,
+            "If the capability-scoped aeh_submit_result tool is available, submit the already-established contract payload through it; a successful durable submission is authoritative.",
+            "Do not redo semantic work. If the result tool is unavailable, structured-output-delivery governs the compatibility marker fallback."
+        ].join("\n");
     }
     if (nativeSchema) {
         return [
             `AEH output contract: ${contractName}.`,
             "The exact JSON Schema is supplied out-of-band and validated deterministically by the runtime.",
-            "Return only the contract result; do not add prose or Markdown around it."
+            "If aeh_submit_result is available, submit exactly the final contract payload through it before completing; that durable result is lifecycle-authoritative.",
+            "A provider-required native structured final may repeat the same payload for transport compatibility, but must not represent a different semantic result."
         ].join("\n");
     }
     const schema = outputJsonSchema(contractName);
     return [
         `AEH output contract: ${contractName}. Runtime validation is authoritative.`,
-        "This transport cannot enforce the schema out-of-band, so match the compact schema below exactly and return no prose.",
+        "If aeh_submit_result is available, submit exactly the final contract payload through it; the durable result is authoritative.",
+        "Otherwise this transport cannot enforce the schema out-of-band, so match the compact schema below exactly and return no prose.",
         schema ? `Schema: ${JSON.stringify(schema)}` : undefined
     ].filter(Boolean).join("\n");
 }

package/dist/workers/promptPolicy.js.map

@@ -1 +1 @@
-{"version":3,"file":"promptPolicy.js","sourceRoot":"","sources":["../../src/workers/promptPolicy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAehE,MAAM,UAAU,wBAAwB,CACtC,SAAkC,EAClC,QAAsB,EACtB,OAAiC;IAEjC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,4BAA4B,CAAC,CAAC,CAAC;IAC3G,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,kBAAkB,CAAC,IAAI,KAAK,CAAC;IAE5E,IAAI,OAAO,CAAC,aAAa,KAAK,OAAO,IAAI,SAAS,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACvE,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACpC,MAAM,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC;QACvC,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC;YAAE,MAAM,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAAC;IAClF,CAAC;IAED,IAAI,cAAc;QAAE,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;IAE7D,OAAO;QACL,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC;QACnB,qBAAqB,EAAE,OAAO,CAAC,cAAc;YAC3C,CAAC,CAAC,qBAAqB,CAAC,OAAO,CAAC,cAAc,EAAE,oBAAoB,CAAC,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC;YACnH,CAAC,CAAC,SAAS;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAsB;IAC3D,OAAO,OAAO,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,IAAI,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,IAAI,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AACrH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,SAAkC,EAAE,SAAiB;IACxF,IAAI,SAAS,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,cAAc,KAAK,OAAO,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,YAAoB,EAAE,YAAqB,EAAE,MAAM,GAAG,KAAK;IAC/F,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,wBAAwB,YAAY,oGAAoG,CAAC;IAClJ,CAAC;IACD,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO;YACL,wBAAwB,YAAY,GAAG;YACvC,+FAA+F;YAC/F,0EAA0E;SAC3E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IACD,MAAM,MAAM,GAAG,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAC9C,OAAO;QACL,wBAAwB,YAAY,wCAAwC;QAC5E,sHAAsH;QACtH,MAAM,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS;KACzD,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC"}
+{"version":3,"file":"promptPolicy.js","sourceRoot":"","sources":["../../src/workers/promptPolicy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAehE,MAAM,UAAU,wBAAwB,CACtC,SAAkC,EAClC,QAAsB,EACtB,OAAiC;IAEjC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,4BAA4B,CAAC,CAAC,CAAC;IAC3G,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,kBAAkB,CAAC,IAAI,KAAK,CAAC;IAE5E,IAAI,OAAO,CAAC,aAAa,KAAK,OAAO,IAAI,SAAS,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACvE,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACpC,MAAM,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC;QACvC,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC;YAAE,MAAM,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAAC;IAClF,CAAC;IAED,IAAI,cAAc,IAAI,SAAS,CAAC,YAAY,KAAK,sBAAsB;QAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IACxF,IAAI,cAAc;QAAE,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;IAE7D,OAAO;QACL,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC;QACnB,qBAAqB,EAAE,OAAO,CAAC,cAAc;YAC3C,CAAC,CAAC,qBAAqB,CAAC,OAAO,CAAC,cAAc,EAAE,oBAAoB,CAAC,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC;YACnH,CAAC,CAAC,SAAS;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAsB;IAC3D,OAAO,OAAO,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,IAAI,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,IAAI,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AACrH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,SAAkC,EAAE,SAAiB;IACxF,IAAI,SAAS,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,cAAc,KAAK,OAAO,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,YAAoB,EAAE,YAAqB,EAAE,MAAM,GAAG,KAAK;IAC/F,IAAI,MAAM,EAAE,CAAC;QACX,OAAO;YACL,wBAAwB,YAAY,wCAAwC;YAC5E,6KAA6K;YAC7K,qIAAqI;SACtI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IACD,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO;YACL,wBAAwB,YAAY,GAAG;YACvC,+FAA+F;YAC/F,4JAA4J;YAC5J,0JAA0J;SAC3J,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IACD,MAAM,MAAM,GAAG,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAC9C,OAAO;QACL,wBAAwB,YAAY,wCAAwC;QAC5E,+HAA+H;QAC/H,gIAAgI;QAChI,MAAM,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS;KACzD,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC"}

package/dist/workers/resultCommit.d.ts

@@ -0,0 +1,2 @@
+import { type AcceptedStructuredResult, type StructuredResultSource } from "./resultGateway.js";
+export declare function commitStructuredResult<T = unknown>(root: string, operationId: string, channelId: string, payload: unknown, source: StructuredResultSource): Promise<AcceptedStructuredResult<T>>;

package/dist/workers/resultCommit.js

@@ -0,0 +1,49 @@
+import crypto from "node:crypto";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { validateAgentOutput } from "../agents/outputContracts.js";
+import { operationArtifactDir, resolveOperationStateRoot } from "../operations/state.js";
+import { acceptStructuredResult, loadStructuredResultChannel } from "./resultGateway.js";
+export async function commitStructuredResult(root, operationId, channelId, payload, source) {
+    const lock = path.join(operationArtifactDir(resolveOperationStateRoot(root), operationId), "result-channels", `${safe(channelId)}.commit.lock`);
+    return withLock(lock, async () => {
+        const channel = await loadStructuredResultChannel(root, operationId, channelId);
+        const turn = channel.activeTurn;
+        if (!turn)
+            throw new Error("AEH_RESULT_NO_ACTIVE_TURN: no controller-activated result turn exists.");
+        if (turn.status === "ACCEPTED" && turn.sha256 && turn.artifact) {
+            const validation = validateAgentOutput(turn.contract, payload);
+            if (!validation.ok)
+                throw new Error(`RESULT_ALREADY_ACCEPTED: ${validation.issues.join("; ")}`);
+            const normalized = validation.value;
+            const sha256 = crypto.createHash("sha256").update(JSON.stringify(normalized)).digest("hex");
+            if (sha256 !== turn.sha256)
+                throw new Error("CONFLICTING_RESULT: the active turn already has a different accepted payload.");
+            return { artifact: turn.artifact, sha256, payload: normalized, source: turn.source ?? source, turnId: turn.id, channelId };
+        }
+        return acceptStructuredResult(root, operationId, channelId, payload, source);
+    });
+}
+function safe(value) { return value.trim().replace(/[^A-Za-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "") || "result"; }
+async function withLock(file, action) {
+    await fs.mkdir(path.dirname(file), { recursive: true });
+    const deadline = Date.now() + 5_000;
+    for (;;) {
+        try {
+            const handle = await fs.open(file, "wx");
+            try {
+                return await action();
+            }
+            finally {
+                await handle.close().catch(() => undefined);
+                await fs.rm(file, { force: true }).catch(() => undefined);
+            }
+        }
+        catch (error) {
+            if (error.code !== "EEXIST" || Date.now() >= deadline)
+                throw error;
+            await new Promise((resolve) => setTimeout(resolve, 10));
+        }
+    }
+}
+//# sourceMappingURL=resultCommit.js.map

package/dist/workers/resultCommit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resultCommit.js","sourceRoot":"","sources":["../../src/workers/resultCommit.ts"],"names":[],"mappings":"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"}

package/dist/workers/resultGateway.d.ts

@@ -0,0 +1,91 @@
+export type StructuredResultSource = "mcp" | "captured";
+export type StructuredResultTurnStatus = "PENDING" | "ACCEPTED" | "REJECTED" | "CONFLICT";
+export interface StructuredResultTurn {
+    id: string;
+    sequence: number;
+    contract: string;
+    phase?: string;
+    status: StructuredResultTurnStatus;
+    attempts: number;
+    activatedAt: string;
+    acceptedAt?: string;
+    artifact?: string;
+    sha256?: string;
+    source?: StructuredResultSource;
+    error?: string;
+}
+export interface StructuredResultChannel {
+    version: 1;
+    operationId: string;
+    channelId: string;
+    logicalAgent: string;
+    role?: string;
+    contract: string;
+    agentId?: string;
+    createdAt: string;
+    updatedAt: string;
+    sequence: number;
+    activeTurn?: StructuredResultTurn;
+}
+export interface StructuredResultArtifact<T = unknown> {
+    version: 1;
+    kind: "agent-result";
+    operationId: string;
+    channelId: string;
+    turnId: string;
+    sequence: number;
+    logicalAgent: string;
+    role?: string;
+    agentId?: string;
+    contract: string;
+    source: StructuredResultSource;
+    createdAt: string;
+    payloadSha256: string;
+    payload: T;
+}
+export interface AcceptedStructuredResult<T = unknown> {
+    artifact: string;
+    sha256: string;
+    payload: T;
+    source: StructuredResultSource;
+    turnId: string;
+    channelId: string;
+}
+export interface StructuredResultResolution<T = unknown> {
+    ok: boolean;
+    accepted?: AcceptedStructuredResult<T>;
+    failure?: string;
+}
+export declare function provisionStructuredResultChannel(root: string, input: {
+    operationId: string;
+    logicalAgent: string;
+    role?: string;
+    contract: string;
+    channelId?: string;
+}): Promise<StructuredResultChannel>;
+export declare function bindStructuredResultChannel(root: string, operationId: string, channelId: string, agentId: string): Promise<StructuredResultChannel>;
+export declare function activateStructuredResultTurn(root: string, operationId: string, channelId: string, phase?: string): Promise<StructuredResultTurn>;
+export declare function activateStructuredResultTurnForAgent(root: string, agentId: string, phase?: string): Promise<StructuredResultTurn | undefined>;
+export declare function acceptStructuredResult<T = unknown>(root: string, operationId: string, channelId: string, payload: unknown, source: StructuredResultSource): Promise<AcceptedStructuredResult<T>>;
+export declare function acceptedStructuredResultForAgent<T = unknown>(root: string, agentId: string): Promise<AcceptedStructuredResult<T> | undefined>;
+export declare function reconcileStructuredResult<T = unknown>(root: string, input: {
+    operationId: string;
+    agentId?: string;
+    logicalAgent: string;
+    role?: string;
+    contract: string;
+    phase?: string;
+    stdout: string;
+    stderr?: string;
+}): Promise<StructuredResultResolution<T>>;
+export declare function projectAcceptedStructuredResult<T extends {
+    stdout: string;
+}>(root: string, agentId: string, result: T): Promise<T>;
+export declare function loadStructuredResultChannel(root: string, operationId: string, channelId: string): Promise<StructuredResultChannel>;
+export declare function resultSinkMcpServerDefinition(root: string, operationId: string, channelId: string): {
+    type: "stdio";
+    command: string;
+    args: string[];
+    env: Record<string, string>;
+    alwaysLoad: true;
+};

package/dist/workers/resultGateway.js

@@ -0,0 +1,278 @@
+import crypto from "node:crypto";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { validateAgentOutput } from "../agents/outputContracts.js";
+import { extractMarkedJson, StructuredOutputError } from "../agents/structuredOutput.js";
+import { operationArtifactDir, resolveOperationStateRoot, updateOperationParticipant } from "../operations/state.js";
+const CHANNELS_DIR = "result-channels";
+const RESULTS_DIR = "results";
+const GLOBAL_INDEX_DIR = path.join(".harness", "result-channels", "agents");
+const LOCK_RETRY_MS = 10;
+const LOCK_TIMEOUT_MS = 5_000;
+export async function provisionStructuredResultChannel(root, input) {
+    const stateRoot = resolveOperationStateRoot(root);
+    const channelId = input.channelId ?? crypto.randomUUID();
+    const file = channelFile(stateRoot, input.operationId, channelId);
+    try {
+        return await readJson(file);
+    }
+    catch {
+        const now = new Date().toISOString();
+        const channel = {
+            version: 1,
+            operationId: input.operationId,
+            channelId,
+            logicalAgent: input.logicalAgent,
+            role: input.role,
+            contract: input.contract,
+            createdAt: now,
+            updatedAt: now,
+            sequence: 0
+        };
+        await writeJsonAtomic(file, channel);
+        return channel;
+    }
+}
+export async function bindStructuredResultChannel(root, operationId, channelId, agentId) {
+    const stateRoot = resolveOperationStateRoot(root);
+    const channel = await mutateChannel(stateRoot, operationId, channelId, (current) => ({
+        ...current,
+        agentId,
+        updatedAt: new Date().toISOString()
+    }));
+    const index = agentIndexFile(stateRoot, agentId);
+    await writeJsonAtomic(index, { version: 1, operationId, channelId, agentId });
+    return channel;
+}
+export async function activateStructuredResultTurn(root, operationId, channelId, phase) {
+    const stateRoot = resolveOperationStateRoot(root);
+    const channel = await mutateChannel(stateRoot, operationId, channelId, (current) => {
+        const sequence = current.sequence + 1;
+        const now = new Date().toISOString();
+        return {
+            ...current,
+            sequence,
+            updatedAt: now,
+            activeTurn: {
+                id: `${String(sequence).padStart(4, "0")}-${crypto.randomUUID()}`,
+                sequence,
+                contract: current.contract,
+                phase,
+                status: "PENDING",
+                attempts: 0,
+                activatedAt: now
+            }
+        };
+    });
+    if (!channel.activeTurn)
+        throw new Error("AEH_RESULT_CHANNEL_STATE: active result turn was not created.");
+    return channel.activeTurn;
+}
+export async function activateStructuredResultTurnForAgent(root, agentId, phase) {
+    const binding = await loadAgentChannelBinding(root, agentId);
+    if (!binding)
+        return undefined;
+    return activateStructuredResultTurn(root, binding.operationId, binding.channelId, phase);
+}
+export async function acceptStructuredResult(root, operationId, channelId, payload, source) {
+    const stateRoot = resolveOperationStateRoot(root);
+    const file = channelFile(stateRoot, operationId, channelId);
+    return withFileLock(file, async () => {
+        const channel = await readJson(file);
+        const turn = channel.activeTurn;
+        if (!turn)
+            throw new Error("AEH_RESULT_NO_ACTIVE_TURN: result submission has no controller-activated turn.");
+        const validation = validateAgentOutput(turn.contract, payload);
+        if (!validation.ok) {
+            const failure = `SCHEMA_VALIDATION_FAILED: ${validation.issues.join("; ")}`;
+            channel.activeTurn = { ...turn, status: "REJECTED", attempts: turn.attempts + 1, error: failure };
+            channel.updatedAt = new Date().toISOString();
+            await writeJsonAtomic(file, channel);
+            throw new Error(failure);
+        }
+        const normalized = validation.value;
+        const canonical = JSON.stringify(normalized);
+        const sha256 = crypto.createHash("sha256").update(canonical).digest("hex");
+        if (turn.status === "ACCEPTED" && turn.sha256) {
+            if (turn.sha256 !== sha256) {
+                channel.activeTurn = { ...turn, status: "CONFLICT", attempts: turn.attempts + 1, error: "CONFLICTING_RESULT: a different valid payload was submitted for an already accepted turn." };
+                channel.updatedAt = new Date().toISOString();
+                await writeJsonAtomic(file, channel);
+                throw new Error("CONFLICTING_RESULT: a different valid payload was submitted for an already accepted turn.");
+            }
+            if (!turn.artifact)
+                throw new Error("AEH_RESULT_CHANNEL_STATE: accepted turn is missing its artifact reference.");
+            return { artifact: turn.artifact, sha256, payload: normalized, source: turn.source ?? source, turnId: turn.id, channelId };
+        }
+        const artifactEnvelope = {
+            version: 1,
+            kind: "agent-result",
+            operationId,
+            channelId,
+            turnId: turn.id,
+            sequence: turn.sequence,
+            logicalAgent: channel.logicalAgent,
+            role: channel.role,
+            agentId: channel.agentId,
+            contract: turn.contract,
+            source,
+            createdAt: new Date().toISOString(),
+            payloadSha256: sha256,
+            payload: normalized
+        };
+        const artifact = await persistResultArtifact(stateRoot, artifactEnvelope);
+        const acceptedAt = new Date().toISOString();
+        channel.activeTurn = {
+            ...turn,
+            status: "ACCEPTED",
+            attempts: turn.attempts + 1,
+            acceptedAt,
+            artifact,
+            sha256,
+            source,
+            error: undefined
+        };
+        channel.updatedAt = acceptedAt;
+        await writeJsonAtomic(file, channel);
+        if (channel.agentId) {
+            await updateOperationParticipant(stateRoot, operationId, channel.agentId, { resultArtifact: artifact }).catch(() => undefined);
+        }
+        return { artifact, sha256, payload: normalized, source, turnId: turn.id, channelId };
+    });
+}
+export async function acceptedStructuredResultForAgent(root, agentId) {
+    const binding = await loadAgentChannelBinding(root, agentId);
+    if (!binding)
+        return undefined;
+    const stateRoot = resolveOperationStateRoot(root);
+    const channel = await readJson(channelFile(stateRoot, binding.operationId, binding.channelId)).catch(() => undefined);
+    const turn = channel?.activeTurn;
+    if (!channel || !turn || turn.status !== "ACCEPTED" || !turn.artifact || !turn.sha256)
+        return undefined;
+    const envelope = await readJson(path.resolve(stateRoot, turn.artifact));
+    return { artifact: turn.artifact, sha256: turn.sha256, payload: envelope.payload, source: turn.source ?? envelope.source, turnId: turn.id, channelId: channel.channelId };
+}
+export async function reconcileStructuredResult(root, input) {
+    if (input.agentId) {
+        const accepted = await acceptedStructuredResultForAgent(root, input.agentId).catch(() => undefined);
+        if (accepted)
+            return { ok: true, accepted };
+    }
+    let payload;
+    try {
+        payload = extractMarkedJson(input.stdout, input.stderr ?? "");
+    }
+    catch (error) {
+        if (error instanceof StructuredOutputError)
+            return { ok: false, failure: `${error.reason}: ${error.message}` };
+        return { ok: false, failure: `OUTPUT_CONTRACT_UNKNOWN: ${String(error)}` };
+    }
+    try {
+        const channel = input.agentId
+            ? await ensureAgentChannel(root, input)
+            : await provisionStructuredResultChannel(root, { operationId: input.operationId, logicalAgent: input.logicalAgent, role: input.role, contract: input.contract });
+        if (!channel.activeTurn || channel.activeTurn.status === "ACCEPTED") {
+            await activateStructuredResultTurn(root, input.operationId, channel.channelId, input.phase);
+        }
+        const accepted = await acceptStructuredResult(root, input.operationId, channel.channelId, payload, "captured");
+        return { ok: true, accepted };
+    }
+    catch (error) {
+        return { ok: false, failure: error instanceof Error ? error.message : String(error) };
+    }
+}
+export async function projectAcceptedStructuredResult(root, agentId, result) {
+    const accepted = await acceptedStructuredResultForAgent(root, agentId).catch(() => undefined);
+    return accepted ? { ...result, stdout: JSON.stringify(accepted.payload) } : result;
+}
+export async function loadStructuredResultChannel(root, operationId, channelId) {
+    return readJson(channelFile(resolveOperationStateRoot(root), operationId, channelId));
+}
+export function resultSinkMcpServerDefinition(root, operationId, channelId) {
+    return {
+        type: "stdio",
+        command: process.execPath,
+        args: [fileURLToPath(new URL("./resultSinkMcp.js", import.meta.url))],
+        env: {
+            AEH_RESULT_CONTROL_ROOT: resolveOperationStateRoot(root),
+            AEH_RESULT_OPERATION_ID: operationId,
+            AEH_RESULT_CHANNEL_ID: channelId
+        },
+        alwaysLoad: true
+    };
+}
+async function ensureAgentChannel(root, input) {
+    if (!input.agentId)
+        throw new Error("agentId is required");
+    const binding = await loadAgentChannelBinding(root, input.agentId);
+    if (binding) {
+        const channel = await loadStructuredResultChannel(root, binding.operationId, binding.channelId);
+        if (channel.contract !== input.contract)
+            throw new Error(`AEH_RESULT_CONTRACT_MISMATCH: channel=${channel.contract} requested=${input.contract}`);
+        return channel;
+    }
+    const channel = await provisionStructuredResultChannel(root, input);
+    return bindStructuredResultChannel(root, input.operationId, channel.channelId, input.agentId);
+}
+async function loadAgentChannelBinding(root, agentId) {
+    const stateRoot = resolveOperationStateRoot(root);
+    return readJson(agentIndexFile(stateRoot, agentId)).catch(() => undefined);
+}
+async function persistResultArtifact(root, envelope) {
+    const dir = path.join(operationArtifactDir(root, envelope.operationId), RESULTS_DIR, safe(envelope.logicalAgent));
+    await fs.mkdir(dir, { recursive: true });
+    const file = path.join(dir, `${String(envelope.sequence).padStart(4, "0")}-${safe(envelope.turnId)}.json`);
+    await writeJsonAtomic(file, envelope);
+    return path.relative(resolveOperationStateRoot(root), file).replaceAll("\\", "/");
+}
+function channelFile(root, operationId, channelId) {
+    return path.join(operationArtifactDir(root, operationId), CHANNELS_DIR, `${safe(channelId)}.json`);
+}
+function agentIndexFile(root, agentId) { return path.resolve(root, GLOBAL_INDEX_DIR, `${safe(agentId)}.json`); }
+function safe(value) { return value.trim().replace(/[^A-Za-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "") || "result"; }
+async function mutateChannel(root, operationId, channelId, mutate) {
+    const file = channelFile(root, operationId, channelId);
+    return withFileLock(file, async () => {
+        const current = await readJson(file);
+        const next = mutate(current);
+        await writeJsonAtomic(file, next);
+        return next;
+    });
+}
+async function withFileLock(file, action) {
+    const lock = `${file}.lock`;
+    await fs.mkdir(path.dirname(file), { recursive: true });
+    const deadline = Date.now() + LOCK_TIMEOUT_MS;
+    for (;;) {
+        try {
+            const handle = await fs.open(lock, "wx");
+            try {
+                return await action();
+            }
+            finally {
+                await handle.close().catch(() => undefined);
+                await fs.rm(lock, { force: true }).catch(() => undefined);
+            }
+        }
+        catch (error) {
+            const code = error.code;
+            if (code !== "EEXIST" || Date.now() >= deadline)
+                throw error;
+            await new Promise((resolve) => setTimeout(resolve, LOCK_RETRY_MS));
+        }
+    }
+}
+async function readJson(file) { return JSON.parse(await fs.readFile(file, "utf8")); }
+async function writeJsonAtomic(file, value) {
+    await fs.mkdir(path.dirname(file), { recursive: true });
+    const temp = `${file}.${process.pid}.${crypto.randomUUID()}.tmp`;
+    await fs.writeFile(temp, `${JSON.stringify(value, null, 2)}\n`);
+    try {
+        await fs.rename(temp, file);
+    }
+    finally {
+        await fs.rm(temp, { force: true }).catch(() => undefined);
+    }
+}
+//# sourceMappingURL=resultGateway.js.map

package/dist/workers/resultGateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resultGateway.js","sourceRoot":"","sources":["../../src/workers/resultGateway.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACzF,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAkErH,MAAM,YAAY,GAAG,iBAAiB,CAAC;AACvC,MAAM,WAAW,GAAG,SAAS,CAAC;AAC9B,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,iBAAiB,EAAE,QAAQ,CAAC,CAAC;AAC5E,MAAM,aAAa,GAAG,EAAE,CAAC;AACzB,MAAM,eAAe,GAAG,KAAK,CAAC;AAE9B,MAAM,CAAC,KAAK,UAAU,gCAAgC,CACpD,IAAY,EACZ,KAAyG;IAEzG,MAAM,SAAS,GAAG,yBAAyB,CAAC,IAAI,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;IACzD,MAAM,IAAI,GAAG,WAAW,CAAC,SAAS,EAAE,KAAK,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAClE,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAA0B,IAAI,CAAC,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,OAAO,GAA4B;YACvC,OAAO,EAAE,CAAC;YACV,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,SAAS;YACT,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,GAAG;YACd,QAAQ,EAAE,CAAC;SACZ,CAAC;QACF,MAAM,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACrC,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,IAAY,EACZ,WAAmB,EACnB,SAAiB,EACjB,OAAe;IAEf,MAAM,SAAS,GAAG,yBAAyB,CAAC,IAAI,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACnF,GAAG,OAAO;QACV,OAAO;QACP,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC,CAAC,CAAC;IACJ,MAAM,KAAK,GAAG,cAAc,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACjD,MAAM,eAAe,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;IAC9E,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,IAAY,EACZ,WAAmB,EACnB,SAAiB,EACjB,KAAc;IAEd,MAAM,SAAS,GAAG,yBAAyB,CAAC,IAAI,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;QACjF,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACtC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,OAAO;YACL,GAAG,OAAO;YACV,QAAQ;YACR,SAAS,EAAE,GAAG;YACd,UAAU,EAAE;gBACV,EAAE,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,UAAU,EAAE,EAAE;gBACjE,QAAQ;gBACR,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,KAAK;gBACL,MAAM,EAAE,SAAS;gBACjB,QAAQ,EAAE,CAAC;gBACX,WAAW,EAAE,GAAG;aACjB;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,OAAO,CAAC,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IAC1G,OAAO,OAAO,CAAC,UAAU,CAAC;AAC5B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oCAAoC,CACxD,IAAY,EACZ,OAAe,EACf,KAAc;IAEd,MAAM,OAAO,GAAG,MAAM,uBAAuB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7D,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,OAAO,4BAA4B,CAAC,IAAI,EAAE,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;AAC3F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,IAAY,EACZ,WAAmB,EACnB,SAAiB,EACjB,OAAgB,EAChB,MAA8B;IAE9B,MAAM,SAAS,GAAG,yBAAyB,CAAC,IAAI,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,WAAW,CAAC,SAAS,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IAC5D,OAAO,YAAY,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE;QACnC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAA0B,IAAI,CAAC,CAAC;QAC9D,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC;QAChC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,gFAAgF,CAAC,CAAC;QAC7G,MAAM,UAAU,GAAG,mBAAmB,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC/D,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;YACnB,MAAM,OAAO,GAAG,6BAA6B,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5E,OAAO,CAAC,UAAU,GAAG,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,GAAG,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;YAClG,OAAO,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC7C,MAAM,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;QACD,MAAM,UAAU,GAAG,UAAU,CAAC,KAAU,CAAC;QACzC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3E,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC9C,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBAC3B,OAAO,CAAC,UAAU,GAAG,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,GAAG,CAAC,EAAE,KAAK,EAAE,2FAA2F,EAAE,CAAC;gBACtL,OAAO,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;gBAC7C,MAAM,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBACrC,MAAM,IAAI,KAAK,CAAC,2FAA2F,CAAC,CAAC;YAC/G,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,4EAA4E,CAAC,CAAC;YAClH,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC;QAC7H,CAAC;QAED,MAAM,gBAAgB,GAAgC;YACpD,OAAO,EAAE,CAAC;YACV,IAAI,EAAE,cAAc;YACpB,WAAW;YACX,SAAS;YACT,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,MAAM;YACN,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,aAAa,EAAE,MAAM;YACrB,OAAO,EAAE,UAAU;SACpB,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;QAC1E,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC5C,OAAO,CAAC,UAAU,GAAG;YACnB,GAAG,IAAI;YACP,MAAM,EAAE,UAAU;YAClB,QAAQ,EAAE,IAAI,CAAC,QAAQ,GAAG,CAAC;YAC3B,UAAU;YACV,QAAQ;YACR,MAAM;YACN,MAAM;YACN,KAAK,EAAE,SAAS;SACjB,CAAC;QACF,OAAO,CAAC,SAAS,GAAG,UAAU,CAAC;QAC/B,MAAM,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACrC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,0BAA0B,CAAC,SAAS,EAAE,WAAW,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACjI,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC;IACvF,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gCAAgC,CACpD,IAAY,EACZ,OAAe;IAEf,MAAM,OAAO,GAAG,MAAM,uBAAuB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7D,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,MAAM,SAAS,GAAG,yBAAyB,CAAC,IAAI,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAA0B,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC/I,MAAM,IAAI,GAAG,OAAO,EAAE,UAAU,CAAC;IACjC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IACxG,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAA8B,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACrG,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC;AAC5K,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,IAAY,EACZ,KASC;IAED,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,MAAM,QAAQ,GAAG,MAAM,gCAAgC,CAAI,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACvG,IAAI,QAAQ;YAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC9C,CAAC;IAED,IAAI,OAAgB,CAAC;IACrB,IAAI,CAAC;QACH,OAAO,GAAG,iBAAiB,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IAChE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,qBAAqB;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QAC/G,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,4BAA4B,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;IAC7E,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO;YAC3B,CAAC,CAAC,MAAM,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC;YACvC,CAAC,CAAC,MAAM,gCAAgC,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QACnK,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YACpE,MAAM,4BAA4B,CAAC,IAAI,EAAE,KAAK,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QAC9F,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAAI,IAAI,EAAE,KAAK,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;QAClH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAChC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IACxF,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,+BAA+B,CAA+B,IAAY,EAAE,OAAe,EAAE,MAAS;IAC1H,MAAM,QAAQ,GAAG,MAAM,gCAAgC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC9F,OAAO,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;AACrF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,IAAY,EAAE,WAAmB,EAAE,SAAiB;IACpG,OAAO,QAAQ,CAA0B,WAAW,CAAC,yBAAyB,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;AACjH,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,IAAY,EAAE,WAAmB,EAAE,SAAiB;IAOhG,OAAO;QACL,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,OAAO,CAAC,QAAQ;QACzB,IAAI,EAAE,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACrE,GAAG,EAAE;YACH,uBAAuB,EAAE,yBAAyB,CAAC,IAAI,CAAC;YACxD,uBAAuB,EAAE,WAAW;YACpC,qBAAqB,EAAE,SAAS;SACjC;QACD,UAAU,EAAE,IAAI;KACjB,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,kBAAkB,CAC/B,IAAY,EACZ,KAAuG;IAEvG,IAAI,CAAC,KAAK,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,MAAM,uBAAuB,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACnE,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,OAAO,GAAG,MAAM,2BAA2B,CAAC,IAAI,EAAE,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAChG,IAAI,OAAO,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,OAAO,CAAC,QAAQ,cAAc,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAClJ,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,gCAAgC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACpE,OAAO,2BAA2B,CAAC,IAAI,EAAE,KAAK,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;AAChG,CAAC;AAED,KAAK,UAAU,uBAAuB,CAAC,IAAY,EAAE,OAAe;IAClE,MAAM,SAAS,GAAG,yBAAyB,CAAC,IAAI,CAAC,CAAC;IAClD,OAAO,QAAQ,CAA8D,cAAc,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;AAC1I,CAAC;AAED,KAAK,UAAU,qBAAqB,CAAI,IAAY,EAAE,QAAqC;IACzF,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,IAAI,EAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC;IAClH,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3G,MAAM,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACtC,OAAO,IAAI,CAAC,QAAQ,CAAC,yBAAyB,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACpF,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,WAAmB,EAAE,SAAiB;IACvE,OAAO,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AACrG,CAAC;AACD,SAAS,cAAc,CAAC,IAAY,EAAE,OAAe,IAAY,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACxI,SAAS,IAAI,CAAC,KAAa,IAAY,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC;AAEnI,KAAK,UAAU,aAAa,CAC1B,IAAY,EACZ,WAAmB,EACnB,SAAiB,EACjB,MAAqE;IAErE,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IACvD,OAAO,YAAY,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE;QACnC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAA0B,IAAI,CAAC,CAAC;QAC9D,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAC7B,MAAM,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,YAAY,CAAI,IAAY,EAAE,MAAwB;IACnE,MAAM,IAAI,GAAG,GAAG,IAAI,OAAO,CAAC;IAC5B,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,eAAe,CAAC;IAC9C,SAAS,CAAC;QACR,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACzC,IAAI,CAAC;gBAAC,OAAO,MAAM,MAAM,EAAE,CAAC;YAAC,CAAC;oBACtB,CAAC;gBAAC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBAAC,MAAM,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAAC,CAAC;QACrH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,GAAI,KAA+B,CAAC,IAAI,CAAC;YACnD,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ;gBAAE,MAAM,KAAK,CAAC;YAC7D,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;AACH,CAAC;AAED,KAAK,UAAU,QAAQ,CAAI,IAAY,IAAgB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAM,CAAC,CAAC,CAAC;AACjH,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,KAAc;IACzD,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,IAAI,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC;IACjE,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAChE,IAAI,CAAC;QAAC,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAAC,CAAC;YAC5B,CAAC;QAAC,MAAM,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAAC,CAAC;AACxE,CAAC"}

package/dist/workers/resultSinkMcp.d.ts

@@ -0,0 +1,9 @@
+interface JsonRpcRequest {
+    jsonrpc?: string;
+    id?: string | number | null;
+    method?: string;
+    params?: Record<string, unknown>;
+}
+export declare function serveResultSinkMcp(): Promise<void>;
+export declare function handleResultSinkRequest(request: JsonRpcRequest): Promise<Record<string, unknown>>;
+export {};

package/dist/workers/resultSinkMcp.js

@@ -0,0 +1,86 @@
+import readline from "node:readline";
+import process from "node:process";
+import { pathToFileURL } from "node:url";
+import { outputJsonSchema } from "../agents/outputContracts.js";
+import { loadStructuredResultChannel } from "./resultGateway.js";
+import { commitStructuredResult } from "./resultCommit.js";
+export async function serveResultSinkMcp() {
+    const rl = readline.createInterface({ input: process.stdin, crlfDelay: Infinity });
+    for await (const line of rl) {
+        if (!line.trim())
+            continue;
+        let request;
+        try {
+            request = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (request.id === undefined || request.id === null)
+            continue;
+        try {
+            write({ jsonrpc: "2.0", id: request.id, result: await handleResultSinkRequest(request) });
+        }
+        catch (error) {
+            write({ jsonrpc: "2.0", id: request.id, error: { code: -32603, message: error instanceof Error ? error.message : String(error) } });
+        }
+    }
+}
+export async function handleResultSinkRequest(request) {
+    const root = requiredEnv("AEH_RESULT_CONTROL_ROOT");
+    const operationId = requiredEnv("AEH_RESULT_OPERATION_ID");
+    const channelId = requiredEnv("AEH_RESULT_CHANNEL_ID");
+    const channel = await loadStructuredResultChannel(root, operationId, channelId);
+    if (request.method === "initialize") {
+        return {
+            protocolVersion: typeof request.params?.protocolVersion === "string" ? request.params.protocolVersion : "2025-06-18",
+            capabilities: { tools: {} },
+            serverInfo: { name: "aeh-result-sink", version: "1" }
+        };
+    }
+    if (request.method === "ping")
+        return {};
+    if (request.method === "tools/list") {
+        return {
+            tools: [{
+                    name: "aeh_submit_result",
+                    description: `Submit the final ${channel.contract} contract result for the current controller-activated AEH turn. This durable submission is authoritative; operation, agent, contract and destination are controller-bound and cannot be supplied by the caller.`,
+                    inputSchema: outputJsonSchema(channel.contract) ?? { type: "object", additionalProperties: true }
+                }]
+        };
+    }
+    if (request.method === "tools/call") {
+        const params = request.params ?? {};
+        if (params.name !== "aeh_submit_result")
+            throw new Error(`Unknown result sink tool '${String(params.name ?? "")}'.`);
+        const payload = object(params.arguments);
+        const accepted = await commitStructuredResult(root, operationId, channelId, payload, "mcp");
+        return {
+            content: [{ type: "text", text: `Accepted ${channel.contract} result ${accepted.sha256.slice(0, 12)} for the active AEH turn.` }],
+            structuredContent: {
+                status: "ACCEPTED",
+                contract: channel.contract,
+                artifact: accepted.artifact,
+                sha256: accepted.sha256,
+                turnId: accepted.turnId
+            }
+        };
+    }
+    throw new Error(`Unsupported MCP method: ${request.method ?? "<missing>"}`);
+}
+function requiredEnv(name) {
+    const value = process.env[name]?.trim();
+    if (!value)
+        throw new Error(`${name} is required for the AEH result sink.`);
+    return value;
+}
+function object(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error("aeh_submit_result arguments must be one JSON object matching the active output contract.");
+    return value;
+}
+function write(value) { process.stdout.write(`${JSON.stringify(value)}\n`); }
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+    serveResultSinkMcp().catch((error) => { process.stderr.write(`${error instanceof Error ? error.stack ?? error.message : String(error)}\n`); process.exitCode = 1; });
+}
+//# sourceMappingURL=resultSinkMcp.js.map

package/dist/workers/resultSinkMcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resultSinkMcp.js","sourceRoot":"","sources":["../../src/workers/resultSinkMcp.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-engineering-harness",
-  "version": "0.6.21",
+  "version": "0.6.23",
   "description": "OSS-first engineering harness for deterministic, spec-driven, issue-driven, audit-governed and orchestration-first multi-agent software delivery.",
   "type": "module",
   "bin": {

package/presets/agents/orchestration.jsonc

@@ -20,10 +20,10 @@
     "operation-supervisor": {
       "role": "coordinator",
       "domains": ["*"],
-      "description": "Own semantic coordination for exactly one durable AEH operation. Act as parent/coordinator for that operation's bounded agents, consolidate their structured artifacts, identify conflicts and missing evidence, and return compact operation summaries. Never override TaskContract/SDD/seals, deterministic participant completion, validators, quality gates, rollback, delivery state or OperationRecord lifecycle authority.",
+      "description": "Own operation-local semantic coordination, delegation, consolidation, conflict detection and evidence gaps for exactly one durable AEH operation.",
       "execution": { "model": "@brain" },
       "temperature": 0.1,
-      "skills": ["finding-dedup", "acceptance-traceability", "recovery-classifier", "verification-planning"],
+      "skills": [],
       "permissions": { "read": "allow", "write": "deny", "shell": "allow", "network": "deny", "delegate": "allow", "review": "allow", "validate": "deny", "gitWrite": "deny" },
       "outputContract": "supervisor"
     },