@introspection-sdk/introspection-browser 0.5.4 → 0.5.5

package/dist/api/runner.js

@@ -0,0 +1,87 @@
+import { RunnerExpiredError, } from "@introspection-sdk/types";
+import { ConversationsClient, FilesClient, SharesClient, TasksClient, } from "@introspection-sdk/http";
+import { BrowserBearerHttpClient } from "./http.js";
+/**
+ * Browser-side live handle to a Data Plane runner. Mirrors the Node Runner
+ * shape but uses browser-safe fetch transport and CP-minted bearer tokens.
+ */
+export class BrowserRunner {
+    owner;
+    source;
+    spec;
+    http;
+    closed = false;
+    tasks;
+    files;
+    conversations;
+    shares;
+    constructor(owner, source, spec) {
+        this.owner = owner;
+        this.source = source;
+        this.spec = spec;
+        this.http = this.buildHttp(spec);
+        const guarded = this.guardedHttp();
+        this.tasks = new TasksClient(guarded);
+        this.files = new FilesClient(guarded);
+        this.conversations = new ConversationsClient(guarded);
+        this.shares = new SharesClient(guarded);
+    }
+    get dpEndpoint() {
+        return this.spec.deployment.endpoint;
+    }
+    get deployment() {
+        return Object.freeze({ ...this.spec.deployment });
+    }
+    get expires_at() {
+        return this.spec.expires_at;
+    }
+    get session_id() {
+        return this.spec.session_id;
+    }
+    get context() {
+        return Object.freeze({ ...this.spec.runtime_context });
+    }
+    get isClosed() {
+        return this.closed;
+    }
+    async refresh() {
+        this.assertOpen();
+        const fresh = await this.owner.requestFreshRunnerSpec(this.source);
+        this.spec = fresh;
+        this.http = this.buildHttp(fresh);
+    }
+    async close() {
+        this.closed = true;
+    }
+    buildHttp(spec) {
+        return new BrowserBearerHttpClient({
+            apiUrl: spec.deployment.endpoint,
+            token: spec.session_token,
+            additionalHeaders: this.owner.additionalHeaders,
+            fetch: this.owner.fetch,
+        });
+    }
+    guardedHttp() {
+        const proxy = Object.create(this.http);
+        proxy.request = async (opts) => {
+            this.assertOpen();
+            return this.http.request(opts);
+        };
+        proxy.stream = async (opts) => {
+            this.assertOpen();
+            return this.http.stream(opts);
+        };
+        return proxy;
+    }
+    assertOpen() {
+        if (this.closed) {
+            throw new RunnerExpiredError({
+                message: "Runner has been closed",
+                status: 401,
+                code: "runner_expired",
+            });
+        }
+    }
+}
+export { BrowserRunner as Runner };
+//# sourceMappingURL=runner.js.map

package/dist/api/runner.js.map

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

package/dist/api/runtimes.d.ts

@@ -0,0 +1,12 @@
+import { RuntimeHandle, RuntimesClient, isUuid, type RuntimeHandleFactory, type RuntimeRunRequestBody } from "@introspection-sdk/http";
+import type { BrowserApiHttpClient } from "./http.js";
+import { BrowserRunner, type BrowserRunnerOwner } from "./runner.js";
+export { isUuid };
+export type { RuntimeRunRequestBody as BrowserRuntimeRunRequestBody };
+export declare class BrowserRuntimesClient extends RuntimesClient<BrowserRunner> {
+    constructor(http: BrowserApiHttpClient, owner: BrowserRunnerOwner);
+}
+export { RuntimeHandle as BrowserRuntimeHandle };
+export type BrowserRuntimeHandleFactory = RuntimeHandleFactory<BrowserRunner>;
+export declare function attachBrowserRuntimes(http: BrowserApiHttpClient, owner: BrowserRunnerOwner): BrowserRuntimesClient & BrowserRuntimeHandleFactory;
+//# sourceMappingURL=runtimes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtimes.d.ts","sourceRoot":"","sources":["../../src/api/runtimes.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,cAAc,EAEd,MAAM,EACN,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC3B,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAErE,OAAO,EAAE,MAAM,EAAE,CAAC;AAClB,YAAY,EAAE,qBAAqB,IAAI,4BAA4B,EAAE,CAAC;AAEtE,qBAAa,qBAAsB,SAAQ,cAAc,CAAC,aAAa,CAAC;gBAC1D,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,kBAAkB;CAGlE;AAED,OAAO,EAAE,aAAa,IAAI,oBAAoB,EAAE,CAAC;AAEjD,MAAM,MAAM,2BAA2B,GAAG,oBAAoB,CAAC,aAAa,CAAC,CAAC;AAE9E,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,oBAAoB,EAC1B,KAAK,EAAE,kBAAkB,GACxB,qBAAqB,GAAG,2BAA2B,CAIrD"}

