agents 0.3.6 → 0.3.8

package/dist/workflow-types-Z_Oem1FJ.d.ts

@@ -0,0 +1,260 @@
+import {
+  WorkflowEvent,
+  WorkflowSleepDuration,
+  WorkflowStep
+} from "cloudflare:workers";
+
+//#region src/workflow-types.d.ts
+/**
+ * Type alias for WorkflowEvent in AgentWorkflow context.
+ * Identical to WorkflowEvent - provided for naming consistency with AgentWorkflowStep.
+ */
+type AgentWorkflowEvent<Params = unknown> = WorkflowEvent<Params>;
+/**
+ * Extended WorkflowStep with durable Agent communication methods.
+ * All added methods on this interface are durable - they're idempotent and won't
+ * repeat on workflow retry.
+ */
+interface AgentWorkflowStep extends WorkflowStep {
+  /**
+   * Report successful completion to the Agent (durable).
+   * Triggers onWorkflowComplete() on the Agent.
+   * @param result - Optional result data
+   */
+  reportComplete<T = unknown>(result?: T): Promise<void>;
+  /**
+   * Report an error to the Agent (durable).
+   * Triggers onWorkflowError() on the Agent.
+   * @param error - Error or error message
+   */
+  reportError(error: Error | string): Promise<void>;
+  /**
+   * Send a custom event to the Agent (durable).
+   * Triggers onWorkflowEvent() on the Agent.
+   * @param event - Custom event payload
+   */
+  sendEvent<T = unknown>(event: T): Promise<void>;
+  /**
+   * Update the Agent's state entirely (durable).
+   * This will replace the Agent's state and broadcast to all connected clients.
+   * @param state - New state to set
+   */
+  updateAgentState(state: unknown): Promise<void>;
+  /**
+   * Merge partial state into the Agent's existing state (durable).
+   * Performs a shallow merge and broadcasts to all connected clients.
+   * @param partialState - Partial state to merge
+   */
+  mergeAgentState(partialState: Record<string, unknown>): Promise<void>;
+  /**
+   * Reset the Agent's state to its initialState (durable).
+   * Broadcasts the reset state to all connected clients.
+   */
+  resetAgentState(): Promise<void>;
+}
+/**
+ * Internal parameters injected by runWorkflow() to identify the originating Agent
+ */
+type AgentWorkflowInternalParams = {
+  /** Name/ID of the Agent that started this workflow */ __agentName: string; /** Environment binding name for the Agent's namespace */
+  __agentBinding: string; /** Workflow binding name (for callbacks) */
+  __workflowName: string;
+};
+/**
+ * Combined workflow params: user params + internal agent params
+ */
+type AgentWorkflowParams<T = unknown> = T & AgentWorkflowInternalParams;
+/**
+ * Workflow callback types for Agent-Workflow communication
+ */
+type WorkflowCallbackType = "progress" | "complete" | "error" | "event";
+/**
+ * Base callback structure sent from Workflow to Agent
+ */
+type WorkflowCallbackBase = {
+  /** Workflow binding name */ workflowName: string; /** ID of the workflow instance */
+  workflowId: string; /** Type of callback */
+  type: WorkflowCallbackType; /** Timestamp when callback was sent */
+  timestamp: number;
+};
+/**
+ * Default progress type - covers common use cases.
+ * Developers can define their own progress type for domain-specific needs.
+ */
+type DefaultProgress = {
+  /** Current step name */ step?: string; /** Step/overall status */
+  status?:
+    | "pending"
+    | "running"
+    | "complete"
+    | "error"; /** Human-readable message */
+  message?: string; /** Progress percentage (0-1) */
+  percent?: number; /** Allow additional custom fields */
+  [key: string]: unknown;
+};
+/**
+ * Progress callback - reports workflow progress with typed payload
+ */
+type WorkflowProgressCallback<P = DefaultProgress> = WorkflowCallbackBase & {
+  type: "progress"; /** Typed progress data */
+  progress: P;
+};
+/**
+ * Complete callback - workflow finished successfully
+ */
+type WorkflowCompleteCallback = WorkflowCallbackBase & {
+  type: "complete"; /** Result of the workflow */
+  result?: unknown;
+};
+/**
+ * Error callback - workflow encountered an error
+ */
+type WorkflowErrorCallback = WorkflowCallbackBase & {
+  type: "error"; /** Error message */
+  error: string;
+};
+/**
+ * Event callback - custom event from workflow
+ */
+type WorkflowEventCallback = WorkflowCallbackBase & {
+  type: "event"; /** Custom event payload */
+  event: unknown;
+};
+/**
+ * Union of all callback types
+ */
+type WorkflowCallback<P = DefaultProgress> =
+  | WorkflowProgressCallback<P>
+  | WorkflowCompleteCallback
+  | WorkflowErrorCallback
+  | WorkflowEventCallback;
+/**
+ * Workflow status values - derived from Cloudflare's InstanceStatus
+ */
+type WorkflowStatus = InstanceStatus["status"];
+/**
+ * Row structure for cf_agents_workflows tracking table
+ */
+type WorkflowTrackingRow = {
+  /** Internal row ID (UUID) */ id: string; /** Cloudflare Workflow instance ID */
+  workflow_id: string; /** Workflow binding name */
+  workflow_name: string; /** Current workflow status */
+  status: WorkflowStatus; /** JSON-serialized metadata for querying */
+  metadata: string | null; /** Error name if workflow failed */
+  error_name: string | null; /** Error message if workflow failed */
+  error_message: string | null; /** Unix timestamp when workflow was created */
+  created_at: number; /** Unix timestamp when workflow was last updated */
+  updated_at: number; /** Unix timestamp when workflow completed (null if not complete) */
+  completed_at: number | null;
+};
+/**
+ * Options for runWorkflow()
+ */
+type RunWorkflowOptions = {
+  /** Custom workflow instance ID (auto-generated if not provided) */ id?: string; /** Optional metadata for querying (stored as JSON) */
+  metadata?: Record<
+    string,
+    unknown
+  >; /** Agent binding name (auto-detected from class name if not provided) */
+  agentBinding?: string;
+};
+/**
+ * Event payload for sendWorkflowEvent()
+ */
+type WorkflowEventPayload = {
+  /** Event type name */ type: string; /** Event payload data */
+  payload: unknown;
+};
+/**
+ * Parsed workflow tracking info returned by getWorkflow()
+ */
+type WorkflowInfo = {
+  /** Internal row ID */ id: string; /** Cloudflare Workflow instance ID */
+  workflowId: string; /** Workflow binding name */
+  workflowName: string; /** Current workflow status */
+  status: WorkflowStatus; /** Metadata (parsed from JSON) */
+  metadata: Record<string, unknown> | null; /** Error info if workflow failed */
+  error: {
+    name: string;
+    message: string;
+  } | null; /** When workflow was created */
+  createdAt: Date; /** When workflow was last updated */
+  updatedAt: Date; /** When workflow completed (null if not complete) */
+  completedAt: Date | null;
+};
+/**
+ * Criteria for querying tracked workflows
+ */
+type WorkflowQueryCriteria = {
+  /** Filter by status */ status?:
+    | WorkflowStatus
+    | WorkflowStatus[]; /** Filter by workflow binding name */
+  workflowName?: string; /** Filter by metadata key-value pairs (exact match) */
+  metadata?: Record<
+    string,
+    string | number | boolean
+  >; /** Limit number of results (default 50, max 100) */
+  limit?: number; /** Order by created_at */
+  orderBy?:
+    | "asc"
+    | "desc"; /** Cursor for pagination (from previous WorkflowPage.nextCursor) */
+  cursor?: string;
+};
+/**
+ * Paginated result from getWorkflows()
+ */
+type WorkflowPage = {
+  /** Workflows for this page */ workflows: WorkflowInfo[]; /** Total count of workflows matching the criteria (ignoring pagination) */
+  total: number; /** Cursor for next page, or null if no more pages */
+  nextCursor: string | null;
+};
+/**
+ * Standard approval event payload used by approveWorkflow/rejectWorkflow
+ */
+type ApprovalEventPayload = {
+  /** Whether the workflow was approved */ approved: boolean; /** Optional reason for approval/rejection */
+  reason?: string; /** Optional additional metadata */
+  metadata?: Record<string, unknown>;
+};
+/**
+ * Options for waitForApproval()
+ */
+type WaitForApprovalOptions = {
+  /** Step name for waitForEvent (default: "wait-for-approval") */ stepName?: string; /** Timeout duration (e.g., "7 days") */
+  timeout?: WorkflowSleepDuration; /** Event type to wait for (default: "approval") */
+  eventType?: string;
+};
+/**
+ * Error thrown when a workflow is rejected via rejectWorkflow()
+ */
+declare class WorkflowRejectedError extends Error {
+  readonly reason?: string | undefined;
+  readonly workflowId?: string | undefined;
+  constructor(reason?: string | undefined, workflowId?: string | undefined);
+}
+//#endregion
+export {
+  WorkflowTrackingRow as S,
+  WorkflowPage as _,
+  ApprovalEventPayload as a,
+  WorkflowRejectedError as b,
+  WaitForApprovalOptions as c,
+  WorkflowCallbackType as d,
+  WorkflowCompleteCallback as f,
+  WorkflowInfo as g,
+  WorkflowEventPayload as h,
+  AgentWorkflowStep as i,
+  WorkflowCallback as l,
+  WorkflowEventCallback as m,
+  AgentWorkflowInternalParams as n,
+  DefaultProgress as o,
+  WorkflowErrorCallback as p,
+  AgentWorkflowParams as r,
+  RunWorkflowOptions as s,
+  AgentWorkflowEvent as t,
+  WorkflowCallbackBase as u,
+  WorkflowProgressCallback as v,
+  WorkflowStatus as x,
+  WorkflowQueryCriteria as y
+};
+//# sourceMappingURL=workflow-types-Z_Oem1FJ.d.ts.map

