@treeport/treeport 0.5.0 → 0.6.1

package/dist/node/cli/index.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
-import { A as treeportVersion, C as disableTailscaleRemote, D as resolvePackagePath, E as resolveLocalApiUrl, M as parseDurationMs, N as TERMINAL_CAPTURE_MAX_LINES, O as runDoctor, S as daemonUp, T as readDaemonLogs, _ as serviceStatus, b as daemonHealth, ct as parseEventsSnapshot, d as serviceDisable, f as serviceDoctorCheck, g as serviceStart, h as serviceRun, k as tailscaleRemoteStatus, l as readServiceLogs, lt as parseProductEvent, m as serviceInstalled, p as serviceEnable, s as runLocalUpdate, st as webPanelInputSchema, t as LocalUpdateError, u as serviceApply, ut as SOCKET_IO_PATH, v as serviceStop, w as enableTailscaleRemote, x as daemonStatus, y as daemonDown } from "../../update-BW-a6Bd-.js";
+import { B as parseEventsSnapshot, H as SOCKET_IO_PATH, R as webPanelInputSchema, V as parseProductEvent, t as TERMINAL_CAPTURE_MAX_LINES } from "../../dist-Crk_Xr82.js";
+import { A as treeportVersion, C as disableTailscaleRemote, D as resolvePackagePath, E as resolveLocalApiUrl, M as parseDurationMs, O as runDoctor, S as daemonUp, T as readDaemonLogs, _ as serviceStatus, b as daemonHealth, d as serviceDisable, f as serviceDoctorCheck, g as serviceStart, h as serviceRun, k as tailscaleRemoteStatus, l as readServiceLogs, m as serviceInstalled, p as serviceEnable, s as runLocalUpdate, t as LocalUpdateError, u as serviceApply, v as serviceStop, w as enableTailscaleRemote, x as daemonStatus, y as daemonDown } from "../../update-qVp7yL5D.js";
 import fs from "node:fs/promises";
 import path from "node:path";
 import { Command, CommanderError } from "commander";
@@ -285,7 +286,37 @@ async function webPanelLaunchCwd(worktree) {
 	});
 	return path.relative(worktreeRoot, cwd) || ".";
 }