package/dist/api/runtimes.js

@@ -0,0 +1,14 @@
+import { RuntimeHandle, RuntimesClient, attachRuntimes, isUuid, } from "@introspection-sdk/http";
+import { BrowserRunner } from "./runner.js";
+export { isUuid };
+export class BrowserRuntimesClient extends RuntimesClient {
+    constructor(http, owner) {
+        super(http, (source, spec) => new BrowserRunner(owner, source, spec));
+    }
+}
+export { RuntimeHandle as BrowserRuntimeHandle };
+export function attachBrowserRuntimes(http, owner) {
+    const api = new BrowserRuntimesClient(http, owner);
+    return attachRuntimes(api);
+}
+//# sourceMappingURL=runtimes.js.map

package/dist/api/runtimes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimes.js","sourceRoot":"","sources":["../../src/api/runtimes.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,cAAc,EACd,cAAc,EACd,MAAM,GAGP,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,aAAa,EAA2B,MAAM,aAAa,CAAC;AAErE,OAAO,EAAE,MAAM,EAAE,CAAC;AAGlB,MAAM,OAAO,qBAAsB,SAAQ,cAA6B;IACtE,YAAY,IAA0B,EAAE,KAAyB;QAC/D,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IACxE,CAAC;CACF;AAED,OAAO,EAAE,aAAa,IAAI,oBAAoB,EAAE,CAAC;AAIjD,MAAM,UAAU,qBAAqB,CACnC,IAA0B,EAC1B,KAAyB;IAEzB,MAAM,GAAG,GAAG,IAAI,qBAAqB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACnD,OAAO,cAAc,CAAC,GAAG,CACI,CAAC;AAChC,CAAC"}

package/dist/api/tasks.d.ts

@@ -1,6 +1,5 @@
-import type { RunIdentityInput, SseEvent, Task, TaskCancelResponse, TaskCreateResponse, TaskListParams, TaskRun, TaskRunCreateParams, TaskUpdateParams } from "@introspection-sdk/types";
-import { Paginator } from "@introspection-sdk/http";
-import { BrowserHttpClient } from "./http.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.
  *
@@ -39,51 +38,13 @@ export interface StartTaskParams extends CreateTaskParams {
     /** Required for the `start()` sugar that returns a run handle. */
     prompt: string;
 }
-/** Live handle on a task's run: stream its events, collect text, cancel. */
-export declare class RunHandle {
-    readonly task: Task | null;
-    readonly run: TaskRun;
-    private readonly runs;
-    constructor(task: Task | null, run: TaskRun, runs: TaskRunsClient);
-    stream(): AsyncIterable<SseEvent>;
-    cancel(): Promise<TaskCancelResponse>;
-    /** Convenience: concatenate `data` from `text`/`message` SSE frames. */
-    text(): Promise<string>;
-}
-export declare class TaskRunsClient {
-    private readonly http;
-    constructor(http: BrowserHttpClient);
-    create(taskId: string, body: TaskRunCreateParams): Promise<RunHandle>;
-    get(taskId: string, runId: string): Promise<TaskRun>;
-    cancel(taskId: string, runId: string): Promise<TaskCancelResponse>;
-    stream(taskId: string, runId: string): AsyncIterable<SseEvent>;
-}
 /**
- * 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 declare class TasksClient {
-    private readonly http;
-    readonly runs: TaskRunsClient;
-    constructor(http: BrowserHttpClient);
-    /**
-     * 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>;
-    create(body: CreateTaskParams): Promise<TaskCreateResponse>;
-    get(taskId: string): Promise<Task>;
-    update(taskId: string, body: TaskUpdateParams): Promise<Task>;
-    delete(taskId: string): Promise<void>;
-    archive(taskId: string): Promise<void>;
-    unarchive(taskId: string): Promise<void>;
-    /** Sugar: create a task + return a handle on its initial run. */
-    start(params: StartTaskParams): Promise<RunHandle>;
+export declare class TasksClient extends SharedTasksClient<CreateTaskParams, StartTaskParams> {
+    constructor(http: ResourceHttpClient);
 }
