@seclai/sdk 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Seclai, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,67 @@
+# Seclai JavaScript SDK
+
+This is the official Seclai JavaScript SDK with TypeScript typings.
+
+## Install
+
+```bash
+npm install @seclai/sdk
+```
+
+## Usage
+
+```ts
+import { Seclai } from "@seclai/sdk";
+
+const client = new Seclai({ apiKey: process.env.SECLAI_API_KEY });
+
+const sources = await client.listSources();
+console.log(sources.pagination, sources.data);
+```
+
+### Upload a file
+
+```ts
+import { Seclai } from "@seclai/sdk";
+
+const client = new Seclai({ apiKey: process.env.SECLAI_API_KEY });
+
+const bytes = new TextEncoder().encode("hello");
+const upload = await client.uploadFileToSource("source_connection_id", {
+  file: bytes,
+  fileName: "hello.txt",
+  mimeType: "text/plain",
+  title: "Hello",
+});
+console.log(upload);
+```
+
+## Development
+
+### Base URL
+
+Set `SECLAI_API_URL` to point at a different API host (e.g., staging):
+
+```bash
+export SECLAI_API_URL="https://example.invalid"
+```
+
+### Install dependencies
+
+```bash
+npm install
+```
+
+### Type checking
+
+```bash
+npm run typecheck
+```
+
+### Build
+
+```bash
+npm run build
+```
+
+This also regenerates `src/openapi.ts` from `../seclai-python/openapi/seclai.openapi.json`.

package/dist/index.cjs

