pyric 0.1.0-alpha.21 → 0.1.0-alpha.24

package/dist/sandbox/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sandbox/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEtE,YAAY,EACV,uBAAuB,EACvB,QAAQ,EACR,SAAS,EACT,aAAa,EACb,WAAW,EACX,UAAU,EACV,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,OAAO,EACP,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAM7D,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACtF,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,aAAa,CAAC;AAKrB,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AASjF,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC1E,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAK9D,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,yBAAyB,EACzB,cAAc,GACf,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,aAAa,EACb,WAAW,EACX,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAGhC,YAAY,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,aAAkB,GAAG,YAAY,CAK3E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sandbox/index.ts"],"names":[],"mappings":"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"}

package/dist/sandbox/index.js

@@ -15,9 +15,18 @@
  * the design rationale for the design rationale.
  */
 import { createSandboxRoot } from './internal/root.js';
-export { SandboxError } from './types/index.js';
+export { SandboxError, MUTATION_EVENT_SERVICES, SERVICE_EVENT_RECORDS } from './types/index.js';
 export { SandboxContextImpl, normalizeAuthState, validateAuthState, } from './sandbox-context.js';
-export { isOperationEvent, operationContextFor, rulesDispositionFor, toOperationRecord, } from './operation-record.js';
+// The sandbox clock: the one source of time every service on the sandbox
+// reads. `getClock(sandbox).set(...)` / `.advance(...)` / `.reset()` move
+// Firestore `serverTimestamp()` and `request.time`, Realtime Database
+// `ServerValue.TIMESTAMP` and rules `now`, Storage `timeCreated` / `updated`,
+// auth token `iat` / `exp` / `auth_time`, and every listener and event stamp
+// together.
+export { SandboxClock, wallClockState } from './clock.js';
+export { getClock } from './clock.js';
+export { isOperationEvent, operationContextFor, rulesDispositionFor, toListenerRecord, toOperationRecord, trafficOperationEvent, } from './operation-record.js';
+export { activeListeners, activeListenerTargetStartsWith } from './active-listeners.js';
 // Remote sandbox (slice 1) — the brand + minimal channel contract that
 // lets `pyric-admin` recognize a Node-side handle onto the browser-hosted
 // worker sandbox (constructed by `@pyric/cli`' `connectRemoteSandbox`)
@@ -27,14 +36,19 @@ export { REMOTE_SANDBOX, REMOTE_SANDBOX_FACTORY, isRemoteSandbox } from './remot
 // issue every write against a fresh sandbox. See
 // `docs/how-to/replay-events.md`.
 export { replay } from './replay/index.js';
+// Full sandbox state: the whole sandbox as one JSON value, and the total
+// replace that installs one. Firestore documents, the Realtime Database tree,
+// Storage objects with their bytes and metadata, auth accounts, and the three
+// rule sources. This is what a branch forks from and promotes onto.
+export { captureFullState, applyFullState, holdsBytesInline } from './full-state.js';
 // Branches — fork/apply/diff/promote/discard experiments built on top of
-// `snapshot()` + `replay()`. A branch is an isolated in-memory sandbox
-// seeded from a `SandboxSnapshot`; `apply` re-issues events via `replay`,
-// `diff` is a focused doc-level structural diff (reuses `Divergence`),
-// `promote` lands the branch's mutations on a target, `discard` drops it.
-// Substrate for Studio's agent dry-run/accept, rules-edit branches, and
-// time-travel. See the design rationale.
-export { apply, discard, diff, fork, promote } from './branches/index.js';
+// `captureFullState()` + `applyFullState()`. A branch is an isolated
+// in-memory sandbox seeded from a `FullSandboxState`, so it carries every
+// service; `apply` re-issues captured writes onto it, `diff` walks the two
+// states service by service (reuses `Divergence`), `promote` writes that
+// same walk onto a target, `discard` drops it. Substrate for Studio's agent
+// dry-run/accept, rules-edit branches, and time-travel.
+export { apply, discard, diff, diffFullStates, fork, promote, promoteFullState } from './branches/index.js';
 export { attachPersistence, createIndexedDBBackend, createMemoryBackend, recordBackendOverBlob, serializeToBuckets, deserializeFromBuckets, bundleRecords, parseBundle, PersistenceSchemaError, rehydrateDocValue, } from './persistence/index.js';
 export { attachTabSync } from './tab-sync/index.js';
 /**

package/dist/sandbox/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sandbox/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAmCvD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAG/B,uEAAuE;AACvE,0EAA0E;AAC1E,uEAAuE;AACvE,yEAAyE;AACzE,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAQtF,oEAAoE;AACpE,iDAAiD;AACjD,kCAAkC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAG3C,yEAAyE;AACzE,uEAAuE;AACvE,0EAA0E;AAC1E,uEAAuE;AACvE,0EAA0E;AAC1E,wEAAwE;AACxE,yCAAyC;AACzC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAY1E,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,aAAa,EACb,WAAW,EACX,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAIhC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAyB,EAAE;IAC3D,4DAA4D;IAC5D,0DAA0D;IAC1D,sCAAsC;IACtC,OAAO,iBAAiB,EAAE,CAAC;AAC7B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sandbox/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AA0CvD,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAChG,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAC9B,yEAAyE;AACzE,0EAA0E;AAC1E,sEAAsE;AACtE,8EAA8E;AAC9E,6EAA6E;AAC7E,YAAY;AACZ,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE1D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,eAAe,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AAGxF,uEAAuE;AACvE,0EAA0E;AAC1E,uEAAuE;AACvE,yEAAyE;AACzE,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAQtF,oEAAoE;AACpE,iDAAiD;AACjD,kCAAkC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAG3C,yEAAyE;AACzE,8EAA8E;AAC9E,8EAA8E;AAC9E,oEAAoE;AACpE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAWrF,yEAAyE;AACzE,qEAAqE;AACrE,0EAA0E;AAC1E,2EAA2E;AAC3E,yEAAyE;AACzE,4EAA4E;AAC5E,wDAAwD;AACxD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAkB5G,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,aAAa,EACb,WAAW,EACX,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAIhC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAyB,EAAE;IAC3D,4DAA4D;IAC5D,0DAA0D;IAC1D,sCAAsC;IACtC,OAAO,iBAAiB,EAAE,CAAC;AAC7B,CAAC"}

package/dist/sandbox/internal/ai-evidence.d.ts

@@ -0,0 +1,27 @@
+/** Payload-free observations. Routed identity is distinct from backend-reported identity. */
+export interface AiEvidence {
+    requestedModel: string;
+    routedModel?: string;
+    reportedModel?: string;
+    engine: 'scripted' | 'openai' | 'gemini' | 'custom' | 'unknown';
+    endpoint?: string;
+    mappingReason?: string;
+    usageSource: 'backend' | 'estimated' | 'scripted' | 'unknown';
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+    durationMs?: number;
+    firstChunkMs?: number;
+}
+export declare function setAiEvidence<T extends object>(value: T, detail: Partial<AiEvidence>): T;
+export declare function getAiEvidence(value: object): Partial<AiEvidence> | undefined;
+/** Strip credentials, paths, and query parameters from diagnostic endpoints. */
+export declare function aiEndpoint(value?: string): string | undefined;
+/** Explicit worker envelope; the page removes it before enhancing Firebase results. */
+export declare function packAiEvidence<T extends object>(response: T): T & {
+    __pyricAi?: Partial<AiEvidence>;
+};
+export declare function unpackAiEvidence<T extends object>(response: T & {
+    __pyricAi?: Partial<AiEvidence>;
+}): T;
+//# sourceMappingURL=ai-evidence.d.ts.map

