@puredesktop/puredesktop-ui-bridge 2.1.4 → 2.1.7

package/src/bridge/storage.mjs

@@ -1,18 +1,18 @@
-import { bridge } from './client.mjs'
-import { PLATFORM_BRIDGE_METHODS } from './methods.mjs'
-
-/**
- * @param {{ appSlug: string, fileName: string }} request
- * @returns {Promise<{ path: string, value: unknown | null }>}
- */
-export async function readPlatformStorageJson(request) {
-  return bridge.call(PLATFORM_BRIDGE_METHODS.STORAGE_READ_JSON, [request])
-}
-
-/**
- * @param {{ appSlug: string, fileName: string, value: unknown }} request
- * @returns {Promise<{ path: string, ok: true }>}
- */
-export async function writePlatformStorageJson(request) {
-  return bridge.call(PLATFORM_BRIDGE_METHODS.STORAGE_WRITE_JSON, [request])
-}
+import { bridge } from './client.mjs'
+import { PLATFORM_BRIDGE_METHODS } from './methods.mjs'
+
+/**
+ * @param {{ appSlug: string, fileName: string }} request
+ * @returns {Promise<{ path: string, value: unknown | null }>}
+ */
+export async function readPlatformStorageJson(request) {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.STORAGE_READ_JSON, [request])
+}
+
+/**
+ * @param {{ appSlug: string, fileName: string, value: unknown }} request
+ * @returns {Promise<{ path: string, ok: true }>}
+ */
+export async function writePlatformStorageJson(request) {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.STORAGE_WRITE_JSON, [request])
+}

package/src/bridge/storage.test.ts

@@ -1,49 +1,49 @@
-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 {
-  readPlatformStorageJson,
-  writePlatformStorageJson,
-} from './storage.mjs'
-
-beforeEach(() => {
-  bridgeCall.mockReset()
-})
-
-describe('storage bridge helpers', () => {
-  it('reads JSON storage using the shell request object shape', async () => {
-    const request = { appSlug: 'puretasks', fileName: 'tasks.json' }
-    bridgeCall.mockResolvedValue({ path: '/tmp/tasks.json', value: null })
-
-    await readPlatformStorageJson(request)
-
-    expect(bridgeCall).toHaveBeenCalledWith(
-      PLATFORM_BRIDGE_METHODS.STORAGE_READ_JSON,
-      [request],
-    )
-  })
-
-  it('writes JSON storage using the shell request object shape', async () => {
+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 {
+  readPlatformStorageJson,
+  writePlatformStorageJson,
+} from './storage.mjs'
+
+beforeEach(() => {
+  bridgeCall.mockReset()
+})
+
+describe('storage bridge helpers', () => {
+  it('reads JSON storage using the shell request object shape', async () => {
+    const request = { appSlug: 'puretasks', fileName: 'tasks.json' } as const
+    bridgeCall.mockResolvedValue({ path: '/tmp/tasks.json', value: null })
+
+    await readPlatformStorageJson(request)
+
+    expect(bridgeCall).toHaveBeenCalledWith(
+      PLATFORM_BRIDGE_METHODS.STORAGE_READ_JSON,
+      [request],
+    )
+  })
+
+  it('writes JSON storage using the shell request object shape', async () => {
     const request = {
       appSlug: 'puretasks',
       fileName: 'tasks.json',
       value: { tasks: [] },
-    }
-    bridgeCall.mockResolvedValue({ path: '/tmp/tasks.json', ok: true })
-
-    await writePlatformStorageJson(request)
-
-    expect(bridgeCall).toHaveBeenCalledWith(
-      PLATFORM_BRIDGE_METHODS.STORAGE_WRITE_JSON,
-      [request],
-    )
-  })
-})
+    } as const
+    bridgeCall.mockResolvedValue({ path: '/tmp/tasks.json', ok: true })
+
+    await writePlatformStorageJson(request)
+
+    expect(bridgeCall).toHaveBeenCalledWith(
+      PLATFORM_BRIDGE_METHODS.STORAGE_WRITE_JSON,
+      [request],
+    )
+  })
+})

