@introspection-sdk/introspection-browser 0.5.2 → 0.5.4

package/src/api/index.ts

@@ -12,8 +12,8 @@
  *
  * const client = new IntrospectionApiClient({
  *   dpUrl: "https://dp.us.introspection.dev",
- *   projectId: "proj_…",
- *   // your backend mints the Introspection access token
+ *   // 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()),
  * });
  *
@@ -38,6 +38,16 @@ export {
   type CreateTaskParams,
   type StartTaskParams,
 } from "./tasks.js";
+export {
+  FilesClient,
+  FileVersionsClient,
+  type FileUploadBody,
+} from "./files.js";
+export {
+  ConversationsClient,
+  ConversationItemsClient,
+} from "./conversations.js";
+export { SharesClient } from "./shares.js";
 export { BrowserHttpClient, type BrowserHttpConfig } from "./http.js";
 export { parseSse } from "./sse.js";
 export {
@@ -51,7 +61,6 @@ export type {
   Task,
   TaskRun,
   TaskStatus,
-  TaskVisibility,
   TaskCreateResponse,
   TaskListParams,
   TaskUpdateParams,
@@ -60,6 +69,23 @@ export type {
   RunIdentityInput,
   Paginated,
   SseEvent,
+  File,
+  FileType,
+  FileListParams,
+  FileUpdateParams,
+  FileCreateTextParams,
+  ListParams,
+  ConversationSummary,
+  ConversationItem,
+  ConversationItemList,
+  ConversationListParams,
+  ConversationItemListParams,
+  ConversationItemInclude,
+  ConversationResponse,
+  ResourceShare,
+  ShareResourceType,
+  ShareCreateParams,
+  ShareListParams,
 } from "@introspection-sdk/types";
 export {
   IntrospectionAPIError,

package/src/api/shares.ts

@@ -0,0 +1,65 @@
+/**
+ * Cookie-authenticated Resource Shares client for the browser (`/v1/shares`).
+ *
+ * Read-sharing grants for files and conversations: `create` / `list` / `get` /
+ * `delete` (revoke). A grant carries a `url` (with the `?share_id` capability) —
+ * read the shared resource via `client.files.get(id, { shareId })` or
+ * `client.conversations.items(id, { shareId })`. To fork a new task from a
+ * shared conversation, pass `fork_share_id` to `client.tasks.create(...)`.
+ */
+
+import type {
+  Paginated,
+  ResourceShare,
+  ShareCreateParams,
+  ShareListParams,
+} from "@introspection-sdk/types";
+import { Paginator, cursorPaginate } from "@introspection-sdk/http";
+import { BrowserHttpClient } from "./http.js";
+
+/** Cookie-authenticated `/v1/shares` client. */
+export class SharesClient {
+  constructor(private readonly http: BrowserHttpClient) {}
+
+  /**
+   * 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/api/tasks.ts

@@ -10,7 +10,6 @@ import type {
   TaskRunCreateParams,
   TaskRunResponse,
   TaskUpdateParams,
-  TaskVisibility,
 } from "@introspection-sdk/types";
 import { Paginator, cursorPaginate } from "@introspection-sdk/http";
 import { BrowserHttpClient } from "./http.js";
@@ -34,7 +33,6 @@ export interface CreateTaskParams {
   agent_name?: string;
   title?: string;
   metadata?: Record<string, unknown>;
-  visibility?: TaskVisibility;
   /**
    * Override the interactive idle window (seconds) before the sandbox is
    * torn down. `0` tears down as soon as it's provisioned; omit to use the
@@ -43,6 +41,13 @@ export interface CreateTaskParams {
   idle_timeout_seconds?: number;
   /** Caller identity for attribution; merged into `metadata.identity`. */
   identity?: RunIdentityInput;
+  /**
+   * Fork from a shared conversation: the `/v1/shares` grant id for the source
+   * conversation. Its presence makes this create a fork — the server seeds the
+   * new task with that conversation's history, read via the share (the
+   * permissions boundary).
+   */
+  fork_share_id?: string;
 }
 
 export interface StartTaskParams extends CreateTaskParams {