@pipelex/sdk 0.16.0 → 0.18.0

package/dist/usage.js

@@ -0,0 +1,121 @@
+/**
+ * Fold a run's usage pair into one summary: run totals, the call count, the assembly error and
+ * a per-pipe rollup. See `docs/run-usage.md` for the rules it applies.
+ *
+ * Pre-contract records, relayed verbatim from artifacts written before the usage contract,
+ * carry no `cost` and no `pipe_code`: they count as unrated and unattributed. The legacy
+ * `job_metadata` / `unit_costs` fields are relics and are never read.
+ */
+export function summarizeUsage(results) {
+    const records = results.tokens_usages;
+    const assemblyError = results.usage_assembly_error ?? null;
+    if (records == null) {
+        return {
+            state: "unavailable",
+            total_cost_usd: null,
+            cost_partial: false,
+            tokens: { input: null, output: null },
+            calls: 0,
+            assembly_error: assemblyError,
+            by_pipe: [],
+        };
+    }
+    if (records.length === 0) {
+        return {
+            state: "no_inference",
+            total_cost_usd: 0,
+            cost_partial: false,
+            tokens: { input: 0, output: 0 },
+            calls: 0,
+            assembly_error: assemblyError,
+            by_pipe: [],
+        };
+    }
+    return {
+        state: "records",
+        ...foldRecords(records),
+        calls: records.length,
+        assembly_error: assemblyError,
+        by_pipe: rollUpByPipe(records),
+    };
+}
+/** Null-aware totals over a non-empty set of records. */
+function foldRecords(records) {
+    let pricedSum = 0;
+    let anyPriced = false;
+    let anyUnrated = false;
+    let inputSum = null;
+    let outputSum = null;
+    for (const record of records) {
+        // `typeof` rather than `!= null`: artifacts are relayed unvalidated, and a non-numeric `cost`
+        // on a malformed one must count as unrated, not turn the sum into string concatenation.
+        if (typeof record.cost === "number") {
+            pricedSum += record.cost;
+            anyPriced = true;
+        }
+        else {
+            anyUnrated = true;
+        }
+        const byCategory = record.nb_tokens_by_category;
+        if (byCategory != null) {
+            // Only the two joined totals are additive; every other category is a subset of one.
+            const input = byCategory["input"];
+            const output = byCategory["output"];
+            if (typeof input === "number")
+                inputSum = (inputSum ?? 0) + input;
+            if (typeof output === "number")
+                outputSum = (outputSum ?? 0) + output;
+        }
+    }
+    return {
+        total_cost_usd: anyPriced ? pricedSum : null,
+        cost_partial: anyPriced && anyUnrated,
+        tokens: { input: inputSum, output: outputSum },
+    };
+}
+/** Group the records by `pipe_code` (a `null` key gathers the unattributed calls) and sort. */
+function rollUpByPipe(records) {
+    const groups = new Map();
+    for (const record of records) {
+        const pipeCode = typeof record.pipe_code === "string" ? record.pipe_code : null;
+        const group = groups.get(pipeCode);
+        if (group === undefined) {
+            groups.set(pipeCode, [record]);
+        }
+        else {
+            group.push(record);
+        }
+    }
+    const rows = [];
+    for (const [pipeCode, pipeRecords] of groups) {
+        const fold = foldRecords(pipeRecords);
+        rows.push({
+            pipe_code: pipeCode,
+            total_cost_usd: fold.total_cost_usd,
+            cost_partial: fold.cost_partial,
+            tokens: fold.tokens,
+            calls: pipeRecords.length,
+        });
+    }
+    return rows.sort(comparePipeRows);
+}
+/** Cost descending with unrated pipes last, then calls descending, then pipe code (null last). */
+function comparePipeRows(a, b) {
+    if (a.total_cost_usd !== b.total_cost_usd) {
+        if (a.total_cost_usd === null)
+            return 1;
+        if (b.total_cost_usd === null)
+            return -1;
+        return b.total_cost_usd - a.total_cost_usd;
+    }
+    if (a.calls !== b.calls)
+        return b.calls - a.calls;
+    if (a.pipe_code === b.pipe_code)
+        return 0;
+    if (a.pipe_code === null)
+        return 1;
+    if (b.pipe_code === null)
+        return -1;
+    return a.pipe_code < b.pipe_code ? -1 : 1;
+}
+//# sourceMappingURL=usage.js.map

package/dist/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../src/usage.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipelex/sdk",
-  "version": "0.16.0",
+  "version": "0.18.0",
   "description": "TypeScript SDK for the Pipelex hosted API — execute methods, manage runs, and call the product surface.",
   "license": "MIT",
   "repository": {
@@ -59,7 +59,8 @@
     "vitest": "^4.0.18"
   },
   "dependencies": {
-    "mthds": "^0.24.0",
-    "smol-toml": "^1.6.0"
+    "mthds": "^0.25.0",
+    "smol-toml": "^1.6.0",
+    "undici": "^7.29.1"
   }
 }