@laserdata/laser-sdk 0.5.3 → 0.6.0

package/dist/context.d.ts

@@ -2,12 +2,20 @@ import type { Laser } from "./client/laser.js";
 import type { Provenance } from "./provenance/provenance.js";
 import type { AgentId, ConversationId, MessageId } from "./types/ids.js";
 import type { AgentEnvelope } from "./wire/agent.js";
+/**
+ * The most raw records one context read examines in each partition, the same
+ * window the Rust and Python SDKs use. An open read takes the newest records
+ * before the current tail, and a point-in-time read the newest records before
+ * the checkpoint, then keeps the ones of the conversation. Turns older than the
+ * window on a busy shared partition are outside the read, so a long
+ * conversation saves state with a checkpoint and replays from it.
+ */
+export declare const CONTEXT_READ_WINDOW = 10000;
 export interface ContextMessage {
     readonly id: MessageId;
     readonly provenance: Provenance;
     readonly payload: Uint8Array;
     readonly envelope?: AgentEnvelope;
-    readonly timestampMicros: bigint;
     /** The name of the topic the message was read from. */
     readonly topic: string;
 }
@@ -18,16 +26,22 @@ export interface ContextMessage {
 export declare class Checkpoint {
     private readonly perTopic;
     private constructor();
-    static empty(): Checkpoint;
-    static capture(laser: Laser, topics: readonly string[]): Promise<Checkpoint>;
     /** The per-partition offsets for `topic`, or `undefined` when the checkpoint
      * was not taken over that topic. */
     topicOffsets(topic: string): ReadonlyMap<number, bigint> | undefined;
-    get topics(): readonly string[];
     isEmpty(): boolean;
-    toJSON(): Record<string, Record<string, string>>;
+    /** The Rust and Python JSON shape, `{"per_topic": {topic: {partition: offset}}}`,
+     * with every offset an exact JSON integer. */
+    toJSON(): {
+        readonly per_topic: Readonly<Record<string, Readonly<Record<string, unknown>>>>;
+    };
+    /** Reads `toJSON` output, as a JSON string or an already parsed value. */
     static fromJSON(value: unknown): Checkpoint;
 }
+/** The current tail of `topics` on `laser`'s default stream, one entry per
+ * topic. Fold up to it with the `at` replay bound or resume after it with
+ * `from-checkpoint`. */
+export declare function contextCheckpoint(laser: Laser, topics: readonly string[]): Promise<Checkpoint>;
 export interface ContextPolicy {
     select(history: readonly ContextMessage[]): readonly ContextMessage[];
 }
@@ -41,18 +55,18 @@ export declare class RoleFilter implements ContextPolicy {
     constructor(agents: Iterable<AgentId>);
     select(history: readonly ContextMessage[]): readonly ContextMessage[];
 }
-export declare class ContextChain implements ContextPolicy {
+export declare class Chain implements ContextPolicy {
     readonly policies: readonly ContextPolicy[];
     constructor(policies: readonly ContextPolicy[]);
     select(history: readonly ContextMessage[]): readonly ContextMessage[];
 }
 export declare class TokenBudget implements ContextPolicy {
-    readonly maxTokens: number;
+    private readonly maxTokens;
     private readonly estimate;
     constructor(maxTokens: number, estimate?: (message: ContextMessage) => number);
     select(history: readonly ContextMessage[]): readonly ContextMessage[];
 }
-interface ContextAssemblerOptions {
+export interface ContextAssemblerOptions {
     readonly conversation: ConversationId;
     readonly acrossSubconversations: boolean;
     readonly topics: readonly string[];
@@ -62,19 +76,20 @@ interface ContextAssemblerOptions {
     readonly toCheckpoint?: Checkpoint;
 }
 export declare class ContextAssemblerBuilder {
-    private readonly conversation;
+    private conversation;
     private acrossChildren;
     private selectedTopics;
     private selectedPolicy;
     private offsets;
     private resumeFrom;
     private stopAt;
-    constructor(conversation: ConversationId);
+    /** The conversation whose history is assembled. Required. */
+    conversationId(conversation: ConversationId): this;
     acrossSubconversations(value?: boolean): this;
     topics(topics: readonly string[]): this;
     policy(policy: ContextPolicy): this;
-    /** One offset map shared by every topic. `fromCheckpoint` takes precedence
-     * for the topics it names. */
+    /** One offset map shared by every topic. If `fromCheckpoint` is set, it
+     * replaces this map for every topic. Missing checkpoint positions start at zero. */
     fromOffsets(offsets: ReadonlyMap<number, bigint>): this;
     /** Resume after `checkpoint`, per topic and partition, and read to the tail. */
     fromCheckpoint(checkpoint: Checkpoint): this;
@@ -84,10 +99,12 @@ export declare class ContextAssemblerBuilder {
 }
 export declare class ContextAssembler {
     private readonly options;
-    static builder(conversation: ConversationId): ContextAssemblerBuilder;
-    constructor(options: ContextAssemblerOptions);
+    static builder(): ContextAssemblerBuilder;
+    private constructor();
     assemble(laser: Laser): Promise<readonly ContextMessage[]>;
-    private matches;
 }
-export {};
+/** Every record of each partition's range instead of the newest
+ * `CONTEXT_READ_WINDOW`, for state replay. An open range ends at the tail
+ * seen when the replay starts. Not exported from the package. */
+export declare function replayContext(options: ContextAssemblerOptions, laser: Laser): Promise<readonly ContextMessage[]>;
 //# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

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

package/dist/context.js

@@ -1,12 +1,21 @@
+import { ConfigError, InvalidError } from "./client/errors.js";
 import { decodeAgentMessage } from "./agent/reliable-consumer.js";
 import { AgentTopic } from "./provenance/agent-topic.js";
 const READ_BATCH = 1_000;
-// Ceiling on the records one assembly holds in memory per topic. A conversation
-// topic grows without bound, and this read is reachable from bridge requests, so
-// the window keeps the most recent records rather than materializing the whole
-// history. Selection policies want the newest records, so the oldest are the
-// ones dropped.
-const MAX_CONTEXT_RECORDS = 10_000;
+/**
+ * The most raw records one context read examines in each partition, the same
+ * window the Rust and Python SDKs use. An open read takes the newest records
+ * before the current tail, and a point-in-time read the newest records before
+ * the checkpoint, then keeps the ones of the conversation. Turns older than the
+ * window on a busy shared partition are outside the read, so a long
+ * conversation saves state with a checkpoint and replays from it.
+ */
+export const CONTEXT_READ_WINDOW = 10_000;
+const WINDOW = BigInt(CONTEXT_READ_WINDOW);
+const U32_MAX = 0xffff_ffff;
+const U64_MAX = 0xffffffffffffffffn;
+// Node 22 writes and reads JSON integers beyond 2^53 exactly through these.
+const EXACT_JSON = JSON;
 /** A point in a conversation's log: the next offset each partition of each
  * topic will write, as captured by `ContextScope.checkpoint`. A client-side
  * bookmark keyed by topic name, never a record on the log. `toJSON` and
@@ -16,9 +25,7 @@ export class Checkpoint {
     constructor(perTopic) {
         this.perTopic = perTopic;
     }
-    static empty() {
-        return new Checkpoint(new Map());
-    }
+    /** @internal */
     static async capture(laser, topics) {
         const entries = await Promise.all(topics.map(async (topic) => [topic, await laser.topic(topic).tailOffsets()]));
         return new Checkpoint(new Map(entries));
@@ -28,39 +35,51 @@ export class Checkpoint {
     topicOffsets(topic) {
         return this.perTopic.get(topic);
     }
-    get topics() {
-        return [...this.perTopic.keys()];
-    }
     isEmpty() {
         return this.perTopic.size === 0;
     }
+    /** The Rust and Python JSON shape, `{"per_topic": {topic: {partition: offset}}}`,
+     * with every offset an exact JSON integer. */
     toJSON() {
-        return Object.fromEntries([...this.perTopic].map(([topic, offsets]) => [
-            topic,
-            Object.fromEntries([...offsets].map(([partition, offset]) => [String(partition), String(offset)]))
-        ]));
+        return {
+            per_topic: Object.fromEntries([...this.perTopic].map(([topic, offsets]) => [
+                topic,
+                Object.fromEntries([...offsets].map(([partition, offset]) => [String(partition), jsonInteger(offset)]))
+            ]))
+        };
     }
+    /** Reads `toJSON` output, as a JSON string or an already parsed value. */
     static fromJSON(value) {
-        const parsed = typeof value === "string" ? JSON.parse(value) : value;
-        if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
-            throw new TypeError("a checkpoint is an object keyed by topic name");
+        let parsed = value;
+        if (typeof value === "string") {
+            try {
+                parsed = JSON.parse(value, exactIntegers);
+            }
+            catch (cause) {
+                throw new InvalidError("a checkpoint must be JSON", undefined, { cause });
+            }
         }
         const perTopic = new Map();
-        for (const [topic, offsets] of Object.entries(parsed)) {
-            if (typeof offsets !== "object" || offsets === null || Array.isArray(offsets)) {
-                throw new TypeError(`checkpoint topic ${topic} is not an object keyed by partition`);
-            }
-            perTopic.set(topic, new Map(Object.entries(offsets).map(([partition, offset]) => {
-                if (!/^\d+$/.test(partition) ||
-                    (typeof offset !== "string" && typeof offset !== "number")) {
-                    throw new TypeError(`checkpoint topic ${topic} has an invalid partition entry`);
+        for (const [topic, offsets] of Object.entries(jsonObject(jsonObject(parsed, "a checkpoint")["per_topic"], "checkpoint per_topic"))) {
+            const partitions = new Map();
+            for (const [partition, offset] of Object.entries(jsonObject(offsets, `checkpoint topic ${topic}`))) {
+                const partitionId = Number(partition);
+                if (!/^\d+$/.test(partition) || partitionId > U32_MAX) {
+                    throw new InvalidError(`checkpoint topic ${topic} has partition ${partition}, not a u32`);
                 }
-                return [Number(partition), BigInt(offset)];
-            })));
+                partitions.set(partitionId, offsetOf(offset, topic));
+            }
+            perTopic.set(topic, partitions);
         }
         return new Checkpoint(perTopic);
     }
 }
+/** The current tail of `topics` on `laser`'s default stream, one entry per
+ * topic. Fold up to it with the `at` replay bound or resume after it with
+ * `from-checkpoint`. */
+export function contextCheckpoint(laser, topics) {
+    return Checkpoint.capture(laser, topics);
+}
 export class LastN {
     count;
     constructor(count) {
@@ -73,16 +92,16 @@ export class LastN {
 export class RoleFilter {
     agents;
     constructor(agents) {
-        this.agents = new Set([...agents].map((agent) => agent.asString()));
+        this.agents = new Set([...agents].map((agent) => agent.asStr()));
     }
     select(history) {
         return history.filter((message) => {
             const agent = message.provenance.agent;
-            return agent !== undefined && this.agents.has(agent.asString());
+            return agent !== undefined && this.agents.has(agent.asStr());
         });
     }
 }
-export class ContextChain {
+export class Chain {
     policies;
     constructor(policies) {
         this.policies = policies;
@@ -123,8 +142,10 @@ export class ContextAssemblerBuilder {
     offsets = new Map();
     resumeFrom;
     stopAt;
-    constructor(conversation) {
+    /** The conversation whose history is assembled. Required. */
+    conversationId(conversation) {
         this.conversation = conversation;
+        return this;
     }
     acrossSubconversations(value = true) {
         this.acrossChildren = value;
@@ -138,8 +159,8 @@ export class ContextAssemblerBuilder {
         this.selectedPolicy = policy;
         return this;
     }
-    /** One offset map shared by every topic. `fromCheckpoint` takes precedence
-     * for the topics it names. */
+    /** One offset map shared by every topic. If `fromCheckpoint` is set, it
+     * replaces this map for every topic. Missing checkpoint positions start at zero. */
     fromOffsets(offsets) {
         this.offsets = new Map(offsets);
         return this;
@@ -155,7 +176,10 @@ export class ContextAssemblerBuilder {
         return this;
     }
     build() {
-        return new ContextAssembler({
+        if (this.conversation === undefined) {
+            throw new ConfigError("ContextAssembler.builder().conversationId() is required");
+        }
+        return ContextAssembler.create({
             conversation: this.conversation,
             acrossSubconversations: this.acrossChildren,
             topics: this.selectedTopics,
@@ -168,72 +192,127 @@ export class ContextAssemblerBuilder {
 }
 export class ContextAssembler {
     options;
-    static builder(conversation) {
-        return new ContextAssemblerBuilder(conversation);
+    static builder() {
+        return new ContextAssemblerBuilder();
     }
     constructor(options) {
         this.options = options;
     }
-    async assemble(laser) {
-        const perTopic = await Promise.all(this.options.topics.map(async (topic, topicIndex) => {
-            const collected = [];
-            // A topic nobody has written yet has no history, same as in Rust.
-            if ((await laser.topic(topic).partitionCount()) === undefined)
-                return collected;
-            const cursor = await laser.topic(topic).replay({ batchSize: READ_BATCH });
-            const resume = this.options.fromCheckpoint?.topicOffsets(topic);
-            cursor.fromOffsets(resume ?? this.options.fromOffsets);
-            const stop = this.options.toCheckpoint;
-            if (stop !== undefined) {
-                // A checkpoint holds the next offset to write, so a partition it does
-                // not name existed only after it and reads as empty.
-                const ends = stop.topicOffsets(topic) ?? new Map();
-                cursor.until(new Map([...cursor.offsets.keys()].map((partition) => [partition, ends.get(partition) ?? 0n])));
-            }
-            for (;;) {
-                const records = await cursor.poll();
-                if (records.length === 0)
-                    break;
-                for (const record of records) {
-                    const decoded = decodeAgentMessage(record);
-                    if (decoded.kind !== "message" || !this.matches(decoded.message.provenance))
-                        continue;
-                    collected.push({
-                        id: decoded.message.id,
-                        provenance: decoded.message.provenance,
-                        payload: decoded.message.payload,
-                        ...(decoded.message.envelope !== undefined
-                            ? { envelope: decoded.message.envelope }
-                            : {}),
-                        timestampMicros: record.timestampMicros ?? 0n,
-                        topic,
-                        topicIndex
-                    });
-                    if (collected.length > MAX_CONTEXT_RECORDS)
-                        collected.shift();
-                }
-            }
+    /** @internal */
+    static create(options) {
+        return new ContextAssembler(options);
+    }
+    assemble(laser) {
+        return readContext(this.options, laser, false);
+    }
+}
+/** Every record of each partition's range instead of the newest
+ * `CONTEXT_READ_WINDOW`, for state replay. An open range ends at the tail
+ * seen when the replay starts. Not exported from the package. */
+export function replayContext(options, laser) {
+    return readContext(options, laser, true);
+}
+async function readContext(options, laser, whole) {
+    const perTopic = await Promise.all(options.topics.map(async (topic, topicIndex) => {
+        // The log timestamp only orders the merged read, like in Rust.
+        const collected = [];
+        // A topic nobody has written yet has no history, same as in Rust.
+        if ((await laser.topic(topic).partitionCount()) === undefined)
             return collected;
-        }));
-        const ordered = perTopic.flat().sort((left, right) => {
-            if (left.timestampMicros !== right.timestampMicros) {
-                return left.timestampMicros < right.timestampMicros ? -1 : 1;
-            }
-            if (left.topicIndex !== right.topicIndex)
-                return left.topicIndex - right.topicIndex;
-            if (left.id.partitionId !== right.id.partitionId) {
-                return left.id.partitionId - right.id.partitionId;
+        const handle = laser.topic(topic);
+        const cursor = (await handle.replay()).batch(READ_BATCH);
+        const partitions = [...cursor.offsets.keys()];
+        const resume = options.fromCheckpoint;
+        const from = (partition) => resume === undefined
+            ? (options.fromOffsets.get(partition) ?? 0n)
+            : (resume.topicOffsets(topic)?.get(partition) ?? 0n);
+        // A checkpoint holds the next offset to write, so a point-in-time read
+        // ends before it, and a partition it does not name existed only after
+        // it and reads as empty. An open read ends at the tail seen now.
+        const stop = options.toCheckpoint;
+        const ends = stop === undefined
+            ? await handle.tailOffsets()
+            : (stop.topicOffsets(topic) ?? new Map());
+        const starts = new Map();
+        const bounds = new Map();
+        for (const partition of partitions) {
+            const end = ends.get(partition) ?? 0n;
+            const windowStart = end > WINDOW ? end - WINDOW : 0n;
+            const start = from(partition);
+            starts.set(partition, whole || start > windowStart ? start : windowStart);
+            bounds.set(partition, end);
+        }
+        cursor.fromOffsets(starts).until(bounds);
+        for (;;) {
+            const records = await cursor.pollRecords();
+            if (records.length === 0)
+                break;
+            for (const record of records) {
+                const decoded = decodeAgentMessage(record);
+                if (decoded.kind !== "message" || !inConversation(options, decoded.message.provenance))
+                    continue;
+                collected.push({
+                    id: decoded.message.id,
+                    provenance: decoded.message.provenance,
+                    payload: decoded.message.payload,
+                    ...(decoded.message.envelope !== undefined
+                        ? { envelope: decoded.message.envelope }
+                        : {}),
+                    timestampMicros: record.timestampMicros ?? 0n,
+                    topic,
+                    topicIndex
+                });
             }
-            return left.id.offset < right.id.offset ? -1 : left.id.offset > right.id.offset ? 1 : 0;
-        });
-        return this.options.policy.select(ordered);
+        }
+        return collected;
+    }));
+    const ordered = perTopic.flat().sort((left, right) => {
+        if (left.timestampMicros !== right.timestampMicros) {
+            return left.timestampMicros < right.timestampMicros ? -1 : 1;
+        }
+        if (left.topicIndex !== right.topicIndex)
+            return left.topicIndex - right.topicIndex;
+        if (left.id.partitionId !== right.id.partitionId) {
+            return left.id.partitionId - right.id.partitionId;
+        }
+        return left.id.offset < right.id.offset ? -1 : left.id.offset > right.id.offset ? 1 : 0;
+    });
+    return options.policy.select(ordered);
+}
+function inConversation(options, provenance) {
+    if (provenance.conversationId.equals(options.conversation))
+        return true;
+    return (options.acrossSubconversations &&
+        (provenance.rootConversationId?.equals(options.conversation) === true ||
+            provenance.parentConversationId?.equals(options.conversation) === true));
+}
+function jsonInteger(value) {
+    return value <= BigInt(Number.MAX_SAFE_INTEGER)
+        ? Number(value)
+        : EXACT_JSON.rawJSON(String(value));
+}
+function exactIntegers(_key, value, context) {
+    return typeof value === "number" &&
+        context?.source !== undefined &&
+        /^-?\d+$/.test(context.source)
+        ? BigInt(context.source)
+        : value;
+}
+function jsonObject(value, what) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new InvalidError(`${what} must be a JSON object`);
     }
-    matches(provenance) {
-        if (provenance.conversationId.equals(this.options.conversation))
-            return true;
-        return (this.options.acrossSubconversations &&
-            (provenance.rootConversationId?.equals(this.options.conversation) === true ||
-                provenance.parentConversationId?.equals(this.options.conversation) === true));
+    return value;
+}
+function offsetOf(value, topic) {
+    const offset = typeof value === "bigint"
+        ? value
+        : typeof value === "number" && Number.isSafeInteger(value)
+            ? BigInt(value)
+            : undefined;
+    if (offset === undefined || offset < 0n || offset > U64_MAX) {
+        throw new InvalidError(`checkpoint topic ${topic} has an offset that is not a u64`);
     }
+    return offset;
 }
 //# sourceMappingURL=context.js.map

package/dist/context.js.map

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

package/dist/conversation-state.d.ts

@@ -21,7 +21,7 @@ export type ReplayBound = {
 export declare const FULL_REPLAY: ReplayBound;
 export declare function resumeOffsets(snapshot: FoldSnapshot): ReadonlyMap<number, bigint>;
 declare function load<State>(laser: Laser, conversation: ConversationId, topics: readonly string[], bound: ReplayBound, initial: State, fold: (state: State, message: ContextMessage) => State): Promise<State>;
-declare function loadWith<State>(laser: Laser, store: SnapshotStore, conversation: ConversationId, topics: readonly string[], initial: State, decodeState: (bytes: Uint8Array) => State, fold: (state: State, message: ContextMessage) => State): Promise<State>;
+declare function loadWith<State>(laser: Laser, store: SnapshotStore, conversation: ConversationId, topics: readonly string[], initial: State, fold: (state: State, message: ContextMessage) => State, decodeState?: (bytes: Uint8Array) => State): Promise<State>;
 export declare const ConversationState: {
     readonly load: typeof load;
     readonly loadWith: typeof loadWith;

package/dist/conversation-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-state.d.ts","sourceRoot":"","sources":["../src/conversation-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAA2B,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AAC5F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,EAA4B,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEhF,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAChF;IAAE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;CAAE,GACrE;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;CAAE,GACxD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAE7B,eAAO,MAAM,WAAW,EAAE,WAA8B,CAAA;AAExD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,YAAY,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAOjF;AAED,iBAAe,IAAI,CAAC,KAAK,EACvB,KAAK,EAAE,KAAK,EACZ,YAAY,EAAE,cAAc,EAC5B,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,KAAK,EACd,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,KAAK,KAAK,GACrD,OAAO,CAAC,KAAK,CAAC,CAehB;AAED,iBAAe,QAAQ,CAAC,KAAK,EAC3B,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,aAAa,EACpB,YAAY,EAAE,cAAc,EAC5B,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,OAAO,EAAE,KAAK,EACd,WAAW,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,KAAK,EACzC,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,KAAK,KAAK,GACrD,OAAO,CAAC,KAAK,CAAC,CAYhB;AAED,eAAO,MAAM,iBAAiB;;;CAA8B,CAAA"}
+{"version":3,"file":"conversation-state.d.ts","sourceRoot":"","sources":["../src/conversation-state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,cAAc,EACpB,MAAM,cAAc,CAAA;AACrB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,EAA4B,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEhF,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAChF;IAAE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;CAAE,GACrE;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;CAAE,GACxD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAE7B,eAAO,MAAM,WAAW,EAAE,WAA8B,CAAA;AAExD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,YAAY,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAOjF;AAKD,iBAAe,IAAI,CAAC,KAAK,EACvB,KAAK,EAAE,KAAK,EACZ,YAAY,EAAE,cAAc,EAC5B,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,KAAK,EACd,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,KAAK,KAAK,GACrD,OAAO,CAAC,KAAK,CAAC,CAuBhB;AAID,iBAAe,QAAQ,CAAC,KAAK,EAC3B,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,aAAa,EACpB,YAAY,EAAE,cAAc,EAC5B,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,OAAO,EAAE,KAAK,EACd,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,KAAK,KAAK,EACtD,WAAW,GAAE,CAAC,KAAK,EAAE,UAAU,KAAK,KAAkD,GACrF,OAAO,CAAC,KAAK,CAAC,CAYhB;AAYD,eAAO,MAAM,iBAAiB;;;CAA8B,CAAA"}

package/dist/conversation-state.js

@@ -1,4 +1,5 @@
-import { ContextAssembler, LastN } from "./context.js";
+import { CodecError } from "./client/errors.js";
+import { ContextAssembler, LastN, replayContext } from "./context.js";
 import { foldSnapshotResumeOffset } from "./wire/snapshot.js";
 export const FULL_REPLAY = { kind: "full" };
 export function resumeOffsets(snapshot) {
@@ -7,29 +8,47 @@ export function resumeOffsets(snapshot) {
         foldSnapshotResumeOffset(snapshot, partition)
     ]));
 }
+// `last` reads the newest context window like a context read. Every other
+// bound folds its whole range, read in chunks up to the tail seen when the
+// replay starts or up to the checkpoint.
 async function load(laser, conversation, topics, bound, initial, fold) {
-    const builder = ContextAssembler.builder(conversation).topics(topics);
-    if (bound.kind === "last")
-        builder.policy(new LastN(bound.count));
-    if (bound.kind === "full")
-        builder.policy(new LastN(Number.MAX_SAFE_INTEGER));
-    if (bound.kind === "from-offsets") {
-        builder.policy(new LastN(Number.MAX_SAFE_INTEGER)).fromOffsets(bound.offsets);
+    if (bound.kind === "last") {
+        const history = await ContextAssembler.builder()
+            .conversationId(conversation)
+            .topics(topics)
+            .policy(new LastN(bound.count))
+            .build()
+            .assemble(laser);
+        return history.reduce(fold, initial);
     }
-    if (bound.kind === "from-checkpoint") {
-        builder.policy(new LastN(Number.MAX_SAFE_INTEGER)).fromCheckpoint(bound.checkpoint);
-    }
-    if (bound.kind === "at") {
-        builder.policy(new LastN(Number.MAX_SAFE_INTEGER)).toCheckpoint(bound.checkpoint);
-    }
-    const history = await builder.build().assemble(laser);
+    const history = await replayContext({
+        conversation,
+        acrossSubconversations: false,
+        topics,
+        policy: new LastN(Number.MAX_SAFE_INTEGER),
+        fromOffsets: bound.kind === "from-offsets" ? bound.offsets : new Map(),
+        ...(bound.kind === "from-checkpoint" ? { fromCheckpoint: bound.checkpoint } : {}),
+        ...(bound.kind === "at" ? { toCheckpoint: bound.checkpoint } : {})
+    }, laser);
     return history.reduce(fold, initial);
 }
-async function loadWith(laser, store, conversation, topics, initial, decodeState, fold) {
+// The newest snapshot's state (JSON by default, like the Rust SDK) plus a
+// replay of only the tail past it.
+async function loadWith(laser, store, conversation, topics, initial, fold, decodeState = (bytes) => decodeJsonState(bytes)) {
     const snapshot = await store.latest(conversation);
     return load(laser, conversation, topics, snapshot === undefined
         ? FULL_REPLAY
         : { kind: "from-offsets", offsets: resumeOffsets(snapshot) }, snapshot === undefined ? initial : decodeState(snapshot.state), fold);
 }
+function decodeJsonState(bytes) {
+    try {
+        return JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(bytes));
+    }
+    catch (error) {
+        throw new CodecError(`decode snapshot state: ${String(error)}`, "json", "decode", {
+            cause: error
+        });
+    }
+}
 export const ConversationState = { load, loadWith };
 //# sourceMappingURL=conversation-state.js.map