@columenlabs/lumen-ai 0.1.252 → 0.1.253

package/dist/assistant/engine.js

@@ -16,7 +16,7 @@ import { webLookupTools } from '../subagents/web.js';
 import { bearings } from './bearings.js';
 import { CHATGPT_REDIRECT, SigninError, finishChatgpt, startChatgpt, testChatgpt, } from './chatgpt.js';
 import { ALL_MODELS, DEFAULT_OUT, Meter, PROVIDERS, XAI_BASE_URL, effortParams, } from './models.js';
-import { DEFAULT_CAP, State, keyDocName, keyState, ownKeyUsd, ownPlanCalls, planDocName, waitText, withProvider, } from './state.js';
+import { DEFAULT_CAP, State, keyDocName, keyState, ownKeyUsd, ownPlanCalls, ownPlanUsd, planDocName, waitText, withProvider, } from './state.js';
 import { Docs } from './store.js';
 import { toolName, withDeadline } from './tools.js';
 import { scrapeqlTools, webFetchTools } from './web.js';
@@ -410,6 +410,7 @@ export class Assistant {
                     title: message.split('\n')[0] || 'Chat',
                     own_usd: ownKeyUsd(paying, onPayer),
                     own_plan_calls: ownPlanCalls(paying, onPayer),
+                    own_plan_usd: ownPlanUsd(paying, onPayer),
                 }, end.parts)
                     .catch(() => undefined);
             const total = end.parts.reduce((a, m) => ({
@@ -1096,6 +1097,7 @@ export class Assistant {
                 title: o.run?.title ?? task?.label ?? o.task,
                 own_usd: ownKeyUsd(paying, [part]),
                 own_plan_calls: ownPlanCalls(paying, [part]),
+                own_plan_usd: ownPlanUsd(paying, [part]),
             }, [part])
                 .catch(() => undefined);
         }
@@ -1185,6 +1187,7 @@ export class Assistant {
                 title: o.run?.title ?? task?.label ?? o.task,
                 own_usd: ownKeyUsd(paying, [part]),
                 own_plan_calls: ownPlanCalls(paying, [part]),
+                own_plan_usd: ownPlanUsd(paying, [part]),
             }, [part])
                 .catch(() => undefined);
         }

package/dist/assistant/state.d.ts

@@ -104,8 +104,19 @@ export type SpendRow = UsagePart & {
 };
 /** The provider a part ran on: by its model id, else by the model's name at the end of its label. */
 export declare function providerOfPart(p: UsagePart): AssistantProvider | undefined;
