feat(codemode): extract utilities into AI-free main entry point

[mattzcarey]

Summary

The main entry point (@cloudflare/codemode) no longer requires the ai or zod peer dependencies. They are now optional and only needed when importing from @cloudflare/codemode/ai.

This lets projects like Cloudflare MCP use the tested utility functions (sanitizeToolName, normalizeCode, generateTypesFromJsonSchema, executors) without pulling in the AI SDK.

Changes

• New utils.ts — pure helpers with zero deps: sanitizeToolName, toCamelCase, escapeJsDoc, escapeStringLiteral, quoteProp
• New json-schema-types.ts — JSON Schema → TypeScript conversion + generateTypesFromJsonSchema (no AI SDK)
• Renamed types.ts → tool-types.ts — AI-dependent generateTypes + ToolDescriptor/ToolDescriptors types
• Updated ai.ts — now also exports generateTypes, ToolDescriptor, ToolDescriptors
• Updated package.json — ai and zod peer deps marked optional: true, added json-schema as direct dep
• Reorganized tests — utils.test.ts, tool-types.test.ts, json-schema-types.test.ts (11 new tests for the AI-free APIs)
• Updated README — documents new module structure, AI-free usage, and generateTypesFromJsonSchema

Breaking change

generateTypes and ToolDescriptor/ToolDescriptors types moved from the main entry to @cloudflare/codemode/ai:

// Before
import { generateTypes } from "@cloudflare/codemode";

// After
import { generateTypes } from "@cloudflare/codemode/ai";

Module structure

Module	Requires ai/zod	Exports
@cloudflare/codemode	No	sanitizeToolName, normalizeCode, generateTypesFromJsonSchema, jsonSchemaToType, DynamicWorkerExecutor, ToolDispatcher
@cloudflare/codemode/ai	Yes	createCodeTool, generateTypes, ToolDescriptor, ToolDescriptors

Source file layout

src/
├── utils.ts              # sanitizeToolName, escapeJsDoc, quoteProp, etc. (zero deps)
├── normalize.ts          # normalizeCode (acorn only)
├── json-schema-types.ts  # JSON Schema → TypeScript (no ai/zod)
├── executor.ts           # Executor, DynamicWorkerExecutor, ToolDispatcher
├── tool-types.ts         # generateTypes, ToolDescriptor (requires ai/zod)
├── tool.ts               # createCodeTool (requires ai/zod)
├── index.ts              # main entry — AI-free exports
├── ai.ts                 # ./ai entry — AI SDK exports
└── tests/
    ├── utils.test.ts
    ├── normalize.test.ts
    ├── json-schema-types.test.ts
    ├── schema-conversion.test.ts
    ├── tool-types.test.ts
    ├── tool.test.ts
    └── executor.test.ts

Test plan

• All 164 tests pass across 7 test files
• Build output verified: dist/index.js has no ai imports, only dist/ai.js does
• Codex 5.3 review — addressed all findings (json-schema dep, leaky API, test gaps)
• Verified codemode-server and cloudflare-mcp can import normalizeCode from the main entry without needing ai

---

[changeset-bot]

🦋 Changeset detected

Latest commit: ccb9cfa

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@cloudflare/codemode	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[threepointone]

pass ci so I can merge this?

[mattzcarey]

pass ci so I can merge this?

on it boss

[pkg-pr-new]

Open in StackBlitz

agents

npm i https://pkg.pr.new/agents@1102

@cloudflare/ai-chat

npm i https://pkg.pr.new/@cloudflare/ai-chat@1102

@cloudflare/codemode

npm i https://pkg.pr.new/@cloudflare/codemode@1102

hono-agents

npm i https://pkg.pr.new/hono-agents@1102

@cloudflare/shell

npm i https://pkg.pr.new/@cloudflare/shell@1102

@cloudflare/voice

npm i https://pkg.pr.new/@cloudflare/voice@1102

@cloudflare/worker-bundler

npm i https://pkg.pr.new/@cloudflare/worker-bundler@1102

commit: cbc565e