@linghun/tui 0.1.0

package/dist/shell/hooks/useScrollBatcher.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Microtask-batched scroll dispatch.
+ *
+ * Multiple scroll delta events arriving within a single microtask frame
+ * (e.g. rapid wheel ticks) are coalesced into a single dispatch call.
+ * This avoids redundant Ink re-renders when the terminal fires several
+ * scroll events before the next paint.
+ */
+export declare function useScrollBatcher(dispatch: (delta: number) => void): (delta: number) => void;
+//# sourceMappingURL=useScrollBatcher.d.ts.map

package/dist/shell/hooks/useScrollBatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollBatcher.d.ts","sourceRoot":"","sources":["../../../src/shell/hooks/useScrollBatcher.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAChC,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAkBzB"}

package/dist/shell/hooks/useScrollBatcher.js

@@ -0,0 +1,23 @@
+// src/shell/hooks/useScrollBatcher.ts
+import { useCallback, useRef } from "react";
+function useScrollBatcher(dispatch) {
+  const pendingRef = useRef(0);
+  const scheduledRef = useRef(false);
+  return useCallback(
+    (delta) => {
+      pendingRef.current += delta;
+      if (scheduledRef.current) return;
+      scheduledRef.current = true;
+      queueMicrotask(() => {
+        scheduledRef.current = false;
+        const batch = pendingRef.current;
+        pendingRef.current = 0;
+        if (batch !== 0) dispatch(batch);
+      });
+    },
+    [dispatch]
+  );
+}
+export {
+  useScrollBatcher
+};

package/dist/shell/hooks/useScrollRuntime.d.ts

@@ -0,0 +1,2 @@
+export declare function useScrollRuntime(dispatch: (delta: number) => void): (delta: number) => void;
+//# sourceMappingURL=useScrollRuntime.d.ts.map

package/dist/shell/hooks/useScrollRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollRuntime.d.ts","sourceRoot":"","sources":["../../../src/shell/hooks/useScrollRuntime.ts"],"names":[],"mappings":"AA8DA,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAChC,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAkEzB"}

package/dist/shell/hooks/useScrollRuntime.js

@@ -0,0 +1,6 @@
+import {
+  useScrollRuntime
+} from "../../chunk-LL7LBRDL.js";
+export {
+  useScrollRuntime
+};

package/dist/shell/hyperlink-utils.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Hyperlink utilities for creating clickable terminal links
+ * Based on CCB's hyperlink implementation
+ */
+/**
+ * Create a clickable hyperlink using OSC 8 escape sequences.
+ * Falls back to plain text if the terminal doesn't support hyperlinks.
+ *
+ * @param url - The URL to link to
+ * @param content - Optional content to display as the link text
+ * @returns Hyperlink string or plain URL
+ */
+export declare function createHyperlink(url: string, content?: string): string;
+/**
+ * Replace URLs in text with clickable hyperlinks
+ */
+export declare function linkifyUrlsInText(content: string): string;
+//# sourceMappingURL=hyperlink-utils.d.ts.map

package/dist/shell/hyperlink-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyperlink-utils.d.ts","sourceRoot":"","sources":["../../src/shell/hyperlink-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA4CH;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAYrE;AAQD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzD"}

package/dist/shell/hyperlink-utils.js

@@ -0,0 +1,8 @@
+import {
+  createHyperlink,
+  linkifyUrlsInText
+} from "../chunk-S3YWTBXL.js";
+export {
+  createHyperlink,
+  linkifyUrlsInText
+};

package/dist/shell/ink-renderer.d.ts

@@ -0,0 +1,18 @@
+import type { Readable, Writable } from "node:stream";
+import { type TerminalCapability } from "./terminal-capability.js";
+import type { ShellController, ShellRenderOptions } from "./types.js";
+export type InkShellInstance = {
+    rerender: () => void;
+    clear: () => void;
+    unmount: () => void;
+    waitUntilExit: () => Promise<void>;
+    waitUntilRenderFlush: () => Promise<void>;
+};
+export declare function shouldUseInkShell(input: Readable, output: Writable): boolean;
+export declare function renderInkShell(controller: ShellController, options?: ShellRenderOptions): InkShellInstance;
+export declare function resolveAlternateScreen(capability: TerminalCapability): boolean;
+export declare function isNoColorTerminal(): boolean;
+/** Re-export for external consumers. */
+export { detectTerminalCapability } from "./terminal-capability.js";
+export type { TerminalCapability } from "./terminal-capability.js";
+//# sourceMappingURL=ink-renderer.d.ts.map

