@arden-hq/headless 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 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,35 @@
-# Temporary Holding Version
+# `@arden-hq/headless`
 
-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.
+A Node client for the HTTP and SSE API of an Arden server. The CLI (`arden run`) uses it.
+
+```ts
+import { createHeadlessClient } from "@arden-hq/headless"
+
+const client = createHeadlessClient({ baseUrl: "http://127.0.0.1:3000" })
+const { sessionId } = await client.createSession()
+const run = await client.submit({ sessionId, message: "Hello" })
+const detail = await client.wait(run)
+```
+
+## Exports
+
+- `createHeadlessClient(options)` and the `HeadlessClient` class. Options are `baseUrl`, `headers` and `fetch`.
+- Sessions: `createSession`, `branchSession`, `listSessions`, `deleteSession`.
+- Runs: `submit`, `getRun`, `getRunEvents`, `wait`, `waitForRun`, `cancel`.
+- Answers: `answerApproval` and `answerConnection` reply to a paused run.
+- Other: `health`, `listSpaces`.
+- Errors: `HeadlessHttpError`, `HeadlessProtocolError`, `HeadlessTimeoutError`, `HeadlessEventHandlerError`.
+
+## Rules
+
+- All requests and responses use the contracts of `@arden-hq/protocol`. A bad response throws `HeadlessProtocolError`.
+- `submit` retries with the same prepared body, so a retry cannot send the message twice.
+- The client sends no credentials by default. Pass them in `headers`.
+
+## Build
+
+```bash
+bun run build
+bun run typecheck
+bun run test
+```

package/dist/client.d.ts

