@puredesktop/puredesktop-ui-bridge 2.1.6 → 2.1.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@puredesktop/puredesktop-ui-bridge",
-  "version": "2.1.6",
+  "version": "2.1.8",
   "description": "PureScience plugin SDK — bridge client, theme, and shared UI",
   "type": "module",
   "repository": {
@@ -113,6 +113,9 @@
     "./bridge/dialog.mjs": "./src/bridge/dialog.mjs",
     "./bridge/dialog": "./src/bridge/dialog.mjs",
     "./bridge/dialog.js": "./src/bridge/dialog.mjs",
+    "./bridge/documents.mjs": "./src/bridge/documents.mjs",
+    "./bridge/documents": "./src/bridge/documents.mjs",
+    "./bridge/documents.js": "./src/bridge/documents.mjs",
     "./bridge/events.mjs": "./src/bridge/events.mjs",
     "./bridge/events": "./src/bridge/events.mjs",
     "./bridge/events.js": "./src/bridge/events.mjs",
@@ -190,6 +193,9 @@
     "./bridge/pureRender/samples.ts": "./src/bridge/pureRender/samples.ts",
     "./bridge/pureRender/samples": "./src/bridge/pureRender/samples.ts",
     "./bridge/pureRender/samples.js": "./src/bridge/pureRender/samples.ts",
+    "./bridge/pureRender/sanitizeExportBody.ts": "./src/bridge/pureRender/sanitizeExportBody.ts",
+    "./bridge/pureRender/sanitizeExportBody": "./src/bridge/pureRender/sanitizeExportBody.ts",
+    "./bridge/pureRender/sanitizeExportBody.js": "./src/bridge/pureRender/sanitizeExportBody.ts",
     "./bridge/pureRender/styles.ts": "./src/bridge/pureRender/styles.ts",
     "./bridge/pureRender/styles": "./src/bridge/pureRender/styles.ts",
     "./bridge/pureRender/styles.js": "./src/bridge/pureRender/styles.ts",
@@ -207,6 +213,12 @@
     "./bridge/react/useDebouncedEffect.ts": "./src/bridge/react/useDebouncedEffect.ts",
     "./bridge/react/useDebouncedEffect": "./src/bridge/react/useDebouncedEffect.ts",
     "./bridge/react/useDebouncedEffect.js": "./src/bridge/react/useDebouncedEffect.ts",
+    "./bridge/react/useDocumentHotkeys.ts": "./src/bridge/react/useDocumentHotkeys.ts",
+    "./bridge/react/useDocumentHotkeys": "./src/bridge/react/useDocumentHotkeys.ts",
+    "./bridge/react/useDocumentHotkeys.js": "./src/bridge/react/useDocumentHotkeys.ts",
+    "./bridge/react/useDocumentLifecycle.tsx": "./src/bridge/react/useDocumentLifecycle.tsx",
+    "./bridge/react/useDocumentLifecycle": "./src/bridge/react/useDocumentLifecycle.tsx",
+    "./bridge/react/useDocumentLifecycle.js": "./src/bridge/react/useDocumentLifecycle.tsx",
     "./bridge/react/useIpc.tsx": "./src/bridge/react/useIpc.tsx",
     "./bridge/react/useIpc": "./src/bridge/react/useIpc.tsx",
     "./bridge/react/useIpc.js": "./src/bridge/react/useIpc.tsx",
@@ -225,6 +237,9 @@
     "./bridge/react/usePlatformAppManifest.tsx": "./src/bridge/react/usePlatformAppManifest.tsx",
     "./bridge/react/usePlatformAppManifest": "./src/bridge/react/usePlatformAppManifest.tsx",
     "./bridge/react/usePlatformAppManifest.js": "./src/bridge/react/usePlatformAppManifest.tsx",
+    "./bridge/react/usePlatformAppSettings.tsx": "./src/bridge/react/usePlatformAppSettings.tsx",
+    "./bridge/react/usePlatformAppSettings": "./src/bridge/react/usePlatformAppSettings.tsx",
+    "./bridge/react/usePlatformAppSettings.js": "./src/bridge/react/usePlatformAppSettings.tsx",
     "./bridge/react/usePlatformBridge.tsx": "./src/bridge/react/usePlatformBridge.tsx",
     "./bridge/react/usePlatformBridge": "./src/bridge/react/usePlatformBridge.tsx",
     "./bridge/react/usePlatformBridge.js": "./src/bridge/react/usePlatformBridge.tsx",
@@ -237,6 +252,9 @@
     "./bridge/react/usePlatformFilePreview.tsx": "./src/bridge/react/usePlatformFilePreview.tsx",
     "./bridge/react/usePlatformFilePreview": "./src/bridge/react/usePlatformFilePreview.tsx",
     "./bridge/react/usePlatformFilePreview.js": "./src/bridge/react/usePlatformFilePreview.tsx",
+    "./bridge/react/usePlatformJsonStore.tsx": "./src/bridge/react/usePlatformJsonStore.tsx",
+    "./bridge/react/usePlatformJsonStore": "./src/bridge/react/usePlatformJsonStore.tsx",
+    "./bridge/react/usePlatformJsonStore.js": "./src/bridge/react/usePlatformJsonStore.tsx",
     "./bridge/react/usePlatformPreferences.tsx": "./src/bridge/react/usePlatformPreferences.tsx",
     "./bridge/react/usePlatformPreferences": "./src/bridge/react/usePlatformPreferences.tsx",
     "./bridge/react/usePlatformPreferences.js": "./src/bridge/react/usePlatformPreferences.tsx",
@@ -360,6 +378,9 @@
     "./components/agents/agentTypes.ts": "./src/components/agents/agentTypes.ts",
     "./components/agents/agentTypes": "./src/components/agents/agentTypes.ts",
     "./components/agents/agentTypes.js": "./src/components/agents/agentTypes.ts",
+    "./components/agents/ContextPicker.tsx": "./src/components/agents/ContextPicker.tsx",
+    "./components/agents/ContextPicker": "./src/components/agents/ContextPicker.tsx",
+    "./components/agents/ContextPicker.js": "./src/components/agents/ContextPicker.tsx",
     "./components/agents/formatToolCallArguments.ts": "./src/components/agents/formatToolCallArguments.ts",
     "./components/agents/formatToolCallArguments": "./src/components/agents/formatToolCallArguments.ts",
     "./components/agents/formatToolCallArguments.js": "./src/components/agents/formatToolCallArguments.ts",
@@ -681,6 +702,17 @@
     "./components/common/desk/index.js": "./src/components/common/desk/index.ts",
     "./components/common/desk": "./src/components/common/desk/index.ts",
     "./components/common/desk.js": "./src/components/common/desk/index.ts",
+    "./components/common/documents/DocumentHeaderActions.tsx": "./src/components/common/documents/DocumentHeaderActions.tsx",
+    "./components/common/documents/DocumentHeaderActions": "./src/components/common/documents/DocumentHeaderActions.tsx",
+    "./components/common/documents/DocumentHeaderActions.js": "./src/components/common/documents/DocumentHeaderActions.tsx",
+    "./components/common/documents/DocumentSwitcher.tsx": "./src/components/common/documents/DocumentSwitcher.tsx",
+    "./components/common/documents/DocumentSwitcher": "./src/components/common/documents/DocumentSwitcher.tsx",
+    "./components/common/documents/DocumentSwitcher.js": "./src/components/common/documents/DocumentSwitcher.tsx",
+    "./components/common/documents/index.ts": "./src/components/common/documents/index.ts",
+    "./components/common/documents/index": "./src/components/common/documents/index.ts",
+    "./components/common/documents/index.js": "./src/components/common/documents/index.ts",
+    "./components/common/documents": "./src/components/common/documents/index.ts",
+    "./components/common/documents.js": "./src/components/common/documents/index.ts",
     "./components/common/dropdown/ContextMenu.tsx": "./src/components/common/dropdown/ContextMenu.tsx",
     "./components/common/dropdown/ContextMenu": "./src/components/common/dropdown/ContextMenu.tsx",
     "./components/common/dropdown/ContextMenu.js": "./src/components/common/dropdown/ContextMenu.tsx",
@@ -1044,6 +1076,9 @@
     "./components/print-design/index.js": "./src/components/print-design/index.ts",
     "./components/print-design": "./src/components/print-design/index.ts",
     "./components/print-design.js": "./src/components/print-design/index.ts",
+    "./components/print-design/previewContent.ts": "./src/components/print-design/previewContent.ts",
+    "./components/print-design/previewContent": "./src/components/print-design/previewContent.ts",
+    "./components/print-design/previewContent.js": "./src/components/print-design/previewContent.ts",
     "./components/print-design/PrintDesignPanel.tsx": "./src/components/print-design/PrintDesignPanel.tsx",
     "./components/print-design/PrintDesignPanel": "./src/components/print-design/PrintDesignPanel.tsx",
     "./components/print-design/PrintDesignPanel.js": "./src/components/print-design/PrintDesignPanel.tsx",
@@ -1055,6 +1090,24 @@
     "./components/proofing/PagedProofDialog.tsx": "./src/components/proofing/PagedProofDialog.tsx",
     "./components/proofing/PagedProofDialog": "./src/components/proofing/PagedProofDialog.tsx",
     "./components/proofing/PagedProofDialog.js": "./src/components/proofing/PagedProofDialog.tsx",
+    "./context/buildContextDocument.ts": "./src/context/buildContextDocument.ts",
+    "./context/buildContextDocument": "./src/context/buildContextDocument.ts",
+    "./context/buildContextDocument.js": "./src/context/buildContextDocument.ts",
+    "./context/contextAccess.ts": "./src/context/contextAccess.ts",
+    "./context/contextAccess": "./src/context/contextAccess.ts",
+    "./context/contextAccess.js": "./src/context/contextAccess.ts",
+    "./context/contextConfig.ts": "./src/context/contextConfig.ts",
+    "./context/contextConfig": "./src/context/contextConfig.ts",
+    "./context/contextConfig.js": "./src/context/contextConfig.ts",
+    "./context/contextDocument.ts": "./src/context/contextDocument.ts",
+    "./context/contextDocument": "./src/context/contextDocument.ts",
+    "./context/contextDocument.js": "./src/context/contextDocument.ts",
+    "./context/contextSections.ts": "./src/context/contextSections.ts",
+    "./context/contextSections": "./src/context/contextSections.ts",
+    "./context/contextSections.js": "./src/context/contextSections.ts",
+    "./context/htmlToContextMarkdown.ts": "./src/context/htmlToContextMarkdown.ts",
+    "./context/htmlToContextMarkdown": "./src/context/htmlToContextMarkdown.ts",
+    "./context/htmlToContextMarkdown.js": "./src/context/htmlToContextMarkdown.ts",
     "./editor/DocumentEditor.tsx": "./src/editor/DocumentEditor.tsx",
     "./editor/DocumentEditor": "./src/editor/DocumentEditor.tsx",
     "./editor/DocumentEditor.js": "./src/editor/DocumentEditor.tsx",
@@ -1181,6 +1234,7 @@
     "lucide-react": "^0.511.0",
     "mermaid": "^11.15.0",
     "styled-components": "^6.1.18",
+    "yaml": "^2.9.0",
     "@puredesktop/platform-editor": "2.1.0"
   },
   "peerDependencies": {

package/src/bridge/agentTypes.ts

@@ -24,7 +24,27 @@ export interface PlatformAgentImageAttachment {
   name?: string
 }
 
-export type PlatformAgentMessageAttachment = PlatformAgentImageAttachment
+/**
+ * An object's markdown context document attached to a user message —
+ * output of the context picker (`context.read`). Mirrors the shell's
+ * `AgentContextAttachment`.
+ */
+export interface PlatformAgentContextAttachment {
+  type: 'context'
+  /** Object kind, e.g. 'manuscript' | 'book'. */
+  kind: string
+  appSlug: string
+  objectId: string
+  title: string
+  /** Full or section markdown from the object's context document. */
+  markdown: string
+  /** Durable section id when a segmented read was attached. */
+  section?: string
+}
+
+export type PlatformAgentMessageAttachment =
+  | PlatformAgentImageAttachment
+  | PlatformAgentContextAttachment
 
 export interface PlatformAgentUiToolCall {
   id: string

package/src/bridge/collectionImagePaste.ts

@@ -25,12 +25,29 @@ export interface CollectionImagePastePayload {
   mimeType: string
 }
 
+export interface CollectionImageInsertPayload {
+  relativePath: string
+  alt: string
+  bytes: Uint8Array
+  mimeType: string
+}
+
 export interface CollectionImagePasteHandlerOptions {
   collectionPath?: string
   subdir?: string
   onError?: (message: string) => void
   getEditor: () => Editor | null | undefined
   writeBinary: (absolutePath: string, bytes: Uint8Array) => Promise<void>
+  /**
+   * Override how the persisted image is placed into the document. Defaults to a
+   * bare image node; callers (e.g. the manuscript editor) can supply a handler
+   * that wraps it in a captioned `<figure>` so it is numbered and
+   * cross-referenceable. Returns `false` if the editor cannot accept the node.
+   */
+  insertImage?: (
+    editor: Editor | null | undefined,
+    image: CollectionImageInsertPayload,
+  ) => boolean
 }
 
 export function normalizeCollectionImageMimeType(
@@ -93,6 +110,7 @@ export function createCollectionImagePasteHandler(
     onError,
     getEditor,
     writeBinary,
+    insertImage = insertCollectionImage,
   } = options
 
   return async ({ name, bytes, mimeType }) => {
@@ -117,7 +135,7 @@ export function createCollectionImagePasteHandler(
     const stem = stemFromImageFileName(name)
     const editor = getEditor()
     if (
-      !insertCollectionImage(editor, {
+      !insertImage(editor, {
         relativePath,
         alt: stem,
         bytes,

package/src/bridge/context.mjs

@@ -10,3 +10,35 @@ import { PLATFORM_BRIDGE_METHODS } from './methods.mjs'
 export async function publishContext(request) {
   return bridge.call(PLATFORM_BRIDGE_METHODS.CONTEXT_PUBLISH, [request])
 }
+
+/**
+ * Resolve one object's context document — generates or refreshes the
+ * `<name>.<kind>.md` file when missing or stale. Requires `filesystem`.
+ *
+ * @param {{ path?: string, appSlug?: string, objectId?: string }} ref
+ * @returns {Promise<import('../context/contextAccess.js').PlatformContextResolveResult>}
+ */
+export async function resolveContextDocument(ref) {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.CONTEXT_RESOLVE, [ref])
+}
+
+/**
+ * Read one object's context markdown — the whole document or one section by
+ * durable section id. Requires `filesystem`.
+ *
+ * @param {{ path?: string, appSlug?: string, objectId?: string, section?: string }} request
+ * @returns {Promise<import('../context/contextAccess.js').PlatformContextReadResult>}
+ */
+export async function readContextDocument(request) {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.CONTEXT_READ, [request])
+}
+
+/**
+ * Search context-enabled objects across apps. Requires `filesystem`.
+ *
+ * @param {{ query: string, kinds?: string[], appSlug?: string, limit?: number }} request
+ * @returns {Promise<import('../context/contextAccess.js').PlatformContextSearchHit[]>}
+ */
+export async function searchContextObjects(request) {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.CONTEXT_SEARCH, [request])
+}

package/src/bridge/documents.d.mts

@@ -0,0 +1,76 @@
+/** One file inside a document. `name: null` addresses a single-file document
+ * itself; a string is a path relative to a package directory. */
+export interface PlatformDocumentFilePayload {
+  name: string | null
+  content: string
+}
+
+export interface PlatformDocumentCreateDraftRequest {
+  appSlug: string
+  suffix: string
+  kind: 'package' | 'file'
+  title?: string
+  files: PlatformDocumentFilePayload[]
+}
+
+export interface PlatformDocumentListEntry {
+  path: string
+  name: string
+  mtimeMs: number
+  isDraft: boolean
+  kind: 'package' | 'file'
+}
+
+export interface PlatformRecentDocumentEntry {
+  path: string
+  title: string
+  touchedAt: string
+}
+
+export function createPlatformDraft(
+  request: PlatformDocumentCreateDraftRequest,
+): Promise<{ path: string }>
+
+export function autosavePlatformDocument(request: {
+  path: string
+  files: PlatformDocumentFilePayload[]
+}): Promise<{ savedAt: string }>
+
+export function promotePlatformDocument(request: {
+  path: string
+  title: string
+  targetDir?: string
+  /** The document type's real suffix (e.g. `.chart.json`) — required for
+   * compound suffixes, which cannot be recovered from the path. */
+  suffix?: string
+  appSlug?: string
+}): Promise<{ path: string }>
+
+export function renamePlatformDocument(request: {
+  path: string
+  title: string
+  suffix?: string
+  appSlug?: string
+}): Promise<{ path: string }>
+
+export function duplicatePlatformDocument(request: {
+  path: string
+  suffix?: string
+}): Promise<{ path: string }>
+
+export function listPlatformDocumentsByType(request: {
+  suffixes: string[]
+}): Promise<PlatformDocumentListEntry[]>
+
+export function listPlatformRecentDocuments(request: {
+  appSlug: string
+  limit?: number
+}): Promise<PlatformRecentDocumentEntry[]>
+
+export function touchPlatformRecentDocument(request: {
+  appSlug: string
+  path: string
+  title: string
+}): Promise<void>
+
+export function suggestPlatformDocumentLocation(): Promise<{ dir: string }>

package/src/bridge/documents.mjs

@@ -0,0 +1,40 @@
+import { bridge } from './client.mjs'
+import { PLATFORM_BRIDGE_METHODS } from './methods.mjs'
+
+/** Unified document lifecycle bridge: drafts, autosave, filing, recents. */
+
+export async function createPlatformDraft(request) {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.DOCUMENTS_CREATE_DRAFT, [request])
+}
+
+export async function autosavePlatformDocument(request) {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.DOCUMENTS_AUTOSAVE, [request])
+}
+
+export async function promotePlatformDocument(request) {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.DOCUMENTS_PROMOTE, [request])
+}
+
+export async function renamePlatformDocument(request) {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.DOCUMENTS_RENAME, [request])
+}
+
+export async function duplicatePlatformDocument(request) {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.DOCUMENTS_DUPLICATE, [request])
+}
+
+export async function listPlatformDocumentsByType(request) {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.DOCUMENTS_LIST_BY_TYPE, [request])
+}
+
+export async function listPlatformRecentDocuments(request) {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.DOCUMENTS_RECENTS_LIST, [request])
+}
+
+export async function touchPlatformRecentDocument(request) {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.DOCUMENTS_RECENTS_TOUCH, [request])
+}
+
+export async function suggestPlatformDocumentLocation() {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.DOCUMENTS_SUGGEST_LOCATION, [])
+}

