@deepseek-harness-tui/dsh-tui 0.8.1 → 0.8.3

package/dsh-ecosystem-spec/protocols/tui-contributions.js

@@ -0,0 +1,143 @@
+/** dsh-TUI private, lifecycle-owned manifest contribution definitions. */
+
+export const API_VERSION = 'tui.dsh/v1alpha1'
+
+export const SETTINGS_SECTION = Object.freeze({
+  apiVersion: API_VERSION,
+  kind: 'SettingsSection',
+})
+
+export const SCENE = Object.freeze({
+  apiVersion: API_VERSION,
+  kind: 'Scene',
+})
+
+export const settingsSectionExtensionDefinition = Object.freeze({
+  ...SETTINGS_SECTION,
+  validateMetadata(metadata) {
+    contributionName(metadata?.name, 'SettingsSection metadata.name')
+  },
+  validateSpec: validateSettingsSectionSpec,
+})
+
+export function validateSettingsSectionSpec(value) {
+  const spec = exactRecord(value, ['namespace', 'title', 'titles', 'fields'], 'SettingsSection content')
+  contributionName(spec.namespace, 'SettingsSection content.namespace')
+  nonEmpty(spec.title, 'SettingsSection content.title')
+  localized(spec.titles, 'SettingsSection content.titles')
+  if (!Array.isArray(spec.fields)) throw new TypeError('SettingsSection content.fields must be an array')
+  return Object.freeze({
+    namespace: spec.namespace,
+    title: spec.title,
+    ...(spec.titles === undefined ? {} : { titles: freezeRecord(spec.titles) }),
+    fields: Object.freeze(spec.fields.map((field, index) => validateSettingsField(field, index))),
+  })
+}
+
+export const sceneExtensionDefinition = Object.freeze({
+  ...SCENE,
+  validateMetadata(metadata) {
+    contributionName(metadata?.name, 'Scene metadata.name')
+  },
+  validateSpec: validateSceneSpec,
+})
+
+export function validateSceneSpec(value) {
+  const spec = exactRecord(value, ['title', 'titles'], 'Scene content')
+  if (spec.title !== undefined) nonEmpty(spec.title, 'Scene content.title')
+  localized(spec.titles, 'Scene content.titles')
+  return Object.freeze({
+    ...(spec.title === undefined ? {} : { title: spec.title }),
+    ...(spec.titles === undefined ? {} : { titles: freezeRecord(spec.titles) }),
+  })
+}
+
+export const contributionExtensionDefinitions = Object.freeze([
+  settingsSectionExtensionDefinition,
+  sceneExtensionDefinition,
+])
+
+export function registerTuiContributionExtensions(catalog) {
+  const disposers = contributionExtensionDefinitions.map(definition => catalog.registerExtension(definition))
+  return () => { for (const dispose of disposers.reverse()) dispose() }
+}
+
+export function assertSettingsSectionHandler(value) {
+  runtimeObject(value, 'SettingsSection handler')
+}
+
+export function assertSceneHandler(value) {
+  const handler = runtimeObject(value, 'Scene handler')
+  if (typeof handler.component !== 'function') throw new TypeError('Scene handler.component must be a function')
+}
+
+function validateSettingsField(value, index) {
+  const label = `SettingsSection spec.fields[${index}]`
+  const field = exactRecord(value, [
+    'path', 'label', 'titles', 'hint', 'hintTitles', 'kind', 'options', 'placeholder', 'secretRef',
+  ], label)
+  if (!Array.isArray(field.path) || field.path.length === 0
+    || field.path.some(segment => typeof segment !== 'string' || segment.length === 0)) {
+    throw new TypeError(`${label}.path must be a non-empty string array`)
+  }
+  nonEmpty(field.label, `${label}.label`)
+  localized(field.titles, `${label}.titles`)
+  if (field.hint !== undefined) nonEmpty(field.hint, `${label}.hint`)
+  localized(field.hintTitles, `${label}.hintTitles`)
+  if (!['text', 'number', 'boolean', 'select'].includes(field.kind)) {
+    throw new TypeError(`${label}.kind is invalid`)
+  }
+  if (field.placeholder !== undefined && typeof field.placeholder !== 'string') {
+    throw new TypeError(`${label}.placeholder must be a string`)
+  }
+  if (field.secretRef !== undefined) nonEmpty(field.secretRef, `${label}.secretRef`)
+  if (field.options !== undefined) {
+    if (!Array.isArray(field.options)) throw new TypeError(`${label}.options must be an array`)
+    for (const [optionIndex, valueOption] of field.options.entries()) {
+      const option = exactRecord(valueOption, ['value', 'label', 'titles'], `${label}.options[${optionIndex}]`)
+      nonEmpty(option.value, `${label}.options[${optionIndex}].value`)
+      nonEmpty(option.label, `${label}.options[${optionIndex}].label`)
+      localized(option.titles, `${label}.options[${optionIndex}].titles`)
+    }
+  }
+  return Object.freeze(structuredClone(field))
+}
+
+function exactRecord(value, allowed, label) {
+  if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+    throw new TypeError(`${label} must be an object`)
+  }
+  const unknown = Object.keys(value).filter(key => !allowed.includes(key) && !key.startsWith('x-'))
+  if (unknown.length > 0) throw new TypeError(`${label} contains unknown field ${JSON.stringify(unknown[0])}`)
+  return value
+}
+
+function runtimeObject(value, label) {
+  if ((typeof value !== 'object' && typeof value !== 'function') || value === null || Array.isArray(value)) {
+    throw new TypeError(`${label} must be an object`)
+  }
+  return value
+}
+
+function contributionName(value, label) {
+  if (typeof value !== 'string' || !/^[a-z][a-z0-9_-]*$/u.test(value)) {
+    throw new TypeError(`${label} is invalid`)
+  }
+}
+
+function nonEmpty(value, label) {
+  if (typeof value !== 'string' || value.trim() === '') throw new TypeError(`${label} must be a non-empty string`)
+}
+
+function localized(value, label) {
+  if (value === undefined) return
+  const record = exactRecord(value, Object.keys(value), label)
+  for (const [locale, text] of Object.entries(record)) {
+    if (locale.trim() === '') throw new TypeError(`${label} contains an empty locale`)
+    nonEmpty(text, `${label}.${locale}`)
+  }
+}
+
+function freezeRecord(value) {
+  return Object.freeze({ ...value })
+}

