@arcforge/err 2.0.146 → 2.0.147

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@arcforge/err",
-    "version": "2.0.146",
+    "version": "2.0.147",
     "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.146"
+        "@arcforge/types": "2.0.147"
     },
     "devDependencies": {
         "@types/bun": "latest",

package/src/map.ts

@@ -133,6 +133,37 @@ export const errorMap = {
         source: "runtime",
         severity: "fatal",
     },
+    ENGINE_ROLE_UNBOUND: {
+        code: "AX-ENGINE-002",
+        title: "Engine Role Not Bound",
+        description: "The cognet asked for an engine role that resolution did not fill. A required role stops the boot, so reaching this means an OPTIONAL role was used without checking `kernel.engine.has()` first — or the role was never declared in the cognet's `engines:` block.",
+        source: "runtime",
+        severity: "fatal",
+    },
+    RESOURCES_EXHAUSTED: {
+        code: "AX-RES-001",
+        title: "Not Enough Memory",
+        description: "A local model does not fit in what is left of this machine's video memory. Nothing was evicted: another agent is using it, and taking memory out from under a running agent would slow it down invisibly. Stop an agent that is holding a model, or raise the ceiling in your profile's `resources`.",
+        source: "runtime",
+        severity: "degraded",
+        expected: true,
+    },
+    ENGINE_PIN_UNAVAILABLE: {
+        code: "AX-ENGINE-004",
+        title: "Model Not Available",
+        description: "The agent pins a model no declared provider can supply. The agent still runs — resolution picked the best available model instead — but it is NOT the one that was asked for. Declare the provider that supplies it in your profile, or pick a model from a provider you have.",
+        source: "runtime",
+        severity: "degraded",
+        expected: true,
+    },
+    ENGINE_REQUIREMENTS_UNMET: {
+        code: "AX-ENGINE-003",
+        title: "Inference Requirements Unmet",
+        description: "This cognet declares engine roles that nothing among the user's providers can fill. Add a provider that supplies what is missing, or run a cognet whose requirements this machine meets.",
+        source: "runtime",
+        severity: "fatal",
+        expected: true,
+    },
     INJECT_OUTSIDE_RUNTIME: {
         code: "AX-RUNTIME-001",
         title: "Runtime Accessed Before Boot",
@@ -1242,6 +1273,14 @@ export const errorMap = {
         severity: "fatal",
         expected: true,
     },
+    NO_LOCAL_PROJECT: {
+        code: "AX-TUI-050",
+        title: "No Local Project",
+        description: "This agent has no project directory on this machine — it was attached over the network, so its source lives wherever it is running. Opening its config, or any other file verb, has to happen there. Focus a local agent instead.",
+        source: "tui",
+        severity: "fatal",
+        expected: true,
+    },
     NO_FOCUSED_INSTANCE: {
         code: "AX-TUI-017",
         title: "No Focused Agent Instance",
@@ -1303,6 +1342,13 @@ export const errorMap = {
         source: "tui",
         severity: "fatal",
     },
+    ATTACH_URL_INVALID: {
+        code: "AX-TUI-049",
+        title: "Attach URL Invalid",
+        description: "The address is not a usable agent URL. An agent is reached over http or https and the scheme is required — `localhost:3010` is a path, `http://localhost:3010` is an address. Checked before anything connects, so a typo fails immediately rather than as a transport error.",
+        source: "tui",
+        severity: "fatal",
+    },
     DEPLOYMENT_NOT_CONNECTABLE: {
         code: "AX-TUI-028",
         title: "Deployment Not Connectable",