openpond-sdk 0.0.5 → 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) {
@@ -2476,6 +2480,151 @@ function sleep2(milliseconds, signal) {
   });
 }
 
+// src/project-actions.ts
+import { promises as fs } from "node:fs";
+var OpenPondProjectActionsClient = class {
+  #apiKey;
+  #apiBaseUrl;
+  constructor(input) {
+    this.#apiKey = input.apiKey;
+    this.#apiBaseUrl = input.apiBaseUrl.replace(/\/+$/, "");
+  }
+  async list(input) {
+    const response = await apiFetch(
+      this.#apiBaseUrl,
+      this.#apiKey,
+      projectActionPath(input.projectId, "releases", input.teamId)
+    );
+    return (await readApiJson(response, "List Project Action releases")).releases;
+  }
+  async catalog(input) {
+    const response = await apiFetch(
+      this.#apiBaseUrl,
+      this.#apiKey,
+      projectActionPath(input.projectId, "catalog", input.teamId)
+    );
+    return (await readApiJson(response, "Get Project Action catalog")).catalog;
+  }
+  async publish(input) {
+    const [bundle, runner] = await Promise.all([
+      fs.readFile(input.build.bundlePath),
+      fs.readFile(input.build.runnerPath)
+    ]);
+    const response = await apiFetch(
+      this.#apiBaseUrl,
+      this.#apiKey,
+      projectActionPath(input.projectId, "releases", input.teamId),
+      {
+        method: "POST",
+        body: JSON.stringify({
+          sourceRef: input.sourceRef,
+          sourceCommitSha: input.sourceCommitSha,
+          bundleBase64: bundle.toString("base64"),
+          runnerBase64: runner.toString("base64"),
+          registry: input.build.registry,
+          manifest: input.build.manifest,
+          metadata: input.metadata
+        })
+      }
+    );
+    return (await readApiJson(response, "Publish Project Actions")).release;
+  }
+  async run(input) {
+    const response = await apiFetch(
+      this.#apiBaseUrl,
+      this.#apiKey,
+      projectActionPath(input.projectId, `actions/${encodeURIComponent(input.actionId)}`, input.teamId),
+      {
+        method: "POST",
+        body: JSON.stringify({
+          input: input.value ?? {},
+          releaseId: input.releaseId,
+          idempotencyKey: input.idempotencyKey,
+          callerType: input.callerType ?? "sdk",
+          callerId: input.callerId
+        }),
+        signal: input.signal,
+        timeoutMs: 15 * 60 * 1e3
+      }
+    );
+    return (await readApiJson(response, "Run Project Action")).invocation;
+  }
+};
+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",
@@ -2488,6 +2637,8 @@ var SANDBOX_RUNTIME_PROFILE_IDS = [
 var OpenPondClient = class {
   sandboxes;
   work;
+  workflows;
+  actions;
   constructor(options) {
     const apiKey = options.apiKey.trim();
     if (!apiKey) throw new Error("OpenPond API key is required");
@@ -2503,6 +2654,8 @@ 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 });
   }
 };
 function createOpenPondClient(options) {
@@ -2511,8 +2664,10 @@ function createOpenPondClient(options) {
 export {
   OpenPondApiError,
   OpenPondClient,
+  OpenPondProjectActionsClient,
   OpenPondSandboxClient,
   OpenPondWorkClient,
+  OpenPondWorkflowsClient,
   SANDBOX_RUNTIME_PROFILE_IDS,
   createOpenPondClient,
   createOpenPondSandboxClient,