@darqlabs/curator-sdk 0.1.0

package/dist/esm/files.d.ts

@@ -0,0 +1,66 @@
+/**
+ * File-upload surface for the Curator SDK.
+ *
+ *   curator.files.createUpload({ filename, mimeType, size })
+ *     // → { uploadUrl, headers, fileReference, expiresAt }
+ *     // caller PUTs bytes to `uploadUrl`, then passes `fileReference`
+ *     // into chat.send(..., { files: [fileReference] })
+ *
+ *   curator.files.upload({ filename, mimeType, data })
+ *     // one-shot convenience: presign + PUT + return fileReference
+ *
+ * Both helpers go through `POST /api/files/presign-upload`. The
+ * resulting upload URL is a short-lived V4 signed URL straight to the
+ * underlying object store — file bytes never round-trip through the
+ * Curator API.
+ */
+import type { HttpClient } from "./http.js";
+import type { FileAttachment } from "./types.js";
+export interface PresignUploadInput {
+    filename: string;
+    mimeType: string;
+    /** File size in bytes. Required by the server for validation. */
+    size: number;
+}
+export interface PresignUploadResult {
+    /** PUT bytes here. Single header to set: see `headers`. */
+    uploadUrl: string;
+    method: "PUT";
+    /** Headers the upload MUST include verbatim. The signature binds them. */
+    headers: Record<string, string>;
+    /** ISO timestamp the signed URL stops working. */
+    expiresAt: string;
+    /** Pass into `chat.send(..., { files: [...] })` after the upload completes. */
+    fileReference: FileAttachment;
+}
+/**
+ * Anything we can stuff into a `fetch` PUT body. Browsers prefer Blob /
+ * File; Node accepts Buffer / Uint8Array (Node 18+ fetch).
+ */
+export type UploadData = Blob | ArrayBuffer | ArrayBufferView | Uint8Array;
+export interface OneShotUploadInput {
+    filename: string;
+    mimeType: string;
+    data: UploadData;
+    /** Optional — inferred from `data` when omitted. */
+    size?: number;
+}
+export declare class Files {
+    private readonly http;
+    private readonly baseUrl;
+    private readonly fetchImpl;
+    constructor(http: HttpClient, baseUrl: string, fetchImpl: typeof fetch);
+    /**
+     * Two-step flow. Returns the signed PUT URL plus the `fileReference`
+     * you'll later hand to `chat.send`. The caller is responsible for
+     * doing the actual upload.
+     */
+    createUpload(input: PresignUploadInput): Promise<PresignUploadResult>;
+    /**
+     * One-shot helper: presign, PUT the bytes, return the file reference
+     * ready to attach to a message. Use this when you have the file
+     * bytes in hand and don't need progress tracking.
+     */
+    upload(input: OneShotUploadInput): Promise<FileAttachment>;
+}
+//# sourceMappingURL=files.d.ts.map

package/dist/esm/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/files.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,mBAAmB;IAClC,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,KAAK,CAAA;IACb,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAA;IACjB,+EAA+E;IAC/E,aAAa,EAAE,cAAc,CAAA;CAC9B;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAClB,IAAI,GACJ,WAAW,GACX,eAAe,GACf,UAAU,CAAA;AAEd,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,UAAU,CAAA;IAChB,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,qBAAa,KAAK;IAEd,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAFT,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,OAAO,KAAK;IAG1C;;;;OAIG;IACG,YAAY,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAiB3E;;;;OAIG;IACG,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC;CAsBjE"}

package/dist/esm/files.js

