harness-engineering-agent 0.3.24 → 0.3.26

package/dist/controller/agent-output-contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-output-contracts.d.ts","sourceRoot":"","sources":["../../src/controller/agent-output-contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AA6H5B,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKmC,CAAA;AAEpE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKiC,CAAA;AAEpE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAK+B,CAAA;AAEpE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;CAK+B,CAAA;AAEpE,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAK0B,CAAA;AAEpE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAK6B,CAAA;AAwBpE,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;CAY4B,CAAA"}

package/dist/controller/agent-output-contracts.js

@@ -0,0 +1,178 @@
+import { RunAcceptanceSchema } from "../domain/index.js";
+import { AcceptanceOutputSchema, FailureAnalyzerOutputSchema, RepairWorkerOutputSchema, TaskReviewVerifierOutputSchema, VerifierOutputSchema, WorkerOutputSchema, } from "./task-agent-schemas.js";
+const parseExample = (schema, example) => schema.parse(example);
+const workerCompletedExample = parseExample(WorkerOutputSchema, {
+    schemaVersion: "1.0.0",
+    role: "worker",
+    status: "completed",
+    summary: "Implemented the requested change and verified it locally.",
+    evidenceIds: [],
+    changedPaths: ["src/example.ts"],
+});
+const verifierPassedExample = parseExample(VerifierOutputSchema, {
+    schemaVersion: "1.0.0",
+    role: "verifier",
+    status: "passed",
+    summary: "Verification passed against the provided evidence.",
+    evidenceIds: ["verification-example"],
+});
+const taskReviewVerifierOutputExample = parseExample(TaskReviewVerifierOutputSchema, {
+    schemaVersion: "1.0.0",
+    role: "verifier",
+    status: "passed",
+    summary: "Review passed on both dimensions.",
+    evidenceIds: ["verification-example"],
+    taskReview: {
+        schemaVersion: "1.0.0",
+        reviewId: "review-example",
+        runId: "run-example",
+        taskId: "task-example",
+        requirementId: "requirement-example",
+        acceptanceCriterionIds: ["criterion-example"],
+        status: "passed",
+        summary: "Spec compliance and code quality both pass.",
+        changedPaths: ["src/example.ts"],
+        specCompliance: {
+            verdict: "pass",
+            summary: "Implementation matches the acceptance criterion.",
+            findings: [],
+        },
+        codeQuality: {
+            verdict: "pass",
+            summary: "No blocking quality findings.",
+            findings: [],
+        },
+    },
+});
+const acceptanceAcceptedExample = parseExample(AcceptanceOutputSchema, {
+    schemaVersion: "1.0.0",
+    role: "acceptance",
+    status: "accepted",
+    summary: "All acceptance criteria are satisfied by deterministic evidence.",
+    evidenceIds: ["verification-example"],
+});
+const failureAnalyzerRepairExample = parseExample(FailureAnalyzerOutputSchema, {
+    schemaVersion: "1.0.0",
+    role: "failure-analyzer",
+    action: "repair",
+    summary: "Root cause confirmed as a missing guard in the implementation.",
+    evidenceIds: ["verification-example"],
+    category: "implementation-defect",
+    confirmedRootCause: true,
+});
+const repairWorkerPlannedExample = parseExample(RepairWorkerOutputSchema, {
+    schemaVersion: "1.0.0",
+    role: "repair-worker",
+    status: "planned",
+    summary: "Narrow repair task addressing the confirmed root cause.",
+    evidenceIds: ["verification-example"],
+    repairTask: {
+        schemaVersion: "1.0.0",
+        repairTaskId: "repair-task-example",
+        version: 1,
+        sourceTaskId: "task-example",
+        sourceFailureId: "failure-example",
+        rootCauseFingerprint: "missing-null-guard-src-example",
+        summary: "Add the missing guard and re-run the failing verification.",
+        allowedPaths: ["src"],
+        acceptanceCriterionIds: ["criterion-example"],
+        retryBudget: { maxAttempts: 1, maxRepairAttempts: 0 },
+        failureEvidenceIds: ["verification-example"],
+        verificationPlan: {
+            minimalFailureSet: [
+                {
+                    name: "unit",
+                    command: "pnpm",
+                    args: ["test"],
+                    workingDirectory: ".",
+                    scope: "task",
+                    sideEffectLevel: "read_only",
+                    timeoutMs: 60000,
+                },
+            ],
+            fullVerification: [
+                {
+                    name: "typecheck",
+                    command: "pnpm",
+                    args: ["typecheck"],
+                    workingDirectory: ".",
+                    scope: "task",
+                    sideEffectLevel: "read_only",
+                    timeoutMs: 60000,
+                },
+            ],
+        },
+        phaseEvidenceKinds: ["red", "green", "refactor"],
+    },
+});
+export const WorkerOutputContract = {
+    schemaVersion: "1.0.0",
+    type: "WorkerOutput",
+    requiredFields: ["schemaVersion", "role", "status", "summary", "evidenceIds", "changedPaths"],
+    example: workerCompletedExample,
+};
+export const VerifierOutputContract = {
+    schemaVersion: "1.0.0",
+    type: "VerifierOutput",
+    requiredFields: ["schemaVersion", "role", "status", "summary", "evidenceIds"],
+    example: verifierPassedExample,
+};
+export const TaskReviewOutputContract = {
+    schemaVersion: "1.0.0",
+    type: "TaskReview",
+    requiredFields: ["schemaVersion", "role", "status", "summary", "evidenceIds", "taskReview"],
+    example: taskReviewVerifierOutputExample,
+};
+export const AcceptanceOutputContract = {
+    schemaVersion: "1.0.0",
+    type: "AcceptanceOutput",
+    requiredFields: ["schemaVersion", "role", "status", "summary", "evidenceIds"],
+    example: acceptanceAcceptedExample,
+};
+export const FailureAnalyzerOutputContract = {
+    schemaVersion: "1.0.0",
+    type: "FailureAnalyzerOutput",
+    requiredFields: ["schemaVersion", "role", "action", "summary", "evidenceIds", "category"],
+    example: failureAnalyzerRepairExample,
+};
+export const RepairWorkerOutputContract = {
+    schemaVersion: "1.0.0",
+    type: "RepairWorkerOutput",
+    requiredFields: ["schemaVersion", "role", "status", "summary", "evidenceIds", "repairTask"],
+    example: repairWorkerPlannedExample,
+};
+const runAcceptanceExample = parseExample(RunAcceptanceSchema, {
+    schemaVersion: "1.0.0",
+    acceptanceId: "acceptance-example",
+    runId: "run-example",
+    status: "accepted",
+    summary: "Every criterion decision is backed by deterministic evidence.",
+    criterionDecisions: [
+        {
+            criterionId: "criterion-example",
+            requirementId: "requirement-example",
+            status: "accepted",
+            taskIds: ["task-example"],
+            taskReviewIds: ["review-example"],
+            evidenceIds: ["verification-example"],
+            failureIds: [],
+            waiverIds: [],
+            changedPaths: ["src/example.ts"],
+            summary: "Criterion satisfied by the verified implementation.",
+        },
+    ],
+});
+export const RunAcceptanceOutputContract = {
+    schemaVersion: "1.0.0",
+    type: "RunAcceptance",
+    requiredFields: [
+        "schemaVersion",
+        "acceptanceId",
+        "runId",
+        "status",
+        "summary",
+        "criterionDecisions",
+    ],
+    example: runAcceptanceExample,
+};
+//# sourceMappingURL=agent-output-contracts.js.map