package/dist/shell/ink-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ink-renderer.d.ts","sourceRoot":"","sources":["../../src/shell/ink-renderer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAItD,OAAO,EAAE,KAAK,kBAAkB,EAA4B,MAAM,0BAA0B,CAAC;AAS7F,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEtE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,oBAAoB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAG,OAAO,CAY5E;AAED,wBAAgB,cAAc,CAC5B,UAAU,EAAE,eAAe,EAC3B,OAAO,GAAE,kBAAuB,GAC/B,gBAAgB,CAuIlB;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,kBAAkB,GAAG,OAAO,CAS9E;AAMD,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED,wCAAwC;AACxC,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,YAAY,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/shell/ink-renderer.js

@@ -0,0 +1,54 @@
+import {
+  isNoColorTerminal,
+  renderInkShell,
+  resolveAlternateScreen,
+  shouldUseInkShell
+} from "../chunk-N7G2X2LK.js";
+import "../chunk-KO64OFSG.js";
+import "../chunk-SOPYWTFV.js";
+import "../chunk-6RJVTUWI.js";
+import "../chunk-JGDIO2NF.js";
+import "../chunk-CRQORMFF.js";
+import "../chunk-SQIBPLLV.js";
+import "../chunk-JLCPHVBN.js";
+import "../chunk-M4AIK2SP.js";
+import "../chunk-L5GOCMZP.js";
+import "../chunk-YH6UIHNF.js";
+import "../chunk-F6TVBCZV.js";
+import "../chunk-UOHZQIVL.js";
+import "../chunk-ZOSK2UEU.js";
+import "../chunk-JBLVBO3U.js";
+import "../chunk-GW5YDCRZ.js";
+import "../chunk-HW2TBXVK.js";
+import "../chunk-VCSRBS47.js";
+import "../chunk-MOJL4X4L.js";
+import "../chunk-D3UTL2QX.js";
+import "../chunk-DTK5NBTV.js";
+import "../chunk-F43AMWLZ.js";
+import "../chunk-TJLC3QAS.js";
+import "../chunk-6CI6TKLN.js";
+import "../chunk-F46N43MG.js";
+import "../chunk-CFMSB6ST.js";
+import "../chunk-XFPNU42I.js";
+import "../chunk-P4CPRJLI.js";
+import "../chunk-YPQFSFYK.js";
+import "../chunk-TFZEFIQT.js";
+import "../chunk-GC55DMZV.js";
+import {
+  detectTerminalCapability
+} from "../chunk-DICVLZHH.js";
+import "../chunk-4K6UB524.js";
+import "../chunk-RBOQJFIZ.js";
+import "../chunk-KI7C6ZOD.js";
+import "../chunk-PGNALDEH.js";
+import "../chunk-6SMM5CMP.js";
+import "../chunk-K4FSYBSY.js";
+import "../chunk-OMZYPQVA.js";
+import "../chunk-APJIC2O5.js";
+export {
+  detectTerminalCapability,
+  isNoColorTerminal,
+  renderInkShell,
+  resolveAlternateScreen,
+  shouldUseInkShell
+};

package/dist/shell/models/command-transcript-presenter.d.ts

