orbit-agent-runtime 0.8.0

package/dist/test/teardown_isolation.test.js

@@ -0,0 +1,279 @@
+"use strict";
+/**
+ * Teardown must be total even when a component fails to release.
+ *
+ * Both loops below used to `await` each release directly, so the first throw
+ * skipped every release behind it — and skipped the final `clear()`. Since each
+ * of those components may own a child process, one failing MCP teardown was
+ * enough to leak the entire remaining surface.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = require("node:test");
+const strict_1 = __importDefault(require("node:assert/strict"));
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const index_1 = require("../src/index");
+function makeCtx(overrides = {}) {
+    return { traceMarkId: "t-1", maxWaitMs: 1000, ...overrides };
+}
+/* ------------------------------------------------------------ ChannelHub */
+(0, node_test_1.test)("channel hub: a throwing teardown does not strand the channels behind it", async () => {
+    const released = [];
+    const mk = (id, throws) => ({
+        setup: async () => { },
+        teardown: async () => {
+            released.push(id);
+            if (throws)
+                throw new Error(`${id} exploded`);
+        },
+        determinismMeta: { determinism: index_1.DeterminismLevel.DETERMINISTIC }
+    });
+    const hub = new index_1.ChannelHub();
+    hub.registerBuiltInChannel(index_1.ChannelKind.MEM_KV_STORE, mk("kv", true));
+    hub.registerBuiltInChannel(index_1.ChannelKind.LLM_ACCESS, mk("llm", false));
+    hub.registerPluginExtChannel(index_1.ChannelKind.FILE_SYSTEM, mk("file", false));
+    // Does not reject: a failed release is contained, not propagated.
+    await hub.teardown();
+    strict_1.default.deepEqual(released, ["kv", "llm", "file"], "every channel was released");
+    // clear() ran despite the failure, so nothing is left registered.
+    strict_1.default.equal(hub.getEffectiveChannel(index_1.ChannelKind.LLM_ACCESS), undefined);
+    strict_1.default.equal(hub.getEffectiveChannel(index_1.ChannelKind.FILE_SYSTEM), undefined);
+    strict_1.default.deepEqual(hub.listCallContexts(), []);
+});
+(0, node_test_1.test)("channel hub: teardown still releases everything when the last channel throws", async () => {
+    const released = [];
+    const mk = (id, throws) => ({
+        setup: async () => { },
+        teardown: async () => {
+            released.push(id);
+            if (throws)
+                throw new Error(`${id} exploded`);
+        },
+        determinismMeta: { determinism: index_1.DeterminismLevel.DETERMINISTIC }
+    });
+    const hub = new index_1.ChannelHub();
+    hub.registerBuiltInChannel(index_1.ChannelKind.MEM_KV_STORE, mk("kv", false));
+    hub.registerPluginExtChannel(index_1.ChannelKind.FILE_SYSTEM, mk("file", true));
+    await hub.teardown();
+    strict_1.default.deepEqual(released, ["kv", "file"]);
+    strict_1.default.equal(hub.getEffectiveChannel(index_1.ChannelKind.MEM_KV_STORE), undefined);
+});
+(0, node_test_1.test)("channel hub: teardown is idempotent on an empty hub", async () => {
+    const hub = new index_1.ChannelHub();
+    await hub.teardown();
+    await hub.teardown();
+});
+/* ----------------------------------------------------- PaeAdapterRegistry */
+function fakeAdapter(adapterId, toolName, onTeardown) {
+    const tool = {
+        name: toolName,
+        capability: "channel:read",
+        determinism: index_1.DeterminismLevel.IO_BOUND,
+        fidelity: "full",
+        description: "teardown fixture"
+    };
+    return {
+        meta: { adapterId, kind: "mcp", sourceEdition: "1.0.0", isolation: "L2" },
+        describe: () => [tool],
+        invoke: async () => null,
+        teardown: onTeardown
+    };
+}
+(0, node_test_1.test)("pae registry: a throwing teardown does not strand the adapters behind it", async () => {
+    const released = [];
+    const registry = new index_1.PaeAdapterRegistry();
+    registry.register(fakeAdapter("bad", "badTool", async () => {
+        released.push("bad");
+        throw new Error("bad exploded");
+    }));
+    registry.register(fakeAdapter("good-1", "goodTool1", async () => {
+        released.push("good-1");
+    }));
+    registry.register(fakeAdapter("good-2", "goodTool2", async () => {
+        released.push("good-2");
+    }));
+    await registry.teardownAll();
+    strict_1.default.deepEqual(released, ["bad", "good-1", "good-2"], "every adapter was released");
+    // The setup bookkeeping was cleared, so a re-registered adapter is set up afresh.
+    strict_1.default.deepEqual(registry.listAdapters().map((a) => a.adapterId), ["bad", "good-1", "good-2"]);
+    registry.clear();
+    strict_1.default.equal(registry.isEmpty(), true);
+});
+(0, node_test_1.test)("pae registry: an adapter without teardown is skipped harmlessly", async () => {
+    const registry = new index_1.PaeAdapterRegistry();
+    const adapter = fakeAdapter("no-teardown", "toolX", async () => { });
+    delete adapter.teardown;
+    registry.register(adapter);
+    await registry.teardownAll();
+    strict_1.default.equal(registry.listAdapters().length, 1);
+});
+/* ------------------------------------------- child process reaping (close) */
+async function tempDir(prefix) {
+    return node_fs_1.promises.mkdtemp(path.join(os.tmpdir(), prefix));
+}
+/** True when no live process answers to `pid`. */
+function pidIsGone(pid) {
+    try {
+        process.kill(pid, 0);
+        return false;
+    }
+    catch (err) {
+        // ESRCH: gone. EPERM: alive but owned by someone else — treat as alive.
+        return err.code === "ESRCH";
+    }
+}
+async function waitFor(predicate, timeoutMs = 5000) {
+    const deadline = Date.now() + timeoutMs;
+    while (!(await predicate())) {
+        if (Date.now() > deadline)
+            throw new Error("timed out waiting for the child to be reaped");
+        await new Promise((resolve) => setTimeout(resolve, 10));
+    }
+}
+/**
+ * A host script that publishes its own pid and then either exits cleanly when
+ * stdin closes, or ignores stdin and has to be killed.
+ */
+function hostScript(pidFile, exitsOnStdinEnd) {
+    const marker = JSON.stringify(pidFile);
+    const behaviour = exitsOnStdinEnd
+        ? `process.stdin.resume(); process.stdin.on("end", () => process.exit(0));`
+        : `setInterval(() => {}, 50);`;
+    return `require("node:fs").writeFileSync(${marker}, String(process.pid)); ${behaviour}`;
+}
+(0, node_test_1.test)("domain transport: close() reaps a child that exits when stdin closes", async () => {
+    const dir = await tempDir("orbit-close-");
+    const pidFile = path.join(dir, "child.pid");
+    const transport = new index_1.ChildProcessDomainTransport({
+        command: process.execPath,
+        args: ["-e", hostScript(pidFile, true)]
+    });
+    await transport.start();
+    await waitFor(async () => (await node_fs_1.promises.access(pidFile).then(() => true, () => false)));
+    const pid = Number(await node_fs_1.promises.readFile(pidFile, "utf8"));
+    strict_1.default.ok(pid > 0, "the host published its pid");
+    strict_1.default.equal(pidIsGone(pid), false, "the host is running before close()");
+    await transport.close();
+    // The whole point: once close() resolves the child is actually gone, not
+    // merely signalled — otherwise it outlives the kernel that spawned it.
+    await waitFor(() => pidIsGone(pid));
+    strict_1.default.equal(transport.closed, true);
+    await node_fs_1.promises.rm(dir, { recursive: true, force: true });
+});
+(0, node_test_1.test)("domain transport: close() kills a child that ignores stdin instead of hanging", async () => {
+    const dir = await tempDir("orbit-close-");
+    const pidFile = path.join(dir, "child.pid");
+    const transport = new index_1.ChildProcessDomainTransport({
+        command: process.execPath,
+        args: ["-e", hostScript(pidFile, false)]
+    });
+    await transport.start();
+    await waitFor(async () => (await node_fs_1.promises.access(pidFile).then(() => true, () => false)));
+    const pid = Number(await node_fs_1.promises.readFile(pidFile, "utf8"));
+    await transport.close();
+    // A hostile host cannot be asked nicely, so the grace window must expire and
+    // the process must be killed — close() must neither hang nor leak it.
+    await waitFor(() => pidIsGone(pid));
+    await node_fs_1.promises.rm(dir, { recursive: true, force: true });
+});
+(0, node_test_1.test)("cordis transport: close() reaps a child that exits when stdin closes", async () => {
+    const dir = await tempDir("orbit-close-");
+    const pidFile = path.join(dir, "child.pid");
+    const transport = new index_1.ChildProcessCordisTransport({
+        command: process.execPath,
+        args: ["-e", hostScript(pidFile, true)]
+    });
+    await transport.start();
+    await waitFor(async () => (await node_fs_1.promises.access(pidFile).then(() => true, () => false)));
+    const pid = Number(await node_fs_1.promises.readFile(pidFile, "utf8"));
+    strict_1.default.equal(pidIsGone(pid), false, "the host is running before close()");
+    await transport.close();
+    await waitFor(() => pidIsGone(pid));
+    strict_1.default.equal(transport.closed, true);
+    await node_fs_1.promises.rm(dir, { recursive: true, force: true });
+});
+(0, node_test_1.test)("cordis transport: close() kills a child that ignores stdin instead of hanging", async () => {
+    const dir = await tempDir("orbit-close-");
+    const pidFile = path.join(dir, "child.pid");
+    const transport = new index_1.ChildProcessCordisTransport({
+        command: process.execPath,
+        args: ["-e", hostScript(pidFile, false)]
+    });
+    await transport.start();
+    await waitFor(async () => (await node_fs_1.promises.access(pidFile).then(() => true, () => false)));
+    const pid = Number(await node_fs_1.promises.readFile(pidFile, "utf8"));
+    await transport.close();
+    await waitFor(() => pidIsGone(pid));
+    await node_fs_1.promises.rm(dir, { recursive: true, force: true });
+});
+(0, node_test_1.test)("child transports: close() before start() is a safe no-op", async () => {
+    const domain = new index_1.ChildProcessDomainTransport({ command: process.execPath, args: ["-e", ""] });
+    await domain.close();
+    strict_1.default.equal(domain.closed, true);
+    const cordis = new index_1.ChildProcessCordisTransport({ command: process.execPath, args: ["-e", ""] });
+    await cordis.close();
+    strict_1.default.equal(cordis.closed, true);
+});
+(0, node_test_1.test)("child transports: close() is idempotent", async () => {
+    const dir = await tempDir("orbit-close-");
+    const pidFile = path.join(dir, "child.pid");
+    const transport = new index_1.ChildProcessDomainTransport({
+        command: process.execPath,
+        args: ["-e", hostScript(pidFile, true)]
+    });
+    await transport.start();
+    await transport.close();
+    await transport.close();
+    strict_1.default.equal(transport.closed, true);
+    await node_fs_1.promises.rm(dir, { recursive: true, force: true });
+});
+// Guard the assumption behind the pid probe itself: without it, every test
+// above could pass for the wrong reason.
+(0, node_test_1.test)("fixture: the pid probe distinguishes a live child from a dead one", async () => {
+    const child = (0, node_child_process_1.spawn)(process.execPath, ["-e", "setInterval(() => {}, 50)"], {
+        stdio: ["pipe", "pipe", "pipe"]
+    });
+    await new Promise((resolve) => child.on("spawn", () => resolve()));
+    strict_1.default.equal(pidIsGone(child.pid), false, "a live child is detected as live");
+    child.kill("SIGKILL");
+    await waitFor(() => pidIsGone(child.pid));
+});
+//# sourceMappingURL=teardown_isolation.test.js.map

