@substrio/sdk 0.1.0 → 0.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@substrio/sdk",
-    "version": "0.1.0",
+    "version": "0.1.1",
     "description": "Substrio JavaScript SDK: zero-dependency, AI-friendly database client",
     "homepage": "https://github.com/illtronicevents-a11y/substrio#readme",
     "bugs": "https://github.com/illtronicevents-a11y/substrio/issues",

package/substrio_errors.mjs

@@ -10,18 +10,18 @@ export const SUBSTRIO_ERRORS = Object.freeze({
     NOT_IMPLEMENTED: Object.freeze({ hex: 0x0002, status: 501, message: "This feature is not implemented" }),
     SYSTEM_CLOSED: Object.freeze({ hex: 0x0100, status: 503, message: "Database system is closed" }),
     SYSTEM_ALREADY_OPEN: Object.freeze({ hex: 0x0101, status: 409, message: "Database system is already open" }),
-    INVALID_ARGUMENT: Object.freeze({ hex: 0x0102, status: 400, message: "Invalid argument provided" }),
-    INVALID_HANDLE: Object.freeze({ hex: 0x0103, status: 400, message: "Invalid handle" }),
+    INVALID_ARGUMENT: Object.freeze({ hex: 0x0102, status: 400, message: "That value is not accepted." }),
+    INVALID_HANDLE: Object.freeze({ hex: 0x0103, status: 400, message: "That handle is not open." }),
     THREAD_INIT_FAILED: Object.freeze({ hex: 0x0104, status: 500, message: "Thread initialization failed" }),
     SHUTDOWN_IN_PROGRESS: Object.freeze({ hex: 0x0105, status: 503, message: "System is shutting down" }),
-    INTERNAL: Object.freeze({ hex: 0x0106, status: 500, message: "Internal server error" }),
+    INTERNAL: Object.freeze({ hex: 0x0106, status: 500, message: "Something went wrong on our side. Try again." }),
     NULL_TREE: Object.freeze({ hex: 0x0107, status: 500, message: "Index tree is not initialized" }),
     NULL_SYSTEM: Object.freeze({ hex: 0x0108, status: 500, message: "Tree is not bound to a system" }),
     BARRIER_UNSUPPORTED: Object.freeze({ hex: 0x0109, status: 500, message: "Process-wide memory barrier unavailable" }),
-    STORAGE_IO: Object.freeze({ hex: 0x1000, status: 500, message: "Storage I/O error" }),
+    STORAGE_IO: Object.freeze({ hex: 0x1000, status: 500, message: "We could not read or save that just now. Try again." }),
     DISK_FULL: Object.freeze({ hex: 0x1001, status: 503, message: "Disk storage is full" }),
     FILE_NOT_FOUND: Object.freeze({ hex: 0x1002, status: 404, message: "File not found" }),
-    PERMISSION_DENIED: Object.freeze({ hex: 0x1003, status: 403, message: "Permission denied" }),
+    PERMISSION_DENIED: Object.freeze({ hex: 0x1003, status: 403, message: "You do not have access to that." }),
     FILE_CORRUPT: Object.freeze({ hex: 0x1004, status: 500, message: "File is corrupted" }),
     MMAP_FAILED: Object.freeze({ hex: 0x1005, status: 500, message: "Memory mapping failed" }),
     FSYNC_FAILED: Object.freeze({ hex: 0x1006, status: 500, message: "File sync failed" }),
@@ -41,7 +41,7 @@ export const SUBSTRIO_ERRORS = Object.freeze({
     NO_ACTIVE_TRANSACTION: Object.freeze({ hex: 0x3006, status: 400, message: "No active transaction" }),
     LWW_STALE: Object.freeze({ hex: 0x3007, status: 409, message: "A newer version exists" }),
     CANCELLED: Object.freeze({ hex: 0x3008, status: 409, message: "Operation cancelled" }),
-    KEY_NOT_FOUND: Object.freeze({ hex: 0x4000, status: 404, message: "Key not found" }),
+    KEY_NOT_FOUND: Object.freeze({ hex: 0x4000, status: 404, message: "We could not find that." }),
     KEY_TOO_LARGE: Object.freeze({ hex: 0x4001, status: 400, message: "Key exceeds maximum size" }),
     VALUE_TOO_LARGE: Object.freeze({ hex: 0x4002, status: 413, message: "Value exceeds maximum size" }),
     KEY_EMPTY: Object.freeze({ hex: 0x4003, status: 400, message: "Key cannot be empty" }),
@@ -62,18 +62,18 @@ export const SUBSTRIO_ERRORS = Object.freeze({
     ROW_STALE: Object.freeze({ hex: 0x4012, status: 409, message: "the document changed since this row was read: nothing was written, and the row now holds the document as it is; read it and write again" }),
     CURSOR_EXHAUSTED: Object.freeze({ hex: 0x5000, status: 200, message: "Cursor exhausted" }),
     CURSOR_INVALIDATED: Object.freeze({ hex: 0x5001, status: 409, message: "Cursor invalidated" }),
-    INVALID_RANGE: Object.freeze({ hex: 0x5002, status: 400, message: "Invalid range" }),
+    INVALID_RANGE: Object.freeze({ hex: 0x5002, status: 400, message: "That range is not accepted." }),
     BATCH_OP_FAILED: Object.freeze({ hex: 0x5003, status: 500, message: "Batch operation failed" }),
     NODE_NOT_FOUND: Object.freeze({ hex: 0x6000, status: 404, message: "Node not found" }),
     EDGE_NOT_FOUND: Object.freeze({ hex: 0x6001, status: 404, message: "Edge not found" }),
     PROPERTY_NOT_FOUND: Object.freeze({ hex: 0x6002, status: 404, message: "Property not found" }),
-    INVALID_EDGE: Object.freeze({ hex: 0x6003, status: 400, message: "Invalid edge" }),
+    INVALID_EDGE: Object.freeze({ hex: 0x6003, status: 400, message: "That edge is not accepted." }),
     PATH_NOT_FOUND: Object.freeze({ hex: 0x6004, status: 404, message: "Path not found" }),
     GRAPH_CYCLE_DETECTED: Object.freeze({ hex: 0x6005, status: 409, message: "Cycle detected" }),
     DIMENSION_MISMATCH: Object.freeze({ hex: 0x7000, status: 400, message: "Dimension mismatch" }),
     POINT_NOT_FOUND: Object.freeze({ hex: 0x7001, status: 404, message: "Point not found" }),
-    INVALID_BOUNDS: Object.freeze({ hex: 0x7002, status: 400, message: "Invalid bounds" }),
-    INVALID_RADIUS: Object.freeze({ hex: 0x7003, status: 400, message: "Invalid radius" }),
+    INVALID_BOUNDS: Object.freeze({ hex: 0x7002, status: 400, message: "Those bounds are not accepted." }),
+    INVALID_RADIUS: Object.freeze({ hex: 0x7003, status: 400, message: "That radius is not accepted." }),
     SCHEMA_VIOLATION: Object.freeze({ hex: 0x8000, status: 400, message: "Schema violation" }),
     TYPE_MISMATCH: Object.freeze({ hex: 0x8001, status: 400, message: "Type mismatch" }),
     CONSTRAINT_VIOLATION: Object.freeze({ hex: 0x8002, status: 409, message: "Constraint violation" }),
@@ -85,7 +85,7 @@ export const SUBSTRIO_ERRORS = Object.freeze({
     STORAGE_QUOTA_EXCEEDED: Object.freeze({ hex: 0x9000, status: 507, message: "Storage quota exceeded" }),
     DOCUMENT_QUOTA_EXCEEDED: Object.freeze({ hex: 0x9001, status: 507, message: "Document quota exceeded" }),
     BANDWIDTH_QUOTA_EXCEEDED: Object.freeze({ hex: 0x9002, status: 429, message: "Bandwidth quota exceeded" }),
-    RATE_LIMIT_EXCEEDED: Object.freeze({ hex: 0x9003, status: 429, message: "Rate limit exceeded. Please slow down." }),
+    RATE_LIMIT_EXCEEDED: Object.freeze({ hex: 0x9003, status: 429, message: "Too many requests. Wait a moment and try again." }),
     REQUEST_TOO_LARGE: Object.freeze({ hex: 0x9004, status: 413, message: "Request payload too large" }),
     CONCURRENT_LIMIT: Object.freeze({ hex: 0x9005, status: 429, message: "Concurrent request limit exceeded" }),
     COLLECTION_LIMIT: Object.freeze({ hex: 0x9006, status: 413, message: "Collection limit exceeded" }),
@@ -102,16 +102,16 @@ export const SUBSTRIO_ERRORS = Object.freeze({
     REALTIME_LIMIT: Object.freeze({ hex: 0x9011, status: 429, message: "This tenant's realtime_connections_limit is at its cap" }),
     CRON_LIMIT: Object.freeze({ hex: 0x9012, status: 429, message: "This tenant's cron_limit is at its cap" }),
     SPACE_FULL: Object.freeze({ hex: 0x9013, status: 507, message: "The account's space is full: free space (delete data or an app) or raise the account's space" }),
-    TOKEN_EXPIRED: Object.freeze({ hex: 0xA000, status: 401, message: "Authentication token has expired" }),
-    TOKEN_INVALID: Object.freeze({ hex: 0xA001, status: 401, message: "Invalid authentication token" }),
-    TOKEN_REVOKED: Object.freeze({ hex: 0xA002, status: 401, message: "Authentication token has been revoked" }),
-    SESSION_EXPIRED: Object.freeze({ hex: 0xA003, status: 401, message: "Session has expired" }),
-    ACCOUNT_SUSPENDED: Object.freeze({ hex: 0xA004, status: 403, message: "Account has been suspended" }),
+    TOKEN_EXPIRED: Object.freeze({ hex: 0xA000, status: 401, message: "Your sign-in has expired. Sign in again." }),
+    TOKEN_INVALID: Object.freeze({ hex: 0xA001, status: 401, message: "Your sign-in is not valid. Sign in again." }),
+    TOKEN_REVOKED: Object.freeze({ hex: 0xA002, status: 401, message: "Your sign-in was ended. Sign in again." }),
+    SESSION_EXPIRED: Object.freeze({ hex: 0xA003, status: 401, message: "Your session has expired. Sign in again." }),
+    ACCOUNT_SUSPENDED: Object.freeze({ hex: 0xA004, status: 403, message: "This account is suspended." }),
     TENANT_SUSPENDED: Object.freeze({ hex: 0xA005, status: 403, message: "Tenant has been suspended" }),
     IP_BLOCKED: Object.freeze({ hex: 0xA006, status: 403, message: "IP address is blocked" }),
-    INSUFFICIENT_PERMISSIONS: Object.freeze({ hex: 0xA007, status: 403, message: "Insufficient permissions for this operation" }),
+    INSUFFICIENT_PERMISSIONS: Object.freeze({ hex: 0xA007, status: 403, message: "You do not have access to do that." }),
     CREDENTIAL_REQUIRED: Object.freeze({ hex: 0xA008, status: 401, message: "Authentication credentials required" }),
-    OAUTH_INVALID: Object.freeze({ hex: 0xA009, status: 401, message: "Invalid OAuth token or code" }),
+    OAUTH_INVALID: Object.freeze({ hex: 0xA009, status: 401, message: "The sign-in provider's answer was not accepted. Try again." }),
     PROVIDER_NOT_CONFIGURED: Object.freeze({ hex: 0xA00A, status: 409, message: "Authentication provider not configured" }),
     PROVIDER_DISABLED: Object.freeze({ hex: 0xA00B, status: 403, message: "Authentication provider is disabled" }),
     TENANT_READ_ONLY: Object.freeze({ hex: 0xA00C, status: 423, message: "Tenant is read-only: writes are refused" }),
@@ -131,16 +131,25 @@ export const SUBSTRIO_ERRORS = Object.freeze({
     APPROVAL_MISMATCH: Object.freeze({ hex: 0xA01A, status: 403, message: "The approval names another call or another session: it works only for the exact call that asked for it" }),
     WEBHOOK_SIGNATURE_INVALID: Object.freeze({ hex: 0xA01B, status: 400, message: "The payment provider webhook's signature does not verify" }),
     BILLING_NOT_SET_UP: Object.freeze({ hex: 0xA01C, status: 503, message: "Billing is not set up: the payment provider's keys are not set" }),
+    EMAIL_TAKEN: Object.freeze({ hex: 0xA01D, status: 409, message: "That email already has an account. Sign in instead." }),
+    CREDENTIALS_MISMATCH: Object.freeze({ hex: 0xA01E, status: 401, message: "That email and password do not match." }),
+    PASSWORD_LENGTH: Object.freeze({ hex: 0xA01F, status: 400, message: "Use a password of 8 to 128 characters." }),
+    EMAIL_INVALID: Object.freeze({ hex: 0xA020, status: 400, message: "Enter a valid email address." }),
+    USER_NOT_FOUND: Object.freeze({ hex: 0xA021, status: 404, message: "We could not find that person." }),
+    ACCOUNT_LOCKED: Object.freeze({ hex: 0xA022, status: 423, message: "This account is locked. Reset your password to sign in again." }),
+    SECRET_KEY_IN_URL: Object.freeze({ hex: 0xA023, status: 400, message: "A secret key was sent in the URL (access_token): only a publishable key may be; send a secret key in the Authorization header, from a server" }),
+    RECIPIENT_UNSUBSCRIBED: Object.freeze({ hex: 0xA024, status: 409, message: "You turned off this app's email, so no code was sent. Ask for a link to turn it back on." }),
+    APP_OVER_PLAN: Object.freeze({ hex: 0xA025, status: 403, message: "This app is paused: the account's plan allows fewer apps than it owns. Move it into the first max_apps on the account's Apps page (account.apps.order), or upgrade." }),
     QUERY_TOO_COMPLEX: Object.freeze({ hex: 0xB000, status: 400, message: "Query is too complex" }),
     QUERY_TIMEOUT: Object.freeze({ hex: 0xB001, status: 504, message: "Query execution timed out" }),
     RESULT_SET_TOO_LARGE: Object.freeze({ hex: 0xB002, status: 413, message: "Result set exceeds maximum size" }),
     SORT_LIMIT_EXCEEDED: Object.freeze({ hex: 0xB003, status: 400, message: "Sort operation exceeds limit" }),
     SCAN_LIMIT_EXCEEDED: Object.freeze({ hex: 0xB004, status: 400, message: "Scan operation exceeds limit" }),
-    INVALID_QUERY_SYNTAX: Object.freeze({ hex: 0xB005, status: 400, message: "Invalid query syntax" }),
+    INVALID_QUERY_SYNTAX: Object.freeze({ hex: 0xB005, status: 400, message: "That query does not parse." }),
     SQL_FAILED: Object.freeze({ hex: 0xB006, status: 400, message: "The SQL statement did not parse or run" }),
     TENANT_NOT_FOUND: Object.freeze({ hex: 0xC000, status: 404, message: "Tenant not found" }),
     TENANT_ALREADY_EXISTS: Object.freeze({ hex: 0xC001, status: 409, message: "Tenant already exists" }),
-    TENANT_INVALID: Object.freeze({ hex: 0xC002, status: 400, message: "Invalid tenant" }),
+    TENANT_INVALID: Object.freeze({ hex: 0xC002, status: 400, message: "That app is not one this server knows." }),
     TENANT_CANNOT_DROP_DEFAULT: Object.freeze({ hex: 0xC003, status: 403, message: "Cannot drop the default tenant" }),
     COLLECTION_NOT_FOUND: Object.freeze({ hex: 0xC004, status: 404, message: "Collection not found" }),
     COLLECTION_ALREADY_EXISTS: Object.freeze({ hex: 0xC005, status: 409, message: "Collection already exists" }),
@@ -212,8 +221,9 @@ export const SUBSTRIO_ERRORS = Object.freeze({
     ROOT_DOMAIN_DISABLED: Object.freeze({ hex: 0xC04E, status: 409, message: "The root domain is disabled: no host is bound under it until the platform admin enables it" }),
     ROOT_DOMAIN_IN_USE: Object.freeze({ hex: 0xC04F, status: 409, message: "Test hosts are bound under the root domain (hosts is their count); they are removed with env.host.remove first" }),
     FEATURED_APP_NOT_FOUND: Object.freeze({ hex: 0xC050, status: 404, message: "No featured app has this name; featured.list names every one" }),
-    FEATURED_NOT_ENABLED: Object.freeze({ hex: 0xC051, status: 409, message: "The account has not enabled this featured app; featured.enable it first" }),
     FEATURED_NEEDS_PLANS: Object.freeze({ hex: 0xC052, status: 400, message: "Only an app open to other accounts' keys whose plans file has a featured block (title, summary, admin) can be featured" }),
+    JET_KEY_NEEDS_APP: Object.freeze({ hex: 0xC053, status: 400, message: "A key for a featured app belongs to one of the account's apps; jet.key.create makes it for the app named" }),
+    FEATURED_ALWAYS_ON: Object.freeze({ hex: 0xC054, status: 409, message: "Every account has every featured app, always on: there is nothing to disable. A key stops with account.key.revoke" }),
     BILLING_KEY_NOT_TEST: Object.freeze({ hex: 0xC060, status: 503, message: "The payment provider key set is not a test key (sk_test_ or rk_test_); the platform takes test keys only, so nothing was sent" }),
     CART_EMPTY: Object.freeze({ hex: 0xC061, status: 400, message: "The cart buys nothing: name at least one plan in items, or funds" }),
     CART_PLAN_NOT_FOUND: Object.freeze({ hex: 0xC062, status: 400, message: "The app has no plan by this id; billing.catalog lists every plan" }),
@@ -229,11 +239,24 @@ export const SUBSTRIO_ERRORS = Object.freeze({
     PAYMENT_PROCESSING: Object.freeze({ hex: 0xC06C, status: 409, message: "The payment is still being processed by the provider; ask again shortly" }),
     SUBSCRIPTION_NONE: Object.freeze({ hex: 0xC06D, status: 404, message: "The account has no subscription to cancel" }),
     PROVIDER_ANSWER_INVALID: Object.freeze({ hex: 0xC06E, status: 503, message: "The payment provider's answer was not the object asked for (the field names it); nothing was applied, ask again" }),
+    PLAN_LIMIT: Object.freeze({ hex: 0xC06F, status: 409, message: "The account's plan allows no more of this (the field names it); account.plan.summary shows the plans that raise it" }),
+    SPACE_ADDON_NOT_ON_PLAN: Object.freeze({ hex: 0xC070, status: 400, message: "The plan the account would be on sells no space add-on; a plan with space_addon (Scale) does" }),
+    SPACE_ADDON_HELD: Object.freeze({ hex: 0xC071, status: 409, message: "The account holds space add-on blocks the new plan does not sell; release them first (a cart with space_blocks 0)" }),
+    SPACE_ADDON_IN_USE: Object.freeze({ hex: 0xC072, status: 409, message: "The account uses more than the space it would keep; delete data first, then release the blocks" }),
+    PLAN_NOT_ON_SALE: Object.freeze({ hex: 0xC073, status: 409, message: "This plan is priced but not on sale yet: it cannot be bought or moved to until the platform sells it (account.plan.summary shows what can be)" }),
     MCP_TOOL_NOT_FOUND: Object.freeze({ hex: 0xC080, status: 404, message: "The app's MCP manifest has no tool of this name; mcp.tool.list names the ones it has" }),
     MCP_TOOL_INVALID: Object.freeze({ hex: 0xC081, status: 400, message: "The tool is not one the app's /mcp can serve; field names the member at fault" }),
     MCP_TEST_USER_NOT_FOUND: Object.freeze({ hex: 0xC082, status: 404, message: "The app has no user of this id to call the tool as; user.list names its people" }),
     MCP_TOOL_FROM_ROUTE: Object.freeze({ hex: 0xC083, status: 409, message: "The tool is a route's own; its function takes it out with tools: {\"<route>\": false} (functions/<name>.json)" }),
+    MCP_RESULT_INVALID: Object.freeze({ hex: 0xC084, status: 502, message: "The app's function answered an _mcp that is no tools/call result; field names the member at fault" }),
+    MCP_OPERATIONS_IDENTITY_ONLY: Object.freeze({ hex: 0xC085, status: 403, message: "operations declares the platform's own operations: only the platform's identity app declares it" }),
+    MCP_LINK_NOT_LINKED: Object.freeze({ hex: 0xC086, status: 403, message: "The caller has no user of that app linked to their Substrio sign-in: they sign in there once" }),
+    MCP_LINK_NOT_OFFERED: Object.freeze({ hex: 0xC087, status: 404, message: "That app offers this app no such tool" }),
+    CALLER_USERS_REFUSED: Object.freeze({ hex: 0xC088, status: 403, message: "Only a featured app's entry, called by another app, reads that app's users; an app you merely use never reads yours" }),
+    NO_CALLER_APP: Object.freeze({ hex: 0xC089, status: 400, message: "This entry was called by no app (a route, a schedule or a direct call), so there are no caller users to read" }),
+    SELF_FIELD_REFUSED: Object.freeze({ hex: 0xC08A, status: 403, message: "The app has not marked this field of the person as one they may edit themself; field names it" }),
     KEY_AUTOMATION_NEEDS_PERSON: Object.freeze({ hex: 0xC090, status: 403, message: "Only a person signed in as themselves makes an automation key; a key, an agent or the system key makes agent keys" }),
+    MCP_IDENTITY_FUNCTION_NOT_DEPLOYED: Object.freeze({ hex: 0xC091, status: 500, message: "A function the release ships for the identity app was not deployed at start; the next start tries again" }),
     PACKAGE_REGISTRY_UNSET: Object.freeze({ hex: 0xC0A0, status: 503, message: "package.add has no registry: the platform setting package_registry_origin is unset" }),
     PACKAGE_UNKNOWN: Object.freeze({ hex: 0xC0A1, status: 404, message: "The registry has no package of that name" }),
     PACKAGE_NAME_INVALID: Object.freeze({ hex: 0xC0A2, status: 400, message: "Not an npm package name: lowercase letters, digits, - . _ ~, an optional @scope/" }),
@@ -245,11 +268,68 @@ export const SUBSTRIO_ERRORS = Object.freeze({
     PACKAGE_INTEGRITY_MISMATCH: Object.freeze({ hex: 0xC0A8, status: 502, message: "The tarball's SHA-512 is not the registry's dist.integrity, or the registry gives no sha512" }),
     PACKAGE_TARBALL_INVALID: Object.freeze({ hex: 0xC0A9, status: 502, message: "The tarball is not a gzip tar of a package: a link, an unsafe path, or no package.json" }),
     PACKAGE_TOO_LARGE: Object.freeze({ hex: 0xC0AA, status: 413, message: "The package unpacks past 256 MiB, or its metadata past 64 MiB" }),
+    ADOPT_DISABLED: Object.freeze({ hex: 0xC0B0, status: 409, message: "This server adopts no file: it was started without --adopt-dir (or its kernel has no openat2); file.upload stores the bytes instead" }),
+    ADOPT_SOURCE_NOT_FOUND: Object.freeze({ hex: 0xC0B1, status: 404, message: "No file of this name is beneath the server's adopt directory; source names it relative to that directory" }),
+    ADOPT_SOURCE_OUTSIDE: Object.freeze({ hex: 0xC0B2, status: 400, message: "The source is outside the server's adopt directory (an absolute name, or .. past it)" }),
+    ADOPT_SOURCE_SYMLINK: Object.freeze({ hex: 0xC0B3, status: 400, message: "The source's name passes a symbolic link; name the file itself" }),
+    ADOPT_SOURCE_NOT_REGULAR: Object.freeze({ hex: 0xC0B4, status: 400, message: "The source is not a regular file (a directory, a pipe, a device or a socket)" }),
+    ADOPT_SOURCE_LINKED: Object.freeze({ hex: 0xC0B5, status: 409, message: "The source has another name (a hard link), which would stay a writable name of the stored file; remove the other name first" }),
+    ADOPT_CROSS_DEVICE: Object.freeze({ hex: 0xC0B6, status: 409, message: "The source is on another filesystem than the app's file store, so it cannot be renamed in; move it onto the store's filesystem first" }),
+    ADOPT_SOURCE_CHANGED: Object.freeze({ hex: 0xC0B7, status: 409, message: "The source was written, or its name moved, while it was hashed; adopt it again once nothing writes it" }),
+    CONSOLE_LINK_NEEDS_PERSON: Object.freeze({ hex: 0xC0B8, status: 403, message: "Only a person mints a console link: an agent session for its own person, or the person signed in to the console; a key, the master key or an agent token is no person" }),
+    CONSOLE_LINK_UNKNOWN: Object.freeze({ hex: 0xC0B9, status: 404, message: "No live console link has this token: it is mistyped, or a newer link replaced it; the agent mints a new one" }),
+    CONSOLE_LINK_USED: Object.freeze({ hex: 0xC0BA, status: 410, message: "This console link was already used; each signs in once, so the agent mints a new one" }),
+    CONSOLE_LINK_EXPIRED: Object.freeze({ hex: 0xC0BB, status: 410, message: "This console link is past its life; the agent mints a new one" }),
+    CONSOLE_LINK_STEP_UP: Object.freeze({ hex: 0xC0BC, status: 403, message: "This session came from your agent's console link: sign in again with your email code or second factor to decide approvals or make an automation key" }),
+    AGENT_CODE_INVALID: Object.freeze({ hex: 0xC0BD, status: 401, message: "This connect code is unknown, already used or past its life; ask your owner for a new one on the console's Agents page" }),
+    AGENT_ALREADY_CONNECTED: Object.freeze({ hex: 0xC0BE, status: 409, message: "This connection already acts for your owner, so the connect code is not needed and was not used. A substrio_ae_ code is for an agent with no connection" }),
+    AGENT_TOOL_UNKNOWN: Object.freeze({ hex: 0xC0BF, status: 404, message: "No tool of this name reaches this credential; GET /v1/_agent/tools names the ones that do" }),
+    CPU_HISTORY_OFF: Object.freeze({ hex: 0xC0C0, status: 409, message: "This server keeps no usage minutes (usage_history_minutes is 0), so it has no CPU a minute to answer; tenant.usage has the totals" }),
+    SUBSCRIPTION_NOT_FOUND: Object.freeze({ hex: 0xC0C1, status: 404, message: "There is no subscription of yours by this id; subscriptions.mine lists them" }),
+    PLAN_FEATURE_REQUIRED: Object.freeze({ hex: 0xC0C2, status: 403, message: "Your plan at this app does not include this feature; the app's plans name the ones that do" }),
+    SUBSCRIBERS_NOT_VISIBLE: Object.freeze({ hex: 0xC0C3, status: 403, message: "Only the selling app and the apps of its own account read its subscribers" }),
+    SUBSCRIPTION_PERSON_REQUIRED: Object.freeze({ hex: 0xC0C4, status: 403, message: "This is a person's own call: sign in as the person (an agent or a key cannot buy or list for them)" }),
+    PLAN_FEATURE_UNKNOWN: Object.freeze({ hex: 0xC0C5, status: 403, message: "The route's plan gate names a feature the app's plans file does not have" }),
+    FILE_EXISTS: Object.freeze({ hex: 0xC0C6, status: 409, message: "A file already exists at the destination path; choose another path, or move with replace: true" }),
+    APP_NOT_NAMED: Object.freeze({ hex: 0xC0C7, status: 400, message: "This call runs at an app and the request names none: send X-Substrio-Tenant: <app>, or call the app's own host" }),
+    SYSTEM_PROTECTED: Object.freeze({ hex: 0xC0C8, status: 403, message: "This account or app is the platform's own and cannot be deleted" }),
+    SHELL_SYNTAX: Object.freeze({ hex: 0xC0D0, status: 400, message: "The command is not in the shell's grammar (the detail says where); nothing ran" }),
+    SHELL_UNKNOWN_COMMAND: Object.freeze({ hex: 0xC0D1, status: 400, message: "The shell has no such command; the detail lists the ones it has" }),
+    SHELL_UNKNOWN_VARIABLE: Object.freeze({ hex: 0xC0D2, status: 400, message: "The shell has no such variable: PWD HOME SRC SITE FILES BRANCH and ? are the ones it has" }),
+    SHELL_PATH_OUTSIDE: Object.freeze({ hex: 0xC0D3, status: 400, message: "The path is under no mount: /src, /site and /files are the shell's whole file system" }),
+    SHELL_READ_ONLY: Object.freeze({ hex: 0xC0D4, status: 400, message: "/site is the live release, read only: change /src and ship a version" }),
+    SHELL_WRITE_NOT_GRANTED: Object.freeze({ hex: 0xC0D5, status: 403, message: "The command writes, and the caller's grant reads only; nothing landed" }),
+    SHELL_FILES_DELETE: Object.freeze({ hex: 0xC0D6, status: 403, message: "A stored file is deleted with file.delete, which asks a person first; nothing landed" }),
+    SHELL_OFFSET_WRITES: Object.freeze({ hex: 0xC0D7, status: 400, message: "offset continues a command's output, and this command writes: run it without offset" }),
+    SHELL_CPU_BUDGET: Object.freeze({ hex: 0xC0D8, status: 408, message: "The command ran past the shell's CPU budget; nothing landed: narrow it" }),
+    SHELL_PIPE_BUDGET: Object.freeze({ hex: 0xC0D9, status: 413, message: "One stage of the command wrote past the shell's pipe budget; nothing landed: narrow it" }),
+    DASHBOARD_INVALID: Object.freeze({ hex: 0xC0E0, status: 400, message: "The app's dashboard file is not one the console can draw; field names the path in it (nav[2].panels[0].source.route) and the detail what is wrong" }),
+    REGION_NOT_FOUND: Object.freeze({ hex: 0xC0F0, status: 404, message: "No region of this slug; region.list names them" }),
+    REGION_IN_USE: Object.freeze({ hex: 0xC0F1, status: 409, message: "A host still names this region; host.update moves or clears it first" }),
+    REGION_LIMIT: Object.freeze({ hex: 0xC0F2, status: 409, message: "The platform holds the most regions it can; region.remove frees one" }),
+    REGION_UNAVAILABLE: Object.freeze({ hex: 0xC0F3, status: 409, message: "This region is not offered: it is hidden, unknown or serves no apps yet; region.choices lists the ones you can pick" }),
+    REGION_FULL: Object.freeze({ hex: 0xC0F4, status: 409, message: "Every host in this region is at its app limit; pick another region from region.choices or try again later" }),
+    HOST_NOT_PROBED: Object.freeze({ hex: 0xC0F5, status: 409, message: "This host has not been probed, so its CPU and systemd are unknown; host.probe first" }),
+    HOST_NO_SYSTEMD: Object.freeze({ hex: 0xC0F6, status: 409, message: "This host runs no systemd, which a node's service needs" }),
+    HOST_NGINX_PRESENT: Object.freeze({ hex: 0xC0F7, status: 409, message: "nginx is installed or running on this host; the platform serves :80 and :443 itself and never shares a host with a proxy" }),
+    RELEASE_NOT_FOUND: Object.freeze({ hex: 0xC0F8, status: 404, message: "The master holds no release of this id; release.list names them" }),
+    RELEASE_NOT_PACKED: Object.freeze({ hex: 0xC0F9, status: 409, message: "This release has no packed tarball (.tar.zst and .sha256) beside its folder, so it cannot be sent to a host" }),
+    RELEASE_ISA_UNKNOWN: Object.freeze({ hex: 0xC0FA, status: 409, message: "This release's manifest names no instruction set, so no host can be checked against it" }),
+    HOST_CPU_MISSING: Object.freeze({ hex: 0xC0FB, status: 409, message: "This host's CPU lacks features the release needs; the detail names them" }),
+    HOST_NODE_LIMIT: Object.freeze({ hex: 0xC0FC, status: 409, message: "This host holds the most nodes it can; host.node.undeploy frees a slot" }),
+    NODE_BUSY: Object.freeze({ hex: 0xC0FD, status: 409, message: "A deploy or undeploy of this node is under way; host.node.list shows when it ends" }),
     TEST_TENANT_REQUIRED: Object.freeze({ hex: 0xC570, status: 403, message: "Only a test tenant (tenant.create test=true) has fetch stubs and a clock" }),
+    ARCHIVE_INVALID: Object.freeze({ hex: 0xC580, status: 400, message: "The archive is not one app.archive made, or an entry does not match its manifest.json; detail names the entry. Nothing was written" }),
+    ARCHIVE_PASSPHRASE_WRONG: Object.freeze({ hex: 0xC581, status: 400, message: "The X-Substrio-Passphrase header does not open the archive's sealed.bin; send the passphrase it was downloaded with, or none to restore without the sealed part. Nothing was written" }),
+    WASM_MODULE_INVALID: Object.freeze({ hex: 0xC590, status: 400, message: "The Wasm module is not valid, lacks an export the platform calls (substrio_fetch, substrio_in, substrio_alloc, memory) or imports something the platform does not provide; the detail names it. Nothing was deployed" }),
+    WASM_COMPILE_FAILED: Object.freeze({ hex: 0xC591, status: 422, message: "The Wasm module is valid but was not compiled within the deploy's time and memory limits. Nothing was deployed" }),
+    WASM_CELLS_UNSUPPORTED: Object.freeze({ hex: 0xC592, status: 409, message: "This server runs tenant code in cells, where a Wasm function cannot run yet. Nothing was deployed" }),
+    RUST_COMPILE_FAILED: Object.freeze({ hex: 0xC593, status: 422, message: "The Rust source did not compile; the detail is the compiler's own diagnostics, with the line and column of each error. Nothing was deployed" }),
+    RUST_TOOLCHAIN_UNAVAILABLE: Object.freeze({ hex: 0xC594, status: 503, message: "This server cannot compile Rust: its release has no Rust toolchain (a release ships one; a dev build needs SUBSTRIO_RUST), or the tools jail could not run it (the detail says why). Nothing was deployed" }),
     SERIALIZATION: Object.freeze({ hex: 0xF000, status: 500, message: "Serialization error" }),
     DESERIALIZATION: Object.freeze({ hex: 0xF001, status: 400, message: "Deserialization error" }),
     PIPELINE_TOO_LARGE: Object.freeze({ hex: 0xF002, status: 400, message: "Pipeline too large" }),
-    INVALID_JSON: Object.freeze({ hex: 0xF003, status: 400, message: "Invalid JSON" }),
+    INVALID_JSON: Object.freeze({ hex: 0xF003, status: 400, message: "The request body is not valid JSON." }),
     EMPTY_PAYLOAD: Object.freeze({ hex: 0xF004, status: 400, message: "Request payload is empty" }),
     BODY_REQUIRED: Object.freeze({ hex: 0xF005, status: 400, message: "Request body is required" }),
     METHOD_NOT_ALLOWED: Object.freeze({ hex: 0xF006, status: 405, message: "HTTP method not allowed" }),