refactor(cli): extract sandbox status action

[cv]

Summary

Extract the sandbox status implementation from src/nemoclaw.ts into a dedicated action module. This removes sandboxStatus from the transitional runtime bridge while preserving the existing status output, gateway reconciliation, process health, and NIM reporting behavior.

Stack Navigation

• Position: 4 of 60
• Previous PR: #2891 — refactor(cli): extract sandbox connect action
• Next PR: #2893 — refactor(cli): extract sandbox doctor action

Changes

• Added src/lib/sandbox-status-action.ts for sandbox status rendering, gateway lookup handling, local inference health, active session reporting, process health, and NIM status.
• Updated src/lib/sandbox-runtime-actions.ts to call the extracted status action.
• Removed sandboxStatus from src/nemoclaw.ts and NemoClawRuntimeBridge.

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)

Verification

• npx prek run --all-files passes
• npm test passes
• Tests added or updated for new or changed behavior
• No secrets, API keys, or credentials committed
• Docs updated for user-facing behavior changes
• make docs builds without warnings (doc changes only)
• Doc pages follow the style guide (doc changes only)
• New doc pages include SPDX header and frontmatter (new pages only)

---

Signed-off-by: Carlos Villela cvillela@nvidia.com

Summary by CodeRabbit

• Refactoring

  • Reorganized sandbox status command implementation for improved maintainability.

• Improvements

  • Enhanced sandbox status reporting with comprehensive diagnostics including model information, provider details, inference status, GPU information, and policy checks.
  • Improved sandbox health verification with better error detection and guidance when state issues are encountered.

[copy-pr-bot]

Auto-sync is disabled for draft pull requests in this repository. Workflows must be run manually.

Contributors can view more details about this message here.

[coderabbitai]

📝 Walkthrough

Walkthrough

The PR extracts the sandboxStatus functionality from the runtime bridge pattern into a standalone module. The new sandbox-status-action.ts contains the full implementation, the bridge interface removes the method declaration, and related imports/exports are updated accordingly.

Changes

Sandbox Status Extraction

Layer / File(s)	Summary
Interface Update src/lib/nemoclaw-runtime-bridge.ts	sandboxStatus method removed from NemoClawRuntimeBridge interface.
Core Implementation src/lib/sandbox-status-action.ts	New module exports showSandboxStatus(sandboxName) with full logic for reconciling gateway state, capturing inference output, probing provider health, detecting sessions, checking agent version, and handling state-specific guidance and recovery flows.
Facade Update src/lib/sandbox-runtime-actions.ts	showSandboxStatus now dynamically requires and delegates to ./sandbox-status-action instead of calling the runtime bridge.
Integration & Cleanup src/nemoclaw.ts	Removes sandboxStatus from exports.runtimeBridge, updates imports (captureOpenshellForStatus/isCommandTimeout → captureOpenshell), and deletes the old implementation body.

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~45 minutes

Possibly related PRs

• NVIDIA/NemoClaw#2836: Applies the same extraction pattern—moving a sandbox action into a dedicated module, updating the facade to require it, and removing the corresponding export from the runtime bridge.

Suggested labels

NemoClaw CLI, refactor

Suggested reviewers

• cjagwani

Poem

🐰 A bridge grows lighter, its burden shed,
New halls are carved for status to spread,
The facade still smiles, directing the way,
As sandbox affairs find their own display! ✨

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 25.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately describes the main change: extracting the sandbox status action from the main module into a dedicated action module.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ 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 refactor/oclif-extract-sandbox-status-action

Tip

💬 Introducing Slack Agent: The best way for teams to turn conversations into code.

Slack Agent is built on CodeRabbit's deep understanding of your code, so your team can collaborate across the entire SDLC without losing context.

• Generate code and open pull requests
• Plan features and break down work
• Investigate incidents and troubleshoot customer tickets together
• Automate recurring tasks and respond to alerts with triggers
• Summarize progress and report instantly

Built for teams:

• Shared memory across your entire org—no repeating context
• Per-thread sandboxes to safely plan and execute work
• Governance built-in—scoped access, auditability, and budget controls

One agent for your entire SDLC. Right inside Slack.

👉 Get your free trial and get 200 agent minutes per Slack user (a $50 value).

---

_{Review rate limit: 9/10 reviews remaining, refill in 6 minutes.}

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

[copy-pr-bot]

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

[prekshivyas]

LGTM — clean mechanical extraction of sandboxStatus into src/lib/sandbox-status-action.ts. Output ordering, exit codes, recovery hints, and color/styling all preserved (verified RD from terminal-style is byte-identical to the local _RD). Old code path fully removed from src/nemoclaw.ts and NemoClawRuntimeBridge; no orphaned imports introduced by this PR.

Carryover nit (not blocking, from #2891): parseForwardList is still imported but unused at src/nemoclaw.ts:79 — happy for that to land in a follow-up cleanup PR in the stack.

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@src/lib/sandbox-status-action.ts`:
- Around line 34-35: Remove the obsolete ESLint suppression comment above the
showSandboxStatus function; delete the line "// eslint-disable-next-line
complexity" so the function declaration export async function
showSandboxStatus(sandboxName: string): Promise<void> is not preceded by any
linter suppression. Ensure no replacement Biome directive is added and leave the
function signature as-is.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: 6f0e3ee1-ca6b-4e5d-998b-ff695c26a32d

📥 Commits

Reviewing files that changed from the base of the PR and between cd79ad0 and 5cfa607.

📒 Files selected for processing (4)

• src/lib/nemoclaw-runtime-bridge.ts
• src/lib/sandbox-runtime-actions.ts
• src/lib/sandbox-status-action.ts
• src/nemoclaw.ts

💤 Files with no reviewable changes (2)

• src/lib/nemoclaw-runtime-bridge.ts
• src/nemoclaw.ts

[coderabbitai]

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
set -euo pipefail

fd -HI '^biome\.json$' . -x sh -c 'printf "== %s ==\n" "$1"; cat "$1"' _ {}
printf "\n== JS/TS ESLint suppression comments ==\n"
rg -n --iglob '*.{js,jsx,ts,tsx}' 'eslint-disable'

Repository: NVIDIA/NemoClaw

Length of output: 3933

---

🏁 Script executed:

fd -HI '^sandbox-status-action\.ts$' . -x wc -l

Repository: NVIDIA/NemoClaw

Length of output: 98

---

🏁 Script executed:

fd -HI '^sandbox-status-action\.ts$' . -x head -40

Repository: NVIDIA/NemoClaw

Length of output: 1784

---

🏁 Script executed:

sed -n '34,260p' ./src/lib/sandbox-status-action.ts | head -100

Repository: NVIDIA/NemoClaw

Length of output: 4088

---

🏁 Script executed:

sed -n '34,260p' ./src/lib/sandbox-status-action.ts | tail -70

Repository: NVIDIA/NemoClaw

Length of output: 2794

---

Remove the ESLint complexity suppression comment.

The // eslint-disable-next-line complexity directive will not suppress any Biome rules, and Biome (per the coding guidelines) is the active linter for this file. This comment signals false coverage. Since the coding guidelines state that complexity hotspots are tracked separately, drop this comment entirely rather than converting it to Biome syntax.

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@src/lib/sandbox-status-action.ts` around lines 34 - 35, Remove the obsolete
ESLint suppression comment above the showSandboxStatus function; delete the line
"// eslint-disable-next-line complexity" so the function declaration export
async function showSandboxStatus(sandboxName: string): Promise<void> is not
preceded by any linter suppression. Ensure no replacement Biome directive is
added and leave the function signature as-is.