@shield-agent/kya 0.1.8 → 0.1.10

package/dist/showback/cost-per-task.js

@@ -0,0 +1,187 @@
+/**
+ * Cost-per-task showback (observe only). Not a PEP. Not a billing meter.
+ * Subagents are nested steps on one run (parentRunId), not extra registry seats.
+ */
+import { estimateRequestUsd } from "./rates.js";
+export const SHOWBACK_DISCLAIMER = "Estimate from published list prices. Not a billing meter. Not a PEP.";
+function nonNeg(n) {
+    if (typeof n !== "number" || !Number.isFinite(n) || n < 0)
+        return 0;
+    return Math.floor(n);
+}
+function requestCost(rec) {
+    const retries = nonNeg(rec.retries);
+    const multiplier = 1 + retries;
+    const one = estimateRequestUsd(rec.model, nonNeg(rec.tokensIn), nonNeg(rec.tokensOut), nonNeg(rec.reasoningTokens));
+    if (one === null)
+        return null;
+    return one * multiplier;
+}
+function requestTokens(rec) {
+    const retries = nonNeg(rec.retries);
+    const multiplier = 1 + retries;
+    return {
+        in: nonNeg(rec.tokensIn) * multiplier,
+        out: (nonNeg(rec.tokensOut) + nonNeg(rec.reasoningTokens)) * multiplier,
+        steps: multiplier,
+    };
+}
+function runKey(rec) {
+    if (rec.parentRunId && rec.parentRunId.trim())
+        return rec.parentRunId.trim();
+    if (rec.runId && rec.runId.trim())
+        return rec.runId.trim();
+    return `solo:${rec.agentId}`;
+}
+/**
+ * Roll usage into per-run and per-agent showback.
+ * Nested subagents share parentRunId and roll into that run's cost-per-task.
+ */
+export function buildShowback(records) {
+    const byRun = new Map();
+    for (const rec of records) {
+        if (!rec.agentId || !rec.agentId.trim())
+            continue;
+        const key = runKey(rec);
+        const tok = requestTokens(rec);
+        const usd = requestCost(rec);
+        let row = byRun.get(key);
+        if (!row) {
+            row = {
+                parentAgentId: rec.agentId,
+                tokensIn: 0,
+                tokensOut: 0,
+                usd: 0,
+                usdKnown: true,
+                steps: 0,
+                subagents: new Set(),
+            };
+            byRun.set(key, row);
+        }
+        if (rec.parentRunId) {
+            row.subagents.add(rec.agentId);
+        }
+        else {
+            row.parentAgentId = rec.agentId;
+        }
+        row.tokensIn += tok.in;
+        row.tokensOut += tok.out;
+        row.steps += tok.steps;
+        if (usd === null) {
+            row.usdKnown = false;
+        }
+        else if (row.usdKnown) {
+            row.usd = (row.usd ?? 0) + usd;
+        }
+    }
+    const perRun = [...byRun.entries()].map(([runId, row]) => ({
+        runId,
+        parentAgentId: row.parentAgentId,
+        tokensIn: row.tokensIn,
+        tokensOut: row.tokensOut,
+        estimatedUsd: row.usdKnown ? roundUsd(row.usd ?? 0) : null,
+        steps: row.steps,
+        subagentIds: [...row.subagents].sort(),
+    }));
+    perRun.sort((a, b) => a.runId.localeCompare(b.runId));
+    const byAgent = new Map();
+    for (const rec of records) {
+        if (!rec.agentId || !rec.agentId.trim())
+            continue;
+        const tok = requestTokens(rec);
+        const usd = requestCost(rec);
+        let row = byAgent.get(rec.agentId);
+        if (!row) {
+            row = { tokensIn: 0, tokensOut: 0, usd: 0, usdKnown: true, runs: new Set() };
+            byAgent.set(rec.agentId, row);
+        }
+        row.tokensIn += tok.in;
+        row.tokensOut += tok.out;
+        row.runs.add(runKey(rec));
+        if (usd === null)
+            row.usdKnown = false;
+        else if (row.usdKnown)
+            row.usd = (row.usd ?? 0) + usd;
+    }
+    const perAgent = [...byAgent.entries()].map(([agentId, row]) => ({
+        agentId,
+        tokensIn: row.tokensIn,
+        tokensOut: row.tokensOut,
+        estimatedUsd: row.usdKnown ? roundUsd(row.usd ?? 0) : null,
+        runs: row.runs.size,
+    }));
+    perAgent.sort((a, b) => a.agentId.localeCompare(b.agentId));
+    let totalIn = 0;
+    let totalOut = 0;
+    let totalUsd = 0;
+    let usdKnown = true;
+    for (const r of perRun) {
+        totalIn += r.tokensIn;
+        totalOut += r.tokensOut;
+        if (r.estimatedUsd === null)
+            usdKnown = false;
+        else
+            totalUsd += r.estimatedUsd;
+    }
+    return {
+        billingMeter: false,
+        disclaimer: SHOWBACK_DISCLAIMER,
+        totalTokensIn: totalIn,
+        totalTokensOut: totalOut,
+        estimatedUsd: usdKnown && perRun.length > 0 ? roundUsd(totalUsd) : perRun.length === 0 ? 0 : null,
+        perRun,
+        perAgent,
+    };
+}
+function roundUsd(n) {
+    return Math.round(n * 1_000_000) / 1_000_000;
+}
+export function parseUsageRecords(raw) {
+    if (!Array.isArray(raw)) {
+        throw new Error("usage must be an array");
+    }
+    if (raw.length > 500) {
+        throw new Error("usage exceeds 500 rows");
+    }
+    const out = [];
+    for (const item of raw) {
+        if (!item || typeof item !== "object")
+            continue;
+        const o = item;
+        const agentId = typeof o.agentId === "string" ? o.agentId : typeof o.agent_id === "string" ? o.agent_id : "";
+        if (!agentId.trim())
+            continue;
+        const tokensIn = num(o.tokensIn ?? o.tokens_in);
+        const tokensOut = num(o.tokensOut ?? o.tokens_out);
+        out.push({
+            agentId: agentId.trim(),
+            parentRunId: str(o.parentRunId ?? o.parent_run_id),
+            runId: str(o.runId ?? o.run_id),
+            model: str(o.model),
+            route: str(o.route),
+            environment: str(o.environment ?? o.env),
+            tokensIn,
+            tokensOut,
+            reasoningTokens: optionalNum(o.reasoningTokens ?? o.reasoning_tokens),
+            retries: optionalNum(o.retries),
+        });
+    }
+    return out;
+}
+function str(v) {
+    return typeof v === "string" && v.trim() ? v.trim() : undefined;
+}
+function num(v) {
+    if (typeof v === "number" && Number.isFinite(v))
+        return Math.max(0, Math.floor(v));
+    if (typeof v === "string" && v.trim() && Number.isFinite(Number(v))) {
+        return Math.max(0, Math.floor(Number(v)));
+    }
+    return 0;
+}
+function optionalNum(v) {
+    if (v === undefined || v === null || v === "")
+        return undefined;
+    return num(v);
+}
+//# sourceMappingURL=cost-per-task.js.map