package/dsh-ecosystem-spec/registry/README.md

@@ -0,0 +1,14 @@
+# dsh-TUI Admission Protocol Profile
+
+[`registry-0.15.json`](registry-0.15.json) 不是全局协议注册表。它描述本 TUI admission profile 使用的 definition 集合：
+
+- `imports` 引用固定 dsh-std revision 已提供的 definitions；
+- `definitions` 只收录 dsh-TUI 私有 definitions。
+
+导入条目不复制 dsh-std 的 schema 或 contract 正文。Community v0.15 的 `Command`、`LocalStorage`、`MessageObserver`、Presentation 与 Workspace 定义分别由 `@dsh-std/command`、`@dsh-std/storage`、`@dsh-std/messages`、`@dsh-std/presentation` 与 `@dsh-std/workspace` 注册。
+
+本地 definition 的 contract profile 使用 SHA-256 固定。修改 profile 内容必须更新 digest，并按兼容性决定保留坐标或发布新 `apiVersion`。digest 只证明字节一致，不证明发布者身份。
+
+`tui.dsh/*` 是 dsh-TUI 私有 namespace。私有 definition 与公共 definition 一样注册到 dsh-std `ProtocolCatalog`；目录收录本身不产生 live support。
+
+权限目录仍是 TUI authorization policy 的输入。permission grant 与 protocol support 分开判断，安装 definition 不自动授权操作。

package/dsh-ecosystem-spec/registry/contracts/scene-v1alpha1.json

@@ -0,0 +1,13 @@
+{
+  "name":"tui.scene","version":"v1alpha1","kind":"extension",
+  "coordinates":{"apiVersion":"tui.dsh/v1alpha1","kind":"Scene"},
+  "caller":"trusted in-process dsh-TUI scene shell",
+  "permissions":[],
+  "operations":["open","close","render"],
+  "errors":["SCENE_INVALID","SCENE_CONFLICT","RENDERER_INCOMPATIBLE"],
+  "concurrency":"one scene may own the full-screen surface at a time",
+  "timeout":"scene operations are local; domain calls made by a scene retain their own deadlines",
+  "cleanup":"an open scene closes when its owning facet deactivates",
+  "privacyClass":"sensitive",
+  "securityBoundary":false
+}

package/dsh-ecosystem-spec/registry/contracts/settings-section-v1alpha1.json

@@ -0,0 +1,13 @@
+{
+  "name":"tui.settings-section","version":"v1alpha1","kind":"extension",
+  "coordinates":{"apiVersion":"tui.dsh/v1alpha1","kind":"SettingsSection"},
+  "caller":"dsh-TUI settings contribution binder",
+  "permissions":[],
+  "operations":["render"],
+  "errors":["SECTION_INVALID","NAMESPACE_CONFLICT","NAMESPACE_UNAVAILABLE"],
+  "concurrency":"one active section owns each settings namespace",
+  "timeout":"not applicable to declarative rendering; writes use the settings protocol deadline",
+  "cleanup":"removing a section removes only UI metadata and preserves settings and credentials",
+  "privacyClass":"public",
+  "securityBoundary":false
+}

package/dsh-ecosystem-spec/registry/contracts/tui-channel-v1alpha1.json

@@ -0,0 +1,30 @@
+{
+  "name": "tui.channel",
+  "version": "v1alpha1",
+  "coordinates": {
+    "apiVersion": "tui.dsh/v1alpha1",
+    "kind": "Channel"
+  },
+  "kind": "capability",
+  "caller": "a negotiated TUI endpoint",
+  "permissions": [],
+  "operations": [
+    {"name": "open", "input": "workspace/session selector", "output": "complete channel snapshot"},
+    {"name": "subscribe", "input": "channel id and last observed version", "output": "snapshot progress stream"},
+    {"name": "invoke", "input": "channel method and JSON arguments", "output": "method progress, JSON result and optional snapshot"},
+    {"name": "close", "input": "channel id", "output": "closed acknowledgement"}
+  ],
+  "wireRevision": 6,
+  "features": [
+    "commands", "credentials", "diagnostics", "files", "models", "modes",
+    "presets", "presentation", "provider-setup", "scenes", "session-history", "session-input",
+    "session-lifecycle", "session-state", "settings", "skills", "subagents",
+    "trace", "workspaces"
+  ],
+  "errors": ["CHANNEL_NOT_FOUND", "FEATURE_UNAVAILABLE", "INVALID_ARGUMENT", "PERMISSION_DENIED", "REVISION_MISMATCH", "PROVIDER_FAILURE"],
+  "concurrency": "state mutations are serialized per channel; independent read operations may run concurrently",
+  "timeout": "the caller supplies connection invocation cancellation; subscriptions remain open until cancelled or closed",
+  "cleanup": "connection close or facet deactivate releases subscriptions, uploads and channel attachments",
+  "privacyClass": "sensitive",
+  "securityBoundary": false
+}

