@palai/sdk 0.1.0

package/dist/stream.js

@@ -0,0 +1,314 @@
+import { errorForResponse, PalaiConnectionError } from "./errors.js";
+// parseEventStream frames a byte stream into SSE frames. It decodes incrementally
+// (TextDecoder stream mode preserves a multi-byte character split across chunks), buffers
+// a partial trailing line across reads, joins multi-line `data:` fields with newlines, and
+// ignores comment lines (a leading colon), which the server uses for keep-alive. It never
+// buffers the whole response — one frame is produced per blank-line dispatch.
+export async function* parseEventStream(body) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    let frame = newFrame();
+    try {
+        for (;;) {
+            const { done, value } = await reader.read();
+            if (done) {
+                break;
+            }
+            buffer += decoder.decode(value, { stream: true });
+            let newline;
+            while ((newline = buffer.indexOf("\n")) !== -1) {
+                // Tolerate CRLF as well as LF line endings.
+                let line = buffer.slice(0, newline);
+                if (line.endsWith("\r")) {
+                    line = line.slice(0, -1);
+                }
+                buffer = buffer.slice(newline + 1);
+                if (line === "") {
+                    if (frame.data !== "" || frame.event !== undefined || frame.id !== undefined) {
+                        yield frame;
+                    }
+                    frame = newFrame();
+                    continue;
+                }
+                applyField(frame, line);
+            }
+        }
+    }
+    finally {
+        // Releasing the reader lets the caller cancel the body to close the socket.
+        reader.releaseLock();
+    }
+}
+function newFrame() {
+    return { id: undefined, event: undefined, data: "" };
+}
+// applyField parses one SSE line into the current frame. A leading colon is a comment; a
+// field is `name` or `name:value` with one optional space stripped after the colon.
+function applyField(frame, line) {
+    if (line.startsWith(":")) {
+        return; // comment / heartbeat
+    }
+    const colon = line.indexOf(":");
+    const field = colon === -1 ? line : line.slice(0, colon);
+    let value = colon === -1 ? "" : line.slice(colon + 1);
+    if (value.startsWith(" ")) {
+        value = value.slice(1);
+    }
+    switch (field) {
+        case "id":
+            frame.id = value;
+            break;
+        case "event":
+            frame.event = value;
+            break;
+        case "data":
+            frame.data = frame.data === "" ? value : `${frame.data}\n${value}`;
+            break;
+        default:
+            // retry: and unknown fields are not used by this consumer.
+            break;
+    }
+}
+const TERMINAL_EVENT = /^(run|response)\.(completed|failed|canceled|timed_out|budget_exceeded)\.v[0-9]+$/;
+// isTerminalEvent reports whether an event closes the run, so the stream stops rather than
+// reconnecting when the server closes a completed stream (spec §22.3, §24.4).
+export function isTerminalEvent(event) {
+    return TERMINAL_EVENT.test(event.type);
+}
+// ResponseStream is a resumable, typed consumer of a run's event stream. Iterating it
+// yields each canonical Event (unknown event types are delivered, not dropped: API-009).
+// A transport drop before a terminal event reconnects from the last seen id via
+// Last-Event-ID with full-jitter backoff; a terminal event or an explicit cancel stops
+// without reconnecting. Breaking out of the iteration closes the transport.
+export class ResponseStream {
+    #transport;
+    #start;
+    #started;
+    #startPromise;
+    #signal;
+    #lastEventId;
+    #maxReconnects;
+    #backoffBaseMs;
+    #backoffMaxMs;
+    #iterator;
+    constructor(init) {
+        this.#transport = init.transport;
+        this.#start = init.start;
+        this.#signal = init.signal;
+        this.#lastEventId = init.lastEventId ?? null;
+        this.#maxReconnects = init.maxReconnects ?? 5;
+        this.#backoffBaseMs = init.backoffBaseMs ?? 100;
+        this.#backoffMaxMs = init.backoffMaxMs ?? 5_000;
+    }
+    // responseID / sessionID resolve once the stream has started (its create has returned);
+    // they are undefined before first consumption.
+    get responseID() {
+        return this.#started?.responseID;
+    }
+    get sessionID() {
+        return this.#started?.sessionID;
+    }
+    // lastEventId exposes the reconnection cursor reached so far (the id of the last event
+    // delivered), so a caller can persist it and resume a new stream later.
+    get lastEventId() {
+        return this.#lastEventId;
+    }
+    #ensureStarted() {
+        if (this.#startPromise === undefined) {
+            this.#startPromise = this.#start().then((started) => (this.#started = started));
+        }
+        return this.#startPromise;
+    }
+    [Symbol.asyncIterator]() {
+        if (this.#iterator !== undefined) {
+            throw new PalaiConnectionError("this response stream has already been consumed");
+        }
+        this.#iterator = this.#run();
+        return this.#iterator;
+    }
+    // finalResponse drains the stream to its terminal event, then returns the canonical
+    // terminal Response (status, model, output, usage, and — on failure — the problem-shaped
+    // error). It shares the single underlying iteration, so it must not be combined with a
+    // separate manual iteration of the same stream.
+    async finalResponse() {
+        const iterator = this[Symbol.asyncIterator]();
+        for (;;) {
+            const next = await iterator.next();
+            if (next.done) {
+                break;
+            }
+            if (isTerminalEvent(next.value)) {
+                break;
+            }
+        }
+        await iterator.return?.(undefined);
+        const { responseID } = await this.#ensureStarted();
+        return this.#transport.retrieveResponse(responseID);
+    }
+    async *#run() {
+        let start;
+        try {
+            start = await this.#ensureStarted();
+        }
+        catch (cause) {
+            if (isAbort(cause, this.#signal)) {
+                return; // the create was canceled before the stream opened
+            }
+            throw cause; // a create failure surfaces to the consumer
+        }
+        let reconnects = 0;
+        for (;;) {
+            // Capture the cursor this connection resumes from, so a server that redelivers the
+            // boundary event inclusively does not double-deliver it to the consumer.
+            const resumedFrom = this.#lastEventId;
+            let response;
+            try {
+                response = await this.#transport.openEventStream(start.sessionID, resumedFrom, this.#signal);
+            }
+            catch (cause) {
+                if (isAbort(cause, this.#signal)) {
+                    return; // explicit cancel: stop, do not reconnect
+                }
+                if (reconnects >= this.#maxReconnects) {
+                    throw new PalaiConnectionError("event stream could not be (re)opened", { cause });
+                }
+                if (!(await this.#backoffSleep(reconnects))) {
+                    return; // canceled mid-backoff: end quietly, like every other cancel path
+                }
+                reconnects += 1;
+                continue;
+            }
+            if (!response.ok) {
+                // A status error (404 unknown session, 410 gone) is terminal, not a drop.
+                const body = await safeText(response);
+                throw errorForResponse(response.status, body, response.headers.get("Request-Id") ?? undefined);
+            }
+            if (response.body === null) {
+                return;
+            }
+            const frames = parseEventStream(response.body);
+            // On a resume, drop a single redelivered boundary event whose id equals the cursor.
+            let dedupePending = resumedFrom !== null;
+            try {
+                for await (const frame of frames) {
+                    if (frame.id !== undefined) {
+                        this.#lastEventId = frame.id;
+                    }
+                    if (frame.data === "") {
+                        continue; // keep-alive with no payload
+                    }
+                    const event = decodeEvent(frame.data);
+                    if (event === null) {
+                        continue; // a non-JSON data line is not a canonical event
+                    }
+                    if (dedupePending) {
+                        dedupePending = false;
+                        if (frame.id !== undefined && frame.id === resumedFrom) {
+                            continue; // duplicate of the resume boundary
+                        }
+                    }
+                    yield event;
+                    if (isTerminalEvent(event)) {
+                        return; // terminal reached: stop, do not reconnect
+                    }
+                }
+            }
+            catch (cause) {
+                if (isAbort(cause, this.#signal)) {
+                    return;
+                }
+                // fall through to reconnect below
+            }
+            finally {
+                // Close the body — and thus the socket — whenever this connection is left: on a
+                // terminal, an abort, or the consumer breaking out of the iteration (iterator
+                // close closes the transport). It is a no-op when the server already ended it.
+                await frames.return(undefined);
+                await response.body?.cancel().catch(() => { });
+            }
+            if (this.#signal?.aborted) {
+                return;
+            }
+            // The stream ended without a terminal event: an unexpected drop. Reconnect from the
+            // last seen id, bounded, with backoff.
+            if (reconnects >= this.#maxReconnects) {
+                throw new PalaiConnectionError("event stream dropped before a terminal event and exhausted reconnects");
+            }
+            if (!(await this.#backoffSleep(reconnects))) {
+                return; // canceled mid-backoff: end quietly, like every other cancel path
+            }
+            reconnects += 1;
+        }
+    }
+    // #backoffSleep waits out one reconnect backoff, cancelably. It returns true when the
+    // sleep completes, or false if the caller aborts mid-sleep — so #run ends the stream
+    // quietly instead of leaking the abort's DOMException, matching every other cancel path.
+    async #backoffSleep(reconnects) {
+        try {
+            await delay(fullJitterBackoff(reconnects, this.#backoffBaseMs, this.#backoffMaxMs), this.#signal);
+            return true;
+        }
+        catch (cause) {
+            if (isAbort(cause, this.#signal)) {
+                return false;
+            }
+            throw cause;
+        }
+    }
+}
+function decodeEvent(data) {
+    try {
+        const parsed = JSON.parse(data);
+        if (typeof parsed === "object" && parsed !== null && typeof parsed.type === "string") {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+async function safeText(response) {
+    try {
+        return await response.text();
+    }
+    catch {
+        return "";
+    }
+}
+// isAbort reports whether an error is the caller's explicit cancellation, so the stream
+// stops silently rather than surfacing an error or reconnecting.
+function isAbort(cause, signal) {
+    if (signal?.aborted) {
+        return true;
+    }
+    return cause instanceof Error && cause.name === "AbortError";
+}
+// --- Shared backoff, used by both stream reconnect and the client's request retry. ---
+// fullJitterBackoff returns a delay in [0, min(maxMs, baseMs * 2^attempt)] — the AWS
+// "full jitter" schedule, which spreads retries so many clients do not synchronize their
+// reconnect storms (§23.7). attempt is 0-based.
+export function fullJitterBackoff(attempt, baseMs, maxMs) {
+    if (baseMs <= 0 || attempt < 0) {
+        return 0;
+    }
+    const ceiling = Math.min(maxMs, baseMs * 2 ** attempt);
+    return Math.random() * ceiling;
+}
+// delay resolves after ms, or rejects with the signal's reason if it aborts first, so a
+// backoff sleep is itself cancelable.
+export function delay(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(signal.reason);
+            return;
+        }
+        const timer = setTimeout(resolve, ms);
+        signal?.addEventListener("abort", () => {
+            clearTimeout(timer);
+            reject(signal.reason);
+        }, { once: true });
+    });
+}
+//# sourceMappingURL=stream.js.map

package/dist/stream.js.map

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

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@palai/sdk",
+  "version": "0.1.0",
+  "description": "TypeScript client for the Palai API: responses, sessions, agents, approvals, artifacts and streaming.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "browser": {
+        "types": "./dist/index.browser.d.ts",
+        "default": "./dist/index.browser.js"
+      },
+      "default": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    },
+    "./browser": {
+      "types": "./dist/index.browser.d.ts",
+      "default": "./dist/index.browser.js"
+    }
+  },
+  "devDependencies": {
+    "@types/node": "26.1.1",
+    "typescript": "7.0.2"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc --project tsconfig.build.json",
+    "test": "node --test --experimental-strip-types test/*.test.ts",
+    "typecheck": "tsc --project tsconfig.json",
+    "generate:tools": "node scripts/generate-tools.mjs"
+  }
+}