gpui-bridge 0.5.0 → 0.6.0

package/dist/app.d.ts

@@ -1,4 +1,4 @@
-import { type ClientMessage, type ErrorCode, type HostMessage, type MenuItem, type NodeEvents, type NodeId, type NodeProps, type NodeType, type ThemeSet, type WindowEventName, type WindowId, type WindowTheme } from "./protocol.js";
+import { type AppIdentity, type ClientMessage, type ErrorCode, type HostMessage, type MenuItem, type NodeEvents, type NodeId, type NodeProps, type NodeType, type ThemeSet, type WindowEventName, type WindowId, type WindowTheme } from "./protocol.js";
 import { Tree } from "./tree.js";
 export interface HostExit {
     code: number | null;
@@ -400,5 +400,5 @@ export declare class App {
  * Starts the host through `start` and completes the handshake. Rejects with a
  * clear message if the host cannot start.
  */
-export declare function connect(hostPath: string, start: (events: HostEvents) => HostTransport): Promise<App>;
+export declare function connect(hostPath: string, start: (events: HostEvents) => HostTransport, identity?: AppIdentity): Promise<App>;
 export {};

package/dist/app.js

@@ -697,7 +697,7 @@ export class App {
  * Starts the host through `start` and completes the handshake. Rejects with a
  * clear message if the host cannot start.
  */
-export function connect(hostPath, start) {
+export function connect(hostPath, start, identity) {
     return new Promise((resolve, reject) => {
         let app;
         let ready = false;
@@ -730,6 +730,7 @@ export function connect(hostPath, start) {
             },
         });
         app = new App(host, hostPath);
-        host.send({ op: "hello", protocol: PROTOCOL_VERSION });
+        // JSON leaves out an undefined `app`, so the default hello stays `{"op":"hello","protocol":1}`.
+        host.send({ op: "hello", protocol: PROTOCOL_VERSION, app: identity });
     });
 }

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { type App } from "./app.js";
+import type { AppIdentity } from "./protocol.js";
 export * from "./app.js";
 export * from "./protocol.js";
 export interface AppOptions {
@@ -8,6 +9,8 @@ export interface AppOptions {
     debug?: boolean;
     /** Run the host without a window (`--no-window`), e.g. for tests. */
     headless?: boolean;
+    /** Names the app for the system (`hello`): Windows shows it on system notifications. Default: `gpui-bridge`. */
+    app?: AppIdentity;
 }
 /** The host to run: `$GPUI_BRIDGE_HOST`, then the packaged one, then a build in this repository. */
 export declare function defaultHostPath(): string;

package/dist/index.js

@@ -54,5 +54,5 @@ export function defaultHostPath() {
 export function createApp(options = {}) {
     const path = options.hostPath ?? defaultHostPath();
     const args = options.headless ? ["--no-window"] : [];
-    return connect(path, (events) => new HostProcess({ path, args, debug: options.debug ?? false, ...events }));
+    return connect(path, (events) => new HostProcess({ path, args, debug: options.debug ?? false, ...events }), options.app);
 }

package/dist/protocol.d.ts

@@ -25,10 +25,19 @@ export interface ThemeConfig {
 }
 /** Node props on the wire. In `setProps`, a `null` value removes the prop. */
 export type Props = Record<string, unknown>;
+/** The app's own name for the system (`hello`): Windows shows `name` and `icon` on system notifications. */
+export interface AppIdentity {
+    /** Windows AppUserModelID: up to 128 characters, no spaces or `\`, e.g. `"Acme.Notes"`. */
+    id: string;
+    name: string;
+    /** Image file shown on the app's system notifications (PNG, ICO…). */
+    icon?: string;
+}
 /** Messages from the client (host stdin). */
 export type ClientMessage = {
     op: "hello";
     protocol: number;
+    app?: AppIdentity;
 } | {
     op: "window";
     id?: WindowId;

package/dist/txiki.d.ts

@@ -1,4 +1,5 @@
 import { type App } from "./app.js";
+import type { AppIdentity } from "./protocol.js";
 export * from "./app.js";
 export * from "./protocol.js";
 export interface TxikiAppOptions {
@@ -6,5 +7,7 @@ export interface TxikiAppOptions {
     hostPath?: string;
     debug?: boolean;
     headless?: boolean;
+    /** Names the app for the system (`hello`): Windows shows it on system notifications. Default: `gpui-bridge`. */
+    app?: AppIdentity;
 }
 export declare function createTxikiApp(options?: TxikiAppOptions): Promise<App>;

package/dist/txiki.js

@@ -86,5 +86,5 @@ function defaultHostPath() {
 export function createTxikiApp(options = {}) {
     const path = options.hostPath ?? defaultHostPath();
     const args = options.headless ? ["--no-window"] : [];
-    return connect(path, (events) => new TxikiHost(path, args, options.debug ?? false, events));
+    return connect(path, (events) => new TxikiHost(path, args, options.debug ?? false, events), options.app);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gpui-bridge",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Node.js client for the gpui-bridge native UI host",
   "license": "MIT",
   "author": "gpui-bridge contributors",
@@ -29,9 +29,9 @@
     "node": ">=22.6"
   },
   "optionalDependencies": {
-    "@indios/gpui-bridge-darwin-arm64": "0.5.0",
-    "@indios/gpui-bridge-linux-x64": "0.5.0",
-    "@indios/gpui-bridge-win32-x64": "0.5.0"
+    "@indios/gpui-bridge-darwin-arm64": "0.6.0",
+    "@indios/gpui-bridge-linux-x64": "0.6.0",
+    "@indios/gpui-bridge-win32-x64": "0.6.0"
   },
   "devDependencies": {
     "@types/node": "^26.6.5",