@earendil-works/pi-agent-core 0.85.1 → 0.86.0

package/dist/harness/pico3/bounded.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Bounded byte collector. It retains a prefix or suffix constrained by both a byte
+ * budget and a newline budget, and accounts for every discarded byte/newline.
+ */
+export declare class Bounded {
+    private bytes;
+    private readonly maxBytes;
+    private readonly maxLines;
+    private readonly retain;
+    droppedBytes: number;
+    droppedLines: number;
+    total: number;
+    constructor(maxBytes: number, maxLines: number, retain: "head" | "tail");
+    push(chunk: Uint8Array): void;
+    private pushHead;
+    private pushTail;
+    private drop;
+    get dropped(): number;
+    text(): string;
+}
+//# sourceMappingURL=bounded.d.ts.map

package/dist/harness/pico3/bounded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounded.d.ts","sourceRoot":"","sources":["../../../src/harness/pico3/bounded.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,OAAO;IACnB,OAAO,CAAC,KAAK,CAAiD;IAC9D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,YAAY,SAAK;IACjB,YAAY,SAAK;IACjB,KAAK,SAAK;IAEV,YAAY,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAItE;IAED,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAY5B;IAED,OAAO,CAAC,QAAQ;IAqBhB,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,IAAI;IAKZ,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,IAAI,MAAM,CAEb;CACD","sourcesContent":["/**\n * Bounded byte collector. It retains a prefix or suffix constrained by both a byte\n * budget and a newline budget, and accounts for every discarded byte/newline.\n */\nexport class Bounded {\n\tprivate bytes: Uint8Array<ArrayBufferLike> = new Uint8Array();\n\tprivate readonly maxBytes: number;\n\tprivate readonly maxLines: number;\n\tprivate readonly retain: \"head\" | \"tail\";\n\tdroppedBytes = 0;\n\tdroppedLines = 0;\n\ttotal = 0;\n\n\tconstructor(maxBytes: number, maxLines: number, retain: \"head\" | \"tail\") {\n\t\tthis.maxBytes = Math.max(0, maxBytes);\n\t\tthis.maxLines = Math.max(0, maxLines);\n\t\tthis.retain = retain;\n\t}\n\n\tpush(chunk: Uint8Array): void {\n\t\tthis.total += chunk.length;\n\t\tif (chunk.length === 0) return;\n\t\tif (this.maxBytes === 0 || this.maxLines === 0) {\n\t\t\tthis.drop(chunk);\n\t\t\treturn;\n\t\t}\n\t\tif (this.retain === \"head\") {\n\t\t\tthis.pushHead(chunk);\n\t\t\treturn;\n\t\t}\n\t\tthis.pushTail(chunk);\n\t}\n\n\tprivate pushHead(chunk: Uint8Array): void {\n\t\tconst remainingBytes = this.maxBytes - this.bytes.length;\n\t\tconst remainingLines = this.maxLines - countNewlines(this.bytes);\n\t\tif (remainingBytes <= 0 || remainingLines <= 0) {\n\t\t\tthis.drop(chunk);\n\t\t\treturn;\n\t\t}\n\t\tlet take = Math.min(chunk.length, remainingBytes);\n\t\tlet lines = 0;\n\t\tfor (let i = 0; i < take; i++) {\n\t\t\tif (chunk[i] !== 0x0a) continue;\n\t\t\tlines++;\n\t\t\tif (lines === remainingLines) {\n\t\t\t\ttake = i + 1;\n\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\t\tthis.bytes = concat(this.bytes, chunk.subarray(0, take));\n\t\tthis.drop(chunk.subarray(take));\n\t}\n\n\tprivate pushTail(chunk: Uint8Array): void {\n\t\tconst incomingStart = tailStart(chunk, this.maxBytes, this.maxLines);\n\t\tthis.drop(chunk.subarray(0, incomingStart));\n\t\tconst combined = concat(this.bytes, chunk.subarray(incomingStart));\n\t\tconst start = tailStart(combined, this.maxBytes, this.maxLines);\n\t\tthis.drop(combined.subarray(0, start));\n\t\tthis.bytes = combined.slice(start);\n\t}\n\n\tprivate drop(bytes: Uint8Array): void {\n\t\tthis.droppedBytes += bytes.length;\n\t\tthis.droppedLines += countNewlines(bytes);\n\t}\n\n\tget dropped(): number {\n\t\treturn this.droppedBytes;\n\t}\n\n\ttext(): string {\n\t\treturn new TextDecoder().decode(this.bytes);\n\t}\n}\n\nfunction tailStart(bytes: Uint8Array, maxBytes: number, maxLines: number): number {\n\tlet start = Math.max(0, bytes.length - maxBytes);\n\tlet excessLines = countNewlines(bytes.subarray(start)) - maxLines;\n\tfor (; start < bytes.length && excessLines > 0; start++) {\n\t\tif (bytes[start] === 0x0a) excessLines--;\n\t}\n\treturn start;\n}\n\nfunction concat(a: Uint8Array, b: Uint8Array): Uint8Array {\n\tif (a.length === 0) return b.slice();\n\tif (b.length === 0) return a;\n\tconst out = new Uint8Array(a.length + b.length);\n\tout.set(a);\n\tout.set(b, a.length);\n\treturn out;\n}\n\nfunction countNewlines(bytes: Uint8Array): number {\n\tlet count = 0;\n\tfor (const byte of bytes) if (byte === 0x0a) count++;\n\treturn count;\n}\n"]}

package/dist/harness/pico3/bounded.js

