feat(codemode): make model configurable instead of hardcoded gpt-4.1

[agents-git-bot]

Summary

Syncs documentation for cloudflare/agents#849

• Documents the new optional model parameter in experimental_codemode
• Updates usage examples to show model configuration
• Adds complete API reference section for the function signature
• Model defaults to openai("gpt-4.1") when not specified

Changes

Updated Documentation

File: public/.well-known/skills/agents-sdk/references/codemode.md

1. API Reference Section: Added comprehensive documentation for the experimental_codemode() function including all parameters and return types, clearly marking model as optional

2. Updated Usage Example: Modified the code example to include:

   • Optional model parameter in the codemode() call with inline specification
   • Comment indicating the parameter is optional and its default value
   • Consistent model usage in both codemode() and streamText()

3. Model Configuration Guide: Added a dedicated section showing:

   • How to specify different models (OpenAI, Anthropic, etc.)
   • Example of omitting the parameter to use the default
   • Multiple model provider examples

Implementation Details

The model parameter is optional in experimental_codemode(). When not provided, it defaults to openai("gpt-4.1"). This allows users to:

• Choose their preferred AI model
• Use any AI SDK-compatible model provider
• Continue using the default without code changes

Related Links

• Original PR: feat(codemode): make model configurable instead of hardcoded gpt-4.1 agents#849
• Issue: CodeMode LLM pinned to gpt-4.1 agents#794

---

Generated by automated docs sync from cloudflare/agents

[github-actions]

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

Pattern	Owners
*	@cloudflare/pcx-technical-writing

[github-actions]

Preview URL: https://6e91d441.preview.developers.cloudflare.com
Preview Branch URL: https://sync-docs-pr-849.preview.developers.cloudflare.com

[elithrar]

/bonk review this PR. replace gpt-4o (which is about to be deprecated) with gpt-5.2. review code to make sure it is valid and uses <TypeScriptExample> where relevant.

[ask-bonk]

Good — all 4 gpt-4o references are now gpt-5.2. The gpt-4.1 reference on line 273 is correct as-is since it refers to the historically hardcoded model in the old version.

Summary of changes made

Replaced all 4 instances of gpt-4o with gpt-5.2 in public/.well-known/skills/agents-sdk/references/codemode.md:

• Line 92: model initialization in main example
• Line 157: API reference parameter description
• Line 179: API reference inline example
• Line 263: migration guide "After" example

<TypeScriptExample> verdict

Not applicable. This is a .md skills file, not an .mdx docs page. All sibling skills files use standard fenced code blocks, which is correct.

github run

[elithrar]

Closing as this is auto-generated and not the source of truth: https://github.com/cloudflare/skills/