agents 0.7.4 → 0.7.6

package/dist/retries.js.map

@@ -1 +1 @@
-{"version":3,"file":"retries.js","names":[],"sources":["../src/retries.ts"],"sourcesContent":["/**\n * Retry options for schedule(), scheduleEvery(), queue(), and this.retry().\n */\nexport interface RetryOptions {\n  /** Max number of attempts (including the first). Default: 3 */\n  maxAttempts?: number;\n  /** Base delay in ms for exponential backoff. Default: 100 */\n  baseDelayMs?: number;\n  /** Max delay cap in ms. Default: 3000 */\n  maxDelayMs?: number;\n}\n\n/**\n * Internal options for tryN -- extends RetryOptions with a shouldRetry predicate.\n */\ninterface TryNOptions extends RetryOptions {\n  /**\n   * Predicate to determine if an error should be retried.\n   * Receives the error and the next attempt number (so callers can\n   * make attempt-aware decisions).\n   * If not provided, all errors are retried.\n   */\n  shouldRetry?: (err: unknown, nextAttempt: number) => boolean;\n}\n\n/**\n * Validate retry options eagerly so invalid config fails at enqueue/schedule time\n * rather than at execution time. Checks individual field ranges, enforces integer\n * maxAttempts, and validates cross-field constraints after resolving against\n * defaults when provided.\n */\nexport function validateRetryOptions(\n  options: RetryOptions,\n  defaults?: Required<RetryOptions>\n): void {\n  if (options.maxAttempts !== undefined) {\n    if (!Number.isFinite(options.maxAttempts) || options.maxAttempts < 1) {\n      throw new Error(\"retry.maxAttempts must be >= 1\");\n    }\n    if (!Number.isInteger(options.maxAttempts)) {\n      throw new Error(\"retry.maxAttempts must be an integer\");\n    }\n  }\n  if (options.baseDelayMs !== undefined) {\n    if (!Number.isFinite(options.baseDelayMs) || options.baseDelayMs <= 0) {\n      throw new Error(\"retry.baseDelayMs must be > 0\");\n    }\n  }\n  if (options.maxDelayMs !== undefined) {\n    if (!Number.isFinite(options.maxDelayMs) || options.maxDelayMs <= 0) {\n      throw new Error(\"retry.maxDelayMs must be > 0\");\n    }\n  }\n\n  // Resolve against defaults (when provided) so that cross-field checks\n  // catch e.g. { baseDelayMs: 5000 } against default maxDelayMs: 3000.\n  const resolvedBase = options.baseDelayMs ?? defaults?.baseDelayMs;\n  const resolvedMax = options.maxDelayMs ?? defaults?.maxDelayMs;\n  if (\n    resolvedBase !== undefined &&\n    resolvedMax !== undefined &&\n    resolvedBase > resolvedMax\n  ) {\n    throw new Error(\"retry.baseDelayMs must be <= retry.maxDelayMs\");\n  }\n}\n\n/**\n * Returns the number of milliseconds to wait before retrying a request.\n * Uses the \"Full Jitter\" approach from\n * https://aws.amazon.com/blogs/architecture/exponential-backoff-and-jitter/\n *\n * @param attempt The current attempt number (1-indexed).\n * @param baseDelayMs Base delay multiplier in ms.\n * @param maxDelayMs Maximum delay cap in ms.\n * @returns Milliseconds to wait before retrying.\n */\nexport function jitterBackoff(\n  attempt: number,\n  baseDelayMs: number,\n  maxDelayMs: number\n): number {\n  const upperBoundMs = Math.min(2 ** attempt * baseDelayMs, maxDelayMs);\n  return Math.floor(Math.random() * upperBoundMs);\n}\n\n/**\n * Retry an async function up to `n` total attempts with jittered exponential backoff.\n *\n * @param n Total number of attempts (must be a finite integer >= 1).\n * @param fn The async function to retry. Receives the current attempt number (1-indexed).\n * @param options Retry configuration.\n * @returns The result of `fn` on success.\n * @throws The last error if all attempts fail or `shouldRetry` returns false.\n */\nexport async function tryN<T>(\n  n: number,\n  fn: (attempt: number) => Promise<T>,\n  options?: TryNOptions\n): Promise<T> {\n  if (!Number.isFinite(n) || n < 1) {\n    throw new Error(\"retry.maxAttempts must be >= 1\");\n  }\n  n = Math.floor(n);\n\n  const rawBase = options?.baseDelayMs ?? 100;\n  const rawMax = options?.maxDelayMs ?? 3000;\n\n  if (!Number.isFinite(rawBase) || rawBase <= 0) {\n    throw new Error(\"retry.baseDelayMs must be > 0\");\n  }\n  if (!Number.isFinite(rawMax) || rawMax <= 0) {\n    throw new Error(\"retry.maxDelayMs must be > 0\");\n  }\n\n  const baseDelayMs = Math.floor(rawBase);\n  const maxDelayMs = Math.floor(rawMax);\n\n  if (baseDelayMs > maxDelayMs) {\n    throw new Error(\"retry.baseDelayMs must be <= retry.maxDelayMs\");\n  }\n\n  let attempt = 1;\n  while (true) {\n    try {\n      return await fn(attempt);\n    } catch (err) {\n      const nextAttempt = attempt + 1;\n      if (\n        nextAttempt > n ||\n        (options?.shouldRetry && !options.shouldRetry(err, nextAttempt))\n      ) {\n        throw err;\n      }\n      const delay = jitterBackoff(attempt, baseDelayMs, maxDelayMs);\n      await new Promise((resolve) => setTimeout(resolve, delay));\n      attempt = nextAttempt;\n    }\n  }\n}\n\n/**\n * Returns true if the given error is retryable according to Durable Object error handling.\n * See https://developers.cloudflare.com/durable-objects/best-practices/error-handling/\n *\n * An error is retryable if it has `retryable: true` but is NOT an overloaded error.\n */\nexport function isErrorRetryable(err: unknown): boolean {\n  if (typeof err !== \"object\" || err === null) {\n    return false;\n  }\n  const msg = String(err);\n  const typed = err as { retryable?: boolean; overloaded?: boolean };\n  return (\n    Boolean(typed.retryable) &&\n    !typed.overloaded &&\n    !msg.includes(\"Durable Object is overloaded\")\n  );\n}\n"],"mappings":";;;;;;;AA+BA,SAAgB,qBACd,SACA,UACM;AACN,KAAI,QAAQ,gBAAgB,QAAW;AACrC,MAAI,CAAC,OAAO,SAAS,QAAQ,YAAY,IAAI,QAAQ,cAAc,EACjE,OAAM,IAAI,MAAM,iCAAiC;AAEnD,MAAI,CAAC,OAAO,UAAU,QAAQ,YAAY,CACxC,OAAM,IAAI,MAAM,uCAAuC;;AAG3D,KAAI,QAAQ,gBAAgB,QAC1B;MAAI,CAAC,OAAO,SAAS,QAAQ,YAAY,IAAI,QAAQ,eAAe,EAClE,OAAM,IAAI,MAAM,gCAAgC;;AAGpD,KAAI,QAAQ,eAAe,QACzB;MAAI,CAAC,OAAO,SAAS,QAAQ,WAAW,IAAI,QAAQ,cAAc,EAChE,OAAM,IAAI,MAAM,+BAA+B;;CAMnD,MAAM,eAAe,QAAQ,eAAe,UAAU;CACtD,MAAM,cAAc,QAAQ,cAAc,UAAU;AACpD,KACE,iBAAiB,UACjB,gBAAgB,UAChB,eAAe,YAEf,OAAM,IAAI,MAAM,gDAAgD;;;;;;;;;;;;AAcpE,SAAgB,cACd,SACA,aACA,YACQ;CACR,MAAM,eAAe,KAAK,IAAI,KAAK,UAAU,aAAa,WAAW;AACrE,QAAO,KAAK,MAAM,KAAK,QAAQ,GAAG,aAAa;;;;;;;;;;;AAYjD,eAAsB,KACpB,GACA,IACA,SACY;AACZ,KAAI,CAAC,OAAO,SAAS,EAAE,IAAI,IAAI,EAC7B,OAAM,IAAI,MAAM,iCAAiC;AAEnD,KAAI,KAAK,MAAM,EAAE;CAEjB,MAAM,UAAU,SAAS,eAAe;CACxC,MAAM,SAAS,SAAS,cAAc;AAEtC,KAAI,CAAC,OAAO,SAAS,QAAQ,IAAI,WAAW,EAC1C,OAAM,IAAI,MAAM,gCAAgC;AAElD,KAAI,CAAC,OAAO,SAAS,OAAO,IAAI,UAAU,EACxC,OAAM,IAAI,MAAM,+BAA+B;CAGjD,MAAM,cAAc,KAAK,MAAM,QAAQ;CACvC,MAAM,aAAa,KAAK,MAAM,OAAO;AAErC,KAAI,cAAc,WAChB,OAAM,IAAI,MAAM,gDAAgD;CAGlE,IAAI,UAAU;AACd,QAAO,KACL,KAAI;AACF,SAAO,MAAM,GAAG,QAAQ;UACjB,KAAK;EACZ,MAAM,cAAc,UAAU;AAC9B,MACE,cAAc,KACb,SAAS,eAAe,CAAC,QAAQ,YAAY,KAAK,YAAY,CAE/D,OAAM;EAER,MAAM,QAAQ,cAAc,SAAS,aAAa,WAAW;AAC7D,QAAM,IAAI,SAAS,YAAY,WAAW,SAAS,MAAM,CAAC;AAC1D,YAAU;;;;;;;;;AAWhB,SAAgB,iBAAiB,KAAuB;AACtD,KAAI,OAAO,QAAQ,YAAY,QAAQ,KACrC,QAAO;CAET,MAAM,MAAM,OAAO,IAAI;CACvB,MAAM,QAAQ;AACd,QACE,QAAQ,MAAM,UAAU,IACxB,CAAC,MAAM,cACP,CAAC,IAAI,SAAS,+BAA+B"}
+{"version":3,"file":"retries.js","names":[],"sources":["../src/retries.ts"],"sourcesContent":["/**\n * Retry options for schedule(), scheduleEvery(), queue(), and this.retry().\n */\nexport interface RetryOptions {\n  /** Max number of attempts (including the first). Default: 3 */\n  maxAttempts?: number;\n  /** Base delay in ms for exponential backoff. Default: 100 */\n  baseDelayMs?: number;\n  /** Max delay cap in ms. Default: 3000 */\n  maxDelayMs?: number;\n}\n\n/**\n * Internal options for tryN -- extends RetryOptions with a shouldRetry predicate.\n */\ninterface TryNOptions extends RetryOptions {\n  /**\n   * Predicate to determine if an error should be retried.\n   * Receives the error and the next attempt number (so callers can\n   * make attempt-aware decisions).\n   * If not provided, all errors are retried.\n   */\n  shouldRetry?: (err: unknown, nextAttempt: number) => boolean;\n}\n\n/**\n * Validate retry options eagerly so invalid config fails at enqueue/schedule time\n * rather than at execution time. Checks individual field ranges, enforces integer\n * maxAttempts, and validates cross-field constraints after resolving against\n * defaults when provided.\n */\nexport function validateRetryOptions(\n  options: RetryOptions,\n  defaults?: Required<RetryOptions>\n): void {\n  if (options.maxAttempts !== undefined) {\n    if (!Number.isFinite(options.maxAttempts) || options.maxAttempts < 1) {\n      throw new Error(\"retry.maxAttempts must be >= 1\");\n    }\n    if (!Number.isInteger(options.maxAttempts)) {\n      throw new Error(\"retry.maxAttempts must be an integer\");\n    }\n  }\n  if (options.baseDelayMs !== undefined) {\n    if (!Number.isFinite(options.baseDelayMs) || options.baseDelayMs <= 0) {\n      throw new Error(\"retry.baseDelayMs must be > 0\");\n    }\n  }\n  if (options.maxDelayMs !== undefined) {\n    if (!Number.isFinite(options.maxDelayMs) || options.maxDelayMs <= 0) {\n      throw new Error(\"retry.maxDelayMs must be > 0\");\n    }\n  }\n\n  // Resolve against defaults (when provided) so that cross-field checks\n  // catch e.g. { baseDelayMs: 5000 } against default maxDelayMs: 3000.\n  const resolvedBase = options.baseDelayMs ?? defaults?.baseDelayMs;\n  const resolvedMax = options.maxDelayMs ?? defaults?.maxDelayMs;\n  if (\n    resolvedBase !== undefined &&\n    resolvedMax !== undefined &&\n    resolvedBase > resolvedMax\n  ) {\n    throw new Error(\"retry.baseDelayMs must be <= retry.maxDelayMs\");\n  }\n}\n\n/**\n * Returns the number of milliseconds to wait before retrying a request.\n * Uses the \"Full Jitter\" approach from\n * https://aws.amazon.com/blogs/architecture/exponential-backoff-and-jitter/\n *\n * @param attempt The current attempt number (1-indexed).\n * @param baseDelayMs Base delay multiplier in ms.\n * @param maxDelayMs Maximum delay cap in ms.\n * @returns Milliseconds to wait before retrying.\n */\nexport function jitterBackoff(\n  attempt: number,\n  baseDelayMs: number,\n  maxDelayMs: number\n): number {\n  const upperBoundMs = Math.min(2 ** attempt * baseDelayMs, maxDelayMs);\n  return Math.floor(Math.random() * upperBoundMs);\n}\n\n/**\n * Retry an async function up to `n` total attempts with jittered exponential backoff.\n *\n * @param n Total number of attempts (must be a finite integer >= 1).\n * @param fn The async function to retry. Receives the current attempt number (1-indexed).\n * @param options Retry configuration.\n * @returns The result of `fn` on success.\n * @throws The last error if all attempts fail or `shouldRetry` returns false.\n */\nexport async function tryN<T>(\n  n: number,\n  fn: (attempt: number) => Promise<T>,\n  options?: TryNOptions\n): Promise<T> {\n  if (!Number.isFinite(n) || n < 1) {\n    throw new Error(\"retry.maxAttempts must be >= 1\");\n  }\n  n = Math.floor(n);\n\n  const rawBase = options?.baseDelayMs ?? 100;\n  const rawMax = options?.maxDelayMs ?? 3000;\n\n  if (!Number.isFinite(rawBase) || rawBase <= 0) {\n    throw new Error(\"retry.baseDelayMs must be > 0\");\n  }\n  if (!Number.isFinite(rawMax) || rawMax <= 0) {\n    throw new Error(\"retry.maxDelayMs must be > 0\");\n  }\n\n  const baseDelayMs = Math.floor(rawBase);\n  const maxDelayMs = Math.floor(rawMax);\n\n  if (baseDelayMs > maxDelayMs) {\n    throw new Error(\"retry.baseDelayMs must be <= retry.maxDelayMs\");\n  }\n\n  let attempt = 1;\n  while (true) {\n    try {\n      return await fn(attempt);\n    } catch (err) {\n      const nextAttempt = attempt + 1;\n      if (\n        nextAttempt > n ||\n        (options?.shouldRetry && !options.shouldRetry(err, nextAttempt))\n      ) {\n        throw err;\n      }\n      const delay = jitterBackoff(attempt, baseDelayMs, maxDelayMs);\n      await new Promise((resolve) => setTimeout(resolve, delay));\n      attempt = nextAttempt;\n    }\n  }\n}\n\n/**\n * Returns true if the given error is retryable according to Durable Object error handling.\n * See https://developers.cloudflare.com/durable-objects/best-practices/error-handling/\n *\n * An error is retryable if it has `retryable: true` but is NOT an overloaded error.\n */\nexport function isErrorRetryable(err: unknown): boolean {\n  if (typeof err !== \"object\" || err === null) {\n    return false;\n  }\n  const msg = String(err);\n  const typed = err as { retryable?: boolean; overloaded?: boolean };\n  return (\n    Boolean(typed.retryable) &&\n    !typed.overloaded &&\n    !msg.includes(\"Durable Object is overloaded\")\n  );\n}\n"],"mappings":";;;;;;;AA+BA,SAAgB,qBACd,SACA,UACM;AACN,KAAI,QAAQ,gBAAgB,KAAA,GAAW;AACrC,MAAI,CAAC,OAAO,SAAS,QAAQ,YAAY,IAAI,QAAQ,cAAc,EACjE,OAAM,IAAI,MAAM,iCAAiC;AAEnD,MAAI,CAAC,OAAO,UAAU,QAAQ,YAAY,CACxC,OAAM,IAAI,MAAM,uCAAuC;;AAG3D,KAAI,QAAQ,gBAAgB,KAAA;MACtB,CAAC,OAAO,SAAS,QAAQ,YAAY,IAAI,QAAQ,eAAe,EAClE,OAAM,IAAI,MAAM,gCAAgC;;AAGpD,KAAI,QAAQ,eAAe,KAAA;MACrB,CAAC,OAAO,SAAS,QAAQ,WAAW,IAAI,QAAQ,cAAc,EAChE,OAAM,IAAI,MAAM,+BAA+B;;CAMnD,MAAM,eAAe,QAAQ,eAAe,UAAU;CACtD,MAAM,cAAc,QAAQ,cAAc,UAAU;AACpD,KACE,iBAAiB,KAAA,KACjB,gBAAgB,KAAA,KAChB,eAAe,YAEf,OAAM,IAAI,MAAM,gDAAgD;;;;;;;;;;;;AAcpE,SAAgB,cACd,SACA,aACA,YACQ;CACR,MAAM,eAAe,KAAK,IAAI,KAAK,UAAU,aAAa,WAAW;AACrE,QAAO,KAAK,MAAM,KAAK,QAAQ,GAAG,aAAa;;;;;;;;;;;AAYjD,eAAsB,KACpB,GACA,IACA,SACY;AACZ,KAAI,CAAC,OAAO,SAAS,EAAE,IAAI,IAAI,EAC7B,OAAM,IAAI,MAAM,iCAAiC;AAEnD,KAAI,KAAK,MAAM,EAAE;CAEjB,MAAM,UAAU,SAAS,eAAe;CACxC,MAAM,SAAS,SAAS,cAAc;AAEtC,KAAI,CAAC,OAAO,SAAS,QAAQ,IAAI,WAAW,EAC1C,OAAM,IAAI,MAAM,gCAAgC;AAElD,KAAI,CAAC,OAAO,SAAS,OAAO,IAAI,UAAU,EACxC,OAAM,IAAI,MAAM,+BAA+B;CAGjD,MAAM,cAAc,KAAK,MAAM,QAAQ;CACvC,MAAM,aAAa,KAAK,MAAM,OAAO;AAErC,KAAI,cAAc,WAChB,OAAM,IAAI,MAAM,gDAAgD;CAGlE,IAAI,UAAU;AACd,QAAO,KACL,KAAI;AACF,SAAO,MAAM,GAAG,QAAQ;UACjB,KAAK;EACZ,MAAM,cAAc,UAAU;AAC9B,MACE,cAAc,KACb,SAAS,eAAe,CAAC,QAAQ,YAAY,KAAK,YAAY,CAE/D,OAAM;EAER,MAAM,QAAQ,cAAc,SAAS,aAAa,WAAW;AAC7D,QAAM,IAAI,SAAS,YAAY,WAAW,SAAS,MAAM,CAAC;AAC1D,YAAU;;;;;;;;;AAWhB,SAAgB,iBAAiB,KAAuB;AACtD,KAAI,OAAO,QAAQ,YAAY,QAAQ,KACrC,QAAO;CAET,MAAM,MAAM,OAAO,IAAI;CACvB,MAAM,QAAQ;AACd,QACE,QAAQ,MAAM,UAAU,IACxB,CAAC,MAAM,cACP,CAAC,IAAI,SAAS,+BAA+B"}