package/dist/workflow-types.d.ts

@@ -0,0 +1,48 @@
+import {
+  S as WorkflowTrackingRow,
+  _ as WorkflowPage,
+  a as ApprovalEventPayload,
+  b as WorkflowRejectedError,
+  c as WaitForApprovalOptions,
+  d as WorkflowCallbackType,
+  f as WorkflowCompleteCallback,
+  g as WorkflowInfo,
+  h as WorkflowEventPayload,
+  i as AgentWorkflowStep,
+  l as WorkflowCallback,
+  m as WorkflowEventCallback,
+  n as AgentWorkflowInternalParams,
+  o as DefaultProgress,
+  p as WorkflowErrorCallback,
+  r as AgentWorkflowParams,
+  s as RunWorkflowOptions,
+  t as AgentWorkflowEvent,
+  u as WorkflowCallbackBase,
+  v as WorkflowProgressCallback,
+  x as WorkflowStatus,
+  y as WorkflowQueryCriteria
+} from "./workflow-types-Z_Oem1FJ.js";
+export {
+  AgentWorkflowEvent,
+  AgentWorkflowInternalParams,
+  AgentWorkflowParams,
+  AgentWorkflowStep,
+  ApprovalEventPayload,
+  DefaultProgress,
+  RunWorkflowOptions,
+  WaitForApprovalOptions,
+  WorkflowCallback,
+  WorkflowCallbackBase,
+  WorkflowCallbackType,
+  WorkflowCompleteCallback,
+  WorkflowErrorCallback,
+  WorkflowEventCallback,
+  WorkflowEventPayload,
+  WorkflowInfo,
+  WorkflowPage,
+  WorkflowProgressCallback,
+  WorkflowQueryCriteria,
+  WorkflowRejectedError,
+  WorkflowStatus,
+  WorkflowTrackingRow
+};

