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

package/src/writing/condenseWritingStyle.ts

@@ -1,103 +1,103 @@
-import {
-  callAgentRunModel,
-  createAgentSession,
-  deleteAgentSession,
-  startAgentRun,
-} from '../bridge/agents.js'
-
-interface AgentSessionRecord {
-  sessionId: string
-  config: { modelId: string }
-}
-
-interface AgentRunSnapshot {
-  runId: string
-  state: string
-  messages: Array<{ role: string; content: string }>
-  error?: string
-}
-
-const MAX_TURNS = 4
-
-const SYSTEM_PROMPT = [
-  'You distill writing-style guidance into a compact, reusable style guide.',
-  'Capture VOICE only — tone, register, sentence rhythm, word choice, and structural habits.',
-  'Output 4–8 short imperative bullet lines, each starting with "- ".',
-  'If the guidance lists words or phrases to PREFER or to AVOID, keep them verbatim as their own "- Prefer: …" and "- Avoid: …" bullets (these are in addition to the 4–8 voice bullets).',
-  'Do NOT include the sample text, its facts, or its subject matter.',
-  'Return plain text only — no preamble, no headings, no commentary.',
-].join('\n')
-
-function latestAssistant(snapshot: AgentRunSnapshot): string {
-  return (
-    [...snapshot.messages]
-      .reverse()
-      .find(message => message.role === 'assistant')
-      ?.content.trim() ?? ''
-  )
-}
-
-/**
- * Distill verbose style guidance (presets + voice samples) into a short,
- * reusable style guide — the book's "style skill". Sent once and reused for
- * every chapter draft/edit instead of the full samples, to save tokens.
- * Falls back to the original guidance if the model is unavailable.
- */
-export async function condenseWritingStyleWithAgent(
-  fullGuidance: string,
-): Promise<string> {
-  const trimmed = fullGuidance.trim()
-  if (!trimmed) return ''
-
-  let session: AgentSessionRecord | null = null
-  try {
-    session = (await createAgentSession({
-      scope: 'app',
-      appSlug: 'book',
-      title: 'Condense writing style',
-      config: {
-        sessionPrompt: SYSTEM_PROMPT,
-        toolPolicy: {
-          allowedTargetApps: ['__purebook_style_no_tools__'],
-          defaultRequiresApproval: true,
-        },
-      } as never,
-    })) as AgentSessionRecord
-
-    let snapshot = (await startAgentRun({
-      session: { scope: 'app', sessionId: session.sessionId, appSlug: 'book' },
-      message: trimmed,
-    })) as AgentRunSnapshot
-
-    for (let turn = 0; turn < MAX_TURNS; turn += 1) {
-      if (snapshot.state === 'ready') {
-        snapshot = (await callAgentRunModel({
-          runId: snapshot.runId,
-          sessionId: session.sessionId,
-        })) as AgentRunSnapshot
-        continue
-      }
-      break
-    }
-
-    if (snapshot.state === 'awaiting_user') {
-      const condensed = latestAssistant(snapshot)
-      if (condensed) return condensed
-    }
-    return trimmed
-  } catch {
-    return trimmed
-  } finally {
-    if (session) {
-      try {
-        await deleteAgentSession({
-          scope: 'app',
-          sessionId: session.sessionId,
-          appSlug: 'book',
-        })
-      } catch {
-        /* best-effort cleanup */
-      }
-    }
-  }
-}
+import {
+  callAgentRunModel,
+  createAgentSession,
+  deleteAgentSession,
+  startAgentRun,
+} from '../bridge/agents.js'
+
+interface AgentSessionRecord {
+  sessionId: string
+  config: { modelId: string }
+}
+
+interface AgentRunSnapshot {
+  runId: string
+  state: string
+  messages: Array<{ role: string; content: string }>
+  error?: string
+}
+
+const MAX_TURNS = 4
+
+const SYSTEM_PROMPT = [
+  'You distill writing-style guidance into a compact, reusable style guide.',
+  'Capture VOICE only — tone, register, sentence rhythm, word choice, and structural habits.',
+  'Output 4–8 short imperative bullet lines, each starting with "- ".',
+  'If the guidance lists words or phrases to PREFER or to AVOID, keep them verbatim as their own "- Prefer: …" and "- Avoid: …" bullets (these are in addition to the 4–8 voice bullets).',
+  'Do NOT include the sample text, its facts, or its subject matter.',
+  'Return plain text only — no preamble, no headings, no commentary.',
+].join('\n')
+
+function latestAssistant(snapshot: AgentRunSnapshot): string {
+  return (
+    [...snapshot.messages]
+      .reverse()
+      .find(message => message.role === 'assistant')
+      ?.content.trim() ?? ''
+  )
+}
+
+/**
+ * Distill verbose style guidance (presets + voice samples) into a short,
+ * reusable style guide — the book's "style skill". Sent once and reused for
+ * every chapter draft/edit instead of the full samples, to save tokens.
+ * Falls back to the original guidance if the model is unavailable.
+ */
+export async function condenseWritingStyleWithAgent(
+  fullGuidance: string,
+): Promise<string> {
+  const trimmed = fullGuidance.trim()
+  if (!trimmed) return ''
+
+  let session: AgentSessionRecord | null = null
+  try {
+    session = (await createAgentSession({
+      scope: 'app',
+      appSlug: 'book',
+      title: 'Condense writing style',
+      config: {
+        sessionPrompt: SYSTEM_PROMPT,
+        toolPolicy: {
+          allowedTargetApps: ['__purebook_style_no_tools__'],
+          defaultRequiresApproval: true,
+        },
+      } as never,
+    })) as AgentSessionRecord
+
+    let snapshot = (await startAgentRun({
+      session: { scope: 'app', sessionId: session.sessionId, appSlug: 'book' },
+      message: trimmed,
+    })) as AgentRunSnapshot
+
+    for (let turn = 0; turn < MAX_TURNS; turn += 1) {
+      if (snapshot.state === 'ready') {
+        snapshot = (await callAgentRunModel({
+          runId: snapshot.runId,
+          sessionId: session.sessionId,
+        })) as AgentRunSnapshot
+        continue
+      }
+      break
+    }
+
+    if (snapshot.state === 'awaiting_user') {
+      const condensed = latestAssistant(snapshot)
+      if (condensed) return condensed
+    }
+    return trimmed
+  } catch {
+    return trimmed
+  } finally {
+    if (session) {
+      try {
+        await deleteAgentSession({
+          scope: 'app',
+          sessionId: session.sessionId,
+          appSlug: 'book',
+        })
+      } catch {
+        /* best-effort cleanup */
+      }
+    }
+  }
+}

