@claudexor/orchestrator 1.0.1

package/dist/runTerminals.js

@@ -0,0 +1,124 @@
+/**
+ * Terminal-state machinery shared by every strategy: typed failure artifacts,
+ * the cancelled terminal, and the announced-run safety net. Every run that
+ * was ANNOUNCED (run.created after createRun) must end with a terminal event
+ * — run.completed, run.blocked, or run.failed — plus failure.yaml/summary
+ * artifacts on the failure paths. An escaped throw used to orphan the run
+ * dir, leaving events.jsonl without a terminal and SSE tailers waiting
+ * forever.
+ */
+import { join } from "node:path";
+import { redactSecrets } from "@claudexor/util";
+export function writeFailure(store, paths, failure) {
+    store.writeYaml(join(paths.finalDir, "failure.yaml"), {
+        phase: failure.phase,
+        category: failure.category,
+        harnessId: failure.harnessId ?? null,
+        attemptId: failure.attemptId ?? null,
+        safeMessage: redactSecrets(failure.safeMessage),
+        rawDetailRef: failure.rawDetailRef ?? null,
+        logRefs: failure.logRefs ?? [],
+        eventRefs: failure.eventRefs ?? [],
+        runDir: failure.runDir ?? paths.root,
+        nextActions: failure.nextActions ?? [],
+    });
+}
+/**
+ * Terminal result for a cancelled run: emits run.failed with status
+ * "cancelled" so every mode ends consistently. `writeTelemetry` carries the
+ * PARTIAL attempt telemetry collected before the abort — a cancelled run
+ * must still account for what it spent and observed; it used to be
+ * written only by convergence.
+ */
+export function cancelledResult(log, runId, taskId, mode, runDir, candidates, writeTelemetry, spendUsd) {
+    if (writeTelemetry) {
+        try {
+            writeTelemetry();
+        }
+        catch {
+            /* partial telemetry is best-effort on the cancel path */
+        }
+    }
+    log.emit("run.failed", { status: "cancelled" });
+    return {
+        runId,
+        taskId,
+        mode,
+        status: "cancelled",
+        winner: null,
+        runDir,
+        summary: "run cancelled",
+        candidates,
+        ...(spendUsd !== undefined ? { spendUsd } : {}),
+    };
+}
+/**
+ * Terminal safety net for an unexpected throw in a post-announce phase.
+ * Every run must end with failure.yaml + summary + a terminal run.failed
+ * event.
+ */
+export function failTerminally(log, store, paths, runId, taskId, mode, phase, err, spendUsd) {
+    const message = redactSecrets(err instanceof Error ? err.message : String(err));
+    store.writeText(join(paths.finalDir, "summary.md"), `# Run ${runId} (${mode})\n\n- Status: failed\n- Phase: ${phase}\n\n${message}\n`);
+    writeFailure(store, paths, {
+        phase,
+        category: "internal",
+        safeMessage: message,
+        runDir: paths.root,
+        nextActions: ["Open diagnostics", "Retry the run"],
+    });
+    log.emit("output.ready", { kind: "summary", path: "final/summary.md", state: "diagnostic" });
+    log.emit("run.failed", {
+        status: "failed",
+        phase,
+        error: message,
+        failure_ref: "final/failure.yaml",
+    });
+    return {
+        runId,
+        taskId,
+        mode,
+        status: "failed",
+        winner: null,
+        runDir: paths.root,
+        summary: message,
+        candidates: [],
+        ...(spendUsd !== undefined ? { spendUsd } : {}),
+    };
+}
+/**
+ * Whole-strategy terminal net: run `body`; if it throws AFTER announcing,
+ * stamp terminal artifacts instead of orphaning the run. Pre-announce throws
+ * keep the loud-request contract (the caller gets the error; no run dir
+ * exists). An abort surfaced as a throw is a CANCELLED terminal, not an
+ * internal failure.
+ */
+export async function guardAnnouncedRun(signal, body) {
+    let announced = null;
+    try {
+        return await body((a) => {
+            announced = a;
+        });
+    }
+    catch (err) {
+        // TS cannot see the closure assignment; the cast is safe (set-once).
+        const a = announced;
+        if (!a)
+            throw err;
+        // Settled-spend accounting is part of the terminal contract on EVERY
+        // path (the orchestrate executor aggregates it); a broken spend snapshot
+        // must not mask the original failure, so it degrades to null loudly-typed.
+        let spendUsd = null;
+        try {
+            spendUsd = a.spend ? a.spend() : null;
+        }
+        catch {
+            spendUsd = null;
+        }
+        if (signal?.aborted) {
+            return cancelledResult(a.log, a.runId, a.taskId, a.mode, a.paths.root, [], undefined, spendUsd);
+        }
+        return failTerminally(a.log, a.store, a.paths, a.runId, a.taskId, a.mode, a.phase, err, spendUsd);
+    }
+}
+//# sourceMappingURL=runTerminals.js.map

