@crewhaus/errors 0.3.2 → 0.4.2

package/dist/index.d.ts

@@ -74,7 +74,20 @@ export declare class ProviderAuthError extends AdapterError {
  * (which tags where an error was raised): a `FailureClass` tags *why the run
  * stopped*, in end-user vocabulary, and maps 1:1 onto an exit code.
  */
-export type FailureClass = "billing" | "auth" | "rate_limit" | "crewhaus_budget" | "mcp_boot" | "context_overflow" | "spec" | "config" | "tool" | "unknown";
+export type FailureClass = "billing" | "auth" | "rate_limit" | "crewhaus_budget" | "timeout"
+/** Loop contract 0.4 (G02) — the spec's in-loop `evaluation:` gate scored
+ *  the run's final answer below threshold with `on_fail: halt`. Like
+ *  `crewhaus_budget`/`timeout`, this is CrewHaus's OWN configured ceiling
+ *  ending the run, not a provider failure. */
+ | "evaluation"
+/** Loop contract 0.4 (G11) — a tool permission resolved to `ask` on a
+ *  NON-interactive surface with `permissions.ask_mode: "pause"` (the
+ *  default) and no prior grant/deny for the call: the runtime persisted a
+ *  `PendingApproval`, published `approval_requested`, and PARKED the run
+ *  to await an out-of-band decision. Unlike the other 3x-band classes this
+ *  is not a hard error — it is a resumable pause; the run re-executes
+ *  pre-resolved once the approval is granted (one-shot) or denied. */
+ | "approval_pending" | "mcp_boot" | "context_overflow" | "spec" | "config" | "tool" | "unknown";
 /**
  * The single structured description of a terminal run failure. `detail`
  * carries the raw provider text (with attribution, e.g. `Anthropic said:
@@ -111,6 +124,22 @@ export declare const EXIT_CODES: {
     readonly rate_limit: 32;
     /** CrewHaus's own configured budget cap ended the run. */
     readonly crewhaus_budget: 33;
+    /** Loop contract 0.4 (G10) — a configured wall-clock limit
+     *  (`limits.deadline_ms` / `turn_timeout_ms` / `model_call_timeout_ms`)
+     *  ended the run. Sits in the 3x band beside `crewhaus_budget`: like the
+     *  spend cap, it is CrewHaus's OWN configured ceiling, not a provider
+     *  failure. */
+    readonly timeout: 34;
+    /** Loop contract 0.4 (G02) — the spec's in-loop `evaluation:` gate failed
+     *  the final answer with `on_fail: halt`. Same 3x band rationale: a
+     *  CrewHaus-configured quality floor, not a provider failure. */
+    readonly evaluation: 35;
+    /** Loop contract 0.4 (G11) — the run PARKED on a headless tool-approval
+     *  ask (`permissions.ask_mode: "pause"`). Sits in the 3x band beside the
+     *  other CrewHaus-configured stops: a resumable pause awaiting an
+     *  out-of-band grant/deny, distinguishable from a hard failure so `fleet`
+     *  / the UI host can surface "needs approval" and resume rather than alert. */
+    readonly approval_pending: 36;
     /** Tool or MCP failure (including MCP boot). */
     readonly tool: 40;
 };

package/dist/index.js

@@ -123,6 +123,22 @@ export const EXIT_CODES = {
     rate_limit: 32,
     /** CrewHaus's own configured budget cap ended the run. */
     crewhaus_budget: 33,
+    /** Loop contract 0.4 (G10) — a configured wall-clock limit
+     *  (`limits.deadline_ms` / `turn_timeout_ms` / `model_call_timeout_ms`)
+     *  ended the run. Sits in the 3x band beside `crewhaus_budget`: like the
+     *  spend cap, it is CrewHaus's OWN configured ceiling, not a provider
+     *  failure. */
+    timeout: 34,
+    /** Loop contract 0.4 (G02) — the spec's in-loop `evaluation:` gate failed
+     *  the final answer with `on_fail: halt`. Same 3x band rationale: a
+     *  CrewHaus-configured quality floor, not a provider failure. */
+    evaluation: 35,
+    /** Loop contract 0.4 (G11) — the run PARKED on a headless tool-approval
+     *  ask (`permissions.ask_mode: "pause"`). Sits in the 3x band beside the
+     *  other CrewHaus-configured stops: a resumable pause awaiting an
+     *  out-of-band grant/deny, distinguishable from a hard failure so `fleet`
+     *  / the UI host can surface "needs approval" and resume rather than alert. */
+    approval_pending: 36,
     /** Tool or MCP failure (including MCP boot). */
     tool: 40,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crewhaus/errors",
-  "version": "0.3.2",
+  "version": "0.4.2",
   "type": "module",
   "description": "Typed error hierarchy shared across factory layers",
   "main": "dist/index.js",