openpond-sdk 0.0.5 → 0.0.7

package/dist/types/packages/sdk/src/workflows.d.ts

@@ -0,0 +1,121 @@
+export type OpenPondWorkflowWeekday = "sunday" | "monday" | "tuesday" | "wednesday" | "thursday" | "friday" | "saturday";
+export type OpenPondWorkflowRecurrence = {
+    version: 1;
+    kind: "once" | "daily" | "weekdays" | "weekly" | "monthly";
+    timeZone: string;
+    startDate: string;
+    localTime: string;
+    weekdays?: OpenPondWorkflowWeekday[];
+    dayOfMonth?: number;
+    end: {
+        kind: "never";
+    } | {
+        kind: "on_date";
+        date: string;
+    } | {
+        kind: "after_occurrences";
+        occurrences: number;
+    };
+};
+export type OpenPondWorkflowSchedule = {
+    id: string;
+    expression: string | null;
+    timeZone: string;
+    recurrence: OpenPondWorkflowRecurrence | null;
+    configurationVersion: number;
+    enabled: boolean;
+    nextRunAt: string | null;
+    lastTriggeredAt: string | null;
+    delivery: Record<string, unknown>;
+};
+export type OpenPondWorkflowDefinition = {
+    id: string;
+    definitionKey: string;
+    version: number;
+    name: string;
+    prompt: string;
+    modelId: string;
+    schedules: OpenPondWorkflowSchedule[];
+};
+export type OpenPondWorkflowRun = {
+    id: string;
+    definitionId: string;
+    scheduleId: string | null;
+    definitionName: string;
+    definitionVersion: number;
+    conversationId: string;
+    triggerKind: "manual" | "schedule" | "webhook" | "retry";
+    status: string;
+    notificationStatus: string;
+    deliveryStatus: string;
+    deliveryError: string | null;
+    createdAt: string;
+};
+export type OpenPondWorkflowCatalog = {
+    definitions: OpenPondWorkflowDefinition[];
+    runs: OpenPondWorkflowRun[];
+    asOf: string;
+};
+export type OpenPondWorkflowCreateInput = {
+    clientRequestId?: string;
+    sourceTurnId?: string | null;
+    name: string;
+    prompt: string;
+    recurrence: OpenPondWorkflowRecurrence;
+    modelId?: string;
+};
+export type OpenPondWorkflowCreateResult = {
+    created: boolean;
+    definitionId: string;
+    scheduleId: string;
+    name: string;
+    enabled: boolean;
+    nextRunAt: string | null;
+    recurrence: OpenPondWorkflowRecurrence | null;
+    timeZone: string;
+};
+export type OpenPondWorkflowUpdateInput = {
+    enabled: boolean;
+} | {
+    name: string;
+    prompt: string;
+    recurrence: OpenPondWorkflowRecurrence;
+};
+export type OpenPondWorkflowUpdateResult = {
+    definitionId?: string;
+    schedule: {
+        id: string;
+        enabled: boolean;
+        nextRunAt: string | null;
+    };
+};
+export type OpenPondWorkflowDeleteResult = {
+    schedule: {
+        id: string;
+        archived: true;
+    };
+};
+export type OpenPondWorkflowRunNowResult = {
+    runId: string;
+    conversationId: string;
+};
+export type OpenPondWorkflowRequestOptions = {
+    signal?: AbortSignal;
+};
+type WorkflowsClientInput = {
+    apiKey: string;
+    apiBaseUrl: string;
+};
+export declare class OpenPondWorkflowsClient {
+    #private;
+    constructor(input: WorkflowsClientInput);
+    list(options?: OpenPondWorkflowRequestOptions): Promise<OpenPondWorkflowCatalog>;
+    create(input: OpenPondWorkflowCreateInput, options?: OpenPondWorkflowRequestOptions): Promise<OpenPondWorkflowCreateResult>;
+    update(scheduleId: string, input: OpenPondWorkflowUpdateInput, options?: OpenPondWorkflowRequestOptions): Promise<OpenPondWorkflowUpdateResult>;
+    delete(scheduleId: string, options?: OpenPondWorkflowRequestOptions): Promise<OpenPondWorkflowDeleteResult>;
+    runNow(scheduleId: string, input?: {
+        clientRequestId?: string;
+    }, options?: OpenPondWorkflowRequestOptions): Promise<OpenPondWorkflowRunNowResult>;
+}
+export {};
+//# sourceMappingURL=workflows.d.ts.map

