opentray 0.5.0 → 0.5.2

package/README.md

@@ -34,15 +34,18 @@ const space = await createSpace({ id: "com.example.status", default: true });
 await space.createTray({
   trayId: "status",
   title: "Status",
-  icon: { type: "rgba", data: [0, 0, 0, 0], width: 1, height: 1 },
+  icon: { type: "file", path: "./assets/tray-icon.png" },
 });
 
 const defaultSpace = await resolveDefaultSpace();
-await createTray({
-  trayId: "secondary",
-  title: "Secondary",
-  icon: { type: "rgba", data: [0, 0, 0, 0], width: 1, height: 1 },
-}, { space: defaultSpace.space });
+await createTray(
+  {
+    trayId: "secondary",
+    title: "Secondary",
+    icon: { type: "file", path: "./assets/tray-icon.png" },
+  },
+  { space: defaultSpace.space }
+);
 ```
 
 `createTray()` resolves the broker default space when no explicit target is provided. If you already know the target, pass `space: defaultSpace.space` in the second argument instead of relying on default-space lookup.
@@ -62,6 +65,27 @@ pnpm --filter opentray example:webview-control
 That demo opens a native WebView window immediately and puts the controls inside the page itself, so you can exercise frameless, transparent, keep-on-top, title, icon, screen, and navigation behavior without going through the tray menu first.
 Treat `example:webview-control` as the API exercise surface. It is useful for probing capabilities and events, but it is not the canonical recipe for a tray-anchored glass shell.
 
+Application code mounts WebView as a tray capability. The first WebView command loads the native extension automatically; ordinary code does not need to send `load-ext` manually:
+
+```ts
+import { WebviewExt } from "@opentray/ext-webview";
+import { createTray } from "opentray";
+
+const tray = (await createTray({
+  trayId: "status",
+  title: "Status",
+  icon: { type: "file", path: "./tray-icon.png" },
+})).extend(WebviewExt);
+
+const panel = tray.createWebviewWindow({
+  html: "<main>Status</main>",
+  width: 360,
+  height: 240,
+});
+
+await panel.show();
+```
+
 Run the dedicated tray-panel demo:
 
 ```bash
@@ -88,15 +112,17 @@ Current WebView truth:
 - some requests are `unsupported by design`, such as asking the macOS runtime to apply a Windows-only style family
 - some results are `unavailable by context`, such as tray-bounds projection when the current session has no authoritative tray anchor
 
-When run from the repo worktree, the example automatically discovers `target/debug` or `target/release` `libopentray_ext_webview` and wires it through `OPENTRAY_EXT_PATH` before starting the daemon. That keeps the example on the real `load-ext` path without requiring a manual staging step for routine source-level testing.
+When run from the repo worktree, the example automatically discovers `target/debug` or `target/release` `libopentray_ext_webview` and wires it through `OPENTRAY_EXT_PATH` before starting the daemon. The WebView mount still exercises the real generic extension loader, but example users do not author a manual `load-ext` request.
 
 After installing from npm, use the published CLI smoke path instead of workspace scripts:
 
 ```bash
 opentray smoke daemon-tray
-opentray smoke daemon-lynx --bundle ./research/lynx/app/dist/main.lynx.bundle
+opentray smoke daemon-lynx
 ```
 
+`opentray smoke daemon-lynx` now uses the package-owned review bundle by default so a fresh npm install can perform the final visual audit without a workspace checkout. Keep `--bundle <path-to-main.lynx.bundle>` only when you want to override that official audit asset with a custom bundle.
+
 This example starts or reuses the same-version daemon automatically, creates a real tray through the public SDK, and prints broker-routed menu events. Use manual lifecycle commands only for operator/debug control:
 
 ```bash
@@ -113,7 +139,19 @@ The host side of that example can call `await tray.getBounds()` to read the curr
 
 The opened WebView also enables the injected page bridge so the rendered page can call `navigator.window` / `navigator.opentrayWindow` and, for the demo only, opt into `window.close()` / `window.moveTo()` / `window.resizeTo()` overrides. Use the in-page buttons to verify `getCapabilities`, `getStyle`, `setStyle({ frameless })`, move, resize, close, and tray-bounds behavior visually instead of relying only on terminal logs.
 
-The Lynx smoke path uses the same generic extension loader but launches a real `LynxExplorer.app.zip` runtime sidecar from `@opentray/ext-lynx-darwin-*`. It starts the requested `.lynx.bundle` immediately on run and exposes `Reload Bundle`, `Hide Window`, and `Quit Smoke` through tray-routed events.
+The Lynx smoke path uses the same generic extension loader but launches a real `OpenTrayLynxRuntime.app.zip` sidecar from `@opentray/ext-lynx-darwin-*`. It starts the requested `.lynx.bundle` in a fixed host shell, sets an initial title and icon, applies an explicit startup feature expression, and exposes `Show Window`, `Hide Window`, and `Quit Smoke` through tray-routed events. Inside the Lynx window, use the rendered controls to verify `getCapabilities`, `getStyle`, `getTitle`, `setTitle`, `getIcon`, `setIcon`, `navigator.screen.getScreenDetails()`, `resizeTo`, `moveTo`, frameless toggling, `window.resizeTo()`, `window.getScreenDetails()`, and close behavior visually. On macOS, the runtime Dock icon should no longer appear blank.
+
+For Lynx, `frameless` currently means borderless only. It does not imply a full-window drag region, because that would steal clicks from the page content. When isolating host-feature regressions, `--features "*,!frameless"` is the fastest way to keep the bridge on while removing the borderless shell from the test.
+
+When you need to validate a GitHub-built macOS artifact before publish, use the workspace launcher instead of hand-written `/tmp` scripts:
+
+```bash
+pnpm run smoke:lynx -- --run <github-actions-run-id> --bundle packages/cli/assets/lynx-review/main.lynx.bundle
+pnpm run smoke:lynx -- --run <github-actions-run-id> --bundle packages/cli/assets/lynx-review/main.lynx.bundle --features "nativeWindowApi,bindWindowGlobals,nativeScreenApi,bindScreenGlobals"
+pnpm run smoke:lynx -- --run <github-actions-run-id> --bundle packages/cli/assets/lynx-review/main.lynx.bundle --features "*,!nativeScreenApi"
+```
+
+The package-owned review bundle is the full human acceptance surface. The separate `input-probe.lynx.bundle` is only a low-level diagnostic asset for isolating raw click/scroll/input delivery. The empty feature set is the baseline carrier check. Use it to validate the physical window baseline: click, scroll, input, red/yellow/green controls, and resize/move. Only after that baseline is healthy should you validate explicit startup feature sets on top of the same carrier.
 
 First-stage platform packages are published for macOS, Linux, and Windows. macOS is the current human-visual acceptance path. Linux and Windows artifacts are present for package topology validation, but unsupported broker/WebView capability must fail explicitly rather than pretending a visible UI exists. Lynx is intentionally macOS-first for now and should fail honestly on other platforms instead of pretending the runtime exists.
 
@@ -130,10 +168,10 @@ cargo build -p opentray-bin -p opentray-ext-webview -p opentray-ext-lynx
 bun run scripts/binaries/stage-local.ts --kind daemon --source target/debug/opentray
 bun run scripts/binaries/stage-local.ts --kind webview --source target/debug/libopentray_ext_webview.dylib
 bun run scripts/binaries/stage-local.ts --kind lynx --source target/debug/libopentray_ext_lynx.dylib
-bash scripts/release/build-lynx-runtime.sh /tmp/LynxExplorer.app.zip
-bun run scripts/binaries/stage-local.ts --kind lynx-runtime --source /tmp/LynxExplorer.app.zip
+bash scripts/release/build-lynx-runtime.sh /tmp/OpenTrayLynxRuntime.app.zip
+bun run scripts/binaries/stage-local.ts --kind lynx-runtime --source /tmp/OpenTrayLynxRuntime.app.zip
 OPENTRAY_EXAMPLE_WEBVIEW_SMOKE=1 pnpm --filter opentray cli -- smoke daemon-tray
-pnpm --filter opentray cli -- smoke daemon-lynx --bundle ./research/lynx/app/dist/main.lynx.bundle
+pnpm --filter opentray cli -- smoke daemon-lynx
 ```
 
 During source-level daemon work, restart the daemon with the freshly built broker binary before testing tray behavior. Otherwise the CLI may reuse the already staged same-version daemon:
