@smithers-orchestrator/errors 0.21.0 → 0.22.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smithers-orchestrator/errors",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "description": "Error types, tagged errors, and error utilities for Smithers",
   "type": "module",
   "sideEffects": false,

package/src/isSmithersError.js

@@ -1,12 +1,18 @@
-
+import { isKnownSmithersErrorCode } from "./isKnownSmithersErrorCode.js";
+import { SmithersError } from "./SmithersError.js";
 /** @typedef {import("./SmithersError.js").SmithersError} SmithersError */
 /**
  * @param {unknown} value
  * @returns {value is SmithersError}
  */
 export function isSmithersError(value) {
+    if (value instanceof SmithersError) {
+        return true;
+    }
     return Boolean(value &&
         typeof value === "object" &&
         "code" in value &&
+        typeof (/** @type {{ code?: unknown }} */ (value).code) === "string" &&
+        isKnownSmithersErrorCode(/** @type {{ code: string }} */ (value).code) &&
         "message" in value);
 }

package/src/smithersErrorDefinitions.js

@@ -53,6 +53,26 @@ export const smithersErrorDefinitions = {
         when: "A task requests auto-hijack but its agent cannot provide a resumable session or conversation.",
         details: "{ nodeId, agentId? }",
     },
+    TASK_FORK_SOURCE_NOT_FOUND: {
+        category: "components",
+        when: "A <Task fork> references a source task id that is not present in the workflow graph (including a source that exists only in an unselected branch).",
+        details: "{ nodeId, forkSource }",
+    },
+    TASK_FORK_SOURCE_NOT_COMPLETE: {
+        category: "engine",
+        when: "A forked task began executing but its fork source has not completed, so no session snapshot exists yet.",
+        details: "{ nodeId, forkSource }",
+    },
+    TASK_FORK_SESSION_UNAVAILABLE: {
+        category: "engine",
+        when: "A <Task fork> cannot obtain a usable agent session snapshot — the forking task is not an agent task, or the source completed without producing a forkable conversation (e.g. a compute/static, skipped, or cancelled source).",
+        details: "{ nodeId, forkSource }",
+    },
+    TASK_FORK_CYCLE: {
+        category: "components",
+        when: "A <Task fork> introduces a dependency cycle, directly or indirectly.",
+        details: "{ nodeId, forkSource }",
+    },
     RUN_NOT_FOUND: {
         category: "engine",
         when: "A CLI or engine command references a run ID that does not exist in the database.",