@@ -0,0 +1,98 @@
+/**
+ * Bounded byte collector. It retains a prefix or suffix constrained by both a byte
+ * budget and a newline budget, and accounts for every discarded byte/newline.
+ */
+export class Bounded {
+    bytes = new Uint8Array();
+    maxBytes;
+    maxLines;
+    retain;
+    droppedBytes = 0;
+    droppedLines = 0;
+    total = 0;
+    constructor(maxBytes, maxLines, retain) {
+        this.maxBytes = Math.max(0, maxBytes);
+        this.maxLines = Math.max(0, maxLines);
+        this.retain = retain;
+    }
+    push(chunk) {
+        this.total += chunk.length;
+        if (chunk.length === 0)
+            return;
+        if (this.maxBytes === 0 || this.maxLines === 0) {
+            this.drop(chunk);
+            return;
+        }
+        if (this.retain === "head") {
+            this.pushHead(chunk);
+            return;
+        }
+        this.pushTail(chunk);
+    }
+    pushHead(chunk) {
+        const remainingBytes = this.maxBytes - this.bytes.length;
+        const remainingLines = this.maxLines - countNewlines(this.bytes);
+        if (remainingBytes <= 0 || remainingLines <= 0) {
+            this.drop(chunk);
+            return;
+        }
+        let take = Math.min(chunk.length, remainingBytes);
+        let lines = 0;
+        for (let i = 0; i < take; i++) {
+            if (chunk[i] !== 0x0a)
+                continue;
+            lines++;
+            if (lines === remainingLines) {
+                take = i + 1;
+                break;
+            }
+        }
+        this.bytes = concat(this.bytes, chunk.subarray(0, take));
+        this.drop(chunk.subarray(take));
+    }
+    pushTail(chunk) {
+        const incomingStart = tailStart(chunk, this.maxBytes, this.maxLines);
+        this.drop(chunk.subarray(0, incomingStart));
+        const combined = concat(this.bytes, chunk.subarray(incomingStart));
+        const start = tailStart(combined, this.maxBytes, this.maxLines);
+        this.drop(combined.subarray(0, start));
+        this.bytes = combined.slice(start);
+    }
+    drop(bytes) {
+        this.droppedBytes += bytes.length;
+        this.droppedLines += countNewlines(bytes);
+    }
+    get dropped() {
+        return this.droppedBytes;
+    }
+    text() {
+        return new TextDecoder().decode(this.bytes);
+    }
+}
+function tailStart(bytes, maxBytes, maxLines) {
+    let start = Math.max(0, bytes.length - maxBytes);
+    let excessLines = countNewlines(bytes.subarray(start)) - maxLines;
+    for (; start < bytes.length && excessLines > 0; start++) {
+        if (bytes[start] === 0x0a)
+            excessLines--;
+    }
+    return start;
+}
+function concat(a, b) {
+    if (a.length === 0)
+        return b.slice();
+    if (b.length === 0)
+        return a;
+    const out = new Uint8Array(a.length + b.length);
+    out.set(a);
+    out.set(b, a.length);
+    return out;
+}
+function countNewlines(bytes) {
+    let count = 0;
+    for (const byte of bytes)
+        if (byte === 0x0a)
+            count++;
+    return count;
+}
+//# sourceMappingURL=bounded.js.map

package/dist/harness/pico3/bounded.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounded.js","sourceRoot":"","sources":["../../../src/harness/pico3/bounded.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Bounded byte collector. It retains a prefix or suffix constrained by both a byte\n * budget and a newline budget, and accounts for every discarded byte/newline.\n */\nexport class Bounded {\n\tprivate bytes: Uint8Array<ArrayBufferLike> = new Uint8Array();\n\tprivate readonly maxBytes: number;\n\tprivate readonly maxLines: number;\n\tprivate readonly retain: \"head\" | \"tail\";\n\tdroppedBytes = 0;\n\tdroppedLines = 0;\n\ttotal = 0;\n\n\tconstructor(maxBytes: number, maxLines: number, retain: \"head\" | \"tail\") {\n\t\tthis.maxBytes = Math.max(0, maxBytes);\n\t\tthis.maxLines = Math.max(0, maxLines);\n\t\tthis.retain = retain;\n\t}\n\n\tpush(chunk: Uint8Array): void {\n\t\tthis.total += chunk.length;\n\t\tif (chunk.length === 0) return;\n\t\tif (this.maxBytes === 0 || this.maxLines === 0) {\n\t\t\tthis.drop(chunk);\n\t\t\treturn;\n\t\t}\n\t\tif (this.retain === \"head\") {\n\t\t\tthis.pushHead(chunk);\n\t\t\treturn;\n\t\t}\n\t\tthis.pushTail(chunk);\n\t}\n\n\tprivate pushHead(chunk: Uint8Array): void {\n\t\tconst remainingBytes = this.maxBytes - this.bytes.length;\n\t\tconst remainingLines = this.maxLines - countNewlines(this.bytes);\n\t\tif (remainingBytes <= 0 || remainingLines <= 0) {\n\t\t\tthis.drop(chunk);\n\t\t\treturn;\n\t\t}\n\t\tlet take = Math.min(chunk.length, remainingBytes);\n\t\tlet lines = 0;\n\t\tfor (let i = 0; i < take; i++) {\n\t\t\tif (chunk[i] !== 0x0a) continue;\n\t\t\tlines++;\n\t\t\tif (lines === remainingLines) {\n\t\t\t\ttake = i + 1;\n\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\t\tthis.bytes = concat(this.bytes, chunk.subarray(0, take));\n\t\tthis.drop(chunk.subarray(take));\n\t}\n\n\tprivate pushTail(chunk: Uint8Array): void {\n\t\tconst incomingStart = tailStart(chunk, this.maxBytes, this.maxLines);\n\t\tthis.drop(chunk.subarray(0, incomingStart));\n\t\tconst combined = concat(this.bytes, chunk.subarray(incomingStart));\n\t\tconst start = tailStart(combined, this.maxBytes, this.maxLines);\n\t\tthis.drop(combined.subarray(0, start));\n\t\tthis.bytes = combined.slice(start);\n\t}\n\n\tprivate drop(bytes: Uint8Array): void {\n\t\tthis.droppedBytes += bytes.length;\n\t\tthis.droppedLines += countNewlines(bytes);\n\t}\n\n\tget dropped(): number {\n\t\treturn this.droppedBytes;\n\t}\n\n\ttext(): string {\n\t\treturn new TextDecoder().decode(this.bytes);\n\t}\n}\n\nfunction tailStart(bytes: Uint8Array, maxBytes: number, maxLines: number): number {\n\tlet start = Math.max(0, bytes.length - maxBytes);\n\tlet excessLines = countNewlines(bytes.subarray(start)) - maxLines;\n\tfor (; start < bytes.length && excessLines > 0; start++) {\n\t\tif (bytes[start] === 0x0a) excessLines--;\n\t}\n\treturn start;\n}\n\nfunction concat(a: Uint8Array, b: Uint8Array): Uint8Array {\n\tif (a.length === 0) return b.slice();\n\tif (b.length === 0) return a;\n\tconst out = new Uint8Array(a.length + b.length);\n\tout.set(a);\n\tout.set(b, a.length);\n\treturn out;\n}\n\nfunction countNewlines(bytes: Uint8Array): number {\n\tlet count = 0;\n\tfor (const byte of bytes) if (byte === 0x0a) count++;\n\treturn count;\n}\n"]}