@@ -0,0 +1,82 @@
+/**
+ * File-upload surface for the Curator SDK.
+ *
+ *   curator.files.createUpload({ filename, mimeType, size })
+ *     // → { uploadUrl, headers, fileReference, expiresAt }
+ *     // caller PUTs bytes to `uploadUrl`, then passes `fileReference`
+ *     // into chat.send(..., { files: [fileReference] })
+ *
+ *   curator.files.upload({ filename, mimeType, data })
+ *     // one-shot convenience: presign + PUT + return fileReference
+ *
+ * Both helpers go through `POST /api/files/presign-upload`. The
+ * resulting upload URL is a short-lived V4 signed URL straight to the
+ * underlying object store — file bytes never round-trip through the
+ * Curator API.
+ */
+import { CuratorError } from "./errors.js";
+export class Files {
+    http;
+    baseUrl;
+    fetchImpl;
+    constructor(http, baseUrl, fetchImpl) {
+        this.http = http;
+        this.baseUrl = baseUrl;
+        this.fetchImpl = fetchImpl;
+    }
+    /**
+     * Two-step flow. Returns the signed PUT URL plus the `fileReference`
+     * you'll later hand to `chat.send`. The caller is responsible for
+     * doing the actual upload.
+     */
+    async createUpload(input) {
+        if (!input.filename)
+            throw new CuratorError("`filename` is required.");
+        if (!input.mimeType)
+            throw new CuratorError("`mimeType` is required.");
+        if (!Number.isFinite(input.size) || input.size <= 0) {
+            throw new CuratorError("`size` must be a positive number of bytes.");
+        }
+        return this.http.request(`${this.baseUrl}/api/files/presign-upload`, {
+            method: "POST",
+            body: {
+                filename: input.filename,
+                mimeType: input.mimeType,
+                size: input.size,
+            },
+        });
+    }
+    /**
+     * One-shot helper: presign, PUT the bytes, return the file reference
+     * ready to attach to a message. Use this when you have the file
+     * bytes in hand and don't need progress tracking.
+     */
+    async upload(input) {
+        const size = input.size ?? sizeOf(input.data);
+        const presigned = await this.createUpload({
+            filename: input.filename,
+            mimeType: input.mimeType,
+            size,
+        });
+        const putResponse = await this.fetchImpl(presigned.uploadUrl, {
+            method: presigned.method,
+            headers: presigned.headers,
+            body: input.data,
+        });
+        if (!putResponse.ok) {
+            const text = await putResponse.text().catch(() => "");
+            throw new CuratorError(`Upload failed with status ${putResponse.status}${text ? `: ${text}` : ""}`);
+        }
+        return presigned.fileReference;
+    }
+}
+function sizeOf(data) {
+    if (typeof Blob !== "undefined" && data instanceof Blob)
+        return data.size;
+    if (data instanceof ArrayBuffer)
+        return data.byteLength;
+    if (ArrayBuffer.isView(data))
+        return data.byteLength;
+    throw new CuratorError("Could not determine `size` from data — pass `size` explicitly.");
+}
+//# sourceMappingURL=files.js.map

package/dist/esm/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/files.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAyC1C,MAAM,OAAO,KAAK;IAEG;IACA;IACA;IAHnB,YACmB,IAAgB,EAChB,OAAe,EACf,SAAuB;QAFvB,SAAI,GAAJ,IAAI,CAAY;QAChB,YAAO,GAAP,OAAO,CAAQ;QACf,cAAS,GAAT,SAAS,CAAc;IACvC,CAAC;IAEJ;;;;OAIG;IACH,KAAK,CAAC,YAAY,CAAC,KAAyB;QAC1C,IAAI,CAAC,KAAK,CAAC,QAAQ;YAAE,MAAM,IAAI,YAAY,CAAC,yBAAyB,CAAC,CAAA;QACtE,IAAI,CAAC,KAAK,CAAC,QAAQ;YAAE,MAAM,IAAI,YAAY,CAAC,yBAAyB,CAAC,CAAA;QACtE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,YAAY,CAAC,4CAA4C,CAAC,CAAA;QACtE,CAAC;QAED,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAsB,GAAG,IAAI,CAAC,OAAO,2BAA2B,EAAE;YACxF,MAAM,EAAE,MAAM;YACd,IAAI,EAAE;gBACJ,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,IAAI,EAAE,KAAK,CAAC,IAAI;aACjB;SACF,CAAC,CAAA;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,KAAyB;QACpC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAC7C,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC;YACxC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,IAAI;SACL,CAAC,CAAA;QAEF,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,SAAS,EAAE;YAC5D,MAAM,EAAE,SAAS,CAAC,MAAM;YACxB,OAAO,EAAE,SAAS,CAAC,OAAO;YAC1B,IAAI,EAAE,KAAK,CAAC,IAAgB;SAC7B,CAAC,CAAA;QACF,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC;YACpB,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;YACrD,MAAM,IAAI,YAAY,CACpB,6BAA6B,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAC5E,CAAA;QACH,CAAC;QAED,OAAO,SAAS,CAAC,aAAa,CAAA;IAChC,CAAC;CACF;AAED,SAAS,MAAM,CAAC,IAAgB;IAC9B,IAAI,OAAO,IAAI,KAAK,WAAW,IAAI,IAAI,YAAY,IAAI;QAAE,OAAO,IAAI,CAAC,IAAI,CAAA;IACzE,IAAI,IAAI,YAAY,WAAW;QAAE,OAAO,IAAI,CAAC,UAAU,CAAA;IACvD,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,UAAU,CAAA;IACpD,MAAM,IAAI,YAAY,CAAC,gEAAgE,CAAC,CAAA;AAC1F,CAAC"}

