agents 0.12.2 → 0.12.4

package/dist/workflow-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-types.js","names":[],"sources":["../src/workflow-types.ts"],"sourcesContent":["/**\n * Workflow integration types for Agents\n *\n * These types provide seamless integration between Cloudflare Agents\n * and Cloudflare Workflows for durable, multi-step background processing.\n *\n * Note: This file is kept separate from workflows.ts to avoid circular dependencies.\n * Both index.ts (Agent class) and workflows.ts (AgentWorkflow class) import from here.\n */\n\nimport type {\n  WorkflowEvent,\n  WorkflowStep,\n  WorkflowSleepDuration\n} from \"cloudflare:workers\";\n\n/**\n * Type alias for WorkflowEvent in AgentWorkflow context.\n * Identical to WorkflowEvent - provided for naming consistency with AgentWorkflowStep.\n */\nexport type AgentWorkflowEvent<Params = unknown> = WorkflowEvent<Params>;\n\n/**\n * Extended WorkflowStep with durable Agent communication methods.\n * All added methods on this interface are durable - they're idempotent and won't\n * repeat on workflow retry.\n */\nexport interface AgentWorkflowStep extends WorkflowStep {\n  /**\n   * Report successful completion to the Agent (durable).\n   * Triggers onWorkflowComplete() on the Agent.\n   * @param result - Optional result data\n   */\n  reportComplete<T = unknown>(result?: T): Promise<void>;\n\n  /**\n   * Report an error to the Agent (durable).\n   * Triggers onWorkflowError() on the Agent.\n   * @param error - Error or error message\n   */\n  reportError(error: Error | string): Promise<void>;\n\n  /**\n   * Send a custom event to the Agent (durable).\n   * Triggers onWorkflowEvent() on the Agent.\n   * @param event - Custom event payload\n   */\n  sendEvent<T = unknown>(event: T): Promise<void>;\n\n  /**\n   * Update the Agent's state entirely (durable).\n   * This will replace the Agent's state and broadcast to all connected clients.\n   * @param state - New state to set\n   */\n  updateAgentState(state: unknown): Promise<void>;\n\n  /**\n   * Merge partial state into the Agent's existing state (durable).\n   * Performs a shallow merge and broadcasts to all connected clients.\n   * @param partialState - Partial state to merge\n   */\n  mergeAgentState(partialState: Record<string, unknown>): Promise<void>;\n\n  /**\n   * Reset the Agent's state to its initialState (durable).\n   * Broadcasts the reset state to all connected clients.\n   */\n  resetAgentState(): Promise<void>;\n}\n\n/**\n * Internal parameters injected by runWorkflow() to identify the originating Agent\n */\nexport type AgentWorkflowInternalParams = {\n  /** Name/ID of the Agent that started this workflow */\n  __agentName: string;\n  /** Environment binding name for the Agent's namespace */\n  __agentBinding: string;\n  /** Workflow binding name (for callbacks) */\n  __workflowName: string;\n};\n\n/**\n * Combined workflow params: user params + internal agent params\n */\nexport type AgentWorkflowParams<T = unknown> = T & AgentWorkflowInternalParams;\n\n/**\n * Workflow callback types for Agent-Workflow communication\n */\nexport type WorkflowCallbackType = \"progress\" | \"complete\" | \"error\" | \"event\";\n\n/**\n * Base callback structure sent from Workflow to Agent\n */\nexport type WorkflowCallbackBase = {\n  /** Workflow binding name */\n  workflowName: string;\n  /** ID of the workflow instance */\n  workflowId: string;\n  /** Type of callback */\n  type: WorkflowCallbackType;\n  /** Timestamp when callback was sent */\n  timestamp: number;\n};\n\n/**\n * Default progress type - covers common use cases.\n * Developers can define their own progress type for domain-specific needs.\n */\nexport type DefaultProgress = {\n  /** Current step name */\n  step?: string;\n  /** Step/overall status */\n  status?: \"pending\" | \"running\" | \"complete\" | \"error\";\n  /** Human-readable message */\n  message?: string;\n  /** Progress percentage (0-1) */\n  percent?: number;\n  /** Allow additional custom fields */\n  [key: string]: unknown;\n};\n\n/**\n * Progress callback - reports workflow progress with typed payload\n */\nexport type WorkflowProgressCallback<P = DefaultProgress> =\n  WorkflowCallbackBase & {\n    type: \"progress\";\n    /** Typed progress data */\n    progress: P;\n  };\n\n/**\n * Complete callback - workflow finished successfully\n */\nexport type WorkflowCompleteCallback = WorkflowCallbackBase & {\n  type: \"complete\";\n  /** Result of the workflow */\n  result?: unknown;\n};\n\n/**\n * Error callback - workflow encountered an error\n */\nexport type WorkflowErrorCallback = WorkflowCallbackBase & {\n  type: \"error\";\n  /** Error message */\n  error: string;\n};\n\n/**\n * Event callback - custom event from workflow\n */\nexport type WorkflowEventCallback = WorkflowCallbackBase & {\n  type: \"event\";\n  /** Custom event payload */\n  event: unknown;\n};\n\n/**\n * Union of all callback types\n */\nexport type WorkflowCallback<P = DefaultProgress> =\n  | WorkflowProgressCallback<P>\n  | WorkflowCompleteCallback\n  | WorkflowErrorCallback\n  | WorkflowEventCallback;\n\n/**\n * Workflow status values - derived from Cloudflare's InstanceStatus\n */\nexport type WorkflowStatus = InstanceStatus[\"status\"];\n\n/**\n * Row structure for cf_agents_workflows tracking table\n */\nexport type WorkflowTrackingRow = {\n  /** Internal row ID (UUID) */\n  id: string;\n  /** Cloudflare Workflow instance ID */\n  workflow_id: string;\n  /** Workflow binding name */\n  workflow_name: string;\n  /** Current workflow status */\n  status: WorkflowStatus;\n  /** JSON-serialized metadata for querying */\n  metadata: string | null;\n  /** Error name if workflow failed */\n  error_name: string | null;\n  /** Error message if workflow failed */\n  error_message: string | null;\n  /** Unix timestamp when workflow was created */\n  created_at: number;\n  /** Unix timestamp when workflow was last updated */\n  updated_at: number;\n  /** Unix timestamp when workflow completed (null if not complete) */\n  completed_at: number | null;\n};\n\n/**\n * Options for runWorkflow()\n */\nexport type RunWorkflowOptions = {\n  /** Custom workflow instance ID (auto-generated if not provided) */\n  id?: string;\n  /** Optional metadata for querying (stored as JSON) */\n  metadata?: Record<string, unknown>;\n  /** Agent binding name (auto-detected from class name if not provided) */\n  agentBinding?: string;\n};\n\n/**\n * Event payload for sendWorkflowEvent()\n */\nexport type WorkflowEventPayload = {\n  /** Event type name */\n  type: string;\n  /** Event payload data */\n  payload: unknown;\n};\n\n/**\n * Parsed workflow tracking info returned by getWorkflow()\n */\nexport type WorkflowInfo = {\n  /** Internal row ID */\n  id: string;\n  /** Cloudflare Workflow instance ID */\n  workflowId: string;\n  /** Workflow binding name */\n  workflowName: string;\n  /** Current workflow status */\n  status: WorkflowStatus;\n  /** Metadata (parsed from JSON) */\n  metadata: Record<string, unknown> | null;\n  /** Error info if workflow failed */\n  error: { name: string; message: string } | null;\n  /** When workflow was created */\n  createdAt: Date;\n  /** When workflow was last updated */\n  updatedAt: Date;\n  /** When workflow completed (null if not complete) */\n  completedAt: Date | null;\n};\n\n/**\n * Criteria for querying tracked workflows\n */\nexport type WorkflowQueryCriteria = {\n  /** Filter by status */\n  status?: WorkflowStatus | WorkflowStatus[];\n  /** Filter by workflow binding name */\n  workflowName?: string;\n  /** Filter by metadata key-value pairs (exact match) */\n  metadata?: Record<string, string | number | boolean>;\n  /** Limit number of results (default 50, max 100) */\n  limit?: number;\n  /** Order by created_at */\n  orderBy?: \"asc\" | \"desc\";\n  /** Cursor for pagination (from previous WorkflowPage.nextCursor) */\n  cursor?: string;\n};\n\n/**\n * Paginated result from getWorkflows()\n */\nexport type WorkflowPage = {\n  /** Workflows for this page */\n  workflows: WorkflowInfo[];\n  /** Total count of workflows matching the criteria (ignoring pagination) */\n  total: number;\n  /** Cursor for next page, or null if no more pages */\n  nextCursor: string | null;\n};\n\n/**\n * Standard approval event payload used by approveWorkflow/rejectWorkflow\n */\nexport type ApprovalEventPayload = {\n  /** Whether the workflow was approved */\n  approved: boolean;\n  /** Optional reason for approval/rejection */\n  reason?: string;\n  /** Optional additional metadata */\n  metadata?: Record<string, unknown>;\n};\n\n/**\n * Options for waitForApproval()\n */\nexport type WaitForApprovalOptions = {\n  /** Step name for waitForEvent (default: \"wait-for-approval\") */\n  stepName?: string;\n  /** Timeout duration (e.g., \"7 days\") */\n  timeout?: WorkflowSleepDuration;\n  /** Event type to wait for (default: \"approval\") */\n  eventType?: string;\n};\n\n/**\n * Error thrown when a workflow is rejected via rejectWorkflow()\n */\nexport class WorkflowRejectedError extends Error {\n  constructor(\n    public readonly reason?: string,\n    public readonly workflowId?: string\n  ) {\n    super(reason ? `Workflow rejected: ${reason}` : \"Workflow rejected\");\n    this.name = \"WorkflowRejectedError\";\n  }\n}\n"],"mappings":";;;;AA+SA,IAAa,wBAAb,cAA2C,MAAM;CAC/C,YACE,QACA,YACA;AACA,QAAM,SAAS,sBAAsB,WAAW,oBAAoB;AAHpD,OAAA,SAAA;AACA,OAAA,aAAA;AAGhB,OAAK,OAAO"}
+{"version":3,"file":"workflow-types.js","names":[],"sources":["../src/workflow-types.ts"],"sourcesContent":["/**\n * Workflow integration types for Agents\n *\n * These types provide seamless integration between Cloudflare Agents\n * and Cloudflare Workflows for durable, multi-step background processing.\n *\n * Note: This file is kept separate from workflows.ts to avoid circular dependencies.\n * Both index.ts (Agent class) and workflows.ts (AgentWorkflow class) import from here.\n */\n\nimport type {\n  WorkflowEvent,\n  WorkflowStep,\n  WorkflowSleepDuration\n} from \"cloudflare:workers\";\n\n/**\n * Type alias for WorkflowEvent in AgentWorkflow context.\n * Identical to WorkflowEvent - provided for naming consistency with AgentWorkflowStep.\n */\nexport type AgentWorkflowEvent<Params = unknown> = WorkflowEvent<Params>;\n\n/**\n * Extended WorkflowStep with durable Agent communication methods.\n * All added methods on this interface are durable - they're idempotent and won't\n * repeat on workflow retry.\n */\nexport interface AgentWorkflowStep extends WorkflowStep {\n  /**\n   * Report successful completion to the Agent (durable).\n   * Triggers onWorkflowComplete() on the Agent.\n   * @param result - Optional result data\n   */\n  reportComplete<T = unknown>(result?: T): Promise<void>;\n\n  /**\n   * Report an error to the Agent (durable).\n   * Triggers onWorkflowError() on the Agent.\n   * @param error - Error or error message\n   */\n  reportError(error: Error | string): Promise<void>;\n\n  /**\n   * Send a custom event to the Agent (durable).\n   * Triggers onWorkflowEvent() on the Agent.\n   * @param event - Custom event payload\n   */\n  sendEvent<T = unknown>(event: T): Promise<void>;\n\n  /**\n   * Update the Agent's state entirely (durable).\n   * This will replace the Agent's state and broadcast to all connected clients.\n   * @param state - New state to set\n   */\n  updateAgentState(state: unknown): Promise<void>;\n\n  /**\n   * Merge partial state into the Agent's existing state (durable).\n   * Performs a shallow merge and broadcasts to all connected clients.\n   * @param partialState - Partial state to merge\n   */\n  mergeAgentState(partialState: Record<string, unknown>): Promise<void>;\n\n  /**\n   * Reset the Agent's state to its initialState (durable).\n   * Broadcasts the reset state to all connected clients.\n   */\n  resetAgentState(): Promise<void>;\n}\n\n/**\n * Internal parameters injected by runWorkflow() to identify the originating Agent\n */\nexport type AgentWorkflowInternalParams = {\n  /** Name/ID of the Agent that started this workflow */\n  __agentName: string;\n  /** Environment binding name for the Agent's namespace */\n  __agentBinding: string;\n  /** Workflow binding name (for callbacks) */\n  __workflowName: string;\n};\n\n/**\n * Combined workflow params: user params + internal agent params\n */\nexport type AgentWorkflowParams<T = unknown> = T & AgentWorkflowInternalParams;\n\n/**\n * Workflow callback types for Agent-Workflow communication\n */\nexport type WorkflowCallbackType = \"progress\" | \"complete\" | \"error\" | \"event\";\n\n/**\n * Base callback structure sent from Workflow to Agent\n */\nexport type WorkflowCallbackBase = {\n  /** Workflow binding name */\n  workflowName: string;\n  /** ID of the workflow instance */\n  workflowId: string;\n  /** Type of callback */\n  type: WorkflowCallbackType;\n  /** Timestamp when callback was sent */\n  timestamp: number;\n};\n\n/**\n * Default progress type - covers common use cases.\n * Developers can define their own progress type for domain-specific needs.\n */\nexport type DefaultProgress = {\n  /** Current step name */\n  step?: string;\n  /** Step/overall status */\n  status?: \"pending\" | \"running\" | \"complete\" | \"error\";\n  /** Human-readable message */\n  message?: string;\n  /** Progress percentage (0-1) */\n  percent?: number;\n  /** Allow additional custom fields */\n  [key: string]: unknown;\n};\n\n/**\n * Progress callback - reports workflow progress with typed payload\n */\nexport type WorkflowProgressCallback<P = DefaultProgress> =\n  WorkflowCallbackBase & {\n    type: \"progress\";\n    /** Typed progress data */\n    progress: P;\n  };\n\n/**\n * Complete callback - workflow finished successfully\n */\nexport type WorkflowCompleteCallback = WorkflowCallbackBase & {\n  type: \"complete\";\n  /** Result of the workflow */\n  result?: unknown;\n};\n\n/**\n * Error callback - workflow encountered an error\n */\nexport type WorkflowErrorCallback = WorkflowCallbackBase & {\n  type: \"error\";\n  /** Error message */\n  error: string;\n};\n\n/**\n * Event callback - custom event from workflow\n */\nexport type WorkflowEventCallback = WorkflowCallbackBase & {\n  type: \"event\";\n  /** Custom event payload */\n  event: unknown;\n};\n\n/**\n * Union of all callback types\n */\nexport type WorkflowCallback<P = DefaultProgress> =\n  | WorkflowProgressCallback<P>\n  | WorkflowCompleteCallback\n  | WorkflowErrorCallback\n  | WorkflowEventCallback;\n\n/**\n * Workflow status values - derived from Cloudflare's InstanceStatus\n */\nexport type WorkflowStatus = InstanceStatus[\"status\"];\n\n/**\n * Row structure for cf_agents_workflows tracking table\n */\nexport type WorkflowTrackingRow = {\n  /** Internal row ID (UUID) */\n  id: string;\n  /** Cloudflare Workflow instance ID */\n  workflow_id: string;\n  /** Workflow binding name */\n  workflow_name: string;\n  /** Current workflow status */\n  status: WorkflowStatus;\n  /** JSON-serialized metadata for querying */\n  metadata: string | null;\n  /** Error name if workflow failed */\n  error_name: string | null;\n  /** Error message if workflow failed */\n  error_message: string | null;\n  /** Unix timestamp when workflow was created */\n  created_at: number;\n  /** Unix timestamp when workflow was last updated */\n  updated_at: number;\n  /** Unix timestamp when workflow completed (null if not complete) */\n  completed_at: number | null;\n};\n\n/**\n * Options for runWorkflow()\n */\nexport type RunWorkflowOptions = {\n  /** Custom workflow instance ID (auto-generated if not provided) */\n  id?: string;\n  /** Optional metadata for querying (stored as JSON) */\n  metadata?: Record<string, unknown>;\n  /** Agent binding name (auto-detected from class name if not provided) */\n  agentBinding?: string;\n};\n\n/**\n * Event payload for sendWorkflowEvent()\n */\nexport type WorkflowEventPayload = {\n  /** Event type name */\n  type: string;\n  /** Event payload data */\n  payload: unknown;\n};\n\n/**\n * Parsed workflow tracking info returned by getWorkflow()\n */\nexport type WorkflowInfo = {\n  /** Internal row ID */\n  id: string;\n  /** Cloudflare Workflow instance ID */\n  workflowId: string;\n  /** Workflow binding name */\n  workflowName: string;\n  /** Current workflow status */\n  status: WorkflowStatus;\n  /** Metadata (parsed from JSON) */\n  metadata: Record<string, unknown> | null;\n  /** Error info if workflow failed */\n  error: { name: string; message: string } | null;\n  /** When workflow was created */\n  createdAt: Date;\n  /** When workflow was last updated */\n  updatedAt: Date;\n  /** When workflow completed (null if not complete) */\n  completedAt: Date | null;\n};\n\n/**\n * Criteria for querying tracked workflows\n */\nexport type WorkflowQueryCriteria = {\n  /** Filter by status */\n  status?: WorkflowStatus | WorkflowStatus[];\n  /** Filter by workflow binding name */\n  workflowName?: string;\n  /** Filter by metadata key-value pairs (exact match) */\n  metadata?: Record<string, string | number | boolean>;\n  /** Limit number of results (default 50, max 100) */\n  limit?: number;\n  /** Order by created_at */\n  orderBy?: \"asc\" | \"desc\";\n  /** Cursor for pagination (from previous WorkflowPage.nextCursor) */\n  cursor?: string;\n};\n\n/**\n * Paginated result from getWorkflows()\n */\nexport type WorkflowPage = {\n  /** Workflows for this page */\n  workflows: WorkflowInfo[];\n  /** Total count of workflows matching the criteria (ignoring pagination) */\n  total: number;\n  /** Cursor for next page, or null if no more pages */\n  nextCursor: string | null;\n};\n\n/**\n * Standard approval event payload used by approveWorkflow/rejectWorkflow\n */\nexport type ApprovalEventPayload = {\n  /** Whether the workflow was approved */\n  approved: boolean;\n  /** Optional reason for approval/rejection */\n  reason?: string;\n  /** Optional additional metadata */\n  metadata?: Record<string, unknown>;\n};\n\n/**\n * Options for waitForApproval()\n */\nexport type WaitForApprovalOptions = {\n  /** Step name for waitForEvent (default: \"wait-for-approval\") */\n  stepName?: string;\n  /** Timeout duration (e.g., \"7 days\") */\n  timeout?: WorkflowSleepDuration;\n  /** Event type to wait for (default: \"approval\") */\n  eventType?: string;\n};\n\n/**\n * Error thrown when a workflow is rejected via rejectWorkflow()\n */\nexport class WorkflowRejectedError extends Error {\n  constructor(\n    public readonly reason?: string,\n    public readonly workflowId?: string\n  ) {\n    super(reason ? `Workflow rejected: ${reason}` : \"Workflow rejected\");\n    this.name = \"WorkflowRejectedError\";\n  }\n}\n"],"mappings":";;;;AA+SA,IAAa,wBAAb,cAA2C,MAAM;CAC/C,YACE,QACA,YACA;EACA,MAAM,SAAS,sBAAsB,WAAW,oBAAoB;EAHpD,KAAA,SAAA;EACA,KAAA,aAAA;EAGhB,KAAK,OAAO"}