@@ -0,0 +1,73 @@
+import type { ProductBlockViewModel } from "../types.js";
+/**
+ * CommandTranscriptPresenter — D.13E Step 1
+ *
+ * D.13D 已经把 slash command 提交后的回声改造为独立 `❯ /command` 转录行，
+ * 通过 ProductBlockKind="command" + keep:true 进入 view.blocks。当前格式化
+ * 逻辑散落在两处：
+ *   - packages/tui/src/shell/plain-renderer.ts:239
+ *   - packages/tui/src/shell/components/ProductBlock.tsx:20
+ *
+ * 这两处都在做同一件事：U+276F + 一个 cyan/accent 着色的 slash 文本，
+ * 不带 status marker，不带 detail/nextAction。本模块抽出唯一的事实源：
+ *   - createCommandBlock(): 构造转录 block（带 keep:true）。
+ *   - getCommandTranscriptText(): 取出最终单行文本（用于 plain renderer / 单测）。
+ *
+ * 本模块只整合现有规则，不引入新行为：
+ *   - 仍是 ProductBlockKind="command"。
+ *   - 仍只显示一行（不展开 detail）。
+ *   - 仍设置 keep:true，不被 thinking → completed 的 block 替换 reset 掉。
+ *
+ * 调用方（plain-renderer.ts / ProductBlock.tsx / view-model.ts）只调用
+ * 本模块拿到 block 或 text，不再自行拼接 `${"\u276F"} ${title}`。
+ */
+/** 转录行使用的前缀字符。U+276F 是单行 slash echo 的标准 marker。 */
+export declare const COMMAND_TRANSCRIPT_PREFIX = "\u276F";
+/** 转录 block id 前缀。每条 transcript 用 `cmd:<n>:<slug>` 唯一标识。 */
+export declare const COMMAND_TRANSCRIPT_ID_PREFIX = "cmd:";
+/** 把单条 slash 文本规范化为转录行用的 title（去首尾空白，但保留中间空格）。 */
+export declare function normalizeCommandTitle(command: string): string;
+/**
+ * 由 (sequence, command) 生成稳定的 block id。
+ * sequence 由调用方递增，避免同一条命令重复提交时 React key 冲突。
+ *
+ * slug 仅取 `/command-head` 部分（去掉参数），便于追踪同一命令族。
+ */
+export declare function buildCommandBlockId(sequence: number, command: string): string;
+/**
+ * 构造一条 slash command 转录 block。view-model 在用户提交 slash 后调用。
+ *
+ * 设计要点：
+ *   - kind="command" → ProductBlock / plain-renderer 的 command 分支命中。
+ *   - status="info" → 与现有 status 颜色映射兼容（command 渲染分支自己覆盖颜色，
+ *     这里给个稳定值便于其它 reducer 读取）。
+ *   - keep=true → block 在新一轮 thinking → completed 流转中不被清掉，转录持久。
+ *   - summary 故意置空字符串：command 渲染分支只用 title，不展示 summary，
+ *     但 ProductBlockViewModel 的契约要求 summary 字段存在。
+ */
+export declare function createCommandBlock(sequence: number, command: string): ProductBlockViewModel;
+/**
+ * 取出转录行的最终 plain 文本（不含 ANSI），用于 plain-renderer 与单测断言。
+ * 与 plain-renderer.ts 的 dim/colorCyan 包装独立 —— 那一层颜色由调用方加。
+ *
+ * 仅一行：`❯ /command`。
+ */
+export declare function getCommandTranscriptText(block: ProductBlockViewModel): string;
+/** 类型守卫：判断一个 block 是否是 command transcript 行。 */
+export declare function isCommandBlock(block: ProductBlockViewModel): boolean;
+/**
+ * D.13Q-UX Real Smoke Fix v2 — C. 用户普通消息（非 slash）进 transcript 的
+ * user-text 行。视觉与 slash command transcript 区别：
+ *   - 前缀 marker `›`（U+203A，比 slash 的 `❯` 轻），dim 着色，正文默认色。
+ *   - 仍走 ProductBlockKind="command" + keep:true，复用 ProductBlock 的
+ *     command 分支渲染（marker + accent title）。
+ *   - id 用 `usr:<n>:<slug>` 区分，避免与 slash transcript 混淆。
+ *
+ * 注意：保留多行原文。ProductBlock 当前 command 分支只渲染 title 单行，
+ * 长用户消息在主屏只显示首行；fullText 仍持有完整正文，便于 /details 路径展开。
+ */
+export declare const USER_TEXT_TRANSCRIPT_PREFIX = "\u203A";
+export declare const USER_TEXT_TRANSCRIPT_ID_PREFIX = "usr:";
+export declare function buildUserTextBlockId(sequence: number, _text: string): string;
+export declare function createUserTextBlock(sequence: number, text: string, timestamp?: number): ProductBlockViewModel;
+//# sourceMappingURL=command-transcript-presenter.d.ts.map

