@cloudflare/codemode 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -1,89 +0,0 @@
-# @cloudflare/codemode
-
-## 0.1.0
-
-### Minor Changes
-
-- [#879](https://github.com/cloudflare/agents/pull/879) [`90e54da`](https://github.com/cloudflare/agents/commit/90e54dab21f7c2c783aac117693918765e8b254b) Thanks [@mattzcarey](https://github.com/mattzcarey)! - Remove experimental_codemode() and CodeModeProxy. Replace with createCodeTool() from @cloudflare/codemode/ai which returns a standard AI SDK Tool. The package no longer owns an LLM call or model choice. Users call streamText/generateText with their own model and pass the codemode tool.
-
-  The AI-dependent export (createCodeTool) is now at @cloudflare/codemode/ai. The root export (@cloudflare/codemode) contains the executor, type generation, and utilities which do not require the ai peer dependency.
-
-  ToolDispatcher (extends RpcTarget) replaces CodeModeProxy (extends WorkerEntrypoint) for dispatching tool calls from the sandbox back to the host. It is passed as a parameter to the dynamic worker's evaluate() method instead of being injected as an env binding, removing the need for CodeModeProxy and globalOutbound service bindings. Only a WorkerLoader binding is required now. globalOutbound on DynamicWorkerExecutor defaults to null which blocks fetch/connect at the runtime level. New Executor interface (execute(code, fns) => ExecuteResult) allows custom sandbox implementations. DynamicWorkerExecutor is the Cloudflare Workers implementation. Console output captured in ExecuteResult.logs. Configurable execution timeout.
-
-  AST-based code normalization via acorn replaces regex. sanitizeToolName() exported for converting MCP-style tool names to valid JS identifiers.
-
-### Patch Changes
-
-- [#954](https://github.com/cloudflare/agents/pull/954) [`943c407`](https://github.com/cloudflare/agents/commit/943c4070992bb836625abb5bf4e3271a6f52f7a2) Thanks [@threepointone](https://github.com/threepointone)! - update dependencies
-
-## 0.0.8
-
-### Patch Changes
-
-- [#916](https://github.com/cloudflare/agents/pull/916) [`24e16e0`](https://github.com/cloudflare/agents/commit/24e16e025b82dbd7b321339a18c6d440b2879136) Thanks [@threepointone](https://github.com/threepointone)! - Widen peer dependency ranges across packages to prevent cascading major bumps during 0.x minor releases. Mark `@cloudflare/ai-chat` and `@cloudflare/codemode` as optional peer dependencies of `agents` to fix unmet peer dependency warnings during installation.
-
-## 0.0.7
-
-### Patch Changes
-
-- [#849](https://github.com/cloudflare/agents/pull/849) [`21a7977`](https://github.com/cloudflare/agents/commit/21a79778f5150aecd890f55a164d397f70db681e) Thanks [@Muhammad-Bin-Ali](https://github.com/Muhammad-Bin-Ali)! - Allow configurable model in `experimental_codemode` instead of hardcoded `gpt-4.1`
-
-- [#859](https://github.com/cloudflare/agents/pull/859) [`3de98a3`](https://github.com/cloudflare/agents/commit/3de98a398d55aeca51c7b845ed4c5d6051887d6d) Thanks [@threepointone](https://github.com/threepointone)! - broaden peer deps
-
-- [#865](https://github.com/cloudflare/agents/pull/865) [`c3211d0`](https://github.com/cloudflare/agents/commit/c3211d0b0cc36aa294c15569ae650d3afeab9926) Thanks [@threepointone](https://github.com/threepointone)! - update dependencies
-
-## 0.0.6
-
-### Patch Changes
-
-- [#813](https://github.com/cloudflare/agents/pull/813) [`7aebab3`](https://github.com/cloudflare/agents/commit/7aebab369d1bef6c685e05a4a3bd6627edcb87db) Thanks [@threepointone](https://github.com/threepointone)! - update dependencies
-
-- [#800](https://github.com/cloudflare/agents/pull/800) [`a54edf5`](https://github.com/cloudflare/agents/commit/a54edf56b462856d1ef4f424c2363ac43a53c46e) Thanks [@threepointone](https://github.com/threepointone)! - Update dependencies
-
-- [#818](https://github.com/cloudflare/agents/pull/818) [`7c74336`](https://github.com/cloudflare/agents/commit/7c743360d7e3639e187725391b9d5c114838bd18) Thanks [@threepointone](https://github.com/threepointone)! - update dependencies
-
-- Updated dependencies [[`0c3c9bb`](https://github.com/cloudflare/agents/commit/0c3c9bb62ceff66ed38d3bbd90c767600f1f3453), [`0c3c9bb`](https://github.com/cloudflare/agents/commit/0c3c9bb62ceff66ed38d3bbd90c767600f1f3453), [`d1a0c2b`](https://github.com/cloudflare/agents/commit/d1a0c2b73b1119d71e120091753a6bcca0e2faa9), [`6218541`](https://github.com/cloudflare/agents/commit/6218541e9c1e40ccbaa25b2d9d93858c0ad81ffa), [`6218541`](https://github.com/cloudflare/agents/commit/6218541e9c1e40ccbaa25b2d9d93858c0ad81ffa), [`6218541`](https://github.com/cloudflare/agents/commit/6218541e9c1e40ccbaa25b2d9d93858c0ad81ffa), [`6218541`](https://github.com/cloudflare/agents/commit/6218541e9c1e40ccbaa25b2d9d93858c0ad81ffa), [`fd79481`](https://github.com/cloudflare/agents/commit/fd7948180abf066fa3d27911a83ffb4c91b3f099), [`6218541`](https://github.com/cloudflare/agents/commit/6218541e9c1e40ccbaa25b2d9d93858c0ad81ffa), [`0c3c9bb`](https://github.com/cloudflare/agents/commit/0c3c9bb62ceff66ed38d3bbd90c767600f1f3453), [`6218541`](https://github.com/cloudflare/agents/commit/6218541e9c1e40ccbaa25b2d9d93858c0ad81ffa), [`6218541`](https://github.com/cloudflare/agents/commit/6218541e9c1e40ccbaa25b2d9d93858c0ad81ffa), [`e20da53`](https://github.com/cloudflare/agents/commit/e20da5319eb46bac6ac580edf71836b00ac6f8bb), [`f604008`](https://github.com/cloudflare/agents/commit/f604008957f136241815909319a552bad6738b58), [`7aebab3`](https://github.com/cloudflare/agents/commit/7aebab369d1bef6c685e05a4a3bd6627edcb87db), [`a54edf5`](https://github.com/cloudflare/agents/commit/a54edf56b462856d1ef4f424c2363ac43a53c46e), [`7c74336`](https://github.com/cloudflare/agents/commit/7c743360d7e3639e187725391b9d5c114838bd18), [`6218541`](https://github.com/cloudflare/agents/commit/6218541e9c1e40ccbaa25b2d9d93858c0ad81ffa), [`ded8d3e`](https://github.com/cloudflare/agents/commit/ded8d3e8aeba0358ebd4aecb5ba15344b5a21db1)]:
-  - agents@0.3.7
-
-## 0.0.5
-
-### Patch Changes
-
-- [#776](https://github.com/cloudflare/agents/pull/776) [`93c613e`](https://github.com/cloudflare/agents/commit/93c613e077e7aa16e78cf9b0b53e285577e92ce5) Thanks [@ShoeBoom](https://github.com/ShoeBoom)! - prepend custom prompt to default assistant text
-
-- Updated dependencies [[`395f461`](https://github.com/cloudflare/agents/commit/395f46105d3affb5a2e2ffd28c516a0eefe45bb4), [`f27e62c`](https://github.com/cloudflare/agents/commit/f27e62c24f586abb285843db183198230ddd47ca)]:
-  - agents@0.3.6
-
-## 0.0.4
-
-### Patch Changes
-
-- [#771](https://github.com/cloudflare/agents/pull/771) [`87dc96d`](https://github.com/cloudflare/agents/commit/87dc96d19de1d26dbb2badecbb9955a4eb8e9e2e) Thanks [@threepointone](https://github.com/threepointone)! - update dependencies
-
-- Updated dependencies [[`cf8a1e7`](https://github.com/cloudflare/agents/commit/cf8a1e7a24ecaac62c2aefca7b0fd5bf1373e8bd), [`87dc96d`](https://github.com/cloudflare/agents/commit/87dc96d19de1d26dbb2badecbb9955a4eb8e9e2e)]:
-  - agents@0.3.4
-
-## 0.0.3
-
-### Patch Changes
-
-- [`a5d0137`](https://github.com/cloudflare/agents/commit/a5d01379b9ad2d88bc028c50f1858b4e69f106c5) Thanks [@threepointone](https://github.com/threepointone)! - trigger a new release
-
-- Updated dependencies [[`a5d0137`](https://github.com/cloudflare/agents/commit/a5d01379b9ad2d88bc028c50f1858b4e69f106c5)]:
-  - agents@0.3.3
-
-## 0.0.2
-
-### Patch Changes
-
-- [#756](https://github.com/cloudflare/agents/pull/756) [`0c4275f`](https://github.com/cloudflare/agents/commit/0c4275f8f4b71c264c32c3742d151ef705739c2f) Thanks [@threepointone](https://github.com/threepointone)! - feat: split ai-chat and codemode into separate packages
-
-  Extract @cloudflare/ai-chat and @cloudflare/codemode into their own packages
-  with comprehensive READMEs. Update agents README to remove chat-specific
-  content and point to new packages. Fix documentation imports to reflect
-  new package structure.
-
-  Maintains backward compatibility, no breaking changes.
-
-- Updated dependencies [[`0c4275f`](https://github.com/cloudflare/agents/commit/0c4275f8f4b71c264c32c3742d151ef705739c2f), [`f12553f`](https://github.com/cloudflare/agents/commit/f12553f2fa65912c68d9a7620b9a11b70b8790a2)]:
-  - agents@0.3.2

package/dist/types-B9g5T2nd.js

@@ -1,138 +0,0 @@
-import { createAuxiliaryTypeStore, createTypeAlias, printNode, zodToTs } from "zod-to-ts";
-
-//#region src/types.ts
-const JS_RESERVED = new Set([
-	"abstract",
-	"arguments",
-	"await",
-	"boolean",
-	"break",
-	"byte",
-	"case",
-	"catch",
-	"char",
-	"class",
-	"const",
-	"continue",
-	"debugger",
-	"default",
-	"delete",
-	"do",
-	"double",
-	"else",
-	"enum",
-	"eval",
-	"export",
-	"extends",
-	"false",
-	"final",
-	"finally",
-	"float",
-	"for",
-	"function",
-	"goto",
-	"if",
-	"implements",
-	"import",
-	"in",
-	"instanceof",
-	"int",
-	"interface",
-	"let",
-	"long",
-	"native",
-	"new",
-	"null",
-	"package",
-	"private",
-	"protected",
-	"public",
-	"return",
-	"short",
-	"static",
-	"super",
-	"switch",
-	"synchronized",
-	"this",
-	"throw",
-	"throws",
-	"transient",
-	"true",
-	"try",
-	"typeof",
-	"undefined",
-	"var",
-	"void",
-	"volatile",
-	"while",
-	"with",
-	"yield"
-]);
-/**
-* Sanitize a tool name into a valid JavaScript identifier.
-* Replaces hyphens, dots, and spaces with `_`, strips other invalid chars,
-* prefixes digit-leading names with `_`, and appends `_` to JS reserved words.
-*/
-function sanitizeToolName(name) {
-	if (!name) return "_";
-	let sanitized = name.replace(/[-.\s]/g, "_");
-	sanitized = sanitized.replace(/[^a-zA-Z0-9_$]/g, "");
-	if (!sanitized) return "_";
-	if (/^[0-9]/.test(sanitized)) sanitized = "_" + sanitized;
-	if (JS_RESERVED.has(sanitized)) sanitized = sanitized + "_";
-	return sanitized;
-}
-function toCamelCase(str) {
-	return str.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase()).replace(/^[a-z]/, (letter) => letter.toUpperCase());
-}
-/**
-* Extract field descriptions from a Zod object schema's `.shape`, if available.
-* Returns an array of `@param input.fieldName - description` lines.
-*/
-function extractParamDescriptions(schema) {
-	const descriptions = [];
-	const shape = schema.shape;
-	if (!shape || typeof shape !== "object") return descriptions;
-	for (const [fieldName, fieldSchema] of Object.entries(shape)) {
-		const desc = fieldSchema.description;
-		if (desc) descriptions.push(`@param input.${fieldName} - ${desc}`);
-	}
-	return descriptions;
-}
-/**
-* Generate TypeScript type definitions from tool descriptors or an AI SDK ToolSet.
-* These types can be included in tool descriptions to help LLMs write correct code.
-*/
-function generateTypes(tools) {
-	let availableTools = "";
-	let availableTypes = "";
-	const auxiliaryTypeStore = createAuxiliaryTypeStore();
-	for (const [toolName, tool] of Object.entries(tools)) {
-		const inputSchema = "inputSchema" in tool ? tool.inputSchema : tool.parameters;
-		const outputSchema = "outputSchema" in tool ? tool.outputSchema : void 0;
-		const description = tool.description;
-		const safeName = sanitizeToolName(toolName);
-		const inputType = printNode(createTypeAlias(zodToTs(inputSchema, { auxiliaryTypeStore }).node, `${toCamelCase(safeName)}Input`));
-		const outputType = outputSchema ? printNode(createTypeAlias(zodToTs(outputSchema, { auxiliaryTypeStore }).node, `${toCamelCase(safeName)}Output`)) : `type ${toCamelCase(safeName)}Output = unknown`;
-		availableTypes += `\n${inputType.trim()}`;
-		availableTypes += `\n${outputType.trim()}`;
-		const paramDescs = extractParamDescriptions(inputSchema);
-		const jsdocLines = [];
-		if (description?.trim()) jsdocLines.push(description.trim());
-		else jsdocLines.push(toolName);
-		for (const pd of paramDescs) jsdocLines.push(pd);
-		const jsdocBody = jsdocLines.map((l) => `\t * ${l}`).join("\n");
-		availableTools += `\n\t/**\n${jsdocBody}\n\t */`;
-		availableTools += `\n\t${safeName}: (input: ${toCamelCase(safeName)}Input) => Promise<${toCamelCase(safeName)}Output>;`;
-		availableTools += "\n";
-	}
-	availableTools = `\ndeclare const codemode: {${availableTools}}`;
-	return `
-${availableTypes}
-${availableTools}
-  `.trim();
-}
-
-//#endregion
-export { sanitizeToolName as n, generateTypes as t };
-//# sourceMappingURL=types-B9g5T2nd.js.map

package/dist/types-B9g5T2nd.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types-B9g5T2nd.js","names":["printNodeZodToTs"],"sources":["../src/types.ts"],"sourcesContent":["import {\n  zodToTs,\n  printNode as printNodeZodToTs,\n  createTypeAlias,\n  createAuxiliaryTypeStore\n} from \"zod-to-ts\";\nimport type { ZodType } from \"zod\";\nimport type { ToolSet } from \"ai\";\n\nconst JS_RESERVED = new Set([\n  \"abstract\",\n  \"arguments\",\n  \"await\",\n  \"boolean\",\n  \"break\",\n  \"byte\",\n  \"case\",\n  \"catch\",\n  \"char\",\n  \"class\",\n  \"const\",\n  \"continue\",\n  \"debugger\",\n  \"default\",\n  \"delete\",\n  \"do\",\n  \"double\",\n  \"else\",\n  \"enum\",\n  \"eval\",\n  \"export\",\n  \"extends\",\n  \"false\",\n  \"final\",\n  \"finally\",\n  \"float\",\n  \"for\",\n  \"function\",\n  \"goto\",\n  \"if\",\n  \"implements\",\n  \"import\",\n  \"in\",\n  \"instanceof\",\n  \"int\",\n  \"interface\",\n  \"let\",\n  \"long\",\n  \"native\",\n  \"new\",\n  \"null\",\n  \"package\",\n  \"private\",\n  \"protected\",\n  \"public\",\n  \"return\",\n  \"short\",\n  \"static\",\n  \"super\",\n  \"switch\",\n  \"synchronized\",\n  \"this\",\n  \"throw\",\n  \"throws\",\n  \"transient\",\n  \"true\",\n  \"try\",\n  \"typeof\",\n  \"undefined\",\n  \"var\",\n  \"void\",\n  \"volatile\",\n  \"while\",\n  \"with\",\n  \"yield\"\n]);\n\n/**\n * Sanitize a tool name into a valid JavaScript identifier.\n * Replaces hyphens, dots, and spaces with `_`, strips other invalid chars,\n * prefixes digit-leading names with `_`, and appends `_` to JS reserved words.\n */\nexport function sanitizeToolName(name: string): string {\n  if (!name) return \"_\";\n\n  // Replace common separators with underscores\n  let sanitized = name.replace(/[-.\\s]/g, \"_\");\n\n  // Strip any remaining non-identifier characters\n  sanitized = sanitized.replace(/[^a-zA-Z0-9_$]/g, \"\");\n\n  if (!sanitized) return \"_\";\n\n  // Prefix with _ if starts with a digit\n  if (/^[0-9]/.test(sanitized)) {\n    sanitized = \"_\" + sanitized;\n  }\n\n  // Append _ to reserved words\n  if (JS_RESERVED.has(sanitized)) {\n    sanitized = sanitized + \"_\";\n  }\n\n  return sanitized;\n}\n\nfunction toCamelCase(str: string) {\n  return str\n    .replace(/_([a-z])/g, (_, letter) => letter.toUpperCase())\n    .replace(/^[a-z]/, (letter) => letter.toUpperCase());\n}\n\n/**\n * Extract field descriptions from a Zod object schema's `.shape`, if available.\n * Returns an array of `@param input.fieldName - description` lines.\n */\nfunction extractParamDescriptions(schema: ZodType): string[] {\n  const descriptions: string[] = [];\n  const shape = (schema as { shape?: Record<string, ZodType> }).shape;\n  if (!shape || typeof shape !== \"object\") return descriptions;\n\n  for (const [fieldName, fieldSchema] of Object.entries(shape)) {\n    const desc = (fieldSchema as { description?: string }).description;\n    if (desc) {\n      descriptions.push(`@param input.${fieldName} - ${desc}`);\n    }\n  }\n  return descriptions;\n}\n\nexport interface ToolDescriptor {\n  description?: string;\n  inputSchema: ZodType;\n  outputSchema?: ZodType;\n  execute?: (args: unknown) => Promise<unknown>;\n}\n\nexport type ToolDescriptors = Record<string, ToolDescriptor>;\n\n/**\n * Generate TypeScript type definitions from tool descriptors or an AI SDK ToolSet.\n * These types can be included in tool descriptions to help LLMs write correct code.\n */\nexport function generateTypes(tools: ToolDescriptors | ToolSet): string {\n  let availableTools = \"\";\n  let availableTypes = \"\";\n\n  const auxiliaryTypeStore = createAuxiliaryTypeStore();\n\n  for (const [toolName, tool] of Object.entries(tools)) {\n    // Handle both our ToolDescriptor and AI SDK Tool types\n    const inputSchema =\n      \"inputSchema\" in tool ? tool.inputSchema : tool.parameters;\n    const outputSchema = \"outputSchema\" in tool ? tool.outputSchema : undefined;\n    const description = tool.description;\n\n    const safeName = sanitizeToolName(toolName);\n\n    const inputType = printNodeZodToTs(\n      createTypeAlias(\n        zodToTs(inputSchema as ZodType, { auxiliaryTypeStore }).node,\n        `${toCamelCase(safeName)}Input`\n      )\n    );\n\n    const outputType = outputSchema\n      ? printNodeZodToTs(\n          createTypeAlias(\n            zodToTs(outputSchema as ZodType, { auxiliaryTypeStore }).node,\n            `${toCamelCase(safeName)}Output`\n          )\n        )\n      : `type ${toCamelCase(safeName)}Output = unknown`;\n\n    availableTypes += `\\n${inputType.trim()}`;\n    availableTypes += `\\n${outputType.trim()}`;\n\n    // Build JSDoc comment with description and param descriptions\n    const paramDescs = extractParamDescriptions(inputSchema as ZodType);\n    const jsdocLines: string[] = [];\n    if (description?.trim()) {\n      jsdocLines.push(description.trim());\n    } else {\n      jsdocLines.push(toolName);\n    }\n    for (const pd of paramDescs) {\n      jsdocLines.push(pd);\n    }\n\n    const jsdocBody = jsdocLines.map((l) => `\\t * ${l}`).join(\"\\n\");\n    availableTools += `\\n\\t/**\\n${jsdocBody}\\n\\t */`;\n    availableTools += `\\n\\t${safeName}: (input: ${toCamelCase(safeName)}Input) => Promise<${toCamelCase(safeName)}Output>;`;\n    availableTools += \"\\n\";\n  }\n\n  availableTools = `\\ndeclare const codemode: {${availableTools}}`;\n\n  return `\n${availableTypes}\n${availableTools}\n  `.trim();\n}\n"],"mappings":";;;AASA,MAAM,cAAc,IAAI,IAAI;CAC1B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;;;;;;AAOF,SAAgB,iBAAiB,MAAsB;AACrD,KAAI,CAAC,KAAM,QAAO;CAGlB,IAAI,YAAY,KAAK,QAAQ,WAAW,IAAI;AAG5C,aAAY,UAAU,QAAQ,mBAAmB,GAAG;AAEpD,KAAI,CAAC,UAAW,QAAO;AAGvB,KAAI,SAAS,KAAK,UAAU,CAC1B,aAAY,MAAM;AAIpB,KAAI,YAAY,IAAI,UAAU,CAC5B,aAAY,YAAY;AAG1B,QAAO;;AAGT,SAAS,YAAY,KAAa;AAChC,QAAO,IACJ,QAAQ,cAAc,GAAG,WAAW,OAAO,aAAa,CAAC,CACzD,QAAQ,WAAW,WAAW,OAAO,aAAa,CAAC;;;;;;AAOxD,SAAS,yBAAyB,QAA2B;CAC3D,MAAM,eAAyB,EAAE;CACjC,MAAM,QAAS,OAA+C;AAC9D,KAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAEhD,MAAK,MAAM,CAAC,WAAW,gBAAgB,OAAO,QAAQ,MAAM,EAAE;EAC5D,MAAM,OAAQ,YAAyC;AACvD,MAAI,KACF,cAAa,KAAK,gBAAgB,UAAU,KAAK,OAAO;;AAG5D,QAAO;;;;;;AAgBT,SAAgB,cAAc,OAA0C;CACtE,IAAI,iBAAiB;CACrB,IAAI,iBAAiB;CAErB,MAAM,qBAAqB,0BAA0B;AAErD,MAAK,MAAM,CAAC,UAAU,SAAS,OAAO,QAAQ,MAAM,EAAE;EAEpD,MAAM,cACJ,iBAAiB,OAAO,KAAK,cAAc,KAAK;EAClD,MAAM,eAAe,kBAAkB,OAAO,KAAK,eAAe;EAClE,MAAM,cAAc,KAAK;EAEzB,MAAM,WAAW,iBAAiB,SAAS;EAE3C,MAAM,YAAYA,UAChB,gBACE,QAAQ,aAAwB,EAAE,oBAAoB,CAAC,CAAC,MACxD,GAAG,YAAY,SAAS,CAAC,OAC1B,CACF;EAED,MAAM,aAAa,eACfA,UACE,gBACE,QAAQ,cAAyB,EAAE,oBAAoB,CAAC,CAAC,MACzD,GAAG,YAAY,SAAS,CAAC,QAC1B,CACF,GACD,QAAQ,YAAY,SAAS,CAAC;AAElC,oBAAkB,KAAK,UAAU,MAAM;AACvC,oBAAkB,KAAK,WAAW,MAAM;EAGxC,MAAM,aAAa,yBAAyB,YAAuB;EACnE,MAAM,aAAuB,EAAE;AAC/B,MAAI,aAAa,MAAM,CACrB,YAAW,KAAK,YAAY,MAAM,CAAC;MAEnC,YAAW,KAAK,SAAS;AAE3B,OAAK,MAAM,MAAM,WACf,YAAW,KAAK,GAAG;EAGrB,MAAM,YAAY,WAAW,KAAK,MAAM,QAAQ,IAAI,CAAC,KAAK,KAAK;AAC/D,oBAAkB,YAAY,UAAU;AACxC,oBAAkB,OAAO,SAAS,YAAY,YAAY,SAAS,CAAC,oBAAoB,YAAY,SAAS,CAAC;AAC9G,oBAAkB;;AAGpB,kBAAiB,8BAA8B,eAAe;AAE9D,QAAO;EACP,eAAe;EACf,eAAe;IACb,MAAM"}

package/e2e/codemode.spec.ts

@@ -1,124 +0,0 @@
-import { test, expect } from "@playwright/test";
-
-/**
- * E2E tests for @cloudflare/codemode with a real AI binding.
- *
- * These verify the full pipeline:
- *   user prompt → LLM generates code via createCodeTool → DynamicWorkerExecutor
- *   runs the code in an isolated Worker → tool functions called via RPC → result returned.
- *
- * Uses Workers AI (@cf/zai-org/glm-4.7-flash) — no API key needed.
- */
-
-async function runChat(
-  request: import("@playwright/test").APIRequestContext,
-  baseURL: string,
-  userMessage: string
-): Promise<string> {
-  const res = await request.post(`${baseURL}/run`, {
-    headers: { "Content-Type": "application/json" },
-    data: {
-      messages: [
-        {
-          id: `msg-${crypto.randomUUID()}`,
-          role: "user",
-          parts: [{ type: "text", text: userMessage }]
-        }
-      ]
-    },
-    timeout: 45_000
-  });
-  expect(res.ok()).toBe(true);
-  return res.text();
-}
-
-test.describe("codemode e2e (Workers AI)", () => {
-  test.setTimeout(45_000);
-
-  test("LLM generates and executes code that calls addNumbers tool", async ({
-    request,
-    baseURL
-  }) => {
-    const response = await runChat(
-      request,
-      baseURL!,
-      "What is 17 + 25? Use the codemode tool with the addNumbers function to calculate this."
-    );
-
-    // The response stream should contain the answer 42 somewhere
-    // (either in the tool result or the LLM's text response)
-    expect(response).toContain("42");
-  });
-
-  test("LLM generates and executes code that calls getWeather tool", async ({
-    request,
-    baseURL
-  }) => {
-    const response = await runChat(
-      request,
-      baseURL!,
-      "What is the weather in London? Use the codemode tool with the getWeather function."
-    );
-
-    // The getWeather tool returns { city: "London", temperature: 22, condition: "Sunny" }
-    // The LLM should mention London or the weather data in its response
-    const lower = response.toLowerCase();
-    expect(
-      lower.includes("london") ||
-        lower.includes("22") ||
-        lower.includes("sunny")
-    ).toBe(true);
-  });
-
-  test("LLM generates and executes code that calls listProjects tool", async ({
-    request,
-    baseURL
-  }) => {
-    const response = await runChat(
-      request,
-      baseURL!,
-      "List all projects using the codemode tool with the listProjects function."
-    );
-
-    // listProjects returns Alpha and Beta
-    const lower = response.toLowerCase();
-    expect(lower.includes("alpha") || lower.includes("beta")).toBe(true);
-  });
-
-  test("LLM generates code with multiple tool calls", async ({
-    request,
-    baseURL
-  }) => {
-    const response = await runChat(
-      request,
-      baseURL!,
-      "Using the codemode tool, first get the weather in Paris, then add the numbers 10 and 5. Return both results."
-    );
-
-    // Should contain evidence of both tool calls completing
-    const lower = response.toLowerCase();
-    expect(
-      lower.includes("paris") ||
-        lower.includes("22") ||
-        lower.includes("15") ||
-        lower.includes("sunny")
-    ).toBe(true);
-  });
-
-  test("generateTypes returns valid type definitions", async ({
-    request,
-    baseURL
-  }) => {
-    const res = await request.get(`${baseURL}/types`);
-    expect(res.ok()).toBe(true);
-
-    const data = await res.json();
-    const types = data.types as string;
-
-    expect(types).toContain("declare const codemode");
-    expect(types).toContain("addNumbers");
-    expect(types).toContain("getWeather");
-    expect(types).toContain("createProject");
-    expect(types).toContain("listProjects");
-  });
-});

package/e2e/playwright.config.ts

@@ -1,24 +0,0 @@
-import { defineConfig } from "@playwright/test";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const PORT = 8798;
-const e2eDir = dirname(fileURLToPath(import.meta.url));
-const configPath = join(e2eDir, "wrangler.jsonc");
-
-export default defineConfig({
-  testDir: e2eDir,
-  testMatch: "*.spec.ts",
-  timeout: 60_000,
-  retries: 2,
-  workers: 1,
-  use: {
-    baseURL: `http://localhost:${PORT}`
-  },
-  webServer: {
-    command: `lsof -ti tcp:${PORT} | xargs kill -9 2>/dev/null; npx wrangler dev --config ${configPath} --port ${PORT}`,
-    port: PORT,
-    reuseExistingServer: !process.env.CI,
-    timeout: 30_000
-  }
-});

package/e2e/worker.ts

@@ -1,144 +0,0 @@
-import { Agent, routeAgentRequest, getAgentByName } from "agents";
-import {
-  streamText,
-  convertToModelMessages,
-  stepCountIs,
-  tool,
-  type UIMessage
-} from "ai";
-import { createWorkersAI } from "workers-ai-provider";
-import { z } from "zod";
-import { createCodeTool } from "../src/ai";
-import { DynamicWorkerExecutor, generateTypes } from "../src/index";
-
-type Env = {
-  AI: Ai;
-  LOADER: WorkerLoader;
-  CodemodeAgent: DurableObjectNamespace<CodemodeAgent>;
-};
-
-const pmTools = {
-  createProject: tool({
-    description: "Create a new project",
-    inputSchema: z.object({
-      name: z.string().describe("Project name"),
-      description: z.string().optional().describe("Project description")
-    }),
-    execute: async ({ name, description }) => ({
-      id: crypto.randomUUID(),
-      name,
-      description: description ?? ""
-    })
-  }),
-
-  listProjects: tool({
-    description: "List all projects",
-    inputSchema: z.object({}),
-    execute: async () => [
-      { id: "proj-1", name: "Alpha", description: "First project" },
-      { id: "proj-2", name: "Beta", description: "Second project" }
-    ]
-  }),
-
-  addNumbers: tool({
-    description: "Add two numbers together",
-    inputSchema: z.object({
-      a: z.number().describe("First number"),
-      b: z.number().describe("Second number")
-    }),
-    execute: async ({ a, b }) => ({ result: a + b })
-  }),
-
-  getWeather: tool({
-    description: "Get the current weather for a city",
-    inputSchema: z.object({
-      city: z.string().describe("The city name")
-    }),
-    execute: async ({ city }) => ({
-      city,
-      temperature: 22,
-      condition: "Sunny"
-    })
-  })
-};
-
-export class CodemodeAgent extends Agent<Env> {
-  observability = undefined;
-
-  async onRequest(request: Request): Promise<Response> {
-    const url = new URL(request.url);
-
-    if (url.pathname.endsWith("/chat") && request.method === "POST") {
-      return this.handleChat(request);
-    }
-
-    if (url.pathname.endsWith("/generate-types")) {
-      return Response.json({ types: generateTypes(pmTools) });
-    }
-
-    return new Response("Not found", { status: 404 });
-  }
-
-  async handleChat(request: Request): Promise<Response> {
-    const body = (await request.json()) as { messages: UIMessage[] };
-
-    const workersai = createWorkersAI({ binding: this.env.AI });
-    const model = workersai("@cf/zai-org/glm-4.7-flash");
-
-    const executor = new DynamicWorkerExecutor({
-      loader: this.env.LOADER
-    });
-
-    const codemode = createCodeTool({
-      tools: pmTools,
-      executor
-    });
-
-    const result = streamText({
-      model,
-      system: `You are a helpful assistant with access to a codemode tool.
-When asked to perform operations, use the codemode tool to write JavaScript code that calls the available functions on the \`codemode\` object.
-Keep responses very short (1-2 sentences max).
-When asked to add numbers, use the addNumbers tool via codemode.
-When asked about weather, use the getWeather tool via codemode.
-When asked about projects, use createProject or listProjects via codemode.`,
-      messages: await convertToModelMessages(body.messages),
-      tools: { codemode },
-      stopWhen: stepCountIs(5)
-    });
-
-    return result.toTextStreamResponse();
-  }
-}
-
-export default {
-  async fetch(request: Request, env: Env, _ctx: ExecutionContext) {
-    const url = new URL(request.url);
-
-    if (url.pathname.startsWith("/agents/")) {
-      return (
-        (await routeAgentRequest(request, env)) ||
-        new Response("Not found", { status: 404 })
-      );
-    }
-
-    if (url.pathname === "/run" && request.method === "POST") {
-      const agent = await getAgentByName(env.CodemodeAgent, "e2e-test");
-      const agentUrl = new URL(request.url);
-      agentUrl.pathname = "/chat";
-      return agent.fetch(
-        new Request(agentUrl.toString(), {
-          method: "POST",
-          headers: request.headers,
-          body: request.body
-        })
-      );
-    }
-
-    if (url.pathname === "/types") {
-      return Response.json({ types: generateTypes(pmTools) });
-    }
-
-    return new Response("OK");
-  }
-};

package/e2e/wrangler.jsonc

@@ -1,14 +0,0 @@
-{
-  "ai": { "binding": "AI", "remote": true },
-  "compatibility_date": "2026-01-28",
-  "compatibility_flags": ["nodejs_compat"],
-  "define": {
-    "__filename": "'index.ts'"
-  },
-  "durable_objects": {
-    "bindings": [{ "class_name": "CodemodeAgent", "name": "CodemodeAgent" }]
-  },
-  "main": "worker.ts",
-  "migrations": [{ "new_sqlite_classes": ["CodemodeAgent"], "tag": "v1" }],
-  "worker_loaders": [{ "binding": "LOADER" }]
-}

package/scripts/build.ts

@@ -1,25 +0,0 @@
-import { execSync } from "node:child_process";
-import { build } from "tsdown";
-
-async function main() {
-  await build({
-    clean: true,
-    dts: true,
-    entry: ["src/index.ts", "src/ai.ts"],
-    skipNodeModulesBundle: true,
-    external: ["cloudflare:workers"],
-    format: "esm",
-    sourcemap: true,
-    fixedExtension: false
-  });
-
-  // then run oxfmt on the generated .d.ts files
-  execSync("oxfmt --write ./dist/*.d.ts");
-
-  process.exit(0);
-}
-
-main().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});

package/src/ai.ts

@@ -1 +0,0 @@
-export { createCodeTool, type CreateCodeToolOptions } from "./tool";