package/dsh-ecosystem-spec/registry/contracts/workspace-provider-v1alpha1.json

@@ -0,0 +1,6 @@
+{
+  "status": "superseded",
+  "coordinates": {"apiVersion": "workspace.dsh/v1alpha1", "kind": "WorkspaceProvider"},
+  "package": "@dsh-std/workspace",
+  "proposal": "vendor/dsh-std/docs/proposals/workspace.zh.md"
+}

package/{ecosystem-spec → dsh-ecosystem-spec}/registry/permissions-0.1.json

@@ -5,7 +5,7 @@
     {"name":"storage.local.write","default":"deny","revocable":true,"scope":"plugin namespace"},
     {"name":"commands.invoke","default":"allow","revocable":true,"scope":"declared command id","rationale":"调用由宿主或用户通过一次 invocation 主动发起，不同于数据访问类权限——插件无法仅凭此权限被动读取任何数据，故默认允许；撤销只关闭该 command ID 的调用入口"},
     {"name":"messages.observe.read","default":"deny","revocable":true,"scope":"message observation scope"},
-    {"name":"session.input.intercept","default":"deny","revocable":true,"scope":"decision event subscription","rationale":"拦截类订阅（RFC 0005 D-7）：能否决/改写用户输入，严格强于观察，故默认拒绝；TUI 实验实现见 tui.dsh/v1alpha1#DecisionEvents"},
+    {"name":"session.input.intercept","default":"deny","revocable":true,"scope":"decision event subscription","rationale":"拦截类订阅（RFC 0005 D-7）：能否决/改写用户输入，严格强于观察，故默认拒绝；TUI 实验实现见 tui.dsh.decision-events"},
     {"name":"session.rewind.intercept","default":"deny","revocable":true,"scope":"decision event subscription","rationale":"同 session.input.intercept——可否决会话回退或注入回退模式"},
     {"name":"session.switch.intercept","default":"deny","revocable":true,"scope":"decision event subscription","rationale":"同 session.input.intercept——可否决会话切换"},
     {"name":"session.compact.intercept","default":"deny","revocable":true,"scope":"decision event subscription","rationale":"同 session.input.intercept——可否决手动压缩"}

package/dsh-ecosystem-spec/registry/registry-0.15.json

