fengming 0.3.8 → 0.3.9

package/dist/binding-targets-B9vYS8n6.js

@@ -0,0 +1,121 @@
+//#region src/channels/plugins/stateful-target-drivers.ts
+const registeredStatefulBindingTargetDrivers = /* @__PURE__ */ new Map();
+function listStatefulBindingTargetDrivers() {
+	return [...registeredStatefulBindingTargetDrivers.values()];
+}
+function registerStatefulBindingTargetDriver(driver) {
+	const id = driver.id.trim();
+	if (!id) throw new Error("Stateful binding target driver id is required");
+	const normalized = {
+		...driver,
+		id
+	};
+	if (registeredStatefulBindingTargetDrivers.get(id)) return;
+	registeredStatefulBindingTargetDrivers.set(id, normalized);
+}
+function getStatefulBindingTargetDriver(id) {
+	const normalizedId = id.trim();
+	if (!normalizedId) return null;
+	return registeredStatefulBindingTargetDrivers.get(normalizedId) ?? null;
+}
+function resolveStatefulBindingTargetBySessionKey(params) {
+	const sessionKey = params.sessionKey.trim();
+	if (!sessionKey) return null;
+	for (const driver of listStatefulBindingTargetDrivers()) {
+		const bindingTarget = driver.resolveTargetBySessionKey?.({
+			cfg: params.cfg,
+			sessionKey
+		});
+		if (bindingTarget) return {
+			driver,
+			bindingTarget
+		};
+	}
+	return null;
+}
+//#endregion
+//#region src/channels/plugins/stateful-target-builtins.ts
+let builtinsRegisteredPromise = null;
+let acpDriverModulePromise;
+function loadAcpStatefulTargetDriverModule() {
+	acpDriverModulePromise ??= import("./acp-stateful-target-driver-B3pCvuOV.js");
+	return acpDriverModulePromise;
+}
+function isStatefulTargetBuiltinDriverId(id) {
+	return id.trim() === "acp";
+}
+async function ensureStatefulTargetBuiltinsRegistered() {
+	if (builtinsRegisteredPromise) {
+		await builtinsRegisteredPromise;
+		return;
+	}
+	builtinsRegisteredPromise = (async () => {
+		const { acpStatefulBindingTargetDriver } = await loadAcpStatefulTargetDriverModule();
+		registerStatefulBindingTargetDriver(acpStatefulBindingTargetDriver);
+	})();
+	try {
+		await builtinsRegisteredPromise;
+	} catch (error) {
+		builtinsRegisteredPromise = null;
+		throw error;
+	}
+}
+//#endregion
+//#region src/channels/plugins/binding-targets.ts
+async function ensureConfiguredBindingTargetReady(params) {
+	if (!params.bindingResolution) return { ok: true };
+	const driverId = params.bindingResolution.statefulTarget.driverId;
+	let driver = getStatefulBindingTargetDriver(driverId);
+	if (!driver && isStatefulTargetBuiltinDriverId(driverId)) {
+		await ensureStatefulTargetBuiltinsRegistered();
+		driver = getStatefulBindingTargetDriver(driverId);
+	}
+	if (!driver) return {
+		ok: false,
+		error: `Configured binding target driver unavailable: ${driverId}`
+	};
+	return await driver.ensureReady({
+		cfg: params.cfg,
+		bindingResolution: params.bindingResolution
+	});
+}
+async function resetConfiguredBindingTargetInPlace(params) {
+	let resolved = resolveStatefulBindingTargetBySessionKey({
+		cfg: params.cfg,
+		sessionKey: params.sessionKey
+	});
+	if (!resolved) {
+		await ensureStatefulTargetBuiltinsRegistered();
+		resolved = resolveStatefulBindingTargetBySessionKey({
+			cfg: params.cfg,
+			sessionKey: params.sessionKey
+		});
+	}
+	if (!resolved?.driver.resetInPlace) return {
+		ok: false,
+		skipped: true
+	};
+	return await resolved.driver.resetInPlace({
+		...params,
+		bindingTarget: resolved.bindingTarget
+	});
+}
+async function ensureConfiguredBindingTargetSession(params) {
+	const driverId = params.bindingResolution.statefulTarget.driverId;
+	let driver = getStatefulBindingTargetDriver(driverId);
+	if (!driver && isStatefulTargetBuiltinDriverId(driverId)) {
+		await ensureStatefulTargetBuiltinsRegistered();
+		driver = getStatefulBindingTargetDriver(driverId);
+	}
+	if (!driver) return {
+		ok: false,
+		sessionKey: params.bindingResolution.statefulTarget.sessionKey,
+		error: `Configured binding target driver unavailable: ${driverId}`
+	};
+	return await driver.ensureSession({
+		cfg: params.cfg,
+		bindingResolution: params.bindingResolution
+	});
+}
+//#endregion
+export { ensureConfiguredBindingTargetSession as n, resetConfiguredBindingTargetInPlace as r, ensureConfiguredBindingTargetReady as t };

