sentinelayer-cli 0.18.0 → 0.18.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sentinelayer-cli",
-  "version": "0.18.0",
+  "version": "0.18.1",
   "description": "Scaffold Sentinelayer spec/prompt/guide artifacts with secure browser auth and token bootstrap.",
   "type": "module",
   "scripts": {

package/src/session/pricing-ledger.js

@@ -6,6 +6,14 @@ import {
 } from "../cost/tracker.js";
 
 const SESSION_USAGE_EVENT = "session_usage";
+export const BILLING_SESSION_USAGE_SCHEMA = "billing/v1";
+export const LOCAL_SESSION_USAGE_SCHEMA = "session_usage/local-v1";
+const LEGACY_SESSION_USAGE_SCHEMAS = new Set(["", "session_usage/v0"]);
+const SUPPORTED_SESSION_USAGE_SCHEMAS = new Set([
+  BILLING_SESSION_USAGE_SCHEMA,
+  LOCAL_SESSION_USAGE_SCHEMA,
+  ...LEGACY_SESSION_USAGE_SCHEMAS,
+]);
 
 function n(value) {
   return String(value == null ? "" : value).trim();
@@ -104,6 +112,9 @@ export function buildUsageLedgerEntry(
   if (kind !== SESSION_USAGE_EVENT) return null;
 
   const payload = object(event?.payload);
+  const schema = n(payload.schema);
+  if (!SUPPORTED_SESSION_USAGE_SCHEMAS.has(schema)) return null;
+
   const usage = object(payload.usage);
   const prompt = object(payload.prompt);
   const response = object(payload.response);
@@ -157,6 +168,7 @@ export function buildUsageLedgerEntry(
   return {
     ledgerEntryId,
     idempotencyKey,
+    schema: schema || "legacy",
     sessionId: n(sessionId),
     agentId,
     action,

package/src/session/usage.js

@@ -1,13 +1,20 @@
 /**
- * Session usage emitter — records every LLM interaction inside a session
- * as a `session_usage` event so consumers (web dashboard, transcript
- * download, telemetry sync) can surface live, accurate token + cost
- * counters per-agent + session-wide.
+ * Session usage emitter — records local transcript/live-stats LLM
+ * interactions inside a session as `session_usage` events so consumers
+ * (web dashboard, transcript download, local recap) can surface live token
+ * + cost counters per-agent + session-wide.
  *
  * Senti orchestrator philosophy: "tokens on point every time any LLM
  * interacts." Every persona / Jules / Codex / Claude call inside a
  * session should land here so the running tally is authoritative.
  *
+ * Important contract split: this module is NOT the API billing ledger.
+ * API-durable billable rows must go through `src/billing/session-usage.js`
+ * and emit `payload.schema = "billing/v1"` with the API-supported price
+ * book. This module emits `session_usage/local-v1`, which is intentionally
+ * ignored by API quota/billing projection while still remaining visible in
+ * transcripts and local aggregate counters.
+ *
  * Event shape:
  *
  *   {
@@ -44,6 +51,7 @@ import { createAgentEvent } from "../events/schema.js";
 import { estimateModelCost } from "../cost/tracker.js";
 import {
   DEFAULT_PRICE_BOOK_VERSION,
+  LOCAL_SESSION_USAGE_SCHEMA,
   buildSessionUsageLedger,
   createSessionUsageLedgerId,
 } from "./pricing-ledger.js";
@@ -158,6 +166,7 @@ export async function emitLLMInteraction(
   const responseText = clipText(response);
 
   const payload = {
+    schema: LOCAL_SESSION_USAGE_SCHEMA,
     interactionId: id,
     idempotencyKey: id,
     ledgerEntryId,