agents 0.14.1 → 0.14.3

package/dist/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","names":[],"sources":["../src/utils.ts"],"sourcesContent":["/**\n * Property keys that JavaScript runtimes and test frameworks probe\n * on arbitrary objects (serialization, thenable check, inspection,\n * matcher duck-typing). When an RPC-stub Proxy is accessed by\n * `JSON.stringify`, `console.log`, `await`, Vitest matchers, etc.,\n * it hits one of these — we must return `undefined` instead of a\n * call-wrapper to avoid firing a bogus RPC for a method the child\n * doesn't implement.\n *\n * @internal\n */\nexport const INTERNAL_JS_STUB_PROPS: ReadonlySet<string> = new Set([\n  \"toJSON\",\n  \"then\",\n  \"catch\",\n  \"finally\",\n  \"valueOf\",\n  \"toString\",\n  \"constructor\",\n  \"prototype\",\n  \"$$typeof\",\n  \"@@toStringTag\",\n  \"asymmetricMatch\",\n  \"nodeType\"\n]);\n\n/**\n * True when the property access is a JS-internal probe that must\n * NOT dispatch an RPC call. Catches all symbol keys plus the named\n * set above.\n *\n * @internal\n */\nexport function isInternalJsStubProp(prop: string | symbol): boolean {\n  return typeof prop === \"symbol\" || INTERNAL_JS_STUB_PROPS.has(prop);\n}\n\n/**\n * Convert a camelCase string to a kebab-case string\n * @param str The string to convert\n * @returns The kebab-case string\n */\nexport function camelCaseToKebabCase(str: string): string {\n  // If string is all uppercase, convert to lowercase\n  if (str === str.toUpperCase() && str !== str.toLowerCase()) {\n    return str.toLowerCase().replace(/_/g, \"-\");\n  }\n\n  // Otherwise handle camelCase to kebab-case\n  let kebabified = str.replace(\n    /[A-Z]/g,\n    (letter) => `-${letter.toLowerCase()}`\n  );\n  kebabified = kebabified.startsWith(\"-\") ? kebabified.slice(1) : kebabified;\n  // Convert any remaining underscores to hyphens and remove trailing -'s\n  return kebabified.replace(/_/g, \"-\").replace(/-$/, \"\");\n}\n"],"mappings":";;;;;;;;;;;;AAWA,MAAa,yBAA8C,IAAI,IAAI;CACjE;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;;;;;;;AASD,SAAgB,qBAAqB,MAAgC;CACnE,OAAO,OAAO,SAAS,YAAY,uBAAuB,IAAI,IAAI;AACpE;;;;;;AAOA,SAAgB,qBAAqB,KAAqB;CAExD,IAAI,QAAQ,IAAI,YAAY,KAAK,QAAQ,IAAI,YAAY,GACvD,OAAO,IAAI,YAAY,EAAE,QAAQ,MAAM,GAAG;CAI5C,IAAI,aAAa,IAAI,QACnB,WACC,WAAW,IAAI,OAAO,YAAY,GACrC;CACA,aAAa,WAAW,WAAW,GAAG,IAAI,WAAW,MAAM,CAAC,IAAI;CAEhE,OAAO,WAAW,QAAQ,MAAM,GAAG,EAAE,QAAQ,MAAM,EAAE;AACvD"}
+{"version":3,"file":"utils.js","names":[],"sources":["../src/utils.ts"],"sourcesContent":["/**\n * Property keys that JavaScript runtimes and test frameworks probe\n * on arbitrary objects (serialization, thenable check, inspection,\n * matcher duck-typing). When an RPC-stub Proxy is accessed by\n * `JSON.stringify`, `console.log`, `await`, Vitest matchers, etc.,\n * it hits one of these — we must return `undefined` instead of a\n * call-wrapper to avoid firing a bogus RPC for a method the child\n * doesn't implement.\n *\n * @internal\n */\nexport const INTERNAL_JS_STUB_PROPS: ReadonlySet<string> = new Set([\n  \"toJSON\",\n  \"then\",\n  \"catch\",\n  \"finally\",\n  \"valueOf\",\n  \"toString\",\n  \"constructor\",\n  \"prototype\",\n  \"$$typeof\",\n  \"@@toStringTag\",\n  \"asymmetricMatch\",\n  \"nodeType\"\n]);\n\n/**\n * True when the property access is a JS-internal probe that must\n * NOT dispatch an RPC call. Catches all symbol keys plus the named\n * set above.\n *\n * @internal\n */\nexport function isInternalJsStubProp(prop: string | symbol): boolean {\n  return typeof prop === \"symbol\" || INTERNAL_JS_STUB_PROPS.has(prop);\n}\n\n/**\n * Convert a camelCase string to a kebab-case string\n * @param str The string to convert\n * @returns The kebab-case string\n */\nexport function camelCaseToKebabCase(str: string): string {\n  // If string is all uppercase, convert to lowercase\n  if (str === str.toUpperCase() && str !== str.toLowerCase()) {\n    return str.toLowerCase().replace(/_/g, \"-\");\n  }\n\n  // Otherwise handle camelCase to kebab-case\n  let kebabified = str.replace(\n    /[A-Z]/g,\n    (letter) => `-${letter.toLowerCase()}`\n  );\n  kebabified = kebabified.startsWith(\"-\") ? kebabified.slice(1) : kebabified;\n  // Convert any remaining underscores to hyphens and remove trailing -'s\n  return kebabified.replace(/_/g, \"-\").replace(/-$/, \"\");\n}\n"],"mappings":";;;;;;;;;;;;AAWA,MAAa,yBAA8C,IAAI,IAAI;CACjE;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;;;;;;;AASD,SAAgB,qBAAqB,MAAgC;CACnE,OAAO,OAAO,SAAS,YAAY,uBAAuB,IAAI,IAAI;AACpE;;;;;;AAOA,SAAgB,qBAAqB,KAAqB;CAExD,IAAI,QAAQ,IAAI,YAAY,KAAK,QAAQ,IAAI,YAAY,GACvD,OAAO,IAAI,YAAY,CAAC,CAAC,QAAQ,MAAM,GAAG;CAI5C,IAAI,aAAa,IAAI,QACnB,WACC,WAAW,IAAI,OAAO,YAAY,GACrC;CACA,aAAa,WAAW,WAAW,GAAG,IAAI,WAAW,MAAM,CAAC,IAAI;CAEhE,OAAO,WAAW,QAAQ,MAAM,GAAG,CAAC,CAAC,QAAQ,MAAM,EAAE;AACvD"}

package/dist/vite.d.ts

@@ -1,14 +1,25 @@
 import { Plugin } from "vite";
 
 //#region src/vite.d.ts
