@puredesktop/puredesktop-ui-bridge 2.1.4 → 2.1.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@puredesktop/puredesktop-ui-bridge",
-  "version": "2.1.4",
+  "version": "2.1.6",
   "description": "PureScience plugin SDK — bridge client, theme, and shared UI",
   "type": "module",
   "repository": {
@@ -278,6 +278,10 @@
     "./bridge/window.mjs": "./src/bridge/window.mjs",
     "./bridge/window": "./src/bridge/window.mjs",
     "./bridge/window.js": "./src/bridge/window.mjs",
+    "./bridge/workspace.mjs": "./src/bridge/workspace.mjs",
+    "./bridge/workspace": "./src/bridge/workspace.ts",
+    "./bridge/workspace.js": "./src/bridge/workspace.ts",
+    "./bridge/workspace.ts": "./src/bridge/workspace.ts",
     "./chrome/index.ts": "./src/chrome/index.ts",
     "./chrome/index": "./src/chrome/index.ts",
     "./chrome/index.js": "./src/chrome/index.ts",
@@ -474,6 +478,9 @@
     "./components/assets/AssetLibraryDialog.tsx": "./src/components/assets/AssetLibraryDialog.tsx",
     "./components/assets/AssetLibraryDialog": "./src/components/assets/AssetLibraryDialog.tsx",
     "./components/assets/AssetLibraryDialog.js": "./src/components/assets/AssetLibraryDialog.tsx",
+    "./components/chrome/documentChromePolicy.ts": "./src/components/chrome/documentChromePolicy.ts",
+    "./components/chrome/documentChromePolicy": "./src/components/chrome/documentChromePolicy.ts",
+    "./components/chrome/documentChromePolicy.js": "./src/components/chrome/documentChromePolicy.ts",
     "./components/chrome/index.ts": "./src/components/chrome/index.ts",
     "./components/chrome/index": "./src/components/chrome/index.ts",
     "./components/chrome/index.js": "./src/components/chrome/index.ts",
@@ -1023,6 +1030,9 @@
     "./components/data/dataTable.ts": "./src/components/data/dataTable.ts",
     "./components/data/dataTable": "./src/components/data/dataTable.ts",
     "./components/data/dataTable.js": "./src/components/data/dataTable.ts",
+    "./components/editor/DocumentAppChrome.tsx": "./src/components/editor/DocumentAppChrome.tsx",
+    "./components/editor/DocumentAppChrome": "./src/components/editor/DocumentAppChrome.tsx",
+    "./components/editor/DocumentAppChrome.js": "./src/components/editor/DocumentAppChrome.tsx",
     "./components/editor/EditorCommentPromptDialog.tsx": "./src/components/editor/EditorCommentPromptDialog.tsx",
     "./components/editor/EditorCommentPromptDialog": "./src/components/editor/EditorCommentPromptDialog.tsx",
     "./components/editor/EditorCommentPromptDialog.js": "./src/components/editor/EditorCommentPromptDialog.tsx",
@@ -1062,6 +1072,10 @@
     "./theme/appAccents.ts": "./src/theme/appAccents.ts",
     "./theme/appAccents": "./src/theme/appAccents.ts",
     "./theme/appAccents.js": "./src/theme/appAccents.ts",
+    "./theme/appIdentityCss.mjs": "./src/theme/appIdentityCss.mjs",
+    "./theme/appIdentityCss": "./src/theme/appIdentityCss.ts",
+    "./theme/appIdentityCss.js": "./src/theme/appIdentityCss.ts",
+    "./theme/appIdentityCss.ts": "./src/theme/appIdentityCss.ts",
     "./theme/buildThemeBridgePayload.ts": "./src/theme/buildThemeBridgePayload.ts",
     "./theme/buildThemeBridgePayload": "./src/theme/buildThemeBridgePayload.ts",
     "./theme/buildThemeBridgePayload.js": "./src/theme/buildThemeBridgePayload.ts",
@@ -1075,6 +1089,10 @@
     "./theme/reportsShellChromeSelectors.ts": "./src/theme/reportsShellChromeSelectors.ts",
     "./theme/reportsShellChromeSelectors": "./src/theme/reportsShellChromeSelectors.ts",
     "./theme/reportsShellChromeSelectors.js": "./src/theme/reportsShellChromeSelectors.ts",
+    "./theme/surfaceCss.mjs": "./src/theme/surfaceCss.mjs",
+    "./theme/surfaceCss": "./src/theme/surfaceCss.ts",
+    "./theme/surfaceCss.js": "./src/theme/surfaceCss.ts",
+    "./theme/surfaceCss.ts": "./src/theme/surfaceCss.ts",
     "./theme/surfacePalettes.ts": "./src/theme/surfacePalettes.ts",
     "./theme/surfacePalettes": "./src/theme/surfacePalettes.ts",
     "./theme/surfacePalettes.js": "./src/theme/surfacePalettes.ts",

package/src/agents/runtime/mapAgentSnapshot.test.ts

@@ -91,8 +91,6 @@ describe('mapApprovalPendingToolCalls', () => {
     }
     expect(
       mapApprovalPendingToolCalls(snapshot, policy, ['call-accepted']),
-    ).toEqual([
-      { id: 'call-manual', name: 'book.review', arguments: {} },
-    ])
+    ).toEqual([{ id: 'call-manual', name: 'book.review', arguments: {} }])
   })
 })

