@senpi/runtime 3.0.129 → 3.0.130

package/dist/telemetry/tick-frame.d.ts

@@ -0,0 +1,212 @@
+/**
+ * The compact `plugin.senpi.tick` frame: the wire shape, the two detail dials that gate it, and the
+ * byte budget it is built under.
+ *
+ * Shape, and why it is compact. A frame carries the latest finished run of every scanner on the box,
+ * so the same 42-character wallet, the same scanner name and the same handful of tool names repeat on
+ * every entry. A per-frame dictionary interns them once and each entry references them by index; the
+ * timestamps are deltas from one frame-level `t0`; and the keys are one or two characters. Two hundred
+ * runtimes at full detail land under a tenth of the frame budget this way, where the long-key shape
+ * would not.
+ *
+ * Short keys stop at this boundary. A client's store expands them once at the reducer and its
+ * components keep reading `scannedCount`, never `n`.
+ *
+ * Two dials, not one. `mcp` gates what the MCP boundary reports (`sw`, `mms`, `c`, `cms`) and `state`
+ * gates the author's own state projection (`stc`, `st`), because the two cost very different numbers
+ * of bytes and an operator watching a slow venue does not also want every author key on the wire. The
+ * tick's own summary facts (`q`, `lag`, `jp`, `cm`) belong to neither, so they ride whenever either
+ * dial is up: with both off the frame is the always-keys only, which is the shape a box publishes when
+ * it wants nothing but proof of life.
+ *
+ * Nothing here reaches `logger.event` or `appendDomainEvent`. A tick is a LEVEL — see
+ * {@link ../utils/telemetry-required-log.js} for why these facts must not become catalogued events.
+ */
+/** How much of one source a frame carries. */
+export type TickDetail = "off" | "summary" | "verbose";
+/** The plugin-config shape: one level for both sources, or a level per source. */
+export type TickTelemetryConfig = TickDetail | {
+    mcp?: TickDetail;
+    state?: TickDetail;
+};
+/** The resolved dials. `enabled` is false only for a bare `"off"`, which publishes no frame at all. */
+export interface TickTelemetrySettings {
+    readonly enabled: boolean;
+    readonly mcp: TickDetail;
+    readonly state: TickDetail;
+}
+/**
+ * The level a source takes when the configuration does not name it.
+ *
+ * Verbose, not summary: a box is watched by exactly one client over that client's own socket, the
+ * frame budget holds two hundred runtimes at this level, and an operator who has to change a setting
+ * before the screen can answer why a scanner is slow will not have changed it yet when it matters.
+ */
+export declare const DEFAULT_TICK_DETAIL: TickDetail;
+/**
+ * Character ceiling for one scanner-authored string inside a tick — an outcome, a state value, a
+ * tool argument. Matches the cap the stats payload's free text takes, for the same reason: these
+ * carry a stringified throwable or an author's own value, and nothing upstream bounds either.
+ */
+export declare const MAX_TICK_TEXT_CHARS = 1024;
+/**
+ * Calls recorded for one tick. A scanner that calls a tool in a loop would otherwise put an unbounded
+ * list on the wire; past this many the tally still counts them (`c` at summary and `cms` stay whole,
+ * because they are read off the scaffold's own totals), and only the per-call detail is cut.
+ */
+export declare const MAX_TICK_CALLS = 64;
+/**
+ * Bounds for one list-valued argument, mirroring the producer's own per-list bounds: at most this
+ * many elements, and no more characters across the whole list than a single string argument is
+ * allowed. The frame is a second, independent gate on values the scaffold already bounded, so it
+ * must not admit a longer list than the scaffold can send — and a list from any other producer is
+ * held to the same terms here.
+ *
+ * The frame's byte budget is not a substitute. That budget drops a whole ENTRY that does not fit,
+ * so without these one scanner's long list would cost that scanner's entire tick rather than the
+ * tail of the list. The character bound is counted AFTER the scrub, for the reason `scrubText`
+ * gives: a redaction can be longer than the text it replaced, so a bound taken first would bound
+ * the input and not what leaves.
+ */
+export declare const MAX_TICK_CALL_ARG_LIST_ITEMS = 16;
+export declare const MAX_TICK_CALL_ARG_LIST_CHARS = 1024;
+/**
+ * `cm` — the state commit outcome, as a RAW STRING and not a dictionary index. Only `a` `s` `m` `o`
+ * `x` are interned; these are a small closed set a client reads directly.
+ *
+ * A tick that committed normally sends nothing at all: the key exists to make the abnormal endings
+ * visible, and the common case is not one of them.
+ *
+ * - `rolled_back` — the tick was not `ok`, so the scaffold discarded the tick's state mutations.
+ * - `persist_failed` — the commit was attempted, the write failed, and the tick was rolled back;
+ *   state did not advance, which is the stall this key exists to make visible.
+ */
+export declare const COMMIT_ROLLED_BACK = "rolled_back";
+export declare const COMMIT_PERSIST_FAILED = "persist_failed";
+/** The commit endings a producer may report. `committed` is the absent case. */
+export type TickCommitOutcome = "committed" | typeof COMMIT_ROLLED_BACK | typeof COMMIT_PERSIST_FAILED;
+/** One MCP tool call a tick made, as the producer's boundary timed it. */
+export interface TickCall {
+    readonly tool: string;
+    /** Wall time the call took. Absent when the producer reported none; never zero as a stand-in. */
+    readonly ms?: number;
+    /** The call's arguments. Ride at `mcp: verbose` only, sanitised, scrubbed and capped. */
+    readonly args?: Readonly<Record<string, unknown>>;
+    /** Set only on a failed call — the leaf error's type, as the boundary classified it. */
+    readonly errorType?: string;
+}
+/**
+ * One finished run waiting for the next frame, already narrowed to what a tick carries.
+ *
+ * Every optional field means UNKNOWN when it is absent. A `scannedCount` of `0` is a scanner that
+ * looked at nothing; an absent one is a scanner that did not say. The distinction is held from the
+ * producer through this frame to the screen, so nothing here may default one to the other.
+ */
+export interface PendingTick {
+    readonly address: string;
+    readonly scannerId: string;
+    /** Run status as the producer reports it. Scanner-authored text: scrubbed and capped. */
+    readonly outcome: string;
+    readonly finishedAt: number;
+    readonly signalCount: number;
+    readonly scannedCount?: number;
+    readonly durationMs?: number;
+    /** MCP failures the author's own `except` swallowed this tick. */
+    readonly mcpFailures?: number;
+    readonly mcpCalls?: readonly TickCall[];
+    /** Total time inside MCP this tick, as the producer totalled it. */
+    readonly mcpMs?: number;
+    /** Consecutive ticks that produced no signal, this one included. */
+    readonly quietTicks?: number;
+    /** Actual gap since the previous tick minus the configured interval. */
+    readonly lagMs?: number;
+    /** Signals still awaiting delivery in the producer's journal. */
+    readonly journalPending?: number;
+    readonly commit?: TickCommitOutcome;
+    /** The last COMMITTED state row, scalars only — stale by one tick by construction. */
+    readonly state?: Readonly<Record<string, unknown>>;
+    /** Fields in that row before sanitising, so `stc` can report the drop. */
+    readonly stateFieldCount?: number;
+    /** Fields in that row whose value moved since the previous committed row. */
+    readonly stateChangedCount?: number;
+}
+/** `c` at `mcp: summary` — how many times each tool was called, keyed by dictionary index. */
+export type TickCallCounts = Record<number, number>;
+/** `c` at `mcp: verbose` — one element per call; the error index appears only on a failed one. */
+export type TickCallDetail = readonly [tool: number, ms: number, args: Record<string, unknown>] | readonly [tool: number, ms: number, args: Record<string, unknown>, err: number];
+/** One tick on the wire. Every key is an index into the frame dictionary or a scalar. */
+export interface TickFrameEntry {
+    a: number;
+    s: number;
+    t: number;
+    o: number;
+    n?: number;
+    g: number;
+    ms?: number;
+    mms?: number;
+    q?: number;
+    lag?: number;
+    sw?: number;
+    jp?: number;
+    cm?: string;
+    c?: TickCallCounts | TickCallDetail[];
+    cms?: number;
+    stc?: readonly [changed: number, total: number];
+    st?: Record<string, string | number | boolean>;
+}
+/** The per-frame dictionary every index in an entry refers to. */
+export interface TickFrameDictionary {
+    /** Wallet addresses, normalised. */
+    a: string[];
+    /** Scanner ids. */
+    s: string[];
+    /** MCP tool names. */
+    m: string[];
+    /** Run outcomes. */
+    o: string[];
+    /** Error types. */
+    x: string[];
+}
+/**
+ * A tick frame. No `batchSeq`, and its entries carry no `seq`: this is the current state of a set of
+ * scanners, and a client that misses a frame is made whole by the next one rather than by a replay.
+ */
+export interface TickFramePayload {
+    v: 1;
+    e: string;
+    /** The frame's time base. Every entry's `t` is a millisecond offset from it. */
+    t0: number;
+    d: TickFrameDictionary;
+    k: TickFrameEntry[];
+}
+/** Scrub one scanner-authored string. `null` means the text could not be vouched for. */
+export type TickScrub = (text: string) => Promise<string | null>;
+export interface TickFrameBuilderOptions {
+    readonly epoch: string;
+    readonly t0: number;
+    readonly settings: TickTelemetrySettings;
+    /** Byte ceiling for the built frame. Defaults to the caller's frame budget. */
+    readonly maxBytes?: number;
+}
+export interface TickFrameBuilder {
+    /**
+     * Take one finished run into the frame. Returns false when it did not fit, or when the dial
+     * publishes nothing — the frame stays publishable either way.
+     */
+    add(tick: PendingTick, scrub: TickScrub): Promise<boolean>;
+    /** The frame, or `null` when nothing was admitted and there is nothing to publish. */
+    build(): TickFramePayload | null;
+}
+/**
+ * Read the `tickTelemetry` plugin-config value.
+ *
+ * Never throws and never leaves the caller without settings: an unusable value falls back to the
+ * default and is reported in `invalid` so the caller can warn about it once, at startup, the way an
+ * unusable `logLevel` is. A configuration mistake must not be the reason a box publishes nothing.
+ */
+export declare function resolveTickTelemetry(value: unknown): {
+    settings: TickTelemetrySettings;
+    invalid?: string;
+};
+export declare function createTickFrameBuilder(options: TickFrameBuilderOptions): TickFrameBuilder;
+//# sourceMappingURL=tick-frame.d.ts.map