package/src/bridge/types.ts

@@ -34,6 +34,10 @@ export interface PlatformShellPreferences {
   betaFeatures?: {
     /** Enables model-backed Pure Render reference-image extraction in app panels. */
     pureRenderVisionExtraction?: boolean
+    /** Enables unfinished claim/fact-check review entry points. */
+    factCheck?: boolean
+    /** Enables the unfinished Manuscript More launcher menu. */
+    manuscriptMoreMenu?: boolean
   }
   /**
    * Host-only workspace tab session (phase 4). Plugin apps should ignore this field.
@@ -255,64 +259,64 @@ export interface PlatformAppInstallState {
   pluginRoot?: string
 }
 
-export interface PlatformFileReadPreviewResult {
-  path: string
-  content: string | null
-  truncated: boolean
-  encoding: 'utf-8'
-}
-
-export interface PlatformFileEntry {
-  path: string
-  name: string
-  extension: string
-  kind: PlatformFileKind
-  mimeType: string
-  byteLength: number
-  modifiedAt: string
-  isDirectory: boolean
-}
-
-export interface PlatformFileListResult {
-  rootPath: string
-  parentPath: string | null
-  entries: PlatformFileEntry[]
-}
-
-export interface PlatformFileReadBinaryResult {
-  path: string
-  mimeType: string
-  base64: string
-  truncated: boolean
-  byteLength: number
-}
-
-export interface PlatformFilePreviewUrlResult {
-  path: string
-  url: string
-  mimeType: string
-  byteLength: number
-}
-
-export interface PlatformFileCreateFolderResult {
-  path: string
-}
-
-export interface PlatformFileRenameResult {
-  path: string
-}
-
-export interface PlatformFileWriteResult {
-  ok: true
-}
-
-export interface PlatformFileDeleteResult {
-  ok: true
-}
-
-/** Minimal file entry fields required for inline preview in plugin iframes. */
-export interface PlatformFilePreviewEntry {
-  path: string
+export interface PlatformFileReadPreviewResult {
+  path: string
+  content: string | null
+  truncated: boolean
+  encoding: 'utf-8'
+}
+
+export interface PlatformFileEntry {
+  path: string
+  name: string
+  extension: string
+  kind: PlatformFileKind
+  mimeType: string
+  byteLength: number
+  modifiedAt: string
+  isDirectory: boolean
+}
+
+export interface PlatformFileListResult {
+  rootPath: string
+  parentPath: string | null
+  entries: PlatformFileEntry[]
+}
+
+export interface PlatformFileReadBinaryResult {
+  path: string
+  mimeType: string
+  base64: string
+  truncated: boolean
+  byteLength: number
+}
+
+export interface PlatformFilePreviewUrlResult {
+  path: string
+  url: string
+  mimeType: string
+  byteLength: number
+}
+
+export interface PlatformFileCreateFolderResult {
+  path: string
+}
+
+export interface PlatformFileRenameResult {
+  path: string
+}
+
+export interface PlatformFileWriteResult {
+  ok: true
+}
+
+export interface PlatformFileDeleteResult {
+  ok: true
+}
+
+/** Minimal file entry fields required for inline preview in plugin iframes. */
+export interface PlatformFilePreviewEntry {
+  path: string
   name: string
   extension: string
   kind: PlatformFileKind

package/src/bridge/window.d.mts

@@ -41,4 +41,6 @@ export declare function startScreenCapture(options?: {
   options?: PlatformScreenCaptureOption[]
 }): Promise<PlatformScreenCaptureResult | null>
 
-export declare function onScreenCaptureShortcut(listener: () => void): () => void
+export declare function onScreenCaptureShortcut(
+  listener: () => void,
+): () => void

package/src/bridge/workspace.d.mts

@@ -0,0 +1,7 @@
+export interface UpdateCurrentWorkspaceTabRequest {
+  title?: string
+}
+
+export declare function updateCurrentWorkspaceTab(
+  request: UpdateCurrentWorkspaceTabRequest,
+): Promise<{ updated: boolean }>

package/src/bridge/workspace.mjs

@@ -0,0 +1,8 @@
+import { bridge } from './client.mjs'
+import { PLATFORM_BRIDGE_METHODS } from './methods.mjs'
+
+export function updateCurrentWorkspaceTab(request) {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.WORKSPACE_UPDATE_CURRENT_TAB, [
+    request,
+  ])
+}

package/src/bridge/workspace.ts

@@ -0,0 +1 @@
+export { updateCurrentWorkspaceTab } from './workspace.mjs'

package/src/commitments/commitments.test.ts

@@ -129,10 +129,15 @@ describe('commitments domain model', () => {
       ),
       '2026-06-21T13:00:00.000Z',
     )
-    const store = { ...emptyCommitmentStore(), commitments: [resolved, dismissed] }
+    const store = {
+      ...emptyCommitmentStore(),
+      commitments: [resolved, dismissed],
+    }
 
     expect(commitmentBuckets(store, { now: NOW }).youOwe).toHaveLength(0)
-    expect(commitmentBuckets(store, { now: NOW, includeClosed: true }).youOwe).toHaveLength(1)
+    expect(
+      commitmentBuckets(store, { now: NOW, includeClosed: true }).youOwe,
+    ).toHaveLength(1)
   })
 
   it('hides snoozed commitments until their snooze date', () => {
@@ -195,7 +200,9 @@ describe('commitments domain model', () => {
     )
     const store = { ...emptyCommitmentStore(), commitments: [commitment] }
 
-    expect(commitmentsByCounterparty(store, 'mira', { now: NOW })).toHaveLength(1)
+    expect(commitmentsByCounterparty(store, 'mira', { now: NOW })).toHaveLength(
+      1,
+    )
     expect(store.commitments[0].links?.[0].type).toBe('task')
   })
 })

