docs(factories): document agentDefaults.computerUseModel (unreleased feature)

[warp-agent-staging]

Summary

Documents the new computerUseModel factory-definition key on the "Factory definition syntax" page (docs.warp.dev/factories/factory-as-code/), per the drafted copy from Doc 'n Roll intake.

⚠️ Unreleased feature — do not merge or publish yet. computerUseModel is implemented in warpdotdev/warp-server#15542 and warpdotdev/warp#15289, plus a pending oz-agent-worker follow-up. This PR is intentionally opened as a draft and must stay a draft until all three have shipped, so the docs don't publish ahead of the feature. A human should promote it to ready for review only after that.

Changes

In src/content/docs/factories/factory-as-code.mdx:

1. New ### agentDefaults.computerUseModel subsection after agentDefaults.workerHost, describing the key, its example usage, its scope (Warp Agent harness only, ignored when computer use is disabled), its non-exclusivity with harness, and the self-hosted worker version requirement. Includes a one-line pointer to model choice for agents noting computer use supports a restricted model set (no specific model IDs enumerated, since the allowlist changes over time).
2. Added computerUseModel to the agents/<name>/agent.md frontmatter key list (the "same keys as agentDefaults" bullet), so agents can override the factory default.
3. Added computerUseModel to the automations/<name>/automation.md execution-override key list, with the same semantics.

Edit 4 from the request (pointer from the new section to a "model choice for agents" page) is folded into edit 1 above, since that page already exists at /agents/inference/model-choice/.

Verification

This is a documentation-copy-only change (new prose, a YAML example, and additions to existing key-enumeration lists) with no runnable behavior — pure data/copy, one of the testing-exempt categories in factory-verification, so no regression test was added.

Ran the repo's documented checks:

• npm install && npm run build — succeeds, no errors (Complete!, 376 docs generated, sitemap + search index built).
• python3 .agents/skills/style_lint/style_lint.py --changed — 0 errors. One pre-existing warning (UNRECOGNIZED-TERM for "GitHub" bolded on line 20) is unrelated to this diff and out of scope for this change.

Visual verification

This is a rendered docs page, a user-facing surface, so it needs visual proof per factory-verification/factory-ui-verification. The proof is embedded below, captured from a live npm run dev render of this branch (via a computer-use session) — the three sections shown are the new agentDefaults.computerUseModel section, the agents/<name>/agent.md frontmatter key list, and the automations/<name>/automation.md "Execution overrides" list, each showing computerUseModel rendering correctly.

Computer-use screenshots (3)

Area 1: The "agentDefaults.computerUseModel" section fully visible, showing the heading, all three paragraphs, the syntax-highlighted YAML code block, and inline links ("model choice for agents", "self-hosted worker").

Area 2: The frontmatter key bullet list under "agents/<name>/agent.md" heading, showing all four bullets including the one enumerating model, harness, runner, environmentId, secrets, mcpServers, workerHost, computerUseModel.

Area 3: The "Execution overrides" section heading and paragraph enumerating the keys: model, harness, runner, environmentId, secrets, mcpServers, workerHost, and computerUseModel.

Originating thread: adhoc Factory MCP intake (task 364c959b-3c3d-45ee-88df-9c3efe16301a, factory "Doc 'n Roll", requester daniel@warp.dev)

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs	Ready	Preview	Aug 19, 2026 8:33pm

[warp-agent-staging]

Factory review

The computerUseModel documentation is accurate and complete: it covers the Warp Agent harness gate, behavior when computer use is disabled, compatibility with harness, restricted model guidance without publishing an allowlist, worker-version guidance, and the agent and automation overrides.

Blocking finding

The PR has no visual proof of the rendered user-facing documentation change. Capture a preview screenshot or video demonstrating the new section, then attach it to the PR description.

Validation

• GitHub CI: build, link, audit, analysis, CodeQL, Vercel Preview, and CLA checks passed.
• npm run typecheck passed with 0 errors.
• Internal link checker passed with 0 broken links.
• style_lint --changed reported only one unrelated pre-existing glossary warning.
• ./script/presubmit is not present in this repository. The local build was not accepted as a pass because the sandbox provides unsupported Node 25 and failed while prerendering the unrelated /_llms-txt/support.txt route; the authoritative GitHub build check passed.

Verdict: Changes requested

Task record: ticket_id=364c959b-3c3d-45ee-88df-9c3efe16301a, ticket_source=adhoc, task_id=364c959b-3c3d-45ee-88df-9c3efe16301a, factory_name=Doc 'n Roll', requester daniel@warp.dev.

Review run: https://oz.staging.warp.dev/runs/01a01bbb-79f3-7d5e-895d-fcfcb8eeaff8

[warp-agent-staging]

Factory re-review

The sole prior finding is closed. I directly inspected the three embedded screenshots and confirmed that they render:

• The complete agentDefaults.computerUseModel section, including its YAML example, all behavioral caveats, and both links.
• The agents/<name>/agent.md frontmatter override bullet containing computerUseModel.
• The automation Execution overrides text containing computerUseModel.

The screenshots show no raw markup, error state, broken layout, or missing required content. The prior review thread is resolved, the documentation diff has not changed, and all GitHub checks remain successful.

Verdict: Accepted

Task record: ticket_id=364c959b-3c3d-45ee-88df-9c3efe16301a, ticket_source=adhoc, task_id=364c959b-3c3d-45ee-88df-9c3efe16301a, factory_name=Doc 'n Roll', requester daniel@warp.dev.

Review run: https://oz.staging.warp.dev/runs/01a01bbb-79f3-7d5e-895d-fcfcb8eeaff8