@arcforge/err 2.0.155 → 2.0.157

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@arcforge/err",
-    "version": "2.0.155",
+    "version": "2.0.157",
     "description": "Structured Axon errors — the code map every user-facing failure is rendered from.",
     "type": "module",
     "private": false,
@@ -15,7 +15,7 @@
         "deploy": "echo \"This package is published ONLY by apps/tui/scripts/release.ts, which pins workspace:* deps to concrete versions first. Publishing it directly ships an unresolvable dependency.\" && exit 1"
     },
     "dependencies": {
-        "@arcforge/types": "2.0.155"
+        "@arcforge/types": "2.0.157"
     },
     "devDependencies": {
         "@types/bun": "latest",

package/src/map.ts

@@ -126,6 +126,114 @@ export const errorMap = {
         severity: "fatal",
         expected: true,
     },
+    SCRIPT_AGENT_NOT_LOCAL: {
+        code: "AX-SCRIPT-003",
+        title: "Script Agent Is Not In-Process",
+        description: "A script's agent must run in the same process as the script. Scripts() booted a linked (confined) agent instead, so there is no in-heap runtime for the script's proxy to forward to. This is a wiring fault, not a user error.",
+        source: "runtime",
+        severity: "fatal",
+        // No `expected` — this is a WIRING fault in our own code, not
+        // something a user did, so the full internals are exactly what a
+        // reader needs to see.
+    },
+    SUBAGENT_LINK_UNSUPPORTED: {
+        code: "AX-SCRIPT-004",
+        title: "Subagent Not Supported Over The Link",
+        description: "An agent asked to spawn a subagent whose child runs as a confined process. `axon.request()` returns a wake's collected entries, while the link's `stimulus` verb returns only admission — the supervisor needs a verb that collects a wake and answers when it settles. Until that exists this fails rather than returning an admission receipt the caller would read as a result.",
+        source: "runtime",
+        severity: "fatal",
+    },
+    AGENT_BOOT_FAILED: {
+        code: "AX-AGENT-006",
+        title: "Agent Failed To Boot",
+        description: "The agent process exited before it connected to its supervisor. Its own stderr is carried as the detail — the agent usually knows exactly what went wrong (a missing cognet, a tool that would not compile), and without this that diagnosis died in a pipe while the supervisor reported only a closed socket.",
+        source: "runtime",
+        severity: "fatal",
+    },
+    LINK_NO_HANDLER: {
+        code: "AX-LINK-001",
+        title: "No Handler For Link Verb",
+        description: "The peer sent a verb this side does not implement. Both ends speak a versioned contract, so this means they disagree about it — a wiring fault, not something a user did.",
+        source: "runtime",
+        severity: "fatal",
+    },
+    LINK_PEER_CLOSED: {
+        code: "AX-LINK-002",
+        title: "Agent Disconnected",
+        description: "The agent process closed its side of the link. Every call still in flight is rejected rather than left hanging — a dead peer must be an error, never a wait that never ends.",
+        source: "runtime",
+        severity: "fatal",
+    },
+    LINK_CLOSED: {
+        code: "AX-LINK-003",
+        title: "Link Closed",
+        description: "The link to the agent was torn down by this side — a shutdown, a dispose, or a failed boot. Outstanding calls are rejected with this rather than hanging.",
+        source: "runtime",
+        severity: "fatal",
+    },
+    LINK_FRAME_TOO_LARGE: {
+        code: "AX-LINK-004",
+        title: "Link Frame Too Large",
+        description: "A message on the link exceeded the maximum frame size, or a length prefix declared one that did. The prefix is peer-controlled input, so an oversized declaration is refused rather than allocated — a desynchronised stream cannot be recovered by reading past it.",
+        source: "runtime",
+        severity: "fatal",
+    },
+    LINK_UNKNOWN_PROMPT_ACTION: {
+        code: "AX-LINK-005",
+        title: "Unknown Prompt Action",
+        description: "The prompt verb was called with an action this side does not know. Loud rather than silent: an unrecognised action would otherwise return undefined, which a caller renders as an empty prompt list.",
+        source: "runtime",
+        severity: "fatal",
+    },
+    AGENT_LINK_MISSING: {
+        code: "AX-AGENT-001",
+        title: "Agent Started Without A Supervisor",
+        description: "An agent process was started with no link paths in its environment, which means nothing is supervising it. It cannot guess a socket path — doing so risks connecting to a different agent's supervisor entirely.",
+        source: "runtime",
+        severity: "fatal",
+    },
+    AGENT_LINK_MALFORMED: {
+        code: "AX-AGENT-002",
+        title: "Malformed Agent Link",
+        description: "The link carrier in the agent's environment is not valid JSON, or does not name both a control and a data socket. Both are required — an agent with only one connected can accept work it has no way to answer.",
+        source: "runtime",
+        severity: "fatal",
+    },
+    AGENT_BLUEPRINT_MISSING: {
+        code: "AX-AGENT-003",
+        title: "Agent Started Without A Blueprint",
+        description: "An agent process was started with no blueprint path in its environment. The supervisor writes the blueprint beside the sockets before spawning; its absence means the spawn path is broken.",
+        source: "runtime",
+        severity: "fatal",
+    },
+    AGENT_NOT_READY: {
+        code: "AX-AGENT-004",
+        title: "Agent Still Booting",
+        description: "A verb arrived before the agent's runtime finished booting. The link connects first so that boot failures are reportable, which leaves a brief window where the agent can be addressed but cannot answer.",
+        source: "runtime",
+        severity: "fatal",
+    },
+    CLI_AGENT_NOT_LOCAL: {
+        code: "AX-AGENT-005",
+        title: "Command Needs An In-Process Agent",
+        description: "A headless CLI command booted an agent that runs as a separate process, but the command reaches into the runtime directly. This is a wiring fault: the command needs either an in-process agent or a link verb.",
+        source: "runtime",
+        severity: "fatal",
+    },
+    ENGINE_ROLE_UNBOUND_LINK: {
+        code: "AX-ENGINE-010",
+        title: "No Engine For Role",
+        description: "A confined agent asked for inference on a role the supervisor has no engine bound to. Roles are resolved on the supervisor's side before the agent starts, so an unbound one here means resolution and the cognet's declaration disagree.",
+        source: "runtime",
+        severity: "fatal",
+    },
+    ENGINE_KIND_MISMATCH_LINK: {
+        code: "AX-ENGINE-011",
+        title: "Engine Kind Mismatch",
+        description: "A role bound to a transform or session engine was asked to serve a generate call. Resolution already matched the declared type, so reaching here means a provider's create() disagreed with the capability it was handed.",
+        source: "runtime",
+        severity: "fatal",
+    },
     ENGINE_MISSING: {
         code: "AX-ENGINE-001",
         title: "No Engine Configured",