package/dist/sandbox/internal/ai-evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-evidence.d.ts","sourceRoot":"","sources":["../../../src/sandbox/internal/ai-evidence.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,MAAM,WAAW,UAAU;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAKD,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAGxF;AACD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,SAAS,CAAgC;AAC7G,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG7D;AAED,uFAAuF;AACvF,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAA;CAAE,CAErG;AACD,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAA;CAAE,GAAG,CAAC,CAGvG"}

package/dist/sandbox/internal/ai-evidence.js

@@ -0,0 +1,29 @@
+// Out-of-band metadata never changes Firebase response envelopes.
+const key = Symbol.for('pyric.ai-evidence');
+const store = globalThis;
+const evidence = store[key] ??= new WeakMap();
+export function setAiEvidence(value, detail) {
+    evidence.set(value, Object.freeze({ ...detail }));
+    return value;
+}
+export function getAiEvidence(value) { return evidence.get(value); }
+/** Strip credentials, paths, and query parameters from diagnostic endpoints. */
+export function aiEndpoint(value) {
+    if (!value)
+        return;
+    try {
+        return new URL(value).origin;
+    }
+    catch {
+        return 'Same-origin proxy';
+    }
+}
+/** Explicit worker envelope; the page removes it before enhancing Firebase results. */
+export function packAiEvidence(response) {
+    return { ...response, __pyricAi: getAiEvidence(response) };
+}
+export function unpackAiEvidence(response) {
+    const { __pyricAi, ...plain } = response;
+    return setAiEvidence(plain, __pyricAi ?? {});
+}
+//# sourceMappingURL=ai-evidence.js.map

package/dist/sandbox/internal/ai-evidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-evidence.js","sourceRoot":"","sources":["../../../src/sandbox/internal/ai-evidence.ts"],"names":[],"mappings":"AAeA,kEAAkE;AAClE,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;AAC5C,MAAM,KAAK,GAAG,UAA8D,CAAC;AAC7E,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,OAAO,EAA+B,CAAC;AAC3E,MAAM,UAAU,aAAa,CAAmB,KAAQ,EAAE,MAA2B;IACnF,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC;IAClD,OAAO,KAAK,CAAC;AACf,CAAC;AACD,MAAM,UAAU,aAAa,CAAC,KAAa,IAAqC,OAAO,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC7G,gFAAgF;AAChF,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,IAAI,CAAC;QAAC,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,mBAAmB,CAAC;IAAC,CAAC;AAC7E,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,cAAc,CAAmB,QAAW;IAC1D,OAAO,EAAE,GAAG,QAAQ,EAAE,SAAS,EAAE,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;AAC7D,CAAC;AACD,MAAM,UAAU,gBAAgB,CAAmB,QAAiD;IAClG,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,GAAG,QAAQ,CAAC;IACzC,OAAO,aAAa,CAAC,KAAU,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC;AACpD,CAAC"}

package/dist/sandbox/internal/event-history.d.ts

