@oribos/resumable-stream 0.0.0-stage → 0.9.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,3 +1,57 @@
-# Temporary Holding Version
+# @oribos/resumable-stream
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Reconnectable agent streams — the resumable-stream capability package. It records a run's
+chunk stream into an event cache and replays-and-follows it with `observe(runId)`: a client
+that disconnects mid-stream reconnects with the run id and loses nothing. One seam, no core
+changes — the core keeps no resume endpoint; the GET endpoint that turns `observe` into HTTP
+is the application's:
+
+```ts
+import { createEventCacheApp } from './app'; // your route layer
+import { withEventCache, observe, createInMemoryEventCache } from '@oribos/resumable-stream';
+
+const cache = createInMemoryEventCache();
+
+// POST /chat — record the run as it streams (the run id is your key for it)
+const output = withEventCache(agent.stream(input), { runId, cache });
+for await (const chunk of output) response.write(sse(chunk));
+
+// GET /stream/<runId> — the reconnect: replay the missed chunks, then follow live
+for await (const chunk of observe(cache, runId)) response.write(sse(chunk));
+```
+
+## How it works
+
+- **`withEventCache(output, { runId, cache })`** wraps the agent's (or durable agent's) stream
+  and appends every chunk to the cache as it flows — the returned object has the same shape
+  as the original (chunk stream + terminal promises), so it drops into the streaming path you
+  already have. The recording survives the consumer: the wrapper's own pump drives the run to
+  completion even after its consumer hangs up, which is exactly the reconnect story's other
+  half. A cache that refuses an append fails the run — the recording is part of the run, not a
+  best-effort side channel.
+- **`observe(cache, runId)`** replays a run's cached chunks in stream order, then follows the
+  run live until it ends. A finished run replays from anywhere the cache can be read; a failed
+  run replays what it produced and then rejects with the recorded failure. A run that is
+  `active` but not being recorded in this process replays and then throws `RunNotLiveError` —
+  cross-instance live tails need a PubSub (a different package's seam), and this package does
+  not smuggle one in as a polling loop. Unknown runs throw `UnknownRunError`.
+- **`closeOnSuspend` needs no mechanism**: a durable run's stream ends with its
+  `finish` chunk (`finishReason: 'suspended'`) and the run's cache entry closes with it, so
+  observers see the run end exactly when the stream did; resuming is a new run id.
+
+## The cache port
+
+- **`createInMemoryEventCache()`** — the default: a Map of run logs, zero dependencies, zero
+  process footprint, no timers. It never evicts on its own; call `drop(runId)` when a run's
+  replay window has passed (that knob stays yours).
+- **`createRedisEventCache({ client, prefix? })`** — durable replay for production: one JSON
+  log per run under `<prefix>oribos:stream:<runId>`, on any Redis-compatible client
+  (`get` / `set` / `del` — the structural subset `ioredis` and `node-redis` both satisfy).
+  A run's log survives a process restart, and any instance sharing the database can replay
+  it. The client is yours; the dependency stays out of this package.
+
+Zero cost when unconfigured: without the wrapper the core's stream path is untouched. No
+resident pipeline: everything happens inline in the request that triggered it.
+
+See `examples/resumable-stream` for the disconnect-reconnect story as a runnable script
+(wired into the repo's offline examples gate).

package/dist/index.d.ts

@@ -0,0 +1,160 @@
+/**
+ * `@oribos/resumable-stream` — the resumable-stream capability package: reconnectable agent
+ * streams (`docs/architecture/harness.md` CUT-H1, ADR-0017 追赶面中层;#184).
+ *
+ * The carrying seam is the output object, not the core: `withEventCache` wraps the chunk
+ * stream an agent (or durable agent) already returned, appending every chunk to an
+ * `EventCache` as it flows — and `observe(cache, runId)` replays a run's cached chunks in
+ * order, then follows the run live until it ends. A client that disconnects mid-stream
+ * reconnects with the run id and loses nothing: the recording pass survives the disconnect
+ * (the wrapper keeps pumping the inner run for the cache even after its own consumer leaves),
+ * and the reconnected observer replays from the cache and rejoins the live tail.
+ *
+ * Pins kept (CUT-M1 / ADR-0011): the core has no resume endpoint and gets none — the GET
+ * endpoint an application exposes is the application's; this package only caches and replays
+ * events, it never re-drives a run. Zero cost when unconfigured: without the wrapper the
+ * core's stream path is untouched. No resident pipeline: everything happens inline in the
+ * request that triggered it — no timers, no polling loops, no background workers.
+ *
+ * `closeOnSuspend` needs no mechanism of its own: a durable run's stream ends with a
+ * `finish` chunk (`finishReason: 'suspended'`) and the wrapper closes the run's cache entry
+ * on stream end, so observers see the run end exactly when the stream did. Resuming is the
+ * application's orchestration (a new run id, a fresh recording).
+ *
+ * The cache is the package's own port: an in-memory default ships here, and
+ * `createRedisEventCache` adapts any Redis-compatible client (`get` / `set` / `del` — the
+ * structural subset `ioredis` and `node-redis` both satisfy) for durable replay across
+ * restarts. Live following is in-process: a run recorded in another process (or a process
+ * that died mid-run) replays from the cache, but `observe` refuses to wait on a run no one
+ * in this process is recording (`RunNotLiveError`) — cross-instance live tails are the
+ * PubSub package's territory, not a polling loop smuggled in here.
+ *
+ * Package face: [`withEventCache`], [`observe`], [`EventCache`], [`RunEventLog`],
+ * [`RunEventStatus`], [`createInMemoryEventCache`], [`createRedisEventCache`],
+ * [`RedisLikeClient`], [`UnknownRunError`], [`RunNotLiveError`].
+ */
+import type { AgentStreamResult } from '@oribos/core/agent';
+import type { Chunk } from '@oribos/core/model';
+/** Where a recorded run stands: still streaming, ended, or failed. */
+export type RunEventStatus = 'active' | 'done' | 'error';
+/** One run's cached event log: its chunks, in stream order, plus where the run stands. */
+export interface RunEventLog {
+    /** The run id the events were recorded under. */
+    readonly runId: string;
+    /** The run's chunks in stream order — the replay source. */
+    readonly chunks: readonly Chunk[];
+    /** `active` while the recording pass is still appending; terminal once closed/failed. */
+    readonly status: RunEventStatus;
+    /** Why an `error` run failed (the error's message); absent otherwise. */
+    readonly error?: string | undefined;
+}
+/**
+ * The package's event-cache port: the seam an external store rides. The in-memory default
+ * ([`createInMemoryEventCache`]) carries no dependency; `createRedisEventCache` adapts any
+ * Redis-compatible client. One run has one writer (the `withEventCache` wrapper); readers
+ * may be anywhere the cache can be read from.
+ */
+export interface EventCache {
+    /** Append one chunk to the run's log, creating the log (status `active`) on first append. */
+    append(runId: string, chunk: Chunk): Promise<void>;
+    /** Mark the run `done` — its stream ended. Keeps the chunks for replay. */
+    close(runId: string): Promise<void>;
+    /** Mark the run `error` with the failure's message. Keeps the chunks already cached. */
+    fail(runId: string, error: unknown): Promise<void>;
+    /** The run's log, or `undefined` for a run this cache has never heard of. */
+    read(runId: string): Promise<RunEventLog | undefined>;
+    /** Forget the run entirely — the retention knob (the defaults never evict on their own). */
+    drop(runId: string): Promise<void>;
+}
+/** The in-memory `EventCache` default: a Map of run logs, zero dependencies and zero process footprint. */
+export declare function createInMemoryEventCache(): EventCache;
+/**
+ * The structural subset of a Redis-compatible client the adapter calls: `get`, `set`, `del`
+ * with string values. `ioredis` and `node-redis` clients both satisfy it as-is — pass yours,
+ * keep the dependency yours.
+ */
+export interface RedisLikeClient {
+    /** GET a key; `null` when absent (both major clients' missing-key convention). */
+    get(key: string): Promise<string | null>;
+    /** SET a key to a string value. */
+    set(key: string, value: string): Promise<unknown>;
+    /** DEL a key. */
+    del(key: string): Promise<unknown>;
+}
+/** `createRedisEventCache` config: your client, and an optional key prefix. */
+export interface RedisEventCacheConfig {
+    /** Any Redis-compatible client (`get` / `set` / `del`). */
+    readonly client: RedisLikeClient;
+    /** Key prefix for this cache's runs; distinct prefixes never collide. Absent = none. */
+    readonly prefix?: string | undefined;
+}
+/**
+ * The Redis-backed `EventCache`: one JSON log per run under `<prefix>oribos:stream:<runId>`.
+ * Appends are read-modify-write of the whole log (one run has one writer — the wrapper), so
+ * the log survives a process restart and any instance sharing the database can replay it.
+ * Chunks must be JSON-serializable (the chunk protocol's values are, by construction).
+ */
+export declare function createRedisEventCache(config: RedisEventCacheConfig): EventCache;
+/** `observe` on a run this cache has never heard of. The application maps it (HTTP: 404). */
+export declare class UnknownRunError extends Error {
+    constructor(runId: string);
+}
+/**
+ * `observe` on a run the cache says is `active` but no `withEventCache` in this process is
+ * recording: the run lives in another instance, or its process died mid-run. The cached
+ * chunks replayed fine; waiting for a tail nobody here can see would hang forever, so the
+ * refusal is explicit. The application maps it (HTTP: conflict / retry later); cross-instance
+ * live tails need a PubSub, which is a different package's seam.
+ */
+export declare class RunNotLiveError extends Error {
+    constructor(runId: string);
+}
+/** `withEventCache` config: the app-chosen run id the events are recorded under, and the cache. */
+export interface WithEventCacheConfig {
+    /** The id reconnecting clients will `observe` — the application's own key for this run. */
+    readonly runId: string;
+    /** Where the events go; absent handling = your choice of the two defaults or your own port. */
+    readonly cache: EventCache;
+}
+/**
+ * Wraps an agent (or durable agent) stream's output object with event recording: the returned
+ * object has the same shape — the same chunk stream to `for await`, the same terminal
+ * promises (`text` / `object` / `steps` / `finishReason` / …) — and, as a side effect of the
+ * same pass, every chunk is appended to the cache and the run's entry is closed (or failed)
+ * when the run ends.
+ *
+ * The recording survives the consumer: the wrapper's own pump drives the inner run to
+ * completion regardless of how it is consumed, so an SSE client hanging up mid-stream leaves
+ * the cache holding the whole run — that is the reconnect story's other half (`observe` is
+ * the first). A cache that refuses an append fails the wrapped run (the recording is part of
+ * the run, not a best-effort side channel — the rag package's fail-the-run precedent). One
+ * run id may be recorded once per cache at a time; recording it again while live throws.
+ *
+ * ```ts
+ * const output = withEventCache(agent.stream(input, { memory: { thread, resource } }), {
+ *   runId, cache,
+ * });
+ * ```
+ */
+export declare function withEventCache<T extends AgentStreamResult>(output: T, config: WithEventCacheConfig): T;
+/**
+ * Replays a run's cached chunks in stream order, then follows the run live until it ends —
+ * the reconnecting client's whole read: one call, first the events it missed, then the tail
+ * it would have seen had it never left.
+ *
+ * - A **finished** run replays from anywhere the cache can be read (with the Redis adapter:
+ * from any instance sharing the database) and then ends; a **failed** run replays what it
+ * produced and then rejects with the recorded failure.
+ * - A **live** run (being recorded by a `withEventCache` wrapper in this process) replays
+ * and follows in-process, chunk by chunk, ending exactly when the run does — including a
+ * durable run's suspension (`finishReason: 'suspended'`): the observer sees the run end and
+ * reconnects later with the resume run's id.
+ * - An **active-but-not-live** run (recorded in another instance, or its process died
+ * mid-run) replays its cached chunks and then throws [`RunNotLiveError`] — waiting on a tail
+ * nobody here can see would hang forever. An unknown run throws [`UnknownRunError`].
+ *
+ * The application owns the endpoint that turns this into HTTP (SSE or otherwise) — the core
+ * keeps no resume endpoint (CUT-M1); this is the read side of that application's route.
+ */
+export declare function observe(cache: EventCache, runId: string): AsyncIterable<Chunk>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,345 @@
+/** The in-memory `EventCache` default: a Map of run logs, zero dependencies and zero process footprint. */
+export function createInMemoryEventCache() {
+    const logs = new Map();
+    const entry = (runId) => {
+        let log = logs.get(runId);
+        if (log === undefined) {
+            log = { chunks: [], status: 'active' };
+            logs.set(runId, log);
+        }
+        return log;
+    };
+    return {
+        append: async (runId, chunk) => void entry(runId).chunks.push(chunk),
+        close: async (runId) => void (entry(runId).status = 'done'),
+        fail: async (runId, error) => {
+            const log = entry(runId);
+            log.status = 'error';
+            log.error = errorMessage(error);
+        },
+        read: async (runId) => {
+            const log = logs.get(runId);
+            if (log === undefined)
+                return undefined;
+            return { runId, chunks: [...log.chunks], status: log.status, error: log.error };
+        },
+        drop: async (runId) => void logs.delete(runId),
+    };
+}
+/**
+ * The Redis-backed `EventCache`: one JSON log per run under `<prefix>oribos:stream:<runId>`.
+ * Appends are read-modify-write of the whole log (one run has one writer — the wrapper), so
+ * the log survives a process restart and any instance sharing the database can replay it.
+ * Chunks must be JSON-serializable (the chunk protocol's values are, by construction).
+ */
+export function createRedisEventCache(config) {
+    const { client } = config;
+    const scope = config.prefix === undefined || config.prefix === '' ? '' : `${config.prefix}:`;
+    const key = (runId) => `${scope}oribos:stream:${runId}`;
+    async function load(runId) {
+        const raw = await client.get(key(runId));
+        if (raw === null)
+            return { chunks: [], status: 'active' };
+        return JSON.parse(raw);
+    }
+    async function save(runId, log) {
+        await client.set(key(runId), JSON.stringify(log));
+    }
+    return {
+        append: async (runId, chunk) => {
+            const log = await load(runId);
+            log.chunks.push(chunk);
+            await save(runId, log);
+        },
+        close: async (runId) => {
+            const log = await load(runId);
+            await save(runId, { ...log, status: 'done' });
+        },
+        fail: async (runId, error) => {
+            const log = await load(runId);
+            await save(runId, { ...log, status: 'error', error: errorMessage(error) });
+        },
+        read: async (runId) => {
+            const raw = await client.get(key(runId));
+            if (raw === null)
+                return undefined;
+            const log = JSON.parse(raw);
+            return { runId, chunks: log.chunks, status: log.status, error: log.error };
+        },
+        drop: (runId) => Promise.resolve(client.del(key(runId))).then(() => undefined),
+    };
+}
+/** `observe` on a run this cache has never heard of. The application maps it (HTTP: 404). */
+export class UnknownRunError extends Error {
+    constructor(runId) {
+        super(`observe: unknown run ${JSON.stringify(runId)} — nothing was recorded under this id`);
+        this.name = 'UnknownRunError';
+    }
+}
+/**
+ * `observe` on a run the cache says is `active` but no `withEventCache` in this process is
+ * recording: the run lives in another instance, or its process died mid-run. The cached
+ * chunks replayed fine; waiting for a tail nobody here can see would hang forever, so the
+ * refusal is explicit. The application maps it (HTTP: conflict / retry later); cross-instance
+ * live tails need a PubSub, which is a different package's seam.
+ */
+export class RunNotLiveError extends Error {
+    constructor(runId) {
+        super(`observe: run ${JSON.stringify(runId)} is active but not recorded in this process — ` +
+            'its cached events replayed, but its live tail lives elsewhere (cross-instance live ' +
+            'following needs a PubSub; a restarted or crashed recording process leaves the run ' +
+            'permanently active in the cache)');
+        this.name = 'RunNotLiveError';
+    }
+}
+/** Live recordings by run id, keyed by cache instance — in-process following only, no globals. */
+const liveRuns = new WeakMap();
+function liveMap(cache) {
+    let runs = liveRuns.get(cache);
+    if (runs === undefined) {
+        runs = new Map();
+        liveRuns.set(cache, runs);
+    }
+    return runs;
+}
+function broadcast(run, event) {
+    // Chunk events keep the subscribers — a tail has many; a terminal event is one-shot, and
+    // detaching on it is what stops a finished run's observer list from growing.
+    if (event.kind === 'chunk') {
+        for (const subscriber of run.subscribers)
+            subscriber(event);
+        return;
+    }
+    for (const subscriber of run.subscribers.splice(0))
+        subscriber(event);
+}
+/**
+ * Wraps an agent (or durable agent) stream's output object with event recording: the returned
+ * object has the same shape — the same chunk stream to `for await`, the same terminal
+ * promises (`text` / `object` / `steps` / `finishReason` / …) — and, as a side effect of the
+ * same pass, every chunk is appended to the cache and the run's entry is closed (or failed)
+ * when the run ends.
+ *
+ * The recording survives the consumer: the wrapper's own pump drives the inner run to
+ * completion regardless of how it is consumed, so an SSE client hanging up mid-stream leaves
+ * the cache holding the whole run — that is the reconnect story's other half (`observe` is
+ * the first). A cache that refuses an append fails the wrapped run (the recording is part of
+ * the run, not a best-effort side channel — the rag package's fail-the-run precedent). One
+ * run id may be recorded once per cache at a time; recording it again while live throws.
+ *
+ * ```ts
+ * const output = withEventCache(agent.stream(input, { memory: { thread, resource } }), {
+ *   runId, cache,
+ * });
+ * ```
+ */
+export function withEventCache(output, config) {
+    const { runId, cache } = config;
+    const runs = liveMap(cache);
+    if (runs.has(runId)) {
+        throw new Error(`withEventCache: run ${JSON.stringify(runId)} is already being recorded on this cache — ` +
+            'one run id, one recording');
+    }
+    const run = { seq: 0, ended: undefined, subscribers: [] };
+    runs.set(runId, run);
+    let started = false;
+    let settled = false;
+    let failure;
+    /** The consumer left the loop; the pump keeps going — the cache is the point. */
+    let abandoned = false;
+    const buffered = [];
+    const waiting = [];
+    const DONE = { value: undefined, done: true };
+    function start() {
+        if (started)
+            return;
+        started = true;
+        void pump();
+    }
+    async function pump() {
+        const iterator = output[Symbol.asyncIterator]();
+        try {
+            for (;;) {
+                const next = await iterator.next();
+                if (next.done)
+                    break;
+                await cache.append(runId, next.value);
+                const seq = run.seq;
+                run.seq += 1;
+                if (run.ended === undefined)
+                    broadcast(run, { kind: 'chunk', seq, chunk: next.value });
+                deliver(next.value);
+            }
+        }
+        catch (error) {
+            await endWithFailure(error);
+            return;
+        }
+        await endWithSuccess();
+    }
+    /** The run completed: close the cache entry, tell the observers, settle the stream. */
+    async function endWithSuccess() {
+        await guard(() => cache.close(runId));
+        run.ended = { kind: 'done' };
+        broadcast(run, run.ended);
+        runs.delete(runId);
+        settled = true;
+        for (const waiter of waiting.splice(0))
+            waiter.resolve(DONE);
+    }
+    /** The run failed (or the cache did): record the failure, settle the stream with the error. */
+    async function endWithFailure(error) {
+        await guard(() => cache.fail(runId, error));
+        run.ended = { kind: 'error', error };
+        broadcast(run, run.ended);
+        runs.delete(runId);
+        settled = true;
+        failure = { error };
+        for (const waiter of waiting.splice(0))
+            waiter.reject(error);
+    }
+    /** A cache that already failed one call may fail the closing call too — never mask the run's own outcome. */
+    async function guard(call) {
+        try {
+            await call();
+        }
+        catch {
+            // The recording is broken; the run's own outcome is what the consumer sees.
+        }
+    }
+    /** Hands a chunk to the waiting iterator, or buffers it until one asks. */
+    function deliver(chunk) {
+        if (abandoned)
+            return;
+        const waiter = waiting.shift();
+        if (waiter === undefined) {
+            buffered.push(chunk);
+            return;
+        }
+        waiter.resolve({ value: chunk, done: false });
+    }
+    const iterator = {
+        next() {
+            start();
+            if (abandoned)
+                return Promise.resolve(DONE);
+            const chunk = buffered.shift();
+            if (chunk !== undefined)
+                return Promise.resolve({ value: chunk, done: false });
+            if (failure !== undefined)
+                return Promise.reject(failure.error);
+            if (settled)
+                return Promise.resolve(DONE);
+            return new Promise((resolve, reject) => {
+                waiting.push({ resolve, reject });
+            });
+        },
+        return() {
+            abandoned = true;
+            buffered.length = 0;
+            return Promise.resolve(DONE);
+        },
+    };
+    const surface = {
+        [Symbol.asyncIterator]: () => iterator,
+    };
+    // The inner terminal keys, each forwarded lazily: reading one starts the recording pass and
+    // hands out the inner promise unchanged (same run, same value, same laziness).
+    for (const key of Object.keys(output)) {
+        Object.defineProperty(surface, key, {
+            enumerable: true,
+            configurable: true,
+            get() {
+                start();
+                return output[key];
+            },
+        });
+    }
+    return surface;
+}
+/**
+ * Replays a run's cached chunks in stream order, then follows the run live until it ends —
+ * the reconnecting client's whole read: one call, first the events it missed, then the tail
+ * it would have seen had it never left.
+ *
+ * - A **finished** run replays from anywhere the cache can be read (with the Redis adapter:
+ * from any instance sharing the database) and then ends; a **failed** run replays what it
+ * produced and then rejects with the recorded failure.
+ * - A **live** run (being recorded by a `withEventCache` wrapper in this process) replays
+ * and follows in-process, chunk by chunk, ending exactly when the run does — including a
+ * durable run's suspension (`finishReason: 'suspended'`): the observer sees the run end and
+ * reconnects later with the resume run's id.
+ * - An **active-but-not-live** run (recorded in another instance, or its process died
+ * mid-run) replays its cached chunks and then throws [`RunNotLiveError`] — waiting on a tail
+ * nobody here can see would hang forever. An unknown run throws [`UnknownRunError`].
+ *
+ * The application owns the endpoint that turns this into HTTP (SSE or otherwise) — the core
+ * keeps no resume endpoint (CUT-M1); this is the read side of that application's route.
+ */
+export function observe(cache, runId) {
+    return {
+        [Symbol.asyncIterator]: () => replayAndFollow(cache, runId),
+    };
+}
+/** The single pass behind `observe`: snapshot the cache, then tail the live broadcast. */
+async function* replayAndFollow(cache, runId) {
+    const live = liveRuns.get(cache)?.get(runId);
+    // Not being recorded here: everything must come from the cache, and the cache must know it.
+    if (live === undefined) {
+        const log = await cache.read(runId);
+        if (log === undefined)
+            throw new UnknownRunError(runId);
+        for (const chunk of log.chunks)
+            yield chunk;
+        if (log.status === 'done')
+            return;
+        if (log.status === 'error') {
+            throw new Error(`observe: run ${JSON.stringify(runId)} failed: ${log.error ?? 'unknown error'}`);
+        }
+        throw new RunNotLiveError(runId);
+    }
+    // Live here: subscribe first, snapshot second — a chunk landing between the two is carried
+    // by its position in the broadcast and skipped against the snapshot, so it arrives once.
+    const queue = [];
+    let wake;
+    const subscriber = (event) => {
+        queue.push(event);
+        wake?.();
+    };
+    if (live.ended === undefined)
+        live.subscribers.push(subscriber);
+    else
+        queue.push(live.ended);
+    const log = await cache.read(runId);
+    const snapshot = log?.chunks ?? [];
+    for (const chunk of snapshot)
+        yield chunk;
+    for (;;) {
+        if (queue.length === 0) {
+            await new Promise((resolve) => {
+                wake = resolve;
+            });
+            continue;
+        }
+        const event = queue.shift();
+        if (event === undefined)
+            continue;
+        if (event.kind === 'chunk') {
+            // Already inside the snapshot the run replayed from — position, not timing, decides.
+            if (event.seq < snapshot.length)
+                continue;
+            yield event.chunk;
+        }
+        else if (event.kind === 'done') {
+            return;
+        }
+        else {
+            throw event.error;
+        }
+    }
+}
+/** The message a failed run's cache entry keeps. */
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -1,6 +1,55 @@
 {
   "name": "@oribos/resumable-stream",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.9.0",
+  "description": "Oribos resumable-stream capability package — reconnectable agent streams: record a run's chunk stream into an event cache and replay-and-follow it with observe(runId). In-memory cache by default, any Redis-compatible client for durable replay, no dependencies beyond the @oribos/core peer.",
+  "keywords": [
+    "ai-agents",
+    "llm",
+    "typescript",
+    "agent-framework",
+    "resumable-stream",
+    "sse",
+    "streaming"
+  ],
+  "license": "Apache-2.0",
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/0xnicholas/oribos-framework.git",
+    "directory": "packages/resumable-stream"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@oribos/core": "^0.9.0"
+  },
+  "devDependencies": {
+    "@oribos/core": "0.9.0",
+    "@oribos/testing": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "check:dist": "node ../../scripts/check-dist.mjs",
+    "check:export-surface": "node ../../scripts/check-export-surface.mjs",
+    "check:runtime-deps": "node ../../scripts/check-runtime-deps.mjs",
+    "check:byte-budget": "node ../../scripts/check-byte-budget.mjs",
+    "byte-budget:update": "node ../../scripts/check-byte-budget.mjs --update",
+    "check:deps-budget": "node ../../scripts/check-deps-budget.mjs",
+    "deps-budget:update": "node ../../scripts/check-deps-budget.mjs --update"
+  }
 }