package/dist/harness/pico3/chord.d.ts

@@ -0,0 +1,41 @@
+import { type Context, type MutableReplicatedState, type ReplicatedState } from "@earendil-works/chord";
+import type { ConversationHandle, Harness } from "./harness.ts";
+import type { ConversationSpec, ConversationView, Entry, EntryScan, Id, JsonObject, NewEntry, SendInput, ViewEvent } from "./types.ts";
+export type PublishedConversationView = ConversationView & {
+    commit: {
+        events: ViewEvent[];
+    };
+};
+export interface PicoConversationService {
+    readonly view: ReplicatedState<PublishedConversationView>;
+    send(input: SendInput, ctx: Context): Promise<Id>;
+    write(entry: NewEntry, ctx: Context): Promise<Id>;
+    inputAbort(id: Id, ctx: Context): Promise<"aborted" | "already_placed" | "not_found">;
+    configSet(patch: JsonObject, ctx: Context): Promise<void>;
+    abort(ctx: Context): Promise<void>;
+    reset(handoff: string | null, ctx: Context): Promise<void>;
+    collapse(instructions: string | null, ctx: Context): Promise<Id>;
+    fork(at: Id | "start", spec: Omit<ConversationSpec, "parent">, ctx: Context): Promise<Id>;
+    entries(scan: EntryScan, ctx: Context): Promise<Entry[]>;
+}
+/** Local registration/control plane and remote keyed conversation contract used by Chord facets. */
+export declare const PicoHarnessService: import("@earendil-works/chord").Service<Harness<[]>>;
+export declare const PicoConversationService: import("@earendil-works/chord").Service<PicoConversationService>;
+export declare function createPicoConversationService<Cfg extends object>(harness: Pick<Harness, "abortInput" | "entries">, conversation: ConversationHandle<Cfg>, view: ReplicatedState<PublishedConversationView>): PicoConversationService;
+export interface ChordViewBridge {
+    readonly view: MutableReplicatedState<PublishedConversationView>;
+    readonly closed: boolean;
+    close(): void;
+}
+export interface ChordViewBridgeOptions {
+    capacity?: number;
+    /** Called after the raw watch is closed. The owner should close and respawn its keyed service instance. */
+    onFailure?: (error: Error) => void;
+}
+/**
+ * Adapt Pico's commit-granular envelopes to one Chord publication per commit.
+ * The raw listener only enqueues. Applying ops and publishing happen together,
+ * off the Session line, with no await between them.
+ */
+export declare function attachChordView(conversation: Pick<ConversationHandle, "watch">, createState: (initial: PublishedConversationView) => MutableReplicatedState<PublishedConversationView>, ctx: Context, opts?: ChordViewBridgeOptions): Promise<ChordViewBridge>;
+//# sourceMappingURL=chord.d.ts.map

