@spendgraph/sdk 0.5.1 → 0.7.0

package/dist/index.js

@@ -1,5 +1 @@
-export { Spendgraph } from "./client.js";
-export { Client, queryString, SpendgraphError } from "./core/client/index.js";
-export * from "./resources/index.js";
-export { FieldValidationError, serializeFields, validateFields, } from "./schema/index.js";
-export { SpendGraph } from "./track/index.js";
+import{Spendgraph as e}from"./client.js";import{Client as i,queryString as p,SpendgraphError as m}from"./core/client/index.js";import{mapLimit as s}from"./core/concurrency.js";import{formatMicros as f,microsFromUsd as l}from"./core/money.js";export*from"./resources/index.js";import{totalTokens as g}from"./rollout/index.js";import{FieldValidationError as S,isMissing as h,serializeFields as c,toBoolean as u,toNumber as E,validateFields as M}from"./schema/index.js";import{SpendGraph as k}from"./track/index.js";export{i as Client,S as FieldValidationError,k as SpendGraph,e as Spendgraph,m as SpendgraphError,f as formatMicros,h as isMissing,s as mapLimit,l as microsFromUsd,p as queryString,c as serializeFields,u as toBoolean,E as toNumber,g as totalTokens,M as validateFields};

package/dist/langchain.js

@@ -1,69 +1 @@
-export function spendGraphHandler(meter, options = {}) {
-    const models = new Map();
-    const rememberModel = (llm, runId, extraParams) => {
-        try {
-            const model = extraParams?.invocation_params?.model ??
-                extraParams?.invocation_params?.model_name ??
-                extraParams?.invocation_params?.modelId ??
-                llm?.kwargs?.model ??
-                llm?.kwargs?.model_name;
-            if (model)
-                models.set(runId, model);
-        }
-        catch {
-        }
-    };
-    return {
-        name: "spendgraph",
-        handleLLMStart(llm, _prompts, runId, _parentRunId, extraParams) {
-            rememberModel(llm, runId, extraParams);
-        },
-        handleChatModelStart(llm, _messages, runId, _parentRunId, extraParams) {
-            rememberModel(llm, runId, extraParams);
-        },
-        handleLLMEnd(output, runId) {
-            const startedAs = models.get(runId);
-            models.delete(runId);
-            try {
-                const msg = output.generations?.[0]?.[0]?.message;
-                const um = msg?.usage_metadata;
-                const tu = output.llmOutput?.tokenUsage;
-                const au = output.llmOutput?.usage;
-                let inputTokens = um?.input_tokens ?? au?.input_tokens ?? tu?.promptTokens;
-                const outputTokens = um?.output_tokens ?? au?.output_tokens ?? tu?.completionTokens;
-                if (typeof inputTokens !== "number" || typeof outputTokens !== "number")
-                    return;
-                let cacheReadTokens = 0;
-                let cacheWriteTokens = 0;
-                if (um?.input_token_details && typeof um.input_tokens === "number") {
-                    cacheReadTokens = um.input_token_details.cache_read ?? 0;
-                    cacheWriteTokens = um.input_token_details.cache_creation ?? 0;
-                    inputTokens = Math.max(0, inputTokens - cacheReadTokens - cacheWriteTokens);
-                }
-                else if (au) {
-                    cacheReadTokens = au.cache_read_input_tokens ?? 0;
-                    cacheWriteTokens = au.cache_creation_input_tokens ?? 0;
-                }
-                const model = msg?.response_metadata?.model ??
-                    msg?.response_metadata?.model_name ??
-                    output.llmOutput?.model ??
-                    startedAs ??
-                    options.defaultModel ??
-                    "unknown";
-                meter.track({
-                    model,
-                    inputTokens,
-                    outputTokens,
-                    cacheReadTokens,
-                    cacheWriteTokens,
-                    metadata: options.metadata,
-                });
-            }
-            catch {
-            }
-        },
-        handleLLMError(_err, runId) {
-            models.delete(runId);
-        },
-    };
-}
+function h(i,l={}){const d=new Map,_=(e,a,n)=>{try{const o=n?.invocation_params?.model??n?.invocation_params?.model_name??n?.invocation_params?.modelId??e?.kwargs?.model??e?.kwargs?.model_name;o&&d.set(a,o)}catch{}};return{name:"spendgraph",handleLLMStart(e,a,n,o,t){_(e,n,t)},handleChatModelStart(e,a,n,o,t){_(e,n,t)},handleLLMEnd(e,a){const n=d.get(a);d.delete(a);try{const o=e.generations?.[0]?.[0]?.message,t=o?.usage_metadata,p=e.llmOutput?.tokenUsage,s=e.llmOutput?.usage;let m=t?.input_tokens??s?.input_tokens??p?.promptTokens;const u=t?.output_tokens??s?.output_tokens??p?.completionTokens;if(typeof m!="number"||typeof u!="number")return;let r=0,c=0;t?.input_token_details&&typeof t.input_tokens=="number"?(r=t.input_token_details.cache_read??0,c=t.input_token_details.cache_creation??0,m=Math.max(0,m-r-c)):s&&(r=s.cache_read_input_tokens??0,c=s.cache_creation_input_tokens??0);const k=o?.response_metadata?.model??o?.response_metadata?.model_name??e.llmOutput?.model??n??l.defaultModel??"unknown";i.track({model:k,inputTokens:m,outputTokens:u,cacheReadTokens:r,cacheWriteTokens:c,metadata:l.metadata})}catch{}},handleLLMError(e,a){d.delete(a)}}}export{h as spendGraphHandler};