package/src/writing/draftTextWithAgent.ts

@@ -1,134 +1,134 @@
-import {
-  callAgentRunModel,
-  createAgentSession,
-  deleteAgentSession,
-  startAgentRun,
-} from '../bridge/agents.js'
-
-interface AgentSessionRecord {
-  sessionId: string
-  config: { modelId: string }
-}
-
-interface AgentRunSnapshot {
-  runId: string
-  state: string
-  messages: Array<{ role: string; content: string }>
-  error?: string
-}
-
-const MAX_TURNS = 4
-
-export type DraftTextMode = 'write' | 'rewrite'
-
-export interface DraftTextInput {
-  mode: DraftTextMode
-  instruction: string
-  selectionText?: string
-  styleGuidance?: string
-  /**
-   * Grounding/reference material (e.g. a manuscript's abstract and reference
-   * list). Used for ACCURACY — facts, terminology, claims — not for voice.
-   */
-  context?: string
-}
-
-function systemPrompt(mode: DraftTextMode): string {
-  return [
-    mode === 'rewrite'
-      ? 'You rewrite a passage of a book to the author’s instruction, preserving its meaning.'
-      : 'You draft a passage of book prose from the author’s instruction.',
-    'Return clean HTML only — paragraphs <p>, sub-headings <h2>, lists where useful.',
-    'No markdown, no code fences, no <h1>, no preamble, no commentary.',
-    'Do not invent precise statistics, dates, quotations, or citations.',
-  ].join('\n')
-}
-
-function message(input: DraftTextInput): string {
-  return [
-    input.mode === 'rewrite' && input.selectionText
-      ? `Passage to rewrite:\n"""${input.selectionText.slice(0, 6000)}"""`
-      : input.selectionText
-        ? `Nearby text for context (do not repeat):\n"""${input.selectionText.slice(0, 2000)}"""`
-        : '',
-    `Instruction: ${input.instruction.trim() || (input.mode === 'rewrite' ? 'Improve this passage.' : 'Draft this.')}`,
-    input.context?.trim()
-      ? `\nReference material — use it for facts, terminology, and claims; do NOT copy its wording as voice and do NOT invent beyond it:\n"""${input.context.trim().slice(0, 4000)}"""`
-      : '',
-    input.styleGuidance ? `\n${input.styleGuidance}` : '',
-    '',
-    'Return the HTML now.',
-  ]
-    .filter(Boolean)
-    .join('\n')
-}
-
-function cleanHtml(raw: string): string {
-  let value = raw.trim()
-  value = value.replace(/^```(?:html)?\s*/i, '').replace(/\s*```$/i, '')
-  value = value.replace(/<h1[\s\S]*?<\/h1>/gi, '')
-  return value.trim()
-}
-
-function latestAssistant(snapshot: AgentRunSnapshot): string {
-  return (
-    [...snapshot.messages]
-      .reverse()
-      .find(entry => entry.role === 'assistant')
-      ?.content.trim() ?? ''
-  )
-}
-
-/** Draft or rewrite a passage via the agent. Returns HTML (empty on failure). */
-export async function draftTextWithAgent(
-  input: DraftTextInput,
-): Promise<string> {
-  let session: AgentSessionRecord | null = null
-  try {
-    session = (await createAgentSession({
-      scope: 'app',
-      appSlug: 'book',
-      title: 'Draft passage',
-      config: {
-        sessionPrompt: systemPrompt(input.mode),
-        toolPolicy: {
-          allowedTargetApps: ['__purebook_draft_text_no_tools__'],
-          defaultRequiresApproval: true,
-        },
-      } as never,
-    })) as AgentSessionRecord
-
-    let snapshot = (await startAgentRun({
-      session: { scope: 'app', sessionId: session.sessionId, appSlug: 'book' },
-      message: message(input),
-    })) as AgentRunSnapshot
-
-    for (let turn = 0; turn < MAX_TURNS; turn += 1) {
-      if (snapshot.state === 'ready') {
-        snapshot = (await callAgentRunModel({
-          runId: snapshot.runId,
-          sessionId: session.sessionId,
-        })) as AgentRunSnapshot
-        continue
-      }
-      break
-    }
-
-    if (snapshot.state === 'awaiting_user') {
-      return cleanHtml(latestAssistant(snapshot))
-    }
-    throw new Error(snapshot.error || `The model stopped at ${snapshot.state}.`)
-  } finally {
-    if (session) {
-      try {
-        await deleteAgentSession({
-          scope: 'app',
-          sessionId: session.sessionId,
-          appSlug: 'book',
-        })
-      } catch {
-        /* best-effort cleanup */
-      }
-    }
-  }
-}
+import {
+  callAgentRunModel,
+  createAgentSession,
+  deleteAgentSession,
+  startAgentRun,
+} from '../bridge/agents.js'
+
+interface AgentSessionRecord {
+  sessionId: string
+  config: { modelId: string }
+}
+
+interface AgentRunSnapshot {
+  runId: string
+  state: string
+  messages: Array<{ role: string; content: string }>
+  error?: string
+}
+
+const MAX_TURNS = 4
+
+export type DraftTextMode = 'write' | 'rewrite'
+
+export interface DraftTextInput {
+  mode: DraftTextMode
+  instruction: string
+  selectionText?: string
+  styleGuidance?: string
+  /**
+   * Grounding/reference material (e.g. a manuscript's abstract and reference
+   * list). Used for ACCURACY — facts, terminology, claims — not for voice.
+   */
+  context?: string
+}
+
+function systemPrompt(mode: DraftTextMode): string {
+  return [
+    mode === 'rewrite'
+      ? 'You rewrite a passage of a book to the author’s instruction, preserving its meaning.'
+      : 'You draft a passage of book prose from the author’s instruction.',
+    'Return clean HTML only — paragraphs <p>, sub-headings <h2>, lists where useful.',
+    'No markdown, no code fences, no <h1>, no preamble, no commentary.',
+    'Do not invent precise statistics, dates, quotations, or citations.',
+  ].join('\n')
+}
+
+function message(input: DraftTextInput): string {
+  return [
+    input.mode === 'rewrite' && input.selectionText
+      ? `Passage to rewrite:\n"""${input.selectionText.slice(0, 6000)}"""`
+      : input.selectionText
+        ? `Nearby text for context (do not repeat):\n"""${input.selectionText.slice(0, 2000)}"""`
+        : '',
+    `Instruction: ${input.instruction.trim() || (input.mode === 'rewrite' ? 'Improve this passage.' : 'Draft this.')}`,
+    input.context?.trim()
+      ? `\nReference material — use it for facts, terminology, and claims; do NOT copy its wording as voice and do NOT invent beyond it:\n"""${input.context.trim().slice(0, 4000)}"""`
+      : '',
+    input.styleGuidance ? `\n${input.styleGuidance}` : '',
+    '',
+    'Return the HTML now.',
+  ]
+    .filter(Boolean)
+    .join('\n')
+}
+
+function cleanHtml(raw: string): string {
+  let value = raw.trim()
+  value = value.replace(/^```(?:html)?\s*/i, '').replace(/\s*```$/i, '')
+  value = value.replace(/<h1[\s\S]*?<\/h1>/gi, '')
+  return value.trim()
+}
+
+function latestAssistant(snapshot: AgentRunSnapshot): string {
+  return (
+    [...snapshot.messages]
+      .reverse()
+      .find(entry => entry.role === 'assistant')
+      ?.content.trim() ?? ''
+  )
+}
+
+/** Draft or rewrite a passage via the agent. Returns HTML (empty on failure). */
+export async function draftTextWithAgent(
+  input: DraftTextInput,
+): Promise<string> {
+  let session: AgentSessionRecord | null = null
+  try {
+    session = (await createAgentSession({
+      scope: 'app',
+      appSlug: 'book',
+      title: 'Draft passage',
+      config: {
+        sessionPrompt: systemPrompt(input.mode),
+        toolPolicy: {
+          allowedTargetApps: ['__purebook_draft_text_no_tools__'],
+          defaultRequiresApproval: true,
+        },
+      } as never,
+    })) as AgentSessionRecord
+
+    let snapshot = (await startAgentRun({
+      session: { scope: 'app', sessionId: session.sessionId, appSlug: 'book' },
+      message: message(input),
+    })) as AgentRunSnapshot
+
+    for (let turn = 0; turn < MAX_TURNS; turn += 1) {
+      if (snapshot.state === 'ready') {
+        snapshot = (await callAgentRunModel({
+          runId: snapshot.runId,
+          sessionId: session.sessionId,
+        })) as AgentRunSnapshot
+        continue
+      }
+      break
+    }
+
+    if (snapshot.state === 'awaiting_user') {
+      return cleanHtml(latestAssistant(snapshot))
+    }
+    throw new Error(snapshot.error || `The model stopped at ${snapshot.state}.`)
+  } finally {
+    if (session) {
+      try {
+        await deleteAgentSession({
+          scope: 'app',
+          sessionId: session.sessionId,
+          appSlug: 'book',
+        })
+      } catch {
+        /* best-effort cleanup */
+      }
+    }
+  }
+}