package/dist/harness/pico3/chord.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chord.d.ts","sourceRoot":"","sources":["../../../src/harness/pico3/chord.ts"],"names":[],"mappings":"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","sourcesContent":["import { type Context, defineService, type MutableReplicatedState, type ReplicatedState } from \"@earendil-works/chord\";\nimport type { Op, Path, Seg } from \"@earendil-works/chord/delta\";\nimport type { ConversationHandle, Harness } from \"./harness.ts\";\nimport type {\n\tConversationSpec,\n\tConversationView,\n\tEntry,\n\tEntryScan,\n\tEnvelope,\n\tId,\n\tJsonObject,\n\tNewEntry,\n\tSendInput,\n\tViewEvent,\n} from \"./types.ts\";\nimport { WATCH_CAPACITY, type Watch } from \"./view.ts\";\n\nexport type PublishedConversationView = ConversationView & {\n\tcommit: { events: ViewEvent[] };\n};\n\nexport interface PicoConversationService {\n\treadonly view: ReplicatedState<PublishedConversationView>;\n\tsend(input: SendInput, ctx: Context): Promise<Id>;\n\twrite(entry: NewEntry, ctx: Context): Promise<Id>;\n\tinputAbort(id: Id, ctx: Context): Promise<\"aborted\" | \"already_placed\" | \"not_found\">;\n\tconfigSet(patch: JsonObject, ctx: Context): Promise<void>;\n\tabort(ctx: Context): Promise<void>;\n\treset(handoff: string | null, ctx: Context): Promise<void>;\n\tcollapse(instructions: string | null, ctx: Context): Promise<Id>;\n\tfork(at: Id | \"start\", spec: Omit<ConversationSpec, \"parent\">, ctx: Context): Promise<Id>;\n\tentries(scan: EntryScan, ctx: Context): Promise<Entry[]>;\n}\n\n/** Local registration/control plane and remote keyed conversation contract used by Chord facets. */\nexport const PicoHarnessService = defineService<Harness>(\"pi.harness\", { local: true });\nexport const PicoConversationService = defineService<PicoConversationService>(\"pi.conversation\");\n\nexport function createPicoConversationService<Cfg extends object>(\n\tharness: Pick<Harness, \"abortInput\" | \"entries\">,\n\tconversation: ConversationHandle<Cfg>,\n\tview: ReplicatedState<PublishedConversationView>,\n): PicoConversationService {\n\treturn {\n\t\tview,\n\t\tsend: (input, ctx) => conversation.send(input, ctx).then((handle) => handle.id),\n\t\twrite: (entry, ctx) => conversation.write(entry, ctx),\n\t\tinputAbort: (id, ctx) => harness.abortInput(id, ctx, conversation.id),\n\t\tconfigSet: (patch, ctx) => conversation.config.set(patch as never, ctx),\n\t\tabort: (ctx) => conversation.abort(ctx),\n\t\treset: (handoff, ctx) => conversation.reset(handoff ?? undefined, ctx),\n\t\tcollapse: (instructions, ctx) => conversation.collapse(instructions ?? undefined, ctx),\n\t\tfork: (at, spec, ctx) => conversation.fork(at, spec, ctx).then((child) => child.id),\n\t\tentries: (scan, ctx) => harness.entries({ ...scan, conversationId: conversation.id }, ctx),\n\t};\n}\n\nexport interface ChordViewBridge {\n\treadonly view: MutableReplicatedState<PublishedConversationView>;\n\treadonly closed: boolean;\n\tclose(): void;\n}\n\nexport interface ChordViewBridgeOptions {\n\tcapacity?: number;\n\t/** Called after the raw watch is closed. The owner should close and respawn its keyed service instance. */\n\tonFailure?: (error: Error) => void;\n}\n\n/**\n * Adapt Pico's commit-granular envelopes to one Chord publication per commit.\n * The raw listener only enqueues. Applying ops and publishing happen together,\n * off the Session line, with no await between them.\n */\nexport async function attachChordView(\n\tconversation: Pick<ConversationHandle, \"watch\">,\n\tcreateState: (initial: PublishedConversationView) => MutableReplicatedState<PublishedConversationView>,\n\tctx: Context,\n\topts: ChordViewBridgeOptions = {},\n): Promise<ChordViewBridge> {\n\tconst watch = await conversation.watch(ctx);\n\tconst view = createState({ ...structuredClone(watch.view), commit: { events: [] } });\n\treturn bridgeWatch(watch, view, ctx, opts);\n}\n\nfunction bridgeWatch(\n\twatch: Watch,\n\tview: MutableReplicatedState<PublishedConversationView>,\n\tctx: Context,\n\topts: ChordViewBridgeOptions,\n): ChordViewBridge {\n\tconst capacity = opts.capacity ?? WATCH_CAPACITY;\n\tif (!Number.isSafeInteger(capacity) || capacity < 1)\n\t\tthrow new RangeError(\"Chord view queue capacity must be positive\");\n\tconst queue: Envelope[] = [];\n\tlet scheduled = false;\n\tlet closed = false;\n\tconst fail = (cause: unknown) => {\n\t\tif (closed) return;\n\t\tclosed = true;\n\t\tqueue.length = 0;\n\t\twatch.stop();\n\t\ttry {\n\t\t\topts.onFailure?.(cause instanceof Error ? cause : new Error(String(cause)));\n\t\t} catch {}\n\t};\n\tconst drain = () => {\n\t\tscheduled = false;\n\t\twhile (!closed && queue.length > 0) {\n\t\t\tconst envelope = queue.shift()!;\n\t\t\ttry {\n\t\t\t\tapplyTracked(view.state, envelope.ops);\n\t\t\t\tview.state.commit.events = structuredClone(envelope.events);\n\t\t\t\tview.publish(ctx);\n\t\t\t} catch (error) {\n\t\t\t\tfail(error);\n\t\t\t}\n\t\t}\n\t};\n\twatch.start((envelope) => {\n\t\tif (closed) return;\n\t\tif (queue.length >= capacity) {\n\t\t\tfail(new Error(`Pico-to-Chord view queue exceeded ${capacity} envelopes`));\n\t\t\treturn;\n\t\t}\n\t\tqueue.push(envelope);\n\t\tif (scheduled) return;\n\t\tscheduled = true;\n\t\tqueueMicrotask(drain);\n\t});\n\treturn {\n\t\tview,\n\t\tget closed() {\n\t\t\treturn closed;\n\t\t},\n\t\tclose() {\n\t\t\tif (closed) return;\n\t\t\tclosed = true;\n\t\t\tqueue.length = 0;\n\t\t\twatch.stop();\n\t\t},\n\t};\n}\n\nfunction applyTracked(root: PublishedConversationView, ops: readonly Op[]): void {\n\tfor (const op of ops) {\n\t\tif (op[0] === \"r\") throw new Error(\"live Pico envelope unexpectedly replaced the view root\");\n\t\tconst path = op[1];\n\t\tif (op[0] === \"p\") {\n\t\t\tconst target = resolve(root, path);\n\t\t\tif (!Array.isArray(target)) throw new Error(`Pico splice path is not an array: ${path.join(\".\")}`);\n\t\t\ttarget.splice(op[2], op[3], ...structuredClone(op[4]));\n\t\t\tcontinue;\n\t\t}\n\t\tconst parent = resolve(root, path.slice(0, -1));\n\t\tif (parent === null || typeof parent !== \"object\")\n\t\t\tthrow new Error(`Pico operation parent is not an object: ${path.join(\".\")}`);\n\t\tconst key = path[path.length - 1]!;\n\t\tif (op[0] === \"d\") {\n\t\t\tif (Array.isArray(parent)) parent.splice(key as number, 1);\n\t\t\telse delete (parent as Record<PropertyKey, unknown>)[key];\n\t\t\tcontinue;\n\t\t}\n\t\tconst record = parent as Record<PropertyKey, unknown>;\n\t\tif (op[0] === \"s\") record[key] = structuredClone(op[2]);\n\t\telse if (op[0] === \"a\") record[key] = `${String(record[key])}${op[2]}`;\n\t\telse record[key] = String(record[key]).slice(op[2]);\n\t}\n}\n\nfunction resolve(root: unknown, path: Path): unknown {\n\tlet value = root;\n\tfor (const segment of path) {\n\t\tif (value === null || typeof value !== \"object\") return undefined;\n\t\tvalue = (value as Record<Seg, unknown>)[segment];\n\t}\n\treturn value;\n}\n"]}

package/dist/harness/pico3/chord.js

