@h-rig/cli 0.0.6-alpha.9 → 0.0.6-alpha.90

package/dist/src/commands/browser.js

@@ -5,17 +5,299 @@ import { resolve } from "path";
 import { spawn } from "child_process";
 import { emitKeypressEvents } from "readline";
 import { pathToFileURL } from "url";
-import * as clack2 from "@clack/prompts";
+
+// packages/cli/src/app/drone-ui.ts
+import { ProcessTerminal, TUI, Text, Input, SelectList, matchesKey } from "@earendil-works/pi-tui";
+
+// packages/cli/src/app/theme.ts
+var RIG_PALETTE = {
+  ink: "#f2f3f6",
+  ink2: "#aeb0ba",
+  ink3: "#6c6e79",
+  ink4: "#44464f",
+  accent: "#ccff4d",
+  accentDim: "#a9d63f",
+  cyan: "#56d8ff",
+  red: "#ff5d5d",
+  yellow: "#ffd24d"
+};
+function hexToRgb(hex) {
+  const value = hex.replace("#", "");
+  return [
+    Number.parseInt(value.slice(0, 2), 16),
+    Number.parseInt(value.slice(2, 4), 16),
+    Number.parseInt(value.slice(4, 6), 16)
+  ];
+}
+function fg(hex) {
+  const [r, g, b] = hexToRgb(hex);
+  return (text) => `\x1B[38;2;${r};${g};${b}m${text}\x1B[39m`;
+}
+var ink = fg(RIG_PALETTE.ink);
+var ink2 = fg(RIG_PALETTE.ink2);
+var ink3 = fg(RIG_PALETTE.ink3);
+var ink4 = fg(RIG_PALETTE.ink4);
+var accent = fg(RIG_PALETTE.accent);
+var accentDim = fg(RIG_PALETTE.accentDim);
+var cyan = fg(RIG_PALETTE.cyan);
+var red = fg(RIG_PALETTE.red);
+var yellow = fg(RIG_PALETTE.yellow);
+function bold(text) {
+  return `\x1B[1m${text}\x1B[22m`;
+}
+var DRONE_ART = [
+  "  .-=-.                   .-=-.   ",
+  " ( !!! )                 ( !!! )  ",
+  "  '-=-'._               _.'-=-'   ",
+  "        '._           _.'         ",
+  "           '=$$$$$$$=.'           ",
+  "          =$$$$$$$$$$$=           ",
+  "         $$$@@@@@@@@@@$$$         ",
+  "        $$$@@        @@$$$        ",
+  "        $$@    ?     @$$$         ",
+  "        $$$@   '-'   @$$$         ",
+  "        $$$@@        @@$$$        ",
+  "         $$$@@@@@@@@@@$$$         ",
+  "          =$$$$$$$$$$$=           ",
+  "           '=$$$$$$$=.'           ",
+  "        _.'           '._         ",
+  "  .-=-.'                 '.-=-.   ",
+  " ( !!! )                 ( !!! )  ",
+  "  '-=-'                   '-=-'   "
+];
+var EYE_FRAMES = ["@", "o", "."];
+var DRONE_WIDTH = DRONE_ART[0].length;
+var DRONE_HEIGHT = DRONE_ART.length;
+var MICRO_BLADES = ["---", "\\\\\\", "|||", "///"];
+function microDroneFrame(tick) {
+  const blade = MICRO_BLADES[tick % MICRO_BLADES.length];
+  const eye = EYE_FRAMES[Math.floor(tick / 2) % EYE_FRAMES.length];
+  return `(${blade})${eye}(${blade})`;
+}
+var MICRO_DRONE_FRAMES = Array.from({ length: 12 }, (_, index) => microDroneFrame(index));
+function renderMicroDroneFrame(tick) {
+  const blade = MICRO_BLADES[tick % MICRO_BLADES.length];
+  const eye = EYE_FRAMES[Math.floor(tick / 2) % EYE_FRAMES.length];
+  return `${ink4("(")}${cyan(blade)}${ink4(")")}${bold(accent(eye))}${ink4("(")}${cyan(blade)}${ink4(")")}`;
+}
+
+// packages/cli/src/commands/_spinner.ts
+var SPINNER_FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+function createTtySpinner(input) {
+  const output = input.output ?? process.stdout;
+  const isTty = output.isTTY === true;
+  const frames = input.frames && input.frames.length > 0 ? input.frames : SPINNER_FRAMES;
+  let label = input.label;
+  let frame = 0;
+  let paused = false;
+  let stopped = false;
+  let lastPrintedLabel = "";
+  const render = () => {
+    if (stopped || paused)
+      return;
+    if (!isTty) {
+      if (label !== lastPrintedLabel) {
+        output.write(`${label}
+`);
+        lastPrintedLabel = label;
+      }
+      return;
+    }
+    frame = (frame + 1) % frames.length;
+    const glyph = frames[frame] ?? frames[0] ?? "";
+    output.write(`\r\x1B[2K${input.styleFrame ? input.styleFrame(glyph) : glyph} ${label}`);
+  };
+  const clearLine = () => {
+    if (isTty)
+      output.write("\r\x1B[2K");
+  };
+  render();
+  const timer = isTty ? setInterval(render, input.intervalMs ?? 120) : null;
+  return {
+    setLabel(next) {
+      label = next;
+      render();
+    },
+    pause() {
+      paused = true;
+      clearLine();
+    },
+    resume() {
+      if (stopped)
+        return;
+      paused = false;
+      render();
+    },
+    stop(finalLine) {
+      if (stopped)
+        return;
+      stopped = true;
+      if (timer)
+        clearInterval(timer);
+      clearLine();
+      if (finalLine)
+        output.write(`${finalLine}
+`);
+    }
+  };
+}
+
+// packages/cli/src/app/drone-ui.ts
+var isTty = () => Boolean(process.stdout.isTTY);
+function hairline(width = Math.min(process.stdout.columns ?? 80, 100)) {
+  return ink4("\u2500".repeat(Math.max(10, width)));
+}
+function droneIntro(title, subtitle) {
+  console.log("");
+  console.log(` ${accent("\u258D")}${bold(ink(title))}${subtitle ? ink3(` \u2014 ${subtitle}`) : ""}`);
+  console.log(hairline());
+}
+function droneOutro(text) {
+  console.log(hairline());
+  console.log(` ${accent("\u25C6")} ${ink2(text)}`);
+  console.log("");
+}
+function droneNote(message, title) {
+  if (title)
+    console.log(` ${accentDim("\u25C7")} ${bold(ink2(title))}`);
+  for (const line of message.split(`
+`)) {
+    console.log(` ${ink4("\u2502")} ${line}`);
+  }
+}
+function droneInfo(text) {
+  console.log(` ${cyan("\xB7")} ${ink2(text)}`);
+}
+function droneWarn(text) {
+  console.log(` ${yellow("\u25B2")} ${ink2(text)}`);
+}
+function droneCancel(text) {
+  console.log(` ${red("\u2716")} ${ink3(text)}`);
+}
+function droneSpinner() {
+  let active = null;
+  return {
+    start(message) {
+      active = createTtySpinner({
+        label: message,
+        frames: MICRO_DRONE_FRAMES,
+        styleFrame: (frame) => renderMicroDroneFrame(Math.max(0, MICRO_DRONE_FRAMES.indexOf(frame)))
+      });
+    },
+    stop(message) {
+      active?.stop(message ? ` ${accent("\u25C6")} ${ink2(message)}` : undefined);
+      active = null;
+    },
+    error(message) {
+      active?.stop(message ? ` ${red("\u2716")} ${ink2(message)}` : undefined);
+      active = null;
+    }
+  };
+}
+var SELECT_THEME = {
+  selectedPrefix: (text) => accent(text),
+  selectedText: (text) => bold(ink(text)),
+  description: (text) => ink3(text),
+  scrollInfo: (text) => ink4(text),
+  noMatch: (text) => ink3(text)
+};
+async function runMiniTui(build) {
+  const terminal = new ProcessTerminal;
+  const tui = new TUI(terminal);
+  let settled = false;
+  return await new Promise((resolve) => {
+    const finish = (result) => {
+      if (settled)
+        return;
+      settled = true;
+      tui.stop();
+      resolve(result);
+    };
+    build(tui, finish);
+    tui.start();
+  });
+}
+async function droneSelect(input) {
+  if (!isTty() || input.options.length === 0) {
+    return input.initialValue ?? input.options[0]?.value ?? null;
+  }
+  return runMiniTui((tui, finish) => {
+    tui.addChild(new Text(` ${accent("\u258D")}${bold(ink(input.message))}`));
+    const items = input.options.map((option) => ({
+      value: option.value,
+      label: option.label,
+      ...option.hint ? { description: option.hint } : {}
+    }));
+    const list = new SelectList(items, Math.min(items.length, 12), SELECT_THEME);
+    const initialIndex = input.initialValue ? items.findIndex((item) => item.value === input.initialValue) : -1;
+    if (initialIndex > 0)
+      list.setSelectedIndex(initialIndex);
+    list.onSelect = (item) => finish(item.value);
+    list.onCancel = () => finish(null);
+    tui.addChild(list);
+    tui.addChild(new Text(ink4(" \u2191\u2193 navigate \xB7 enter select \xB7 esc cancel")));
+    tui.setFocus(list);
+    tui.addInputListener((data) => {
+      if (matchesKey(data, "ctrl+c") || matchesKey(data, "escape")) {
+        finish(null);
+        return { consume: true };
+      }
+      return;
+    });
+  });
+}
+async function droneText(input) {
+  if (!isTty())
+    return input.initialValue ?? null;
+  return runMiniTui((tui, finish) => {
+    tui.addChild(new Text(` ${accent("\u258D")}${bold(ink(input.message))}${input.placeholder ? ink4(`  (${input.placeholder})`) : ""}`));
+    const field = new Input;
+    if (input.initialValue)
+      field.setValue(input.initialValue);
+    field.onSubmit = (value) => finish(value);
+    field.onEscape = () => finish(null);
+    tui.addChild(field);
+    tui.addChild(new Text(ink4(" enter submit \xB7 esc cancel")));
+    tui.setFocus(field);
+    tui.addInputListener((data) => {
+      if (matchesKey(data, "ctrl+c")) {
+        finish(null);
+        return { consume: true };
+      }
+      return;
+    });
+  });
+}
+async function droneConfirm(input) {
+  const answer = await droneSelect({
+    message: input.message,
+    options: [
+      { value: "yes", label: "Yes" },
+      { value: "no", label: "No" }
+    ],
+    initialValue: input.initialValue === false ? "no" : "yes"
+  });
+  return answer === null ? null : answer === "yes";
+}
+
+// packages/cli/src/commands/browser.ts
 import pc2 from "picocolors";
 
 // packages/cli/src/runner.ts
 import { EventBus } from "@rig/runtime/control-plane/runtime/events";