package/dist/shell/models/command-transcript-presenter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-transcript-presenter.d.ts","sourceRoot":"","sources":["../../../src/shell/models/command-transcript-presenter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,mDAAmD;AACnD,eAAO,MAAM,yBAAyB,WAAW,CAAC;AAElD,4DAA4D;AAC5D,eAAO,MAAM,4BAA4B,SAAS,CAAC;AAEnD,kDAAkD;AAClD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAK7E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,qBAAqB,CAU3F;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAG7E;AAED,gDAAgD;AAChD,wBAAgB,cAAc,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAEpE;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,2BAA2B,WAAM,CAAC;AAC/C,eAAO,MAAM,8BAA8B,SAAS,CAAC;AAErD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,qBAAqB,CAe7G"}

package/dist/shell/models/command-transcript-presenter.js

@@ -0,0 +1,26 @@
+import {
+  COMMAND_TRANSCRIPT_ID_PREFIX,
+  COMMAND_TRANSCRIPT_PREFIX,
+  USER_TEXT_TRANSCRIPT_ID_PREFIX,
+  USER_TEXT_TRANSCRIPT_PREFIX,
+  buildCommandBlockId,
+  buildUserTextBlockId,
+  createCommandBlock,
+  createUserTextBlock,
+  getCommandTranscriptText,
+  isCommandBlock,
+  normalizeCommandTitle
+} from "../../chunk-SJOS5PM6.js";
+export {
+  COMMAND_TRANSCRIPT_ID_PREFIX,
+  COMMAND_TRANSCRIPT_PREFIX,
+  USER_TEXT_TRANSCRIPT_ID_PREFIX,
+  USER_TEXT_TRANSCRIPT_PREFIX,
+  buildCommandBlockId,
+  buildUserTextBlockId,
+  createCommandBlock,
+  createUserTextBlock,
+  getCommandTranscriptText,
+  isCommandBlock,
+  normalizeCommandTitle
+};

package/dist/shell/models/help-panel.d.ts

@@ -0,0 +1,37 @@
+import type { Language } from "@linghun/shared";
+/**
+ * D.13Q-UX — HelpPanel 模型
+ *
+ * 把 /help 的 short / advanced / details 三组命令收敛成结构化数据，
+ * 让 HelpPanel UI 可以 Tab 切换、↑↓ 选择、Enter dispatch slash。
+ * 隐藏命令（userVisible=false / 例如 /status）永远过滤；plain TUI
+ * 仍走 formatCatalogHelp 文本表 fallback。
+ *
+ * CCB HelpV2 范式：tabs by group + 只读 Select；本模块不引入新功能、
+ * 不复制 CCB 源码；命令清单与 slash-dispatch 中的现有清单对齐。
+ */
+export type HelpPanelGroup = "core" | "advanced" | "details";
+export type HelpPanelEntry = {
+    /** 命令文本，例如 "/model"。 */
+    slash: string;
+    /** user-facing 描述。 */
+    description: string;
+};
+export type HelpPanelData = {
+    /** 当前 active 分组。 */
+    group: HelpPanelGroup;
+    /** 当前 cursor 位置（被选中条目下标）。 */
+    cursor: number;
+    /** 滚动偏移（用于 scroll viewport）。 */
+    scrollOffset: number;
+    /** 该分组的命令清单。 */
+    entries: HelpPanelEntry[];
+};
+/**
+ * 取本组命令清单。隐藏命令（如 /status）已经在数据层过滤掉，不出现在
+ * HelpPanel 主流程；用户仍可通过 /help all 看到完整文本表。
+ */
+export declare function getHelpPanelEntries(group: HelpPanelGroup, language: Language): HelpPanelEntry[];
+export declare function buildHelpPanelData(group: HelpPanelGroup, cursor: number, scrollOffset: number, language: Language): HelpPanelData;
+export declare const HELP_PANEL_GROUPS: HelpPanelGroup[];
+//# sourceMappingURL=help-panel.d.ts.map

package/dist/shell/models/help-panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-panel.d.ts","sourceRoot":"","sources":["../../../src/shell/models/help-panel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;AAE7D,MAAM,MAAM,cAAc,GAAG;IAC3B,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,oBAAoB;IACpB,KAAK,EAAE,cAAc,CAAC;IACtB,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB;IAChB,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B,CAAC;AA2EF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,GAAG,cAAc,EAAE,CAI/F;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,QAAQ,GACjB,aAAa,CAIf;AAED,eAAO,MAAM,iBAAiB,EAAE,cAAc,EAAoC,CAAC"}