package/dist/bridge-server-DG9YtKQe.js

@@ -0,0 +1,113 @@
+import { c as normalizeOptionalString } from "./string-coerce-DKw2K5wM.js";
+import { i as isLoopbackHost } from "./net-DAt4-3lj.js";
+import "./string-coerce-runtime-BurriTLB.js";
+import "./sdk-security-runtime-CM9KnGnN.js";
+import { r as setBridgeAuthForPort, t as deleteBridgeAuthForPort } from "./bridge-auth-registry-BX45MLkH.js";
+import { n as installBrowserAuthMiddleware, r as installBrowserCommonMiddleware, t as hasVerifiedBrowserAuth } from "./server-middleware-KTpBWo-A.js";
+import express from "express";
+//#region extensions/browser/src/browser/bridge-server.ts
+function buildNoVncBootstrapHtml(params) {
+	const hash = new URLSearchParams({
+		autoconnect: "1",
+		resize: "remote"
+	});
+	const password = normalizeOptionalString(params.password);
+	if (password) hash.set("password", password);
+	const targetUrl = `http://127.0.0.1:${params.noVncPort}/vnc.html#${hash.toString()}`;
+	return `<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <meta name="referrer" content="no-referrer" />
+  <title>FengMing noVNC Observer</title>
+</head>
+<body>
+  <p>Opening sandbox observer...</p>
+  <script>
+    const target = ${JSON.stringify(targetUrl)};
+    window.location.replace(target);
+  <\/script>
+</body>
+</html>`;
+}
+async function startBrowserBridgeServer(params) {
+	const host = params.host ?? "127.0.0.1";
+	if (!isLoopbackHost(host)) throw new Error(`bridge server must bind to loopback host (got ${host})`);
+	const port = params.port ?? 0;
+	const app = express();
+	installBrowserCommonMiddleware(app);
+	const authToken = normalizeOptionalString(params.authToken);
+	const authPassword = normalizeOptionalString(params.authPassword);
+	if (!authToken && !authPassword) throw new Error("桥服务器需要认证（缺少 authToken 或 authPassword）");
+	installBrowserAuthMiddleware(app, {
+		token: authToken,
+		password: authPassword
+	});
+	if (params.resolveSandboxNoVncToken) app.get("/sandbox/novnc", (req, res) => {
+		if (!hasVerifiedBrowserAuth(req)) {
+			res.status(401).send("Unauthorized");
+			return;
+		}
+		res.setHeader("Cache-Control", "no-store, no-cache, must-revalidate, proxy-revalidate");
+		res.setHeader("Pragma", "no-cache");
+		res.setHeader("Expires", "0");
+		res.setHeader("Referrer-Policy", "no-referrer");
+		const rawToken = normalizeOptionalString(req.query?.token);
+		if (!rawToken) {
+			res.status(400).send("Missing token");
+			return;
+		}
+		const resolved = params.resolveSandboxNoVncToken?.(rawToken);
+		if (!resolved) {
+			res.status(404).send("Invalid or expired token");
+			return;
+		}
+		res.type("html").status(200).send(buildNoVncBootstrapHtml(resolved));
+	});
+	const state = {
+		server: null,
+		port,
+		resolved: params.resolved,
+		profiles: /* @__PURE__ */ new Map()
+	};
+	if (params.skipRouteRegistrationForTest) app.get("/", (_req, res) => {
+		res.status(200).send("OK");
+	});
+	else {
+		const [{ createBrowserRouteContext }, { registerBrowserRoutes }] = await Promise.all([import("./server-context-BIemGRt4.js"), import("./routes-dTCmw98g.js")]);
+		registerBrowserRoutes(app, createBrowserRouteContext({
+			getState: () => state,
+			onEnsureAttachTarget: params.onEnsureAttachTarget
+		}));
+	}
+	const server = await new Promise((resolve, reject) => {
+		const s = app.listen(port, host, () => resolve(s));
+		s.once("error", reject);
+	});
+	const resolvedPort = server.address()?.port ?? port;
+	state.server = server;
+	state.port = resolvedPort;
+	state.resolved.controlPort = resolvedPort;
+	setBridgeAuthForPort(resolvedPort, {
+		token: authToken,
+		password: authPassword
+	});
+	return {
+		server,
+		port: resolvedPort,
+		baseUrl: `http://${host}:${resolvedPort}`,
+		state
+	};
+}
+async function stopBrowserBridgeServer(server) {
+	try {
+		const address = server.address();
+		if (address?.port) deleteBridgeAuthForPort(address.port);
+	} catch {}
+	await new Promise((resolve) => {
+		server.close(() => resolve());
+	});
+}
+//#endregion
+export { stopBrowserBridgeServer as n, startBrowserBridgeServer as t };

