@comfyorg/comfyui-desktop-bridge-types 0.6.0 → 0.7.0

package/comfyDesktopBridge.d.ts

@@ -130,13 +130,21 @@ export interface ComfyDesktop2AuthBridge {
    *  is scoped to; null when signed out, disabled, or the scope is missing,
    *  malformed or different. The refresh token never leaves Desktop. */
   getWorkspaceToken(workspaceId: string): Promise<string | null>
+  /** The partner-node token for prompts in `workspaceId`, under the same rules
+   *  as `getWorkspaceToken`. Desktop mints and renews it; null means use the
+   *  workspace token. Absent on Desktop builds before it. */
+  getPartnerNodeToken?(workspaceId: string): Promise<string | null>
   /** Runs Desktop's browser sign-in and resolves with the resulting state. */
   requestSignIn(): Promise<ComfyDesktop2AuthState>
   /** Signs Desktop out of its account (every view follows) and resolves with
    *  the resulting state; Desktop may keep the session if an install needs it. */
   signOut(): Promise<ComfyDesktop2AuthState>
-  /** Re-scopes Desktop's session to `workspaceId` (browser consent the first
-   *  time) and resolves with the resulting state; every view follows. */
+  /** Re-scopes Desktop's session to `workspaceId` and resolves with the resulting
+   *  state; every view follows. A view that is not signed in gets its current
+   *  state back. Otherwise the switch may open browser consent: it does not for
+   *  the grant's own workspace or one Desktop holds an unexpired token for,
+   *  unless the grant has ended, and a request for a workspace Desktop is already
+   *  switching to shares that switch's result. */
   switchWorkspace(workspaceId: string): Promise<ComfyDesktop2AuthState>
   /** Fires when Desktop signs in, signs out or switches workspace. */
   onChanged(callback: (state: ComfyDesktop2AuthState) => void): () => void
@@ -168,6 +176,13 @@ export interface ComfyDesktop2Bridge {
   /** Reports whether the backend server is cloud/remote, not the user's location.
    *  Optional: desktop builds predating it are still in the wild. */
   isRemote?(): boolean
+  /** Returns the per-installation id: a non-PII, stable-per-machine value
+   *  (`SHA-256(machine_id + salt)`, see main/lib/deviceId). The hosted
+   *  frontend sends it to cloud as the `X-Comfy-Install-Id` header so cloud
+   *  can attribute requests to a Desktop install. Not an identity/secret.
+   *  Undefined outside cloud-hosted pages or when the id is not
+   *  machine-derived. Absent on Desktop builds predating it. */
+  getInstallId?(): string | undefined
   openTerminal?: () => Promise<boolean>
   /** Opens a model provider access page in the hosted frontend's browser session.
    *  Resolves `true` when the host has taken ownership of the request.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comfyorg/comfyui-desktop-bridge-types",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "TypeScript definitions for the Comfy Desktop hosted frontend bridge",
   "type": "module",
   "main": "./index.js",