package/dist/esm/http.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Thin HTTP layer the SDK uses to talk to the Curator API.
+ *
+ * Responsibilities:
+ *   - Attach the `Authorization: Bearer curator_<live|test>_*` header.
+ *   - Resolve the right URL family for project-scoped vs system-scoped
+ *     deployments.
+ *   - Translate HTTP failures into typed SDK errors so callers don't
+ *     branch on status codes.
+ *
+ * Everything else (retries, conversation state, waiting) lives in the
+ * higher-level classes that consume this transport.
+ */
+import type { Environment } from "./types.js";
+/**
+ * Per-deployment routing. The SDK supports the two URL families the
+ * backend exposes:
+ *   - project-scoped, env-aware: /api/projects/<slug>/environments/<env>/deployments/<slug>
+ *   - system-scoped:             /api/deployments/<slug>
+ */
+export interface DeploymentRoute {
+    kind: "project" | "system";
+    /** Required for `kind === 'project'`. */
+    project?: string;
+    /** Required for `kind === 'project'`. */
+    environment?: Environment;
+    deployment: string;
+}
+/**
+ * End-user JWT — a short-lived token minted by the customer's backend that
+ * proves which user on their platform is currently driving the agent. The
+ * SDK passes it through as `X-Curator-End-User-JWT` and the Curator backend
+ * verifies it against the org's configured JWKS. See the end-user JWT plan.
+ *
+ * Accepts either:
+ *   - a static string (caller refreshes by re-creating the client), or
+ *   - a sync/async function the SDK calls per-request (typical for browsers
+ *     that mint a fresh short-lived JWT via their backend on each turn).
+ */
+export type EndUserJwtProvider = string | (() => string | Promise<string> | null | undefined);
+export interface HttpClientOptions {
+    apiKey: string;
+    baseUrl: string;
+    /** Custom fetch implementation — defaults to global `fetch`. */
+    fetch?: typeof fetch;
+    /** Extra headers attached to every request (e.g. tracing). */
+    defaultHeaders?: Record<string, string>;
+    /**
+     * End-user JWT — see {@link EndUserJwtProvider}. Optional. When set and
+     * resolved to a non-empty string, the SDK attaches the
+     * `X-Curator-End-User-JWT` header to every request.
+     */
+    endUserJwt?: EndUserJwtProvider;
+}
+export interface RequestOptions {
+    method?: "GET" | "POST" | "DELETE";
+    query?: Record<string, string | number | boolean | undefined>;
+    body?: unknown;
+    /** Per-request fetch timeout, in ms. Aborts via AbortController. */
+    signalTimeoutMs?: number;
+}
+export declare class HttpClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly fetchImpl;
+    private readonly defaultHeaders;
+    private readonly endUserJwtProvider?;
+    constructor(opts: HttpClientOptions);
+    /** Build the URL prefix for a given deployment route. */
+    deploymentBase(route: DeploymentRoute): string;
+    /**
+     * Resolve the end-user JWT for this request. Resolves to `undefined`
+     * when no provider was configured or the provider returns falsy — the
+     * caller skips attaching the header in that case. Wraps function
+     * provider exceptions in a `CuratorError` so callers see a single
+     * error type regardless of whether the failure was network or token-mint.
+     */
+    private resolveEndUserJwt;
+    /**
+     * Issue a streaming POST and return the open response. Throws typed
+     * errors on a non-2xx status (consuming the error body for the
+     * message); on 2xx, hands back the live `Response` so the caller can
+     * read `response.body` as a `ReadableStream`.
+     */
+    streamPost(url: string, opts?: {
+        body?: unknown;
+        query?: RequestOptions["query"];
+        signal?: AbortSignal;
+    }): Promise<Response>;
+    request<T>(url: string, opts?: RequestOptions): Promise<T>;
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/esm/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAUH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAA;IAC1B,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,yCAAyC;IACzC,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,kBAAkB,GAC1B,MAAM,GACN,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;AAEvD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,gEAAgE;IAChE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;IACpB,8DAA8D;IAC9D,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvC;;;;OAIG;IACH,UAAU,CAAC,EAAE,kBAAkB,CAAA;CAChC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAA;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAA;IAC7D,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,oEAAoE;IACpE,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwB;IACvD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAoB;gBAE5C,IAAI,EAAE,iBAAiB;IAsBnC,yDAAyD;IACzD,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM;IAgB9C;;;;;;OAMG;YACW,iBAAiB;IAe/B;;;;;OAKG;IACG,UAAU,CACd,GAAG,EAAE,MAAM,EACX,IAAI,GAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GACnF,OAAO,CAAC,QAAQ,CAAC;IAyCd,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,CAAC,CAAC;CAmDrE"}