@@ -0,0 +1,130 @@
+import { defineService } from "@earendil-works/chord";
+import { WATCH_CAPACITY } from "./view.js";
+/** Local registration/control plane and remote keyed conversation contract used by Chord facets. */
+export const PicoHarnessService = defineService("pi.harness", { local: true });
+export const PicoConversationService = defineService("pi.conversation");
+export function createPicoConversationService(harness, conversation, view) {
+    return {
+        view,
+        send: (input, ctx) => conversation.send(input, ctx).then((handle) => handle.id),
+        write: (entry, ctx) => conversation.write(entry, ctx),
+        inputAbort: (id, ctx) => harness.abortInput(id, ctx, conversation.id),
+        configSet: (patch, ctx) => conversation.config.set(patch, ctx),
+        abort: (ctx) => conversation.abort(ctx),
+        reset: (handoff, ctx) => conversation.reset(handoff ?? undefined, ctx),
+        collapse: (instructions, ctx) => conversation.collapse(instructions ?? undefined, ctx),
+        fork: (at, spec, ctx) => conversation.fork(at, spec, ctx).then((child) => child.id),
+        entries: (scan, ctx) => harness.entries({ ...scan, conversationId: conversation.id }, ctx),
+    };
+}
+/**
+ * Adapt Pico's commit-granular envelopes to one Chord publication per commit.
+ * The raw listener only enqueues. Applying ops and publishing happen together,
+ * off the Session line, with no await between them.
+ */
+export async function attachChordView(conversation, createState, ctx, opts = {}) {
+    const watch = await conversation.watch(ctx);
+    const view = createState({ ...structuredClone(watch.view), commit: { events: [] } });
+    return bridgeWatch(watch, view, ctx, opts);
+}
+function bridgeWatch(watch, view, ctx, opts) {
+    const capacity = opts.capacity ?? WATCH_CAPACITY;
+    if (!Number.isSafeInteger(capacity) || capacity < 1)
+        throw new RangeError("Chord view queue capacity must be positive");
+    const queue = [];
+    let scheduled = false;
+    let closed = false;
+    const fail = (cause) => {
+        if (closed)
+            return;
+        closed = true;
+        queue.length = 0;
+        watch.stop();
+        try {
+            opts.onFailure?.(cause instanceof Error ? cause : new Error(String(cause)));
+        }
+        catch { }
+    };
+    const drain = () => {
+        scheduled = false;
+        while (!closed && queue.length > 0) {
+            const envelope = queue.shift();
+            try {
+                applyTracked(view.state, envelope.ops);
+                view.state.commit.events = structuredClone(envelope.events);
+                view.publish(ctx);
+            }
+            catch (error) {
+                fail(error);
+            }
+        }
+    };
+    watch.start((envelope) => {
+        if (closed)
+            return;
+        if (queue.length >= capacity) {
+            fail(new Error(`Pico-to-Chord view queue exceeded ${capacity} envelopes`));
+            return;
+        }
+        queue.push(envelope);
+        if (scheduled)
+            return;
+        scheduled = true;
+        queueMicrotask(drain);
+    });
+    return {
+        view,
+        get closed() {
+            return closed;
+        },
+        close() {
+            if (closed)
+                return;
+            closed = true;
+            queue.length = 0;
+            watch.stop();
+        },
+    };
+}
+function applyTracked(root, ops) {
+    for (const op of ops) {
+        if (op[0] === "r")
+            throw new Error("live Pico envelope unexpectedly replaced the view root");
+        const path = op[1];
+        if (op[0] === "p") {
+            const target = resolve(root, path);
+            if (!Array.isArray(target))
+                throw new Error(`Pico splice path is not an array: ${path.join(".")}`);
+            target.splice(op[2], op[3], ...structuredClone(op[4]));
+            continue;
+        }
+        const parent = resolve(root, path.slice(0, -1));
+        if (parent === null || typeof parent !== "object")
+            throw new Error(`Pico operation parent is not an object: ${path.join(".")}`);
+        const key = path[path.length - 1];
+        if (op[0] === "d") {
+            if (Array.isArray(parent))
+                parent.splice(key, 1);
+            else
+                delete parent[key];
+            continue;
+        }
+        const record = parent;
+        if (op[0] === "s")
+            record[key] = structuredClone(op[2]);
+        else if (op[0] === "a")
+            record[key] = `${String(record[key])}${op[2]}`;
+        else
+            record[key] = String(record[key]).slice(op[2]);
+    }
+}
+function resolve(root, path) {
+    let value = root;
+    for (const segment of path) {
+        if (value === null || typeof value !== "object")
+            return undefined;
+        value = value[segment];
+    }
+    return value;
+}
+//# sourceMappingURL=chord.js.map