package/dist/controller/agent-output-contracts.js.map

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

package/dist/controller/agent-output-protocol.d.ts

@@ -4,6 +4,7 @@ export type AgentOutputStatus = "completed" | "failed" | "blocked" | "partial";
 export type AgentOutputDiagnostics = {
     readonly normalizationSteps: readonly string[];
     readonly sourcePreview: string;
+    readonly sourceLength?: number;
     readonly parsePosition?: number;
 };
 export type AgentOutputEnvelope<T> = {
@@ -14,7 +15,7 @@ export type AgentOutputEnvelope<T> = {
     readonly payload: T;
     readonly diagnostics?: AgentOutputDiagnostics;
 };
-export type AgentOutputProtocolErrorCode = "invalid-json" | "ambiguous-json" | "invalid-envelope" | "unsupported-version";
+export type AgentOutputProtocolErrorCode = "invalid-json" | "ambiguous-json" | "invalid-envelope" | "unsupported-version" | "output-truncated";
 export declare class AgentOutputProtocolError extends Error {
     readonly code: AgentOutputProtocolErrorCode;
     readonly diagnostics: AgentOutputDiagnostics;
@@ -22,5 +23,10 @@ export declare class AgentOutputProtocolError extends Error {
     constructor(code: AgentOutputProtocolErrorCode, diagnostics: AgentOutputDiagnostics, message: string, options?: ErrorOptions);
 }
 export declare const parseAgentOutput: <T>(text: string, schema: ZodType<T>, role: string) => T;
+export type ParsedAgentJsonValue = {
+    readonly value: unknown;
+    readonly diagnostics: AgentOutputDiagnostics;
+};
+export declare const parseAgentJsonValueDetailed: (text: string, role: string) => ParsedAgentJsonValue;
 export declare const parseAgentJsonValue: (text: string, role: string) => unknown;
 //# sourceMappingURL=agent-output-protocol.d.ts.map

package/dist/controller/agent-output-protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-output-protocol.d.ts","sourceRoot":"","sources":["../../src/controller/agent-output-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,OAAO,EAAE,MAAM,KAAK,CAAA;AAE5C,eAAO,MAAM,6BAA6B,EAAG,OAAgB,CAAA;AAE7D,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAA;AAE9E,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAA;IAC9C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI;IACnC,QAAQ,CAAC,eAAe,EAAE,OAAO,6BAA6B,CAAA;IAC9D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAA;IAClC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;IACnB,QAAQ,CAAC,WAAW,CAAC,EAAE,sBAAsB,CAAA;CAC9C,CAAA;AAED,MAAM,MAAM,4BAA4B,GACpC,cAAc,GACd,gBAAgB,GAChB,kBAAkB,GAClB,qBAAqB,CAAA;AAEzB,qBAAa,wBAAyB,SAAQ,KAAK;IAI/C,QAAQ,CAAC,IAAI,EAAE,4BAA4B;IAC3C,QAAQ,CAAC,WAAW,EAAE,sBAAsB;IAJ9C,QAAQ,CAAC,IAAI,8BAA6B;gBAG/B,IAAI,EAAE,4BAA4B,EAClC,WAAW,EAAE,sBAAsB,EAC5C,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,YAAY;CAIzB;AAED,eAAO,MAAM,gBAAgB,GAAI,CAAC,EAAE,MAAM,MAAM,EAAE,QAAQ,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,MAAM,KAAG,CAepF,CAAA;AAED,eAAO,MAAM,mBAAmB,GAAI,MAAM,MAAM,EAAE,MAAM,MAAM,KAAG,OAgChE,CAAA"}
+{"version":3,"file":"agent-output-protocol.d.ts","sourceRoot":"","sources":["../../src/controller/agent-output-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,OAAO,EAAE,MAAM,KAAK,CAAA;AAE5C,eAAO,MAAM,6BAA6B,EAAG,OAAgB,CAAA;AAE7D,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAA;AAE9E,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAA;IAC9C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI;IACnC,QAAQ,CAAC,eAAe,EAAE,OAAO,6BAA6B,CAAA;IAC9D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAA;IAClC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;IACnB,QAAQ,CAAC,WAAW,CAAC,EAAE,sBAAsB,CAAA;CAC9C,CAAA;AAED,MAAM,MAAM,4BAA4B,GACpC,cAAc,GACd,gBAAgB,GAChB,kBAAkB,GAClB,qBAAqB,GACrB,kBAAkB,CAAA;AAEtB,qBAAa,wBAAyB,SAAQ,KAAK;IAI/C,QAAQ,CAAC,IAAI,EAAE,4BAA4B;IAC3C,QAAQ,CAAC,WAAW,EAAE,sBAAsB;IAJ9C,QAAQ,CAAC,IAAI,8BAA6B;gBAG/B,IAAI,EAAE,4BAA4B,EAClC,WAAW,EAAE,sBAAsB,EAC5C,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,YAAY;CAIzB;AAED,eAAO,MAAM,gBAAgB,GAAI,CAAC,EAAE,MAAM,MAAM,EAAE,QAAQ,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,MAAM,KAAG,CAepF,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,WAAW,EAAE,sBAAsB,CAAA;CAC7C,CAAA;AAED,eAAO,MAAM,2BAA2B,GAAI,MAAM,MAAM,EAAE,MAAM,MAAM,KAAG,oBAiCxE,CAAA;AAED,eAAO,MAAM,mBAAmB,GAAI,MAAM,MAAM,EAAE,MAAM,MAAM,KAAG,OAClB,CAAA"}

package/dist/controller/agent-output-protocol.js

@@ -22,14 +22,15 @@ export const parseAgentOutput = (text, schema, role) => {
         throw error;
     }
 };
-export const parseAgentJsonValue = (text, role) => {
+export const parseAgentJsonValueDetailed = (text, role) => {
     const normalized = normalizeJsonText(text);
     let value;
     try {
         value = JSON.parse(normalized.text);
     }
     catch (error) {
-        throw new AgentOutputProtocolError("invalid-json", normalized.diagnostics, `${role} agent returned invalid JSON`, { cause: error });
+        const repaired = normalized.diagnostics.normalizationSteps.includes("repaired-truncated-json");
+        throw new AgentOutputProtocolError(repaired ? "output-truncated" : "invalid-json", normalized.diagnostics, `${role} agent returned invalid JSON`, { cause: error });
     }
     if (isEnvelope(value)) {
         if (value.protocolVersion.split(".")[0] !== AGENT_OUTPUT_PROTOCOL_VERSION.split(".")[0]) {
@@ -38,10 +39,11 @@ export const parseAgentJsonValue = (text, role) => {
         if (value.agentRole !== role) {
             throw new AgentOutputProtocolError("invalid-envelope", normalized.diagnostics, `${role} agent envelope identifies role ${value.agentRole}`);
         }
-        return value.payload;
+        return { value: value.payload, diagnostics: normalized.diagnostics };
     }
-    return value;
+    return { value, diagnostics: normalized.diagnostics };
 };
+export const parseAgentJsonValue = (text, role) => parseAgentJsonValueDetailed(text, role).value;
 const isEnvelope = (value) => {
     if (typeof value !== "object" || value === null || Array.isArray(value))
         return false;
@@ -66,13 +68,18 @@ const normalizeJsonText = (input) => {
         text = fenced[1].trim();
         steps.push("removed-json-code-fence");
     }
-    if (!text.startsWith("{") && !text.startsWith("[")) {
-        const start = findJsonStart(text);
-        if (start !== -1) {
-            const extracted = extractBalancedJson(text, start);
-            if (extracted === null) {
-                throw new AgentOutputProtocolError("invalid-json", createDiagnostics(input, steps, start), "agent output contains incomplete JSON");
+    const start = findJsonStart(text);
+    if (start !== -1) {
+        const extracted = extractBalancedJson(text, start);
+        if (extracted === null) {
+            const repaired = repairTruncatedJson(text.slice(start));
+            if (repaired === null) {
+                throw new AgentOutputProtocolError("output-truncated", createDiagnostics(input, steps, start, input.length), "agent output contains truncated JSON that could not be auto-repaired");
             }
+            text = `${text.slice(0, start)}${repaired}`;
+            steps.push("repaired-truncated-json");
+        }
+        else {
             const trailing = text.slice(extracted.end).trim();
             if (trailing.length > 0) {
                 throw new AgentOutputProtocolError("ambiguous-json", createDiagnostics(text, steps, start), "agent output contains non-JSON content after the JSON value");
@@ -81,11 +88,58 @@ const normalizeJsonText = (input) => {
             steps.push("extracted-balanced-json");
         }
     }
-    return { text, diagnostics: createDiagnostics(input, steps) };
+    return { text, diagnostics: createDiagnostics(input, steps, undefined, input.length) };
+};
+const repairTruncatedJson = (text) => {
+    const opening = text[0];
+    if (opening !== "{" && opening !== "[")
+        return null;
+    const stack = [];
+    let inString = false;
+    let escaped = false;
+    for (let index = 0; index < text.length; index += 1) {
+        const character = text[index];
+        if (inString) {
+            if (escaped) {
+                escaped = false;
+                continue;
+            }
+            if (character === "\\") {
+                escaped = true;
+                continue;
+            }
+            if (character === '"')
+                inString = false;
+            continue;
+        }
+        if (character === '"') {
+            inString = true;
+            continue;
+        }
+        if (character === "{" || character === "[") {
+            stack.push(character === "{" ? "}" : "]");
+            continue;
+        }
+        if (character === "}" || character === "]") {
+            const expected = stack.pop();
+            if (expected !== character)
+                return null;
+        }
+    }
+    let repaired = text;
+    if (inString) {
+        if (escaped)
+            repaired = repaired.slice(0, -1);
+        repaired += '"';
+    }
+    repaired = repaired.replace(/:\s*$/u, ":null").replace(/,\s*$/u, "");
+    repaired += stack.reverse().join("");
+    return repaired;
 };
-const createDiagnostics = (source, normalizationSteps, parsePosition) => ({
+const createDiagnostics = (source, normalizationSteps, parsePosition, sourceLength) => ({
     normalizationSteps,
     sourcePreview: source.slice(0, 500).replace(/\s+/gu, " "),
+    ...(sourceLength === undefined ? {} : { sourceLength }),
     ...(parsePosition === undefined ? {} : { parsePosition }),
 });
 const findJsonStart = (text) => {

package/dist/controller/agent-output-protocol.js.map

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

package/dist/controller/agent-output.d.ts

@@ -15,6 +15,11 @@ export declare class StructuredAgentOutputError extends Error {
     constructor(code: StructuredAgentOutputErrorCode, details: StructuredAgentOutputErrorDetails);
 }
 export declare const readAgentOutput: (result: SessionRunResult) => string;
+/**
+ * 结构化失败诊断：任意角色会话解析/合同失败时输出到 stderr，
+ * 便于从日志直接定位（role、attempt、reasonCode、输出长度、sourcePreview）。
+ */
+export declare const emitAgentDiagnostics: (role: string, error: unknown, attempt: number) => void;
 export declare const parseAgentJson: <T>(text: string, schema: ZodType<T>, role: string) => T;
 export declare const assertAgentSuggestedStatus: (role: string, suggestedStatus: string, allowedStatuses: readonly string[]) => void;
 export {};

package/dist/controller/agent-output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-output.d.ts","sourceRoot":"","sources":["../../src/controller/agent-output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,OAAO,EAAE,MAAM,KAAK,CAAA;AAG5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAO3D,KAAK,8BAA8B,GAC/B,gCAAgC,GAChC,2BAA2B,GAC3B,4BAA4B,CAAA;AAEhC,KAAK,iCAAiC,GAAG;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAA;CACxC,CAAA;AAED,qBAAa,0BAA2B,SAAQ,KAAK;IAIjD,QAAQ,CAAC,IAAI,EAAE,8BAA8B;IAC7C,QAAQ,CAAC,OAAO,EAAE,iCAAiC;IAJrD,QAAQ,CAAC,IAAI,gCAA+B;gBAGjC,IAAI,EAAE,8BAA8B,EACpC,OAAO,EAAE,iCAAiC;CAItD;AAED,eAAO,MAAM,eAAe,GAAI,QAAQ,gBAAgB,KAAG,MAS1D,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,CAAC,EAAE,MAAM,MAAM,EAAE,QAAQ,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,MAAM,KAAG,CAqBlF,CAAA;AA8BD,eAAO,MAAM,0BAA0B,GACrC,MAAM,MAAM,EACZ,iBAAiB,MAAM,EACvB,iBAAiB,SAAS,MAAM,EAAE,KACjC,IASF,CAAA"}
+{"version":3,"file":"agent-output.d.ts","sourceRoot":"","sources":["../../src/controller/agent-output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,OAAO,EAAE,MAAM,KAAK,CAAA;AAG5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAa3D,KAAK,8BAA8B,GAC/B,gCAAgC,GAChC,2BAA2B,GAC3B,4BAA4B,CAAA;AAEhC,KAAK,iCAAiC,GAAG;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAA;CACxC,CAAA;AAED,qBAAa,0BAA2B,SAAQ,KAAK;IAIjD,QAAQ,CAAC,IAAI,EAAE,8BAA8B;IAC7C,QAAQ,CAAC,OAAO,EAAE,iCAAiC;IAJrD,QAAQ,CAAC,IAAI,gCAA+B;gBAGjC,IAAI,EAAE,8BAA8B,EACpC,OAAO,EAAE,iCAAiC;CAItD;AAED,eAAO,MAAM,eAAe,GAAI,QAAQ,gBAAgB,KAAG,MAqB1D,CAAA;AAUD;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,EAAE,OAAO,OAAO,EAAE,SAAS,MAAM,KAAG,IAWpF,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,CAAC,EAAE,MAAM,MAAM,EAAE,QAAQ,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,MAAM,KAAG,CAsClF,CAAA;AAkHD,eAAO,MAAM,0BAA0B,GACrC,MAAM,MAAM,EACZ,iBAAiB,MAAM,EACvB,iBAAiB,SAAS,MAAM,EAAE,KACjC,IASF,CAAA"}

package/dist/controller/agent-output.js

@@ -1,7 +1,7 @@
 import { ZodError } from "zod";
-import { findUnauthorizedSuggestedSignal } from "../agent/index.js";
-import { AgentOutputProtocolError, parseAgentJsonValue } from "./agent-output-protocol.js";
-import { AgentOutputParseError, AgentRunFailedError, RunCancellationError } from "./errors.js";
+import { findUnauthorizedSuggestedSignal, HARNESS_AGENT_CAPABILITIES } from "../agent/index.js";
+import { AgentOutputProtocolError, parseAgentJsonValueDetailed } from "./agent-output-protocol.js";
+import { AgentOutputParseError, AgentRunFailedError, RunCancellationError, } from "./errors.js";
 import { normalizeFailureAnalyzerOutput } from "./failure-analyzer-schemas.js";
 const SUPPORTED_SCHEMA_MAJOR_VERSION = 1;
 export class StructuredAgentOutputError extends Error {
@@ -16,41 +16,154 @@ export class StructuredAgentOutputError extends Error {
 }
 export const readAgentOutput = (result) => {
     switch (result.kind) {
-        case "completed":
-            return result.outputText;
+        case "completed": {
+            const outputText = result.outputText;
+            if (outputText.trim().length === 0) {
+                throw new AgentOutputParseError(result.role, "empty output: session completed without any text content", {
+                    reasonCode: "empty-output",
+                    diagnostics: { sourcePreview: "", sourceLength: 0 },
+                });
+            }
+            return outputText;
+        }
         case "failed":
             throw new AgentRunFailedError(result.role, result.error.message);
         case "aborted":
             throw new RunCancellationError(result.sessionId);
     }
 };
+const toErrorDiagnostics = (diagnostics) => ({
+    sourcePreview: diagnostics.sourcePreview,
+    ...(diagnostics.sourceLength === undefined ? {} : { sourceLength: diagnostics.sourceLength }),
+    ...(diagnostics.parsePosition === undefined ? {} : { parsePosition: diagnostics.parsePosition }),
+});
+/**
+ * 结构化失败诊断：任意角色会话解析/合同失败时输出到 stderr，
+ * 便于从日志直接定位（role、attempt、reasonCode、输出长度、sourcePreview）。
+ */
+export const emitAgentDiagnostics = (role, error, attempt) => {
+    const parseError = error instanceof AgentOutputParseError ? error : undefined;
+    const diagnostics = parseError?.diagnostics;
+    const payload = {
+        role,
+        attempt,
+        reasonCode: parseError?.reasonCode ?? "unknown",
+        outputLength: diagnostics?.sourceLength ?? null,
+        sourcePreview: diagnostics?.sourcePreview ?? "",
+    };
+    process.stderr.write(`HARNESS_AGENT_DIAG ${JSON.stringify(payload)}\n`);
+};
 export const parseAgentJson = (text, schema, role) => {
+    let repaired = false;
+    let lastDiagnostics;
     try {
-        const parsed = normalizeRoleSpecificOutput(parseAgentJsonValue(text, role), role);
+        const { value, diagnostics } = parseAgentJsonValueDetailed(text, role);
+        lastDiagnostics = toErrorDiagnostics(diagnostics);
+        repaired = diagnostics.normalizationSteps.includes("repaired-truncated-json");
+        const parsed = normalizeRoleSpecificOutput(value, role);
         assertSupportedSchemaVersion(parsed, role);
         assertRoleAuthorizedSignals(parsed, role);
         return schema.parse(parsed);
     }
     catch (error) {
+        const reasonCode = deriveReasonCode(error, repaired);
+        const diagnostics = error instanceof AgentOutputProtocolError
+            ? toErrorDiagnostics(error.diagnostics)
+            : lastDiagnostics;
+        const throwParseError = (reason, options) => {
+            throw new AgentOutputParseError(role, reason, {
+                ...(options ?? {}),
+                reasonCode,
+                diagnostics,
+            });
+        };
         if (error instanceof StructuredAgentOutputError) {
-            throw new AgentOutputParseError(role, error.message, { cause: error });
+            throwParseError(error.message);
         }
         if (error instanceof ZodError) {
-            throw new AgentOutputParseError(role, summarizeZodError(error), { cause: error });
+            throwParseError(summarizeZodError(error, role));
         }
         if (error instanceof AgentOutputProtocolError) {
-            throw new AgentOutputParseError(role, error.message, { cause: error });
+            throwParseError(error.message);
         }
         if (error instanceof SyntaxError) {
-            throw new AgentOutputParseError(role, summarizeText(error.message), { cause: error });
+            throwParseError(summarizeText(error.message));
         }
         throw error;
     }
 };
-const summarizeZodError = (error) => summarizeText(error.issues
+const deriveReasonCode = (error, repaired) => {
+    if (error instanceof AgentOutputProtocolError) {
+        if (error.code === "output-truncated")
+            return "truncated";
+        if (error.diagnostics.normalizationSteps.includes("repaired-truncated-json")) {
+            return "truncated";
+        }
+        return "invalid-json";
+    }
+    if (error instanceof ZodError) {
+        return repaired ? "truncated" : "schema";
+    }
+    if (error instanceof StructuredAgentOutputError)
+        return "schema";
+    if (error instanceof SyntaxError)
+        return "invalid-json";
+    return "unknown";
+};
+const summarizeZodError = (error, role) => summarizeText(error.issues
     .slice(0, 20)
-    .map((issue) => `${issue.path.join(".") || "root"}: ${issue.message}`)
+    .map((issue) => summarizeZodIssue(error, issue, role))
     .join("; "));
+const summarizeZodIssue = (error, issue, role) => {
+    const path = issue.path.map(String).join(".") || "root";
+    if (issue.code === "invalid_union") {
+        const expectedValues = collectDiscriminatorExpectations(error, issue.path.map(String), role);
+        if (expectedValues.length > 0) {
+            return `${path}: expected one of ${expectedValues.join(" | ")}`;
+        }
+    }
+    return `${path}: ${issue.message}`;
+};
+const collectDiscriminatorExpectations = (error, issuePath, role) => {
+    const expectations = new Set();
+    const discriminatorField = issuePath.at(-1);
+    for (const issue of error.issues) {
+        if (issue.code !== "invalid_union" || !("unionErrors" in issue)) {
+            continue;
+        }
+        if (!pathsMatch(issue.path.map(String), issuePath)) {
+            continue;
+        }
+        for (const unionError of issue.unionErrors) {
+            for (const candidate of unionError.issues) {
+                const candidatePath = candidate.path.map(String);
+                if (candidate.code === "invalid_type" &&
+                    candidatePath.length === 1 &&
+                    candidatePath[0] === discriminatorField &&
+                    typeof candidate.expected === "string") {
+                    expectations.add(`"${candidate.expected}"`);
+                }
+            }
+        }
+    }
+    if (expectations.size === 0) {
+        // Zod 4 在 discriminator 无匹配时不携带分支信息；回退到角色 capability 的建议值
+        const capability = HARNESS_AGENT_CAPABILITIES.find((item) => item.sessionRole === role);
+        if (capability !== undefined && discriminatorField !== undefined) {
+            const suggestions = discriminatorField === "status"
+                ? capability.suggestions.status
+                : discriminatorField === "action"
+                    ? capability.suggestions.action
+                    : undefined;
+            for (const value of suggestions ?? []) {
+                expectations.add(`"${value}"`);
+            }
+        }
+    }
+    return [...expectations].sort();
+};
+const pathsMatch = (left, right) => left.length === right.length &&
+    left.every((segment, index) => String(segment) === String(right[index]));
 const summarizeText = (text) => {
     const maxLength = 4_000;
     return text.length <= maxLength ? text : `${text.slice(0, maxLength - 3)}...`;

package/dist/controller/agent-output.js.map

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

package/dist/controller/agent-session-utils.d.ts

@@ -76,6 +76,11 @@ export type OrphanSession = {
 export declare const listOrphanSessions: (input: {
     readonly store: RunStore;
 }) => Promise<readonly OrphanSession[]>;
+/**
+ * 防御性兜底：sendAgent 内的 AbortController 定时器负责中断挂起的 prompt 请求（超时主路径），
+ * 本定时器在超时后再兜底调用 abort API 并释放会话，确保即使 signal 路径失效，会话也不会泄漏。
+ * 两者使用相同的 timeoutMs，幂等不冲突。
+ */
 export declare const createTimeout: (input: {
     readonly runId: RunId;
     readonly sessionId: string;