@ash-qw/dsh-theme-prts 2.1.1 → 2.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ash-qw/dsh-theme-prts",
-  "version": "2.1.1",
+  "version": "2.2.0",
   "private": false,
   "type": "module",
   "description": "Unofficial Arknights P.R.T.S.-inspired UI theme for DeepSeek Harness Web and the official desktop client",

package/src/client/preferences.js

@@ -42,7 +42,9 @@ export const DEFAULT_PREFERENCES = Object.freeze({
   particlePattern: 'orthogonal',
   railDefaultHidden: false,
   sessionPreview: true,
+  aiToolsEnabled: true,
   previewOngoing: true,
+  previewTools: true,
   previewWarning: true,
   previewDone: true,
   previewFollowOngoing: true,
@@ -101,7 +103,8 @@ export const PREFERENCE_GROUPS = Object.freeze({
   particles: Object.freeze(['conversationParticleDensity', 'heroParticleDensity', 'particleTraversalSpeed']),
   material: Object.freeze(['glass', 'composerGlass']),
   accessibility: Object.freeze(['motion', 'bootAnimation', 'cursor']),
-  navigation: Object.freeze(['railDefaultHidden', 'sessionPreview', 'previewOngoing', 'previewWarning', 'previewDone', 'previewDoubleClick', 'previewFollowOngoing', 'previewFollowWarning', 'previewReplyLimit']),
+  aiTools: Object.freeze(['aiToolsEnabled']),
+  navigation: Object.freeze(['railDefaultHidden', 'sessionPreview', 'previewOngoing', 'previewTools', 'previewWarning', 'previewDone', 'previewDoubleClick', 'previewFollowOngoing', 'previewFollowWarning', 'previewReplyLimit']),
   conversation: Object.freeze(['sessionFlow', 'sessionGlow', 'sessionFlowPalette', 'sessionFlowColorBack', 'sessionFlowColorCore', 'sessionFlowColorFront', 'sessionFlowSpeed', 'conversationStyle', 'bakerGroupAvatars', 'bakerLoading', 'conversationEmblem']),
 })
 
@@ -237,7 +240,9 @@ export function normalizePreferences(value) {
     sessionFlowColorFront: sessionFlowColors.front,
     sessionFlowSpeed: sessionFlowSpeedOr(input.sessionFlowSpeed, DEFAULT_PREFERENCES.sessionFlowSpeed),
     sessionPreview: booleanOr(input.sessionPreview, DEFAULT_PREFERENCES.sessionPreview),
+    aiToolsEnabled: booleanOr(input.aiToolsEnabled, DEFAULT_PREFERENCES.aiToolsEnabled),
     previewOngoing: booleanOr(input.previewOngoing, DEFAULT_PREFERENCES.previewOngoing),
+    previewTools: booleanOr(input.previewTools, DEFAULT_PREFERENCES.previewTools),
     previewWarning: booleanOr(input.previewWarning, DEFAULT_PREFERENCES.previewWarning),
     previewDone: booleanOr(input.previewDone, DEFAULT_PREFERENCES.previewDone),
     previewReplyLimit: [0, 5, 10, '0', '5', '10'].includes(input.previewReplyLimit) ? Number(input.previewReplyLimit) : 5,

package/src/client/session-summary-preview.js

@@ -39,6 +39,60 @@ export function latestAssistantReply(snapshot) {
   return ''
 }
 
+// Call objects may be mutable on older hosts; compare raw arguments before reuse.
+const toolSummaryCache = new WeakMap()
+function toolSummary(call) {
+  const raw = call.argsRaw ?? call.call?.argsRaw ?? ''
+  const cached = toolSummaryCache.get(call)
+  if (cached?.raw === raw) return cached.text
+  let args
+  try { args = JSON.parse(raw) } catch {}
+  const summary = ['description', 'command', 'cmd', 'file_path', 'filePath', 'path', 'query', 'pattern', 'url']
+    .map(field => args?.[field]).find(value => typeof value === 'string' && value.trim())
+  const normalized = summary?.replace(/\s+/g, ' ').trim()
+  const text = normalized ? normalized.slice(0, 160) + (normalized.length > 160 ? '…' : '') : ''
+  toolSummaryCache.set(call, {raw, text})
+  return text
+}
+
+// Only calls after the latest settled prose belong to the current progress preview.
+export function previewToolCalls(snapshot) {
+  const turn = snapshot?.timeline?.turnOrder?.at(-1)
+  const order = snapshot?.order ?? []
+  const calls = [], seen = new Set()
+  const visit = (call, key) => {
+    if (!call) return
+    const id = call.callId ?? key
+    if (!seen.has(id)) { seen.add(id); calls.push({call, key: id}) }
+    for (const [index, child] of (call.subCalls ?? []).entries()) visit(child, key + ':' + index)
+  }
+  for (let i = order.length - 1; i >= 0; i--) {
+    const node = snapshot.nodes?.get?.(order[i])
+    if (['user', 'steering', 'turn-trigger'].includes(node?.kind)) break
+    if (turn !== undefined && node?.location?.turn?.turn !== turn) continue
+    if (node?.visibility === 'hidden') continue
+    if (node?.kind === 'assistant-step' && node.data?.status === 'settled'
+      && node.data.blocks?.some(block => block.kind === 'text' && block.text?.trim())) break
+    if (node?.kind === 'tool-call') visit(node.data?.root, order[i])
+  }
+  return calls.sort((a, b) => (b.call.callTime ?? b.call.time ?? 0) - (a.call.callTime ?? a.call.time ?? 0)).map(({call, key}) => {
+    const text = toolSummary(call)
+    return {
+      key,
+      name: call.name || call.call?.name || '工具调用',
+      status: call.kind === 'tool-result' ? call.isError ? '失败' : '已完成'
+        : call.phase === 'preparing' ? '准备中' : '执行中',
+      summary: text ? text
+        : call.phase === 'preparing' ? '正在准备调用…' : '暂无操作摘要',
+    }
+  })
+}
+
+export function latestToolCall(snapshot) {
+  const records = previewToolCalls(snapshot)
+  return records.length ? {...records[0], records} : undefined
+}
+
 export function completedPreviewReplies(snapshot) {
   const replies = []
   const latestTurn = snapshot?.timeline?.turnOrder?.at(-1)
@@ -142,8 +196,8 @@ export function createSessionSummaryPreview({ document, window, sessions, getSes
     active = undefined
     if (!old) return
     window.clearTimeout(old.leaveTimer)
-    window.clearTimeout(old.delay)
-    window.clearTimeout(old.refresh)
+    window.cancelAnimationFrame(old.delay)
+    window.cancelAnimationFrame(old.refresh)
     old.unsubscribe?.()
     old.unsubscribeStatus?.()
     if (keepWarm && old.reference && old.source) {
@@ -311,6 +365,39 @@ export function createSessionSummaryPreview({ document, window, sessions, getSes
       body.setAttribute('data-prts-preview-body', '')
       panel.querySelector('p').replaceWith(body)
     }
+    panel.querySelector('[data-prts-preview-tool]')?.remove()
+    const toolSection = panel.ownerDocument.createElement('div')
+    toolSection.setAttribute('data-prts-preview-tool', '')
+    toolSection.hidden = true
+    body.before(toolSection)
+    let previousTool, currentTool
+    const toolEntry = panel.ownerDocument.createElement('button')
+    toolEntry.type = 'button'
+    toolEntry.setAttribute('data-prts-tool-entry', '')
+    const toolHeading = panel.ownerDocument.createElement('small')
+    const toolName = panel.ownerDocument.createElement('span')
+    toolEntry.append(toolHeading, toolName)
+    toolSection.append(toolEntry)
+    const openToolDetail = (refresh = false) => {
+      if (currentTool) showDetail({key: 'latest-tool', tool: currentTool}, 0, toolEntry, refresh)
+    }
+    toolEntry.addEventListener('pointermove', () => openToolDetail())
+    toolEntry.addEventListener('focus', () => openToolDetail())
+    toolEntry.addEventListener('click', () => openToolDetail())
+    const renderTool = tool => {
+      const signature = JSON.stringify(tool)
+      if (signature === previousTool) return
+      previousTool = signature
+      currentTool = tool
+      toolSection.hidden = !tool
+      if (!tool) {
+        if (detailKey === 'latest-tool') hideDetail()
+        return
+      }
+      toolHeading.textContent = '工具 · ' + tool.status + ' · ' + tool.records.length + ' 次'
+      toolName.textContent = tool.name
+      if (detailKey === 'latest-tool') openToolDetail(true)
+    }
     const choices = panel.ownerDocument.createElement('div')
     choices.setAttribute('data-prts-preview-choices', '')
     panel.querySelector('[data-prts-preview-choices]')?.remove()
@@ -450,9 +537,9 @@ export function createSessionSummaryPreview({ document, window, sessions, getSes
       detailEntry?.removeAttribute('data-prts-reply-active')
       detailEntry = undefined
     }
-    const showDetail = (reply, index, item) => {
+    const showDetail = (reply, index, item, refresh = false) => {
       keep()
-      if (detailKey === reply.key && current.detail && !current.detail.hidden) return
+      if (!refresh && detailKey === reply.key && current.detail && !current.detail.hidden) return
       if (!current.detail) {
         const detail = panel.ownerDocument.createElement('section')
         detail.setAttribute('data-prts-summary-reply', '')
@@ -472,10 +559,36 @@ export function createSessionSummaryPreview({ document, window, sessions, getSes
       detailEntry?.removeAttribute('data-prts-reply-active')
       detailEntry = item
       item?.setAttribute('data-prts-reply-active', '')
-      detail.querySelector('strong').textContent = '回复 ' + (reply.ordinal ?? index + 1)
+      detail.toggleAttribute('data-prts-tool-history', Boolean(reply.tool))
+      detail.querySelector('strong').textContent = reply.tool ? '本段工具记录 · ' + reply.tool.records.length + ' 次' : '回复 ' + (reply.ordinal ?? index + 1)
       const content = detail.querySelector('[data-prts-preview-body]')
-      content.innerHTML = current.contentCache(reply.text).html
-      content.scrollTop = 0
+      const scrollTop = refresh ? content.scrollTop : 0
+      let anchorKey, anchorOffset
+      if (refresh && scrollTop > 0) {
+        const anchor = [...content.children].find(row => row.getBoundingClientRect().bottom > content.getBoundingClientRect().top)
+        anchorKey = anchor?.dataset.toolKey
+        anchorOffset = anchor?.getBoundingClientRect().top
+      }
+      if (reply.tool) {
+        content.replaceChildren(...reply.tool.records.map(record => {
+          const row = panel.ownerDocument.createElement('article')
+          row.setAttribute('data-prts-tool-record', '')
+          row.dataset.toolKey = record.key
+          const heading = panel.ownerDocument.createElement('div')
+          const name = panel.ownerDocument.createElement('b')
+          name.textContent = record.name
+          const status = panel.ownerDocument.createElement('small')
+          status.textContent = record.status
+          heading.append(name, status)
+          const summary = panel.ownerDocument.createElement('p')
+          summary.textContent = record.summary
+          row.append(heading, summary)
+          return row
+        }))
+      } else content.innerHTML = current.contentCache(reply.text).html
+      content.scrollTop = scrollTop
+      const retainedAnchor = anchorKey && [...content.children].find(row => row.dataset.toolKey === anchorKey)
+      if (retainedAnchor) content.scrollTop += retainedAnchor.getBoundingClientRect().top - anchorOffset
       detail.hidden = false
       const rect = panel.getBoundingClientRect()
       const width = Math.min(340, window.innerWidth - 16)
@@ -548,11 +661,18 @@ export function createSessionSummaryPreview({ document, window, sessions, getSes
         }))
       }
       choices.hidden = !labels.length
+      const tool = state === 'ongoing' && !question && getPreviewPreferences?.().previewTools !== false ? latestToolCall(source?.getSnapshot()) : undefined
+      renderTool(tool)
+      if (tool) label.textContent = '运行中 · 最新活动'
       panel.setAttribute('aria-label', title + '：' + label.textContent)
       if (state === 'ongoing' && source) {
         const replies = selectReplies(source.getSnapshot(), replyLimit())
-        if (replies === historyKeys) return
-        panel.toggleAttribute('data-prts-preview-empty', !replies.length)
+        panel.toggleAttribute('data-prts-preview-empty', !replies.length && !tool)
+        if (replies === historyKeys) {
+          const emptyText = tool ? '' : '正在处理…'
+          if (!replies.length && body.textContent !== emptyText) body.textContent = emptyText
+          return
+        }
         const previousTop = body.scrollTop
         const scrollAnchor = previousTop > 0 ? [...body.children].find(entry => entry.getBoundingClientRect().bottom > body.getBoundingClientRect().top) : undefined
         const anchorTop = scrollAnchor?.getBoundingClientRect().top
@@ -568,7 +688,7 @@ export function createSessionSummaryPreview({ document, window, sessions, getSes
           }
         }
         if (!historyKeys.length) body.replaceChildren()
-        if (!replies.length) body.textContent = '正在处理，等待本轮正文输出完成…'
+        if (!replies.length) body.textContent = tool ? '' : '正在处理…'
         for (let index = 0; index < replies.length; index++) {
           const reply = replies[index]
           if (retained.has(reply.key)) continue
@@ -580,6 +700,13 @@ export function createSessionSummaryPreview({ document, window, sessions, getSes
           item.setAttribute('data-prts-reply-entry', '')
           const heading = panel.ownerDocument.createElement('small')
           heading.textContent = '回复 ' + reply.ordinal
+          const icon = panel.ownerDocument.createElementNS('http://www.w3.org/2000/svg', 'svg')
+          icon.setAttribute('viewBox', '0 0 16 16')
+          icon.setAttribute('aria-hidden', 'true')
+          const outline = panel.ownerDocument.createElementNS(icon.namespaceURI, 'path')
+          outline.setAttribute('d', 'M3 2.5h10a1 1 0 0 1 1 1v7a1 1 0 0 1-1 1H7l-4 2v-2a1 1 0 0 1-1-1v-7a1 1 0 0 1 1-1Z')
+          icon.append(outline)
+          heading.prepend(icon)
           const summary = panel.ownerDocument.createElement('span')
           summary.textContent = current.contentCache(reply.text).summary
           item.append(heading, summary)
@@ -610,7 +737,7 @@ export function createSessionSummaryPreview({ document, window, sessions, getSes
         ? approval
           ? [pending.toolName, pending.displayReason?.['zh-CN'] || pending.displayReason?.zh || pending.reason || pending.displayReason?.en || '请进入会话查看操作详情'].filter(Boolean).join('：')
           : first?.question || pendingQuestionPreview(pending)
-        : source ? excerpt || (state === 'ongoing' ? '正在处理，尚未输出正文…' : '暂无正文回复，可进入会话查看执行记录。') : '正在读取…'
+        : source ? excerpt || (state === 'ongoing' ? '正在处理…' : '暂无正文回复，可进入会话查看执行记录。') : '正在读取…'
       if (previousText !== text || previousQuestion !== question) {
         const extendsReply = previousQuestion === question && previousText && text.startsWith(previousText)
         if (question) body.textContent = text
@@ -631,7 +758,8 @@ export function createSessionSummaryPreview({ document, window, sessions, getSes
     })
     render()
     body.scrollTop = 0
-    current.delay = window.setTimeout(async () => {
+    current.delay = window.requestAnimationFrame(async () => {
+      current.delay = undefined
       try {
         const service = getUiConversation?.()
         const controller = getSessions?.() ?? sessions
@@ -643,11 +771,13 @@ export function createSessionSummaryPreview({ document, window, sessions, getSes
         current.source = source
         current.unsubscribe = source.subscribe(() => {
           if (active !== current || current.refresh !== undefined) return
-          current.refresh = window.setTimeout(() => {
+          current.refresh = window.requestAnimationFrame(() => {
             current.refresh = undefined
-            if (current.state === 'ongoing' && !current.editor && selectReplies(source.getSnapshot(), replyLimit()) === historyKeys) return
+            if (current.state === 'ongoing' && !current.editor
+              && selectReplies(source.getSnapshot(), replyLimit()) === historyKeys
+              && JSON.stringify(getPreviewPreferences?.().previewTools === false ? undefined : latestToolCall(source.getSnapshot())) === previousTool) return
             render()
-          }, 120)
+          })
         })
         render()
       } catch {
@@ -659,7 +789,7 @@ export function createSessionSummaryPreview({ document, window, sessions, getSes
         render()
         if (body.textContent.trim() === '正在读取…') body.textContent = '暂时无法读取回复，可点击会话查看'
       }
-    }, cached ? 0 : 80)
+    })
   }
   function leave() {
     if (!active || active.sticky) return
@@ -673,6 +803,8 @@ export function createSessionSummaryPreview({ document, window, sessions, getSes
     if (!active) return
     const anchor = [...root.querySelectorAll('[data-prts-session-summary-item]')]
       .find(item => item.getAttribute('data-prts-session-summary-item') === active.id)
+    // A read completion (or removed session) has no status row to own a preview.
+    if (!anchor) { stop(); return }
     active.group?.removeAttribute('data-prts-preview-open')
     active.anchor?.removeAttribute('data-prts-preview-active')
     active.anchor = anchor

package/src/client/sidebar-control-adapter.js

@@ -976,7 +976,7 @@ export function createSidebarControlAdapter({ document, window, sessions, worksp
 
   return {
     start(preferences = {}) {
-      const keys = ['sessionPreview','previewOngoing','previewWarning','previewDone','previewDoubleClick', 'previewFollowOngoing', 'previewFollowWarning', 'previewReplyLimit']
+      const keys = ['sessionPreview','previewOngoing','previewTools','previewWarning','previewDone','previewDoubleClick', 'previewFollowOngoing', 'previewFollowWarning', 'previewReplyLimit']
       if (keys.some(key => previewPreferences[key] !== preferences[key])) preview.stop()
       previewPreferences = Object.fromEntries(keys.map(key => [key, preferences[key]]))
       if (!document) return

package/src/client/theme-settings-workbench.js

@@ -59,7 +59,7 @@ function settingButtons(key, label, options) {
       : key === 'sessionFlowPalette'
         ? '<small data-prts-setting-note>同时适配日间与夜间模式</small>'
       : ''
-  if (['composerGlass', 'bakerLoading', 'motion', 'cursor', 'railDefaultHidden', 'sessionFlow', 'sessionGlow', 'bakerGroupAvatars', 'conversationEmblem', 'sessionPreview', 'previewOngoing', 'previewWarning', 'previewDone', 'previewDoubleClick', 'previewFollowOngoing', 'previewFollowWarning'].includes(key)) return `<div data-prts-setting-row="${key}">
+  if (['composerGlass', 'bakerLoading', 'motion', 'cursor', 'railDefaultHidden', 'sessionFlow', 'sessionGlow', 'bakerGroupAvatars', 'conversationEmblem', 'sessionPreview', 'aiToolsEnabled', 'previewOngoing', 'previewTools', 'previewWarning', 'previewDone', 'previewDoubleClick', 'previewFollowOngoing', 'previewFollowWarning'].includes(key)) return `<div data-prts-setting-row="${key}">
     <span><strong>${label}</strong>${note}</span>
     <button type="button" role="switch" aria-label="${label}" aria-checked="false" data-prts-setting-switch="${key}" ${key === 'cursor' ? 'data-prts-cursor-switch' : ''}><span aria-hidden="true"></span></button>
   </div>`
@@ -127,6 +127,7 @@ export function themeSettingsMarkup() {
           <button type="button" data-prts-settings-jump="flow" role="tab" id="prts-tab-flow" aria-controls="prts-page-flow" aria-selected="false" tabindex="-1">会话流线</button>
           <button type="button" data-prts-settings-jump="particles" role="tab" id="prts-tab-particles" aria-controls="prts-page-particles" aria-selected="false" tabindex="-1">粒子徽记</button>
           <button type="button" data-prts-settings-jump="assistance" role="tab" id="prts-tab-assistance" aria-controls="prts-page-assistance" aria-selected="false" tabindex="-1">辅助功能</button>
+          <button type="button" data-prts-settings-jump="ai-tools" role="tab" id="prts-tab-ai-tools" aria-controls="prts-page-ai-tools" aria-selected="false" tabindex="-1">AI 工具</button>
         </nav>
           <footer data-prts-settings-actions aria-label="全局主题设置操作">
             <div data-prts-persistence-error hidden role="alert">
@@ -167,6 +168,33 @@ export function themeSettingsMarkup() {
               ${COMMON_CONTROLS.filter(([key]) => ['cursor', 'railDefaultHidden', 'motion'].includes(key)).map(([key, label, options]) => settingButtons(key, label, options)).join('')}
             </div>
           </section>
+          <section data-prts-settings-section="ai-tools" data-prts-ai-tools role="tabpanel" id="prts-page-ai-tools" aria-labelledby="prts-tab-ai-tools" tabindex="0" hidden>
+            <div data-prts-preview-settings><div data-prts-preview-master>
+            ${previewSetting('aiToolsEnabled', '允许 AI 定制主题', '默认开启 · 共 5 个工具 · 影响此 DSH 实例的所有会话')}
+            </div></div>
+            <p>开启后，AI 可以通过工具调整粒子徽记和 Baker 头像。关闭后，后续模型请求不再提供这些工具，手动设置不受影响；已有对话中的工具记录不会删除。</p>
+            <section>
+              <h3>粒子徽记 <small>3 个工具</small></h3>
+              <p>将会话中的图片制作成粒子徽记，用于新会话页面或正文轮换。</p>
+              <ol><li>上传图片，或让 AI 读取已生成的图片。</li><li>让 AI 制作草稿，调整轮廓、位置和缩放，先查看预览。</li><li>满意后明确要求应用到新会话徽记，或加入正文轮换。</li></ol>
+              <blockquote>“把这张图片做成粒子徽记，先给我看看效果。”</blockquote>
+              <details><summary>工具说明与限制</summary><dl>
+                <dt><code>prts_emblem_inspect</code></dt><dd>查看徽记配置、版本与当前会话的可用图片，不修改设置。</dd>
+                <dt><code>prts_emblem_preview</code></dt><dd>制作或调整粒子徽记草稿，只生成预览，不直接应用。</dd>
+                <dt><code>prts_emblem_apply</code></dt><dd>经你确认后，替换新会话徽记，或添加、替换正文轮换徽记。</dd>
+              </dl><p>单张来源图片最大 8 MB。徽记设置跨工作区和会话共享。粒子预览不等同于原图；配置发生变化时，AI 需要重新核对后再应用。</p></details>
+            </section>
+            <section>
+              <h3>Baker 头像 <small>2 个工具</small></h3>
+              <p>为用户和 AI 设置头像，调整圆形裁剪，或恢复默认头像。仅在 Baker 会话样式下显示。</p>
+              <ol><li>上传图片，说明要修改用户头像还是 AI 头像。</li><li>让 AI 查看当前配置，再按你的要求替换、裁剪或恢复默认。</li></ol>
+              <blockquote>“把这张图片设为 AI 头像，居中裁剪。”</blockquote>
+              <details><summary>工具说明与限制</summary><dl>
+                <dt><code>prts_avatar_inspect</code></dt><dd>查看头像配置、原图尺寸、裁剪参数及会话图片，不修改设置。</dd>
+                <dt><code>prts_avatar_apply</code></dt><dd>替换用户或 AI 头像、基于现有原图重新裁剪，或恢复默认头像。</dd>
+              </dl><p>单图最大 5 MB、2500 万像素；裁剪支持 1～4 倍缩放。修改立即影响此实例所有会话，不会自动切换会话样式。替换后不保留旧原图；恢复默认会删除自定义原图。</p></details>
+            </section>
+          </section>
           <section data-prts-settings-section="assistance" role="tabpanel" id="prts-page-assistance" aria-labelledby="prts-tab-assistance" tabindex="0" hidden>
             <section data-prts-preview-settings>
               <div data-prts-preview-master>
@@ -177,6 +205,7 @@ export function themeSettingsMarkup() {
                   <header><strong>悬停预览</strong><small>选择哪些状态显示详细浮窗</small></header>
                   ${previewSetting('previewOngoing', '运行中预览', '逐轮查看已完成的回复，最新内容置顶')}
                   <div data-prts-preview-details="previewOngoing">
+                  ${previewSetting('previewTools', '显示工具调用', '显示工具进度，悬停查看最新正文之后的调用记录')}
                   <label data-prts-setting-row="previewReplyLimit"><span><strong>回复条数</strong><small data-prts-preview-setting-description>仅保留最新回复</small></span><select data-prts-preview-reply-limit aria-label="最多显示回复"><option value="5">最新 5 条</option><option value="10">最新 10 条</option><option value="0">不限制</option></select></label>
                   ${previewSetting('previewFollowOngoing', '运行结束后跟随', '转为待处理或已完成时，自动切换预览')}
                   </div>

package/src/index.js

@@ -19,7 +19,7 @@ export const Config = Schema.object(Object.fromEntries([
   ['preferencesInitialized', Schema.boolean().default(false).volatile()],
 ]))
 
-export async function apply(ctx) {
+export async function apply(ctx, config = {}) {
   ctx.inject(['settings'], settingsCtx => {
     settingsCtx.effect(() => settingsCtx.settings.configure({ auto: false }, ctx.fiber))
   })
@@ -27,7 +27,24 @@ export async function apply(ctx) {
   const service=await createEmblemService(directory)
   const backgrounds=await createBackgroundService(join(directory,'..','backgrounds'))
   const avatars=await createAvatarService(join(directory,'..','avatars'))
-  const disposers=[...emblemTools(service,ctx.attachments),...avatarTools(avatars,ctx.attachments)].map(tool=>ctx.tools.register(tool))
-  disposers.push(registerEmblemApi(ctx,service),registerAvatarApi(ctx,avatars),registerBackgroundApi(ctx,backgrounds))
-  ctx.effect(()=>async()=>{for(const dispose of disposers.reverse())dispose();await service.dispose();await backgrounds.dispose()})
+  const definitions=[...emblemTools(service,ctx.attachments),...avatarTools(avatars,ctx.attachments)]
+  let toolDisposers=[]
+  const syncTools=()=>{
+    const enabled=(config.aiToolsEnabled?.get?.() ?? config.aiToolsEnabled) !== false
+    if(enabled && !toolDisposers.length) {
+      for(const tool of definitions)toolDisposers.push(ctx.tools.register(tool))
+    } else if(!enabled) {
+      for(const dispose of toolDisposers.splice(0).reverse())dispose()
+    }
+  }
+  syncTools()
+  // Host volatile fields are updated before this notification; they expose get(), not subscribe().
+  const stopConfig=ctx.on('app-boot/config-reload',syncTools)
+  const disposers=[registerEmblemApi(ctx,service),registerAvatarApi(ctx,avatars),registerBackgroundApi(ctx,backgrounds)]
+  ctx.effect(()=>async()=>{
+    stopConfig()
+    for(const dispose of toolDisposers.splice(0).reverse())dispose()
+    for(const dispose of disposers.reverse())dispose()
+    await service.dispose();await backgrounds.dispose()
+  })
 }

package/src/styles/facility-vector.css

@@ -776,10 +776,10 @@ html[data-dsh-prts] [data-prts-preview-body] a { color:var(--prts-cyan);text-dec
 html[data-dsh-prts] [data-prts-preview-message] + [data-prts-preview-message] { margin-top:5px; }
 html[data-dsh-prts] [data-prts-preview-message] > small { display:block;margin-bottom:6px;color:var(--prts-muted);font:10px/1.5 var(--prts-mono); }
 
-html[data-dsh-prts] [data-prts-reply-entry] { display:flex;align-items:flex-start;gap:8px;width:100%;padding:6px 8px;text-align:left;border:1px solid var(--prts-line);border-radius:5px;background:transparent;color:var(--prts-ink);cursor:pointer; }
-html[data-dsh-prts] [data-prts-reply-entry]:is(:hover,:focus-visible,[data-prts-reply-active]) { background:color-mix(in srgb,var(--prts-ink) 7%,transparent);border-color:var(--prts-muted); }
-html[data-dsh-prts] [data-prts-reply-entry] small { flex:0 0 auto;white-space:nowrap;padding-top:2px;color:var(--prts-muted);font:10px/1.5 var(--prts-mono); }
-html[data-dsh-prts] [data-prts-reply-entry] span { min-width:0;flex:1;display:-webkit-box;-webkit-box-orient:vertical;-webkit-line-clamp:2;overflow:hidden;font:12px/1.6 var(--prts-body);overflow-wrap:anywhere; }
+html[data-dsh-prts] :is([data-prts-reply-entry],[data-prts-tool-entry]) { display:flex;align-items:flex-start;gap:8px;width:100%;padding:6px 8px;text-align:left;border:1px solid var(--prts-line);border-radius:5px;background:transparent;color:var(--prts-ink);cursor:pointer; }
+html[data-dsh-prts] :is([data-prts-reply-entry],[data-prts-tool-entry]):is(:hover,:focus-visible,[data-prts-reply-active]) { background:color-mix(in srgb,var(--prts-ink) 7%,transparent);border-color:var(--prts-muted); }
+html[data-dsh-prts] :is([data-prts-reply-entry],[data-prts-tool-entry]) small { flex:0 0 auto;white-space:nowrap;padding-top:2px;color:var(--prts-muted);font:10px/1.5 var(--prts-mono); }
+html[data-dsh-prts] :is([data-prts-reply-entry],[data-prts-tool-entry]) span { min-width:0;flex:1;display:-webkit-box;-webkit-box-orient:vertical;-webkit-line-clamp:2;overflow:hidden;font:12px/1.6 var(--prts-body);overflow-wrap:anywhere; }
 html[data-dsh-prts] [data-prts-reply-detail]:not([data-prts-preview-question]) > [data-prts-preview-body] { max-height:190px; }
 
 html[data-dsh-prts] [data-prts-preview-marker] { display:none;flex:none;margin-left:auto;color:var(--prts-muted);font:600 9px/1.4 var(--prts-body); }
@@ -864,3 +864,25 @@ html[data-dsh-prts] [data-prts-summary-dismissed] [data-prts-session-summary-pop
   pointer-events: none !important;
   transition: none;
 }
+
+html[data-dsh-prts] [data-prts-preview-tool] { margin-top:8px; }
+html[data-dsh-prts] [data-prts-preview-tool][hidden] { display:none; }
+html[data-dsh-prts] [data-prts-preview-tool] > button { box-sizing:border-box;height:32px;align-items:center;gap:7px;padding:4px 8px;overflow:hidden;border-left:2px solid var(--prts-cyan);background:color-mix(in srgb,var(--prts-cyan) 7%,transparent); }
+html[data-dsh-prts] [data-prts-tool-entry]::before { content:">_";flex:none;color:var(--prts-cyan);font:600 11px var(--prts-mono); }
+html[data-dsh-prts] [data-prts-preview-tool] small { padding:0;color:var(--prts-cyan); }
+html[data-dsh-prts] [data-prts-preview-tool] span { display:block;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font:11px/1.6 var(--prts-mono); }
+
+html[data-dsh-prts] [data-prts-summary-reply] > [data-prts-preview-body]:empty { display:none;margin:0; }
+
+html[data-dsh-prts] [data-prts-preview-message] > [data-prts-reply-entry] { border-color:transparent;border-radius:3px; }
+html[data-dsh-prts] [data-prts-reply-entry] small { display:flex;align-items:center;gap:4px;color:#8aaee0; }
+html[data-dsh-prts] [data-prts-reply-entry] svg { width:14px;height:14px;flex:none;fill:none;stroke:currentColor;stroke-width:1.2; }
+
+html[data-dsh-prts][data-prts-scheme="light"] [data-prts-reply-entry] small { color:#476b9c; }
+
+html[data-dsh-prts] [data-prts-summary-reply][data-prts-tool-history] > [data-prts-preview-body] { height:190px;max-height:190px; }
+html[data-dsh-prts] [data-prts-tool-record] { padding:8px 0;border-bottom:1px solid var(--prts-line); }
+html[data-dsh-prts] [data-prts-tool-record] > div { display:flex;align-items:baseline;gap:8px; }
+html[data-dsh-prts] [data-prts-tool-record] b { flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;color:var(--prts-cyan);font:11px/1.6 var(--prts-mono); }
+html[data-dsh-prts] [data-prts-tool-record] small { flex:none;color:var(--prts-muted);font-size:10px; }
+html[data-dsh-prts] [data-prts-tool-record] p { display:-webkit-box;-webkit-box-orient:vertical;-webkit-line-clamp:2;overflow:hidden;margin:4px 0 0; }

package/src/styles/theme-settings-workbench.css

@@ -919,3 +919,13 @@ html[data-dsh-prts] [data-prts-preview-settings] {
   & [data-prts-setting-row] { gap:12px; }
 }
 }
+
+html[data-dsh-prts] [data-prts-theme-settings] [data-prts-ai-tools] { padding:0 20px 20px;font:12px/1.75 var(--prts-body);overflow-wrap:anywhere; }
+html[data-dsh-prts] [data-prts-ai-tools] > section { padding:16px 0;border-top:1px solid var(--prts-line); }
+html[data-dsh-prts] [data-prts-ai-tools] h3 { margin:0 0 8px;font-size:14px; }
+html[data-dsh-prts] [data-prts-ai-tools] :is(p,dd,small) { color:var(--prts-muted); }
+html[data-dsh-prts] [data-prts-ai-tools] h3 small { margin-left:8px;font-size:11px;font-weight:400; }
+html[data-dsh-prts] [data-prts-ai-tools] blockquote { margin:12px 0;padding:8px 12px;border-left:2px solid var(--prts-cyan);background:color-mix(in srgb,var(--prts-cyan) 5%,transparent); }
+html[data-dsh-prts] [data-prts-ai-tools] summary { cursor:pointer; }
+html[data-dsh-prts] [data-prts-ai-tools] dt { margin-top:12px; }
+html[data-dsh-prts] [data-prts-ai-tools] dd { margin:3px 0 0; }