@@ -0,0 +1,149 @@
+{
+  "profileVersion": "tui-admission/0.15",
+  "std": {
+    "repository": "https://github.com/Yan-Zero/dsh-std",
+    "submodule": "vendor/dsh-std",
+    "manifestVersion": "0.15"
+  },
+  "imports": [
+    {
+      "name": "commands",
+      "coordinates": {
+        "apiVersion": "commands.dsh/v1alpha1",
+        "kind": "Command"
+      },
+      "package": "@dsh-std/command",
+      "kind": "capability",
+      "permissions": [
+        "commands.invoke"
+      ]
+    },
+    {
+      "name": "storage.local",
+      "coordinates": {
+        "apiVersion": "storage.dsh/v1alpha1",
+        "kind": "LocalStorage"
+      },
+      "package": "@dsh-std/storage",
+      "kind": "capability",
+      "permissions": [
+        "storage.local.read",
+        "storage.local.write"
+      ]
+    },
+    {
+      "name": "messages.observe",
+      "coordinates": {
+        "apiVersion": "messages.dsh/v1alpha1",
+        "kind": "MessageObserver"
+      },
+      "package": "@dsh-std/messages",
+      "kind": "event",
+      "permissions": [
+        "messages.observe.read"
+      ],
+      "eventEnvelope": "@dsh-std/messages/schema/message-observer-envelope-0.15.json"
+    },
+    {
+      "name": "presentation.open-external",
+      "coordinates": {
+        "apiVersion": "presentation.dsh/v1alpha1",
+        "kind": "OpenExternal"
+      },
+      "package": "@dsh-std/presentation",
+      "kind": "capability",
+      "permissions": []
+    },
+    {
+      "name": "presentation.user-interaction",
+      "coordinates": {
+        "apiVersion": "presentation.dsh/v1alpha1",
+        "kind": "UserInteraction"
+      },
+      "package": "@dsh-std/presentation",
+      "kind": "capability",
+      "permissions": []
+    },
+    {
+      "name": "presentation.external-redirect",
+      "coordinates": {
+        "apiVersion": "presentation.dsh/v1alpha1",
+        "kind": "ExternalRedirect"
+      },
+      "package": "@dsh-std/presentation",
+      "kind": "capability",
+      "permissions": []
+    }
+  ],
+  "definitions": [
+    {
+      "name": "tui.decision-events",
+      "authority": "dsh-tui",
+      "coordinates": {
+        "apiVersion": "tui.dsh/v1alpha1",
+        "kind": "DecisionEvents"
+      },
+      "kind": "capability",
+      "profile": "registry/contracts/decision-events-v1alpha1.json",
+      "profileHash": "sha256:56440dde1b00c210b22761a0cba139ce0a20207330567777cebe1e48b494ceb0",
+      "permissions": [
+        "session.input.intercept",
+        "session.rewind.intercept",
+        "session.switch.intercept",
+        "session.compact.intercept"
+      ]
+    },
+    {
+      "name": "tui.channel",
+      "authority": "dsh-tui",
+      "coordinates": {
+        "apiVersion": "tui.dsh/v1alpha1",
+        "kind": "Channel"
+      },
+      "kind": "capability",
+      "profile": "registry/contracts/tui-channel-v1alpha1.json",
+      "profileHash": "sha256:2d0668656d999a8cacd363cd3c76207f9392118be8a83e6dd5f81b54ae063fe6",
+      "permissions": []
+    }
+  ],
+  "extensions": [
+    {
+      "name": "workspace.provider",
+      "authority": "dsh-std",
+      "coordinates": {
+        "apiVersion": "workspace.dsh/v1alpha1",
+        "kind": "WorkspaceProvider"
+      },
+      "kind": "extension",
+      "package": "@dsh-std/workspace",
+      "permissions": []
+    },
+    {
+      "name": "tui.settings-section",
+      "authority": "dsh-tui",
+      "coordinates": {
+        "apiVersion": "tui.dsh/v1alpha1",
+        "kind": "SettingsSection"
+      },
+      "kind": "extension",
+      "profile": "registry/contracts/settings-section-v1alpha1.json",
+      "profileHash": "sha256:685b0f17fe489f458e9b799811f61c42b858330584e95ecb97e7216b5be100ac",
+      "permissions": []
+    },
+    {
+      "name": "tui.scene",
+      "authority": "dsh-tui",
+      "coordinates": {
+        "apiVersion": "tui.dsh/v1alpha1",
+        "kind": "Scene"
+      },
+      "kind": "extension",
+      "profile": "registry/contracts/scene-v1alpha1.json",
+      "profileHash": "sha256:69ce3ae26d60dea2ed170376db8a1fb5860c94bd192c62681423c1d848ec2b26",
+      "permissions": []
+    }
+  ],
+  "facetApiVersions": [
+    "v1alpha1"
+  ]
+}

package/lib/types/command-trees.d.ts

@@ -1,3 +1,4 @@
-export * from './dsh-adapter/command-trees.js';
+export { name, TuiCommandTreeRuntime } from './dsh-adapter/command-trees.js';
+export type { TuiCommandTreeProvider } from './dsh-adapter/command-trees.js';
 export { default } from './dsh-adapter/command-trees.js';
 //# sourceMappingURL=command-trees.d.ts.map

