refactor(cli): introduce sandbox runtime action facade

src/lib/connect-cli-command.ts

@@ -6,7 +6,7 @@
 import { Args, Command, Flags } from "@oclif/core";
 
 import { CLI_NAME } from "./branding";
-import { getNemoClawRuntimeBridge } from "./nemoclaw-runtime-bridge";
+import { connectSandbox } from "./sandbox-runtime-actions";
 
 export default class ConnectCliCommand extends Command {
   static id = "sandbox:connect";
@@ -30,7 +30,7 @@ export default class ConnectCliCommand extends Command {
       console.error(`  Usage: ${CLI_NAME} <name> connect [--probe-only]`);
       process.exit(1);
     }
-    await getNemoClawRuntimeBridge().sandboxConnect(args.sandboxName, {
+    await connectSandbox(args.sandboxName, {
       probeOnly: Boolean(flags["probe-only"]),
     });
   }

src/lib/destroy-cli-command.ts

@@ -5,7 +5,7 @@
 
 import { Args, Command, Flags } from "@oclif/core";
 
-import { getNemoClawRuntimeBridge } from "./nemoclaw-runtime-bridge";
+import { destroySandbox } from "./sandbox-runtime-actions";
 
 export default class DestroyCliCommand extends Command {
   static id = "sandbox:destroy";
@@ -27,6 +27,6 @@ export default class DestroyCliCommand extends Command {
     const legacyArgs: string[] = [];
     if (flags.yes) legacyArgs.push("--yes");
     if (flags.force) legacyArgs.push("--force");
-    await getNemoClawRuntimeBridge().sandboxDestroy(args.sandboxName, legacyArgs);
+    await destroySandbox(args.sandboxName, legacyArgs);
   }
 }

src/lib/rebuild-cli-command.ts

@@ -5,7 +5,7 @@
 
 import { Args, Command, Flags } from "@oclif/core";
 
-import { getNemoClawRuntimeBridge } from "./nemoclaw-runtime-bridge";
+import { rebuildSandbox } from "./sandbox-runtime-actions";
 
 export default class RebuildCliCommand extends Command {
   static id = "sandbox:rebuild";
@@ -29,6 +29,6 @@ export default class RebuildCliCommand extends Command {
     if (flags.yes) legacyArgs.push("--yes");
     if (flags.force) legacyArgs.push("--force");
     if (flags.verbose) legacyArgs.push("--verbose");
-    await getNemoClawRuntimeBridge().sandboxRebuild(args.sandboxName, legacyArgs);
+    await rebuildSandbox(args.sandboxName, legacyArgs);
   }
 }

src/lib/sandbox-inspection-cli-command.ts

@@ -8,6 +8,7 @@ import { Args, Command, Flags } from "@oclif/core";
 import { CLI_NAME } from "./branding";
 import { getNemoClawRuntimeBridge } from "./nemoclaw-runtime-bridge";
 import * as sandboxConfig from "./sandbox-config";
+import { showSandboxStatus } from "./sandbox-runtime-actions";
 
 const sandboxNameArg = Args.string({
   name: "sandbox",
@@ -30,7 +31,7 @@ export class SandboxStatusCommand extends Command {
 
   public async run(): Promise<void> {
     const { args } = await this.parse(SandboxStatusCommand);
-    await getNemoClawRuntimeBridge().sandboxStatus(args.sandboxName);
+    await showSandboxStatus(args.sandboxName);
   }
 }
 

src/lib/sandbox-logs-cli-command.ts

@@ -5,13 +5,12 @@
 
 import { Args, Command, Flags } from "@oclif/core";
 
-import type { NemoClawRuntimeBridge } from "./nemoclaw-runtime-bridge";
-import { getNemoClawRuntimeBridge } from "./nemoclaw-runtime-bridge";
+import { showSandboxLogs } from "./sandbox-runtime-actions";
 
-let runtimeBridgeFactory = (): Pick<NemoClawRuntimeBridge, "sandboxLogs"> => getNemoClawRuntimeBridge();
+let runtimeBridgeFactory = () => ({ sandboxLogs: showSandboxLogs });
 
 export function setSandboxLogsRuntimeBridgeFactoryForTest(
-  factory: () => Pick<NemoClawRuntimeBridge, "sandboxLogs">,
+  factory: () => { sandboxLogs: (sandboxName: string, follow: boolean) => void },
 ): void {
   runtimeBridgeFactory = factory;
 }

src/lib/sandbox-runtime-actions.ts

@@ -0,0 +1,41 @@
+// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+// SPDX-License-Identifier: Apache-2.0
+
+/* v8 ignore start -- transitional action facade until implementations leave src/nemoclaw.ts. */
+
+import type { SandboxConnectOptions } from "./nemoclaw-runtime-bridge";
+import { getNemoClawRuntimeBridge } from "./nemoclaw-runtime-bridge";
+
+export async function connectSandbox(
+  sandboxName: string,
+  options?: SandboxConnectOptions,
+): Promise<void> {
+  await getNemoClawRuntimeBridge().sandboxConnect(sandboxName, options);
+}
+
+export async function showSandboxStatus(sandboxName: string): Promise<void> {
+  await getNemoClawRuntimeBridge().sandboxStatus(sandboxName);
+}
+
+export function showSandboxLogs(sandboxName: string, follow: boolean): void {
+  getNemoClawRuntimeBridge().sandboxLogs(sandboxName, follow);
+}
+
+export async function destroySandbox(sandboxName: string, args: string[] = []): Promise<void> {
+  await getNemoClawRuntimeBridge().sandboxDestroy(sandboxName, args);
+}
+
+export async function rebuildSandbox(sandboxName: string, args: string[] = []): Promise<void> {
+  await getNemoClawRuntimeBridge().sandboxRebuild(sandboxName, args);
+}
+
+export async function installSandboxSkill(
+  sandboxName: string,
+  args: string[] = [],
+): Promise<void> {
+  await getNemoClawRuntimeBridge().sandboxSkillInstall(sandboxName, args);
+}
+
+export async function runSandboxSnapshot(sandboxName: string, args: string[]): Promise<void> {
+  await getNemoClawRuntimeBridge().sandboxSnapshot(sandboxName, args);
+}

src/lib/skill-install-cli-command.ts

@@ -5,13 +5,12 @@
 
 import { Args, Command, Flags } from "@oclif/core";
 
-import type { NemoClawRuntimeBridge } from "./nemoclaw-runtime-bridge";
-import { getNemoClawRuntimeBridge } from "./nemoclaw-runtime-bridge";
+import { installSandboxSkill } from "./sandbox-runtime-actions";
 
-let runtimeBridgeFactory = (): Pick<NemoClawRuntimeBridge, "sandboxSkillInstall"> => getNemoClawRuntimeBridge();
+let runtimeBridgeFactory = () => ({ sandboxSkillInstall: installSandboxSkill });
 
 export function setSkillInstallRuntimeBridgeFactoryForTest(
-  factory: () => Pick<NemoClawRuntimeBridge, "sandboxSkillInstall">,
+  factory: () => { sandboxSkillInstall: (sandboxName: string, args?: string[]) => Promise<void> },
 ): void {
   runtimeBridgeFactory = factory;
 }

src/lib/snapshot-cli-commands.ts

@@ -5,12 +5,13 @@
 
 import { Args, Command, Flags } from "@oclif/core";
 
-import type { NemoClawRuntimeBridge } from "./nemoclaw-runtime-bridge";
-import { getNemoClawRuntimeBridge } from "./nemoclaw-runtime-bridge";
+import { runSandboxSnapshot } from "./sandbox-runtime-actions";
 
-let runtimeBridgeFactory = (): Pick<NemoClawRuntimeBridge, "sandboxSnapshot"> => getNemoClawRuntimeBridge();
+let runtimeBridgeFactory = () => ({ sandboxSnapshot: runSandboxSnapshot });
 
-export function setSnapshotRuntimeBridgeFactoryForTest(factory: () => Pick<NemoClawRuntimeBridge, "sandboxSnapshot">): void {
+export function setSnapshotRuntimeBridgeFactoryForTest(
+  factory: () => { sandboxSnapshot: (sandboxName: string, args: string[]) => Promise<void> },
+): void {
   runtimeBridgeFactory = factory;
 }