package/src/writing/index.ts

@@ -1,39 +1,39 @@
-/**
- * Reusable writing-style + AI drafting toolkit.
- *
- * App-agnostic: the host owns persistence of the style library (pass `styles`
- * and `onStylesChange`); everything else — the named-style manager, the
- * "distill into skill" flow, and the draft/redraft dialog — lives here so any
- * app can adopt it.
- */
-
-export {
-  DraftAssistantDialog,
-  type DraftAssistantDialogProps,
-} from './DraftAssistantDialog.js'
-export {
-  WritingStyleManager,
-  type WritingStyleManagerProps,
-} from './WritingStyleManager.js'
-export {
-  draftTextWithAgent,
-  type DraftTextInput,
-  type DraftTextMode,
-} from './draftTextWithAgent.js'
-export { condenseWritingStyleWithAgent } from './condenseWritingStyle.js'
-export {
-  loadSharedWritingStyles,
-  saveSharedWritingStyles,
-} from './styleStore.js'
-export {
-  EMPTY_WRITING_STYLE,
-  buildStyleGuidance,
-  createStyleSource,
-  createWritingStyle,
-  normalizeWritingStyle,
-  styleHasContent,
-  styleRawGuidance,
-  type BookWritingStyle,
-  type StyleSource,
-  type WritingStyle,
-} from './writingStyle.js'
+/**
+ * Reusable writing-style + AI drafting toolkit.
+ *
+ * App-agnostic: the host owns persistence of the style library (pass `styles`
+ * and `onStylesChange`); everything else — the named-style manager, the
+ * "distill into skill" flow, and the draft/redraft dialog — lives here so any
+ * app can adopt it.
+ */
+
+export {
+  DraftAssistantDialog,
+  type DraftAssistantDialogProps,
+} from './DraftAssistantDialog.js'
+export {
+  WritingStyleManager,
+  type WritingStyleManagerProps,
+} from './WritingStyleManager.js'
+export {
+  draftTextWithAgent,
+  type DraftTextInput,
+  type DraftTextMode,
+} from './draftTextWithAgent.js'
+export { condenseWritingStyleWithAgent } from './condenseWritingStyle.js'
+export {
+  loadSharedWritingStyles,
+  saveSharedWritingStyles,
+} from './styleStore.js'
+export {
+  EMPTY_WRITING_STYLE,
+  buildStyleGuidance,
+  createStyleSource,
+  createWritingStyle,
+  normalizeWritingStyle,
+  styleHasContent,
+  styleRawGuidance,
+  type BookWritingStyle,
+  type StyleSource,
+  type WritingStyle,
+} from './writingStyle.js'