-import { CliError } from "@rig/runtime/control-plane/errors";
+import { CliError as RuntimeCliError } from "@rig/runtime/control-plane/errors";
 import { evaluate, loadPolicy, resolveAction } from "@rig/runtime/control-plane/runtime/guard";
-import { PluginManager } from "@rig/runtime/control-plane/runtime/plugins";
-import { loadRuntimeContextFromEnv } from "@rig/runtime/control-plane/runtime/context";
 import { buildBinary } from "@rig/runtime/control-plane/runtime/isolation";
-import { CliError as CliError2 } from "@rig/runtime/control-plane/errors";
+
+class CliError extends RuntimeCliError {
+  hint;
+  constructor(message, exitCode = 1, options = {}) {
+    super(message, exitCode);
+    if (options.hint?.trim()) {
+      this.hint = options.hint.trim();
+    }
+  }
+}
 function takeFlag(args, flag) {
   const rest = [];
   let value = false;
@@ -36,7 +318,7 @@ function takeOption(args, option) {
     if (current === option) {
       const next = args[index + 1];
       if (!next || next.startsWith("-")) {
-        throw new CliError(`Missing value for ${option}`);
+        throw new CliError(`Missing value for ${option}`, 1, { hint: `Provide a value after ${option}, e.g. \`${option} <value>\`.` });
       }
       value = next;
       index += 1;
@@ -59,7 +341,6 @@ Usage: ${usage}`);
 import { runCapture as runCapture2 } from "@rig/runtime/control-plane/native/utils";
 
 // packages/cli/src/commands/task-report-bug.ts
-import * as clack from "@clack/prompts";
 import pc from "picocolors";
 import {
   appendJsonlRecord,
@@ -74,28 +355,30 @@ import { resolveMonorepoRoot } from "@rig/runtime/control-plane/native/utils";
 
 // packages/cli/src/commands/task-report-bug.ts
 async function promptBugText(message, defaultValue, options = {}) {
-  const result = await clack.text({
-    message,
-    defaultValue: defaultValue?.trim() ? defaultValue : undefined,
-    placeholder: options.placeholder,
-    validate: options.required ? (value) => validateRequiredBugPromptValue(value, message) : undefined
-  });
-  return unwrapClackPrompt(result).trim();
+  for (;; ) {
+    const result = await droneText({
+      message,
+      ...options.placeholder ? { placeholder: options.placeholder } : {},
+      ...defaultValue?.trim() ? { initialValue: defaultValue } : {}
+    });
+    if (result === null) {
+      droneCancel("Bug report cancelled.");
+      throw new CliError("Bug report cancelled by user.");
+    }
+    const invalid = options.required ? validateRequiredBugPromptValue(result, message) : undefined;
+    if (!invalid)
+      return result.trim();
+    droneInfo(invalid);
+  }
 }
 function validateRequiredBugPromptValue(value, label) {
   return value?.trim() ? undefined : `${label} is required.`;
 }
 async function promptBugConfirm(message, initialValue) {
-  const result = await clack.confirm({
-    message,
-    initialValue
-  });
-  return unwrapClackPrompt(result);
-}
-function unwrapClackPrompt(result) {
-  if (clack.isCancel(result)) {
-    clack.cancel("Bug report cancelled.");
-    throw new CliError2("Bug report cancelled by user.");
+  const result = await droneConfirm({ message, initialValue });
+  if (result === null) {
+    droneCancel("Bug report cancelled.");
+    throw new CliError("Bug report cancelled by user.");
   }
   return result;
 }
@@ -351,7 +634,7 @@ async function executeBrowser(context, args) {
     return { ok: true, group: "browser", command: "help" };
   }
   if (command === "explain") {
-    requireNoExtraArgs(rest, "bun run rig browser explain");
+    requireNoExtraArgs(rest, "rig browser explain");
     console.log(browserAgentUsageText());
     return { ok: true, group: "browser", command: "explain" };
   }
@@ -361,7 +644,7 @@ async function executeBrowser(context, args) {
   if (command === "app" || command === "hp-next") {
     const appSlug = command === "hp-next" ? "hp-next" : process.env.RIG_BROWSER_APP?.trim() || "";
     if (!appSlug) {
-      throw new CliError2(`rig browser app: set RIG_BROWSER_APP=<app-slug> to select which project app scripts to invoke.
+      throw new CliError(`rig browser app: set RIG_BROWSER_APP=<app-slug> to select which project app scripts to invoke.
 ` + `Scripts are invoked as 'bun run app:<mode>:browser:<app-slug>'.
 
 ${browserHelpText()}`);
@@ -373,11 +656,11 @@ ${browserHelpText()}`);
     }
     const modes = ["dev", "start", "check", "e2e", "reset"];
     if (!modes.includes(subcommand)) {
-      throw new CliError2(`Unknown browser ${command} command: ${subcommand}. Valid modes: ${modes.join(", ")}.
+      throw new CliError(`Unknown browser ${command} command: ${subcommand}. Valid modes: ${modes.join(", ")}.
 
 ${browserHelpText()}`);
     }
-    requireNoExtraArgs(appRest, `bun run rig browser ${command} ${subcommand}`);
+    requireNoExtraArgs(appRest, `rig browser ${command} ${subcommand}`);
     await context.runCommand(["bun", "run", `app:${subcommand}:browser:${appSlug}`]);
     return { ok: true, group: "browser", command: `${command}-${subcommand}` };
   }
@@ -389,13 +672,13 @@ ${browserHelpText()}`);
   };
   const packageScript = packageScripts[command];
   if (packageScript) {
-    requireNoExtraArgs(rest, `bun run rig browser ${command}`);
+    requireNoExtraArgs(rest, `rig browser ${command}`);
     await context.runCommand(["bun", "run", "--filter=@rig/browser", packageScript]);
     return { ok: true, group: "browser", command };
   }
-  throw new CliError2(`Unknown browser command: ${command}
+  throw new CliError(`Unknown browser command: ${command}
 
-${browserHelpText()}`);
+${browserHelpText()}`, 1, { hint: "Run `rig browser help` for the full browser command reference." });
 }
 async function executeBrowserDemo(context, args) {
   const [maybeHelp] = args;
@@ -416,13 +699,13 @@ async function executeBrowserDemo(context, args) {
   pending = keepOpenFlag.rest;
   const noBuildFlag = takeFlag(pending, "--no-build");
   pending = noBuildFlag.rest;
-  requireNoExtraArgs(pending, "bun run rig browser demo [--port <n>] [--profile <name>] [--state-dir <path>] [--target-url <url>] [--keep-open] [--no-build]");
+  requireNoExtraArgs(pending, "rig browser demo [--port <n>] [--profile <name>] [--state-dir <path>] [--target-url <url>] [--keep-open] [--no-build]");
   if (context.outputMode !== "text" || !process.stdin.isTTY || !process.stdout.isTTY) {
-    throw new CliError2("rig browser demo requires an interactive TTY in text mode.");
+    throw new CliError("rig browser demo requires an interactive TTY in text mode.", 1, { hint: "Run `rig browser demo` from an interactive terminal (no --json, no piped stdin)." });
   }
   const port = portResult.value ? Number.parseInt(portResult.value, 10) : undefined;
   if (port !== undefined && (!Number.isFinite(port) || port <= 0)) {
-    throw new CliError2(`Invalid --port value: ${portResult.value}`);
+    throw new CliError(`Invalid --port value: ${portResult.value}`, 1, { hint: "Pass a positive port number, e.g. `--port 9222`." });
   }
   const runtime = buildBrowserDemoRuntime(context.projectRoot, {
     ...port !== undefined ? { port } : {},
@@ -430,26 +713,26 @@ async function executeBrowserDemo(context, args) {
     ...stateDirResult.value ? { stateDir: stateDirResult.value } : {},
     ...targetUrlResult.value ? { targetUrl: targetUrlResult.value } : {}
   });
-  clack2.intro("rig browser demo");
-  clack2.note([
+  droneIntro("rig browser demo");
+  droneNote([
     "You are now acting as the agent inside a browser-required task run.",
     "Type each simple command when prompted. The CLI will run the real backing action",
     "and print the same kind of output an agent would inspect before the next step."
   ].join(`
 `), "Agent task-run walkthrough");
-  clack2.note(formatBrowserDemoRuntime(runtime), "Runtime contract the agent receives");
+  droneNote(formatBrowserDemoRuntime(runtime), "Runtime contract the agent receives");
   const agentCommands = buildBrowserDemoAgentCommands(runtime);
   await promptBrowserDemoAgentCommand("Agent command 1/4: print browser attach info", agentCommands.attachInfo);
   printBrowserDemoCommandOutput(agentCommands.attachInfo.primary, formatBrowserDemoAttachInfoOutput(runtime));
   await promptBrowserDemoAgentCommand("Agent command 2/4: launch Rig Browser", agentCommands.launch);
   if (!noBuildFlag.value) {
-    const spinner2 = clack2.spinner();
-    spinner2.start("Preparing browser bundle for the launch command");
+    const spinner = droneSpinner();
+    spinner.start("Preparing browser bundle for the launch command");
     try {
       runBrowserDemoBuild(context.projectRoot);
-      spinner2.stop("Browser bundle built");
+      spinner.stop("Browser bundle built");
     } catch (error) {
-      spinner2.error("Browser bundle build failed");
+      spinner.error("Browser bundle build failed");
       throw error;
     }
   }
@@ -458,20 +741,20 @@ async function executeBrowserDemo(context, args) {
   try {
     printBrowserDemoCommandOutput(agentCommands.launch.primary, formatBrowserDemoLaunchOutput(runtime, child.pid));
     await promptBrowserDemoAgentCommand("Agent command 3/4: check live browser endpoint", agentCommands.check);
-    const readySpinner = clack2.spinner();
+    const readySpinner = droneSpinner();
     readySpinner.start(`Waiting for live CDP endpoint at ${runtime.attachUrl}`);
     const { version, pageTarget, targets } = await waitForBrowserDemoReady(runtime, child);
     readySpinner.stop("Live CDP endpoint is ready");
     printBrowserDemoCommandOutput(agentCommands.check.primary, formatBrowserDemoCheckOutput(runtime, version, pageTarget, targets));
     await promptBugText("Look at the launched browser page, then type ready", undefined, { required: true, placeholder: "ready" });
     await promptBrowserDemoAgentCommand("Agent command 4/4: attach DevTools MCP", agentCommands.attach);
-    clack2.note([
+    droneNote([
       "The attach step evaluates JavaScript inside the live browser page.",
       "It records DOM state before the change, changes #status, #details, and the page background,",
       "then records DOM state and layout again so the transcript proves what changed."
     ].join(`
 `), "What mutationEvaluation means");
-    const cdpSpinner = clack2.spinner();
+    const cdpSpinner = droneSpinner();
     cdpSpinner.start("Agent attaching over WebSocket CDP");
     const cdpResult = await runBrowserDemoCdpAction(pageTarget.webSocketDebuggerUrl);
     cdpSpinner.stop("Agent CDP action completed");
@@ -480,7 +763,7 @@ async function executeBrowserDemo(context, args) {
     if (!keepOpen) {
       keepOpen = await promptBugConfirm("Keep the demo browser open after this command exits?", false);
     }
-    clack2.outro(keepOpen ? "Demo complete. Browser left open by request." : "Demo complete. Closing browser.");
+    droneOutro(keepOpen ? "Demo complete. Browser left open by request." : "Demo complete. Closing browser.");
     return {
       ok: true,
       group: "browser",
@@ -577,7 +860,7 @@ function runBrowserDemoBuild(projectRoot) {
   if (result.exitCode !== 0) {
     const details = [result.stdout.trim(), result.stderr.trim()].filter(Boolean).join(`
 `);
-    throw new CliError2(`Browser demo build failed.${details ? `
+    throw new CliError(`Browser demo build failed.${details ? `
 ${details}` : ""}`, result.exitCode);
   }
 }
@@ -587,7 +870,7 @@ async function promptBrowserDemoAgentCommand(message, command) {
     if (browserDemoCommandMatches(value, command)) {
       return normalizeBrowserDemoCommand(value);
     }
-    clack2.log.warn(`Expected one of:
+    droneWarn(`Expected one of:
 ${command.accepted.map((accepted) => `  ${accepted}`).join(`
 `)}`);
   }
@@ -632,7 +915,7 @@ function readBrowserDemoCommandLine(command) {
         cleanup();
         stdout.write(`
 `);
-        rejectInput(new CliError2("Browser demo cancelled."));
+        rejectInput(new CliError("Browser demo cancelled."));
         return;
       }
       if (key.name === "return" || key.name === "enter") {
@@ -698,7 +981,7 @@ async function waitForBrowserDemoReady(runtime, child) {
     return { targets: nextTargets, pageTarget: nextPageTarget };
   }, child, "CDP demo page target");
   if (!version.Browser) {
-    throw new CliError2("Browser demo reached CDP but /json/version did not include Browser metadata.");
+    throw new CliError("Browser demo reached CDP but /json/version did not include Browser metadata.");
   }
   return { version, targets, pageTarget };
 }