package/lib/types/command-trees.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-trees.d.ts","sourceRoot":"","sources":["../../src/command-trees.ts"],"names":[],"mappings":"AAEA,cAAc,gCAAgC,CAAA;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAA"}
+{"version":3,"file":"command-trees.d.ts","sourceRoot":"","sources":["../../src/command-trees.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAA;AAC5E,YAAY,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAA;AAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAA"}

package/lib/types/command-trees.js

@@ -1,4 +1,4 @@
 // Re-export shim: the Cordis-backed implementation lives behind the adapter
 // boundary so UI consumers never import official @deepseek-ai/* packages.
-export * from './dsh-adapter/command-trees.js';
+export { name, TuiCommandTreeRuntime } from './dsh-adapter/command-trees.js';
 export { default } from './dsh-adapter/command-trees.js';

package/lib/types/components/LoadedContextPanel.d.ts

@@ -1,15 +1,20 @@
 import React from 'react';
 import type { LoadedContext } from '../dsh-adapter/channel.js';
 /**
- * The startup context summary: a one-line inventory of what a
+ * The startup context panel: a collapsed one-line summary of what a
  * fresh conversation will load for the current agent (system prompt
  * sections, workspace instruction files, dynamic context, skill catalog,
- * tools). `/context` renders the existing details as a local report; the
- * summary itself disappears once the transcript has rows. Renders nothing
- * for an empty snapshot.
+ * tools), expandable to the grouped details with Ctrl+P. The `/context`
+ * local command still prints the same details as a transcript report.
+ * The panel renders only while the transcript is still empty — the first
+ * message's rows take over. Renders nothing for an empty snapshot.
  * @param context - the channel's loaded-context snapshot.
+ * @param open - whether the grouped details are shown.
+ * @param onToggle - flips `open`; fired by the Ctrl+P keybinding.
  */
-export declare function LoadedContextPanel({ context }: {
+export declare function LoadedContextPanel({ context, open, onToggle, }: {
     context: LoadedContext;
+    open: boolean;
+    onToggle: () => void;
 }): React.ReactNode;
 //# sourceMappingURL=LoadedContextPanel.d.ts.map

package/lib/types/components/LoadedContextPanel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LoadedContextPanel.d.ts","sourceRoot":"","sources":["../../../src/components/LoadedContextPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAG9D;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,EAAE,aAAa,CAAA;CAAE,GAAG,KAAK,CAAC,SAAS,CAW3F"}
+{"version":3,"file":"LoadedContextPanel.d.ts","sourceRoot":"","sources":["../../../src/components/LoadedContextPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,2BAA2B,CAAA;AA+BlF;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,OAAO,EACP,IAAI,EACJ,QAAQ,GACT,EAAE;IACD,OAAO,EAAE,aAAa,CAAA;IACtB,IAAI,EAAE,OAAO,CAAA;IACb,QAAQ,EAAE,MAAM,IAAI,CAAA;CACrB,GAAG,KAAK,CAAC,SAAS,CAoElB"}

package/lib/types/components/LoadedContextPanel.js

@@ -1,19 +1,30 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { t } from '../i18n.js';
 import { Box, Text } from '../ui.js';
-import { summarizeLoadedContext } from '../utils/loaded-context.js';
+import { summarizeLoadedContext, truncateContextText } from '../utils/loaded-context.js';
+/** One named entry (section or dynamic context) with its full text. */
+function Entry({ entry }) {
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, dimColor: true, children: entry.name }), _jsx(Text, { dimColor: true, wrap: "wrap", children: truncateContextText(entry.text) })] }));
+}
+/** A titled group of rows inside the expanded panel. */
+function Group({ title, children }) {
+    return (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { bold: true, color: "subtle", children: title }), _jsx(Box, { flexDirection: "column", paddingLeft: 2, children: children })] }));
+}
 /**
- * The startup context summary: a one-line inventory of what a
+ * The startup context panel: a collapsed one-line summary of what a
  * fresh conversation will load for the current agent (system prompt
  * sections, workspace instruction files, dynamic context, skill catalog,
- * tools). `/context` renders the existing details as a local report; the
- * summary itself disappears once the transcript has rows. Renders nothing
- * for an empty snapshot.
+ * tools), expandable to the grouped details with Ctrl+P. The `/context`
+ * local command still prints the same details as a transcript report.
+ * The panel renders only while the transcript is still empty — the first
+ * message's rows take over. Renders nothing for an empty snapshot.
  * @param context - the channel's loaded-context snapshot.
+ * @param open - whether the grouped details are shown.
+ * @param onToggle - flips `open`; fired by the Ctrl+P keybinding.
  */
-export function LoadedContextPanel({ context }) {
+export function LoadedContextPanel({ context, open, onToggle, }) {
     const summary = summarizeLoadedContext(context);
     if (summary === '')
         return null;
-    return (_jsx(Box, { marginTop: 1, marginBottom: 1, paddingX: 1, children: _jsxs(Text, { wrap: "truncate", children: [t('context-loaded'), " \u00B7 ", summary, _jsx(Text, { dimColor: true, children: " \u00B7 /context" })] }) }));
+    return (_jsxs(Box, { flexDirection: "column", marginTop: 1, marginBottom: 1, children: [_jsx(Box, { paddingX: 1, backgroundColor: open ? 'userMessageBackground' : undefined, children: _jsxs(Text, { bold: open, wrap: "truncate", children: [open ? '▼' : '▶', " ", _jsxs(Text, { dimColor: true, children: ["\uFF08Ctrl+P", open ? t('context-panel-collapse') : t('context-panel-expand'), "\uFF09"] }), " ", t('context-loaded'), " \u00B7 ", summary] }) }), open && (_jsxs(Box, { flexDirection: "column", paddingX: 1, paddingTop: 1, children: [context.sections.length > 0 && (_jsx(Group, { title: t('context-panel-sections', { n: context.sections.length }), children: context.sections.map(section => (_jsx(Entry, { entry: section }, section.name))) })), context.files.length > 0 && (_jsx(Group, { title: t('context-panel-files', { n: context.files.length }), children: context.files.map(file => (_jsx(Text, { dimColor: true, children: file.displayPath }, file.displayPath))) })), context.contexts.length > 0 && (_jsx(Group, { title: t('context-panel-runtime', { n: context.contexts.length }), children: context.contexts.map(entry => (_jsx(Entry, { entry: entry }, entry.name))) })), context.skills.length > 0 && (_jsx(Group, { title: t('context-panel-skills', { n: context.skills.length }), children: context.skills.map(skill => (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, dimColor: true, children: skill.name }), _jsx(Text, { dimColor: true, wrap: "wrap", children: skill.description })] }, skill.name))) })), context.tools.length > 0 && (_jsx(Group, { title: t('context-panel-tools', { n: context.tools.length }), children: context.tools.map(tool => (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, dimColor: true, children: tool.name }), _jsx(Text, { dimColor: true, wrap: "wrap", children: truncateContextText(tool.description, 160) })] }, tool.name))) })), _jsx(Text, { dimColor: true, children: "\u00B7 /context" })] }))] }));
 }

