@puredesktop/puredesktop-ui-bridge 1.0.0-beta.1 → 2.1.0

package/src/components/agents/agentTypes.ts

@@ -1,96 +1,139 @@
-/** Presentational run state — mirrors shell `AgentRunState` without importing shell code. */
-export const AgentUiRunState = {
-  Ready: 'ready',
-  PendingTools: 'pending_tools',
-  AwaitingUser: 'awaiting_user',
-  Failed: 'failed',
-  Interrupted: 'interrupted',
-} as const
-
-export type AgentUiRunState =
-  (typeof AgentUiRunState)[keyof typeof AgentUiRunState]
-
-export type AgentUiMessageRole = 'user' | 'assistant' | 'tool'
-
-export interface AgentUiToolCall {
-  id: string
-  name: string
-  arguments: Record<string, unknown>
-}
-
-export const AgentLivePhase = {
-  Idle: 'idle',
-  Thinking: 'thinking',
-  Responding: 'responding',
-  ToolsPending: 'tools_pending',
-  ToolRunning: 'tool_running',
-} as const
-
-export type AgentLivePhase =
-  (typeof AgentLivePhase)[keyof typeof AgentLivePhase]
-
-export interface AgentLiveActiveTool {
-  toolCallId: string
-  name: string
-  arguments?: Record<string, unknown>
-}
-
-export interface AgentLiveTurn {
-  phase: AgentLivePhase
-  thinking: string
-  text: string
-  toolCalls: AgentUiToolCall[]
-  activeTool?: AgentLiveActiveTool
-  /** From context_compaction_* run events — not separate React state. */
-  contextCompaction?: 'summarizing' | 'summarized'
-}
-
-export interface AgentUiMessage {
-  id: string
-  role: AgentUiMessageRole
-  content: string
-  thinking?: string
-  streaming?: boolean
-  toolCalls?: AgentUiToolCall[]
-  activeTool?: AgentLiveActiveTool
-}
-
-export interface AgentModelOption {
-  value: string
-  label: string
-}
-
-export interface AgentUiRunUsage {
-  inputTokens: number
-  outputTokens: number
-  totalTokens: number
-  contextWindowTokens?: number
-  contextFillTokens?: number
-  estimated?: boolean
-}
-
-export interface AgentDrawerPanelProps {
-  messages: AgentUiMessage[]
-  assistantLabel?: string
-  liveTurn?: AgentLiveTurn | null
-  pendingToolCalls: AgentUiToolCall[]
-  runState: AgentUiRunState | null
-  busy: boolean
-  error: string | null
-  composerValue: string
-  composerDisabled?: boolean
-  composerLeading?: React.ReactNode
-  onComposerChange: (value: string) => void
-  onSend: () => void
-  onStop?: () => void
-  onApproveTools: () => void
-  onRejectTools: () => void
-  onApproveOne?: (toolCallId: string) => void
-  onRejectOne?: (toolCallId: string) => void
-  onApproveAlwaysForSession?: (
-    qualifiedName: string,
-    toolCallId: string,
-  ) => void
-  storageHint?: string | null
-  usage?: AgentUiRunUsage | null
-}
+/** Presentational run state — mirrors shell `AgentRunState` without importing shell code. */
+export const AgentUiRunState = {
+  Ready: 'ready',
+  PendingTools: 'pending_tools',
+  AwaitingUser: 'awaiting_user',
+  Failed: 'failed',
+  Interrupted: 'interrupted',
+} as const
+
+export type AgentUiRunState =
+  (typeof AgentUiRunState)[keyof typeof AgentUiRunState]
+
+export type AgentUiMessageRole = 'user' | 'assistant' | 'tool'
+
+export interface AgentUiToolCall {
+  id: string
+  name: string
+  arguments: Record<string, unknown>
+  result?: string
+  status?: 'running' | 'done'
+  delegatedActivity?: AgentDelegatedActivity
+}
+
+export const AgentLivePhase = {
+  Idle: 'idle',
+  Thinking: 'thinking',
+  Responding: 'responding',
+  ToolsPending: 'tools_pending',
+  ToolRunning: 'tool_running',
+} as const
+
+export type AgentLivePhase =
+  (typeof AgentLivePhase)[keyof typeof AgentLivePhase]
+
+export interface AgentLiveActiveTool {
+  toolCallId: string
+  name: string
+  arguments?: Record<string, unknown>
+}
+
+export interface AgentLiveTurn {
+  phase: AgentLivePhase
+  thinking: string
+  text: string
+  toolCalls: AgentUiToolCall[]
+  activeTool?: AgentLiveActiveTool
+  /** From context_compaction_* run events — not separate React state. */
+  contextCompaction?: 'summarizing' | 'summarized'
+}
+
+export interface AgentUiMessage {
+  id: string
+  role: AgentUiMessageRole
+  content: string
+  thinking?: string
+  streaming?: boolean
+  toolCalls?: AgentUiToolCall[]
+  activeTool?: AgentLiveActiveTool
+}
+
+export interface AgentDelegatedActivity {
+  delegationId: string
+  childSessionId: string
+  childJobId?: string
+  childAppSlug: string
+  liveTurn: AgentLiveTurn
+  snapshotState?: AgentUiRunState
+}
+
+export interface AgentUiFollowUp {
+  id: string
+  message: string
+  position: number
+}
+
+export interface AgentModelOption {
+  value: string
+  label: string
+  groupLabel?: string
+  meta?: string
+}
+
+export interface AgentUiRunUsage {
+  inputTokens: number
+  outputTokens: number
+  totalTokens: number
+  contextWindowTokens?: number
+  contextFillTokens?: number
+  estimated?: boolean
+}
+
+export interface AgentDrawerPanelProps {
+  messages: AgentUiMessage[]
+  assistantLabel?: string
+  liveTurn?: AgentLiveTurn | null
+  pendingToolCalls: AgentUiToolCall[]
+  pendingQuestionToolCalls?: AgentUiToolCall[]
+  runState: AgentUiRunState | null
+  busy: boolean
+  error: string | null
+  composerValue: string
+  composerDisabled?: boolean
+  composerInputDisabled?: boolean
+  composerSendDisabled?: boolean
+  composerLeading?: React.ReactNode
+  followUps?: AgentUiFollowUp[]
+  activityHint?: string | null
+  onComposerChange: (value: string) => void
+  onSend: () => void
+  onStop?: () => void
+  onRemoveFollowUp?: (followUpId: string) => void
+  onSendFollowUpNow?: (followUpId: string) => void
+  onApproveTools: () => void
+  onRejectTools: () => void
+  onApproveOne?: (toolCallId: string) => void
+  onRejectOne?: (toolCallId: string) => void
+  onApproveAlwaysForSession?: (
+    qualifiedName: string,
+    toolCallId: string,
+  ) => void
+  onAnswerQuestionTool?: (
+    toolCallId: string,
+    selectedOptionIds: readonly string[],
+  ) => void | Promise<void>
+  onDeclineQuestionTool?: (
+    toolCallId: string,
+    declineReason: string,
+  ) => void | Promise<void>
+  storageHint?: string | null
+  usage?: AgentUiRunUsage | null
+  /** Pure Assistant workspace tab is active — shell sets this; UI leaves layout to the host. */
+  pureAssistantTabActive?: boolean
+  /** Agent drawer panel is open (including forced-open on Pure Assistant). */
+  drawerOpen?: boolean
+  /** Composer is portaled by the shell — drawer keeps a footer spacer only. */
+  composerPortaled?: boolean
+  /** Shell thread chrome (scope, session actions) — anchored to the message column. */
+  threadHeader?: React.ReactNode
+}

