opentray 0.6.0 → 0.8.0

package/README.md

@@ -17,6 +17,27 @@ pnpm add opentray
 
 `packages/cli` is the only unscoped npm package in this monorepo.
 
+## Caller identity and per-caller isolation
+
+Each host application gets its own broker process. OpenTray does not aggregate
+multiple callers onto one shared tray; a broker is pinned to exactly one caller
+session so its process is identifiable in the task manager and killing it only
+affects that one application.
+
+The SDK derives a caller label with this precedence:
+
+1. An explicit label: `connectLocalBroker({ callerLabel: "myapp" })`.
+2. `npm_package_name` when present.
+3. The basename of the running script.
+4. The neutral fallback `opentray` when nothing usable is available.
+
+The label is sanitized to a filesystem- and process-safe component and scopes
+the broker endpoint, runtime directory, ready file, and the process name, so two
+host applications using the same OpenTray version resolve distinct brokers and
+endpoints. A broker rejects a second incoming connection with a typed
+`OPENTRAY_BROKER_SINGLE_SESSION` error rather than silently sharing state.
+
+
 ## Example
 
 Run a protocol-only example that creates a space, creates a tray, dispatches an extension command, and prints each client frame:
@@ -31,10 +52,18 @@ The top-level SDK now exposes the mainline broker-backed path directly:
 import { createSpace, createTray, resolveDefaultSpace } from "opentray";
 
 const space = await createSpace({ id: "com.example.status", default: true });