@@ -0,0 +1,32 @@
+import { type EventHistoryLimits } from './history-retention.js';
+export type { EventHistoryLimits } from './history-retention.js';
+import type { SandboxEvent } from '../types/events.js';
+/** One observation history owner; adapters may bound retention without truncating undo state. */
+export declare class EventHistory {
+    private readonly limits?;
+    private entries;
+    private bytes;
+    private liveCount;
+    private liveBytes;
+    private readonly activeRequests;
+    private readonly completedRequests;
+    private readonly activeListeners;
+    private readonly retainedIds;
+    private readonly rulesEvidence;
+    private sourceGapCount;
+    private gap;
+    constructor(limits?: EventHistoryLimits | undefined);
+    get length(): number;
+    append(event: SandboxEvent): void;
+    snapshot(): SandboxEvent[];
+    clear(): void;
+    private forgetId;
+    private trackListener;
+    private expireRulesEvidence;
+    private reserveLive;
+    private releaseLive;
+    private prune;
+    private exceedsLimits;
+    private omit;
+}
+//# sourceMappingURL=event-history.d.ts.map

package/dist/sandbox/internal/event-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-history.d.ts","sourceRoot":"","sources":["../../../src/sandbox/internal/event-history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC/E,YAAY,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,KAAK,EAAE,YAAY,EAA8B,MAAM,oBAAoB,CAAC;AAOnF,iGAAiG;AACjG,qBAAa,YAAY;IAcX,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAbpC,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,KAAK,CAAK;IAElB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAmC;IAClE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAqB;IACvD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAmC;IACnE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA8C;IAC5E,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,GAAG,CAAyC;gBAEvB,MAAM,CAAC,EAAE,kBAAkB,YAAA;IAExD,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IA8CjC,QAAQ,IAAI,YAAY,EAAE;IAQ1B,KAAK,IAAI,IAAI;IAcb,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,aAAa;IAmBrB,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,KAAK;IAcb,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,IAAI;CAeb"}

package/dist/sandbox/internal/event-history.js

