@introspection-sdk/introspection-browser 0.5.4 → 0.5.6

package/dist/api/tasks.js

@@ -1,5 +1,4 @@
-import { cursorPaginate } from "@introspection-sdk/http";
-import { parseSse } from "./sse.js";
+import { RunHandle, TaskRunsClient, TasksClient as SharedTasksClient, } from "@introspection-sdk/http";
 function toTaskBody(params) {
     const { identity, metadata, ...rest } = params;
     const body = { ...rest };
@@ -10,137 +9,15 @@ function toTaskBody(params) {
         body.metadata = mergedMetadata;
     return body;
 }
-/** Live handle on a task's run: stream its events, collect text, cancel. */
-export class RunHandle {
-    task;
-    run;
-    runs;
-    constructor(task, run, runs) {
-        this.task = task;
-        this.run = run;
-        this.runs = runs;
-    }
-    stream() {
-        return this.runs.stream(this.run.task_id, this.run.id);
-    }
-    cancel() {
-        return this.runs.cancel(this.run.task_id, this.run.id);
-    }
-    /** Convenience: concatenate `data` from `text`/`message` SSE frames. */
-    async text() {
-        let out = "";
-        for await (const ev of this.stream()) {
-            if (ev.event === "text" || ev.event === "message")
-                out += ev.data;
-        }
-        return out;
-    }
-}
-export class TaskRunsClient {
-    http;
-    constructor(http) {
-        this.http = http;
-    }
-    async create(taskId, body) {
-        const res = await this.http.request({
-            method: "POST",
-            path: `/v1/tasks/${encodeURIComponent(taskId)}/runs`,
-            body,
-        });
-        return new RunHandle(null, res.run, this);
-    }
-    get(taskId, runId) {
-        return this.http.request({
-            method: "GET",
-            path: `/v1/tasks/${encodeURIComponent(taskId)}/runs/${encodeURIComponent(runId)}`,
-        });
-    }
-    cancel(taskId, runId) {
-        return this.http.request({
-            method: "POST",
-            path: `/v1/tasks/${encodeURIComponent(taskId)}/runs/${encodeURIComponent(runId)}/cancel`,
-        });
-    }
-    async *stream(taskId, runId) {
-        const res = await this.http.stream({
-            path: `/v1/tasks/${encodeURIComponent(taskId)}/runs/${encodeURIComponent(runId)}/stream`,
-        });
-        yield* parseSse(res);
-    }
-}
 /**
- * Cookie-authenticated `/v1/tasks` client. Mirrors the Node SDK's
- * `TasksApi` shape but is bound to a DP session cookie rather than a
- * bearer token, and lets the caller select the agent on create.
+ * Cookie-authenticated `/v1/tasks` client. The implementation is shared with
+ * Node's runner-bound task client; this browser subclass only adds the
+ * `identity -> metadata.identity` body mapping used by cookie-session calls.
  */
-export class TasksClient {
-    http;
-    runs;
+export class TasksClient extends SharedTasksClient {
     constructor(http) {
-        this.http = http;
-        this.runs = new TaskRunsClient(http);
-    }
-    /**
-     * Tasks matching `params`. `await` it for the first page (preserving
-     * the wire envelope's counts + `next` cursor), or `for await` it to
-     * stream every task across pages (fetched lazily — `limit` sets the
-     * page size, `next` the starting cursor; stop early to stop fetching).
-     *
-     * Mirrors the Node SDK's `TasksApi.list`, which is the source of truth
-     * for the `/v1/tasks` shape.
-     */
-    list(params) {
-        return cursorPaginate((next) => this.http.request({
-            method: "GET",
-            path: "/v1/tasks",
-            query: { ...params, next },
-        }), params?.next);
-    }
-    create(body) {
-        return this.http.request({
-            method: "POST",
-            path: "/v1/tasks",
-            body: toTaskBody(body),
-        });
-    }
-    get(taskId) {
-        return this.http.request({
-            method: "GET",
-            path: `/v1/tasks/${encodeURIComponent(taskId)}`,
-        });
-    }
-    update(taskId, body) {
-        return this.http.request({
-            method: "PATCH",
-            path: `/v1/tasks/${encodeURIComponent(taskId)}`,
-            body,
-        });
-    }
-    delete(taskId) {
-        return this.http.request({
-            method: "DELETE",
-            path: `/v1/tasks/${encodeURIComponent(taskId)}`,
-            expect: "empty",
-        });
-    }
-    archive(taskId) {
-        return this.http.request({
-            method: "POST",
-            path: `/v1/tasks/${encodeURIComponent(taskId)}/archive`,
-            expect: "empty",
-        });
-    }
-    unarchive(taskId) {
-        return this.http.request({
-            method: "POST",
-            path: `/v1/tasks/${encodeURIComponent(taskId)}/unarchive`,
-            expect: "empty",
-        });
-    }
-    /** Sugar: create a task + return a handle on its initial run. */
-    async start(params) {
-        const res = await this.create(params);
-        return new RunHandle(res.task, res.run, this.runs);
+        super(http, toTaskBody);
     }
 }
+export { RunHandle, TaskRunsClient };
 //# sourceMappingURL=tasks.js.map

package/dist/api/tasks.js.map

@@ -1 +1 @@
-{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../src/api/tasks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../src/api/tasks.ts"],"names":[],"mappings":"AACA,OAAO,EACL,SAAS,EACT,cAAc,EACd,WAAW,IAAI,iBAAiB,GAEjC,MAAM,yBAAyB,CAAC;AA0CjC,SAAS,UAAU,CAAC,MAAwB;IAC1C,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IAC/C,MAAM,IAAI,GAA4B,EAAE,GAAG,IAAI,EAAE,CAAC;IAClD,MAAM,cAAc,GAAG,QAAQ;QAC7B,CAAC,CAAC,EAAE,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE;QACnC,CAAC,CAAC,QAAQ,CAAC;IACb,IAAI,cAAc,KAAK,SAAS;QAAE,IAAI,CAAC,QAAQ,GAAG,cAAc,CAAC;IACjE,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,WAAY,SAAQ,iBAGhC;IACC,YAAY,IAAwB;QAClC,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC1B,CAAC;CACF;AAED,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@introspection-sdk/introspection-browser",
-  "version": "0.5.4",
+  "version": "0.5.6",
   "license": "Apache-2.0",
   "description": "Introspection observability SDK for the browser",
   "engines": {
@@ -31,8 +31,8 @@
     "@opentelemetry/api-logs": "^0.219.0",
     "@opentelemetry/sdk-logs": "^0.219.0",
     "@opentelemetry/exporter-logs-otlp-http": "^0.219.0",
-    "@introspection-sdk/http": "0.5.4",
-    "@introspection-sdk/types": "0.5.4"
+    "@introspection-sdk/types": "0.5.6",
+    "@introspection-sdk/http": "0.5.6"
   },
   "scripts": {
     "lint": "eslint . --max-warnings 0",

package/src/api/client.ts

@@ -2,17 +2,22 @@
  * Browser-side Introspection API client.
  *
  * Lets a single-page app create and stream Introspection tasks directly
- * from the browser, with no API key in JavaScript. The auth boundary:
+ * from the browser, with no API key in JavaScript. The browser talks only
+ * to the Data Plane — runtime resolution and any other Control Plane work
+ * stays on the app's backend, so the CP never needs to serve CORS to
+ * customer web origins. The auth boundary:
  *
- *   1. The SPA's own backend ("broker") mints an Introspection access
- *      token — via RFC 8693 token-exchange of the partner IdP token, a
- *      PKCE `authorization_code`, or `client_credentials`. The IdP
- *      secret never leaves the backend. The SPA fetches that token
- *      through the `getToken` callback.
+ *   1. The SPA's own backend ("broker") mints a short-lived Introspection
+ *      access token — via RFC 8693 token-exchange of the partner IdP
+ *      token, a PKCE `authorization_code`, or `client_credentials` (the
+ *      IdP secret never leaves the backend) — and, when a specific runtime
+ *      is needed, resolves its `runtime_id` server-side. The SPA fetches
+ *      the token through the `getToken` callback.
  *   2. `connect()` redeems the token at the DP `POST /v1/oauth/exchange`
  *      for the HttpOnly `intro_dp_session` cookie.
  *   3. Every subsequent call rides that cookie (`credentials: "include"`)
- *      — `client.tasks.start(...)`, `.get(...)`, run streaming, etc.
+ *      — `client.tasks.start({ runtime_id })`, `.get(...)`, run streaming,
+ *      etc.
  *
  * When the session cookie expires, an in-flight request gets a 401, and
  * the client transparently re-runs `getToken` + the DP exchange once
@@ -20,13 +25,26 @@
  */
 
 import { BrowserHttpClient, stripTrailingSlash, toApiError } from "./http.js";
+import {
+  ConversationsClient,
+  FilesClient,
+  SharesClient,
+} from "@introspection-sdk/http";
 import { TasksClient } from "./tasks.js";
-import { FilesClient } from "./files.js";
-import { ConversationsClient } from "./conversations.js";
-import { SharesClient } from "./shares.js";
+
+type CookieClients = {
+  tasks: TasksClient;
+  files: FilesClient;
+  conversations: ConversationsClient;
+  shares: SharesClient;
+};
 
 export interface IntrospectionApiClientOptions {
-  /** Data Plane REST base URL (e.g. `https://dp.us.introspection.dev`). */
+  /**
+   * Data Plane REST base URL for the cookie-session APIs (`connect()` and
+   * `client.tasks` / `client.files` / `client.conversations` /
+   * `client.shares`). Required — the browser only talks to the DP.
+   */
   dpUrl: string;
   /**
    * Returns a fresh Introspection access token from the app's broker
@@ -43,16 +61,8 @@ export interface IntrospectionApiClientOptions {
 }
 
 export class IntrospectionApiClient {
-  /** `/v1/tasks` operations bound to the DP session cookie. */
-  readonly tasks: TasksClient;
-  /** `/v1/files` operations bound to the DP session cookie. */
-  readonly files: FilesClient;
-  /** Read-only `/v1/conversations` projection bound to the session cookie. */
-  readonly conversations: ConversationsClient;
-  /** `/v1/shares` read-sharing grants bound to the session cookie. */
-  readonly shares: SharesClient;
-
   private readonly fetchImpl: typeof fetch;
+  private readonly cookieClients: CookieClients;
 
   constructor(private readonly opts: IntrospectionApiClientOptions) {
     this.fetchImpl = opts.fetch ?? globalThis.fetch;
@@ -61,16 +71,41 @@ export class IntrospectionApiClient {
         "global fetch is unavailable; pass `fetch` or run in a modern browser",
       );
     }
+    if (!opts.dpUrl) {
+      throw new Error("IntrospectionApiClient requires a dpUrl");
+    }
     const http = new BrowserHttpClient({
       apiUrl: opts.dpUrl,
       additionalHeaders: opts.additionalHeaders,
       fetch: opts.fetch,
       onUnauthorized: () => this.reexchange(),
     });
-    this.tasks = new TasksClient(http);
-    this.files = new FilesClient(http);
-    this.conversations = new ConversationsClient(http);
-    this.shares = new SharesClient(http);
+    this.cookieClients = {
+      tasks: new TasksClient(http),
+      files: new FilesClient(http),
+      conversations: new ConversationsClient(http),
+      shares: new SharesClient(http),
+    };
+  }
+
+  /** `/v1/tasks` operations bound to the DP session cookie. */
+  get tasks(): TasksClient {
+    return this.cookieClients.tasks;
+  }
+
+  /** `/v1/files` operations bound to the DP session cookie. */
+  get files(): FilesClient {
+    return this.cookieClients.files;
+  }
+
+  /** Read-only `/v1/conversations` projection bound to the session cookie. */
+  get conversations(): ConversationsClient {
+    return this.cookieClients.conversations;
+  }
+
+  /** `/v1/shares` read-sharing grants bound to the session cookie. */
+  get shares(): SharesClient {
+    return this.cookieClients.shares;
   }
 
   /**

package/src/api/index.ts

@@ -6,22 +6,30 @@
  * Separate from the package's default telemetry export so apps only pull
  * in what they use.
  *
+ * The browser talks only to the Data Plane. Resolving a runtime by name
+ * (a Control Plane call) stays on your backend, which hands the browser a
+ * short-lived access token plus the resolved `runtime_id`.
+ *
  * @example
  * ```typescript
  * import { IntrospectionApiClient } from "@introspection-sdk/introspection-browser/api";
  *
+ * // Your backend returns { token, runtimeId, dpUrl } — it mints the access
+ * // token, resolves the runtime id, and surfaces the DP URL (e.g. from the
+ * // Node SDK's serviceAccountToken response), so the browser never calls the CP.
+ * const { token, runtimeId, dpUrl } = await fetch(
+ *   "/api/introspection/session",
+ * ).then((r) => r.json());
+ *
  * const client = new IntrospectionApiClient({
- *   dpUrl: "https://dp.us.introspection.dev",
- *   // your backend mints the Introspection access token (the session's
- *   // project is derived from its claims — no projectId option needed)
- *   getToken: () => fetch("/api/introspection/token").then((r) => r.text()),
+ *   dpUrl,
+ *   getToken: () => token,
  * });
  *
- * await client.connect(); // → intro_dp_session cookie
+ * await client.connect(); // -> intro_dp_session cookie
  * const run = await client.tasks.start({
  *   prompt: "Summarize my latest order",
- *   agent_name: "support-agent",
- *   identity: { user_id: "u_42" },
+ *   runtime_id: runtimeId,
  * });
  * for await (const ev of run.stream()) console.log(ev.event, ev.data);
  * ```
@@ -39,15 +47,13 @@ export {
   type StartTaskParams,
 } from "./tasks.js";
 export {
-  FilesClient,
+  ConversationItemsClient,
+  ConversationsClient,
   FileVersionsClient,
+  FilesClient,
+  SharesClient,
   type FileUploadBody,
-} from "./files.js";
-export {
-  ConversationsClient,
-  ConversationItemsClient,
-} from "./conversations.js";
-export { SharesClient } from "./shares.js";
+} from "@introspection-sdk/http";
 export { BrowserHttpClient, type BrowserHttpConfig } from "./http.js";
 export { parseSse } from "./sse.js";
 export {
@@ -93,4 +99,5 @@ export {
   InsufficientScopeError,
   NotFoundError,
   NetworkError,
+  RunnerExpiredError,
 } from "@introspection-sdk/types";

package/src/api/tasks.ts

@@ -1,19 +1,10 @@
-import type {
-  Paginated,
-  RunIdentityInput,
-  SseEvent,
-  Task,
-  TaskCancelResponse,
-  TaskCreateResponse,
-  TaskListParams,
-  TaskRun,
-  TaskRunCreateParams,
-  TaskRunResponse,
-  TaskUpdateParams,
-} from "@introspection-sdk/types";
-import { Paginator, cursorPaginate } from "@introspection-sdk/http";
-import { BrowserHttpClient } from "./http.js";
-import { parseSse } from "./sse.js";
+import type { RunIdentityInput } from "@introspection-sdk/types";
+import {
+  RunHandle,
+  TaskRunsClient,
+  TasksClient as SharedTasksClient,
+  type ResourceHttpClient,
+} from "@introspection-sdk/http";
 
 /**
  * Body for creating a task directly against the DP from the browser.
@@ -65,149 +56,18 @@ function toTaskBody(params: CreateTaskParams): Record<string, unknown> {
   return body;
 }
 
-/** Live handle on a task's run: stream its events, collect text, cancel. */
-export class RunHandle {
-  constructor(
-    public readonly task: Task | null,
-    public readonly run: TaskRun,
-    private readonly runs: TaskRunsClient,
-  ) {}
-
-  stream(): AsyncIterable<SseEvent> {
-    return this.runs.stream(this.run.task_id, this.run.id);
-  }
-
-  cancel(): Promise<TaskCancelResponse> {
-    return this.runs.cancel(this.run.task_id, this.run.id);
-  }
-
-  /** Convenience: concatenate `data` from `text`/`message` SSE frames. */
-  async text(): Promise<string> {
-    let out = "";
-    for await (const ev of this.stream()) {
-      if (ev.event === "text" || ev.event === "message") out += ev.data;
-    }
-    return out;
-  }
-}
-
-export class TaskRunsClient {
-  constructor(private readonly http: BrowserHttpClient) {}
-
-  async create(taskId: string, body: TaskRunCreateParams): Promise<RunHandle> {
-    const res = await this.http.request<TaskRunResponse>({
-      method: "POST",
-      path: `/v1/tasks/${encodeURIComponent(taskId)}/runs`,
-      body,
-    });
-    return new RunHandle(null, res.run, this);
-  }
-
-  get(taskId: string, runId: string): Promise<TaskRun> {
-    return this.http.request<TaskRun>({
-      method: "GET",
-      path: `/v1/tasks/${encodeURIComponent(taskId)}/runs/${encodeURIComponent(runId)}`,
-    });
-  }
-
-  cancel(taskId: string, runId: string): Promise<TaskCancelResponse> {
-    return this.http.request<TaskCancelResponse>({
-      method: "POST",
-      path: `/v1/tasks/${encodeURIComponent(taskId)}/runs/${encodeURIComponent(runId)}/cancel`,
-    });
-  }
-
-  async *stream(taskId: string, runId: string): AsyncIterable<SseEvent> {
-    const res = await this.http.stream({
-      path: `/v1/tasks/${encodeURIComponent(taskId)}/runs/${encodeURIComponent(runId)}/stream`,
-    });
-    yield* parseSse(res);
-  }
-}
-
 /**
- * Cookie-authenticated `/v1/tasks` client. Mirrors the Node SDK's
- * `TasksApi` shape but is bound to a DP session cookie rather than a
- * bearer token, and lets the caller select the agent on create.
+ * Cookie-authenticated `/v1/tasks` client. The implementation is shared with
+ * Node's runner-bound task client; this browser subclass only adds the
+ * `identity -> metadata.identity` body mapping used by cookie-session calls.
  */
-export class TasksClient {
-  readonly runs: TaskRunsClient;
-
-  constructor(private readonly http: BrowserHttpClient) {
-    this.runs = new TaskRunsClient(http);
-  }
-
-  /**
-   * Tasks matching `params`. `await` it for the first page (preserving
-   * the wire envelope's counts + `next` cursor), or `for await` it to
-   * stream every task across pages (fetched lazily — `limit` sets the
-   * page size, `next` the starting cursor; stop early to stop fetching).
-   *
-   * Mirrors the Node SDK's `TasksApi.list`, which is the source of truth
-   * for the `/v1/tasks` shape.
-   */
-  list(params?: TaskListParams): Paginator<Task> {
-    return cursorPaginate(
-      (next) =>
-        this.http.request<Paginated<Task>>({
-          method: "GET",
-          path: "/v1/tasks",
-          query: { ...params, next } as Record<string, unknown>,
-        }),
-      params?.next,
-    );
-  }
-
-  create(body: CreateTaskParams): Promise<TaskCreateResponse> {
-    return this.http.request<TaskCreateResponse>({
-      method: "POST",
-      path: "/v1/tasks",
-      body: toTaskBody(body),
-    });
-  }
-
-  get(taskId: string): Promise<Task> {
-    return this.http.request<Task>({
-      method: "GET",
-      path: `/v1/tasks/${encodeURIComponent(taskId)}`,
-    });
-  }
-
-  update(taskId: string, body: TaskUpdateParams): Promise<Task> {
-    return this.http.request<Task>({
-      method: "PATCH",
-      path: `/v1/tasks/${encodeURIComponent(taskId)}`,
-      body,
-    });
-  }
-
-  delete(taskId: string): Promise<void> {
-    return this.http.request<void>({
-      method: "DELETE",
-      path: `/v1/tasks/${encodeURIComponent(taskId)}`,
-      expect: "empty",
-    });
-  }
-
-  archive(taskId: string): Promise<void> {
-    return this.http.request<void>({
-      method: "POST",
-      path: `/v1/tasks/${encodeURIComponent(taskId)}/archive`,
-      expect: "empty",
-    });
-  }
-
-  unarchive(taskId: string): Promise<void> {
-    return this.http.request<void>({
-      method: "POST",
-      path: `/v1/tasks/${encodeURIComponent(taskId)}/unarchive`,
-      expect: "empty",
-    });
-  }
-
-  /** Sugar: create a task + return a handle on its initial run. */
-  async start(params: StartTaskParams): Promise<RunHandle> {
-    const res = await this.create(params);
-    return new RunHandle(res.task, res.run, this.runs);
+export class TasksClient extends SharedTasksClient<
+  CreateTaskParams,
+  StartTaskParams
+> {
+  constructor(http: ResourceHttpClient) {
+    super(http, toTaskBody);
   }
 }
+
+export { RunHandle, TaskRunsClient };

package/dist/api/conversations.d.ts

@@ -1,84 +0,0 @@
-/**
- * Cookie-authenticated, read-only Conversations client for the browser
- * (`/v1/conversations`).
- *
- * Mirrors the Node SDK's runner-bound `ConversationsApi`, but rides the
- * DP `intro_dp_session` cookie via {@link BrowserHttpClient} instead of a
- * bearer token — so a single-page app reads conversation history with the
- * same identity session it uses for tasks and files. Conversations are a
- * projection over the immutable telemetry store: list summaries, walk a
- * conversation's items, or `retrieve()` the resolved state of one turn.
- */
-import type { ConversationItem, ConversationItemInclude, ConversationItemList, ConversationItemListParams, ConversationListParams, ConversationResponse, ConversationSummary } from "@introspection-sdk/types";
-import { Paginator } from "@introspection-sdk/http";
-import { BrowserHttpClient } from "./http.js";
-/**
- * Items of a conversation (`/v1/conversations/{id}/items`). Read-only.
- *
- * Paging is OpenAI-style underneath: the envelope has NO `next` token —
- * `list()` drives `after` = the previous page's `last_id` while
- * `has_more` is true.
- */
-export declare class ConversationItemsClient {
-    private readonly http;
-    constructor(http: BrowserHttpClient);
-    /**
-     * List items of a conversation. `await` the result for the first page
-     * (an OpenAI-style {@link ConversationItemList} envelope), or
-     * `for await` it to stream every item across pages (fetched lazily —
-     * `limit` sets the page size, `after` the starting cursor; stop early to
-     * stop fetching). Pass `order: "asc"` to walk the transcript from the
-     * start.
-     *
-     * Items carry the turn-local delta in `input_messages` — only the
-     * messages new to that turn. Use `get()` for the full input history.
-     */
-    list(conversationId: string, params?: ConversationItemListParams): Paginator<ConversationItem, ConversationItemList>;
-    /**
-     * Fetch a single conversation item. Unlike the list route, the
-     * detail's `input_messages` is the FULL input history for that span.
-     */
-    get(conversationId: string, itemId: string, params?: {
-        include?: ConversationItemInclude[];
-    }): Promise<ConversationItem>;
-}
-/**
- * Read-only Conversations client (`/v1/conversations`).
- *
- * Both `list()` and `items.list()` are auto-paging, but they drive
- * different wire protocols underneath: `list()` walks the standard
- * Introspection cursor envelope's opaque `next` token, while
- * `items.list()` walks an OpenAI-style envelope via `after` = the
- * previous page's `last_id` while `has_more` is true.
- */
-export declare class ConversationsClient {
-    private readonly http;
-    /** Items of a conversation — `conversations.items.list(...)` etc. */
-    readonly items: ConversationItemsClient;
-    constructor(http: BrowserHttpClient);
-    /**
-     * List conversation summaries matching `params`. `await` the result for
-     * the first page, or `for await` it to stream every summary across
-     * pages (fetched lazily — `limit` sets the page size, `next` the
-     * starting cursor; stop early to stop fetching).
-     */
-    list(params?: ConversationListParams): Paginator<ConversationSummary>;
-    /**
-     * Responses-API-style retrieve: load the state of a conversation as of
-     * one item — the full input history, output, system instructions, and
-     * tool definitions of that turn.
-     *
-     * When `itemId` is omitted, the latest LLM turn is used: the first
-     * item (in descending order) whose `node_type` is `"assistant"` or
-     * whose `operation_name` is `"chat"`, falling back to the first item
-     * with a non-null `output_message`. Returns `null` when the
-     * conversation has no items.
-     *
-     * For the full per-turn transcript instead, iterate
-     * `items.list(conversationId, { order: "asc" })`.
-     */
-    retrieve(conversationId: string, itemId?: string): Promise<ConversationResponse | null>;
-    /** Scan items in descending order for the most recent LLM turn. */
-    private findLatestTurnId;
-}
-//# sourceMappingURL=conversations.d.ts.map

package/dist/api/conversations.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"conversations.d.ts","sourceRoot":"","sources":["../../src/api/conversations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACpB,0BAA0B,EAC1B,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EAIpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,SAAS,EAAkB,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAS9C;;;;;;GAMG;AACH,qBAAa,uBAAuB;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,iBAAiB;IAEpD;;;;;;;;;;OAUG;IACH,IAAI,CACF,cAAc,EAAE,MAAM,EACtB,MAAM,CAAC,EAAE,0BAA0B,GAClC,SAAS,CAAC,gBAAgB,EAAE,oBAAoB,CAAC;IAiBpD;;;OAGG;IACH,GAAG,CACD,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,uBAAuB,EAAE,CAAA;KAAE,GAC/C,OAAO,CAAC,gBAAgB,CAAC;CAO7B;AAED;;;;;;;;GAQG;AACH,qBAAa,mBAAmB;IAIlB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,qEAAqE;IACrE,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;gBAEX,IAAI,EAAE,iBAAiB;IAIpD;;;;;OAKG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAAC,mBAAmB,CAAC;IAYrE;;;;;;;;;;;;;OAaG;IACG,QAAQ,CACZ,cAAc,EAAE,MAAM,EACtB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IA6BvC,mEAAmE;YACrD,gBAAgB;CAc/B"}