package/dist/esm/http.js

@@ -0,0 +1,228 @@
+/**
+ * Thin HTTP layer the SDK uses to talk to the Curator API.
+ *
+ * Responsibilities:
+ *   - Attach the `Authorization: Bearer curator_<live|test>_*` header.
+ *   - Resolve the right URL family for project-scoped vs system-scoped
+ *     deployments.
+ *   - Translate HTTP failures into typed SDK errors so callers don't
+ *     branch on status codes.
+ *
+ * Everything else (retries, conversation state, waiting) lives in the
+ * higher-level classes that consume this transport.
+ */
+import { CuratorAuthError, CuratorDeploymentRetiredError, CuratorError, CuratorForbiddenError, CuratorNotFoundError, CuratorRateLimitError, } from "./errors.js";
+export class HttpClient {
+    apiKey;
+    baseUrl;
+    fetchImpl;
+    defaultHeaders;
+    endUserJwtProvider;
+    constructor(opts) {
+        if (!opts.apiKey) {
+            throw new CuratorError("`apiKey` is required to construct the Curator client.");
+        }
+        this.apiKey = opts.apiKey;
+        this.baseUrl = stripTrailingSlash(opts.baseUrl);
+        this.endUserJwtProvider = opts.endUserJwt;
+        // Bind the global fetch to its host (`window` in browsers, `globalThis`
+        // in Node). Without this, browsers throw "Illegal invocation" because
+        // the unbound fetch reference is later called via `this.fetchImpl(...)`
+        // with the HttpClient instance as `this`. Caller-supplied fetches are
+        // assumed to already be bound (or to be arrow-style wrappers).
+        const globalFetch = globalThis.fetch;
+        this.fetchImpl = opts.fetch ?? (globalFetch ? globalFetch.bind(globalThis) : undefined);
+        if (!this.fetchImpl) {
+            throw new CuratorError("No global fetch found. Pass `fetch` explicitly in the SDK options on Node < 18 or in a runtime that lacks it.");
+        }
+        this.defaultHeaders = { ...opts.defaultHeaders };
+    }
+    /** Build the URL prefix for a given deployment route. */
+    deploymentBase(route) {
+        if (route.kind === "project") {
+            if (!route.project || !route.environment) {
+                throw new CuratorError("Project-scoped deployment requires both `project` and `environment`.");
+            }
+            const project = encodeURIComponent(route.project);
+            const env = encodeURIComponent(route.environment);
+            const slug = encodeURIComponent(route.deployment);
+            return `${this.baseUrl}/api/projects/${project}/environments/${env}/deployments/${slug}`;
+        }
+        const slug = encodeURIComponent(route.deployment);
+        return `${this.baseUrl}/api/deployments/${slug}`;
+    }
+    /**
+     * Resolve the end-user JWT for this request. Resolves to `undefined`
+     * when no provider was configured or the provider returns falsy — the
+     * caller skips attaching the header in that case. Wraps function
+     * provider exceptions in a `CuratorError` so callers see a single
+     * error type regardless of whether the failure was network or token-mint.
+     */
+    async resolveEndUserJwt() {
+        const p = this.endUserJwtProvider;
+        if (!p)
+            return undefined;
+        if (typeof p === "string")
+            return p || undefined;
+        try {
+            const value = await p();
+            return value || undefined;
+        }
+        catch (err) {
+            throw new CuratorError(`Failed to obtain end-user JWT: ${err.message}`, { cause: err });
+        }
+    }
+    /**
+     * Issue a streaming POST and return the open response. Throws typed
+     * errors on a non-2xx status (consuming the error body for the
+     * message); on 2xx, hands back the live `Response` so the caller can
+     * read `response.body` as a `ReadableStream`.
+     */
+    async streamPost(url, opts = {}) {
+        const finalUrl = appendQuery(url, opts.query);
+        const headers = {
+            Authorization: `Bearer ${this.apiKey}`,
+            Accept: "text/event-stream",
+            ...this.defaultHeaders,
+        };
+        if (opts.body !== undefined) {
+            headers["Content-Type"] = "application/json";
+        }
+        const endUserJwt = await this.resolveEndUserJwt();
+        if (endUserJwt) {
+            headers["X-Curator-End-User-JWT"] = endUserJwt;
+        }
+        let response;
+        try {
+            response = await this.fetchImpl(finalUrl, {
+                method: "POST",
+                headers,
+                body: opts.body !== undefined ? JSON.stringify(opts.body) : undefined,
+                signal: opts.signal,
+            });
+        }
+        catch (err) {
+            throw new CuratorError(`Network error talking to ${finalUrl}: ${err.message}`, { cause: err });
+        }
+        if (!response.ok) {
+            const text = await response.text().catch(() => "");
+            const body = text ? safeJsonParse(text) : undefined;
+            throw httpError(response.status, body, finalUrl);
+        }
+        if (!response.body) {
+            throw new CuratorError(`Streaming response had no body (${finalUrl})`);
+        }
+        return response;
+    }
+    async request(url, opts = {}) {
+        const finalUrl = appendQuery(url, opts.query);
+        const headers = {
+            Authorization: `Bearer ${this.apiKey}`,
+            Accept: "application/json",
+            ...this.defaultHeaders,
+        };
+        if (opts.body !== undefined) {
+            headers["Content-Type"] = "application/json";
+        }
+        const endUserJwt = await this.resolveEndUserJwt();
+        if (endUserJwt) {
+            headers["X-Curator-End-User-JWT"] = endUserJwt;
+        }
+        const controller = opts.signalTimeoutMs ? new AbortController() : null;
+        const timer = controller
+            ? setTimeout(() => controller.abort(), opts.signalTimeoutMs)
+            : null;
+        let response;
+        try {
+            response = await this.fetchImpl(finalUrl, {
+                method: opts.method ?? "GET",
+                headers,
+                body: opts.body !== undefined ? JSON.stringify(opts.body) : undefined,
+                signal: controller?.signal,
+            });
+        }
+        catch (err) {
+            throw new CuratorError(`Network error talking to ${finalUrl}: ${err.message}`, { cause: err });
+        }
+        finally {
+            if (timer)
+                clearTimeout(timer);
+        }
+        if (response.status === 204) {
+            return undefined;
+        }
+        const text = await response.text();
+        const body = text ? safeJsonParse(text) : undefined;
+        if (!response.ok) {
+            throw httpError(response.status, body, finalUrl);
+        }
+        return body ?? undefined;
+    }
+}
+function stripTrailingSlash(s) {
+    return s.replace(/\/+$/, "");
+}
+function appendQuery(url, query) {
+    if (!query)
+        return url;
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(query)) {
+        if (value === undefined || value === null)
+            continue;
+        params.append(key, String(value));
+    }
+    const qs = params.toString();
+    if (!qs)
+        return url;
+    return url.includes("?") ? `${url}&${qs}` : `${url}?${qs}`;
+}
+function safeJsonParse(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+function httpError(status, body, url) {
+    const detail = readErrorMessage(body);
+    switch (status) {
+        case 401:
+            return new CuratorAuthError(detail ?? "Invalid or revoked API key");
+        case 403:
+            return new CuratorForbiddenError(detail ?? "Permission denied");
+        case 404:
+            return new CuratorNotFoundError(detail ?? "Resource not found");
+        case 410: {
+            const retiredAt = body && typeof body === "object" && "details" in body
+                ? (body.details
+                    ?.retired_at ?? null)
+                : null;
+            return new CuratorDeploymentRetiredError(detail ?? "Deployment has been retired", retiredAt);
+        }
+        case 429: {
+            const retry = body && typeof body === "object" && "retryAfter" in body
+                ? Number(body.retryAfter)
+                : null;
+            return new CuratorRateLimitError(detail ?? undefined, Number.isFinite(retry) ? retry : null);
+        }
+        default:
+            return new CuratorError(`HTTP ${status} from ${url}${detail ? `: ${detail}` : ""}`);
+    }
+}
+function readErrorMessage(body) {
+    if (!body || typeof body !== "object")
+        return undefined;
+    const b = body;
+    if (typeof b.error === "string")
+        return b.error;
+    if (b.error && typeof b.error === "object") {
+        const inner = b.error;
+        if (typeof inner.message === "string")
+            return inner.message;
+    }
+    if (typeof b.message === "string")
+        return b.message;
+    return undefined;
+}
+//# sourceMappingURL=http.js.map

package/dist/esm/http.js.map

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

package/dist/esm/index.d.ts

@@ -0,0 +1,10 @@
+export { Curator, Agent, Chat } from "./client.js";
+export type { CuratorOptions, AgentLocator } from "./client.js";
+export type { EndUserJwtProvider } from "./http.js";
+export { Files } from "./files.js";
+export type { PresignUploadInput, PresignUploadResult, OneShotUploadInput, UploadData, } from "./files.js";
+export { CuratorError, CuratorAuthError, CuratorForbiddenError, CuratorNotFoundError, CuratorDeploymentRetiredError, CuratorRateLimitError, CuratorApprovalRequiredError, CuratorAgentError, CuratorTimeoutError, } from "./errors.js";
+export type { AssistantMessage, UserMessage, ToolMessage, ConversationMessage, Environment, FileAttachment, ApprovalDetails, AgentFailureClass, SendOptions, HistoryOptions, HistoryPage, DeploymentConfig, } from "./types.js";
+export type { StreamEvent, StreamDelta, StreamToolCallStarted, StreamToolCallCompleted, StreamDone, StreamError, StreamPausedForApproval, } from "./streamEvents.js";
+export { isTerminalStreamEvent } from "./streamEvents.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAClD,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/D,YAAY,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,UAAU,GACX,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,6BAA6B,EAC7B,qBAAqB,EACrB,4BAA4B,EAC5B,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,aAAa,CAAA;AACpB,YAAY,EACV,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,cAAc,EACd,WAAW,EACX,gBAAgB,GACjB,MAAM,YAAY,CAAA;AACnB,YAAY,EACV,WAAW,EACX,WAAW,EACX,qBAAqB,EACrB,uBAAuB,EACvB,UAAU,EACV,WAAW,EACX,uBAAuB,GACxB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/esm/index.js

@@ -0,0 +1,5 @@
+export { Curator, Agent, Chat } from "./client.js";
+export { Files } from "./files.js";
+export { CuratorError, CuratorAuthError, CuratorForbiddenError, CuratorNotFoundError, CuratorDeploymentRetiredError, CuratorRateLimitError, CuratorApprovalRequiredError, CuratorAgentError, CuratorTimeoutError, } from "./errors.js";
+export { isTerminalStreamEvent } from "./streamEvents.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAGlD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAOlC,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,6BAA6B,EAC7B,qBAAqB,EACrB,4BAA4B,EAC5B,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,aAAa,CAAA;AAwBpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/dist/esm/sse.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Tiny SSE parser.
+ *
+ * Reads a `ReadableStream<Uint8Array>` (the body returned by `fetch`)
+ * and yields SSE frames as `{ event, data }`. Spec essentials: lines
+ * separated by `\n` (or `\r\n`), blank line terminates a message,
+ * `event:` and `data:` fields are accumulated until the terminator,
+ * `:` lines are comments and ignored. We don't track ids or retries —
+ * not needed for the wait-for-terminal use case.
+ *
+ * Used by Chat.stream() to turn the backend's SSE response into typed
+ * stream events.
+ */
+export interface SseFrame {
+    event: string;
+    /** Raw JSON string (or empty when the field was absent). */
+    data: string;
+}
+export declare function parseSseStream(stream: ReadableStream<Uint8Array>): AsyncIterable<SseFrame>;
+//# sourceMappingURL=sse.d.ts.map

package/dist/esm/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/sse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAA;CACb;AAED,wBAAuB,cAAc,CACnC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GACjC,aAAa,CAAC,QAAQ,CAAC,CAoCzB"}

package/dist/esm/sse.js

@@ -0,0 +1,86 @@
+/**
+ * Tiny SSE parser.
+ *
+ * Reads a `ReadableStream<Uint8Array>` (the body returned by `fetch`)
+ * and yields SSE frames as `{ event, data }`. Spec essentials: lines
+ * separated by `\n` (or `\r\n`), blank line terminates a message,
+ * `event:` and `data:` fields are accumulated until the terminator,
+ * `:` lines are comments and ignored. We don't track ids or retries —
+ * not needed for the wait-for-terminal use case.
+ *
+ * Used by Chat.stream() to turn the backend's SSE response into typed
+ * stream events.
+ */
+export async function* parseSseStream(stream) {
+    const reader = stream.getReader();
+    const decoder = new TextDecoder("utf-8");
+    let buffer = "";
+    try {
+        while (true) {
+            const { value, done } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            // Split on blank-line terminators (either \n\n or \r\n\r\n). The
+            // last chunk in the buffer may be a partial frame; we keep it for
+            // the next read.
+            let boundary = findBoundary(buffer);
+            while (boundary !== -1) {
+                const rawFrame = buffer.slice(0, boundary);
+                buffer = buffer.slice(boundary).replace(/^(\r?\n)+/, "");
+                const frame = parseFrame(rawFrame);
+                if (frame)
+                    yield frame;
+                boundary = findBoundary(buffer);
+            }
+        }
+        // Flush any trailing complete frame (no blank line, but the stream ended).
+        if (buffer.trim().length > 0) {
+            const frame = parseFrame(buffer);
+            if (frame)
+                yield frame;
+        }
+    }
+    finally {
+        try {
+            reader.releaseLock();
+        }
+        catch {
+            /* ignore */
+        }
+    }
+}
+function findBoundary(s) {
+    const a = s.indexOf("\n\n");
+    const b = s.indexOf("\r\n\r\n");
+    if (a === -1)
+        return b;
+    if (b === -1)
+        return a;
+    return Math.min(a, b);
+}
+function parseFrame(raw) {
+    let event = "message";
+    const dataLines = [];
+    for (const line of raw.split(/\r?\n/)) {
+        if (line.length === 0)
+            continue;
+        if (line.startsWith(":"))
+            continue; // comment / heartbeat
+        const colon = line.indexOf(":");
+        const field = colon === -1 ? line : line.slice(0, colon);
+        // Spec: a single leading space after the colon is stripped.
+        let value = colon === -1 ? "" : line.slice(colon + 1);
+        if (value.startsWith(" "))
+            value = value.slice(1);
+        if (field === "event")
+            event = value;
+        else if (field === "data")
+            dataLines.push(value);
+        // ignore id / retry
+    }
+    if (dataLines.length === 0 && event === "message")
+        return null;
+    return { event, data: dataLines.join("\n") };
+}
+//# sourceMappingURL=sse.js.map

package/dist/esm/sse.js.map

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