package/dist/types/packages/sdk/src/workflows.d.ts.map

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

package/dist/workflows.js

@@ -0,0 +1,244 @@
+// src/workflows.ts
+import { randomUUID } from "node:crypto";
+
+// ../cloud/dist/api/vercel-protection.js
+var VERCEL_PROTECTION_BYPASS_HEADER = "x-vercel-protection-bypass";
+function withVercelProtectionBypass(requestUrl, inputHeaders, env = typeof process === "undefined" ? {} : process.env) {
+  const headers = new Headers(inputHeaders);
+  const secret = env.VERCEL_AUTOMATION_BYPASS_SECRET?.trim();
+  if (!secret || !isOpenPondStagingUrl(requestUrl))
+    return headers;
+  headers.set(VERCEL_PROTECTION_BYPASS_HEADER, secret);
+  return headers;
+}
+function isOpenPondStagingUrl(requestUrl) {
+  try {
+    const hostname = new URL(requestUrl).hostname.toLowerCase();
+    return hostname === "staging.openpond.ai" || hostname === "staging-api.openpond.ai" || hostname.endsWith(".staging-api.openpond.ai");
+  } catch {
+    return false;
+  }
+}
+
+// ../cloud/dist/api/core.js
+var DEFAULT_API_TIMEOUT_MS = 3e4;
+var DEFAULT_API_RESPONSE_BYTES = 8 * 1024 * 1024;
+var LONG_STREAM_API_OPTIONS = { timeoutMs: 15 * 60 * 1e3, maxResponseBytes: 64 * 1024 * 1024 };
+var ApiTimeoutError = class extends Error {
+  timeoutMs;
+  requestUrl;
+  code = "OPENPOND_API_TIMEOUT";
+  constructor(timeoutMs, requestUrl) {
+    super(`API request timed out after ${timeoutMs}ms: ${requestUrl}`);
+    this.timeoutMs = timeoutMs;
+    this.requestUrl = requestUrl;
+    this.name = "ApiTimeoutError";
+  }
+};
+var ApiResponseTooLargeError = class extends Error {
+  maximumBytes;
+  requestUrl;
+  code = "OPENPOND_API_RESPONSE_TOO_LARGE";
+  constructor(maximumBytes, requestUrl) {
+    super(`API response exceeded ${maximumBytes} bytes: ${requestUrl}`);
+    this.maximumBytes = maximumBytes;
+    this.requestUrl = requestUrl;
+    this.name = "ApiResponseTooLargeError";
+  }
+};
+var OpenPondApiError = class extends Error {
+  status;
+  apiMessage;
+  code;
+  constructor(status, errorCode, label, apiMessage = null) {
+    const detail = apiMessage || errorCode;
+    super(`${label} failed: ${status}${detail ? ` ${detail}` : ""}`);
+    this.status = status;
+    this.apiMessage = apiMessage;
+    this.name = "OpenPondApiError";
+    this.code = errorCode || "OPENPOND_API_ERROR";
+  }
+};
+async function apiFetch(baseUrl, token, requestPath, options = {}) {
+  const { timeoutMs = DEFAULT_API_TIMEOUT_MS, maxResponseBytes = DEFAULT_API_RESPONSE_BYTES, ...init } = options;
+  const requestUrl = `${baseUrl}${requestPath}`;
+  const headers = withVercelProtectionBypass(requestUrl, init.headers);
+  headers.set("Content-Type", "application/json");
+  const apiKey = process.env.OPENPOND_API_KEY;
+  const trimmedToken = token?.trim() || "";
+  const tokenIsApiKey = trimmedToken.startsWith("opk_");
+  const effectiveApiKey = apiKey || (tokenIsApiKey ? trimmedToken : null);
+  if (effectiveApiKey && !headers.has("openpond-api-key"))
+    headers.set("openpond-api-key", effectiveApiKey);
+  if (token) {
+    headers.set("Authorization", tokenIsApiKey ? `ApiKey ${trimmedToken}` : `Bearer ${token}`);
+  } else if (apiKey && !headers.has("Authorization")) {
+    headers.set("Authorization", `ApiKey ${apiKey}`);
+  }
+  const timeoutController = new AbortController();
+  const timeoutError = new ApiTimeoutError(timeoutMs, requestUrl);
+  const timer = timeoutMs > 0 ? setTimeout(() => timeoutController.abort(timeoutError), timeoutMs) : null;
+  timer?.unref?.();
+  const signal = composedSignal(init.signal, timeoutController.signal, timeoutMs);
+  const cleanup = () => {
+    if (timer)
+      clearTimeout(timer);
+  };
+  try {
+    const response = await fetch(requestUrl, { ...init, headers, signal });
+    return boundedResponse(response, {
+      cleanup,
+      maximumBytes: maxResponseBytes,
+      requestUrl,
+      timeoutController,
+      timeoutError
+    });
+  } catch (error) {
+    cleanup();
+    if (timeoutController.signal.aborted)
+      throw timeoutError;
+    throw error;
+  }
+}
+async function readApiJson(response, label) {
+  let payload;
+  try {
+    const text = await response.text();
+    payload = text ? JSON.parse(text) : {};
+  } catch (error) {
+    if (error instanceof ApiTimeoutError || error instanceof ApiResponseTooLargeError)
+      throw error;
+    payload = {};
+  }
+  if (!response.ok) {
+    const errorCode = typeof payload.error === "string" ? payload.error : null;
+    const apiMessage = typeof payload.message === "string" ? payload.message : null;
+    throw new OpenPondApiError(response.status, errorCode, label, apiMessage);
+  }
+  return payload;
+}
+function boundedResponse(response, input) {
+  if (!response.body) {
+    input.cleanup();
+    return response;
+  }
+  const contentLength = Number(response.headers.get("content-length"));
+  if (input.maximumBytes > 0 && Number.isFinite(contentLength) && contentLength > input.maximumBytes) {
+    input.cleanup();
+    void response.body.cancel();
+    throw new ApiResponseTooLargeError(input.maximumBytes, input.requestUrl);
+  }
+  const reader = response.body.getReader();
+  let receivedBytes = 0;
+  const body = new ReadableStream({
+    async pull(controller) {
+      try {
+        const result = await reader.read();
+        if (result.done) {
+          input.cleanup();
+          controller.close();
+          return;
+        }
+        receivedBytes += result.value.byteLength;
+        if (input.maximumBytes > 0 && receivedBytes > input.maximumBytes) {
+          input.cleanup();
+          await reader.cancel();
+          controller.error(new ApiResponseTooLargeError(input.maximumBytes, input.requestUrl));
+          return;
+        }
+        controller.enqueue(result.value);
+      } catch (error) {
+        input.cleanup();
+        controller.error(input.timeoutController.signal.aborted ? input.timeoutError : error);
+      }
+    },
+    async cancel(reason) {
+      input.cleanup();
+      await reader.cancel(reason);
+    }
+  });
+  return new Response(body, {
+    headers: response.headers,
+    status: response.status,
+    statusText: response.statusText
+  });
+}
+function composedSignal(callerSignal, timeoutSignal, timeoutMs) {
+  if (timeoutMs <= 0)
+    return callerSignal ?? void 0;
+  return callerSignal ? AbortSignal.any([callerSignal, timeoutSignal]) : timeoutSignal;
+}
+
+// src/workflows.ts
+var OpenPondWorkflowsClient = class {
+  #apiKey;
+  #apiBaseUrl;
+  constructor(input) {
+    this.#apiKey = input.apiKey;
+    this.#apiBaseUrl = input.apiBaseUrl.replace(/\/+$/, "");
+  }
+  async list(options = {}) {
+    return this.#request("", "List Workflows", {
+      signal: options.signal
+    });
+  }
+  async create(input, options = {}) {
+    return this.#request("", "Create Workflow", {
+      method: "POST",
+      body: JSON.stringify({
+        ...input,
+        clientRequestId: input.clientRequestId?.trim() || randomUUID()
+      }),
+      signal: options.signal
+    });
+  }
+  async update(scheduleId, input, options = {}) {
+    return this.#request(
+      `/schedules/${encodeURIComponent(requiredId(scheduleId, "scheduleId"))}`,
+      "Update Workflow",
+      {
+        method: "PATCH",
+        body: JSON.stringify(input),
+        signal: options.signal
+      }
+    );
+  }
+  async delete(scheduleId, options = {}) {
+    return this.#request(
+      `/schedules/${encodeURIComponent(requiredId(scheduleId, "scheduleId"))}`,
+      "Delete Workflow",
+      { method: "DELETE", signal: options.signal }
+    );
+  }
+  async runNow(scheduleId, input = {}, options = {}) {
+    return this.#request(
+      `/schedules/${encodeURIComponent(requiredId(scheduleId, "scheduleId"))}/run`,
+      "Run Workflow",
+      {
+        method: "POST",
+        body: JSON.stringify({
+          clientRequestId: input.clientRequestId?.trim() || randomUUID()
+        }),
+        signal: options.signal
+      }
+    );
+  }
+  async #request(suffix, label, options = {}) {
+    const response = await apiFetch(
+      this.#apiBaseUrl,
+      this.#apiKey,
+      `/v1/saved-work${suffix}`,
+      options
+    );
+    return readApiJson(response, label);
+  }
+};
+function requiredId(value, label) {
+  const normalized = value.trim();
+  if (!normalized) throw new Error(`${label} is required`);
+  return normalized;
+}
+export {
+  OpenPondWorkflowsClient
+};
+//# sourceMappingURL=workflows.js.map