package/src/commitments/commitments.ts

@@ -219,7 +219,12 @@ export function reactivateSnoozedCommitments(
       commitment.status === 'snoozed' &&
       commitment.snoozedUntil &&
       commitment.snoozedUntil <= now
-        ? { ...commitment, status: 'open', snoozedUntil: undefined, updatedAt: now }
+        ? {
+            ...commitment,
+            status: 'open',
+            snoozedUntil: undefined,
+            updatedAt: now,
+          }
         : commitment,
     ),
   }
@@ -270,13 +275,18 @@ export function commitmentBuckets(
   options: CommitmentQueryOptions = {},
 ): CommitmentBuckets {
   const now = options.now ?? new Date().toISOString()
-  const commitments = openCommitments(store, { ...options, includeClosed: true })
+  const commitments = openCommitments(store, {
+    ...options,
+    includeClosed: true,
+  })
   const visible = commitments.filter(
     commitment => options.includeClosed || commitment.status === 'open',
   )
   return {
     youOwe: visible.filter(commitment => commitment.direction === 'you_owe'),
-    waitingOn: visible.filter(commitment => commitment.direction === 'waiting_on'),
+    waitingOn: visible.filter(
+      commitment => commitment.direction === 'waiting_on',
+    ),
     dueToday: visible.filter(
       commitment => commitmentDueState(commitment, now) === 'due_today',
     ),
@@ -322,7 +332,11 @@ export function commitmentsByCounterparty(
 }
 
 function validateCommitmentSource(input: CommitmentInput | Commitment): void {
-  if (input.source && input.source.type !== 'manual' && !input.sourceQuote?.trim()) {
+  if (
+    input.source &&
+    input.source.type !== 'manual' &&
+    !input.sourceQuote?.trim()
+  ) {
     throw new Error('Extracted commitments require a source quote.')
   }
 }

package/src/components/accessibility/AccessibilityReviewDialog.tsx

@@ -291,7 +291,10 @@ export function AccessibilityReviewDialog({
     setDismissed(new Set())
   }, [html])
 
-  const applyAndDismiss = (issue: AccessibilityIssue, nextHtml: string): void => {
+  const applyAndDismiss = (
+    issue: AccessibilityIssue,
+    nextHtml: string,
+  ): void => {
     onChange(nextHtml)
     setDismissed(current => new Set(current).add(issue.id))
   }
@@ -316,7 +319,9 @@ export function AccessibilityReviewDialog({
             No chapter-level accessibility findings in this pass.
           </InlineBanner>
         ) : visibleIssues.length === 0 ? (
-          <InlineBanner>All findings in this queue are handled or ignored.</InlineBanner>
+          <InlineBanner>
+            All findings in this queue are handled or ignored.
+          </InlineBanner>
         ) : (
           <StyledQueue>
             {visibleIssues.map(issue => (

package/src/components/accessibility/accessibilityReview.test.ts

@@ -58,7 +58,8 @@ describe('applyAccessibilityIssueFix', () => {
 
 describe('accessibility draft fixes', () => {
   it('drafts image alt text from nearby figure captions', () => {
-    const html = '<figure><img src="chart.png"><figcaption>Revenue by quarter</figcaption></figure>'
+    const html =
+      '<figure><img src="chart.png"><figcaption>Revenue by quarter</figcaption></figure>'
     const issue = auditHtmlAccessibility(html).find(
       finding => finding.ruleId === 'image-missing-alt',
     )
@@ -67,12 +68,17 @@ describe('accessibility draft fixes', () => {
     const draft = getAccessibilityIssueDraft(html, issue!)
     expect(draft?.value).toBe('Revenue by quarter')
 
-    const fixed = applyAccessibilityIssueDraft(html, issue!, 'Quarterly revenue trend')
+    const fixed = applyAccessibilityIssueDraft(
+      html,
+      issue!,
+      'Quarterly revenue trend',
+    )
     expect(fixed).toContain('alt="Quarterly revenue trend"')
   })
 
   it('drafts table captions from header-like first rows', () => {
-    const html = '<table><tr><td>Name</td><td>Value</td></tr><tr><td>A</td><td>2</td></tr></table>'
+    const html =
+      '<table><tr><td>Name</td><td>Value</td></tr><tr><td>A</td><td>2</td></tr></table>'
     const issue = auditHtmlAccessibility(html).find(
       finding => finding.ruleId === 'table-missing-caption',
     )
@@ -86,7 +92,8 @@ describe('accessibility draft fixes', () => {
   })
 
   it('drafts clearer link labels from the destination', () => {
-    const html = '<p><a href="https://example.com/research-notes">click here</a></p>'
+    const html =
+      '<p><a href="https://example.com/research-notes">click here</a></p>'
     const issue = auditHtmlAccessibility(html).find(
       finding => finding.ruleId === 'link-ambiguous-label',
     )

package/src/components/accessibility/accessibilityReview.ts

@@ -120,10 +120,7 @@ function humanizePathPart(value: string): string {
   const withoutQuery = value.split(/[?#]/)[0] ?? ''
   const lastPart = withoutQuery.split('/').filter(Boolean).pop() ?? ''
   const withoutExtension = lastPart.replace(/\.[a-z0-9]+$/i, '')
-  return withoutExtension
-    .replace(/[-_]+/g, ' ')
-    .replace(/\s+/g, ' ')
-    .trim()
+  return withoutExtension.replace(/[-_]+/g, ' ').replace(/\s+/g, ' ').trim()
 }
 
 function readableLinkDestination(href: string): string {
@@ -186,7 +183,9 @@ function figureCaptionDraft(figure: Element): string {
   const alt = image?.getAttribute('alt')?.trim()
   if (alt) return clipDraft(alt)
 
-  const sourceLabel = image ? humanizePathPart(image.getAttribute('src') ?? '') : ''
+  const sourceLabel = image
+    ? humanizePathPart(image.getAttribute('src') ?? '')
+    : ''
   if (sourceLabel) return clipDraft(sourceLabel, 100)
 
   return nearbySentence(figure) || 'Figure summary'
@@ -384,7 +383,9 @@ export function auditHtmlAccessibility(html: string): AccessibilityIssue[] {
 
   for (const media of Array.from(main.querySelectorAll('video,audio'))) {
     const target = selectorFor(media)
-    if (!media.querySelector('track[kind="captions"],track[kind="subtitles"]')) {
+    if (
+      !media.querySelector('track[kind="captions"],track[kind="subtitles"]')
+    ) {
       pushIssue(issues, {
         ruleId: 'media-missing-captions',
         category: 'media',
@@ -427,7 +428,10 @@ export function auditHtmlAccessibility(html: string): AccessibilityIssue[] {
   return issues
 }
 
-function findTarget(document: Document, issue: AccessibilityIssue): Element | null {
+function findTarget(
+  document: Document,
+  issue: AccessibilityIssue,
+): Element | null {
   const main = document.body.querySelector('main')
   return issue.target ? main?.querySelector(issue.target) ?? null : null
 }
@@ -476,7 +480,8 @@ export function applyAccessibilityIssueFix(
           header.setAttribute('scope', 'col')
           header.innerHTML = cell.innerHTML
           for (const attr of Array.from(cell.attributes)) {
-            if (attr.name !== 'scope') header.setAttribute(attr.name, attr.value)
+            if (attr.name !== 'scope')
+              header.setAttribute(attr.name, attr.value)
           }
           cell.replaceWith(header)
         }
@@ -527,7 +532,8 @@ export function getAccessibilityIssueDraft(
     case 'table-missing-caption':
       return {
         label: 'Caption',
-        description: 'A brief table title for readers and assistive technology.',
+        description:
+          'A brief table title for readers and assistive technology.',
         value: tableCaptionDraft(target),
         applyLabel: 'Add caption',
       }
@@ -628,7 +634,9 @@ export function annotateAccessibilityIssue(
   target.setAttribute('data-comment-type', 'agent-review')
   target.setAttribute(
     'data-comment-text',
-    `${issue.title}: ${issue.detail} (${issue.standard} ${issue.wcag.join(', ')})`,
+    `${issue.title}: ${issue.detail} (${issue.standard} ${issue.wcag.join(
+      ', ',
+    )})`,
   )
   target.setAttribute('data-comment-author', ISSUE_AUTHOR)
   target.setAttribute('data-comment-created-at', new Date().toISOString())

package/src/components/agent-feedback/ScreenAnnotationAgentDialog.tsx

@@ -138,7 +138,10 @@ function drawLine(
   context.restore()
 }
 
-function normalizeRect(start: { x: number; y: number }, end: { x: number; y: number }): Rect {
+function normalizeRect(
+  start: { x: number; y: number },
+  end: { x: number; y: number },
+): Rect {
   return {
     x: Math.min(start.x, end.x),
     y: Math.min(start.y, end.y),
@@ -158,7 +161,11 @@ function defaultSelection(canvas: HTMLCanvasElement): Rect {
   }
 }
 
-function drawSelectionOverlay(canvas: HTMLCanvasElement, source: HTMLCanvasElement, rect: Rect): void {
+function drawSelectionOverlay(
+  canvas: HTMLCanvasElement,
+  source: HTMLCanvasElement,
+  rect: Rect,
+): void {
   const context = canvas.getContext('2d')
   if (!context) return
   canvas.width = source.width

package/src/components/agents/AgentContextUsageBar.tsx

@@ -48,10 +48,12 @@ export function AgentContextUsageBar({
   const percent = usage ? contextUsagePercent(usage) : undefined
   const label =
     total && usage?.contextWindowTokens
-      ? `${prefix}${total} / ${formatAgentTokenCount(usage.contextWindowTokens)}`
+      ? `${prefix}${total} / ${formatAgentTokenCount(
+          usage.contextWindowTokens,
+        )}`
       : total
-        ? `${prefix}${total} tokens`
-        : null
+      ? `${prefix}${total} tokens`
+      : null
 
   if (!label) return null
 

package/src/components/agents/AgentDrawerPanel.test.tsx

@@ -1,6 +1,14 @@
 import { act } from 'react'
 import { createRoot, type Root } from 'react-dom/client'
-import { afterEach, beforeAll, beforeEach, describe, expect, it, vi } from 'vitest'
+import {
+  afterEach,
+  beforeAll,
+  beforeEach,
+  describe,
+  expect,
+  it,
+  vi,
+} from 'vitest'
 import { AgentDrawerPanel } from './AgentDrawerPanel.js'
 import {
   AgentLivePhase,
@@ -205,7 +213,9 @@ describe('AgentDrawerPanel composer and steering behavior', () => {
       }),
     )
 
-    const sendNow = host.querySelector('button[aria-label="Send follow-up now"]')
+    const sendNow = host.querySelector(
+      'button[aria-label="Send follow-up now"]',
+    )
     const remove = host.querySelector('button[aria-label="Remove follow-up"]')
     const textarea = host.querySelector('textarea')
     const composerSurface = textarea?.parentElement
@@ -244,7 +254,9 @@ describe('AgentDrawerPanel composer and steering behavior', () => {
       }),
     )
 
-    const sendNow = host.querySelector('button[aria-label="Send follow-up now"]')
+    const sendNow = host.querySelector(
+      'button[aria-label="Send follow-up now"]',
+    )
 
     expect(sendNow).toBeInstanceOf(HTMLButtonElement)
     expect((sendNow as HTMLButtonElement).disabled).toBe(false)

package/src/components/agents/AgentMessageBubble.tsx

@@ -104,9 +104,7 @@ function formatToolRowSummary(call: AgentUiToolCall): string {
   return formatAgentToolRowSummary(call)
 }
 
-function formatToolRowDetails(
-  call: AgentUiToolCall,
-): string[] | undefined {
+function formatToolRowDetails(call: AgentUiToolCall): string[] | undefined {
   if (call.delegatedActivity) {
     return delegatedActivityDetails(call.delegatedActivity)
   }

package/src/components/agents/AgentQuestionPromptList.tsx

@@ -39,7 +39,7 @@ const StyledPrompt = styled(FlexCol)`
   gap: var(--platform-spacing-sm);
   padding: 10px;
   border: 1px solid var(--platform-colors-border);
-  border-radius: 8px;
+  border-radius: var(--platform-radius-sm);
   background: var(--platform-colors-bg);
 `
 
@@ -62,7 +62,7 @@ const StyledOptionButton = styled.button<{ $selected: boolean }>`
       $selected
         ? 'var(--platform-colors-accent)'
         : 'var(--platform-colors-border)'};
-  border-radius: var(--platform-radius-sm, 6px);
+  border-radius: var(--platform-radius-sm);
   background: ${({ $selected }) =>
     $selected
       ? 'color-mix(in srgb, var(--platform-colors-accent) 10%, var(--platform-colors-bg))'
@@ -98,7 +98,7 @@ const StyledDeclineInput = styled.input`
   height: 28px;
   padding: 0 9px;
   border: 1px solid var(--platform-colors-border);
-  border-radius: var(--platform-radius-sm, 6px);
+  border-radius: var(--platform-radius-sm);
   background: var(--platform-colors-surface);
   color: var(--platform-colors-text);
   font: inherit;

package/src/components/agents/AgentToolApprovalActions.tsx

@@ -39,9 +39,7 @@ export function AgentToolApprovalActions({
           disabled={busy}
           menuPlacement="above"
           aria-label="Approve"
-          onSelect={() =>
-            onApproveAlwaysForSession(toolCall.name, toolCall.id)
-          }
+          onSelect={() => onApproveAlwaysForSession(toolCall.name, toolCall.id)}
         />
       ) : (
         <Button

package/src/components/agents/agentPanelStyles.ts

@@ -25,9 +25,7 @@ export const StyledAgentThreadHost = styled.div`
 
 export const StyledAgentScroll = styled.div`
   position: relative;
-  flex: 1 1 auto;
   min-height: 0;
-  overflow: hidden;
   display: flex;
   flex-direction: column;
   --platform-agent-thread-header-height: 0px;
@@ -132,7 +130,7 @@ export const StyledFollowUpRow = styled.div`
   min-width: 0;
   padding: 6px 8px;
   border: 1px solid var(--platform-colors-border);
-  border-radius: 8px;
+  border-radius: var(--platform-radius-sm, 0px);
   background: var(--platform-colors-bg);
 `