package/lib/types/components/LogoV2.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LogoV2.d.ts","sourceRoot":"","sources":["../../../src/components/LogoV2.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAoDzB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,MAAM,CAAC,EACrB,KAAK,EACL,MAAM,EACN,GAAG,EACH,SAAiB,GAClB,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,iFAAiF;IACjF,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB,GAAG,KAAK,CAAC,SAAS,CA+ElB"}
+{"version":3,"file":"LogoV2.d.ts","sourceRoot":"","sources":["../../../src/components/LogoV2.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAwDzB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,MAAM,CAAC,EACrB,KAAK,EACL,MAAM,EACN,GAAG,EACH,SAAiB,GAClB,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,iFAAiF;IACjF,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB,GAAG,KAAK,CAAC,SAAS,CAqFlB"}

package/lib/types/components/LogoV2.js

@@ -9,6 +9,7 @@ import { getTheme } from '../theme.js';
 import { useTheme } from './design-system/ThemeProvider.js';
 import { parseRGB } from './Spinner/spinnerUtils.js';
 import { renderBigText } from './bigfont.js';
+import { stringWidth } from '../ink/stringWidth.js';
 import { BRAND, FLASH, ICE, PALE, sweep } from './shimmer.js';
 import { STANDARD_FRAME_INDEX, WhaleArt } from './Whale.js';
 import { OPENING_SEQUENCE } from './whaleFrames.js';
@@ -35,13 +36,16 @@ const WHALE_MIN_COLUMNS = 64;
  */
 const FULL_WHALE_WIDTH = 40;
 /**
- * Leading spaces that center the welcome line under the drawn whale: the
- * art's bounding box spans sprite columns 3..34 (center 18.5) of the
- * 40-wide box, and the tagline measure 14
- * columns — 18.5 − 7 = 11.5 → 12. Centered on the full 40-column box
- * instead would need 13, which reads one column right of the whale body.
+ * Center of the whale art's bounding box: sprite columns 3..34 (center
+ * 18.5) of the 40-wide box. The welcome tagline is indented so its own
+ * center lands on this column — for the 14-column Chinese tagline that is
+ * 18.5 − 7 = 11.5 → 12 leading spaces. (Centering on the full 40-column
+ * box would need 13, which reads one column right of the whale body.)
+ * The pad is recomputed from the rendered tagline's display width so
+ * longer locales — e.g. the 21-column English tagline → 8 — stay
+ * centered under the art too.
  */
-const WELCOME_PAD = 12;
+const WHALE_CENTER = 18.5;
 /** `max` → `Max` (effort levels arrive lower-case from the adapter). */
 function capitalize(text) {
     return text.length === 0 ? text : text[0].toUpperCase() + text.slice(1);
@@ -89,7 +93,12 @@ export function LogoV2({ model, effort, cwd, skipIntro = false, }) {
     // Frozen clock for the settled header: t=0 parks every sweep highlight
     // off-screen, leaving the static gradient behind.
     const t = settled ? 0 : time;
+    const tagline = tr('logo-tagline');
+    // Indent that centers the tagline under the whale art's bounding box.
+    const welcomePad = showWhale
+        ? Math.max(0, Math.round(WHALE_CENTER - stringWidth(tagline) / 2))
+        : 2;
     const bigDeepSeek = renderBigText('DEEPSEEK', t, wordmarkRGB, taglineRGB, FLASH, 60);
     const bigHarness = renderBigText('HARNESS', t, taglineRGB, PALE, FLASH, 60);
-    return (_jsxs(Box, { ref: ref, flexDirection: "column", marginTop: 1, children: [_jsxs(Box, { flexDirection: "row", gap: 2, width: "100%", alignItems: "center", children: [showWhale && _jsx(WhaleArt, { frameIndex: frameIndex, width: FULL_WHALE_WIDTH }), _jsxs(Box, { flexDirection: "column", flexShrink: 1, children: [_jsxs(Text, { wrap: "truncate-end", children: [sweep('✦ dsh-TUI', t, wordmarkRGB, wordmarkShimmerRGB, 60), _jsx(Text, { dimColor: true, children: '  v' + VERSION })] }), bigDeepSeek.map((row, index) => (_jsx(Text, { wrap: "truncate-end", children: row }, `ds-${index}`))), bigHarness.map((row, index) => (_jsx(Text, { wrap: "truncate-end", children: row }, `h-${index}`))), _jsxs(Text, { wrap: "truncate-end", children: [model, effort !== undefined && _jsx(Text, { dimColor: true, children: ' · ' + capitalize(effort) + ' effort' })] }), _jsx(Text, { dimColor: true, wrap: "truncate-end", children: cwd }), _jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { dimColor: true, children: tr('logo-tip-prefix') }), "/model", _jsxs(Text, { dimColor: true, children: [" ", tr('logo-tip-model'), " \u00B7 "] }), "/help", _jsxs(Text, { dimColor: true, children: [" ", tr('logo-tip-help'), " \u00B7 "] }), "Tab", _jsxs(Text, { dimColor: true, children: [" ", tr('logo-tip-tab')] })] })] })] }), _jsx(Box, { marginTop: 1, paddingLeft: showWhale ? WELCOME_PAD : 2, children: _jsx(Text, { children: sweep(tr('logo-tagline'), t, taglineRGB, FLASH, 60) }) })] }));
+    return (_jsxs(Box, { ref: ref, flexDirection: "column", marginTop: 1, children: [_jsxs(Box, { flexDirection: "row", gap: 2, width: "100%", alignItems: "center", children: [showWhale && _jsx(WhaleArt, { frameIndex: frameIndex, width: FULL_WHALE_WIDTH }), _jsxs(Box, { flexDirection: "column", flexShrink: 1, children: [_jsxs(Text, { wrap: "truncate-end", children: [sweep('✦ dsh-TUI', t, wordmarkRGB, wordmarkShimmerRGB, 60), _jsx(Text, { dimColor: true, children: '  v' + VERSION })] }), bigDeepSeek.map((row, index) => (_jsx(Text, { wrap: "truncate-end", children: row }, `ds-${index}`))), bigHarness.map((row, index) => (_jsx(Text, { wrap: "truncate-end", children: row }, `h-${index}`))), _jsxs(Text, { wrap: "truncate-end", children: [model, effort !== undefined && _jsx(Text, { dimColor: true, children: ' · ' + capitalize(effort) + ' effort' })] }), _jsx(Text, { dimColor: true, wrap: "truncate-end", children: cwd }), _jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { dimColor: true, children: tr('logo-tip-prefix') }), "/model", _jsxs(Text, { dimColor: true, children: [" ", tr('logo-tip-model'), " \u00B7 "] }), "/help", _jsxs(Text, { dimColor: true, children: [" ", tr('logo-tip-help'), " \u00B7 "] }), "Tab", _jsxs(Text, { dimColor: true, children: [" ", tr('logo-tip-tab')] })] })] })] }), _jsx(Box, { marginTop: 1, paddingLeft: welcomePad, children: _jsx(Text, { children: sweep(tagline, t, taglineRGB, FLASH, 60) }) })] }));
 }