package/dist/harness/pico3/chord.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chord.js","sourceRoot":"","sources":["../../../src/harness/pico3/chord.ts"],"names":[],"mappings":"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","sourcesContent":["import { type Context, defineService, type MutableReplicatedState, type ReplicatedState } from \"@earendil-works/chord\";\nimport type { Op, Path, Seg } from \"@earendil-works/chord/delta\";\nimport type { ConversationHandle, Harness } from \"./harness.ts\";\nimport type {\n\tConversationSpec,\n\tConversationView,\n\tEntry,\n\tEntryScan,\n\tEnvelope,\n\tId,\n\tJsonObject,\n\tNewEntry,\n\tSendInput,\n\tViewEvent,\n} from \"./types.ts\";\nimport { WATCH_CAPACITY, type Watch } from \"./view.ts\";\n\nexport type PublishedConversationView = ConversationView & {\n\tcommit: { events: ViewEvent[] };\n};\n\nexport interface PicoConversationService {\n\treadonly view: ReplicatedState<PublishedConversationView>;\n\tsend(input: SendInput, ctx: Context): Promise<Id>;\n\twrite(entry: NewEntry, ctx: Context): Promise<Id>;\n\tinputAbort(id: Id, ctx: Context): Promise<\"aborted\" | \"already_placed\" | \"not_found\">;\n\tconfigSet(patch: JsonObject, ctx: Context): Promise<void>;\n\tabort(ctx: Context): Promise<void>;\n\treset(handoff: string | null, ctx: Context): Promise<void>;\n\tcollapse(instructions: string | null, ctx: Context): Promise<Id>;\n\tfork(at: Id | \"start\", spec: Omit<ConversationSpec, \"parent\">, ctx: Context): Promise<Id>;\n\tentries(scan: EntryScan, ctx: Context): Promise<Entry[]>;\n}\n\n/** Local registration/control plane and remote keyed conversation contract used by Chord facets. */\nexport const PicoHarnessService = defineService<Harness>(\"pi.harness\", { local: true });\nexport const PicoConversationService = defineService<PicoConversationService>(\"pi.conversation\");\n\nexport function createPicoConversationService<Cfg extends object>(\n\tharness: Pick<Harness, \"abortInput\" | \"entries\">,\n\tconversation: ConversationHandle<Cfg>,\n\tview: ReplicatedState<PublishedConversationView>,\n): PicoConversationService {\n\treturn {\n\t\tview,\n\t\tsend: (input, ctx) => conversation.send(input, ctx).then((handle) => handle.id),\n\t\twrite: (entry, ctx) => conversation.write(entry, ctx),\n\t\tinputAbort: (id, ctx) => harness.abortInput(id, ctx, conversation.id),\n\t\tconfigSet: (patch, ctx) => conversation.config.set(patch as never, ctx),\n\t\tabort: (ctx) => conversation.abort(ctx),\n\t\treset: (handoff, ctx) => conversation.reset(handoff ?? undefined, ctx),\n\t\tcollapse: (instructions, ctx) => conversation.collapse(instructions ?? undefined, ctx),\n\t\tfork: (at, spec, ctx) => conversation.fork(at, spec, ctx).then((child) => child.id),\n\t\tentries: (scan, ctx) => harness.entries({ ...scan, conversationId: conversation.id }, ctx),\n\t};\n}\n\nexport interface ChordViewBridge {\n\treadonly view: MutableReplicatedState<PublishedConversationView>;\n\treadonly closed: boolean;\n\tclose(): void;\n}\n\nexport interface ChordViewBridgeOptions {\n\tcapacity?: number;\n\t/** Called after the raw watch is closed. The owner should close and respawn its keyed service instance. */\n\tonFailure?: (error: Error) => void;\n}\n\n/**\n * Adapt Pico's commit-granular envelopes to one Chord publication per commit.\n * The raw listener only enqueues. Applying ops and publishing happen together,\n * off the Session line, with no await between them.\n */\nexport async function attachChordView(\n\tconversation: Pick<ConversationHandle, \"watch\">,\n\tcreateState: (initial: PublishedConversationView) => MutableReplicatedState<PublishedConversationView>,\n\tctx: Context,\n\topts: ChordViewBridgeOptions = {},\n): Promise<ChordViewBridge> {\n\tconst watch = await conversation.watch(ctx);\n\tconst view = createState({ ...structuredClone(watch.view), commit: { events: [] } });\n\treturn bridgeWatch(watch, view, ctx, opts);\n}\n\nfunction bridgeWatch(\n\twatch: Watch,\n\tview: MutableReplicatedState<PublishedConversationView>,\n\tctx: Context,\n\topts: ChordViewBridgeOptions,\n): ChordViewBridge {\n\tconst capacity = opts.capacity ?? WATCH_CAPACITY;\n\tif (!Number.isSafeInteger(capacity) || capacity < 1)\n\t\tthrow new RangeError(\"Chord view queue capacity must be positive\");\n\tconst queue: Envelope[] = [];\n\tlet scheduled = false;\n\tlet closed = false;\n\tconst fail = (cause: unknown) => {\n\t\tif (closed) return;\n\t\tclosed = true;\n\t\tqueue.length = 0;\n\t\twatch.stop();\n\t\ttry {\n\t\t\topts.onFailure?.(cause instanceof Error ? cause : new Error(String(cause)));\n\t\t} catch {}\n\t};\n\tconst drain = () => {\n\t\tscheduled = false;\n\t\twhile (!closed && queue.length > 0) {\n\t\t\tconst envelope = queue.shift()!;\n\t\t\ttry {\n\t\t\t\tapplyTracked(view.state, envelope.ops);\n\t\t\t\tview.state.commit.events = structuredClone(envelope.events);\n\t\t\t\tview.publish(ctx);\n\t\t\t} catch (error) {\n\t\t\t\tfail(error);\n\t\t\t}\n\t\t}\n\t};\n\twatch.start((envelope) => {\n\t\tif (closed) return;\n\t\tif (queue.length >= capacity) {\n\t\t\tfail(new Error(`Pico-to-Chord view queue exceeded ${capacity} envelopes`));\n\t\t\treturn;\n\t\t}\n\t\tqueue.push(envelope);\n\t\tif (scheduled) return;\n\t\tscheduled = true;\n\t\tqueueMicrotask(drain);\n\t});\n\treturn {\n\t\tview,\n\t\tget closed() {\n\t\t\treturn closed;\n\t\t},\n\t\tclose() {\n\t\t\tif (closed) return;\n\t\t\tclosed = true;\n\t\t\tqueue.length = 0;\n\t\t\twatch.stop();\n\t\t},\n\t};\n}\n\nfunction applyTracked(root: PublishedConversationView, ops: readonly Op[]): void {\n\tfor (const op of ops) {\n\t\tif (op[0] === \"r\") throw new Error(\"live Pico envelope unexpectedly replaced the view root\");\n\t\tconst path = op[1];\n\t\tif (op[0] === \"p\") {\n\t\t\tconst target = resolve(root, path);\n\t\t\tif (!Array.isArray(target)) throw new Error(`Pico splice path is not an array: ${path.join(\".\")}`);\n\t\t\ttarget.splice(op[2], op[3], ...structuredClone(op[4]));\n\t\t\tcontinue;\n\t\t}\n\t\tconst parent = resolve(root, path.slice(0, -1));\n\t\tif (parent === null || typeof parent !== \"object\")\n\t\t\tthrow new Error(`Pico operation parent is not an object: ${path.join(\".\")}`);\n\t\tconst key = path[path.length - 1]!;\n\t\tif (op[0] === \"d\") {\n\t\t\tif (Array.isArray(parent)) parent.splice(key as number, 1);\n\t\t\telse delete (parent as Record<PropertyKey, unknown>)[key];\n\t\t\tcontinue;\n\t\t}\n\t\tconst record = parent as Record<PropertyKey, unknown>;\n\t\tif (op[0] === \"s\") record[key] = structuredClone(op[2]);\n\t\telse if (op[0] === \"a\") record[key] = `${String(record[key])}${op[2]}`;\n\t\telse record[key] = String(record[key]).slice(op[2]);\n\t}\n}\n\nfunction resolve(root: unknown, path: Path): unknown {\n\tlet value = root;\n\tfor (const segment of path) {\n\t\tif (value === null || typeof value !== \"object\") return undefined;\n\t\tvalue = (value as Record<Seg, unknown>)[segment];\n\t}\n\treturn value;\n}\n"]}

package/dist/harness/pico3/context.d.ts

@@ -0,0 +1,16 @@
+import type { Context } from "@earendil-works/chord";
+import type { ContextView, Id, Storage } from "./types.ts";
+/**
+ * pico §1.3, verbatim:
+ *   H       = newest fork-visible entry at or before T with a head
+ *   from    = H ? H.head : transcript start
+ *   range   = fork-visible entries from `from` through T
+ *   edits   = per target, newest edit in range wins
+ *   entries = H ? [H, ...range without any head entries] : range
+ *   model   = concat(entries.map(e => edits[e.id] ? apply : e.model)), then reorder tool results
+ *
+ * Display-only entries (aborted/error assistants, pi.usage, model-less plugin entries) have no
+ * `model` and contribute nothing. Nothing here inspects an error string.
+ */
+export declare function deriveContext(storage: Storage, conversationId: Id, at: Id | undefined, ctx: Context): Promise<ContextView>;
+//# sourceMappingURL=context.d.ts.map

