@columenlabs/lumen-ops 0.1.257 → 0.1.258

package/README.md

@@ -151,13 +151,16 @@ import { meterEvent, setEventSink } from '@columenlabs/lumen-ops/events';
 setEventSink(env.EVENTS);
 meterEvent({ event: 'bank.call', code: '/accounts/get', ok: res.ok, ms, status: res.status, upstream: true });
 meterEvent({ event: 'sync.done', ok: true, subject: accountId, ref: connectionId, counts: [added, modified, removed] });
+meterEvent({ event: 'ai.answer', code: 'ok', ok: true, ms, ai: { model: 'claude-sonnet-5-5', in: 12000, out: 800, read: 9000, usd: 0.021 } });
 ```
 
 | Column | Holds |
 |---|---|
 | `index1` | Subject, or `anon` |
-| `blob1` … `blob10` | App, event, code, outcome, ref, trigger, request id, upstream id, env, version |
-| `double1` … `double6` | ms, status, count1, count2, count3, attempt |
+| `blob1` … `blob11` | App, event, code, outcome, ref, trigger, request id, upstream id, env, version, AI model |
+| `double1` … `double10` | ms, status, count1, count2, count3, attempt, AI usd, AI tokens in (cache reads included), AI tokens out, AI cache reads |
+
+`ai` is for an event that asked a model (an answer, a generated draft): the model id and what that call cost, so use and spend can be read per model and per event. Points without it write empty and 0 there.
 
 `upstream: true` adds the call's time to the request's `upstream ms`. In a Durable Object no request is in scope: give `setEventSink(binding, { app, env, version })` the defaults, and pass a `requestId` the caller sent if you have one.
 

package/dist/events.d.ts

@@ -27,6 +27,14 @@ export interface EventPoint {
     /** Up to three counts, named by the event (a sync: added, modified, removed). */
     counts?: [number?, number?, number?];
     attempt?: number;
+    /** A model call's use, for an event that asked an AI model: its id, tokens (in counts cache reads) and cost. */
+    ai?: {
+        model?: string;
+        in?: number;
+        out?: number;
+        read?: number;
+        usd?: number;
+    };
     /** `true` when the event was a call to another service: its time adds to the request's. */
     upstream?: boolean;
     /** Defaults to the request in scope; pass these from a Durable Object or a job. */
@@ -47,7 +55,7 @@ export interface EventDefaults {
 export declare function setEventSink(s: PointSink | undefined, d?: EventDefaults): void;
 /**
  * Column order is the contract with whoever reads the dataset back: index1 subject (or `anon`);
- * blobs app, event, code, outcome, ref, trigger, request id, upstream id, env, version; doubles
- * ms, status, count1, count2, count3, attempt.
+ * blobs app, event, code, outcome, ref, trigger, request id, upstream id, env, version, AI model;
+ * doubles ms, status, count1, count2, count3, attempt, AI usd, tokens in, tokens out, cache reads.
  */
 export declare function meterEvent(p: EventPoint): void;

package/dist/events.js

@@ -12,8 +12,8 @@ export function setEventSink(s, d = {}) {
 }
 /**
  * Column order is the contract with whoever reads the dataset back: index1 subject (or `anon`);
- * blobs app, event, code, outcome, ref, trigger, request id, upstream id, env, version; doubles
- * ms, status, count1, count2, count3, attempt.
+ * blobs app, event, code, outcome, ref, trigger, request id, upstream id, env, version, AI model;
+ * doubles ms, status, count1, count2, count3, attempt, AI usd, tokens in, tokens out, cache reads.
  */
 export function meterEvent(p) {
     try {
@@ -40,6 +40,7 @@ export function meterEvent(p) {
                 cap(p.upstreamId),
                 cap(fields.env),
                 cap(fields.version),
+                cap(p.ai?.model),
             ],
             doubles: [
                 num(p.ms),
@@ -48,6 +49,10 @@ export function meterEvent(p) {
                 num(p.counts?.[1]),
                 num(p.counts?.[2]),
                 num(p.attempt),
+                num(p.ai?.usd),
+                num(p.ai?.in),
+                num(p.ai?.out),
+                num(p.ai?.read),
             ],
         });
         logLine('event', {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@columenlabs/lumen-ops",
-  "version": "0.1.257",
+  "version": "0.1.258",
   "description": "Lumen's ops parts: every request, event, data query and tool call an app runs as one Analytics Engine point (templates, codes, shapes and hashes only), and signed webhooks out.",
   "license": "MIT",
   "type": "module",