+interface AgentsPluginOptions {
+  /**
+   * Replace `turndown` with an inert stub so `just-bash` (workspace bash tool /
+   * skill runner) doesn't drag turndown's `require()`-using DOM fallback into
+   * the Worker's module-init path and break deploys. Enabled by default. Set to
+   * `false` if your app uses turndown directly and needs the real
+   * implementation.
+   */
+  stubTurndown?: boolean;
+}
 /**
  * Vite plugin for Agents SDK projects.
  *
- * Currently handles TC39 decorator transforms (Oxc doesn't support them yet,
- * oxc#9170) so `@callable()` works at runtime. Will grow to cover other
+ * Handles TC39 decorator transforms (Oxc doesn't support them yet, oxc#9170) so
+ * `@callable()` works at runtime, the `agents:skills` import transform, and
+ * stubbing `turndown` to keep Workers deploys clean. Will grow to cover other
  * Agents-specific build concerns as needed.
  */
-declare function agents(): Plugin[];
+declare function agents(options?: AgentsPluginOptions): Plugin[];
 //#endregion
-export { agents as default };
+export { AgentsPluginOptions, agents as default };
 //# sourceMappingURL=vite.d.ts.map

package/dist/vite.js

@@ -230,6 +230,30 @@ async function buildSkillsModule(dir, warn) {
 	};
 	return `const manifest = ${JSON.stringify(manifest)};\nexport default {\n  id: manifest.id,\n  fingerprint: manifest.fingerprint,\n  async list() {\n    return manifest.skills.map(({ body, rawContent, resources, ...skill }) => skill);\n  },\n  async load(name) {\n    const skill = manifest.skills.find((entry) => entry.name === name);\n    if (!skill) return null;\n    return {\n      ...skill,\n      resources: skill.resources.map(({ content, ...resource }) => resource)\n    };\n  },\n  async readResource(name, path) {\n    const skill = manifest.skills.find((entry) => entry.name === name);\n    const resource = skill?.resources.find((entry) => entry.path === path);\n    return resource ? { ...resource } : null;\n  }\n};\n`;
 }
