Skip to content

docs(factories): refresh Computer Use model catalog - #581

Merged
rachaelrenk merged 4 commits into
mainfrom
factory/computer-use-model-docs
Oct 8, 2026
Merged

rachaelrenk merged 4 commits into
mainfrom
factory/computer-use-model-docs

Conversation

@warp-agent-staging

@warp-agent-staging warp-agent-staging Bot commented Aug 19, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Refreshes the factory definition reference with the 11 Claude 5.5 model IDs currently available for Computer Use in production. The broader computerUseModel documentation shipped through #754, so this update preserves the current page and limits the diff to the missing catalog entries.

Changes

  • Add five Claude Sonnet 5.5 Computer Use model IDs.
  • Add six Claude Opus 5.5 Computer Use model IDs.

Verification

  • python3 .agents/skills/style_lint/style_lint.py --changed — completed with one pre-existing UNRECOGNIZED-TERM warning for “GitHub” on line 20.
  • python3 .agents/skills/check_for_broken_links/check_links.py --internal-only — passed; 4,335 internal links checked with no broken links.
  • python3 .agents/skills/doc_quality_policy/check_compression_contract.py src/content/docs/factories/factory-as-code.mdx --content-type reference — passed.
  • npm ci && npm run build — passed; Astro generated 394 Markdown documents.
  • git diff --check origin/main...HEAD — passed.
  • trunk check and trunk fmt — not run because Trunk is not installed in this environment.

Unverified claims

None. The model IDs were verified against the current Computer Use model catalog and production feature configuration in warp-server.

Documentation risk

Risk: engineering-review-required
Rationale: Updates the public Computer Use model availability catalog from production configuration.
Source files consulted: logic/ai/llm/model_choice.go@16e4e4ddc9fdc1911ba3bf7e6a224ccc2ce76acb, config/prod.yaml@16e4e4ddc9fdc1911ba3bf7e6a224ccc2ce76acb
Engineering review status: pending
Docs override: none

Co-Authored-By: Oz oz-agent@warp.dev

@cla-bot cla-bot Bot added the cla-signed label Aug 19, 2026
@warp-agent-staging warp-agent-staging Bot added the warpy-factory Opened by the Warp factory agents label Aug 19, 2026
@vercel

vercel Bot commented Aug 19, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
docs Ready Ready Preview Oct 7, 2026 6:34am UTC

Request Review

@warp-agent-staging warp-agent-staging Bot left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

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

Comment thread src/content/docs/factories/factory-as-code.mdx

@warp-agent-staging warp-agent-staging Bot left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

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

@warp-for-oss

warp-for-oss Bot commented Aug 26, 2026 •

Copy link
Copy Markdown
Contributor

@hongyi-chen

I'm starting a first review of this pull request.

You can view the conversation on Warp.

I completed the review and no human review was requested for this pull request.

Comment /warp-agent-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

@warp-for-oss warp-for-oss 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.

Overview

This PR documents the new agentDefaults.computerUseModel key on the factory-as-code reference page and adds it to the agent and automation override lists. The change is limited to docs copy and key lists; I found one terminology issue in the new section.

Concerns

  • The new agentDefaults.computerUseModel section uses subagent for the computer use runtime, but the docs glossary reserves subagent for child agents created by a parent agent. The inline suggestion keeps the description focused on the user-visible configuration behavior.
  • The PR description says this feature is unreleased, so keep this draft unmerged until the product surface ships. This is a release-readiness constraint, not a counted diff finding.

Verdict

Found: 0 critical, 0 important, 1 suggestions

Approve with nits

Comment /warp-agent-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

Comment thread src/content/docs/factories/factory-as-code.mdx Outdated

@warp-agent-staging warp-agent-staging Bot left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Factory re-review

The documentation change builds and renders correctly, and the existing visual proof covers the new section plus both override lists. One unresolved terminology finding still needs a copy-only correction before acceptance.

Finding

  • src/content/docs/factories/factory-as-code.mdx:213 — Replace “computer use subagent” with wording that describes computer use without redefining subagent, which the glossary reserves for child agents created by a parent agent.

Validation

  • GitHub CI checks: passed.
  • npm run typecheck: passed with 0 errors.
  • npm run build: passed.
  • Internal link checker: passed with 0 broken links.
  • Live local render: verified the new section, both override lists, and both added links with no console or layout errors.
  • Local npm run lint: unavailable because trunk is not installed in this environment; ./script/presubmit is not present in this repository.

Verdict

Rework needed

Review run: https://oz.staging.warp.dev/runs/01a04013-cc87-763e-88ea-d23f55833786

Comment thread src/content/docs/factories/factory-as-code.mdx Outdated
Computer use runs as part of the agent's own run, not as a separate
child agent, so 'subagent' conflicted with the terminology glossary's
definition of a subagent as a child agent created by a parent agent.

Co-Authored-By: Warp <agent@warp.dev>

@warp-agent-staging warp-agent-staging Bot left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Overview

The PR documents agentDefaults.computerUseModel and lists the override on agent and automation definitions. The final rework replaces both inaccurate uses of “computer use subagent” with “computer use,” matching the glossary.

Verdict

Checks: CI ✅ · build ✅ · typecheck ✅ · internal links ✅ · visual proof ✅ · style lint: no new diff issues (npm run lint unavailable because trunk is absent; no ./script/presubmit in this repository)
Found: 0 critical, 0 important, 0 suggestions

Accepted

Review run

https://oz.staging.warp.dev/runs/01a0402f-2f45-7e82-b5e3-1ddde6fc59fe

@warp-agent-staging warp-agent-staging Bot added the factory:docs-factory Label associated to the "docs-factory" factory label Oct 7, 2026
Co-Authored-By: Oz <oz-agent@warp.dev>
@warp-agent-staging warp-agent-staging Bot changed the title docs(factories): document agentDefaults.computerUseModel (unreleased feature) docs(factories): refresh Computer Use model catalog Oct 7, 2026

@github-actions github-actions 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.

Review summary

The independent agent completed its review for this commit.

Findings

  • No findings.

Verdict

Approve

@rachaelrenk
rachaelrenk merged commit 15bde26 into main Oct 8, 2026
15 of 17 checks passed
@rachaelrenk
rachaelrenk deleted the factory/computer-use-model-docs branch October 8, 2026 14:04
@warp-agent-staging

Copy link
Copy Markdown
Contributor Author

@rachaelrenk, your GitHub account is not connected to Warp. Connect your GitHub account.

This branch was successfully deployed

1 active deployment
Preview — 8a7c1c32 Deployed Oct 7, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cla-signed factory:docs-factory Label associated to the "docs-factory" factory warpy-factory Opened by the Warp factory agents

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants