openpond-sdk 0.0.6 → 0.0.7

package/README.md

@@ -96,6 +96,31 @@ console.log(result.command.output);
 
 The package also exports `createOpenPondSandboxClient`, all public sandbox input and response types, and the OpChat helpers used by the Work loop.
 
+## Workflows and scheduled Work
+
+Use `openpond.workflows` for model-driven scheduled Work. Workflows use the same Saved Work definitions, conversations, runs, and scheduler as the hosted OpenPond Workflows UI:
+
+```ts
+const workflow = await openpond.workflows.create({
+  name: "Morning market brief",
+  prompt: "Summarize the overnight market and write the brief to outputs.",
+  recurrence: {
+    version: 1,
+    kind: "weekdays",
+    timeZone: "America/New_York",
+    startDate: "2026-08-18",
+    localTime: "08:30",
+    end: { kind: "never" },
+  },
+});
+
+const catalog = await openpond.workflows.list();
+await openpond.workflows.runNow(workflow.scheduleId);
+await openpond.workflows.update(workflow.scheduleId, { enabled: false });
+```
+
+`openpond.workflows` is distinct from `openpond.sandboxes.createSchedule()`. Workflows schedule model-driven Work and create normal Work conversations and run history. Raw sandbox schedules execute a declared sandbox command or action.
+
 ## Project Actions
 
 Project Actions expose typed business functions from a normal Git Project to local OpenPond Work. The website and action wrapper can import the same neutral domain module, so the harness does not duplicate application logic.

package/dist/index.js

@@ -1188,7 +1188,8 @@ var OpenPondSandboxClient = class extends OpenPondSandboxInstanceClient {
     return this.requestApiRoot(`/projects?${query.toString()}`).then((payload) => payload.projects);
   }
   upsertProject(input) {
-    return this.requestApiRoot("/projects", {
+    const query = new URLSearchParams({ teamId: input.teamId });
+    return this.requestApiRoot(`/projects?${query.toString()}`, {
       method: "POST",
       body: JSON.stringify(input)
     }).then((payload) => payload.project);
@@ -1255,7 +1256,8 @@ var OpenPondSandboxClient = class extends OpenPondSandboxInstanceClient {
     return this.requestApiRoot(`/agents?${query.toString()}`).then((payload) => payload.agents);
   }
   upsertAgent(input) {
-    return this.requestApiRoot("/agents", {
+    const query = new URLSearchParams({ teamId: input.teamId });
+    return this.requestApiRoot(`/agents?${query.toString()}`, {
       method: "POST",
       body: JSON.stringify(input)
     }).then((payload) => payload.agent);
@@ -1277,7 +1279,8 @@ var OpenPondSandboxClient = class extends OpenPondSandboxInstanceClient {
     }).then((payload) => payload.agent);
   }
   runAgent(agentId, input) {
-    return this.requestApiRoot(`/agents/${encodeURIComponent(agentId)}/run`, {
+    const query = new URLSearchParams({ teamId: input.teamId });
+    return this.requestApiRoot(`/agents/${encodeURIComponent(agentId)}/run?${query.toString()}`, {
       method: "POST",
       headers: {
         Prefer: "respond-async"
@@ -1300,7 +1303,8 @@ var OpenPondSandboxClient = class extends OpenPondSandboxInstanceClient {
     const { teamId: _teamId, ...body } = input;
     return this.requestApiRoot(`/agents/${encodeURIComponent(agentId)}/source/checks?${query.toString()}`, {
       method: "POST",
-      body: JSON.stringify(body)
+      body: JSON.stringify(body),
+      timeoutMs: 15 * 60 * 1e3
     });
   }
   publishAgentSource(agentId, input) {
@@ -2550,6 +2554,77 @@ function projectActionPath(projectId, suffix, teamId) {
   return `/v1/project-actions/${encodeURIComponent(projectId)}/${suffix}?teamId=${encodeURIComponent(teamId)}`;
 }
 
+// src/workflows.ts
+import { randomUUID as randomUUID2 } from "node:crypto";
+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() || randomUUID2()
+      }),
+      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() || randomUUID2()
+        }),
+        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;
+}
+
 // ../cloud/dist/sandbox/types/runtime-profiles.js
 var SANDBOX_RUNTIME_PROFILE_IDS = [
   "openpond-generic-v1",
@@ -2562,6 +2637,7 @@ var SANDBOX_RUNTIME_PROFILE_IDS = [
 var OpenPondClient = class {
   sandboxes;
   work;
+  workflows;
   actions;
   constructor(options) {
     const apiKey = options.apiKey.trim();
@@ -2578,6 +2654,7 @@ var OpenPondClient = class {
       chatApiBaseUrl: options.chatApiUrl?.trim() || resolveOpChatApiBaseUrl({ apiBaseUrl, env: {} }),
       sandboxes: this.sandboxes
     });
+    this.workflows = new OpenPondWorkflowsClient({ apiKey, apiBaseUrl });
     this.actions = new OpenPondProjectActionsClient({ apiKey, apiBaseUrl });
   }
 };
@@ -2590,6 +2667,7 @@ export {
   OpenPondProjectActionsClient,
   OpenPondSandboxClient,
   OpenPondWorkClient,
+  OpenPondWorkflowsClient,
   SANDBOX_RUNTIME_PROFILE_IDS,
   createOpenPondClient,
   createOpenPondSandboxClient,