package/dist/schedule.js

@@ -1,5 +1,4 @@
 import { z } from "zod";
-
 //#region src/schedule.ts
 /**
 * Get the schedule prompt for a given event
@@ -116,7 +115,7 @@ const scheduleSchema = z.object({
 * @returns The schedule schema
 */
 const unstable_scheduleSchema = scheduleSchema;
-
 //#endregion
 export { getSchedulePrompt, scheduleSchema, unstable_getSchedulePrompt, unstable_scheduleSchema };
+
 //# sourceMappingURL=schedule.js.map

package/dist/schedule.js.map

@@ -1 +1 @@
-{"version":3,"file":"schedule.js","names":[],"sources":["../src/schedule.ts"],"sourcesContent":["import { z } from \"zod\";\n\n/**\n * Get the schedule prompt for a given event\n * @param event - The event to get the schedule prompt for\n * @returns The schedule prompt\n */\nexport function getSchedulePrompt(event: { date: Date }) {\n  return `\n[Schedule Parser Component]\n\nCurrent time: ${event.date.toUTCString()}\n\nThis component parses natural language scheduling requests into a structured format. It extracts:\n1. A clean task description (without timing information)\n2. Scheduling details in one of these formats:\n   - scheduled: Specific date/time events\n   - delayed: Relative time delays (in seconds)\n   - cron: Recurring patterns\n   - no-schedule: Tasks without timing\n\nRules:\n- Task descriptions should be clean and focused on the action\n- Use numbers (0-6) for days in cron patterns (0=Sunday)\n- For recurring tasks, use standard cron syntax\n- For relative times, convert to seconds\n- For specific dates, use the current time as reference\n\nExample outputs:\n{\n  \"description\": \"meeting with team\",\n  \"when\": {\n    \"type\": \"scheduled\",\n    \"date\": \"tomorrow at 14:00\"\n  }\n}\n\n{\n  \"description\": \"backup database\",\n  \"when\": {\n    \"type\": \"cron\",\n    \"cron\": \"0 0 * * *\"\n  }\n}\n\n{\n  \"description\": \"send report\",\n  \"when\": {\n    \"type\": \"delayed\",\n    \"delayInSeconds\": 1800\n  }\n}\n\n[End Schedule Parser Component]\n`;\n}\n\nlet didWarnAboutUnstableGetSchedulePrompt = false;\n\n/**\n * @deprecated this has been renamed to getSchedulePrompt, and unstable_getSchedulePrompt will be removed in the next major version\n * @param event - The event to get the schedule prompt for\n * @returns The schedule prompt\n */\nexport function unstable_getSchedulePrompt(event: { date: Date }) {\n  if (!didWarnAboutUnstableGetSchedulePrompt) {\n    didWarnAboutUnstableGetSchedulePrompt = true;\n    console.warn(\n      \"unstable_getSchedulePrompt is deprecated, use getSchedulePrompt instead. unstable_getSchedulePrompt will be removed in the next major version.\"\n    );\n  }\n  return getSchedulePrompt(event);\n}\n\n/**\n * The schema for parsing natural language scheduling requests.\n *\n * @example\n * ```typescript\n * import { generateObject } from \"ai\";\n * import { scheduleSchema, getSchedulePrompt } from \"agents/schedule\";\n *\n * const result = await generateObject({\n *   model,\n *   prompt: `${getSchedulePrompt({ date: new Date() })} Input: \"${userInput}\"`,\n *   schema: scheduleSchema,\n *   // Required for OpenAI to avoid strict JSON schema validation errors\n *   providerOptions: {\n *     openai: { strictJsonSchema: false }\n *   }\n * });\n * ```\n *\n * @remarks\n * When using this schema with OpenAI models via the AI SDK, you must pass\n * `providerOptions: { openai: { strictJsonSchema: false } }` to `generateObject`.\n * This is because the schema uses a discriminated union which is not compatible\n * with OpenAI's strict structured outputs mode.\n */\nexport const scheduleSchema = z.object({\n  description: z.string().describe(\"A description of the task\"),\n  when: z.discriminatedUnion(\"type\", [\n    z.object({\n      type: z.literal(\"scheduled\"),\n      date: z\n        .string()\n        .describe(\n          \"Execute task at the specified date and time in ISO 8601 format\"\n        )\n    }),\n    z.object({\n      type: z.literal(\"delayed\"),\n      delayInSeconds: z\n        .number()\n        .describe(\"Execute task after a delay in seconds\")\n    }),\n    z.object({\n      type: z.literal(\"cron\"),\n      cron: z\n        .string()\n        .describe(\n          \"Execute task on a recurring interval specified as cron syntax\"\n        )\n    }),\n    z.object({\n      type: z.literal(\"no-schedule\")\n    })\n  ])\n});\n\n/**\n * The type for the schedule prompt\n */\nexport type Schedule = z.infer<typeof scheduleSchema>;\n\n/**\n * @deprecated this has been renamed to scheduleSchema, and unstable_scheduleSchema will be removed in the next major version\n * @returns The schedule schema\n */\nexport const unstable_scheduleSchema = scheduleSchema;\n"],"mappings":";;;;;;;;AAOA,SAAgB,kBAAkB,OAAuB;AACvD,QAAO;;;gBAGO,MAAM,KAAK,aAAa,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8CzC,IAAI,wCAAwC;;;;;;AAO5C,SAAgB,2BAA2B,OAAuB;AAChE,KAAI,CAAC,uCAAuC;AAC1C,0CAAwC;AACxC,UAAQ,KACN,iJACD;;AAEH,QAAO,kBAAkB,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BjC,MAAa,iBAAiB,EAAE,OAAO;CACrC,aAAa,EAAE,QAAQ,CAAC,SAAS,4BAA4B;CAC7D,MAAM,EAAE,mBAAmB,QAAQ;EACjC,EAAE,OAAO;GACP,MAAM,EAAE,QAAQ,YAAY;GAC5B,MAAM,EACH,QAAQ,CACR,SACC,iEACD;GACJ,CAAC;EACF,EAAE,OAAO;GACP,MAAM,EAAE,QAAQ,UAAU;GAC1B,gBAAgB,EACb,QAAQ,CACR,SAAS,wCAAwC;GACrD,CAAC;EACF,EAAE,OAAO;GACP,MAAM,EAAE,QAAQ,OAAO;GACvB,MAAM,EACH,QAAQ,CACR,SACC,gEACD;GACJ,CAAC;EACF,EAAE,OAAO,EACP,MAAM,EAAE,QAAQ,cAAc,EAC/B,CAAC;EACH,CAAC;CACH,CAAC;;;;;AAWF,MAAa,0BAA0B"}
+{"version":3,"file":"schedule.js","names":[],"sources":["../src/schedule.ts"],"sourcesContent":["import { z } from \"zod\";\n\n/**\n * Get the schedule prompt for a given event\n * @param event - The event to get the schedule prompt for\n * @returns The schedule prompt\n */\nexport function getSchedulePrompt(event: { date: Date }) {\n  return `\n[Schedule Parser Component]\n\nCurrent time: ${event.date.toUTCString()}\n\nThis component parses natural language scheduling requests into a structured format. It extracts:\n1. A clean task description (without timing information)\n2. Scheduling details in one of these formats:\n   - scheduled: Specific date/time events\n   - delayed: Relative time delays (in seconds)\n   - cron: Recurring patterns\n   - no-schedule: Tasks without timing\n\nRules:\n- Task descriptions should be clean and focused on the action\n- Use numbers (0-6) for days in cron patterns (0=Sunday)\n- For recurring tasks, use standard cron syntax\n- For relative times, convert to seconds\n- For specific dates, use the current time as reference\n\nExample outputs:\n{\n  \"description\": \"meeting with team\",\n  \"when\": {\n    \"type\": \"scheduled\",\n    \"date\": \"tomorrow at 14:00\"\n  }\n}\n\n{\n  \"description\": \"backup database\",\n  \"when\": {\n    \"type\": \"cron\",\n    \"cron\": \"0 0 * * *\"\n  }\n}\n\n{\n  \"description\": \"send report\",\n  \"when\": {\n    \"type\": \"delayed\",\n    \"delayInSeconds\": 1800\n  }\n}\n\n[End Schedule Parser Component]\n`;\n}\n\nlet didWarnAboutUnstableGetSchedulePrompt = false;\n\n/**\n * @deprecated this has been renamed to getSchedulePrompt, and unstable_getSchedulePrompt will be removed in the next major version\n * @param event - The event to get the schedule prompt for\n * @returns The schedule prompt\n */\nexport function unstable_getSchedulePrompt(event: { date: Date }) {\n  if (!didWarnAboutUnstableGetSchedulePrompt) {\n    didWarnAboutUnstableGetSchedulePrompt = true;\n    console.warn(\n      \"unstable_getSchedulePrompt is deprecated, use getSchedulePrompt instead. unstable_getSchedulePrompt will be removed in the next major version.\"\n    );\n  }\n  return getSchedulePrompt(event);\n}\n\n/**\n * The schema for parsing natural language scheduling requests.\n *\n * @example\n * ```typescript\n * import { generateObject } from \"ai\";\n * import { scheduleSchema, getSchedulePrompt } from \"agents/schedule\";\n *\n * const result = await generateObject({\n *   model,\n *   prompt: `${getSchedulePrompt({ date: new Date() })} Input: \"${userInput}\"`,\n *   schema: scheduleSchema,\n *   // Required for OpenAI to avoid strict JSON schema validation errors\n *   providerOptions: {\n *     openai: { strictJsonSchema: false }\n *   }\n * });\n * ```\n *\n * @remarks\n * When using this schema with OpenAI models via the AI SDK, you must pass\n * `providerOptions: { openai: { strictJsonSchema: false } }` to `generateObject`.\n * This is because the schema uses a discriminated union which is not compatible\n * with OpenAI's strict structured outputs mode.\n */\nexport const scheduleSchema = z.object({\n  description: z.string().describe(\"A description of the task\"),\n  when: z.discriminatedUnion(\"type\", [\n    z.object({\n      type: z.literal(\"scheduled\"),\n      date: z\n        .string()\n        .describe(\n          \"Execute task at the specified date and time in ISO 8601 format\"\n        )\n    }),\n    z.object({\n      type: z.literal(\"delayed\"),\n      delayInSeconds: z\n        .number()\n        .describe(\"Execute task after a delay in seconds\")\n    }),\n    z.object({\n      type: z.literal(\"cron\"),\n      cron: z\n        .string()\n        .describe(\n          \"Execute task on a recurring interval specified as cron syntax\"\n        )\n    }),\n    z.object({\n      type: z.literal(\"no-schedule\")\n    })\n  ])\n});\n\n/**\n * The type for the schedule prompt\n */\nexport type Schedule = z.infer<typeof scheduleSchema>;\n\n/**\n * @deprecated this has been renamed to scheduleSchema, and unstable_scheduleSchema will be removed in the next major version\n * @returns The schedule schema\n */\nexport const unstable_scheduleSchema = scheduleSchema;\n"],"mappings":";;;;;;;AAOA,SAAgB,kBAAkB,OAAuB;AACvD,QAAO;;;gBAGO,MAAM,KAAK,aAAa,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8CzC,IAAI,wCAAwC;;;;;;AAO5C,SAAgB,2BAA2B,OAAuB;AAChE,KAAI,CAAC,uCAAuC;AAC1C,0CAAwC;AACxC,UAAQ,KACN,iJACD;;AAEH,QAAO,kBAAkB,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BjC,MAAa,iBAAiB,EAAE,OAAO;CACrC,aAAa,EAAE,QAAQ,CAAC,SAAS,4BAA4B;CAC7D,MAAM,EAAE,mBAAmB,QAAQ;EACjC,EAAE,OAAO;GACP,MAAM,EAAE,QAAQ,YAAY;GAC5B,MAAM,EACH,QAAQ,CACR,SACC,iEACD;GACJ,CAAC;EACF,EAAE,OAAO;GACP,MAAM,EAAE,QAAQ,UAAU;GAC1B,gBAAgB,EACb,QAAQ,CACR,SAAS,wCAAwC;GACrD,CAAC;EACF,EAAE,OAAO;GACP,MAAM,EAAE,QAAQ,OAAO;GACvB,MAAM,EACH,QAAQ,CACR,SACC,gEACD;GACJ,CAAC;EACF,EAAE,OAAO,EACP,MAAM,EAAE,QAAQ,cAAc,EAC/B,CAAC;EACH,CAAC;CACH,CAAC;;;;;AAWF,MAAa,0BAA0B"}