package/lib/types/components/Markdown.d.ts

@@ -18,7 +18,19 @@ type Props = {
 /**
  * 混合渲染 Markdown 内容：表格用带边框的 flexbox 组件，其余内容由
  * formatToken 生成 ANSI 字符串放入 Text。高亮对象异步就绪后自动刷新。
+ *
+ * memo by content: finished transcript blocks render with the SAME string
+ * identity for the whole session (StreamingMarkdown keeps its stable prefix
+ * identity-stable precisely to hit this); without the memo every parent
+ * re-render re-ran the full token→ANSI→yoga pipeline for every settled
+ * block — the dominant long-output stall (string-width via wrap-ansi, 60%+
+ * of CPU in streaming profiles).
+ */
+declare function MarkdownImpl({ children, dimColor, cacheTokens }: Props): React.ReactNode;
+/**
+ * Memoized Markdown: skips the whole token→ANSI→layout pipeline when the
+ * content string is the same reference (see MarkdownImpl's doc comment).
  */
-export declare function Markdown({ children, dimColor, cacheTokens }: Props): React.ReactNode;
+export declare const Markdown: React.MemoExoticComponent<typeof MarkdownImpl>;
 export {};
 //# sourceMappingURL=Markdown.d.ts.map

package/lib/types/components/Markdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Markdown.d.ts","sourceRoot":"","sources":["../../../src/components/Markdown.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAOzB;;;;;;;;GAQG;AAEH,KAAK,KAAK,GAAG;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB,CAAA;AA4GD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,EAAE,QAAQ,EAAE,QAAgB,EAAE,WAAkB,EAAE,EAAE,KAAK,GAAG,KAAK,CAAC,SAAS,CA6BnG"}
+{"version":3,"file":"Markdown.d.ts","sourceRoot":"","sources":["../../../src/components/Markdown.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAOzB;;;;;;;;GAQG;AAEH,KAAK,KAAK,GAAG;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB,CAAA;AA4GD;;;;;;;;;;GAUG;AACH,iBAAS,YAAY,CAAC,EAAE,QAAQ,EAAE,QAAgB,EAAE,WAAkB,EAAE,EAAE,KAAK,GAAG,KAAK,CAAC,SAAS,CA6BhG;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ,gDAMpB,CAAA"}

package/lib/types/components/Markdown.js

@@ -90,8 +90,15 @@ function renderTokensToNodes(tokens, highlight, dimColor) {
 /**
  * 混合渲染 Markdown 内容：表格用带边框的 flexbox 组件，其余内容由
  * formatToken 生成 ANSI 字符串放入 Text。高亮对象异步就绪后自动刷新。
+ *
+ * memo by content: finished transcript blocks render with the SAME string
+ * identity for the whole session (StreamingMarkdown keeps its stable prefix
+ * identity-stable precisely to hit this); without the memo every parent
+ * re-render re-ran the full token→ANSI→yoga pipeline for every settled
+ * block — the dominant long-output stall (string-width via wrap-ansi, 60%+
+ * of CPU in streaming profiles).
  */
-export function Markdown({ children, dimColor = false, cacheTokens = true }) {
+function MarkdownImpl({ children, dimColor = false, cacheTokens = true }) {
     const [highlight, setHighlight] = React.useState(null);
     React.useEffect(() => {
         let mounted = true;
@@ -110,3 +117,10 @@ export function Markdown({ children, dimColor = false, cacheTokens = true }) {
     }, [children, dimColor, highlight, cacheTokens]);
     return (_jsx(Box, { flexDirection: "column", gap: 1, children: renderedNodes }));
 }
+/**
+ * Memoized Markdown: skips the whole token→ANSI→layout pipeline when the
+ * content string is the same reference (see MarkdownImpl's doc comment).
+ */
+export const Markdown = React.memo(MarkdownImpl, (prev, next) => prev.children === next.children &&
+    prev.dimColor === next.dimColor &&
+    prev.cacheTokens === next.cacheTokens);

package/lib/types/components/MessageList.d.ts

@@ -2,7 +2,7 @@ import React from 'react';
 import { type ScrollBoxHandle } from '../ui.js';
 import type { ChatRow } from '../dsh-adapter/channel.js';
 import type { DOMElement } from '../ink/dom.js';
-export declare function MessageList({ rows, expanded, expandedRows, selectedId, onToggleRow, model, diffLayout, showAll, onToggleAll, onLoadOlder, thinkingVisible, registerRowRef, scrollHandle, forceMountRowId, newSinceRowId, onUnseenCount, failureHintRowId, failureHint, }: {
+export declare function MessageList({ rows, expanded, expandedRows, selectedId, onToggleRow, model, diffLayout, thinkingFold, showAll, onToggleAll, onLoadOlder, thinkingVisible, registerRowRef, scrollHandle, forceMountRowId, newSinceRowId, onUnseenCount, failureHintRowId, failureHint, }: {
     rows: readonly ChatRow[];
     expanded: boolean;
     expandedRows: ReadonlySet<number>;
@@ -11,6 +11,8 @@ export declare function MessageList({ rows, expanded, expandedRows, selectedId,
     model: string;
     /** Edit/Write diff presentation preference (forwarded to tool cards). */
     diffLayout?: 'auto' | 'split' | 'unified';
+    /** Thinking-block display mode from channel (`preview`/`full`). */
+    thinkingFold?: 'preview' | 'full';
     showAll: boolean;
     onToggleAll: () => void;
     /** Restore folded-away older rows from the session log (CC-style "load

package/lib/types/components/MessageList.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MessageList.d.ts","sourceRoot":"","sources":["../../../src/components/MessageList.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,EAA8B,KAAK,eAAe,EAAE,MAAM,UAAU,CAAA;AAC3E,OAAO,KAAK,EAAE,OAAO,EAAyC,MAAM,2BAA2B,CAAA;AAC/F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAuC/C,wBAAgB,WAAW,CAAC,EAC1B,IAAI,EACJ,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,WAAW,EACX,KAAK,EACL,UAAmB,EACnB,OAAO,EACP,WAAW,EACX,WAAW,EACX,eAAsB,EACtB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,WAAW,GACZ,EAAE;IACD,IAAI,EAAE,SAAS,OAAO,EAAE,CAAA;IACxB,QAAQ,EAAE,OAAO,CAAA;IACjB,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACjC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAA;IACzC,OAAO,EAAE,OAAO,CAAA;IAChB,WAAW,EAAE,MAAM,IAAI,CAAA;IACvB;2EACuE;IACvE,WAAW,CAAC,EAAE,MAAM,IAAI,CAAA;IACxB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,8EAA8E;IAC9E,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,GAAG,IAAI,KAAK,IAAI,CAAA;IAC/D,oDAAoD;IACpD,YAAY,CAAC,EAAE,eAAe,GAAG,IAAI,CAAA;IACrC,4EAA4E;IAC5E,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B;8EAC0E;IAC1E,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,0EAA0E;IAC1E,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,qBAiRA;AA2QD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,MAAM,EACN,GAAG,GACJ,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,GAAG,EAAE,MAAM,CAAA;CACZ,GAAG,KAAK,CAAC,SAAS,CAMlB"}
+{"version":3,"file":"MessageList.d.ts","sourceRoot":"","sources":["../../../src/components/MessageList.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,EAA8B,KAAK,eAAe,EAAE,MAAM,UAAU,CAAA;AAC3E,OAAO,KAAK,EAAE,OAAO,EAAyC,MAAM,2BAA2B,CAAA;AAC/F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAuC/C,wBAAgB,WAAW,CAAC,EAC1B,IAAI,EACJ,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,WAAW,EACX,KAAK,EACL,UAAmB,EACnB,YAAwB,EACxB,OAAO,EACP,WAAW,EACX,WAAW,EACX,eAAsB,EACtB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,WAAW,GACZ,EAAE;IACD,IAAI,EAAE,SAAS,OAAO,EAAE,CAAA;IACxB,QAAQ,EAAE,OAAO,CAAA;IACjB,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACjC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAA;IACzC,mEAAmE;IACnE,YAAY,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;IACjC,OAAO,EAAE,OAAO,CAAA;IAChB,WAAW,EAAE,MAAM,IAAI,CAAA;IACvB;2EACuE;IACvE,WAAW,CAAC,EAAE,MAAM,IAAI,CAAA;IACxB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,8EAA8E;IAC9E,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,GAAG,IAAI,KAAK,IAAI,CAAA;IAC/D,oDAAoD;IACpD,YAAY,CAAC,EAAE,eAAe,GAAG,IAAI,CAAA;IACrC,4EAA4E;IAC5E,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B;8EAC0E;IAC1E,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,0EAA0E;IAC1E,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,qBA6VA;AAmRD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,MAAM,EACN,GAAG,GACJ,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,GAAG,EAAE,MAAM,CAAA;CACZ,GAAG,KAAK,CAAC,SAAS,CAMlB"}