package/dist/shell/models/help-panel.js

@@ -0,0 +1,10 @@
+import {
+  HELP_PANEL_GROUPS,
+  buildHelpPanelData,
+  getHelpPanelEntries
+} from "../../chunk-3AKXDMVS.js";
+export {
+  HELP_PANEL_GROUPS,
+  buildHelpPanelData,
+  getHelpPanelEntries
+};

package/dist/shell/models/permission-elevation.d.ts

@@ -0,0 +1,65 @@
+import type { Language } from "@linghun/shared";
+import type { ToolName } from "@linghun/tools";
+import type { PermissionRule } from "../../permission-continuation-runtime.js";
+/**
+ * PermissionElevationModel — D.13E Step 1（v3 修正）
+ *
+ * 纯函数：根据当前权限上下文（toolName / scope / risk / 现有规则）计算
+ * 提权选项菜单。本轮只返回 4 档：
+ *   - allow_once          当次同意（不落盘）
+ *   - allow_always_tool   当次同意 + 持久落盘（语义由 controller 层 atomic 实现）
+ *   - deny                当次拒绝
+ *   - details             展开 reason/scope
+ *
+ * 复用 packages/tui/src/permission-continuation-runtime.ts 中已存在的
+ * PermissionRule 类型。本模块不持久化、不写文件、不注册任何 store —
+ * "always" 落盘由 controller 层调用 addAllowRule helper（见 index.ts）。
+ *
+ * 已存在 effect:"allow" toolName:<x>|"*" 规则时，allow_always_tool 隐藏，
+ * 避免重复落盘和误导用户。
+ *
+ * v3 契约调整：删除 dispatches 字段。原本"submit yes + slash /permissions add"
+ * 的复合 dispatch 由 model 描述、UI 顺次发两个 onInput 的设计会与
+ * pendingLocalApproval 状态竞争（两个 submit 之间 pending 已被消费）。
+ * 修正后：model 只暴露 `id`（语义），副作用由 controller 在收到
+ * `permission-action` 事件后 atomic 处理（先 addAllowRule 持久化，
+ * 持久化成功才 approve；失败保留 pending）。
+ */
+export type ElevationOptionId = "allow_once" | "allow_always_tool" | "deny" | "details";
+export type ElevationOption = {
+    id: ElevationOptionId;
+    /** 单字母快捷键。details 用 d；allow_always_tool 用 a；allow_once 用 y；deny 用 n。 */
+    shortcut?: string;
+    label: string;
+    /** 短提示，用于权限卡 hint 行 / suggestion bar 副标题。 */
+    hint: string;
+};
+export type ElevationInput = {
+    toolName: ToolName;
+    /** 影响范围（文件路径 / bash 命令片段等），仅用于文案，不参与决策。 */
+    scope: string[];
+    risk: "low" | "medium" | "high";
+    existingRules: PermissionRule[];
+    language: Language;
+};
+/**
+ * 检测当前 rules 中是否已经有覆盖 `toolName` 的 effect:"allow" 规则。
+ * 与 /permissions add 的语义对齐：toolName 为 "*" 表示通配；risk 限定可能更窄，
+ * 但只要存在一条无 risk 限定或 risk 等于当前 risk 的 allow 规则，就视为已覆盖。
+ *
+ * 暴露为独立纯函数便于单元测试。
+ */
+export declare function hasExistingAllowRule(rules: PermissionRule[], toolName: ToolName, risk: "low" | "medium" | "high"): boolean;
+/**
+ * 暴露 allow_always_tool 等价 slash 命令（仅文档/调试用途）。
+ * controller 端不再通过 onInput 派发该 slash；直接调 addAllowRule helper 完成
+ * "持久化 + approve" 的 atomic 操作。
+ */
+export declare function describeAllowAlwaysCommand(toolName: ToolName, risk: "low" | "medium" | "high"): string;
+/**
+ * 根据当前权限上下文返回 ElevationOption[]。
+ * 顺序固定为 allow_once → allow_always_tool → deny → details，
+ * 与 PermissionAction 的稳定渲染顺序兼容。
+ */
+export declare function buildElevationOptions(input: ElevationInput): ElevationOption[];
+//# sourceMappingURL=permission-elevation.d.ts.map

