@columenlabs/lumen-ai 0.1.271 → 0.1.273

package/dist/assistant/engine.js

@@ -76,7 +76,7 @@ const WHY_TEXT = {
     check_failed: 'check failed',
 };
 /** A short line of what an error was, never an upstream body. */
-function shownError(err) {
+function shownError(err, plan = false) {
     if (err instanceof AssistantError)
         return { message: err.message, code: err.code };
     const api = err instanceof Anthropic.APIError
@@ -100,6 +100,16 @@ function shownError(err) {
     // The AI SDK's errors (APICallError, and RetryError around its last one) carry the HTTP status as
     // statusCode: say what that status means, never the body; the body goes to the log only.
     const call = sdkCall(err);
+    // OpenAI names the reason in its body (a plan's usage limit answers 500): say that reason.
+    if (call?.code && /openai\.com|chatgpt\.com/.test(call.url))
+        return {
+            message: openaiStreamError({ code: call.code, message: call.message }, plan),
+            code: /usage_limit|insufficient_quota/.test(call.code)
+                ? 'usage_limit'
+                : /rate_limit/.test(call.code)
+                    ? 'rate_limited'
+                    : 'model_error',
+        };
     if (call) {
         console.error(JSON.stringify({
             event: 'assistant_upstream_error',
@@ -126,7 +136,10 @@ function shownError(err) {
     }
     return { message: 'Something went wrong while answering.', code: 'internal' };
 }
-/** An AI SDK call error's status and message, through RetryError's lastError and `cause`. */
+/**
+ * An AI SDK call error's status, message, address and the provider's own error code (from its
+ * body: `error.code`, `error.type` or `detail.code`), through RetryError's lastError and `cause`.
+ */
 function sdkCall(err, depth = 0) {
     if (!err || typeof err !== 'object' || depth > 3)
         return null;
@@ -134,13 +147,41 @@ function sdkCall(err, depth = 0) {
     const name = typeof e.name === 'string' ? e.name : '';
     if (name === 'AI_RetryError' || name === 'RetryError')
         return sdkCall(e.lastError, depth + 1);
-    if (name === 'AI_APICallError' || name === 'APICallError' || typeof e.statusCode === 'number')
+    if (name === 'AI_APICallError' || name === 'APICallError' || typeof e.statusCode === 'number') {
+        const code = bodyCode(e.data) ?? bodyCode(parseJson(e.responseBody));
         return {
             ...(typeof e.statusCode === 'number' && { status: e.statusCode }),
             message: typeof e.message === 'string' ? e.message : '',
+            url: typeof e.url === 'string' ? e.url : '',
+            ...(code && { code }),
         };
+    }
     return e.cause ? sdkCall(e.cause, depth + 1) : null;
 }
+const parseJson = (v) => {
+    if (typeof v !== 'string')
+        return undefined;
+    try {
+        return JSON.parse(v);
+    }
+    catch {
+        return undefined;
+    }
+};
+/** A provider body's error code: `{error: {code | type}}` or `{detail: {code}}`. */
+function bodyCode(v) {
+    if (!v || typeof v !== 'object')
+        return undefined;
+    const o = v;
+    for (const x of [o.error, o.detail]) {
+        if (!x || typeof x !== 'object')
+            continue;
+        const c = x.code ?? x.type;
+        if (typeof c === 'string' && c)
+            return c.slice(0, 80);
+    }
+    return undefined;
+}
 /**
  * A plain sentence for an error OpenAI sends inside the answer's stream (an `error` event, or a
  * failed response): what happened and what to do, by its code, with OpenAI's code in brackets so
@@ -416,7 +457,7 @@ export class Assistant {
             label: main.meter.label,
             system: (t) => rulesFor(main, t),
             lead: `${page}${handTo && reach.length
-                ? `The person handed this message to ${handTo.label}: call escalate {tier: "${handTo.id}", why: "asked"} now, its task the message with every fact from this chat it needs, then answer from its memo.\n\n`
+                ? `The person handed this message to ${handTo.label}: call escalate {tier: "${handTo.id}", why: "asked"} now, its task the message with every fact from this chat it needs, then answer from its memo. If it answers with an error, do the task yourself with your tools.\n\n`
                 : ''}${command}`,
             sources: await this.sourcesOf(caller, p),
             ...(fallback ? { fallback } : {}),
@@ -639,7 +680,9 @@ export class Assistant {
                         tier: tier.id,
                         handoff: true,
                     })).catch(() => undefined);
-                    return { error: `${sub.meter.label} failed: ${shownError(err).message}` };
+                    return {
+                        error: `${sub.meter.label} could not take the task: ${shownError(err, !!key.plan).message} The task is still yours: do it now with your own tools, and tell the person only this reason if you cannot.`,
+                    };
                 }
             },
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@columenlabs/lumen-ai",
-  "version": "0.1.271",
+  "version": "0.1.273",
   "description": "Lumen's assistant and agent parts: a chat assistant's server (Claude tiers, tools over MCP, the web, hand off, spend caps), serving an MCP server from a Worker, read-only tool sets and metered tool calls.",
   "license": "MIT",
   "type": "module",
@@ -56,8 +56,8 @@
     "@ai-sdk/openai": "4.0.108",
     "@anthropic-ai/sdk": "0.133.0",
     "@cloudflare/think": "0.23.0",
-    "@columenlabs/lumen-ops": "0.1.271",
-    "@columenlabs/lumen-ui-types": "0.1.271",
+    "@columenlabs/lumen-ops": "0.1.273",
+    "@columenlabs/lumen-ui-types": "0.1.273",
     "agents": "0.32.0",
     "ai": "7.0.162",
     "just-bash": "3.6.0",