package/src/components/agents/formatToolCallArguments.test.ts

@@ -1,16 +1,16 @@
-import { describe, expect, it } from 'vitest'
-import { formatToolCallArguments } from './formatToolCallArguments.js'
-
-describe('formatToolCallArguments', () => {
-  it('returns compact JSON', () => {
-    expect(formatToolCallArguments({ text: 'hi', n: 1 })).toBe(
-      '{"text":"hi","n":1}',
-    )
-  })
-
-  it('truncates long payloads', () => {
-    const long = formatToolCallArguments({ body: 'x'.repeat(300) }, 40)
-    expect(long.endsWith('…')).toBe(true)
-    expect(long.length).toBeLessThanOrEqual(40)
-  })
-})
+import { describe, expect, it } from 'vitest'
+import { formatToolCallArguments } from './formatToolCallArguments.js'
+
+describe('formatToolCallArguments', () => {
+  it('returns compact JSON', () => {
+    expect(formatToolCallArguments({ text: 'hi', n: 1 })).toBe(
+      '{"text":"hi","n":1}',
+    )
+  })
+
+  it('truncates long payloads', () => {
+    const long = formatToolCallArguments({ body: 'x'.repeat(300) }, 40)
+    expect(long.endsWith('…')).toBe(true)
+    expect(long.length).toBeLessThanOrEqual(40)
+  })
+})

