@cat-factory/orchestration 0.105.5 → 0.106.0

package/dist/modules/execution/job.logic.js

@@ -1,3 +1,4 @@
+import { DomainError, getErrorMessage } from '@cat-factory/kernel';
 /**
  * Maximum number of times a step's *crash* eviction (OOM / a genuine crash) is
  * recovered automatically by re-dispatching a fresh container for the same step.
@@ -42,6 +43,38 @@ export const TRANSIENT_EVICTION_MARKER = 'transient infrastructure eviction';
 export function isContainerEvictionError(error) {
     return error !== undefined && /evicted or crashed/i.test(error);
 }
+/**
+ * Classify a throw from an async agent dispatch (`startJob`) into a terminal failure. The
+ * dispatch catch used to assume EVERY throw was the container failing to accept the job, but a
+ * job is also built (auth, repo target, context) BEFORE any container is contacted — so a
+ * precondition can reject it up front. Three cases, most-specific first:
+ *
+ *  - A domain PRECONDITION error (any {@link DomainError}, e.g. the `github_not_connected`
+ *    `ConflictError` raised while building the job because the workspace has no connected repo)
+ *    was rejected before dispatch. That is a `preflight` failure, not a container `dispatch`
+ *    blip: surface its own actionable message and propagate its machine-readable `reason` so
+ *    the SPA renders precise guidance ("GitHub not connected") instead of the misleading
+ *    "container failed to start".
+ *  - A container eviction/crash routes to `evicted` (a fresh-container retry may help).
+ *  - Anything else is a genuine container accept failure (`dispatch`): the container/runner
+ *    never accepted the job (an HTTP/network error, a capacity blip).
+ */
+export function classifyDispatchFailure(error) {
+    const message = getErrorMessage(error);
+    if (error instanceof DomainError) {
+        const reason = error.details?.reason;
+        return {
+            error: message,
+            failureKind: 'preflight',
+            detail: message,
+            reason: typeof reason === 'string' ? reason : undefined,
+        };
+    }
+    if (isContainerEvictionError(message)) {
+        return { error: message, failureKind: 'evicted', detail: message };
+    }
+    return { error: 'The container failed to start.', failureKind: 'dispatch', detail: message };
+}
 /**
  * Whether a container eviction was flagged by the runtime facade as *transient
  * infrastructure churn* (the facade tagged it with {@link TRANSIENT_EVICTION_MARKER})

package/dist/modules/execution/job.logic.js.map

@@ -1 +1 @@
-{"version":3,"file":"job.logic.js","sourceRoot":"","sources":["../../../src/modules/execution/job.logic.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAA;AAExC;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAA;AAElD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,mCAAmC,CAAA;AAE5E;;;;;;;;;GASG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAyB;IAChE,OAAO,KAAK,KAAK,SAAS,IAAI,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;AACjE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAyB;IAC3D,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAA;AACzE,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAyB;IACjE,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,oBAAoB,CAAC;QAC1B,KAAK,cAAc;YACjB,OAAO,SAAS,CAAA;QAClB,KAAK,OAAO,CAAC;QACb,KAAK,KAAK,CAAC;QACX,KAAK,KAAK,CAAC;QACX,KAAK,kBAAkB,CAAC;QACxB,KAAK,YAAY;YACf,OAAO,OAAO,CAAA;QAChB;YACE,OAAO,SAAS,CAAA;IACpB,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAyB;IAC5D,IAAI,KAAK,IAAI,4CAA4C,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IACvF,OAAO,OAAO,CAAA;AAChB,CAAC"}
+{"version":3,"file":"job.logic.js","sourceRoot":"","sources":["../../../src/modules/execution/job.logic.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAElE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAA;AAExC;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAA;AAElD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,mCAAmC,CAAA;AAE5E;;;;;;;;;GASG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAyB;IAChE,OAAO,KAAK,KAAK,SAAS,IAAI,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;AACjE,CAAC;AAcD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,CAAA;IACtC,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,EAAE,MAAM,CAAA;QACpC,OAAO;YACL,KAAK,EAAE,OAAO;YACd,WAAW,EAAE,WAAW;YACxB,MAAM,EAAE,OAAO;YACf,MAAM,EAAE,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;SACxD,CAAA;IACH,CAAC;IACD,IAAI,wBAAwB,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;IACpE,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,gCAAgC,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;AAC9F,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAyB;IAC3D,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAA;AACzE,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAyB;IACjE,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,oBAAoB,CAAC;QAC1B,KAAK,cAAc;YACjB,OAAO,SAAS,CAAA;QAClB,KAAK,OAAO,CAAC;QACb,KAAK,KAAK,CAAC;QACX,KAAK,KAAK,CAAC;QACX,KAAK,kBAAkB,CAAC;QACxB,KAAK,YAAY;YACf,OAAO,OAAO,CAAA;QAChB;YACE,OAAO,SAAS,CAAA;IACpB,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAyB;IAC5D,IAAI,KAAK,IAAI,4CAA4C,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IACvF,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/orchestration",
-  "version": "0.105.5",
+  "version": "0.106.0",
   "description": "Delivery-workflow engine for the Agent Architecture Board (execution, bootstrap, pipelines, board, boardScan, requirements, and composition root).",
   "repository": {
     "type": "git",
@@ -25,20 +25,20 @@
   },
   "dependencies": {
     "ai": "^6.0.219",
-    "@cat-factory/agents": "0.53.5",
-    "@cat-factory/caching": "0.6.33",
-    "@cat-factory/contracts": "0.126.0",
-    "@cat-factory/integrations": "0.81.4",
-    "@cat-factory/kernel": "0.121.0",
-    "@cat-factory/prompt-fragments": "0.13.12",
-    "@cat-factory/sandbox": "0.9.64",
-    "@cat-factory/spend": "0.12.14",
-    "@cat-factory/workspaces": "0.13.25"
+    "@cat-factory/agents": "0.54.0",
+    "@cat-factory/caching": "0.6.35",
+    "@cat-factory/contracts": "0.127.0",
+    "@cat-factory/integrations": "0.81.6",
+    "@cat-factory/kernel": "0.121.2",
+    "@cat-factory/prompt-fragments": "0.13.13",
+    "@cat-factory/sandbox": "0.9.66",
+    "@cat-factory/spend": "0.12.16",
+    "@cat-factory/workspaces": "0.13.27"
   },
   "devDependencies": {
     "typescript": "7.0.1-rc",
     "vitest": "^4.1.9",
-    "@cat-factory/sandbox-fixtures": "0.7.147"
+    "@cat-factory/sandbox-fixtures": "0.7.148"
   },
   "scripts": {
     "build": "tsc -b tsconfig.build.json",