package/dist/showback/cost-per-task.js.map

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

package/dist/showback/rates.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Published list-price estimates for display-only showback.
+ * Dated 2026-08-29. Not an invoice. Unknown models return null USD.
+ * Keep in lockstep with Java PublishedModelRates (same test vectors).
+ */
+export interface ModelRate {
+    readonly model: string;
+    /** USD per 1M input tokens */
+    readonly inputPer1M: number;
+    /** USD per 1M output tokens (reasoning billed as output when present) */
+    readonly outputPer1M: number;
+}
+/** Rates table as of 2026-08-29. Estimate only. */
+export declare const PUBLISHED_MODEL_RATES: readonly ModelRate[];
+export declare function lookupRate(model: string | undefined | null): ModelRate | null;
+/** USD for one request. Returns null when the model has no published rate. */
+export declare function estimateRequestUsd(model: string | undefined | null, tokensIn: number, tokensOut: number, reasoningTokens?: number): number | null;
+//# sourceMappingURL=rates.d.ts.map

package/dist/showback/rates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rates.d.ts","sourceRoot":"","sources":["../../src/showback/rates.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,yEAAyE;IACzE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,mDAAmD;AACnD,eAAO,MAAM,qBAAqB,EAAE,SAAS,SAAS,EAQrD,CAAC;AAMF,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAK7E;AAED,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAChC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,eAAe,SAAI,GAClB,MAAM,GAAG,IAAI,CAMf"}

