@introspection-sdk/introspection-node 0.4.2 → 0.4.3

package/dist/runner-resources/files.js

@@ -0,0 +1,131 @@
+export class FileVersionsApi {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    list(fileId, params) {
+        return this.http.request({
+            method: "GET",
+            path: `/v1/files/${encodeURIComponent(fileId)}/versions`,
+            query: params,
+        });
+    }
+    async *listAll(fileId, params) {
+        let next = params?.next;
+        do {
+            const page = await this.list(fileId, { ...params, next });
+            for (const f of page.records)
+                yield f;
+            next = page.next ?? undefined;
+        } while (next);
+    }
+    get(fileId, versionId) {
+        return this.http.request({
+            method: "GET",
+            path: `/v1/files/${encodeURIComponent(fileId)}/versions/${encodeURIComponent(versionId)}`,
+        });
+    }
+    create(fileId, body) {
+        const form = toFormData(body);
+        return this.http.request({
+            method: "POST",
+            path: `/v1/files/${encodeURIComponent(fileId)}/versions`,
+            body: form,
+        });
+    }
+}
+export class FilesApi {
+    http;
+    versions;
+    constructor(http) {
+        this.http = http;
+        this.versions = new FileVersionsApi(http);
+    }
+    list(params) {
+        return this.http.request({
+            method: "GET",
+            path: "/v1/files",
+            query: params,
+        });
+    }
+    async *listAll(params) {
+        let next = params?.next;
+        do {
+            const page = await this.list({ ...params, next });
+            for (const f of page.records)
+                yield f;
+            next = page.next ?? undefined;
+        } while (next);
+    }
+    upload(body) {
+        const form = toFormData(body);
+        return this.http.request({
+            method: "POST",
+            path: "/v1/files",
+            body: form,
+        });
+    }
+    createText(body) {
+        return this.http.request({
+            method: "POST",
+            path: "/v1/files",
+            body,
+        });
+    }
+    get(fileId) {
+        return this.http.request({
+            method: "GET",
+            path: `/v1/files/${encodeURIComponent(fileId)}`,
+        });
+    }
+    update(fileId, body) {
+        return this.http.request({
+            method: "PATCH",
+            path: `/v1/files/${encodeURIComponent(fileId)}`,
+            body,
+        });
+    }
+    delete(fileId) {
+        return this.http.request({
+            method: "DELETE",
+            path: `/v1/files/${encodeURIComponent(fileId)}`,
+            expect: "empty",
+        });
+    }
+    download(fileId) {
+        return this.http.request({
+            method: "GET",
+            path: `/v1/files/${encodeURIComponent(fileId)}/content`,
+            expect: "bytes",
+        });
+    }
+    downloadStream(fileId) {
+        return this.http.request({
+            method: "GET",
+            path: `/v1/files/${encodeURIComponent(fileId)}/content`,
+            expect: "stream",
+        });
+    }
+}
+function toFormData(body) {
+    const fd = new FormData();
+    if ("file" in body && body.file instanceof Blob) {
+        fd.append("file", body.file, body.name);
+    }
+    else {
+        // Uint8Array branch — copy into a fresh ArrayBuffer so the Blob
+        // constructor sees a concrete ArrayBuffer (not ArrayBufferLike,
+        // which TS rejects under nodenext lib).
+        const u8 = body.file;
+        const ct = body.contentType ??
+            "application/octet-stream";
+        const ab = u8.buffer.slice(u8.byteOffset, u8.byteOffset + u8.byteLength);
+        fd.append("file", new Blob([ab], { type: ct }), body.name);
+    }
+    if (body.name)
+        fd.append("name", body.name);
+    if (body.file_type)
+        fd.append("file_type", body.file_type);
+    return fd;
+}
+//# sourceMappingURL=files.js.map

package/dist/runner-resources/files.js.map

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

package/dist/runner-resources/tasks.d.ts