package/dist/resources/alerts.js

@@ -1,9 +1 @@
-export class Alerts {
-    client;
-    constructor(client) {
-        this.client = client;
-    }
-    list(query = {}) {
-        return this.client.get("/api/v1/alerts", { ...query });
-    }
-}
+class s{client;constructor(t){this.client=t}list(t={}){return this.client.get("/api/v1/alerts",{...t})}}export{s as Alerts};

package/dist/resources/cli.js

@@ -1,21 +1 @@
-export class Cli {
-    client;
-    constructor(client) {
-        this.client = client;
-    }
-    start(body) {
-        return this.client.postAnonymous("/api/v1/cli/auth", body);
-    }
-    exchange(body) {
-        return this.client.postAnonymous("/api/v1/cli/token", body);
-    }
-    terminals() {
-        return this.client.get("/api/v1/cli/tokens");
-    }
-    revoke(id) {
-        return this.client.delete(`/api/v1/cli/tokens/${encodeURIComponent(id)}`);
-    }
-    revokeSelf() {
-        return this.client.delete("/api/v1/cli/tokens/current");
-    }
-}
+class n{client;constructor(e){this.client=e}start(e){return this.client.postAnonymous("/api/v1/cli/auth",e)}exchange(e){return this.client.postAnonymous("/api/v1/cli/token",e)}terminals(){return this.client.get("/api/v1/cli/tokens")}revoke(e){return this.client.delete(`/api/v1/cli/tokens/${encodeURIComponent(e)}`)}revokeSelf(){return this.client.delete("/api/v1/cli/tokens/current")}}export{n as Cli};

package/dist/resources/credentials.js

@@ -1,15 +1 @@
-export class Credentials {
-    client;
-    constructor(client) {
-        this.client = client;
-    }
-    list() {
-        return this.client.get("/api/v1/credentials");
-    }
-    set(body) {
-        return this.client.put("/api/v1/credentials", body);
-    }
-    remove(provider) {
-        return this.client.delete("/api/v1/credentials", { provider });
-    }
-}
+class i{client;constructor(e){this.client=e}list(){return this.client.get("/api/v1/credentials")}set(e){return this.client.put("/api/v1/credentials",e)}remove(e){return this.client.delete("/api/v1/credentials",{provider:e})}}export{i as Credentials};

package/dist/resources/events.js

@@ -1,18 +1 @@
-export class Events {
-    client;
-    constructor(client) {
-        this.client = client;
-    }
-    list(query = {}) {
-        return this.client.get("/api/v1/events", { ...query });
-    }
-    async *all(query = {}) {
-        let cursor = query.cursor;
-        do {
-            const page = await this.list({ ...query, cursor });
-            for (const event of page.events)
-                yield event;
-            cursor = page.nextCursor ?? undefined;
-        } while (cursor);
-    }
-}
+class c{client;constructor(t){this.client=t}list(t={}){return this.client.get("/api/v1/events",{...t})}async*all(t={}){let e=t.cursor;do{const s=await this.list({...t,cursor:e});for(const n of s.events)yield n;e=s.nextCursor??void 0}while(e)}}export{c as Events};