package/src/bridge/methods.d.mts

@@ -8,6 +8,7 @@ export declare const PLATFORM_BRIDGE_METHODS: {
   readonly WORKSPACE_OPEN_APP: 'workspace.openApp'
   readonly WORKSPACE_OPEN_PALETTE: 'workspace.openPalette'
   readonly WORKSPACE_UPDATE_CURRENT_TAB: 'workspace.updateCurrentTab'
+  readonly WORKSPACE_SET_OVERLAY_OPEN: 'workspace.setOverlayOpen'
   readonly SCHEDULER_REGISTER: 'scheduler.register'
   readonly SCHEDULER_UNREGISTER: 'scheduler.unregister'
   readonly CATALOG_CONSUME_PENDING_OPEN: 'catalog.consumePendingOpen'
@@ -60,17 +61,27 @@ export declare const PLATFORM_BRIDGE_METHODS: {
   readonly ASSETS_TRANSFORM: 'assets.transform'
   readonly ASSETS_GET_CONTEXT: 'assets.getContext'
   readonly NETWORK_FETCH: 'network.fetch'
+  readonly RESEARCH_QUERY: 'research.query'
   readonly VISION_GENERATE_IMAGE: 'vision.generateImage'
   readonly OAUTH_LOOPBACK_AUTHORIZE: 'oauth.loopbackAuthorize'
   readonly SECRETS_GET: 'secrets.get'
   readonly SECRETS_SET: 'secrets.set'
   readonly SECRETS_DELETE: 'secrets.delete'
   readonly SECRETS_STATUS: 'secrets.status'
+  readonly MYTOOLS_LIST: 'mytools.list'
+  readonly MYTOOLS_SAVE: 'mytools.save'
+  readonly MYTOOLS_UPDATE: 'mytools.update'
+  readonly MYTOOLS_DELETE: 'mytools.delete'
+  readonly MYTOOLS_TEST: 'mytools.test'
+  readonly MYTOOLS_RESEARCH: 'mytools.research'
   readonly DEBUG_EMIT_EVENT: 'debug.emitEvent'
   readonly PLUGINS_INSTALL: 'plugins.install'
   readonly PLUGINS_EVALUATE_BUILD: 'plugins.evaluateBuild'
   readonly PLUGINS_PREPARE_REGISTRATION: 'plugins.prepareRegistration'
   readonly CONTEXT_PUBLISH: 'context.publish'
+  readonly CONTEXT_RESOLVE: 'context.resolve'
+  readonly CONTEXT_READ: 'context.read'
+  readonly CONTEXT_SEARCH: 'context.search'
   readonly PEOPLE_SUGGEST: 'people.suggest'
   readonly PEOPLE_RESEARCH: 'people.research'
   readonly CREDENTIALS_STORAGE_STATUS: 'credentials.storageStatus'
@@ -102,6 +113,15 @@ export declare const PLATFORM_BRIDGE_METHODS: {
   readonly AGENTS_LOCAL_MODELS_STATUS: 'agents.localModels.status'
   readonly AGENTS_TOOLS_REGISTER: 'agents.tools.register'
   readonly AGENTS_TOOLS_COMPLETE: 'agents.tools.complete'
+  readonly DOCUMENTS_CREATE_DRAFT: 'documents.createDraft'
+  readonly DOCUMENTS_AUTOSAVE: 'documents.autosave'
+  readonly DOCUMENTS_PROMOTE: 'documents.promote'
+  readonly DOCUMENTS_RENAME: 'documents.rename'
+  readonly DOCUMENTS_DUPLICATE: 'documents.duplicate'
+  readonly DOCUMENTS_LIST_BY_TYPE: 'documents.listByType'
+  readonly DOCUMENTS_RECENTS_LIST: 'documents.recents.list'
+  readonly DOCUMENTS_RECENTS_TOUCH: 'documents.recents.touch'
+  readonly DOCUMENTS_SUGGEST_LOCATION: 'documents.suggestLocation'
 }
 
 export declare const PLATFORM_BRIDGE_METHOD_PREFIXES: {
@@ -119,12 +139,15 @@ export declare const PLATFORM_BRIDGE_METHOD_PREFIXES: {
   readonly WATCH: 'watch.'
   readonly ASSETS: 'assets.'
   readonly NETWORK: 'network.'
+  readonly RESEARCH: 'research.'
   readonly VISION: 'vision.'
   readonly OAUTH: 'oauth.'
   readonly SECRETS: 'secrets.'
+  readonly MYTOOLS: 'mytools.'
   readonly AGENTS: 'agents.'
   readonly PEOPLE: 'people.'
   readonly DEBUG: 'debug.'
+  readonly DOCUMENTS: 'documents.'
 }
 
 export type PlatformBridgeMethodName =

package/src/bridge/methods.mjs

@@ -11,6 +11,7 @@ export const PLATFORM_BRIDGE_METHODS = {
   WORKSPACE_OPEN_APP: 'workspace.openApp',
   WORKSPACE_OPEN_PALETTE: 'workspace.openPalette',
   WORKSPACE_UPDATE_CURRENT_TAB: 'workspace.updateCurrentTab',
+  WORKSPACE_SET_OVERLAY_OPEN: 'workspace.setOverlayOpen',
   SCHEDULER_REGISTER: 'scheduler.register',
   SCHEDULER_UNREGISTER: 'scheduler.unregister',
   CATALOG_CONSUME_PENDING_OPEN: 'catalog.consumePendingOpen',
@@ -75,12 +76,19 @@ export const PLATFORM_BRIDGE_METHODS = {
   ASSETS_GET_CONTEXT: 'assets.getContext',
 
   NETWORK_FETCH: 'network.fetch',
+  RESEARCH_QUERY: 'research.query',
   VISION_GENERATE_IMAGE: 'vision.generateImage',
   OAUTH_LOOPBACK_AUTHORIZE: 'oauth.loopbackAuthorize',
   SECRETS_GET: 'secrets.get',
   SECRETS_SET: 'secrets.set',
   SECRETS_DELETE: 'secrets.delete',
   SECRETS_STATUS: 'secrets.status',
+  MYTOOLS_LIST: 'mytools.list',
+  MYTOOLS_SAVE: 'mytools.save',
+  MYTOOLS_UPDATE: 'mytools.update',
+  MYTOOLS_DELETE: 'mytools.delete',
+  MYTOOLS_TEST: 'mytools.test',
+  MYTOOLS_RESEARCH: 'mytools.research',
 
   DEBUG_EMIT_EVENT: 'debug.emitEvent',
 
@@ -88,6 +96,9 @@ export const PLATFORM_BRIDGE_METHODS = {
   PLUGINS_EVALUATE_BUILD: 'plugins.evaluateBuild',
   PLUGINS_PREPARE_REGISTRATION: 'plugins.prepareRegistration',
   CONTEXT_PUBLISH: 'context.publish',
+  CONTEXT_RESOLVE: 'context.resolve',
+  CONTEXT_READ: 'context.read',
+  CONTEXT_SEARCH: 'context.search',
   PEOPLE_SUGGEST: 'people.suggest',
   PEOPLE_RESEARCH: 'people.research',
 
@@ -124,6 +135,15 @@ export const PLATFORM_BRIDGE_METHODS = {
   AGENTS_LOCAL_MODELS_STATUS: 'agents.localModels.status',
   AGENTS_TOOLS_REGISTER: 'agents.tools.register',
   AGENTS_TOOLS_COMPLETE: 'agents.tools.complete',
+  DOCUMENTS_CREATE_DRAFT: 'documents.createDraft',
+  DOCUMENTS_AUTOSAVE: 'documents.autosave',
+  DOCUMENTS_PROMOTE: 'documents.promote',
+  DOCUMENTS_RENAME: 'documents.rename',
+  DOCUMENTS_DUPLICATE: 'documents.duplicate',
+  DOCUMENTS_LIST_BY_TYPE: 'documents.listByType',
+  DOCUMENTS_RECENTS_LIST: 'documents.recents.list',
+  DOCUMENTS_RECENTS_TOUCH: 'documents.recents.touch',
+  DOCUMENTS_SUGGEST_LOCATION: 'documents.suggestLocation',
 }
 
 export const PLATFORM_BRIDGE_METHOD_PREFIXES = {
@@ -141,10 +161,13 @@ export const PLATFORM_BRIDGE_METHOD_PREFIXES = {
   WATCH: 'watch.',
   ASSETS: 'assets.',
   NETWORK: 'network.',
+  RESEARCH: 'research.',
   VISION: 'vision.',
   OAUTH: 'oauth.',
   SECRETS: 'secrets.',
+  MYTOOLS: 'mytools.',
   AGENTS: 'agents.',
   PEOPLE: 'people.',
   DEBUG: 'debug.',
+  DOCUMENTS: 'documents.',
 }

package/src/bridge/pureRender/base.css

@@ -16,6 +16,46 @@ body {
   max-width: 30rem;
   string-set: doctitle content(text);
 }
+/* Metadata eyebrow above the title — driven purely by theme tokens. */
+.doc-title::before {
+  content: var(--eyebrow-text, '');
+  display: var(--eyebrow-display, none);
+  font: 600 8pt / 1.3 var(--sans);
+  letter-spacing: 0.14em;
+  text-transform: uppercase;
+  color: var(--accent);
+  margin: 0 0 calc(var(--rhythm) * 0.6);
+}
+/* Drop cap on the opening paragraph — inert unless the theme enables it.
+   THREE separate rules on purpose: Paged.js crashes on comma-lists of
+   ::first-letter selectors ("item doesn't belong to list"). */
+.doc-title + p::first-letter {
+  float: var(--drop-cap-float, none);
+  font-family: var(--drop-cap-font, inherit);
+  font-size: var(--drop-cap-size, 1em);
+  line-height: var(--drop-cap-lh, inherit);
+  font-weight: var(--drop-cap-weight, inherit);
+  padding: var(--drop-cap-pad, 0);
+  color: var(--drop-cap-ink, inherit);
+}
+.doc-title + section > p:first-child::first-letter {
+  float: var(--drop-cap-float, none);
+  font-family: var(--drop-cap-font, inherit);
+  font-size: var(--drop-cap-size, 1em);
+  line-height: var(--drop-cap-lh, inherit);
+  font-weight: var(--drop-cap-weight, inherit);
+  padding: var(--drop-cap-pad, 0);
+  color: var(--drop-cap-ink, inherit);
+}
+section:first-of-type > p:first-child::first-letter {
+  float: var(--drop-cap-float, none);
+  font-family: var(--drop-cap-font, inherit);
+  font-size: var(--drop-cap-size, 1em);
+  line-height: var(--drop-cap-lh, inherit);
+  font-weight: var(--drop-cap-weight, inherit);
+  padding: var(--drop-cap-pad, 0);
+  color: var(--drop-cap-ink, inherit);
+}
 .authors {
   font: 500 11.5pt/1.4 var(--sans);
   margin: 0 0 0.4rem;
@@ -83,6 +123,10 @@ h2 {
   line-height: 1.15;
   margin: calc(var(--rhythm) * 1.5) 0 calc(var(--rhythm) * 0.4);
   string-set: sectitle content(text);
+  /* Optional accent rule beneath section headings (theme token). */
+  border-bottom: var(--heading-rule-width, 0) solid var(--accent);
+  padding-bottom: var(--heading-rule-pad, 0);
+  max-width: var(--measure);
 }
 section:not([data-type='abstract']):not([data-type='frontmatter']):not(
     [data-type='backmatter']

package/src/bridge/pureRender/document.ts

@@ -1,5 +1,10 @@
 import { buildPrintHtmlDocument } from '../printDocument.js'
-import { normalizePureRenderHtml } from './normalize.js'
+import {
+  injectCoverSection,
+  injectGeneratedToc,
+  normalizePureRenderHtml,
+  wrapLooseBodyRun,
+} from './normalize.js'
 import { buildPureRenderStylesheet } from './styles.js'
 import type { PureRenderRequest } from './types.js'
 
@@ -22,6 +27,28 @@ export function buildPureRenderHtmlDocument(options: {
     )
   }
 
+  // Theme-driven structure: cover first (title block onto its own named
+  // page), then a generated table of contents from the normalized
+  // article's sections (ids are assigned during normalization).
+  const setting = options.request.theme?.setting
+  let bodyHtml = normalized.html
+  if (setting?.coverPage) {
+    bodyHtml = injectCoverSection(bodyHtml, {
+      author: setting.coverAuthor,
+      date: setting.coverDate,
+    })
+  }
+  // Contents implies a cover: without one, a toc page before the title
+  // reads as clutter rather than structure.
+  if (setting?.coverPage && setting?.toc) {
+    bodyHtml = injectGeneratedToc(bodyHtml)
+  }
+  if (options.request.theme?.page?.columns === 2) {
+    // Columns attach to body sections; unsectioned (writer) articles need
+    // their loose body run wrapped so there is a section to columnize.
+    bodyHtml = wrapLooseBodyRun(bodyHtml)
+  }
+
   return buildPrintHtmlDocument({
     rootPath: options.rootPath,
     title: options.title ?? normalized.title,
@@ -30,6 +57,6 @@ export function buildPureRenderHtmlDocument(options: {
       theme: options.request.theme,
     }),
     bodyClass: `pure-render pure-render-${options.request.profile}`,
-    bodyHtml: normalized.html,
+    bodyHtml,
   })
 }

package/src/bridge/pureRender/index.ts

@@ -1,4 +1,5 @@
 export { compilePrintTheme } from './compiler.js'
+export { sanitizeBodyForPureRenderExport } from './sanitizeExportBody.js'
 export {
   buildBookPureRenderRequest,
   buildWriterPureRenderRequest,
@@ -46,7 +47,9 @@ export {
 } from './samples.js'
 export {
   inspectPureRenderVisualLayout,
+  relevantPagedSnapshotPages,
   visualIssuesForMetrics,
+  type PureRenderSnapshotRole,
   type PureRenderVisualCandidate,
   type PureRenderVisualDecision,
   type PureRenderVisualInspection,