@@ -0,0 +1,199 @@
+import { encodedBytes } from './history-retention.js';
+import { RulesEvidenceRetention } from './rules-evidence-retention.js';
+/** One observation history owner; adapters may bound retention without truncating undo state. */
+export class EventHistory {
+    limits;
+    entries = [];
+    bytes = 0;
+    // Live state remains visible; its reservation may use at most half the history budget.
+    liveCount = 0;
+    liveBytes = 0;
+    activeRequests = new Map();
+    completedRequests = new Set();
+    activeListeners = new Map();
+    retainedIds = new Set();
+    rulesEvidence = new RulesEvidenceRetention();
+    sourceGapCount = 0;
+    gap;
+    constructor(limits) {
+        this.limits = limits;
+    }
+    get length() {
+        return this.snapshot().length;
+    }
+    append(event) {
+        const observation = event.kind === 'operation' ? event.observation : undefined;
+        const isBounded = this.limits !== undefined;
+        const bytes = isBounded ? encodedBytes(event) + 1 : 0;
+        if (observation?.status === 'pending') {
+            if (this.completedRequests.has(observation.id))
+                return;
+            const previous = this.activeRequests.get(observation.id);
+            if (previous)
+                this.releaseLive(previous);
+            const entry = { event, bytes };
+            this.activeRequests.set(observation.id, entry);
+            this.reserveLive(entry);
+            this.prune();
+            return;
+        }
+        if (observation) {
+            const pending = this.activeRequests.get(observation.id);
+            if (pending)
+                this.releaseLive(pending);
+            this.activeRequests.delete(observation.id);
+            this.completedRequests.add(observation.id);
+        }
+        this.trackListener(event, bytes);
+        if (this.retainedIds.has(event.id))
+            return;
+        this.retainedIds.add(event.id);
+        const activeListener = 'listenerId' in event ? this.activeListeners.get(event.listenerId) : undefined;
+        const retainsListener = activeListener?.event.id === event.id;
+        if (retainsListener)
+            this.releaseLive(activeListener);
+        const isPriorEviction = isBounded && event.kind === 'observation_gap' && event.reason === 'history-limit';
+        const mustOmit = isPriorEviction || !Number.isFinite(bytes);
+        if (mustOmit) {
+            this.forgetId(event);
+            if (isPriorEviction) {
+                const omittedCount = Math.max(0, event.omittedCount - this.sourceGapCount);
+                this.sourceGapCount = Math.max(this.sourceGapCount, event.omittedCount);
+                if (omittedCount)
+                    this.omit({ ...event, omittedCount });
+            }
+            else
+                this.omit(event);
+        }
+        else {
+            const entry = { event, bytes };
+            this.entries.push(entry);
+            this.bytes += bytes;
+            const expired = this.rulesEvidence.record(entry);
+            const hasExpiredEvidence = expired !== undefined;
+            if (hasExpiredEvidence)
+                this.expireRulesEvidence(expired);
+        }
+        this.prune();
+    }
+    snapshot() {
+        const events = [...this.entries.map(entry => entry.event), ...[...this.activeRequests.values()].map(entry => entry.event),
+            ...[...this.activeListeners.values()].map(entry => entry.event).filter(event => !this.retainedIds.has(event.id))];
+        const gap = this.gap;
+        const hasGap = gap !== undefined;
+        return hasGap ? [{ ...gap }, ...events] : events;
+    }
+    clear() {
+        this.entries = [];
+        this.activeRequests.clear();
+        this.activeListeners.clear();
+        this.completedRequests.clear();
+        this.retainedIds.clear();
+        this.rulesEvidence.clear();
+        this.bytes = 0;
+        this.liveCount = 0;
+        this.liveBytes = 0;
+        this.gap = undefined;
+        this.sourceGapCount = 0;
+    }
+    forgetId(event) {
+        this.retainedIds.delete(event.id);
+        const listener = 'listenerId' in event ? this.activeListeners.get(event.listenerId) : undefined;
+        const isActiveListener = listener?.event.id === event.id;
+        if (isActiveListener)
+            this.reserveLive(listener);
+        const observation = event.kind === 'operation' ? event.observation : undefined;
+        if (observation)
+            this.completedRequests.delete(observation.id);
+    }
+    trackListener(event, bytes) {
+        if (!('listenerId' in event))
+            return;
+        const attaches = event.kind === 'listener_attach' || (event.kind === 'listener' && event.phase === 'attach');
+        const closes = event.kind === 'listener_detach' || event.kind === 'listener_errored'
+            || (event.kind === 'listener' && (event.phase === 'detach' || event.phase === 'errored'));
+        const changesRegistration = attaches || closes;
+        if (!changesRegistration)
+            return;
+        const previous = this.activeListeners.get(event.listenerId);
+        const previousIsLiveOnly = previous !== undefined && !this.retainedIds.has(previous.event.id);
+        if (previousIsLiveOnly)
+            this.releaseLive(previous);
+        if (attaches) {
+            const entry = { event, bytes };
+            this.activeListeners.set(event.listenerId, entry);
+            const isLiveOnly = !this.retainedIds.has(event.id);
+            if (isLiveOnly)
+                this.reserveLive(entry);
+        }
+        else
+            this.activeListeners.delete(event.listenerId);
+        if (previousIsLiveOnly)
+            this.omit(previous.event);
+    }
+    expireRulesEvidence(entry) {
+        const event = entry.event;
+        const isOtherEvent = event.kind !== 'request';
+        if (isOtherEvent)
+            return;
+        const { rulesEvidence, ...metadata } = event;
+        entry.event = { ...metadata, rulesEvidenceExpired: true };
+        const isBounded = this.limits !== undefined;
+        const bytes = isBounded ? encodedBytes(entry.event) + 1 : 0;
+        this.bytes += bytes - entry.bytes;
+        entry.bytes = bytes;
+    }
+    reserveLive(entry) {
+        this.liveCount++;
+        this.liveBytes += entry.bytes;
+    }
+    releaseLive(entry) {
+        this.liveCount--;
+        this.liveBytes -= entry.bytes;
+    }
+    prune() {
+        let exceedsLimits = this.exceedsLimits();
+        while (exceedsLimits) {
+            const oldest = this.entries.shift();
+            const isEmpty = oldest === undefined;
+            if (isEmpty)
+                break;
+            this.forgetId(oldest.event);
+            this.rulesEvidence.forget(oldest);
+            this.bytes -= oldest.bytes;
+            this.omit(oldest.event);
+            exceedsLimits = this.exceedsLimits();
+        }
+    }
+    exceedsLimits() {
+        const limits = this.limits;
+        const isUnbounded = limits === undefined;
+        if (isUnbounded)
+            return false;
+        const hasNoGap = this.gap === undefined;
+        const gapBytes = hasNoGap ? 0 : encodedBytes(this.gap) + 1;
+        const reservedEvents = Math.min(this.liveCount, Math.floor(limits.maxEvents / 2));
+        const reservedBytes = Math.min(this.liveBytes, Math.floor(limits.maxBytes / 2));
+        const eventCount = this.entries.length + reservedEvents;
+        const exceedsCount = eventCount > limits.maxEvents;
+        const exceedsBytes = this.bytes + reservedBytes + gapBytes + 2 > limits.maxBytes;
+        return exceedsCount || exceedsBytes;
+    }
+    omit(event) {
+        const listener = 'listenerId' in event ? this.activeListeners.get(event.listenerId) : undefined;
+        const remainsVisible = listener?.event.id === event.id;
+        if (remainsVisible)
+            return;
+        const isGap = event.kind === 'observation_gap';
+        const count = isGap ? event.omittedCount : 1;
+        const first = isGap ? event.firstEventId : event.id;
+        const last = isGap ? event.lastEventId : event.id;
+        this.gap = {
+            kind: 'observation_gap', reason: 'history-limit', id: 'history-gap',
+            at: this.gap?.at ?? event.at,
+            firstEventId: this.gap?.firstEventId ?? first, lastEventId: last,
+            omittedCount: (this.gap?.omittedCount ?? 0) + count,
+        };
+    }
+}
+//# sourceMappingURL=event-history.js.map