package/dist/resources/files.d.ts

@@ -0,0 +1,35 @@
+import type { Client } from "../core/client/index.js";
+export declare const PUBLISH_FROM: readonly ["text", "md", "html"];
+export declare const PUBLISH_TO: readonly ["md", "html", "txt", "pdf"];
+export type PublishFrom = (typeof PUBLISH_FROM)[number];
+export type PublishTo = (typeof PUBLISH_TO)[number];
+export interface PublishInput {
+    projectId: string;
+    content: string;
+    from: PublishFrom;
+    to: PublishTo;
+    /** The file's name without its extension; `document` when unset. */
+    name?: string;
+}
+/** A file the app rendered and stored, and the public URL it answers on. */
+export interface PublishedFile {
+    id: string;
+    name: string;
+    type: string;
+    bytes: number;
+    key: string;
+    url: string;
+}
+/**
+ * Files the app renders from content and stores for anyone with the link.
+ *
+ * An API key publishes into the one project it is pinned to. Nothing is read
+ * back through here: a published file is public, so its URL is the way in.
+ */
+export declare class Files {
+    private readonly client;
+    constructor(client: Client);
+    publish(body: PublishInput): Promise<{
+        file: PublishedFile;
+    }>;
+}

package/dist/resources/files.js

@@ -0,0 +1 @@
+const e=["text","md","html"],i=["md","html","txt","pdf"];class l{client;constructor(t){this.client=t}publish(t){return this.client.post("/api/v1/files",t)}}export{l as Files,e as PUBLISH_FROM,i as PUBLISH_TO};

package/dist/resources/index.d.ts

@@ -5,6 +5,8 @@ export { Cli } from "./cli.js";
 export { Credentials } from "./credentials.js";
 export type { EventsPage, EventsQuery, UsageEventRow } from "./events.js";
 export { Events } from "./events.js";
+export type { PublishedFile, PublishFrom, PublishInput, PublishTo } from "./files.js";
+export { Files, PUBLISH_FROM, PUBLISH_TO } from "./files.js";
 export type { IngestResult, Sender, UsageEvent } from "./ingest.js";
 export { Ingest, MAX_EVENTS } from "./ingest.js";
 export type { ApiKeyRow } from "./keys.js";
@@ -17,7 +19,7 @@ export { Invites, Projects } from "./projects.js";
 export type { DatasetCase, PromptBlock, RenderedMessage, ReportRolloutInput, Role, RunPromptInput, SavePromptInput, Scoped, } from "./prompts.js";
 export { Prompts } from "./prompts.js";
 export { PromptsAdmin } from "./prompts-admin.js";
-export type { SaveToolInput, ToolEffect, ToolRow } from "./tools.js";
-export { Tools } from "./tools.js";
 export type { ModelRow, RangeQuery, Summary, Timeseries, TimeseriesPoint, Totals, } from "./stats.js";
 export { Stats } from "./stats.js";
+export type { SaveToolInput, ToolEffect, ToolRow } from "./tools.js";
+export { Tools } from "./tools.js";

package/dist/resources/index.js

@@ -1,13 +1 @@
-export { Alerts } from "./alerts.js";
-export { Cli } from "./cli.js";
-export { Credentials } from "./credentials.js";
-export { Events } from "./events.js";
-export { Ingest, MAX_EVENTS } from "./ingest.js";
-export { Keys } from "./keys.js";
-export { Playground } from "./playground.js";
-export { Models, Pricing } from "./pricing.js";
-export { Invites, Projects } from "./projects.js";
-export { Prompts } from "./prompts.js";
-export { PromptsAdmin } from "./prompts-admin.js";
-export { Tools } from "./tools.js";
-export { Stats } from "./stats.js";
+import{Alerts as e}from"./alerts.js";import{Cli as m}from"./cli.js";import{Credentials as f}from"./credentials.js";import{Events as s}from"./events.js";import{Files as l,PUBLISH_FROM as n,PUBLISH_TO as P}from"./files.js";import{Ingest as I,MAX_EVENTS as S}from"./ingest.js";import{Keys as g}from"./keys.js";import{Playground as E}from"./playground.js";import{Models as T,Pricing as _}from"./pricing.js";import{Invites as v,Projects as y}from"./projects.js";import{Prompts as C}from"./prompts.js";import{PromptsAdmin as H}from"./prompts-admin.js";import{Stats as O}from"./stats.js";import{Tools as j}from"./tools.js";export{e as Alerts,m as Cli,f as Credentials,s as Events,l as Files,I as Ingest,v as Invites,g as Keys,S as MAX_EVENTS,T as Models,n as PUBLISH_FROM,P as PUBLISH_TO,E as Playground,_ as Pricing,y as Projects,C as Prompts,H as PromptsAdmin,O as Stats,j as Tools};

