runwork 0.26.0 → 0.27.1

package/bundled-types/core-agent.d.ts

@@ -229,14 +229,17 @@ export declare const integrationApiSchema: z.ZodObject<{
     method: z.ZodDefault<z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>>;
     endpoint: z.ZodString;
     data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
     endpoint: string;
     method: "POST" | "GET" | "PUT" | "PATCH" | "DELETE";
     data?: Record<string, unknown> | undefined;
+    headers?: Record<string, string> | undefined;
 }, {
     endpoint: string;
     data?: Record<string, unknown> | undefined;
     method?: "POST" | "GET" | "PUT" | "PATCH" | "DELETE" | undefined;
+    headers?: Record<string, string> | undefined;
 }>;
 /**
  * Get tool definitions for integration access

package/bundled-types/core-workflow-coordinator.d.ts

@@ -6,6 +6,16 @@
  * - Creates WorkflowInstance DOs
  * - Maintains an index for querying workflows
  * - Routes signals to correct instances
+ *
+ * Index storage: one storage key per instance entry (`index:<instanceId>`),
+ * read back with a prefix list. A single-value index hits the 2 MB per-value
+ * limit of SQLite-backed DO storage at roughly 11,000 entries, after which every
+ * write fails with SQLITE_TOOBIG. Apps deployed before the per-key layout still
+ * hold the legacy `workflow_index` value; it is migrated on first load.
+ *
+ * Retention: terminal entries older than the retention window are pruned from
+ * a self-armed alarm, and the index is trimmed inline when a write pushes it
+ * past the entry cap, so the index stays bounded without an external caller.
  */
 import { DurableObject } from 'cloudflare:workers';
 import type { NativeWorkflowStatus, NativeWorkflowConfig, ListWorkflowsOptions, WorkflowInstanceInfo, WorkflowInstanceStub } from './core-workflow-types';
@@ -19,8 +29,14 @@ import { type Env } from './core-utils';
  */
 export declare class WorkflowCoordinator extends DurableObject<Env> {
     private index;
+    /** Entry cap applied inline on writes and by the retention alarm. */
+    readonly retentionMaxEntries = 10000;
     /**
-     * Create a new workflow instance
+     * Create a new workflow instance.
+     *
+     * The index entry and stored params are written before the instance starts,
+     * so a completion notification from a fast workflow can never race ahead of
+     * its own pending entry, and an index failure surfaces before any work runs.
      */
     create(workflowName: string, params: Record<string, unknown>, config?: Partial<NativeWorkflowConfig>, metadata?: Record<string, unknown>): Promise<string>;
     /**
@@ -65,14 +81,36 @@ export declare class WorkflowCoordinator extends DurableObject<Env> {
         byWorkflow: Record<string, number>;
     }>;
     /**
-     * Clean up completed/old workflow entries
-     * Should be called periodically to prevent index bloat
+     * Clean up completed/old workflow entries.
+     *
+     * Removes terminal entries older than `olderThanMs`, every completed entry
+     * unless `keepCompleted` is set, and then the oldest terminal entries until
+     * the index fits within `maxEntries`. Active entries (pending, running,
+     * sleeping, waiting, paused) are never removed. Runs from the retention alarm
+     * and inline on writes; explicit calls remain supported.
      */
     cleanup(options?: {
         olderThanMs?: number;
         keepCompleted?: boolean;
         maxEntries?: number;
     }): Promise<number>;
+    /**
+     * Retention alarm: prune old terminal entries and re-arm while the index
+     * still holds anything.
+     */
+    alarm(): Promise<void>;
     private ensureIndexLoaded;
-    private persistIndex;
+    /**
+     * Move a legacy single-value index into per-entry keys. Per-entry values
+     * already present win, since they were written after the legacy value.
+     * An unreadable legacy value is dropped: the workflow instances themselves
+     * still hold their state, only the listing loses history.
+     */
+    private migrateLegacyIndex;
+    private deleteLegacyIndexKey;
+    /**
+     * Remove index entries and their stored params, in storage batches.
+     */
+    private removeEntries;
+    private ensureRetentionAlarm;
 }

package/bundled-types/shared/shared/core-types.d.ts

@@ -28,7 +28,12 @@ export interface NangoProxyOptions {
     method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
     endpoint: string;
     providerConfigKey: string;
-    data?: Record<string, unknown>;
+    /**
+     * Request body. Encoded per the Content-Type in `headers`: form-encoded with
+     * bracket notation for application/x-www-form-urlencoded, JSON otherwise.
+     * A string is sent verbatim.
+     */
+    data?: Record<string, unknown> | string;
     headers?: Record<string, string>;
     params?: Record<string, string>;
     retries?: number;