@@ -0,0 +1,39 @@
+import type { Paginated, SseEvent, Task, TaskCancelResponse, TaskCreateParams, TaskCreateResponse, TaskListParams, TaskRun, TaskRunCreateParams, TaskUpdateParams } from "@introspection-sdk/types";
+import { HttpClient } from "../http.js";
+export interface StartParams extends TaskCreateParams {
+    prompt: string;
+}
+export declare class RunHandle {
+    readonly task: Task | null;
+    readonly run: TaskRun;
+    private readonly runs;
+    constructor(task: Task | null, run: TaskRun, runs: TaskRunsApi);
+    stream(): AsyncIterable<SseEvent>;
+    cancel(): Promise<TaskCancelResponse>;
+    /** Convenience: collect `data` from `event: text`-style frames into a string. */
+    text(): Promise<string>;
+}
+export declare class TaskRunsApi {
+    private readonly http;
+    constructor(http: HttpClient);
+    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>;
+}
+export declare class TasksApi {
+    private readonly http;
+    readonly runs: TaskRunsApi;
+    constructor(http: HttpClient);
+    list(params?: TaskListParams): Promise<Paginated<Task>>;
+    listAll(params?: TaskListParams): AsyncIterable<Task>;
+    create(body: TaskCreateParams): 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>;
+    /** Cursor-style sugar: create a task + return a handle on its initial run. */
+    start(params: StartParams): Promise<RunHandle>;
+}
+//# sourceMappingURL=tasks.d.ts.map

package/dist/runner-resources/tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/runner-resources/tasks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,QAAQ,EACR,IAAI,EACJ,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,OAAO,EACP,mBAAmB,EAEnB,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGxC,MAAM,WAAW,WAAY,SAAQ,gBAAgB;IACnD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,SAAS;aAEF,IAAI,EAAE,IAAI,GAAG,IAAI;aACjB,GAAG,EAAE,OAAO;IAC5B,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAFL,IAAI,EAAE,IAAI,GAAG,IAAI,EACjB,GAAG,EAAE,OAAO,EACX,IAAI,EAAE,WAAW;IAGpC,MAAM,IAAI,aAAa,CAAC,QAAQ,CAAC;IAIjC,MAAM,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAIrC,iFAAiF;IAC3E,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;CAO9B;AAED,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEvC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,CAAC;IAS3E,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOpD,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAO3D,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC;CAMtE;AAED,qBAAa,QAAQ;IAGP,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;gBAEE,IAAI,EAAE,UAAU;IAI7C,IAAI,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAQhD,OAAO,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,aAAa,CAAC,IAAI,CAAC;IAS5D,MAAM,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAQ3D,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ7D,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQrC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQtC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxC,8EAA8E;IACxE,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC;CAIrD"}

package/dist/runner-resources/tasks.js

