[miyoungc]

Summary

Corrects inference documentation so manifest iteration names the implemented agents apply -f command, named-sandbox syntax matches the CLI, and the Deep Agents recreation heading appears only in the Deep Agents guide. Adds variant-rendering regression coverage for both QA defects.

Related Issue

Fixes #7308
Fixes #7309
Supersedes #7321

Changes

• Document nemoclaw <name> agents apply -f <agents.yaml> in the manifest iteration guidance without adding the nonexistent agents show command.
• Distinguish positional sandbox names for shields from inference set --sandbox <name>.
• Keep the Deep Agents recreation heading inside the deepagents variant block.
• Add focused regression assertions for the affected prose and generated agent variants.

Type of Change

• Code change (feature, bug fix, or refactor)
• Code change with doc updates
• Doc only (prose changes, no code sample modifications)
• Doc only (includes code sample changes)

Quality Gates

• Tests added or updated for changed behavior
• Existing tests cover changed behavior — justification:
• Tests not applicable — justification:
• Docs updated for user-facing behavior changes
• Docs not applicable — justification:
• Sensitive paths changed (security, policy, credentials, preflight, onboarding, inference, runner, sandbox, or messaging)
• Sensitive-path review completed or maintainer-approved waiver recorded — reviewer/approval link/justification: Miyoung Choi reviewed the existing inference command syntax and generated variant behavior; no inference runtime changed.
• Non-success, skipped, or missing CI check accepted by maintainer — check name, approval link, and follow-up issue:

Documentation Writer Review

• Documentation writer subagent reviewed the completed changes
• Result: docs-updated
• Evidence: Reviewed docs/inference/declarative-agents-manifest.mdx and docs/inference/switch-providers.mdx for terminology, structure, voice, and code-sample presentation. The focused 15-test Vitest run and documentation build passed.
• Agent: Codex Desktop
• PR: docs: correct inference CLI references #7405

DGX Station Hardware Evidence

• Tested on DGX Station
• Tested commit:
• Station profile/scenario:
• Result:
• Supporting evidence:

Verification

• PR description includes a Signed-off-by: line and every commit appears as Verified in GitHub
• Normal pre-commit, commit-msg, and pre-push hooks passed, or npm run check:diff passed when hooks were skipped or unavailable
• Targeted behavior tests pass for the current change set, or tests are marked not applicable above — command/result or justification: npx vitest run --project integration test/agent-variant-docs.test.ts passed (1 file, 15 tests).
• Applicable broad gate passed — npm test for broad runtime/test-harness changes; npm run check for repo-wide validation/coverage changes — command/result: not applicable; this change updates two documentation pages and focused regression assertions.
• Quality Gates section completed with required justifications or waivers
• No secrets, API keys, or credentials committed
• npm run docs builds without warnings (doc changes only) — passed with 0 errors and 1 existing light-mode accent contrast warning unrelated to this diff.
• Doc pages follow the style guide (doc changes only)
• New doc pages include SPDX header and frontmatter (new pages only) — not applicable; no pages were added.

---

Signed-off-by: Miyoung Choi miyoungc@nvidia.com

Summary by CodeRabbit

• Documentation

  • Added guidance for reconciling agent rosters from an agents.yaml manifest.
  • Clarified sandbox selection syntax when switching inference providers.
  • Improved the placement of Deep Agents sandbox recreation instructions.

• Tests

  • Added coverage to verify manifest iteration and provider-switching documentation across supported agent variants.

[coderabbitai]

📝 Walkthrough

Walkthrough

Updated inference documentation for manifest reconciliation and runtime provider switching, including Deep Agents variant scoping. Added regression tests covering rendered agent commands and variant-specific provider-switching content.

Changes

Inference documentation

Layer / File(s)	Summary
Manifest iteration guidance docs/inference/declarative-agents-manifest.mdx, test/agent-variant-docs.test.ts	Documents reconciling agents from agents.yaml with agents apply, and verifies the rendered Iterating command list.
Provider switching variant rendering docs/inference/switch-providers.mdx, test/agent-variant-docs.test.ts	Clarifies positional versus flagged sandbox syntax, scopes the Deep Agents heading correctly, and tests output for OpenClaw, Hermes, and Deep Agents.

Estimated code review effort: 2 (Simple) | ~10 minutes

Suggested labels: v0.0.93

Suggested reviewers: laitingsheng, ericksoa

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Linked Issues check	✅ Passed	The docs and regression tests address both linked issues by fixing the manifest commands, sandbox syntax, and Deep Agents-only heading.
Out of Scope Changes check	✅ Passed	The changes stay within the documented CLI wording and regression coverage needed for the linked issues.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately summarizes the main change: correcting inference CLI references in documentation.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch codex/docs-inference-cli-references

---

_{Comment @coderabbitai help to get the list of available commands.}

[github-code-quality]

Code Coverage Overview

Languages: TypeScript

TypeScript / code-coverage/plugin

The overall coverage in commit c06e315 in the codex/docs-inference... branch remains at 96%, unchanged from commit cce9540 in the main branch.

---

_{Updated July 23, 2026 14:34 UTC}

[github-actions]

🌿 Preview your docs: https://nvidia-preview-pr-7405.docs.buildwithfern.com/nemoclaw

[github-actions]

PR Review Advisor — Informational

Advisor assessment: Informational / high confidence
Next action: No advisor follow-up needed.
Findings: 0 blockers · 0 warnings · 0 suggestions
Status: No actionable findings remain in the canonical review ledger.

Model lanes

• GPT-5.6 Terra (primary): Completed · high confidence · 0 blockers · 0 warnings · 0 suggestions
• Nemotron 3 Ultra (second opinion): Completed · high confidence · 0 blockers · 0 warnings · 0 suggestions
• Model comparison: normalized findings match; normalized E2E selections match; severity counts match.

Nemotron output stays in workflow artifacts and does not change the assessment above.

E2E guidance

Advisory only. E2E / PR Gate selects and runs jobs independently.

Recommended E2E: None

1 optional E2E recommendation

• docs-validation

Workflow run details

This automated review informs maintainers. Warnings and suggestions do not require a response. A maintainer decides whether to merge.