-/** Spend rows with the provider each ran on, so a page can tell a removed key's spend apart. */
-export declare function withProvider<R extends UsagePart>(rows: R[]): R[];
+/**
+ * What a part's tokens cost at its model's API rates: the estimate shown for a plan sign-in's calls,
+ * which cost the person nothing. Cache writes count as plain input. Undefined for an unknown model.
+ */
+export declare function listUsd(p: UsagePart): number | undefined;
+/**
+ * Spend rows with the provider each ran on, so a page can tell a removed key's spend apart, and
+ * a $0 row (a plan's calls) with what it would cost at API rates (`list_usd`).
+ */
+export declare function withProvider<R extends UsagePart>(rows: R[]): (R & {
+    provider?: "anthropic" | "openai" | "xai" | undefined;
+    list_usd?: number | undefined;
+})[];
 /** USD of `parts` the person's own API keys paid: a provider signed in with a plan costs $0. */
 export declare function ownKeyUsd(paying: {
     payer: AssistantPayer;
@@ -116,6 +127,11 @@ export declare function ownPlanCalls(paying: {
     payer: AssistantPayer;
     plans: Paying['plans'];
 }, parts: UsagePart[]): number;
+/** Those plan calls at the models' API rates: an estimate of what the plan saved the person. */
+export declare function ownPlanUsd(paying: {
+    payer: AssistantPayer;
+    plans: Paying['plans'];
+}, parts: UsagePart[]): number;
 /**
  * What counts toward the person's own cap: own rows paid by an API key (a plan sign-in costs
  * nothing per call), on a provider they can still pay with. A row from before ways were recorded
@@ -282,7 +298,8 @@ export declare class State {
      * Adds one answer's use to a chat or run in this month's history (`usage:YYYY-MM`): one entry a
      * chat or run, its parts merged, the newest `USAGE_KEPT` kept. `title` names a new entry only;
      * `own_usd` is what of this answer the person's own key or plan paid, added to the entry's;
-     * `own_plan_calls` the calls their plan sign-in answered (free to them, so counted, not priced).
+     * `own_plan_calls` the calls their plan sign-in answered (free to them, so counted, not priced),
+     * `own_plan_usd` those calls at API rates (an estimate).
      */
     addUsage(id: string, e: {
         id: string;
@@ -291,6 +308,7 @@ export declare class State {
         title: string;
         own_usd?: number;
         own_plan_calls?: number;
+        own_plan_usd?: number;
     }, parts: UsagePart[]): Promise<void>;
     /** One month's history (this month by default) beside its spend, and the months that have one. */
     usage(id: string, month?: string): Promise<UsageHistory>;

package/dist/assistant/state.js

@@ -14,11 +14,30 @@ export function providerOfPart(p) {
         KNOWN_MODELS.find((x) => p.label === x.label || p.label.endsWith(` · ${x.label}`));
     return m?.provider;
 }
-/** Spend rows with the provider each ran on, so a page can tell a removed key's spend apart. */
+/**
+ * What a part's tokens cost at its model's API rates: the estimate shown for a plan sign-in's calls,
+ * which cost the person nothing. Cache writes count as plain input. Undefined for an unknown model.
+ */
+export function listUsd(p) {
+    const m = KNOWN_MODELS.find((x) => x.id === p.model) ??
+        KNOWN_MODELS.find((x) => p.label === x.label || p.label.endsWith(` · ${x.label}`));
+    if (!m)
+        return undefined;
+    return (Math.max(0, p.in - p.read) * m.in + p.read * m.read + p.out * m.out) / 1e6;
+}
+/**
+ * Spend rows with the provider each ran on, so a page can tell a removed key's spend apart, and
+ * a $0 row (a plan's calls) with what it would cost at API rates (`list_usd`).
+ */
 export function withProvider(rows) {
     return rows.map((r) => {
         const provider = providerOfPart(r);
-        return provider ? { ...r, provider } : r;
+        const list = r.calls && r.usd < 0.0005 ? listUsd(r) : undefined;
+        return {
+            ...r,
+            ...(provider ? { provider } : {}),
+            ...(list !== undefined ? { list_usd: list } : {}),
+        };
     });
 }
 /** USD of `parts` the person's own API keys paid: a provider signed in with a plan costs $0. */
@@ -43,6 +62,17 @@ export function ownPlanCalls(paying, parts) {
     })
         .reduce((a, p) => a + p.calls, 0);
 }
+/** Those plan calls at the models' API rates: an estimate of what the plan saved the person. */
+export function ownPlanUsd(paying, parts) {
+    if (paying.payer !== 'own')
+        return 0;
+    return parts
+        .filter((p) => {
+        const prov = providerOfPart(p);
+        return !!(prov && paying.plans[prov]);
+    })
+        .reduce((a, p) => a + (listUsd(p) ?? 0), 0);
+}
 /**
  * What counts toward the person's own cap: own rows paid by an API key (a plan sign-in costs
  * nothing per call), on a provider they can still pay with. A row from before ways were recorded
@@ -364,7 +394,8 @@ export class State {
      * Adds one answer's use to a chat or run in this month's history (`usage:YYYY-MM`): one entry a
      * chat or run, its parts merged, the newest `USAGE_KEPT` kept. `title` names a new entry only;
      * `own_usd` is what of this answer the person's own key or plan paid, added to the entry's;
-     * `own_plan_calls` the calls their plan sign-in answered (free to them, so counted, not priced).
+     * `own_plan_calls` the calls their plan sign-in answered (free to them, so counted, not priced),
+     * `own_plan_usd` those calls at API rates (an estimate).
      */
     async addUsage(id, e, parts) {
         if (!parts.some((p) => p.calls))
@@ -378,6 +409,7 @@ export class State {
             const sum = (k) => merged.reduce((a, p) => a + p[k], 0);
             const own = (prev?.own_usd ?? 0) + (e.own_usd ?? 0);
             const plan = (prev?.own_plan_calls ?? 0) + (e.own_plan_calls ?? 0);
+            const planUsd = (prev?.own_plan_usd ?? 0) + (e.own_plan_usd ?? 0);
             entries.unshift({
                 id: e.id,
                 kind: e.kind,
@@ -392,6 +424,7 @@ export class State {
                 usd: sum('usd'),
                 ...(own > 0 ? { own_usd: own } : {}),
                 ...(plan > 0 ? { own_plan_calls: plan } : {}),
+                ...(planUsd > 0 ? { own_plan_usd: planUsd } : {}),
                 parts: merged,
             });
             return { entries: entries.slice(0, USAGE_KEPT) };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@columenlabs/lumen-ai",
-  "version": "0.1.252",
+  "version": "0.1.253",
   "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.252",
-    "@columenlabs/lumen-ui-types": "0.1.252",
+    "@columenlabs/lumen-ops": "0.1.253",
+    "@columenlabs/lumen-ui-types": "0.1.253",
     "agents": "0.32.0",
     "ai": "7.0.162",
     "just-bash": "3.6.0",