@lightspeed-ai/sdk 0.4.0

package/README.md

@@ -0,0 +1,68 @@
+# Lightspeed TypeScript SDK
+
+TypeScript SDK for Lightspeed, with a typed JSON-RPC client and workflow helpers.
+
+The public API types and typed method map are generated from the committed
+contract artifacts in `crates/api/contract/`. The hand-written code is limited to the
+JSON-RPC transport and small workflow helpers.
+
+For a complete application walkthrough with authentication, retry identity,
+events, and results, read
+[API and TypeScript](../../docs/documentation/integrating-and-extending/api-and-typescript.md).
+Durable receivers and custom workers are covered in
+[Workflow tools](../../docs/documentation/integrating-and-extending/workflow-tools.md).
+
+## Install
+
+Tagged Lightspeed releases publish `@lightspeed-ai/sdk` to npm. In-tree
+consumers use the repository workspace directly.
+
+```bash
+npm install @lightspeed-ai/sdk
+```
+
+## Use
+
+```ts
+import { LightspeedClient } from "@lightspeed-ai/sdk";
+
+const lightspeed = new LightspeedClient("http://127.0.0.1:18080/rpc");
+
+const session = await lightspeed.call("session/start", {
+  sessionId: "session_123",
+  config: null,
+});
+
+const run = await lightspeed.startRun(
+  session.result.session.id,
+  [{ type: "text", text: "summarize this repository" }],
+);
+
+const terminal = await lightspeed.awaitRun(session.result.session.id, run.result.run.id);
+
+console.log(terminal.state.status, terminal.cursor);
+```
+
+Raw calls return the full `AgentApiOutcome<...>` envelope, including any
+notifications. JSON-RPC failures throw `LightspeedRpcError` with `code`, `message`,
+`kind`, and raw `data` preserved.
+
+`METHOD_INFO` exposes the canonical Rust-authored scope, summary, and
+operational description for every method. The generated `rpc.*` helpers carry
+the same text as JSDoc, while parameter and result field documentation comes
+from the generated schema types.
+
+## Regenerate
+
+```bash
+npm install
+npm run check --workspace @lightspeed-ai/sdk
+```
+
+`npm run check:generated` regenerates `src/generated/*` and the packaged
+schemas, and fails if the committed generated output is stale.
+
+Workflow receivers import `@lightspeed-ai/sdk/workflow`. That subpath
+contains generated emission/start-on-call types and manifest-owned constants,
+plus Temporal-sandbox-safe parsing, id derivation, workflow-id, recipe, and
+reply helpers. It has no Temporal package dependency.

package/dist/client.d.ts