@@ -0,0 +1,87 @@
+import type { DecodedServerEventFrame } from "@arden-hq/protocol";
+import { type CancelInput, type CancelResponse, type ChatMessageInput, type ChatReceiptStatus, type ConnectionResultInput, type ToolResultInput } from "@arden-hq/protocol/chat";
+import { type SpaceListResponse } from "@arden-hq/protocol/spaces";
+import { type HealthStatus } from "@arden-hq/protocol/health";
+import { type RunDetail, type RunEventPage, type RunEventPageOptions, type RunTerminalResult } from "@arden-hq/protocol/runs";
+import { type BranchSessionRequest, type BranchSessionResponse, type CreateSessionRequest, type CreateSessionResponse, type SessionListOptions, type SessionListResponse } from "@arden-hq/protocol/sessions";
+export type { RunDetail, RunTerminalResult };
+/** One decoded frame of a run's session event stream. */
+export type HeadlessRunEvent = DecodedServerEventFrame;
+export interface HeadlessClientOptions {
+    readonly baseUrl: string | URL;
+    readonly headers?: Readonly<Record<string, string>>;
+    readonly fetch?: typeof globalThis.fetch;
+}
+export interface SubmittedRun {
+    readonly runId: string;
+    readonly sessionId: string;
+    readonly clientId: string;
+    readonly status: ChatReceiptStatus;
+}
+export interface HeadlessStreamOptions {
+    readonly signal?: AbortSignal;
+}
+export interface HeadlessRunEventOptions extends RunEventPageOptions {
+    readonly signal?: AbortSignal;
+}
+export interface WaitForRunOptions {
+    readonly signal?: AbortSignal;
+    readonly timeoutMs?: number;
+    readonly reconnectDelayMs?: number;
+    readonly onEvent?: (event: HeadlessRunEvent) => void | PromiseLike<void>;
+}
+export declare class HeadlessHttpError extends Error {
+    readonly status: number;
+    readonly method: string;
+    readonly path: string;
+    readonly detail: string;
+    readonly name = "HeadlessHttpError";
+    constructor(status: number, method: string, path: string, detail: string);
+}
+export declare class HeadlessProtocolError extends Error {
+    readonly name = "HeadlessProtocolError";
+    readonly cause?: unknown;
+    constructor(message: string, cause?: unknown);
+}
+export declare class HeadlessTimeoutError extends Error {
+    readonly timeoutMs: number;
+    readonly name = "HeadlessTimeoutError";
+    constructor(timeoutMs: number);
+}
+export declare class HeadlessEventHandlerError extends Error {
+    readonly name = "HeadlessEventHandlerError";
+    readonly cause: unknown;
+    constructor(cause: unknown);
+}
+export declare class HeadlessClient {
+    #private;
+    constructor(options: HeadlessClientOptions);
+    createSession(input?: CreateSessionRequest): Promise<CreateSessionResponse>;
+    branchSession(sessionId: string, input?: BranchSessionRequest): Promise<BranchSessionResponse>;
+    /** Submit with one generated client id and reuse the exact body for a lost-response retry. */
+    submit(input: ChatMessageInput): Promise<SubmittedRun>;
+    getRun(runId: string): Promise<RunDetail>;
+    getRunEvents(runId: string, options?: HeadlessRunEventOptions): Promise<RunEventPage>;
+    streamSession(sessionId: string, options?: HeadlessStreamOptions): AsyncGenerator<HeadlessRunEvent>;
+    /** Follow a submitted message to the end of the Run that answers it. A queued
+     *  message joined the chat's running Run (a Goal's turn, say), which another
+     *  client started; that Run answers it, under its own client identity. */
+    wait(run: SubmittedRun, options?: WaitForRunOptions): Promise<RunDetail>;
+    /** Follow a Run this client did not submit (one started earlier, or elsewhere) to its end. */
+    waitForRun(runId: string, options?: WaitForRunOptions): Promise<RunDetail>;
+    listSessions(options?: SessionListOptions): Promise<SessionListResponse>;
+    /** Whether the server is up and has a model to answer with. */
+    health(): Promise<HealthStatus>;
+    /** Delete a Session for good, with its files: archived first, as only an archived one deletes. */
+    deleteSession(sessionId: string): Promise<void>;
+    listSpaces(): Promise<SpaceListResponse>;
+    /** Answer a tool approval the Run is waiting on. */
+    answerApproval(input: ToolResultInput): Promise<void>;
+    /** Answer a connection request the Run is waiting on. */
+    answerConnection(input: ConnectionResultInput): Promise<void>;
+    cancel(input: CancelInput, options?: {
+        readonly signal?: AbortSignal;
+    }): Promise<CancelResponse>;
+}
+export declare const createHeadlessClient: (options: HeadlessClientOptions) => HeadlessClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,327 @@
+import { chatDecoders, chatRequests, chatRoutes } from "@arden-hq/protocol/chat";
+import { spaceDecoders, spaceRoutes } from "@arden-hq/protocol/spaces";
+import { healthDecoders, healthRoutes } from "@arden-hq/protocol/health";
+import { ProtocolError } from "@arden-hq/protocol";
+import { isTerminalRunStatus, runDecoders, runRoutes } from "@arden-hq/protocol/runs";
+import { sessionDecoders, sessionRequests, sessionRoutes } from "@arden-hq/protocol/sessions";
+import { retryableStatus } from "@arden-hq/std/retry";
+import { sleep } from "@arden-hq/std/sleep";
+export class HeadlessHttpError extends Error {
+    status;
+    method;
+    path;
+    detail;
+    name = "HeadlessHttpError";
+    constructor(status, method, path, detail) {
+        super(`${method} ${path} failed with HTTP ${status}${detail.length === 0 ? "" : `: ${detail}`}`);
+        this.status = status;
+        this.method = method;
+        this.path = path;
+        this.detail = detail;
+    }
+}
+export class HeadlessProtocolError extends Error {
+    name = "HeadlessProtocolError";
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+    }
+}
+export class HeadlessTimeoutError extends Error {
+    timeoutMs;
+    name = "HeadlessTimeoutError";
+    constructor(timeoutMs) {
+        super(`Run did not finish within ${timeoutMs} ms`);
+        this.timeoutMs = timeoutMs;
+    }
+}
+export class HeadlessEventHandlerError extends Error {
+    name = "HeadlessEventHandlerError";
+    cause;
+    constructor(cause) {
+        super("Headless Run event handler failed");
+        this.cause = cause;
+    }
+}
+const reconcilingEvents = new Set([
+    "RUN_FINISHED",
+    "RUN_ERROR",
+    "run_cancelled",
+    "stream_snapshot",
+    "stream_live"
+]);
+const shouldReconcile = (event) => reconcilingEvents.has(event.data.type);
+const responseDetail = (response) => response.text().then((body) => body.trim().slice(0, 2_000), () => "");
+const responseJson = async (response) => {
+    try {
+        return await response.json();
+    }
+    catch (cause) {
+        throw new HeadlessProtocolError("Arden returned invalid JSON", cause);
+    }
+};
+const responseChunks = async function* (body) {
+    const reader = body.getReader();
+    try {
+        while (true) {
+            const next = await reader.read();
+            if (next.done)
+                return;
+            yield next.value;
+        }
+    }
+    finally {
+        await reader.cancel().catch(() => undefined);
+        reader.releaseLock();
+    }
+};
+const retryableConnectionFailure = (cause) => cause instanceof TypeError ||
+    (cause instanceof HeadlessHttpError && retryableStatus(cause.status));
+const throwIfAborted = (signal) => {
+    if (signal?.aborted !== true)
+        return;
+    throw signal.reason instanceof Error ? signal.reason : new Error("Headless Run wait was aborted");
+};
+const assertRunIdentity = (detail, submitted) => {
+    if (detail.run_id !== submitted.runId || detail.session_id !== submitted.sessionId) {
+        throw new HeadlessProtocolError("Arden returned a Run that does not match its submission");
+    }
+    if (detail.client_id !== submitted.clientId) {
+        throw new HeadlessProtocolError("Arden returned a Run with a different client identity");
+    }
+};
+export class HeadlessClient {
+    #baseUrl;
+    #headers;
+    #fetch;
+    constructor(options) {
+        this.#baseUrl = new URL(options.baseUrl);
+        this.#headers = Object.freeze({ ...(options.headers ?? {}) });
+        this.#fetch = options.fetch ?? globalThis.fetch;
+    }
+    async createSession(input = {}) {
+        return sessionDecoders.createResponse(await this.#requestJson(sessionRoutes.collection, {
+            method: "POST",
+            body: sessionRequests.create(input)
+        }));
+    }
+    async branchSession(sessionId, input = {}) {
+        return sessionDecoders.branchResponse(await this.#requestJson(sessionRoutes.branch(sessionId), {
+            method: "POST",
+            body: sessionRequests.branch(input)
+        }));
+    }
+    /** Submit with one generated client id and reuse the exact body for a lost-response retry. */
+    async submit(input) {
+        const prepared = chatRequests.message(input);
+        let response;
+        let lastCause;
+        for (let attempt = 0; attempt < 2; attempt += 1) {
+            try {
+                response = await this.#fetch(this.#url(chatRoutes.message), {
+                    method: "POST",
+                    headers: this.#requestHeaders(true),
+                    body: prepared.body
+                });
+                if (response.ok || !retryableStatus(response.status) || attempt === 1)
+                    break;
+                lastCause = new HeadlessHttpError(response.status, "POST", chatRoutes.message, await responseDetail(response));
+            }
+            catch (cause) {
+                lastCause = cause;
+                if (attempt === 1)
+                    throw cause;
+            }
+        }
+        if (response === undefined)
+            throw lastCause;
+        if (!response.ok)
+            throw await this.#httpError(response, "POST", chatRoutes.message);
+        const receipt = chatDecoders.receipt(await responseJson(response));
+        if (receipt.runId === null) {
+            throw new HeadlessProtocolError("Arden accepted no Run for the submitted message");
+        }
+        return {
+            runId: receipt.runId,
+            sessionId: receipt.sessionId,
+            clientId: prepared.clientId,
+            status: receipt.status
+        };
+    }
+    async getRun(runId) {
+        return this.#getRun(runId);
+    }
+    async getRunEvents(runId, options = {}) {
+        const { signal, ...page } = options;
+        return runDecoders.eventPage(await this.#requestJson(runRoutes.events(runId, page), {
+            method: "GET",
+            ...(signal === undefined ? {} : { signal })
+        }));
+    }
+    async *streamSession(sessionId, options = {}) {
+        const path = chatRoutes.events(sessionId);
+        const response = await this.#fetch(this.#url(path), {
+            method: "GET",
+            headers: this.#requestHeaders(false, { accept: "text/event-stream" }),
+            ...(options.signal === undefined ? {} : { signal: options.signal })
+        });
+        if (!response.ok)
+            throw await this.#httpError(response, "GET", path);
+        if (response.body === null) {
+            throw new HeadlessProtocolError("Arden returned an empty event stream");
+        }
+        yield* chatDecoders.eventStream(responseChunks(response.body));
+    }
+    /** Follow a submitted message to the end of the Run that answers it. A queued
+     *  message joined the chat's running Run (a Goal's turn, say), which another
+     *  client started; that Run answers it, under its own client identity. */
+    async wait(run, options = {}) {
+        if (run.status === "queued")
+            return this.waitForRun(run.runId, options);
+        return this.#waitFor(run, options);
+    }
+    /** Follow a Run this client did not submit (one started earlier, or elsewhere) to its end. */
+    async waitForRun(runId, options = {}) {
+        const detail = await this.#getRun(runId, options.signal);
+        if (isTerminalRunStatus(detail.status))
+            return detail;
+        return this.#waitFor({ runId: detail.run_id, sessionId: detail.session_id, clientId: detail.client_id }, options);
+    }
+    async listSessions(options = {}) {
+        return sessionDecoders.listResponse(await this.#requestJson(sessionRoutes.list(options), { method: "GET" }));
+    }
+    /** Whether the server is up and has a model to answer with. */
+    async health() {
+        return healthDecoders.status(await this.#requestJson(healthRoutes.status, { method: "GET" }));
+    }
+    /** Delete a Session for good, with its files: archived first, as only an archived one deletes. */
+    async deleteSession(sessionId) {
+        await this.#requestJson(sessionRoutes.archive(sessionId, { stop: false }), { method: "DELETE" });
+        await this.#requestJson(sessionRoutes.permanentDelete(sessionId, { stop: false }), {
+            method: "DELETE"
+        });
+    }
+    async listSpaces() {
+        return spaceDecoders.list(await this.#requestJson(spaceRoutes.collection, { method: "GET" }));
+    }
+    /** Answer a tool approval the Run is waiting on. */
+    async answerApproval(input) {
+        await this.#requestJson(chatRoutes.toolResult, {
+            method: "POST",
+            body: chatRequests.toolResult(input)
+        });
+    }
+    /** Answer a connection request the Run is waiting on. */
+    async answerConnection(input) {
+        await this.#requestJson(chatRoutes.connectionResult, {
+            method: "POST",
+            body: chatRequests.connectionResult(input)
+        });
+    }
+    async #waitFor(run, options) {
+        const timeoutController = new AbortController();
+        const timeoutMs = options.timeoutMs;
+        const timeout = timeoutMs === undefined
+            ? undefined
+            : setTimeout(() => {
+                timeoutController.abort(new HeadlessTimeoutError(timeoutMs));
+            }, timeoutMs);
+        timeout?.unref();
+        const signal = options.signal === undefined
+            ? timeoutController.signal
+            : AbortSignal.any([options.signal, timeoutController.signal]);
+        const reconnectDelayMs = options.reconnectDelayMs ?? 100;
+        try {
+            while (true) {
+                throwIfAborted(signal);
+                let detail;
+                try {
+                    detail = await this.#getRun(run.runId, signal);
+                }
+                catch (cause) {
+                    throwIfAborted(signal);
+                    if (!retryableConnectionFailure(cause))
+                        throw cause;
+                    await sleep(reconnectDelayMs, signal);
+                    continue;
+                }
+                throwIfAborted(signal);
+                assertRunIdentity(detail, run);
+                if (isTerminalRunStatus(detail.status))
+                    return detail;
+                try {
+                    for await (const event of this.streamSession(run.sessionId, { signal })) {
+                        throwIfAborted(signal);
+                        if (options.onEvent !== undefined) {
+                            try {
+                                await options.onEvent(event);
+                            }
+                            catch (cause) {
+                                throw new HeadlessEventHandlerError(cause);
+                            }
+                        }
+                        if (!shouldReconcile(event))
+                            continue;
+                        const reconciled = await this.#getRun(run.runId, signal);
+                        throwIfAborted(signal);
+                        assertRunIdentity(reconciled, run);
+                        if (isTerminalRunStatus(reconciled.status))
+                            return reconciled;
+                    }
+                }
+                catch (cause) {
+                    throwIfAborted(signal);
+                    if (cause instanceof ProtocolError || !retryableConnectionFailure(cause))
+                        throw cause;
+                }
+                await sleep(reconnectDelayMs, signal);
+            }
+        }
+        catch (cause) {
+            throwIfAborted(signal);
+            throw cause;
+        }
+        finally {
+            if (timeout !== undefined)
+                clearTimeout(timeout);
+        }
+    }
+    async cancel(input, options = {}) {
+        return chatDecoders.cancel(await this.#requestJson(chatRoutes.cancel, {
+            method: "POST",
+            body: chatRequests.cancel(input),
+            ...(options.signal === undefined ? {} : { signal: options.signal })
+        }));
+    }
+    async #getRun(runId, signal) {
+        return runDecoders.detail(await this.#requestJson(runRoutes.detail(runId), {
+            method: "GET",
+            ...(signal === undefined ? {} : { signal })
+        }));
+    }
+    async #requestJson(path, init) {
+        const response = await this.#fetch(this.#url(path), {
+            ...init,
+            headers: this.#requestHeaders(init.body !== undefined)
+        });
+        if (!response.ok)
+            throw await this.#httpError(response, init.method ?? "GET", path);
+        return responseJson(response);
+    }
+    #requestHeaders(json, extra = {}) {
+        return {
+            ...this.#headers,
+            ...(json ? { "content-type": "application/json" } : {}),
+            ...extra
+        };
+    }
+    #url(path) {
+        return new URL(path, this.#baseUrl);
+    }
+    async #httpError(response, method, path) {
+        return new HeadlessHttpError(response.status, method, path, await responseDetail(response));
+    }
+}
+export const createHeadlessClient = (options) => new HeadlessClient(options);
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./client.js";
+//# 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":"AAAA,cAAc,aAAa,CAAA"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from "./client.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA"}

package/package.json

@@ -1,6 +1,52 @@
 {
+  "$schema": "https://json.schemastore.org/package.json",
   "name": "@arden-hq/headless",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Node client for Arden's production HTTP and SSE runtime",
+  "license": "Apache-2.0",
+  "type": "module",
+  "engines": {
+    "node": ">=20.19"
+  },
+  "types": "./dist/index.d.ts",
+  "module": "./dist/index.js",
+  "exports": {
+    ".": {
+      "arden-source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "dist/**/*.js.map",
+    "dist/**/*.d.ts.map",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "node ../../tooling/clean-dist.mjs",
+    "prepack": "bun run clean && bun run build",
+    "typecheck": "tsc -p tsconfig.check.json --noEmit --pretty false --incremental --tsBuildInfoFile ../../node_modules/.cache/tsc/libs-headless.tsbuildinfo",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@arden-hq/protocol": "0.1.0",
+    "@arden-hq/std": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "24.10.1",
+    "typescript": "7.0.2",
+    "vitest": "4.1.12"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/arden-hq/arden-engine.git",
+    "directory": "libs/headless"
+  }
+}