@@ -0,0 +1,369 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  SECLAI_API_URL: () => SECLAI_API_URL,
+  Seclai: () => Seclai,
+  SeclaiAPIStatusError: () => SeclaiAPIStatusError,
+  SeclaiAPIValidationError: () => SeclaiAPIValidationError,
+  SeclaiConfigurationError: () => SeclaiConfigurationError,
+  SeclaiError: () => SeclaiError
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/errors.ts
+var SeclaiError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "SeclaiError";
+  }
+};
+var SeclaiConfigurationError = class extends SeclaiError {
+  constructor(message) {
+    super(message);
+    this.name = "SeclaiConfigurationError";
+  }
+};
+var SeclaiAPIStatusError = class extends SeclaiError {
+  /** HTTP status code returned by the API. */
+  statusCode;
+  /** HTTP method used for the request. */
+  method;
+  /** Full request URL. */
+  url;
+  /** Best-effort response body text (if available). */
+  responseText;
+  constructor(opts) {
+    super(opts.message);
+    this.name = "SeclaiAPIStatusError";
+    this.statusCode = opts.statusCode;
+    this.method = opts.method;
+    this.url = opts.url;
+    this.responseText = opts.responseText;
+  }
+};
+var SeclaiAPIValidationError = class extends SeclaiAPIStatusError {
+  /** Parsed validation error payload (best-effort). */
+  validationError;
+  constructor(opts) {
+    super(opts);
+    this.name = "SeclaiAPIValidationError";
+    this.validationError = opts.validationError;
+  }
+};
+
+// src/client.ts
+var SECLAI_API_URL = "https://seclai.com";
+function getEnv(name) {
+  const p = globalThis?.process;
+  return p?.env?.[name];
+}
+function buildURL(baseUrl, path, query) {
+  const url = new URL(path, baseUrl);
+  if (query) {
+    for (const [key, value] of Object.entries(query)) {
+      if (value === void 0 || value === null) continue;
+      url.searchParams.set(key, String(value));
+    }
+  }
+  return url;
+}
+async function safeText(response) {
+  try {
+    return await response.clone().text();
+  } catch {
+    return void 0;
+  }
+}
+async function safeJson(response) {
+  try {
+    return await response.clone().json();
+  } catch {
+    return void 0;
+  }
+}
+var Seclai = class {
+  apiKey;
+  baseUrl;
+  apiKeyHeader;
+  defaultHeaders;
+  fetcher;
+  /**
+   * Create a new Seclai client.
+   *
+   * @param opts - Client configuration.
+   * @throws {@link SeclaiConfigurationError} If no API key is provided (and `SECLAI_API_KEY` is not set).
+   * @throws {@link SeclaiConfigurationError} If no `fetch` implementation is available.
+   */
+  constructor(opts = {}) {
+    const apiKey = opts.apiKey ?? getEnv("SECLAI_API_KEY");
+    if (!apiKey) {
+      throw new SeclaiConfigurationError(
+        "Missing API key. Provide apiKey or set SECLAI_API_KEY."
+      );
+    }
+    const fetcher = opts.fetch ?? globalThis.fetch;
+    if (!fetcher) {
+      throw new SeclaiConfigurationError(
+        "No fetch implementation available. Provide opts.fetch or run in an environment with global fetch."
+      );
+    }
+    this.apiKey = apiKey;
+    this.baseUrl = opts.baseUrl ?? getEnv("SECLAI_API_URL") ?? SECLAI_API_URL;
+    this.apiKeyHeader = opts.apiKeyHeader ?? "x-api-key";
+    this.defaultHeaders = { ...opts.defaultHeaders ?? {} };
+    this.fetcher = fetcher;
+  }
+  /**
+   * Make a raw HTTP request to the Seclai API.
+   *
+   * This is a low-level escape hatch. For most operations, prefer the typed convenience methods.
+   *
+   * @param method - HTTP method (e.g. `"GET"`, `"POST"`).
+   * @param path - Request path relative to `baseUrl` (e.g. `"/api/sources/"`).
+   * @param opts - Query params, JSON body, and per-request headers.
+   * @returns Parsed JSON for JSON responses, raw text for non-JSON responses, or `null` for empty bodies.
+   * @throws {@link SeclaiAPIValidationError} For validation errors (typically HTTP 422).
+   * @throws {@link SeclaiAPIStatusError} For other non-success HTTP status codes.
+   */
+  async request(method, path, opts) {
+    const url = buildURL(this.baseUrl, path, opts?.query);
+    const headers = {
+      ...this.defaultHeaders,
+      ...opts?.headers ?? {},
+      [this.apiKeyHeader]: this.apiKey
+    };
+    let body;
+    if (opts?.json !== void 0) {
+      headers["content-type"] = headers["content-type"] ?? "application/json";
+      body = JSON.stringify(opts.json);
+    }
+    const init = { method, headers };
+    if (body !== void 0) {
+      init.body = body;
+    }
+    const response = await this.fetcher(url, init);
+    if (response.status === 204) return null;
+    const contentType = response.headers.get("content-type") ?? "";
+    const isJson = contentType.includes("application/json");
+    if (!response.ok) {
+      const responseText = await safeText(response);
+      if (response.status === 422) {
+        const validation = await safeJson(response);
+        throw new SeclaiAPIValidationError({
+          message: "Validation error",
+          statusCode: response.status,
+          method,
+          url: url.toString(),
+          responseText,
+          validationError: validation
+        });
+      }
+      throw new SeclaiAPIStatusError({
+        message: `Request failed with status ${response.status}`,
+        statusCode: response.status,
+        method,
+        url: url.toString(),
+        responseText
+      });
+    }
+    if (!response.body) return null;
+    if (isJson) {
+      return await response.json();
+    }
+    return await response.text();
+  }
+  /**
+   * Run an agent.
+   *
+   * @param agentId - Agent identifier.
+   * @param body - Agent run request payload.
+   * @returns The created agent run.
+   */
+  async runAgent(agentId, body) {
+    const data = await this.request("POST", `/api/agents/${agentId}/runs`, { json: body });
+    return data;
+  }
+  /**
+   * List agent runs for an agent.
+   *
+   * @param agentId - Agent identifier.
+   * @param opts - Pagination options.
+   * @returns A paginated list of runs.
+   */
+  async listAgentRuns(agentId, opts = {}) {
+    const data = await this.request("GET", `/api/agents/${agentId}/runs`, {
+      query: { page: opts.page ?? 1, limit: opts.limit ?? 50 }
+    });
+    return data;
+  }
+  /**
+   * Get details of a specific agent run.
+   *
+   * @param agentId - Agent identifier.
+   * @param runId - Run identifier.
+   * @returns Agent run details.
+   */
+  async getAgentRun(agentId, runId) {
+    const data = await this.request("GET", `/api/agents/${agentId}/runs/${runId}`);
+    return data;
+  }
+  /**
+   * Cancel an agent run.
+   *
+   * @param agentId - Agent identifier.
+   * @param runId - Run identifier.
+   * @returns Updated agent run record.
+   */
+  async deleteAgentRun(agentId, runId) {
+    const data = await this.request("DELETE", `/api/agents/${agentId}/runs/${runId}`);
+    return data;
+  }
+  /**
+   * Get content detail.
+   *
+   * Fetches a slice of a content version (use `start`/`end` to page through large content).
+   *
+   * @param sourceConnectionContentVersion - Content version identifier.
+   * @param opts - Range options.
+   * @returns Content details for the requested range.
+   */
+  async getContentDetail(sourceConnectionContentVersion, opts = {}) {
+    const data = await this.request(
+      "GET",
+      `/api/contents/${sourceConnectionContentVersion}`,
+      { query: { start: opts.start ?? 0, end: opts.end ?? 5e3 } }
+    );
+    return data;
+  }
+  /**
+   * Delete a specific content version.
+   *
+   * @param sourceConnectionContentVersion - Content version identifier.
+   */
+  async deleteContent(sourceConnectionContentVersion) {
+    await this.request("DELETE", `/api/contents/${sourceConnectionContentVersion}`);
+  }
+  /**
+   * List embeddings for a content version.
+   *
+   * @param sourceConnectionContentVersion - Content version identifier.
+   * @param opts - Pagination options.
+   * @returns A paginated list of embeddings.
+   */
+  async listContentEmbeddings(sourceConnectionContentVersion, opts = {}) {
+    const data = await this.request(
+      "GET",
+      `/api/contents/${sourceConnectionContentVersion}/embeddings`,
+      { query: { page: opts.page ?? 1, limit: opts.limit ?? 20 } }
+    );
+    return data;
+  }
+  /**
+   * List sources.
+   *
+   * @param opts - Pagination and filter options.
+   * @returns A paginated list of sources.
+   */
+  async listSources(opts = {}) {
+    const data = await this.request("GET", "/api/sources/", {
+      query: {
+        page: opts.page ?? 1,
+        limit: opts.limit ?? 20,
+        sort: opts.sort ?? "created_at",
+        order: opts.order ?? "desc",
+        account_id: opts.accountId ?? void 0
+      }
+    });
+    return data;
+  }
+  /**
+   * Upload a file to a specific source connection.
+   *
+   * @param sourceConnectionId - Source connection identifier.
+   * @param opts - File payload and optional metadata.
+   * @param opts.file - File payload as a `Blob`, `Uint8Array`, or `ArrayBuffer`.
+   * @param opts.title - Optional title for the uploaded file.
+   * @param opts.fileName - Optional filename to send with the upload.
+   * @param opts.mimeType - Optional MIME type to attach to the upload.
+   * @returns Upload response details.
+   */
+  async uploadFileToSource(sourceConnectionId, opts) {
+    const url = buildURL(this.baseUrl, `/api/sources/${sourceConnectionId}/upload`);
+    const headers = {
+      ...this.defaultHeaders,
+      [this.apiKeyHeader]: this.apiKey
+    };
+    const form = new FormData();
+    let blob;
+    if (opts.file instanceof Blob) {
+      blob = opts.file;
+    } else if (opts.file instanceof ArrayBuffer) {
+      const blobOpts = opts.mimeType ? { type: opts.mimeType } : void 0;
+      blob = new Blob([new Uint8Array(opts.file)], blobOpts);
+    } else {
+      const blobOpts = opts.mimeType ? { type: opts.mimeType } : void 0;
+      blob = new Blob([opts.file], blobOpts);
+    }
+    const fileName = opts.fileName ?? "upload";
+    form.set("file", blob, fileName);
+    if (opts.title !== void 0) {
+      form.set("title", opts.title);
+    }
+    const response = await this.fetcher(url, {
+      method: "POST",
+      headers,
+      body: form
+    });
+    if (!response.ok) {
+      const responseText = await safeText(response);
+      if (response.status === 422) {
+        const validation = await safeJson(response);
+        throw new SeclaiAPIValidationError({
+          message: "Validation error",
+          statusCode: response.status,
+          method: "POST",
+          url: url.toString(),
+          responseText,
+          validationError: validation
+        });
+      }
+      throw new SeclaiAPIStatusError({
+        message: `Request failed with status ${response.status}`,
+        statusCode: response.status,
+        method: "POST",
+        url: url.toString(),
+        responseText
+      });
+    }
+    return await response.json();
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SECLAI_API_URL,
+  Seclai,
+  SeclaiAPIStatusError,
+  SeclaiAPIValidationError,
+  SeclaiConfigurationError,
+  SeclaiError
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/client.ts"],"sourcesContent":["export {\n  Seclai,\n  SECLAI_API_URL,\n  type SeclaiOptions,\n  type FetchLike,\n} from \"./client\";\n\nexport {\n  SeclaiError,\n  SeclaiConfigurationError,\n  SeclaiAPIStatusError,\n  SeclaiAPIValidationError,\n} from \"./errors\";\n\nexport type {\n  JSONValue,\n  AgentRunRequest,\n  AgentRunResponse,\n  AgentRunListResponse,\n  ContentDetailResponse,\n  ContentEmbeddingsListResponse,\n  SourceListResponse,\n  FileUploadResponse,\n  HTTPValidationError,\n} from \"./types\";\n","/** Base error class for the Seclai SDK. */\nexport class SeclaiError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"SeclaiError\";\n  }\n}\n\n/** Thrown when the SDK is misconfigured (for example, missing API key). */\nexport class SeclaiConfigurationError extends SeclaiError {\n  constructor(message: string) {\n    super(message);\n    this.name = \"SeclaiConfigurationError\";\n  }\n}\n\n/**\n * Thrown when the API returns a non-success status code.\n *\n * @remarks\n * Use {@link SeclaiAPIValidationError} for HTTP 422 validation errors.\n */\nexport class SeclaiAPIStatusError extends SeclaiError {\n  /** HTTP status code returned by the API. */\n  public readonly statusCode: number;\n  /** HTTP method used for the request. */\n  public readonly method: string;\n  /** Full request URL. */\n  public readonly url: string;\n  /** Best-effort response body text (if available). */\n  public readonly responseText: string | undefined;\n\n  constructor(opts: {\n    /** Human-readable error message. */\n    message: string;\n    statusCode: number;\n    method: string;\n    url: string;\n    responseText: string | undefined;\n  }) {\n    super(opts.message);\n    this.name = \"SeclaiAPIStatusError\";\n    this.statusCode = opts.statusCode;\n    this.method = opts.method;\n    this.url = opts.url;\n    this.responseText = opts.responseText;\n  }\n}\n\n/**\n * Thrown when the API returns a validation error response (typically HTTP 422).\n *\n * The `validationError` field contains the decoded validation payload when available.\n */\nexport class SeclaiAPIValidationError extends SeclaiAPIStatusError {\n  /** Parsed validation error payload (best-effort). */\n  public readonly validationError: unknown;\n\n  constructor(opts: {\n    message: string;\n    statusCode: number;\n    method: string;\n    url: string;\n    responseText: string | undefined;\n    validationError: unknown;\n  }) {\n    super(opts);\n    this.name = \"SeclaiAPIValidationError\";\n    this.validationError = opts.validationError;\n  }\n}\n","import {\n  SeclaiAPIStatusError,\n  SeclaiAPIValidationError,\n  SeclaiConfigurationError,\n} from \"./errors\";\nimport type {\n  AgentRunListResponse,\n  AgentRunRequest,\n  AgentRunResponse,\n  ContentDetailResponse,\n  ContentEmbeddingsListResponse,\n  FileUploadResponse,\n  HTTPValidationError,\n  SourceListResponse,\n} from \"./types\";\n\n/** Default API base URL (can be overridden with `baseUrl` or `SECLAI_API_URL`). */\nexport const SECLAI_API_URL = \"https://seclai.com\";\n\n/** A `fetch`-compatible function (e.g. `globalThis.fetch` or `undici.fetch`). */\nexport type FetchLike = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;\n\n/** Configuration for the {@link Seclai} client. */\nexport interface SeclaiOptions {\n  /** API key used for authentication. Defaults to `process.env.SECLAI_API_KEY` when available. */\n  apiKey?: string;\n  /** API base URL. Defaults to `process.env.SECLAI_API_URL` when available, else {@link SECLAI_API_URL}. */\n  baseUrl?: string;\n  /** Header name to use for the API key. Defaults to `x-api-key`. */\n  apiKeyHeader?: string;\n  /** Extra headers to include on every request. */\n  defaultHeaders?: Record<string, string>;\n  /** Optional `fetch` implementation for environments without a global `fetch`. */\n  fetch?: FetchLike;\n}\n\nfunction getEnv(name: string): string | undefined {\n  const p = (globalThis as any)?.process;\n  return p?.env?.[name];\n}\n\nfunction buildURL(baseUrl: string, path: string, query?: Record<string, unknown>): URL {\n  const url = new URL(path, baseUrl);\n  if (query) {\n    for (const [key, value] of Object.entries(query)) {\n      if (value === undefined || value === null) continue;\n      url.searchParams.set(key, String(value));\n    }\n  }\n  return url;\n}\n\nasync function safeText(response: Response): Promise<string | undefined> {\n  try {\n    return await response.clone().text();\n  } catch {\n    return undefined;\n  }\n}\n\nasync function safeJson(response: Response): Promise<unknown | undefined> {\n  try {\n    return await response.clone().json();\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Seclai JavaScript/TypeScript client.\n *\n * @remarks\n * - Uses API key auth via `x-api-key` by default.\n * - Throws SDK exceptions for non-success responses.\n */\nexport class Seclai {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly apiKeyHeader: string;\n  private readonly defaultHeaders: Record<string, string>;\n  private readonly fetcher: FetchLike;\n\n  /**\n   * Create a new Seclai client.\n   *\n   * @param opts - Client configuration.\n   * @throws {@link SeclaiConfigurationError} If no API key is provided (and `SECLAI_API_KEY` is not set).\n   * @throws {@link SeclaiConfigurationError} If no `fetch` implementation is available.\n   */\n  constructor(opts: SeclaiOptions = {}) {\n    const apiKey = opts.apiKey ?? getEnv(\"SECLAI_API_KEY\");\n    if (!apiKey) {\n      throw new SeclaiConfigurationError(\n        \"Missing API key. Provide apiKey or set SECLAI_API_KEY.\"\n      );\n    }\n\n    const fetcher = opts.fetch ?? (globalThis.fetch as FetchLike | undefined);\n    if (!fetcher) {\n      throw new SeclaiConfigurationError(\n        \"No fetch implementation available. Provide opts.fetch or run in an environment with global fetch.\"\n      );\n    }\n\n    this.apiKey = apiKey;\n    this.baseUrl = opts.baseUrl ?? getEnv(\"SECLAI_API_URL\") ?? SECLAI_API_URL;\n    this.apiKeyHeader = opts.apiKeyHeader ?? \"x-api-key\";\n    this.defaultHeaders = { ...(opts.defaultHeaders ?? {}) };\n    this.fetcher = fetcher;\n  }\n\n  /**\n   * Make a raw HTTP request to the Seclai API.\n   *\n   * This is a low-level escape hatch. For most operations, prefer the typed convenience methods.\n   *\n   * @param method - HTTP method (e.g. `\"GET\"`, `\"POST\"`).\n   * @param path - Request path relative to `baseUrl` (e.g. `\"/api/sources/\"`).\n   * @param opts - Query params, JSON body, and per-request headers.\n   * @returns Parsed JSON for JSON responses, raw text for non-JSON responses, or `null` for empty bodies.\n   * @throws {@link SeclaiAPIValidationError} For validation errors (typically HTTP 422).\n   * @throws {@link SeclaiAPIStatusError} For other non-success HTTP status codes.\n   */\n  async request(\n    method: string,\n    path: string,\n    opts?: {\n      query?: Record<string, unknown>;\n      json?: unknown;\n      headers?: Record<string, string>;\n    }\n  ): Promise<unknown | string | null> {\n    const url = buildURL(this.baseUrl, path, opts?.query);\n\n    const headers: Record<string, string> = {\n      ...this.defaultHeaders,\n      ...(opts?.headers ?? {}),\n      [this.apiKeyHeader]: this.apiKey,\n    };\n\n    let body: BodyInit | undefined;\n    if (opts?.json !== undefined) {\n      headers[\"content-type\"] = headers[\"content-type\"] ?? \"application/json\";\n      body = JSON.stringify(opts.json);\n    }\n\n    const init: RequestInit = { method, headers };\n    if (body !== undefined) {\n      init.body = body;\n    }\n    const response = await this.fetcher(url, init);\n\n    if (response.status === 204) return null;\n\n    const contentType = response.headers.get(\"content-type\") ?? \"\";\n    const isJson = contentType.includes(\"application/json\");\n\n    if (!response.ok) {\n      const responseText = await safeText(response);\n      if (response.status === 422) {\n        const validation = (await safeJson(response)) as HTTPValidationError | undefined;\n        throw new SeclaiAPIValidationError({\n          message: \"Validation error\",\n          statusCode: response.status,\n          method,\n          url: url.toString(),\n          responseText,\n          validationError: validation,\n        });\n      }\n      throw new SeclaiAPIStatusError({\n        message: `Request failed with status ${response.status}`,\n        statusCode: response.status,\n        method,\n        url: url.toString(),\n        responseText,\n      });\n    }\n\n    if (!response.body) return null;\n\n    if (isJson) {\n      return (await response.json()) as unknown;\n    }\n    return await response.text();\n  }\n\n  /**\n   * Run an agent.\n   *\n   * @param agentId - Agent identifier.\n   * @param body - Agent run request payload.\n   * @returns The created agent run.\n   */\n  async runAgent(agentId: string, body: AgentRunRequest): Promise<AgentRunResponse> {\n    const data = await this.request(\"POST\", `/api/agents/${agentId}/runs`, { json: body });\n    return data as AgentRunResponse;\n  }\n\n  /**\n   * List agent runs for an agent.\n   *\n   * @param agentId - Agent identifier.\n   * @param opts - Pagination options.\n   * @returns A paginated list of runs.\n   */\n  async listAgentRuns(\n    agentId: string,\n    opts: { page?: number; limit?: number } = {}\n  ): Promise<AgentRunListResponse> {\n    const data = await this.request(\"GET\", `/api/agents/${agentId}/runs`, {\n      query: { page: opts.page ?? 1, limit: opts.limit ?? 50 },\n    });\n    return data as AgentRunListResponse;\n  }\n\n  /**\n   * Get details of a specific agent run.\n   *\n   * @param agentId - Agent identifier.\n   * @param runId - Run identifier.\n   * @returns Agent run details.\n   */\n  async getAgentRun(agentId: string, runId: string): Promise<AgentRunResponse> {\n    const data = await this.request(\"GET\", `/api/agents/${agentId}/runs/${runId}`);\n    return data as AgentRunResponse;\n  }\n\n  /**\n   * Cancel an agent run.\n   *\n   * @param agentId - Agent identifier.\n   * @param runId - Run identifier.\n   * @returns Updated agent run record.\n   */\n  async deleteAgentRun(agentId: string, runId: string): Promise<AgentRunResponse> {\n    const data = await this.request(\"DELETE\", `/api/agents/${agentId}/runs/${runId}`);\n    return data as AgentRunResponse;\n  }\n\n  /**\n   * Get content detail.\n   *\n   * Fetches a slice of a content version (use `start`/`end` to page through large content).\n   *\n   * @param sourceConnectionContentVersion - Content version identifier.\n   * @param opts - Range options.\n   * @returns Content details for the requested range.\n   */\n  async getContentDetail(\n    sourceConnectionContentVersion: string,\n    opts: { start?: number; end?: number } = {}\n  ): Promise<ContentDetailResponse> {\n    const data = await this.request(\n      \"GET\",\n      `/api/contents/${sourceConnectionContentVersion}`,\n      { query: { start: opts.start ?? 0, end: opts.end ?? 5000 } }\n    );\n    return data as ContentDetailResponse;\n  }\n\n  /**\n   * Delete a specific content version.\n   *\n   * @param sourceConnectionContentVersion - Content version identifier.\n   */\n  async deleteContent(sourceConnectionContentVersion: string): Promise<void> {\n    await this.request(\"DELETE\", `/api/contents/${sourceConnectionContentVersion}`);\n  }\n\n  /**\n   * List embeddings for a content version.\n   *\n   * @param sourceConnectionContentVersion - Content version identifier.\n   * @param opts - Pagination options.\n   * @returns A paginated list of embeddings.\n   */\n  async listContentEmbeddings(\n    sourceConnectionContentVersion: string,\n    opts: { page?: number; limit?: number } = {}\n  ): Promise<ContentEmbeddingsListResponse> {\n    const data = await this.request(\n      \"GET\",\n      `/api/contents/${sourceConnectionContentVersion}/embeddings`,\n      { query: { page: opts.page ?? 1, limit: opts.limit ?? 20 } }\n    );\n    return data as ContentEmbeddingsListResponse;\n  }\n\n  /**\n   * List sources.\n   *\n   * @param opts - Pagination and filter options.\n   * @returns A paginated list of sources.\n   */\n  async listSources(\n    opts: {\n      page?: number;\n      limit?: number;\n      sort?: string;\n      order?: \"asc\" | \"desc\";\n      accountId?: string | null;\n    } = {}\n  ): Promise<SourceListResponse> {\n    const data = await this.request(\"GET\", \"/api/sources/\", {\n      query: {\n        page: opts.page ?? 1,\n        limit: opts.limit ?? 20,\n        sort: opts.sort ?? \"created_at\",\n        order: opts.order ?? \"desc\",\n        account_id: opts.accountId ?? undefined,\n      },\n    });\n    return data as SourceListResponse;\n  }\n\n  /**\n   * Upload a file to a specific source connection.\n   *\n   * @param sourceConnectionId - Source connection identifier.\n   * @param opts - File payload and optional metadata.\n   * @param opts.file - File payload as a `Blob`, `Uint8Array`, or `ArrayBuffer`.\n   * @param opts.title - Optional title for the uploaded file.\n   * @param opts.fileName - Optional filename to send with the upload.\n   * @param opts.mimeType - Optional MIME type to attach to the upload.\n   * @returns Upload response details.\n   */\n  async uploadFileToSource(\n    sourceConnectionId: string,\n    opts: {\n      file: Blob | Uint8Array | ArrayBuffer;\n      title?: string;\n      fileName?: string;\n      mimeType?: string;\n    }\n  ): Promise<FileUploadResponse> {\n    const url = buildURL(this.baseUrl, `/api/sources/${sourceConnectionId}/upload`);\n\n    const headers: Record<string, string> = {\n      ...this.defaultHeaders,\n      [this.apiKeyHeader]: this.apiKey,\n    };\n\n    const form = new FormData();\n\n    let blob: Blob;\n    if (opts.file instanceof Blob) {\n      blob = opts.file;\n    } else if (opts.file instanceof ArrayBuffer) {\n      const blobOpts = opts.mimeType ? { type: opts.mimeType } : undefined;\n      blob = new Blob([new Uint8Array(opts.file)], blobOpts);\n    } else {\n      const blobOpts = opts.mimeType ? { type: opts.mimeType } : undefined;\n      blob = new Blob([opts.file as unknown as BlobPart], blobOpts);\n    }\n\n    const fileName = opts.fileName ?? \"upload\";\n    form.set(\"file\", blob, fileName);\n\n    if (opts.title !== undefined) {\n      form.set(\"title\", opts.title);\n    }\n\n    const response = await this.fetcher(url, {\n      method: \"POST\",\n      headers,\n      body: form,\n    });\n\n    if (!response.ok) {\n      const responseText = await safeText(response);\n      if (response.status === 422) {\n        const validation = (await safeJson(response)) as HTTPValidationError | undefined;\n        throw new SeclaiAPIValidationError({\n          message: \"Validation error\",\n          statusCode: response.status,\n          method: \"POST\",\n          url: url.toString(),\n          responseText,\n          validationError: validation,\n        });\n      }\n      throw new SeclaiAPIStatusError({\n        message: `Request failed with status ${response.status}`,\n        statusCode: response.status,\n        method: \"POST\",\n        url: url.toString(),\n        responseText,\n      });\n    }\n\n    return (await response.json()) as FileUploadResponse;\n  }\n}\n"],"mappings":"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","names":[]}