@columenlabs/lumen-ai 0.1.271 → 0.1.274

package/dist/agent/agent.d.ts

@@ -23,6 +23,11 @@ import { UsageMeter } from './usage.js';
 /** What a plan's extra tools get: the open tools, a meter of their own and the cap. */
 export interface TurnTools {
     opened: OpenedTools;
+    /**
+     * The agent's own file tools over its workspace (read, list, find, grep and the rest, as Think
+     * gives the main model), so a hand-off reads the same files the app wrote for this turn.
+     */
+    files: ToolSet;
     /** A new part of this answer's usage (a hand off), counted against the cap. */
     meter(model: ModelDef, label: string, free?: boolean): UsageMeter;
     /** Spent this answer reached what the payer has left. */

package/dist/agent/agent.js

@@ -12,6 +12,7 @@
  * An `Assistant` gives both: `assistant.agentTurn(caller, input)` returns a plan and its settle.
  */
 import { anthropic } from '@ai-sdk/anthropic';
+import { createAITools } from '@cloudflare/computer/tools/ai-sdk';
 import { Think, } from '@cloudflare/think';
 import { ASSISTANT_IMAGES_MAX, ASSISTANT_IMAGE_CHARS, ASSISTANT_IMAGE_TYPES, ASSISTANT_QUOTE_MAX, } from '@columenlabs/lumen-ui-types/assistant';
 import { createCompactFunction } from 'agents/sessions';
@@ -706,6 +707,7 @@ export class LumenAgent extends Think {
         };
         const more = plan.more?.({
             opened,
+            files: createAITools({ workspace: this.workspace }),
             over: () => plan.left !== undefined && this.#spent() >= plan.left,
             meter: (model, label, f = free) => {
                 const m = new UsageMeter(model, label, f);

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 } : {}),
@@ -604,7 +645,7 @@ export class Assistant {
                         }),
                         instructions: c.system(tt.opened),
                         prompt: `${c.message}\n\n${this.name} handed you this task (${WHY_TEXT[shown]}): ${task}\n\nWork it out with the tools, then end with a memo for ${this.name} of at most 200 words: the answer and the facts it rests on. ${this.name} answers the person.`,
-                        tools: tt.opened.tools,
+                        tools: { ...tt.files, ...tt.opened.tools },
                         stopWhen: stepCountIs(MAX_ROUNDS),
                         prepareStep: () => (tt.over() ? { activeTools: [] } : undefined),
                         onStepFinish: (s) => {
@@ -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.274",
   "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",
@@ -55,9 +55,10 @@
     "@ai-sdk/anthropic": "4.0.96",
     "@ai-sdk/openai": "4.0.108",
     "@anthropic-ai/sdk": "0.133.0",
+    "@cloudflare/computer": "0.8.0",
     "@cloudflare/think": "0.23.0",
-    "@columenlabs/lumen-ops": "0.1.271",
-    "@columenlabs/lumen-ui-types": "0.1.271",
+    "@columenlabs/lumen-ops": "0.1.274",
+    "@columenlabs/lumen-ui-types": "0.1.274",
     "agents": "0.32.0",
     "ai": "7.0.162",
     "just-bash": "3.6.0",