package/dist/sandbox/internal/event-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-history.js","sourceRoot":"","sources":["../../../src/sandbox/internal/event-history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA2B,MAAM,wBAAwB,CAAC;AAE/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAQvE,iGAAiG;AACjG,MAAM,OAAO,YAAY;IAcM;IAbrB,OAAO,GAAmB,EAAE,CAAC;IAC7B,KAAK,GAAG,CAAC,CAAC;IAClB,uFAAuF;IAC/E,SAAS,GAAG,CAAC,CAAC;IACd,SAAS,GAAG,CAAC,CAAC;IACL,cAAc,GAAG,IAAI,GAAG,EAAwB,CAAC;IACjD,iBAAiB,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,eAAe,GAAG,IAAI,GAAG,EAAwB,CAAC;IAClD,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,aAAa,GAAG,IAAI,sBAAsB,EAAgB,CAAC;IACpE,cAAc,GAAG,CAAC,CAAC;IACnB,GAAG,CAAyC;IAEpD,YAA6B,MAA2B;QAA3B,WAAM,GAAN,MAAM,CAAqB;IAAG,CAAC;IAE5D,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC;IAChC,CAAC;IAED,MAAM,CAAC,KAAmB;QACxB,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/E,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC;QAC5C,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACtD,IAAI,WAAW,EAAE,MAAM,KAAK,SAAS,EAAE,CAAC;YACtC,IAAI,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;gBAAE,OAAO;YACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;YACzD,IAAI,QAAQ;gBAAE,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YACzC,MAAM,KAAK,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;YAC/B,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YAC/C,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YACxB,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QACD,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;YACxD,IAAI,OAAO;gBAAE,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YACvC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;YAC3C,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAC7C,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACjC,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAAE,OAAO;QAC3C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC/B,MAAM,cAAc,GAAG,YAAY,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACtG,MAAM,eAAe,GAAG,cAAc,EAAE,KAAK,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC;QAC9D,IAAI,eAAe;YAAE,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;QACtD,MAAM,eAAe,GAAG,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB,IAAI,KAAK,CAAC,MAAM,KAAK,eAAe,CAAC;QAC1G,MAAM,QAAQ,GAAG,eAAe,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC5D,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YACrB,IAAI,eAAe,EAAE,CAAC;gBACpB,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC;gBAC3E,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;gBACxE,IAAI,YAAY;oBAAE,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;YAC1D,CAAC;;gBAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,MAAM,KAAK,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;YAC/B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC;YACpB,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACjD,MAAM,kBAAkB,GAAG,OAAO,KAAK,SAAS,CAAC;YACjD,IAAI,kBAAkB;gBAAE,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IAED,QAAQ;QACN,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC;YACvH,GAAG,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACpH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACrB,MAAM,MAAM,GAAG,GAAG,KAAK,SAAS,CAAC;QACjC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACnD,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC5B,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;QAC7B,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAC;QAC/B,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;QACf,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC,GAAG,GAAG,SAAS,CAAC;QACrB,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;IAC1B,CAAC;IAEO,QAAQ,CAAC,KAAmB;QAClC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAG,YAAY,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAChG,MAAM,gBAAgB,GAAG,QAAQ,EAAE,KAAK,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC;QACzD,IAAI,gBAAgB;YAAE,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QACjD,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/E,IAAI,WAAW;YAAE,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IACjE,CAAC;IAEO,aAAa,CAAC,KAAmB,EAAE,KAAa;QACtD,IAAI,CAAC,CAAC,YAAY,IAAI,KAAK,CAAC;YAAE,OAAO;QACrC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,KAAK,iBAAiB,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC;QAC7G,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,KAAK,iBAAiB,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB;eAC/E,CAAC,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC;QAC5F,MAAM,mBAAmB,GAAG,QAAQ,IAAI,MAAM,CAAC;QAC/C,IAAI,CAAC,mBAAmB;YAAE,OAAO;QACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC5D,MAAM,kBAAkB,GAAG,QAAQ,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC9F,IAAI,kBAAkB;YAAE,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QACnD,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;YAC/B,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;YAClD,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACnD,IAAI,UAAU;gBAAE,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAC1C,CAAC;;YAAM,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACrD,IAAI,kBAAkB;YAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpD,CAAC;IAEO,mBAAmB,CAAC,KAAmB;QAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAC1B,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC;QAC9C,IAAI,YAAY;YAAE,OAAO;QACzB,MAAM,EAAE,aAAa,EAAE,GAAG,QAAQ,EAAE,GAAG,KAAK,CAAC;QAC7C,KAAK,CAAC,KAAK,GAAG,EAAE,GAAG,QAAQ,EAAE,oBAAoB,EAAE,IAAI,EAAE,CAAC;QAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC;QAC5C,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5D,IAAI,CAAC,KAAK,IAAI,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAClC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;IACtB,CAAC;IAEO,WAAW,CAAC,KAAmB;QACrC,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC,KAAK,CAAC;IAChC,CAAC;IAEO,WAAW,CAAC,KAAmB;QACrC,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC,KAAK,CAAC;IAChC,CAAC;IAEO,KAAK;QACX,IAAI,aAAa,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACzC,OAAO,aAAa,EAAE,CAAC;YACrB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACpC,MAAM,OAAO,GAAG,MAAM,KAAK,SAAS,CAAC;YACrC,IAAI,OAAO;gBAAE,MAAM;YACnB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5B,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAClC,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC;YAC3B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACxB,aAAa,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACvC,CAAC;IACH,CAAC;IAEO,aAAa;QACnB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,MAAM,WAAW,GAAG,MAAM,KAAK,SAAS,CAAC;QACzC,IAAI,WAAW;YAAE,OAAO,KAAK,CAAC;QAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,KAAK,SAAS,CAAC;QACxC,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3D,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC;QAClF,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC;QAChF,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,cAAc,CAAC;QACxD,MAAM,YAAY,GAAG,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC;QACnD,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,GAAG,aAAa,GAAG,QAAQ,GAAG,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;QACjF,OAAO,YAAY,IAAI,YAAY,CAAC;IACtC,CAAC;IAEO,IAAI,CAAC,KAAmB;QAC9B,MAAM,QAAQ,GAAG,YAAY,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAChG,MAAM,cAAc,GAAG,QAAQ,EAAE,KAAK,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC;QACvD,IAAI,cAAc;YAAE,OAAO;QAC3B,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,KAAK,iBAAiB,CAAC;QAC/C,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;QAClD,IAAI,CAAC,GAAG,GAAG;YACT,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,eAAe,EAAE,EAAE,EAAE,aAAa;YACnE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,KAAK,CAAC,EAAE;YAC5B,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE,YAAY,IAAI,KAAK,EAAE,WAAW,EAAE,IAAI;YAChE,YAAY,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,IAAI,CAAC,CAAC,GAAG,KAAK;SACpD,CAAC;IACJ,CAAC;CACF"}

