@columenlabs/lumen-ai 0.1.198 → 0.1.200

package/README.md

@@ -280,6 +280,6 @@ Three more ways rows reach a tab, all on a free Workers plan (no Dynamic Workers
 
 - **Fetch recipe** (`{kind: 'fetch', requests: [{url, method?, key?}], each?: {values}, rows?, pick?}`): declarative web reads the product runs on its server. `{field}` holes in a URL fill from each value of `each` (text fills `{value}`); `fetchCalls` expands them (at most `FETCH_CALLS`, 50 a run) and `fetchedRows` turns the answers into rows, the `each` value's fields first, then `pick`'s dotted paths (`current.temperature_2m`). A data key is named (`key`), never sent: the product adds it server side.
 - **Browser script** (`{kind: 'script', runtime: 'browser', code, requests?}`): JavaScript that runs in the person's page. The kit's `runBrowserFrame` loads `<base>/sandbox` (this package's `SANDBOX_HTML`, served with `SANDBOX_CSP`: `connect-src 'none'`) in an iframe with `sandbox="allow-scripts"`, runs the code in a Web Worker there (stopped at `BROWSER_RUN_MS`, 30 s), and saves what it returns with `PUT /frames/:id/rows` (one write, the frame's caps checked). The code is the body of `async (fetched, hub) => rows`: `fetched` holds the answers to its `requests`, `hub.fetch(url, {key})` makes one more read through the product's proxy (`fetch` in `workspaceRoutes`, `POST <base>/fetch`). The server never runs it: `refresh` refuses it (409, open the tab), and `refreshAll` lists such tabs as `browser`.
-- **Pushed dataset** (`store.pushFrame(owner, {name, rows, mode, by, key?})`): rows an outside agent wrangled (a CSV parsed by `parseCsv`, at most `CSV_BYTES` a call, the rest as `append` parts; with `key`, an appended row replaces the one with its key). Origin `harness`, no recipe; `by` names the agent and the tab's status bar reads "Pushed by Claude Code · 4 min ago". `removeFrame` deletes one with its tabs.
+- **Pushed dataset** (`store.pushFrame(owner, {name, rows, mode, by, key?})`): rows an outside agent wrangled (a CSV parsed by `parseCsv`, at most `CSV_BYTES` a call, the rest as `append` parts; with `key`, an appended row replaces the one with its key). Origin `harness`, no recipe; `by` names the agent and the tab's status bar reads "Pushed by Claude Code · 4 min ago". `frameTab(owner, workspace, {name, frame})` shows one in a tab (no run); `removeFrame` deletes one with its tabs.
 
 `workspaceRoutes` lets `call`, `fetch` and browser `script` recipes through to the product's `allow`; server `sql` and `script` are refused.

package/dist/agent/models.d.ts

@@ -24,14 +24,14 @@ export interface AiModelOptions {
 export declare function planFetch(base?: typeof fetch, name?: string): typeof fetch;
 /** The AI SDK model a tier runs: its provider's client on the payer's key. */
 export declare function aiModel(model: ModelDef, key: ModelKey, o?: AiModelOptions): LanguageModel;
-/** A tier's effort and output cap as a turn's settings; nothing at the model's own default. */
+/** A tier's effort and output cap as a turn's settings, with Claude's prompt cache on. */
 export declare function turnSettings(model: ModelDef, o: {
     effort: AssistantEffort;
     out?: number;
     plan?: boolean;
 }): {
     maxOutputTokens?: number;
-    providerOptions?: Record<string, Record<string, JSONValue>>;
+    providerOptions: Record<string, Record<string, JSONValue>>;
 };
 /** A ChatGPT plan used up for now: a 429 or a usage code, thrown or sent before any output. */
 export declare function planLimited(err: unknown): boolean;

package/dist/agent/models.js

@@ -87,19 +87,29 @@ export function aiModel(model, key, o = {}) {
     const f = key.plan ? planFetch(o.fetch, o.name) : o.fetch;
     return createOpenAI({ apiKey: key.apiKey, ...(f ? { fetch: f } : {}) }).responses(model.id);
 }
-/** A tier's effort and output cap as a turn's settings; nothing at the model's own default. */
+/**
+ * Claude's prompt cache: one breakpoint on the request, which Claude moves to the newest block on
+ * each call, so a turn's later steps and the next turn read the tools, instructions and chat so
+ * far from cache (a tenth of the input price) instead of paying for them again. Sent whatever the
+ * tier's provider, so a plan's fallback to Claude caches too; other providers ignore it.
+ */
+const CLAUDE_CACHE = { cacheControl: { type: 'ephemeral' } };
+/** A tier's effort and output cap as a turn's settings, with Claude's prompt cache on. */
 export function turnSettings(model, o) {
     const out = o.plan || !o.out ? {} : { maxOutputTokens: o.out };
+    const anthropic = { ...CLAUDE_CACHE };
     // A plan keeps nothing, so earlier turns go back as items, not references to stored ones.
     const openai = o.plan ? { store: false } : {};
     if (o.effort !== 'default') {
         if (model.provider === 'anthropic')
-            return { ...out, providerOptions: { anthropic: { effort: o.effort } } };
-        openai.reasoningEffort = o.effort;
+            anthropic.effort = o.effort;
+        else
+            openai.reasoningEffort = o.effort;
     }
-    return model.provider === 'openai' && Object.keys(openai).length
-        ? { ...out, providerOptions: { openai } }
-        : out;
+    return {
+        ...out,
+        providerOptions: { anthropic, ...(Object.keys(openai).length ? { openai } : {}) },
+    };
 }
 /** A ChatGPT plan used up for now: a 429 or a usage code, thrown or sent before any output. */
 export function planLimited(err) {

package/dist/workspaces/store.d.ts

@@ -92,6 +92,18 @@ export declare function createWorkspaces(opts: WorkspacesOptions): {
         workspace: WorkspaceRead;
         tab: string;
     }>;
+    /**
+     * A new tab over a frame the person already has (a dataset an outside agent pushed): no run,
+     * the rows are the frame's. One tab per frame in a workspace; asking again gives that tab.
+     */
+    frameTab(owner: string, id: string, p: {
+        name: string;
+        frame: string;
+        start?: WorkspaceTab['start'];
+    }): Promise<{
+        workspace: Workspace;
+        tab: string;
+    }>;
     putTab(owner: string, id: string, tab: string, p: {
         name?: string;
         config?: CustomViewConfig | null;

package/dist/workspaces/store.js

@@ -326,6 +326,27 @@ export function createWorkspaces(opts) {
                 tab: tab.id,
             };
         },
+        /**
+         * A new tab over a frame the person already has (a dataset an outside agent pushed): no run,
+         * the rows are the frame's. One tab per frame in a workspace; asking again gives that tab.
+         */
+        async frameTab(owner, id, p) {
+            const w = await getSpace(owner, id);
+            await getFrame(owner, p.frame);
+            const had = w.tabs.find((x) => 'frame' in x.source && x.source.frame === p.frame);
+            if (had)
+                return { workspace: w, tab: had.id };
+            if (w.tabs.length >= MAX_TABS)
+                throw new FrameError(`${w.name} has ${MAX_TABS} tabs, the most: delete one first.`, 409);
+            const tab = {
+                id: newId('tb'),
+                name: p.name,
+                source: { frame: p.frame },
+                config: null,
+                ...(p.start?.formulas.length ? { start: p.start } : {}),
+            };
+            return { workspace: await saveSpace(owner, { ...w, tabs: [...w.tabs, tab] }), tab: tab.id };
+        },
         async putTab(owner, id, tab, p) {
             const w = await getSpace(owner, id);
             if (!w.tabs.some((x) => x.id === tab))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@columenlabs/lumen-ai",
-  "version": "0.1.198",
+  "version": "0.1.200",
   "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",
@@ -52,8 +52,8 @@
     "@ai-sdk/openai": "4.0.108",
     "@anthropic-ai/sdk": "0.133.0",
     "@cloudflare/think": "0.23.0",
-    "@columenlabs/lumen-ops": "0.1.198",
-    "@columenlabs/lumen-ui-types": "0.1.198",
+    "@columenlabs/lumen-ops": "0.1.200",
+    "@columenlabs/lumen-ui-types": "0.1.200",
     "agents": "0.32.0",
     "ai": "7.0.162",
     "just-bash": "3.6.0",