assistant-stream 0.3.13 → 0.3.15

package/dist/resumable/stores/redis-impl.d.ts

@@ -0,0 +1,60 @@
+import type { ResumableStreamAcquireOptions, ResumableStreamEntry, ResumableStreamRole, ResumableStreamStatus, ResumableStreamStore } from "../types.js";
+export type PipelineCommand = {
+    readonly type: "xAdd";
+    readonly key: string;
+    readonly fields: Record<string, string | Uint8Array>;
+} | {
+    readonly type: "expire";
+    readonly key: string;
+    readonly ttlSec: number;
+} | {
+    readonly type: "set";
+    readonly key: string;
+    readonly value: string;
+    readonly ttlSec: number;
+};
+/**
+ * Structural Redis-client interface. The bundled `redis` and `ioredis`
+ * adapters wrap their respective clients to satisfy it; custom or proxied
+ * clients can implement it directly.
+ */
+export interface RedisLikeClient {
+    setNX(key: string, value: string, ttlSec: number): Promise<boolean>;
+    set(key: string, value: string, ttlSec: number): Promise<void>;
+    get(key: string): Promise<string | null>;
+    expire(key: string, ttlSec: number): Promise<void>;
+    exists(key: string): Promise<boolean>;
+    del(keys: string[]): Promise<void>;
+    xAdd(key: string, fields: Record<string, string | Uint8Array>): Promise<string>;
+    xRange(key: string, start: string, end: string): Promise<Array<{
+        id: string;
+        fields: Record<string, string | Uint8Array>;
+    }>>;
+    /** Executes the commands as a single pipeline batch (one round trip). */
+    pipeline(commands: readonly PipelineCommand[]): Promise<void>;
+}
+export type RedisResumableStreamStoreOptions = {
+    readonly keyPrefix?: string;
+    readonly defaultTtlMs?: number;
+    /** Defaults to 100ms. Lower values reduce read latency, raise traffic. */
+    readonly pollIntervalMs?: number;
+    readonly maxChunkBytes?: number;
+};
+export declare class RedisResumableStreamStore implements ResumableStreamStore {
+    private readonly client;
+    private readonly keyPrefix;
+    private readonly defaultTtlMs;
+    private readonly pollIntervalMs;
+    private readonly maxChunkBytes;
+    constructor(client: RedisLikeClient, options?: RedisResumableStreamStoreOptions);
+    acquire(streamId: string, options?: ResumableStreamAcquireOptions): Promise<ResumableStreamRole>;
+    append(streamId: string, chunk: Uint8Array): Promise<void>;
+    finalize(streamId: string, status: "done" | "error", error?: string): Promise<void>;
+    read(streamId: string, cursor: string, signal: AbortSignal): AsyncIterable<ResumableStreamEntry>;
+    status(streamId: string): Promise<ResumableStreamStatus>;
+    delete(streamId: string): Promise<void>;
+    private readMeta;
+    private metaKey;
+    private dataKey;
+}
+//# sourceMappingURL=redis-impl.d.ts.map

package/dist/resumable/stores/redis-impl.d.ts.map

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

package/dist/resumable/stores/redis-impl.js

