@introspection-sdk/introspection-node 0.5.4 → 0.5.5

package/src/runner-resources/files.ts

@@ -1,162 +0,0 @@
-import type {
-  File as FileResource,
-  FileCreateTextParams,
-  FileListParams,
-  FileType,
-  FileUpdateParams,
-  ListParams,
-  Paginated,
-} from "@introspection-sdk/types";
-import { HttpClient } from "../http.js";
-import { Paginator, cursorPaginate } from "../pagination.js";
-
-export type FileUploadBody =
-  | { file: Blob; name?: string; file_type?: FileType }
-  | {
-      file: Uint8Array;
-      name: string;
-      file_type?: FileType;
-      contentType?: string;
-    };
-
-export class FileVersionsApi {
-  constructor(private readonly http: HttpClient) {}
-
-  /**
-   * List versions of a file. `await` the result for the first page, or
-   * `for await` it to stream every version across pages (fetched lazily;
-   * stop early to stop fetching).
-   */
-  list(fileId: string, params?: ListParams): Paginator<FileResource> {
-    return cursorPaginate(
-      (next) =>
-        this.http.request<Paginated<FileResource>>({
-          method: "GET",
-          path: `/v1/files/${encodeURIComponent(fileId)}/versions`,
-          query: { ...params, next } as Record<string, unknown>,
-        }),
-      params?.next,
-    );
-  }
-
-  get(fileId: string, versionId: string): Promise<FileResource> {
-    return this.http.request<FileResource>({
-      method: "GET",
-      path: `/v1/files/${encodeURIComponent(fileId)}/versions/${encodeURIComponent(versionId)}`,
-    });
-  }
-
-  create(fileId: string, body: FileUploadBody): Promise<FileResource> {
-    const form = toFormData(body);
-    return this.http.request<FileResource>({
-      method: "POST",
-      path: `/v1/files/${encodeURIComponent(fileId)}/versions`,
-      body: form,
-    });
-  }
-}
-
-export class FilesApi {
-  readonly versions: FileVersionsApi;
-
-  constructor(private readonly http: HttpClient) {
-    this.versions = new FileVersionsApi(http);
-  }
-
-  /**
-   * List files matching `params`. `await` the result for the first page,
-   * or `for await` it to stream every file across pages (fetched lazily —
-   * `limit` sets the page size, `next` the starting cursor; stop early to
-   * stop fetching).
-   */
-  list(params?: FileListParams): Paginator<FileResource> {
-    return cursorPaginate(
-      (next) =>
-        this.http.request<Paginated<FileResource>>({
-          method: "GET",
-          path: "/v1/files",
-          query: { ...params, next } as Record<string, unknown>,
-        }),
-      params?.next,
-    );
-  }
-
-  upload(body: FileUploadBody): Promise<FileResource> {
-    const form = toFormData(body);
-    return this.http.request<FileResource>({
-      method: "POST",
-      path: "/v1/files",
-      body: form,
-    });
-  }
-
-  createText(body: FileCreateTextParams): Promise<FileResource> {
-    return this.http.request<FileResource>({
-      method: "POST",
-      path: "/v1/files",
-      body,
-    });
-  }
-
-  get(fileId: string): Promise<FileResource> {
-    return this.http.request<FileResource>({
-      method: "GET",
-      path: `/v1/files/${encodeURIComponent(fileId)}`,
-    });
-  }
-
-  update(fileId: string, body: FileUpdateParams): Promise<FileResource> {
-    return this.http.request<FileResource>({
-      method: "PATCH",
-      path: `/v1/files/${encodeURIComponent(fileId)}`,
-      body,
-    });
-  }
-
-  delete(fileId: string): Promise<void> {
-    return this.http.request<void>({
-      method: "DELETE",
-      path: `/v1/files/${encodeURIComponent(fileId)}`,
-      expect: "empty",
-    });
-  }
-
-  download(fileId: string): Promise<Uint8Array> {
-    return this.http.request<Uint8Array>({
-      method: "GET",
-      path: `/v1/files/${encodeURIComponent(fileId)}/content`,
-      expect: "bytes",
-    });
-  }
-
-  downloadStream(fileId: string): Promise<ReadableStream<Uint8Array>> {
-    return this.http.request<ReadableStream<Uint8Array>>({
-      method: "GET",
-      path: `/v1/files/${encodeURIComponent(fileId)}/content`,
-      expect: "stream",
-    });
-  }
-}
-
-function toFormData(body: FileUploadBody): FormData {
-  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 as { file: Uint8Array }).file;
-    const ct =
-      (body as { contentType?: string }).contentType ??
-      "application/octet-stream";
-    const ab = u8.buffer.slice(
-      u8.byteOffset,
-      u8.byteOffset + u8.byteLength,
-    ) as ArrayBuffer;
-    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;
-}