package/dist/workflow-types.js

@@ -0,0 +1,16 @@
+//#region src/workflow-types.ts
+/**
+* Error thrown when a workflow is rejected via rejectWorkflow()
+*/
+var WorkflowRejectedError = class extends Error {
+	constructor(reason, workflowId) {
+		super(reason ? `Workflow rejected: ${reason}` : "Workflow rejected");
+		this.reason = reason;
+		this.workflowId = workflowId;
+		this.name = "WorkflowRejectedError";
+	}
+};
+
+//#endregion
+export { WorkflowRejectedError };
+//# sourceMappingURL=workflow-types.js.map

package/dist/workflow-types.js.map

@@ -0,0 +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,AAAgB,QAChB,AAAgB,YAChB;AACA,QAAM,SAAS,sBAAsB,WAAW,oBAAoB;EAHpD;EACA;AAGhB,OAAK,OAAO"}

package/dist/workflows.d.ts

@@ -0,0 +1,163 @@
+import "./internal_context-CEu5ji80.js";
+import "./email-8ljcpvwV.js";
+import "./client-DGpERepg.js";
+import {
+  S as WorkflowTrackingRow,
+  _ as WorkflowPage,
+  a as ApprovalEventPayload,
+  b as WorkflowRejectedError,
+  c as WaitForApprovalOptions,
+  d as WorkflowCallbackType,
+  f as WorkflowCompleteCallback,
+  g as WorkflowInfo,
+  h as WorkflowEventPayload,
+  i as AgentWorkflowStep,
+  l as WorkflowCallback,
+  m as WorkflowEventCallback,
+  o as DefaultProgress,
+  p as WorkflowErrorCallback,
+  r as AgentWorkflowParams,
+  s as RunWorkflowOptions,
+  t as AgentWorkflowEvent,
+  v as WorkflowProgressCallback,
+  x as WorkflowStatus,
+  y as WorkflowQueryCriteria
+} from "./workflow-types-Z_Oem1FJ.js";
+import { Agent } from "./index.js";
+import { WorkflowEntrypoint } from "cloudflare:workers";
+
+//#region src/workflows.d.ts
+/**
+ * Base class for Workflows that need access to their originating Agent.
+ *
+ * @template AgentType - The Agent class type (for typed RPC access)
+ * @template Params - User-defined params passed to the workflow (optional)
+ * @template ProgressType - Type for progress reporting (defaults to DefaultProgress)
+ * @template Env - Environment type (defaults to Cloudflare.Env)
+ */
+declare class AgentWorkflow<
+  AgentType extends Agent = Agent,
+  Params = unknown,
+  ProgressType = DefaultProgress,
+  Env extends Cloudflare.Env = Cloudflare.Env
+> extends WorkflowEntrypoint<Env, AgentWorkflowParams<Params>> {
+  /**
+   * The Agent stub - initialized before run() is called.
+   * Use this.agent to access the Agent's RPC methods.
+   */
+  private _agent;
+  /**
+   * Workflow instance ID
+   */
+  private _workflowId;
+  /**
+   * Workflow binding name (for callbacks)
+   */
+  private _workflowName;
+  constructor(ctx: ExecutionContext, env: Env);
+  /**
+   * Initialize the Agent stub from workflow params.
+   * Called automatically before run() executes.
+   */
+  private _initAgent;
+  /**
+   * Wrap WorkflowStep with durable Agent communication methods.
+   * Methods added to the wrapped step are idempotent and won't repeat on retry.
+   *
+   * Note: We add methods directly to the step object to preserve instanceof checks
+   * that Cloudflare's runtime may perform on the WorkflowStep class.
+   */
+  private _wrapStep;
+  /**
+   * Get the Agent stub for RPC calls.
+   * Provides typed access to the Agent's methods.
+   *
+   * @example
+   * ```typescript
+   * // Call any public method on the Agent
+   * await this.agent.updateStatus('processing');
+   * const data = await this.agent.getData();
+   * ```
+   */
+  get agent(): DurableObjectStub<AgentType>;
+  /**
+   * Get the workflow instance ID
+   */
+  get workflowId(): string;
+  /**
+   * Get the workflow binding name
+   */
+  get workflowName(): string;
+  /**
+   * Send a notification to the Agent via RPC.
+   *
+   * @param callback - Callback payload to send
+   */
+  protected notifyAgent(callback: WorkflowCallback): Promise<void>;
+  /**
+   * Report progress to the Agent with typed progress data.
+   * Triggers onWorkflowProgress() on the Agent.
+   *
+   * @param progress - Typed progress data
+   *
+   * @example
+   * ```typescript
+   * // Using default progress type
+   * await this.reportProgress({ step: 'fetch', status: 'running' });
+   * await this.reportProgress({ step: 'fetch', status: 'complete', percent: 0.5 });
+   *
+   * // With custom progress type
+   * await this.reportProgress({ stage: 'extract', recordsProcessed: 100 });
+   * ```
+   */
+  protected reportProgress(progress: ProgressType): Promise<void>;
+  /**
+   * Broadcast a message to all connected WebSocket clients via the Agent.
+   * This is non-durable and may repeat on workflow retry.
+   *
+   * @param message - Message to broadcast (will be JSON-stringified)
+   */
+  protected broadcastToClients(message: unknown): void;
+  /**
+   * Wait for approval from the Agent.
+   * Handles rejection by reporting error (durably) and throwing WorkflowRejectedError.
+   *
+   * @param step - AgentWorkflowStep object
+   * @param options - Wait options (timeout, eventType, stepName)
+   * @returns Approval payload (throws WorkflowRejectedError if rejected)
+   *
+   * @example
+   * ```typescript
+   * const approval = await this.waitForApproval(step, { timeout: '7 days' });
+   * // approval contains the payload from approveWorkflow()
+   * ```
+   */
+  protected waitForApproval<T = unknown>(
+    step: AgentWorkflowStep,
+    options?: WaitForApprovalOptions
+  ): Promise<T>;
+}
+//#endregion
+export {
+  AgentWorkflow,
+  type AgentWorkflowEvent,
+  type AgentWorkflowStep,
+  type ApprovalEventPayload,
+  type DefaultProgress,
+  type RunWorkflowOptions,
+  type WaitForApprovalOptions,
+  type WorkflowCallback,
+  type WorkflowCallbackType,
+  type WorkflowCompleteCallback,
+  type WorkflowErrorCallback,
+  type WorkflowEventCallback,
+  type WorkflowEventPayload,
+  type WorkflowInfo,
+  type WorkflowPage,
+  type WorkflowProgressCallback,
+  type WorkflowQueryCriteria,
+  WorkflowRejectedError,
+  type WorkflowStatus,
+  type WorkflowTrackingRow
+};
+//# sourceMappingURL=workflows.d.ts.map