package/src/components/agents/formatToolCallArguments.ts

@@ -1,9 +1,9 @@
-/** Compact tool args for approval UI — one line when possible. */
-export function formatToolCallArguments(
-  args: Record<string, unknown>,
-  maxLength = 240,
-): string {
-  const compact = JSON.stringify(args)
-  if (compact.length <= maxLength) return compact
-  return `${compact.slice(0, maxLength - 1)}…`
-}
+/** Compact tool args for approval UI — one line when possible. */
+export function formatToolCallArguments(
+  args: Record<string, unknown>,
+  maxLength = 240,
+): string {
+  const compact = JSON.stringify(args)
+  if (compact.length <= maxLength) return compact
+  return `${compact.slice(0, maxLength - 1)}…`
+}

package/src/components/agents/index.ts

@@ -1,40 +1,40 @@
-export { AgentDrawerPanel } from './AgentDrawerPanel.js'
-export { AgentMessageList, formatAssistantLabel } from './AgentMessageList.js'
-export { AgentMessageBubble } from './AgentMessageBubble.js'
-export { AgentToolPendingList } from './AgentToolPendingList.js'
-export { AgentComposer } from './AgentComposer.js'
-export {
-  AgentContextUsageBar,
-  formatAgentTokenCount,
-} from './AgentContextUsageBar.js'
-export {
-  AgentModelMenu,
-  buildAgentModelMenuOptions,
-  AGENT_AUTO_MODEL_ID,
-  AGENT_AUTO_MODEL_LABEL,
-  isAgentAutoModelId,
-  type AgentModelMenuProps,
-} from './AgentModelMenu.js'
-export {
-  ChatBox,
-  ChatModelMenu,
-  ChatThread,
-  ChatThreadEmpty,
-  ChatUserBubble,
-  ChatAssistantMessage,
-  ChatMarkdown,
-  ChatThinkingIndicator,
-  ChatStatusRow,
-  ChatToolRow,
-} from '../common/chat/index.js'
-export {
-  AgentLivePhase,
-  AgentUiRunState,
-  type AgentDrawerPanelProps,
-  type AgentLiveActiveTool,
-  type AgentLiveTurn,
-  type AgentModelOption,
-  type AgentUiMessage,
-  type AgentUiRunUsage,
-  type AgentUiToolCall,
-} from './agentTypes.js'
+export { AgentDrawerPanel } from './AgentDrawerPanel.js'
+export { AgentMessageList, formatAssistantLabel } from './AgentMessageList.js'
+export { AgentMessageBubble } from './AgentMessageBubble.js'
+export { AgentToolPendingList } from './AgentToolPendingList.js'
+export { AgentComposer } from './AgentComposer.js'
+export {
+  AgentContextUsageBar,
+  formatAgentTokenCount,
+} from './AgentContextUsageBar.js'
+export {
+  AgentModelMenu,
+  buildAgentModelMenuOptions,
+  AGENT_AUTO_MODEL_ID,
+  AGENT_AUTO_MODEL_LABEL,
+  isAgentAutoModelId,
+  type AgentModelMenuProps,
+} from './AgentModelMenu.js'
+export {
+  ChatBox,
+  ChatModelMenu,
+  ChatThread,
+  ChatThreadEmpty,
+  ChatUserBubble,
+  ChatAssistantMessage,
+  ChatMarkdown,
+  ChatThinkingIndicator,
+  ChatStatusRow,
+  ChatToolRow,
+} from '../common/chat/index.js'
+export {
+  AgentLivePhase,
+  AgentUiRunState,
+  type AgentDrawerPanelProps,
+  type AgentLiveActiveTool,
+  type AgentLiveTurn,
+  type AgentModelOption,
+  type AgentUiMessage,
+  type AgentUiRunUsage,
+  type AgentUiToolCall,
+} from './agentTypes.js'