package/src/runner-resources/shares.ts

@@ -1,62 +0,0 @@
-import type {
-  Paginated,
-  ResourceShare,
-  ShareCreateParams,
-  ShareListParams,
-} from "@introspection-sdk/types";
-import { HttpClient } from "../http.js";
-import { Paginator, cursorPaginate } from "../pagination.js";
-
-/**
- * Runner-bound Resource Shares API (`/v1/shares`).
- *
- * Read-sharing grants for files and conversations: `create` / `list` / `get` /
- * `delete` (revoke). A grant carries a `url` (with the `?share_id` capability)
- * for reading the shared resource. To fork a new task from a shared
- * conversation, pass `fork_share_id` to `runner.tasks.create(...)`.
- */
-export class SharesApi {
-  constructor(private readonly http: HttpClient) {}
-
-  /**
-   * List grants the caller created or that target them. `await` for the first
-   * page, or `for await` to stream every grant across pages.
-   */
-  list(params?: ShareListParams): Paginator<ResourceShare> {
-    return cursorPaginate(
-      (next) =>
-        this.http.request<Paginated<ResourceShare>>({
-          method: "GET",
-          path: "/v1/shares",
-          query: { ...params, next } as Record<string, unknown>,
-        }),
-      params?.next,
-    );
-  }
-
-  /** Create a read-sharing grant. The caller must own the target resource. */
-  create(body: ShareCreateParams): Promise<ResourceShare> {
-    return this.http.request<ResourceShare>({
-      method: "POST",
-      path: "/v1/shares",
-      body,
-    });
-  }
-
-  /** Read a single grant (carries the `url` to the shared resource). */
-  get(shareId: string): Promise<ResourceShare> {
-    return this.http.request<ResourceShare>({
-      method: "GET",
-      path: `/v1/shares/${encodeURIComponent(shareId)}`,
-    });
-  }
-
-  /** Revoke a grant. Only the grantor (or an admin/owner) may revoke. */
-  delete(shareId: string): Promise<void> {
-    return this.http.request<void>({
-      method: "DELETE",
-      path: `/v1/shares/${encodeURIComponent(shareId)}`,
-      expect: "empty",
-    });
-  }
-}

package/src/runner-resources/tasks.ts

@@ -1,158 +0,0 @@
-import type {
-  Paginated,
-  SseEvent,
-  Task,
-  TaskCancelResponse,
-  TaskCreateParams,
-  TaskCreateResponse,
-  TaskListParams,
-  TaskRun,
-  TaskRunCreateParams,
-  TaskRunResponse,
-  TaskUpdateParams,
-} from "@introspection-sdk/types";
-import { HttpClient } from "../http.js";
-import { Paginator, cursorPaginate } from "../pagination.js";
-import { parseSse } from "../streaming.js";
-
-export interface StartParams extends TaskCreateParams {
-  prompt: string; // required for the cursor-style sugar
-}
-
-export class RunHandle {
-  constructor(
-    public readonly task: Task | null,
-    public readonly run: TaskRun,
-    private readonly runs: TaskRunsApi,
-  ) {}
-
-  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: collect `data` from `event: text`-style frames into a string. */
-  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 TaskRunsApi {
-  constructor(private readonly http: HttpClient) {}
-
-  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);
-  }
-}
-
-export class TasksApi {
-  readonly runs: TaskRunsApi;
-
-  constructor(private readonly http: HttpClient) {
-    this.runs = new TaskRunsApi(http);
-  }
-
-  /**
-   * List tasks matching `params`. `await` the result for the first page,
-   * 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).
-   */
-  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: TaskCreateParams): Promise<TaskCreateResponse> {
-    return this.http.request<TaskCreateResponse>({
-      method: "POST",
-      path: "/v1/tasks",
-      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",
-    });
-  }
-
-  /** Cursor-style sugar: create a task + return a handle on its initial run. */
-  async start(params: StartParams): Promise<RunHandle> {
-    const res = await this.create(params);
-    return new RunHandle(res.task, res.run, this.runs);
-  }
-}