@frugalco/frugal-sdk-node 0.3.0 → 0.5.0

package/dist/otel.js

@@ -13,17 +13,37 @@ import { OTLPMetricExporter } from "@opentelemetry/exporter-metrics-otlp-proto";
 import { resourceFromAttributes } from "@opentelemetry/resources";
 import { AggregationType, ConsoleMetricExporter, MeterProvider, PeriodicExportingMetricReader, } from "@opentelemetry/sdk-metrics";
 import { emitLog } from "./debug.js";
-import { FRUGAL_COMPONENT, FRUGAL_CUSTOMER_ID, FRUGAL_PROJECT_ID, METRIC_CACHE_PREFIX_STABLE, METRIC_CACHE_READ_TOKENS, METRIC_CACHE_WRITE_TOKENS, METRIC_CALLS, METRIC_ERRORS, METRIC_FEW_SHOT_COUNT, METRIC_HISTORY_DEPTH, METRIC_NOISE_RATIO, METRIC_OPERATION_DURATION, METRIC_INTERNAL_ERRORS, METRIC_OUTPUT_CAP_UTILIZATION, METRIC_REASONING_TOKENS, METRIC_STRUCTURED_OUTPUT_HINT, METRIC_TOKEN_USAGE, } from "./semconv.js";
+import { FRUGAL_COMPONENT, FRUGAL_CUSTOMER_ID, FRUGAL_INSTRUMENT, FRUGAL_PROJECT_ID, METRIC_AGENT_TURNS, METRIC_CACHE_PREFIX_STABLE, METRIC_CACHE_READ_TOKENS, METRIC_CACHE_WRITE_TOKENS, METRIC_CALLS, METRIC_DUPLICATE_REQUESTS, METRIC_ERRORS, METRIC_FEW_SHOT_COUNT, METRIC_FEW_SHOT_TOKENS, METRIC_HISTORY_DEPTH, METRIC_NOISE_RATIO, METRIC_OPERATION_DURATION, METRIC_INTERNAL_ERRORS, METRIC_OUTPUT_CAP_UTILIZATION, METRIC_REASONING_TOKENS, METRIC_STRUCTURED_OUTPUT_HINT, METRIC_TOKEN_USAGE, } from "./semconv.js";
 const INSTRUMENTATION_NAME = "frugal-metrics";
 const INSTRUMENTATION_VERSION = "0.1.0";
+// The attribute OTel's metrics SDK stamps on the single merged series it
+// creates once an instrument exceeds its per-instrument attribute-set limit.
+// Deliberately a literal here rather than an import from semconv.ts: this is
+// OTel's own wire key, not a Frugal convention, and the detector below is the
+// only thing that reads it.
+const OTEL_METRIC_OVERFLOW = "otel.metric.overflow";
+// Effective "no limit" when FRUGAL_MAX_SERIES_PER_INSTRUMENT is 0 — the OTel
+// SDK has no explicit off switch, so we hand it a number no real deployment
+// reaches.
+export const UNLIMITED_SERIES_PER_INSTRUMENT = 1_000_000;
 let cached = null;
+// A build failure is cached exactly like a success. Configuration is read from
+// the environment once per process, so a build that failed will fail the same
+// way every time — and every retry constructs a MeterProvider whose reader
+// starts an export timer, leaking one per customer call. Remember the failure
+// and rethrow it; the wrappers already catch and fall through to the real
+// client call, so the customer sees a no-op SDK rather than a rebuild storm.
+let buildFailure = null;
 export function getInstruments(config) {
     if (cached !== null)
         return cached;
+    if (buildFailure !== null)
+        throw buildFailure.error;
     try {
         cached = buildInstruments(config);
     }
     catch (err) {
+        buildFailure = { error: err };
         emitLog("error", `failed to initialize metrics: ${errorMessage(err)}`);
         throw err;
     }
@@ -36,7 +56,24 @@ function errorMessage(err) {
 }
 function buildInstruments(config) {
     const reader = buildReader(config);
-    return buildFromReader(config, reader);
+    try {
+        return buildFromReader(config, reader);
+    }
+    catch (err) {
+        // The reader owns an export timer from the moment the MeterProvider
+        // registers it. Failing here (a bad resource, a meter that refuses an
+        // instrument) would otherwise strand that timer in the customer's process
+        // for its lifetime, exporting from a provider nobody holds a handle to.
+        try {
+            void reader.shutdown().catch(() => {
+                /* best effort */
+            });
+        }
+        catch {
+            /* best effort */
+        }
+        throw err;
+    }
 }
 export function buildFromReader(config, reader) {
     // service.name takes the customer suffix when configured, otherwise stays
@@ -77,6 +114,22 @@ export function buildFromReader(config, reader) {
                     },
                 },
             },