package/dist/shell/models/permission-elevation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission-elevation.d.ts","sourceRoot":"","sources":["../../../src/shell/models/permission-elevation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,mBAAmB,GAAG,MAAM,GAAG,SAAS,CAAC;AAExF,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,iBAAiB,CAAC;IACtB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,QAAQ,CAAC;IACnB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAChC,aAAa,EAAE,cAAc,EAAE,CAAC;IAChC,QAAQ,EAAE,QAAQ,CAAC;CACpB,CAAC;AAgCF;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,cAAc,EAAE,EACvB,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAC9B,OAAO,CAQT;AAiBD;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAC9B,MAAM,CAER;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,GAAG,eAAe,EAAE,CAmC9E"}

package/dist/shell/models/permission-elevation.js

@@ -0,0 +1,10 @@
+import {
+  buildElevationOptions,
+  describeAllowAlwaysCommand,
+  hasExistingAllowRule
+} from "../../chunk-H3T4EF5F.js";
+export {
+  buildElevationOptions,
+  describeAllowAlwaysCommand,
+  hasExistingAllowRule
+};

package/dist/shell/models/permission-explanation.d.ts

@@ -0,0 +1,45 @@
+import type { Language } from "@linghun/shared";
+/**
+ * D.13Q-UX — permission-explanation 翻译层
+ *
+ * 把 permission-policy-engine.PolicyVerdict.semantic + pathSafety 与
+ * tui-permission-runtime.decidePermission 的 reason 文案翻译成 user-facing
+ * 中文/英文短句。**绝不暴露 rule.id（randomUUID）**；底层仍可在 details
+ * debug 区显示，但主屏 / PermissionPanel 只看本模块输出。
+ *
+ * 不引入第二套审批系统：本模块只是 presenter 层。
+ */
+export type PolicySemantic = "readonly" | "mutating" | "destructive" | "network" | "install" | "secret_read" | "outside_workspace" | "unknown";
+export type PathSafety = "workspace_safe" | "workspace_write" | "outside_workspace" | "sensitive_path" | "unknown_path";
+/**
+ * 把 reason 字符串里的 rule.id（randomUUID 形如
+ * `命中 deny 规则：a3b4c2-...` / `命中 allow 规则：xxx`）剥离，
+ * 让 user-facing 文本只留语义。
+ */
+export declare function sanitizePermissionReason(reason: string): string;
+/**
+ * 把 PolicyVerdict.semantic 翻译成 user-facing 中文/英文短句。
+ */
+export declare function explainSemantic(semantic: PolicySemantic, language: Language): string;
+/**
+ * 把 PathSafety 翻译成 user-facing 中文/英文短句。
+ */
+export declare function explainPathSafety(pathSafety: PathSafety, language: Language): string;
+/**
+ * 给出"如何永久允许 / 修改规则"的 UI 指引（CCB PermissionRuleExplanation 范式）。
+ * 不展示 rule id；仅指向 /permissions 入口。
+ */
+export declare function explainHowToUpdate(language: Language): string;
+/**
+ * 把 PolicyVerdict 整体翻译成 PermissionPanel 详情区的多行说明。
+ * 输入只取 semantic / pathSafety / redactedSummary 三段稳定字段；
+ * reason 文本经 sanitizePermissionReason 脱去 rule.id。
+ */
+export type PolicyVerdictLite = {
+    semantic?: PolicySemantic;
+    pathSafety?: PathSafety;
+    redactedSummary?: string;
+    reason?: string;
+};
+export declare function explainPolicyVerdict(verdict: PolicyVerdictLite, language: Language): string[];
+//# sourceMappingURL=permission-explanation.d.ts.map

package/dist/shell/models/permission-explanation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission-explanation.d.ts","sourceRoot":"","sources":["../../../src/shell/models/permission-explanation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;;;;GASG;AAEH,MAAM,MAAM,cAAc,GACtB,UAAU,GACV,UAAU,GACV,aAAa,GACb,SAAS,GACT,SAAS,GACT,aAAa,GACb,mBAAmB,GACnB,SAAS,CAAC;AAEd,MAAM,MAAM,UAAU,GAClB,gBAAgB,GAChB,iBAAiB,GACjB,mBAAmB,GACnB,gBAAgB,GAChB,cAAc,CAAC;AAEnB;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAiB/D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAsBpF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAcpF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAI7D;AAED;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,EAAE,CAe7F"}