package/dist/workflows.d.ts

@@ -1,4 +1,4 @@
-import { v as Agent } from "./agent-tool-types-DSteYkkS.js";
+import { v as Agent } from "./agent-tool-types-CM_50fcV.js";
 import {
   S as WorkflowTrackingRow,
   _ as WorkflowPage,
@@ -20,7 +20,7 @@ import {
   v as WorkflowProgressCallback,
   x as WorkflowStatus,
   y as WorkflowQueryCriteria
-} from "./workflow-types-DHs0L0KP.js";
+} from "./workflow-types-Dkzg4hAx.js";
 import { WorkflowEntrypoint } from "cloudflare:workers";
 
 //#region src/workflows.d.ts

package/dist/workflows.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflows.js","names":[],"sources":["../src/workflows.ts"],"sourcesContent":["/**\n * AgentWorkflow - Base class for Workflows that integrate with Agents\n *\n * Extends Cloudflare's WorkflowEntrypoint to provide seamless access to\n * the Agent that started the workflow, enabling bidirectional communication.\n *\n * @example\n * ```typescript\n * import { AgentWorkflow } from 'agents/workflows';\n * import type { MyAgent } from './agent';\n *\n * type TaskParams = { taskId: string; data: string };\n *\n * export class ProcessingWorkflow extends AgentWorkflow<MyAgent, TaskParams> {\n *   async run(event: AgentWorkflowEvent<TaskParams>, step: WorkflowStep) {\n *     // Access the originating Agent via typed RPC\n *     await this.agent.updateTaskStatus(event.payload.taskId, 'processing');\n *\n *     const result = await step.do('process', async () => {\n *       // ... processing logic\n *       return { processed: true };\n *     });\n *\n *     // Report progress to Agent (typed)\n *     await this.reportProgress({ step: 'process', status: 'complete', percent: 0.5 });\n *\n *     // Broadcast to connected clients\n *     await this.broadcastToClients({ type: 'progress', data: result });\n *\n *     return result;\n *   }\n * }\n * ```\n */\n\nimport { WorkflowEntrypoint } from \"cloudflare:workers\";\nimport type { WorkflowEvent, WorkflowStep } from \"cloudflare:workers\";\nimport { getAgentByName, type Agent } from \"./index\";\nimport type {\n  AgentWorkflowParams,\n  AgentWorkflowStep,\n  WorkflowCallback,\n  DefaultProgress,\n  WaitForApprovalOptions\n} from \"./workflow-types\";\nimport { WorkflowRejectedError } from \"./workflow-types\";\n\n/**\n * WeakSet to track which prototypes have been wrapped.\n * This prevents re-wrapping on subsequent instantiations of the same class.\n */\nconst wrappedPrototypes = new WeakSet<object>();\n\n/**\n * Base class for Workflows that need access to their originating Agent.\n *\n * @template AgentType - The Agent class type (for typed RPC access)\n * @template Params - User-defined params passed to the workflow (optional)\n * @template ProgressType - Type for progress reporting (defaults to DefaultProgress)\n * @template Env - Environment type (defaults to Cloudflare.Env)\n */\nexport class AgentWorkflow<\n  AgentType extends Agent = Agent,\n  Params = unknown,\n  ProgressType = DefaultProgress,\n  Env extends Cloudflare.Env = Cloudflare.Env\n> extends WorkflowEntrypoint<Env, AgentWorkflowParams<Params>> {\n  /**\n   * The Agent stub - initialized before run() is called.\n   * Use this.agent to access the Agent's RPC methods.\n   */\n  private _agent!: DurableObjectStub<AgentType>;\n\n  /**\n   * Workflow instance ID\n   */\n  private _workflowId!: string;\n\n  /**\n   * Workflow binding name (for callbacks)\n   */\n  private _workflowName!: string;\n\n  /**\n   * Instance-level guard to prevent double initialization.\n   * Used when a subclass calls super.run() after its own run() was wrapped.\n   */\n  private __agentInitCalled = false;\n\n  /**\n   * Guard to prevent double error notification.\n   * Set to true when reportError() is called explicitly, so the automatic\n   * error catch in the run() wrapper doesn't send a duplicate notification.\n   */\n  private _errorReported = false;\n\n  constructor(ctx: ExecutionContext, env: Env) {\n    super(ctx, env);\n\n    const proto = Object.getPrototypeOf(this);\n\n    // Only wrap if:\n    // 1. This prototype defines its own run method (hasOwnProperty)\n    // 2. It hasn't been wrapped yet (WeakSet check)\n    // This prevents double-wrapping inherited methods and ensures each subclass\n    // that defines run() gets wrapped exactly once.\n    if (Object.hasOwn(proto, \"run\") && !wrappedPrototypes.has(proto)) {\n      const originalRun = proto.run as (\n        event: WorkflowEvent<Params>,\n        step: AgentWorkflowStep\n      ) => Promise<unknown>;\n\n      // Replace the prototype's run method with a wrapper that initializes\n      // the agent before calling the user's implementation\n      proto.run = async function (\n        this: AgentWorkflow<AgentType, Params, ProgressType, Env>,\n        event: WorkflowEvent<AgentWorkflowParams<Params>>,\n        step: WorkflowStep\n      ) {\n        // Instance-level guard: only init once per instance\n        // (prevents double init if super.run() is called from a subclass)\n        if (!this.__agentInitCalled) {\n          const { __agentName, __agentBinding, __workflowName, ...userParams } =\n            event.payload;\n\n          // Initialize agent connection\n          await this._initAgent(\n            __agentName,\n            __agentBinding,\n            __workflowName,\n            event.instanceId\n          );\n          this.__agentInitCalled = true;\n\n          // Pass cleaned event and wrapped step to user's implementation\n          const cleanedEvent = {\n            ...event,\n            payload: userParams as Params\n          } as WorkflowEvent<Params>;\n\n          const wrappedStep = this._wrapStep(step);\n\n          try {\n            return await originalRun.call(this, cleanedEvent, wrappedStep);\n          } catch (err) {\n            await this._autoReportError(err);\n            throw err;\n          }\n        }\n\n        // If already initialized (e.g., called via super.run()),\n        // just call the original with the event as-is\n        try {\n          return await originalRun.call(\n            this,\n            event as WorkflowEvent<Params>,\n            step as AgentWorkflowStep\n          );\n        } catch (err) {\n          await this._autoReportError(err);\n          throw err;\n        }\n      };\n\n      wrappedPrototypes.add(proto);\n    }\n  }\n\n  /**\n   * Initialize the Agent stub from workflow params.\n   * Called automatically before run() executes.\n   */\n  private async _initAgent(\n    agentName: string | undefined,\n    agentBinding: string | undefined,\n    workflowName: string | undefined,\n    instanceId: string\n  ): Promise<void> {\n    if (!agentName || !agentBinding || !workflowName) {\n      throw new Error(\n        \"AgentWorkflow requires __agentName, __agentBinding, and __workflowName in params. \" +\n          \"Use agent.runWorkflow() to start workflows with proper agent context.\"\n      );\n    }\n\n    this._workflowId = instanceId;\n    this._workflowName = workflowName;\n\n    // Get the Agent namespace from env\n    const namespace = (this.env as Record<string, unknown>)[\n      agentBinding\n    ] as DurableObjectNamespace<AgentType>;\n\n    if (!namespace) {\n      throw new Error(\n        `Agent binding '${agentBinding}' not found in environment`\n      );\n    }\n\n    // Get the Agent stub by name\n    this._agent = await getAgentByName<Cloudflare.Env, AgentType>(\n      namespace,\n      agentName\n    );\n  }\n\n  /**\n   * Wrap WorkflowStep with durable Agent communication methods.\n   * Methods added to the wrapped step are idempotent and won't repeat on retry.\n   *\n   * Note: We add methods directly to the step object to preserve instanceof checks\n   * that Cloudflare's runtime may perform on the WorkflowStep class.\n   */\n  private _wrapStep(step: WorkflowStep): AgentWorkflowStep {\n    let stepCounter = 0;\n\n    // Cast step to our extended type and add methods directly\n    // This preserves the original object identity and instanceof relationship\n    const wrappedStep = step as AgentWorkflowStep;\n\n    // Add durable Agent methods directly to the step object\n    wrappedStep.reportComplete = async <T>(result?: T): Promise<void> => {\n      await step.do(`__agent_reportComplete_${stepCounter++}`, async () => {\n        await this.notifyAgent({\n          workflowName: this._workflowName,\n          workflowId: this._workflowId,\n          type: \"complete\",\n          result,\n          timestamp: Date.now()\n        });\n      });\n    };\n\n    wrappedStep.reportError = async (error: Error | string): Promise<void> => {\n      const errorMessage = error instanceof Error ? error.message : error;\n      this._errorReported = true;\n      await step.do(`__agent_reportError_${stepCounter++}`, async () => {\n        await this.notifyAgent({\n          workflowName: this._workflowName,\n          workflowId: this._workflowId,\n          type: \"error\",\n          error: errorMessage,\n          timestamp: Date.now()\n        });\n      });\n    };\n\n    wrappedStep.sendEvent = async <T>(event: T): Promise<void> => {\n      await step.do(`__agent_sendEvent_${stepCounter++}`, async () => {\n        await this.notifyAgent({\n          workflowName: this._workflowName,\n          workflowId: this._workflowId,\n          type: \"event\",\n          event,\n          timestamp: Date.now()\n        });\n      });\n    };\n\n    wrappedStep.updateAgentState = async (state: unknown): Promise<void> => {\n      await step.do(`__agent_updateState_${stepCounter++}`, async () => {\n        await this.agent._workflow_updateState(\"set\", state);\n      });\n    };\n\n    wrappedStep.mergeAgentState = async (\n      partialState: Record<string, unknown>\n    ): Promise<void> => {\n      await step.do(`__agent_mergeState_${stepCounter++}`, async () => {\n        await this.agent._workflow_updateState(\"merge\", partialState);\n      });\n    };\n\n    wrappedStep.resetAgentState = async (): Promise<void> => {\n      await step.do(`__agent_resetState_${stepCounter++}`, async () => {\n        await this.agent._workflow_updateState(\"reset\");\n      });\n    };\n\n    return wrappedStep;\n  }\n\n  /**\n   * Get the Agent stub for RPC calls.\n   * Provides typed access to the Agent's methods.\n   *\n   * @example\n   * ```typescript\n   * // Call any public method on the Agent\n   * await this.agent.updateStatus('processing');\n   * const data = await this.agent.getData();\n   * ```\n   */\n  get agent(): DurableObjectStub<AgentType> {\n    if (!this._agent) {\n      throw new Error(\n        \"Agent not initialized. Ensure you're accessing this.agent inside run().\"\n      );\n    }\n    return this._agent;\n  }\n\n  /**\n   * Get the workflow instance ID\n   */\n  get workflowId(): string {\n    return this._workflowId;\n  }\n\n  /**\n   * Get the workflow binding name\n   */\n  get workflowName(): string {\n    return this._workflowName;\n  }\n\n  /**\n   * Automatically report an unhandled error to the Agent.\n   * Skipped if reportError() was already called (prevents double notification).\n   * Best-effort: notification failures are swallowed so the original error propagates.\n   *\n   * @param err - The caught error\n   */\n  private async _autoReportError(err: unknown): Promise<void> {\n    if (this._errorReported) {\n      return;\n    }\n    this._errorReported = true;\n    const errorMessage = err instanceof Error ? err.message : String(err);\n    try {\n      await this.notifyAgent({\n        workflowName: this._workflowName,\n        workflowId: this._workflowId,\n        type: \"error\",\n        error: errorMessage,\n        timestamp: Date.now()\n      });\n    } catch (_notifyErr) {\n      // Best-effort: don't mask the original error\n    }\n  }\n\n  /**\n   * Send a notification to the Agent via RPC.\n   *\n   * @param callback - Callback payload to send\n   */\n  protected async notifyAgent(callback: WorkflowCallback): Promise<void> {\n    await this.agent._workflow_handleCallback(callback);\n  }\n\n  /**\n   * Report progress to the Agent with typed progress data.\n   * Triggers onWorkflowProgress() on the Agent.\n   *\n   * @param progress - Typed progress data\n   *\n   * @example\n   * ```typescript\n   * // Using default progress type\n   * await this.reportProgress({ step: 'fetch', status: 'running' });\n   * await this.reportProgress({ step: 'fetch', status: 'complete', percent: 0.5 });\n   *\n   * // With custom progress type\n   * await this.reportProgress({ stage: 'extract', recordsProcessed: 100 });\n   * ```\n   */\n  protected async reportProgress(progress: ProgressType): Promise<void> {\n    await this.notifyAgent({\n      workflowName: this._workflowName,\n      workflowId: this._workflowId,\n      type: \"progress\",\n      progress: progress as DefaultProgress,\n      timestamp: Date.now()\n    });\n  }\n\n  /**\n   * Broadcast a message to all connected WebSocket clients via the Agent.\n   * This is non-durable and may repeat on workflow retry.\n   *\n   * @param message - Message to broadcast (will be JSON-stringified)\n   */\n  protected broadcastToClients(message: unknown): void {\n    this.agent._workflow_broadcast(message);\n  }\n\n  /**\n   * Wait for approval from the Agent.\n   * Handles rejection by reporting error (durably) and throwing WorkflowRejectedError.\n   *\n   * @param step - AgentWorkflowStep object\n   * @param options - Wait options (timeout, eventType, stepName)\n   * @returns Approval payload (throws WorkflowRejectedError if rejected)\n   *\n   * @example\n   * ```typescript\n   * const approval = await this.waitForApproval(step, { timeout: '7 days' });\n   * // approval contains the payload from approveWorkflow()\n   * ```\n   */\n  protected async waitForApproval<T = unknown>(\n    step: AgentWorkflowStep,\n    options?: WaitForApprovalOptions\n  ): Promise<T> {\n    const stepName = options?.stepName ?? \"wait-for-approval\";\n    const eventType = options?.eventType ?? \"approval\";\n    const timeout = options?.timeout;\n\n    // Wait for the approval event\n    // Note: Call reportProgress() before this method if you want to update progress\n    const event = await step.waitForEvent(stepName, {\n      type: eventType,\n      timeout\n    });\n\n    // Cast the payload to our expected type\n    const payload = event.payload as {\n      approved: boolean;\n      reason?: string;\n      metadata?: T;\n    };\n\n    // Check if rejected\n    if (!payload.approved) {\n      const reason = payload.reason;\n      await step.reportError(reason ?? \"Workflow rejected\");\n      throw new WorkflowRejectedError(reason, this._workflowId);\n    }\n\n    // Return the approval metadata as the result\n    return payload.metadata as T;\n  }\n}\n\n// Re-export types for convenience\nexport type {\n  AgentWorkflowEvent,\n  AgentWorkflowStep,\n  WorkflowCallback,\n  WorkflowCallbackType,\n  WorkflowProgressCallback,\n  WorkflowCompleteCallback,\n  WorkflowErrorCallback,\n  WorkflowEventCallback,\n  DefaultProgress,\n  WaitForApprovalOptions,\n  ApprovalEventPayload,\n  WorkflowStatus,\n  WorkflowTrackingRow,\n  RunWorkflowOptions,\n  WorkflowEventPayload,\n  WorkflowInfo,\n  WorkflowQueryCriteria,\n  WorkflowPage\n} from \"./workflow-types\";\n\nexport { WorkflowRejectedError } from \"./workflow-types\";\n"],"mappings":"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"}
+{"version":3,"file":"workflows.js","names":[],"sources":["../src/workflows.ts"],"sourcesContent":["/**\n * AgentWorkflow - Base class for Workflows that integrate with Agents\n *\n * Extends Cloudflare's WorkflowEntrypoint to provide seamless access to\n * the Agent that started the workflow, enabling bidirectional communication.\n *\n * @example\n * ```typescript\n * import { AgentWorkflow } from 'agents/workflows';\n * import type { MyAgent } from './agent';\n *\n * type TaskParams = { taskId: string; data: string };\n *\n * export class ProcessingWorkflow extends AgentWorkflow<MyAgent, TaskParams> {\n *   async run(event: AgentWorkflowEvent<TaskParams>, step: WorkflowStep) {\n *     // Access the originating Agent via typed RPC\n *     await this.agent.updateTaskStatus(event.payload.taskId, 'processing');\n *\n *     const result = await step.do('process', async () => {\n *       // ... processing logic\n *       return { processed: true };\n *     });\n *\n *     // Report progress to Agent (typed)\n *     await this.reportProgress({ step: 'process', status: 'complete', percent: 0.5 });\n *\n *     // Broadcast to connected clients\n *     await this.broadcastToClients({ type: 'progress', data: result });\n *\n *     return result;\n *   }\n * }\n * ```\n */\n\nimport { WorkflowEntrypoint } from \"cloudflare:workers\";\nimport type { WorkflowEvent, WorkflowStep } from \"cloudflare:workers\";\nimport { getAgentByName, type Agent } from \"./index\";\nimport type {\n  AgentWorkflowParams,\n  AgentWorkflowStep,\n  WorkflowCallback,\n  DefaultProgress,\n  WaitForApprovalOptions\n} from \"./workflow-types\";\nimport { WorkflowRejectedError } from \"./workflow-types\";\n\n/**\n * WeakSet to track which prototypes have been wrapped.\n * This prevents re-wrapping on subsequent instantiations of the same class.\n */\nconst wrappedPrototypes = new WeakSet<object>();\n\n/**\n * Base class for Workflows that need access to their originating Agent.\n *\n * @template AgentType - The Agent class type (for typed RPC access)\n * @template Params - User-defined params passed to the workflow (optional)\n * @template ProgressType - Type for progress reporting (defaults to DefaultProgress)\n * @template Env - Environment type (defaults to Cloudflare.Env)\n */\nexport class AgentWorkflow<\n  AgentType extends Agent = Agent,\n  Params = unknown,\n  ProgressType = DefaultProgress,\n  Env extends Cloudflare.Env = Cloudflare.Env\n> extends WorkflowEntrypoint<Env, AgentWorkflowParams<Params>> {\n  /**\n   * The Agent stub - initialized before run() is called.\n   * Use this.agent to access the Agent's RPC methods.\n   */\n  private _agent!: DurableObjectStub<AgentType>;\n\n  /**\n   * Workflow instance ID\n   */\n  private _workflowId!: string;\n\n  /**\n   * Workflow binding name (for callbacks)\n   */\n  private _workflowName!: string;\n\n  /**\n   * Instance-level guard to prevent double initialization.\n   * Used when a subclass calls super.run() after its own run() was wrapped.\n   */\n  private __agentInitCalled = false;\n\n  /**\n   * Guard to prevent double error notification.\n   * Set to true when reportError() is called explicitly, so the automatic\n   * error catch in the run() wrapper doesn't send a duplicate notification.\n   */\n  private _errorReported = false;\n\n  constructor(ctx: ExecutionContext, env: Env) {\n    super(ctx, env);\n\n    const proto = Object.getPrototypeOf(this);\n\n    // Only wrap if:\n    // 1. This prototype defines its own run method (hasOwnProperty)\n    // 2. It hasn't been wrapped yet (WeakSet check)\n    // This prevents double-wrapping inherited methods and ensures each subclass\n    // that defines run() gets wrapped exactly once.\n    if (Object.hasOwn(proto, \"run\") && !wrappedPrototypes.has(proto)) {\n      const originalRun = proto.run as (\n        event: WorkflowEvent<Params>,\n        step: AgentWorkflowStep\n      ) => Promise<unknown>;\n\n      // Replace the prototype's run method with a wrapper that initializes\n      // the agent before calling the user's implementation\n      proto.run = async function (\n        this: AgentWorkflow<AgentType, Params, ProgressType, Env>,\n        event: WorkflowEvent<AgentWorkflowParams<Params>>,\n        step: WorkflowStep\n      ) {\n        // Instance-level guard: only init once per instance\n        // (prevents double init if super.run() is called from a subclass)\n        if (!this.__agentInitCalled) {\n          const { __agentName, __agentBinding, __workflowName, ...userParams } =\n            event.payload;\n\n          // Initialize agent connection\n          await this._initAgent(\n            __agentName,\n            __agentBinding,\n            __workflowName,\n            event.instanceId\n          );\n          this.__agentInitCalled = true;\n\n          // Pass cleaned event and wrapped step to user's implementation\n          const cleanedEvent = {\n            ...event,\n            payload: userParams as Params\n          } as WorkflowEvent<Params>;\n\n          const wrappedStep = this._wrapStep(step);\n\n          try {\n            return await originalRun.call(this, cleanedEvent, wrappedStep);\n          } catch (err) {\n            await this._autoReportError(err);\n            throw err;\n          }\n        }\n\n        // If already initialized (e.g., called via super.run()),\n        // just call the original with the event as-is\n        try {\n          return await originalRun.call(\n            this,\n            event as WorkflowEvent<Params>,\n            step as AgentWorkflowStep\n          );\n        } catch (err) {\n          await this._autoReportError(err);\n          throw err;\n        }\n      };\n\n      wrappedPrototypes.add(proto);\n    }\n  }\n\n  /**\n   * Initialize the Agent stub from workflow params.\n   * Called automatically before run() executes.\n   */\n  private async _initAgent(\n    agentName: string | undefined,\n    agentBinding: string | undefined,\n    workflowName: string | undefined,\n    instanceId: string\n  ): Promise<void> {\n    if (!agentName || !agentBinding || !workflowName) {\n      throw new Error(\n        \"AgentWorkflow requires __agentName, __agentBinding, and __workflowName in params. \" +\n          \"Use agent.runWorkflow() to start workflows with proper agent context.\"\n      );\n    }\n\n    this._workflowId = instanceId;\n    this._workflowName = workflowName;\n\n    // Get the Agent namespace from env\n    const namespace = (this.env as Record<string, unknown>)[\n      agentBinding\n    ] as DurableObjectNamespace<AgentType>;\n\n    if (!namespace) {\n      throw new Error(\n        `Agent binding '${agentBinding}' not found in environment`\n      );\n    }\n\n    // Get the Agent stub by name\n    this._agent = await getAgentByName<Cloudflare.Env, AgentType>(\n      namespace,\n      agentName\n    );\n  }\n\n  /**\n   * Wrap WorkflowStep with durable Agent communication methods.\n   * Methods added to the wrapped step are idempotent and won't repeat on retry.\n   *\n   * Note: We add methods directly to the step object to preserve instanceof checks\n   * that Cloudflare's runtime may perform on the WorkflowStep class.\n   */\n  private _wrapStep(step: WorkflowStep): AgentWorkflowStep {\n    let stepCounter = 0;\n\n    // Cast step to our extended type and add methods directly\n    // This preserves the original object identity and instanceof relationship\n    const wrappedStep = step as AgentWorkflowStep;\n\n    // Add durable Agent methods directly to the step object\n    wrappedStep.reportComplete = async <T>(result?: T): Promise<void> => {\n      await step.do(`__agent_reportComplete_${stepCounter++}`, async () => {\n        await this.notifyAgent({\n          workflowName: this._workflowName,\n          workflowId: this._workflowId,\n          type: \"complete\",\n          result,\n          timestamp: Date.now()\n        });\n      });\n    };\n\n    wrappedStep.reportError = async (error: Error | string): Promise<void> => {\n      const errorMessage = error instanceof Error ? error.message : error;\n      this._errorReported = true;\n      await step.do(`__agent_reportError_${stepCounter++}`, async () => {\n        await this.notifyAgent({\n          workflowName: this._workflowName,\n          workflowId: this._workflowId,\n          type: \"error\",\n          error: errorMessage,\n          timestamp: Date.now()\n        });\n      });\n    };\n\n    wrappedStep.sendEvent = async <T>(event: T): Promise<void> => {\n      await step.do(`__agent_sendEvent_${stepCounter++}`, async () => {\n        await this.notifyAgent({\n          workflowName: this._workflowName,\n          workflowId: this._workflowId,\n          type: \"event\",\n          event,\n          timestamp: Date.now()\n        });\n      });\n    };\n\n    wrappedStep.updateAgentState = async (state: unknown): Promise<void> => {\n      await step.do(`__agent_updateState_${stepCounter++}`, async () => {\n        await this.agent._workflow_updateState(\"set\", state);\n      });\n    };\n\n    wrappedStep.mergeAgentState = async (\n      partialState: Record<string, unknown>\n    ): Promise<void> => {\n      await step.do(`__agent_mergeState_${stepCounter++}`, async () => {\n        await this.agent._workflow_updateState(\"merge\", partialState);\n      });\n    };\n\n    wrappedStep.resetAgentState = async (): Promise<void> => {\n      await step.do(`__agent_resetState_${stepCounter++}`, async () => {\n        await this.agent._workflow_updateState(\"reset\");\n      });\n    };\n\n    return wrappedStep;\n  }\n\n  /**\n   * Get the Agent stub for RPC calls.\n   * Provides typed access to the Agent's methods.\n   *\n   * @example\n   * ```typescript\n   * // Call any public method on the Agent\n   * await this.agent.updateStatus('processing');\n   * const data = await this.agent.getData();\n   * ```\n   */\n  get agent(): DurableObjectStub<AgentType> {\n    if (!this._agent) {\n      throw new Error(\n        \"Agent not initialized. Ensure you're accessing this.agent inside run().\"\n      );\n    }\n    return this._agent;\n  }\n\n  /**\n   * Get the workflow instance ID\n   */\n  get workflowId(): string {\n    return this._workflowId;\n  }\n\n  /**\n   * Get the workflow binding name\n   */\n  get workflowName(): string {\n    return this._workflowName;\n  }\n\n  /**\n   * Automatically report an unhandled error to the Agent.\n   * Skipped if reportError() was already called (prevents double notification).\n   * Best-effort: notification failures are swallowed so the original error propagates.\n   *\n   * @param err - The caught error\n   */\n  private async _autoReportError(err: unknown): Promise<void> {\n    if (this._errorReported) {\n      return;\n    }\n    this._errorReported = true;\n    const errorMessage = err instanceof Error ? err.message : String(err);\n    try {\n      await this.notifyAgent({\n        workflowName: this._workflowName,\n        workflowId: this._workflowId,\n        type: \"error\",\n        error: errorMessage,\n        timestamp: Date.now()\n      });\n    } catch (_notifyErr) {\n      // Best-effort: don't mask the original error\n    }\n  }\n\n  /**\n   * Send a notification to the Agent via RPC.\n   *\n   * @param callback - Callback payload to send\n   */\n  protected async notifyAgent(callback: WorkflowCallback): Promise<void> {\n    await this.agent._workflow_handleCallback(callback);\n  }\n\n  /**\n   * Report progress to the Agent with typed progress data.\n   * Triggers onWorkflowProgress() on the Agent.\n   *\n   * @param progress - Typed progress data\n   *\n   * @example\n   * ```typescript\n   * // Using default progress type\n   * await this.reportProgress({ step: 'fetch', status: 'running' });\n   * await this.reportProgress({ step: 'fetch', status: 'complete', percent: 0.5 });\n   *\n   * // With custom progress type\n   * await this.reportProgress({ stage: 'extract', recordsProcessed: 100 });\n   * ```\n   */\n  protected async reportProgress(progress: ProgressType): Promise<void> {\n    await this.notifyAgent({\n      workflowName: this._workflowName,\n      workflowId: this._workflowId,\n      type: \"progress\",\n      progress: progress as DefaultProgress,\n      timestamp: Date.now()\n    });\n  }\n\n  /**\n   * Broadcast a message to all connected WebSocket clients via the Agent.\n   * This is non-durable and may repeat on workflow retry.\n   *\n   * @param message - Message to broadcast (will be JSON-stringified)\n   */\n  protected broadcastToClients(message: unknown): void {\n    this.agent._workflow_broadcast(message);\n  }\n\n  /**\n   * Wait for approval from the Agent.\n   * Handles rejection by reporting error (durably) and throwing WorkflowRejectedError.\n   *\n   * @param step - AgentWorkflowStep object\n   * @param options - Wait options (timeout, eventType, stepName)\n   * @returns Approval payload (throws WorkflowRejectedError if rejected)\n   *\n   * @example\n   * ```typescript\n   * const approval = await this.waitForApproval(step, { timeout: '7 days' });\n   * // approval contains the payload from approveWorkflow()\n   * ```\n   */\n  protected async waitForApproval<T = unknown>(\n    step: AgentWorkflowStep,\n    options?: WaitForApprovalOptions\n  ): Promise<T> {\n    const stepName = options?.stepName ?? \"wait-for-approval\";\n    const eventType = options?.eventType ?? \"approval\";\n    const timeout = options?.timeout;\n\n    // Wait for the approval event\n    // Note: Call reportProgress() before this method if you want to update progress\n    const event = await step.waitForEvent(stepName, {\n      type: eventType,\n      timeout\n    });\n\n    // Cast the payload to our expected type\n    const payload = event.payload as {\n      approved: boolean;\n      reason?: string;\n      metadata?: T;\n    };\n\n    // Check if rejected\n    if (!payload.approved) {\n      const reason = payload.reason;\n      await step.reportError(reason ?? \"Workflow rejected\");\n      throw new WorkflowRejectedError(reason, this._workflowId);\n    }\n\n    // Return the approval metadata as the result\n    return payload.metadata as T;\n  }\n}\n\n// Re-export types for convenience\nexport type {\n  AgentWorkflowEvent,\n  AgentWorkflowStep,\n  WorkflowCallback,\n  WorkflowCallbackType,\n  WorkflowProgressCallback,\n  WorkflowCompleteCallback,\n  WorkflowErrorCallback,\n  WorkflowEventCallback,\n  DefaultProgress,\n  WaitForApprovalOptions,\n  ApprovalEventPayload,\n  WorkflowStatus,\n  WorkflowTrackingRow,\n  RunWorkflowOptions,\n  WorkflowEventPayload,\n  WorkflowInfo,\n  WorkflowQueryCriteria,\n  WorkflowPage\n} from \"./workflow-types\";\n\nexport { WorkflowRejectedError } from \"./workflow-types\";\n"],"mappings":"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"}