@@ -158,4 +196,4 @@ otool -L target/release/libopentray_ext_webview.dylib
 otool -L target/release/libopentray_ext_lynx.dylib
 ```
 
-Current native icon support is `rgba`. `encoded` and `file` are typed protocol shapes, but the native `tray-icon` backend reports them as unsupported until decoding and file loading policy are implemented.
+The native `tray-icon` backend now normalizes `encoded` and `file` icon inputs into RGBA before native tray materialization. `rgba` still works when you already have pixel data, but ordinary app code can point at a PNG file instead of hand-building pixels.

package/assets/lynx-review/README.md

@@ -0,0 +1,14 @@
+## Lynx Review Bundle
+
+This directory contains the package-owned Lynx review bundle used by the public CLI smoke:
+
+```bash
+opentray smoke daemon-lynx
+```
+
+The goal is post-publish human verification. A fresh npm install must be able to open a real Lynx window without depending on a workspace checkout or `research/` paths.
+
+TODO:
+
+- move the source of this review app into a tracked repo-owned source root instead of relying on a copied research build artifact
+- keep the bundle focused on visual/runtime acceptance, not on product features unrelated to extension-host verification

package/dist/cli.d.mts

@@ -11,6 +11,7 @@ type CliCommand = {
   type: "smoke";
   name: "daemon-lynx";
   bundlePath?: string;
+  featureExpression?: string;
 } | {
   type: "help";
 };

package/dist/cli.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.mts","names":[],"sources":["../src/cli.ts"],"mappings":";;;KAiBK,UAAA;EACC,IAAA;EAAgB,MAAA;AAAA;EAChB,IAAA;EAAe,IAAA;AAAA;EACf,IAAA;EAAe,IAAA;EAAqB,UAAA;AAAA;EACpC,IAAA;AAAA;AAAA,cAEO,eAAA,GAAmB,IAAA,eAAiB,UAmBhD;AAAA,cAEY,MAAA,GAAgB,IAAA,eAAiB,OAAO;AAAA,cAsFxC,wBAAA,GAA4B,MAAoB,EAAZ,YAAY;AAAA,cAoBhD,eAAA,GAAmB,aAAA,sBAAmC,UAAkB"}
+{"version":3,"file":"cli.d.mts","names":[],"sources":["../src/cli.ts"],"mappings":";;;KAuBK,UAAA;EACC,IAAA;EAAgB,MAAA;AAAA;EAChB,IAAA;EAAe,IAAA;AAAA;EAEf,IAAA;EACA,IAAA;EACA,UAAA;EACA,iBAAA;AAAA;EAEA,IAAA;AAAA;AAAA,cAEO,eAAA,GAAmB,IAAA,eAAiB,UA+BhD;AAAA,cAEY,MAAA,GAAgB,IAAA,eAAiB,OAAO;AAAA,cAwGxC,wBAAA,GAA4B,MAAoB,EAAZ,YAAY;AAAA,cAoBhD,eAAA,GACX,aAAA,sBACA,UAAkB"}

package/dist/cli.mjs

@@ -1,19 +1,32 @@
 #!/usr/bin/env node
-import { t as createClient } from "./client-B_zxQOo5.mjs";
+import { t as createClient } from "./client-DzcHIH-f.mjs";
 import { a as inspectDaemon, c as stopDaemon, i as createNodeDaemonDriver, n as resolveDaemonPaths, o as restartDaemon, r as readPackageVersion, s as startDaemon, t as connectLocalBroker } from "./local-broker-CEIHPBcK.mjs";
 import { homedir } from "node:os";
 import { fileURLToPath } from "node:url";
 import { existsSync, realpathSync } from "node:fs";
-import { resolve } from "node:path";
+import { dirname, join, resolve } from "node:path";
 //#region src/smoke/daemon-lynx.ts
 const menuLabels$1 = new Map([
-	[1, "Reload Bundle"],
+	[1, "Show Window"],
 	[2, "Hide Window"],
 	[99, "Quit Smoke"]
 ]);
 const DEFAULT_LYNX_BUNDLE_ENV = "OPENTRAY_LYNX_BUNDLE";
+const DEFAULT_LYNX_HOST_FEATURES_ENV = "OPENTRAY_LYNX_HOST_FEATURES";
+const DEFAULT_REVIEW_BUNDLE_RELATIVE_PATH = "assets/lynx-review/main.lynx.bundle";
+const LYNX_HOST_FEATURES = [
+	"nativeWindowApi",
+	"bindWindowGlobals",
+	"nativeScreenApi",
+	"bindScreenGlobals",
+	"frameless"
+];
 const runDaemonLynxSmoke = async (options = {}) => {
 	const bundlePath = resolveLynxBundlePath(options.bundlePath);
+	const hostFeatures = resolveLynxHostFeatures(options.featureExpression);
+	if (process.env.OPENTRAY_LYNX_DEBUG) console.log(`lynx debug modes: ${process.env.OPENTRAY_LYNX_DEBUG}`);
+	if (process.env[DEFAULT_LYNX_HOST_FEATURES_ENV]) console.log(`lynx host features: ${process.env[DEFAULT_LYNX_HOST_FEATURES_ENV]}`);
+	if (process.env.OPENTRAY_LYNX_DEBUG_LOG_PATH) console.log(`lynx debug log path: ${process.env.OPENTRAY_LYNX_DEBUG_LOG_PATH}`);
 	const connection = await connectLocalBroker();
 	const client = createClient(connection, { requestIdPrefix: "daemon-lynx" });
 	console.log(`connected: endpoint=${connection.endpoint} session=${connection.sessionId}`);
@@ -35,7 +48,7 @@ const runDaemonLynxSmoke = async (options = {}) => {
 			{
 				type: "item",
 				id: 1,
-				title: "Reload Bundle"
+				title: "Show Window"
 			},
 			{
 				type: "item",
@@ -63,11 +76,12 @@ const runDaemonLynxSmoke = async (options = {}) => {
 	let exitTimer;
 	let resolveClosed;
 	const show = async () => {
-		await tray.commandExtension("lynx", {
-			type: "show",
-			bundlePath
+		const command = createLynxShowCommand({
+			bundlePath,
+			hostFeatures
 		});
-		console.log(`lynx command: show bundle=${bundlePath}`);
+		await tray.commandExtension("lynx", command);
+		console.log(`lynx command: show features=${describeLynxHostFeatures(hostFeatures)} bundle=${bundlePath}`);
 	};
 	const hide = async () => {
 		await tray.commandExtension("lynx", { type: "hide" });
@@ -125,7 +139,7 @@ const runDaemonLynxSmoke = async (options = {}) => {
 	}
 	try {
 		await show();
-		console.log("use the tray menu to reload or hide the Lynx window, or press Ctrl+C to exit");
+		console.log(`use the tray menu to re-show or hide the window, or press Ctrl+C to exit; features=${describeLynxHostFeatures(hostFeatures)}`);
 	} catch (error) {
 		await connection.close();
 		process.off("SIGINT", onSignal);
@@ -138,11 +152,96 @@ const runDaemonLynxSmoke = async (options = {}) => {
 };
 const resolveLynxBundlePath = (value) => {
 	const resolved = value ?? process.env[DEFAULT_LYNX_BUNDLE_ENV];
-	if (resolved === void 0 || resolved.length === 0) throw new Error(`lynx smoke requires --bundle <path> or ${DEFAULT_LYNX_BUNDLE_ENV}=<path-to-main.lynx.bundle>`);
+	if (resolved === void 0 || resolved.length === 0) {
+		const bundledReviewBundle = resolveBundledReviewBundlePath();
+		if (!existsSync(bundledReviewBundle)) throw new Error(`lynx smoke requires --bundle <path>, ${DEFAULT_LYNX_BUNDLE_ENV}=<path-to-main.lynx.bundle>, or a packaged review bundle at ${bundledReviewBundle}`);
+		return realpathSync(bundledReviewBundle);
+	}
 	const absolutePath = resolve(process.env.INIT_CWD ?? process.cwd(), resolved);
 	if (!existsSync(absolutePath)) throw new Error(`lynx smoke bundle does not exist: ${absolutePath}`);
 	return realpathSync(absolutePath);
 };
+const resolveLynxHostFeatures = (expression = process.env[DEFAULT_LYNX_HOST_FEATURES_ENV] ?? "") => {
+	const features = createEmptyLynxHostFeatures();
+	for (const rawToken of expression.split(",")) {
+		const token = rawToken.trim();
+		if (token.length === 0) continue;
+		applyLynxHostFeatureToken(features, token);
+	}
+	return features;
+};
+const createLynxShowCommand = ({ bundlePath, hostFeatures }) => {
+	const command = {
+		type: "show",
+		bundlePath,
+		width: 720,
+		height: 420,
+		minWidth: 320,
+		minHeight: 220,
+		maxWidth: 960,
+		maxHeight: 720,
+		nativeWindowApi: hostFeatures.nativeWindowApi,
+		bindWindowGlobals: hostFeatures.bindWindowGlobals,
+		nativeScreenApi: hostFeatures.nativeScreenApi,
+		bindScreenGlobals: hostFeatures.bindScreenGlobals,
+		title: `OpenTray Lynx Smoke (${describeLynxHostFeatures(hostFeatures)})`,
+		icon: createVisibleIcon$1()
+	};
+	if (hostFeatures.frameless) command.style = { frameless: true };
+	return command;
+};
+const describeLynxHostFeatures = (features) => {
+	const enabled = LYNX_HOST_FEATURES.filter((feature) => features[feature]);
+	return enabled.length === 0 ? "baseline" : enabled.join(",");
+};
+const resolveBundledReviewBundlePath = (moduleUrl = import.meta.url) => {
+	let currentDir = dirname(fileURLToPath(moduleUrl));
+	while (true) {
+		if (existsSync(join(currentDir, "package.json"))) return join(currentDir, DEFAULT_REVIEW_BUNDLE_RELATIVE_PATH);
+		const parent = dirname(currentDir);
+		if (parent === currentDir) throw new Error(`failed to resolve opentray package root from ${moduleUrl}`);
+		currentDir = parent;
+	}
+};
+function createEmptyLynxHostFeatures() {
+	return {
+		nativeWindowApi: false,
+		bindWindowGlobals: false,
+		nativeScreenApi: false,
+		bindScreenGlobals: false,
+		frameless: false
+	};
+}
+function applyLynxHostFeatureToken(features, rawToken) {
+	const disabled = rawToken.startsWith("!");
+	const token = disabled ? rawToken.slice(1) : rawToken;
+	if (token === "*" || token === "full") {
+		for (const feature of LYNX_HOST_FEATURES) features[feature] = !disabled;
+		return;
+	}
+	if (token === "baseline") {
+		for (const feature of LYNX_HOST_FEATURES) features[feature] = false;
+		return;
+	}
+	if (!isLynxHostFeature(token)) throw new Error(`unsupported Lynx host feature token: ${rawToken}; supported tokens: baseline, full, *, !<feature>, ${LYNX_HOST_FEATURES.join(", ")}`);
+	features[token] = !disabled;
+	if (token === "nativeWindowApi" && disabled) {
+		features.bindWindowGlobals = false;
+		return;
+	}
+	if (token === "nativeScreenApi" && disabled) {
+		features.bindScreenGlobals = false;
+		return;
+	}
+	if (token === "bindWindowGlobals" && !disabled) {
+		features.nativeWindowApi = true;
+		return;
+	}
+	if (token === "bindScreenGlobals" && !disabled) features.nativeScreenApi = true;
+}
+function isLynxHostFeature(value) {
+	return LYNX_HOST_FEATURES.includes(value);
+}
 function createVisibleIcon$1() {
 	const width = 32;
 	const height = 32;
@@ -397,14 +496,12 @@ const parseCliCommand = (argv) => {
 			name: "daemon-tray"
 		};
 		if (group === "smoke" && action === "daemon-lynx") {
-			const bundlePath = parseSmokeBundlePath(rest);
-			return bundlePath === void 0 ? {
-				type: "smoke",
-				name: "daemon-lynx"
-			} : {
+			const smokeOptions = parseSmokeOptions(rest);
+			return {
 				type: "smoke",
 				name: "daemon-lynx",
-				bundlePath
+				...smokeOptions.bundlePath ? { bundlePath: smokeOptions.bundlePath } : {},
+				...smokeOptions.featureExpression ? { featureExpression: smokeOptions.featureExpression } : {}
 			};
 		}
 		return { type: "help" };
@@ -428,7 +525,10 @@ const runCli = async (argv) => {
 	}
 	if (command.type === "smoke") {
 		if (command.name === "daemon-tray") await runDaemonTraySmoke();
-		else await runDaemonLynxSmoke(command.bundlePath === void 0 ? {} : { bundlePath: command.bundlePath });
+		else await runDaemonLynxSmoke({
+			...command.bundlePath === void 0 ? {} : { bundlePath: command.bundlePath },
+			...command.featureExpression === void 0 ? {} : { featureExpression: command.featureExpression }
+		});
 		return 0;
 	}
 	const driver = createNodeDaemonDriver(cliModulePath);
@@ -488,7 +588,8 @@ const runCli = async (argv) => {
 const printHelp = () => {
 	console.error("Usage: opentray daemon <start|stop|restart|health>");
 	console.error("       opentray smoke daemon-tray");
-	console.error("       opentray smoke daemon-lynx --bundle <path-to-main.lynx.bundle>");
+	console.error("       opentray smoke daemon-lynx [--bundle <path-to-main.lynx.bundle>] [--features <baseline|full|*,!feature,...>]");
+	console.error("       default Lynx smoke uses the packaged review bundle");
 };
 const formatDaemonHealthOutput = (health) => {
 	const lines = [
@@ -513,8 +614,20 @@ const isCliEntrypoint = (argvEntryPath, modulePath) => {
 		return argvEntryPath === modulePath;
 	}
 };
-function parseSmokeBundlePath(argv) {
-	for (let index = 0; index < argv.length; index += 1) if (argv[index] === "--bundle") return argv[index + 1];
+function parseSmokeOptions(argv) {
+	let bundlePath;
+	let featureExpression;
+	for (let index = 0; index < argv.length; index += 1) {
+		if (argv[index] === "--bundle") {
+			bundlePath = argv[index + 1];
+			continue;
+		}
+		if (argv[index] === "--features") featureExpression = argv[index + 1];
+	}
+	return {
+		...bundlePath === void 0 ? {} : { bundlePath },
+		...featureExpression === void 0 ? {} : { featureExpression }
+	};
 }
 if (isCliEntrypoint(process.argv[1], cliModulePath)) runCli(process.argv.slice(2)).then((code) => {
 	process.exitCode = code;

package/dist/cli.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cli.mjs","names":["menuLabels","createVisibleIcon"],"sources":["../src/smoke/daemon-lynx.ts","../src/smoke/daemon-tray.ts","../src/cli.ts"],"sourcesContent":["import { existsSync, realpathSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\n\nimport { createClient } from \"../client\";\nimport { connectLocalBroker } from \"../local-broker\";\n\nconst menuLabels = new Map<number, string>([\n  [1, \"Reload Bundle\"],\n  [2, \"Hide Window\"],\n  [99, \"Quit Smoke\"],\n]);\n\nconst DEFAULT_LYNX_BUNDLE_ENV = \"OPENTRAY_LYNX_BUNDLE\";\n\nexport interface DaemonLynxSmokeOptions {\n  bundlePath?: string;\n}\n\nexport const runDaemonLynxSmoke = async (\n  options: DaemonLynxSmokeOptions = {},\n): Promise<void> => {\n  const bundlePath = resolveLynxBundlePath(options.bundlePath);\n  const connection = await connectLocalBroker();\n  const client = createClient(connection, { requestIdPrefix: \"daemon-lynx\" });\n  console.log(`connected: endpoint=${connection.endpoint} session=${connection.sessionId}`);\n\n  const space = await client.createSpace({\n    id: \"com.example.opentray.daemon-lynx\",\n    title: \"OpenTray Lynx Smoke\",\n    default: true,\n  });\n  console.log(`space: ${JSON.stringify(space.space)}`);\n\n  const tray = await space.createTray({\n    trayId: \"daemon-lynx-status\",\n    title: \"OpenTray Lynx\",\n    tooltip: {\n      title: \"OpenTray Lynx\",\n      description: \"Generic extension smoke for a real Lynx runtime window\",\n    },\n    icon: createVisibleIcon(),\n    menu: {\n      items: [\n        { type: \"item\", id: 1, title: \"Reload Bundle\" },\n        { type: \"item\", id: 2, title: \"Hide Window\" },\n        { type: \"separator\" },\n        { type: \"item\", id: 99, title: \"Quit Smoke\" },\n      ],\n    },\n  });\n  console.log(`tray: ${tray.trayId}`);\n\n  await connection.request({\n    type: \"load-ext\",\n    requestId: \"daemon-lynx-load\",\n    spaceId: space.space.spaceId,\n    name: \"lynx\",\n    path: \"@opentray/ext-lynx\",\n  });\n  console.log(\"lynx extension requested through the generic load-ext path\");\n\n  let closed = false;\n  let exitTimer: NodeJS.Timeout | undefined;\n  let resolveClosed: (() => void) | undefined;\n\n  const show = async (): Promise<void> => {\n    await tray.commandExtension(\"lynx\", {\n      type: \"show\",\n      bundlePath,\n    });\n    console.log(`lynx command: show bundle=${bundlePath}`);\n  };\n\n  const hide = async (): Promise<void> => {\n    await tray.commandExtension(\"lynx\", { type: \"hide\" });\n    console.log(\"lynx command: hide\");\n  };\n\n  const shutdown = async (): Promise<void> => {\n    if (closed) {\n      return;\n    }\n    closed = true;\n    if (exitTimer !== undefined) {\n      clearTimeout(exitTimer);\n    }\n    process.off(\"SIGINT\", onSignal);\n    process.off(\"SIGTERM\", onSignal);\n    try {\n      await hide();\n    } catch (error) {\n      console.error(`lynx hide during shutdown failed: ${String(error)}`);\n    }\n    await connection.close();\n    resolveClosed?.();\n  };\n\n  const handleMenuClick = async (itemId: number): Promise<void> => {\n    switch (itemId) {\n      case 1:\n        await show();\n        return;\n      case 2:\n        await hide();\n        return;\n      case 99:\n        console.log(\"quit item routed; closing lynx smoke connection\");\n        await shutdown();\n        return;\n      default:\n        return;\n    }\n  };\n\n  connection.onEvent((frame) => {\n    console.log(`broker -> client ${JSON.stringify(frame)}`);\n    if (frame.type === \"event\" && frame.event.type === \"menuClick\") {\n      console.log(`menu click: ${menuLabels.get(frame.event.itemId) ?? frame.event.itemId}`);\n      void handleMenuClick(frame.event.itemId);\n      return;\n    }\n    if (frame.type === \"ext-event\" && frame.ext === \"lynx\") {\n      console.log(`lynx event: ${JSON.stringify(frame.data)}`);\n    }\n  });\n\n  const onSignal = (): void => {\n    void shutdown();\n  };\n  process.on(\"SIGINT\", onSignal);\n  process.on(\"SIGTERM\", onSignal);\n\n  const exitAfter = process.env.OPENTRAY_EXAMPLE_EXIT_AFTER_MS;\n  if (exitAfter !== undefined && exitAfter.length > 0) {\n    const duration = Number.parseInt(exitAfter, 10);\n    if (Number.isInteger(duration) && duration > 0) {\n      exitTimer = setTimeout(() => {\n        void shutdown();\n      }, duration);\n    }\n  }\n\n  try {\n    await show();\n    console.log(\"use the tray menu to reload or hide the Lynx window, or press Ctrl+C to exit\");\n  } catch (error) {\n    await connection.close();\n    process.off(\"SIGINT\", onSignal);\n    process.off(\"SIGTERM\", onSignal);\n    throw error;\n  }\n\n  await new Promise<void>((resolve) => {\n    resolveClosed = resolve;\n  });\n};\n\nexport const resolveLynxBundlePath = (value?: string): string => {\n  const resolved = value ?? process.env[DEFAULT_LYNX_BUNDLE_ENV];\n  if (resolved === undefined || resolved.length === 0) {\n    throw new Error(\n      `lynx smoke requires --bundle <path> or ${DEFAULT_LYNX_BUNDLE_ENV}=<path-to-main.lynx.bundle>`,\n    );\n  }\n  const baseDir = process.env.INIT_CWD ?? process.cwd();\n  const absolutePath = resolve(baseDir, resolved);\n  if (!existsSync(absolutePath)) {\n    throw new Error(`lynx smoke bundle does not exist: ${absolutePath}`);\n  }\n  return realpathSync(absolutePath);\n};\n\nfunction createVisibleIcon(): { type: \"rgba\"; width: number; height: number; data: number[] } {\n  const width = 32;\n  const height = 32;\n  const data: number[] = [];\n\n  for (let y = 0; y < height; y += 1) {\n    for (let x = 0; x < width; x += 1) {\n      const inStroke = x <= 5 || (x >= 13 && x <= 18) || y >= 26;\n      const inDiagonal = y >= x + 10 && x <= 18;\n      const alpha = inStroke || inDiagonal ? 255 : 0;\n      data.push(34, 92, 56, alpha);\n    }\n  }\n\n  return { type: \"rgba\", width, height, data };\n}\n","import type { Rect } from \"@opentray/spec\";\n\nimport { createClient } from \"../client\";\nimport { connectLocalBroker } from \"../local-broker\";\n\nconst menuLabels = new Map<number, string>([\n  [1, \"Open WebView\"],\n]);\n\ninterface WebviewShowCommand {\n  type: \"show\";\n  html?: string;\n  url?: string;\n  width?: number;\n  height?: number;\n  fallbackRect?: Rect;\n  nativeWindowApi?: boolean;\n  bindWindowGlobals?: boolean;\n  nativeScreenApi?: boolean;\n  bindScreenGlobals?: boolean;\n  nativeTrayApi?: boolean;\n  title?: string;\n  icon?: { type: \"href\"; href: string };\n  style?: {\n    frameless?: boolean;\n    transparent?: boolean;\n    keepOnTop?: boolean;\n    platform?: {\n      macos?: {\n        material?: string | null;\n        materialState?: \"followsWindowActiveState\" | \"active\" | \"inactive\";\n        cornerRadius?: number | null;\n      };\n    };\n  };\n  titleSync?: boolean | { documentToWindow?: boolean; windowToDocument?: boolean };\n  iconSync?: boolean | { faviconToWindow?: boolean; windowToFavicon?: boolean };\n  nativeApiPolicy?: {\n    defaultSrc?: string[];\n    window?: string[];\n    screen?: string[];\n    tray?: string[];\n    windowGlobals?: string[];\n    screenGlobals?: string[];\n    titleSync?: string[];\n    iconSync?: string[];\n  };\n}\n\nexport const runDaemonTraySmoke = async (): Promise<void> => {\n  const connection = await connectLocalBroker();\n  const client = createClient(connection, { requestIdPrefix: \"daemon-smoke\" });\n  console.log(`connected: endpoint=${connection.endpoint} session=${connection.sessionId}`);\n\n  const space = await client.createSpace({\n    id: \"com.example.opentray.daemon-smoke\",\n    title: \"OpenTray Daemon Smoke\",\n    default: true,\n  });\n  console.log(`space: ${JSON.stringify(space.space)}`);\n\n  const tray = await space.createTray({\n    trayId: \"daemon-smoke-status\",\n    title: \"OpenTray\",\n    tooltip: {\n      title: \"OpenTray\",\n      description: \"Single primary tray action; macOS direct-triggers without opening a menu\",\n    },\n    icon: createVisibleIcon(),\n    menu: {\n      items: [\n        { type: \"item\", id: 1, title: \"Open WebView\", primaryEvent: true },\n      ],\n    },\n  });\n  console.log(`tray: ${tray.trayId}`);\n\n  await connection.request({\n    type: \"load-ext\",\n    requestId: \"daemon-smoke-load-webview\",\n    spaceId: space.space.spaceId,\n    name: \"webview\",\n    path: \"@opentray/ext-webview\",\n  });\n  console.log(\"webview extension requested through the generic load-ext path\");\n  console.log(\"click the tray icon: macOS should direct-trigger the single primary action without opening a menu\");\n\n  let closed = false;\n  let exitTimer: NodeJS.Timeout | undefined;\n\n  const shutdown = async (): Promise<void> => {\n    if (closed) {\n      return;\n    }\n    closed = true;\n    if (exitTimer !== undefined) {\n      clearTimeout(exitTimer);\n    }\n    await connection.close();\n  };\n\n  const commandWebview = async (command: WebviewShowCommand | Record<string, unknown>): Promise<void> => {\n    await tray.commandExtension(\"webview\", command);\n  };\n\n  const handleMenuClick = async (itemId: number): Promise<void> => {\n    if (itemId === 1) {\n      const trayBounds = await tray.getBounds();\n      console.log(`tray bounds: ${JSON.stringify(trayBounds)}`);\n      await commandWebview({\n        type: \"show\",\n        html: createWebviewDemoHtml(),\n        width: 420,\n        height: 260,\n        title: \"OpenTray WebView Smoke\",\n        icon: {\n          type: \"href\",\n          href: \"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO+/p9sAAAAASUVORK5CYII=\",\n        },\n        style: {\n          frameless: true,\n          transparent: true,\n          keepOnTop: true,\n          platform: {\n            macos: {\n              material: \"hudWindow\",\n              materialState: \"active\",\n            },\n          },\n        },\n        fallbackRect: trayBounds.rect ?? { x: 0, y: 0, width: 1, height: 1 },\n        nativeWindowApi: true,\n        bindWindowGlobals: true,\n        nativeScreenApi: true,\n        bindScreenGlobals: true,\n        nativeTrayApi: true,\n        titleSync: {\n          documentToWindow: true,\n          windowToDocument: true,\n        },\n        iconSync: true,\n        nativeApiPolicy: {\n          defaultSrc: [\"'local'\"],\n          window: [\"https://example.com\"],\n          screen: [\"https://example.com\"],\n          tray: [\"https://example.com\"],\n          titleSync: [\"https://example.com\"],\n          iconSync: [\"https://example.com\"],\n        },\n      });\n      console.log(\"primary tray action: webview show\");\n      return;\n    }\n  };\n\n  connection.onEvent((frame) => {\n    console.log(`broker -> client ${JSON.stringify(frame)}`);\n    if (frame.type === \"event\" && frame.event.type === \"menuClick\") {\n      console.log(`menu click: ${menuLabels.get(frame.event.itemId) ?? frame.event.itemId}`);\n      void handleMenuClick(frame.event.itemId);\n    }\n  });\n\n  const exitAfter = process.env.OPENTRAY_EXAMPLE_EXIT_AFTER_MS;\n  if (exitAfter !== undefined && exitAfter.length > 0) {\n    const duration = Number.parseInt(exitAfter, 10);\n    if (Number.isInteger(duration) && duration > 0) {\n      exitTimer = setTimeout(() => {\n        void shutdown();\n      }, duration);\n    }\n  }\n\n  const webviewSmoke = process.env.OPENTRAY_EXAMPLE_WEBVIEW_SMOKE;\n  try {\n    if (webviewSmoke === \"show\" || webviewSmoke === \"1\") {\n      await handleMenuClick(1);\n    }\n    if (webviewSmoke === \"1\") {\n      if (exitTimer !== undefined) {\n        clearTimeout(exitTimer);\n        exitTimer = undefined;\n      }\n      await sleep(300);\n      await shutdown();\n    }\n  } catch (error) {\n    await shutdown();\n    throw error;\n  }\n};\n\nfunction createVisibleIcon(): { type: \"rgba\"; width: number; height: number; data: number[] } {\n  const width = 32;\n  const height = 32;\n  const data: number[] = [];\n\n  for (let y = 0; y < height; y += 1) {\n    for (let x = 0; x < width; x += 1) {\n      const dx = x - 15.5;\n      const dy = y - 15.5;\n      const distance = Math.sqrt(dx * dx + dy * dy);\n      const inRing = distance >= 9 && distance <= 14;\n      const inCore = distance <= 5;\n      const inNeedle = Math.abs(dx + dy) <= 1.2 && x >= 9 && x <= 23 && y >= 9 && y <= 23;\n\n      if (inRing || inCore || inNeedle) {\n        data.push(inCore ? 255 : 24, inNeedle ? 240 : 132, inRing ? 72 : 96, 255);\n      } else {\n        data.push(0, 0, 0, 0);\n      }\n    }\n  }\n\n  return { type: \"rgba\", width, height, data };\n}\n\nfunction createWebviewDemoHtml(): string {\n  return `<!doctype html>\n<html lang=\"en\">\n  <head>\n    <meta charset=\"utf-8\" />\n    <title>OpenTray WebView</title>\n    <style>\n      :root {\n        color: #18220f;\n        background: #f6edd8;\n        font: 15px ui-rounded, \"SF Pro Rounded\", \"Avenir Next\", sans-serif;\n      }\n      body {\n        margin: 0;\n      }\n      main {\n        min-height: 100vh;\n        box-sizing: border-box;\n        padding: 22px;\n        background:\n          radial-gradient(circle at 84% 10%, rgba(34, 132, 96, 0.22), transparent 34%),\n          linear-gradient(135deg, #fff8e7 0%, #e9f0d8 100%);\n      }\n      h1 {\n        margin: 0 0 8px;\n        font-size: 24px;\n        letter-spacing: -0.04em;\n      }\n      p {\n        margin: 0 0 16px;\n        color: #526044;\n      }\n      section {\n        display: grid;\n        gap: 10px;\n      }\n      .card {\n        border: 1px solid rgba(24, 34, 15, 0.16);\n        border-radius: 14px;\n        padding: 12px;\n        background: rgba(255, 255, 255, 0.72);\n        box-shadow: 0 12px 30px rgba(56, 72, 36, 0.12);\n      }\n      .label {\n        margin-bottom: 5px;\n        color: #7b5b1d;\n        font-size: 12px;\n        font-weight: 700;\n        letter-spacing: 0.08em;\n        text-transform: uppercase;\n      }\n      code {\n        word-break: break-word;\n      }\n    </style>\n  </head>\n  <body>\n    <main>\n      <h1>OpenTray WebView</h1>\n      <p>This window was opened by the single primary tray action.</p>\n      <section>\n        <div class=\"card\">\n          <div class=\"label\">primary event</div>\n          <code>macOS single primary item direct-triggered menuClick -> WebView show</code>\n        </div>\n      </section>\n    </main>\n  </body>\n</html>`;\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n","#!/usr/bin/env node\nimport { realpathSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { fileURLToPath } from \"node:url\";\n\nimport type { DaemonHealth } from \"@opentray/spec\";\n\nimport { createNodeDaemonDriver, inspectDaemon, restartDaemon, startDaemon, stopDaemon } from \"./daemon/lifecycle\";\nimport { readPackageVersion } from \"./daemon/package-version\";\nimport { resolveDaemonPaths } from \"./daemon/paths\";\nimport { connectLocalBroker } from \"./local-broker\";\nimport { runDaemonLynxSmoke } from \"./smoke/daemon-lynx\";\nimport { runDaemonTraySmoke } from \"./smoke/daemon-tray\";\n\nconst packageJsonUrl = new URL(\"../package.json\", import.meta.url);\nconst cliModulePath = fileURLToPath(import.meta.url);\n\ntype CliCommand =\n  | { type: \"daemon\"; action: \"start\" | \"stop\" | \"restart\" | \"health\" }\n  | { type: \"smoke\"; name: \"daemon-tray\" }\n  | { type: \"smoke\"; name: \"daemon-lynx\"; bundlePath?: string }\n  | { type: \"help\" };\n\nexport const parseCliCommand = (argv: string[]): CliCommand => {\n  const [group, action, ...rest] = argv;\n  if (group !== \"daemon\") {\n    if (group === \"smoke\" && action === \"daemon-tray\") {\n      return { type: \"smoke\", name: \"daemon-tray\" };\n    }\n    if (group === \"smoke\" && action === \"daemon-lynx\") {\n      const bundlePath = parseSmokeBundlePath(rest);\n      return bundlePath === undefined\n        ? { type: \"smoke\", name: \"daemon-lynx\" }\n        : { type: \"smoke\", name: \"daemon-lynx\", bundlePath };\n    }\n    return { type: \"help\" };\n  }\n  if (action === \"start\" || action === \"stop\" || action === \"restart\" || action === \"health\") {\n    return { type: \"daemon\", action };\n  }\n\n  return { type: \"help\" };\n};\n\nexport const runCli = async (argv: string[]): Promise<number> => {\n  const command = parseCliCommand(argv);\n  const packageVersion = process.env.OPENTRAY_DAEMON_PACKAGE_VERSION ?? (await readPackageVersion(packageJsonUrl));\n  const paths = resolveDaemonPaths({\n    homeDir: process.env.OPENTRAY_HOME ?? homedir(),\n    packageVersion,\n  });\n\n  if (command.type === \"help\") {\n    printHelp();\n    return 1;\n  }\n\n  if (command.type === \"smoke\") {\n    if (command.name === \"daemon-tray\") {\n      await runDaemonTraySmoke();\n    } else {\n      await runDaemonLynxSmoke(\n        command.bundlePath === undefined ? {} : { bundlePath: command.bundlePath },\n      );\n    }\n    return 0;\n  }\n\n  const driver = createNodeDaemonDriver(cliModulePath);\n\n  if (command.action === \"start\") {\n    const result = await startDaemon({ paths, driver });\n    console.log(`opentray daemon ${result.status}: pid=${result.pid} endpoint=${result.paths.endpoint}`);\n    return 0;\n  }\n\n  if (command.action === \"stop\") {\n    const result = await stopDaemon({ paths, driver });\n    console.log(\n      result.status === \"stopped\"\n        ? `opentray daemon stopped: pid=${result.pid}`\n        : \"opentray daemon not running\",\n    );\n    return 0;\n  }\n\n  if (command.action === \"restart\") {\n    const result = await restartDaemon({ paths, driver });\n    console.log(`opentray daemon ${result.status}: pid=${result.pid} endpoint=${result.paths.endpoint}`);\n    return 0;\n  }\n\n  if (command.action === \"health\") {\n    const inspected = await inspectDaemon({ paths, driver });\n    if (inspected.status === \"not-running\") {\n      console.log(\"opentray daemon not running\");\n      return 0;\n    }\n\n    const connection = await connectLocalBroker({\n      autoStart: false,\n      endpoint: paths.endpoint,\n      homeDir: paths.homeDir,\n      packageVersion,\n    });\n    try {\n      const response = await connection.request({\n        type: \"health\",\n        requestId: \"opentray-daemon-health\",\n      });\n      if (response.type !== \"daemon-health\") {\n        throw new Error(`expected daemon-health response, received ${response.type}`);\n      }\n      console.log(formatDaemonHealthOutput(response.health));\n    } finally {\n      await connection.close();\n    }\n    return 0;\n  }\n\n  printHelp();\n  return 1;\n};\n\nconst printHelp = (): void => {\n  console.error(\"Usage: opentray daemon <start|stop|restart|health>\");\n  console.error(\"       opentray smoke daemon-tray\");\n  console.error(\"       opentray smoke daemon-lynx --bundle <path-to-main.lynx.bundle>\");\n};\n\nexport const formatDaemonHealthOutput = (health: DaemonHealth): string => {\n  const lines = [\n    \"opentray daemon running\",\n    `pid: ${health.pid}`,\n    `endpoint: ${health.endpoint}`,\n    `packageVersion: ${health.packageVersion}`,\n    `protocolVersion: ${health.protocolVersion}`,\n    `sessions: ${health.sessionCount}`,\n  ];\n\n  for (const session of health.sessions) {\n    const internalLease = session.internalLeaseId ?? \"(pending)\";\n    lines.push(\n      `- sessionId=${session.sessionId} initialized=${session.initialized} internalLeaseId=${internalLease}`,\n    );\n  }\n\n  return lines.join(\"\\n\");\n};\n\nexport const isCliEntrypoint = (argvEntryPath: string | undefined, modulePath: string): boolean => {\n  if (argvEntryPath === undefined) return false;\n  try {\n    return realpathSync(argvEntryPath) === realpathSync(modulePath);\n  } catch {\n    return argvEntryPath === modulePath;\n  }\n};\n\nfunction parseSmokeBundlePath(argv: string[]): string | undefined {\n  for (let index = 0; index < argv.length; index += 1) {\n    if (argv[index] === \"--bundle\") {\n      return argv[index + 1];\n    }\n  }\n  return undefined;\n}\n\nif (isCliEntrypoint(process.argv[1], cliModulePath)) {\n  runCli(process.argv.slice(2)).then((code) => {\n    process.exitCode = code;\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"cli.mjs","names":["menuLabels","createVisibleIcon"],"sources":["../src/smoke/daemon-lynx.ts","../src/smoke/daemon-tray.ts","../src/cli.ts"],"sourcesContent":["import { existsSync, realpathSync } from \"node:fs\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nimport { createClient } from \"../client\";\nimport { connectLocalBroker } from \"../local-broker\";\n\nconst menuLabels = new Map<number, string>([\n  [1, \"Show Window\"],\n  [2, \"Hide Window\"],\n  [99, \"Quit Smoke\"],\n]);\n\nconst DEFAULT_LYNX_BUNDLE_ENV = \"OPENTRAY_LYNX_BUNDLE\";\nconst DEFAULT_LYNX_HOST_FEATURES_ENV = \"OPENTRAY_LYNX_HOST_FEATURES\";\nconst DEFAULT_REVIEW_BUNDLE_RELATIVE_PATH =\n  \"assets/lynx-review/main.lynx.bundle\";\nconst LYNX_HOST_FEATURES = [\n  \"nativeWindowApi\",\n  \"bindWindowGlobals\",\n  \"nativeScreenApi\",\n  \"bindScreenGlobals\",\n  \"frameless\",\n] as const;\n\nexport type LynxHostFeature = (typeof LYNX_HOST_FEATURES)[number];\n\nexport interface LynxHostFeatureState {\n  nativeWindowApi: boolean;\n  bindWindowGlobals: boolean;\n  nativeScreenApi: boolean;\n  bindScreenGlobals: boolean;\n  frameless: boolean;\n}\n\ninterface LynxSmokeShowCommand {\n  type: \"show\";\n  bundlePath: string;\n  width: number;\n  height: number;\n  minWidth: number;\n  minHeight: number;\n  maxWidth: number;\n  maxHeight: number;\n  nativeWindowApi: boolean;\n  bindWindowGlobals: boolean;\n  nativeScreenApi: boolean;\n  bindScreenGlobals: boolean;\n  title: string;\n  icon: ReturnType<typeof createVisibleIcon>;\n  style?: {\n    frameless: boolean;\n  };\n}\n\nexport interface DaemonLynxSmokeOptions {\n  bundlePath?: string;\n  featureExpression?: string;\n}\n\nexport const runDaemonLynxSmoke = async (\n  options: DaemonLynxSmokeOptions = {},\n): Promise<void> => {\n  const bundlePath = resolveLynxBundlePath(options.bundlePath);\n  const hostFeatures = resolveLynxHostFeatures(options.featureExpression);\n  if (process.env.OPENTRAY_LYNX_DEBUG) {\n    console.log(`lynx debug modes: ${process.env.OPENTRAY_LYNX_DEBUG}`);\n  }\n  if (process.env[DEFAULT_LYNX_HOST_FEATURES_ENV]) {\n    console.log(\n      `lynx host features: ${process.env[DEFAULT_LYNX_HOST_FEATURES_ENV]}`,\n    );\n  }\n  if (process.env.OPENTRAY_LYNX_DEBUG_LOG_PATH) {\n    console.log(\n      `lynx debug log path: ${process.env.OPENTRAY_LYNX_DEBUG_LOG_PATH}`,\n    );\n  }\n  const connection = await connectLocalBroker();\n  const client = createClient(connection, { requestIdPrefix: \"daemon-lynx\" });\n  console.log(\n    `connected: endpoint=${connection.endpoint} session=${connection.sessionId}`,\n  );\n\n  const space = await client.createSpace({\n    id: \"com.example.opentray.daemon-lynx\",\n    title: \"OpenTray Lynx Smoke\",\n    default: true,\n  });\n  console.log(`space: ${JSON.stringify(space.space)}`);\n\n  const tray = await space.createTray({\n    trayId: \"daemon-lynx-status\",\n    title: \"OpenTray Lynx\",\n    tooltip: {\n      title: \"OpenTray Lynx\",\n      description: \"Generic extension smoke for a real Lynx runtime window\",\n    },\n    icon: createVisibleIcon(),\n    menu: {\n      items: [\n        { type: \"item\", id: 1, title: \"Show Window\" },\n        { type: \"item\", id: 2, title: \"Hide Window\" },\n        { type: \"separator\" },\n        { type: \"item\", id: 99, title: \"Quit Smoke\" },\n      ],\n    },\n  });\n  console.log(`tray: ${tray.trayId}`);\n\n  await connection.request({\n    type: \"load-ext\",\n    requestId: \"daemon-lynx-load\",\n    spaceId: space.space.spaceId,\n    name: \"lynx\",\n    path: \"@opentray/ext-lynx\",\n  });\n  console.log(\"lynx extension requested through the generic load-ext path\");\n\n  let closed = false;\n  let exitTimer: NodeJS.Timeout | undefined;\n  let resolveClosed: (() => void) | undefined;\n\n  const show = async (): Promise<void> => {\n    const command = createLynxShowCommand({\n      bundlePath,\n      hostFeatures,\n    });\n    await tray.commandExtension(\"lynx\", command);\n    console.log(\n      `lynx command: show features=${describeLynxHostFeatures(\n        hostFeatures,\n      )} bundle=${bundlePath}`,\n    );\n  };\n\n  const hide = async (): Promise<void> => {\n    await tray.commandExtension(\"lynx\", { type: \"hide\" });\n    console.log(\"lynx command: hide\");\n  };\n\n  const shutdown = async (): Promise<void> => {\n    if (closed) {\n      return;\n    }\n    closed = true;\n    if (exitTimer !== undefined) {\n      clearTimeout(exitTimer);\n    }\n    process.off(\"SIGINT\", onSignal);\n    process.off(\"SIGTERM\", onSignal);\n    try {\n      await hide();\n    } catch (error) {\n      console.error(`lynx hide during shutdown failed: ${String(error)}`);\n    }\n    await connection.close();\n    resolveClosed?.();\n  };\n\n  const handleMenuClick = async (itemId: number): Promise<void> => {\n    switch (itemId) {\n      case 1:\n        await show();\n        return;\n      case 2:\n        await hide();\n        return;\n      case 99:\n        console.log(\"quit item routed; closing lynx smoke connection\");\n        await shutdown();\n        return;\n      default:\n        return;\n    }\n  };\n\n  connection.onEvent((frame) => {\n    console.log(`broker -> client ${JSON.stringify(frame)}`);\n    if (frame.type === \"event\" && frame.event.type === \"menuClick\") {\n      console.log(\n        `menu click: ${menuLabels.get(frame.event.itemId) ?? frame.event.itemId}`,\n      );\n      void handleMenuClick(frame.event.itemId);\n      return;\n    }\n    if (frame.type === \"ext-event\" && frame.ext === \"lynx\") {\n      console.log(`lynx event: ${JSON.stringify(frame.data)}`);\n    }\n  });\n\n  const onSignal = (): void => {\n    void shutdown();\n  };\n  process.on(\"SIGINT\", onSignal);\n  process.on(\"SIGTERM\", onSignal);\n\n  const exitAfter = process.env.OPENTRAY_EXAMPLE_EXIT_AFTER_MS;\n  if (exitAfter !== undefined && exitAfter.length > 0) {\n    const duration = Number.parseInt(exitAfter, 10);\n    if (Number.isInteger(duration) && duration > 0) {\n      exitTimer = setTimeout(() => {\n        void shutdown();\n      }, duration);\n    }\n  }\n\n  try {\n    await show();\n    console.log(\n      `use the tray menu to re-show or hide the window, or press Ctrl+C to exit; features=${describeLynxHostFeatures(\n        hostFeatures,\n      )}`,\n    );\n  } catch (error) {\n    await connection.close();\n    process.off(\"SIGINT\", onSignal);\n    process.off(\"SIGTERM\", onSignal);\n    throw error;\n  }\n\n  await new Promise<void>((resolve) => {\n    resolveClosed = resolve;\n  });\n};\n\nexport const resolveLynxBundlePath = (value?: string): string => {\n  const resolved = value ?? process.env[DEFAULT_LYNX_BUNDLE_ENV];\n  if (resolved === undefined || resolved.length === 0) {\n    const bundledReviewBundle = resolveBundledReviewBundlePath();\n    if (!existsSync(bundledReviewBundle)) {\n      throw new Error(\n        `lynx smoke requires --bundle <path>, ${DEFAULT_LYNX_BUNDLE_ENV}=<path-to-main.lynx.bundle>, or a packaged review bundle at ${bundledReviewBundle}`,\n      );\n    }\n    return realpathSync(bundledReviewBundle);\n  }\n  const baseDir = process.env.INIT_CWD ?? process.cwd();\n  const absolutePath = resolve(baseDir, resolved);\n  if (!existsSync(absolutePath)) {\n    throw new Error(`lynx smoke bundle does not exist: ${absolutePath}`);\n  }\n  return realpathSync(absolutePath);\n};\n\nexport const resolveLynxHostFeatures = (\n  expression = process.env[DEFAULT_LYNX_HOST_FEATURES_ENV] ?? \"\",\n): LynxHostFeatureState => {\n  const features = createEmptyLynxHostFeatures();\n  for (const rawToken of expression.split(\",\")) {\n    const token = rawToken.trim();\n    if (token.length === 0) {\n      continue;\n    }\n    applyLynxHostFeatureToken(features, token);\n  }\n  return features;\n};\n\nexport const createLynxShowCommand = ({\n  bundlePath,\n  hostFeatures,\n}: {\n  bundlePath: string;\n  hostFeatures: LynxHostFeatureState;\n}): LynxSmokeShowCommand => {\n  const command: LynxSmokeShowCommand = {\n    type: \"show\",\n    bundlePath,\n    width: 720,\n    height: 420,\n    minWidth: 320,\n    minHeight: 220,\n    maxWidth: 960,\n    maxHeight: 720,\n    nativeWindowApi: hostFeatures.nativeWindowApi,\n    bindWindowGlobals: hostFeatures.bindWindowGlobals,\n    nativeScreenApi: hostFeatures.nativeScreenApi,\n    bindScreenGlobals: hostFeatures.bindScreenGlobals,\n    title: `OpenTray Lynx Smoke (${describeLynxHostFeatures(hostFeatures)})`,\n    icon: createVisibleIcon(),\n  };\n  if (hostFeatures.frameless) {\n    command.style = { frameless: true };\n  }\n  return command;\n};\n\nexport const describeLynxHostFeatures = (\n  features: LynxHostFeatureState,\n): string => {\n  const enabled = LYNX_HOST_FEATURES.filter((feature) => features[feature]);\n  return enabled.length === 0 ? \"baseline\" : enabled.join(\",\");\n};\n\nexport const resolveBundledReviewBundlePath = (\n  moduleUrl = import.meta.url,\n): string => {\n  let currentDir = dirname(fileURLToPath(moduleUrl));\n\n  while (true) {\n    const packageJson = join(currentDir, \"package.json\");\n    if (existsSync(packageJson)) {\n      return join(currentDir, DEFAULT_REVIEW_BUNDLE_RELATIVE_PATH);\n    }\n\n    const parent = dirname(currentDir);\n    if (parent === currentDir) {\n      throw new Error(`failed to resolve opentray package root from ${moduleUrl}`);\n    }\n    currentDir = parent;\n  }\n};\n\nfunction createEmptyLynxHostFeatures(): LynxHostFeatureState {\n  return {\n    nativeWindowApi: false,\n    bindWindowGlobals: false,\n    nativeScreenApi: false,\n    bindScreenGlobals: false,\n    frameless: false,\n  };\n}\n\nfunction applyLynxHostFeatureToken(\n  features: LynxHostFeatureState,\n  rawToken: string,\n): void {\n  const disabled = rawToken.startsWith(\"!\");\n  const token = disabled ? rawToken.slice(1) : rawToken;\n\n  if (token === \"*\" || token === \"full\") {\n    for (const feature of LYNX_HOST_FEATURES) {\n      features[feature] = !disabled;\n    }\n    return;\n  }\n  if (token === \"baseline\") {\n    for (const feature of LYNX_HOST_FEATURES) {\n      features[feature] = false;\n    }\n    return;\n  }\n  if (!isLynxHostFeature(token)) {\n    throw new Error(\n      `unsupported Lynx host feature token: ${rawToken}; supported tokens: baseline, full, *, !<feature>, ${LYNX_HOST_FEATURES.join(\n        \", \",\n      )}`,\n    );\n  }\n  features[token] = !disabled;\n  if (token === \"nativeWindowApi\" && disabled) {\n    features.bindWindowGlobals = false;\n    return;\n  }\n  if (token === \"nativeScreenApi\" && disabled) {\n    features.bindScreenGlobals = false;\n    return;\n  }\n  if (token === \"bindWindowGlobals\" && !disabled) {\n    features.nativeWindowApi = true;\n    return;\n  }\n  if (token === \"bindScreenGlobals\" && !disabled) {\n    features.nativeScreenApi = true;\n  }\n}\n\nfunction isLynxHostFeature(value: string): value is LynxHostFeature {\n  return (LYNX_HOST_FEATURES as readonly string[]).includes(value);\n}\n\nfunction createVisibleIcon(): {\n  type: \"rgba\";\n  width: number;\n  height: number;\n  data: number[];\n} {\n  const width = 32;\n  const height = 32;\n  const data: number[] = [];\n\n  for (let y = 0; y < height; y += 1) {\n    for (let x = 0; x < width; x += 1) {\n      const inStroke = x <= 5 || (x >= 13 && x <= 18) || y >= 26;\n      const inDiagonal = y >= x + 10 && x <= 18;\n      const alpha = inStroke || inDiagonal ? 255 : 0;\n      data.push(34, 92, 56, alpha);\n    }\n  }\n\n  return { type: \"rgba\", width, height, data };\n}\n","import type { Rect } from \"@opentray/spec\";\n\nimport { createClient } from \"../client\";\nimport { connectLocalBroker } from \"../local-broker\";\n\nconst menuLabels = new Map<number, string>([\n  [1, \"Open WebView\"],\n]);\n\ninterface WebviewShowCommand {\n  type: \"show\";\n  html?: string;\n  url?: string;\n  width?: number;\n  height?: number;\n  fallbackRect?: Rect;\n  nativeWindowApi?: boolean;\n  bindWindowGlobals?: boolean;\n  nativeScreenApi?: boolean;\n  bindScreenGlobals?: boolean;\n  nativeTrayApi?: boolean;\n  title?: string;\n  icon?: { type: \"href\"; href: string };\n  style?: {\n    frameless?: boolean;\n    transparent?: boolean;\n    keepOnTop?: boolean;\n    platform?: {\n      macos?: {\n        material?: string | null;\n        materialState?: \"followsWindowActiveState\" | \"active\" | \"inactive\";\n        cornerRadius?: number | null;\n      };\n    };\n  };\n  titleSync?: boolean | { documentToWindow?: boolean; windowToDocument?: boolean };\n  iconSync?: boolean | { faviconToWindow?: boolean; windowToFavicon?: boolean };\n  nativeApiPolicy?: {\n    defaultSrc?: string[];\n    window?: string[];\n    screen?: string[];\n    tray?: string[];\n    windowGlobals?: string[];\n    screenGlobals?: string[];\n    titleSync?: string[];\n    iconSync?: string[];\n  };\n}\n\nexport const runDaemonTraySmoke = async (): Promise<void> => {\n  const connection = await connectLocalBroker();\n  const client = createClient(connection, { requestIdPrefix: \"daemon-smoke\" });\n  console.log(`connected: endpoint=${connection.endpoint} session=${connection.sessionId}`);\n\n  const space = await client.createSpace({\n    id: \"com.example.opentray.daemon-smoke\",\n    title: \"OpenTray Daemon Smoke\",\n    default: true,\n  });\n  console.log(`space: ${JSON.stringify(space.space)}`);\n\n  const tray = await space.createTray({\n    trayId: \"daemon-smoke-status\",\n    title: \"OpenTray\",\n    tooltip: {\n      title: \"OpenTray\",\n      description: \"Single primary tray action; macOS direct-triggers without opening a menu\",\n    },\n    icon: createVisibleIcon(),\n    menu: {\n      items: [\n        { type: \"item\", id: 1, title: \"Open WebView\", primaryEvent: true },\n      ],\n    },\n  });\n  console.log(`tray: ${tray.trayId}`);\n\n  await connection.request({\n    type: \"load-ext\",\n    requestId: \"daemon-smoke-load-webview\",\n    spaceId: space.space.spaceId,\n    name: \"webview\",\n    path: \"@opentray/ext-webview\",\n  });\n  console.log(\"webview extension requested through the generic load-ext path\");\n  console.log(\"click the tray icon: macOS should direct-trigger the single primary action without opening a menu\");\n\n  let closed = false;\n  let exitTimer: NodeJS.Timeout | undefined;\n\n  const shutdown = async (): Promise<void> => {\n    if (closed) {\n      return;\n    }\n    closed = true;\n    if (exitTimer !== undefined) {\n      clearTimeout(exitTimer);\n    }\n    await connection.close();\n  };\n\n  const commandWebview = async (command: WebviewShowCommand | Record<string, unknown>): Promise<void> => {\n    await tray.commandExtension(\"webview\", command);\n  };\n\n  const handleMenuClick = async (itemId: number): Promise<void> => {\n    if (itemId === 1) {\n      const trayBounds = await tray.getBounds();\n      console.log(`tray bounds: ${JSON.stringify(trayBounds)}`);\n      await commandWebview({\n        type: \"show\",\n        html: createWebviewDemoHtml(),\n        width: 420,\n        height: 260,\n        title: \"OpenTray WebView Smoke\",\n        icon: {\n          type: \"href\",\n          href: \"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO+/p9sAAAAASUVORK5CYII=\",\n        },\n        style: {\n          frameless: true,\n          transparent: true,\n          keepOnTop: true,\n          platform: {\n            macos: {\n              material: \"hudWindow\",\n              materialState: \"active\",\n            },\n          },\n        },\n        fallbackRect: trayBounds.rect ?? { x: 0, y: 0, width: 1, height: 1 },\n        nativeWindowApi: true,\n        bindWindowGlobals: true,\n        nativeScreenApi: true,\n        bindScreenGlobals: true,\n        nativeTrayApi: true,\n        titleSync: {\n          documentToWindow: true,\n          windowToDocument: true,\n        },\n        iconSync: true,\n        nativeApiPolicy: {\n          defaultSrc: [\"'local'\"],\n          window: [\"https://example.com\"],\n          screen: [\"https://example.com\"],\n          tray: [\"https://example.com\"],\n          titleSync: [\"https://example.com\"],\n          iconSync: [\"https://example.com\"],\n        },\n      });\n      console.log(\"primary tray action: webview show\");\n      return;\n    }\n  };\n\n  connection.onEvent((frame) => {\n    console.log(`broker -> client ${JSON.stringify(frame)}`);\n    if (frame.type === \"event\" && frame.event.type === \"menuClick\") {\n      console.log(`menu click: ${menuLabels.get(frame.event.itemId) ?? frame.event.itemId}`);\n      void handleMenuClick(frame.event.itemId);\n    }\n  });\n\n  const exitAfter = process.env.OPENTRAY_EXAMPLE_EXIT_AFTER_MS;\n  if (exitAfter !== undefined && exitAfter.length > 0) {\n    const duration = Number.parseInt(exitAfter, 10);\n    if (Number.isInteger(duration) && duration > 0) {\n      exitTimer = setTimeout(() => {\n        void shutdown();\n      }, duration);\n    }\n  }\n\n  const webviewSmoke = process.env.OPENTRAY_EXAMPLE_WEBVIEW_SMOKE;\n  try {\n    if (webviewSmoke === \"show\" || webviewSmoke === \"1\") {\n      await handleMenuClick(1);\n    }\n    if (webviewSmoke === \"1\") {\n      if (exitTimer !== undefined) {\n        clearTimeout(exitTimer);\n        exitTimer = undefined;\n      }\n      await sleep(300);\n      await shutdown();\n    }\n  } catch (error) {\n    await shutdown();\n    throw error;\n  }\n};\n\nfunction createVisibleIcon(): { type: \"rgba\"; width: number; height: number; data: number[] } {\n  const width = 32;\n  const height = 32;\n  const data: number[] = [];\n\n  for (let y = 0; y < height; y += 1) {\n    for (let x = 0; x < width; x += 1) {\n      const dx = x - 15.5;\n      const dy = y - 15.5;\n      const distance = Math.sqrt(dx * dx + dy * dy);\n      const inRing = distance >= 9 && distance <= 14;\n      const inCore = distance <= 5;\n      const inNeedle = Math.abs(dx + dy) <= 1.2 && x >= 9 && x <= 23 && y >= 9 && y <= 23;\n\n      if (inRing || inCore || inNeedle) {\n        data.push(inCore ? 255 : 24, inNeedle ? 240 : 132, inRing ? 72 : 96, 255);\n      } else {\n        data.push(0, 0, 0, 0);\n      }\n    }\n  }\n\n  return { type: \"rgba\", width, height, data };\n}\n\nfunction createWebviewDemoHtml(): string {\n  return `<!doctype html>\n<html lang=\"en\">\n  <head>\n    <meta charset=\"utf-8\" />\n    <title>OpenTray WebView</title>\n    <style>\n      :root {\n        color: #18220f;\n        background: #f6edd8;\n        font: 15px ui-rounded, \"SF Pro Rounded\", \"Avenir Next\", sans-serif;\n      }\n      body {\n        margin: 0;\n      }\n      main {\n        min-height: 100vh;\n        box-sizing: border-box;\n        padding: 22px;\n        background:\n          radial-gradient(circle at 84% 10%, rgba(34, 132, 96, 0.22), transparent 34%),\n          linear-gradient(135deg, #fff8e7 0%, #e9f0d8 100%);\n      }\n      h1 {\n        margin: 0 0 8px;\n        font-size: 24px;\n        letter-spacing: -0.04em;\n      }\n      p {\n        margin: 0 0 16px;\n        color: #526044;\n      }\n      section {\n        display: grid;\n        gap: 10px;\n      }\n      .card {\n        border: 1px solid rgba(24, 34, 15, 0.16);\n        border-radius: 14px;\n        padding: 12px;\n        background: rgba(255, 255, 255, 0.72);\n        box-shadow: 0 12px 30px rgba(56, 72, 36, 0.12);\n      }\n      .label {\n        margin-bottom: 5px;\n        color: #7b5b1d;\n        font-size: 12px;\n        font-weight: 700;\n        letter-spacing: 0.08em;\n        text-transform: uppercase;\n      }\n      code {\n        word-break: break-word;\n      }\n    </style>\n  </head>\n  <body>\n    <main>\n      <h1>OpenTray WebView</h1>\n      <p>This window was opened by the single primary tray action.</p>\n      <section>\n        <div class=\"card\">\n          <div class=\"label\">primary event</div>\n          <code>macOS single primary item direct-triggered menuClick -> WebView show</code>\n        </div>\n      </section>\n    </main>\n  </body>\n</html>`;\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n","#!/usr/bin/env node\nimport { realpathSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { fileURLToPath } from \"node:url\";\n\nimport type { DaemonHealth } from \"@opentray/spec\";\n\nimport {\n  createNodeDaemonDriver,\n  inspectDaemon,\n  restartDaemon,\n  startDaemon,\n  stopDaemon,\n} from \"./daemon/lifecycle\";\nimport { readPackageVersion } from \"./daemon/package-version\";\nimport { resolveDaemonPaths } from \"./daemon/paths\";\nimport { connectLocalBroker } from \"./local-broker\";\nimport { runDaemonLynxSmoke } from \"./smoke/daemon-lynx\";\nimport { runDaemonTraySmoke } from \"./smoke/daemon-tray\";\n\nconst packageJsonUrl = new URL(\"../package.json\", import.meta.url);\nconst cliModulePath = fileURLToPath(import.meta.url);\n\ntype CliCommand =\n  | { type: \"daemon\"; action: \"start\" | \"stop\" | \"restart\" | \"health\" }\n  | { type: \"smoke\"; name: \"daemon-tray\" }\n  | {\n      type: \"smoke\";\n      name: \"daemon-lynx\";\n      bundlePath?: string;\n      featureExpression?: string;\n    }\n  | { type: \"help\" };\n\nexport const parseCliCommand = (argv: string[]): CliCommand => {\n  const [group, action, ...rest] = argv;\n  if (group !== \"daemon\") {\n    if (group === \"smoke\" && action === \"daemon-tray\") {\n      return { type: \"smoke\", name: \"daemon-tray\" };\n    }\n    if (group === \"smoke\" && action === \"daemon-lynx\") {\n      const smokeOptions = parseSmokeOptions(rest);\n      return {\n        type: \"smoke\",\n        name: \"daemon-lynx\",\n        ...(smokeOptions.bundlePath\n          ? { bundlePath: smokeOptions.bundlePath }\n          : {}),\n        ...(smokeOptions.featureExpression\n          ? { featureExpression: smokeOptions.featureExpression }\n          : {}),\n      };\n    }\n    return { type: \"help\" };\n  }\n  if (\n    action === \"start\" ||\n    action === \"stop\" ||\n    action === \"restart\" ||\n    action === \"health\"\n  ) {\n    return { type: \"daemon\", action };\n  }\n\n  return { type: \"help\" };\n};\n\nexport const runCli = async (argv: string[]): Promise<number> => {\n  const command = parseCliCommand(argv);\n  const packageVersion =\n    process.env.OPENTRAY_DAEMON_PACKAGE_VERSION ??\n    (await readPackageVersion(packageJsonUrl));\n  const paths = resolveDaemonPaths({\n    homeDir: process.env.OPENTRAY_HOME ?? homedir(),\n    packageVersion,\n  });\n\n  if (command.type === \"help\") {\n    printHelp();\n    return 1;\n  }\n\n  if (command.type === \"smoke\") {\n    if (command.name === \"daemon-tray\") {\n      await runDaemonTraySmoke();\n    } else {\n      await runDaemonLynxSmoke(\n        {\n          ...(command.bundlePath === undefined\n            ? {}\n            : { bundlePath: command.bundlePath }),\n          ...(command.featureExpression === undefined\n            ? {}\n            : { featureExpression: command.featureExpression }),\n        }\n      );\n    }\n    return 0;\n  }\n\n  const driver = createNodeDaemonDriver(cliModulePath);\n\n  if (command.action === \"start\") {\n    const result = await startDaemon({ paths, driver });\n    console.log(\n      `opentray daemon ${result.status}: pid=${result.pid} endpoint=${result.paths.endpoint}`\n    );\n    return 0;\n  }\n\n  if (command.action === \"stop\") {\n    const result = await stopDaemon({ paths, driver });\n    console.log(\n      result.status === \"stopped\"\n        ? `opentray daemon stopped: pid=${result.pid}`\n        : \"opentray daemon not running\"\n    );\n    return 0;\n  }\n\n  if (command.action === \"restart\") {\n    const result = await restartDaemon({ paths, driver });\n    console.log(\n      `opentray daemon ${result.status}: pid=${result.pid} endpoint=${result.paths.endpoint}`\n    );\n    return 0;\n  }\n\n  if (command.action === \"health\") {\n    const inspected = await inspectDaemon({ paths, driver });\n    if (inspected.status === \"not-running\") {\n      console.log(\"opentray daemon not running\");\n      return 0;\n    }\n\n    const connection = await connectLocalBroker({\n      autoStart: false,\n      endpoint: paths.endpoint,\n      homeDir: paths.homeDir,\n      packageVersion,\n    });\n    try {\n      const response = await connection.request({\n        type: \"health\",\n        requestId: \"opentray-daemon-health\",\n      });\n      if (response.type !== \"daemon-health\") {\n        throw new Error(\n          `expected daemon-health response, received ${response.type}`\n        );\n      }\n      console.log(formatDaemonHealthOutput(response.health));\n    } finally {\n      await connection.close();\n    }\n    return 0;\n  }\n\n  printHelp();\n  return 1;\n};\n\nconst printHelp = (): void => {\n  console.error(\"Usage: opentray daemon <start|stop|restart|health>\");\n  console.error(\"       opentray smoke daemon-tray\");\n  console.error(\n    \"       opentray smoke daemon-lynx [--bundle <path-to-main.lynx.bundle>] [--features <baseline|full|*,!feature,...>]\"\n  );\n  console.error(\"       default Lynx smoke uses the packaged review bundle\");\n};\n\nexport const formatDaemonHealthOutput = (health: DaemonHealth): string => {\n  const lines = [\n    \"opentray daemon running\",\n    `pid: ${health.pid}`,\n    `endpoint: ${health.endpoint}`,\n    `packageVersion: ${health.packageVersion}`,\n    `protocolVersion: ${health.protocolVersion}`,\n    `sessions: ${health.sessionCount}`,\n  ];\n\n  for (const session of health.sessions) {\n    const internalLease = session.internalLeaseId ?? \"(pending)\";\n    lines.push(\n      `- sessionId=${session.sessionId} initialized=${session.initialized} internalLeaseId=${internalLease}`\n    );\n  }\n\n  return lines.join(\"\\n\");\n};\n\nexport const isCliEntrypoint = (\n  argvEntryPath: string | undefined,\n  modulePath: string\n): boolean => {\n  if (argvEntryPath === undefined) return false;\n  try {\n    return realpathSync(argvEntryPath) === realpathSync(modulePath);\n  } catch {\n    return argvEntryPath === modulePath;\n  }\n};\n\nfunction parseSmokeOptions(argv: string[]): {\n  bundlePath?: string;\n  featureExpression?: string;\n} {\n  let bundlePath: string | undefined;\n  let featureExpression: string | undefined;\n  for (let index = 0; index < argv.length; index += 1) {\n    if (argv[index] === \"--bundle\") {\n      bundlePath = argv[index + 1];\n      continue;\n    }\n    if (argv[index] === \"--features\") {\n      featureExpression = argv[index + 1];\n    }\n  }\n  return {\n    ...(bundlePath === undefined ? {} : { bundlePath }),\n    ...(featureExpression === undefined ? {} : { featureExpression }),\n  };\n}\n\nif (isCliEntrypoint(process.argv[1], cliModulePath)) {\n  runCli(process.argv.slice(2)).then((code) => {\n    process.exitCode = code;\n  });\n}\n"],"mappings":";;;;;;;;AAOA,MAAMA,eAAa,IAAI,IAAoB;CACzC,CAAC,GAAG,aAAa;CACjB,CAAC,GAAG,aAAa;CACjB,CAAC,IAAI,YAAY;AACnB,CAAC;AAED,MAAM,0BAA0B;AAChC,MAAM,iCAAiC;AACvC,MAAM,sCACJ;AACF,MAAM,qBAAqB;CACzB;CACA;CACA;CACA;CACA;AACF;AAqCA,MAAa,qBAAqB,OAChC,UAAkC,CAAC,MACjB;CAClB,MAAM,aAAa,sBAAsB,QAAQ,UAAU;CAC3D,MAAM,eAAe,wBAAwB,QAAQ,iBAAiB;CACtE,IAAI,QAAQ,IAAI,qBACd,QAAQ,IAAI,qBAAqB,QAAQ,IAAI,qBAAqB;CAEpE,IAAI,QAAQ,IAAI,iCACd,QAAQ,IACN,uBAAuB,QAAQ,IAAI,iCACrC;CAEF,IAAI,QAAQ,IAAI,8BACd,QAAQ,IACN,wBAAwB,QAAQ,IAAI,8BACtC;CAEF,MAAM,aAAa,MAAM,mBAAmB;CAC5C,MAAM,SAAS,aAAa,YAAY,EAAE,iBAAiB,cAAc,CAAC;CAC1E,QAAQ,IACN,uBAAuB,WAAW,SAAS,WAAW,WAAW,WACnE;CAEA,MAAM,QAAQ,MAAM,OAAO,YAAY;EACrC,IAAI;EACJ,OAAO;EACP,SAAS;CACX,CAAC;CACD,QAAQ,IAAI,UAAU,KAAK,UAAU,MAAM,KAAK,GAAG;CAEnD,MAAM,OAAO,MAAM,MAAM,WAAW;EAClC,QAAQ;EACR,OAAO;EACP,SAAS;GACP,OAAO;GACP,aAAa;EACf;EACA,MAAMC,oBAAkB;EACxB,MAAM,EACJ,OAAO;GACL;IAAE,MAAM;IAAQ,IAAI;IAAG,OAAO;GAAc;GAC5C;IAAE,MAAM;IAAQ,IAAI;IAAG,OAAO;GAAc;GAC5C,EAAE,MAAM,YAAY;GACpB;IAAE,MAAM;IAAQ,IAAI;IAAI,OAAO;GAAa;EAC9C,EACF;CACF,CAAC;CACD,QAAQ,IAAI,SAAS,KAAK,QAAQ;CAElC,MAAM,WAAW,QAAQ;EACvB,MAAM;EACN,WAAW;EACX,SAAS,MAAM,MAAM;EACrB,MAAM;EACN,MAAM;CACR,CAAC;CACD,QAAQ,IAAI,4DAA4D;CAExE,IAAI,SAAS;CACb,IAAI;CACJ,IAAI;CAEJ,MAAM,OAAO,YAA2B;EACtC,MAAM,UAAU,sBAAsB;GACpC;GACA;EACF,CAAC;EACD,MAAM,KAAK,iBAAiB,QAAQ,OAAO;EAC3C,QAAQ,IACN,+BAA+B,yBAC7B,YACF,EAAE,UAAU,YACd;CACF;CAEA,MAAM,OAAO,YAA2B;EACtC,MAAM,KAAK,iBAAiB,QAAQ,EAAE,MAAM,OAAO,CAAC;EACpD,QAAQ,IAAI,oBAAoB;CAClC;CAEA,MAAM,WAAW,YAA2B;EAC1C,IAAI,QACF;EAEF,SAAS;EACT,IAAI,cAAc,KAAA,GAChB,aAAa,SAAS;EAExB,QAAQ,IAAI,UAAU,QAAQ;EAC9B,QAAQ,IAAI,WAAW,QAAQ;EAC/B,IAAI;GACF,MAAM,KAAK;EACb,SAAS,OAAO;GACd,QAAQ,MAAM,qCAAqC,OAAO,KAAK,GAAG;EACpE;EACA,MAAM,WAAW,MAAM;EACvB,gBAAgB;CAClB;CAEA,MAAM,kBAAkB,OAAO,WAAkC;EAC/D,QAAQ,QAAR;GACE,KAAK;IACH,MAAM,KAAK;IACX;GACF,KAAK;IACH,MAAM,KAAK;IACX;GACF,KAAK;IACH,QAAQ,IAAI,iDAAiD;IAC7D,MAAM,SAAS;IACf;GACF,SACE;EACJ;CACF;CAEA,WAAW,SAAS,UAAU;EAC5B,QAAQ,IAAI,oBAAoB,KAAK,UAAU,KAAK,GAAG;EACvD,IAAI,MAAM,SAAS,WAAW,MAAM,MAAM,SAAS,aAAa;GAC9D,QAAQ,IACN,eAAeD,aAAW,IAAI,MAAM,MAAM,MAAM,KAAK,MAAM,MAAM,QACnE;GACA,gBAAqB,MAAM,MAAM,MAAM;GACvC;EACF;EACA,IAAI,MAAM,SAAS,eAAe,MAAM,QAAQ,QAC9C,QAAQ,IAAI,eAAe,KAAK,UAAU,MAAM,IAAI,GAAG;CAE3D,CAAC;CAED,MAAM,iBAAuB;EAC3B,SAAc;CAChB;CACA,QAAQ,GAAG,UAAU,QAAQ;CAC7B,QAAQ,GAAG,WAAW,QAAQ;CAE9B,MAAM,YAAY,QAAQ,IAAI;CAC9B,IAAI,cAAc,KAAA,KAAa,UAAU,SAAS,GAAG;EACnD,MAAM,WAAW,OAAO,SAAS,WAAW,EAAE;EAC9C,IAAI,OAAO,UAAU,QAAQ,KAAK,WAAW,GAC3C,YAAY,iBAAiB;GAC3B,SAAc;EAChB,GAAG,QAAQ;CAEf;CAEA,IAAI;EACF,MAAM,KAAK;EACX,QAAQ,IACN,sFAAsF,yBACpF,YACF,GACF;CACF,SAAS,OAAO;EACd,MAAM,WAAW,MAAM;EACvB,QAAQ,IAAI,UAAU,QAAQ;EAC9B,QAAQ,IAAI,WAAW,QAAQ;EAC/B,MAAM;CACR;CAEA,MAAM,IAAI,SAAe,YAAY;EACnC,gBAAgB;CAClB,CAAC;AACH;AAEA,MAAa,yBAAyB,UAA2B;CAC/D,MAAM,WAAW,SAAS,QAAQ,IAAI;CACtC,IAAI,aAAa,KAAA,KAAa,SAAS,WAAW,GAAG;EACnD,MAAM,sBAAsB,+BAA+B;EAC3D,IAAI,CAAC,WAAW,mBAAmB,GACjC,MAAM,IAAI,MACR,wCAAwC,wBAAwB,8DAA8D,qBAChI;EAEF,OAAO,aAAa,mBAAmB;CACzC;CAEA,MAAM,eAAe,QADL,QAAQ,IAAI,YAAY,QAAQ,IAAI,GACd,QAAQ;CAC9C,IAAI,CAAC,WAAW,YAAY,GAC1B,MAAM,IAAI,MAAM,qCAAqC,cAAc;CAErE,OAAO,aAAa,YAAY;AAClC;AAEA,MAAa,2BACX,aAAa,QAAQ,IAAI,mCAAmC,OACnC;CACzB,MAAM,WAAW,4BAA4B;CAC7C,KAAK,MAAM,YAAY,WAAW,MAAM,GAAG,GAAG;EAC5C,MAAM,QAAQ,SAAS,KAAK;EAC5B,IAAI,MAAM,WAAW,GACnB;EAEF,0BAA0B,UAAU,KAAK;CAC3C;CACA,OAAO;AACT;AAEA,MAAa,yBAAyB,EACpC,YACA,mBAI0B;CAC1B,MAAM,UAAgC;EACpC,MAAM;EACN;EACA,OAAO;EACP,QAAQ;EACR,UAAU;EACV,WAAW;EACX,UAAU;EACV,WAAW;EACX,iBAAiB,aAAa;EAC9B,mBAAmB,aAAa;EAChC,iBAAiB,aAAa;EAC9B,mBAAmB,aAAa;EAChC,OAAO,wBAAwB,yBAAyB,YAAY,EAAE;EACtE,MAAMC,oBAAkB;CAC1B;CACA,IAAI,aAAa,WACf,QAAQ,QAAQ,EAAE,WAAW,KAAK;CAEpC,OAAO;AACT;AAEA,MAAa,4BACX,aACW;CACX,MAAM,UAAU,mBAAmB,QAAQ,YAAY,SAAS,QAAQ;CACxE,OAAO,QAAQ,WAAW,IAAI,aAAa,QAAQ,KAAK,GAAG;AAC7D;AAEA,MAAa,kCACX,YAAY,OAAO,KAAK,QACb;CACX,IAAI,aAAa,QAAQ,cAAc,SAAS,CAAC;CAEjD,OAAO,MAAM;EAEX,IAAI,WADgB,KAAK,YAAY,cACZ,CAAC,GACxB,OAAO,KAAK,YAAY,mCAAmC;EAG7D,MAAM,SAAS,QAAQ,UAAU;EACjC,IAAI,WAAW,YACb,MAAM,IAAI,MAAM,gDAAgD,WAAW;EAE7E,aAAa;CACf;AACF;AAEA,SAAS,8BAAoD;CAC3D,OAAO;EACL,iBAAiB;EACjB,mBAAmB;EACnB,iBAAiB;EACjB,mBAAmB;EACnB,WAAW;CACb;AACF;AAEA,SAAS,0BACP,UACA,UACM;CACN,MAAM,WAAW,SAAS,WAAW,GAAG;CACxC,MAAM,QAAQ,WAAW,SAAS,MAAM,CAAC,IAAI;CAE7C,IAAI,UAAU,OAAO,UAAU,QAAQ;EACrC,KAAK,MAAM,WAAW,oBACpB,SAAS,WAAW,CAAC;EAEvB;CACF;CACA,IAAI,UAAU,YAAY;EACxB,KAAK,MAAM,WAAW,oBACpB,SAAS,WAAW;EAEtB;CACF;CACA,IAAI,CAAC,kBAAkB,KAAK,GAC1B,MAAM,IAAI,MACR,wCAAwC,SAAS,qDAAqD,mBAAmB,KACvH,IACF,GACF;CAEF,SAAS,SAAS,CAAC;CACnB,IAAI,UAAU,qBAAqB,UAAU;EAC3C,SAAS,oBAAoB;EAC7B;CACF;CACA,IAAI,UAAU,qBAAqB,UAAU;EAC3C,SAAS,oBAAoB;EAC7B;CACF;CACA,IAAI,UAAU,uBAAuB,CAAC,UAAU;EAC9C,SAAS,kBAAkB;EAC3B;CACF;CACA,IAAI,UAAU,uBAAuB,CAAC,UACpC,SAAS,kBAAkB;AAE/B;AAEA,SAAS,kBAAkB,OAAyC;CAClE,OAAQ,mBAAyC,SAAS,KAAK;AACjE;AAEA,SAASA,sBAKP;CACA,MAAM,QAAQ;CACd,MAAM,SAAS;CACf,MAAM,OAAiB,CAAC;CAExB,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,KAAK,GAC/B,KAAK,IAAI,IAAI,GAAG,IAAI,OAAO,KAAK,GAAG;EACjC,MAAM,WAAW,KAAK,KAAM,KAAK,MAAM,KAAK,MAAO,KAAK;EACxD,MAAM,aAAa,KAAK,IAAI,MAAM,KAAK;EACvC,MAAM,QAAQ,YAAY,aAAa,MAAM;EAC7C,KAAK,KAAK,IAAI,IAAI,IAAI,KAAK;CAC7B;CAGF,OAAO;EAAE,MAAM;EAAQ;EAAO;EAAQ;CAAK;AAC7C;;;ACnYA,MAAM,aAAa,IAAI,IAAoB,CACzC,CAAC,GAAG,cAAc,CACpB,CAAC;AA0CD,MAAa,qBAAqB,YAA2B;CAC3D,MAAM,aAAa,MAAM,mBAAmB;CAC5C,MAAM,SAAS,aAAa,YAAY,EAAE,iBAAiB,eAAe,CAAC;CAC3E,QAAQ,IAAI,uBAAuB,WAAW,SAAS,WAAW,WAAW,WAAW;CAExF,MAAM,QAAQ,MAAM,OAAO,YAAY;EACrC,IAAI;EACJ,OAAO;EACP,SAAS;CACX,CAAC;CACD,QAAQ,IAAI,UAAU,KAAK,UAAU,MAAM,KAAK,GAAG;CAEnD,MAAM,OAAO,MAAM,MAAM,WAAW;EAClC,QAAQ;EACR,OAAO;EACP,SAAS;GACP,OAAO;GACP,aAAa;EACf;EACA,MAAM,kBAAkB;EACxB,MAAM,EACJ,OAAO,CACL;GAAE,MAAM;GAAQ,IAAI;GAAG,OAAO;GAAgB,cAAc;EAAK,CACnE,EACF;CACF,CAAC;CACD,QAAQ,IAAI,SAAS,KAAK,QAAQ;CAElC,MAAM,WAAW,QAAQ;EACvB,MAAM;EACN,WAAW;EACX,SAAS,MAAM,MAAM;EACrB,MAAM;EACN,MAAM;CACR,CAAC;CACD,QAAQ,IAAI,+DAA+D;CAC3E,QAAQ,IAAI,mGAAmG;CAE/G,IAAI,SAAS;CACb,IAAI;CAEJ,MAAM,WAAW,YAA2B;EAC1C,IAAI,QACF;EAEF,SAAS;EACT,IAAI,cAAc,KAAA,GAChB,aAAa,SAAS;EAExB,MAAM,WAAW,MAAM;CACzB;CAEA,MAAM,iBAAiB,OAAO,YAAyE;EACrG,MAAM,KAAK,iBAAiB,WAAW,OAAO;CAChD;CAEA,MAAM,kBAAkB,OAAO,WAAkC;EAC/D,IAAI,WAAW,GAAG;GAChB,MAAM,aAAa,MAAM,KAAK,UAAU;GACxC,QAAQ,IAAI,gBAAgB,KAAK,UAAU,UAAU,GAAG;GACxD,MAAM,eAAe;IACnB,MAAM;IACN,MAAM,sBAAsB;IAC5B,OAAO;IACP,QAAQ;IACR,OAAO;IACP,MAAM;KACJ,MAAM;KACN,MAAM;IACR;IACA,OAAO;KACL,WAAW;KACX,aAAa;KACb,WAAW;KACX,UAAU,EACR,OAAO;MACL,UAAU;MACV,eAAe;KACjB,EACF;IACF;IACA,cAAc,WAAW,QAAQ;KAAE,GAAG;KAAG,GAAG;KAAG,OAAO;KAAG,QAAQ;IAAE;IACnE,iBAAiB;IACjB,mBAAmB;IACnB,iBAAiB;IACjB,mBAAmB;IACnB,eAAe;IACf,WAAW;KACT,kBAAkB;KAClB,kBAAkB;IACpB;IACA,UAAU;IACV,iBAAiB;KACf,YAAY,CAAC,SAAS;KACtB,QAAQ,CAAC,qBAAqB;KAC9B,QAAQ,CAAC,qBAAqB;KAC9B,MAAM,CAAC,qBAAqB;KAC5B,WAAW,CAAC,qBAAqB;KACjC,UAAU,CAAC,qBAAqB;IAClC;GACF,CAAC;GACD,QAAQ,IAAI,mCAAmC;GAC/C;EACF;CACF;CAEA,WAAW,SAAS,UAAU;EAC5B,QAAQ,IAAI,oBAAoB,KAAK,UAAU,KAAK,GAAG;EACvD,IAAI,MAAM,SAAS,WAAW,MAAM,MAAM,SAAS,aAAa;GAC9D,QAAQ,IAAI,eAAe,WAAW,IAAI,MAAM,MAAM,MAAM,KAAK,MAAM,MAAM,QAAQ;GACrF,gBAAqB,MAAM,MAAM,MAAM;EACzC;CACF,CAAC;CAED,MAAM,YAAY,QAAQ,IAAI;CAC9B,IAAI,cAAc,KAAA,KAAa,UAAU,SAAS,GAAG;EACnD,MAAM,WAAW,OAAO,SAAS,WAAW,EAAE;EAC9C,IAAI,OAAO,UAAU,QAAQ,KAAK,WAAW,GAC3C,YAAY,iBAAiB;GAC3B,SAAc;EAChB,GAAG,QAAQ;CAEf;CAEA,MAAM,eAAe,QAAQ,IAAI;CACjC,IAAI;EACF,IAAI,iBAAiB,UAAU,iBAAiB,KAC9C,MAAM,gBAAgB,CAAC;EAEzB,IAAI,iBAAiB,KAAK;GACxB,IAAI,cAAc,KAAA,GAAW;IAC3B,aAAa,SAAS;IACtB,YAAY,KAAA;GACd;GACA,MAAM,MAAM,GAAG;GACf,MAAM,SAAS;EACjB;CACF,SAAS,OAAO;EACd,MAAM,SAAS;EACf,MAAM;CACR;AACF;AAEA,SAAS,oBAAqF;CAC5F,MAAM,QAAQ;CACd,MAAM,SAAS;CACf,MAAM,OAAiB,CAAC;CAExB,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,KAAK,GAC/B,KAAK,IAAI,IAAI,GAAG,IAAI,OAAO,KAAK,GAAG;EACjC,MAAM,KAAK,IAAI;EACf,MAAM,KAAK,IAAI;EACf,MAAM,WAAW,KAAK,KAAK,KAAK,KAAK,KAAK,EAAE;EAC5C,MAAM,SAAS,YAAY,KAAK,YAAY;EAC5C,MAAM,SAAS,YAAY;EAC3B,MAAM,WAAW,KAAK,IAAI,KAAK,EAAE,KAAK,OAAO,KAAK,KAAK,KAAK,MAAM,KAAK,KAAK,KAAK;EAEjF,IAAI,UAAU,UAAU,UACtB,KAAK,KAAK,SAAS,MAAM,IAAI,WAAW,MAAM,KAAK,SAAS,KAAK,IAAI,GAAG;OAExE,KAAK,KAAK,GAAG,GAAG,GAAG,CAAC;CAExB;CAGF,OAAO;EAAE,MAAM;EAAQ;EAAO;EAAQ;CAAK;AAC7C;AAEA,SAAS,wBAAgC;CACvC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoET;AAEA,SAAS,MAAM,IAA2B;CACxC,OAAO,IAAI,SAAS,YAAY,WAAW,SAAS,EAAE,CAAC;AACzD;;;AC9QA,MAAM,iBAAiB,IAAI,IAAI,mBAAmB,OAAO,KAAK,GAAG;AACjE,MAAM,gBAAgB,cAAc,OAAO,KAAK,GAAG;AAanD,MAAa,mBAAmB,SAA+B;CAC7D,MAAM,CAAC,OAAO,QAAQ,GAAG,QAAQ;CACjC,IAAI,UAAU,UAAU;EACtB,IAAI,UAAU,WAAW,WAAW,eAClC,OAAO;GAAE,MAAM;GAAS,MAAM;EAAc;EAE9C,IAAI,UAAU,WAAW,WAAW,eAAe;GACjD,MAAM,eAAe,kBAAkB,IAAI;GAC3C,OAAO;IACL,MAAM;IACN,MAAM;IACN,GAAI,aAAa,aACb,EAAE,YAAY,aAAa,WAAW,IACtC,CAAC;IACL,GAAI,aAAa,oBACb,EAAE,mBAAmB,aAAa,kBAAkB,IACpD,CAAC;GACP;EACF;EACA,OAAO,EAAE,MAAM,OAAO;CACxB;CACA,IACE,WAAW,WACX,WAAW,UACX,WAAW,aACX,WAAW,UAEX,OAAO;EAAE,MAAM;EAAU;CAAO;CAGlC,OAAO,EAAE,MAAM,OAAO;AACxB;AAEA,MAAa,SAAS,OAAO,SAAoC;CAC/D,MAAM,UAAU,gBAAgB,IAAI;CACpC,MAAM,iBACJ,QAAQ,IAAI,mCACX,MAAM,mBAAmB,cAAc;CAC1C,MAAM,QAAQ,mBAAmB;EAC/B,SAAS,QAAQ,IAAI,iBAAiB,QAAQ;EAC9C;CACF,CAAC;CAED,IAAI,QAAQ,SAAS,QAAQ;EAC3B,UAAU;EACV,OAAO;CACT;CAEA,IAAI,QAAQ,SAAS,SAAS;EAC5B,IAAI,QAAQ,SAAS,eACnB,MAAM,mBAAmB;OAEzB,MAAM,mBACJ;GACE,GAAI,QAAQ,eAAe,KAAA,IACvB,CAAC,IACD,EAAE,YAAY,QAAQ,WAAW;GACrC,GAAI,QAAQ,sBAAsB,KAAA,IAC9B,CAAC,IACD,EAAE,mBAAmB,QAAQ,kBAAkB;EACrD,CACF;EAEF,OAAO;CACT;CAEA,MAAM,SAAS,uBAAuB,aAAa;CAEnD,IAAI,QAAQ,WAAW,SAAS;EAC9B,MAAM,SAAS,MAAM,YAAY;GAAE;GAAO;EAAO,CAAC;EAClD,QAAQ,IACN,mBAAmB,OAAO,OAAO,QAAQ,OAAO,IAAI,YAAY,OAAO,MAAM,UAC/E;EACA,OAAO;CACT;CAEA,IAAI,QAAQ,WAAW,QAAQ;EAC7B,MAAM,SAAS,MAAM,WAAW;GAAE;GAAO;EAAO,CAAC;EACjD,QAAQ,IACN,OAAO,WAAW,YACd,gCAAgC,OAAO,QACvC,6BACN;EACA,OAAO;CACT;CAEA,IAAI,QAAQ,WAAW,WAAW;EAChC,MAAM,SAAS,MAAM,cAAc;GAAE;GAAO;EAAO,CAAC;EACpD,QAAQ,IACN,mBAAmB,OAAO,OAAO,QAAQ,OAAO,IAAI,YAAY,OAAO,MAAM,UAC/E;EACA,OAAO;CACT;CAEA,IAAI,QAAQ,WAAW,UAAU;EAE/B,KAAI,MADoB,cAAc;GAAE;GAAO;EAAO,CAAC,GACzC,WAAW,eAAe;GACtC,QAAQ,IAAI,6BAA6B;GACzC,OAAO;EACT;EAEA,MAAM,aAAa,MAAM,mBAAmB;GAC1C,WAAW;GACX,UAAU,MAAM;GAChB,SAAS,MAAM;GACf;EACF,CAAC;EACD,IAAI;GACF,MAAM,WAAW,MAAM,WAAW,QAAQ;IACxC,MAAM;IACN,WAAW;GACb,CAAC;GACD,IAAI,SAAS,SAAS,iBACpB,MAAM,IAAI,MACR,6CAA6C,SAAS,MACxD;GAEF,QAAQ,IAAI,yBAAyB,SAAS,MAAM,CAAC;EACvD,UAAU;GACR,MAAM,WAAW,MAAM;EACzB;EACA,OAAO;CACT;CAEA,UAAU;CACV,OAAO;AACT;AAEA,MAAM,kBAAwB;CAC5B,QAAQ,MAAM,oDAAoD;CAClE,QAAQ,MAAM,mCAAmC;CACjD,QAAQ,MACN,qHACF;CACA,QAAQ,MAAM,2DAA2D;AAC3E;AAEA,MAAa,4BAA4B,WAAiC;CACxE,MAAM,QAAQ;EACZ;EACA,QAAQ,OAAO;EACf,aAAa,OAAO;EACpB,mBAAmB,OAAO;EAC1B,oBAAoB,OAAO;EAC3B,aAAa,OAAO;CACtB;CAEA,KAAK,MAAM,WAAW,OAAO,UAAU;EACrC,MAAM,gBAAgB,QAAQ,mBAAmB;EACjD,MAAM,KACJ,eAAe,QAAQ,UAAU,eAAe,QAAQ,YAAY,mBAAmB,eACzF;CACF;CAEA,OAAO,MAAM,KAAK,IAAI;AACxB;AAEA,MAAa,mBACX,eACA,eACY;CACZ,IAAI,kBAAkB,KAAA,GAAW,OAAO;CACxC,IAAI;EACF,OAAO,aAAa,aAAa,MAAM,aAAa,UAAU;CAChE,QAAQ;EACN,OAAO,kBAAkB;CAC3B;AACF;AAEA,SAAS,kBAAkB,MAGzB;CACA,IAAI;CACJ,IAAI;CACJ,KAAK,IAAI,QAAQ,GAAG,QAAQ,KAAK,QAAQ,SAAS,GAAG;EACnD,IAAI,KAAK,WAAW,YAAY;GAC9B,aAAa,KAAK,QAAQ;GAC1B;EACF;EACA,IAAI,KAAK,WAAW,cAClB,oBAAoB,KAAK,QAAQ;CAErC;CACA,OAAO;EACL,GAAI,eAAe,KAAA,IAAY,CAAC,IAAI,EAAE,WAAW;EACjD,GAAI,sBAAsB,KAAA,IAAY,CAAC,IAAI,EAAE,kBAAkB;CACjE;AACF;AAEA,IAAI,gBAAgB,QAAQ,KAAK,IAAI,aAAa,GAChD,OAAO,QAAQ,KAAK,MAAM,CAAC,CAAC,EAAE,MAAM,SAAS;CAC3C,QAAQ,WAAW;AACrB,CAAC"}