package/dist/harness/pico3/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/harness/pico3/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAe,WAAW,EAAS,EAAE,EAAkB,OAAO,EAAiB,MAAM,YAAY,CAAC;AAE9G;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAClC,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,EAAE,EAClB,EAAE,EAAE,EAAE,GAAG,SAAS,EAClB,GAAG,EAAE,OAAO,GACV,OAAO,CAAC,WAAW,CAAC,CA4CtB","sourcesContent":["import type { Context } from \"@earendil-works/chord\";\nimport type { ContextEdit, ContextView, Entry, Id, RequestMessage, Storage, StoredMessage } from \"./types.ts\";\n\n/**\n * pico §1.3, verbatim:\n *   H       = newest fork-visible entry at or before T with a head\n *   from    = H ? H.head : transcript start\n *   range   = fork-visible entries from `from` through T\n *   edits   = per target, newest edit in range wins\n *   entries = H ? [H, ...range without any head entries] : range\n *   model   = concat(entries.map(e => edits[e.id] ? apply : e.model)), then reorder tool results\n *\n * Display-only entries (aborted/error assistants, pi.usage, model-less plugin entries) have no\n * `model` and contribute nothing. Nothing here inspects an error string.\n */\nexport async function deriveContext(\n\tstorage: Storage,\n\tconversationId: Id,\n\tat: Id | undefined,\n\tctx: Context,\n): Promise<ContextView> {\n\tconst [head] = await storage.scanEntries(\n\t\t{ conversationId, withHead: true, ...(at === undefined ? {} : { before: at + 1 }), limit: 1 },\n\t\tctx,\n\t);\n\tconst from = head?.head;\n\n\t// Walk newest-first until we pass `from`.\n\tconst range: Entry[] = [];\n\tlet before = at === undefined ? undefined : at + 1;\n\tfor (;;) {\n\t\tconst page = await storage.scanEntries(\n\t\t\t{ conversationId, ...(before === undefined ? {} : { before }), limit: 256 },\n\t\t\tctx,\n\t\t);\n\t\tlet done = page.length < 256;\n\t\tfor (const e of page) {\n\t\t\tif (from !== undefined && e.id < from) {\n\t\t\t\tdone = true;\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\trange.push(e);\n\t\t}\n\t\tif (done) break;\n\t\tbefore = page[page.length - 1]!.id;\n\t}\n\trange.reverse();\n\n\tconst edits = new Map<Id, ContextEdit>();\n\tfor (const e of range) for (const edit of e.edits ?? []) edits.set(edit.target, edit); // later wins by iteration order\n\n\tconst entries = head === undefined ? range : [head, ...range.filter((e) => e.head === undefined)];\n\n\tconst messages: RequestMessage[] = [];\n\tfor (const e of entries) {\n\t\tconst edit = edits.get(e.id);\n\t\tif (edit?.action === \"omit\") continue;\n\t\tif (edit?.action === \"replace\") {\n\t\t\tmessages.push(...(edit.messages ?? []));\n\t\t\tcontinue;\n\t\t}\n\t\tif (e.model) messages.push(...e.model);\n\t}\n\treturn { head, entries, messages: reorderToolResults(messages) };\n}\n\n/** Results are appended as tools finish; put them back in call order, synthesising a missing one after a fork cut. */\ntype StoredAssistant = Extract<StoredMessage, { role: \"assistant\" }>;\ntype StoredToolResult = Extract<StoredMessage, { role: \"toolResult\" }>;\ntype StoredToolCall = Extract<StoredAssistant[\"content\"][number], { type: \"toolCall\" }>;\nfunction reorderToolResults(messages: RequestMessage[]): RequestMessage[] {\n\tconst out: RequestMessage[] = [];\n\tfor (let i = 0; i < messages.length; i++) {\n\t\tconst m = messages[i]!;\n\t\tout.push(m);\n\t\tif (m.role !== \"assistant\") continue;\n\t\tconst calls = (m as StoredAssistant).content.filter((c): c is StoredToolCall => c.type === \"toolCall\");\n\t\tif (calls.length === 0) continue;\n\t\tconst results = new Map<string, StoredToolResult>();\n\t\tlet j = i + 1;\n\t\twhile (j < messages.length && messages[j]!.role === \"toolResult\") {\n\t\t\tconst r = messages[j] as StoredToolResult;\n\t\t\tresults.set(r.toolCallId, r);\n\t\t\tj++;\n\t\t}\n\t\tfor (const call of calls) {\n\t\t\tout.push(\n\t\t\t\tresults.get(call.id) ??\n\t\t\t\t\t({\n\t\t\t\t\t\trole: \"toolResult\",\n\t\t\t\t\t\ttoolCallId: call.id,\n\t\t\t\t\t\ttoolName: call.name,\n\t\t\t\t\t\tcontent: [\n\t\t\t\t\t\t\t{ type: \"text\", text: \"Tool result unavailable: history ends before this call completed.\" },\n\t\t\t\t\t\t],\n\t\t\t\t\t\tisError: true,\n\t\t\t\t\t\tdetails: { reason: \"missing_after_fork\" },\n\t\t\t\t\t\ttimestamp: (m as StoredAssistant).timestamp,\n\t\t\t\t\t} as StoredToolResult),\n\t\t\t);\n\t\t}\n\t\ti = j - 1;\n\t}\n\treturn out;\n}\n"]}

package/dist/harness/pico3/context.js

@@ -0,0 +1,88 @@
+/**
+ * pico §1.3, verbatim:
+ *   H       = newest fork-visible entry at or before T with a head
+ *   from    = H ? H.head : transcript start
+ *   range   = fork-visible entries from `from` through T
+ *   edits   = per target, newest edit in range wins
+ *   entries = H ? [H, ...range without any head entries] : range
+ *   model   = concat(entries.map(e => edits[e.id] ? apply : e.model)), then reorder tool results
+ *
+ * Display-only entries (aborted/error assistants, pi.usage, model-less plugin entries) have no
+ * `model` and contribute nothing. Nothing here inspects an error string.
+ */
+export async function deriveContext(storage, conversationId, at, ctx) {
+    const [head] = await storage.scanEntries({ conversationId, withHead: true, ...(at === undefined ? {} : { before: at + 1 }), limit: 1 }, ctx);
+    const from = head?.head;
+    // Walk newest-first until we pass `from`.
+    const range = [];
+    let before = at === undefined ? undefined : at + 1;
+    for (;;) {
+        const page = await storage.scanEntries({ conversationId, ...(before === undefined ? {} : { before }), limit: 256 }, ctx);
+        let done = page.length < 256;
+        for (const e of page) {
+            if (from !== undefined && e.id < from) {
+                done = true;
+                break;
+            }
+            range.push(e);
+        }
+        if (done)
+            break;
+        before = page[page.length - 1].id;
+    }
+    range.reverse();
+    const edits = new Map();
+    for (const e of range)
+        for (const edit of e.edits ?? [])
+            edits.set(edit.target, edit); // later wins by iteration order
+    const entries = head === undefined ? range : [head, ...range.filter((e) => e.head === undefined)];
+    const messages = [];
+    for (const e of entries) {
+        const edit = edits.get(e.id);
+        if (edit?.action === "omit")
+            continue;
+        if (edit?.action === "replace") {
+            messages.push(...(edit.messages ?? []));
+            continue;
+        }
+        if (e.model)
+            messages.push(...e.model);
+    }
+    return { head, entries, messages: reorderToolResults(messages) };
+}
+function reorderToolResults(messages) {
+    const out = [];
+    for (let i = 0; i < messages.length; i++) {
+        const m = messages[i];
+        out.push(m);
+        if (m.role !== "assistant")
+            continue;
+        const calls = m.content.filter((c) => c.type === "toolCall");
+        if (calls.length === 0)
+            continue;
+        const results = new Map();
+        let j = i + 1;
+        while (j < messages.length && messages[j].role === "toolResult") {
+            const r = messages[j];
+            results.set(r.toolCallId, r);
+            j++;
+        }
+        for (const call of calls) {
+            out.push(results.get(call.id) ??
+                {
+                    role: "toolResult",
+                    toolCallId: call.id,
+                    toolName: call.name,
+                    content: [
+                        { type: "text", text: "Tool result unavailable: history ends before this call completed." },
+                    ],
+                    isError: true,
+                    details: { reason: "missing_after_fork" },
+                    timestamp: m.timestamp,
+                });
+        }
+        i = j - 1;
+    }
+    return out;
+}
+//# sourceMappingURL=context.js.map