package/dist/serializable.js

@@ -1 +1 @@
-export {  };
+export {};

package/dist/types-BB1plA51.d.ts

@@ -0,0 +1,15 @@
+//#region src/types.d.ts
+/**
+ * Enum for message types to improve type safety and maintainability
+ */
+declare enum MessageType {
+  CF_AGENT_MCP_SERVERS = "cf_agent_mcp_servers",
+  CF_MCP_AGENT_EVENT = "cf_mcp_agent_event",
+  CF_AGENT_STATE = "cf_agent_state",
+  CF_AGENT_STATE_ERROR = "cf_agent_state_error",
+  CF_AGENT_IDENTITY = "cf_agent_identity",
+  RPC = "rpc"
+}
+//#endregion
+export { MessageType as t };
+//# sourceMappingURL=types-BB1plA51.d.ts.map

package/dist/types.d.ts

@@ -1,15 +1,2 @@
-//#region src/types.d.ts
-/**
- * Enum for message types to improve type safety and maintainability
- */
-declare enum MessageType {
-  CF_AGENT_MCP_SERVERS = "cf_agent_mcp_servers",
-  CF_MCP_AGENT_EVENT = "cf_mcp_agent_event",
-  CF_AGENT_STATE = "cf_agent_state",
-  CF_AGENT_STATE_ERROR = "cf_agent_state_error",
-  CF_AGENT_IDENTITY = "cf_agent_identity",
-  RPC = "rpc"
-}
-//#endregion
+import { t as MessageType } from "./types-BB1plA51.js";
 export { MessageType };