+            {
+                // Same reasoning as the operation-duration view above: OTel's default
+                // boundaries are tuned for durations, not integer turn counts, so a
+                // real agent run (typically 1–30 turns, occasionally more on long
+                // tool loops) would collapse into one or two buckets. These give
+                // visible spread across the realistic range.
+                instrumentName: METRIC_AGENT_TURNS,
+                aggregation: {
+                    type: AggregationType.EXPLICIT_BUCKET_HISTOGRAM,
+                    options: {
+                        boundaries: [
+                            1, 2, 3, 4, 5, 6, 8, 10, 12, 15, 20, 25, 30, 40, 50, 75, 100,
+                        ],
+                    },
+                },
+            },
         ],
     });
     const meter = provider.getMeter(INSTRUMENTATION_NAME, INSTRUMENTATION_VERSION);
@@ -107,6 +160,10 @@ export function buildFromReader(config, reader) {
             unit: "{token}",
             description: "Reasoning / extended thinking tokens billed at output rate.",
         }),
+        agentTurns: meter.createHistogram(METRIC_AGENT_TURNS, {
+            unit: "{turn}",
+            description: "Model-response turns completed by an agent invocation.",
+        }),
         errors: meter.createCounter(METRIC_ERRORS, {
             unit: "{error}",
             description: "Count of errors raised by AI client operations.",
@@ -131,6 +188,10 @@ export function buildFromReader(config, reader) {
             unit: "{example}",
             description: "Count of consecutive user/assistant pairs preceding the final user message in single-turn calls.",
         }),
+        fewShotTokens: meter.createHistogram(METRIC_FEW_SHOT_TOKENS, {
+            unit: "{token}",
+            description: "Approximate token size of the few-shot example block (the user/assistant pairs counted by few_shot_count).",
+        }),
         noiseRatio: meter.createHistogram(METRIC_NOISE_RATIO, {
             unit: "1",
             description: "Ratio of noise characters (HTML tags, base64 runs, large whitespace) to total input characters.",
@@ -139,6 +200,10 @@ export function buildFromReader(config, reader) {
             unit: "{call}",
             description: "Count of calls whose prompt asks for structured output in prose without using tools or response_format.",
         }),
+        duplicateRequests: meter.createCounter(METRIC_DUPLICATE_REQUESTS, {
+            unit: "{call}",
+            description: "Per-call request-duplication state (first_seen | repeat_seen) from a time-windowed signature filter.",
+        }),
     };
     return applyComponentFanout(raw, config.components);
 }
