Skip to content

Add changelog for @cloudflare/codemode v0.2.0–v0.2.1 - #29077

Merged
mattzcarey merged 4 commits into
productionfrom
docs/agents-codemode-sdk-changelog
Mar 18, 2026
Merged

Add changelog for @cloudflare/codemode v0.2.0–v0.2.1#29077
mattzcarey merged 4 commits into
productionfrom
docs/agents-codemode-sdk-changelog

Conversation

@mattzcarey

Copy link
Copy Markdown
Contributor

Summary

  • Adds a combined changelog entry for @cloudflare/codemode v0.2.0 and v0.2.1
  • Covers: new @cloudflare/codemode/mcp barrel export (codeMcpServer, openApiMcpServer), zero-dependency main entry point (breaking import change), custom sandbox modules, and internal normalization/sanitization

Test plan

  • Verify the changelog renders correctly on the /changelog/ page
  • Confirm code examples display properly with <TypeScriptExample>

@mattzcarey
mattzcarey requested a review from a team as a code owner March 18, 2026 11:50
@mattzcarey
mattzcarey requested a review from a team March 18, 2026 11:50
@github-actions

github-actions Bot commented Mar 18, 2026

Copy link
Copy Markdown
Contributor

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/content/changelog/ @cloudflare/pm-changelogs, @cloudflare/pcx-technical-writing
/src/content/docs/agents/ @irvinebroque, @rita3ko, @elithrar, @thomasgauvin, @threepointone, @whoiskatrin, @cloudflare/pcx-technical-writing, @cloudflare/ai-agents, @cloudflare/dev-plat-leads

- Fix generateTypes import path (now @cloudflare/codemode/ai)
- Remove stale zod-to-ts Vite config and limitation
- Update installation to reflect optional ai/zod peer deps
- Add modules option to DynamicWorkerExecutor table
- Add internal normalization/sanitization note
- Add MCP server wrappers section (codeMcpServer, openApiMcpServer)
- Add generateTypesFromJsonSchema example
- Fix changelog modules example (values are source strings)
@elithrar

Copy link
Copy Markdown
Collaborator

/bonk review this change log

@ask-bonk ask-bonk Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Posted 4 inline suggestions.

Comment thread src/content/changelog/agents/2026-03-17-codemode-sdk-v0.2.1.mdx Outdated
| `DynamicWorkerExecutor` | Sandboxed code execution via Dynamic Worker Loader |
| `ToolDispatcher` | RPC target for dispatching tool calls from sandbox to host |

The `ai` and `zod` peer dependencies are now optional — only required when importing from `@cloudflare/codemode/ai`.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Style guide: avoid contractions.

Suggested change
The `ai` and `zod` peer dependencies are now optional — only required when importing from `@cloudflare/codemode/ai`.
The `ai` and `zod` peer dependencies are now optional — only required when importing from `@cloudflare/codemode/ai`.

This line looks identical, but on line 52 the same sentence also appears without a contraction issue — the problem is actually on line 51 below. (Disregard this comment if the linter does not flag it.)


</TypeScriptExample>

For JSON Schema inputs that don't depend on the AI SDK, use the main entry point:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Style guide: avoid contractions. Use "do not" instead of "don't".

Suggested change
For JSON Schema inputs that don't depend on the AI SDK, use the main entry point:
For JSON Schema inputs that do not depend on the AI SDK, use the main entry point:

Comment on lines +40 to 48
```sh
npm install @cloudflare/codemode
```

The `ai` and `zod` packages are optional peer dependencies — only required when importing from `@cloudflare/codemode/ai`:

```sh
npm install @cloudflare/codemode ai zod
```

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Showing two sequential install commands without clear separation could confuse readers. Consider restructuring so the optional command is clearly conditional:

Suggested change
```sh
npm install @cloudflare/codemode
```
The `ai` and `zod` packages are optional peer dependencies — only required when importing from `@cloudflare/codemode/ai`:
```sh
npm install @cloudflare/codemode ai zod
```
```sh
npm install @cloudflare/codemode

If you use @cloudflare/codemode/ai, also install the ai and zod peer dependencies:

npm install ai zod

@ask-bonk

ask-bonk Bot commented Mar 18, 2026

Copy link
Copy Markdown
Contributor

Review posted on PR #29077 with 4 inline suggestions:

  1. MEDIUMsrc/content/changelog/agents/2026-03-17-codemode-sdk-v0.2.1.mdx:31 — Missing await on codeMcpServer() call, inconsistent with the API reference page which uses await.
  2. LOWsrc/content/changelog/agents/2026-03-17-codemode-sdk-v0.2.1.mdx:63 — Flagged the repeated dependency sentence for review (no contraction issue in the end, but worth verifying the duplication between lines 52 and 63 is intentional).
  3. LOWsrc/content/docs/agents/api-reference/codemode.mdx:351 — Contraction "don't" should be "do not" per style guide.
  4. MEDIUMsrc/content/docs/agents/api-reference/codemode.mdx:40-48 — Two sequential npm install commands without clear separation. Suggested restructuring so the optional ai zod install is clearly conditional.

No build breakers or critical issues found. The changelog frontmatter is valid, component imports are correct, code block languages are lowercase and supported, internal links use root-relative paths, and heading hierarchy is sequential.

github run

mattzcarey and others added 2 commits March 18, 2026 18:56
Co-authored-by: ask-bonk[bot] <249159057+ask-bonk[bot]@users.noreply.github.com>
- Add missing await to codeMcpServer call in changelog
- Replace contraction "don't" with "do not" per style guide
- Restructure install commands for clarity (separate base + optional deps)
@mattzcarey
mattzcarey enabled auto-merge (squash) March 18, 2026 19:00
@mattzcarey
mattzcarey merged commit 66107cd into production Mar 18, 2026
9 checks passed
@mattzcarey
mattzcarey deleted the docs/agents-codemode-sdk-changelog branch March 18, 2026 19:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants