@mccaskie-labs/workbench-ai 0.1.2 → 0.1.3

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @mccaskie-labs/workbench-ai
 
+## 0.1.3
+
+### Patch Changes
+
+- Two new error codes for the Workbench content rules (`docs/spec.md` §2.7): `content_refused` (never retryable; `details.rule`, `details.stage` and `details.rulesVersion` say which rule refused it and where) and `content_check_unavailable` (retryable). Before this a streamed refusal surfaced as a retryable `network` error.
+
 ## 0.1.2
 
 ### Patch Changes

package/dist/errors.d.ts

@@ -1,4 +1,4 @@
-export type AiErrorCode = "refused" | "truncated" | "invalid_output" | "unexpected_stop" | "unauthorised" | "forbidden_scope" | "invalid_request" | "model_not_allowed" | "budget_exceeded" | "rate_limited" | "not_found" | "not_available" | "upstream_error" | "upstream_timeout" | "internal_error" | "network" | "invalid_config";
+export type AiErrorCode = "refused" | "truncated" | "invalid_output" | "unexpected_stop" | "unauthorised" | "forbidden_scope" | "invalid_request" | "model_not_allowed" | "budget_exceeded" | "content_refused" | "content_check_unavailable" | "rate_limited" | "not_found" | "not_available" | "upstream_error" | "upstream_timeout" | "internal_error" | "network" | "invalid_config";
 export interface AiErrorDetails {
     requestId?: string;
     upstreamStatus?: number;
@@ -12,6 +12,10 @@ export interface AiErrorDetails {
     month?: string;
     spentUsd?: number;
     capUsd?: number;
+    /** For `content_refused`: the rule (`R2`, or `vendor` for a vendor's own safety block), the stage and the rules version. */
+    rule?: string;
+    stage?: "input" | "output";
+    rulesVersion?: string;
 }
 export declare class WorkbenchAiError extends Error {
     readonly code: AiErrorCode;

package/dist/errors.js

@@ -1,7 +1,7 @@
 // Every failure the package raises is a WorkbenchAiError with a stable code
 // (docs/spec.md §3). Callers branch on `code`, never on the message. A refusal
 // or a max_tokens truncation is an error, never a partial success (audit F18).
-const RETRYABLE = new Set(["rate_limited", "upstream_error", "upstream_timeout", "network"]);
+const RETRYABLE = new Set(["rate_limited", "content_check_unavailable", "upstream_error", "upstream_timeout", "network"]);
 export class WorkbenchAiError extends Error {
     code;
     retryable;
@@ -26,6 +26,8 @@ const KNOWN = new Set([
     "invalid_request",
     "model_not_allowed",
     "budget_exceeded",
+    "content_refused",
+    "content_check_unavailable",
     "rate_limited",
     "not_found",
     "not_available",
@@ -96,5 +98,11 @@ export function errorFromGateway(status, body, requestId) {
         details.spentUsd = err["spent_usd"];
     if (typeof err["cap_usd"] === "number")
         details.capUsd = err["cap_usd"];
+    if (typeof err["rule"] === "string")
+        details.rule = err["rule"];
+    if (err["stage"] === "input" || err["stage"] === "output")
+        details.stage = err["stage"];
+    if (typeof err["rules_version"] === "string")
+        details.rulesVersion = err["rules_version"];
     return new WorkbenchAiError(code, message, details);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mccaskie-labs/workbench-ai",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Claude through the Workbench Gateway: text, structured output, streaming and budget status, with no Anthropic key in the app. Refusals and truncations throw; createFakeAi for tests.",
   "license": "UNLICENSED",
   "type": "module",