@@ -148,24 +213,32 @@ export function buildFromReader(config, reader) {
 // whole project (component absent) or split by component, with no double-count
 // of the project total. internalErrors is excluded — it's a process-level
 // diagnostic, not per-component attributable.
+// Every Instruments field is listed explicitly (no spread) so adding an
+// instrument without deciding its fanout behavior is a compile error, not a
+// silently missing per-component series.
 function applyComponentFanout(raw, components) {
     if (components.length === 0)
         return raw;
     return {
-        ...raw,
+        meterProvider: raw.meterProvider,
+        reader: raw.reader,
         operationDuration: fanoutHistogram(raw.operationDuration, components),
         tokenUsage: fanoutHistogram(raw.tokenUsage, components),
         calls: fanoutCounter(raw.calls, components),
         cacheReadTokens: fanoutHistogram(raw.cacheReadTokens, components),
         cacheWriteTokens: fanoutHistogram(raw.cacheWriteTokens, components),
         reasoningTokens: fanoutHistogram(raw.reasoningTokens, components),
+        agentTurns: fanoutHistogram(raw.agentTurns, components),
         errors: fanoutCounter(raw.errors, components),
+        internalErrors: raw.internalErrors,
         outputCapUtilization: fanoutHistogram(raw.outputCapUtilization, components),
         cachePrefixStable: fanoutCounter(raw.cachePrefixStable, components),
         historyDepth: fanoutHistogram(raw.historyDepth, components),
         fewShotCount: fanoutHistogram(raw.fewShotCount, components),
+        fewShotTokens: fanoutHistogram(raw.fewShotTokens, components),
         noiseRatio: fanoutHistogram(raw.noiseRatio, components),
         structuredOutputHint: fanoutCounter(raw.structuredOutputHint, components),
+        duplicateRequests: fanoutCounter(raw.duplicateRequests, components),
     };
 }
 function fanoutCounter(inner, components) {
@@ -188,7 +261,7 @@ function fanoutHistogram(inner, components) {
         },
     };
 }