package/dist/browser-cli-B0Ou-Nbm.js

@@ -0,0 +1,2 @@
+import { t as registerBrowserCli } from "./browser-cli-GF25gL6M.js";
+export { registerBrowserCli };

package/dist/browser-cli-GF25gL6M.js

@@ -0,0 +1,230 @@
+import { t as formatCliCommand } from "./command-format-Jv8eeOPe.js";
+import { t as resolveCliArgvInvocation } from "./argv-invocation-Ayg7bWYX.js";
+import { t as formatDocsLink } from "./links-CgdQazeA.js";
+import { r as theme } from "./theme-BM_HFRPe.js";
+import { n as defaultRuntime } from "./runtime-BkTkFkXs.js";
+import { t as danger } from "./globals-BMM_rcFF.js";
+import { n as shouldEagerRegisterSubcommands } from "./command-registration-policy-9vz_YrbL.js";
+import { t as addGatewayClientOptions } from "./gateway-rpc-C5wc61o-.js";
+import { t as formatHelpExamples } from "./help-format-B6DgFpFp.js";
+import { i as registerCommandGroups } from "./register-command-groups-BFFim6Cu.js";
+import "./cli-runtime-D7C6yK3b.js";
+import "./core-api-DSpUKNVW.js";
+//#region extensions/browser/src/cli/browser-cli-examples.ts
+const browserCoreExamples = [
+	"fengming browser status",
+	"fengming browser start",
+	"fengming browser start --headless",
+	"fengming browser stop",
+	"fengming browser tabs",
+	"fengming browser open https://example.com",
+	"fengming browser focus abcd1234",
+	"fengming browser close abcd1234",
+	"fengming browser screenshot",
+	"fengming browser screenshot --full-page",
+	"fengming browser screenshot --ref 12",
+	"fengming browser snapshot",
+	"fengming browser snapshot --format aria --limit 200",
+	"fengming browser snapshot --efficient",
+	"fengming browser snapshot --labels"
+];
+const browserActionExamples = [
+	"fengming browser navigate https://example.com",
+	"fengming browser resize 1280 720",
+	"fengming browser click 12 --double",
+	"fengming browser click-coords 120 340",
+	"fengming browser type 23 \"hello\" --submit",
+	"fengming browser press Enter",
+	"fengming browser hover 44",
+	"fengming browser drag 10 11",
+	"fengming browser select 9 OptionA OptionB",
+	"fengming browser upload /tmp/fengming/uploads/file.pdf",
+	"fengming browser fill --fields '[{\"ref\":\"1\",\"value\":\"Ada\"}]'",
+	"fengming browser dialog --accept",
+	"fengming browser wait --text \"Done\"",
+	"fengming browser evaluate --fn '(el) => el.textContent' --ref 7",
+	"fengming browser console --level error",
+	"fengming browser pdf"
+];
+//#endregion
+//#region extensions/browser/src/cli/browser-cli.ts
+const ROOT_BOOLEAN_OPTIONS = new Set(["--dev", "--no-color"]);
+const ROOT_VALUE_OPTIONS = new Set([
+	"--profile",
+	"--log-level",
+	"--container"
+]);
+const BROWSER_BOOLEAN_OPTIONS = new Set(["--json", "--expect-final"]);
+const BROWSER_VALUE_OPTIONS = new Set([
+	"--browser-profile",
+	"--url",
+	"--token",
+	"--timeout"
+]);
+const command = (name, description, options) => ({
+	name,
+	description,
+	...options ? { options } : {}
+});
+const browserCommandGroupDefinitions = [
+	{
+		placeholders: [
+			command("status", "Show browser status"),
+			command("start", "Start the browser (no-op if already running)"),
+			command("stop", "Stop the browser (best-effort)"),
+			command("reset-profile", "Reset browser profile (moves it to Trash)"),
+			command("tabs", "List open tabs"),
+			command("tab", "Tab shortcuts (index-based)"),
+			command("open", "Open a URL in a new tab"),
+			command("focus", "Focus a tab by target id, tab id, label, or unique target id prefix"),
+			command("close", "Close a tab (target id optional)"),
+			command("profiles", "List all browser profiles"),
+			command("create-profile", "Create a new browser profile"),
+			command("delete-profile", "Delete a browser profile"),
+			command("doctor", "Check browser plugin readiness", [{
+				flags: "--deep",
+				description: "Run a live snapshot probe"
+			}])
+		],
+		register: async (args) => {
+			(await import("./browser-cli-manage-B9D9BvSe.js")).registerBrowserManageCommands(args.browser, args.parentOpts);
+		}
+	},
+	{
+		placeholders: [command("screenshot", "Capture a screenshot (MEDIA:<path>)"), command("snapshot", "Capture a snapshot (default: ai; aria is the accessibility tree)")],
+		register: async (args) => {
+			(await import("./browser-cli-inspect-WU5KeWOK.js")).registerBrowserInspectCommands(args.browser, args.parentOpts);
+		}
+	},
+	{
+		placeholders: [
+			command("navigate", "Navigate the current tab to a URL"),
+			command("resize", "Resize the viewport"),
+			command("click", "Click an element by ref from snapshot"),
+			command("click-coords", "Click viewport coordinates"),
+			command("type", "Type into an element by ref from snapshot"),
+			command("press", "Press a key"),
+			command("hover", "Hover an element by ai ref"),
+			command("scrollintoview", "Scroll an element into view by ref from snapshot"),
+			command("drag", "Drag from one ref to another"),
+			command("select", "Select option(s) in a select element"),
+			command("upload", "Arm file upload for the next file chooser"),
+			command("waitfordownload", "Wait for the next download (and save it)"),
+			command("download", "Click a ref and save the resulting download"),
+			command("dialog", "Arm the next modal dialog (alert/confirm/prompt)"),
+			command("fill", "Fill a form with JSON field descriptors"),
+			command("wait", "Wait for time, selector, URL, load state, or JS conditions"),
+			command("evaluate", "Evaluate a function against the page or a ref")
+		],
+		register: async (args) => {
+			(await import("./browser-cli-actions-input-CuER6RVe.js")).registerBrowserActionInputCommands(args.browser, args.parentOpts);
+		}
+	},
+	{
+		placeholders: [
+			command("console", "Get recent console messages"),
+			command("pdf", "Save page as PDF"),
+			command("responsebody", "Wait for a network response and return its body")
+		],
+		register: async (args) => {
+			(await import("./browser-cli-actions-observe-Dq-Zz_FA.js")).registerBrowserActionObserveCommands(args.browser, args.parentOpts);
+		}
+	},
+	{
+		placeholders: [
+			command("highlight", "Highlight an element by ref"),
+			command("errors", "Get recent page errors"),
+			command("requests", "Get recent network requests (best-effort)"),
+			command("trace", "Record a Playwright trace")
+		],
+		register: async (args) => {
+			(await import("./browser-cli-debug-7hvb49S1.js")).registerBrowserDebugCommands(args.browser, args.parentOpts);
+		}
+	},
+	{
+		placeholders: [
+			command("cookies", "Read/write cookies"),
+			command("storage", "Read/write localStorage/sessionStorage"),
+			command("set", "Browser environment settings")
+		],
+		register: async (args) => {
+			(await import("./browser-cli-state-D_YxTqRw.js")).registerBrowserStateCommands(args.browser, args.parentOpts);
+		}
+	}
+];
+function buildBrowserCommandGroups(params) {
+	return browserCommandGroupDefinitions.map((entry) => ({
+		placeholders: entry.placeholders,
+		register: async () => await entry.register(params)
+	}));
+}
+function isValueToken(arg) {
+	return Boolean(arg && arg !== "--" && (!arg.startsWith("-") || /^-\d+(?:\.\d+)?$/.test(arg)));
+}
+function consumeOption(args, index, booleanOptions, valueOptions) {
+	const arg = args[index];
+	if (!arg || arg === "--" || !arg.startsWith("-")) return 0;
+	const equalsIndex = arg.indexOf("=");
+	const flag = equalsIndex === -1 ? arg : arg.slice(0, equalsIndex);
+	if (booleanOptions.has(flag)) return equalsIndex === -1 ? 1 : 0;
+	if (!valueOptions.has(flag)) return 0;
+	if (equalsIndex !== -1) return arg.slice(equalsIndex + 1).trim() ? 1 : 0;
+	return isValueToken(args[index + 1]) ? 2 : 1;
+}
+function resolveBrowserLazySubcommand(argv) {
+	const { primary } = resolveCliArgvInvocation(argv);
+	if (primary !== "browser") return null;
+	const args = argv.slice(2);
+	let sawBrowser = false;
+	for (let i = 0; i < args.length; i += 1) {
+		const arg = args[i];
+		if (!arg || arg === "--") break;
+		if (!sawBrowser) {
+			const consumed = consumeOption(args, i, ROOT_BOOLEAN_OPTIONS, ROOT_VALUE_OPTIONS);
+			if (consumed > 0) {
+				i += consumed - 1;
+				continue;
+			}
+			if (arg.startsWith("-")) continue;
+			if (arg === "browser") {
+				sawBrowser = true;
+				continue;
+			}
+			return null;
+		}
+		const consumed = consumeOption(args, i, BROWSER_BOOLEAN_OPTIONS, BROWSER_VALUE_OPTIONS);
+		if (consumed > 0) {
+			i += consumed - 1;
+			continue;
+		}
+		if (arg.startsWith("-")) continue;
+		return arg;
+	}
+	return null;
+}
+function resolveBrowserParentOpts(cmd) {
+	for (let current = cmd; current; current = current.parent) if (current.name() === "browser") return current.opts();
+	return cmd.parent?.opts?.();
+}
+function registerLazyBrowserCommands(browser, parentOpts, argv) {
+	const subcommand = resolveBrowserLazySubcommand(argv);
+	registerCommandGroups(browser, buildBrowserCommandGroups({
+		browser,
+		parentOpts
+	}), {
+		eager: shouldEagerRegisterSubcommands(),
+		primary: subcommand,
+		registerPrimaryOnly: subcommand !== null
+	});
+}
+function registerBrowserCli(program, argv = process.argv) {
+	const browser = program.command("browser").description("Manage FengMing's dedicated browser (Chrome/Chromium)").option("--browser-profile <name>", "Browser profile name (default from config)").option("--json", "Output machine-readable JSON", false).addHelpText("after", () => `\n${theme.heading("Examples:")}\n${formatHelpExamples([...browserCoreExamples, ...browserActionExamples].map((cmd) => [cmd, ""]), true)}\n\n${theme.muted("Docs:")} ${formatDocsLink("/cli/browser", "docs.fengming.ai/cli/browser")}\n`).action(() => {
+		browser.outputHelp();
+		defaultRuntime.error(danger(`Missing subcommand. Try: "${formatCliCommand("fengming browser status")}"`));
+		defaultRuntime.exit(1);
+	});
+	addGatewayClientOptions(browser);
+	registerLazyBrowserCommands(browser, resolveBrowserParentOpts, argv);
+}
+//#endregion
+export { registerBrowserCli as t };