openpond-sdk 0.0.10 → 0.0.12

package/README.md

@@ -119,6 +119,25 @@ await openpond.workflows.runNow(workflow.scheduleId);
 await openpond.workflows.update(workflow.scheduleId, { enabled: false });
 ```
 
+An external product can also let OpenPond own recurrence while keeping the
+work itself inside that product. External callbacks are created disabled by
+default by the caller, carry only an opaque external reference, and receive a
+verifiable Saved Work run identity when OpenPond fires them:
+
+```ts
+await openpond.workflows.create({
+  name: "Daily account review",
+  prompt: "Run the account-owned daily review.",
+  recurrence,
+  enabled: false,
+  target: {
+    kind: "external_callback",
+    callbackUrl: "https://app.example.com/api/workflows/openpond-callback",
+    externalReference: "opaque_binding_id",
+  },
+});
+```
+
 `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

package/dist/index.js

@@ -2591,6 +2591,37 @@ var OpenPondProfileActionsClient = class {
       "Get Profile Action catalog"
     )).catalog;
   }
+  async run(input) {
+    const teamId = requiredValue(input.teamId, "teamId");
+    const actionKey = requiredValue(input.actionKey, "actionKey");
+    const idempotencyKey = requiredValue(input.idempotencyKey, "idempotencyKey");
+    const catalogVersion = requiredValue(input.catalogVersion, "catalogVersion");
+    const response = await apiFetch(
+      this.#apiBaseUrl,
+      this.#apiKey,
+      `/v1/profile/actions/run?${new URLSearchParams({ teamId }).toString()}`,
+      {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          ...input.profileId?.trim() ? { profileId: input.profileId.trim() } : {},
+          ...input.profileName?.trim() ? { profileName: input.profileName.trim() } : {},
+          actionKey,
+          value: input.value ?? {},
+          conversationId: input.conversationId ?? null,
+          createConversation: input.createConversation,
+          conversationTitle: input.conversationTitle ?? null,
+          idempotencyKey,
+          catalogVersion,
+          externalCapabilityLeases: input.externalCapabilityLeases
+        })
+      }
+    );
+    return readApiJson(
+      response,
+      "Run Profile Action"
+    );
+  }
 };
 function requiredValue(value, name) {
   const normalized = value.trim();