package/package.json

@@ -9,7 +9,7 @@
     "durable objects"
   ],
   "type": "module",
-  "version": "0.12.2",
+  "version": "0.12.4",
   "license": "MIT",
   "repository": {
     "directory": "packages/agents",
@@ -31,22 +31,22 @@
     "cron-schedule": "^6.0.0",
     "mimetext": "^3.0.28",
     "nanoid": "^5.1.11",
-    "partyserver": "^0.5.5",
-    "partysocket": "1.1.18",
+    "partyserver": "^0.5.6",
+    "partysocket": "1.1.19",
     "yargs": "^18.0.0"
   },
   "devDependencies": {
-    "@ai-sdk/react": "^3.0.176",
-    "@tanstack/ai": "^0.14.0",
+    "@ai-sdk/react": "^3.0.182",
+    "@tanstack/ai": "^0.16.0",
     "@types/react": "^19.2.14",
     "@types/yargs": "^17.0.35",
-    "@vitest/browser-playwright": "^4.1.5",
+    "@vitest/browser-playwright": "^4.1.6",
     "@x402/core": "^2.11.0",
     "@x402/evm": "^2.11.0",
-    "ai": "^6.0.174",
-    "react": "^19.2.5",
+    "ai": "^6.0.180",
+    "react": "^19.2.6",
     "vitest-browser-react": "^2.2.0",
-    "zod": "^4.4.2"
+    "zod": "^4.4.3"
   },
   "peerDependencies": {
     "@cloudflare/ai-chat": ">=0.6.1 <1.0.0",

package/dist/serializable-Brg7fRds.d.ts

@@ -1,131 +0,0 @@
-//#region src/serializable.d.ts
-type SerializablePrimitive = undefined | null | string | number | boolean;
-type NonSerializable =
-  | Function
-  | symbol
-  | bigint
-  | Date
-  | RegExp
-  | Map<unknown, unknown>
-  | Set<unknown>
-  | WeakMap<object, unknown>
-  | WeakSet<object>
-  | Error
-  | ArrayBuffer
-  | SharedArrayBuffer
-  | DataView
-  | Int8Array
-  | Uint8Array
-  | Uint8ClampedArray
-  | Int16Array
-  | Uint16Array
-  | Int32Array
-  | Uint32Array
-  | Float32Array
-  | Float64Array
-  | BigInt64Array
-  | BigUint64Array;
-type MaxDepth = [0, 0, 0, 0, 0, 0, 0, 0, 0, 0];
-type Increment<D extends unknown[]> = [0, ...D];
-type IsMaxDepth<D extends unknown[]> = D["length"] extends MaxDepth["length"]
-  ? true
-  : false;
-type SerializableValue =
-  | undefined
-  | null
-  | string
-  | number
-  | boolean
-  | {
-      [key: string]: SerializableValue;
-    }
-  | SerializableValue[];
-type CanSerialize<T, Seen = never, Depth extends unknown[] = []> =
-  IsMaxDepth<Depth> extends true
-    ? true
-    : T extends Seen
-      ? true
-      : T extends SerializablePrimitive
-        ? true
-        : T extends NonSerializable
-          ? false
-          : T extends readonly (infer U)[]
-            ? CanSerialize<U, Seen | T, Increment<Depth>>
-            : T extends object
-              ? unknown extends T
-                ? true
-                : {
-                      [K in keyof T]: CanSerialize<
-                        T[K],
-                        Seen | T,
-                        Increment<Depth>
-                      >;
-                    } extends { [K in keyof T]: true }
-                  ? true
-                  : false
-              : true;
-type CanSerializeReturn<T> = T extends void
-  ? true
-  : T extends Promise<infer U>
-    ? CanSerialize<U>
-    : CanSerialize<T>;
-type SerializableReturnValue =
-  | SerializableValue
-  | void
-  | Promise<SerializableValue>
-  | Promise<void>;
-type IsSerializableParam<T, Seen = never, Depth extends unknown[] = []> =
-  IsMaxDepth<Depth> extends true
-    ? true
-    : T extends Seen
-      ? true
-      : T extends SerializablePrimitive
-        ? true
-        : T extends NonSerializable
-          ? false
-          : T extends readonly (infer U)[]
-            ? IsSerializableParam<U, Seen | T, Increment<Depth>>
-            : T extends object
-              ? unknown extends T
-                ? true
-                : {
-                      [K in keyof T]: IsSerializableParam<
-                        T[K],
-                        Seen | T,
-                        Increment<Depth>
-                      >;
-                    } extends { [K in keyof T]: true }
-                  ? true
-                  : false
-              : true;
-type AllSerializableValues<A> = A extends [infer First, ...infer Rest]
-  ? IsSerializableParam<First> extends true
-    ? AllSerializableValues<Rest>
-    : false
-  : true;
-type Method = (...args: any[]) => any;
-type IsUnknown<T> = [unknown] extends [T]
-  ? [T] extends [unknown]
-    ? true
-    : false
-  : false;
-type UnwrapPromise<T> = T extends Promise<infer U> ? U : T;
-type RPCMethod<T = Method> = T extends Method
-  ? T extends (...arg: infer A) => infer R
-    ? AllSerializableValues<A> extends true
-      ? CanSerializeReturn<R> extends true
-        ? T
-        : IsUnknown<UnwrapPromise<R>> extends true
-          ? T
-          : never
-      : never
-    : never
-  : never;
-//#endregion
-export {
-  SerializableValue as i,
-  RPCMethod as n,
-  SerializableReturnValue as r,
-  Method as t
-};
-//# sourceMappingURL=serializable-Brg7fRds.d.ts.map