@senpi/runtime 3.0.132 → 3.0.138

package/dist/telemetry/tick-frame.js

@@ -1,421 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"version":3,"file":"tick-frame.js","sourceRoot":"","sources":["../../src/telemetry/tick-frame.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EACL,cAAc,IAAI,oBAAoB,EACtC,6BAA6B,IAAI,wBAAwB,GAE1D,MAAM,oCAAoC,CAAC;AAe5C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAe,SAAS,CAAC;AAEzD,uFAAuF;AACvF,MAAM,YAAY,GAA0B,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AAE1E;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAEzC;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AAEjC;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAE,CAAC;AAC/C,MAAM,CAAC,MAAM,4BAA4B,GAAG,KAAK,CAAC;AAElD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,aAAa,CAAC;AAChD,MAAM,CAAC,MAAM,qBAAqB,GAAG,gBAAgB,CAAC;AAiJtD,iFAAiF;AACjF,MAAM,uBAAuB,GAAG,GAAG,GAAG,IAAI,CAAC;AAE3C,4DAA4D;AAC5D,MAAM,eAAe,GAAG,CAAC,CAAC;AAE1B,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,YAAkC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC1F,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IAIjD,MAAM,QAAQ,GAA0B;QACtC,OAAO,EAAE,IAAI;QACb,GAAG,EAAE,mBAAmB;QACxB,KAAK,EAAE,mBAAmB;KAC3B,CAAC;IACF,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAE7F,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,KAAK,GAAG,EAAE,CAAC;QACrE,CAAC;QACD,4FAA4F;QAC5F,2EAA2E;QAC3E,OAAO,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,KAAK,KAAK,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC;IAC9E,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACtD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,iBAAiB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;IACnG,CAAC;IAED,MAAM,GAAG,GAAG,KAA2C,CAAC;IACxD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,CAAC,GAAoB,EAAc,EAAE;QAChD,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QACvB,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,mBAAmB,CAAC;QACpD,IAAI,YAAY,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACtC,GAAG,CAAC,IAAI,CAAC,iBAAiB,GAAG,KAAK,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACpD,OAAO,mBAAmB,CAAC;IAC7B,CAAC,CAAC;IACF,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IACxB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5B,OAAO;QACL,8FAA8F;QAC9F,qFAAqF;QACrF,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE;QACvC,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvD,CAAC;AACJ,CAAC;AAED,kDAAkD;AAClD,SAAS,cAAc,CAAC,KAAiB;IACvC,OAAO,KAAK,KAAK,KAAK,CAAC;AACzB,CAAC;AAED,mFAAmF;AACnF,SAAS,KAAK,CAAC,KAAc;IAC3B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/F,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,SAAS,CAAC,IAAY,EAAE,KAAgB;IACrD,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;IAC5E,CAAC;IAAC,MAAM,CAAC;QACP,0FAA0F;QAC1F,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,uGAAuG;AACvG,KAAK,UAAU,cAAc,CAC3B,GAAsC,EACtC,KAAgB;IAEhB,MAAM,EAAE,UAAU,EAAE,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;IACjD,MAAM,GAAG,GAAoC,EAAE,CAAC;IAChD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAE,CAAC;QAC/B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACjB,SAAS;QACX,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC/C,IAAI,QAAQ,KAAK,IAAI;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;IAC7C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;;;;GAWG;AACH,KAAK,UAAU,eAAe,CAC5B,KAAiC,EACjC,KAAgB;IAEhB,MAAM,IAAI,GAAsB,EAAE,CAAC;IACnC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,4BAA4B,CAAC,EAAE,CAAC;QAChE,MAAM,QAAQ,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACxF,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QACnC,IAAI,KAAK,GAAG,QAAQ,CAAC,MAAM,GAAG,4BAA4B;YAAE,MAAM;QAClE,KAAK,IAAI,QAAQ,CAAC,MAAM,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM;QAAE,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,OAAO,CAAC,CAAC;IACjF,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;GASG;AACH,KAAK,UAAU,aAAa,CAC1B,GAAsC,EACtC,KAAgB;IAEhB,MAAM,EAAE,UAAU,EAAE,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC;IACrD,MAAM,GAAG,GAAwD,EAAE,CAAC;IACpE,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAE,CAAC;QAC/B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YACjD,IAAI,IAAI,KAAK,IAAI;gBAAE,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;YACnC,SAAS;QACX,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACjB,SAAS;QACX,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC/C,IAAI,QAAQ,KAAK,IAAI;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;IAC7C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAgC;IACrE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,uBAAuB,CAAC;IAC7D,MAAM,UAAU,GAAwB,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;IAC9E,MAAM,OAAO,GAAqB,EAAE,CAAC;IAErC,+FAA+F;IAC/F,sFAAsF;IACtF,IAAI,KAAK,GAAG,MAAM,CAAC,UAAU,CAC3B,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,EAAE,EAA6B,CAAC,CACxF,CAAC;IAEF;;;;;;OAMG;IACH,SAAS,MAAM,CAAC,IAA+B,EAAE,IAAY,EAAE,KAAwB;QACrF,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QAC/B,KAAK,CAAC,KAAK,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChB,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,iEAAiE;IACjE,SAAS,KAAK;QACZ,OAAO;YACL,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,MAAM;YACtB,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,MAAM;YACtB,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,MAAM;YACtB,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,MAAM;YACtB,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,MAAM;SACvB,CAAC;IACJ,CAAC;IAED,SAAS,OAAO,CAAC,IAA+C;QAC9D,UAAU,CAAC,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;QAC7B,UAAU,CAAC,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;QAC7B,UAAU,CAAC,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;QAC7B,UAAU,CAAC,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;QAC7B,UAAU,CAAC,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;IAC/B,CAAC;IAED;;;;;;OAMG;IACH,KAAK,UAAU,OAAO,CACpB,IAAiB,EACjB,KAAgB,EAChB,KAAwB;QAExB,IAAI,QAAQ,CAAC,GAAG,KAAK,KAAK;YAAE,OAAO,EAAE,CAAC;QACtC,MAAM,GAAG,GAAY,EAAE,CAAC;QACxB,yFAAyF;QACzF,6FAA6F;QAC7F,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC5B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC9C,IAAI,aAAa,KAAK,SAAS,IAAI,aAAa,GAAG,CAAC;gBAAE,GAAG,CAAC,EAAE,GAAG,aAAa,CAAC;YAC7E,OAAO,GAAG,CAAC;QACb,CAAC;QAED,+FAA+F;QAC/F,yEAAyE;QACzE,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,GAAG,CAAC,GAAG,GAAG,KAAK,CAAC;QAE7D,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC1C,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,GAAG,CAAC;YAAE,GAAG,CAAC,EAAE,GAAG,SAAS,CAAC;QAEjE,IAAI,QAAQ,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAmB,EAAE,CAAC;YAClC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,mBAAmB,CAAC,EAAE,KAAK,CAAC,CAAC;gBAC3E,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YAC3C,CAAC;YACD,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC;YACf,OAAO,GAAG,CAAC;QACb,CAAC;QAED,MAAM,MAAM,GAAqB,EAAE,CAAC;QACpC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,mBAAmB,CAAC,EAAE,KAAK,CAAC,CAAC;YAC1E,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;YAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAClF,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;gBACjC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;gBAC9B,SAAS;YACX,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,mBAAmB,CAAC,EAAE,KAAK,CAAC,CAAC;YAC9E,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;QACrC,CAAC;QACD,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC;QACf,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;OAIG;IACH,SAAS,WAAW,CAAC,IAAiB;QACpC,OAAO,QAAQ,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChE,CAAC;IAED;;;;;;OAMG;IACH,KAAK,UAAU,SAAS,CAAC,IAAiB,EAAE,KAAgB;QAC1D,IAAI,QAAQ,CAAC,KAAK,KAAK,KAAK;YAAE,OAAO,EAAE,CAAC;QACxC,IAAI,QAAQ,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAC1C,IAAI,OAAO,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,EAAE,CAAC;YAC5D,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC;QACnC,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;QACxC,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;IACzD,CAAC;IAED,KAAK,UAAU,GAAG,CAAC,IAAiB,EAAE,KAAgB;QACpD,IAAI,CAAC,QAAQ,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QACpC,MAAM,IAAI,GAAG,KAAK,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,CAAC,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;YAC7D,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACzC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACxC,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC/E,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC3D,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACpD,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACjE,MAAM,MAAM,GACV,OAAO,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW;gBACjE,CAAC,CAAC,IAAI,CAAC,MAAM;gBACb,CAAC,CAAC,SAAS,CAAC;YAEhB,6FAA6F;YAC7F,6FAA6F;YAC7F,oFAAoF;YACpF,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC3C,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YAC7C,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;YACtC,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YAC9C,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;YAC9B,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC3C,MAAM,KAAK,GAAmB;gBAC5B,CAAC;gBACD,CAAC;gBACD,CAAC,EAAE,IAAI,CAAC,UAAU,GAAG,EAAE;gBACvB,CAAC;gBACD,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC;gBAChD,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;gBAC/B,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC;gBACnD,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC;gBAClD,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzD,GAAG,CAAC,GAAG,KAAK,SAAS,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChD,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC;gBAC/C,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChE,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;gBAC/C,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;gBAC5C,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC;gBACrC,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC;gBACtD,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;aACpD,CAAC;YAEF,2FAA2F;YAC3F,+FAA+F;YAC/F,+FAA+F;YAC/F,MAAM,IAAI,GACR,KAAK,CAAC,KAAK;gBACX,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;gBACxC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7C,IAAI,KAAK,GAAG,IAAI,GAAG,QAAQ,EAAE,CAAC;gBAC5B,OAAO,CAAC,IAAI,CAAC,CAAC;gBACd,OAAO,KAAK,CAAC;YACf,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpB,KAAK,IAAI,IAAI,CAAC;YACd,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,sEAAsE;YACtE,OAAO,CAAC,IAAI,CAAC,CAAC;YACd,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO;QACL,GAAG;QACH,KAAK,EAAE,GAAG,EAAE,CACV,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE;KAClF,CAAC;AACJ,CAAC"}