@@ -711,14 +994,14 @@ async function waitForBrowserDemo(check, child, label, timeoutMs = 18000) {
   let lastError = null;
   for (;; ) {
     if (child.exitCode !== null || child.signalCode !== null) {
-      throw new CliError2(`Rig Browser exited before ${label} became ready.`);
+      throw new CliError(`Rig Browser exited before ${label} became ready.`);
     }
     try {
       return await check();
     } catch (error) {
       lastError = error;
       if (Date.now() - startedAt > timeoutMs) {
-        throw new CliError2(`${label} did not become ready within ${timeoutMs}ms: ${String(lastError)}`);
+        throw new CliError(`${label} did not become ready within ${timeoutMs}ms: ${String(lastError)}`);
       }
       await new Promise((resolveDelay) => setTimeout(resolveDelay, 150));
     }

package/dist/src/commands/connect.d.ts

@@ -0,0 +1,7 @@
+import { type RunnerContext } from "../runner";
+import type { CommandOutcome } from "@rig/runtime/control-plane/runtime/types";
+export type ConnectionCommandOptions = {
+    group: "server";
+    interactiveUse?: boolean;
+};
+export declare function executeConnectionCommand(context: RunnerContext, args: string[], options: ConnectionCommandOptions): Promise<CommandOutcome>;