@@ -0,0 +1,198 @@
+import { DEFAULT_TTL_MS } from "../constants.js";
+import { ResumableStreamError, validateStreamId } from "../errors.js";
+const DEFAULT_POLL_INTERVAL_MS = 100;
+const DEFAULT_KEY_PREFIX = "aui:resumable";
+const FIELD_CHUNK = "c";
+const FIELD_FIN = "fin";
+const FIELD_ERROR = "error";
+const FIN_DONE = "done";
+const FIN_ERROR = "error";
+const STREAM_START_ID = "0-0";
+export class RedisResumableStreamStore {
+    client;
+    keyPrefix;
+    defaultTtlMs;
+    pollIntervalMs;
+    maxChunkBytes;
+    constructor(client, options = {}) {
+        this.client = client;
+        this.keyPrefix = options.keyPrefix ?? DEFAULT_KEY_PREFIX;
+        this.defaultTtlMs = options.defaultTtlMs ?? DEFAULT_TTL_MS;
+        this.pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+        this.maxChunkBytes = options.maxChunkBytes;
+    }
+    async acquire(streamId, options) {
+        validateStreamId(streamId);
+        const ttlSec = msToSec(options?.ttlMs ?? this.defaultTtlMs);
+        const meta = JSON.stringify({ status: "streaming", ttlSec });
+        const acquired = await this.client.setNX(this.metaKey(streamId), meta, ttlSec);
+        if (acquired) {
+            // a prior producer's data key may outlive its expired meta key.
+            await this.client.del([this.dataKey(streamId)]);
+            return "producer";
+        }
+        return "consumer";
+    }
+    async append(streamId, chunk) {
+        validateStreamId(streamId);
+        if (this.maxChunkBytes !== undefined &&
+            chunk.byteLength > this.maxChunkBytes) {
+            throw new Error(`Chunk exceeds maxChunkBytes (${chunk.byteLength} > ${this.maxChunkBytes})`);
+        }
+        const dataKey = this.dataKey(streamId);
+        const metaKey = this.metaKey(streamId);
+        const meta = await this.readMeta(streamId);
+        if (!meta) {
+            throw new Error(`Stream not found: ${streamId}`);
+        }
+        if (meta.status !== "streaming") {
+            throw new ResumableStreamError("finalized", `Stream already finalized: ${streamId}`);
+        }
+        const ttlSec = meta.ttlSec ?? msToSec(this.defaultTtlMs);
+        await this.client.pipeline([
+            { type: "xAdd", key: dataKey, fields: { [FIELD_CHUNK]: chunk } },
+            { type: "expire", key: dataKey, ttlSec },
+            { type: "expire", key: metaKey, ttlSec },
+        ]);
+    }
+    async finalize(streamId, status, error) {
+        validateStreamId(streamId);
+        const dataKey = this.dataKey(streamId);
+        const metaKey = this.metaKey(streamId);
+        const existing = await this.readMeta(streamId);
+        if (!existing) {
+            throw new Error(`Stream not found: ${streamId}`);
+        }
+        // a second finalize must not append a duplicate FIN entry.
+        if (existing.status !== "streaming")
+            return;
+        const ttlSec = existing.ttlSec ?? msToSec(this.defaultTtlMs);
+        const meta = JSON.stringify(status === "error"
+            ? { status: "error", error: error ?? "Stream errored", ttlSec }
+            : { status: "done", ttlSec });
+        const fields = {
+            [FIELD_FIN]: status === "error" ? FIN_ERROR : FIN_DONE,
+        };
+        if (status === "error") {
+            fields[FIELD_ERROR] = error ?? "Stream errored";
+        }
+        await this.client.pipeline([
+            { type: "set", key: metaKey, value: meta, ttlSec },
+            { type: "xAdd", key: dataKey, fields },
+            { type: "expire", key: dataKey, ttlSec },
+        ]);
+    }
+    async *read(streamId, cursor, signal) {
+        validateStreamId(streamId);
+        const dataKey = this.dataKey(streamId);
+        const metaKey = this.metaKey(streamId);
+        const initialMeta = await this.client.get(metaKey);
+        if (initialMeta === null) {
+            throw new Error(`Stream not found: ${streamId}`);
+        }
+        let lastId = cursor === "" ? STREAM_START_ID : cursor;
+        while (true) {
+            if (signal.aborted)
+                return;
+            const start = lastId === STREAM_START_ID ? "-" : `(${lastId}`;
+            const entries = await this.client.xRange(dataKey, start, "+");
+            for (const entry of entries) {
+                if (signal.aborted)
+                    return;
+                lastId = entry.id;
+                const fin = readString(entry.fields[FIELD_FIN]);
+                if (fin === FIN_DONE)
+                    return;
+                if (fin === FIN_ERROR) {
+                    throw new Error(readString(entry.fields[FIELD_ERROR]) ?? "Stream errored");
+                }
+                const raw = entry.fields[FIELD_CHUNK];
+                if (raw === undefined)
+                    continue;
+                yield { cursor: entry.id, chunk: toBytes(raw) };
+            }
+            if (entries.length > 0)
+                continue;
+            const stillExists = await this.client.exists(metaKey);
+            if (!stillExists)
+                return;
+            await sleep(this.pollIntervalMs, signal);
+        }
+    }
+    async status(streamId) {
+        validateStreamId(streamId);
+        const meta = await this.client.get(this.metaKey(streamId));
+        if (meta === null)
+            return "missing";
+        const parsed = parseMeta(meta);
+        if (parsed?.status === "streaming")
+            return "streaming";
+        if (parsed?.status === "done")
+            return "done";
+        if (parsed?.status === "error")
+            return "error";
+        return "missing";
+    }
+    async delete(streamId) {
+        validateStreamId(streamId);
+        await this.client.del([this.metaKey(streamId), this.dataKey(streamId)]);
+    }
+    async readMeta(streamId) {
+        const raw = await this.client.get(this.metaKey(streamId));
+        if (raw === null)
+            return undefined;
+        return parseMeta(raw);
+    }
+    // {streamId} is a Redis Cluster hash tag so both keys live on the same
+    // shard; multi-key DEL and same-stream pipelines stay single-slot.
+    metaKey(streamId) {
+        return `${this.keyPrefix}:{${streamId}}:meta`;
+    }
+    dataKey(streamId) {
+        return `${this.keyPrefix}:{${streamId}}:data`;
+    }
+}
+function parseMeta(value) {
+    try {
+        const parsed = JSON.parse(value);
+        return parsed && typeof parsed === "object" ? parsed : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function msToSec(ms) {
+    return Math.max(1, Math.ceil(ms / 1000));
+}
+function sleep(ms, signal) {
+    return new Promise((resolve) => {
+        if (signal.aborted) {
+            resolve();
+            return;
+        }
+        const timer = setTimeout(() => {
+            signal.removeEventListener("abort", onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            resolve();
+        };
+        signal.addEventListener("abort", onAbort, { once: true });
+    });
+}
+const SHARED_DECODER = new TextDecoder();
+const SHARED_ENCODER = new TextEncoder();
+function readString(value) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value === "string")
+        return value;
+    return SHARED_DECODER.decode(value);
+}
+function toBytes(value) {
+    if (value instanceof Uint8Array)
+        return value;
+    return SHARED_ENCODER.encode(value);
+}
+//# sourceMappingURL=redis-impl.js.map

package/dist/resumable/stores/redis-impl.js.map

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

package/dist/resumable/stores/redis.d.ts

@@ -0,0 +1,39 @@
+import { type RedisResumableStreamStoreOptions } from "./redis-impl.js";
+import type { ResumableStreamStore } from "../types.js";
+type NodeRedisFields = Record<string, string | Buffer>;
+interface NodeRedisMultiCommand {
+    xAdd(key: string, id: string, fields: NodeRedisFields): NodeRedisMultiCommand;
+    expire(key: string, seconds: number): NodeRedisMultiCommand;
+    set(key: string, value: string, options: {
+        EX: number;
+    }): NodeRedisMultiCommand;
+    execAsPipeline(): Promise<unknown>;
+    exec(): Promise<unknown>;
+}
+/** Structural subset of node-redis v5 used by the adapter. */
+export interface NodeRedisLike {
+    set(key: string, value: string, options: {
+        NX: true;
+        EX: number;
+    }): Promise<string | null>;
+    set(key: string, value: string, options: {
+        EX: number;
+    }): Promise<string | null>;
+    get(key: string): Promise<string | null>;
+    expire(key: string, seconds: number): Promise<unknown>;
+    exists(key: string): Promise<number>;
+    del(keys: string | string[]): Promise<unknown>;
+    xAdd(key: string, id: string, fields: NodeRedisFields): Promise<string>;
+    sendCommand<T = unknown>(args: ReadonlyArray<string | Buffer>, options?: {
+        typeMapping?: Record<number, unknown>;
+    }): Promise<T>;
+    multi(): NodeRedisMultiCommand;
+}
+/**
+ * Resumable stream store backed by [`redis`](https://www.npmjs.com/package/redis)
+ * v5. Expects a connected client; cluster routing relies on the shared
+ * `{streamId}` hash tag baked into the key scheme.
+ */
+export declare function createRedisResumableStreamStore(client: NodeRedisLike, options?: RedisResumableStreamStoreOptions): ResumableStreamStore;
+export {};
+//# sourceMappingURL=redis.d.ts.map

package/dist/resumable/stores/redis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../../src/resumable/stores/redis.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,gCAAgC,EACtC,wBAAqB;AACtB,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAiB;AAIrD,KAAK,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;AAEvD,UAAU,qBAAqB;IAC7B,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,qBAAqB,CAAC;IAC9E,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,qBAAqB,CAAC;IAC5D,GAAG,CACD,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GACtB,qBAAqB,CAAC;IACzB,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1B;AAED,8DAA8D;AAC9D,MAAM,WAAW,aAAa;IAC5B,GAAG,CACD,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAChC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC1B,GAAG,CACD,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GACtB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC1B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxE,WAAW,CAAC,CAAC,GAAG,OAAO,EACrB,IAAI,EAAE,aAAa,CAAC,MAAM,GAAG,MAAM,CAAC,EACpC,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAClD,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,KAAK,IAAI,qBAAqB,CAAC;CAChC;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,aAAa,EACrB,OAAO,CAAC,EAAE,gCAAgC,GACzC,oBAAoB,CAEtB"}

package/dist/resumable/stores/redis.js

@@ -0,0 +1,113 @@
+import { RedisResumableStreamStore, } from "./redis-impl.js";
+const RESP_BLOB_STRING = 36;
+/**
+ * Resumable stream store backed by [`redis`](https://www.npmjs.com/package/redis)
+ * v5. Expects a connected client; cluster routing relies on the shared
+ * `{streamId}` hash tag baked into the key scheme.
+ */
+export function createRedisResumableStreamStore(client, options) {
+    return new RedisResumableStreamStore(adapt(client), options);
+}
+function adapt(client) {
+    return {
+        async setNX(key, value, ttlSec) {
+            const result = await client.set(key, value, { NX: true, EX: ttlSec });
+            return result === "OK";
+        },
+        async set(key, value, ttlSec) {
+            await client.set(key, value, { EX: ttlSec });
+        },
+        async get(key) {
+            return client.get(key);
+        },
+        async expire(key, ttlSec) {
+            await client.expire(key, ttlSec);
+        },
+        async exists(key) {
+            const result = await client.exists(key);
+            return result > 0;
+        },
+        async del(keys) {
+            if (keys.length === 0)
+                return;
+            await client.del(keys.length === 1 ? keys[0] : keys);
+        },
+        async xAdd(key, fields) {
+            return client.xAdd(key, "*", toNodeFields(fields));
+        },
+        async xRange(key, start, end) {
+            const reply = await client.sendCommand(["XRANGE", key, start, end], { typeMapping: { [RESP_BLOB_STRING]: Buffer } });
+            return parseXRangeReply(reply);
+        },
+        async pipeline(commands) {
+            if (commands.length === 0)
+                return;
+            let chain = client.multi();
+            for (const cmd of commands) {
+                chain = applyPipelineCommand(chain, cmd);
+            }
+            await chain.execAsPipeline();
+        },
+    };
+}
+function applyPipelineCommand(chain, cmd) {
+    switch (cmd.type) {
+        case "xAdd":
+            return chain.xAdd(cmd.key, "*", toNodeFields(cmd.fields));
+        case "expire":
+            return chain.expire(cmd.key, cmd.ttlSec);
+        case "set":
+            return chain.set(cmd.key, cmd.value, { EX: cmd.ttlSec });
+    }
+}
+function toNodeFields(fields) {
+    const out = {};
+    for (const [k, v] of Object.entries(fields)) {
+        out[k] = typeof v === "string" ? v : toBuffer(v);
+    }
+    return out;
+}
+function toBuffer(bytes) {
+    if (Buffer.isBuffer(bytes))
+        return bytes;
+    return Buffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+}
+function parseXRangeReply(reply) {
+    if (!Array.isArray(reply))
+        return [];
+    const out = [];
+    for (const entry of reply) {
+        if (!Array.isArray(entry) || entry.length < 2)
+            continue;
+        const [rawId, rawFields] = entry;
+        const id = bufferOrStringToString(rawId);
+        if (id === undefined || !Array.isArray(rawFields))
+            continue;
+        const fields = {};
+        for (let i = 0; i + 1 < rawFields.length; i += 2) {
+            const fieldKey = bufferOrStringToString(rawFields[i]);
+            const fieldValue = rawFields[i + 1];
+            if (fieldKey === undefined || fieldValue === undefined)
+                continue;
+            fields[fieldKey] = bufferOrStringToBytes(fieldValue);
+        }
+        out.push({ id, fields });
+    }
+    return out;
+}
+function bufferOrStringToString(value) {
+    if (typeof value === "string")
+        return value;
+    if (Buffer.isBuffer(value))
+        return value.toString("utf8");
+    return undefined;
+}
+function bufferOrStringToBytes(value) {
+    if (typeof value === "string")
+        return value;
+    if (Buffer.isBuffer(value)) {
+        return new Uint8Array(value.buffer, value.byteOffset, value.byteLength);
+    }
+    return "";
+}
+//# sourceMappingURL=redis.js.map

package/dist/resumable/stores/redis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.js","sourceRoot":"","sources":["../../../src/resumable/stores/redis.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,GAI1B,wBAAqB;AAGtB,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAwC5B;;;;GAIG;AACH,MAAM,UAAU,+BAA+B,CAC7C,MAAqB,EACrB,OAA0C;IAE1C,OAAO,IAAI,yBAAyB,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,KAAK,CAAC,MAAqB;IAClC,OAAO;QACL,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM;YAC5B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YACtE,OAAO,MAAM,KAAK,IAAI,CAAC;QACzB,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM;YAC1B,MAAM,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAC/C,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,GAAG;YACX,OAAO,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM;YACtB,MAAM,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACnC,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,GAAG;YACd,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACxC,OAAO,MAAM,GAAG,CAAC,CAAC;QACpB,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,IAAI;YACZ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO;YAC9B,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACxD,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM;YACpB,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QACrD,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG;YAC1B,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,WAAW,CACpC,CAAC,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,EAC3B,EAAE,WAAW,EAAE,EAAE,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,EAAE,CAChD,CAAC;YACF,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;QACD,KAAK,CAAC,QAAQ,CAAC,QAAQ;YACrB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO;YAClC,IAAI,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;YAC3B,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;gBAC3B,KAAK,GAAG,oBAAoB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAC3C,CAAC;YACD,MAAM,KAAK,CAAC,cAAc,EAAE,CAAC;QAC/B,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAC3B,KAA4B,EAC5B,GAAoB;IAEpB,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,MAAM;YACT,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;QAC5D,KAAK,QAAQ;YACX,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QAC3C,KAAK,KAAK;YACR,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CACnB,MAA2C;IAE3C,MAAM,GAAG,GAAoB,EAAE,CAAC;IAChC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5C,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,QAAQ,CAAC,KAAiB;IACjC,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACzC,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,gBAAgB,CACvB,KAAc;IAEd,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,MAAM,GAAG,GAGJ,EAAE,CAAC;IACR,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS;QACxD,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,GAAG,KAA2B,CAAC;QACvD,MAAM,EAAE,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,EAAE,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;YAAE,SAAS;QAC5D,MAAM,MAAM,GAAwC,EAAE,CAAC;QACvD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACjD,MAAM,QAAQ,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;YACtD,MAAM,UAAU,GAAG,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACpC,IAAI,QAAQ,KAAK,SAAS,IAAI,UAAU,KAAK,SAAS;gBAAE,SAAS;YACjE,MAAM,CAAC,QAAQ,CAAC,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;QACvD,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAc;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1D,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc;IAC3C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/resumable/types.d.ts

@@ -0,0 +1,30 @@
+export type ResumableStreamRole = "producer" | "consumer";
+export type ResumableStreamStatus = "streaming" | "done" | "error" | "missing";
+export type ResumableStreamEntry = {
+    readonly cursor: string;
+    readonly chunk: Uint8Array;
+};
+export type ResumableStreamAcquireOptions = {
+    readonly ttlMs?: number;
+};
+export interface ResumableStreamStore {
+    /**
+     * Atomic election. The first caller for a given `streamId` observes
+     * `"producer"`; every later caller observes `"consumer"`, including those
+     * arriving after `finalize`.
+     */
+    acquire(streamId: string, options?: ResumableStreamAcquireOptions): Promise<ResumableStreamRole>;
+    /** Implementations should refresh the TTL on each call. */
+    append(streamId: string, chunk: Uint8Array): Promise<void>;
+    finalize(streamId: string, status: "done" | "error", error?: string): Promise<void>;
+    /**
+     * Yields persisted entries strictly after `cursor` (`""` starts from the
+     * beginning), then waits for new ones until the stream is finalized.
+     * Aborting `signal` resolves the iterable without throwing.
+     */
+    read(streamId: string, cursor: string, signal: AbortSignal): AsyncIterable<ResumableStreamEntry>;
+    status(streamId: string): Promise<ResumableStreamStatus>;
+    /** Active readers terminate. No-op when the stream does not exist. */
+    delete(streamId: string): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/resumable/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/resumable/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,UAAU,CAAC;AAE1D,MAAM,MAAM,qBAAqB,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAE/E,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,OAAO,CACL,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,6BAA6B,GACtC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEhC,2DAA2D;IAC3D,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3D,QAAQ,CACN,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GAAG,OAAO,EACxB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;OAIG;IACH,IAAI,CACF,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,GAClB,aAAa,CAAC,oBAAoB,CAAC,CAAC;IAEvC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAEzD,sEAAsE;IACtE,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC"}

package/dist/resumable/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/resumable/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/resumable/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "assistant-stream",
-  "version": "0.3.13",
+  "version": "0.3.15",
   "description": "Streaming utilities for AI assistants",
   "keywords": [
     "ai",
@@ -22,6 +22,18 @@
     "./utils": {
       "types": "./dist/utils.d.ts",
       "default": "./dist/utils.js"
+    },
+    "./resumable": {
+      "types": "./dist/resumable/index.d.ts",
+      "default": "./dist/resumable/index.js"
+    },
+    "./resumable/redis": {
+      "types": "./dist/resumable/stores/redis.d.ts",
+      "default": "./dist/resumable/stores/redis.js"
+    },
+    "./resumable/ioredis": {
+      "types": "./dist/resumable/stores/ioredis.d.ts",
+      "default": "./dist/resumable/stores/ioredis.js"
     }
   },
   "main": "./dist/index.js",
@@ -38,10 +50,24 @@
     "nanoid": "^5.1.11",
     "secure-json-parse": "^4.1.0"
   },
+  "peerDependencies": {
+    "ioredis": "^5.10.1",
+    "redis": "^5.12.1"
+  },
+  "peerDependenciesMeta": {
+    "ioredis": {
+      "optional": true
+    },
+    "redis": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@types/json-schema": "^7.0.15",
+    "ioredis": "^5.10.1",
+    "redis": "^5.12.1",
     "vitest": "^4.1.5",
-    "@assistant-ui/x-buildutils": "0.0.7"
+    "@assistant-ui/x-buildutils": "0.0.8"
   },
   "publishConfig": {
     "access": "public",

package/src/core/AssistantStream.ts

@@ -1,7 +1,22 @@
 import type { AssistantStreamChunk } from "./AssistantStreamChunk";
 
+/**
+ * Stream of assistant-ui protocol chunks.
+ *
+ * `AssistantStream` is the normalized internal stream format used by
+ * encoders, decoders, accumulators, and tool execution transforms. Use an
+ * encoder such as `DataStreamEncoder` when returning it from an HTTP route,
+ * and the matching decoder when reading it back from a response.
+ */
 export type AssistantStream = ReadableStream<AssistantStreamChunk>;
 
+/**
+ * Encoder that converts an {@link AssistantStream} into bytes suitable for an
+ * HTTP response body.
+ *
+ * Encoders may expose response headers, such as content type or protocol
+ * markers, through `headers`.
+ */
 export type AssistantStreamEncoder = ReadableWritablePair<
   Uint8Array<ArrayBuffer>,
   AssistantStreamChunk
@@ -10,12 +25,26 @@ export type AssistantStreamEncoder = ReadableWritablePair<
 };
 
 export const AssistantStream = {
+  /**
+   * Converts an {@link AssistantStream} into a `Response` using the supplied
+   * encoder.
+   *
+   * The encoder's `headers` are copied onto the response. Pair this with the
+   * decoder for the same wire format when consuming the response.
+   */
   toResponse(stream: AssistantStream, transformer: AssistantStreamEncoder) {
     return new Response(AssistantStream.toByteStream(stream, transformer), {
       headers: transformer.headers ?? {},
     });
   },
 
+  /**
+   * Reads an assistant stream from a `Response` body using the supplied
+   * decoder.
+   *
+   * The response body must be present and encoded with the matching assistant
+   * stream wire format.
+   */
   fromResponse(
     response: Response,
     transformer: ReadableWritablePair<
@@ -26,6 +55,10 @@ export const AssistantStream = {
     return AssistantStream.fromByteStream(response.body!, transformer);
   },
 
+  /**
+   * Pipes an {@link AssistantStream} through an encoder and returns the
+   * resulting byte stream.
+   */
   toByteStream(
     stream: AssistantStream,
     transformer: ReadableWritablePair<
@@ -36,6 +69,10 @@ export const AssistantStream = {
     return stream.pipeThrough(transformer);
   },
 
+  /**
+   * Pipes a byte stream through a decoder and returns normalized
+   * {@link AssistantStreamChunk} values.
+   */
   fromByteStream(
     readable: ReadableStream<Uint8Array<ArrayBuffer>>,
     transformer: ReadableWritablePair<