package/dist/telemetry/tick-frame.d.ts.map

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

package/dist/telemetry/tick-frame.js

@@ -0,0 +1,421 @@
+/**
+ * The compact `plugin.senpi.tick` frame: the wire shape, the two detail dials that gate it, and the
+ * byte budget it is built under.
+ *
+ * Shape, and why it is compact. A frame carries the latest finished run of every scanner on the box,
+ * so the same 42-character wallet, the same scanner name and the same handful of tool names repeat on
+ * every entry. A per-frame dictionary interns them once and each entry references them by index; the
+ * timestamps are deltas from one frame-level `t0`; and the keys are one or two characters. Two hundred
+ * runtimes at full detail land under a tenth of the frame budget this way, where the long-key shape
+ * would not.
+ *
+ * Short keys stop at this boundary. A client's store expands them once at the reducer and its
+ * components keep reading `scannedCount`, never `n`.
+ *
+ * Two dials, not one. `mcp` gates what the MCP boundary reports (`sw`, `mms`, `c`, `cms`) and `state`
+ * gates the author's own state projection (`stc`, `st`), because the two cost very different numbers
+ * of bytes and an operator watching a slow venue does not also want every author key on the wire. The
+ * tick's own summary facts (`q`, `lag`, `jp`, `cm`) belong to neither, so they ride whenever either
+ * dial is up: with both off the frame is the always-keys only, which is the shape a box publishes when
+ * it wants nothing but proof of life.
+ *
+ * Nothing here reaches `logger.event` or `appendDomainEvent`. A tick is a LEVEL — see
+ * {@link ../utils/telemetry-required-log.js} for why these facts must not become catalogued events.
+ */
+import { capValue } from "./attributes.js";
+import { sanitizeFields as sanitizeScalarFields, sanitizeFieldsWithScalarLists as sanitizeScalarListFields, } from "../utils/telemetry-required-log.js";
+/**
+ * The level a source takes when the configuration does not name it.
+ *
+ * Verbose, not summary: a box is watched by exactly one client over that client's own socket, the
+ * frame budget holds two hundred runtimes at this level, and an operator who has to change a setting
+ * before the screen can answer why a scanner is slow will not have changed it yet when it matters.
+ */
+export const DEFAULT_TICK_DETAIL = "verbose";
+/** The levels a configured value may name; anything else falls back to the default. */
+const TICK_DETAILS = ["off", "summary", "verbose"];
+/**
+ * Character ceiling for one scanner-authored string inside a tick — an outcome, a state value, a
+ * tool argument. Matches the cap the stats payload's free text takes, for the same reason: these
+ * carry a stringified throwable or an author's own value, and nothing upstream bounds either.
+ */
+export const MAX_TICK_TEXT_CHARS = 1_024;
+/**
+ * Calls recorded for one tick. A scanner that calls a tool in a loop would otherwise put an unbounded
+ * list on the wire; past this many the tally still counts them (`c` at summary and `cms` stay whole,
+ * because they are read off the scaffold's own totals), and only the per-call detail is cut.
+ */
+export const MAX_TICK_CALLS = 64;
+/**
+ * Bounds for one list-valued argument, mirroring the producer's own per-list bounds: at most this
+ * many elements, and no more characters across the whole list than a single string argument is
+ * allowed. The frame is a second, independent gate on values the scaffold already bounded, so it
+ * must not admit a longer list than the scaffold can send — and a list from any other producer is
+ * held to the same terms here.
+ *
+ * The frame's byte budget is not a substitute. That budget drops a whole ENTRY that does not fit,
+ * so without these one scanner's long list would cost that scanner's entire tick rather than the
+ * tail of the list. The character bound is counted AFTER the scrub, for the reason `scrubText`
+ * gives: a redaction can be longer than the text it replaced, so a bound taken first would bound
+ * the input and not what leaves.
+ */
+export const MAX_TICK_CALL_ARG_LIST_ITEMS = 16;
+export const MAX_TICK_CALL_ARG_LIST_CHARS = 1_024;
+/**
+ * `cm` — the state commit outcome, as a RAW STRING and not a dictionary index. Only `a` `s` `m` `o`
+ * `x` are interned; these are a small closed set a client reads directly.
+ *
+ * A tick that committed normally sends nothing at all: the key exists to make the abnormal endings
+ * visible, and the common case is not one of them.
+ *
+ * - `rolled_back` — the tick was not `ok`, so the scaffold discarded the tick's state mutations.
+ * - `persist_failed` — the commit was attempted, the write failed, and the tick was rolled back;
+ *   state did not advance, which is the stall this key exists to make visible.
+ */
+export const COMMIT_ROLLED_BACK = "rolled_back";
+export const COMMIT_PERSIST_FAILED = "persist_failed";
+/** 128 KiB, the same ceiling the timeline and stats frames are split against. */
+const DEFAULT_MAX_FRAME_BYTES = 128 * 1024;
+/** One comma between two members of the same JSON array. */
+const SEPARATOR_BYTES = 1;
+function isTickDetail(value) {
+    return typeof value === "string" && TICK_DETAILS.includes(value);
+}
+/**
+ * Read the `tickTelemetry` plugin-config value.
+ *
+ * Never throws and never leaves the caller without settings: an unusable value falls back to the
+ * default and is reported in `invalid` so the caller can warn about it once, at startup, the way an
+ * unusable `logLevel` is. A configuration mistake must not be the reason a box publishes nothing.
+ */
+export function resolveTickTelemetry(value) {
+    const fallback = {
+        enabled: true,
+        mcp: DEFAULT_TICK_DETAIL,
+        state: DEFAULT_TICK_DETAIL,
+    };
+    if (value === undefined || value === null)
+        return { settings: fallback, invalid: undefined };
+    if (typeof value === "string") {
+        if (!isTickDetail(value)) {
+            return { settings: fallback, invalid: `tickTelemetry="${value}"` };
+        }
+        // A bare level applies to both sources; a bare `off` is the one value that stops the frames
+        // themselves, rather than emptying them of everything but the always-keys.
+        return { settings: { enabled: value !== "off", mcp: value, state: value } };
+    }
+    if (typeof value !== "object" || Array.isArray(value)) {
+        return { settings: fallback, invalid: `tickTelemetry=${JSON.stringify(value) ?? typeof value}` };
+    }
+    const raw = value;
+    const bad = [];
+    const read = (key) => {
+        const level = raw[key];
+        if (level === undefined)
+            return DEFAULT_TICK_DETAIL;
+        if (isTickDetail(level))
+            return level;
+        bad.push(`tickTelemetry.${key}="${String(level)}"`);
+        return DEFAULT_TICK_DETAIL;
+    };
+    const mcp = read("mcp");
+    const state = read("state");
+    return {
+        // The object form never turns the frames off: `{mcp:"off",state:"off"}` is an operator asking
+        // for proof of life and nothing else, which is a frame of always-keys — not silence.
+        settings: { enabled: true, mcp, state },
+        ...(bad.length > 0 ? { invalid: bad.join(", ") } : {}),
+    };
+}
+/** Whether a source is at `summary` or better. */
+function atLeastSummary(level) {
+    return level !== "off";
+}
+/** A finite, non-negative count, or `undefined` for a value that means nothing. */
+function count(value) {
+    return typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : undefined;
+}
+/**
+ * Scrub, then cap, one scanner-authored string. The cap is taken AFTER the scrub because a redaction
+ * can be longer than the text it replaced, so a cut taken first would bound the input and not what
+ * leaves. A string the scrub could not vouch for is dropped rather than passed through.
+ */
+async function scrubText(text, scrub) {
+    if (text === "")
+        return "";
+    try {
+        const scrubbed = await scrub(text);
+        return scrubbed === null ? null : capValue(scrubbed, MAX_TICK_TEXT_CHARS);
+    }
+    catch {
+        // The caller's scrub already reports its own failures; a throw here costs the one string.
+        return null;
+    }
+}
+/** Every scalar in a bag, scrubbed. Non-scalars are dropped exactly as the required log drops them. */
+async function scrubScalarBag(bag, scrub) {
+    const { attributes } = sanitizeScalarFields(bag);
+    const out = {};
+    for (const key of Object.keys(attributes)) {
+        const value = attributes[key];
+        if (typeof value !== "string") {
+            out[key] = value;
+            continue;
+        }
+        const scrubbed = await scrubText(value, scrub);
+        if (scrubbed !== null)
+            out[key] = scrubbed;
+    }
+    return out;
+}
+/**
+ * One list argument, scrubbed and bounded — or `null` when the list is not carried at all.
+ *
+ * Every string element goes through the same scrub a bare string value does, because a list that
+ * bypassed redaction would put on the wire exactly what the scrub exists to keep off it. An element
+ * the scrub could not vouch for refuses the whole list: at bag level an unvouchable value costs its
+ * key, and this list IS one key's value.
+ *
+ * Elements cut by either bound are replaced by a trailing count, so a shortened list reads as
+ * shortened rather than as a shorter call. The marker is a plain string element because a consumer
+ * expands dictionary indexes and scalars, and a nested object would not survive that.
+ */
+async function scrubScalarList(items, scrub) {
+    const kept = [];
+    let chars = 0;
+    for (const item of items.slice(0, MAX_TICK_CALL_ARG_LIST_ITEMS)) {
+        const rendered = typeof item === "string" ? await scrubText(item, scrub) : String(item);
+        if (rendered === null)
+            return null;
+        if (chars + rendered.length > MAX_TICK_CALL_ARG_LIST_CHARS)
+            break;
+        chars += rendered.length;
+        kept.push(typeof item === "string" ? rendered : item);
+    }
+    if (kept.length < items.length)
+        kept.push(`+${items.length - kept.length} more`);
+    return kept;
+}
+/**
+ * One call's arguments: every scalar as the state projection keeps them, and additionally a list
+ * whose every element is a scalar.
+ *
+ * Which assets a scanner priced is the argument an operator reads first, and it arrives as a list —
+ * so an argument bag is the one bag on this frame that needs the wider rule. It is asked for HERE
+ * and not in the shared sanitiser: the narrow rule is a contract the required log's consumer and the
+ * author's state projection both depend on, and neither may gain lists because an argument bag
+ * wanted them.
+ */
+async function scrubCallArgs(bag, scrub) {
+    const { attributes } = sanitizeScalarListFields(bag);
+    const out = {};
+    for (const key of Object.keys(attributes)) {
+        const value = attributes[key];
+        if (Array.isArray(value)) {
+            const list = await scrubScalarList(value, scrub);
+            if (list !== null)
+                out[key] = list;
+            continue;
+        }
+        if (typeof value !== "string") {
+            out[key] = value;
+            continue;
+        }
+        const scrubbed = await scrubText(value, scrub);
+        if (scrubbed !== null)
+            out[key] = scrubbed;
+    }
+    return out;
+}
+export function createTickFrameBuilder(options) {
+    const { epoch, t0, settings } = options;
+    const maxBytes = options.maxBytes ?? DEFAULT_MAX_FRAME_BYTES;
+    const dictionary = { a: [], s: [], m: [], o: [], x: [] };
+    const entries = [];
+    // What the frame costs before it holds anything. Counted rather than estimated, so the running
+    // total below is the size of the frame that goes out and not a sum of approximations.
+    let bytes = Buffer.byteLength(JSON.stringify({ v: 1, e: epoch, t0, d: dictionary, k: [] }));
+    /**
+     * The index of `text` in a dictionary slot, interning it when it is new.
+     *
+     * `added` accumulates what the new strings cost, so an entry that turns out not to fit can have
+     * them taken back out again: a dropped entry must not leave its wallet in the dictionary of a
+     * frame that never mentions it.
+     */
+    function intern(slot, text, added) {
+        const list = dictionary[slot];
+        const found = list.indexOf(text);
+        if (found !== -1)
+            return found;
+        added.bytes += Buffer.byteLength(JSON.stringify(text)) + (list.length > 0 ? SEPARATOR_BYTES : 0);
+        list.push(text);
+        return list.length - 1;
+    }
+    /** Every slot's length, so interning can be undone wholesale. */
+    function marks() {
+        return {
+            a: dictionary.a.length,
+            s: dictionary.s.length,
+            m: dictionary.m.length,
+            o: dictionary.o.length,
+            x: dictionary.x.length,
+        };
+    }
+    function restore(mark) {
+        dictionary.a.length = mark.a;
+        dictionary.s.length = mark.s;
+        dictionary.m.length = mark.m;
+        dictionary.o.length = mark.o;
+        dictionary.x.length = mark.x;
+    }
+    /**
+     * `c` and its two companions, in whichever of the two shapes the MCP dial asks for.
+     *
+     * Summary is a count per tool: what the scanner did, in the fewest bytes that can say it. Verbose
+     * is one element per call with its duration and its arguments, which is what answers where the time
+     * went — and `cms` is dropped there because the per-call durations already carry the total.
+     */
+    async function mcpKeys(tick, scrub, added) {
+        if (settings.mcp === "off")
+            return {};
+        const out = {};
+        // A producer that reported no call information at all — an in-process scanner — is not a
+        // producer that made no calls. The first leaves `c` off entirely; the second sends it empty.
+        const calls = tick.mcpCalls;
+        if (calls === undefined) {
+            const swallowedOnly = count(tick.mcpFailures);
+            if (swallowedOnly !== undefined && swallowedOnly > 0)
+                out.sw = swallowedOnly;
+            return out;
+        }
+        // The time split rides with the MCP source and is absent when the tick called no tool at all —
+        // a zero would read as "MCP was instant" rather than "MCP was not used".
+        const mcpMs = count(tick.mcpMs);
+        if (mcpMs !== undefined && calls.length > 0)
+            out.mms = mcpMs;
+        const swallowed = count(tick.mcpFailures);
+        if (swallowed !== undefined && swallowed > 0)
+            out.sw = swallowed;
+        if (settings.mcp === "summary") {
+            const counts = {};
+            for (const call of calls) {
+                const index = intern("m", capValue(call.tool, MAX_TICK_TEXT_CHARS), added);
+                counts[index] = (counts[index] ?? 0) + 1;
+            }
+            out.c = counts;
+            return out;
+        }
+        const detail = [];
+        for (const call of calls.slice(0, MAX_TICK_CALLS)) {
+            const tool = intern("m", capValue(call.tool, MAX_TICK_TEXT_CHARS), added);
+            const ms = count(call.ms) ?? 0;
+            const args = call.args === undefined ? {} : await scrubCallArgs(call.args, scrub);
+            if (call.errorType === undefined) {
+                detail.push([tool, ms, args]);
+                continue;
+            }
+            const err = intern("x", capValue(call.errorType, MAX_TICK_TEXT_CHARS), added);
+            detail.push([tool, ms, args, err]);
+        }
+        out.c = detail;
+        return out;
+    }
+    /**
+     * `cms` rides at BOTH levels, the one number the frame repeats. A client could sum the per-call
+     * durations at verbose, but two implementations of the same total disagree eventually, so the box
+     * states it and neither side derives it.
+     */
+    function totalCallMs(tick) {
+        return settings.mcp === "off" ? undefined : count(tick.mcpMs);
+    }
+    /**
+     * `stc` at summary, `st` at verbose, nothing at off — exactly one of the two, never both.
+     *
+     * The projection is the last COMMITTED row, so it is stale by one tick whenever the current tick
+     * failed. That is the point: a tick that could not commit is precisely when an operator wants to
+     * see what the scanner last agreed on.
+     */
+    async function stateKeys(tick, scrub) {
+        if (settings.state === "off")
+            return {};
+        if (settings.state === "summary") {
+            const changed = count(tick.stateChangedCount);
+            const total = count(tick.stateFieldCount);
+            if (changed === undefined || total === undefined)
+                return {};
+            return { stc: [changed, total] };
+        }
+        if (tick.state === undefined)
+            return {};
+        return { st: await scrubScalarBag(tick.state, scrub) };
+    }
+    async function add(tick, scrub) {
+        if (!settings.enabled)
+            return false;
+        const mark = marks();
+        const added = { bytes: 0 };
+        try {
+            const outcome = (await scrubText(tick.outcome, scrub)) ?? "";
+            const scanned = count(tick.scannedCount);
+            const duration = count(tick.durationMs);
+            const summary = atLeastSummary(settings.mcp) || atLeastSummary(settings.state);
+            const quiet = summary ? count(tick.quietTicks) : undefined;
+            const lag = summary ? count(tick.lagMs) : undefined;
+            const journal = summary ? count(tick.journalPending) : undefined;
+            const commit = summary && tick.commit !== undefined && tick.commit !== "committed"
+                ? tick.commit
+                : undefined;
+            // The two indexes are taken before the spread below so the dictionary is interned in a fixed
+            // order, then the entry is assembled in the CONTRACT's own key order: a frame then reads the
+            // way its table does, and two frames of the same shape serialise to the same bytes.
+            const a = intern("a", tick.address, added);
+            const s = intern("s", tick.scannerId, added);
+            const o = intern("o", outcome, added);
+            const mcp = await mcpKeys(tick, scrub, added);
+            const cms = totalCallMs(tick);
+            const state = await stateKeys(tick, scrub);
+            const entry = {
+                a,
+                s,
+                t: tick.finishedAt - t0,
+                o,
+                ...(scanned === undefined ? {} : { n: scanned }),
+                g: count(tick.signalCount) ?? 0,
+                ...(duration === undefined ? {} : { ms: duration }),
+                ...(mcp.mms === undefined ? {} : { mms: mcp.mms }),
+                ...(quiet !== undefined && quiet > 0 ? { q: quiet } : {}),
+                ...(lag !== undefined && lag > 0 ? { lag } : {}),
+                ...(mcp.sw === undefined ? {} : { sw: mcp.sw }),
+                ...(journal !== undefined && journal > 0 ? { jp: journal } : {}),
+                ...(commit === undefined ? {} : { cm: commit }),
+                ...(mcp.c === undefined ? {} : { c: mcp.c }),
+                ...(cms === undefined ? {} : { cms }),
+                ...(state.stc === undefined ? {} : { stc: state.stc }),
+                ...(state.st === undefined ? {} : { st: state.st }),
+            };
+            // Bytes, not entry count: one non-ASCII character in a scanner-authored string costs up to
+            // three of them, and the read limit at the far end counts bytes. The separator is counted with
+            // the member it precedes, so the running total is the frame's own size and not a sum under it.
+            const cost = added.bytes +
+                Buffer.byteLength(JSON.stringify(entry)) +
+                (entries.length > 0 ? SEPARATOR_BYTES : 0);
+            if (bytes + cost > maxBytes) {
+                restore(mark);
+                return false;
+            }
+            entries.push(entry);
+            bytes += cost;
+            return true;
+        }
+        catch {
+            // A malformed producer value must cost its own tick and nothing else.
+            restore(mark);
+            return false;
+        }
+    }
+    return {
+        add,
+        build: () => entries.length === 0 ? null : { v: 1, e: epoch, t0, d: dictionary, k: entries },
+    };
+}
+//# sourceMappingURL=tick-frame.js.map

package/dist/telemetry/tick-frame.js.map

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