package/dist/resources/ingest.js

@@ -1,27 +1 @@
-export const MAX_EVENTS = 100;
-export class Ingest {
-    client;
-    project;
-    constructor(client, project) {
-        this.client = client;
-        this.project = project;
-    }
-    async send(events) {
-        await this.report(events);
-    }
-    async report(events) {
-        const total = { accepted: 0, rejected: 0, unpricedModels: [] };
-        if (events.length === 0)
-            return total;
-        const unpriced = new Set();
-        for (let i = 0; i < events.length; i += MAX_EVENTS) {
-            const res = await this.client.post("/api/v1/ingest", { events: events.slice(i, i + MAX_EVENTS) }, { project: this.project });
-            total.accepted += res?.accepted ?? 0;
-            total.rejected += res?.rejected ?? 0;
-            for (const model of res?.unpricedModels ?? [])
-                unpriced.add(model);
-        }
-        total.unpricedModels = [...unpriced];
-        return total;
-    }
-}
+const i=100;class p{client;project;constructor(c,e){this.client=c,this.project=e}async send(c){await this.report(c)}async report(c){const e={accepted:0,rejected:0,unpricedModels:[]};if(c.length===0)return e;const r=new Set,o=c.map(t=>({...t,eventId:t.eventId??crypto.randomUUID()}));for(let t=0;t<o.length;t+=100){const n=await this.client.post("/api/v1/ingest",{events:o.slice(t,t+100)},{project:this.project});e.accepted+=n?.accepted??0,e.rejected+=n?.rejected??0;for(const s of n?.unpricedModels??[])r.add(s)}return e.unpricedModels=[...r],e}}export{p as Ingest,i as MAX_EVENTS};

package/dist/resources/keys.js

@@ -1,15 +1 @@
-export class Keys {
-    client;
-    constructor(client) {
-        this.client = client;
-    }
-    list(query = {}) {
-        return this.client.get("/api/v1/keys", { ...query });
-    }
-    create(body) {
-        return this.client.post("/api/v1/keys", body);
-    }
-    revoke(keyId) {
-        return this.client.delete(`/api/v1/keys/${encodeURIComponent(keyId)}`);
-    }
-}
+class i{client;constructor(e){this.client=e}list(e={}){return this.client.get("/api/v1/keys",{...e})}create(e){return this.client.post("/api/v1/keys",e)}revoke(e){return this.client.delete(`/api/v1/keys/${encodeURIComponent(e)}`)}}export{i as Keys};

package/dist/resources/playground.js

@@ -1,9 +1 @@
-export class Playground {
-    client;
-    constructor(client) {
-        this.client = client;
-    }
-    run(body) {
-        return this.client.post("/api/v1/playground/run", body);
-    }
-}
+class r{client;constructor(t){this.client=t}run(t){return this.client.post("/api/v1/playground/run",t)}}export{r as Playground};

package/dist/resources/pricing.js