package/dist/workflows.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/workflows.ts", "../../cloud/src/api/vercel-protection.ts", "../../cloud/src/api/core.ts"],
+  "sourcesContent": ["import { randomUUID } from \"node:crypto\";\n\nimport { apiFetch, readApiJson } from \"@openpond/cloud/api/core\";\n\nexport type OpenPondWorkflowWeekday =\n  | \"sunday\"\n  | \"monday\"\n  | \"tuesday\"\n  | \"wednesday\"\n  | \"thursday\"\n  | \"friday\"\n  | \"saturday\";\n\nexport type OpenPondWorkflowRecurrence = {\n  version: 1;\n  kind: \"once\" | \"daily\" | \"weekdays\" | \"weekly\" | \"monthly\";\n  timeZone: string;\n  startDate: string;\n  localTime: string;\n  weekdays?: OpenPondWorkflowWeekday[];\n  dayOfMonth?: number;\n  end:\n    | { kind: \"never\" }\n    | { kind: \"on_date\"; date: string }\n    | { kind: \"after_occurrences\"; occurrences: number };\n};\n\nexport type OpenPondWorkflowSchedule = {\n  id: string;\n  expression: string | null;\n  timeZone: string;\n  recurrence: OpenPondWorkflowRecurrence | null;\n  configurationVersion: number;\n  enabled: boolean;\n  nextRunAt: string | null;\n  lastTriggeredAt: string | null;\n  delivery: Record<string, unknown>;\n};\n\nexport type OpenPondWorkflowDefinition = {\n  id: string;\n  definitionKey: string;\n  version: number;\n  name: string;\n  prompt: string;\n  modelId: string;\n  schedules: OpenPondWorkflowSchedule[];\n};\n\nexport type OpenPondWorkflowRun = {\n  id: string;\n  definitionId: string;\n  scheduleId: string | null;\n  definitionName: string;\n  definitionVersion: number;\n  conversationId: string;\n  triggerKind: \"manual\" | \"schedule\" | \"webhook\" | \"retry\";\n  status: string;\n  notificationStatus: string;\n  deliveryStatus: string;\n  deliveryError: string | null;\n  createdAt: string;\n};\n\nexport type OpenPondWorkflowCatalog = {\n  definitions: OpenPondWorkflowDefinition[];\n  runs: OpenPondWorkflowRun[];\n  asOf: string;\n};\n\nexport type OpenPondWorkflowCreateInput = {\n  clientRequestId?: string;\n  sourceTurnId?: string | null;\n  name: string;\n  prompt: string;\n  recurrence: OpenPondWorkflowRecurrence;\n  modelId?: string;\n};\n\nexport type OpenPondWorkflowCreateResult = {\n  created: boolean;\n  definitionId: string;\n  scheduleId: string;\n  name: string;\n  enabled: boolean;\n  nextRunAt: string | null;\n  recurrence: OpenPondWorkflowRecurrence | null;\n  timeZone: string;\n};\n\nexport type OpenPondWorkflowUpdateInput =\n  | { enabled: boolean }\n  | {\n      name: string;\n      prompt: string;\n      recurrence: OpenPondWorkflowRecurrence;\n    };\n\nexport type OpenPondWorkflowUpdateResult = {\n  definitionId?: string;\n  schedule: {\n    id: string;\n    enabled: boolean;\n    nextRunAt: string | null;\n  };\n};\n\nexport type OpenPondWorkflowDeleteResult = {\n  schedule: {\n    id: string;\n    archived: true;\n  };\n};\n\nexport type OpenPondWorkflowRunNowResult = {\n  runId: string;\n  conversationId: string;\n};\n\nexport type OpenPondWorkflowRequestOptions = {\n  signal?: AbortSignal;\n};\n\ntype WorkflowsClientInput = {\n  apiKey: string;\n  apiBaseUrl: string;\n};\n\nexport class OpenPondWorkflowsClient {\n  readonly #apiKey: string;\n  readonly #apiBaseUrl: string;\n\n  constructor(input: WorkflowsClientInput) {\n    this.#apiKey = input.apiKey;\n    this.#apiBaseUrl = input.apiBaseUrl.replace(/\\/+$/, \"\");\n  }\n\n  async list(\n    options: OpenPondWorkflowRequestOptions = {},\n  ): Promise<OpenPondWorkflowCatalog> {\n    return this.#request<OpenPondWorkflowCatalog>(\"\", \"List Workflows\", {\n      signal: options.signal,\n    });\n  }\n\n  async create(\n    input: OpenPondWorkflowCreateInput,\n    options: OpenPondWorkflowRequestOptions = {},\n  ): Promise<OpenPondWorkflowCreateResult> {\n    return this.#request<OpenPondWorkflowCreateResult>(\"\", \"Create Workflow\", {\n      method: \"POST\",\n      body: JSON.stringify({\n        ...input,\n        clientRequestId: input.clientRequestId?.trim() || randomUUID(),\n      }),\n      signal: options.signal,\n    });\n  }\n\n  async update(\n    scheduleId: string,\n    input: OpenPondWorkflowUpdateInput,\n    options: OpenPondWorkflowRequestOptions = {},\n  ): Promise<OpenPondWorkflowUpdateResult> {\n    return this.#request<OpenPondWorkflowUpdateResult>(\n      `/schedules/${encodeURIComponent(requiredId(scheduleId, \"scheduleId\"))}`,\n      \"Update Workflow\",\n      {\n        method: \"PATCH\",\n        body: JSON.stringify(input),\n        signal: options.signal,\n      },\n    );\n  }\n\n  async delete(\n    scheduleId: string,\n    options: OpenPondWorkflowRequestOptions = {},\n  ): Promise<OpenPondWorkflowDeleteResult> {\n    return this.#request<OpenPondWorkflowDeleteResult>(\n      `/schedules/${encodeURIComponent(requiredId(scheduleId, \"scheduleId\"))}`,\n      \"Delete Workflow\",\n      { method: \"DELETE\", signal: options.signal },\n    );\n  }\n\n  async runNow(\n    scheduleId: string,\n    input: { clientRequestId?: string } = {},\n    options: OpenPondWorkflowRequestOptions = {},\n  ): Promise<OpenPondWorkflowRunNowResult> {\n    return this.#request<OpenPondWorkflowRunNowResult>(\n      `/schedules/${encodeURIComponent(requiredId(scheduleId, \"scheduleId\"))}/run`,\n      \"Run Workflow\",\n      {\n        method: \"POST\",\n        body: JSON.stringify({\n          clientRequestId: input.clientRequestId?.trim() || randomUUID(),\n        }),\n        signal: options.signal,\n      },\n    );\n  }\n\n  async #request<T>(\n    suffix: string,\n    label: string,\n    options: RequestInit = {},\n  ): Promise<T> {\n    const response = await apiFetch(\n      this.#apiBaseUrl,\n      this.#apiKey,\n      `/v1/saved-work${suffix}`,\n      options,\n    );\n    return readApiJson<T>(response, label);\n  }\n}\n\nfunction requiredId(value: string, label: string): string {\n  const normalized = value.trim();\n  if (!normalized) throw new Error(`${label} is required`);\n  return normalized;\n}\n", "const VERCEL_PROTECTION_BYPASS_HEADER = \"x-vercel-protection-bypass\";\n\nexport function withVercelProtectionBypass(\n  requestUrl: string,\n  inputHeaders?: HeadersInit,\n  env: Record<string, string | undefined> =\n    typeof process === \"undefined\" ? {} : process.env,\n): Headers {\n  const headers = new Headers(inputHeaders);\n  const secret = env.VERCEL_AUTOMATION_BYPASS_SECRET?.trim();\n  if (!secret || !isOpenPondStagingUrl(requestUrl)) return headers;\n  headers.set(VERCEL_PROTECTION_BYPASS_HEADER, secret);\n  return headers;\n}\n\nfunction isOpenPondStagingUrl(requestUrl: string): boolean {\n  try {\n    const hostname = new URL(requestUrl).hostname.toLowerCase();\n    return (\n      hostname === \"staging.openpond.ai\" ||\n      hostname === \"staging-api.openpond.ai\" ||\n      hostname.endsWith(\".staging-api.openpond.ai\")\n    );\n  } catch {\n    return false;\n  }\n}\n", "import { withVercelProtectionBypass } from \"./vercel-protection.js\";\n\nconst DEFAULT_API_TIMEOUT_MS = 30_000;\nconst DEFAULT_API_RESPONSE_BYTES = 8 * 1024 * 1024;\nexport const LONG_STREAM_API_OPTIONS = { timeoutMs: 15 * 60 * 1000, maxResponseBytes: 64 * 1024 * 1024 } as const;\n\nexport type ApiFetchOptions = RequestInit & {\n  timeoutMs?: number;\n  maxResponseBytes?: number;\n};\n\nexport class ApiTimeoutError extends Error {\n  readonly code = \"OPENPOND_API_TIMEOUT\";\n\n  constructor(readonly timeoutMs: number, readonly requestUrl: string) {\n    super(`API request timed out after ${timeoutMs}ms: ${requestUrl}`);\n    this.name = \"ApiTimeoutError\";\n  }\n}\n\nexport class ApiResponseTooLargeError extends Error {\n  readonly code = \"OPENPOND_API_RESPONSE_TOO_LARGE\";\n\n  constructor(readonly maximumBytes: number, readonly requestUrl: string) {\n    super(`API response exceeded ${maximumBytes} bytes: ${requestUrl}`);\n    this.name = \"ApiResponseTooLargeError\";\n  }\n}\n\nexport class OpenPondApiError extends Error {\n  readonly code: string;\n\n  constructor(\n    readonly status: number,\n    errorCode: string | null,\n    label: string,\n    readonly apiMessage: string | null = null,\n  ) {\n    const detail = apiMessage || errorCode;\n    super(`${label} failed: ${status}${detail ? ` ${detail}` : \"\"}`);\n    this.name = \"OpenPondApiError\";\n    this.code = errorCode || \"OPENPOND_API_ERROR\";\n  }\n}\n\nexport async function apiFetch(\n  baseUrl: string,\n  token: string | null,\n  requestPath: string,\n  options: ApiFetchOptions = {},\n): Promise<Response> {\n  const { timeoutMs = DEFAULT_API_TIMEOUT_MS, maxResponseBytes = DEFAULT_API_RESPONSE_BYTES, ...init } = options;\n  const requestUrl = `${baseUrl}${requestPath}`;\n  const headers = withVercelProtectionBypass(requestUrl, init.headers);\n  headers.set(\"Content-Type\", \"application/json\");\n  const apiKey = process.env.OPENPOND_API_KEY;\n  const trimmedToken = token?.trim() || \"\";\n  const tokenIsApiKey = trimmedToken.startsWith(\"opk_\");\n  const effectiveApiKey = apiKey || (tokenIsApiKey ? trimmedToken : null);\n  if (effectiveApiKey && !headers.has(\"openpond-api-key\")) headers.set(\"openpond-api-key\", effectiveApiKey);\n  if (token) {\n    headers.set(\"Authorization\", tokenIsApiKey ? `ApiKey ${trimmedToken}` : `Bearer ${token}`);\n  } else if (apiKey && !headers.has(\"Authorization\")) {\n    headers.set(\"Authorization\", `ApiKey ${apiKey}`);\n  }\n\n  const timeoutController = new AbortController();\n  const timeoutError = new ApiTimeoutError(timeoutMs, requestUrl);\n  const timer = timeoutMs > 0\n    ? setTimeout(() => timeoutController.abort(timeoutError), timeoutMs)\n    : null;\n  timer?.unref?.();\n  const signal = composedSignal(init.signal, timeoutController.signal, timeoutMs);\n  const cleanup = () => {\n    if (timer) clearTimeout(timer);\n  };\n\n  try {\n    const response = await fetch(requestUrl, { ...init, headers, signal });\n    return boundedResponse(response, {\n      cleanup,\n      maximumBytes: maxResponseBytes,\n      requestUrl,\n      timeoutController,\n      timeoutError,\n    });\n  } catch (error) {\n    cleanup();\n    if (timeoutController.signal.aborted) throw timeoutError;\n    throw error;\n  }\n}\n\nexport async function readApiJson<T>(response: Response, label: string): Promise<T> {\n  let payload: T & { error?: unknown; message?: unknown };\n  try {\n    const text = await response.text();\n    payload = (text ? JSON.parse(text) : {}) as T & { error?: unknown; message?: unknown };\n  } catch (error) {\n    if (error instanceof ApiTimeoutError || error instanceof ApiResponseTooLargeError) throw error;\n    payload = {} as T & { error?: unknown; message?: unknown };\n  }\n  if (!response.ok) {\n    const errorCode = typeof payload.error === \"string\" ? payload.error : null;\n    const apiMessage =\n      typeof payload.message === \"string\" ? payload.message : null;\n    throw new OpenPondApiError(response.status, errorCode, label, apiMessage);\n  }\n  return payload as T;\n}\n\nfunction boundedResponse(\n  response: Response,\n  input: {\n    cleanup: () => void;\n    maximumBytes: number;\n    requestUrl: string;\n    timeoutController: AbortController;\n    timeoutError: ApiTimeoutError;\n  },\n): Response {\n  if (!response.body) {\n    input.cleanup();\n    return response;\n  }\n  const contentLength = Number(response.headers.get(\"content-length\"));\n  if (input.maximumBytes > 0 && Number.isFinite(contentLength) && contentLength > input.maximumBytes) {\n    input.cleanup();\n    void response.body.cancel();\n    throw new ApiResponseTooLargeError(input.maximumBytes, input.requestUrl);\n  }\n\n  const reader = response.body.getReader();\n  let receivedBytes = 0;\n  const body = new ReadableStream<Uint8Array>({\n    async pull(controller) {\n      try {\n        const result = await reader.read();\n        if (result.done) {\n          input.cleanup();\n          controller.close();\n          return;\n        }\n        receivedBytes += result.value.byteLength;\n        if (input.maximumBytes > 0 && receivedBytes > input.maximumBytes) {\n          input.cleanup();\n          await reader.cancel();\n          controller.error(new ApiResponseTooLargeError(input.maximumBytes, input.requestUrl));\n          return;\n        }\n        controller.enqueue(result.value);\n      } catch (error) {\n        input.cleanup();\n        controller.error(input.timeoutController.signal.aborted ? input.timeoutError : error);\n      }\n    },\n    async cancel(reason) {\n      input.cleanup();\n      await reader.cancel(reason);\n    },\n  });\n  return new Response(body, {\n    headers: response.headers,\n    status: response.status,\n    statusText: response.statusText,\n  });\n}\n\nfunction composedSignal(\n  callerSignal: AbortSignal | null | undefined,\n  timeoutSignal: AbortSignal,\n  timeoutMs: number,\n): AbortSignal | undefined {\n  if (timeoutMs <= 0) return callerSignal ?? undefined;\n  return callerSignal ? AbortSignal.any([callerSignal, timeoutSignal]) : timeoutSignal;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openpond-sdk",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "description": "Server-side TypeScript SDK for OpenPond sandboxes and agentic work",
   "license": "MIT",
   "type": "module",
@@ -24,6 +24,14 @@
       "types": "./dist/types/packages/sdk/src/actions-local.d.ts",
       "import": "./dist/actions-local.js"
     },
+    "./project-actions": {
+      "types": "./dist/types/packages/sdk/src/project-actions.d.ts",
+      "import": "./dist/project-actions.js"
+    },
+    "./workflows": {
+      "types": "./dist/types/packages/sdk/src/workflows.d.ts",
+      "import": "./dist/workflows.js"
+    },
     "./package.json": "./package.json"
   },
   "publishConfig": {