-function buildReader(config) {
+export function buildReader(config) {
     const base = config.otlpEndpoint
         ? new OTLPMetricExporter({
             url: config.otlpEndpoint,
@@ -196,10 +269,75 @@ function buildReader(config) {
         })
         : new ConsoleMetricExporter();
     return new PeriodicExportingMetricReader({
-        exporter: wrapExporterForHealth(base),
+        exporter: wrapExporterForHealth(base, {
+            projectId: config.projectId,
+            customerId: config.customerId,
+        }),
         exportIntervalMillis: config.exportIntervalMs,
+        // Reader-level (`default`), NOT per-View: a per-View limit applies only to
+        // the instruments that View matches, so any instrument added later would
+        // silently sit at OTel's 2000-attribute-set default and start merging
+        // series into `otel.metric.overflow` without anyone changing config.
+        cardinalityLimits: {
+            default: config.maxSeriesPerInstrument > 0
+                ? config.maxSeriesPerInstrument
+                : UNLIMITED_SERIES_PER_INSTRUMENT,
+        },
     });
 }
+/**
+ * Walk exported metrics for data points OTel merged into its per-instrument
+ * overflow bucket, and return the de-duplicated, order-stable list of
+ * instrument names affected.
+ *
+ * Pure and total: runs on every export tick against SDK-shaped data we do not
+ * own, so every level is guarded and any surprise yields whatever was collected
+ * so far rather than an exception on the export path.
+ */
+export function scanForOverflow(metrics) {
+    const found = [];
+    const seen = new Set();
+    try {
+        const scopeMetrics = metrics?.scopeMetrics;
+        if (!Array.isArray(scopeMetrics))
+            return found;
+        for (const sm of scopeMetrics) {
+            const list = sm?.metrics;
+            if (!Array.isArray(list))
+                continue;
+            for (const metric of list) {
+                const name = metric?.descriptor?.name;
+                if (typeof name !== "string" || seen.has(name))
+                    continue;
+                const dataPoints = metric?.dataPoints;
+                if (!Array.isArray(dataPoints))
+                    continue;
+                for (const dp of dataPoints) {
+                    const attributes = dp?.attributes;
+                    if (!attributes || typeof attributes !== "object")
+                        continue;
+                    if (OTEL_METRIC_OVERFLOW in attributes) {
+                        seen.add(name);
+                        found.push(name);
+                        break;
+                    }
+                }
+            }
+        }
+    }
+    catch {
+        // Diagnostics must never break the export path.
+    }
+    return found;
+}
+/**
+ * The internal-errors counter, if instruments have been built. The health
+ * wrapper is constructed inside buildReader — before buildFromReader creates
+ * any instrument — so it can only resolve the counter lazily, per export.
+ */
+function internalErrorsCounterOrNull() {
+    return cached === null ? null : cached.internalErrors;
+}
 /**
  * Wrap an OTLP exporter so persistent export failures surface as a single
  * de-duped `error` debug callback. The periodic reader retries silently
@@ -209,11 +347,67 @@ function buildReader(config) {
  * one alert per failure run, not one per export tick.
  *
  * Delegates every other exporter method so behavior is otherwise unchanged.
+ *
+ * `identity` stamps frugal.project_id / frugal.customer_id onto the
+ * overflow-detection points below. Optional so tests (and any caller that only
+ * wants export-failure reporting) can wrap without a Config.
  */
-export function wrapExporterForHealth(exporter) {
+export function wrapExporterForHealth(exporter, identity) {
     let consecutiveFailures = 0;
+    // Per-wrapper (not global) so state lives and dies with the reader it was
+    // built for — no reset hook to remember in tests, and two readers never share
+    // a "already reported" memory. Both are bounded by the instrument count, so a
+    // permanently overflowing instrument yields one point, not one per tick.
+    //
+    // Two sets, not one: the wrapper is built inside buildReader, BEFORE any
+    // instrument exists, so the very first export can find no counter to add to.
+    // A single "reported" set would mark the instrument done on that export and
+    // the internal_errors point would never be emitted, even though the counter
+    // exists one tick later. `logged` retires the debug line immediately (it did
+    // fire); `counted` is only written once the counter add actually ran.
+    const logged = new Set();
+    const counted = new Set();
     return {
         export(metrics, resultCallback) {
+            // Diagnostics only: never alters control flow, never recurses (the
+            // counter increment lands in the NEXT collection cycle), and the export
+            // below runs exactly as before whatever happens here.
+            try {
+                for (const name of scanForOverflow(metrics)) {
+                    if (!logged.has(name)) {
+                        logged.add(name);
+                        emitLog("error", `OTel per-instrument cardinality limit exceeded on ${name}: further attribute sets are merged into a single {${OTEL_METRIC_OVERFLOW}: true} series with every other label dropped. Raise FRUGAL_MAX_SERIES_PER_INSTRUMENT, or lower FRUGAL_MAX_CALL_SITES / FRUGAL_MAX_MODELS.`, { [FRUGAL_INSTRUMENT]: name });
+                    }
+                    if (counted.has(name))
+                        continue;
+                    const counter = internalErrorsCounterOrNull();
+                    // No counter yet — leave the name uncounted so a later export, once
+                    // instruments exist, still lands the point.
+                    if (counter === null)
+                        continue;
+                    // Identity goes on the POINT, matching cardinality_cap_hit and
+                    // model_cap_hit: every product-side query scopes on the
+                    // frugal.project_id point label, so relying on the resource
+                    // attributes being flattened by OTLP ingest would drop these points
+                    // out of every dashboard.
+                    counter.add(1, {
+                        ...(identity?.customerId
+                            ? { [FRUGAL_CUSTOMER_ID]: identity.customerId }
+                            : {}),
+                        ...(identity?.projectId
+                            ? { [FRUGAL_PROJECT_ID]: identity.projectId }
+                            : {}),
+                        "frugal.internal_error.stage": "otel_cardinality_overflow",
+                        [FRUGAL_INSTRUMENT]: name,
+                    });
+                    // Only AFTER the add actually returned: a throwing counter must not
+                    // consume the one-shot and lose the point forever.
+                    counted.add(name);
+                }
+            }
+            catch {
+                // never let a diagnostic break the export path
+            }
             exporter.export(metrics, (result) => {
                 if (result.code === ExportResultCode.SUCCESS) {
                     if (consecutiveFailures > 0)
@@ -277,7 +471,7 @@ function parseHeaders(raw) {
     }
     return Object.keys(out).length > 0 ? out : undefined;
 }
-/** Test-only hook — wipe the cached instruments between tests. */
+/** Test-only hook — wipe the cached instruments (and any cached failure). */
 export function resetInstrumentsForTests() {
     if (cached) {
         cached.meterProvider.shutdown().catch(() => {
@@ -285,9 +479,11 @@ export function resetInstrumentsForTests() {
         });
     }
     cached = null;
+    buildFailure = null;
 }
 /** Test-only hook — install pre-built instruments (e.g. with InMemory reader). */
 export function setInstrumentsForTests(instruments) {
     cached = instruments;
+    buildFailure = null;
 }
 //# sourceMappingURL=otel.js.map

package/dist/otel.js.map

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

package/dist/prompt-analyzer.d.ts

@@ -1,3 +1,4 @@
+import { type HistoryBucket } from "./semconv.js";
 export interface RequestPayload {
     /** Provider-specific messages array (OpenAI chat / Anthropic messages). */
     messages?: unknown;
@@ -9,18 +10,28 @@ export interface RequestPayload {
     maxTokens?: number | null;
     /** Optional system prompt for Anthropic (passed alongside messages). */
     system?: unknown;
+    /**
+     * OpenAI Responses API previous_response_id. Stateful conversations carry
+     * server-side history the signature can't see, so this is folded into the
+     * duplicate signature to keep short recurring turns ("continue") from
+     * colliding across genuinely distinct conversations.
+     */
+    previousResponseId?: string | null;
 }
 export interface AnalysisResult {
     systemHash: string | null;
     userHash: string | null;
     toolsHash: string | null;
     schemaHash: string | null;
-    historyDepth: number | null;
     fewShotCount: number | null;
+    fewShotTokens: number | null;
     noiseRatio: number | null;
     structuredOutputHint: boolean;
 }
 export declare function analyzeRequest(payload: RequestPayload): AnalysisResult;
 export declare function structuredOutputMode(payload: RequestPayload): string;
+export declare function historyDepth(payload: RequestPayload): number | null;
+export declare function historyBucket(n: number): HistoryBucket;
+export declare function requestSignature(payload: RequestPayload, model: string, callSiteId: string): string | null;
 export declare function shouldSample(callSiteId: string, sampleRate: number, nowMs?: number): boolean;
 //# sourceMappingURL=prompt-analyzer.d.ts.map

package/dist/prompt-analyzer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt-analyzer.d.ts","sourceRoot":"","sources":["../src/prompt-analyzer.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,cAAc;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qCAAqC;IACrC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,wEAAwE;IACxE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,cAAc,CActE;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAWpE;AAyKD,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,KAAK,GAAE,MAAmB,GACzB,OAAO,CAYT"}
+{"version":3,"file":"prompt-analyzer.d.ts","sourceRoot":"","sources":["../src/prompt-analyzer.ts"],"names":[],"mappings":"AAQA,OAAO,EAKL,KAAK,aAAa,EACnB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,cAAc;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qCAAqC;IACrC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,wEAAwE;IACxE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,cAAc,CActE;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAWpE;AA2JD,wBAAgB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI,CAGnE;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,aAAa,CAQtD;AA0HD,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,IAAI,CA8Bf;AA6BD,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,KAAK,GAAE,MAAmB,GACzB,OAAO,CAYT"}

package/dist/prompt-analyzer.js

@@ -11,8 +11,8 @@ export function analyzeRequest(payload) {
         userHash: safe(() => hashUserBlock(payload), null),
         toolsHash: safe(() => hashJSON(payload.tools), null),
         schemaHash: safe(() => hashJSON(payload.responseFormat), null),
-        historyDepth: safe(() => historyDepth(payload), null),
         fewShotCount: safe(() => fewShotCount(payload), null),
+        fewShotTokens: safe(() => fewShotTokens(payload), null),
         noiseRatio: safe(() => noiseRatio(payload), null),
         structuredOutputHint: safe(() => structuredOutputHint(payload), false),
     };
@@ -49,14 +49,98 @@ function hashJSON(value) {
     return sha256(canonicalize(value));
 }
 function canonicalize(value) {
-    if (value === null || typeof value !== "object")
-        return JSON.stringify(value);
-    if (Array.isArray(value)) {
-        return "[" + value.map((v) => canonicalize(v)).join(",") + "]";
+    const parts = [];
+    streamCanonical(value, (chunk) => parts.push(chunk));
+    return parts.join("");
+}
+// Canonical-JSON serialization pushed through a sink chunk by chunk, so the
+// signature path can hash incrementally under a byte budget instead of
+// materializing one giant string. Normalized to JSON wire semantics: an
+// explicitly-undefined property serializes identically to an omitted one, so
+// SDK-built objects with optional undefined props can't evade duplicate
+// detection. Binary content (TypedArray / ArrayBuffer — e.g. Bedrock Converse
+// images) contributes only its byteLength, never its bytes: hashing megabytes
+// of image data per call buys no duplicate signal worth its CPU cost, and the
+// generic object branch would sort one key per byte.
+//
+// This walk runs on 100% of chat calls, so every input dimension is bounded,
+// not just the total output (the sink's byte budget checks a chunk only after
+// it exists):
+// - String leaves are capped at MAX_STRING_LEAF_CHARS before stringification.
+//   Base64 images arrive as plain strings (OpenAI `image_url.url`, Anthropic
+//   `source.data`) — stringifying a multi-MB data URL whole would allocate a
+//   same-sized escaped copy per call. The leaf contributes its head plus its
+//   total length, so strings identical through the cap but of different
+//   lengths still differ; same-length strings differing only past the cap
+//   collide — the same trade-off as the binary byteLength branch.
+// - Recursion is depth-capped (everything below MAX_CANONICAL_DEPTH collapses
+//   to one marker) — the byte budget bounds breadth but not depth, and a
+//   pathologically nested payload would exhaust the JS stack first.
+// - Ancestor cycles emit a marker instead of recursing forever. The guard is
+//   path-scoped (added on entry, removed on exit), so a shared sub-object
+//   appearing twice (a DAG) still serializes both times.
+const MAX_STRING_LEAF_CHARS = 8 * 1024;
+const MAX_CANONICAL_DEPTH = 64;
+function streamCanonical(value, sink) {
+    walkCanonical(value, sink, 0, new WeakSet());
+}
+function walkCanonical(value, sink, depth, ancestors) {
+    if (typeof value === "string" && value.length > MAX_STRING_LEAF_CHARS) {
+        sink(JSON.stringify(`${value.slice(0, MAX_STRING_LEAF_CHARS)}<str:${value.length}>`));
+        return;
+    }
+    if (value === null || typeof value !== "object") {
+        // JSON.stringify yields undefined for undefined/function/symbol — all
+        // serialize as null on the wire.
+        sink(JSON.stringify(value) ?? "null");
+        return;
+    }
+    if (ArrayBuffer.isView(value)) {
+        sink(`"<binary:${value.byteLength}>"`);
+        return;
+    }
+    if (value instanceof ArrayBuffer) {
+        sink(`"<binary:${value.byteLength}>"`);
+        return;
+    }
+    if (depth >= MAX_CANONICAL_DEPTH) {
+        sink('"<maxdepth>"');
+        return;
+    }
+    if (ancestors.has(value)) {
+        sink('"<cycle>"');
+        return;
+    }
+    ancestors.add(value);
+    try {
+        if (Array.isArray(value)) {
+            sink("[");
+            for (let i = 0; i < value.length; i++) {
+                if (i > 0)
+                    sink(",");
+                walkCanonical(value[i], sink, depth + 1, ancestors);
+            }
+            sink("]");
+            return;
+        }
+        const obj = value;
+        const keys = Object.keys(obj)
+            .filter((k) => obj[k] !== undefined)
+            .sort();
+        sink("{");
+        for (let i = 0; i < keys.length; i++) {
+            if (i > 0)
+                sink(",");
+            sink(JSON.stringify(keys[i]) + ":");
+            walkCanonical(obj[keys[i]], sink, depth + 1, ancestors);
+        }
+        sink("}");
+    }
+    finally {
+        // finally, not post-loop: the budget sink aborts the walk by throwing, and
+        // the ancestor set must unwind with the stack either way.
+        ancestors.delete(value);
     }
-    const keys = Object.keys(value).sort();
-    const parts = keys.map((k) => JSON.stringify(k) + ":" + canonicalize(value[k]));
-    return "{" + parts.join(",") + "}";
 }
 function hashSystemBlock(payload) {
     const blocks = [];
@@ -88,12 +172,27 @@ function hashUserBlock(payload) {
     return hashJSON(blocks);
 }
 // --- structural counts -----------------------------------------------------
-function historyDepth(payload) {
+export function historyDepth(payload) {
     if (!Array.isArray(payload.messages))
         return null;
     return payload.messages.length;
 }
-function fewShotCount(payload) {
+export function historyBucket(n) {
+    if (n <= 0)
+        return "0";
+    if (n <= 2)
+        return "1-2";
+    if (n <= 5)
+        return "3-5";
+    if (n <= 10)
+        return "6-10";
+    if (n <= 20)
+        return "11-20";
+    if (n <= 50)
+        return "21-50";
+    return "51+";
+}
+function fewShotSpan(payload) {
     if (!Array.isArray(payload.messages))
         return null;
     const msgs = payload.messages.filter((m) => m !== null && typeof m === "object");
@@ -113,20 +212,51 @@ function fewShotCount(payload) {
         if (Array.isArray(m.tool_calls) && m.tool_calls.length > 0)
             return null;
     }
-    // Count consecutive (user, assistant) pairs preceding the final user.
-    let pairs = 0;
+    // Collect consecutive (user, assistant) pairs preceding the final user.
+    const exampleMessages = [];
     let j = i;
     const lastIdx = msgs.length - 1; // final user
     while (j + 1 < lastIdx) {
         if (msgs[j].role === "user" && msgs[j + 1].role === "assistant") {
-            pairs++;
+            exampleMessages.push(msgs[j], msgs[j + 1]);
             j += 2;
         }
         else {
             break;
         }
     }
-    return pairs;
+    return { pairs: exampleMessages.length / 2, exampleMessages };
+}
+function fewShotCount(payload) {
+    const span = fewShotSpan(payload);
+    return span === null ? null : span.pairs;
+}
+function fewShotTokens(payload) {
+    const span = fewShotSpan(payload);
+    if (span === null)
+        return null;
+    return estimateTokens(messagesText(span.exampleMessages));
+}
+function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+function messagesText(messages) {
+    const parts = [];
+    for (const m of messages) {
+        const content = m.content;
+        if (typeof content === "string")
+            parts.push(content);
+        else if (Array.isArray(content)) {
+            for (const c of content) {
+                if (!c || typeof c !== "object")
+                    continue;
+                const text = c.text;
+                if (typeof text === "string")
+                    parts.push(text);
+            }
+        }
+    }
+    return parts.join("\n");
 }
 // --- noise ratio -----------------------------------------------------------
 const HTML_TAG_REGEX = /<[^>]+>/g;
@@ -170,6 +300,47 @@ function collectText(payload) {
     }
     return parts.join("\n");
 }
+// The signature runs on 100% of chat calls, synchronously on the caller's hot
+// path, so its cost must stay bounded regardless of payload size. Hashing is
+// incremental (no giant intermediate string) and capped: past
+// SIGNATURE_MAX_CHARS canonical characters, traversal stops and a truncation
+// marker plus the message count is folded in instead. Multi-MB payloads
+// identical in their first 256K canonical chars therefore collide — an
+// accepted trade-off; the alternative is serializing megabytes per call.
+const SIGNATURE_MAX_CHARS = 256 * 1024;
+const TRUNCATED = Symbol("frugal.signature.truncated");
+export function requestSignature(payload, model, callSiteId) {
+    if (!Array.isArray(payload.messages))
+        return null;
+    const hash = createHash("sha256");
+    let remaining = SIGNATURE_MAX_CHARS;
+    const sink = (chunk) => {
+        remaining -= chunk.length;
+        if (remaining < 0)
+            throw TRUNCATED;
+        hash.update(chunk);
+    };
+    try {
+        streamCanonical({
+            site: callSiteId,
+            model,
+            system: payload.system ?? null,
+            messages: payload.messages,
+            tools: payload.tools ?? null,
+            responseFormat: payload.responseFormat ?? null,
+            maxTokens: payload.maxTokens ?? null,
+            ...(payload.previousResponseId
+                ? { previousResponseId: payload.previousResponseId }
+                : {}),
+        }, sink);
+    }
+    catch (err) {
+        if (err !== TRUNCATED)
+            throw err;
+        hash.update(`|truncated|messages:${payload.messages.length}`);
+    }
+    return hash.digest("hex");
+}
 // --- structured output hint ------------------------------------------------
 const STRUCTURED_HINT_REGEXES = [
     /format\s+as\s+JSON/i,