package/src/components/assets/AssetLibraryDialog.tsx

@@ -1,5 +1,5 @@
-/** @deprecated Import from `@purescience/platform-ui/components/assets/asset-library` instead. */
-export {
-  AssetLibraryDialog,
-  type AssetLibraryDialogProps,
-} from './asset-library/index.js'
+/** @deprecated Import from `@purescience/platform-ui/components/assets/asset-library` instead. */
+export {
+  AssetLibraryDialog,
+  type AssetLibraryDialogProps,
+} from './asset-library/index.js'

package/src/components/assets/asset-library/AssetLibraryDialog.tsx

@@ -1,43 +1,43 @@
-import { Modal } from '../../common/overlays/Modal.js'
-import { AssetLibraryWorkspace } from './AssetLibraryWorkspace.js'
-import type { AssetLibraryDialogProps } from './types.js'
-
-export function AssetLibraryDialog({
-  open,
-  onClose,
-  collectionPath,
-  documentAdapter,
-  documentFiles,
-  currentDocumentFile,
-  currentDocumentTitle,
-  collectionLabel = 'collection',
-  insertTargetLabel = 'document',
-  inlineAssetScope = 'all',
-  uploadRelativeDir,
-  onDocumentSourceSaved,
-}: AssetLibraryDialogProps): React.ReactElement | null {
-  return (
-    <Modal
-      open={open}
-      onClose={onClose}
-      title="Assets"
-      size="xl"
-      chrome
-      bodyClassName="asset-library-modal-body"
-    >
-      <AssetLibraryWorkspace
-        open={open}
-        collectionPath={collectionPath}
-        documentAdapter={documentAdapter}
-        documentFiles={documentFiles}
-        currentDocumentFile={currentDocumentFile}
-        currentDocumentTitle={currentDocumentTitle}
-        collectionLabel={collectionLabel}
-        insertTargetLabel={insertTargetLabel}
-        inlineAssetScope={inlineAssetScope}
-        uploadRelativeDir={uploadRelativeDir}
-        onDocumentSourceSaved={onDocumentSourceSaved}
-      />
-    </Modal>
-  )
-}
+import { Modal } from '../../common/overlays/Modal.js'
+import { AssetLibraryWorkspace } from './AssetLibraryWorkspace.js'
+import type { AssetLibraryDialogProps } from './types.js'
+
+export function AssetLibraryDialog({
+  open,
+  onClose,
+  collectionPath,
+  documentAdapter,
+  documentFiles,
+  currentDocumentFile,
+  currentDocumentTitle,
+  collectionLabel = 'collection',
+  insertTargetLabel = 'document',
+  inlineAssetScope = 'all',
+  uploadRelativeDir,
+  onDocumentSourceSaved,
+}: AssetLibraryDialogProps): React.ReactElement | null {
+  return (
+    <Modal
+      open={open}
+      onClose={onClose}
+      title="Assets"
+      size="xl"
+      chrome
+      bodyClassName="asset-library-modal-body"
+    >
+      <AssetLibraryWorkspace
+        open={open}
+        collectionPath={collectionPath}
+        documentAdapter={documentAdapter}
+        documentFiles={documentFiles}
+        currentDocumentFile={currentDocumentFile}
+        currentDocumentTitle={currentDocumentTitle}
+        collectionLabel={collectionLabel}
+        insertTargetLabel={insertTargetLabel}
+        inlineAssetScope={inlineAssetScope}
+        uploadRelativeDir={uploadRelativeDir}
+        onDocumentSourceSaved={onDocumentSourceSaved}
+      />
+    </Modal>
+  )
+}