@@ -0,0 +1,129 @@
+import { parseSse } from "../streaming.js";
+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: collect `data` from `event: text`-style frames into a string. */
+    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 TaskRunsApi {
+    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);
+    }
+}
+export class TasksApi {
+    http;
+    runs;
+    constructor(http) {
+        this.http = http;
+        this.runs = new TaskRunsApi(http);
+    }
+    list(params) {
+        return this.http.request({
+            method: "GET",
+            path: "/v1/tasks",
+            query: params,
+        });
+    }
+    async *listAll(params) {
+        let next = params?.next;
+        do {
+            const page = await this.list({ ...params, next });
+            for (const t of page.records)
+                yield t;
+            next = page.next ?? undefined;
+        } while (next);
+    }
+    create(body) {
+        return this.http.request({
+            method: "POST",
+            path: "/v1/tasks",
+            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",
+        });
+    }
+    /** Cursor-style 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);
+    }
+}
+//# sourceMappingURL=tasks.js.map

package/dist/runner-resources/tasks.js.map

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

package/dist/runner.d.ts

@@ -0,0 +1,80 @@
+import { type RunnerContext, type RunnerDeployment, type RunnerSpec, type RunRequest, type Uuid } from "@introspection-sdk/types";
+import { TasksApi } from "./runner-resources/tasks.js";
+import { FilesApi } from "./runner-resources/files.js";
+import type { IntrospectionClient } from "./client.js";
+/**
+ * Where this Runner came from, so `refresh()` can call CP again with the
+ * same arguments to obtain a fresh `RunnerSpec` (manual escape hatch only;
+ * not auto-scheduled).
+ */
+export type RunnerSource = {
+    kind: "runtime";
+    id: Uuid;
+    options?: RunRequest;
+} | {
+    kind: "experiment";
+    id: Uuid;
+    options?: RunRequest;
+};
+/**
+ * Live handle to a Data Plane sandbox. Holds the bearer JWT, the DP
+ * endpoint URL, and the runtime/experiment context, and exposes the
+ * runner-bound `tasks` and `files` namespaces.
+ *
+ * In v1 of the agent-session-based design, token refresh is handled
+ * server-side by the DP materializer attached to the agent session — the
+ * SDK does NOT auto-refresh and does NOT install a 401 safety-net. The
+ * `refresh()` method is kept as a manual escape hatch that re-calls the
+ * CP `/run` route to mint a brand-new spec.
+ */
+export declare class Runner {
+    private readonly client;
+    private readonly source;
+    private spec;
+    private http;
+    private closed;
+    readonly tasks: TasksApi;
+    readonly files: FilesApi;
+    constructor(client: IntrospectionClient, source: RunnerSource, spec: RunnerSpec);
+    /** DP REST base URL the runner is bound to. */
+    get dpEndpoint(): string;
+    /** Routing target — DP endpoint / slug / region. */
+    get deployment(): Readonly<RunnerDeployment>;
+    /** Session lifetime (ISO-8601 string). */
+    get expires_at(): string;
+    /** Session ID assigned by CP. */
+    get session_id(): string;
+    /** Resolved runtime / arm / recipe / identity / caller context. */
+    get context(): Readonly<RunnerContext>;
+    /** True once `close()` has been called. */
+    get isClosed(): boolean;
+    /**
+     * Manual escape hatch: re-call CP `/v1/runtimes/{id}/run` or
+     * `/v1/experiments/{id}/run` with the original `RunRequest` and replace
+     * this runner's in-memory spec with a fresh one.
+     *
+     * Not auto-scheduled — in v1 the DP materializer refreshes the
+     * underlying access token transparently for the agent-session-backed
+     * runner. Call this only if you have an explicit reason to mint a new
+     * session (e.g. you held a runner across a very long pause).
+     */
+    refresh(): Promise<void>;
+    /**
+     * Best-effort close — flips a local `isClosed` flag so subsequent
+     * `runner.tasks` / `runner.files` calls throw a friendly error. No
+     * server-side revoke is performed; future work will route a revoke via
+     * the CP locator-token path.
+     */
+    close(): Promise<void>;
+    private buildHttp;
+    /**
+     * Wrap an HttpClient so that calls after `close()` fail with a clear
+     * `RunnerExpiredError` instead of hitting the network with a stale
+     * bearer. No 401 retry / refresh logic — that is the DP materializer's
+     * job in v1.
+     */
+    private guardedHttp;
+    private assertOpen;
+    private requestFreshSpec;
+}
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,IAAI,EACV,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD;;;;GAIG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,UAAU,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,UAAU,CAAA;CAAE,CAAC;AAE3D;;;;;;;;;;GAUG;AACH,qBAAa,MAAM;IAUf,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAVzB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,MAAM,CAAS;IAGvB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;gBAGN,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE,YAAY,EACrC,IAAI,EAAE,UAAU;IAUlB,+CAA+C;IAC/C,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,oDAAoD;IACpD,IAAI,UAAU,IAAI,QAAQ,CAAC,gBAAgB,CAAC,CAE3C;IAED,0CAA0C;IAC1C,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,iCAAiC;IACjC,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,mEAAmE;IACnE,IAAI,OAAO,IAAI,QAAQ,CAAC,aAAa,CAAC,CAErC;IAED,2CAA2C;IAC3C,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAID;;;;;;;;;OASG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB9B;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B,OAAO,CAAC,SAAS;IAUjB;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAiBnB,OAAO,CAAC,UAAU;YAUJ,gBAAgB;CAgB/B"}

package/dist/runner.js

@@ -0,0 +1,159 @@
+import { RunnerExpiredError, } from "@introspection-sdk/types";
+import { HttpClient } from "./http.js";
+import { TasksApi } from "./runner-resources/tasks.js";
+import { FilesApi } from "./runner-resources/files.js";
+/**
+ * Live handle to a Data Plane sandbox. Holds the bearer JWT, the DP
+ * endpoint URL, and the runtime/experiment context, and exposes the
+ * runner-bound `tasks` and `files` namespaces.
+ *
+ * In v1 of the agent-session-based design, token refresh is handled
+ * server-side by the DP materializer attached to the agent session — the
+ * SDK does NOT auto-refresh and does NOT install a 401 safety-net. The
+ * `refresh()` method is kept as a manual escape hatch that re-calls the
+ * CP `/run` route to mint a brand-new spec.
+ */
+export class Runner {
+    client;
+    source;
+    spec;
+    http;
+    closed = false;
+    // Public API surfaces.
+    tasks;
+    files;
+    constructor(client, source, spec) {
+        this.client = client;
+        this.source = source;
+        this.spec = spec;
+        this.http = this.buildHttp();
+        this.tasks = new TasksApi(this.guardedHttp(this.http));
+        this.files = new FilesApi(this.guardedHttp(this.http));
+    }
+    // --- public accessors ---
+    /** DP REST base URL the runner is bound to. */
+    get dpEndpoint() {
+        return this.spec.deployment.endpoint;
+    }
+    /** Routing target — DP endpoint / slug / region. */
+    get deployment() {
+        return Object.freeze({ ...this.spec.deployment });
+    }
+    /** Session lifetime (ISO-8601 string). */
+    get expires_at() {
+        return this.spec.expires_at;
+    }
+    /** Session ID assigned by CP. */
+    get session_id() {
+        return this.spec.session_id;
+    }
+    /** Resolved runtime / arm / recipe / identity / caller context. */
+    get context() {
+        return Object.freeze({ ...this.spec.runtime_context });
+    }
+    /** True once `close()` has been called. */
+    get isClosed() {
+        return this.closed;
+    }
+    // --- lifecycle ---
+    /**
+     * Manual escape hatch: re-call CP `/v1/runtimes/{id}/run` or
+     * `/v1/experiments/{id}/run` with the original `RunRequest` and replace
+     * this runner's in-memory spec with a fresh one.
+     *
+     * Not auto-scheduled — in v1 the DP materializer refreshes the
+     * underlying access token transparently for the agent-session-backed
+     * runner. Call this only if you have an explicit reason to mint a new
+     * session (e.g. you held a runner across a very long pause).
+     */
+    async refresh() {
+        if (this.closed) {
+            throw new RunnerExpiredError({
+                message: "Runner has been closed",
+                status: 401,
+                code: "runner_expired",
+            });
+        }
+        const fresh = await this.requestFreshSpec();
+        this.spec = fresh;
+        // Note: we intentionally don't swap the underlying `http` here — the
+        // constructor-time bindings stay stable for the lifetime of the Runner.
+        // Callers wanting a freshly-bound Runner should call
+        // `client.runtimes(id).run(...)` again.
+    }
+    /**
+     * Best-effort close — flips a local `isClosed` flag so subsequent
+     * `runner.tasks` / `runner.files` calls throw a friendly error. No
+     * server-side revoke is performed; future work will route a revoke via
+     * the CP locator-token path.
+     */
+    async close() {
+        this.closed = true;
+    }
+    // --- internals ---
+    buildHttp() {
+        const advanced = this.client.advancedOptions;
+        return new HttpClient({
+            apiUrl: this.spec.deployment.endpoint,
+            token: this.spec.session_token,
+            additionalHeaders: advanced.additionalHeaders,
+            fetch: advanced.fetch,
+        });
+    }
+    /**
+     * Wrap an HttpClient so that calls after `close()` fail with a clear
+     * `RunnerExpiredError` instead of hitting the network with a stale
+     * bearer. No 401 retry / refresh logic — that is the DP materializer's
+     * job in v1.
+     */
+    guardedHttp(http) {
+        const proxy = Object.create(http);
+        proxy.request = async (opts) => {
+            this.assertOpen();
+            return http.request(opts);
+        };
+        proxy.stream = async (opts) => {
+            this.assertOpen();
+            return http.stream(opts);
+        };
+        return proxy;
+    }
+    assertOpen() {
+        if (this.closed) {
+            throw new RunnerExpiredError({
+                message: "Runner has been closed",
+                status: 401,
+                code: "runner_expired",
+            });
+        }
+    }
+    async requestFreshSpec() {
+        const http = this.client.cpHttp;
+        const body = toRunBody(this.source.options);
+        if (this.source.kind === "runtime") {
+            return await http.request({
+                method: "POST",
+                path: `/v1/runtimes/${encodeURIComponent(this.source.id)}/run`,
+                body,
+            });
+        }
+        return await http.request({
+            method: "POST",
+            path: `/v1/experiments/${encodeURIComponent(this.source.id)}/run`,
+            body,
+        });
+    }
+}
+function toRunBody(opts) {
+    if (!opts)
+        return {};
+    const out = {};
+    if (opts.identity)
+        out.identity = opts.identity;
+    if (opts.caller)
+        out.caller = opts.caller;
+    if (opts.ttl_seconds !== undefined)
+        out.ttl_seconds = opts.ttl_seconds;
+    return out;
+}
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

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

package/dist/streaming.d.ts

@@ -0,0 +1,8 @@
+import type { SseEvent } from "@introspection-sdk/types";
+/**
+ * Parse a `text/event-stream` Response into an async-iterable of SSE
+ * events. Minimal parser: handles `event:`, `data:` (multi-line),
+ * `id:`, `retry:`; ignores comments and unknown fields.
+ */
+export declare function parseSse(res: Response): AsyncIterable<SseEvent>;
+//# sourceMappingURL=streaming.d.ts.map

package/dist/streaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../src/streaming.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzD;;;;GAIG;AACH,wBAAuB,QAAQ,CAAC,GAAG,EAAE,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAC,CAiDtE"}

package/dist/streaming.js

@@ -0,0 +1,67 @@
+/**
+ * Parse a `text/event-stream` Response into an async-iterable of SSE
+ * events. Minimal parser: handles `event:`, `data:` (multi-line),
+ * `id:`, `retry:`; ignores comments and unknown fields.
+ */
+export async function* parseSse(res) {
+    if (!res.body)
+        return;
+    const reader = res.body.getReader();
+    const decoder = new TextDecoder();
+    let buf = "";
+    let event = "message";
+    let data = [];
+    let id;
+    let retry;
+    const flush = () => {
+        if (data.length === 0 && event === "message" && id === undefined)
+            return null;
+        const ev = { event, data: data.join("\n") };
+        if (id !== undefined)
+            ev.id = id;
+        if (retry !== undefined)
+            ev.retry = retry;
+        event = "message";
+        data = [];
+        id = undefined;
+        retry = undefined;
+        return ev;
+    };
+    while (true) {
+        const { value, done } = await reader.read();
+        if (done)
+            break;
+        buf += decoder.decode(value, { stream: true });
+        let nl;
+        while ((nl = buf.indexOf("\n")) >= 0) {
+            const line = buf.slice(0, nl).replace(/\r$/, "");
+            buf = buf.slice(nl + 1);
+            if (line === "") {
+                const ev = flush();
+                if (ev)
+                    yield ev;
+                continue;
+            }
+            if (line.startsWith(":"))
+                continue;
+            const colon = line.indexOf(":");
+            const field = colon < 0 ? line : line.slice(0, colon);
+            const valueRaw = colon < 0 ? "" : line.slice(colon + 1).replace(/^ /, "");
+            if (field === "event")
+                event = valueRaw;
+            else if (field === "data")
+                data.push(valueRaw);
+            else if (field === "id")
+                id = valueRaw;
+            else if (field === "retry") {
+                const n = Number(valueRaw);
+                if (Number.isFinite(n))
+                    retry = n;
+            }
+        }
+    }
+    const ev = flush();
+    if (ev)
+        yield ev;
+}
+//# sourceMappingURL=streaming.js.map

package/dist/streaming.js.map

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