package/dist/sandbox/internal/history-integrity.d.ts

@@ -0,0 +1,3 @@
+/** A retained suffix cannot stand in for a complete replay or verification input. */
+export declare function assertCompleteHistory(events: readonly unknown[]): void;
+//# sourceMappingURL=history-integrity.d.ts.map

package/dist/sandbox/internal/history-integrity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-integrity.d.ts","sourceRoot":"","sources":["../../../src/sandbox/internal/history-integrity.ts"],"names":[],"mappings":"AAEA,qFAAqF;AACrF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,CAQtE"}

package/dist/sandbox/internal/history-integrity.js

@@ -0,0 +1,12 @@
+import { SandboxError } from '../types/errors.js';
+/** A retained suffix cannot stand in for a complete replay or verification input. */
+export function assertCompleteHistory(events) {
+    const hasGap = events.some(event => {
+        const isRecord = event !== null && typeof event === 'object';
+        const isGap = isRecord && 'kind' in event && event.kind === 'observation_gap';
+        return isGap;
+    });
+    if (hasGap)
+        throw new SandboxError('failed-precondition', 'Cannot replay or verify incomplete observation history. Capture a fresh session without observation gaps.');
+}
+//# sourceMappingURL=history-integrity.js.map

package/dist/sandbox/internal/history-integrity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-integrity.js","sourceRoot":"","sources":["../../../src/sandbox/internal/history-integrity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,qFAAqF;AACrF,MAAM,UAAU,qBAAqB,CAAC,MAA0B;IAC9D,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;QACjC,MAAM,QAAQ,GAAG,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;QAC7D,MAAM,KAAK,GAAG,QAAQ,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB,CAAC;QAC9E,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;IACH,IAAI,MAAM;QAAE,MAAM,IAAI,YAAY,CAAC,qBAAqB,EACtD,2GAA2G,CAAC,CAAC;AACjH,CAAC"}

package/dist/sandbox/internal/history-retention.d.ts

@@ -0,0 +1,6 @@
+export interface EventHistoryLimits {
+    maxEvents: number;
+    maxBytes: number;
+}
+export declare function encodedBytes(value: unknown): number;
+//# sourceMappingURL=history-retention.d.ts.map

package/dist/sandbox/internal/history-retention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-retention.d.ts","sourceRoot":"","sources":["../../../src/sandbox/internal/history-retention.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAOnD"}

package/dist/sandbox/internal/history-retention.js

@@ -0,0 +1,12 @@
+const utf8 = new TextEncoder();
+export function encodedBytes(value) {
+    try {
+        const json = JSON.stringify(value);
+        const hasBuffer = typeof Buffer === 'function';
+        return hasBuffer ? Buffer.byteLength(json) : utf8.encode(json).byteLength;
+    }
+    catch {
+        return Infinity;
+    }
+}
+//# sourceMappingURL=history-retention.js.map

package/dist/sandbox/internal/history-retention.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-retention.js","sourceRoot":"","sources":["../../../src/sandbox/internal/history-retention.ts"],"names":[],"mappings":"AAKA,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC;AAE/B,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,SAAS,GAAG,OAAO,MAAM,KAAK,UAAU,CAAC;QAC/C,OAAO,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC;IAC5E,CAAC;IACD,MAAM,CAAC;QAAC,OAAO,QAAQ,CAAC;IAAC,CAAC;AAC5B,CAAC"}

package/dist/sandbox/internal/index.d.ts

@@ -15,6 +15,24 @@
  * scope summary".
  */
 export { getInternalEnv } from './sandbox-impl.js';
+export { decodeImportBundle, validatePersistenceEncoding } from '../persistence/import-bundle.js';
+export { validatePersistedService, persistedServiceHasData, UnsupportedPersistedServiceError } from '../persistence/validate-services.js';
+export { seedUserSchema, storedMetadataSchema } from './state-schemas.js';
+export { captureIndexQuery, analyzeIndexQuery, readIndexConfig, type IndexQuery, type IndexFinding } from '../../rules/indexes/query-analysis.js';
+export type { IndexesConfig, IndexesConfigEntry } from '../../rules/indexes/types.js';
+export { analyzeServiceIndex, captureDatabaseIndexQuery, databaseIndexLocations, indexService, isDatabaseIndexQuery, type DatabaseIndexQuery, type DatabaseIndexDefinition, type DatabaseIndexConfig, type ServiceIndexQuery, type ServiceIndexConfig, type ServiceIndexDefinition, type ServiceIndexFinding, } from '../../rules/indexes/service-query.js';
+export { observationService, type SdkObservation } from './sdk-observation.js';
+export { runSdkWrite } from './sdk-write-activity.js';
+export { createSdkRates, createSdkRateMonitor, sdkRates } from './sdk-rates.js';
+export type { AiRequestObservation, SdkRateSnapshot, SdkServiceRate, SdkMethodRate, SdkRateBucket } from './sdk-rates.js';
+export { sdkMethodCoverage } from './sdk-coverage.js';
+export type { SdkMethodCoverage, SdkMethodCategory } from './sdk-coverage.js';
+export { createSdkActivityJournal, finishSdkRead, sdkActivity, type SdkActivityEvent, type SdkActivityHandle, type SdkActivityRecord, type SdkActivitySource, } from './sdk-activity.js';
+export { configureListenerAttribution, listenerAttributionEnabled, listenerAttributionMode, type ListenerAttributionMode, } from '../attribution/attribution-mode.js';
+export { callerFrameFromStack, captureCreationFrame, listenerAttachOwners, tagOwnerFor, type ComponentOwnerInput, type ListenerAttribution, type ListenerOwnerHint, type RecordedListenerOwners, } from '../attribution/listener-owners.js';
+export { recordEffectRegions } from '../attribution/effect-regions.js';
+export { isSelectableElement, ownerSelectorFor, tagNameOf, type SelectableElement, } from '../attribution/element-selector.js';
+export { getClock } from '../clock.js';
 export { stampProvenance } from './provenance.js';
 export { bindOperationContext } from '../sandbox-context.js';
 export { provenanceForOperationContext, resolveOperationContext, } from '../operation-record.js';