+const TURNDOWN_STUB_ID = "\0agents:turndown-stub";
+function turndownStubPlugin() {
+	return {
+		name: "agents-turndown-stub",
+		enforce: "pre",
+		resolveId(source) {
+			if (source === "turndown") return TURNDOWN_STUB_ID;
+			return null;
+		},
+		load(id) {
+			if (id !== TURNDOWN_STUB_ID) return null;
+			return `class TurndownService {
+  constructor() {}
+  use() { return this; }
+  addRule() { return this; }
+  keep() { return this; }
+  remove() { return this; }
+  turndown() { return ""; }
+}
+export default TurndownService;
+`;
+		}
+	};
+}
 function skillsImportPlugin() {
 	return {
 		name: "agents-skills-import",
@@ -249,15 +273,21 @@ function skillsImportPlugin() {
 /**
 * Vite plugin for Agents SDK projects.
 *
-* Currently handles TC39 decorator transforms (Oxc doesn't support them yet,
-* oxc#9170) so `@callable()` works at runtime. Will grow to cover other
+* Handles TC39 decorator transforms (Oxc doesn't support them yet, oxc#9170) so
+* `@callable()` works at runtime, the `agents:skills` import transform, and
+* stubbing `turndown` to keep Workers deploys clean. Will grow to cover other
 * Agents-specific build concerns as needed.
 */
-function agents() {
-	return [skillsImportPlugin(), babel({ presets: [{
-		preset: () => ({ plugins: [["@babel/plugin-proposal-decorators", { version: "2023-11" }]] }),
-		rolldown: { filter: { code: "@" } }
-	}] })];
+function agents(options = {}) {
+	const { stubTurndown = true } = options;
+	return [
+		...stubTurndown ? [turndownStubPlugin()] : [],
+		skillsImportPlugin(),
+		babel({ presets: [{
+			preset: () => ({ plugins: [["@babel/plugin-proposal-decorators", { version: "2023-11" }]] }),
+			rolldown: { filter: { code: "@" } }
+		}] })
+	];
 }
 //#endregion
 export { agents as default };

package/dist/vite.js.map

@@ -1 +1 @@
-{"version":3,"file":"vite.js","names":["parseYaml"],"sources":["../src/vite.ts"],"sourcesContent":["import babel from \"@rolldown/plugin-babel\";\nimport { createHash } from \"node:crypto\";\nimport { readdir, readFile, stat } from \"node:fs/promises\";\nimport { basename, join, resolve } from \"node:path\";\nimport { parse as parseYaml } from \"yaml\";\nimport type { Plugin } from \"vite\";\n\nconst SKILLS_SPECIFIER = \"agents:skills\";\nconst SKILLS_VIRTUAL_PREFIX = \"\\0agents:skills:\";\nconst SKILL_RESOURCE_ROOTS = new Set([\n  \"references\",\n  \"scripts\",\n  \"assets\",\n  \"graphics\",\n  \"fonts\",\n  \"templates\",\n  \"rendered-files\",\n  \"illustrations\"\n]);\nconst SKILL_IGNORED_ROOTS = new Set([\n  \".git\",\n  \".hg\",\n  \".svn\",\n  \".DS_Store\",\n  \".idea\",\n  \".vscode\",\n  \"dist\",\n  \"build\",\n  \"coverage\",\n  \"node_modules\"\n]);\nconst SPEC_RESOURCE_ROOTS = new Set([\"references\", \"scripts\", \"assets\"]);\n\n// Bundled skill resources are base64-embedded into the Worker bundle, which\n// inflates them by ~1.33x and competes with app code for the bundle-size\n// budget. These heuristic thresholds (raw bytes) trigger a recommendation to\n// move large assets to an R2-backed skill source instead.\nconst SKILL_ASSET_WARN_BYTES = 256 * 1024;\nconst SKILL_BUNDLE_WARN_BYTES = 1024 * 1024;\n\nfunction formatBytes(bytes: number): string {\n  if (bytes >= 1024 * 1024) return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;\n  if (bytes >= 1024) return `${(bytes / 1024).toFixed(0)}KB`;\n  return `${bytes}B`;\n}\n\ninterface SkillFile {\n  name: string;\n  description: string;\n  body: string;\n  rawContent: string;\n  compatibility?: string;\n  license?: string;\n  allowedTools?: string;\n  metadata?: Record<string, unknown>;\n  resources: Array<{\n    path: string;\n    kind: \"reference\" | \"script\" | \"asset\" | \"file\";\n    size: number;\n    encoding: \"text\" | \"base64\";\n    mimeType?: string;\n    content: string;\n  }>;\n}\n\nfunction parseFrontmatter(raw: string): {\n  data: Record<string, unknown>;\n  body: string;\n} {\n  const match = raw.match(/^---\\r?\\n([\\s\\S]*?)\\r?\\n---\\r?\\n?([\\s\\S]*)$/);\n  if (!match) return { data: {}, body: raw };\n  const parsed = parseYaml(match[1] ?? \"\");\n  const data =\n    parsed !== null && typeof parsed === \"object\" && !Array.isArray(parsed)\n      ? (parsed as Record<string, unknown>)\n      : {};\n  return { data, body: match[2] ?? \"\" };\n}\n\nfunction stringField(value: unknown): string | undefined {\n  return typeof value === \"string\" && value.trim() ? value.trim() : undefined;\n}\n\nfunction recordField(value: unknown): Record<string, unknown> | undefined {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : undefined;\n}\n\nfunction resourceKind(path: string): \"reference\" | \"script\" | \"asset\" | \"file\" {\n  if (path.startsWith(\"references/\")) return \"reference\";\n  if (path.startsWith(\"scripts/\")) return \"script\";\n  if (\n    path.startsWith(\"assets/\") ||\n    path.startsWith(\"graphics/\") ||\n    path.startsWith(\"fonts/\") ||\n    path.startsWith(\"templates/\") ||\n    path.startsWith(\"rendered-files/\") ||\n    path.startsWith(\"illustrations/\")\n  ) {\n    return \"asset\";\n  }\n  return \"file\";\n}\n\nconst TEXT_EXTENSIONS = new Set([\n  \".bash\",\n  \".css\",\n  \".csv\",\n  \".html\",\n  \".js\",\n  \".json\",\n  \".jsx\",\n  \".md\",\n  \".mjs\",\n  \".py\",\n  \".sh\",\n  \".svg\",\n  \".ts\",\n  \".tsx\",\n  \".txt\",\n  \".xml\",\n  \".yaml\",\n  \".yml\"\n]);\n\nconst MIME_TYPES = new Map([\n  [\".css\", \"text/css\"],\n  [\".gif\", \"image/gif\"],\n  [\".html\", \"text/html\"],\n  [\".jpg\", \"image/jpeg\"],\n  [\".jpeg\", \"image/jpeg\"],\n  [\".js\", \"text/javascript\"],\n  [\".json\", \"application/json\"],\n  [\".md\", \"text/markdown\"],\n  [\".mjs\", \"text/javascript\"],\n  [\".pdf\", \"application/pdf\"],\n  [\".png\", \"image/png\"],\n  [\".py\", \"text/x-python\"],\n  [\".sh\", \"text/x-shellscript\"],\n  [\".svg\", \"image/svg+xml\"],\n  [\".ts\", \"text/typescript\"],\n  [\".tsx\", \"text/typescript\"],\n  [\".txt\", \"text/plain\"],\n  [\".webp\", \"image/webp\"],\n  [\".woff\", \"font/woff\"],\n  [\".woff2\", \"font/woff2\"],\n  [\".xml\", \"application/xml\"],\n  [\".yaml\", \"application/yaml\"],\n  [\".yml\", \"application/yaml\"]\n]);\n\nfunction extensionOf(path: string): string {\n  const file = path.split(\"/\").at(-1) ?? path;\n  const index = file.lastIndexOf(\".\");\n  return index === -1 ? \"\" : file.slice(index).toLowerCase();\n}\n\nfunction resourceEncoding(path: string): \"text\" | \"base64\" {\n  return TEXT_EXTENSIONS.has(extensionOf(path)) ? \"text\" : \"base64\";\n}\n\nfunction resourceMimeType(path: string): string | undefined {\n  return MIME_TYPES.get(extensionOf(path));\n}\n\nasync function collectFiles(\n  root: string,\n  relativeRoot = \"\",\n  warn?: (message: string) => void\n): Promise<Array<{ path: string; absolutePath: string; size: number }>> {\n  const entries = await readdir(join(root, relativeRoot), {\n    withFileTypes: true\n  }).catch(() => []);\n  const files: Array<{ path: string; absolutePath: string; size: number }> = [];\n\n  for (const entry of entries) {\n    if (SKILL_IGNORED_ROOTS.has(entry.name)) continue;\n    const relativePath = relativeRoot\n      ? `${relativeRoot}/${entry.name}`\n      : entry.name;\n    const absolutePath = join(root, relativePath);\n    if (entry.isDirectory()) {\n      const resourceRoot = relativePath.split(\"/\")[0];\n      if (!resourceRoot || SKILL_IGNORED_ROOTS.has(resourceRoot)) continue;\n      if (!SKILL_RESOURCE_ROOTS.has(resourceRoot)) {\n        if (!relativeRoot) {\n          warn?.(\n            `Ignoring skill directory \"${relativePath}\". Bundled skill resources should live under references/, scripts/, assets/, or a known asset root.`\n          );\n        }\n        continue;\n      }\n      if (!SPEC_RESOURCE_ROOTS.has(resourceRoot) && !relativeRoot) {\n        warn?.(\n          `Bundling non-standard skill resource root \"${resourceRoot}/\". Prefer assets/ for portable Agent Skills when possible.`\n        );\n      }\n      files.push(...(await collectFiles(root, relativePath, warn)));\n    } else if (entry.isFile() && relativePath !== \"SKILL.md\") {\n      const resourceRoot = relativePath.split(\"/\")[0];\n      if (!resourceRoot || SKILL_IGNORED_ROOTS.has(resourceRoot)) continue;\n      if (!SKILL_RESOURCE_ROOTS.has(resourceRoot)) {\n        warn?.(\n          `Ignoring skill file \"${relativePath}\". Bundled skill resources should live under references/, scripts/, assets/, or a known asset root.`\n        );\n        continue;\n      }\n      const info = await stat(absolutePath);\n      files.push({ path: relativePath, absolutePath, size: info.size });\n    }\n  }\n\n  return files.sort((a, b) => a.path.localeCompare(b.path));\n}\n\nasync function collectWatchTargets(\n  root: string,\n  relativeRoot = \"\"\n): Promise<string[]> {\n  const directory = join(root, relativeRoot);\n  const entries = await readdir(directory, { withFileTypes: true }).catch(\n    () => []\n  );\n  const targets = [directory];\n\n  for (const entry of entries) {\n    if (SKILL_IGNORED_ROOTS.has(entry.name)) continue;\n    const relativePath = relativeRoot\n      ? `${relativeRoot}/${entry.name}`\n      : entry.name;\n    const resourceRoot = relativePath.split(\"/\")[0];\n    if (!resourceRoot || SKILL_IGNORED_ROOTS.has(resourceRoot)) continue;\n\n    const absolutePath = join(root, relativePath);\n    targets.push(absolutePath);\n\n    if (entry.isDirectory()) {\n      targets.push(...(await collectWatchTargets(root, relativePath)));\n    }\n  }\n\n  return targets;\n}\n\nasync function readSkill(\n  skillDir: string,\n  warn?: (message: string) => void\n): Promise<SkillFile | null> {\n  const skillPath = join(skillDir, \"SKILL.md\");\n  const rawContent = await readFile(skillPath, \"utf8\").catch(() => null);\n  if (rawContent === null) return null;\n\n  const { data, body } = parseFrontmatter(rawContent);\n  const name = stringField(data.name);\n  const description = stringField(data.description);\n  if (!name || !description) return null;\n\n  const resources = await Promise.all(\n    (await collectFiles(skillDir, \"\", warn)).map(async (file) => {\n      const encoding = resourceEncoding(file.path);\n      const bytes = await readFile(file.absolutePath);\n      return {\n        path: file.path,\n        kind: resourceKind(file.path),\n        size: file.size,\n        encoding,\n        mimeType: resourceMimeType(file.path),\n        content:\n          encoding === \"base64\" ? bytes.toString(\"base64\") : bytes.toString()\n      };\n    })\n  );\n\n  return {\n    name,\n    description,\n    body,\n    rawContent,\n    compatibility: stringField(data.compatibility),\n    license: stringField(data.license),\n    allowedTools: stringField(data[\"allowed-tools\"]),\n    metadata: recordField(data.metadata),\n    resources\n  };\n}\n\nasync function buildSkillsModule(\n  dir: string,\n  warn?: (message: string) => void\n): Promise<string> {\n  const entries = await readdir(dir, { withFileTypes: true });\n  const skills: SkillFile[] = [];\n  const seen = new Set<string>();\n\n  for (const entry of entries) {\n    if (!entry.isDirectory()) continue;\n    const skill = await readSkill(join(dir, entry.name), warn);\n    if (!skill) continue;\n    if (seen.has(skill.name)) {\n      warn?.(\n        `Duplicate bundled skill name \"${skill.name}\" in \"${entry.name}/\"; keeping the first occurrence and ignoring this one.`\n      );\n      continue;\n    }\n    seen.add(skill.name);\n    skills.push(skill);\n  }\n\n  skills.sort((a, b) => a.name.localeCompare(b.name));\n\n  let totalBytes = 0;\n  for (const skill of skills) {\n    for (const resource of skill.resources) {\n      totalBytes += resource.size;\n      if (resource.size > SKILL_ASSET_WARN_BYTES) {\n        warn?.(\n          `Bundled skill resource \"${skill.name}/${resource.path}\" is ${formatBytes(resource.size)}; large assets bloat the Worker bundle (base64, ~1.33x). Prefer an R2-backed source via skills.r2().`\n        );\n      }\n    }\n  }\n  if (totalBytes > SKILL_BUNDLE_WARN_BYTES) {\n    warn?.(\n      `Bundled skills total ${formatBytes(totalBytes)} of embedded resources; this competes with the Worker bundle-size budget. Consider serving large skills from R2 via skills.r2().`\n    );\n  }\n\n  const hash = createHash(\"sha256\");\n  hash.update(JSON.stringify(skills));\n\n  const manifest = {\n    id: `bundle:${basename(dir)}`,\n    fingerprint: hash.digest(\"hex\"),\n    skills\n  };\n\n  return `const manifest = ${JSON.stringify(manifest)};\\nexport default {\\n  id: manifest.id,\\n  fingerprint: manifest.fingerprint,\\n  async list() {\\n    return manifest.skills.map(({ body, rawContent, resources, ...skill }) => skill);\\n  },\\n  async load(name) {\\n    const skill = manifest.skills.find((entry) => entry.name === name);\\n    if (!skill) return null;\\n    return {\\n      ...skill,\\n      resources: skill.resources.map(({ content, ...resource }) => resource)\\n    };\\n  },\\n  async readResource(name, path) {\\n    const skill = manifest.skills.find((entry) => entry.name === name);\\n    const resource = skill?.resources.find((entry) => entry.path === path);\\n    return resource ? { ...resource } : null;\\n  }\\n};\\n`;\n}\n\nfunction skillsImportPlugin(): Plugin {\n  return {\n    name: \"agents-skills-import\",\n    async resolveId(source, importer) {\n      // `agents:skills` resolves to a `./skills` directory next to the\n      // importer; `agents:skills/<dir>` points at a sibling directory.\n      if (\n        source !== SKILLS_SPECIFIER &&\n        !source.startsWith(`${SKILLS_SPECIFIER}/`)\n      ) {\n        return null;\n      }\n      if (!importer) return null;\n      const relative =\n        source === SKILLS_SPECIFIER\n          ? \"skills\"\n          : source.slice(SKILLS_SPECIFIER.length + 1);\n      const resolved = resolve(importer, \"..\", relative);\n      return `${SKILLS_VIRTUAL_PREFIX}${resolved}`;\n    },\n    async load(id) {\n      if (!id.startsWith(SKILLS_VIRTUAL_PREFIX)) return null;\n      const dir = id.slice(SKILLS_VIRTUAL_PREFIX.length);\n      for (const target of await collectWatchTargets(dir)) {\n        this.addWatchFile(target);\n      }\n      return buildSkillsModule(dir, (message) => this.warn(message));\n    }\n  };\n}\n\n/**\n * Vite plugin for Agents SDK projects.\n *\n * Currently handles TC39 decorator transforms (Oxc doesn't support them yet,\n * oxc#9170) so `@callable()` works at runtime. Will grow to cover other\n * Agents-specific build concerns as needed.\n */\nexport default function agents(): Plugin[] {\n  return [\n    skillsImportPlugin(),\n    babel({\n      presets: [\n        {\n          preset: () => ({\n            plugins: [\n              [\"@babel/plugin-proposal-decorators\", { version: \"2023-11\" }]\n            ]\n          }),\n          rolldown: { filter: { code: \"@\" } }\n        }\n      ]\n    }) as unknown as Plugin\n  ];\n}\n"],"mappings":"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"}
+{"version":3,"file":"vite.js","names":["parseYaml"],"sources":["../src/vite.ts"],"sourcesContent":["import babel from \"@rolldown/plugin-babel\";\nimport { createHash } from \"node:crypto\";\nimport { readdir, readFile, stat } from \"node:fs/promises\";\nimport { basename, join, resolve } from \"node:path\";\nimport { parse as parseYaml } from \"yaml\";\nimport type { Plugin } from \"vite\";\n\nconst SKILLS_SPECIFIER = \"agents:skills\";\nconst SKILLS_VIRTUAL_PREFIX = \"\\0agents:skills:\";\nconst SKILL_RESOURCE_ROOTS = new Set([\n  \"references\",\n  \"scripts\",\n  \"assets\",\n  \"graphics\",\n  \"fonts\",\n  \"templates\",\n  \"rendered-files\",\n  \"illustrations\"\n]);\nconst SKILL_IGNORED_ROOTS = new Set([\n  \".git\",\n  \".hg\",\n  \".svn\",\n  \".DS_Store\",\n  \".idea\",\n  \".vscode\",\n  \"dist\",\n  \"build\",\n  \"coverage\",\n  \"node_modules\"\n]);\nconst SPEC_RESOURCE_ROOTS = new Set([\"references\", \"scripts\", \"assets\"]);\n\n// Bundled skill resources are base64-embedded into the Worker bundle, which\n// inflates them by ~1.33x and competes with app code for the bundle-size\n// budget. These heuristic thresholds (raw bytes) trigger a recommendation to\n// move large assets to an R2-backed skill source instead.\nconst SKILL_ASSET_WARN_BYTES = 256 * 1024;\nconst SKILL_BUNDLE_WARN_BYTES = 1024 * 1024;\n\nfunction formatBytes(bytes: number): string {\n  if (bytes >= 1024 * 1024) return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;\n  if (bytes >= 1024) return `${(bytes / 1024).toFixed(0)}KB`;\n  return `${bytes}B`;\n}\n\ninterface SkillFile {\n  name: string;\n  description: string;\n  body: string;\n  rawContent: string;\n  compatibility?: string;\n  license?: string;\n  allowedTools?: string;\n  metadata?: Record<string, unknown>;\n  resources: Array<{\n    path: string;\n    kind: \"reference\" | \"script\" | \"asset\" | \"file\";\n    size: number;\n    encoding: \"text\" | \"base64\";\n    mimeType?: string;\n    content: string;\n  }>;\n}\n\nfunction parseFrontmatter(raw: string): {\n  data: Record<string, unknown>;\n  body: string;\n} {\n  const match = raw.match(/^---\\r?\\n([\\s\\S]*?)\\r?\\n---\\r?\\n?([\\s\\S]*)$/);\n  if (!match) return { data: {}, body: raw };\n  const parsed = parseYaml(match[1] ?? \"\");\n  const data =\n    parsed !== null && typeof parsed === \"object\" && !Array.isArray(parsed)\n      ? (parsed as Record<string, unknown>)\n      : {};\n  return { data, body: match[2] ?? \"\" };\n}\n\nfunction stringField(value: unknown): string | undefined {\n  return typeof value === \"string\" && value.trim() ? value.trim() : undefined;\n}\n\nfunction recordField(value: unknown): Record<string, unknown> | undefined {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : undefined;\n}\n\nfunction resourceKind(path: string): \"reference\" | \"script\" | \"asset\" | \"file\" {\n  if (path.startsWith(\"references/\")) return \"reference\";\n  if (path.startsWith(\"scripts/\")) return \"script\";\n  if (\n    path.startsWith(\"assets/\") ||\n    path.startsWith(\"graphics/\") ||\n    path.startsWith(\"fonts/\") ||\n    path.startsWith(\"templates/\") ||\n    path.startsWith(\"rendered-files/\") ||\n    path.startsWith(\"illustrations/\")\n  ) {\n    return \"asset\";\n  }\n  return \"file\";\n}\n\nconst TEXT_EXTENSIONS = new Set([\n  \".bash\",\n  \".css\",\n  \".csv\",\n  \".html\",\n  \".js\",\n  \".json\",\n  \".jsx\",\n  \".md\",\n  \".mjs\",\n  \".py\",\n  \".sh\",\n  \".svg\",\n  \".ts\",\n  \".tsx\",\n  \".txt\",\n  \".xml\",\n  \".yaml\",\n  \".yml\"\n]);\n\nconst MIME_TYPES = new Map([\n  [\".css\", \"text/css\"],\n  [\".gif\", \"image/gif\"],\n  [\".html\", \"text/html\"],\n  [\".jpg\", \"image/jpeg\"],\n  [\".jpeg\", \"image/jpeg\"],\n  [\".js\", \"text/javascript\"],\n  [\".json\", \"application/json\"],\n  [\".md\", \"text/markdown\"],\n  [\".mjs\", \"text/javascript\"],\n  [\".pdf\", \"application/pdf\"],\n  [\".png\", \"image/png\"],\n  [\".py\", \"text/x-python\"],\n  [\".sh\", \"text/x-shellscript\"],\n  [\".svg\", \"image/svg+xml\"],\n  [\".ts\", \"text/typescript\"],\n  [\".tsx\", \"text/typescript\"],\n  [\".txt\", \"text/plain\"],\n  [\".webp\", \"image/webp\"],\n  [\".woff\", \"font/woff\"],\n  [\".woff2\", \"font/woff2\"],\n  [\".xml\", \"application/xml\"],\n  [\".yaml\", \"application/yaml\"],\n  [\".yml\", \"application/yaml\"]\n]);\n\nfunction extensionOf(path: string): string {\n  const file = path.split(\"/\").at(-1) ?? path;\n  const index = file.lastIndexOf(\".\");\n  return index === -1 ? \"\" : file.slice(index).toLowerCase();\n}\n\nfunction resourceEncoding(path: string): \"text\" | \"base64\" {\n  return TEXT_EXTENSIONS.has(extensionOf(path)) ? \"text\" : \"base64\";\n}\n\nfunction resourceMimeType(path: string): string | undefined {\n  return MIME_TYPES.get(extensionOf(path));\n}\n\nasync function collectFiles(\n  root: string,\n  relativeRoot = \"\",\n  warn?: (message: string) => void\n): Promise<Array<{ path: string; absolutePath: string; size: number }>> {\n  const entries = await readdir(join(root, relativeRoot), {\n    withFileTypes: true\n  }).catch(() => []);\n  const files: Array<{ path: string; absolutePath: string; size: number }> = [];\n\n  for (const entry of entries) {\n    if (SKILL_IGNORED_ROOTS.has(entry.name)) continue;\n    const relativePath = relativeRoot\n      ? `${relativeRoot}/${entry.name}`\n      : entry.name;\n    const absolutePath = join(root, relativePath);\n    if (entry.isDirectory()) {\n      const resourceRoot = relativePath.split(\"/\")[0];\n      if (!resourceRoot || SKILL_IGNORED_ROOTS.has(resourceRoot)) continue;\n      if (!SKILL_RESOURCE_ROOTS.has(resourceRoot)) {\n        if (!relativeRoot) {\n          warn?.(\n            `Ignoring skill directory \"${relativePath}\". Bundled skill resources should live under references/, scripts/, assets/, or a known asset root.`\n          );\n        }\n        continue;\n      }\n      if (!SPEC_RESOURCE_ROOTS.has(resourceRoot) && !relativeRoot) {\n        warn?.(\n          `Bundling non-standard skill resource root \"${resourceRoot}/\". Prefer assets/ for portable Agent Skills when possible.`\n        );\n      }\n      files.push(...(await collectFiles(root, relativePath, warn)));\n    } else if (entry.isFile() && relativePath !== \"SKILL.md\") {\n      const resourceRoot = relativePath.split(\"/\")[0];\n      if (!resourceRoot || SKILL_IGNORED_ROOTS.has(resourceRoot)) continue;\n      if (!SKILL_RESOURCE_ROOTS.has(resourceRoot)) {\n        warn?.(\n          `Ignoring skill file \"${relativePath}\". Bundled skill resources should live under references/, scripts/, assets/, or a known asset root.`\n        );\n        continue;\n      }\n      const info = await stat(absolutePath);\n      files.push({ path: relativePath, absolutePath, size: info.size });\n    }\n  }\n\n  return files.sort((a, b) => a.path.localeCompare(b.path));\n}\n\nasync function collectWatchTargets(\n  root: string,\n  relativeRoot = \"\"\n): Promise<string[]> {\n  const directory = join(root, relativeRoot);\n  const entries = await readdir(directory, { withFileTypes: true }).catch(\n    () => []\n  );\n  const targets = [directory];\n\n  for (const entry of entries) {\n    if (SKILL_IGNORED_ROOTS.has(entry.name)) continue;\n    const relativePath = relativeRoot\n      ? `${relativeRoot}/${entry.name}`\n      : entry.name;\n    const resourceRoot = relativePath.split(\"/\")[0];\n    if (!resourceRoot || SKILL_IGNORED_ROOTS.has(resourceRoot)) continue;\n\n    const absolutePath = join(root, relativePath);\n    targets.push(absolutePath);\n\n    if (entry.isDirectory()) {\n      targets.push(...(await collectWatchTargets(root, relativePath)));\n    }\n  }\n\n  return targets;\n}\n\nasync function readSkill(\n  skillDir: string,\n  warn?: (message: string) => void\n): Promise<SkillFile | null> {\n  const skillPath = join(skillDir, \"SKILL.md\");\n  const rawContent = await readFile(skillPath, \"utf8\").catch(() => null);\n  if (rawContent === null) return null;\n\n  const { data, body } = parseFrontmatter(rawContent);\n  const name = stringField(data.name);\n  const description = stringField(data.description);\n  if (!name || !description) return null;\n\n  const resources = await Promise.all(\n    (await collectFiles(skillDir, \"\", warn)).map(async (file) => {\n      const encoding = resourceEncoding(file.path);\n      const bytes = await readFile(file.absolutePath);\n      return {\n        path: file.path,\n        kind: resourceKind(file.path),\n        size: file.size,\n        encoding,\n        mimeType: resourceMimeType(file.path),\n        content:\n          encoding === \"base64\" ? bytes.toString(\"base64\") : bytes.toString()\n      };\n    })\n  );\n\n  return {\n    name,\n    description,\n    body,\n    rawContent,\n    compatibility: stringField(data.compatibility),\n    license: stringField(data.license),\n    allowedTools: stringField(data[\"allowed-tools\"]),\n    metadata: recordField(data.metadata),\n    resources\n  };\n}\n\nasync function buildSkillsModule(\n  dir: string,\n  warn?: (message: string) => void\n): Promise<string> {\n  const entries = await readdir(dir, { withFileTypes: true });\n  const skills: SkillFile[] = [];\n  const seen = new Set<string>();\n\n  for (const entry of entries) {\n    if (!entry.isDirectory()) continue;\n    const skill = await readSkill(join(dir, entry.name), warn);\n    if (!skill) continue;\n    if (seen.has(skill.name)) {\n      warn?.(\n        `Duplicate bundled skill name \"${skill.name}\" in \"${entry.name}/\"; keeping the first occurrence and ignoring this one.`\n      );\n      continue;\n    }\n    seen.add(skill.name);\n    skills.push(skill);\n  }\n\n  skills.sort((a, b) => a.name.localeCompare(b.name));\n\n  let totalBytes = 0;\n  for (const skill of skills) {\n    for (const resource of skill.resources) {\n      totalBytes += resource.size;\n      if (resource.size > SKILL_ASSET_WARN_BYTES) {\n        warn?.(\n          `Bundled skill resource \"${skill.name}/${resource.path}\" is ${formatBytes(resource.size)}; large assets bloat the Worker bundle (base64, ~1.33x). Prefer an R2-backed source via skills.r2().`\n        );\n      }\n    }\n  }\n  if (totalBytes > SKILL_BUNDLE_WARN_BYTES) {\n    warn?.(\n      `Bundled skills total ${formatBytes(totalBytes)} of embedded resources; this competes with the Worker bundle-size budget. Consider serving large skills from R2 via skills.r2().`\n    );\n  }\n\n  const hash = createHash(\"sha256\");\n  hash.update(JSON.stringify(skills));\n\n  const manifest = {\n    id: `bundle:${basename(dir)}`,\n    fingerprint: hash.digest(\"hex\"),\n    skills\n  };\n\n  return `const manifest = ${JSON.stringify(manifest)};\\nexport default {\\n  id: manifest.id,\\n  fingerprint: manifest.fingerprint,\\n  async list() {\\n    return manifest.skills.map(({ body, rawContent, resources, ...skill }) => skill);\\n  },\\n  async load(name) {\\n    const skill = manifest.skills.find((entry) => entry.name === name);\\n    if (!skill) return null;\\n    return {\\n      ...skill,\\n      resources: skill.resources.map(({ content, ...resource }) => resource)\\n    };\\n  },\\n  async readResource(name, path) {\\n    const skill = manifest.skills.find((entry) => entry.name === name);\\n    const resource = skill?.resources.find((entry) => entry.path === path);\\n    return resource ? { ...resource } : null;\\n  }\\n};\\n`;\n}\n\nconst TURNDOWN_STUB_ID = \"\\0agents:turndown-stub\";\n\n// `just-bash` (pulled in by the workspace bash tool / skill runner) statically\n// depends on `turndown`, whose ESM build runs a top-level `require()` on its\n// Node DOM fallback. Workers is ESM with no global `require`, so the module\n// throws at startup — even when the bash tool is never used. turndown is only\n// needed by just-bash's niche `html-to-markdown` command, so we replace it with\n// an inert stub by default to keep Workers deploys clean. Opt out with\n// `agents({ stubTurndown: false })` if you rely on turndown elsewhere.\nfunction turndownStubPlugin(): Plugin {\n  return {\n    name: \"agents-turndown-stub\",\n    enforce: \"pre\",\n    resolveId(source) {\n      if (source === \"turndown\") return TURNDOWN_STUB_ID;\n      return null;\n    },\n    load(id) {\n      if (id !== TURNDOWN_STUB_ID) return null;\n      return `class TurndownService {\n  constructor() {}\n  use() { return this; }\n  addRule() { return this; }\n  keep() { return this; }\n  remove() { return this; }\n  turndown() { return \"\"; }\n}\nexport default TurndownService;\n`;\n    }\n  };\n}\n\nfunction skillsImportPlugin(): Plugin {\n  return {\n    name: \"agents-skills-import\",\n    async resolveId(source, importer) {\n      // `agents:skills` resolves to a `./skills` directory next to the\n      // importer; `agents:skills/<dir>` points at a sibling directory.\n      if (\n        source !== SKILLS_SPECIFIER &&\n        !source.startsWith(`${SKILLS_SPECIFIER}/`)\n      ) {\n        return null;\n      }\n      if (!importer) return null;\n      const relative =\n        source === SKILLS_SPECIFIER\n          ? \"skills\"\n          : source.slice(SKILLS_SPECIFIER.length + 1);\n      const resolved = resolve(importer, \"..\", relative);\n      return `${SKILLS_VIRTUAL_PREFIX}${resolved}`;\n    },\n    async load(id) {\n      if (!id.startsWith(SKILLS_VIRTUAL_PREFIX)) return null;\n      const dir = id.slice(SKILLS_VIRTUAL_PREFIX.length);\n      for (const target of await collectWatchTargets(dir)) {\n        this.addWatchFile(target);\n      }\n      return buildSkillsModule(dir, (message) => this.warn(message));\n    }\n  };\n}\n\nexport interface AgentsPluginOptions {\n  /**\n   * Replace `turndown` with an inert stub so `just-bash` (workspace bash tool /\n   * skill runner) doesn't drag turndown's `require()`-using DOM fallback into\n   * the Worker's module-init path and break deploys. Enabled by default. Set to\n   * `false` if your app uses turndown directly and needs the real\n   * implementation.\n   */\n  stubTurndown?: boolean;\n}\n\n/**\n * Vite plugin for Agents SDK projects.\n *\n * Handles TC39 decorator transforms (Oxc doesn't support them yet, oxc#9170) so\n * `@callable()` works at runtime, the `agents:skills` import transform, and\n * stubbing `turndown` to keep Workers deploys clean. Will grow to cover other\n * Agents-specific build concerns as needed.\n */\nexport default function agents(options: AgentsPluginOptions = {}): Plugin[] {\n  const { stubTurndown = true } = options;\n  return [\n    ...(stubTurndown ? [turndownStubPlugin()] : []),\n    skillsImportPlugin(),\n    babel({\n      presets: [\n        {\n          preset: () => ({\n            plugins: [\n              [\"@babel/plugin-proposal-decorators\", { version: \"2023-11\" }]\n            ]\n          }),\n          rolldown: { filter: { code: \"@\" } }\n        }\n      ]\n    }) as unknown as Plugin\n  ];\n}\n"],"mappings":"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"}

package/dist/workflows.d.ts

@@ -1,4 +1,4 @@
-import { y as Agent } from "./agent-tool-types-BAJWu8s4.js";
+import { b as Agent } from "./agent-tool-types-V25Z_HcX.js";
 import {
   S as WorkflowTrackingRow,
   _ as WorkflowPage,
@@ -42,7 +42,7 @@ declare class AgentWorkflow<
    * The Agent stub - initialized before run() is called.
    * Use this.agent to access the Agent's RPC methods.
    */
-  private _agent;
+  private _agent?;
   /**
    * Workflow instance ID
    */
@@ -68,6 +68,14 @@ declare class AgentWorkflow<
    * Called automatically before run() executes.
    */
   private _initAgent;
+  /**
+   * Call user workflow code and report unhandled errors to the Agent.
+   */
+  private _runWithErrorReporting;
+  /**
+   * Dispose the Agent stub owned by this workflow run.
+   */
+  private _disposeAgent;
   /**
    * Wrap WorkflowStep with durable Agent communication methods.
    * Methods added to the wrapped step are idempotent and won't repeat on retry.

package/dist/workflows.js

@@ -62,24 +62,18 @@ var AgentWorkflow = class extends WorkflowEntrypoint {
 					const { __agentName, __agentBinding, __workflowName, ...userParams } = event.payload;
 					await this._initAgent(__agentName, __agentBinding, __workflowName, event.instanceId);
 					this.__agentInitCalled = true;
-					const cleanedEvent = {
-						...event,
-						payload: userParams
-					};
-					const wrappedStep = this.extendStep(this._wrapStep(step), cleanedEvent);
 					try {
-						return await originalRun.call(this, cleanedEvent, wrappedStep);
-					} catch (err) {
-						await this._autoReportError(err);
-						throw err;
+						const cleanedEvent = {
+							...event,
+							payload: userParams
+						};
+						const wrappedStep = this.extendStep(this._wrapStep(step), cleanedEvent);
+						return await this._runWithErrorReporting(originalRun, cleanedEvent, wrappedStep);
+					} finally {
+						this._disposeAgent();
 					}
 				}
-				try {
-					return await originalRun.call(this, event, step);
-				} catch (err) {
-					await this._autoReportError(err);
-					throw err;
-				}
+				return await this._runWithErrorReporting(originalRun, event, step);
 			};
 			wrappedPrototypes.add(proto);
 		}
@@ -92,11 +86,32 @@ var AgentWorkflow = class extends WorkflowEntrypoint {
 		if (!agentName || !agentBinding || !workflowName) throw new Error("AgentWorkflow requires __agentName, __agentBinding, and __workflowName in params. Use agent.runWorkflow() to start workflows with proper agent context.");
 		this._workflowId = instanceId;
 		this._workflowName = workflowName;
+		this._errorReported = false;
 		const namespace = this.env[agentBinding];
 		if (!namespace) throw new Error(`Agent binding '${agentBinding}' not found in environment`);
 		this._agent = await getAgentByName(namespace, agentName);
 	}
 	/**
+	* Call user workflow code and report unhandled errors to the Agent.
+	*/
+	async _runWithErrorReporting(originalRun, event, step) {
+		try {
+			return await originalRun.call(this, event, step);
+		} catch (err) {
+			await this._autoReportError(err);
+			throw err;
+		}
+	}
+	/**
+	* Dispose the Agent stub owned by this workflow run.
+	*/
+	_disposeAgent() {
+		const agent = this._agent;
+		this._agent = void 0;
+		this.__agentInitCalled = false;
+		disposeIfPresent(agent);
+	}
+	/**
 	* Wrap WorkflowStep with durable Agent communication methods.
 	* Methods added to the wrapped step are idempotent and won't repeat on retry.
 	*
@@ -275,18 +290,29 @@ var AgentWorkflow = class extends WorkflowEntrypoint {
 		const stepName = options?.stepName ?? "wait-for-approval";
 		const eventType = options?.eventType ?? "approval";
 		const timeout = options?.timeout;
-		const payload = (await step.waitForEvent(stepName, {
+		const event = await step.waitForEvent(stepName, {
 			type: eventType,
 			timeout
-		})).payload;
-		if (!payload.approved) {
-			const reason = payload.reason;
-			await step.reportError(reason ?? "Workflow rejected");
-			throw new WorkflowRejectedError(reason, this._workflowId);
+		});
+		try {
+			const payload = event.payload;
+			if (!payload.approved) {
+				const reason = payload.reason;
+				await step.reportError(reason ?? "Workflow rejected");
+				throw new WorkflowRejectedError(reason, this._workflowId);
+			}
+			return payload.metadata;
+		} finally {
+			disposeIfPresent(event);
 		}
-		return payload.metadata;
 	}
 };
+function isDisposableResource(value) {
+	return !!value && typeof value === "object" && Symbol.dispose in value && typeof value[Symbol.dispose] === "function";
+}
+function disposeIfPresent(value) {
+	if (isDisposableResource(value)) value[Symbol.dispose]();
+}
 //#endregion
 export { AgentWorkflow, WorkflowRejectedError };
 

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.extendStep(\n            this._wrapStep(step),\n            cleanedEvent\n          );\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   * Extend the Agent-aware workflow step before user code receives it.\n   *\n   * Subclasses can override this to add framework-specific step helpers while\n   * preserving the underlying WorkflowStep object identity.\n   */\n  protected extendStep(\n    step: AgentWorkflowStep,\n    _event: WorkflowEvent<Params>\n  ): AgentWorkflowStep {\n    return step;\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 {\n  WorkflowEvent,\n  WorkflowStep,\n  WorkflowStepEvent\n} 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          try {\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.extendStep(\n              this._wrapStep(step),\n              cleanedEvent\n            );\n\n            return await this._runWithErrorReporting(\n              originalRun,\n              cleanedEvent,\n              wrappedStep\n            );\n          } finally {\n            this._disposeAgent();\n          }\n        }\n\n        // If already initialized (e.g., called via super.run()),\n        // just call the original with the event as-is.\n        return await this._runWithErrorReporting(\n          originalRun,\n          event as WorkflowEvent<Params>,\n          step as AgentWorkflowStep\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    this._errorReported = false;\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   * Call user workflow code and report unhandled errors to the Agent.\n   */\n  private async _runWithErrorReporting(\n    originalRun: (\n      event: WorkflowEvent<Params>,\n      step: AgentWorkflowStep\n    ) => Promise<unknown>,\n    event: WorkflowEvent<Params>,\n    step: AgentWorkflowStep\n  ): Promise<unknown> {\n    try {\n      return await originalRun.call(this, event, step);\n    } catch (err) {\n      await this._autoReportError(err);\n      throw err;\n    }\n  }\n\n  /**\n   * Dispose the Agent stub owned by this workflow run.\n   */\n  private _disposeAgent(): void {\n    const agent = this._agent;\n    this._agent = undefined;\n    this.__agentInitCalled = false;\n    disposeIfPresent(agent);\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   * Extend the Agent-aware workflow step before user code receives it.\n   *\n   * Subclasses can override this to add framework-specific step helpers while\n   * preserving the underlying WorkflowStep object identity.\n   */\n  protected extendStep(\n    step: AgentWorkflowStep,\n    _event: WorkflowEvent<Params>\n  ): AgentWorkflowStep {\n    return step;\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    })) as WorkflowStepEvent<{\n      approved: boolean;\n      reason?: string;\n      metadata?: T;\n    }>;\n\n    try {\n      const payload = event.payload;\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    } finally {\n      disposeIfPresent(event);\n    }\n  }\n}\n\ntype DisposableResource = {\n  [Symbol.dispose](): void;\n};\n\nfunction isDisposableResource(value: unknown): value is DisposableResource {\n  return (\n    !!value &&\n    typeof value === \"object\" &&\n    Symbol.dispose in value &&\n    typeof value[Symbol.dispose] === \"function\"\n  );\n}\n\nfunction disposeIfPresent(value: unknown): void {\n  if (isDisposableResource(value)) {\n    value[Symbol.dispose]();\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.14.1",
+  "version": "0.14.3",
   "license": "MIT",
   "repository": {
     "directory": "packages/agents",
@@ -26,9 +26,11 @@
   "dependencies": {
     "@babel/plugin-proposal-decorators": "^7.29.7",
     "@cfworker/json-schema": "^4.1.1",
+    "@cloudflare/codemode": "^0.3.8",
     "@modelcontextprotocol/sdk": "1.29.0",
     "@rolldown/plugin-babel": "^0.2.3",
     "cron-schedule": "^6.0.0",
+    "just-bash": "^3.0.1",
     "mimetext": "^3.0.28",
     "nanoid": "^5.1.11",
     "partyserver": "^0.5.6",
@@ -37,32 +39,29 @@
     "yargs": "^18.0.0"
   },
   "devDependencies": {
-    "@ai-sdk/react": "^3.0.196",
-    "@cloudflare/codemode": "^0.3.8",
+    "@ai-sdk/react": "^3.0.198",
     "@cloudflare/worker-bundler": "^0.2.0",
-    "@tanstack/ai": "^0.26.1",
+    "@tanstack/ai": "^0.27.0",
     "@types/react": "^19.2.16",
     "@types/yargs": "^17.0.35",
     "@vitest/browser-playwright": "^4.1.8",
     "@x402/core": "^2.14.0",
     "@x402/evm": "^2.14.0",
-    "ai": "^6.0.194",
+    "ai": "^6.0.196",
     "chat": "^4.30.0",
-    "just-bash": "^3.0.1",
+    "glob": "^11.1.0",
     "react": "^19.2.7",
     "vitest-browser-react": "^2.2.0",
     "zod": "^4.4.3"
   },
   "peerDependencies": {
     "@cloudflare/ai-chat": ">=0.8.0 <1.0.0",
-    "@cloudflare/codemode": ">=0.3.8 <1.0.0",
     "@cloudflare/worker-bundler": ">=0.2.0 <1.0.0",
     "@tanstack/ai": ">=0.10.2 <1.0.0",
     "@x402/core": "^2.0.0",
     "@x402/evm": "^2.0.0",
     "ai": "^6.0.0",
     "chat": "^4.29.0",
-    "just-bash": "^3.0.0",
     "react": "^19.0.0",
     "vite": ">=6.0.0 <9.0.0",
     "zod": "^4.0.0"
@@ -71,9 +70,6 @@
     "@cloudflare/ai-chat": {
       "optional": true
     },
-    "@cloudflare/codemode": {
-      "optional": true
-    },
     "@cloudflare/worker-bundler": {
       "optional": true
     },
@@ -89,9 +85,6 @@
     "chat": {
       "optional": true
     },
-    "just-bash": {
-      "optional": true
-    },
     "vite": {
       "optional": true
     }
@@ -251,8 +244,7 @@
   ],
   "nx": {
     "implicitDependencies": [
-      "!@cloudflare/ai-chat",
-      "!@cloudflare/codemode"
+      "!@cloudflare/ai-chat"
     ]
   },
   "scripts": {
@@ -268,4 +260,4 @@
     "test:x402": "vitest --project x402",
     "test:e2e": "vitest --run -c src/e2e-tests/vitest.config.ts"
   }
-}
+}