@@ -1,36 +1 @@
-export class Pricing {
-    client;
-    constructor(client) {
-        this.client = client;
-    }
-    list() {
-        return this.client.get("/api/v1/pricing");
-    }
-    override(model, body) {
-        return this.client.put(`/api/v1/pricing/${encodeURIComponent(model)}`, body);
-    }
-    coverage() {
-        return this.client.get("/api/v1/pricing/coverage");
-    }
-    readiness() {
-        return this.client.get("/api/v1/pricing/readiness");
-    }
-    sync(body = {}) {
-        return this.client.post("/api/v1/pricing/sync", body);
-    }
-}
-export class Models {
-    client;
-    constructor(client) {
-        this.client = client;
-    }
-    list(query = {}) {
-        return this.client.get("/api/v1/models", { ...query });
-    }
-    offers(query = {}) {
-        return this.client.get("/api/v1/offers", { ...query });
-    }
-    compare(query = {}) {
-        return this.client.get("/api/v1/compare", { ...query });
-    }
-}
+class r{client;constructor(e){this.client=e}list(){return this.client.get("/api/v1/pricing")}override(e,t){return this.client.put(`/api/v1/pricing/${encodeURIComponent(e)}`,t)}coverage(){return this.client.get("/api/v1/pricing/coverage")}readiness(){return this.client.get("/api/v1/pricing/readiness")}sync(e={}){return this.client.post("/api/v1/pricing/sync",e)}}class n{client;constructor(e){this.client=e}list(e={}){return this.client.get("/api/v1/models",{...e})}offers(e={}){return this.client.get("/api/v1/offers",{...e})}compare(e={}){return this.client.get("/api/v1/compare",{...e})}}export{n as Models,r as Pricing};

package/dist/resources/projects.js

@@ -1,49 +1 @@
-export class Projects {
-    client;
-    constructor(client) {
-        this.client = client;
-    }
-    list() {
-        return this.client.get("/api/v1/projects");
-    }
-    create(body) {
-        return this.client.post("/api/v1/projects", body);
-    }
-    budget(projectId) {
-        return this.client.get(`/api/v1/projects/${encodeURIComponent(projectId)}/budget`);
-    }
-    setBudget(projectId, body) {
-        return this.client.put(`/api/v1/projects/${encodeURIComponent(projectId)}/budget`, body);
-    }
-    members(projectId) {
-        return this.client.get(`/api/v1/projects/${encodeURIComponent(projectId)}/members`);
-    }
-    addMember(projectId, body) {
-        return this.client.post(`/api/v1/projects/${encodeURIComponent(projectId)}/members`, body);
-    }
-    removeMember(projectId, userId) {
-        return this.client.delete(`/api/v1/projects/${encodeURIComponent(projectId)}/members`, {
-            userId,
-        });
-    }
-    invite(projectId, body) {
-        return this.client.post(`/api/v1/projects/${encodeURIComponent(projectId)}/invites`, body);
-    }
-    revokeInvite(projectId, inviteId) {
-        return this.client.delete(`/api/v1/projects/${encodeURIComponent(projectId)}/invites`, {
-            inviteId,
-        });
-    }
-}
-export class Invites {
-    client;
-    constructor(client) {
-        this.client = client;
-    }
-    preview(token) {
-        return this.client.get("/api/v1/invites/accept", { token });
-    }
-    accept(token) {
-        return this.client.post("/api/v1/invites/accept", { token });
-    }
-}
+class i{client;constructor(e){this.client=e}list(){return this.client.get("/api/v1/projects")}create(e){return this.client.post("/api/v1/projects",e)}budget(e){return this.client.get(`/api/v1/projects/${encodeURIComponent(e)}/budget`)}setBudget(e,t){return this.client.put(`/api/v1/projects/${encodeURIComponent(e)}/budget`,t)}members(e){return this.client.get(`/api/v1/projects/${encodeURIComponent(e)}/members`)}addMember(e,t){return this.client.post(`/api/v1/projects/${encodeURIComponent(e)}/members`,t)}removeMember(e,t){return this.client.delete(`/api/v1/projects/${encodeURIComponent(e)}/members`,{userId:t})}invite(e,t){return this.client.post(`/api/v1/projects/${encodeURIComponent(e)}/invites`,t)}revokeInvite(e,t){return this.client.delete(`/api/v1/projects/${encodeURIComponent(e)}/invites`,{inviteId:t})}}class r{client;constructor(e){this.client=e}preview(e){return this.client.get("/api/v1/invites/accept",{token:e})}accept(e){return this.client.post("/api/v1/invites/accept",{token:e})}}export{r as Invites,i as Projects};

package/dist/resources/prompts-admin.js