package/dist/telemetry/timeline-buffer.d.ts

@@ -1,95 +0,0 @@
-/**
- * In-memory recent-window buffer for the live telemetry stream: the records a client replays on
- * subscribe and the records the stats view is computed from. One buffer per process, partitioned by
- * strategy address — the same shape as the disk ring's process-global sink map, because the tap that
- * feeds it (`appendDomainEvent`) is process-global too.
- *
- * Three things make a client's state recoverable across a reconnect:
- * - `epoch`, a ULID minted when the buffer is created. A change means the plugin restarted, not that
- *   frames were lost.
- * - `seq`, monotonic per epoch across every address, so `(epoch, seq)` is a dedupe and resume key and
- *   a single `afterSeq` cursor is unambiguous. It never rewinds while the epoch holds — not on
- *   teardown, not on eviction.
- * - {@link TimelineBuffer.oldestTs}, the stamp of the oldest record still held. A client whose cursor
- *   predates it knows it has a gap that no replay can fill.
- *
- * The write path is on the serial trading path: it takes one bounded slot write and returns. It does
- * no I/O, awaits nothing, computes nothing, and never throws.
- */
-import type { AttrValue } from "../utils/event-catalog.js";
-import { type LogLevel } from "../utils/logger.js";
-/**
- * Records held per address before the oldest is overwritten. The bound is a record COUNT, per
- * address: a fixed-size ring makes eviction a single slot write (no scan, no shift) and makes the
- * oldest stamp an O(1) read, both of which a byte or age bound would cost the write path. Per address
- * rather than process-wide so one chatty strategy cannot evict a quiet one's window.
- *
- * This is the number to change when the retention window is measured — see also the
- * `maxRecordsPerAddress` option, which overrides it per buffer.
- */
-export declare const DEFAULT_MAX_RECORDS_PER_ADDRESS = 2000;
-/** The seq of the first record of an epoch. Records start at 1, so `afterSeq: 0` means "everything". */
-export declare const FIRST_SEQ = 1;
-/** One record as the tap hands it over, before the buffer stamps a seq. */
-export interface TimelineRecordInput {
-    /** Call-time epoch ms, stamped by `logger.event`. */
-    ts: number;
-    name: string;
-    level: LogLevel;
-    address: string;
-    /** The engine scanner id. Absent — never empty — on a record that has no scanner. */
-    scannerId?: string;
-    body: string;
-    attrs: Record<string, AttrValue>;
-}
-/** A buffered record: the tap's input plus its position in the epoch. */
-export interface TimelineRecord extends TimelineRecordInput {
-    seq: number;
-}
-/** Filters for {@link TimelineBuffer.read}; all optional, all combinable. Time bounds are inclusive. */
-export interface TimelineQuery {
-    /** Exclusive lower bound on seq — the client's resume cursor. */
-    afterSeq?: number;
-    address?: string;
-    scannerId?: string;
-    sinceMs?: number;
-    untilMs?: number;
-    /** Keep the last N after filtering (newest tail). */
-    limit?: number;
-}
-export interface TimelineBufferOptions {
-    /** Overrides {@link DEFAULT_MAX_RECORDS_PER_ADDRESS}. Clamped to at least one record. */
-    maxRecordsPerAddress?: number;
-}
-export interface TimelineBuffer {
-    /** ULID minted with this buffer. Rides every published payload. */
-    readonly epoch: string;
-    /** Copy one record in and return. Never blocks, never throws. */
-    append(input: TimelineRecordInput): void;
-    /** Records matching `query`, oldest first. */
-    read(query?: TimelineQuery): TimelineRecord[];
-    /** Stamp of the oldest record still held across every address; undefined when nothing is held. */
-    oldestTs(): number | undefined;
-    /**
-     * The largest seq this buffer has thrown away, or zero when it has thrown away nothing. A client
-     * resuming from a cursor BELOW this lost at least one record; a cursor at or above it lost none.
-     *
-     * It is not the oldest seq still held. The rings are per address, so a quiet strategy keeps a low
-     * seq alive long after a chatty one has evicted everything above it, and the oldest record held
-     * then says nothing about what a resuming client is missing.
-     */
-    highestDroppedSeq(): number;
-    /** Records appended since the last drain, oldest first. Reads the publish frontier — does not evict. */
-    drain(): TimelineRecord[];
-    /** Drop every record. The seq counter is deliberately not rewound. */
-    teardown(): void;
-}
-export declare function createTimelineBuffer(options?: TimelineBufferOptions): TimelineBuffer;
-/** The process's telemetry buffer, minted (with its epoch) on first use. */
-export declare function getTimelineBuffer(): TimelineBuffer;
-/**
- * Drop the process buffer on plugin reload or shutdown. The next {@link getTimelineBuffer} mints a
- * fresh epoch, so the restarted seq run cannot collide with the one a client already holds.
- */
-export declare function teardownTimelineBuffer(): void;
-//# sourceMappingURL=timeline-buffer.d.ts.map