package/dist/runTerminals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runTerminals.js","sourceRoot":"","sources":["../src/runTerminals.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAiBhD,MAAM,UAAU,YAAY,CAC1B,KAAoB,EACpB,KAA4C,EAC5C,OAWC;IAED,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,cAAc,CAAC,EAAE;QACpD,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;QACpC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;QACpC,WAAW,EAAE,aAAa,CAAC,OAAO,CAAC,WAAW,CAAC;QAC/C,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,IAAI;QAC1C,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;QAC9B,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE;QAClC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI;QACpC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE;KACvC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,GAAa,EACb,KAAa,EACb,MAAc,EACd,IAAc,EACd,MAAc,EACd,UAAsE,EACtE,cAA2B,EAC3B,QAAwB;IAExB,IAAI,cAAc,EAAE,CAAC;QACnB,IAAI,CAAC;YACH,cAAc,EAAE,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACP,yDAAyD;QAC3D,CAAC;IACH,CAAC;IACD,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IAChD,OAAO;QACL,KAAK;QACL,MAAM;QACN,IAAI;QACJ,MAAM,EAAE,WAAW;QACnB,MAAM,EAAE,IAAI;QACZ,MAAM;QACN,OAAO,EAAE,eAAe;QACxB,UAAU;QACV,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChD,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAa,EACb,KAAoB,EACpB,KAA4C,EAC5C,KAAa,EACb,MAAc,EACd,IAAc,EACd,KAAa,EACb,GAAY,EACZ,QAAwB;IAExB,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAChF,KAAK,CAAC,SAAS,CACb,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,YAAY,CAAC,EAClC,SAAS,KAAK,KAAK,IAAI,mCAAmC,KAAK,OAAO,OAAO,IAAI,CAClF,CAAC;IACF,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE;QACzB,KAAK;QACL,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE,OAAO;QACpB,MAAM,EAAE,KAAK,CAAC,IAAI;QAClB,WAAW,EAAE,CAAC,kBAAkB,EAAE,eAAe,CAAC;KACnD,CAAC,CAAC;IACH,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;IAC7F,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE;QACrB,MAAM,EAAE,QAAQ;QAChB,KAAK;QACL,KAAK,EAAE,OAAO;QACd,WAAW,EAAE,oBAAoB;KAClC,CAAC,CAAC;IACH,OAAO;QACL,KAAK;QACL,MAAM;QACN,IAAI;QACJ,MAAM,EAAE,QAAQ;QAChB,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,KAAK,CAAC,IAAI;QAClB,OAAO,EAAE,OAAO;QAChB,UAAU,EAAE,EAAE;QACd,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChD,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAA+B,EAC/B,IAAiF;IAEjF,IAAI,SAAS,GAA+B,IAAI,CAAC;IACjD,IAAI,CAAC;QACH,OAAO,MAAM,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;YACtB,SAAS,GAAG,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,qEAAqE;QACrE,MAAM,CAAC,GAAG,SAAuC,CAAC;QAClD,IAAI,CAAC,CAAC;YAAE,MAAM,GAAG,CAAC;QAClB,qEAAqE;QACrE,yEAAyE;QACzE,2EAA2E;QAC3E,IAAI,QAAQ,GAAkB,IAAI,CAAC;QACnC,IAAI,CAAC;YACH,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;QACD,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,OAAO,eAAe,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QAClG,CAAC;QACD,OAAO,cAAc,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;IACpG,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@claudexor/orchestrator",
+  "version": "1.0.1",
+  "license": "MIT",
+  "description": "Hub that composes all subsystems and implements the five canonical modes (ask, plan, audit, agent, orchestrate) with their strategy flags (best-of-N race, attempt caps, until-clean, swarm, create).",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@claudexor/arbitration": "1.0.1",
+    "@claudexor/artifact-store": "1.0.1",
+    "@claudexor/budget": "1.0.1",
+    "@claudexor/config": "1.0.1",
+    "@claudexor/core": "1.0.1",
+    "@claudexor/delivery": "1.0.1",
+    "@claudexor/event-log": "1.0.1",
+    "@claudexor/context": "1.0.1",
+    "@claudexor/gateway": "1.0.1",
+    "@claudexor/policy": "1.0.1",
+    "@claudexor/interview": "1.0.1",
+    "@claudexor/review": "1.0.1",
+    "@claudexor/schema": "1.0.1",
+    "@claudexor/workspace": "1.0.1",
+    "@claudexor/util": "1.0.1",
+    "@claudexor/synthesis": "1.0.1"
+  },
+  "devDependencies": {
+    "@claudexor/harness-fake": "1.0.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/razzant/claudexor.git",
+    "directory": "packages/orchestrator"
+  },
+  "homepage": "https://github.com/razzant/claudexor#readme",
+  "bugs": {
+    "url": "https://github.com/razzant/claudexor/issues"
+  },
+  "engines": {
+    "node": ">=20.19"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  }
+}