-await space.createTray({
+const tray = await space.createTray({
   trayId: "status",
   title: "Status",
   icon: { type: "file", path: "./assets/tray-icon.png" },
+  menu: { items: [{ type: "item", id: 1, title: "Open", primaryEvent: true }] },
+});
+
+await tray.setTitle("Status: ready");
+tray.onMenuClick(({ itemId }) => {
+  if (itemId === 1) {
+    // Open a native menu action or a WebView surface.
+  }
 });
 
 const defaultSpace = await resolveDefaultSpace();
@@ -88,6 +117,26 @@ const panel = tray.createWebviewWindow({
 await panel.show();
 ```
 
+For tray-anchored or screen-aware surfaces, use `WebviewPlacementKit` from `@opentray/ext-webview` instead of hand-authoring raw broker frames or creating a one-off panel abstraction.
+
+Run the placement demo when you want to review tray, screen, and edge-aware placement:
+
+```bash
+cargo build -p opentray-bin -p opentray-ext-webview
+pnpm --filter opentray example:placement
+```
+
+This demo follows the `skills/opentray` placement law: extension-owned WebView mounting, continuous `WebviewPlacementKit.watch()`, `applyOnce()`, tray/screen/edge anchors, and a page-owned frameless drag region.
+
+Run the media query demo when you want to review responsive native window style and constraints:
+
+```bash
+cargo build -p opentray-bin -p opentray-ext-webview
+pnpm --filter opentray example:mediaQuery
+```
+
+This demo focuses on `styleKit.apply(...)` and `mediaQueryKit.match(...)`. Keep it separate from placement debugging so size/style callbacks do not obscure placement behavior.
+
 Run the dedicated tray-panel demo:
 
 ```bash

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-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-C9siWyRh.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-BMxjb-eO.mjs";
 import { homedir } from "node:os";
 import { fileURLToPath } from "node:url";
 import { realpathSync } from "node:fs";

package/dist/client-C27qmRfr.d.mts

@@ -0,0 +1,102 @@
+import { ClientFrame, ClientRequestFrame, ExtensionEnvelope, Icon, Menu, RequestId, ServerFrame, SpaceOptions, SpaceRef, Tooltip, TrayBoundsResult, TrayEvent, TrayId, TrayOptions } from "@opentray/spec";
+
+//#region src/client.d.ts
+interface OpenTrayTransport {
+  request(frame: ClientRequestFrame): Promise<ServerFrame>;
+}
+type BrokerEventFrame = Extract<ServerFrame, {
+  type: "event" | "ext-event";
+}>;
+interface OpenTrayEventSource {
+  onEvent(listener: (frame: BrokerEventFrame) => void): () => void;
+}
+interface OpenTrayConnection extends OpenTrayTransport, OpenTrayEventSource {}
+interface OpenTrayClient {
+  createSpace(options: SpaceOptions): Promise<SpaceHandle>;
+  resolveDefaultSpace(): Promise<SpaceHandle>;
+  /** @deprecated Use `createSpace`. */
+  createSurface(options: SpaceOptions): Promise<SpaceHandle>;
+}
+interface SpaceHandle {
+  space: SpaceRef;
+  createTray(options: TrayOptions): Promise<TrayHandle>;
+}
+interface EventfulSpaceHandle extends Omit<SpaceHandle, "createTray"> {
+  createTray(options: TrayOptions): Promise<EventfulTrayHandle>;
+}
+/** @deprecated Use `SpaceHandle`. */
+type SurfaceHandle = SpaceHandle;
+interface TrayHandle {
+  space: SpaceRef;
+  trayId: TrayId;
+  getBounds(): Promise<TrayBoundsResult>;
+  setMenu(menu: Menu): Promise<void>;
+  setTooltip(tooltip: Tooltip): Promise<void>;
+  setIcon(icon: Icon): Promise<void>;
+  setTitle(title: string): Promise<void>;
+  loadExtension(options: ExtensionLoadOptions): Promise<void>;
+  commandExtension(ext: string, data: unknown): Promise<void>;
+  requestExtension(ext: string, data: unknown): Promise<ExtensionEnvelope[]>;
+  extend<TCapability extends object, TOptions = undefined>(extension: TrayExtension<TCapability, TOptions>, options?: TOptions): TrayHandle & TCapability;
+  destroy(): Promise<void>;
+}
+type TrayScopedEvent = Exclude<TrayEvent, {
+  type: "ready";
+}>;
+type TrayEventType = TrayScopedEvent["type"];
+type TrayEventByType<TEvent extends TrayEventType> = Extract<TrayScopedEvent, {
+  type: TEvent;
+}>;
+interface EventfulTrayHandle extends TrayHandle {
+  extend<TCapability extends object, TOptions = undefined>(extension: TrayExtension<TCapability, TOptions>, options?: TOptions): EventfulTrayHandle & TCapability;
+  listenExtension<TData = unknown>(ext: string, handler: (event: ExtensionEnvelope<TData>) => void): () => void;
+  listen<TEvent extends TrayEventType>(event: TEvent, handler: (event: TrayEventByType<TEvent>) => void): () => void;
+  onMenuClick(handler: (event: TrayEventByType<"menuClick">) => void): () => void;
+  onTrayClick(handler: (event: TrayEventByType<"trayClick">) => void): () => void;
+  onTrayDoubleClick(handler: (event: TrayEventByType<"trayDoubleClick">) => void): () => 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>;
+  request(data: unknown): Promise<ExtensionEnvelope[]>;
+}
+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;
+}
+interface OpenTrayEventfulClient extends Omit<OpenTrayClient, "createSpace" | "resolveDefaultSpace" | "createSurface"> {
+  createSpace(options: SpaceOptions): Promise<EventfulSpaceHandle>;
+  resolveDefaultSpace(): Promise<EventfulSpaceHandle>;
+  /** @deprecated Use `createSpace`. */
+  createSurface(options: SpaceOptions): Promise<EventfulSpaceHandle>;
+}
+declare function createClient(transport: OpenTrayConnection, options?: CreateClientOptions): OpenTrayEventfulClient;
+declare function createClient(transport: OpenTrayTransport, options?: CreateClientOptions): OpenTrayClient;
+declare function createSpaceHandle(transport: OpenTrayConnection, space: SpaceRef, nextRequestId?: () => RequestId): EventfulSpaceHandle;
+declare function createSpaceHandle(transport: OpenTrayTransport, space: SpaceRef, nextRequestId?: () => RequestId): SpaceHandle;
+/** @deprecated Use `createSpaceHandle`. */
+declare const createSurfaceHandle: typeof createSpaceHandle;
+declare function createTrayHandle(transport: OpenTrayConnection, space: SpaceRef, trayId: TrayId, nextRequestId?: () => RequestId): EventfulTrayHandle;
+declare function createTrayHandle(transport: OpenTrayTransport, space: SpaceRef, trayId: TrayId, nextRequestId?: () => RequestId): TrayHandle;
+//#endregion
+export { createTrayHandle as C, createSurfaceHandle as S, TrayExtensionMountSpec as _, ExtensionLoadOptions as a, createInitFrame as b, OpenTrayEventSource as c, SpaceHandle as d, SurfaceHandle as f, TrayExtensionContext as g, TrayExtension as h, EventfulTrayHandle as i, OpenTrayEventfulClient as l, TrayEventType as m, CreateClientOptions as n, OpenTrayClient as o, TrayEventByType as p, EventfulSpaceHandle as r, OpenTrayConnection as s, BrokerEventFrame as t, OpenTrayTransport as u, TrayHandle as v, createSpaceHandle as x, createClient as y };
+//# sourceMappingURL=client-C27qmRfr.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client-C27qmRfr.d.mts","names":[],"sources":["../src/client.ts"],"mappings":"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"}

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-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 { C as createTrayHandle, S as createSurfaceHandle, _ as TrayExtensionMountSpec, a as ExtensionLoadOptions, b as createInitFrame, c as OpenTrayEventSource, d as SpaceHandle, f as SurfaceHandle, g as TrayExtensionContext, h as TrayExtension, i as EventfulTrayHandle, l as OpenTrayEventfulClient, m as TrayEventType, n as CreateClientOptions, o as OpenTrayClient, p as TrayEventByType, r as EventfulSpaceHandle, s as OpenTrayConnection, t as BrokerEventFrame, u as OpenTrayTransport, v as TrayHandle, x as createSpaceHandle, y as createClient } from "./client-C27qmRfr.mjs";
 import { BrokerEndpointIdentity, BrokerEndpointIdentityOptions, PROTOCOL_VERSION, SpaceOptions, SpaceRef, TrayOptions, createBrokerEndpointIdentity, formatBrokerEndpointName, formatBrokerStateRoot, formatUnixSocketPath, formatWindowsPipeName, isSupportedProtocolVersion } from "@opentray/spec";
 
 //#region src/sdk.d.ts
@@ -13,11 +13,11 @@ interface BrokerConnectOptions {
 interface CreateTrayOptions extends BrokerConnectOptions {
   space?: SpaceRef;
 }
-declare const createSpace: (options: SpaceOptions, brokerOptions?: BrokerConnectOptions) => Promise<SpaceHandle>;
+declare const createSpace: (options: SpaceOptions, brokerOptions?: BrokerConnectOptions) => Promise<EventfulSpaceHandle>;
 /** @deprecated Use `createSpace`. */
 declare const createSurface: (options: SpaceOptions, brokerOptions?: BrokerConnectOptions) => Promise<SurfaceHandle>;
-declare const resolveDefaultSpace: (brokerOptions?: BrokerConnectOptions) => Promise<SpaceHandle>;
-declare const createTray: (options: TrayOptions, brokerOptions?: CreateTrayOptions) => Promise<TrayHandle>;
+declare const resolveDefaultSpace: (brokerOptions?: BrokerConnectOptions) => Promise<EventfulSpaceHandle>;
+declare const createTray: (options: TrayOptions, brokerOptions?: CreateTrayOptions) => Promise<EventfulTrayHandle>;
 //#endregion
-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 };
+export { type BrokerConnectOptions, type BrokerEndpointIdentity, type BrokerEndpointIdentityOptions, type BrokerEventFrame, type CreateClientOptions, type CreateTrayOptions, type EventfulSpaceHandle, type EventfulTrayHandle, type ExtensionLoadOptions, type OpenTrayClient, type OpenTrayConnection, type OpenTrayEventSource, type OpenTrayEventfulClient, type OpenTrayTransport, PROTOCOL_VERSION, type SpaceHandle, type SurfaceHandle, type TrayEventByType, type TrayEventType, 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.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/sdk.ts"],"mappings":";;;;UAKiB,oBAAA;EACf,QAAA;EACA,OAAA;EACA,cAAA;EACA,eAAA;EACA,aAAA;EACA,SAAA;AAAA;AAAA,UAGe,iBAAA,SAA0B,oBAAoB;EAC7D,KAAA,GAAQ,QAAA;AAAA;AAAA,cAGG,WAAA,GACX,OAAA,EAAS,YAAA,EACT,aAAA,GAAe,oBAAA,KACd,OAAA,CAAQ,WAAA;;cAME,aAAA,GACX,OAAA,EAAS,YAAA,EACT,aAAA,GAAe,oBAAA,KACd,OAAA,CAAQ,aAAA;AAAA,cAEE,mBAAA,GACX,aAAA,GAAe,oBAAA,KACd,OAAA,CAAQ,WAAA;AAAA,cAKE,UAAA,GACX,OAAA,EAAS,WAAA,EACT,aAAA,GAAe,iBAAA,KACd,OAAA,CAAQ,UAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/sdk.ts"],"mappings":";;;;UAWiB,oBAAA;EACf,QAAA;EACA,OAAA;EACA,cAAA;EACA,eAAA;EACA,aAAA;EACA,SAAA;AAAA;AAAA,UAGe,iBAAA,SAA0B,oBAAoB;EAC7D,KAAA,GAAQ,QAAA;AAAA;AAAA,cAGG,WAAA,GACX,OAAA,EAAS,YAAA,EACT,aAAA,GAAe,oBAAA,KACd,OAAA,CAAQ,mBAAA;;cAME,aAAA,GACX,OAAA,EAAS,YAAA,EACT,aAAA,GAAe,oBAAA,KACd,OAAA,CAAQ,aAAA;AAAA,cAEE,mBAAA,GACX,aAAA,GAAe,oBAAA,KACd,OAAA,CAAQ,mBAAA;AAAA,cAKE,UAAA,GACX,OAAA,EAAS,WAAA,EACT,aAAA,GAAe,iBAAA,KACd,OAAA,CAAQ,kBAAA"}

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { t as connectLocalBroker } from "./local-broker-C9siWyRh.mjs";
+import { t as connectLocalBroker } from "./local-broker-BMxjb-eO.mjs";
 import { PROTOCOL_VERSION, PROTOCOL_VERSION as PROTOCOL_VERSION$1, createBrokerEndpointIdentity, formatBrokerEndpointName, formatBrokerStateRoot, formatUnixSocketPath, formatWindowsPipeName, isSupportedProtocolVersion } from "@opentray/spec";
 //#region src/client.ts
 const createInitFrame = (clientVersion) => ({
@@ -6,7 +6,7 @@ const createInitFrame = (clientVersion) => ({
 	protocolVersion: PROTOCOL_VERSION$1,
 	clientVersion
 });
-const createClient = (transport, options = {}) => {
+function createClient(transport, options = {}) {
 	const nextRequestId = createRequestIdFactory(options.requestIdPrefix ?? "opentray");
 	return {
 		async createSpace(spaceOptions) {
@@ -30,22 +30,24 @@ const createClient = (transport, options = {}) => {
 			return this.createSpace(spaceOptions);
 		}
 	};
-};
-const createSpaceHandle = (transport, space, nextRequestId = createRequestIdFactory("opentray")) => ({
-	space,
-	async createTray(options) {
-		const requestId = nextRequestId();
-		return createTrayHandle(transport, space, expectResponse(await transport.request({
-			type: "create-tray",
-			requestId,
-			space,
-			tray: options
-		}), requestId, "tray-created").trayId, nextRequestId);
-	}
-});
+}
+function createSpaceHandle(transport, space, nextRequestId = createRequestIdFactory("opentray")) {
+	return {
+		space,
+		async createTray(options) {
+			const requestId = nextRequestId();
+			return createTrayHandle(transport, space, expectResponse(await transport.request({
+				type: "create-tray",
+				requestId,
+				space,
+				tray: options
+			}), requestId, "tray-created").trayId, nextRequestId);
+		}
+	};
+}
 /** @deprecated Use `createSpaceHandle`. */
 const createSurfaceHandle = createSpaceHandle;
-const createTrayHandle = (transport, space, trayId, nextRequestId = createRequestIdFactory("opentray")) => {
+function createTrayHandle(transport, space, trayId, nextRequestId = createRequestIdFactory("opentray")) {
 	let nextMountOrdinal = 1;
 	const nextMountId = (extensionName) => {
 		const mountId = `${formatMountIdComponent(extensionName)}.${formatMountIdComponent(trayId)}.${nextMountOrdinal}`;
@@ -64,6 +66,46 @@ const createTrayHandle = (transport, space, trayId, nextRequestId = createReques
 				trayId
 			}), requestId, "tray-bounds").bounds;
 		},
+		async setMenu(menu) {
+			const requestId = nextRequestId();
+			expectResponse(await transport.request({
+				type: "set-tray-menu",
+				requestId,
+				spaceId: space.spaceId,
+				trayId,
+				menu
+			}), requestId, "ack");
+		},
+		async setTooltip(tooltip) {
+			const requestId = nextRequestId();
+			expectResponse(await transport.request({
+				type: "set-tray-tooltip",
+				requestId,
+				spaceId: space.spaceId,
+				trayId,
+				tooltip
+			}), requestId, "ack");
+		},
+		async setIcon(icon) {
+			const requestId = nextRequestId();
+			expectResponse(await transport.request({
+				type: "set-tray-icon",
+				requestId,
+				spaceId: space.spaceId,
+				trayId,
+				icon
+			}), requestId, "ack");
+		},
+		async setTitle(title) {
+			const requestId = nextRequestId();
+			expectResponse(await transport.request({
+				type: "set-tray-title",
+				requestId,
+				spaceId: space.spaceId,
+				trayId,
+				title
+			}), requestId, "ack");
+		},
 		async loadExtension(options) {
 			const requestId = nextRequestId();
 			expectResponse(await transport.request({
@@ -76,15 +118,23 @@ const createTrayHandle = (transport, space, trayId, nextRequestId = createReques
 			}), requestId, "ack");
 		},
 		async commandExtension(ext, data) {
+			await this.requestExtension(ext, data);
+		},
+		async requestExtension(ext, data) {
 			const requestId = nextRequestId();
-			expectResponse(await transport.request({
+			const response = await transport.request({
 				type: "ext-command",
 				requestId,
 				spaceId: space.spaceId,
 				trayId,
 				ext,
 				data
-			}), requestId, "ack");
+			});
+			if (response.type === "ack") {
+				expectResponse(response, requestId, "ack");
+				return [];
+			}
+			return expectResponse(response, requestId, "ext-command-result").events;
 		},
 		extend(extension, options) {
 			const context = createTrayExtensionContext(handle, extension, options, nextMountId);
@@ -101,8 +151,51 @@ const createTrayHandle = (transport, space, trayId, nextRequestId = createReques
 			}), requestId, "ack");
 		}
 	};
-	return handle;
+	if (!isOpenTrayEventSource(transport)) return handle;
+	return attachEventfulTrayHandle(handle, transport, nextMountId);
+}
+const attachEventfulTrayHandle = (handle, source, nextMountId) => {
+	const listen = (event, handler) => source.onEvent((frame) => {
+		if (frame.type !== "event" || frame.event.type !== event) return;
+		if (!isOwnedTrayEvent(frame.event, handle.space.spaceId, handle.trayId)) return;
+		handler(frame.event);
+	});
+	const eventful = {
+		...handle,
+		listenExtension(ext, handler) {
+			return source.onEvent((frame) => {
+				if (frame.type !== "ext-event" || frame.ext !== ext) return;
+				if (frame.spaceId !== handle.space.spaceId || frame.trayId !== handle.trayId) return;
+				handler({
+					scope: {
+						spaceId: frame.spaceId,
+						trayId: frame.trayId,
+						ext: frame.ext
+					},
+					data: frame.data
+				});
+			});
+		},
+		listen,
+		onMenuClick(handler) {
+			return listen("menuClick", handler);
+		},
+		onTrayClick(handler) {
+			return listen("trayClick", handler);
+		},
+		onTrayDoubleClick(handler) {
+			return listen("trayDoubleClick", handler);
+		},
+		extend(extension, options) {
+			const context = createTrayExtensionContext(eventful, extension, options, nextMountId);
+			const capability = extension.extend(eventful, context, options);
+			return Object.assign({}, eventful, capability);
+		}
+	};
+	return eventful;
 };
+const isOwnedTrayEvent = (event, spaceId, trayId) => event.type !== "ready" && event.spaceId === spaceId && event.trayId === trayId;
+const isOpenTrayEventSource = (transport) => "onEvent" in transport && typeof transport.onEvent === "function";
 const createTrayExtensionContext = (tray, extension, options, nextMountId) => {
 	const mount = extension.resolveMount?.(options) ?? {};
 	const name = mount.name ?? extension.name;
@@ -128,6 +221,10 @@ const createTrayExtensionContext = (tray, extension, options, nextMountId) => {
 		async command(data) {
 			await ensureLoaded();
 			await tray.commandExtension(mountId, data);
+		},
+		async request(data) {
+			await ensureLoaded();
+			return tray.requestExtension(mountId, data);
 		}
 	};
 };
@@ -156,6 +253,7 @@ const requestIdOf = (frame) => {
 		case "tray-created":
 		case "tray-bounds":
 		case "ack":
+		case "ext-command-result":
 		case "daemon-health": return frame.requestId;
 		case "error": return frame.requestId;
 		case "ready":

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["PROTOCOL_VERSION"],"sources":["../src/client.ts","../src/sdk.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","import type { SpaceOptions, SpaceRef, TrayOptions } from \"@opentray/spec\";\n\nimport { createClient, createSpaceHandle, type SpaceHandle, type SurfaceHandle, type TrayHandle } from \"./client\";\nimport { connectLocalBroker } from \"./local-broker\";\n\nexport interface BrokerConnectOptions {\n  endpoint?: string;\n  homeDir?: string;\n  packageVersion?: string;\n  protocolVersion?: number;\n  clientVersion?: string;\n  autoStart?: boolean;\n}\n\nexport interface CreateTrayOptions extends BrokerConnectOptions {\n  space?: SpaceRef;\n}\n\nexport const createSpace = async (\n  options: SpaceOptions,\n  brokerOptions: BrokerConnectOptions = {},\n): Promise<SpaceHandle> => {\n  const connection = await connectLocalBroker(brokerOptions);\n  return createClient(connection).createSpace(options);\n};\n\n/** @deprecated Use `createSpace`. */\nexport const createSurface = async (\n  options: SpaceOptions,\n  brokerOptions: BrokerConnectOptions = {},\n): Promise<SurfaceHandle> => createSpace(options, brokerOptions);\n\nexport const resolveDefaultSpace = async (\n  brokerOptions: BrokerConnectOptions = {},\n): Promise<SpaceHandle> => {\n  const connection = await connectLocalBroker(brokerOptions);\n  return createClient(connection).resolveDefaultSpace();\n};\n\nexport const createTray = async (\n  options: TrayOptions,\n  brokerOptions: CreateTrayOptions = {},\n): Promise<TrayHandle> => {\n  const { space, ...connectOptions } = brokerOptions;\n  const connection = await connectLocalBroker(connectOptions);\n  const spaceHandle = space ? createSpaceHandle(connection, space) : await createClient(connection).resolveDefaultSpace();\n  return spaceHandle.createTray(options);\n};\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":["PROTOCOL_VERSION"],"sources":["../src/client.ts","../src/sdk.ts"],"sourcesContent":["import {\n  PROTOCOL_VERSION,\n  type ClientFrame,\n  type ClientRequestFrame,\n  type ExtensionEnvelope,\n  type Icon,\n  type Menu,\n  type RequestId,\n  type ServerFrame,\n  type SpaceOptions,\n  type SpaceRef,\n  type Tooltip,\n  type TrayBoundsResult,\n  type TrayEvent,\n  type TrayId,\n  type TrayOptions,\n} from \"@opentray/spec\";\n\nexport interface OpenTrayTransport {\n  request(frame: ClientRequestFrame): Promise<ServerFrame>;\n}\n\nexport type BrokerEventFrame = Extract<ServerFrame, { type: \"event\" | \"ext-event\" }>;\n\nexport interface OpenTrayEventSource {\n  onEvent(listener: (frame: BrokerEventFrame) => void): () => void;\n}\n\nexport interface OpenTrayConnection extends OpenTrayTransport, OpenTrayEventSource {}\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\nexport interface EventfulSpaceHandle extends Omit<SpaceHandle, \"createTray\"> {\n  createTray(options: TrayOptions): Promise<EventfulTrayHandle>;\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  setMenu(menu: Menu): Promise<void>;\n  setTooltip(tooltip: Tooltip): Promise<void>;\n  setIcon(icon: Icon): Promise<void>;\n  setTitle(title: string): Promise<void>;\n  loadExtension(options: ExtensionLoadOptions): Promise<void>;\n  commandExtension(ext: string, data: unknown): Promise<void>;\n  requestExtension(ext: string, data: unknown): Promise<ExtensionEnvelope[]>;\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 type TrayScopedEvent = Exclude<TrayEvent, { type: \"ready\" }>;\nexport type TrayEventType = TrayScopedEvent[\"type\"];\nexport type TrayEventByType<TEvent extends TrayEventType> = Extract<TrayScopedEvent, { type: TEvent }>;\n\nexport interface EventfulTrayHandle extends TrayHandle {\n  extend<TCapability extends object, TOptions = undefined>(\n    extension: TrayExtension<TCapability, TOptions>,\n    options?: TOptions,\n  ): EventfulTrayHandle & TCapability;\n  listenExtension<TData = unknown>(\n    ext: string,\n    handler: (event: ExtensionEnvelope<TData>) => void,\n  ): () => void;\n  listen<TEvent extends TrayEventType>(\n    event: TEvent,\n    handler: (event: TrayEventByType<TEvent>) => void,\n  ): () => void;\n  onMenuClick(handler: (event: TrayEventByType<\"menuClick\">) => void): () => void;\n  onTrayClick(handler: (event: TrayEventByType<\"trayClick\">) => void): () => void;\n  onTrayDoubleClick(handler: (event: TrayEventByType<\"trayDoubleClick\">) => void): () => 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  request(data: unknown): Promise<ExtensionEnvelope[]>;\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 interface OpenTrayEventfulClient extends Omit<OpenTrayClient, \"createSpace\" | \"resolveDefaultSpace\" | \"createSurface\"> {\n  createSpace(options: SpaceOptions): Promise<EventfulSpaceHandle>;\n  resolveDefaultSpace(): Promise<EventfulSpaceHandle>;\n  /** @deprecated Use `createSpace`. */\n  createSurface(options: SpaceOptions): Promise<EventfulSpaceHandle>;\n}\n\nexport function createClient(\n  transport: OpenTrayConnection,\n  options?: CreateClientOptions,\n): OpenTrayEventfulClient;\nexport function createClient(transport: OpenTrayTransport, options?: CreateClientOptions): OpenTrayClient;\nexport function createClient(\n  transport: OpenTrayTransport,\n  options: CreateClientOptions = {},\n): OpenTrayClient | OpenTrayEventfulClient {\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 function createSpaceHandle(\n  transport: OpenTrayConnection,\n  space: SpaceRef,\n  nextRequestId?: () => RequestId,\n): EventfulSpaceHandle;\nexport function createSpaceHandle(\n  transport: OpenTrayTransport,\n  space: SpaceRef,\n  nextRequestId?: () => RequestId,\n): SpaceHandle;\nexport function createSpaceHandle(\n  transport: OpenTrayTransport,\n  space: SpaceRef,\n  nextRequestId: () => RequestId = createRequestIdFactory(\"opentray\"),\n): SpaceHandle | EventfulSpaceHandle {\n  return {\n    space,\n    async createTray(options: TrayOptions): Promise<TrayHandle | EventfulTrayHandle> {\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\n/** @deprecated Use `createSpaceHandle`. */\nexport const createSurfaceHandle = createSpaceHandle;\n\nexport function createTrayHandle(\n  transport: OpenTrayConnection,\n  space: SpaceRef,\n  trayId: TrayId,\n  nextRequestId?: () => RequestId,\n): EventfulTrayHandle;\nexport function createTrayHandle(\n  transport: OpenTrayTransport,\n  space: SpaceRef,\n  trayId: TrayId,\n  nextRequestId?: () => RequestId,\n): TrayHandle;\nexport function createTrayHandle(\n  transport: OpenTrayTransport,\n  space: SpaceRef,\n  trayId: TrayId,\n  nextRequestId: () => RequestId = createRequestIdFactory(\"opentray\"),\n): TrayHandle | EventfulTrayHandle {\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 setMenu(menu: Menu): Promise<void> {\n      const requestId = nextRequestId();\n      const response = await transport.request({\n        type: \"set-tray-menu\",\n        requestId,\n        spaceId: space.spaceId,\n        trayId,\n        menu,\n      });\n      expectResponse(response, requestId, \"ack\");\n    },\n    async setTooltip(tooltip: Tooltip): Promise<void> {\n      const requestId = nextRequestId();\n      const response = await transport.request({\n        type: \"set-tray-tooltip\",\n        requestId,\n        spaceId: space.spaceId,\n        trayId,\n        tooltip,\n      });\n      expectResponse(response, requestId, \"ack\");\n    },\n    async setIcon(icon: Icon): Promise<void> {\n      const requestId = nextRequestId();\n      const response = await transport.request({\n        type: \"set-tray-icon\",\n        requestId,\n        spaceId: space.spaceId,\n        trayId,\n        icon,\n      });\n      expectResponse(response, requestId, \"ack\");\n    },\n    async setTitle(title: string): Promise<void> {\n      const requestId = nextRequestId();\n      const response = await transport.request({\n        type: \"set-tray-title\",\n        requestId,\n        spaceId: space.spaceId,\n        trayId,\n        title,\n      });\n      expectResponse(response, requestId, \"ack\");\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      await this.requestExtension(ext, data);\n    },\n    async requestExtension(ext: string, data: unknown): Promise<ExtensionEnvelope[]> {\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      if (response.type === \"ack\") {\n        expectResponse(response, requestId, \"ack\");\n        return [];\n      }\n      return expectResponse(response, requestId, \"ext-command-result\").events;\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  if (!isOpenTrayEventSource(transport)) {\n    return handle;\n  }\n  return attachEventfulTrayHandle(handle, transport, nextMountId);\n}\n\nconst attachEventfulTrayHandle = (\n  handle: TrayHandle,\n  source: OpenTrayEventSource,\n  nextMountId: (extensionName: string) => string,\n): EventfulTrayHandle => {\n  const listen: EventfulTrayHandle[\"listen\"] = (event, handler) =>\n    source.onEvent((frame) => {\n      if (frame.type !== \"event\" || frame.event.type !== event) {\n        return;\n      }\n      if (!isOwnedTrayEvent(frame.event, handle.space.spaceId, handle.trayId)) {\n        return;\n      }\n      handler(frame.event as TrayEventByType<typeof event>);\n    });\n\n  const eventful: EventfulTrayHandle = {\n    ...handle,\n    listenExtension<TData = unknown>(ext: string, handler: (event: ExtensionEnvelope<TData>) => void) {\n      return source.onEvent((frame) => {\n        if (frame.type !== \"ext-event\" || frame.ext !== ext) {\n          return;\n        }\n        if (frame.spaceId !== handle.space.spaceId || frame.trayId !== handle.trayId) {\n          return;\n        }\n        handler({\n          scope: { spaceId: frame.spaceId, trayId: frame.trayId, ext: frame.ext },\n          data: frame.data as TData,\n        });\n      });\n    },\n    listen,\n    onMenuClick(handler) {\n      return listen(\"menuClick\", handler);\n    },\n    onTrayClick(handler) {\n      return listen(\"trayClick\", handler);\n    },\n    onTrayDoubleClick(handler) {\n      return listen(\"trayDoubleClick\", handler);\n    },\n    extend<TCapability extends object, TOptions = undefined>(\n      extension: TrayExtension<TCapability, TOptions>,\n      options?: TOptions,\n    ): EventfulTrayHandle & TCapability {\n      const context = createTrayExtensionContext(eventful, extension, options, nextMountId);\n      const capability = extension.extend(eventful, context, options);\n      return Object.assign({}, eventful, capability);\n    },\n  };\n  return eventful;\n};\n\nconst isOwnedTrayEvent = (event: TrayEvent, spaceId: string, trayId: string): event is TrayScopedEvent =>\n  event.type !== \"ready\" && event.spaceId === spaceId && event.trayId === trayId;\n\nconst isOpenTrayEventSource = (transport: OpenTrayTransport): transport is OpenTrayConnection =>\n  \"onEvent\" in transport && typeof transport.onEvent === \"function\";\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    async request(data: unknown): Promise<ExtensionEnvelope[]> {\n      await ensureLoaded();\n      return tray.requestExtension(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 \"ext-command-result\":\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","import type { SpaceOptions, SpaceRef, TrayOptions } from \"@opentray/spec\";\n\nimport {\n  createClient,\n  createSpaceHandle,\n  type EventfulSpaceHandle,\n  type EventfulTrayHandle,\n  type SurfaceHandle,\n} from \"./client\";\nimport { connectLocalBroker } from \"./local-broker\";\n\nexport interface BrokerConnectOptions {\n  endpoint?: string;\n  homeDir?: string;\n  packageVersion?: string;\n  protocolVersion?: number;\n  clientVersion?: string;\n  autoStart?: boolean;\n}\n\nexport interface CreateTrayOptions extends BrokerConnectOptions {\n  space?: SpaceRef;\n}\n\nexport const createSpace = async (\n  options: SpaceOptions,\n  brokerOptions: BrokerConnectOptions = {},\n): Promise<EventfulSpaceHandle> => {\n  const connection = await connectLocalBroker(brokerOptions);\n  return createClient(connection).createSpace(options);\n};\n\n/** @deprecated Use `createSpace`. */\nexport const createSurface = async (\n  options: SpaceOptions,\n  brokerOptions: BrokerConnectOptions = {},\n): Promise<SurfaceHandle> => createSpace(options, brokerOptions);\n\nexport const resolveDefaultSpace = async (\n  brokerOptions: BrokerConnectOptions = {},\n): Promise<EventfulSpaceHandle> => {\n  const connection = await connectLocalBroker(brokerOptions);\n  return createClient(connection).resolveDefaultSpace();\n};\n\nexport const createTray = async (\n  options: TrayOptions,\n  brokerOptions: CreateTrayOptions = {},\n): Promise<EventfulTrayHandle> => {\n  const { space, ...connectOptions } = brokerOptions;\n  const connection = await connectLocalBroker(connectOptions);\n  const spaceHandle = space ? createSpaceHandle(connection, space) : await createClient(connection).resolveDefaultSpace();\n  return spaceHandle.createTray(options);\n};\n"],"mappings":"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"}

package/dist/{local-broker-C9siWyRh.mjs → local-broker-BMxjb-eO.mjs}

@@ -1,12 +1,35 @@
 import { createRequire } from "node:module";
-import { PROTOCOL_VERSION, createBrokerEndpointIdentity, formatUnixSocketPath, formatWindowsPipeName, parseServerFrame } from "@opentray/spec";
+import { PROTOCOL_VERSION, createBrokerEndpointIdentity, formatUnixSocketPath, formatWindowsPipeName, parseServerFrame, sanitizeCallerLabel } from "@opentray/spec";
 import { createConnection } from "node:net";
 import { homedir } from "node:os";
 import { fileURLToPath } from "node:url";
+import { basename, dirname, join } from "node:path";
 import { constants } from "node:fs";
 import { access, chmod, mkdir, open, readFile, rm, unlink, writeFile } from "node:fs/promises";
 import { spawn } from "node:child_process";
-import { dirname, join } from "node:path";
+//#region src/daemon/caller-label.ts
+/**
+* Derives a caller label using the precedence: explicit > npm_package_name >
+* script basename > neutral default. The result is always sanitized to a
+* filesystem- and process-safe component, so callers can use it directly in
+* endpoint identity, runtime directories, and process titles.
+*/
+const resolveCallerLabel = (options = {}) => {
+	const env = options.env ?? process.env;
+	const argv = options.argv ?? process.argv;
+	const candidates = [];
+	if (options.explicit !== void 0 && options.explicit.length > 0) candidates.push(options.explicit);
+	const npmName = options.npmPackageName ?? env.npm_package_name;
+	if (typeof npmName === "string" && npmName.length > 0) candidates.push(npmName);
+	const scriptPath = options.scriptPath ?? argv[1];
+	if (typeof scriptPath === "string" && scriptPath.length > 0) candidates.push(basename(scriptPath));
+	for (const candidate of candidates) {
+		const sanitized = sanitizeCallerLabel(candidate);
+		if (sanitized.length > 0) return sanitized;
+	}
+	return sanitizeCallerLabel(void 0);
+};
+//#endregion
 //#region src/daemon/native-target.ts
 const resolveBrokerNativeTarget = (platform = process.platform, arch = process.arch) => {
 	const packageOs = platformToPackageOs(platform);
@@ -78,7 +101,9 @@ const commandForBinary = (binary, paths, cwd) => {
 			"--package-version",
 			paths.packageVersion,
 			"--protocol-version",
-			`${paths.protocolVersion}`
+			`${paths.protocolVersion}`,
+			"--caller-label",
+			paths.callerLabel
 		]
 	};
 	if (cwd !== void 0) command.cwd = cwd;
@@ -115,8 +140,14 @@ const findWorkspaceRoot = async (start) => {
 		current = parent;
 	}
 };
+const resolveDevBrokerBinaryPath = (workspaceRoot, platform = process.platform) => join(workspaceRoot, "target", "debug", platform === "win32" ? "opentray.exe" : "opentray");
+const terminateWorkspaceDevBrokerProcess = async (workspaceRoot, platform = process.platform) => {
+	if (platform !== "win32") return;
+	await terminateWindowsProcessByExecutable(resolveDevBrokerBinaryPath(workspaceRoot, platform));
+};
 const ensureDevBrokerBinary = async (workspaceRoot) => {
-	const binary = join(workspaceRoot, "target", "debug", process.platform === "win32" ? "opentray.exe" : "opentray");
+	const binary = resolveDevBrokerBinaryPath(workspaceRoot);
+	await terminateWorkspaceDevBrokerProcess(workspaceRoot);
 	await runCargoBuild(workspaceRoot);
 	return binary;
 };
@@ -146,6 +177,45 @@ const exists = async (path) => {
 		return false;
 	}
 };
+const terminateWindowsProcessByExecutable = (binary) => new Promise((resolve, reject) => {
+	const child = spawn("powershell.exe", [
+		"-NoProfile",
+		"-NonInteractive",
+		"-ExecutionPolicy",
+		"Bypass",
+		"-Command",
+		String.raw`
+$ErrorActionPreference = 'Stop'
+$target = [System.IO.Path]::GetFullPath(${powerShellString(binary)})
+$processes = @(Get-CimInstance Win32_Process -Filter "Name = 'opentray.exe'" | Where-Object {
+  $_.ExecutablePath -and ([System.IO.Path]::GetFullPath($_.ExecutablePath) -ieq $target)
+})
+foreach ($process in $processes) {
+  Stop-Process -Id $process.ProcessId -Force -ErrorAction Stop
+}
+foreach ($process in $processes) {
+  Wait-Process -Id $process.ProcessId -Timeout 5 -ErrorAction SilentlyContinue
+}
+`
+	], { stdio: [
+		"ignore",
+		"ignore",
+		"pipe"
+	] });
+	let stderr = "";
+	child.stderr?.on("data", (chunk) => {
+		stderr += String(chunk);
+	});
+	child.once("error", reject);
+	child.once("exit", (code) => {
+		if (code === 0) {
+			resolve();
+			return;
+		}
+		reject(/* @__PURE__ */ new Error(`failed to stop running dev broker before cargo build: ${stderr.trim() || code}`));
+	});
+});
+const powerShellString = (value) => `'${value.replace(/'/g, "''")}'`;
 const isNodeError$1 = (error) => error instanceof Error && "code" in error;
 //#endregion
 //#region src/daemon/lifecycle.ts
@@ -163,7 +233,8 @@ const createNodeDaemonDriver = (cliEntrypoint) => ({
 				...process.env,
 				OPENTRAY_DAEMON_HOME: paths.homeDir,
 				OPENTRAY_DAEMON_PACKAGE_VERSION: paths.packageVersion,
-				OPENTRAY_DAEMON_CLI_ENTRYPOINT: cliEntrypoint
+				OPENTRAY_DAEMON_CLI_ENTRYPOINT: cliEntrypoint,
+				OPENTRAY_DAEMON_CALLER_LABEL: paths.callerLabel
 			},
 			stdio: resolveBrokerStdio(process.env[DAEMON_STDIO_ENV])
 		});
@@ -315,15 +386,19 @@ const readPackageVersion = async (packageJsonUrl) => {
 const isPackageJsonWithVersion = (value) => typeof value === "object" && value !== null && !Array.isArray(value) && "version" in value && typeof value.version === "string";
 //#endregion
 //#region src/daemon/paths.ts
-const resolveDaemonPaths = ({ homeDir, packageVersion, platform = process.platform }) => {
-	const identity = createBrokerEndpointIdentity({ packageVersion });
+const resolveDaemonPaths = ({ homeDir, packageVersion, callerLabel, platform = process.platform }) => {
+	const identity = createBrokerEndpointIdentity(callerLabel === void 0 ? { packageVersion } : {
+		packageVersion,
+		callerLabel
+	});
 	const normalizedHome = homeDir.replace(/[\\/]+$/u, "");
-	const stateRoot = `${normalizedHome}/.opentray/${identity.packageVersion}`;
+	const stateRoot = `${normalizedHome}/.opentray/${identity.packageVersion}/${identity.callerLabel}`;
 	const runtimeDir = `${stateRoot}/runtime`;
 	const endpoint = platform === "win32" ? formatWindowsPipeName(identity) : formatUnixSocketPath(normalizedHome, identity);
 	return {
 		homeDir: normalizedHome,
 		packageVersion: identity.packageVersion,
+		callerLabel: identity.callerLabel,
 		protocolVersion: identity.protocolVersion,
 		stateRoot,
 		runtimeDir,
@@ -339,9 +414,11 @@ const packageJsonUrl = new URL("../package.json", import.meta.url);
 const connectLocalBroker = async (options = {}) => {
 	const packageVersion = options.packageVersion ?? await readPackageVersion(packageJsonUrl);
 	const clientVersion = options.clientVersion ?? packageVersion;
+	const callerLabel = options.callerLabel ?? resolveCallerLabel();
 	const paths = resolveDaemonPaths({
 		homeDir: options.homeDir ?? process.env.OPENTRAY_HOME ?? homedir(),
-		packageVersion
+		packageVersion,
+		callerLabel
 	});
 	const endpoint = options.endpoint ?? paths.endpoint;
 	const autoStart = options.autoStart ?? endpoint === paths.endpoint;
@@ -353,13 +430,14 @@ const connectLocalBroker = async (options = {}) => {
 			driver: options.daemonDriver ?? createNodeDaemonDriver(cliEntrypoint)
 		});
 	}
-	const connection = new LocalBrokerConnection(await connectSocket(endpoint), endpoint);
+	const connection = new LocalBrokerConnection(await connectSocket(endpoint), endpoint, callerLabel);
 	await connection.init(clientVersion, options.protocolVersion ?? PROTOCOL_VERSION);
 	return connection;
 };
 var LocalBrokerConnection = class {
 	socket;
 	endpoint;
+	callerLabel;
 	sessionId = "";
 	/** @deprecated Use `sessionId`. */
 	leaseId = "";
@@ -367,9 +445,10 @@ var LocalBrokerConnection = class {
 	listeners = /* @__PURE__ */ new Set();
 	pending = /* @__PURE__ */ new Map();
 	ready;
-	constructor(socket, endpoint) {
+	constructor(socket, endpoint, callerLabel) {
 		this.socket = socket;
 		this.endpoint = endpoint;
+		this.callerLabel = callerLabel;
 		socket.setEncoding("utf8");
 		socket.on("data", (chunk) => {
 			this.consume(String(chunk));
@@ -433,7 +512,7 @@ var LocalBrokerConnection = class {
 	dispatchLine(line) {
 		const parsed = parseServerFrame(line);
 		if (!parsed.ok || parsed.frame === void 0) {
-			this.rejectAll(new Error(parsed.error ?? "invalid server frame"));
+			this.rejectAll(/* @__PURE__ */ new Error(`${parsed.error ?? "invalid server frame"}: ${line}`));
 			return;
 		}
 		this.dispatchFrame(parsed.frame);
@@ -451,8 +530,12 @@ var LocalBrokerConnection = class {
 				this.pending.delete(frame.requestId);
 				return;
 			}
-			this.ready?.reject(error);
-			this.ready = void 0;
+			if (this.ready) {
+				this.ready.reject(error);
+				this.ready = void 0;
+				return;
+			}
+			this.rejectAll(error);
 			return;
 		}
 		const requestId = responseRequestId(frame);
@@ -488,6 +571,7 @@ const responseRequestId = (frame) => {
 		case "tray-created":
 		case "tray-bounds":
 		case "ack":
+		case "ext-command-result":
 		case "daemon-health": return frame.requestId;
 		case "ready":
 		case "event":
@@ -502,4 +586,4 @@ const resolveCliEntrypoint = () => {
 //#endregion
 export { inspectDaemon as a, stopDaemon as c, createNodeDaemonDriver as i, resolveDaemonPaths as n, restartDaemon as o, readPackageVersion as r, startDaemon as s, connectLocalBroker as t };
 
-//# sourceMappingURL=local-broker-C9siWyRh.mjs.map
+//# sourceMappingURL=local-broker-BMxjb-eO.mjs.map

package/dist/local-broker-BMxjb-eO.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-broker-BMxjb-eO.mjs","names":["isNodeError"],"sources":["../src/daemon/caller-label.ts","../src/daemon/native-target.ts","../src/daemon/broker-command.ts","../src/daemon/lifecycle.ts","../src/daemon/package-version.ts","../src/daemon/paths.ts","../src/local-broker.ts"],"sourcesContent":["import { basename } from \"node:path\";\n\nimport { sanitizeCallerLabel } from \"@opentray/spec\";\n\nexport interface CallerLabelSources {\n  /** Explicit developer-provided label, highest precedence. */\n  readonly explicit?: string;\n  /** `npm_package_name` environment value. */\n  readonly npmPackageName?: string;\n  /** Script path resolved from `process.argv[1]` or equivalent. */\n  readonly scriptPath?: string;\n}\n\nexport interface ResolveCallerLabelOptions extends Partial<CallerLabelSources> {\n  env?: NodeJS.ProcessEnv;\n  argv?: readonly string[];\n}\n\n/**\n * Derives a caller label using the precedence: explicit > npm_package_name >\n * script basename > neutral default. The result is always sanitized to a\n * filesystem- and process-safe component, so callers can use it directly in\n * endpoint identity, runtime directories, and process titles.\n */\nexport const resolveCallerLabel = (options: ResolveCallerLabelOptions = {}): string => {\n  const env = options.env ?? process.env;\n  const argv = options.argv ?? process.argv;\n\n  const candidates: string[] = [];\n  if (options.explicit !== undefined && options.explicit.length > 0) {\n    candidates.push(options.explicit);\n  }\n  const npmName = options.npmPackageName ?? env.npm_package_name;\n  if (typeof npmName === \"string\" && npmName.length > 0) {\n    candidates.push(npmName);\n  }\n  const scriptPath = options.scriptPath ?? argv[1];\n  if (typeof scriptPath === \"string\" && scriptPath.length > 0) {\n    candidates.push(basename(scriptPath));\n  }\n\n  for (const candidate of candidates) {\n    const sanitized = sanitizeCallerLabel(candidate);\n    if (sanitized.length > 0) {\n      return sanitized;\n    }\n  }\n\n  return sanitizeCallerLabel(undefined);\n};\n","export type BrokerPackageOs = \"darwin\" | \"linux\" | \"windows\";\nexport type BrokerArch = \"arm64\" | \"x64\";\n\nexport interface BrokerNativeTarget {\n  packageName: string;\n  binaryRelativePath: string;\n}\n\nexport const resolveBrokerNativeTarget = (\n  platform: string = process.platform,\n  arch: string = process.arch,\n): BrokerNativeTarget => {\n  const packageOs = platformToPackageOs(platform);\n  const nativeArch = normalizeArch(arch);\n  return {\n    packageName: `@opentray/${packageOs}-${nativeArch}`,\n    binaryRelativePath: `bin/${packageOs === \"windows\" ? \"opentray.exe\" : \"opentray\"}`,\n  };\n};\n\nconst platformToPackageOs = (platform: string): BrokerPackageOs => {\n  switch (platform) {\n    case \"darwin\":\n    case \"linux\":\n      return platform;\n    case \"win32\":\n      return \"windows\";\n    default:\n      throw new MissingPlatformBrokerBinaryError(\n        `unsupported OpenTray broker platform: ${platform}`,\n        platform,\n        process.arch,\n      );\n  }\n};\n\nconst normalizeArch = (arch: string): BrokerArch => {\n  switch (arch) {\n    case \"arm64\":\n    case \"x64\":\n      return arch;\n    default:\n      throw new MissingPlatformBrokerBinaryError(\n        `unsupported OpenTray broker architecture: ${arch}`,\n        process.platform,\n        arch,\n      );\n  }\n};\n\nexport class MissingPlatformBrokerBinaryError extends Error {\n  readonly code = \"OPENTRAY_MISSING_PLATFORM_BROKER_BINARY\";\n  readonly platform: string;\n  readonly arch: string;\n  readonly packageName: string | undefined;\n  readonly binaryPath: string | undefined;\n\n  constructor(\n    message: string,\n    platform: string,\n    arch: string,\n    options: {\n      packageName?: string;\n      binaryPath?: string;\n      cause?: unknown;\n    } = {},\n  ) {\n    super(message, options.cause === undefined ? undefined : { cause: options.cause });\n    this.name = \"MissingPlatformBrokerBinaryError\";\n    this.platform = platform;\n    this.arch = arch;\n    this.packageName = options.packageName;\n    this.binaryPath = options.binaryPath;\n  }\n}\n","import { access, chmod } from \"node:fs/promises\";\nimport { constants } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { createRequire } from \"node:module\";\nimport { fileURLToPath } from \"node:url\";\nimport { spawn } from \"node:child_process\";\n\nimport type { DaemonPaths } from \"./paths\";\nimport { MissingPlatformBrokerBinaryError, resolveBrokerNativeTarget } from \"./native-target\";\n\nexport interface BrokerCommand {\n  command: string;\n  args: string[];\n  cwd?: string;\n}\n\nconst sourceUrl = import.meta.url;\nconst requireFromSource = createRequire(sourceUrl);\n\nexport interface ResolveBrokerCommandOptions {\n  env?: NodeJS.ProcessEnv;\n  platform?: NodeJS.Platform;\n  arch?: string;\n  sourceDir?: string;\n  resolvePackageJson?: (packageName: string) => string | undefined;\n  findWorkspaceRoot?: (start: string) => Promise<string | undefined>;\n  ensureDevBrokerBinary?: (workspaceRoot: string) => Promise<string>;\n}\n\nexport const resolveBrokerCommand = async (\n  paths: DaemonPaths,\n  options: ResolveBrokerCommandOptions = {},\n): Promise<BrokerCommand> => {\n  const env = options.env ?? process.env;\n  const explicit = env.OPENTRAY_BROKER_BIN;\n  if (explicit !== undefined && explicit.length > 0) {\n    return commandForBinary(explicit, paths);\n  }\n\n  const sourceDir = options.sourceDir ?? dirname(fileURLToPath(sourceUrl));\n  const workspaceRoot = await (options.findWorkspaceRoot ?? findWorkspaceRoot)(sourceDir);\n  if (workspaceRoot !== undefined) {\n    const binary = await (options.ensureDevBrokerBinary ?? ensureDevBrokerBinary)(workspaceRoot);\n    return commandForBinary(binary, paths, workspaceRoot);\n  }\n\n  const platform = options.platform ?? process.platform;\n  const arch = options.arch ?? process.arch;\n  const installedBinary = await resolveInstalledBrokerBinary({\n    platform,\n    arch,\n    resolvePackageJson: options.resolvePackageJson ?? resolvePackageJson,\n  });\n  if (installedBinary !== undefined) {\n    return commandForBinary(installedBinary, paths);\n  }\n\n  const target = resolveBrokerNativeTarget(platform, arch);\n  throw new MissingPlatformBrokerBinaryError(\n    `unable to resolve OpenTray broker binary for ${platform}/${arch}; install ${target.packageName} or set OPENTRAY_BROKER_BIN`,\n    platform,\n    arch,\n    { packageName: target.packageName },\n  );\n};\n\nconst commandForBinary = (binary: string, paths: DaemonPaths, cwd?: string): BrokerCommand => {\n  const command: BrokerCommand = {\n    command: binary,\n    args: [\n      \"broker\",\n      \"--endpoint\",\n      paths.endpoint,\n      \"--ready-file\",\n      paths.readyFile,\n      \"--package-version\",\n      paths.packageVersion,\n      \"--protocol-version\",\n      `${paths.protocolVersion}`,\n      \"--caller-label\",\n      paths.callerLabel,\n    ],\n  };\n  if (cwd !== undefined) {\n    command.cwd = cwd;\n  }\n  return command;\n};\n\ninterface ResolveInstalledBrokerBinaryOptions {\n  platform: NodeJS.Platform;\n  arch: string;\n  resolvePackageJson: (packageName: string) => string | undefined;\n}\n\nexport const resolveInstalledBrokerBinary = async ({\n  platform,\n  arch,\n  resolvePackageJson,\n}: ResolveInstalledBrokerBinaryOptions): Promise<string | undefined> => {\n  const target = resolveBrokerNativeTarget(platform, arch);\n  const packageJsonPath = resolvePackageJson(target.packageName);\n  if (packageJsonPath === undefined) {\n    return undefined;\n  }\n\n  const binary = join(dirname(packageJsonPath), target.binaryRelativePath);\n  if (!(await exists(binary))) {\n    throw new MissingPlatformBrokerBinaryError(\n      `OpenTray broker package ${target.packageName} is installed but missing ${target.binaryRelativePath}`,\n      platform,\n      arch,\n      {\n        packageName: target.packageName,\n        binaryPath: binary,\n      },\n    );\n  }\n\n  if (platform !== \"win32\") {\n    await chmod(binary, 0o755);\n  }\n\n  return binary;\n};\n\nconst resolvePackageJson = (packageName: string): string | undefined => {\n  try {\n    return requireFromSource.resolve(`${packageName}/package.json`);\n  } catch (error) {\n    if (isNodeError(error) && error.code === \"MODULE_NOT_FOUND\") {\n      return undefined;\n    }\n    throw error;\n  }\n};\n\nconst findWorkspaceRoot = async (start: string): Promise<string | undefined> => {\n  let current = start;\n  while (true) {\n    if (await exists(join(current, \"Cargo.toml\"))) {\n      if (await exists(join(current, \"crates\", \"opentray-bin\", \"Cargo.toml\"))) {\n        return current;\n      }\n    }\n\n    const parent = dirname(current);\n    if (parent === current) {\n      return undefined;\n    }\n    current = parent;\n  }\n};\n\nexport const resolveDevBrokerBinaryPath = (\n  workspaceRoot: string,\n  platform: NodeJS.Platform = process.platform,\n): string =>\n  join(workspaceRoot, \"target\", \"debug\", platform === \"win32\" ? \"opentray.exe\" : \"opentray\");\n\nexport const terminateWorkspaceDevBrokerProcess = async (\n  workspaceRoot: string,\n  platform: NodeJS.Platform = process.platform,\n): Promise<void> => {\n  if (platform !== \"win32\") {\n    return;\n  }\n  await terminateWindowsProcessByExecutable(resolveDevBrokerBinaryPath(workspaceRoot, platform));\n};\n\nconst ensureDevBrokerBinary = async (workspaceRoot: string): Promise<string> => {\n  const binary = resolveDevBrokerBinaryPath(workspaceRoot);\n  await terminateWorkspaceDevBrokerProcess(workspaceRoot);\n  await runCargoBuild(workspaceRoot);\n  return binary;\n};\n\nconst runCargoBuild = (workspaceRoot: string): Promise<void> =>\n  new Promise((resolve, reject) => {\n    const child = spawn(\"cargo\", [\"build\", \"-p\", \"opentray-bin\"], {\n      cwd: workspaceRoot,\n      stdio: process.env.OPENTRAY_BROKER_BUILD_LOGS === \"1\" ? \"inherit\" : \"ignore\",\n    });\n    child.once(\"error\", reject);\n    child.once(\"exit\", (code) => {\n      if (code === 0) {\n        resolve();\n        return;\n      }\n      reject(new Error(`cargo build -p opentray-bin failed with code ${code ?? \"unknown\"}`));\n    });\n  });\n\nconst exists = async (path: string): Promise<boolean> => {\n  try {\n    await access(path, constants.F_OK);\n    return true;\n  } catch {\n    return false;\n  }\n};\n\nconst terminateWindowsProcessByExecutable = (binary: string): Promise<void> =>\n  new Promise((resolve, reject) => {\n    const script = String.raw`\n$ErrorActionPreference = 'Stop'\n$target = [System.IO.Path]::GetFullPath(${powerShellString(binary)})\n$processes = @(Get-CimInstance Win32_Process -Filter \"Name = 'opentray.exe'\" | Where-Object {\n  $_.ExecutablePath -and ([System.IO.Path]::GetFullPath($_.ExecutablePath) -ieq $target)\n})\nforeach ($process in $processes) {\n  Stop-Process -Id $process.ProcessId -Force -ErrorAction Stop\n}\nforeach ($process in $processes) {\n  Wait-Process -Id $process.ProcessId -Timeout 5 -ErrorAction SilentlyContinue\n}\n`;\n    const child = spawn(\n      \"powershell.exe\",\n      [\"-NoProfile\", \"-NonInteractive\", \"-ExecutionPolicy\", \"Bypass\", \"-Command\", script],\n      { stdio: [\"ignore\", \"ignore\", \"pipe\"] },\n    );\n    let stderr = \"\";\n    child.stderr?.on(\"data\", (chunk: Buffer | string) => {\n      stderr += String(chunk);\n    });\n    child.once(\"error\", reject);\n    child.once(\"exit\", (code) => {\n      if (code === 0) {\n        resolve();\n        return;\n      }\n      reject(new Error(`failed to stop running dev broker before cargo build: ${stderr.trim() || code}`));\n    });\n  });\n\nconst powerShellString = (value: string): string => `'${value.replace(/'/g, \"''\")}'`;\n\nconst isNodeError = (error: unknown): error is NodeJS.ErrnoException =>\n  error instanceof Error && \"code\" in error;\n","import { constants } from \"node:fs\";\nimport { mkdir, open, readFile, rm, unlink, writeFile } from \"node:fs/promises\";\nimport { spawn } from \"node:child_process\";\n\nimport { resolveBrokerCommand } from \"./broker-command\";\nimport type { DaemonPaths } from \"./paths\";\n\nconst DAEMON_STDIO_ENV = \"OPENTRAY_DAEMON_STDIO\";\n\nexport type DaemonStartResult =\n  | { status: \"started\"; pid: number; paths: DaemonPaths }\n  | { status: \"already-running\"; pid: number; paths: DaemonPaths };\n\nexport type DaemonStopResult =\n  | { status: \"stopped\"; pid: number; paths: DaemonPaths }\n  | { status: \"not-running\"; paths: DaemonPaths };\n\nexport type DaemonInspectResult =\n  | { status: \"running\"; pid: number; paths: DaemonPaths }\n  | { status: \"not-running\"; paths: DaemonPaths; stalePid?: number };\n\nexport interface DaemonDriver {\n  isAlive(pid: number): Promise<boolean>;\n  spawnBroker(paths: DaemonPaths): Promise<number>;\n  stop(pid: number): Promise<void>;\n}\n\nexport interface StartDaemonOptions {\n  paths: DaemonPaths;\n  driver: DaemonDriver;\n  lockTimeoutMs?: number;\n}\n\nexport interface StopDaemonOptions {\n  paths: DaemonPaths;\n  driver: DaemonDriver;\n}\n\nexport interface InspectDaemonOptions {\n  paths: DaemonPaths;\n  driver: DaemonDriver;\n}\n\nexport const createNodeDaemonDriver = (cliEntrypoint: string): DaemonDriver => ({\n  async isAlive(pid) {\n    return isProcessAlive(pid);\n  },\n  async spawnBroker(paths) {\n    const broker = await resolveBrokerCommand(paths);\n    // The caller label flows to the broker via both a CLI flag and an env var.\n    // The broker uses it to bind the per-caller endpoint and to set its own\n    // process title so task managers show the owning application.\n    const child = spawn(broker.command, broker.args, {\n      cwd: broker.cwd,\n      detached: true,\n      env: {\n        ...process.env,\n        OPENTRAY_DAEMON_HOME: paths.homeDir,\n        OPENTRAY_DAEMON_PACKAGE_VERSION: paths.packageVersion,\n        OPENTRAY_DAEMON_CLI_ENTRYPOINT: cliEntrypoint,\n        OPENTRAY_DAEMON_CALLER_LABEL: paths.callerLabel,\n      },\n      stdio: resolveBrokerStdio(process.env[DAEMON_STDIO_ENV]),\n    });\n\n    child.unref();\n    return child.pid ?? 0;\n  },\n  async stop(pid) {\n    process.kill(pid, \"SIGTERM\");\n  },\n});\n\nexport const resolveBrokerStdio = (\n  value: string | undefined,\n): \"ignore\" | \"inherit\" => {\n  return value === \"inherit\" ? \"inherit\" : \"ignore\";\n};\n\nexport const startDaemon = async ({\n  paths,\n  driver,\n  lockTimeoutMs = 1_000,\n}: StartDaemonOptions): Promise<DaemonStartResult> => {\n  await mkdir(paths.runtimeDir, { recursive: true });\n\n  const lock = await acquireLock(paths.lockFile, lockTimeoutMs);\n  try {\n    const existingPid = await readPid(paths.pidFile);\n    if (existingPid !== undefined && (await driver.isAlive(existingPid))) {\n      return { status: \"already-running\", pid: existingPid, paths };\n    }\n\n    await cleanupRuntimeFiles(paths);\n    const pid = await driver.spawnBroker(paths);\n    if (!Number.isInteger(pid) || pid <= 0) {\n      throw new Error(\"daemon broker process did not expose a valid pid\");\n    }\n    await writeFile(paths.pidFile, `${pid}\\n`, \"utf8\");\n    await waitForReadyFile(paths.readyFile, driver, pid);\n    return { status: \"started\", pid, paths };\n  } finally {\n    await lock.release();\n  }\n};\n\nexport const stopDaemon = async ({ paths, driver }: StopDaemonOptions): Promise<DaemonStopResult> => {\n  const pid = await readPid(paths.pidFile);\n  if (pid === undefined || !(await driver.isAlive(pid))) {\n    await cleanupRuntimeFiles(paths);\n    return { status: \"not-running\", paths };\n  }\n\n  await driver.stop(pid);\n  await waitUntilStopped(driver, pid);\n  await cleanupRuntimeFiles(paths);\n  return { status: \"stopped\", pid, paths };\n};\n\nexport const restartDaemon = async (options: StartDaemonOptions): Promise<DaemonStartResult> => {\n  await stopDaemon({ paths: options.paths, driver: options.driver });\n  return startDaemon(options);\n};\n\nexport const inspectDaemon = async ({ paths, driver }: InspectDaemonOptions): Promise<DaemonInspectResult> => {\n  const pid = await readPid(paths.pidFile);\n  if (pid !== undefined && (await driver.isAlive(pid))) {\n    return { status: \"running\", pid, paths };\n  }\n\n  await cleanupRuntimeFiles(paths);\n  return pid === undefined\n    ? { status: \"not-running\", paths }\n    : { status: \"not-running\", paths, stalePid: pid };\n};\n\nconst readPid = async (pidFile: string): Promise<number | undefined> => {\n  try {\n    const content = await readFile(pidFile, \"utf8\");\n    const pid = Number.parseInt(content.trim(), 10);\n    return Number.isInteger(pid) && pid > 0 ? pid : undefined;\n  } catch (error) {\n    if (isNodeError(error) && error.code === \"ENOENT\") {\n      return undefined;\n    }\n    throw error;\n  }\n};\n\nconst cleanupRuntimeFiles = async (paths: DaemonPaths): Promise<void> => {\n  await rm(paths.readyFile, { force: true });\n  await rm(paths.pidFile, { force: true });\n  if (process.platform !== \"win32\") {\n    await rm(paths.endpoint, { force: true });\n  }\n};\n\nconst waitUntilStopped = async (driver: DaemonDriver, pid: number): Promise<void> => {\n  for (let attempt = 0; attempt < 20; attempt += 1) {\n    if (!(await driver.isAlive(pid))) {\n      return;\n    }\n    await sleep(50);\n  }\n};\n\nconst waitForReadyFile = async (\n  readyFile: string,\n  driver: DaemonDriver,\n  pid: number,\n): Promise<void> => {\n  for (let attempt = 0; attempt < 40; attempt += 1) {\n    try {\n      await readFile(readyFile, \"utf8\");\n      return;\n    } catch (error) {\n      if (!isNodeError(error) || error.code !== \"ENOENT\") {\n        throw error;\n      }\n      if (!(await driver.isAlive(pid))) {\n        throw new Error(\n          `daemon broker exited before readiness: pid=${pid}; readyFile=${readyFile}; set ${DAEMON_STDIO_ENV}=inherit to inspect broker stderr`,\n        );\n      }\n      await sleep(50);\n    }\n  }\n\n  throw new Error(`timed out waiting for daemon readiness: ${readyFile}`);\n};\n\nconst acquireLock = async (\n  lockFile: string,\n  timeoutMs: number,\n): Promise<{\n  release(): Promise<void>;\n}> => {\n  const deadline = Date.now() + timeoutMs;\n  while (Date.now() <= deadline) {\n    try {\n      const handle = await open(lockFile, constants.O_CREAT | constants.O_EXCL | constants.O_WRONLY);\n      await handle.writeFile(`${process.pid}\\n`, \"utf8\");\n      return {\n        async release() {\n          await handle.close();\n          await unlink(lockFile).catch((error: unknown) => {\n            if (!isNodeError(error) || error.code !== \"ENOENT\") {\n              throw error;\n            }\n          });\n        },\n      };\n    } catch (error) {\n      if (isNodeError(error) && error.code === \"EEXIST\") {\n        await sleep(25);\n        continue;\n      }\n      throw error;\n    }\n  }\n\n  throw new Error(`timed out acquiring daemon lock: ${lockFile}`);\n};\n\nconst isProcessAlive = (pid: number): boolean => {\n  try {\n    process.kill(pid, 0);\n    return true;\n  } catch {\n    return false;\n  }\n};\n\nconst sleep = (ms: number): Promise<void> => new Promise((resolve) => setTimeout(resolve, ms));\n\nconst isNodeError = (error: unknown): error is NodeJS.ErrnoException =>\n  error instanceof Error && \"code\" in error;\n","import { readFile } from \"node:fs/promises\";\n\nexport const readPackageVersion = async (packageJsonUrl: URL): Promise<string> => {\n  const value: unknown = JSON.parse(await readFile(packageJsonUrl, \"utf8\"));\n  if (!isPackageJsonWithVersion(value)) {\n    throw new Error(`package.json is missing a string version: ${packageJsonUrl.href}`);\n  }\n\n  return value.version;\n};\n\nconst isPackageJsonWithVersion = (value: unknown): value is { version: string } =>\n  typeof value === \"object\" &&\n  value !== null &&\n  !Array.isArray(value) &&\n  \"version\" in value &&\n  typeof value.version === \"string\";\n","import { createBrokerEndpointIdentity, formatUnixSocketPath, formatWindowsPipeName } from \"@opentray/spec\";\n\nexport interface DaemonPathOptions {\n  homeDir: string;\n  packageVersion: string;\n  callerLabel?: string;\n  platform?: NodeJS.Platform;\n}\n\nexport interface DaemonPaths {\n  homeDir: string;\n  packageVersion: string;\n  callerLabel: string;\n  protocolVersion: number;\n  stateRoot: string;\n  runtimeDir: string;\n  endpoint: string;\n  pidFile: string;\n  lockFile: string;\n  readyFile: string;\n}\n\nexport const resolveDaemonPaths = ({\n  homeDir,\n  packageVersion,\n  callerLabel,\n  platform = process.platform,\n}: DaemonPathOptions): DaemonPaths => {\n  const identity = createBrokerEndpointIdentity(\n    callerLabel === undefined ? { packageVersion } : { packageVersion, callerLabel },\n  );\n  const normalizedHome = homeDir.replace(/[\\\\/]+$/u, \"\");\n  const stateRoot = `${normalizedHome}/.opentray/${identity.packageVersion}/${identity.callerLabel}`;\n  const runtimeDir = `${stateRoot}/runtime`;\n  const endpoint =\n    platform === \"win32\" ? formatWindowsPipeName(identity) : formatUnixSocketPath(normalizedHome, identity);\n\n  return {\n    homeDir: normalizedHome,\n    packageVersion: identity.packageVersion,\n    callerLabel: identity.callerLabel,\n    protocolVersion: identity.protocolVersion,\n    stateRoot,\n    runtimeDir,\n    endpoint,\n    pidFile: `${runtimeDir}/broker.pid`,\n    lockFile: `${runtimeDir}/broker.lock`,\n    readyFile: `${runtimeDir}/ready.json`,\n  };\n};\n","import { createConnection, type Socket } from \"node:net\";\nimport { homedir } from \"node:os\";\nimport { fileURLToPath } from \"node:url\";\n\nimport {\n  PROTOCOL_VERSION,\n  parseServerFrame,\n  type BrokerEndpointIdentityOptions,\n  type ClientRequestFrame,\n  type RequestId,\n  type ServerFrame,\n} from \"@opentray/spec\";\n\nimport type { OpenTrayTransport } from \"./client\";\nimport { resolveCallerLabel } from \"./daemon/caller-label\";\nimport { createNodeDaemonDriver, startDaemon, type DaemonDriver } from \"./daemon/lifecycle\";\nimport { readPackageVersion } from \"./daemon/package-version\";\nimport { resolveDaemonPaths } from \"./daemon/paths\";\n\nconst packageJsonUrl = new URL(\"../package.json\", import.meta.url);\n\nexport type BrokerEventFrame = Extract<ServerFrame, { type: \"event\" | \"ext-event\" }>;\n\nexport interface LocalBrokerClient extends OpenTrayTransport {\n  readonly endpoint: string;\n  readonly callerLabel: string;\n  readonly sessionId: string;\n  /** @deprecated Use `sessionId`. */\n  readonly leaseId: string;\n  onEvent(listener: (frame: BrokerEventFrame) => void): () => void;\n  close(): Promise<void>;\n}\n\nexport interface ConnectLocalBrokerOptions extends Partial<BrokerEndpointIdentityOptions> {\n  endpoint?: string;\n  homeDir?: string;\n  clientVersion?: string;\n  autoStart?: boolean;\n  daemonDriver?: DaemonDriver;\n  cliEntrypoint?: string;\n  callerLabel?: string;\n}\n\ninterface PendingRequest {\n  resolve(frame: ServerFrame): void;\n  reject(error: Error): void;\n}\n\ninterface BrokerSocket {\n  setEncoding(encoding: BufferEncoding): void;\n  on(event: \"data\", listener: (chunk: Buffer | string) => void): void;\n  on(event: \"error\", listener: (error: Error) => void): void;\n  on(event: \"close\", listener: () => void): void;\n  once(event: \"connect\", listener: () => void): void;\n  once(event: \"error\", listener: (error: Error) => void): void;\n  off(event: \"error\", listener: (error: Error) => void): void;\n  write(data: string): void;\n  end(callback: () => void): void;\n}\n\nexport const connectLocalBroker = async (\n  options: ConnectLocalBrokerOptions = {},\n): Promise<LocalBrokerClient> => {\n  const packageVersion = options.packageVersion ?? (await readPackageVersion(packageJsonUrl));\n  const clientVersion = options.clientVersion ?? packageVersion;\n  const callerLabel =\n    options.callerLabel ?? resolveCallerLabel();\n  const paths = resolveDaemonPaths({\n    homeDir: options.homeDir ?? process.env.OPENTRAY_HOME ?? homedir(),\n    packageVersion,\n    callerLabel,\n  });\n  const endpoint = options.endpoint ?? paths.endpoint;\n  const autoStart = options.autoStart ?? endpoint === paths.endpoint;\n  if (autoStart && endpoint !== paths.endpoint) {\n    throw new Error(\"local broker autoStart requires the derived same-version endpoint\");\n  }\n  if (autoStart) {\n    const cliEntrypoint = options.cliEntrypoint ?? resolveCliEntrypoint();\n    const driver = options.daemonDriver ?? createNodeDaemonDriver(cliEntrypoint);\n    await startDaemon({ paths, driver });\n  }\n  const socket = await connectSocket(endpoint);\n  const connection = new LocalBrokerConnection(socket, endpoint, callerLabel);\n\n  await connection.init(clientVersion, options.protocolVersion ?? PROTOCOL_VERSION);\n  return connection;\n};\n\nclass LocalBrokerConnection implements LocalBrokerClient {\n  readonly endpoint: string;\n  readonly callerLabel: string;\n  sessionId = \"\";\n  /** @deprecated Use `sessionId`. */\n  leaseId = \"\";\n\n  private buffer = \"\";\n  private readonly listeners = new Set<(frame: BrokerEventFrame) => void>();\n  private readonly pending = new Map<RequestId, PendingRequest>();\n  private ready:\n    | {\n        resolve(frame: Extract<ServerFrame, { type: \"ready\" }>): void;\n        reject(error: Error): void;\n      }\n    | undefined;\n\n  constructor(\n    private readonly socket: BrokerSocket,\n    endpoint: string,\n    callerLabel: string,\n  ) {\n    this.endpoint = endpoint;\n    this.callerLabel = callerLabel;\n    socket.setEncoding(\"utf8\");\n    socket.on(\"data\", (chunk: Buffer | string) => {\n      this.consume(String(chunk));\n    });\n    socket.on(\"error\", (error) => {\n      this.rejectAll(error);\n    });\n    socket.on(\"close\", () => {\n      this.rejectAll(new Error(\"broker connection closed\"));\n    });\n  }\n\n  async init(clientVersion: string, protocolVersion: number): Promise<void> {\n    const ready = new Promise<Extract<ServerFrame, { type: \"ready\" }>>((resolve, reject) => {\n      this.ready = { resolve, reject };\n    });\n    this.write({\n      type: \"init\",\n      protocolVersion,\n      clientVersion,\n    });\n    const frame = await ready;\n    this.sessionId = frame.sessionId;\n    this.leaseId = frame.sessionId;\n  }\n\n  async request(frame: ClientRequestFrame): Promise<ServerFrame> {\n    if (this.pending.has(frame.requestId)) {\n      throw new Error(`duplicate requestId: ${frame.requestId}`);\n    }\n\n    const response = new Promise<ServerFrame>((resolve, reject) => {\n      this.pending.set(frame.requestId, { resolve, reject });\n    });\n    this.write(frame);\n    return response;\n  }\n\n  onEvent(listener: (frame: BrokerEventFrame) => void): () => void {\n    this.listeners.add(listener);\n    return () => {\n      this.listeners.delete(listener);\n    };\n  }\n\n  async close(): Promise<void> {\n    this.write({ type: \"exit\" });\n    await new Promise<void>((resolve) => {\n      this.socket.end(resolve);\n    });\n  }\n\n  private consume(chunk: string): void {\n    this.buffer += chunk;\n    while (true) {\n      const newline = this.buffer.indexOf(\"\\n\");\n      if (newline < 0) {\n        return;\n      }\n\n      const line = this.buffer.slice(0, newline).trim();\n      this.buffer = this.buffer.slice(newline + 1);\n      if (line.length > 0) {\n        this.dispatchLine(line);\n      }\n    }\n  }\n\n  private dispatchLine(line: string): void {\n    const parsed = parseServerFrame(line);\n    if (!parsed.ok || parsed.frame === undefined) {\n      this.rejectAll(new Error(`${parsed.error ?? \"invalid server frame\"}: ${line}`));\n      return;\n    }\n\n    this.dispatchFrame(parsed.frame);\n  }\n\n  private dispatchFrame(frame: ServerFrame): void {\n    if (frame.type === \"ready\") {\n      this.ready?.resolve(frame);\n      this.ready = undefined;\n      return;\n    }\n\n    if (frame.type === \"error\") {\n      const error = new Error(`${frame.code}: ${frame.message}`);\n      if (frame.requestId !== undefined) {\n        this.pending.get(frame.requestId)?.reject(error);\n        this.pending.delete(frame.requestId);\n        return;\n      }\n      // An error with no requestId could not be correlated to a specific request.\n      // If the handshake is still pending, reject it; otherwise reject every\n      // pending request so callers fail loudly instead of hanging indefinitely.\n      // (See issue #3: createTray never resolves on a malformed frame.)\n      if (this.ready) {\n        this.ready.reject(error);\n        this.ready = undefined;\n        return;\n      }\n      this.rejectAll(error);\n      return;\n    }\n\n    const requestId = responseRequestId(frame);\n    if (requestId !== undefined) {\n      // Request responses and broker events are separate streams even on one socket.\n      this.pending.get(requestId)?.resolve(frame);\n      this.pending.delete(requestId);\n      return;\n    }\n\n    if (frame.type === \"event\" || frame.type === \"ext-event\") {\n      for (const listener of this.listeners) {\n        listener(frame);\n      }\n    }\n  }\n\n  private write(frame: unknown): void {\n    this.socket.write(`${JSON.stringify(frame)}\\n`);\n  }\n\n  private rejectAll(error: Error): void {\n    this.ready?.reject(error);\n    this.ready = undefined;\n    for (const pending of this.pending.values()) {\n      pending.reject(error);\n    }\n    this.pending.clear();\n  }\n}\n\nconst connectSocket = (endpoint: string): Promise<BrokerSocket> =>\n  new Promise((resolve, reject) => {\n    const socket = createConnection(endpoint);\n    socket.once(\"connect\", () => {\n      socket.off(\"error\", reject);\n      resolve(socket);\n    });\n    socket.once(\"error\", reject);\n  });\n\nconst responseRequestId = (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 \"ext-command-result\":\n    case \"daemon-health\":\n      return frame.requestId;\n    case \"ready\":\n    case \"event\":\n    case \"ext-event\":\n    case \"error\":\n      return undefined;\n  }\n};\n\nconst resolveCliEntrypoint = (): string => {\n  const suffix = fileURLToPath(import.meta.url).endsWith(\".ts\") ? \"cli.ts\" : \"cli.mjs\";\n  return fileURLToPath(new URL(`./${suffix}`, import.meta.url));\n};\n"],"mappings":"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"}

package/dist/node.d.mts

@@ -1,10 +1,11 @@
-import { i as OpenTrayTransport } from "./client-DQn3DLZw.mjs";
+import { u as OpenTrayTransport } from "./client-C27qmRfr.mjs";
 import { BrokerEndpointIdentityOptions, ServerFrame } from "@opentray/spec";
 
 //#region src/daemon/paths.d.ts
 interface DaemonPaths {
   homeDir: string;
   packageVersion: string;
+  callerLabel: string;
   protocolVersion: number;
   stateRoot: string;
   runtimeDir: string;
@@ -27,6 +28,7 @@ type BrokerEventFrame = Extract<ServerFrame, {
 }>;
 interface LocalBrokerClient extends OpenTrayTransport {
   readonly endpoint: string;
+  readonly callerLabel: string;
   readonly sessionId: string;
   /** @deprecated Use `sessionId`. */
   readonly leaseId: string;
@@ -40,6 +42,7 @@ interface ConnectLocalBrokerOptions extends Partial<BrokerEndpointIdentityOption
   autoStart?: boolean;
   daemonDriver?: DaemonDriver;
   cliEntrypoint?: string;
+  callerLabel?: string;
 }
 declare const connectLocalBroker: (options?: ConnectLocalBrokerOptions) => Promise<LocalBrokerClient>;
 //#endregion

package/dist/node.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"node.d.mts","names":[],"sources":["../src/daemon/paths.ts","../src/daemon/lifecycle.ts","../src/local-broker.ts"],"mappings":";;;;UAQiB,WAAA;EACf,OAAA;EACA,cAAA;EACA,eAAA;EACA,SAAA;EACA,UAAA;EACA,QAAA;EACA,OAAA;EACA,QAAA;EACA,SAAA;AAAA;;;UCIe,YAAA;EACf,OAAA,CAAQ,GAAA,WAAc,OAAA;EACtB,WAAA,CAAY,KAAA,EAAO,WAAA,GAAc,OAAA;EACjC,IAAA,CAAK,GAAA,WAAc,OAAA;AAAA;;;KCJT,gBAAA,GAAmB,OAAO,CAAC,WAAA;EAAe,IAAA;AAAA;AAAA,UAErC,iBAAA,SAA0B,iBAAA;EAAA,SAChC,QAAA;EAAA,SACA,SAAA;EFdT;EAAA,SEgBS,OAAA;EACT,OAAA,CAAQ,QAAA,GAAW,KAAA,EAAO,gBAAA;EAC1B,KAAA,IAAS,OAAA;AAAA;AAAA,UAGM,yBAAA,SAAkC,OAAA,CAAQ,6BAAA;EACzD,QAAA;EACA,OAAA;EACA,aAAA;EACA,SAAA;EACA,YAAA,GAAe,YAAA;EACf,aAAA;AAAA;AAAA,cAoBW,kBAAA,GACX,OAAA,GAAS,yBAAA,KACR,OAAA,CAAQ,iBAAA"}
+{"version":3,"file":"node.d.mts","names":[],"sources":["../src/daemon/paths.ts","../src/daemon/lifecycle.ts","../src/local-broker.ts"],"mappings":";;;;UASiB,WAAA;EACf,OAAA;EACA,cAAA;EACA,WAAA;EACA,eAAA;EACA,SAAA;EACA,UAAA;EACA,QAAA;EACA,OAAA;EACA,QAAA;EACA,SAAA;AAAA;;;UCEe,YAAA;EACf,OAAA,CAAQ,GAAA,WAAc,OAAA;EACtB,WAAA,CAAY,KAAA,EAAO,WAAA,GAAc,OAAA;EACjC,IAAA,CAAK,GAAA,WAAc,OAAA;AAAA;;;KCHT,gBAAA,GAAmB,OAAO,CAAC,WAAA;EAAe,IAAA;AAAA;AAAA,UAErC,iBAAA,SAA0B,iBAAA;EAAA,SAChC,QAAA;EAAA,SACA,WAAA;EAAA,SACA,SAAA;EFdT;EAAA,SEgBS,OAAA;EACT,OAAA,CAAQ,QAAA,GAAW,KAAA,EAAO,gBAAA;EAC1B,KAAA,IAAS,OAAA;AAAA;AAAA,UAGM,yBAAA,SAAkC,OAAA,CAAQ,6BAAA;EACzD,QAAA;EACA,OAAA;EACA,aAAA;EACA,SAAA;EACA,YAAA,GAAe,YAAA;EACf,aAAA;EACA,WAAA;AAAA;AAAA,cAoBW,kBAAA,GACX,OAAA,GAAS,yBAAA,KACR,OAAA,CAAQ,iBAAA"}

package/dist/node.mjs

@@ -1,2 +1,2 @@
-import { t as connectLocalBroker } from "./local-broker-C9siWyRh.mjs";
+import { t as connectLocalBroker } from "./local-broker-BMxjb-eO.mjs";
 export { connectLocalBroker };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opentray",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "Developer-facing OpenTray SDK and CLI package.",
   "type": "module",
   "license": "MIT",
@@ -28,7 +28,7 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@opentray/spec": "0.4.1"
+    "@opentray/spec": "0.6.0"
   },
   "devDependencies": {
     "tsdown": "^0.22.1",
@@ -36,12 +36,12 @@
     "vitest": "^4.1.7"
   },
   "optionalDependencies": {
-    "@opentray/darwin-arm64": "0.6.0",
-    "@opentray/darwin-x64": "0.6.0",
-    "@opentray/linux-arm64": "0.6.0",
-    "@opentray/linux-x64": "0.6.0",
-    "@opentray/windows-arm64": "0.6.0",
-    "@opentray/windows-x64": "0.6.0"
+    "@opentray/darwin-arm64": "0.8.0",
+    "@opentray/darwin-x64": "0.8.0",
+    "@opentray/linux-arm64": "0.8.0",
+    "@opentray/linux-x64": "0.8.0",
+    "@opentray/windows-arm64": "0.8.0",
+    "@opentray/windows-x64": "0.8.0"
   },
   "scripts": {
     "build": "tsdown src/index.ts src/node.ts src/cli.ts --format esm --dts",
@@ -49,6 +49,9 @@
     "example:basic": "bun run examples/basic-space.ts",
     "example:daemon-lynx": "bun run examples/daemon-lynx.ts",
     "example:daemon-tray": "bun run examples/daemon-tray.ts",
+    "example:mediaQuery": "bun run examples/media-query-panel.ts",
+    "example:badge": "bun run examples/badge-panel.ts",
+    "example:placement": "bun run examples/placement-panel.ts",
     "example:tray-panel": "bun run examples/tray-panel.ts",
     "example:webview-control": "bun run examples/webview-control.ts",
     "test": "vitest run",

package/dist/client-DQn3DLZw.d.mts

@@ -1,62 +0,0 @@
-import { ClientFrame, ClientRequestFrame, RequestId, ServerFrame, SpaceOptions, SpaceRef, TrayBoundsResult, TrayId, TrayOptions } from "@opentray/spec";
-
-//#region src/client.d.ts
-interface OpenTrayTransport {
-  request(frame: ClientRequestFrame): Promise<ServerFrame>;
-}
-interface OpenTrayClient {
-  createSpace(options: SpaceOptions): Promise<SpaceHandle>;
-  resolveDefaultSpace(): Promise<SpaceHandle>;
-  /** @deprecated Use `createSpace`. */
-  createSurface(options: SpaceOptions): Promise<SpaceHandle>;
-}
-interface SpaceHandle {
-  space: SpaceRef;
-  createTray(options: TrayOptions): Promise<TrayHandle>;
-}
-/** @deprecated Use `SpaceHandle`. */
-type SurfaceHandle = SpaceHandle;
-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;
-}
-declare const createClient: (transport: OpenTrayTransport, options?: CreateClientOptions) => OpenTrayClient;
-declare const createSpaceHandle: (transport: OpenTrayTransport, space: SpaceRef, nextRequestId?: () => RequestId) => SpaceHandle;
-/** @deprecated Use `createSpaceHandle`. */
-declare const createSurfaceHandle: (transport: OpenTrayTransport, space: SpaceRef, nextRequestId?: () => RequestId) => SpaceHandle;
-declare const createTrayHandle: (transport: OpenTrayTransport, space: SpaceRef, trayId: TrayId, nextRequestId?: () => RequestId) => TrayHandle;
-//#endregion
-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

@@ -1 +0,0 @@
-{"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/local-broker-C9siWyRh.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"local-broker-C9siWyRh.mjs","names":["isNodeError"],"sources":["../src/daemon/native-target.ts","../src/daemon/broker-command.ts","../src/daemon/lifecycle.ts","../src/daemon/package-version.ts","../src/daemon/paths.ts","../src/local-broker.ts"],"sourcesContent":["export type BrokerPackageOs = \"darwin\" | \"linux\" | \"windows\";\nexport type BrokerArch = \"arm64\" | \"x64\";\n\nexport interface BrokerNativeTarget {\n  packageName: string;\n  binaryRelativePath: string;\n}\n\nexport const resolveBrokerNativeTarget = (\n  platform: string = process.platform,\n  arch: string = process.arch,\n): BrokerNativeTarget => {\n  const packageOs = platformToPackageOs(platform);\n  const nativeArch = normalizeArch(arch);\n  return {\n    packageName: `@opentray/${packageOs}-${nativeArch}`,\n    binaryRelativePath: `bin/${packageOs === \"windows\" ? \"opentray.exe\" : \"opentray\"}`,\n  };\n};\n\nconst platformToPackageOs = (platform: string): BrokerPackageOs => {\n  switch (platform) {\n    case \"darwin\":\n    case \"linux\":\n      return platform;\n    case \"win32\":\n      return \"windows\";\n    default:\n      throw new MissingPlatformBrokerBinaryError(\n        `unsupported OpenTray broker platform: ${platform}`,\n        platform,\n        process.arch,\n      );\n  }\n};\n\nconst normalizeArch = (arch: string): BrokerArch => {\n  switch (arch) {\n    case \"arm64\":\n    case \"x64\":\n      return arch;\n    default:\n      throw new MissingPlatformBrokerBinaryError(\n        `unsupported OpenTray broker architecture: ${arch}`,\n        process.platform,\n        arch,\n      );\n  }\n};\n\nexport class MissingPlatformBrokerBinaryError extends Error {\n  readonly code = \"OPENTRAY_MISSING_PLATFORM_BROKER_BINARY\";\n  readonly platform: string;\n  readonly arch: string;\n  readonly packageName: string | undefined;\n  readonly binaryPath: string | undefined;\n\n  constructor(\n    message: string,\n    platform: string,\n    arch: string,\n    options: {\n      packageName?: string;\n      binaryPath?: string;\n      cause?: unknown;\n    } = {},\n  ) {\n    super(message, options.cause === undefined ? undefined : { cause: options.cause });\n    this.name = \"MissingPlatformBrokerBinaryError\";\n    this.platform = platform;\n    this.arch = arch;\n    this.packageName = options.packageName;\n    this.binaryPath = options.binaryPath;\n  }\n}\n","import { access, chmod } from \"node:fs/promises\";\nimport { constants } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { createRequire } from \"node:module\";\nimport { fileURLToPath } from \"node:url\";\nimport { spawn } from \"node:child_process\";\n\nimport type { DaemonPaths } from \"./paths\";\nimport { MissingPlatformBrokerBinaryError, resolveBrokerNativeTarget } from \"./native-target\";\n\nexport interface BrokerCommand {\n  command: string;\n  args: string[];\n  cwd?: string;\n}\n\nconst sourceUrl = import.meta.url;\nconst requireFromSource = createRequire(sourceUrl);\n\nexport interface ResolveBrokerCommandOptions {\n  env?: NodeJS.ProcessEnv;\n  platform?: NodeJS.Platform;\n  arch?: string;\n  sourceDir?: string;\n  resolvePackageJson?: (packageName: string) => string | undefined;\n  findWorkspaceRoot?: (start: string) => Promise<string | undefined>;\n  ensureDevBrokerBinary?: (workspaceRoot: string) => Promise<string>;\n}\n\nexport const resolveBrokerCommand = async (\n  paths: DaemonPaths,\n  options: ResolveBrokerCommandOptions = {},\n): Promise<BrokerCommand> => {\n  const env = options.env ?? process.env;\n  const explicit = env.OPENTRAY_BROKER_BIN;\n  if (explicit !== undefined && explicit.length > 0) {\n    return commandForBinary(explicit, paths);\n  }\n\n  const sourceDir = options.sourceDir ?? dirname(fileURLToPath(sourceUrl));\n  const workspaceRoot = await (options.findWorkspaceRoot ?? findWorkspaceRoot)(sourceDir);\n  if (workspaceRoot !== undefined) {\n    const binary = await (options.ensureDevBrokerBinary ?? ensureDevBrokerBinary)(workspaceRoot);\n    return commandForBinary(binary, paths, workspaceRoot);\n  }\n\n  const platform = options.platform ?? process.platform;\n  const arch = options.arch ?? process.arch;\n  const installedBinary = await resolveInstalledBrokerBinary({\n    platform,\n    arch,\n    resolvePackageJson: options.resolvePackageJson ?? resolvePackageJson,\n  });\n  if (installedBinary !== undefined) {\n    return commandForBinary(installedBinary, paths);\n  }\n\n  const target = resolveBrokerNativeTarget(platform, arch);\n  throw new MissingPlatformBrokerBinaryError(\n    `unable to resolve OpenTray broker binary for ${platform}/${arch}; install ${target.packageName} or set OPENTRAY_BROKER_BIN`,\n    platform,\n    arch,\n    { packageName: target.packageName },\n  );\n};\n\nconst commandForBinary = (binary: string, paths: DaemonPaths, cwd?: string): BrokerCommand => {\n  const command: BrokerCommand = {\n    command: binary,\n    args: [\n      \"broker\",\n      \"--endpoint\",\n      paths.endpoint,\n      \"--ready-file\",\n      paths.readyFile,\n      \"--package-version\",\n      paths.packageVersion,\n      \"--protocol-version\",\n      `${paths.protocolVersion}`,\n    ],\n  };\n  if (cwd !== undefined) {\n    command.cwd = cwd;\n  }\n  return command;\n};\n\ninterface ResolveInstalledBrokerBinaryOptions {\n  platform: NodeJS.Platform;\n  arch: string;\n  resolvePackageJson: (packageName: string) => string | undefined;\n}\n\nexport const resolveInstalledBrokerBinary = async ({\n  platform,\n  arch,\n  resolvePackageJson,\n}: ResolveInstalledBrokerBinaryOptions): Promise<string | undefined> => {\n  const target = resolveBrokerNativeTarget(platform, arch);\n  const packageJsonPath = resolvePackageJson(target.packageName);\n  if (packageJsonPath === undefined) {\n    return undefined;\n  }\n\n  const binary = join(dirname(packageJsonPath), target.binaryRelativePath);\n  if (!(await exists(binary))) {\n    throw new MissingPlatformBrokerBinaryError(\n      `OpenTray broker package ${target.packageName} is installed but missing ${target.binaryRelativePath}`,\n      platform,\n      arch,\n      {\n        packageName: target.packageName,\n        binaryPath: binary,\n      },\n    );\n  }\n\n  if (platform !== \"win32\") {\n    await chmod(binary, 0o755);\n  }\n\n  return binary;\n};\n\nconst resolvePackageJson = (packageName: string): string | undefined => {\n  try {\n    return requireFromSource.resolve(`${packageName}/package.json`);\n  } catch (error) {\n    if (isNodeError(error) && error.code === \"MODULE_NOT_FOUND\") {\n      return undefined;\n    }\n    throw error;\n  }\n};\n\nconst findWorkspaceRoot = async (start: string): Promise<string | undefined> => {\n  let current = start;\n  while (true) {\n    if (await exists(join(current, \"Cargo.toml\"))) {\n      if (await exists(join(current, \"crates\", \"opentray-bin\", \"Cargo.toml\"))) {\n        return current;\n      }\n    }\n\n    const parent = dirname(current);\n    if (parent === current) {\n      return undefined;\n    }\n    current = parent;\n  }\n};\n\nconst ensureDevBrokerBinary = async (workspaceRoot: string): Promise<string> => {\n  const binary = join(\n    workspaceRoot,\n    \"target\",\n    \"debug\",\n    process.platform === \"win32\" ? \"opentray.exe\" : \"opentray\",\n  );\n  await runCargoBuild(workspaceRoot);\n  return binary;\n};\n\nconst runCargoBuild = (workspaceRoot: string): Promise<void> =>\n  new Promise((resolve, reject) => {\n    const child = spawn(\"cargo\", [\"build\", \"-p\", \"opentray-bin\"], {\n      cwd: workspaceRoot,\n      stdio: process.env.OPENTRAY_BROKER_BUILD_LOGS === \"1\" ? \"inherit\" : \"ignore\",\n    });\n    child.once(\"error\", reject);\n    child.once(\"exit\", (code) => {\n      if (code === 0) {\n        resolve();\n        return;\n      }\n      reject(new Error(`cargo build -p opentray-bin failed with code ${code ?? \"unknown\"}`));\n    });\n  });\n\nconst exists = async (path: string): Promise<boolean> => {\n  try {\n    await access(path, constants.F_OK);\n    return true;\n  } catch {\n    return false;\n  }\n};\n\nconst isNodeError = (error: unknown): error is NodeJS.ErrnoException =>\n  error instanceof Error && \"code\" in error;\n","import { constants } from \"node:fs\";\nimport { mkdir, open, readFile, rm, unlink, writeFile } from \"node:fs/promises\";\nimport { spawn } from \"node:child_process\";\n\nimport { resolveBrokerCommand } from \"./broker-command\";\nimport type { DaemonPaths } from \"./paths\";\n\nconst DAEMON_STDIO_ENV = \"OPENTRAY_DAEMON_STDIO\";\n\nexport type DaemonStartResult =\n  | { status: \"started\"; pid: number; paths: DaemonPaths }\n  | { status: \"already-running\"; pid: number; paths: DaemonPaths };\n\nexport type DaemonStopResult =\n  | { status: \"stopped\"; pid: number; paths: DaemonPaths }\n  | { status: \"not-running\"; paths: DaemonPaths };\n\nexport type DaemonInspectResult =\n  | { status: \"running\"; pid: number; paths: DaemonPaths }\n  | { status: \"not-running\"; paths: DaemonPaths; stalePid?: number };\n\nexport interface DaemonDriver {\n  isAlive(pid: number): Promise<boolean>;\n  spawnBroker(paths: DaemonPaths): Promise<number>;\n  stop(pid: number): Promise<void>;\n}\n\nexport interface StartDaemonOptions {\n  paths: DaemonPaths;\n  driver: DaemonDriver;\n  lockTimeoutMs?: number;\n}\n\nexport interface StopDaemonOptions {\n  paths: DaemonPaths;\n  driver: DaemonDriver;\n}\n\nexport interface InspectDaemonOptions {\n  paths: DaemonPaths;\n  driver: DaemonDriver;\n}\n\nexport const createNodeDaemonDriver = (cliEntrypoint: string): DaemonDriver => ({\n  async isAlive(pid) {\n    return isProcessAlive(pid);\n  },\n  async spawnBroker(paths) {\n    const broker = await resolveBrokerCommand(paths);\n    const child = spawn(broker.command, broker.args, {\n      cwd: broker.cwd,\n      detached: true,\n      env: {\n        ...process.env,\n        OPENTRAY_DAEMON_HOME: paths.homeDir,\n        OPENTRAY_DAEMON_PACKAGE_VERSION: paths.packageVersion,\n        OPENTRAY_DAEMON_CLI_ENTRYPOINT: cliEntrypoint,\n      },\n      stdio: resolveBrokerStdio(process.env[DAEMON_STDIO_ENV]),\n    });\n\n    child.unref();\n    return child.pid ?? 0;\n  },\n  async stop(pid) {\n    process.kill(pid, \"SIGTERM\");\n  },\n});\n\nexport const resolveBrokerStdio = (\n  value: string | undefined,\n): \"ignore\" | \"inherit\" => {\n  return value === \"inherit\" ? \"inherit\" : \"ignore\";\n};\n\nexport const startDaemon = async ({\n  paths,\n  driver,\n  lockTimeoutMs = 1_000,\n}: StartDaemonOptions): Promise<DaemonStartResult> => {\n  await mkdir(paths.runtimeDir, { recursive: true });\n\n  const lock = await acquireLock(paths.lockFile, lockTimeoutMs);\n  try {\n    const existingPid = await readPid(paths.pidFile);\n    if (existingPid !== undefined && (await driver.isAlive(existingPid))) {\n      return { status: \"already-running\", pid: existingPid, paths };\n    }\n\n    await cleanupRuntimeFiles(paths);\n    const pid = await driver.spawnBroker(paths);\n    if (!Number.isInteger(pid) || pid <= 0) {\n      throw new Error(\"daemon broker process did not expose a valid pid\");\n    }\n    await writeFile(paths.pidFile, `${pid}\\n`, \"utf8\");\n    await waitForReadyFile(paths.readyFile, driver, pid);\n    return { status: \"started\", pid, paths };\n  } finally {\n    await lock.release();\n  }\n};\n\nexport const stopDaemon = async ({ paths, driver }: StopDaemonOptions): Promise<DaemonStopResult> => {\n  const pid = await readPid(paths.pidFile);\n  if (pid === undefined || !(await driver.isAlive(pid))) {\n    await cleanupRuntimeFiles(paths);\n    return { status: \"not-running\", paths };\n  }\n\n  await driver.stop(pid);\n  await waitUntilStopped(driver, pid);\n  await cleanupRuntimeFiles(paths);\n  return { status: \"stopped\", pid, paths };\n};\n\nexport const restartDaemon = async (options: StartDaemonOptions): Promise<DaemonStartResult> => {\n  await stopDaemon({ paths: options.paths, driver: options.driver });\n  return startDaemon(options);\n};\n\nexport const inspectDaemon = async ({ paths, driver }: InspectDaemonOptions): Promise<DaemonInspectResult> => {\n  const pid = await readPid(paths.pidFile);\n  if (pid !== undefined && (await driver.isAlive(pid))) {\n    return { status: \"running\", pid, paths };\n  }\n\n  await cleanupRuntimeFiles(paths);\n  return pid === undefined\n    ? { status: \"not-running\", paths }\n    : { status: \"not-running\", paths, stalePid: pid };\n};\n\nconst readPid = async (pidFile: string): Promise<number | undefined> => {\n  try {\n    const content = await readFile(pidFile, \"utf8\");\n    const pid = Number.parseInt(content.trim(), 10);\n    return Number.isInteger(pid) && pid > 0 ? pid : undefined;\n  } catch (error) {\n    if (isNodeError(error) && error.code === \"ENOENT\") {\n      return undefined;\n    }\n    throw error;\n  }\n};\n\nconst cleanupRuntimeFiles = async (paths: DaemonPaths): Promise<void> => {\n  await rm(paths.readyFile, { force: true });\n  await rm(paths.pidFile, { force: true });\n  if (process.platform !== \"win32\") {\n    await rm(paths.endpoint, { force: true });\n  }\n};\n\nconst waitUntilStopped = async (driver: DaemonDriver, pid: number): Promise<void> => {\n  for (let attempt = 0; attempt < 20; attempt += 1) {\n    if (!(await driver.isAlive(pid))) {\n      return;\n    }\n    await sleep(50);\n  }\n};\n\nconst waitForReadyFile = async (\n  readyFile: string,\n  driver: DaemonDriver,\n  pid: number,\n): Promise<void> => {\n  for (let attempt = 0; attempt < 40; attempt += 1) {\n    try {\n      await readFile(readyFile, \"utf8\");\n      return;\n    } catch (error) {\n      if (!isNodeError(error) || error.code !== \"ENOENT\") {\n        throw error;\n      }\n      if (!(await driver.isAlive(pid))) {\n        throw new Error(\n          `daemon broker exited before readiness: pid=${pid}; readyFile=${readyFile}; set ${DAEMON_STDIO_ENV}=inherit to inspect broker stderr`,\n        );\n      }\n      await sleep(50);\n    }\n  }\n\n  throw new Error(`timed out waiting for daemon readiness: ${readyFile}`);\n};\n\nconst acquireLock = async (\n  lockFile: string,\n  timeoutMs: number,\n): Promise<{\n  release(): Promise<void>;\n}> => {\n  const deadline = Date.now() + timeoutMs;\n  while (Date.now() <= deadline) {\n    try {\n      const handle = await open(lockFile, constants.O_CREAT | constants.O_EXCL | constants.O_WRONLY);\n      await handle.writeFile(`${process.pid}\\n`, \"utf8\");\n      return {\n        async release() {\n          await handle.close();\n          await unlink(lockFile).catch((error: unknown) => {\n            if (!isNodeError(error) || error.code !== \"ENOENT\") {\n              throw error;\n            }\n          });\n        },\n      };\n    } catch (error) {\n      if (isNodeError(error) && error.code === \"EEXIST\") {\n        await sleep(25);\n        continue;\n      }\n      throw error;\n    }\n  }\n\n  throw new Error(`timed out acquiring daemon lock: ${lockFile}`);\n};\n\nconst isProcessAlive = (pid: number): boolean => {\n  try {\n    process.kill(pid, 0);\n    return true;\n  } catch {\n    return false;\n  }\n};\n\nconst sleep = (ms: number): Promise<void> => new Promise((resolve) => setTimeout(resolve, ms));\n\nconst isNodeError = (error: unknown): error is NodeJS.ErrnoException =>\n  error instanceof Error && \"code\" in error;\n","import { readFile } from \"node:fs/promises\";\n\nexport const readPackageVersion = async (packageJsonUrl: URL): Promise<string> => {\n  const value: unknown = JSON.parse(await readFile(packageJsonUrl, \"utf8\"));\n  if (!isPackageJsonWithVersion(value)) {\n    throw new Error(`package.json is missing a string version: ${packageJsonUrl.href}`);\n  }\n\n  return value.version;\n};\n\nconst isPackageJsonWithVersion = (value: unknown): value is { version: string } =>\n  typeof value === \"object\" &&\n  value !== null &&\n  !Array.isArray(value) &&\n  \"version\" in value &&\n  typeof value.version === \"string\";\n","import { createBrokerEndpointIdentity, formatUnixSocketPath, formatWindowsPipeName } from \"@opentray/spec\";\n\nexport interface DaemonPathOptions {\n  homeDir: string;\n  packageVersion: string;\n  platform?: NodeJS.Platform;\n}\n\nexport interface DaemonPaths {\n  homeDir: string;\n  packageVersion: string;\n  protocolVersion: number;\n  stateRoot: string;\n  runtimeDir: string;\n  endpoint: string;\n  pidFile: string;\n  lockFile: string;\n  readyFile: string;\n}\n\nexport const resolveDaemonPaths = ({\n  homeDir,\n  packageVersion,\n  platform = process.platform,\n}: DaemonPathOptions): DaemonPaths => {\n  const identity = createBrokerEndpointIdentity({ packageVersion });\n  const normalizedHome = homeDir.replace(/[\\\\/]+$/u, \"\");\n  const stateRoot = `${normalizedHome}/.opentray/${identity.packageVersion}`;\n  const runtimeDir = `${stateRoot}/runtime`;\n  const endpoint =\n    platform === \"win32\" ? formatWindowsPipeName(identity) : formatUnixSocketPath(normalizedHome, identity);\n\n  return {\n    homeDir: normalizedHome,\n    packageVersion: identity.packageVersion,\n    protocolVersion: identity.protocolVersion,\n    stateRoot,\n    runtimeDir,\n    endpoint,\n    pidFile: `${runtimeDir}/broker.pid`,\n    lockFile: `${runtimeDir}/broker.lock`,\n    readyFile: `${runtimeDir}/ready.json`,\n  };\n};\n","import { createConnection, type Socket } from \"node:net\";\nimport { homedir } from \"node:os\";\nimport { fileURLToPath } from \"node:url\";\n\nimport {\n  PROTOCOL_VERSION,\n  parseServerFrame,\n  type BrokerEndpointIdentityOptions,\n  type ClientRequestFrame,\n  type RequestId,\n  type ServerFrame,\n} from \"@opentray/spec\";\n\nimport type { OpenTrayTransport } from \"./client\";\nimport { createNodeDaemonDriver, startDaemon, type DaemonDriver } from \"./daemon/lifecycle\";\nimport { readPackageVersion } from \"./daemon/package-version\";\nimport { resolveDaemonPaths } from \"./daemon/paths\";\n\nconst packageJsonUrl = new URL(\"../package.json\", import.meta.url);\n\nexport type BrokerEventFrame = Extract<ServerFrame, { type: \"event\" | \"ext-event\" }>;\n\nexport interface LocalBrokerClient extends OpenTrayTransport {\n  readonly endpoint: string;\n  readonly sessionId: string;\n  /** @deprecated Use `sessionId`. */\n  readonly leaseId: string;\n  onEvent(listener: (frame: BrokerEventFrame) => void): () => void;\n  close(): Promise<void>;\n}\n\nexport interface ConnectLocalBrokerOptions extends Partial<BrokerEndpointIdentityOptions> {\n  endpoint?: string;\n  homeDir?: string;\n  clientVersion?: string;\n  autoStart?: boolean;\n  daemonDriver?: DaemonDriver;\n  cliEntrypoint?: string;\n}\n\ninterface PendingRequest {\n  resolve(frame: ServerFrame): void;\n  reject(error: Error): void;\n}\n\ninterface BrokerSocket {\n  setEncoding(encoding: BufferEncoding): void;\n  on(event: \"data\", listener: (chunk: Buffer | string) => void): void;\n  on(event: \"error\", listener: (error: Error) => void): void;\n  on(event: \"close\", listener: () => void): void;\n  once(event: \"connect\", listener: () => void): void;\n  once(event: \"error\", listener: (error: Error) => void): void;\n  off(event: \"error\", listener: (error: Error) => void): void;\n  write(data: string): void;\n  end(callback: () => void): void;\n}\n\nexport const connectLocalBroker = async (\n  options: ConnectLocalBrokerOptions = {},\n): Promise<LocalBrokerClient> => {\n  const packageVersion = options.packageVersion ?? (await readPackageVersion(packageJsonUrl));\n  const clientVersion = options.clientVersion ?? packageVersion;\n  const paths = resolveDaemonPaths({\n    homeDir: options.homeDir ?? process.env.OPENTRAY_HOME ?? homedir(),\n    packageVersion,\n  });\n  const endpoint = options.endpoint ?? paths.endpoint;\n  const autoStart = options.autoStart ?? endpoint === paths.endpoint;\n  if (autoStart && endpoint !== paths.endpoint) {\n    throw new Error(\"local broker autoStart requires the derived same-version endpoint\");\n  }\n  if (autoStart) {\n    const cliEntrypoint = options.cliEntrypoint ?? resolveCliEntrypoint();\n    const driver = options.daemonDriver ?? createNodeDaemonDriver(cliEntrypoint);\n    await startDaemon({ paths, driver });\n  }\n  const socket = await connectSocket(endpoint);\n  const connection = new LocalBrokerConnection(socket, endpoint);\n\n  await connection.init(clientVersion, options.protocolVersion ?? PROTOCOL_VERSION);\n  return connection;\n};\n\nclass LocalBrokerConnection implements LocalBrokerClient {\n  readonly endpoint: string;\n  sessionId = \"\";\n  /** @deprecated Use `sessionId`. */\n  leaseId = \"\";\n\n  private buffer = \"\";\n  private readonly listeners = new Set<(frame: BrokerEventFrame) => void>();\n  private readonly pending = new Map<RequestId, PendingRequest>();\n  private ready:\n    | {\n        resolve(frame: Extract<ServerFrame, { type: \"ready\" }>): void;\n        reject(error: Error): void;\n      }\n    | undefined;\n\n  constructor(\n    private readonly socket: BrokerSocket,\n    endpoint: string,\n  ) {\n    this.endpoint = endpoint;\n    socket.setEncoding(\"utf8\");\n    socket.on(\"data\", (chunk: Buffer | string) => {\n      this.consume(String(chunk));\n    });\n    socket.on(\"error\", (error) => {\n      this.rejectAll(error);\n    });\n    socket.on(\"close\", () => {\n      this.rejectAll(new Error(\"broker connection closed\"));\n    });\n  }\n\n  async init(clientVersion: string, protocolVersion: number): Promise<void> {\n    const ready = new Promise<Extract<ServerFrame, { type: \"ready\" }>>((resolve, reject) => {\n      this.ready = { resolve, reject };\n    });\n    this.write({\n      type: \"init\",\n      protocolVersion,\n      clientVersion,\n    });\n    const frame = await ready;\n    this.sessionId = frame.sessionId;\n    this.leaseId = frame.sessionId;\n  }\n\n  async request(frame: ClientRequestFrame): Promise<ServerFrame> {\n    if (this.pending.has(frame.requestId)) {\n      throw new Error(`duplicate requestId: ${frame.requestId}`);\n    }\n\n    const response = new Promise<ServerFrame>((resolve, reject) => {\n      this.pending.set(frame.requestId, { resolve, reject });\n    });\n    this.write(frame);\n    return response;\n  }\n\n  onEvent(listener: (frame: BrokerEventFrame) => void): () => void {\n    this.listeners.add(listener);\n    return () => {\n      this.listeners.delete(listener);\n    };\n  }\n\n  async close(): Promise<void> {\n    this.write({ type: \"exit\" });\n    await new Promise<void>((resolve) => {\n      this.socket.end(resolve);\n    });\n  }\n\n  private consume(chunk: string): void {\n    this.buffer += chunk;\n    while (true) {\n      const newline = this.buffer.indexOf(\"\\n\");\n      if (newline < 0) {\n        return;\n      }\n\n      const line = this.buffer.slice(0, newline).trim();\n      this.buffer = this.buffer.slice(newline + 1);\n      if (line.length > 0) {\n        this.dispatchLine(line);\n      }\n    }\n  }\n\n  private dispatchLine(line: string): void {\n    const parsed = parseServerFrame(line);\n    if (!parsed.ok || parsed.frame === undefined) {\n      this.rejectAll(new Error(parsed.error ?? \"invalid server frame\"));\n      return;\n    }\n\n    this.dispatchFrame(parsed.frame);\n  }\n\n  private dispatchFrame(frame: ServerFrame): void {\n    if (frame.type === \"ready\") {\n      this.ready?.resolve(frame);\n      this.ready = undefined;\n      return;\n    }\n\n    if (frame.type === \"error\") {\n      const error = new Error(`${frame.code}: ${frame.message}`);\n      if (frame.requestId !== undefined) {\n        this.pending.get(frame.requestId)?.reject(error);\n        this.pending.delete(frame.requestId);\n        return;\n      }\n      this.ready?.reject(error);\n      this.ready = undefined;\n      return;\n    }\n\n    const requestId = responseRequestId(frame);\n    if (requestId !== undefined) {\n      // Request responses and broker events are separate streams even on one socket.\n      this.pending.get(requestId)?.resolve(frame);\n      this.pending.delete(requestId);\n      return;\n    }\n\n    if (frame.type === \"event\" || frame.type === \"ext-event\") {\n      for (const listener of this.listeners) {\n        listener(frame);\n      }\n    }\n  }\n\n  private write(frame: unknown): void {\n    this.socket.write(`${JSON.stringify(frame)}\\n`);\n  }\n\n  private rejectAll(error: Error): void {\n    this.ready?.reject(error);\n    this.ready = undefined;\n    for (const pending of this.pending.values()) {\n      pending.reject(error);\n    }\n    this.pending.clear();\n  }\n}\n\nconst connectSocket = (endpoint: string): Promise<BrokerSocket> =>\n  new Promise((resolve, reject) => {\n    const socket = createConnection(endpoint);\n    socket.once(\"connect\", () => {\n      socket.off(\"error\", reject);\n      resolve(socket);\n    });\n    socket.once(\"error\", reject);\n  });\n\nconst responseRequestId = (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 \"ready\":\n    case \"event\":\n    case \"ext-event\":\n    case \"error\":\n      return undefined;\n  }\n};\n\nconst resolveCliEntrypoint = (): string => {\n  const suffix = fileURLToPath(import.meta.url).endsWith(\".ts\") ? \"cli.ts\" : \"cli.mjs\";\n  return fileURLToPath(new URL(`./${suffix}`, import.meta.url));\n};\n"],"mappings":"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"}