package/dist/{client-h6gZdeOk.d.mts → client-DQn3DLZw.d.mts}

@@ -20,9 +20,34 @@ interface TrayHandle {
   space: SpaceRef;
   trayId: TrayId;
   getBounds(): Promise<TrayBoundsResult>;
+  loadExtension(options: ExtensionLoadOptions): Promise<void>;
   commandExtension(ext: string, data: unknown): Promise<void>;
+  extend<TCapability extends object, TOptions = undefined>(extension: TrayExtension<TCapability, TOptions>, options?: TOptions): TrayHandle & TCapability;
   destroy(): Promise<void>;
 }
+interface ExtensionLoadOptions {
+  name: string;
+  path: string;
+  mountId?: string;
+}
+interface TrayExtensionMountSpec {
+  name?: string;
+  path?: string;
+  mountId?: string;
+}
+interface TrayExtensionContext {
+  readonly name: string;
+  readonly path: string;
+  readonly mountId: string;
+  ensureLoaded(): Promise<void>;
+  command(data: unknown): Promise<void>;
+}
+interface TrayExtension<TCapability extends object, TOptions = undefined> {
+  readonly name: string;
+  readonly path: string;
+  resolveMount?(options: TOptions | undefined): TrayExtensionMountSpec;
+  extend(tray: TrayHandle, context: TrayExtensionContext, options: TOptions | undefined): TCapability;
+}
 declare const createInitFrame: (clientVersion: string) => ClientFrame;
 interface CreateClientOptions {
   requestIdPrefix?: string;
@@ -33,5 +58,5 @@ declare const createSpaceHandle: (transport: OpenTrayTransport, space: SpaceRef,
 declare const createSurfaceHandle: (transport: OpenTrayTransport, space: SpaceRef, nextRequestId?: () => RequestId) => SpaceHandle;
 declare const createTrayHandle: (transport: OpenTrayTransport, space: SpaceRef, trayId: TrayId, nextRequestId?: () => RequestId) => TrayHandle;
 //#endregion
-export { SurfaceHandle as a, createInitFrame as c, createTrayHandle as d, SpaceHandle as i, createSpaceHandle as l, OpenTrayClient as n, TrayHandle as o, OpenTrayTransport as r, createClient as s, CreateClientOptions as t, createSurfaceHandle as u };
-//# sourceMappingURL=client-h6gZdeOk.d.mts.map
+export { SpaceHandle as a, TrayExtensionContext as c, createClient as d, createInitFrame as f, createTrayHandle as h, OpenTrayTransport as i, TrayExtensionMountSpec as l, createSurfaceHandle as m, ExtensionLoadOptions as n, SurfaceHandle as o, createSpaceHandle as p, OpenTrayClient as r, TrayExtension as s, CreateClientOptions as t, TrayHandle as u };
+//# sourceMappingURL=client-DQn3DLZw.d.mts.map

package/dist/client-DQn3DLZw.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-DQn3DLZw.d.mts","names":[],"sources":["../src/client.ts"],"mappings":";;;UAaiB,iBAAA;EACf,OAAA,CAAQ,KAAA,EAAO,kBAAA,GAAqB,OAAA,CAAQ,WAAA;AAAA;AAAA,UAG7B,cAAA;EACf,WAAA,CAAY,OAAA,EAAS,YAAA,GAAe,OAAA,CAAQ,WAAA;EAC5C,mBAAA,IAAuB,OAAA,CAAQ,WAAA;EALa;EAO5C,aAAA,CAAc,OAAA,EAAS,YAAA,GAAe,OAAA,CAAQ,WAAA;AAAA;AAAA,UAG/B,WAAA;EACf,KAAA,EAAO,QAAA;EACP,UAAA,CAAW,OAAA,EAAS,WAAA,GAAc,OAAA,CAAQ,UAAA;AAAA;;KAIhC,aAAA,GAAgB,WAAW;AAAA,UAEtB,UAAA;EACf,KAAA,EAAO,QAAA;EACP,MAAA,EAAQ,MAAA;EACR,SAAA,IAAa,OAAA,CAAQ,gBAAA;EACrB,aAAA,CAAc,OAAA,EAAS,oBAAA,GAAuB,OAAA;EAC9C,gBAAA,CAAiB,GAAA,UAAa,IAAA,YAAgB,OAAA;EAC9C,MAAA,mDACE,SAAA,EAAW,aAAA,CAAc,WAAA,EAAa,QAAA,GACtC,OAAA,GAAU,QAAA,GACT,UAAA,GAAa,WAAA;EAChB,OAAA,IAAW,OAAA;AAAA;AAAA,UAGI,oBAAA;EACf,IAAA;EACA,IAAA;EACA,OAAA;AAAA;AAAA,UAGe,sBAAA;EACf,IAAA;EACA,IAAA;EACA,OAAA;AAAA;AAAA,UAGe,oBAAA;EAAA,SACN,IAAA;EAAA,SACA,IAAA;EAAA,SACA,OAAA;EACT,YAAA,IAAgB,OAAA;EAChB,OAAA,CAAQ,IAAA,YAAgB,OAAO;AAAA;AAAA,UAGhB,aAAA;EAAA,SACN,IAAA;EAAA,SACA,IAAA;EACT,YAAA,EAAc,OAAA,EAAS,QAAA,eAAuB,sBAAA;EAC9C,MAAA,CAAO,IAAA,EAAM,UAAA,EAAY,OAAA,EAAS,oBAAA,EAAsB,OAAA,EAAS,QAAA,eAAuB,WAAA;AAAA;AAAA,cAG7E,eAAA,GAAmB,aAAA,aAAwB,WAItD;AAAA,UAEe,mBAAA;EACf,eAAe;AAAA;AAAA,cAGJ,YAAA,GACX,SAAA,EAAW,iBAAA,EACX,OAAA,GAAS,mBAAA,KACR,cAAA;AAAA,cA6BU,iBAAA,GACX,SAAA,EAAW,iBAAA,EACX,KAAA,EAAO,QAAA,EACP,aAAA,SAAqB,SAAA,KACpB,WAAA;;cAgBU,mBAAA,GAAmB,SAAA,EAnBnB,iBAAA,EAAiB,KAAA,EACrB,QAAA,EAAQ,aAAA,SACM,SAAA,KACpB,WAAA;AAAA,cAkBU,gBAAA,GACX,SAAA,EAAW,iBAAA,EACX,KAAA,EAAO,QAAA,EACP,MAAA,EAAQ,MAAA,EACR,aAAA,SAAqB,SAAA,KACpB,UAAA"}

package/dist/{client-B_zxQOo5.mjs → client-DzcHIH-f.mjs}

@@ -44,39 +44,96 @@ const createSpaceHandle = (transport, space, nextRequestId = createRequestIdFact
 });
 /** @deprecated Use `createSpaceHandle`. */
 const createSurfaceHandle = createSpaceHandle;
-const createTrayHandle = (transport, space, trayId, nextRequestId = createRequestIdFactory("opentray")) => ({
-	space,
-	trayId,
-	async getBounds() {
-		const requestId = nextRequestId();
-		return expectResponse(await transport.request({
-			type: "get-tray-bounds",
-			requestId,
-			spaceId: space.spaceId,
-			trayId
-		}), requestId, "tray-bounds").bounds;
-	},
-	async commandExtension(ext, data) {
-		const requestId = nextRequestId();
-		expectResponse(await transport.request({
-			type: "ext-command",
-			requestId,
-			spaceId: space.spaceId,
-			trayId,
-			ext,
-			data
-		}), requestId, "ack");
-	},
-	async destroy() {
-		const requestId = nextRequestId();
-		expectResponse(await transport.request({
-			type: "destroy-tray",
-			requestId,
-			spaceId: space.spaceId,
-			trayId
-		}), requestId, "ack");
-	}
-});
+const createTrayHandle = (transport, space, trayId, nextRequestId = createRequestIdFactory("opentray")) => {
+	let nextMountOrdinal = 1;
+	const nextMountId = (extensionName) => {
+		const mountId = `${formatMountIdComponent(extensionName)}.${formatMountIdComponent(trayId)}.${nextMountOrdinal}`;
+		nextMountOrdinal += 1;
+		return mountId;
+	};
+	const handle = {
+		space,
+		trayId,
+		async getBounds() {
+			const requestId = nextRequestId();
+			return expectResponse(await transport.request({
+				type: "get-tray-bounds",
+				requestId,
+				spaceId: space.spaceId,
+				trayId
+			}), requestId, "tray-bounds").bounds;
+		},
+		async loadExtension(options) {
+			const requestId = nextRequestId();
+			expectResponse(await transport.request({
+				type: "load-ext",
+				requestId,
+				spaceId: space.spaceId,
+				name: options.name,
+				path: options.path,
+				...options.mountId === void 0 ? {} : { mountId: options.mountId }
+			}), requestId, "ack");
+		},
+		async commandExtension(ext, data) {
+			const requestId = nextRequestId();
+			expectResponse(await transport.request({
+				type: "ext-command",
+				requestId,
+				spaceId: space.spaceId,
+				trayId,
+				ext,
+				data
+			}), requestId, "ack");
+		},
+		extend(extension, options) {
+			const context = createTrayExtensionContext(handle, extension, options, nextMountId);
+			const capability = extension.extend(handle, context, options);
+			return Object.assign({}, handle, capability);
+		},
+		async destroy() {
+			const requestId = nextRequestId();
+			expectResponse(await transport.request({
+				type: "destroy-tray",
+				requestId,
+				spaceId: space.spaceId,
+				trayId
+			}), requestId, "ack");
+		}
+	};
+	return handle;
+};
+const createTrayExtensionContext = (tray, extension, options, nextMountId) => {
+	const mount = extension.resolveMount?.(options) ?? {};
+	const name = mount.name ?? extension.name;
+	const path = mount.path ?? extension.path;
+	const mountId = mount.mountId ?? nextMountId(name);
+	let loadPromise;
+	const ensureLoaded = async () => {
+		if (loadPromise === void 0) loadPromise = tray.loadExtension({
+			name,
+			path,
+			mountId
+		}).catch((error) => {
+			loadPromise = void 0;
+			throw error;
+		});
+		await loadPromise;
+	};
+	return {
+		name,
+		path,
+		mountId,
+		ensureLoaded,
+		async command(data) {
+			await ensureLoaded();
+			await tray.commandExtension(mountId, data);
+		}
+	};
+};
+const formatMountIdComponent = (value) => {
+	const formatted = value.replaceAll(/[^a-zA-Z0-9._+-]/g, "_");
+	return formatted.length > 0 ? formatted : "ext";
+};
 const createRequestIdFactory = (prefix) => {
 	let next = 1;
 	return () => {
@@ -108,4 +165,4 @@ const requestIdOf = (frame) => {
 //#endregion
 export { createTrayHandle as a, createSurfaceHandle as i, createInitFrame as n, createSpaceHandle as r, createClient as t };
 
-//# sourceMappingURL=client-B_zxQOo5.mjs.map
+//# sourceMappingURL=client-DzcHIH-f.mjs.map

package/dist/client-DzcHIH-f.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-DzcHIH-f.mjs","names":[],"sources":["../src/client.ts"],"sourcesContent":["import {\n  PROTOCOL_VERSION,\n  type ClientFrame,\n  type ClientRequestFrame,\n  type RequestId,\n  type ServerFrame,\n  type SpaceOptions,\n  type SpaceRef,\n  type TrayBoundsResult,\n  type TrayId,\n  type TrayOptions,\n} from \"@opentray/spec\";\n\nexport interface OpenTrayTransport {\n  request(frame: ClientRequestFrame): Promise<ServerFrame>;\n}\n\nexport interface OpenTrayClient {\n  createSpace(options: SpaceOptions): Promise<SpaceHandle>;\n  resolveDefaultSpace(): Promise<SpaceHandle>;\n  /** @deprecated Use `createSpace`. */\n  createSurface(options: SpaceOptions): Promise<SpaceHandle>;\n}\n\nexport interface SpaceHandle {\n  space: SpaceRef;\n  createTray(options: TrayOptions): Promise<TrayHandle>;\n}\n\n/** @deprecated Use `SpaceHandle`. */\nexport type SurfaceHandle = SpaceHandle;\n\nexport interface TrayHandle {\n  space: SpaceRef;\n  trayId: TrayId;\n  getBounds(): Promise<TrayBoundsResult>;\n  loadExtension(options: ExtensionLoadOptions): Promise<void>;\n  commandExtension(ext: string, data: unknown): Promise<void>;\n  extend<TCapability extends object, TOptions = undefined>(\n    extension: TrayExtension<TCapability, TOptions>,\n    options?: TOptions,\n  ): TrayHandle & TCapability;\n  destroy(): Promise<void>;\n}\n\nexport interface ExtensionLoadOptions {\n  name: string;\n  path: string;\n  mountId?: string;\n}\n\nexport interface TrayExtensionMountSpec {\n  name?: string;\n  path?: string;\n  mountId?: string;\n}\n\nexport interface TrayExtensionContext {\n  readonly name: string;\n  readonly path: string;\n  readonly mountId: string;\n  ensureLoaded(): Promise<void>;\n  command(data: unknown): Promise<void>;\n}\n\nexport interface TrayExtension<TCapability extends object, TOptions = undefined> {\n  readonly name: string;\n  readonly path: string;\n  resolveMount?(options: TOptions | undefined): TrayExtensionMountSpec;\n  extend(tray: TrayHandle, context: TrayExtensionContext, options: TOptions | undefined): TCapability;\n}\n\nexport const createInitFrame = (clientVersion: string): ClientFrame => ({\n  type: \"init\",\n  protocolVersion: PROTOCOL_VERSION,\n  clientVersion,\n});\n\nexport interface CreateClientOptions {\n  requestIdPrefix?: string;\n}\n\nexport const createClient = (\n  transport: OpenTrayTransport,\n  options: CreateClientOptions = {},\n): OpenTrayClient => {\n  const nextRequestId = createRequestIdFactory(options.requestIdPrefix ?? \"opentray\");\n\n  return {\n    async createSpace(spaceOptions): Promise<SpaceHandle> {\n      const requestId = nextRequestId();\n      const response = await transport.request({\n        type: \"create-space\",\n        requestId,\n        ...spaceOptions,\n      });\n      const space = expectResponse(response, requestId, \"space-created\").space;\n      return createSpaceHandle(transport, space, nextRequestId);\n    },\n    async resolveDefaultSpace(): Promise<SpaceHandle> {\n      const requestId = nextRequestId();\n      const response = await transport.request({\n        type: \"resolve-default-space\",\n        requestId,\n      });\n      const space = expectResponse(response, requestId, \"default-space\").space;\n      return createSpaceHandle(transport, space, nextRequestId);\n    },\n    async createSurface(spaceOptions): Promise<SpaceHandle> {\n      return this.createSpace(spaceOptions);\n    },\n  };\n};\n\nexport const createSpaceHandle = (\n  transport: OpenTrayTransport,\n  space: SpaceRef,\n  nextRequestId: () => RequestId = createRequestIdFactory(\"opentray\"),\n): SpaceHandle => ({\n  space,\n  async createTray(options: TrayOptions): Promise<TrayHandle> {\n    const requestId = nextRequestId();\n    const response = await transport.request({\n      type: \"create-tray\",\n      requestId,\n      space,\n      tray: options,\n    });\n    const frame = expectResponse(response, requestId, \"tray-created\");\n    return createTrayHandle(transport, space, frame.trayId, nextRequestId);\n  },\n});\n\n/** @deprecated Use `createSpaceHandle`. */\nexport const createSurfaceHandle = createSpaceHandle;\n\nexport const createTrayHandle = (\n  transport: OpenTrayTransport,\n  space: SpaceRef,\n  trayId: TrayId,\n  nextRequestId: () => RequestId = createRequestIdFactory(\"opentray\"),\n): TrayHandle => {\n  let nextMountOrdinal = 1;\n  const nextMountId = (extensionName: string): string => {\n    const mountId = `${formatMountIdComponent(extensionName)}.${formatMountIdComponent(trayId)}.${nextMountOrdinal}`;\n    nextMountOrdinal += 1;\n    return mountId;\n  };\n  const handle: TrayHandle = {\n    space,\n    trayId,\n    async getBounds(): Promise<TrayBoundsResult> {\n      const requestId = nextRequestId();\n      const response = await transport.request({\n        type: \"get-tray-bounds\",\n        requestId,\n        spaceId: space.spaceId,\n        trayId,\n      });\n      return expectResponse(response, requestId, \"tray-bounds\").bounds;\n    },\n    async loadExtension(options): Promise<void> {\n      const requestId = nextRequestId();\n      const response = await transport.request({\n        type: \"load-ext\",\n        requestId,\n        spaceId: space.spaceId,\n        name: options.name,\n        path: options.path,\n        ...(options.mountId === undefined ? {} : { mountId: options.mountId }),\n      });\n      expectResponse(response, requestId, \"ack\");\n    },\n    async commandExtension(ext: string, data: unknown): Promise<void> {\n      const requestId = nextRequestId();\n      const response = await transport.request({\n        type: \"ext-command\",\n        requestId,\n        spaceId: space.spaceId,\n        trayId,\n        ext,\n        data,\n      });\n      expectResponse(response, requestId, \"ack\");\n    },\n    extend<TCapability extends object, TOptions = undefined>(\n      extension: TrayExtension<TCapability, TOptions>,\n      options?: TOptions,\n    ): TrayHandle & TCapability {\n      const context = createTrayExtensionContext(handle, extension, options, nextMountId);\n      const capability = extension.extend(handle, context, options);\n      return Object.assign({}, handle, capability);\n    },\n    async destroy(): Promise<void> {\n      const requestId = nextRequestId();\n      const response = await transport.request({\n        type: \"destroy-tray\",\n        requestId,\n        spaceId: space.spaceId,\n        trayId,\n      });\n      expectResponse(response, requestId, \"ack\");\n    },\n  };\n  return handle;\n};\n\nconst createTrayExtensionContext = <TCapability extends object, TOptions>(\n  tray: TrayHandle,\n  extension: TrayExtension<TCapability, TOptions>,\n  options: TOptions | undefined,\n  nextMountId: (extensionName: string) => string,\n): TrayExtensionContext => {\n  const mount = extension.resolveMount?.(options) ?? {};\n  const name = mount.name ?? extension.name;\n  const path = mount.path ?? extension.path;\n  const mountId = mount.mountId ?? nextMountId(name);\n  let loadPromise: Promise<void> | undefined;\n\n  const ensureLoaded = async (): Promise<void> => {\n    if (loadPromise === undefined) {\n      loadPromise = tray.loadExtension({ name, path, mountId }).catch((error: unknown) => {\n        loadPromise = undefined;\n        throw error;\n      });\n    }\n    await loadPromise;\n  };\n\n  return {\n    name,\n    path,\n    mountId,\n    ensureLoaded,\n    async command(data: unknown): Promise<void> {\n      await ensureLoaded();\n      await tray.commandExtension(mountId, data);\n    },\n  };\n};\n\nconst formatMountIdComponent = (value: string): string => {\n  const formatted = value.replaceAll(/[^a-zA-Z0-9._+-]/g, \"_\");\n  return formatted.length > 0 ? formatted : \"ext\";\n};\n\nconst createRequestIdFactory = (prefix: string): (() => RequestId) => {\n  let next = 1;\n  return () => {\n    const requestId = `${prefix}-${next}`;\n    next += 1;\n    return requestId;\n  };\n};\n\nconst expectResponse = <TType extends ServerFrame[\"type\"]>(\n  frame: ServerFrame,\n  requestId: RequestId,\n  type: TType,\n): Extract<ServerFrame, { type: TType }> => {\n  if (frame.type === \"error\") {\n    throw new Error(`${frame.code}: ${frame.message}`);\n  }\n  if (frame.type !== type) {\n    throw new Error(`expected ${type} for ${requestId}, received ${frame.type}`);\n  }\n  if (requestIdOf(frame) !== requestId) {\n    throw new Error(`expected response for ${requestId}, received ${requestIdOf(frame) ?? \"none\"}`);\n  }\n  return frame as Extract<ServerFrame, { type: TType }>;\n};\n\nconst requestIdOf = (frame: ServerFrame): RequestId | undefined => {\n  switch (frame.type) {\n    case \"space-created\":\n    case \"default-space\":\n    case \"tray-created\":\n    case \"tray-bounds\":\n    case \"ack\":\n    case \"daemon-health\":\n      return frame.requestId;\n    case \"error\":\n      return frame.requestId;\n    case \"ready\":\n    case \"event\":\n    case \"ext-event\":\n      return undefined;\n  }\n};\n"],"mappings":";;AAwEA,MAAa,mBAAmB,mBAAwC;CACtE,MAAM;CACN,iBAAiB;CACjB;AACF;AAMA,MAAa,gBACX,WACA,UAA+B,CAAC,MACb;CACnB,MAAM,gBAAgB,uBAAuB,QAAQ,mBAAmB,UAAU;CAElF,OAAO;EACL,MAAM,YAAY,cAAoC;GACpD,MAAM,YAAY,cAAc;GAMhC,MAAM,QAAQ,eAAe,MALN,UAAU,QAAQ;IACvC,MAAM;IACN;IACA,GAAG;GACL,CAAC,GACsC,WAAW,eAAe,EAAE;GACnE,OAAO,kBAAkB,WAAW,OAAO,aAAa;EAC1D;EACA,MAAM,sBAA4C;GAChD,MAAM,YAAY,cAAc;GAKhC,MAAM,QAAQ,eAAe,MAJN,UAAU,QAAQ;IACvC,MAAM;IACN;GACF,CAAC,GACsC,WAAW,eAAe,EAAE;GACnE,OAAO,kBAAkB,WAAW,OAAO,aAAa;EAC1D;EACA,MAAM,cAAc,cAAoC;GACtD,OAAO,KAAK,YAAY,YAAY;EACtC;CACF;AACF;AAEA,MAAa,qBACX,WACA,OACA,gBAAiC,uBAAuB,UAAU,OACjD;CACjB;CACA,MAAM,WAAW,SAA2C;EAC1D,MAAM,YAAY,cAAc;EAQhC,OAAO,iBAAiB,WAAW,OADrB,eAAe,MANN,UAAU,QAAQ;GACvC,MAAM;GACN;GACA;GACA,MAAM;EACR,CAAC,GACsC,WAAW,cACJ,EAAE,QAAQ,aAAa;CACvE;AACF;;AAGA,MAAa,sBAAsB;AAEnC,MAAa,oBACX,WACA,OACA,QACA,gBAAiC,uBAAuB,UAAU,MACnD;CACf,IAAI,mBAAmB;CACvB,MAAM,eAAe,kBAAkC;EACrD,MAAM,UAAU,GAAG,uBAAuB,aAAa,EAAE,GAAG,uBAAuB,MAAM,EAAE,GAAG;EAC9F,oBAAoB;EACpB,OAAO;CACT;CACA,MAAM,SAAqB;EACzB;EACA;EACA,MAAM,YAAuC;GAC3C,MAAM,YAAY,cAAc;GAOhC,OAAO,eAAe,MANC,UAAU,QAAQ;IACvC,MAAM;IACN;IACA,SAAS,MAAM;IACf;GACF,CAAC,GAC+B,WAAW,aAAa,EAAE;EAC5D;EACA,MAAM,cAAc,SAAwB;GAC1C,MAAM,YAAY,cAAc;GAShC,eAAe,MARQ,UAAU,QAAQ;IACvC,MAAM;IACN;IACA,SAAS,MAAM;IACf,MAAM,QAAQ;IACd,MAAM,QAAQ;IACd,GAAI,QAAQ,YAAY,KAAA,IAAY,CAAC,IAAI,EAAE,SAAS,QAAQ,QAAQ;GACtE,CAAC,GACwB,WAAW,KAAK;EAC3C;EACA,MAAM,iBAAiB,KAAa,MAA8B;GAChE,MAAM,YAAY,cAAc;GAShC,eAAe,MARQ,UAAU,QAAQ;IACvC,MAAM;IACN;IACA,SAAS,MAAM;IACf;IACA;IACA;GACF,CAAC,GACwB,WAAW,KAAK;EAC3C;EACA,OACE,WACA,SAC0B;GAC1B,MAAM,UAAU,2BAA2B,QAAQ,WAAW,SAAS,WAAW;GAClF,MAAM,aAAa,UAAU,OAAO,QAAQ,SAAS,OAAO;GAC5D,OAAO,OAAO,OAAO,CAAC,GAAG,QAAQ,UAAU;EAC7C;EACA,MAAM,UAAyB;GAC7B,MAAM,YAAY,cAAc;GAOhC,eAAe,MANQ,UAAU,QAAQ;IACvC,MAAM;IACN;IACA,SAAS,MAAM;IACf;GACF,CAAC,GACwB,WAAW,KAAK;EAC3C;CACF;CACA,OAAO;AACT;AAEA,MAAM,8BACJ,MACA,WACA,SACA,gBACyB;CACzB,MAAM,QAAQ,UAAU,eAAe,OAAO,KAAK,CAAC;CACpD,MAAM,OAAO,MAAM,QAAQ,UAAU;CACrC,MAAM,OAAO,MAAM,QAAQ,UAAU;CACrC,MAAM,UAAU,MAAM,WAAW,YAAY,IAAI;CACjD,IAAI;CAEJ,MAAM,eAAe,YAA2B;EAC9C,IAAI,gBAAgB,KAAA,GAClB,cAAc,KAAK,cAAc;GAAE;GAAM;GAAM;EAAQ,CAAC,EAAE,OAAO,UAAmB;GAClF,cAAc,KAAA;GACd,MAAM;EACR,CAAC;EAEH,MAAM;CACR;CAEA,OAAO;EACL;EACA;EACA;EACA;EACA,MAAM,QAAQ,MAA8B;GAC1C,MAAM,aAAa;GACnB,MAAM,KAAK,iBAAiB,SAAS,IAAI;EAC3C;CACF;AACF;AAEA,MAAM,0BAA0B,UAA0B;CACxD,MAAM,YAAY,MAAM,WAAW,qBAAqB,GAAG;CAC3D,OAAO,UAAU,SAAS,IAAI,YAAY;AAC5C;AAEA,MAAM,0BAA0B,WAAsC;CACpE,IAAI,OAAO;CACX,aAAa;EACX,MAAM,YAAY,GAAG,OAAO,GAAG;EAC/B,QAAQ;EACR,OAAO;CACT;AACF;AAEA,MAAM,kBACJ,OACA,WACA,SAC0C;CAC1C,IAAI,MAAM,SAAS,SACjB,MAAM,IAAI,MAAM,GAAG,MAAM,KAAK,IAAI,MAAM,SAAS;CAEnD,IAAI,MAAM,SAAS,MACjB,MAAM,IAAI,MAAM,YAAY,KAAK,OAAO,UAAU,aAAa,MAAM,MAAM;CAE7E,IAAI,YAAY,KAAK,MAAM,WACzB,MAAM,IAAI,MAAM,yBAAyB,UAAU,aAAa,YAAY,KAAK,KAAK,QAAQ;CAEhG,OAAO;AACT;AAEA,MAAM,eAAe,UAA8C;CACjE,QAAQ,MAAM,MAAd;EACE,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,iBACH,OAAO,MAAM;EACf,KAAK,SACH,OAAO,MAAM;EACf,KAAK;EACL,KAAK;EACL,KAAK,aACH;CACJ;AACF"}

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { a as SurfaceHandle, c as createInitFrame, d as createTrayHandle, i as SpaceHandle, l as createSpaceHandle, n as OpenTrayClient, o as TrayHandle, r as OpenTrayTransport, s as createClient, t as CreateClientOptions, u as createSurfaceHandle } from "./client-h6gZdeOk.mjs";
+import { a as SpaceHandle, c as TrayExtensionContext, d as createClient, f as createInitFrame, h as createTrayHandle, i as OpenTrayTransport, l as TrayExtensionMountSpec, m as createSurfaceHandle, n as ExtensionLoadOptions, o as SurfaceHandle, p as createSpaceHandle, r as OpenTrayClient, s as TrayExtension, t as CreateClientOptions, u as TrayHandle } from "./client-DQn3DLZw.mjs";
 import { BrokerEndpointIdentity, BrokerEndpointIdentityOptions, PROTOCOL_VERSION, SpaceOptions, SpaceRef, TrayOptions, createBrokerEndpointIdentity, formatBrokerEndpointName, formatBrokerStateRoot, formatUnixSocketPath, formatWindowsPipeName, isSupportedProtocolVersion } from "@opentray/spec";
 
 //#region src/sdk.d.ts
@@ -19,5 +19,5 @@ declare const createSurface: (options: SpaceOptions, brokerOptions?: BrokerConne
 declare const resolveDefaultSpace: (brokerOptions?: BrokerConnectOptions) => Promise<SpaceHandle>;
 declare const createTray: (options: TrayOptions, brokerOptions?: CreateTrayOptions) => Promise<TrayHandle>;
 //#endregion
-export { type BrokerConnectOptions, type BrokerEndpointIdentity, type BrokerEndpointIdentityOptions, type CreateClientOptions, type CreateTrayOptions, type OpenTrayClient, type OpenTrayTransport, PROTOCOL_VERSION, type SpaceHandle, type SurfaceHandle, type TrayHandle, createBrokerEndpointIdentity, createClient, createInitFrame, createSpace, createSpaceHandle, createSurface, createSurfaceHandle, createTray, createTrayHandle, formatBrokerEndpointName, formatBrokerStateRoot, formatUnixSocketPath, formatWindowsPipeName, isSupportedProtocolVersion, resolveDefaultSpace };
+export { type BrokerConnectOptions, type BrokerEndpointIdentity, type BrokerEndpointIdentityOptions, type CreateClientOptions, type CreateTrayOptions, type ExtensionLoadOptions, type OpenTrayClient, type OpenTrayTransport, PROTOCOL_VERSION, type SpaceHandle, type SurfaceHandle, type TrayExtension, type TrayExtensionContext, type TrayExtensionMountSpec, type TrayHandle, createBrokerEndpointIdentity, createClient, createInitFrame, createSpace, createSpaceHandle, createSurface, createSurfaceHandle, createTray, createTrayHandle, formatBrokerEndpointName, formatBrokerStateRoot, formatUnixSocketPath, formatWindowsPipeName, isSupportedProtocolVersion, resolveDefaultSpace };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { a as createTrayHandle, i as createSurfaceHandle, n as createInitFrame, r as createSpaceHandle, t as createClient } from "./client-B_zxQOo5.mjs";
+import { a as createTrayHandle, i as createSurfaceHandle, n as createInitFrame, r as createSpaceHandle, t as createClient } from "./client-DzcHIH-f.mjs";
 import { t as connectLocalBroker } from "./local-broker-CEIHPBcK.mjs";
 import { PROTOCOL_VERSION, createBrokerEndpointIdentity, formatBrokerEndpointName, formatBrokerStateRoot, formatUnixSocketPath, formatWindowsPipeName, isSupportedProtocolVersion } from "@opentray/spec";
 //#region src/sdk.ts

package/dist/node.d.mts

@@ -1,4 +1,4 @@
-import { r as OpenTrayTransport } from "./client-h6gZdeOk.mjs";
+import { i as OpenTrayTransport } from "./client-DQn3DLZw.mjs";
 import { BrokerEndpointIdentityOptions, ServerFrame } from "@opentray/spec";
 
 //#region src/daemon/paths.d.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opentray",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Developer-facing OpenTray SDK and CLI package.",
   "type": "module",
   "license": "MIT",
@@ -24,11 +24,12 @@
   },
   "files": [
     "dist",
+    "assets",
     "README.md"
   ],
   "sideEffects": false,
   "dependencies": {
-    "@opentray/spec": "0.4.0"
+    "@opentray/spec": "0.4.1"
   },
   "devDependencies": {
     "tsdown": "^0.22.1",
@@ -36,12 +37,12 @@
     "vitest": "^4.1.7"
   },
   "optionalDependencies": {
-    "@opentray/darwin-arm64": "0.5.0",
-    "@opentray/darwin-x64": "0.5.0",
-    "@opentray/linux-arm64": "0.5.0",
-    "@opentray/linux-x64": "0.5.0",
-    "@opentray/windows-arm64": "0.5.0",
-    "@opentray/windows-x64": "0.5.0"
+    "@opentray/darwin-arm64": "0.5.2",
+    "@opentray/darwin-x64": "0.5.2",
+    "@opentray/linux-arm64": "0.5.2",
+    "@opentray/linux-x64": "0.5.2",
+    "@opentray/windows-arm64": "0.5.2",
+    "@opentray/windows-x64": "0.5.2"
   },
   "scripts": {
     "build": "tsdown src/index.ts src/node.ts src/cli.ts --format esm --dts",

package/dist/client-B_zxQOo5.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"client-B_zxQOo5.mjs","names":[],"sources":["../src/client.ts"],"sourcesContent":["import {\n  PROTOCOL_VERSION,\n  type ClientFrame,\n  type ClientRequestFrame,\n  type RequestId,\n  type ServerFrame,\n  type SpaceOptions,\n  type SpaceRef,\n  type TrayBoundsResult,\n  type TrayId,\n  type TrayOptions,\n} from \"@opentray/spec\";\n\nexport interface OpenTrayTransport {\n  request(frame: ClientRequestFrame): Promise<ServerFrame>;\n}\n\nexport interface OpenTrayClient {\n  createSpace(options: SpaceOptions): Promise<SpaceHandle>;\n  resolveDefaultSpace(): Promise<SpaceHandle>;\n  /** @deprecated Use `createSpace`. */\n  createSurface(options: SpaceOptions): Promise<SpaceHandle>;\n}\n\nexport interface SpaceHandle {\n  space: SpaceRef;\n  createTray(options: TrayOptions): Promise<TrayHandle>;\n}\n\n/** @deprecated Use `SpaceHandle`. */\nexport type SurfaceHandle = SpaceHandle;\n\nexport interface TrayHandle {\n  space: SpaceRef;\n  trayId: TrayId;\n  getBounds(): Promise<TrayBoundsResult>;\n  commandExtension(ext: string, data: unknown): Promise<void>;\n  destroy(): Promise<void>;\n}\n\nexport const createInitFrame = (clientVersion: string): ClientFrame => ({\n  type: \"init\",\n  protocolVersion: PROTOCOL_VERSION,\n  clientVersion,\n});\n\nexport interface CreateClientOptions {\n  requestIdPrefix?: string;\n}\n\nexport const createClient = (\n  transport: OpenTrayTransport,\n  options: CreateClientOptions = {},\n): OpenTrayClient => {\n  const nextRequestId = createRequestIdFactory(options.requestIdPrefix ?? \"opentray\");\n\n  return {\n    async createSpace(spaceOptions): Promise<SpaceHandle> {\n      const requestId = nextRequestId();\n      const response = await transport.request({\n        type: \"create-space\",\n        requestId,\n        ...spaceOptions,\n      });\n      const space = expectResponse(response, requestId, \"space-created\").space;\n      return createSpaceHandle(transport, space, nextRequestId);\n    },\n    async resolveDefaultSpace(): Promise<SpaceHandle> {\n      const requestId = nextRequestId();\n      const response = await transport.request({\n        type: \"resolve-default-space\",\n        requestId,\n      });\n      const space = expectResponse(response, requestId, \"default-space\").space;\n      return createSpaceHandle(transport, space, nextRequestId);\n    },\n    async createSurface(spaceOptions): Promise<SpaceHandle> {\n      return this.createSpace(spaceOptions);\n    },\n  };\n};\n\nexport const createSpaceHandle = (\n  transport: OpenTrayTransport,\n  space: SpaceRef,\n  nextRequestId: () => RequestId = createRequestIdFactory(\"opentray\"),\n): SpaceHandle => ({\n  space,\n  async createTray(options: TrayOptions): Promise<TrayHandle> {\n    const requestId = nextRequestId();\n    const response = await transport.request({\n      type: \"create-tray\",\n      requestId,\n      space,\n      tray: options,\n    });\n    const frame = expectResponse(response, requestId, \"tray-created\");\n    return createTrayHandle(transport, space, frame.trayId, nextRequestId);\n  },\n});\n\n/** @deprecated Use `createSpaceHandle`. */\nexport const createSurfaceHandle = createSpaceHandle;\n\nexport const createTrayHandle = (\n  transport: OpenTrayTransport,\n  space: SpaceRef,\n  trayId: TrayId,\n  nextRequestId: () => RequestId = createRequestIdFactory(\"opentray\"),\n): TrayHandle => ({\n  space,\n  trayId,\n  async getBounds(): Promise<TrayBoundsResult> {\n    const requestId = nextRequestId();\n    const response = await transport.request({\n      type: \"get-tray-bounds\",\n      requestId,\n      spaceId: space.spaceId,\n      trayId,\n    });\n    return expectResponse(response, requestId, \"tray-bounds\").bounds;\n  },\n  async commandExtension(ext: string, data: unknown): Promise<void> {\n    const requestId = nextRequestId();\n    const response = await transport.request({\n      type: \"ext-command\",\n      requestId,\n      spaceId: space.spaceId,\n      trayId,\n      ext,\n      data,\n    });\n    expectResponse(response, requestId, \"ack\");\n  },\n  async destroy(): Promise<void> {\n    const requestId = nextRequestId();\n    const response = await transport.request({\n      type: \"destroy-tray\",\n      requestId,\n      spaceId: space.spaceId,\n      trayId,\n    });\n    expectResponse(response, requestId, \"ack\");\n  },\n});\n\nconst createRequestIdFactory = (prefix: string): (() => RequestId) => {\n  let next = 1;\n  return () => {\n    const requestId = `${prefix}-${next}`;\n    next += 1;\n    return requestId;\n  };\n};\n\nconst expectResponse = <TType extends ServerFrame[\"type\"]>(\n  frame: ServerFrame,\n  requestId: RequestId,\n  type: TType,\n): Extract<ServerFrame, { type: TType }> => {\n  if (frame.type === \"error\") {\n    throw new Error(`${frame.code}: ${frame.message}`);\n  }\n  if (frame.type !== type) {\n    throw new Error(`expected ${type} for ${requestId}, received ${frame.type}`);\n  }\n  if (requestIdOf(frame) !== requestId) {\n    throw new Error(`expected response for ${requestId}, received ${requestIdOf(frame) ?? \"none\"}`);\n  }\n  return frame as Extract<ServerFrame, { type: TType }>;\n};\n\nconst requestIdOf = (frame: ServerFrame): RequestId | undefined => {\n  switch (frame.type) {\n    case \"space-created\":\n    case \"default-space\":\n    case \"tray-created\":\n    case \"tray-bounds\":\n    case \"ack\":\n    case \"daemon-health\":\n      return frame.requestId;\n    case \"error\":\n      return frame.requestId;\n    case \"ready\":\n    case \"event\":\n    case \"ext-event\":\n      return undefined;\n  }\n};\n"],"mappings":";;AAwCA,MAAa,mBAAmB,mBAAwC;CACtE,MAAM;CACN,iBAAiB;CACjB;AACF;AAMA,MAAa,gBACX,WACA,UAA+B,CAAC,MACb;CACnB,MAAM,gBAAgB,uBAAuB,QAAQ,mBAAmB,UAAU;CAElF,OAAO;EACL,MAAM,YAAY,cAAoC;GACpD,MAAM,YAAY,cAAc;GAMhC,MAAM,QAAQ,eAAe,MALN,UAAU,QAAQ;IACvC,MAAM;IACN;IACA,GAAG;GACL,CAAC,GACsC,WAAW,eAAe,EAAE;GACnE,OAAO,kBAAkB,WAAW,OAAO,aAAa;EAC1D;EACA,MAAM,sBAA4C;GAChD,MAAM,YAAY,cAAc;GAKhC,MAAM,QAAQ,eAAe,MAJN,UAAU,QAAQ;IACvC,MAAM;IACN;GACF,CAAC,GACsC,WAAW,eAAe,EAAE;GACnE,OAAO,kBAAkB,WAAW,OAAO,aAAa;EAC1D;EACA,MAAM,cAAc,cAAoC;GACtD,OAAO,KAAK,YAAY,YAAY;EACtC;CACF;AACF;AAEA,MAAa,qBACX,WACA,OACA,gBAAiC,uBAAuB,UAAU,OACjD;CACjB;CACA,MAAM,WAAW,SAA2C;EAC1D,MAAM,YAAY,cAAc;EAQhC,OAAO,iBAAiB,WAAW,OADrB,eAAe,MANN,UAAU,QAAQ;GACvC,MAAM;GACN;GACA;GACA,MAAM;EACR,CAAC,GACsC,WAAW,cACJ,EAAE,QAAQ,aAAa;CACvE;AACF;;AAGA,MAAa,sBAAsB;AAEnC,MAAa,oBACX,WACA,OACA,QACA,gBAAiC,uBAAuB,UAAU,OAClD;CAChB;CACA;CACA,MAAM,YAAuC;EAC3C,MAAM,YAAY,cAAc;EAOhC,OAAO,eAAe,MANC,UAAU,QAAQ;GACvC,MAAM;GACN;GACA,SAAS,MAAM;GACf;EACF,CAAC,GAC+B,WAAW,aAAa,EAAE;CAC5D;CACA,MAAM,iBAAiB,KAAa,MAA8B;EAChE,MAAM,YAAY,cAAc;EAShC,eAAe,MARQ,UAAU,QAAQ;GACvC,MAAM;GACN;GACA,SAAS,MAAM;GACf;GACA;GACA;EACF,CAAC,GACwB,WAAW,KAAK;CAC3C;CACA,MAAM,UAAyB;EAC7B,MAAM,YAAY,cAAc;EAOhC,eAAe,MANQ,UAAU,QAAQ;GACvC,MAAM;GACN;GACA,SAAS,MAAM;GACf;EACF,CAAC,GACwB,WAAW,KAAK;CAC3C;AACF;AAEA,MAAM,0BAA0B,WAAsC;CACpE,IAAI,OAAO;CACX,aAAa;EACX,MAAM,YAAY,GAAG,OAAO,GAAG;EAC/B,QAAQ;EACR,OAAO;CACT;AACF;AAEA,MAAM,kBACJ,OACA,WACA,SAC0C;CAC1C,IAAI,MAAM,SAAS,SACjB,MAAM,IAAI,MAAM,GAAG,MAAM,KAAK,IAAI,MAAM,SAAS;CAEnD,IAAI,MAAM,SAAS,MACjB,MAAM,IAAI,MAAM,YAAY,KAAK,OAAO,UAAU,aAAa,MAAM,MAAM;CAE7E,IAAI,YAAY,KAAK,MAAM,WACzB,MAAM,IAAI,MAAM,yBAAyB,UAAU,aAAa,YAAY,KAAK,KAAK,QAAQ;CAEhG,OAAO;AACT;AAEA,MAAM,eAAe,UAA8C;CACjE,QAAQ,MAAM,MAAd;EACE,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,iBACH,OAAO,MAAM;EACf,KAAK,SACH,OAAO,MAAM;EACf,KAAK;EACL,KAAK;EACL,KAAK,aACH;CACJ;AACF"}

package/dist/client-h6gZdeOk.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client-h6gZdeOk.d.mts","names":[],"sources":["../src/client.ts"],"mappings":";;;UAaiB,iBAAA;EACf,OAAA,CAAQ,KAAA,EAAO,kBAAA,GAAqB,OAAA,CAAQ,WAAA;AAAA;AAAA,UAG7B,cAAA;EACf,WAAA,CAAY,OAAA,EAAS,YAAA,GAAe,OAAA,CAAQ,WAAA;EAC5C,mBAAA,IAAuB,OAAA,CAAQ,WAAA;EALa;EAO5C,aAAA,CAAc,OAAA,EAAS,YAAA,GAAe,OAAA,CAAQ,WAAA;AAAA;AAAA,UAG/B,WAAA;EACf,KAAA,EAAO,QAAA;EACP,UAAA,CAAW,OAAA,EAAS,WAAA,GAAc,OAAA,CAAQ,UAAA;AAAA;;KAIhC,aAAA,GAAgB,WAAW;AAAA,UAEtB,UAAA;EACf,KAAA,EAAO,QAAA;EACP,MAAA,EAAQ,MAAA;EACR,SAAA,IAAa,OAAA,CAAQ,gBAAA;EACrB,gBAAA,CAAiB,GAAA,UAAa,IAAA,YAAgB,OAAA;EAC9C,OAAA,IAAW,OAAA;AAAA;AAAA,cAGA,eAAA,GAAmB,aAAA,aAAwB,WAItD;AAAA,UAEe,mBAAA;EACf,eAAe;AAAA;AAAA,cAGJ,YAAA,GACX,SAAA,EAAW,iBAAA,EACX,OAAA,GAAS,mBAAA,KACR,cAAA;AAAA,cA6BU,iBAAA,GACX,SAAA,EAAW,iBAAA,EACX,KAAA,EAAO,QAAA,EACP,aAAA,SAAqB,SAAA,KACpB,WAAA;;cAgBU,mBAAA,GAAmB,SAAA,EAnBnB,iBAAA,EAAiB,KAAA,EACrB,QAAA,EAAQ,aAAA,SACM,SAAA,KACpB,WAAA;AAAA,cAkBU,gBAAA,GACX,SAAA,EAAW,iBAAA,EACX,KAAA,EAAO,QAAA,EACP,MAAA,EAAQ,MAAA,EACR,aAAA,SAAqB,SAAA,KACpB,UAAA"}