-//# sourceMappingURL=types.d.ts.map

package/dist/types.js

@@ -11,7 +11,7 @@ let MessageType = /* @__PURE__ */ function(MessageType) {
 	MessageType["RPC"] = "rpc";
 	return MessageType;
 }({});
-
 //#endregion
 export { MessageType };
+
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":[],"sources":["../src/types.ts"],"sourcesContent":["/**\n * Enum for message types to improve type safety and maintainability\n */\nexport enum MessageType {\n  CF_AGENT_MCP_SERVERS = \"cf_agent_mcp_servers\",\n  CF_MCP_AGENT_EVENT = \"cf_mcp_agent_event\",\n  CF_AGENT_STATE = \"cf_agent_state\",\n  CF_AGENT_STATE_ERROR = \"cf_agent_state_error\",\n  CF_AGENT_IDENTITY = \"cf_agent_identity\",\n  RPC = \"rpc\"\n}\n"],"mappings":";;;;AAGA,IAAY,oDAAL;AACL;AACA;AACA;AACA;AACA;AACA"}
+{"version":3,"file":"types.js","names":[],"sources":["../src/types.ts"],"sourcesContent":["/**\n * Enum for message types to improve type safety and maintainability\n */\nexport enum MessageType {\n  CF_AGENT_MCP_SERVERS = \"cf_agent_mcp_servers\",\n  CF_MCP_AGENT_EVENT = \"cf_mcp_agent_event\",\n  CF_AGENT_STATE = \"cf_agent_state\",\n  CF_AGENT_STATE_ERROR = \"cf_agent_state_error\",\n  CF_AGENT_IDENTITY = \"cf_agent_identity\",\n  RPC = \"rpc\"\n}\n"],"mappings":";;;;AAGA,IAAY,cAAL,yBAAA,aAAA;AACL,aAAA,0BAAA;AACA,aAAA,wBAAA;AACA,aAAA,oBAAA;AACA,aAAA,0BAAA;AACA,aAAA,uBAAA;AACA,aAAA,SAAA;;KACD"}

package/dist/utils.js

@@ -10,7 +10,7 @@ function camelCaseToKebabCase(str) {
 	kebabified = kebabified.startsWith("-") ? kebabified.slice(1) : kebabified;
 	return kebabified.replace(/_/g, "-").replace(/-$/, "");
 }
-
 //#endregion
 export { camelCaseToKebabCase };
+
 //# sourceMappingURL=utils.js.map

package/dist/workflow-types-CZNXKj_D.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-CZNXKj_D.d.ts.map

package/dist/workflow-types.d.ts

@@ -1,238 +1,27 @@
 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
+  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-CZNXKj_D.js";
 export {
   AgentWorkflowEvent,
   AgentWorkflowInternalParams,
@@ -257,4 +46,3 @@ export {
   WorkflowStatus,
   WorkflowTrackingRow
 };
-//# sourceMappingURL=workflow-types.d.ts.map