+export { RunHandle, TaskRunsClient };
 //# sourceMappingURL=tasks.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/api/tasks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/api/tasks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EACL,SAAS,EACT,cAAc,EACd,WAAW,IAAI,iBAAiB,EAChC,KAAK,kBAAkB,EACxB,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,wEAAwE;IACxE,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACvD,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;CAChB;AAYD;;;;GAIG;AACH,qBAAa,WAAY,SAAQ,iBAAiB,CAChD,gBAAgB,EAChB,eAAe,CAChB;gBACa,IAAI,EAAE,kBAAkB;CAGrC;AAED,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC"}

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.5",
   "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.5",
+    "@introspection-sdk/http": "0.5.5"
   },
   "scripts": {
     "lint": "eslint . --max-warnings 0",

package/src/api/client.ts

@@ -19,15 +19,47 @@
  * before retrying.
  */
 
-import { BrowserHttpClient, stripTrailingSlash, toApiError } from "./http.js";
+import {
+  BrowserBearerHttpClient,
+  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";
+import {
+  attachBrowserRuntimes,
+  type BrowserRuntimeHandleFactory,
+  type BrowserRuntimesClient,
+} from "./runtimes.js";
+import type { BrowserRunnerSource } from "./runner.js";
+import type { RunnerSpec } from "@introspection-sdk/types";
+
+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`). */
-  dpUrl: string;
+  /**
+   * Control Plane REST base URL. Used by `client.runtimes(name).run()` to
+   * resolve runtimes and mint runner specs. Defaults to
+   * `https://api.introspection.dev`.
+   */
+  cpUrl?: string;
+  /**
+   * Data Plane REST base URL for the cookie-session APIs (`connect()` and
+   * top-level `client.tasks` / `client.files` / `client.conversations` /
+   * `client.shares`). Runner APIs use the DP endpoint returned by CP and do
+   * not require this option.
+   */
+  dpUrl?: string;
   /**
    * Returns a fresh Introspection access token from the app's broker
    * (its own backend). Called on `connect()` and again whenever the DP
@@ -43,16 +75,15 @@ 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;
+  /**
+   * CRUD on CP `/v1/runtimes` and the `(idOrName) => RuntimeHandle` factory.
+   * Call as `client.runtimes("customer-agent").run()`.
+   */
+  readonly runtimes: BrowserRuntimesClient & BrowserRuntimeHandleFactory;
 
   private readonly fetchImpl: typeof fetch;
+  private readonly cpHttp: BrowserBearerHttpClient;
+  private readonly cookieClients: CookieClients | null;
 
   constructor(private readonly opts: IntrospectionApiClientOptions) {
     this.fetchImpl = opts.fetch ?? globalThis.fetch;
@@ -61,16 +92,53 @@ export class IntrospectionApiClient {
         "global fetch is unavailable; pass `fetch` or run in a modern browser",
       );
     }
-    const http = new BrowserHttpClient({
-      apiUrl: opts.dpUrl,
+    this.cpHttp = new BrowserBearerHttpClient({
+      apiUrl: opts.cpUrl ?? "https://api.introspection.dev",
+      token: opts.getToken,
       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.runtimes = attachBrowserRuntimes(this.cpHttp, {
+      additionalHeaders: opts.additionalHeaders,
+      fetch: opts.fetch,
+      requestFreshRunnerSpec: (source) => this.requestFreshRunnerSpec(source),
+    });
+    if (opts.dpUrl) {
+      const http = new BrowserHttpClient({
+        apiUrl: opts.dpUrl,
+        additionalHeaders: opts.additionalHeaders,
+        fetch: opts.fetch,
+        onUnauthorized: () => this.reexchange(),
+      });
+      this.cookieClients = {
+        tasks: new TasksClient(http),
+        files: new FilesClient(http),
+        conversations: new ConversationsClient(http),
+        shares: new SharesClient(http),
+      };
+    } else {
+      this.cookieClients = null;
+    }
+  }
+
+  /** `/v1/tasks` operations bound to the DP session cookie. */
+  get tasks(): TasksClient {
+    return this.requireCookieClient("tasks");
+  }
+
+  /** `/v1/files` operations bound to the DP session cookie. */
+  get files(): FilesClient {
+    return this.requireCookieClient("files");
+  }
+
+  /** Read-only `/v1/conversations` projection bound to the session cookie. */
+  get conversations(): ConversationsClient {
+    return this.requireCookieClient("conversations");
+  }
+
+  /** `/v1/shares` read-sharing grants bound to the session cookie. */
+  get shares(): SharesClient {
+    return this.requireCookieClient("shares");
   }
 
   /**
@@ -78,13 +146,15 @@ export class IntrospectionApiClient {
    * `intro_dp_session` cookie. Call once before issuing task requests.
    */
   async connect(): Promise<void> {
+    this.requireDpUrl();
     await this.exchange();
   }
 
   private async exchange(): Promise<void> {
+    const dpUrl = this.requireDpUrl();
     const token = await this.opts.getToken();
     const res = await this.fetchImpl(
-      `${stripTrailingSlash(this.opts.dpUrl)}/v1/oauth/exchange`,
+      `${stripTrailingSlash(dpUrl)}/v1/oauth/exchange`,
       {
         method: "POST",
         headers: {
@@ -107,4 +177,41 @@ export class IntrospectionApiClient {
       return false;
     }
   }
+
+  private requireCookieClient<K extends keyof CookieClients>(
+    key: K,
+  ): CookieClients[K] {
+    if (!this.cookieClients) {
+      throw new Error(
+        `IntrospectionApiClient.${key} requires dpUrl; use client.runtimes(...).run() for runner-bound APIs or pass dpUrl for cookie-session APIs`,
+      );
+    }
+    return this.cookieClients[key];
+  }
+
+  private requireDpUrl(): string {
+    if (!this.opts.dpUrl) {
+      throw new Error(
+        "IntrospectionApiClient.connect() requires dpUrl; use client.runtimes(...).run() for runner-bound APIs or pass dpUrl for cookie-session APIs",
+      );
+    }
+    return this.opts.dpUrl;
+  }
+
+  private async requestFreshRunnerSpec(
+    source: BrowserRunnerSource,
+  ): Promise<RunnerSpec> {
+    if (source.kind === "runtime") {
+      return this.cpHttp.request<RunnerSpec>({
+        method: "POST",
+        path: `/v1/runtimes/${encodeURIComponent(source.id)}/run`,
+        body: source.options ?? {},
+      });
+    }
+    return this.cpHttp.request<RunnerSpec>({
+      method: "POST",
+      path: `/v1/experiments/${encodeURIComponent(source.id)}/run`,
+      body: source.options ?? {},
+    });
+  }
 }

package/src/api/http.ts

@@ -35,6 +35,8 @@ export interface BrowserHttpConfig {
   onUnauthorized?: () => Promise<boolean>;
 }
 
+export type BrowserApiHttpClient = Pick<BaseHttpClient, "request" | "stream">;
+
 /**
  * Cookie-authenticated HTTP wrapper bound to one DP endpoint. Has no
  * opinion about which resource it serves — the caller picks the path.
@@ -53,3 +55,57 @@ export class BrowserHttpClient extends BaseHttpClient {
     });
   }
 }
+
+export interface BrowserBearerHttpConfig {
+  /** REST base URL every request is prefixed with. */
+  apiUrl: string;
+  /** Bearer token, or a provider returning the latest token before each request. */
+  token: string | (() => string | Promise<string>);
+  /** Extra headers merged into every request. */
+  additionalHeaders?: Record<string, string>;
+  /** Custom `fetch` (for tests or non-standard runtimes). */
+  fetch?: typeof fetch;
+}
+
+/**
+ * Bearer-authenticated browser HTTP wrapper. Used for CP runtime calls with
+ * brokered access tokens and for DP runner calls with CP-minted runner tokens.
+ */
+export class BrowserBearerHttpClient extends BaseHttpClient {
+  private readonly tokenBox: { value: string };
+  private readonly getToken?: () => string | Promise<string>;
+
+  constructor(cfg: BrowserBearerHttpConfig) {
+    const tokenBox = { value: typeof cfg.token === "string" ? cfg.token : "" };
+    super({
+      apiUrl: cfg.apiUrl,
+      additionalHeaders: cfg.additionalHeaders,
+      fetch: cfg.fetch,
+      transport: {
+        authHeaders: (): Record<string, string> => {
+          if (!tokenBox.value) return {};
+          return { Authorization: `Bearer ${tokenBox.value}` };
+        },
+      },
+    });
+    this.tokenBox = tokenBox;
+    this.getToken = typeof cfg.token === "function" ? cfg.token : undefined;
+  }
+
+  private async refreshToken(): Promise<void> {
+    if (!this.getToken) return;
+    this.tokenBox.value = await this.getToken();
+  }
+
+  async request<T>(opts: Parameters<BaseHttpClient["request"]>[0]): Promise<T> {
+    await this.refreshToken();
+    return super.request<T>(opts);
+  }
+
+  async stream(
+    opts: Parameters<BaseHttpClient["stream"]>[0],
+  ): Promise<Response> {
+    await this.refreshToken();
+    return super.stream(opts);
+  }
+}