@@ -37,4 +55,13 @@ export * from '../../firestore/sandbox/converters/bytes-geopoint.js';
 export * from '../../firestore/sandbox/snapshot-listeners.js';
 export * from '../../firestore/sandbox/wire-encoder.js';
 export { createSandboxRoot } from './root.js';
+export { assertCompleteHistory } from './history-integrity.js';
+export { EventHistory } from './event-history.js';
+export { firestoreReadUsage } from './usage-evidence.js';
+export type { UsageEvidence } from './usage-evidence.js';
+export { OBSERVATION_HISTORY_LIMITS } from './observation-history.js';
+export { observationPayload, observationText } from './observation-payload.js';
+export { aiCompletionUsage } from './usage-evidence.js';
+export { requestStatusLabel } from '../types/request-observation.js';
+export { createActiveListenerState } from '../active-listeners.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/sandbox/internal/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sandbox/internal/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EACL,6BAA6B,EAC7B,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAUhC,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,wBAAwB,EACxB,yBAAyB,EACzB,4BAA4B,EAC5B,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAiB3B,cAAc,8CAA8C,CAAC;AAC7D,OAAO,EACL,UAAU,EACV,KAAK,cAAc,EACnB,KAAK,WAAW,IAAI,qBAAqB,EACzC,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,YAAY,GAClB,MAAM,wCAAwC,CAAC;AAChD,cAAc,sCAAsC,CAAC;AACrD,cAAc,oCAAoC,CAAC;AACnD,cAAc,wCAAwC,CAAC;AACvD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,8CAA8C,CAAC;AAC7D,cAAc,mCAAmC,CAAC;AAClD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,iDAAiD,CAAC;AAChE,cAAc,sDAAsD,CAAC;AACrE,cAAc,iDAAiD,CAAC;AAChE,cAAc,8CAA8C,CAAC;AAC7D,cAAc,kDAAkD,CAAC;AACjE,cAAc,sDAAsD,CAAC;AACrE,cAAc,+CAA+C,CAAC;AAK9D,cAAc,yCAAyC,CAAC;AAWxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sandbox/internal/index.ts"],"names":[],"mappings":"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"}

package/dist/sandbox/internal/index.js

@@ -15,6 +15,24 @@
  * scope summary".
  */
 export { getInternalEnv } from './sandbox-impl.js';
+export { decodeImportBundle, validatePersistenceEncoding } from '../persistence/import-bundle.js';
+export { validatePersistedService, persistedServiceHasData, UnsupportedPersistedServiceError } from '../persistence/validate-services.js';
+export { seedUserSchema, storedMetadataSchema } from './state-schemas.js';
+export { captureIndexQuery, analyzeIndexQuery, readIndexConfig } from '../../rules/indexes/query-analysis.js';
+export { analyzeServiceIndex, captureDatabaseIndexQuery, databaseIndexLocations, indexService, isDatabaseIndexQuery, } from '../../rules/indexes/service-query.js';
+export { observationService } from './sdk-observation.js';
+export { runSdkWrite } from './sdk-write-activity.js';
+export { createSdkRates, createSdkRateMonitor, sdkRates } from './sdk-rates.js';
+export { sdkMethodCoverage } from './sdk-coverage.js';
+export { createSdkActivityJournal, finishSdkRead, sdkActivity, } from './sdk-activity.js';
+// Listener attribution: the owner records pyric stamps onto its own listener
+// events. Every mirrored surface with listeners reaches these, so they live in
+// the cross-surface runtime rather than in one surface's backend.
+export { configureListenerAttribution, listenerAttributionEnabled, listenerAttributionMode, } from '../attribution/attribution-mode.js';
+export { callerFrameFromStack, captureCreationFrame, listenerAttachOwners, tagOwnerFor, } from '../attribution/listener-owners.js';
+export { recordEffectRegions } from '../attribution/effect-regions.js';
+export { isSelectableElement, ownerSelectorFor, tagNameOf, } from '../attribution/element-selector.js';
+export { getClock } from '../clock.js';
 export { stampProvenance } from './provenance.js';
 export { bindOperationContext } from '../sandbox-context.js';
 export { provenanceForOperationContext, resolveOperationContext, } from '../operation-record.js';
@@ -73,4 +91,12 @@ export * from '../../firestore/sandbox/wire-encoder.js';
 // with explicit named re-exports once the admin-compat layer's
 // surface stops drifting.
 export { createSandboxRoot } from './root.js';