package/dist/harness/pico3/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/harness/pico3/context.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Context } from \"@earendil-works/chord\";\nimport type { ContextEdit, ContextView, Entry, Id, RequestMessage, Storage, StoredMessage } from \"./types.ts\";\n\n/**\n * pico §1.3, verbatim:\n *   H       = newest fork-visible entry at or before T with a head\n *   from    = H ? H.head : transcript start\n *   range   = fork-visible entries from `from` through T\n *   edits   = per target, newest edit in range wins\n *   entries = H ? [H, ...range without any head entries] : range\n *   model   = concat(entries.map(e => edits[e.id] ? apply : e.model)), then reorder tool results\n *\n * Display-only entries (aborted/error assistants, pi.usage, model-less plugin entries) have no\n * `model` and contribute nothing. Nothing here inspects an error string.\n */\nexport async function deriveContext(\n\tstorage: Storage,\n\tconversationId: Id,\n\tat: Id | undefined,\n\tctx: Context,\n): Promise<ContextView> {\n\tconst [head] = await storage.scanEntries(\n\t\t{ conversationId, withHead: true, ...(at === undefined ? {} : { before: at + 1 }), limit: 1 },\n\t\tctx,\n\t);\n\tconst from = head?.head;\n\n\t// Walk newest-first until we pass `from`.\n\tconst range: Entry[] = [];\n\tlet before = at === undefined ? undefined : at + 1;\n\tfor (;;) {\n\t\tconst page = await storage.scanEntries(\n\t\t\t{ conversationId, ...(before === undefined ? {} : { before }), limit: 256 },\n\t\t\tctx,\n\t\t);\n\t\tlet done = page.length < 256;\n\t\tfor (const e of page) {\n\t\t\tif (from !== undefined && e.id < from) {\n\t\t\t\tdone = true;\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\trange.push(e);\n\t\t}\n\t\tif (done) break;\n\t\tbefore = page[page.length - 1]!.id;\n\t}\n\trange.reverse();\n\n\tconst edits = new Map<Id, ContextEdit>();\n\tfor (const e of range) for (const edit of e.edits ?? []) edits.set(edit.target, edit); // later wins by iteration order\n\n\tconst entries = head === undefined ? range : [head, ...range.filter((e) => e.head === undefined)];\n\n\tconst messages: RequestMessage[] = [];\n\tfor (const e of entries) {\n\t\tconst edit = edits.get(e.id);\n\t\tif (edit?.action === \"omit\") continue;\n\t\tif (edit?.action === \"replace\") {\n\t\t\tmessages.push(...(edit.messages ?? []));\n\t\t\tcontinue;\n\t\t}\n\t\tif (e.model) messages.push(...e.model);\n\t}\n\treturn { head, entries, messages: reorderToolResults(messages) };\n}\n\n/** Results are appended as tools finish; put them back in call order, synthesising a missing one after a fork cut. */\ntype StoredAssistant = Extract<StoredMessage, { role: \"assistant\" }>;\ntype StoredToolResult = Extract<StoredMessage, { role: \"toolResult\" }>;\ntype StoredToolCall = Extract<StoredAssistant[\"content\"][number], { type: \"toolCall\" }>;\nfunction reorderToolResults(messages: RequestMessage[]): RequestMessage[] {\n\tconst out: RequestMessage[] = [];\n\tfor (let i = 0; i < messages.length; i++) {\n\t\tconst m = messages[i]!;\n\t\tout.push(m);\n\t\tif (m.role !== \"assistant\") continue;\n\t\tconst calls = (m as StoredAssistant).content.filter((c): c is StoredToolCall => c.type === \"toolCall\");\n\t\tif (calls.length === 0) continue;\n\t\tconst results = new Map<string, StoredToolResult>();\n\t\tlet j = i + 1;\n\t\twhile (j < messages.length && messages[j]!.role === \"toolResult\") {\n\t\t\tconst r = messages[j] as StoredToolResult;\n\t\t\tresults.set(r.toolCallId, r);\n\t\t\tj++;\n\t\t}\n\t\tfor (const call of calls) {\n\t\t\tout.push(\n\t\t\t\tresults.get(call.id) ??\n\t\t\t\t\t({\n\t\t\t\t\t\trole: \"toolResult\",\n\t\t\t\t\t\ttoolCallId: call.id,\n\t\t\t\t\t\ttoolName: call.name,\n\t\t\t\t\t\tcontent: [\n\t\t\t\t\t\t\t{ type: \"text\", text: \"Tool result unavailable: history ends before this call completed.\" },\n\t\t\t\t\t\t],\n\t\t\t\t\t\tisError: true,\n\t\t\t\t\t\tdetails: { reason: \"missing_after_fork\" },\n\t\t\t\t\t\ttimestamp: (m as StoredAssistant).timestamp,\n\t\t\t\t\t} as StoredToolResult),\n\t\t\t);\n\t\t}\n\t\ti = j - 1;\n\t}\n\treturn out;\n}\n"]}