package/dist/shell/models/permission-explanation.js

@@ -0,0 +1,14 @@
+import {
+  explainHowToUpdate,
+  explainPathSafety,
+  explainPolicyVerdict,
+  explainSemantic,
+  sanitizePermissionReason
+} from "../../chunk-NSIKYD3X.js";
+export {
+  explainHowToUpdate,
+  explainPathSafety,
+  explainPolicyVerdict,
+  explainSemantic,
+  sanitizePermissionReason
+};

package/dist/shell/models/session-panel.d.ts

@@ -0,0 +1,22 @@
+/**
+ * session-panel — D.13Q-UX Closure
+ *
+ * SessionsPanel 数据模型：把 SessionStore.list() 转成 picker 用的稳定结构。
+ * 按 updatedAt 倒序排序；当前 session 标记 isCurrent；title 优先使用 summary，
+ * 退到 sessionId 短串。**不在数据层 dump transcript**；只暴露 id + 元数据。
+ */
+export type SessionPanelEntry = {
+    id: string;
+    title: string;
+    updatedAt: string;
+    messageCount: number;
+    isCurrent: boolean;
+};
+export type SessionListItem = {
+    id: string;
+    updatedAt: string;
+    summary?: string;
+    messageCount?: number;
+};
+export declare function buildSessionPanelEntries(sessions: SessionListItem[], currentSessionId: string | undefined): SessionPanelEntry[];
+//# sourceMappingURL=session-panel.d.ts.map

package/dist/shell/models/session-panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-panel.d.ts","sourceRoot":"","sources":["../../../src/shell/models/session-panel.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,eAAe,EAAE,EAC3B,gBAAgB,EAAE,MAAM,GAAG,SAAS,GACnC,iBAAiB,EAAE,CAarB"}

package/dist/shell/models/session-panel.js

@@ -0,0 +1,18 @@
+// src/shell/models/session-panel.ts
+function buildSessionPanelEntries(sessions, currentSessionId) {
+  const sorted = [...sessions].sort((a, b) => {
+    const at = new Date(a.updatedAt).getTime() || 0;
+    const bt = new Date(b.updatedAt).getTime() || 0;
+    return bt - at;
+  });
+  return sorted.map((s) => ({
+    id: s.id,
+    title: s.summary && s.summary.trim().length > 0 ? s.summary.trim() : s.id.slice(0, 12),
+    updatedAt: s.updatedAt,
+    messageCount: typeof s.messageCount === "number" ? s.messageCount : 0,
+    isCurrent: s.id === currentSessionId
+  }));
+}
+export {
+  buildSessionPanelEntries
+};

package/dist/shell/models/task-scroll-state.d.ts

@@ -0,0 +1,24 @@
+import type { TaskScrollView } from "../types.js";
+/**
+ * D.13Q-UX Task Surface — 任务区滚动状态推进（纯函数）。
+ *
+ * 本模块是 transcript-scroll-state 的轻量适配。TaskScrollView === TranscriptScrollView，
+ * 核心逻辑统一由 transcript-scroll-state 提供，这里保留 task-scroll 特定的 action 子集。
+ */
+export type TaskScrollAction = {
+    type: "scroll";
+    delta: number;
+} | {
+    type: "end";
+} | {
+    type: "top";
+};
+export declare function createInitialTaskScroll(): TaskScrollView;
+export declare function reduceTaskScroll(state: TaskScrollView | undefined, action: TaskScrollAction): TaskScrollView;
+export declare function clampTaskScroll(state: TaskScrollView | undefined, maxOffset: number): TaskScrollView;
+export declare function computeScrollViewportOffset(maxOffset: number, scroll: TaskScrollView | undefined): {
+    topOffset: number;
+    marginTop: number;
+    bottomOffset: number;
+};
+//# sourceMappingURL=task-scroll-state.d.ts.map

package/dist/shell/models/task-scroll-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-scroll-state.d.ts","sourceRoot":"","sources":["../../../src/shell/models/task-scroll-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAQlD;;;;;GAKG;AAEH,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GACf;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,CAAC;AAEpB,wBAAgB,uBAAuB,IAAI,cAAc,CAExD;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,cAAc,GAAG,SAAS,EACjC,MAAM,EAAE,gBAAgB,GACvB,cAAc,CAEhB;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,cAAc,GAAG,SAAS,EACjC,SAAS,EAAE,MAAM,GAChB,cAAc,CAEhB;AAED,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,cAAc,GAAG,SAAS,GACjC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAEhE"}