+export { assertCompleteHistory } from './history-integrity.js';
+export { EventHistory } from './event-history.js';
+export { firestoreReadUsage } from './usage-evidence.js';
+export { OBSERVATION_HISTORY_LIMITS } from './observation-history.js';
+export { observationPayload, observationText } from './observation-payload.js';
+export { aiCompletionUsage } from './usage-evidence.js';
+export { requestStatusLabel } from '../types/request-observation.js';
+export { createActiveListenerState } from '../active-listeners.js';
 //# sourceMappingURL=index.js.map

package/dist/sandbox/internal/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/sandbox/internal/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EACL,6BAA6B,EAC7B,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAEhC,oEAAoE;AACpE,sEAAsE;AACtE,wEAAwE;AACxE,sEAAsE;AACtE,sEAAsE;AACtE,sEAAsE;AACtE,uEAAuE;AACvE,0EAA0E;AAC1E,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,wBAAwB,EACxB,yBAAyB,EACzB,4BAA4B,EAC5B,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAE3B,iEAAiE;AACjE,iEAAiE;AACjE,oEAAoE;AACpE,gEAAgE;AAChE,8BAA8B;AAC9B,EAAE;AACF,iEAAiE;AACjE,oDAAoD;AACpD,iEAAiE;AACjE,0DAA0D;AAC1D,gEAAgE;AAChE,iEAAiE;AACjE,+DAA+D;AAC/D,4DAA4D;AAC5D,kBAAkB;AAClB,cAAc,8CAA8C,CAAC;AAC7D,OAAO,EACL,UAAU,GAOX,MAAM,wCAAwC,CAAC;AAChD,cAAc,sCAAsC,CAAC;AACrD,cAAc,oCAAoC,CAAC;AACnD,cAAc,wCAAwC,CAAC;AACvD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,8CAA8C,CAAC;AAC7D,cAAc,mCAAmC,CAAC;AAClD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,iDAAiD,CAAC;AAChE,cAAc,sDAAsD,CAAC;AACrE,cAAc,iDAAiD,CAAC;AAChE,cAAc,8CAA8C,CAAC;AAC7D,cAAc,kDAAkD,CAAC;AACjE,cAAc,sDAAsD,CAAC;AACrE,cAAc,+CAA+C,CAAC;AAC9D,iEAAiE;AACjE,6DAA6D;AAC7D,kEAAkE;AAClE,WAAW;AACX,cAAc,yCAAyC,CAAC;AAExD,iEAAiE;AACjE,mEAAmE;AACnE,qEAAqE;AACrE,4DAA4D;AAC5D,+DAA+D;AAC/D,oEAAoE;AACpE,iEAAiE;AACjE,+DAA+D;AAC/D,0BAA0B;AAC1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/sandbox/internal/index.ts"],"names":[],"mappings":"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"}

package/dist/sandbox/internal/observation-history.d.ts

@@ -0,0 +1,6 @@
+/** Shared count and byte bounds; elapsed time must not make replay history incomplete. */
+export declare const OBSERVATION_HISTORY_LIMITS: {
+    readonly maxEvents: 10000;
+    readonly maxBytes: number;
+};
+//# sourceMappingURL=observation-history.d.ts.map

package/dist/sandbox/internal/observation-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation-history.d.ts","sourceRoot":"","sources":["../../../src/sandbox/internal/observation-history.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,eAAO,MAAM,0BAA0B;;;CAG7B,CAAC"}

package/dist/sandbox/internal/observation-history.js

@@ -0,0 +1,6 @@
+/** Shared count and byte bounds; elapsed time must not make replay history incomplete. */
+export const OBSERVATION_HISTORY_LIMITS = {
+    maxEvents: 10_000,
+    maxBytes: 8 * 1024 * 1024,
+};
+//# sourceMappingURL=observation-history.js.map

package/dist/sandbox/internal/observation-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation-history.js","sourceRoot":"","sources":["../../../src/sandbox/internal/observation-history.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,SAAS,EAAE,MAAM;IACjB,QAAQ,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;CACjB,CAAC"}

package/dist/sandbox/internal/observation-payload.d.ts

@@ -0,0 +1,6 @@
+export declare function observationText(text: string): string;
+export declare function observationPayload(value: unknown, limit?: number): {
+    text: string;
+    truncated: boolean;
+} | undefined;
+//# sourceMappingURL=observation-payload.d.ts.map

package/dist/sandbox/internal/observation-payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation-payload.d.ts","sourceRoot":"","sources":["../../../src/sandbox/internal/observation-payload.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKpD;AACD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,CASlH"}

package/dist/sandbox/internal/observation-payload.js

@@ -0,0 +1,24 @@
+/** Diagnostic previews are bounded and omit credential fields at every depth. */
+const secretField = /password|credential|secret|token|authorization|cookie|api[-_]?key/i;
+export function observationText(text) {
+    return text
+        .replace(/\bBearer\s+[A-Za-z0-9._~+\/-]+=*/gi, 'Bearer [redacted]')
+        .replace(/\beyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\b/g, '[redacted token]')
+        .replace(/((?:password|api[-_]?key|access[-_]?token|refresh[-_]?token|secret)["']?\s*[:=]\s*["']?)[^\s"',;}]+/gi, '$1[redacted]');
+}
+export function observationPayload(value, limit = 16384) {
+    try {
+        const text = JSON.stringify(value, (key, item) => {
+            if (secretField.test(key))
+                return '[redacted]';
+            return typeof item === 'string' ? observationText(item) : item;
+        }, 2);
+        if (text === undefined)
+            return;
+        return { text: text.slice(0, limit), truncated: text.length > limit };
+    }
+    catch {
+        return;
+    }
+}
+//# sourceMappingURL=observation-payload.js.map