package/dist/showback/rates.js

@@ -0,0 +1,34 @@
+/**
+ * Published list-price estimates for display-only showback.
+ * Dated 2026-08-29. Not an invoice. Unknown models return null USD.
+ * Keep in lockstep with Java PublishedModelRates (same test vectors).
+ */
+/** Rates table as of 2026-08-29. Estimate only. */
+export const PUBLISHED_MODEL_RATES = [
+    { model: "gpt-4o", inputPer1M: 2.5, outputPer1M: 10 },
+    { model: "gpt-4o-mini", inputPer1M: 0.15, outputPer1M: 0.6 },
+    { model: "claude-sonnet-4", inputPer1M: 3, outputPer1M: 15 },
+    { model: "claude-3-5-sonnet", inputPer1M: 3, outputPer1M: 15 },
+    { model: "claude-3-5-haiku", inputPer1M: 0.8, outputPer1M: 4 },
+    { model: "grok-4", inputPer1M: 3, outputPer1M: 15 },
+    { model: "grok-2", inputPer1M: 2, outputPer1M: 10 },
+];
+const byModel = new Map(PUBLISHED_MODEL_RATES.map((r) => [r.model.toLowerCase(), r]));
+export function lookupRate(model) {
+    if (!model)
+        return null;
+    const key = model.trim().toLowerCase();
+    if (!key)
+        return null;
+    return byModel.get(key) ?? null;
+}
+/** USD for one request. Returns null when the model has no published rate. */
+export function estimateRequestUsd(model, tokensIn, tokensOut, reasoningTokens = 0) {
+    const rate = lookupRate(model);
+    if (!rate)
+        return null;
+    const inTok = Math.max(0, tokensIn);
+    const outTok = Math.max(0, tokensOut) + Math.max(0, reasoningTokens);
+    return (inTok * rate.inputPer1M + outTok * rate.outputPer1M) / 1_000_000;
+}
+//# sourceMappingURL=rates.js.map

package/dist/showback/rates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rates.js","sourceRoot":"","sources":["../../src/showback/rates.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,mDAAmD;AACnD,MAAM,CAAC,MAAM,qBAAqB,GAAyB;IACzD,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,EAAE,EAAE,EAAE;IACrD,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE;IAC5D,EAAE,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE;IAC5D,EAAE,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE;IAC9D,EAAE,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,EAAE;IAC9D,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE;IACnD,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE;CACpD,CAAC;AAEF,MAAM,OAAO,GAAG,IAAI,GAAG,CACrB,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC,CAAU,CAAC,CACtE,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,KAAgC;IACzD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACvC,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;AAClC,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,kBAAkB,CAChC,KAAgC,EAChC,QAAgB,EAChB,SAAiB,EACjB,eAAe,GAAG,CAAC;IAEnB,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;IACrE,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,UAAU,GAAG,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC;AAC3E,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shield-agent/kya",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "Know Your Agent light CLI + local MCP gate (provider-agnostic, zero vertical packs required).",
   "license": "MIT",
   "type": "module",

package/server.json

@@ -7,12 +7,12 @@
     "url": "https://github.com/The-Pixel-Boys/shield-kya",
     "source": "github"
   },
-  "version": "0.1.8",
+  "version": "0.1.10",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@shield-agent/kya",
-      "version": "0.1.8",
+      "version": "0.1.10",
       "transport": {
         "type": "stdio"
       },