package/dist/shell/models/task-scroll-state.js

@@ -0,0 +1,26 @@
+import {
+  clampTranscriptScroll,
+  computeScrollViewportOffset,
+  createInitialTranscriptScroll,
+  reduceTranscriptScroll
+} from "../../chunk-JPXSFZFC.js";
+
+// src/shell/models/task-scroll-state.ts
+function createInitialTaskScroll() {
+  return createInitialTranscriptScroll();
+}
+function reduceTaskScroll(state, action) {
+  return reduceTranscriptScroll(state, action);
+}
+function clampTaskScroll(state, maxOffset) {
+  return clampTranscriptScroll(state, maxOffset);
+}
+function computeScrollViewportOffset2(maxOffset, scroll) {
+  return computeScrollViewportOffset(maxOffset, scroll);
+}
+export {
+  clampTaskScroll,
+  computeScrollViewportOffset2 as computeScrollViewportOffset,
+  createInitialTaskScroll,
+  reduceTaskScroll
+};

package/dist/shell/models/terminal-input-runtime.d.ts

@@ -0,0 +1,37 @@
+import { type Key } from "@linghun/ink-runtime";
+export type TerminalInputAction = {
+    type: "backspace";
+} | {
+    type: "delete";
+} | {
+    type: "delete-word-left";
+} | {
+    type: "newline";
+} | {
+    type: "text";
+    text: string;
+} | {
+    type: "ignore";
+};
+export type InputClassification = "keyboard" | "mouse" | "paste" | "terminal-response" | "unknown-escape";
+/**
+ * Classify raw terminal input BEFORE it reaches any handler.
+ * Returns "mouse" for SGR mouse sequences (full or orphan tail),
+ * "terminal-response" for DA1/DA2/DECRPM/cursor-position reports,
+ * "keyboard" for everything else.
+ */
+export declare function classifyTerminalInput(input: string): InputClassification;
+/**
+ * Recover an orphan SGR mouse tail by prepending ESC.
+ * When the event loop stalls, ESC arrives as a separate frame and the
+ * remaining `[<btn;col;rowM` reaches handlers as "text". This re-synthesizes
+ * the full sequence so the mouse router can parse it.
+ */
+export declare function recoverOrphanMouseTail(input: string): string | undefined;
+export type TerminalInputKey = Pick<Key, "backspace" | "delete" | "ctrl" | "meta" | "return" | "shift">;
+export declare function normalizeTerminalInput(input: string, key: TerminalInputKey): TerminalInputAction;
+export declare function isDeleteSequence(input: string): boolean;
+export declare function isBackspaceSequence(input: string): boolean;
+export declare function isMultilineEnterSequence(input: string): boolean;
+export declare function sanitizeTerminalText(value: string): string;
+//# sourceMappingURL=terminal-input-runtime.d.ts.map

package/dist/shell/models/terminal-input-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-input-runtime.d.ts","sourceRoot":"","sources":["../../../src/shell/models/terminal-input-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAE7E,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,kBAAkB,CAAA;CAAE,GAC5B;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEvB,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,mBAAmB,GAAG,gBAAgB,CAAC;AAE1G;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAGxE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKxE;AAED,MAAM,MAAM,gBAAgB,GAAG,IAAI,CACjC,GAAG,EACH,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAC9D,CAAC;AAsBF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,GAAG,mBAAmB,CAoBhG;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGvD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAG1D;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAO/D;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAS1D"}

package/dist/shell/models/terminal-input-runtime.js

@@ -0,0 +1,18 @@
+import {
+  classifyTerminalInput,
+  isBackspaceSequence,
+  isDeleteSequence,
+  isMultilineEnterSequence,
+  normalizeTerminalInput,
+  recoverOrphanMouseTail,
+  sanitizeTerminalText
+} from "../../chunk-JBLVBO3U.js";
+export {
+  classifyTerminalInput,
+  isBackspaceSequence,
+  isDeleteSequence,
+  isMultilineEnterSequence,
+  normalizeTerminalInput,
+  recoverOrphanMouseTail,
+  sanitizeTerminalText
+};