package/src/agents/runtime/mapAgentSnapshot.ts

@@ -12,8 +12,10 @@ import { toolRequiresApproval } from './toolRequiresApproval.js'
 
 const VISIBLE_ROLES = new Set(['user', 'assistant', 'tool'])
 
-export function mapRunState(state: string): typeof AgentUiRunState[keyof typeof AgentUiRunState] {
-  return state as typeof AgentUiRunState[keyof typeof AgentUiRunState]
+export function mapRunState(
+  state: string,
+): (typeof AgentUiRunState)[keyof typeof AgentUiRunState] {
+  return state as (typeof AgentUiRunState)[keyof typeof AgentUiRunState]
 }
 
 export function mapSnapshotToMessages(
@@ -69,7 +71,9 @@ export function mapPendingToolCalls(
   snapshot: PlatformAgentRunSnapshot | null,
 ): AgentUiToolCall[] {
   if (!snapshot) return []
-  return derivePendingToolCalls(snapshot.messages, snapshot.state).map(mapToolCall)
+  return derivePendingToolCalls(snapshot.messages, snapshot.state).map(
+    mapToolCall,
+  )
 }
 
 /** Pending tools that still need explicit user approval. */
@@ -111,7 +115,7 @@ function mapToolCallWithResult(
 }
 
 export function isComposerEnabled(
-  runState: typeof AgentUiRunState[keyof typeof AgentUiRunState] | null,
+  runState: (typeof AgentUiRunState)[keyof typeof AgentUiRunState] | null,
   busy: boolean,
 ): boolean {
   if (busy) return false

package/src/agents/runtime/mergeUsageTurn.ts

@@ -6,8 +6,7 @@ export function mergeUsageTurn(
   delta: AgentUsageTurnDelta,
   estimated = false,
 ): PlatformAgentRunUsage {
-  const turnTotal =
-    delta.totalTokens ?? delta.inputTokens + delta.outputTokens
+  const turnTotal = delta.totalTokens ?? delta.inputTokens + delta.outputTokens
   const next: PlatformAgentRunUsage = {
     inputTokens: (base?.inputTokens ?? 0) + delta.inputTokens,
     outputTokens: (base?.outputTokens ?? 0) + delta.outputTokens,

package/src/agents/runtime/pendingToolCalls.test.ts

@@ -31,9 +31,7 @@ describe('derivePendingToolCalls', () => {
           {
             role: 'assistant',
             content: '',
-            toolCalls: [
-              { id: 'tc-1', name: 'book:read', arguments: {} },
-            ],
+            toolCalls: [{ id: 'tc-1', name: 'book:read', arguments: {} }],
           },
         ],
         AgentUiRunState.AwaitingUser,

package/src/agents/runtime/unresolvedToolCalls.ts

@@ -26,8 +26,7 @@ export function unresolvedToolCalls(
     messages
       .filter(
         message =>
-          message.role === 'tool' &&
-          typeof message.toolCallId === 'string',
+          message.role === 'tool' && typeof message.toolCallId === 'string',
       )
       .map(message => message.toolCallId as string),
   )

package/src/bridge/agentModelTiers.ts

@@ -8,7 +8,9 @@ export const DEFAULT_AGENT_LOW_LEVEL_MODEL_ID = 'deepseek:deepseek-v4-flash'
 export const AGENT_AUTO_MODEL_ID = 'auto'
 export const AGENT_AUTO_MODEL_LABEL = 'Auto'
 
-export function isAgentAutoModelId(modelId: string | undefined | null): boolean {
+export function isAgentAutoModelId(
+  modelId: string | undefined | null,
+): boolean {
   return modelId === AGENT_AUTO_MODEL_ID
 }
 
@@ -36,9 +38,12 @@ export interface PlatformAgentSessionScopeDefaults {
 
 /** Resolve tier ids from shell preferences with catalog fallbacks. */
 export function resolveAgentModelTiersFromPrefs(
-  prefs: {
-    agentModelTiers?: Partial<PlatformAgentModelTiers>
-  } | null | undefined,
+  prefs:
+    | {
+        agentModelTiers?: Partial<PlatformAgentModelTiers>
+      }
+    | null
+    | undefined,
 ): PlatformAgentModelTiers {
   const stored = prefs?.agentModelTiers
   return {

package/src/bridge/agents.mjs

@@ -129,7 +129,9 @@ export async function advanceAgentSessionPending(request) {
  * @returns {Promise<import('./agentTypes.js').PlatformAgentSessionDriveResult>}
  */
 export async function interruptAgentSession(request) {
-  return bridge.call(PLATFORM_BRIDGE_METHODS.AGENTS_SESSION_INTERRUPT, [request])
+  return bridge.call(PLATFORM_BRIDGE_METHODS.AGENTS_SESSION_INTERRUPT, [
+    request,
+  ])
 }
 
 /**

package/src/bridge/calendarDraftIntent.ts

@@ -39,17 +39,25 @@ export interface CalendarDraftIntentStore {
   intents: Record<string, CalendarDraftIntent>
 }
 
-export function calendarDraftResourceId(accountId: string, threadId: string): string {
-  return `${CALENDAR_DRAFT_INTENT_PREFIX}${encodeURIComponent(accountId)}:${encodeURIComponent(threadId)}`
+export function calendarDraftResourceId(
+  accountId: string,
+  threadId: string,
+): string {
+  return `${CALENDAR_DRAFT_INTENT_PREFIX}${encodeURIComponent(
+    accountId,
+  )}:${encodeURIComponent(threadId)}`
 }
 
 export function isCalendarDraftResourceId(resourceId: string): boolean {
   return resourceId.startsWith(CALENDAR_DRAFT_INTENT_PREFIX)
 }
 
-export function normalizeCalendarDraftIntentStore(value: unknown): CalendarDraftIntentStore {
+export function normalizeCalendarDraftIntentStore(
+  value: unknown,
+): CalendarDraftIntentStore {
   if (!value || typeof value !== 'object') return { intents: {} }
   const intents = (value as Partial<CalendarDraftIntentStore>).intents
-  if (!intents || typeof intents !== 'object' || Array.isArray(intents)) return { intents: {} }
+  if (!intents || typeof intents !== 'object' || Array.isArray(intents))
+    return { intents: {} }
   return { intents: intents as Record<string, CalendarDraftIntent> }
 }

package/src/bridge/calendarInviteIntent.ts

@@ -1,9 +1,14 @@
 export const CALENDAR_INVITE_INTENT_STORAGE_SLUG = 'calendar'
-export const CALENDAR_INVITE_INTENT_STORAGE_FILE = 'calendar-invite-intents.json'
+export const CALENDAR_INVITE_INTENT_STORAGE_FILE =
+  'calendar-invite-intents.json'
 export const CALENDAR_INVITE_INTENT_PREFIX = 'calendar-invite:mail:'
 
 export type CalendarInviteMethod = 'REQUEST' | 'REPLY' | 'CANCEL' | 'PUBLISH'
-export type CalendarInviteResponse = 'accepted' | 'declined' | 'tentative' | 'needsAction'
+export type CalendarInviteResponse =
+  | 'accepted'
+  | 'declined'
+  | 'tentative'
+  | 'needsAction'
 
 export interface CalendarInviteContact {
   name: string
@@ -48,15 +53,23 @@ export interface CalendarInviteIntentStore {
   intents: Record<string, CalendarInviteIntent>
 }
 
-export function calendarInviteResourceId(accountId: string, messageId: string, uid: string): string {
-  return `${CALENDAR_INVITE_INTENT_PREFIX}${encodeURIComponent(accountId)}:${encodeURIComponent(messageId)}:${encodeURIComponent(uid)}`
+export function calendarInviteResourceId(
+  accountId: string,
+  messageId: string,
+  uid: string,
+): string {
+  return `${CALENDAR_INVITE_INTENT_PREFIX}${encodeURIComponent(
+    accountId,
+  )}:${encodeURIComponent(messageId)}:${encodeURIComponent(uid)}`
 }
 
 export function isCalendarInviteResourceId(resourceId: string): boolean {
   return resourceId.startsWith(CALENDAR_INVITE_INTENT_PREFIX)
 }
 
-export function normalizeCalendarInviteIntentStore(value: unknown): CalendarInviteIntentStore {
+export function normalizeCalendarInviteIntentStore(
+  value: unknown,
+): CalendarInviteIntentStore {
   if (!value || typeof value !== 'object') return { intents: {} }
   const intents = (value as Partial<CalendarInviteIntentStore>).intents
   if (!intents || typeof intents !== 'object') return { intents: {} }

package/src/bridge/client.mjs

@@ -21,16 +21,16 @@ const HANDSHAKE_MS = 800
 let readyPromise = null
 let bridgeMeta = null
 let eventListenerAttached = false
-const eventListeners = new Map()
-
-function postHandshake() {
-  window.parent.postMessage({ channel: CHANNEL, type: 'handshake' }, '*')
-}
-
-function ensureEventListener() {
-  if (eventListenerAttached) return
-  eventListenerAttached = true
-  window.addEventListener('message', event => {
+const eventListeners = new Map()
+
+function postHandshake() {
+  window.parent.postMessage({ channel: CHANNEL, type: 'handshake' }, '*')
+}
+
+function ensureEventListener() {
+  if (eventListenerAttached) return
+  eventListenerAttached = true
+  window.addEventListener('message', event => {
     const data = event.data
     if (!data || data.channel !== CHANNEL || data.type !== 'event') return
     const handlers = eventListeners.get(data.name)
@@ -58,24 +58,24 @@ function offEvent(name, handler) {
   eventListeners.get(name)?.delete(handler)
 }
 
-function waitForReady() {
-  if (readyPromise) return readyPromise
-  readyPromise = new Promise((resolve, reject) => {
-    const timeout = window.setTimeout(() => {
-      window.clearInterval(handshakeTimer)
-      reject(
-        new Error(
+function waitForReady() {
+  if (readyPromise) return readyPromise
+  readyPromise = new Promise((resolve, reject) => {
+    const timeout = window.setTimeout(() => {
+      window.clearInterval(handshakeTimer)
+      reject(
+        new Error(
           'PureScience plugin bridge ready timeout (is this page inside the desktop iframe?)',
         ),
       )
     }, 15_000)
 
-    const onMessage = event => {
-      const data = event.data
-      if (!data || data.channel !== CHANNEL || data.type !== 'ready') return
-      window.clearTimeout(timeout)
-      window.clearInterval(handshakeTimer)
-      window.removeEventListener('message', onMessage)
+    const onMessage = event => {
+      const data = event.data
+      if (!data || data.channel !== CHANNEL || data.type !== 'ready') return
+      window.clearTimeout(timeout)
+      window.clearInterval(handshakeTimer)
+      window.removeEventListener('message', onMessage)
       const viewport =
         data.viewport &&
         typeof data.viewport === 'object' &&
@@ -100,21 +100,21 @@ function waitForReady() {
       }
       applyThemeFromHost(data.theme)
       resolve(bridgeMeta)
-    }
-
-    window.addEventListener('message', onMessage)
-    postHandshake()
-    const handshakeTimer = window.setInterval(postHandshake, HANDSHAKE_MS)
-  })
-  return readyPromise
-}
+    }
+
+    window.addEventListener('message', onMessage)
+    postHandshake()
+    const handshakeTimer = window.setInterval(postHandshake, HANDSHAKE_MS)
+  })
+  return readyPromise
+}
 
-function call(method, args = []) {
-  return waitForReady().then(
-    () =>
-      new Promise((resolve, reject) => {
-        const id = `req-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`
-        const onMessage = event => {
+function call(method, args = []) {
+  return waitForReady().then(
+    () =>
+      new Promise((resolve, reject) => {
+        const id = `req-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`
+        const onMessage = event => {
           const data = event.data
           if (
             !data ||
@@ -124,14 +124,14 @@ function call(method, args = []) {
           ) {
             return
           }
-          window.removeEventListener('message', onMessage)
-          if (data.ok) resolve(data.result)
-          else reject(new Error(data.error || 'Bridge request failed'))
-        }
-        window.addEventListener('message', onMessage)
-        window.parent.postMessage(
-          { channel: CHANNEL, type: 'request', id, method, args },
-          '*',
+          window.removeEventListener('message', onMessage)
+          if (data.ok) resolve(data.result)
+          else reject(new Error(data.error || 'Bridge request failed'))
+        }
+        window.addEventListener('message', onMessage)
+        window.parent.postMessage(
+          { channel: CHANNEL, type: 'request', id, method, args },
+          '*',
         )
       }),
   )

package/src/bridge/dialog.d.mts

@@ -1,8 +1,8 @@
-export interface PlatformDialogPathResult {
-  path: string | null
-}
-
-export declare function openPlatformFolderDialog(): Promise<string | null>
-export declare function savePlatformFolderDialog(): Promise<string | null>
-export declare function openPlatformImageDialog(): Promise<string | null>
-export declare function openPlatformFileDialog(): Promise<string | null>
+export interface PlatformDialogPathResult {
+  path: string | null
+}
+
+export declare function openPlatformFolderDialog(): Promise<string | null>
+export declare function savePlatformFolderDialog(): Promise<string | null>
+export declare function openPlatformImageDialog(): Promise<string | null>
+export declare function openPlatformFileDialog(): Promise<string | null>

package/src/bridge/dialog.mjs

@@ -1,43 +1,43 @@
-import { bridge } from './client.mjs'
-import { PLATFORM_BRIDGE_METHODS } from './methods.mjs'
-
-/**
- * @returns {Promise<string | null>} Absolute path to the picked folder, or null if cancelled.
- */
-export async function openPlatformFolderDialog() {
-  const result = await bridge.call(
-    PLATFORM_BRIDGE_METHODS.DIALOG_OPEN_FOLDER,
-    [],
-  )
-  return result?.path ?? null
-}
-
-/**
- * @returns {Promise<string | null>} Absolute path to the picked parent folder, or null if cancelled.
- */
-export async function savePlatformFolderDialog() {
-  const result = await bridge.call(
-    PLATFORM_BRIDGE_METHODS.DIALOG_SAVE_FOLDER,
-    [],
-  )
-  return result?.path ?? null
-}
-
-/**
- * @returns {Promise<string | null>} Absolute path to the picked image, or null if cancelled.
- */
-export async function openPlatformImageDialog() {
+import { bridge } from './client.mjs'
+import { PLATFORM_BRIDGE_METHODS } from './methods.mjs'
+
+/**
+ * @returns {Promise<string | null>} Absolute path to the picked folder, or null if cancelled.
+ */
+export async function openPlatformFolderDialog() {
+  const result = await bridge.call(
+    PLATFORM_BRIDGE_METHODS.DIALOG_OPEN_FOLDER,
+    [],
+  )
+  return result?.path ?? null
+}
+
+/**
+ * @returns {Promise<string | null>} Absolute path to the picked parent folder, or null if cancelled.
+ */
+export async function savePlatformFolderDialog() {
+  const result = await bridge.call(
+    PLATFORM_BRIDGE_METHODS.DIALOG_SAVE_FOLDER,
+    [],
+  )
+  return result?.path ?? null
+}
+
+/**
+ * @returns {Promise<string | null>} Absolute path to the picked image, or null if cancelled.
+ */
+export async function openPlatformImageDialog() {
   const result = await bridge.call(
     PLATFORM_BRIDGE_METHODS.DIALOG_OPEN_IMAGE,
     [],
-  )
-  return result?.path ?? null
-}
-
-/**
- * @returns {Promise<string | null>} Absolute path to the picked file, or null if cancelled.
- */
-export async function openPlatformFileDialog() {
-  const result = await bridge.call(PLATFORM_BRIDGE_METHODS.DIALOG_OPEN_FILE, [])
-  return result?.path ?? null
-}
+  )
+  return result?.path ?? null
+}
+
+/**
+ * @returns {Promise<string | null>} Absolute path to the picked file, or null if cancelled.
+ */
+export async function openPlatformFileDialog() {
+  const result = await bridge.call(PLATFORM_BRIDGE_METHODS.DIALOG_OPEN_FILE, [])
+  return result?.path ?? null
+}

package/src/bridge/dialog.test.ts

@@ -1,73 +1,73 @@
-import { beforeEach, describe, expect, it, vi } from 'vitest'
-import { PLATFORM_BRIDGE_METHODS } from './methods.mjs'
-
-const bridgeCall = vi.hoisted(() => vi.fn())
-
-vi.mock('./client.mjs', () => ({
-  bridge: {
-    call: bridgeCall,
-  },
-}))
-
-import {
-  openPlatformFileDialog,
-  openPlatformFolderDialog,
-  openPlatformImageDialog,
-  savePlatformFolderDialog,
-} from './dialog.mjs'
-
-beforeEach(() => {
-  bridgeCall.mockReset()
-})
-
-describe('dialog bridge helpers', () => {
-  it('opens a folder dialog using the shell method with no arguments', async () => {
-    bridgeCall.mockResolvedValue({ path: '/tmp' })
-
-    await expect(openPlatformFolderDialog()).resolves.toBe('/tmp')
-
-    expect(bridgeCall).toHaveBeenCalledWith(
-      PLATFORM_BRIDGE_METHODS.DIALOG_OPEN_FOLDER,
-      [],
-    )
-  })
-
-  it('opens a save folder dialog using the shell method with no arguments', async () => {
-    bridgeCall.mockResolvedValue({ path: '/tmp/project' })
-
-    await expect(savePlatformFolderDialog()).resolves.toBe('/tmp/project')
-
-    expect(bridgeCall).toHaveBeenCalledWith(
-      PLATFORM_BRIDGE_METHODS.DIALOG_SAVE_FOLDER,
-      [],
-    )
-  })
-
-  it('opens an image dialog using the shell method with no arguments', async () => {
-    bridgeCall.mockResolvedValue({ path: '/tmp/image.png' })
-
-    await expect(openPlatformImageDialog()).resolves.toBe('/tmp/image.png')
-
-    expect(bridgeCall).toHaveBeenCalledWith(
-      PLATFORM_BRIDGE_METHODS.DIALOG_OPEN_IMAGE,
-      [],
-    )
-  })
-
-  it('opens a file dialog using the shell method with no arguments', async () => {
-    bridgeCall.mockResolvedValue({ path: '/tmp/file.md' })
-
-    await expect(openPlatformFileDialog()).resolves.toBe('/tmp/file.md')
-
-    expect(bridgeCall).toHaveBeenCalledWith(
-      PLATFORM_BRIDGE_METHODS.DIALOG_OPEN_FILE,
-      [],
-    )
-  })
-
-  it('returns null when the shell dialog is cancelled', async () => {
-    bridgeCall.mockResolvedValue({ path: null })
-
-    await expect(openPlatformFolderDialog()).resolves.toBeNull()
-  })
-})
+import { beforeEach, describe, expect, it, vi } from 'vitest'
+import { PLATFORM_BRIDGE_METHODS } from './methods.mjs'
+
+const bridgeCall = vi.hoisted(() => vi.fn())
+
+vi.mock('./client.mjs', () => ({
+  bridge: {
+    call: bridgeCall,
+  },
+}))
+
+import {
+  openPlatformFileDialog,
+  openPlatformFolderDialog,
+  openPlatformImageDialog,
+  savePlatformFolderDialog,
+} from './dialog.mjs'
+
+beforeEach(() => {
+  bridgeCall.mockReset()
+})
+
+describe('dialog bridge helpers', () => {
+  it('opens a folder dialog using the shell method with no arguments', async () => {
+    bridgeCall.mockResolvedValue({ path: '/tmp' })
+
+    await expect(openPlatformFolderDialog()).resolves.toBe('/tmp')
+
+    expect(bridgeCall).toHaveBeenCalledWith(
+      PLATFORM_BRIDGE_METHODS.DIALOG_OPEN_FOLDER,
+      [],
+    )
+  })
+
+  it('opens a save folder dialog using the shell method with no arguments', async () => {
+    bridgeCall.mockResolvedValue({ path: '/tmp/project' })
+
+    await expect(savePlatformFolderDialog()).resolves.toBe('/tmp/project')
+
+    expect(bridgeCall).toHaveBeenCalledWith(
+      PLATFORM_BRIDGE_METHODS.DIALOG_SAVE_FOLDER,
+      [],
+    )
+  })
+
+  it('opens an image dialog using the shell method with no arguments', async () => {
+    bridgeCall.mockResolvedValue({ path: '/tmp/image.png' })
+
+    await expect(openPlatformImageDialog()).resolves.toBe('/tmp/image.png')
+
+    expect(bridgeCall).toHaveBeenCalledWith(
+      PLATFORM_BRIDGE_METHODS.DIALOG_OPEN_IMAGE,
+      [],
+    )
+  })
+
+  it('opens a file dialog using the shell method with no arguments', async () => {
+    bridgeCall.mockResolvedValue({ path: '/tmp/file.md' })
+
+    await expect(openPlatformFileDialog()).resolves.toBe('/tmp/file.md')
+
+    expect(bridgeCall).toHaveBeenCalledWith(
+      PLATFORM_BRIDGE_METHODS.DIALOG_OPEN_FILE,
+      [],
+    )
+  })
+
+  it('returns null when the shell dialog is cancelled', async () => {
+    bridgeCall.mockResolvedValue({ path: null })
+
+    await expect(openPlatformFolderDialog()).resolves.toBeNull()
+  })
+})