agentic-engineering-harness 0.6.22 → 0.6.24

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":"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"}

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.22",
+  "version": "0.6.24",
   "description": "OSS-first engineering harness for deterministic, spec-driven, issue-driven, audit-governed and orchestration-first multi-agent software delivery.",
   "type": "module",
   "bin": {

package/skills/structured-output-delivery/SKILL.md

@@ -1,22 +1,23 @@
 ---
 name: structured-output-delivery
-description: Deliver machine-consumed AEH agent results as valid JSON that satisfies the runtime output contract.
+description: Deliver machine-consumed AEH agent results through the controller-owned structured result channel.
 license: Apache-2.0
 ---
 # Structured Output Delivery
 
-This skill governs delivery format only. It never changes the task conclusion, findings, evidence, or lifecycle authority.
+This skill governs delivery only. It never changes the task conclusion, findings, evidence, or lifecycle authority.
 
 When AEH supplies an output contract or JSON Schema:
 
 1. Treat the schema as authoritative and machine-consumed.
-2. Return exactly one JSON value matching that schema as the final result.
-3. Use ordinary ASCII JSON syntax. String delimiters must be U+0022 (`"`); never use typographic quotes such as `“` or `”`.
-4. Do not wrap the JSON in Markdown fences, headings, bullets, or explanatory prose.
-5. Do not omit required fields, rename fields, or invent undeclared fields to make serialization easier.
-6. Preserve the semantic result already established by the task. Formatting repair must not add findings, remove findings, rerun tools, or change conclusions.
-7. If the transport cannot return native structured output and AEH explicitly requests the marker fallback, return exactly one line in this form:
+2. Preserve the semantic result already established by the task. Delivery repair must not add findings, remove findings, rerun tools, or change conclusions.
+3. If the capability-scoped `aeh_submit_result` tool is available, call it exactly with the final contract object. Do not supply operation ids, agent ids, contract names, paths, or lifecycle state; those are controller-bound.
+4. A successful `aeh_submit_result` call is the authoritative delivery. Do not call it again with a different payload. If the provider requires a native structured final response, it may repeat the same object only for transport compatibility.
+5. If the tool rejects the payload, correct only the reported schema/serialization defect and resubmit the same semantic result.
+6. If no result-sink tool is available, return exactly one JSON value matching the schema. Use ordinary ASCII JSON syntax; string delimiters must be U+0022 (`"`), never typographic quotes.
+7. Do not wrap JSON in Markdown fences, headings, bullets, or explanatory prose.
+8. Only when AEH explicitly requests the legacy marker fallback and no result-sink tool is available, return exactly one line:
 
 `AEH_RESULT_JSON=<valid compact JSON>`
 
-Before completing the turn, check syntactically that the payload could be parsed by a standard JSON parser and that enum values and required fields match the supplied contract.
+Before completing a fallback delivery, check syntactically that a standard JSON parser can parse the payload and that enum values and required fields match the supplied contract.