@trigger.dev/core 4.4.6 → 4.5.0-rc.0

package/dist/esm/v3/inputStreams/noopManager.d.ts

@@ -8,6 +8,9 @@ export declare class NoopInputStreamManager implements InputStreamManager {
     once(_streamId: string, _options?: InputStreamOnceOptions): InputStreamOncePromise<unknown>;
     peek(_streamId: string): unknown | undefined;
     lastSeqNum(_streamId: string): number | undefined;
+    setLastSeqNum(_streamId: string, _seqNum: number): void;
+    shiftBuffer(_streamId: string): boolean;
+    disconnectStream(_streamId: string): void;
     clearHandlers(): void;
     reset(): void;
     disconnect(): void;

package/dist/esm/v3/inputStreams/noopManager.js

@@ -15,6 +15,9 @@ export class NoopInputStreamManager {
     lastSeqNum(_streamId) {
         return undefined;
     }
+    setLastSeqNum(_streamId, _seqNum) { }
+    shiftBuffer(_streamId) { return false; }
+    disconnectStream(_streamId) { }
     clearHandlers() { }
     reset() { }
     disconnect() { }

package/dist/esm/v3/inputStreams/noopManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"noopManager.js","sourceRoot":"","sources":["../../../../src/v3/inputStreams/noopManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAGxE,MAAM,OAAO,sBAAsB;IACjC,QAAQ,CAAC,MAAc,EAAE,eAAwB,IAAS,CAAC;IAE3D,EAAE,CAAC,SAAiB,EAAE,QAAiD;QACrE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC;IAC3B,CAAC;IAED,IAAI,CAAC,SAAiB,EAAE,QAAiC;QACvD,OAAO,IAAI,sBAAsB,CAAC,GAAG,EAAE;YACrC,8BAA8B;QAChC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,SAAiB;QACpB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,UAAU,CAAC,SAAiB;QAC1B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,aAAa,KAAU,CAAC;IACxB,KAAK,KAAU,CAAC;IAChB,UAAU,KAAU,CAAC;IACrB,WAAW,CAAC,MAAc,EAAE,QAAiB,IAAS,CAAC;CACxD"}
+{"version":3,"file":"noopManager.js","sourceRoot":"","sources":["../../../../src/v3/inputStreams/noopManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAGxE,MAAM,OAAO,sBAAsB;IACjC,QAAQ,CAAC,MAAc,EAAE,eAAwB,IAAS,CAAC;IAE3D,EAAE,CAAC,SAAiB,EAAE,QAAiD;QACrE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC;IAC3B,CAAC;IAED,IAAI,CAAC,SAAiB,EAAE,QAAiC;QACvD,OAAO,IAAI,sBAAsB,CAAC,GAAG,EAAE;YACrC,8BAA8B;QAChC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,SAAiB;QACpB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,UAAU,CAAC,SAAiB;QAC1B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,aAAa,CAAC,SAAiB,EAAE,OAAe,IAAS,CAAC;IAE1D,WAAW,CAAC,SAAiB,IAAa,OAAO,KAAK,CAAC,CAAC,CAAC;IAEzD,gBAAgB,CAAC,SAAiB,IAAS,CAAC;IAE5C,aAAa,KAAU,CAAC;IACxB,KAAK,KAAU,CAAC;IAChB,UAAU,KAAU,CAAC;IACrB,WAAW,CAAC,MAAc,EAAE,QAAiB,IAAS,CAAC;CACxD"}

package/dist/esm/v3/inputStreams/types.d.ts

@@ -45,6 +45,25 @@ export interface InputStreamManager {
      * Used by `.wait()` to tell the server where to check for existing data.
      */
     lastSeqNum(streamId: string): number | undefined;
+    /**
+     * Advance the last-seen S2 sequence number for the given input stream.
+     * Used after `.wait()` resumes to prevent the SSE tail from replaying
+     * the record that was consumed via the waitpoint path.
+     */
+    setLastSeqNum(streamId: string, seqNum: number): void;
+    /**
+     * Remove and discard the first buffered item for the given input stream.
+     * Used after `.wait()` resumes to remove the duplicate that the SSE tail
+     * buffered while the waitpoint was being completed via a separate path.
+     * Returns true if an item was removed, false if the buffer was empty.
+     */
+    shiftBuffer(streamId: string): boolean;
+    /**
+     * Disconnect the SSE tail and clear the buffer for a specific input stream.
+     * Used before suspending via `.wait()` so the tail doesn't buffer duplicates
+     * of data that will be delivered through the waitpoint path.
+     */
+    disconnectStream(streamId: string): void;
     /**
      * Clear all persistent `.on()` handlers and abort tails that have no remaining once waiters.
      * Called automatically when a task run completes.

package/dist/esm/v3/locals/manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../../../src/v3/locals/manager.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,iBAAiB;IAC5B,WAAW,CAAI,EAAU;QACvB,OAAO;YACL,MAAM,EAAE,MAAM,EAAE;YAChB,EAAE;SACwB,CAAC;IAC/B,CAAC;IAED,QAAQ,CAAI,GAAiB;QAC3B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,QAAQ,CAAI,GAAiB,EAAE,KAAQ,IAAS,CAAC;CAClD;AAED,MAAM,OAAO,qBAAqB;IACxB,KAAK,GAAyB,IAAI,GAAG,EAAE,CAAC;IAEhD,WAAW,CAAI,EAAU;QACvB,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC3B,OAAO;YACL,MAAM,EAAE,GAAG;YACX,EAAE;SACwB,CAAC;IAC/B,CAAC;IAED,QAAQ,CAAI,GAAiB;QAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAkB,CAAC;IACrD,CAAC;IAED,QAAQ,CAAI,GAAiB,EAAE,KAAQ;QACrC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF"}
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../../../src/v3/locals/manager.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,iBAAiB;IAC5B,WAAW,CAAI,EAAU;QACvB,OAAO;YACL,MAAM,EAAE,MAAM,EAAE;YAChB,EAAE;SACH,CAAC;IACJ,CAAC;IAED,QAAQ,CAAI,GAAiB;QAC3B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,QAAQ,CAAI,GAAiB,EAAE,KAAQ,IAAS,CAAC;CAClD;AAED,MAAM,OAAO,qBAAqB;IACxB,KAAK,GAAyB,IAAI,GAAG,EAAE,CAAC;IAEhD,WAAW,CAAI,EAAU;QACvB,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC3B,OAAO;YACL,MAAM,EAAE,GAAG;YACX,EAAE;SACH,CAAC;IACJ,CAAC;IAED,QAAQ,CAAI,GAAiB;QAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAkB,CAAC;IACrD,CAAC;IAED,QAAQ,CAAI,GAAiB,EAAE,KAAQ;QACrC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF"}

package/dist/esm/v3/locals/types.d.ts

@@ -1,14 +1,25 @@
-declare const __local: unique symbol;
-type BrandLocal<T> = {
-    [__local]: T;
-};
-export type LocalsKey<T> = BrandLocal<T> & {
+/**
+ * A type-safe key for `locals`. Carries the value type `T` as a phantom
+ * marker on the optional `__valueType` field so two keys with different
+ * value types are distinguishable at the type level.
+ *
+ * The phantom field is intentionally not anchored to a `unique symbol`:
+ * dual-package builds (`tshy`) emit separate `.d.ts` files for ESM and
+ * CJS outputs, and each `unique symbol` declaration in a `.d.ts` is its
+ * own nominal type. If a single compilation ever resolves `LocalsKey`
+ * from both the ESM and CJS paths — which happens under certain pnpm
+ * hoisting layouts — `unique symbol` brands produce structurally
+ * incompatible variants of the same type. A plain string brand avoids
+ * the hazard.
+ */
+export type LocalsKey<T> = {
     readonly id: string;
-    readonly __type: unique symbol;
+    readonly __type: symbol;
+    /** Phantom carrier for the value type — never read at runtime. */
+    readonly __valueType?: T;
 };
 export interface LocalsManager {
     createLocal<T>(id: string): LocalsKey<T>;
     getLocal<T>(key: LocalsKey<T>): T | undefined;
     setLocal<T>(key: LocalsKey<T>, value: T): void;
 }
-export {};

package/dist/esm/v3/realtime-streams-api.d.ts

@@ -1,3 +1,6 @@
 import { RealtimeStreamsAPI } from "./realtimeStreams/index.js";
 export declare const realtimeStreams: RealtimeStreamsAPI;
 export * from "./realtimeStreams/types.js";
+export { SessionStreamInstance } from "./realtimeStreams/sessionStreamInstance.js";
+export type { SessionStreamInstanceOptions, InitializeSessionStreamResponseLike, } from "./realtimeStreams/sessionStreamInstance.js";
+export { trimSessionStream, writeSessionControlRecord, writeTurnCompleteRecord, writeUpgradeRequiredRecord, } from "./realtimeStreams/sessionStreamOneshot.js";

package/dist/esm/v3/realtime-streams-api.js

@@ -3,4 +3,6 @@
 import { RealtimeStreamsAPI } from "./realtimeStreams/index.js";
 export const realtimeStreams = RealtimeStreamsAPI.getInstance();
 export * from "./realtimeStreams/types.js";
+export { SessionStreamInstance } from "./realtimeStreams/sessionStreamInstance.js";
+export { trimSessionStream, writeSessionControlRecord, writeTurnCompleteRecord, writeUpgradeRequiredRecord, } from "./realtimeStreams/sessionStreamOneshot.js";
 //# sourceMappingURL=realtime-streams-api.js.map

package/dist/esm/v3/realtime-streams-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"realtime-streams-api.js","sourceRoot":"","sources":["../../../src/v3/realtime-streams-api.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,qCAAqC;AACrC,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,MAAM,CAAC,MAAM,eAAe,GAAG,kBAAkB,CAAC,WAAW,EAAE,CAAC;AAEhE,cAAc,4BAA4B,CAAC"}
+{"version":3,"file":"realtime-streams-api.js","sourceRoot":"","sources":["../../../src/v3/realtime-streams-api.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,qCAAqC;AACrC,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,MAAM,CAAC,MAAM,eAAe,GAAG,kBAAkB,CAAC,WAAW,EAAE,CAAC;AAEhE,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AAKnF,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,2CAA2C,CAAC"}

package/dist/esm/v3/realtimeStreams/index.d.ts

@@ -1,4 +1,7 @@
 import { RealtimeStreamOperationOptions, RealtimeStreamInstance, RealtimeStreamsManager } from "./types.js";
+export { SessionStreamInstance } from "./sessionStreamInstance.js";
+export type { SessionStreamInstanceOptions, InitializeSessionStreamResponseLike, } from "./sessionStreamInstance.js";
+export { trimSessionStream, writeSessionControlRecord, writeTurnCompleteRecord, writeUpgradeRequiredRecord, } from "./sessionStreamOneshot.js";
 export declare class RealtimeStreamsAPI implements RealtimeStreamsManager {
     #private;
     private static _instance?;

package/dist/esm/v3/realtimeStreams/index.js

@@ -1,5 +1,10 @@
 import { getGlobal, registerGlobal } from "../utils/globals.js";
 import { NoopRealtimeStreamsManager } from "./noopManager.js";
+// Re-export the session-scoped stream instance so the SDK's
+// `SessionOutputChannel.pipe` / `.writer` can construct it without reaching
+// into the core package's internals.
+export { SessionStreamInstance } from "./sessionStreamInstance.js";
+export { trimSessionStream, writeSessionControlRecord, writeTurnCompleteRecord, writeUpgradeRequiredRecord, } from "./sessionStreamOneshot.js";
 const API_NAME = "realtime-streams";
 const NOOP_MANAGER = new NoopRealtimeStreamsManager();
 export class RealtimeStreamsAPI {

package/dist/esm/v3/realtimeStreams/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/v3/realtimeStreams/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAO9D,MAAM,QAAQ,GAAG,kBAAkB,CAAC;AAEpC,MAAM,YAAY,GAAG,IAAI,0BAA0B,EAAE,CAAC;AAEtD,MAAM,OAAO,kBAAkB;IACrB,MAAM,CAAC,SAAS,CAAsB;IAE9C,gBAAuB,CAAC;IAEjB,MAAM,CAAC,WAAW;QACvB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,SAAS,GAAG,IAAI,kBAAkB,EAAE,CAAC;QAC5C,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,gBAAgB,CAAC,OAA+B;QAC9C,OAAO,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,WAAW;QACT,OAAO,SAAS,CAAC,QAAQ,CAAC,IAAI,YAAY,CAAC;IAC7C,CAAC;IAEM,IAAI,CACT,GAAW,EACX,MAA4C,EAC5C,OAAwC;QAExC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;IAEM,MAAM,CACX,GAAW,EACX,IAAW,EACX,OAAwC;QAExC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;CACF"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/v3/realtimeStreams/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAO9D,4DAA4D;AAC5D,4EAA4E;AAC5E,qCAAqC;AACrC,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAKnE,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,2BAA2B,CAAC;AAEnC,MAAM,QAAQ,GAAG,kBAAkB,CAAC;AAEpC,MAAM,YAAY,GAAG,IAAI,0BAA0B,EAAE,CAAC;AAEtD,MAAM,OAAO,kBAAkB;IACrB,MAAM,CAAC,SAAS,CAAsB;IAE9C,gBAAuB,CAAC;IAEjB,MAAM,CAAC,WAAW;QACvB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,SAAS,GAAG,IAAI,kBAAkB,EAAE,CAAC;QAC5C,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,gBAAgB,CAAC,OAA+B;QAC9C,OAAO,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,WAAW;QACT,OAAO,SAAS,CAAC,QAAQ,CAAC,IAAI,YAAY,CAAC;IAC7C,CAAC;IAEM,IAAI,CACT,GAAW,EACX,MAA4C,EAC5C,OAAwC;QAExC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;IAEM,MAAM,CACX,GAAW,EACX,IAAW,EACX,OAAwC;QAExC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;CACF"}

package/dist/esm/v3/realtimeStreams/manager.d.ts

@@ -6,7 +6,18 @@ export declare class StandardRealtimeStreamsManager implements RealtimeStreamsMa
     private debug;
     constructor(apiClient: ApiClient, baseUrl: string, debug?: boolean);
     private activeStreams;
+    private createStreamCache;
     reset(): void;
+    private getCachedCreateStream;
+    /**
+     * Reactive invalidation: a writer's `wait()` rejecting can mean the
+     * cached S2 credentials have gone stale (expired token, revoked
+     * access, basin retired), so evict the cached `createStream` response
+     * for `(runId, key)` and let the next `pipe()` re-PUT to mint fresh
+     * credentials. Compare by identity so a fresh promise installed by a
+     * concurrent caller isn't accidentally cleared.
+     */
+    private evictCreateStreamIfStale;
     pipe<T>(key: string, source: AsyncIterable<T> | ReadableStream<T>, options?: RealtimeStreamOperationOptions): RealtimeStreamInstance<T>;
     append<TPart extends BodyInit>(key: string, part: TPart, options?: RealtimeStreamOperationOptions): Promise<void>;
     hasActiveStreams(): boolean;

package/dist/esm/v3/realtimeStreams/manager.js

@@ -12,8 +12,48 @@ export class StandardRealtimeStreamsManager {
     }
     // Track active streams - using a Set allows multiple streams for the same key to coexist
     activeStreams = new Set();
+    // Cache of in-flight / resolved `createStream` responses, keyed by
+    // `${runId}:${key}`. S2 v2 access tokens are scoped to the org basin
+    // (default 1-day TTL server-side) so reusing them across repeated
+    // `pipe()` calls for the same `(runId, key)` is safe, and avoids the
+    // per-call PUT that pushes `streamId` onto `TaskRun.realtimeStreams`,
+    // which under chat-agent-style hot-loop writers caused row-lock
+    // contention on the writer DB.
+    createStreamCache = new Map();
     reset() {
         this.activeStreams.clear();
+        this.createStreamCache.clear();
+    }
+    getCachedCreateStream(runId, key, requestOptions) {
+        const cacheKey = `${runId}:${key}`;
+        const cached = this.createStreamCache.get(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        const promise = this.apiClient.createStream(runId, "self", key, requestOptions);
+        this.createStreamCache.set(cacheKey, promise);
+        // Evict on failure so the next call retries instead of returning a
+        // poisoned cache entry forever.
+        promise.catch((err) => {
+            if (this.createStreamCache.get(cacheKey) === promise) {
+                this.createStreamCache.delete(cacheKey);
+            }
+        });
+        return promise;
+    }
+    /**
+     * Reactive invalidation: a writer's `wait()` rejecting can mean the
+     * cached S2 credentials have gone stale (expired token, revoked
+     * access, basin retired), so evict the cached `createStream` response
+     * for `(runId, key)` and let the next `pipe()` re-PUT to mint fresh
+     * credentials. Compare by identity so a fresh promise installed by a
+     * concurrent caller isn't accidentally cleared.
+     */
+    evictCreateStreamIfStale(runId, key, expected) {
+        const cacheKey = `${runId}:${key}`;
+        if (this.createStreamCache.get(cacheKey) === expected) {
+            this.createStreamCache.delete(cacheKey);
+        }
     }
     pipe(key, source, options) {
         // Normalize ReadableStream to AsyncIterable
@@ -28,6 +68,10 @@ export class StandardRealtimeStreamsManager {
         const combinedSignal = options?.signal
             ? AbortSignal.any?.([options.signal, abortController.signal]) ?? abortController.signal
             : abortController.signal;
+        // Capture which cached promise this writer uses so reactive
+        // invalidation below evicts only if the cache still holds it (a
+        // concurrent caller may have already refreshed it).
+        const activeCreatePromise = this.getCachedCreateStream(runId, key, options?.requestOptions);
         const streamInstance = new StreamInstance({
             apiClient: this.apiClient,
             baseUrl: this.baseUrl,
@@ -38,12 +82,24 @@ export class StandardRealtimeStreamsManager {
             requestOptions: options?.requestOptions,
             target: options?.target,
             debug: this.debug,
+            createStream: () => activeCreatePromise,
         });
         // Register this stream
         const streamInfo = { wait: () => streamInstance.wait(), abortController };
         this.activeStreams.add(streamInfo);
-        // Clean up when stream completes
-        streamInstance.wait().finally(() => this.activeStreams.delete(streamInfo));
+        // Single internal chain that handles activeStreams cleanup AND
+        // reactive invalidation. On rejection we evict the cached
+        // `createStream` entry so the next pipe() for the same `(runId, key)`
+        // re-PUTs and recovers (e.g. when a cached S2 access token expired
+        // mid-process). Customer awaiters still observe the rejection via
+        // the returned `wait()`; this chain just keeps the cleanup path
+        // from surfacing as unhandled.
+        streamInstance.wait().then(() => {
+            this.activeStreams.delete(streamInfo);
+        }, (err) => {
+            this.evictCreateStreamIfStale(runId, key, activeCreatePromise);
+            this.activeStreams.delete(streamInfo);
+        });
         return {
             wait: () => streamInstance.wait(),
             stream: streamInstance.stream,

package/dist/esm/v3/realtimeStreams/manager.js.map

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

package/dist/esm/v3/realtimeStreams/manager.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/esm/v3/realtimeStreams/manager.test.js

@@ -0,0 +1,90 @@
+import { describe, expect, it, vi } from "vitest";
+import { StandardRealtimeStreamsManager } from "./manager.js";
+function getCached(manager, runId, key) {
+    return manager.getCachedCreateStream(runId, key);
+}
+function makeApiClient(impl) {
+    const spy = vi.fn(impl);
+    const client = { createStream: spy };
+    return { client, spy };
+}
+describe("StandardRealtimeStreamsManager createStream cache", () => {
+    it("dedupes repeated calls for the same (runId, key)", async () => {
+        const { client, spy } = makeApiClient(async () => ({ version: "v1", headers: {} }));
+        const manager = new StandardRealtimeStreamsManager(client, "http://localhost");
+        const p1 = getCached(manager, "run-1", "chat");
+        const p2 = getCached(manager, "run-1", "chat");
+        expect(p1).toBe(p2);
+        expect(spy).toHaveBeenCalledTimes(1);
+        await Promise.all([p1, p2]);
+        expect(spy).toHaveBeenCalledTimes(1);
+    });
+    it("issues a separate PUT for each distinct stream key on the same run", async () => {
+        const { client, spy } = makeApiClient(async () => ({ version: "v1", headers: {} }));
+        const manager = new StandardRealtimeStreamsManager(client, "http://localhost");
+        await Promise.all([
+            getCached(manager, "run-1", "chat"),
+            getCached(manager, "run-1", "tool-output"),
+        ]);
+        expect(spy).toHaveBeenCalledTimes(2);
+        expect(spy).toHaveBeenNthCalledWith(1, "run-1", "self", "chat", undefined);
+        expect(spy).toHaveBeenNthCalledWith(2, "run-1", "self", "tool-output", undefined);
+    });
+    it("issues a separate PUT for each distinct run, even with the same key", async () => {
+        const { client, spy } = makeApiClient(async () => ({ version: "v1", headers: {} }));
+        const manager = new StandardRealtimeStreamsManager(client, "http://localhost");
+        await Promise.all([
+            getCached(manager, "run-1", "chat"),
+            getCached(manager, "run-2", "chat"),
+        ]);
+        expect(spy).toHaveBeenCalledTimes(2);
+    });
+    it("evicts on failure so the next call retries instead of returning a poisoned entry", async () => {
+        const spy = vi
+            .fn()
+            .mockRejectedValueOnce(new Error("boom"))
+            .mockResolvedValueOnce({ version: "v1", headers: {} });
+        const client = { createStream: spy };
+        const manager = new StandardRealtimeStreamsManager(client, "http://localhost");
+        await expect(getCached(manager, "run-1", "chat")).rejects.toThrow("boom");
+        const retried = await getCached(manager, "run-1", "chat");
+        expect(retried).toEqual({ version: "v1", headers: {} });
+        expect(spy).toHaveBeenCalledTimes(2);
+    });
+    it("reset() clears cached entries so the next call re-PUTs", async () => {
+        const { client, spy } = makeApiClient(async () => ({ version: "v1", headers: {} }));
+        const manager = new StandardRealtimeStreamsManager(client, "http://localhost");
+        await getCached(manager, "run-1", "chat");
+        expect(spy).toHaveBeenCalledTimes(1);
+        manager.reset();
+        await getCached(manager, "run-1", "chat");
+        expect(spy).toHaveBeenCalledTimes(2);
+    });
+    it("evictCreateStreamIfStale clears the matching entry so the next call re-PUTs", async () => {
+        const { client, spy } = makeApiClient(async () => ({ version: "v1", headers: {} }));
+        const manager = new StandardRealtimeStreamsManager(client, "http://localhost");
+        // Prime the cache and capture which promise was stored.
+        const cachedPromise = getCached(manager, "run-1", "chat");
+        await cachedPromise;
+        expect(spy).toHaveBeenCalledTimes(1);
+        // Simulate the reactive invalidation path that `pipe()` runs when a
+        // writer's `wait()` rejects.
+        manager.evictCreateStreamIfStale("run-1", "chat", cachedPromise);
+        await getCached(manager, "run-1", "chat");
+        expect(spy).toHaveBeenCalledTimes(2);
+    });
+    it("evictCreateStreamIfStale is a no-op when the cache holds a different promise", async () => {
+        const { client, spy } = makeApiClient(async () => ({ version: "v1", headers: {} }));
+        const manager = new StandardRealtimeStreamsManager(client, "http://localhost");
+        const original = getCached(manager, "run-1", "chat");
+        await original;
+        // A different promise (e.g. from a concurrent caller that already
+        // refreshed) shouldn't trigger eviction.
+        const stalePromise = Promise.resolve({ version: "v1", headers: {} });
+        manager.evictCreateStreamIfStale("run-1", "chat", stalePromise);
+        // Cache should still hold the original entry; next call is a hit.
+        await getCached(manager, "run-1", "chat");
+        expect(spy).toHaveBeenCalledTimes(1);
+    });
+});
+//# sourceMappingURL=manager.test.js.map

package/dist/esm/v3/realtimeStreams/manager.test.js.map

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

package/dist/esm/v3/realtimeStreams/noopManager.js

@@ -2,7 +2,7 @@ import { createAsyncIterableStreamFromAsyncIterable, } from "../streams/asyncIte
 export class NoopRealtimeStreamsManager {
     pipe(key, source, options) {
         return {
-            wait: () => Promise.resolve(),
+            wait: () => Promise.resolve({}),
             get stream() {
                 return createAsyncIterableStreamFromAsyncIterable(source);
             },

package/dist/esm/v3/realtimeStreams/noopManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"noopManager.js","sourceRoot":"","sources":["../../../../src/v3/realtimeStreams/noopManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,0CAA0C,GAC3C,MAAM,mCAAmC,CAAC;AAO3C,MAAM,OAAO,0BAA0B;IAC9B,IAAI,CACT,GAAW,EACX,MAA4C,EAC5C,OAAwC;QAExC,OAAO;YACL,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE;YAC7B,IAAI,MAAM;gBACR,OAAO,0CAA0C,CAAC,MAAM,CAAC,CAAC;YAC5D,CAAC;SACF,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,MAAM,CACjB,GAAW,EACX,IAAW,EACX,OAAwC,IACxB,CAAC;CACpB"}
+{"version":3,"file":"noopManager.js","sourceRoot":"","sources":["../../../../src/v3/realtimeStreams/noopManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,0CAA0C,GAC3C,MAAM,mCAAmC,CAAC;AAO3C,MAAM,OAAO,0BAA0B;IAC9B,IAAI,CACT,GAAW,EACX,MAA4C,EAC5C,OAAwC;QAExC,OAAO;YACL,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/B,IAAI,MAAM;gBACR,OAAO,0CAA0C,CAAC,MAAM,CAAC,CAAC;YAC5D,CAAC;SACF,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,MAAM,CACjB,GAAW,EACX,IAAW,EACX,OAAwC,IACxB,CAAC;CACpB"}

package/dist/esm/v3/realtimeStreams/sessionStreamInstance.d.ts

@@ -0,0 +1,41 @@
+import { ApiClient } from "../apiClient/index.js";
+import { AsyncIterableStream } from "../streams/asyncIterableStream.js";
+import { AnyZodFetchOptions } from "../zodfetch.js";
+import { StreamsWriter, StreamWriteResult } from "./types.js";
+export type InitializeSessionStreamResponseLike = {
+    headers?: Record<string, string>;
+};
+export type SessionStreamInstanceOptions<T> = {
+    apiClient: ApiClient;
+    baseUrl: string;
+    sessionId: string;
+    io: "out" | "in";
+    source: ReadableStream<T>;
+    signal?: AbortSignal;
+    requestOptions?: AnyZodFetchOptions;
+    debug?: boolean;
+    /**
+     * Optional override for the initialize-session-stream call. Defaults to
+     * `apiClient.initializeSessionStream(sessionId, io, requestOptions)`. The
+     * channel passes a cached version so repeated `pipe()` / `writer()`
+     * calls for the same `(sessionId, io)` share a single PUT instead of
+     * hammering the server on every chunk.
+     */
+    initializeSession?: () => Promise<InitializeSessionStreamResponseLike>;
+};
+/**
+ * Session-scoped parallel to {@link StreamInstance}. Calls
+ * `initializeSessionStream` to fetch S2 credentials for the session's
+ * channel, then pipes `source` directly to S2 via {@link StreamsWriterV2}.
+ *
+ * Sessions are S2-only — there's no v1 (Redis) fallback — so this
+ * skips the version-detection dance `StreamInstance` does.
+ */
+export declare class SessionStreamInstance<T> implements StreamsWriter {
+    private options;
+    private streamPromise;
+    constructor(options: SessionStreamInstanceOptions<T>);
+    private initializeWriter;
+    wait(): Promise<StreamWriteResult>;
+    get stream(): AsyncIterableStream<T>;
+}

package/dist/esm/v3/realtimeStreams/sessionStreamInstance.js

@@ -0,0 +1,73 @@
+import { StreamsWriterV2 } from "./streamsWriterV2.js";
+/**
+ * Session-scoped parallel to {@link StreamInstance}. Calls
+ * `initializeSessionStream` to fetch S2 credentials for the session's
+ * channel, then pipes `source` directly to S2 via {@link StreamsWriterV2}.
+ *
+ * Sessions are S2-only — there's no v1 (Redis) fallback — so this
+ * skips the version-detection dance `StreamInstance` does.
+ */
+export class SessionStreamInstance {
+    options;
+    streamPromise;
+    constructor(options) {
+        this.options = options;
+        this.streamPromise = this.initializeWriter();
+    }
+    async initializeWriter() {
+        const initializeFn = this.options.initializeSession ??
+            (() => this.options.apiClient.initializeSessionStream(this.options.sessionId, this.options.io, this.options?.requestOptions));
+        const response = await initializeFn();
+        const headers = response.headers ?? {};
+        const accessToken = headers["x-s2-access-token"];
+        const basin = headers["x-s2-basin"];
+        const streamName = headers["x-s2-stream-name"];
+        const endpoint = headers["x-s2-endpoint"];
+        const flushIntervalMs = headers["x-s2-flush-interval-ms"]
+            ? parseInt(headers["x-s2-flush-interval-ms"])
+            : undefined;
+        const maxRetries = headers["x-s2-max-retries"]
+            ? parseInt(headers["x-s2-max-retries"])
+            : undefined;
+        if (!accessToken || !basin || !streamName) {
+            throw new Error("Session stream initialize did not return S2 credentials — server may be configured for v1 realtime streams, which sessions do not support.");
+        }
+        return new StreamsWriterV2({
+            basin,
+            stream: streamName,
+            accessToken,
+            endpoint,
+            source: this.options.source,
+            signal: this.options.signal,
+            debug: this.options.debug,
+            flushIntervalMs,
+            maxRetries,
+        });
+    }
+    async wait() {
+        const writer = await this.streamPromise;
+        return writer.wait();
+    }
+    get stream() {
+        const self = this;
+        return new ReadableStream({
+            async start(controller) {
+                const streamWriter = await self.streamPromise;
+                const iterator = streamWriter[Symbol.asyncIterator]();
+                while (true) {
+                    if (self.options.signal?.aborted) {
+                        controller.close();
+                        break;
+                    }
+                    const { done, value } = await iterator.next();
+                    if (done) {
+                        controller.close();
+                        break;
+                    }
+                    controller.enqueue(value);
+                }
+            },
+        });
+    }
+}
+//# sourceMappingURL=sessionStreamInstance.js.map

package/dist/esm/v3/realtimeStreams/sessionStreamInstance.js.map

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

package/dist/esm/v3/realtimeStreams/sessionStreamOneshot.d.ts

@@ -0,0 +1,45 @@
+import type { ApiClient } from "../apiClient/index.js";
+import { type TriggerControlSubtype } from "../sessionStreams/wireProtocol.js";
+import type { StreamWriteResult } from "./types.js";
+/**
+ * One-shot S2 writes against a Session channel. Used for Trigger control
+ * records (turn-complete, upgrade-required) and S2 command records (trim).
+ *
+ * These differ from the streaming writer (`SessionStreamInstance` /
+ * `StreamsWriterV2`) in two ways: they emit a single record per call, and
+ * they need precise control over the record's `headers` + `body` shape —
+ * which the streaming writer's JSON-envelope encoding doesn't expose.
+ *
+ * Each call fetches a fresh S2 access token via `initializeSessionStream`
+ * and opens a new client. Cheap enough at the rate these are emitted
+ * (~one of each per turn).
+ */
+type IO = "out" | "in";
+/**
+ * Append a single Trigger control record to a Session channel. The record
+ * carries a `trigger-control` header valued with `subtype`, plus any
+ * sibling headers (e.g. `public-access-token` on `turn-complete`). Body is
+ * always empty — control semantics live in the headers.
+ *
+ * Returns the ack's last seq_num as `lastEventId`, useful for trim chains.
+ */
+export declare function writeSessionControlRecord(apiClient: ApiClient, sessionId: string, io: IO, subtype: TriggerControlSubtype | string, extraHeaders?: ReadonlyArray<readonly [string, string]>): Promise<StreamWriteResult>;
+/**
+ * Append an S2 `trim` command record to `session.out`, setting the new
+ * earliest-readable seq_num. Idempotent and monotonic at S2 — the
+ * effective trim point is `max(existing, min(provided, current_tail))`.
+ *
+ * Used after every `turn-complete` to keep `session.out` bounded to
+ * approximately one turn of records at steady state.
+ */
+export declare function trimSessionStream(apiClient: ApiClient, sessionId: string, earliestSeqNum: number): Promise<void>;
+/**
+ * Convenience: append a `turn-complete` control record. Carries an
+ * optional refreshed `publicAccessToken` in a sibling header.
+ */
+export declare function writeTurnCompleteRecord(apiClient: ApiClient, sessionId: string, publicAccessToken?: string): Promise<StreamWriteResult>;
+/**
+ * Convenience: append an `upgrade-required` control record.
+ */
+export declare function writeUpgradeRequiredRecord(apiClient: ApiClient, sessionId: string): Promise<StreamWriteResult>;
+export {};