@@ -0,0 +1,65 @@
+import type { AgentApiOutcomeOfRunStartResponse, AgentApiOutcomeOfSessionEventsReadResponse, EventCursor, ContentRefView, InputItem, RunStartConfig, RunStartSource, SessionEventView } from "./generated/types.js";
+import type { Method, MethodParams, MethodResult, RpcCaller } from "./generated/methods.js";
+export type RequestId = number | string;
+export interface CallOptions {
+    headers?: HeadersInit;
+    signal?: AbortSignal;
+}
+export interface LightspeedClientOptions {
+    endpoint: string | URL;
+    fetch?: typeof fetch;
+    headers?: HeadersInit | (() => HeadersInit | Promise<HeadersInit>);
+    requestId?: () => RequestId;
+}
+export interface StartRunOptions extends CallOptions {
+    config?: RunStartConfig | null;
+    submissionId?: string | null;
+}
+export interface ReadEventsOptions extends CallOptions {
+    after?: EventCursor | null;
+    limit?: number | null;
+    waitMs?: number | null;
+}
+export type RunTerminalState = {
+    status: "completed";
+    event: SessionEventView;
+    output: ContentRefView | null;
+} | {
+    status: "failed";
+    event: SessionEventView;
+    message: string;
+} | {
+    status: "cancelled";
+    event: SessionEventView;
+};
+export interface AwaitRunOptions extends CallOptions {
+    after?: EventCursor | null;
+    limit?: number | null;
+    waitMs?: number | null;
+    heartbeat?: (cursor: EventCursor | null, page: AgentApiOutcomeOfSessionEventsReadResponse) => void | Promise<void>;
+    onEvent?: (event: SessionEventView) => void | Promise<void>;
+    onPage?: (page: AgentApiOutcomeOfSessionEventsReadResponse) => void | Promise<void>;
+}
+export interface AwaitRunResult {
+    state: RunTerminalState;
+    cursor: EventCursor;
+    page: AgentApiOutcomeOfSessionEventsReadResponse;
+}
+export declare class LightspeedClient implements RpcCaller {
+    private readonly endpoint;
+    private readonly fetchImpl;
+    private readonly headers;
+    private readonly requestId;
+    private nextNumericRequestId;
+    constructor(endpoint: string | URL);
+    constructor(options: LightspeedClientOptions);
+    call<M extends Method>(method: M, params: MethodParams<M>, options?: CallOptions): Promise<MethodResult<M>>;
+    startRun(sessionId: string, input: InputItem[], options?: StartRunOptions): Promise<AgentApiOutcomeOfRunStartResponse>;
+    startRunWithSource(sessionId: string, source: RunStartSource, options?: StartRunOptions): Promise<AgentApiOutcomeOfRunStartResponse>;
+    readEvents(sessionId: string, options?: ReadEventsOptions): Promise<AgentApiOutcomeOfSessionEventsReadResponse>;
+    awaitRun(sessionId: string, runId: string, options?: AwaitRunOptions): Promise<AwaitRunResult>;
+    private nextRequestId;
+    private buildHeaders;
+}
+export declare function generateSubmissionId(): string;
+//# 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,198 @@
+import { METHOD_INFO } from "./generated/methods.js";
+import { LightspeedRpcError, LightspeedTransportError } from "./errors.js";
+export class LightspeedClient {
+    endpoint;
+    fetchImpl;
+    headers;
+    requestId;
+    nextNumericRequestId = 1;
+    constructor(options) {
+        const resolved = typeof options === "string" || options instanceof URL ? { endpoint: options } : options;
+        const fetchImpl = resolved.fetch ?? globalThis.fetch;
+        if (!fetchImpl) {
+            throw new LightspeedTransportError("LightspeedClient requires a fetch implementation");
+        }
+        this.endpoint = resolved.endpoint.toString();
+        this.fetchImpl = fetchImpl;
+        this.headers = resolved.headers;
+        this.requestId = resolved.requestId;
+    }
+    async call(method, params, options = {}) {
+        const id = this.nextRequestId();
+        const headers = await this.buildHeaders(options.headers);
+        if (METHOD_INFO[method].scope === "connection" || METHOD_INFO[method].scope === "deployment") {
+            headers.delete("x-lightspeed-universe");
+        }
+        const init = {
+            method: "POST",
+            headers,
+            body: JSON.stringify({ id, method, params }),
+        };
+        if (options.signal) {
+            init.signal = options.signal;
+        }
+        let response;
+        try {
+            response = await this.fetchImpl(this.endpoint, init);
+        }
+        catch (error) {
+            throw new LightspeedTransportError(`Lightspeed API request failed: ${errorMessage(error)}`);
+        }
+        const body = await readJson(response);
+        if (!response.ok) {
+            throw new LightspeedTransportError(`Lightspeed API request failed with HTTP ${response.status}`, {
+                status: response.status,
+                body,
+            });
+        }
+        if (!isRecord(body)) {
+            throw new LightspeedTransportError("Lightspeed API response was not a JSON object", { body });
+        }
+        const rpcResponse = body;
+        if (rpcResponse.id !== undefined && rpcResponse.id !== id) {
+            throw new LightspeedTransportError("Lightspeed API response id did not match the request id", {
+                body,
+            });
+        }
+        if (rpcResponse.error) {
+            throw new LightspeedRpcError(rpcResponse.error);
+        }
+        if (!("result" in rpcResponse)) {
+            throw new LightspeedTransportError("Lightspeed API response was missing result", { body });
+        }
+        return rpcResponse.result;
+    }
+    startRun(sessionId, input, options = {}) {
+        return this.startRunWithSource(sessionId, { type: "input", items: input }, options);
+    }
+    startRunWithSource(sessionId, source, options = {}) {
+        const params = {
+            sessionId,
+            source,
+            submissionId: options.submissionId === undefined ? generateSubmissionId() : options.submissionId,
+        };
+        if ("config" in options) {
+            params.config = options.config ?? null;
+        }
+        return this.call("session/runs/start", params, options);
+    }
+    readEvents(sessionId, options = {}) {
+        const params = { sessionId };
+        if (options.after !== undefined) {
+            params.after = options.after;
+        }
+        if (options.limit !== undefined) {
+            params.limit = options.limit;
+        }
+        if (options.waitMs !== undefined) {
+            params.waitMs = options.waitMs;
+        }
+        return this.call("session/events/read", params, options);
+    }
+    async awaitRun(sessionId, runId, options = {}) {
+        let cursor = options.after ?? null;
+        for (;;) {
+            throwIfAborted(options.signal);
+            const readOptions = {
+                after: cursor,
+                waitMs: options.waitMs ?? 30_000,
+            };
+            if (options.limit !== undefined) {
+                readOptions.limit = options.limit;
+            }
+            if (options.signal) {
+                readOptions.signal = options.signal;
+            }
+            if (options.headers) {
+                readOptions.headers = options.headers;
+            }
+            const page = await this.readEvents(sessionId, readOptions);
+            await options.onPage?.(page);
+            for (const event of page.result.events ?? []) {
+                cursor = event.cursor;
+                await options.onEvent?.(event);
+                const state = terminalStateForRun(event, runId);
+                if (state) {
+                    await options.heartbeat?.(cursor, page);
+                    return { state, cursor, page };
+                }
+            }
+            cursor = page.result.nextCursor ?? page.result.headCursor ?? cursor;
+            await options.heartbeat?.(cursor, page);
+        }
+    }
+    nextRequestId() {
+        if (this.requestId) {
+            return this.requestId();
+        }
+        return this.nextNumericRequestId++;
+    }
+    async buildHeaders(callHeaders) {
+        const headers = new Headers();
+        headers.set("content-type", "application/json");
+        headers.set("accept", "application/json");
+        const defaultHeaders = typeof this.headers === "function" ? await this.headers() : this.headers;
+        appendHeaders(headers, defaultHeaders);
+        appendHeaders(headers, callHeaders);
+        return headers;
+    }
+}
+export function generateSubmissionId() {
+    if (globalThis.crypto?.randomUUID) {
+        return globalThis.crypto.randomUUID();
+    }
+    const bytes = new Uint8Array(16);
+    globalThis.crypto?.getRandomValues(bytes);
+    if (bytes.some((byte) => byte !== 0)) {
+        return Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
+    }
+    return `sub_${Date.now().toString(36)}_${Math.random().toString(36).slice(2)}`;
+}
+function terminalStateForRun(event, runId) {
+    const kind = event.kind;
+    switch (kind.type) {
+        case "runCompleted":
+            return kind.runId === runId
+                ? { status: "completed", event, output: kind.output ?? null }
+                : null;
+        case "runFailed":
+            return kind.runId === runId ? { status: "failed", event, message: kind.message } : null;
+        case "runCancelled":
+            return kind.runId === runId ? { status: "cancelled", event } : null;
+        default:
+            return null;
+    }
+}
+function appendHeaders(headers, values) {
+    if (!values) {
+        return;
+    }
+    new Headers(values).forEach((value, key) => headers.set(key, value));
+}
+async function readJson(response) {
+    const text = await response.text();
+    if (text.length === 0) {
+        return null;
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch (error) {
+        throw new LightspeedTransportError(`Lightspeed API response was not valid JSON: ${errorMessage(error)}`, {
+            status: response.status,
+            body: text,
+        });
+    }
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function throwIfAborted(signal) {
+    if (signal?.aborted) {
+        throw signal.reason instanceof Error ? signal.reason : new Error("operation aborted");
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAA4B,MAAM,aAAa,CAAC;AAmErG,MAAM,OAAO,gBAAgB;IACV,QAAQ,CAAS;IACjB,SAAS,CAAe;IACxB,OAAO,CAAqC;IAC5C,SAAS,CAAgC;IAClD,oBAAoB,GAAG,CAAC,CAAC;IAIjC,YAAY,OAA+C;QACzD,MAAM,QAAQ,GACZ,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,YAAY,GAAG,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QAC1F,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC;QACrD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,wBAAwB,CAAC,kDAAkD,CAAC,CAAC;QACzF,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAC7C,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,IAAI,CACR,MAAS,EACT,MAAuB,EACvB,UAAuB,EAAE;QAEzB,MAAM,EAAE,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACzD,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC,KAAK,KAAK,YAAY,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC,KAAK,KAAK,YAAY,EAAE,CAAC;YAC7F,OAAO,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC;QAC1C,CAAC;QACD,MAAM,IAAI,GAAgB;YACxB,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;SAC7C,CAAC;QACF,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC/B,CAAC;QAED,IAAI,QAAkB,CAAC;QACvB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,wBAAwB,CAAC,kCAAkC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC9F,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,wBAAwB,CAAC,2CAA2C,QAAQ,CAAC,MAAM,EAAE,EAAE;gBAC/F,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,IAAI;aACL,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,wBAAwB,CAAC,+CAA+C,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAChG,CAAC;QAED,MAAM,WAAW,GAAG,IAAuB,CAAC;QAC5C,IAAI,WAAW,CAAC,EAAE,KAAK,SAAS,IAAI,WAAW,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;YAC1D,MAAM,IAAI,wBAAwB,CAAC,yDAAyD,EAAE;gBAC5F,IAAI;aACL,CAAC,CAAC;QACL,CAAC;QACD,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;YACtB,MAAM,IAAI,kBAAkB,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAClD,CAAC;QACD,IAAI,CAAC,CAAC,QAAQ,IAAI,WAAW,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,wBAAwB,CAAC,4CAA4C,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7F,CAAC;QACD,OAAO,WAAW,CAAC,MAAyB,CAAC;IAC/C,CAAC;IAED,QAAQ,CACN,SAAiB,EACjB,KAAkB,EAClB,UAA2B,EAAE;QAE7B,OAAO,IAAI,CAAC,kBAAkB,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;IACtF,CAAC;IAED,kBAAkB,CAChB,SAAiB,EACjB,MAAsB,EACtB,UAA2B,EAAE;QAE7B,MAAM,MAAM,GAAmB;YAC7B,SAAS;YACT,MAAM;YACN,YAAY,EACV,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,oBAAoB,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY;SACrF,CAAC;QACF,IAAI,QAAQ,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC;QACzC,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED,UAAU,CACR,SAAiB,EACjB,UAA6B,EAAE;QAE/B,MAAM,MAAM,GAA4B,EAAE,SAAS,EAAE,CAAC;QACtD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC/B,CAAC;QACD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC/B,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACjC,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QACjC,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,SAAiB,EACjB,KAAa,EACb,UAA2B,EAAE;QAE7B,IAAI,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC;QACnC,SAAS,CAAC;YACR,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC/B,MAAM,WAAW,GAAsB;gBACrC,KAAK,EAAE,MAAM;gBACb,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,MAAM;aACjC,CAAC;YACF,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAChC,WAAW,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;YACpC,CAAC;YACD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnB,WAAW,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YACtC,CAAC;YACD,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBACpB,WAAW,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;YACxC,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;YAC3D,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;YAE7B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;gBAC7C,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;gBACtB,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;gBAC/B,MAAM,KAAK,GAAG,mBAAmB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;gBAChD,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;oBACxC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;gBACjC,CAAC;YACH,CAAC;YAED,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC;YACpE,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAEO,aAAa;QACnB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC;QAC1B,CAAC;QACD,OAAO,IAAI,CAAC,oBAAoB,EAAE,CAAC;IACrC,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,WAAoC;QAC7D,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;QAC1C,MAAM,cAAc,GAClB,OAAO,IAAI,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;QAC3E,aAAa,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QACvC,aAAa,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QACpC,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAED,MAAM,UAAU,oBAAoB;IAClC,IAAI,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;QAClC,OAAO,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;IACxC,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IACjC,UAAU,CAAC,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC;IAC1C,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC;QACrC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AACjF,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAuB,EAAE,KAAa;IACjE,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACxB,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,cAAc;YACjB,OAAO,IAAI,CAAC,KAAK,KAAK,KAAK;gBACzB,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI,EAAE;gBAC7D,CAAC,CAAC,IAAI,CAAC;QACX,KAAK,WAAW;YACd,OAAO,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC1F,KAAK,cAAc;YACjB,OAAO,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACtE;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,OAAgB,EAAE,MAA+B;IACtE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;IACT,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,QAAkB;IACxC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,wBAAwB,CAAC,+CAA+C,YAAY,CAAC,KAAK,CAAC,EAAE,EAAE;YACvG,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,IAAI,EAAE,IAAI;SACX,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,cAAc,CAAC,MAA+B;IACrD,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,CAAC,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACxF,CAAC;AACH,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,20 @@
+import type { AgentApiError, JsonRpcError as ApiJsonRpcError } from "./generated/types.js";
+export type JsonRpcErrorPayload = ApiJsonRpcError;
+export type LightspeedRpcErrorKind = "invalid_request" | "method_not_found" | "unauthenticated" | "forbidden" | "not_found" | "conflict" | "rejected" | "environment_not_ready" | "model_default_unset" | "internal" | "unknown";
+export declare function lightspeedRpcErrorKind(code: number): LightspeedRpcErrorKind;
+export declare class LightspeedRpcError extends Error {
+    readonly code: number;
+    readonly data: AgentApiError | null | undefined;
+    readonly kind: LightspeedRpcErrorKind;
+    readonly payload: JsonRpcErrorPayload;
+    constructor(payload: JsonRpcErrorPayload);
+}
+export declare class LightspeedTransportError extends Error {
+    readonly status: number | undefined;
+    readonly body: unknown | undefined;
+    constructor(message: string, options?: {
+        status?: number;
+        body?: unknown;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,IAAI,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE3F,MAAM,MAAM,mBAAmB,GAAG,eAAe,CAAC;AAElD,MAAM,MAAM,sBAAsB,GAC9B,iBAAiB,GACjB,kBAAkB,GAClB,iBAAiB,GACjB,WAAW,GACX,WAAW,GACX,UAAU,GACV,UAAU,GACV,uBAAuB,GACvB,qBAAqB,GACrB,UAAU,GACV,SAAS,CAAC;AAEd,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB,CAyB3E;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;gBAE1B,OAAO,EAAE,mBAAmB;CASzC;AAED,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;gBAEvB,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAO;CAO/E"}

package/dist/errors.js

@@ -0,0 +1,53 @@
+export function lightspeedRpcErrorKind(code) {
+    switch (code) {
+        case -32602:
+            return "invalid_request";
+        case -32601:
+            return "method_not_found";
+        case -32001:
+            return "unauthenticated";
+        case -32003:
+            return "forbidden";
+        case -32004:
+            return "not_found";
+        case -32009:
+            return "conflict";
+        case -32010:
+            return "rejected";
+        case -32012:
+            return "environment_not_ready";
+        case -32603:
+            return "internal";
+        case -32014:
+            return "model_default_unset";
+        default:
+            return "unknown";
+    }
+}
+export class LightspeedRpcError extends Error {
+    code;
+    data;
+    kind;
+    payload;
+    constructor(payload) {
+        super(payload.message);
+        this.name = "LightspeedRpcError";
+        this.code = payload.code;
+        this.data = payload.data;
+        this.kind = lightspeedRpcErrorKind(payload.code);
+        this.payload = payload;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+export class LightspeedTransportError extends Error {
+    status;
+    body;
+    constructor(message, options = {}) {
+        super(message);
+        this.name = "LightspeedTransportError";
+        this.status = options.status;
+        this.body = options.body;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAiBA,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,CAAC,KAAK;YACT,OAAO,iBAAiB,CAAC;QAC3B,KAAK,CAAC,KAAK;YACT,OAAO,kBAAkB,CAAC;QAC5B,KAAK,CAAC,KAAK;YACT,OAAO,iBAAiB,CAAC;QAC3B,KAAK,CAAC,KAAK;YACT,OAAO,WAAW,CAAC;QACrB,KAAK,CAAC,KAAK;YACT,OAAO,WAAW,CAAC;QACrB,KAAK,CAAC,KAAK;YACT,OAAO,UAAU,CAAC;QACpB,KAAK,CAAC,KAAK;YACT,OAAO,UAAU,CAAC;QACpB,KAAK,CAAC,KAAK;YACT,OAAO,uBAAuB,CAAC;QACjC,KAAK,CAAC,KAAK;YACT,OAAO,UAAU,CAAC;QACpB,KAAK,CAAC,KAAK;YACT,OAAO,qBAAqB,CAAC;QAC/B;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,IAAI,CAAS;IACb,IAAI,CAAmC;IACvC,IAAI,CAAyB;IAC7B,OAAO,CAAsB;IAEtC,YAAY,OAA4B;QACtC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACxC,MAAM,CAAqB;IAC3B,IAAI,CAAsB;IAEnC,YAAY,OAAe,EAAE,UAA+C,EAAE;QAC5E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;QACvC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF"}