dev3000 0.0.173 → 0.0.175

package/dist/cli.js

@@ -63,108 +63,59 @@ function findAgentBrowser() {
     }
     return "agent-browser";
 }
-function findNextBrowserCli() {
-    if (process.env.NEXT_BROWSER_PATH) {
-        const runnablePath = getRunnablePath(process.env.NEXT_BROWSER_PATH);
-        if (runnablePath) {
-            return runnablePath;
-        }
-    }
-    const cwd = process.cwd();
-    const home = homedir();
-    const searchPaths = [
-        join(home, ".bun", "install", "global", "node_modules", "dev3000", "node_modules", "@vercel", "next-browser", "dist", "cli.js"),
-        join(home, ".bun", "install", "global", "node_modules", "@vercel", "next-browser", "dist", "cli.js"),
-        join(cwd, "node_modules", "@vercel", "next-browser", "dist", "cli.js"),
-        join(cwd, "..", "node_modules", "@vercel", "next-browser", "dist", "cli.js")
-    ];
-    const globalNodeModules = [
-        join("/usr", "local", "lib", "node_modules"),
-        join("/opt", "homebrew", "lib", "node_modules")
-    ];
-    for (const root of globalNodeModules) {
-        searchPaths.push(join(root, "dev3000", "node_modules", "@vercel", "next-browser", "dist", "cli.js"));
-        searchPaths.push(join(root, "@vercel", "next-browser", "dist", "cli.js"));
-    }
-    for (const searchPath of searchPaths) {
-        if (existsSync(searchPath)) {
-            return searchPath;
-        }
+function getSessionCdpPort() {
+    const session = findCurrentSession();
+    const cdpUrl = session?.cdpUrl;
+    if (!cdpUrl) {
+        return null;
     }
-    return null;
-}
-function getProjectBrowserToolPreference() {
     try {
-        const sessionFile = join(getProjectDir(), "session.json");
-        if (!existsSync(sessionFile)) {
-            return "agent-browser";
+        const parsed = new URL(cdpUrl);
+        if (/^\d+$/.test(parsed.port)) {
+            return parsed.port;
         }
-        const sessionInfo = JSON.parse(readFileSync(sessionFile, "utf8"));
-        return sessionInfo.preferredBrowserTool === "next-browser" ? "next-browser" : "agent-browser";
     }
     catch {
-        return "agent-browser";
+        const match = cdpUrl.match(/:(\d+)/);
+        if (match) {
+            return match[1];
+        }
     }
+    return null;
 }
-function runLocalBrowserTool(browserTool, args) {
+function runLocalBrowserTool(args) {
     const env = { ...process.env };
     ensureCommandPath(env);
-    if (browserTool === "agent-browser") {
-        const subcommandIndex = args.findIndex((arg) => !arg.startsWith("-") && !arg.startsWith("@") && arg !== "9222");
-        const subcommand = subcommandIndex >= 0 ? args[subcommandIndex] : null;
-        if (subcommand === "errors") {
-            console.log("\x1b[33m💡 Tip: Using `d3k errors` instead (shows browser + server errors)\x1b[0m\n");
-            const d3kBin = process.argv[1];
-            const result = spawnSync(d3kBin, ["errors"], { stdio: "inherit", shell: false });
-            process.exit(result.status ?? 0);
-        }
-        if (subcommand === "console") {
-            console.log("\x1b[33m💡 Tip: Using `d3k logs` instead (shows browser + server logs)\x1b[0m\n");
-            const d3kBin = process.argv[1];
-            const result = spawnSync(d3kBin, ["logs", "--type", "browser"], { stdio: "inherit", shell: false });
-            process.exit(result.status ?? 0);
+    const subcommandIndex = args.findIndex((arg) => !arg.startsWith("-") && !arg.startsWith("@") && arg !== "9222");
+    const subcommand = subcommandIndex >= 0 ? args[subcommandIndex] : null;
+    if (subcommand === "errors") {
+        console.log("\x1b[33m💡 Tip: Using `d3k errors` instead (shows browser + server errors)\x1b[0m\n");
+        const d3kBin = process.argv[1];
+        const result = spawnSync(d3kBin, ["errors"], { stdio: "inherit", shell: false });
+        process.exit(result.status ?? 0);
+    }
+    if (subcommand === "console") {
+        console.log("\x1b[33m💡 Tip: Using `d3k logs` instead (shows browser + server logs)\x1b[0m\n");
+        const d3kBin = process.argv[1];
+        const result = spawnSync(d3kBin, ["logs", "--type", "browser"], { stdio: "inherit", shell: false });
+        process.exit(result.status ?? 0);
+    }
+    const binaryPath = findAgentBrowser();
+    if (subcommand !== "connect" &&
+        subcommand !== "close" &&
+        !args.includes("--cdp") &&
+        !args.includes("--profile") &&
+        !args.includes("--profile-dir")) {
+        const cdpPort = getSessionCdpPort();
+        if (cdpPort) {
+            spawnSync(binaryPath, ["connect", cdpPort], { stdio: "pipe", env, shell: false });
         }
-        const binaryPath = findAgentBrowser();
-        const result = spawnSync(binaryPath, args, {
-            stdio: "pipe",
-            shell: false,
-            env
-        });
-        if (result.stdout?.length > 0) {
-            process.stdout.write(result.stdout);
-        }
-        if (result.stderr?.length > 0) {
-            process.stderr.write(result.stderr);
-        }
-        if (result.error) {
-            console.error(`\nError spawning agent-browser: ${result.error.message}`);
-            console.error(`Binary path: ${binaryPath}`);
-            process.exit(1);
-        }
-        process.exit(result.status ?? 1);
     }
-    const nodeVersionCheck = spawnSync("node", ["-e", "process.stdout.write(process.versions.node)"], {
-        encoding: "utf-8",
+    const result = spawnSync(binaryPath, args, {
+        stdio: "pipe",
         env,
         shell: false
     });
-    const nodeVersion = nodeVersionCheck.stdout?.trim();
-    const nodeMajor = nodeVersion ? Number.parseInt(nodeVersion.split(".")[0] || "0", 10) : 0;
-    if (nodeVersionCheck.status !== 0 || Number.isNaN(nodeMajor) || nodeMajor < 20) {
-        console.error("\nnext-browser requires a system Node.js runtime >= 20.");
-        console.error("Install Node 20+ or keep using agent-browser for local d3k sessions.");
-        process.exit(1);
-    }
-    const cliPath = findNextBrowserCli();
-    const nextBrowserHome = join(getProjectDir(), "next-browser-home");
-    mkdirSync(nextBrowserHome, { recursive: true });
-    env.HOME = nextBrowserHome;
-    env.USERPROFILE = nextBrowserHome;
-    const result = spawnSync(cliPath ? "node" : "next-browser", cliPath ? [cliPath, ...args] : args, {
-        stdio: "pipe",
-        shell: false,
-        env
-    });
     if (result.stdout?.length > 0) {
         process.stdout.write(result.stdout);
     }
@@ -172,10 +123,8 @@ function runLocalBrowserTool(browserTool, args) {
         process.stderr.write(result.stderr);
     }
     if (result.error) {
-        console.error(`\nError spawning next-browser: ${result.error.message}`);
-        if (cliPath) {
-            console.error(`CLI path: ${cliPath}`);
-        }
+        console.error(`\nError spawning agent-browser: ${result.error.message}`);
+        console.error(`Binary path: ${binaryPath}`);
         process.exit(1);
     }
     process.exit(result.status ?? 1);
@@ -183,13 +132,7 @@ function runLocalBrowserTool(browserTool, args) {
 import { getBrowserCommandInvocation } from "./utils/browser-command-argv.js";
 const browserCommandInvocation = getBrowserCommandInvocation(process.argv.slice(2));
 if (browserCommandInvocation && (process.argv[1]?.includes("d3k") || process.argv[1]?.includes("dev3000"))) {
-    const { browserCommand, args } = browserCommandInvocation;
-    const browserTool = browserCommand === "browser"
-        ? getProjectBrowserToolPreference()
-        : browserCommand === "next-browser"
-            ? "next-browser"
-            : "agent-browser";
-    runLocalBrowserTool(browserTool, args);
+    runLocalBrowserTool(browserCommandInvocation.args);
 }
 import chalk from "chalk";
 import { execSync, spawnSync } from "child_process";
@@ -197,16 +140,17 @@ import { Command } from "commander";
 import { accessSync, appendFileSync, chmodSync, constants, copyFileSync, existsSync, mkdirSync, readFileSync } from "fs";
 import { homedir } from "os";
 import { detect } from "package-manager-detector";
-import { dirname, join } from "path";
+import { dirname, join, resolve } from "path";
 import { fileURLToPath } from "url";
-import { cloudCheckPR } from "./commands/cloud-check-pr.js";
-import { cloudFix } from "./commands/cloud-fix.js";
+import { runRemoteSkillCommand, shouldUseRemoteSkillRunner } from "./commands/skill-runner.js";
 import { createPersistentLogFile, findAvailablePort, startDevEnvironment } from "./dev-environment.js";
-import { getBundledSkillsPath, getSkill, getSkillsInfo, listAvailableSkills } from "./skills/index.js";
+import { getBundledD3kSkillPath, getSkill, getSkillsInfo, listAvailableSkills } from "./skills/index.js";
 import { detectAIAgent } from "./utils/agent-detection.js";
 import { getAvailableAgents, getSkillsAgentId } from "./utils/agent-selection.js";
 import { ensureD3kHomeDir } from "./utils/d3k-dir.js";
+import { readProjectAgentName } from "./utils/project-metadata.js";
 import { getProjectDir, getProjectDisplayName } from "./utils/project-name.js";
+import { findCurrentSession } from "./utils/session.js";
 import { checkForSkillUpdates, getApplicablePackages, getSkillsPathForLocation, installSkillPackage, isPackageInstalled, updateSkills } from "./utils/skill-installer.js";
 import { DEFAULT_TMUX_CONFIG, generateSessionName, generateTmuxCommands, getTmuxInstallInstructions, isTmuxInstalled } from "./utils/tmux-helpers.js";
 import { loadUserConfig, saveUserConfig } from "./utils/user-config.js";
@@ -268,46 +212,81 @@ process.on("unhandledRejection", (reason) => {
         process.exit(1);
     }
 });
+function shellQuote(value) {
+    return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+function validatePortOption(port) {
+    if (!/^\d+$/.test(port)) {
+        throw new Error("--port must be a numeric port number.");
+    }
+    const parsed = Number.parseInt(port, 10);
+    if (!Number.isInteger(parsed) || parsed < 1 || parsed > 65535) {
+        throw new Error("--port must be between 1 and 65535.");
+    }
+    return String(parsed);
+}
+function validatePositiveIntegerOption(name, value) {
+    if (!/^\d+$/.test(value)) {
+        throw new Error(`${name} must be a positive integer.`);
+    }
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isInteger(parsed) || parsed <= 0) {
+        throw new Error(`${name} must be a positive integer.`);
+    }
+    return String(parsed);
+}
+function validateScriptOption(script) {
+    if (!/^[A-Za-z0-9._:/-]+$/.test(script)) {
+        throw new Error("--script may only contain letters, numbers, dots, slashes, colons, underscores, and hyphens.");
+    }
+    return script;
+}
+function validateDateTimeOption(value) {
+    if (value !== "local" && value !== "utc") {
+        throw new Error("--date-time must be either 'local' or 'utc'.");
+    }
+    return value;
+}
 /**
  * Build the d3k command string with forwarded options.
  */
 function buildD3kCommandWithOptions(options) {
     const d3kBase = process.argv[1].endsWith("d3k") ? "d3k" : "dev3000";
-    const args = [d3kBase];
+    const args = [shellQuote(d3kBase)];
     // Forward options that were explicitly set
     if (options.port)
-        args.push(`--port ${options.port}`);
+        args.push("--port", shellQuote(options.port));
     if (options.script)
-        args.push(`--script ${options.script}`);
+        args.push("--script", shellQuote(options.script));
     if (options.command)
-        args.push(`--command "${options.command.replace(/"/g, '\\"')}"`);
+        args.push("--command", shellQuote(options.command));
     if (options.startupTimeout)
-        args.push(`--startup-timeout ${options.startupTimeout}`);
+        args.push("--startup-timeout", shellQuote(options.startupTimeout));
+    if (options.browserNavigationTimeout) {
+        args.push("--browser-navigation-timeout", shellQuote(options.browserNavigationTimeout));
+    }
     if (options.profileDir)
-        args.push(`--profile-dir "${options.profileDir}"`);
+        args.push("--profile-dir", shellQuote(options.profileDir));
     if (options.browserTool)
-        args.push(`--browser-tool ${options.browserTool}`);
+        args.push("--browser-tool", shellQuote(options.browserTool));
     if (options.browser)
-        args.push(`--browser "${options.browser}"`);
+        args.push("--browser", shellQuote(options.browser));
     if (options.serversOnly)
         args.push("--servers-only");
     if (options.headless)
         args.push("--headless");
     if (options.dateTime)
-        args.push(`--date-time ${options.dateTime}`);
+        args.push("--date-time", shellQuote(options.dateTime));
     if (options.pluginReactScan)
         args.push("--plugin-react-scan");
     if (options.agentName)
-        args.push(`--agent-name ${options.agentName}`);
+        args.push("--agent-name", shellQuote(options.agentName));
     return args.join(" ");
 }
 function ensureClaudeD3kSkill() {
     try {
-        const bundledSkillsDir = getBundledSkillsPath();
-        if (!bundledSkillsDir)
-            return;
-        const bundledSkillPath = join(bundledSkillsDir, "d3k", "SKILL.md");
-        if (!existsSync(bundledSkillPath))
+        const bundledSkillPath = getBundledD3kSkillPath();
+        if (!bundledSkillPath)
             return;
         const skillsRoot = join(process.cwd(), ".claude", "skills");
         const skillDir = join(skillsRoot, "d3k");
@@ -772,8 +751,12 @@ program
     .option("-s, --script <script>", "Script to run (e.g. dev, main.py) - auto-detected by project type")
     .option("-c, --command <command>", "Custom command to run (overrides auto-detection and --script)")
     .option("--startup-timeout <seconds>", "Seconds to wait for your app server to become reachable", "30")
+    .option("--browser-navigation-timeout <seconds>", "Seconds to wait for browser-initiated page navigation commands", "60")
     .option("--profile-dir <dir>", "Chrome profile directory")
-    .option("--browser-tool <tool>", "Preferred local browser CLI: 'agent-browser' (default) or 'next-browser'", "agent-browser")
+    .option("--data-dir <dir>", "Override the per-project data directory (default: ~/.d3k/<project>/). Holds session.json, logs, screenshots, and the Chrome profile.")
+    .option("--log-file <path>", "Override the consolidated log file path (default: <data-dir>/logs/<timestamp>.log)")
+    .option("--screenshots-dir <dir>", "Override the screenshots directory (default: <data-dir>/screenshots)")
+    .option("--browser-tool <tool>", "Preferred local browser CLI: 'agent-browser'", "agent-browser")
     .option("--browser <path>", "Full path to browser executable (e.g. for Arc: '/Applications/Arc.app/Contents/MacOS/Arc')")
     .option("--servers-only", "Run servers only, skip browser launch")
     .option("--debug", "Enable debug logging to console (automatically disables TUI)")
@@ -789,10 +772,34 @@ program
     .option("--agent-name <name>", "Selected agent name (internal)")
     .option("--no-agent", "Skip agent selection prompt and run d3k standalone")
     .action(async (options) => {
+    if (options.dataDir) {
+        process.env.D3K_DATA_DIR = resolve(options.dataDir);
+    }
     const projectName = getProjectDisplayName();
     setTerminalTitle(projectName);
+    try {
+        if (options.port) {
+            options.port = validatePortOption(options.port);
+        }
+        if (options.script) {
+            options.script = validateScriptOption(options.script);
+        }
+        options.startupTimeout = validatePositiveIntegerOption("--startup-timeout", options.startupTimeout);
+        options.browserNavigationTimeout = validatePositiveIntegerOption("--browser-navigation-timeout", options.browserNavigationTimeout);
+        if (options.browserTool && options.browserTool !== "agent-browser") {
+            throw new Error("--browser-tool must be 'agent-browser'.");
+        }
+        options.browserTool = "agent-browser";
+        options.dateTime = validateDateTimeOption(options.dateTime || "local");
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(chalk.red(`\n❌ ${message}\n`));
+        process.exit(1);
+    }
     // Load user config early so it can be used for --with-agent and agent selection flows
     const userConfig = loadUserConfig();
+    const agentDetection = detectAIAgent();
     // Apply browser default from user config if not explicitly provided via CLI
     const browserOption = options.browser || userConfig.browser;
     // Handle --with-agent by spawning tmux with split panes
@@ -802,6 +809,7 @@ program
             script: options.script,
             command: options.command,
             startupTimeout: options.startupTimeout,
+            browserNavigationTimeout: options.browserNavigationTimeout,
             profileDir: options.profileDir,
             browserTool: options.browserTool,
             browser: browserOption,
@@ -818,7 +826,23 @@ program
     const insideTmux = !!process.env.TMUX;
     let selectedAgent = null;
     let didPromptAgentSelection = false;
-    let skillsAgentId = options.agentName ? getSkillsAgentId(options.agentName) : null;
+    let skillsAgentId = options.agentName
+        ? getSkillsAgentId(options.agentName)
+        : agentDetection.agentId || null;
+    if (agentDetection.isAgent) {
+        if (options.tui !== false) {
+            if (options.debug) {
+                console.log(`[DEBUG] AI agent detected: ${agentDetection.agentName} (${agentDetection.reason}), auto-disabling TUI`);
+            }
+            options.tui = false;
+        }
+        if (agentDetection.agentId && options.skills !== false && !options.autoSkills) {
+            if (options.debug) {
+                console.log(`[DEBUG] AI agent detected: ${agentDetection.agentName} (${agentDetection.reason}), auto-enabling project skill installs`);
+            }
+            options.autoSkills = true;
+        }
+    }
     if (process.stdin.isTTY && options.agent !== false && options.tui !== false && !options.debug && !insideTmux) {
         // Clear the terminal so d3k UI starts at the top of the screen
         process.stdout.write("\x1B[2J\x1B[0f");
@@ -831,7 +855,8 @@ program
         }
         else {
             // Always show prompt, pre-selecting the last-used option
-            selectedAgent = await promptAgentSelection(userConfig.defaultAgent?.name);
+            const preferredAgentName = readProjectAgentName() || userConfig.defaultAgent?.name;
+            selectedAgent = await promptAgentSelection(preferredAgentName);
             didPromptAgentSelection = true;
             if (selectedAgent) {
                 if (selectedAgent.name === "debug") {
@@ -961,19 +986,21 @@ program
                 script: options.script,
                 command: options.command,
                 startupTimeout: options.startupTimeout,
+                browserNavigationTimeout: options.browserNavigationTimeout,
                 profileDir: options.profileDir,
                 browserTool: options.browserTool,
                 browser: browserOption,
                 serversOnly: options.serversOnly,
                 headless: options.headless,
                 dateTime: options.dateTime,
-                pluginReactScan: options.pluginReactScan
+                pluginReactScan: options.pluginReactScan,
+                agentName: selectedAgent.name
             });
             return;
         }
     }
     if (options.autoSkills && options.skills !== false && !skillsAgentId) {
-        skillsAgentId = "codex";
+        skillsAgentId = agentDetection.agentId || "codex";
     }
     // Detect project type and configuration
     const projectConfig = await detectProjectType(options.debug);
@@ -991,25 +1018,21 @@ program
         console.error(chalk.yellow(`    d3k --command "node server.js" -p 3000\n`));
         process.exit(1);
     }
-    // Detect if running under an AI agent and auto-disable TUI
-    const agentDetection = detectAIAgent();
-    if (agentDetection.isAgent && options.tui !== false) {
-        if (options.debug) {
-            console.log(`[DEBUG] AI agent detected: ${agentDetection.agentName} (${agentDetection.reason}), auto-disabling TUI`);
-        }
-        // Override TUI setting to false when agent is detected
-        options.tui = false;
-    }
     // Use defaults from project detection if not explicitly provided
     const port = options.port || projectConfig.defaultPort;
     const script = options.script || projectConfig.defaultScript;
     const userSetPort = options.port !== undefined;
     const startupTimeoutSeconds = Number.parseInt(options.startupTimeout, 10);
-    const browserTool = options.browserTool === "next-browser" ? "next-browser" : "agent-browser";
+    const browserNavigationTimeoutSeconds = Number.parseInt(options.browserNavigationTimeout, 10);
+    const browserTool = "agent-browser";
     if (Number.isNaN(startupTimeoutSeconds) || startupTimeoutSeconds <= 0) {
         console.error(chalk.red("\n❌ --startup-timeout must be a positive integer (seconds).\n"));
         process.exit(1);
     }
+    if (Number.isNaN(browserNavigationTimeoutSeconds) || browserNavigationTimeoutSeconds <= 0) {
+        console.error(chalk.red("\n❌ --browser-navigation-timeout must be a positive integer (seconds).\n"));
+        process.exit(1);
+    }
     // Generate server command based on custom command or project type
     let serverCommand;
     if (options.command) {
@@ -1081,7 +1104,7 @@ program
     const commandName = executablePath.endsWith("/d3k") || executablePath.includes("/d3k") ? "d3k" : "dev3000";
     try {
         // Create persistent log file
-        const logFile = createPersistentLogFile();
+        const logFile = createPersistentLogFile(options.logFile);
         // Use a per-project Chrome profile by default so concurrent d3k sessions
         // don't fight over the same browser state. Honor explicit overrides.
         const profileDir = options.profileDir || join(getProjectDir(), "chrome-profile");
@@ -1104,14 +1127,17 @@ program
             serversOnly: options.serversOnly,
             commandName,
             startupTimeoutSeconds,
+            browserNavigationTimeoutSeconds,
             tail: options.tail,
             tui: options.tui && !options.debug, // TUI is default unless --no-tui or --debug is specified
             portless: options.portless === true,
             dateTimeFormat: options.dateTime || "local",
             pluginReactScan: options.pluginReactScan || false,
+            agentName: options.agentName || undefined,
             skillsAgentId: skillsAgentId || undefined,
             autoSkills: options.skills !== false ? options.autoSkills || false : false,
-            installSkills: options.skills !== false
+            installSkills: options.skills !== false,
+            screenshotsDir: options.screenshotsDir
         });
     }
     catch (error) {
@@ -1119,41 +1145,6 @@ program
         process.exit(1);
     }
 });
-// Cloud commands
-const cloud = program.command("cloud").description("Cloud-based tools using Vercel Sandbox");
-// Cloud fix command
-cloud
-    .command("fix")
-    .description("Start a cloud fix workflow for the current project")
-    .option("--repo <url>", "Repository URL (e.g. https://github.com/user/repo)")
-    .option("--branch <name>", "Git branch to test")
-    .option("--project-dir <dir>", "Project directory within repo (e.g. 'www')")
-    .option("--debug", "Enable debug logging")
-    .action(async (options) => {
-    try {
-        await cloudFix(options);
-    }
-    catch (error) {
-        console.error(chalk.red("❌ Cloud fix failed:"), error);
-        process.exit(1);
-    }
-});
-// Cloud check-pr command
-cloud
-    .command("check-pr [pr-number]")
-    .description("Verify a PR's changes work as expected using Vercel preview deployment")
-    .option("--repo <url>", "Repository URL (optional, auto-detected from git)")
-    .option("--url <preview-url>", "Preview deployment URL (optional, auto-detected from Vercel)")
-    .option("--debug", "Enable debug logging")
-    .action(async (prNumber, options) => {
-    try {
-        await cloudCheckPR({ ...options, prNumber });
-    }
-    catch (error) {
-        console.error(chalk.red("❌ Cloud check-pr failed:"), error);
-        process.exit(1);
-    }
-});
 // Upgrade command
 program
     .command("upgrade")
@@ -1199,21 +1190,37 @@ program
     .command("agent-browser [args...]")
     .description("Run the bundled agent-browser CLI (e.g., d3k agent-browser screenshot /tmp/foo.png)")
     .allowUnknownOption(true);
-program
-    .command("next-browser [args...]")
-    .description("Run the bundled next-browser CLI (e.g., d3k next-browser open http://localhost:3000)")
-    .allowUnknownOption(true);
-program
-    .command("browser [args...]")
-    .description("Run the preferred local browser CLI for this session")
-    .allowUnknownOption(true);
 // Skill command - get skill content for use in prompts/workflows
 program
     .command("skill [name]")
     .description("Get skill content or list available skills")
     .option("-l, --list", "List all available skills")
     .option("-v, --verbose", "Show detailed skill information")
-    .action((name, options) => {
+    .option("--team <team>", "Override the inferred Vercel team slug or ID for a hosted skill run")
+    .option("--project <project>", "Override the inferred Vercel project name or ID for a hosted skill run")
+    .option("--branch <branch>", "Git branch or ref to scan")
+    .option("--project-dir <dir>", "Project root directory inside the repository")
+    .option("--base-url <url>", "dev3000 base URL")
+    .option("--wait", "Wait for the run to finish")
+    .option("--json", "Print machine-readable JSON")
+    .option("--no-install", "Do not install or repair the team skill runner project before starting")
+    .action(async (name, options) => {
+    if (shouldUseRemoteSkillRunner(name, options)) {
+        try {
+            await runRemoteSkillCommand(name, options);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (options.json) {
+                console.log(JSON.stringify({ success: false, error: message }, null, 2));
+            }
+            else {
+                console.error(chalk.red(`Error: ${message}`));
+            }
+            process.exit(1);
+        }
+        return;
+    }
     // List skills if --list flag or no name provided
     if (options.list || !name) {
         if (options.verbose) {
@@ -1306,49 +1313,19 @@ program
     const { crawlApp } = await import("./commands/crawl.js");
     await crawlApp(options);
 });
-// Find-component command - map DOM to React source
 program
-    .command("find-component <selector>")
-    .description("Find React component source for a DOM selector")
-    .action(async (selector) => {
-    const { findComponent } = await import("./commands/find-component.js");
-    await findComponent(selector);
+    .command("resume")
+    .description("Resume the last supported AI agent session for this project")
+    .action(async () => {
+    const { resumeLastAgent } = await import("./commands/resume.js");
+    await resumeLastAgent();
 });
 // CDP port command - get the CDP port from the session file
 program
     .command("cdp-port")
     .description("Output the CDP port for the current d3k session (for use in scripts)")
-    .action(async () => {
-    const sessionDir = join(homedir(), ".d3k");
-    const projectDir = getProjectDir();
-    const projectName = projectDir.split("/").pop() || "unknown";
-    // Try to find session.json in ~/.d3k/{project-name}/
-    const entries = existsSync(sessionDir)
-        ? await import("fs").then((fs) => fs.readdirSync(sessionDir, { withFileTypes: true }))
-        : [];
-    for (const entry of entries) {
-        if (entry.isDirectory() && entry.name.startsWith(projectName.substring(0, 20))) {
-            const sessionFile = join(sessionDir, entry.name, "session.json");
-            if (existsSync(sessionFile)) {
-                try {
-                    const content = JSON.parse(readFileSync(sessionFile, "utf-8"));
-                    if (content.cdpUrl) {
-                        // Extract port from URL like "ws://localhost:9223/devtools/browser/..."
-                        const match = content.cdpUrl.match(/:(\d+)/);
-                        if (match) {
-                            console.log(match[1]);
-                            process.exit(0);
-                        }
-                    }
-                }
-                catch {
-                    // Continue searching
-                }
-            }
-        }
-    }
-    // Default to 9222 if no session found
-    console.log("9222");
+    .action(() => {
+    console.log(getSessionCdpPort() || "9222");
 });
 program.parse();
 //# sourceMappingURL=cli.js.map