package/dist/test/teardown_isolation.test.js.map

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

package/dist/test/token_budget.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=token_budget.test.d.ts.map

package/dist/test/token_budget.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token_budget.test.d.ts","sourceRoot":"","sources":["../../test/token_budget.test.ts"],"names":[],"mappings":""}

package/dist/test/token_budget.test.js

@@ -0,0 +1,113 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = require("node:test");
+const strict_1 = __importDefault(require("node:assert/strict"));
+const core_hub_1 = require("@orbit/core-hub");
+// A tight config so thresholds are easy to assert against.
+const TIGHT = {
+    maxTokensPerCall: 100,
+    compressAboveTokens: 50,
+    trimRatio: { conservative: 0.9, normal: 0.5, aggressive: 0.25 },
+    compressThresholdBytes: 64,
+    enabled: true
+};
+(0, node_test_1.test)("engine: token estimate is deterministic and punctuation-aware", () => {
+    const e = new core_hub_1.TokenBudgetEngine(TIGHT);
+    strict_1.default.equal(e.estimateTokens(""), 0);
+    strict_1.default.equal(e.estimateTokens("hello world"), 2);
+    strict_1.default.equal(e.estimateTokens("the quick brown fox jumps"), 5);
+    // Pure function: identical input -> identical output.
+    strict_1.default.equal(e.estimateTokens("hello world"), e.estimateTokens("hello world"));
+    // CJK letters also count as word-runs.
+    strict_1.default.equal(e.estimateTokens("你好 世界"), 2);
+});
+(0, node_test_1.test)("engine: compress is a pure, deterministic head-trim (no invention/reorder)", () => {
+    const e = new core_hub_1.TokenBudgetEngine(TIGHT);
+    const long = Array(60).fill("tok").join(" "); // 60 tokens > 50 threshold
+    const a = e.compress(long, "normal");
+    const b = e.compress(long, "normal");
+    strict_1.default.equal(a.applied, true);
+    strict_1.default.equal(a.level, "normal");
+    // Deterministic: same output every call.
+    strict_1.default.equal(a.text, b.text);
+    strict_1.default.equal(a.estimatedTokens, 30); // keep 50% of 60
+    // Head trim: the first 30 tokens are preserved verbatim.
+    strict_1.default.equal(a.text, Array(30).fill("tok").join(" "));
+});
+(0, node_test_1.test)("engine: compress is a no-op below the threshold", () => {
+    const e = new core_hub_1.TokenBudgetEngine(TIGHT);
+    const short = "one two three"; // 3 tokens
+    const r = e.compress(short, "aggressive");
+    strict_1.default.equal(r.applied, false);
+    strict_1.default.equal(r.text, short);
+});
+(0, node_test_1.test)("engine: budgetPolicy reflects cumulative usage (normal -> shrink -> stop)", () => {
+    const e = new core_hub_1.TokenBudgetEngine(TIGHT); // compressAbove=50, max=100
+    strict_1.default.deepEqual(e.budgetPolicy("p1"), { allow: true, strategy: "normal" });
+    e.account("p1", 60); // now above compressAboveTokens
+    strict_1.default.deepEqual(e.budgetPolicy("p1"), { allow: true, strategy: "shrink" });
+    e.account("p1", 60); // now above maxTokensPerCall
+    strict_1.default.deepEqual(e.budgetPolicy("p1"), { allow: false, strategy: "stop" });
+});
+(0, node_test_1.test)("engine: disabled config is a pass-through (always allow/normal)", () => {
+    const e = new core_hub_1.TokenBudgetEngine({ ...TIGHT, enabled: false });
+    e.account("p1", 9999);
+    strict_1.default.deepEqual(e.budgetPolicy("p1"), { allow: true, strategy: "normal" });
+    strict_1.default.equal(e.compress("a b c d e".repeat(100)).applied, false);
+});
+(0, node_test_1.test)("engine: compressionPolicyFor scales with estimated size", () => {
+    const e = new core_hub_1.TokenBudgetEngine(TIGHT); // compressAbove=50
+    strict_1.default.deepEqual(e.compressionPolicyFor(10), { level: "conservative", applied: false });
+    strict_1.default.deepEqual(e.compressionPolicyFor(45), { level: "normal", applied: true });
+    strict_1.default.deepEqual(e.compressionPolicyFor(80), { level: "aggressive", applied: true });
+});
+(0, node_test_1.test)("engine: configHash is stable per config and changes with the thresholds", () => {
+    const a = new core_hub_1.TokenBudgetEngine(core_hub_1.DEFAULT_TOKEN_BUDGET_CONFIG).configHash();
+    const b = new core_hub_1.TokenBudgetEngine(core_hub_1.DEFAULT_TOKEN_BUDGET_CONFIG).configHash();
+    strict_1.default.equal(a, b); // stable across instances
+    const c = new core_hub_1.TokenBudgetEngine({ ...core_hub_1.DEFAULT_TOKEN_BUDGET_CONFIG, maxTokensPerCall: 4096 }).configHash();
+    strict_1.default.notEqual(a, c); // drift is detectable
+});
+(0, node_test_1.test)("engine: decideCompression is payload-aware and threshold-driven", () => {
+    const e = new core_hub_1.TokenBudgetEngine(TIGHT); // compressThresholdBytes = 64
+    // Below threshold -> no compression, "normal" level.
+    strict_1.default.deepEqual(e.decideCompression("hello"), { level: "normal", applied: false });
+    // ~102 bytes: just above threshold, within 2x -> applied, conservative.
+    const mid = "x".repeat(100);
+    const dMid = e.decideCompression(mid);
+    strict_1.default.equal(dMid.applied, true);
+    strict_1.default.equal(dMid.level, "conservative");
+    // ~302 bytes: above 4x threshold -> aggressive, applied.
+    strict_1.default.deepEqual(e.decideCompression("x".repeat(300)), { level: "aggressive", applied: true });
+    // Small objects stay uncompressed.
+    strict_1.default.deepEqual(e.decideCompression({ a: 1 }), { level: "normal", applied: false });
+});
+(0, node_test_1.test)("engine: compressPayload/decompressPayload round-trips and is deterministic", () => {
+    for (const v of ["hello world", { a: [1, 2, 3], b: "x" }, 42, null, ["a", "b"], true]) {
+        const env = (0, core_hub_1.compressPayload)(v, "normal");
+        strict_1.default.equal((0, core_hub_1.isCompressedPayload)(env), true);
+        strict_1.default.deepEqual((0, core_hub_1.decompressPayload)(env), v);
+        // Determinism: identical input -> identical envelope bytes.
+        strict_1.default.equal(env.data, (0, core_hub_1.compressPayload)(v, "normal").data);
+    }
+    strict_1.default.equal((0, core_hub_1.isCompressedPayload)("not compressed"), false);
+    strict_1.default.equal((0, core_hub_1.isCompressedPayload)(null), false);
+});
+(0, node_test_1.test)("engine: packSnapshot keeps the original when deflate does not save space", () => {
+    const small = "hi"; // tiny -> deflate enlarges -> original kept, not applied
+    const p = (0, core_hub_1.packSnapshot)(small, "normal");
+    strict_1.default.equal(p.applied, false);
+    strict_1.default.equal(p.bytesSaved, 0);
+    strict_1.default.equal(p.served, small);
+    // Large repeated payload -> deflate clearly helps.
+    const big = "y".repeat(5000);
+    const q = (0, core_hub_1.packSnapshot)(big, "aggressive");
+    strict_1.default.equal(q.applied, true);
+    strict_1.default.ok(q.bytesSaved > 0);
+    strict_1.default.equal((0, core_hub_1.isCompressedPayload)(q.served), true);
+    strict_1.default.deepEqual((0, core_hub_1.decompressPayload)(q.served), big);
+});
+//# sourceMappingURL=token_budget.test.js.map