package/src/components/assets/asset-library/AssetLibraryWorkspace.tsx

@@ -1,54 +1,54 @@
-import { AssetLibraryDetailPane } from './detail/AssetLibraryDetailPane.js'
-import { useAssetLibraryDialog } from './hooks/useAssetLibraryDialog.js'
-import { StyledAssetLibraryLayout } from './layout/assetLibraryLayout.js'
-import { AssetLibrarySidebar } from './sidebar/AssetLibrarySidebar.js'
-import type { AssetLibraryWorkspaceProps } from './types.js'
-
-export function AssetLibraryWorkspace({
-  open,
-  collectionPath,
-  documentAdapter,
-  documentFiles,
-  currentDocumentFile,
-  currentDocumentTitle,
-  collectionLabel = 'collection',
-  insertTargetLabel = 'document',
-  inlineAssetScope = 'all',
-  uploadRelativeDir,
-  onDocumentSourceSaved,
-  fill = false,
-}: AssetLibraryWorkspaceProps): React.ReactElement {
-  const { list, metadata, actions, usage, versions } = useAssetLibraryDialog({
-    open,
-    collectionPath,
-    documentFiles,
-    currentDocumentFile,
-    inlineAssetScope,
-    collectionLabel,
-    insertTargetLabel,
-    uploadRelativeDir,
-    documentAdapter,
-    onDocumentSourceSaved,
-  })
-
-  return (
-    <StyledAssetLibraryLayout $fill={fill}>
-      <AssetLibrarySidebar
-        collectionPath={collectionPath}
-        collectionLabel={collectionLabel}
-        insertTargetLabel={insertTargetLabel}
-        currentDocumentFile={currentDocumentFile}
-        currentDocumentTitle={currentDocumentTitle}
-        list={list}
-        actions={actions}
-      />
-      <AssetLibraryDetailPane
-        selectedAsset={list.selectedAsset}
-        metadata={metadata}
-        actions={actions}
-        usage={usage}
-        versions={versions}
-      />
-    </StyledAssetLibraryLayout>
-  )
-}
+import { AssetLibraryDetailPane } from './detail/AssetLibraryDetailPane.js'
+import { useAssetLibraryDialog } from './hooks/useAssetLibraryDialog.js'
+import { StyledAssetLibraryLayout } from './layout/assetLibraryLayout.js'
+import { AssetLibrarySidebar } from './sidebar/AssetLibrarySidebar.js'
+import type { AssetLibraryWorkspaceProps } from './types.js'
+
+export function AssetLibraryWorkspace({
+  open,
+  collectionPath,
+  documentAdapter,
+  documentFiles,
+  currentDocumentFile,
+  currentDocumentTitle,
+  collectionLabel = 'collection',
+  insertTargetLabel = 'document',
+  inlineAssetScope = 'all',
+  uploadRelativeDir,
+  onDocumentSourceSaved,
+  fill = false,
+}: AssetLibraryWorkspaceProps): React.ReactElement {
+  const { list, metadata, actions, usage, versions } = useAssetLibraryDialog({
+    open,
+    collectionPath,
+    documentFiles,
+    currentDocumentFile,
+    inlineAssetScope,
+    collectionLabel,
+    insertTargetLabel,
+    uploadRelativeDir,
+    documentAdapter,
+    onDocumentSourceSaved,
+  })
+
+  return (
+    <StyledAssetLibraryLayout $fill={fill}>
+      <AssetLibrarySidebar
+        collectionPath={collectionPath}
+        collectionLabel={collectionLabel}
+        insertTargetLabel={insertTargetLabel}
+        currentDocumentFile={currentDocumentFile}
+        currentDocumentTitle={currentDocumentTitle}
+        list={list}
+        actions={actions}
+      />
+      <AssetLibraryDetailPane
+        selectedAsset={list.selectedAsset}
+        metadata={metadata}
+        actions={actions}
+        usage={usage}
+        versions={versions}
+      />
+    </StyledAssetLibraryLayout>
+  )
+}