package/dist/telemetry/timeline-buffer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"timeline-buffer.d.ts","sourceRoot":"","sources":["../../src/telemetry/timeline-buffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAKjE;;;;;;;;GAQG;AACH,eAAO,MAAM,+BAA+B,OAAO,CAAC;AAEpD,wGAAwG;AACxG,eAAO,MAAM,SAAS,IAAI,CAAC;AAE3B,2EAA2E;AAC3E,MAAM,WAAW,mBAAmB;IAClC,qDAAqD;IACrD,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAClC;AAED,yEAAyE;AACzE,MAAM,WAAW,cAAe,SAAQ,mBAAmB;IACzD,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wGAAwG;AACxG,MAAM,WAAW,aAAa;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,yFAAyF;IACzF,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,MAAM,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACzC,8CAA8C;IAC9C,IAAI,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,cAAc,EAAE,CAAC;IAC9C,kGAAkG;IAClG,QAAQ,IAAI,MAAM,GAAG,SAAS,CAAC;IAC/B;;;;;;;OAOG;IACH,iBAAiB,IAAI,MAAM,CAAC;IAC5B,wGAAwG;IACxG,KAAK,IAAI,cAAc,EAAE,CAAC;IAC1B,sEAAsE;IACtE,QAAQ,IAAI,IAAI,CAAC;CAClB;AAkDD,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,qBAA0B,GAAG,cAAc,CA8IxF;AAMD,4EAA4E;AAC5E,wBAAgB,iBAAiB,IAAI,cAAc,CAGlD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAG7C"}