package/dist/test/token_budget.test.js.map

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

package/dist/test/trace_journal.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=trace_journal.test.d.ts.map

package/dist/test/trace_journal.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace_journal.test.d.ts","sourceRoot":"","sources":["../../test/trace_journal.test.ts"],"names":[],"mappings":""}

package/dist/test/trace_journal.test.js

@@ -0,0 +1,43 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = require("node:test");
+const strict_1 = __importDefault(require("node:assert/strict"));
+const core_hub_1 = require("@orbit/core-hub");
+(0, node_test_1.test)("append & entries: records carry uid and timestamp", () => {
+    const journal = new core_hub_1.TraceJournal();
+    journal.append({ entryClass: "TEST_EVENT", traceMarkId: "t1", factPayload: { n: 1 } });
+    const entries = journal.entries();
+    strict_1.default.equal(entries.length, 1);
+    strict_1.default.ok(entries[0].entryUid.length > 0);
+    strict_1.default.ok(entries[0].occurredAt > 0);
+});
+(0, node_test_1.test)("filters: by trace mark / agent box / plugin unit / entry class", () => {
+    const journal = new core_hub_1.TraceJournal();
+    journal.append({ entryClass: "AGENT_SINGLE_CYCLE_EXEC", traceMarkId: "t1", agentBoxId: "box.a", factPayload: {} });
+    journal.append({ entryClass: "PLUGIN_UNIT_EXCEPTION", traceMarkId: "t1", pluginUnitId: "p1", factPayload: {} });
+    journal.append({ entryClass: "AGENT_SINGLE_CYCLE_EXEC", traceMarkId: "t2", agentBoxId: "box.b", factPayload: {} });
+    strict_1.default.equal(journal.byTraceMark("t1").length, 2);
+    strict_1.default.equal(journal.byAgentBox("box.a").length, 1);
+    strict_1.default.equal(journal.byPluginUnit("p1").length, 1);
+    strict_1.default.equal(journal.byEntryClass("AGENT_SINGLE_CYCLE_EXEC").length, 2);
+});
+(0, node_test_1.test)("snapshot & restore: round-trips the journal", () => {
+    const journal = new core_hub_1.TraceJournal();
+    journal.append({ entryClass: "A", traceMarkId: "t", factPayload: {} });
+    const snapshot = journal.snapshot();
+    journal.append({ entryClass: "B", traceMarkId: "t", factPayload: {} });
+    journal.restoreSnapshot(snapshot);
+    strict_1.default.equal(journal.entries().length, 1);
+    strict_1.default.equal(journal.entries()[0].entryClass, "A");
+});
+(0, node_test_1.test)("entries returns a copy: external mutation is isolated", () => {
+    const journal = new core_hub_1.TraceJournal();
+    journal.append({ entryClass: "A", traceMarkId: "t", factPayload: {} });
+    const entries = journal.entries();
+    entries.length = 0;
+    strict_1.default.equal(journal.entries().length, 1);
+});
+//# sourceMappingURL=trace_journal.test.js.map

package/dist/test/trace_journal.test.js.map

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

package/dist/test/trace_journal_persistence.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=trace_journal_persistence.test.d.ts.map

package/dist/test/trace_journal_persistence.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace_journal_persistence.test.d.ts","sourceRoot":"","sources":["../../test/trace_journal_persistence.test.ts"],"names":[],"mappings":""}