package/src/writing/styleStore.ts

@@ -1,32 +1,32 @@
-import { bridge, PLATFORM_BRIDGE_METHODS } from '../bridge/client.mjs'
-import { normalizeWritingStyle, type BookWritingStyle } from './writingStyle.js'
-
-/**
- * Shared writing-style library — ONE set of named styles across every app.
- *
- * Stored as a single JSON file in the suite data dir (`~/PureScience/`), so a
- * style created (and distilled) in one app is available in all of them. The
- * bridge requires an appSlug but does not use it to scope the path, so every
- * app that reads/writes this filename shares the same library.
- */
-const STORAGE_SLUG = 'writing'
-const STORAGE_FILE = 'writing-styles.json'
-
-export async function loadSharedWritingStyles(): Promise<BookWritingStyle> {
-  try {
-    const result = (await bridge.call(PLATFORM_BRIDGE_METHODS.STORAGE_READ_JSON, [
-      { appSlug: STORAGE_SLUG, fileName: STORAGE_FILE },
-    ])) as { value?: unknown } | null
-    return normalizeWritingStyle(result?.value)
-  } catch {
-    return normalizeWritingStyle(null)
-  }
-}
-
-export async function saveSharedWritingStyles(
-  style: BookWritingStyle,
-): Promise<void> {
-  await bridge.call(PLATFORM_BRIDGE_METHODS.STORAGE_WRITE_JSON, [
-    { appSlug: STORAGE_SLUG, fileName: STORAGE_FILE, value: style },
-  ])
-}
+import { bridge, PLATFORM_BRIDGE_METHODS } from '../bridge/client.mjs'
+import { normalizeWritingStyle, type BookWritingStyle } from './writingStyle.js'
+
+/**
+ * Shared writing-style library — ONE set of named styles across every app.
+ *
+ * Stored as a single JSON file in the suite data dir (`~/PureScience/`), so a
+ * style created (and distilled) in one app is available in all of them. The
+ * bridge requires an appSlug but does not use it to scope the path, so every
+ * app that reads/writes this filename shares the same library.
+ */
+const STORAGE_SLUG = 'writing'
+const STORAGE_FILE = 'writing-styles.json'
+
+export async function loadSharedWritingStyles(): Promise<BookWritingStyle> {
+  try {
+    const result = (await bridge.call(PLATFORM_BRIDGE_METHODS.STORAGE_READ_JSON, [
+      { appSlug: STORAGE_SLUG, fileName: STORAGE_FILE },
+    ])) as { value?: unknown } | null
+    return normalizeWritingStyle(result?.value)
+  } catch {
+    return normalizeWritingStyle(null)
+  }
+}
+
+export async function saveSharedWritingStyles(
+  style: BookWritingStyle,
+): Promise<void> {
+  await bridge.call(PLATFORM_BRIDGE_METHODS.STORAGE_WRITE_JSON, [
+    { appSlug: STORAGE_SLUG, fileName: STORAGE_FILE, value: style },
+  ])
+}