@@ -1,21 +1 @@
-export class PromptsAdmin {
-    client;
-    constructor(client) {
-        this.client = client;
-    }
-    publish(promptId, body = {}) {
-        return this.client.post(`/api/v1/prompts/${encodeURIComponent(promptId)}/publish`, body);
-    }
-    archive(promptId, query = {}) {
-        return this.client.post(`/api/v1/prompts/${encodeURIComponent(promptId)}/archive`, {}, { ...query });
-    }
-    assay(promptId, body) {
-        return this.client.post(`/api/v1/prompts/${encodeURIComponent(promptId)}/assay`, body);
-    }
-    runs(query = {}) {
-        return this.client.get("/api/v1/prompts/runs", { ...query });
-    }
-    run(runId) {
-        return this.client.get(`/api/v1/prompts/runs/${encodeURIComponent(runId)}`);
-    }
-}
+class s{client;constructor(t){this.client=t}publish(t,n={}){return this.client.post(`/api/v1/prompts/${encodeURIComponent(t)}/publish`,n)}archive(t,n={}){return this.client.post(`/api/v1/prompts/${encodeURIComponent(t)}/archive`,{},{...n})}assay(t,n){return this.client.post(`/api/v1/prompts/${encodeURIComponent(t)}/assay`,n)}runs(t={}){return this.client.get("/api/v1/prompts/runs",{...t})}run(t){return this.client.get(`/api/v1/prompts/runs/${encodeURIComponent(t)}`)}}export{s as PromptsAdmin};

package/dist/resources/prompts.d.ts

@@ -1,8 +1,20 @@
 import type { Client } from "../core/client/index.js";