-function webPanelUrl(worktree, panelId) {
+async function resolveBrowserPanel(panelId) {
+	const candidates = (await projects()).flatMap((project) => project.worktrees.flatMap((worktree) => worktree.panels.filter((panel) => panel.kind === "browser").map((panel) => ({
+		panel,
+		worktree
+	}))));
+	if (panelId) {
+		const match = candidates.find((candidate) => candidate.panel.id === panelId);
+		if (!match) throw new CliError(`Browser ${panelId} was not found`, 5);
+		return match;
+	}
+	const worktree = await resolveWorktree(".");
+	const matches = candidates.filter((candidate) => candidate.worktree.id === worktree.id);
+	if (matches.length === 1) return matches[0];
+	if (matches.length === 0) throw new CliError(`No Browser is open in worktree ${worktree.name}`, 5, "BROWSER_PANEL_NOT_FOUND");
+	throw new CliError(`More than one Browser is open in worktree ${worktree.name}; specify --panel`, 5, "BROWSER_PANEL_AMBIGUOUS", { panelIds: matches.map((candidate) => candidate.panel.id) });
+}
+async function runBrowserAgentCommand(command, args, panelId) {
+	const { panel } = await resolveBrowserPanel(panelId);
+	const result = await request(`/api/panels/${encodeURIComponent(panel.id)}/browser-agent`, {
+		method: "POST",
+		body: JSON.stringify({
+			command,
+			args
+		})
+	});
+	return {
+		panelId: panel.id,
+		output: result.output
+	};
+}
+function panelUrl(worktree, panelId) {
 	const target = new URL(apiUrl);
 	target.pathname = `/projects/${encodeURIComponent(worktree.projectId)}/worktrees/${encodeURIComponent(worktree.id)}/panels/${encodeURIComponent(panelId)}`;
 	target.search = "";
@@ -441,13 +472,10 @@ async function waitForTerminal(terminalId, condition, timeoutMs) {
 function print(value, human) {
 	writeStdout(`${jsonOutput ? JSON.stringify(value) : human ? human() : JSON.stringify(value, null, 2)}\n`);
 }
-const agentGuidance = `AI agents:
-  If you're an AI agent, use \`treeport skills\` to see the usage guide.
-`;
 async function main(args) {
 	const argv = args[0] === "spawn" || args[0] === "terminal" && args[1] === "create" ? commandArgv(args) : void 0;
 	let parserError = "";
-	const program = new Command().name("treeport").usage("[options] [folder] [command]").description("Manage Treeport projects, trees, and terminals.").argument("[folder]", "folder or folder inside a Git repository to open").option("--json", "emit machine-readable JSON").addHelpText("beforeAll", agentGuidance).configureOutput({
+	const program = new Command().name("treeport").usage("[options] [folder] [command]").description("Manage Treeport projects, trees, and terminals.").argument("[folder]", "folder or folder inside a Git repository to open").option("--json", "emit machine-readable JSON").configureOutput({
 		writeOut: writeStdout,
 		writeErr: (value) => {
 			parserError += value;
@@ -673,6 +701,7 @@ async function main(args) {
 			worktreeId,
 			terminalId
 		});
+		const treeContext = (await request(`/api/worktrees/${encodeURIComponent(worktree.id)}/context`)).context;
 		const context = {
 			managed: true,
 			apiUrl,
@@ -695,7 +724,8 @@ async function main(args) {
 				head: worktree.head,
 				branch: worktree.branch,
 				detached: worktree.detached,
-				kind: worktree.kind
+				kind: worktree.kind,
+				context: treeContext
 			},
 			terminal: {
 				id: terminal.id,
@@ -705,8 +735,108 @@ async function main(args) {
 				exitCode: terminal.exitCode
 			}
 		};
-		print(context, () => `Treeport context\n\nProject:  ${context.project.name} (${context.project.id})\nTree:     ${context.worktree.name} (${context.worktree.id})\nPath:     ${context.worktree.path}\nTerminal: ${context.terminal.name} (${context.terminal.id}) — ${context.terminal.status}\nAPI:      ${context.apiUrl}\nLifecycle: ${context.daemonLifecycle === "external" ? "externally managed" : context.daemonLifecycle === "service" ? "managed by the OS service" : "managed by Treeport"}`);
+		print(context, () => {
+			const entries = Object.entries(context.worktree.context);
+			const treeContextText = entries.length === 0 ? "—" : entries.map(([key, value]) => {
+				const [first = "", ...rest] = [...value].map((character) => {
+					const code = character.charCodeAt(0);
+					return code !== 10 && (code <= 31 || code >= 127 && code <= 159) ? `\\u${code.toString(16).padStart(4, "0")}` : character;
+				}).join("").split("\n");
+				return `  ${key}: ${first}${rest.length > 0 ? `\n${rest.map((line) => `    ${line}`).join("\n")}` : ""}`;
+			}).join("\n");
+			return `Treeport context\n\nProject:  ${context.project.name} (${context.project.id})\nTree:     ${context.worktree.name} (${context.worktree.id})\nPath:     ${context.worktree.path}\nContext:\n${treeContextText}\nTerminal: ${context.terminal.name} (${context.terminal.id}) — ${context.terminal.status}\nAPI:      ${context.apiUrl}\nLifecycle: ${context.daemonLifecycle === "external" ? "externally managed" : context.daemonLifecycle === "service" ? "managed by the OS service" : "managed by Treeport"}`;
+		});
+	});
+	const browserCommand = program.command("browser").description("Manage Browser and its hosted Chromium");
+	browserCommand.action(() => {
+		writeStdout(browserCommand.helpInformation());
+	});
+	const browserOpenCommand = browserCommand.command("open").description("Open Browser and request client navigation").argument("[url]", "absolute HTTP or HTTPS URL").requiredOption("--worktree <id-or-path-or-dot>", "owning tree").option("--json", "emit machine-readable JSON");
+	browserOpenCommand.action(async (url) => {
+		const worktree = await resolveWorktree(browserOpenCommand.opts().worktree);
+		const body = {
+			url,
+			sourceTerminalId: contextWorktreeId === worktree.id ? contextTerminalId ?? null : null
+		};
+		const result = await request(`/api/worktrees/${encodeURIComponent(worktree.id)}/browser-panels`, {
+			method: "POST",
+			body: JSON.stringify(body)
+		});
+		const output = {
+			...result,
+			url: panelUrl(worktree, result.panel.id)
+		};
+		print(output, () => `Opened ${result.panel.title} (${result.panel.id})\n${output.url}`);
 	});
+	browserCommand.command("install").description("Install the Chromium build used by Browser").option("--json", "emit machine-readable JSON").action(async () => {
+		const result = await request("/api/browser/install", { method: "POST" });
+		print(result, () => result.message);
+	});
+	browserCommand.command("status").description("Show hosted browser installation status").option("--json", "emit machine-readable JSON").action(async () => {
+		const result = await request("/api/browser/status");
+		print(result, () => `${result.installed ? "Chromium is installed" : "Chromium is not installed"}\nLaunch ready: ${result.launchReady ? "yes" : "no"}\nPlaywright: ${result.playwrightVersion}\nBrowser: ${result.channel} ${result.browserRevision}\nExecutable: ${result.executablePath}${result.launchError ? `\nLaunch error: ${result.launchError}` : ""}`);
+	});
+	browserCommand.command("remove").description("Remove Treeport's hosted Chromium build").option("--json", "emit machine-readable JSON").action(async () => {
+		await request("/api/browser/install", { method: "DELETE" });
+		print({ removed: true }, () => "Removed Treeport hosted Chromium");
+	});
+	browserCommand.command("list").description("List open Browser sessions").option("--json", "emit machine-readable JSON").action(async () => {
+		const panels = (await projects()).flatMap((project) => project.worktrees.flatMap((worktree) => worktree.panels.filter((panel) => panel.kind === "browser").map((panel) => ({
+			panelId: panel.id,
+			title: panel.title,
+			worktreeId: worktree.id,
+			worktree: worktree.name,
+			projectId: project.id,
+			project: project.name
+		}))));
+		print(panels, () => panels.length ? panels.map((panel) => `${panel.panelId}\t${panel.project} / ${panel.worktree}\t${panel.title}`).join("\n") : "Browser is not open.");
+	});
+	const printAgentResult = async (command, args, panelId) => {
+		const result = await runBrowserAgentCommand(command, args, panelId);
+		print(result, () => result.output);
+	};
+	const browserSnapshotCommand = browserCommand.command("snapshot").description("Capture an accessibility snapshot of the hosted page").option("--panel <panel-id>", "Browser ID").option("--json", "emit machine-readable JSON");
+	browserSnapshotCommand.action(async () => printAgentResult("snapshot", [], browserSnapshotCommand.opts().panel));
+	const browserClickCommand = browserCommand.command("click").description("Click an element from the latest browser snapshot").argument("<target>", "Playwright element reference or selector").option("--panel <panel-id>", "Browser ID").option("--json", "emit machine-readable JSON");
+	browserClickCommand.action(async (target) => printAgentResult("click", [target], browserClickCommand.opts().panel));
+	const browserFillCommand = browserCommand.command("fill").description("Fill an editable element from the latest browser snapshot").argument("<target>", "Playwright element reference or selector").argument("<text>", "text to enter").option("--panel <panel-id>", "Browser ID").option("--json", "emit machine-readable JSON");
+	browserFillCommand.action(async (target, text) => printAgentResult("fill", [target, text], browserFillCommand.opts().panel));
+	const browserPressCommand = browserCommand.command("press").description("Press a key in the hosted page").argument("<key>", "Playwright key name").option("--panel <panel-id>", "Browser ID").option("--json", "emit machine-readable JSON");
+	browserPressCommand.action(async (key) => printAgentResult("press", [key], browserPressCommand.opts().panel));
+	const browserGotoCommand = browserCommand.command("goto").description("Navigate the hosted page").argument("<url>", "absolute HTTP or HTTPS URL").option("--panel <panel-id>", "Browser ID").option("--json", "emit machine-readable JSON");
+	browserGotoCommand.action(async (url) => printAgentResult("goto", [url], browserGotoCommand.opts().panel));
+	const browserConsoleCommand = browserCommand.command("console").description("List page console messages").argument("[level]", "minimum console level").option("--panel <panel-id>", "Browser ID").option("--json", "emit machine-readable JSON");
+	browserConsoleCommand.action(async (level) => printAgentResult("console", level ? [level] : [], browserConsoleCommand.opts().panel));
+	for (const [name, description, agentName] of [
+		[
+			"back",
+			"Go back in the hosted page",
+			"go-back"
+		],
+		[
+			"forward",
+			"Go forward in the hosted page",
+			"go-forward"
+		],
+		[
+			"reload",
+			"Reload the hosted page",
+			"reload"
+		],
+		[
+			"network",
+			"List page network requests",
+			"requests"
+		],
+		[
+			"screenshot",
+			"Capture a screenshot of the hosted page",
+			"screenshot"
+		]
+	]) {
+		const command = browserCommand.command(name).description(description).option("--panel <panel-id>", "Browser ID").option("--json", "emit machine-readable JSON");
+		command.action(async () => printAgentResult(agentName, [], command.opts().panel));
+	}
 	const installCommand = program.command("install").description("Install and configure a Treeport package").argument("<source>", "npm: source or local directory").option("-l, --local", "configure the registered project containing the current directory").option("--json", "emit machine-readable JSON");
 	installCommand.action(async (source) => {
 		const options = installCommand.opts();
@@ -858,7 +988,7 @@ async function main(args) {
 		});
 		const output = {
 			...result,
-			url: webPanelUrl(worktree, result.panel.id)
+			url: panelUrl(worktree, result.panel.id)
 		};
 		print(output, () => `${result.reused ? "Reused" : "Opened"} ${result.panel.title} (${result.panel.id})\n${output.url}`);
 	});

package/dist/node/server/core/launcher.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import "../../../dist-Crk_Xr82.js";
 import { t as integrateShellLaunch } from "../../../shell-integration-Be_c91lw.js";
 import fs from "node:fs/promises";
 import path from "node:path";
@@ -13,6 +14,7 @@ const FORWARDED_SIGNALS = [
 ];
 const launchSpecSchema = z.object({
 	argv: z.array(z.string()),
+	initialTitle: z.string().trim().min(1).max(120).optional(),
 	fallbackArgv: z.array(z.string()).optional(),
 	cwd: z.string(),
 	env: z.record(z.string(), z.string()),
@@ -159,30 +161,57 @@ async function runLaunchSpec(spec, dependencies = {}) {
 		...spec.env
 	};
 	const command = integrateShellLaunch(spec.argv, commandEnvironment, spec.shellIntegrationDir, spec.tmuxExecutable);
-	const result = await runChild(command.argv, {
-		cwd: spec.cwd,
-		env: command.env,
-		spawnProcess,
-		signalSource
-	});
-	if (result.spawnError) stderr.write(`Treeport launcher: ${safeDiagnostic(result.spawnError.message) || "spawn error"}\n`);
-	if (result.forwardedSignal && (!spec.fallbackArgv || result.forwardedSignal !== "SIGINT")) return 1;
-	if (spec.fallbackArgv) {
-		if (spec.tmuxExecutable && tmuxPane && spec.fallbackArgv[0]) await runChild([
+	const initialTitle = spec.initialTitle ? safeDiagnostic(spec.initialTitle) : "";
+	if (initialTitle && spec.tmuxExecutable && tmuxPane) {
+		if ((await runChild([
 			spec.tmuxExecutable,
 			"set-option",
 			"-p",
 			"-t",
 			tmuxPane,
 			"--",
-			"@treeport-fallback-shell",
-			Buffer.from(JSON.stringify(spec.fallbackArgv[0]), "utf8").toString("base64url")
+			"@treeport-command",
+			initialTitle
 		], {
 			cwd: spec.cwd,
 			env: process.env,
 			spawnProcess,
 			signalSource
-		});
+		})).forwardedSignal) return 1;
+	}
+	const result = await runChild(command.argv, {
+		cwd: spec.cwd,
+		env: command.env,
+		spawnProcess,
+		signalSource
+	});
+	if (result.spawnError) stderr.write(`Treeport launcher: ${safeDiagnostic(result.spawnError.message) || "spawn error"}\n`);
+	if (result.forwardedSignal && (!spec.fallbackArgv || result.forwardedSignal !== "SIGINT")) return 1;
+	if (spec.fallbackArgv) {
+		if (spec.tmuxExecutable && tmuxPane && spec.fallbackArgv[0]) {
+			if ((await runChild([
+				spec.tmuxExecutable,
+				"set-option",
+				"-p",
+				"-u",
+				"-t",
+				tmuxPane,
+				"@treeport-command",
+				";",
+				"set-option",
+				"-p",
+				"-t",
+				tmuxPane,
+				"--",
+				"@treeport-fallback-shell",
+				Buffer.from(JSON.stringify(spec.fallbackArgv[0]), "utf8").toString("base64url")
+			], {
+				cwd: spec.cwd,
+				env: process.env,
+				spawnProcess,
+				signalSource
+			})).forwardedSignal) return 1;
+		}
 		const fallback = integrateShellLaunch(spec.fallbackArgv, commandEnvironment, spec.shellIntegrationDir, spec.tmuxExecutable);
 		const fallbackResult = await runChild(fallback.argv, {
 			cwd: spec.cwd,