-export type Role = "system" | "user" | "assistant";
+/**
+ * A turn as a rollout records it.
+ *
+ * `tool` is here because a conversation that used tools is not three roles
+ * pretending to be two. Narrating a result into a `user` message kept the words
+ * and lost the fact — and it misled the one reader that cared: the summary
+ * takes the last user message as the question when a prompt names no
+ * `question` field, so a tool-using run was captioned with whatever the tool
+ * said back.
+ */
+export type Role = "system" | "user" | "assistant" | "tool";
 export interface RenderedMessage {
     role: Role;
     content: string;
+    /** Which tool answered, on a `tool` turn. Absent on the other three. */
+    name?: string;
 }
 export interface PromptBlock {
     title?: string;

package/dist/resources/prompts.js

@@ -1,49 +1 @@
-export class Prompts {
-    client;
-    constructor(client) {
-        this.client = client;
-    }
-    list(query = {}) {
-        return this.client.get("/api/v1/prompts", { ...query });
-    }
-    create(body) {
-        return this.client.post("/api/v1/prompts", body);
-    }
-    get(promptId, query = {}) {
-        return this.client.get(`/api/v1/prompts/${encodeURIComponent(promptId)}`, { ...query });
-    }
-    update(promptId, body, query = {}) {
-        return this.client.put(`/api/v1/prompts/${encodeURIComponent(promptId)}`, body, { ...query });
-    }
-    versions(promptId, query = {}) {
-        return this.client.get(`/api/v1/prompts/${encodeURIComponent(promptId)}/versions`, {
-            ...query,
-        });
-    }
-    promote(promptId, versionId, query = {}) {
-        return this.client.post(`/api/v1/prompts/${encodeURIComponent(promptId)}/versions`, { versionId }, { ...query });
-    }
-    cases(promptId, query = {}) {
-        return this.client.get(`/api/v1/prompts/${encodeURIComponent(promptId)}/cases`, {
-            ...query,
-        });
-    }
-    putCases(promptId, cases, query = {}) {
-        return this.client.put(`/api/v1/prompts/${encodeURIComponent(promptId)}/cases`, { cases }, { ...query });
-    }
-    rollouts(promptId, query = {}) {
-        return this.client.get(`/api/v1/prompts/${encodeURIComponent(promptId)}/rollouts`, {
-            ...query,
-        });
-    }
-    report(promptId, body, query = {}) {
-        return this.client.post(`/api/v1/prompts/${encodeURIComponent(promptId)}/rollouts`, body, {
-            ...query,
-        });
-    }
-    run(promptId, body, query = {}) {
-        return this.client.post(`/api/v1/prompts/${encodeURIComponent(promptId)}/run`, body, {
-            ...query,
-        });
-    }
-}
+class p{client;constructor(t){this.client=t}list(t={}){return this.client.get("/api/v1/prompts",{...t})}create(t){return this.client.post("/api/v1/prompts",t)}get(t,e={}){return this.client.get(`/api/v1/prompts/${encodeURIComponent(t)}`,{...e})}update(t,e,o={}){return this.client.put(`/api/v1/prompts/${encodeURIComponent(t)}`,e,{...o})}versions(t,e={}){return this.client.get(`/api/v1/prompts/${encodeURIComponent(t)}/versions`,{...e})}promote(t,e,o={}){return this.client.post(`/api/v1/prompts/${encodeURIComponent(t)}/versions`,{versionId:e},{...o})}cases(t,e={}){return this.client.get(`/api/v1/prompts/${encodeURIComponent(t)}/cases`,{...e})}putCases(t,e,o={}){return this.client.put(`/api/v1/prompts/${encodeURIComponent(t)}/cases`,{cases:e},{...o})}rollouts(t,e={}){return this.client.get(`/api/v1/prompts/${encodeURIComponent(t)}/rollouts`,{...e})}report(t,e,o={}){return this.client.post(`/api/v1/prompts/${encodeURIComponent(t)}/rollouts`,e,{...o})}run(t,e,o={}){return this.client.post(`/api/v1/prompts/${encodeURIComponent(t)}/run`,e,{...o})}}export{p as Prompts};

package/dist/resources/stats.js

@@ -1,21 +1 @@
-export class Stats {
-    client;
-    constructor(client) {
-        this.client = client;
-    }
-    summary(query = {}) {
-        return this.client.get("/api/v1/stats/summary", { ...query });
-    }
-    timeseries(query = {}) {
-        return this.client.get("/api/v1/stats/timeseries", { ...query });
-    }
-    byModel(query = {}) {
-        return this.client.get("/api/v1/stats/by-model", { ...query });
-    }
-    byKey(query = {}) {
-        return this.client.get("/api/v1/stats/by-key", { ...query });
-    }
-    byTag(query = {}) {
-        return this.client.get("/api/v1/stats/by-tag", { ...query });
-    }
-}
+class s{client;constructor(t){this.client=t}summary(t={}){return this.client.get("/api/v1/stats/summary",{...t})}timeseries(t={}){return this.client.get("/api/v1/stats/timeseries",{...t})}byModel(t={}){return this.client.get("/api/v1/stats/by-model",{...t})}byKey(t={}){return this.client.get("/api/v1/stats/by-key",{...t})}byTag(t={}){return this.client.get("/api/v1/stats/by-tag",{...t})}}export{s as Stats};

package/dist/resources/tools.d.ts

@@ -1,5 +1,5 @@
-import type { FieldSpec } from "../schema/index.js";
 import type { Client } from "../core/client/index.js";
+import type { FieldSpec } from "../schema/index.js";
 import type { Scoped } from "./prompts.js";
 /** What calling a tool does outside the process. Null means nobody has said. */
 export type ToolEffect = "readonly" | "idempotent" | "destructive";

package/dist/resources/tools.js

@@ -1,21 +1 @@
-export class Tools {
-    client;
-    constructor(client) {
-        this.client = client;
-    }
-    list(query = {}) {
-        return this.client.get("/api/v1/tools", { ...query });
-    }
-    get(name, query = {}) {
-        return this.client.get(`/api/v1/tools/${encodeURIComponent(name)}`, { ...query });
-    }
-    create(body) {
-        return this.client.post("/api/v1/tools", body);
-    }
-    update(id, body, query = {}) {
-        return this.client.patch(`/api/v1/tools/${encodeURIComponent(id)}`, body, { ...query });
-    }
-    archive(id, archived, query = {}) {
-        return this.client.post(`/api/v1/tools/${encodeURIComponent(id)}/archive`, { archived }, { ...query });
-    }
-}
+class i{client;constructor(t){this.client=t}list(t={}){return this.client.get("/api/v1/tools",{...t})}get(t,e={}){return this.client.get(`/api/v1/tools/${encodeURIComponent(t)}`,{...e})}create(t){return this.client.post("/api/v1/tools",t)}update(t,e,o={}){return this.client.patch(`/api/v1/tools/${encodeURIComponent(t)}`,e,{...o})}archive(t,e,o={}){return this.client.post(`/api/v1/tools/${encodeURIComponent(t)}/archive`,{archived:e},{...o})}}export{i as Tools};

package/dist/rollout/index.d.ts

@@ -1 +1,2 @@
 export type { RolloutInput, RolloutRecord, RolloutStep } from "./rollout.js";
+export { totalTokens } from "./rollout.js";

package/dist/rollout/index.js

@@ -1 +1 @@
-export {};
+import{totalTokens as e}from"./rollout.js";export{e as totalTokens};

package/dist/rollout/rollout.d.ts

@@ -21,8 +21,37 @@ export interface RolloutStep {
     error?: string;
     inputTokens?: number;
     outputTokens?: number;
+    /**
+     * The four counts a provider bills apart from input and output.
+     *
+     * Optional and usually absent: most steps are a tool call, which has no
+     * tokens at all. A step that made a model call and left them off is saying
+     * the reply did not carry them — which is not the same as a workload that
+     * used no cache, and is why a rollup leaves the key out rather than adding a
+     * zero. The write is billed at a premium and the read at a discount, so a
+     * total built from the first two alone is wrong in both directions at once.
+     */
+    cacheReadTokens?: number;
+    cacheWriteTokens?: number;
+    citationTokens?: number;
+    reasoningTokens?: number;
     latencyMs?: number;
 }
+/** The counts beyond input and output, in the order a report reads them. */
+declare const EXTRA: readonly ["cacheReadTokens", "cacheWriteTokens", "citationTokens", "reasoningTokens"];
+type Extra = (typeof EXTRA)[number];
+/**
+ * What every step in a rollout adds up to.
+ *
+ * Here rather than in each caller for the reason `RolloutStep` is: a second
+ * copy is how two capabilities end up disagreeing about what a run cost. They
+ * had — one guarded the counts and one did not, so the same nested steps
+ * totalled a number in a graph run and `NaN` in a refine loop.
+ */
+export declare function totalTokens(steps: RolloutStep[]): {
+    inputTokens: number;
+    outputTokens: number;
+} & Partial<Record<Extra, number>>;
 /** What a caller hands back after running something itself. */
 export interface RolloutInput {
     /** Dedupe key. Generated if omitted; supply your own to make a retry safe. */
@@ -73,3 +102,4 @@ export interface RolloutRecord {
     inputTokens: number;
     outputTokens: number;
 }
+export {};

package/dist/rollout/rollout.js

@@ -1 +1 @@
-export {};
+const c=["cacheReadTokens","cacheWriteTokens","citationTokens","reasoningTokens"];function s(n){return typeof n!="number"||!Number.isFinite(n)||n<0?0:Math.trunc(n)}function u(n){let i=0,r=0;const o={};for(const t of n){i+=s(t.inputTokens),r+=s(t.outputTokens);for(const e of c)t[e]!==void 0&&(o[e]=(o[e]??0)+s(t[e]))}return{inputTokens:i,outputTokens:r,...o}}export{u as totalTokens};

package/dist/schema/index.d.ts

@@ -1,3 +1,3 @@
 export { serializeFields } from "./serialize/index.js";
 export type { FieldSpec, FieldType } from "./types/index.js";
-export { type FieldError, FieldValidationError, validateFields } from "./validate/index.js";
+export { type FieldError, FieldValidationError, isMissing, toBoolean, toNumber, validateFields, } from "./validate/index.js";

package/dist/schema/index.js

@@ -1,2 +1 @@
-export { serializeFields } from "./serialize/index.js";
-export { FieldValidationError, validateFields } from "./validate/index.js";
+import{serializeFields as o}from"./serialize/index.js";import{FieldValidationError as l,isMissing as a,toBoolean as s,toNumber as t,validateFields as d}from"./validate/index.js";export{l as FieldValidationError,a as isMissing,o as serializeFields,s as toBoolean,t as toNumber,d as validateFields};

package/dist/schema/serialize/index.js

@@ -1 +1 @@
-export { serializeFields } from "./serialize.js";
+import{serializeFields as r}from"./serialize.js";export{r as serializeFields};