@changfenhuang/dsh-genui 0.11.3 → 0.12.0

package/lib/types/client/blocks/forms.d.ts

@@ -1,15 +1,14 @@
-import type { AnswersState, GenuiBlockProps, QuestionMeta } from './state.ts';
+import type { RadioSubmissionMember } from '../submission-registry.ts';
+import type { AnswersState, GenuiBlockProps } from './state.ts';
 import type { GenuiInput, GenuiRadio, GenuiSelect, GenuiSlider, GenuiSubmit, GenuiSwitch, GenuiTextarea } from '../spec.ts';
 export declare function RadioNode({ node, onAction, answers }: {
     node: GenuiRadio;
     onAction?: GenuiBlockProps['onAction'];
     answers?: AnswersState | undefined;
 }): import("react").JSX.Element;
-/** Resolve a question's correct label from its metadata. */
-export declare function correctLabelOf(m: QuestionMeta): string | undefined;
-/** Submit: collect grouped radio and checkbox answers. Radio-only scopes keep
- * LOCAL-FIRST grading; when checkbox selections participate, the click falls
- * back to the aggregation action so multi-select data is never discarded. */
+/** 根据静态 radio member 获取正确选项的标签。 */
+export declare function correctLabelOf(m: RadioSubmissionMember): string | undefined;
+/** 汇总当前 block 的表单状态，并根据 resolver 的结果提交或本地判卷。 */
 export declare function SubmitNode({ node, onAction, answers }: {
     node: GenuiSubmit;
     onAction?: GenuiBlockProps['onAction'];

package/lib/types/client/blocks/state.d.ts

@@ -7,6 +7,7 @@
  */
 import type { GenuiSpec } from '../spec.ts';
 import type { BlockInteractionState } from '../interaction-store.ts';
+import type { SubmissionRegistry } from '../submission-registry.ts';
 export interface GenuiBlockProps {
     /** Parsed spec to render. */
     spec: GenuiSpec;
@@ -33,15 +34,6 @@ export interface GenuiBlockProps {
     /** Observe the current secret-free durable state without changing persistence ownership. */
     onStateSnapshot?: ((state: BlockInteractionState) => void) | undefined;
 }
-/** Per-question metadata registered by grouped radios for local grading. */
-export interface QuestionMeta {
-    label: string;
-    options: string[];
-    /** Correct option: index (number) or label (string); absent = no local grading. */
-    answer?: number | string | undefined;
-    /** Shown after local grading. */
-    explanation?: string | undefined;
-}
 /** Block-wide aggregation state. Grouped radios store one selected label in
  * `answers`; grouped checkboxes store a selected-label array in
  * `multiAnswers`. Keeping the registries separate preserves the existing
@@ -57,7 +49,7 @@ export interface AnswersState {
     fields: Record<string, string>;
     /** Field ids whose value must never be persisted or collected (secrets). */
     secretFields: ReadonlySet<string>;
-    meta: Record<string, QuestionMeta>;
+    registry: SubmissionRegistry;
     /** True after a local grading: questions are locked until 重新作答. */
     locked: boolean;
     /** Bumped by every reset; radios use it as their remount key. */
@@ -66,7 +58,6 @@ export interface AnswersState {
     setMultiAnswer: (group: string, choice: string, checked: boolean) => void;
     setField: (id: string, value: string) => void;
     registerSecretField: (id: string) => void;
-    registerMeta: (group: string, meta: QuestionMeta) => void;
     clear: () => void;
     setLocked: (locked: boolean) => void;
 }

package/lib/types/client/dom-fence.d.ts

@@ -1,6 +1,7 @@
 import { type Root } from 'react-dom/client';
 import type { Context } from '@deepseek-ai/cordis';
 import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import { type FileLinkAvailability } from './file-link-context.tsx';
 /** Override the React root factory (tests / tuning). */
 export declare function setDomRootFactory(factory: (container: HTMLElement) => Root): void;
 /**
@@ -27,4 +28,4 @@ export declare function hostFenceIndexOf(row: Element, block: Element): number;
  * @param sendAction - plugin-owned relay: (sessionId, action, payload) → the
  *   scoped conversation send carrying the `[genui-action]` prompt.
  */
-export declare function installDomFenceRenderer(ctx: Context, sendAction: (sessionId: SessionId, action: string, payload: Record<string, unknown>) => void): () => void;
+export declare function installDomFenceRenderer(ctx: Context, sendAction: (sessionId: SessionId, action: string, payload: Record<string, unknown>) => void, fileLinkAvailability?: FileLinkAvailability): () => void;

package/lib/types/client/file-address.d.ts

@@ -0,0 +1,4 @@
+/** Build a session resource address while preserving encoded path segments. */
+export declare function sessionFileAddress(sessionId: string, path: string): string;
+/** Resolve workspace absolute paths to session-relative resource addresses. */
+export declare function fileAddressFor(sessionId: string, cwd: string | undefined, path: string): string;

package/lib/types/client/file-link-context.d.ts

@@ -0,0 +1,41 @@
+import { type ReactNode } from 'react';
+interface SidebarRightService {
+    openResource(address: string, options?: {
+        params: {
+            line: number;
+        };
+    }): void;
+}
+interface FileLinkHostContext {
+    get(name: 'sidebarRight', strict?: false): SidebarRightService | undefined;
+    sessions: {
+        list: {
+            getSnapshot(): unknown;
+        };
+    };
+}
+interface FileLinkScope {
+    get(name: 'sidebarRight'): SidebarRightService | undefined;
+    effect(callback: () => void | (() => void), name?: string): unknown;
+}
+export interface FileLinkCordisContext extends FileLinkHostContext {
+    inject(services: ['sidebarRight'], callback: (scope: FileLinkScope) => void): unknown;
+}
+export interface FileLinkAvailability {
+    subscribe(listener: () => void): () => void;
+    getSnapshot(): boolean;
+}
+/** Track an optional host service through arrival, removal, and plugin unload. */
+export declare function createFileLinkAvailability(ctx: FileLinkCordisContext): FileLinkAvailability;
+/** Render a file link as an accessible host navigation button when available. */
+export declare function FileLink({ path, line, label, children }: {
+    path: string;
+    line?: number;
+    label: string;
+    children?: ReactNode;
+}): import("react").DetailedReactHTMLElement<{
+    title: string;
+}, HTMLElement>;
+/** Add session-scoped file navigation to one fence render tree. */
+export declare function withFileLinkContext(ctx: FileLinkHostContext, availability: FileLinkAvailability, sessionId: string | undefined, streaming: boolean, children: ReactNode): ReactNode;
+export {};

package/lib/types/client/file-link.d.ts

@@ -0,0 +1,17 @@
+export interface ParsedFileLink {
+    path: string;
+    line?: number;
+}
+export type LinkTarget = {
+    type: 'external';
+    href: string;
+} | {
+    type: 'file';
+    file: ParsedFileLink;
+} | {
+    type: 'invalid';
+};
+/** Decode a local file destination and its optional first line fragment. */
+export declare function parseFileLink(value: string): ParsedFileLink | undefined;
+/** Classify a link destination while preserving the existing external URL policy. */
+export declare function classifyLinkTarget(value: unknown): LinkTarget;

package/lib/types/client/i18n/en.d.ts

@@ -262,6 +262,10 @@ export declare const EN: {
     readonly 'label.copyButtonTitle': "{action}; right-click for copy options";
     readonly 'block.copyMarkdown': "Copy Markdown";
     readonly 'block.copyCsv': "Copy CSV";
+    readonly 'block.table.expandDetails': "Expand details for {label}";
+    readonly 'block.table.collapseDetails': "Collapse details for {label}";
+    readonly 'block.table.expandGroup': "Expand group {label}";
+    readonly 'block.table.collapseGroup': "Collapse group {label}";
     readonly 'block.total': "Total";
     readonly 'block.filteredRows': "{visible} / {total} rows after filtering";
     readonly 'block.filterMatch': "{shown} / {total} matched";
@@ -277,7 +281,7 @@ export declare const EN: {
     readonly 'block.svgPreview': "Preview";
     readonly 'block.svgSource': "Source";
     readonly 'block.svgError': "SVG could not be displayed — showing the source instead";
-    readonly 'block.mermaidError': "Invalid diagram syntax — showing the source instead";
+    readonly 'block.mermaidError': "Diagram rendering failed — showing the source instead";
     readonly 'block.mermaidLoading': "Rendering…";
     readonly 'block.scene3dLoading': "Loading 3D scene…";
     readonly 'block.scene3dError': "3D rendering failed";

package/lib/types/client/inline.d.ts

@@ -2,4 +2,4 @@
 import { type ReactNode } from 'react';
 export declare function hasInlineMarkup(text: string): boolean;
 /** Render safe phrasing content, usable in headings, buttons and labels too. */
-export declare function renderInline(text: string, allowLinks?: boolean, depth?: number): ReactNode;
+export declare function renderInline(text: string, allowLinks?: boolean | 'file', depth?: number): ReactNode;

package/lib/types/client/mermaid-colors.d.ts

@@ -0,0 +1,2 @@
+/** Resolve host CSS colors before passing them to Mermaid's limited parser. */
+export declare function readMermaidThemeColor(name: string, fallback: string): string;

package/lib/types/client/panel.d.ts

@@ -1,9 +1,14 @@
 import { type GenuiActionHandler } from './action-context.ts';
+import { type FileLinkAvailability, type FileLinkCordisContext } from './file-link-context.tsx';
 import type { PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
 /** Injection face built per session in apply (scoped conversation send). */
 export interface GenuiPanelInjected {
     sessionId: string;
     sendGenuiAction: GenuiActionHandler;
+    fileLinkContext?: {
+        ctx: FileLinkCordisContext;
+        availability: FileLinkAvailability;
+    };
     /** Template center "try it": insert the template instruction into the
      *  current composer draft (standard conversation.input.for channel). */
     insertTemplate: (text: string) => void;
@@ -15,4 +20,4 @@ export type GenuiPanelProps = PropsRuntime<'conversation.input.dock'> & GenuiPan
  * default so the dock never steals the message flow's scroll room; the
  * header always shows the current panel title.
  */
-export declare function GenuiPanel({ sessionId, sendGenuiAction, insertTemplate }: GenuiPanelProps): import("react").JSX.Element | null;
+export declare function GenuiPanel({ sessionId, sendGenuiAction, insertTemplate, fileLinkContext }: GenuiPanelProps): import("react").JSX.Element | null;

package/lib/types/client/spec.d.ts

@@ -372,17 +372,13 @@ export interface GenuiRadio {
     /** v2.6: per-question explanation shown after local grading. */
     explanation?: string;
 }
-/** Submit node: collects sibling `radio` and grouped `checkbox` answers in
- * this block. LOCAL-FIRST grading still applies to radio-only question scopes;
- * aggregation scopes can emit strings for radio groups and string arrays for
- * checkbox groups in the same `answers` object. */
+/** 提交节点收集当前 block 的答案和字段值；纯 radio 范围可在本地判卷。 */
 export interface GenuiSubmit {
     type: 'submit';
     label: string;
     /**
-     * Optional action name. Local-first: when the in-scope questions can be
-     * graded entirely locally, no action is needed. Aggregation submits require
-     * an action and emit `{type:'submit', answers, total, answered}`.
+     * 可选 action 名称。纯 radio 范围满足本地判卷条件时无需 action；其他提交
+     * 通过 action 发送 `answers`、可选的 `fields`、`total` 和 `answered`。
      */
     action?: string;
     /**
@@ -392,10 +388,11 @@ export interface GenuiSubmit {
      */
     resetAction?: string;
     /**
-     * Optional explicit group list to wait for; when absent the submit enables
-     * once at least one grouped answer (or filled field) exists. When present
-     * it stays disabled until EVERY listed radio/checkbox group has a non-empty
-     * recorded answer (the hint shows the progress).
+     * `groups` 引用当前 block 中的 submission member key，来源为 radio.group、
+     * checkbox.group 以及 input/textarea/select/slider.id。radio 需已选择，
+     * checkbox 需至少选择一项，普通 field 需在 trim 后非空。`groups` 控制提交
+     * 所需成员与完成进度；payload 仍收集当前 block 中已填写的表单状态。
+     * 未设置时，只要存在至少一个已完成成员即可提交。
      */
     groups?: string[];
 }

package/lib/types/client/submission-registry.d.ts

@@ -0,0 +1,51 @@
+import type { GenuiSpec } from './spec.ts';
+export type SubmissionMember = RadioSubmissionMember | CheckboxSubmissionMember | FieldSubmissionMember;
+export interface RadioSubmissionMember {
+    kind: 'radio';
+    key: string;
+    label: string;
+    options: string[];
+    answer?: number | string;
+    explanation?: string;
+}
+export interface CheckboxSubmissionMember {
+    kind: 'checkbox';
+    key: string;
+}
+export interface FieldSubmissionMember {
+    kind: 'field';
+    key: string;
+    fieldType: 'input' | 'textarea' | 'select' | 'slider';
+    secret: boolean;
+}
+export interface SubmissionRegistry {
+    members: ReadonlyMap<string, SubmissionMember>;
+}
+export interface SubmitInteractionState {
+    answers: Record<string, string>;
+    multiAnswers: Record<string, string[]>;
+    fields: Record<string, string>;
+    secretFields: ReadonlySet<string>;
+}
+export interface ResolvedSubmitState {
+    scope: SubmissionMember[];
+    answered: number;
+    total: number;
+    localGradeEligible: boolean;
+    hasOutOfScopePayload: boolean;
+}
+/** 从 spec 建立成员表，并诊断 submission key 和 submit.groups。 */
+export declare function analyzeSubmissionRegistry(spec: GenuiSpec): {
+    registry: SubmissionRegistry;
+    diagnostics: string[];
+};
+/** 编译供运行时读取的静态 submission 成员表。 */
+export declare function compileSubmissionRegistry(spec: GenuiSpec): SubmissionRegistry;
+/** 根据当前交互状态判断一个 submission member 是否完成。 */
+export declare function isSubmissionMemberAnswered(member: SubmissionMember, state: SubmitInteractionState): boolean;
+/** 计算 submit 进度和纯本地判卷条件。 */
+export declare function resolveSubmitState({ registry, groups, state }: {
+    registry: SubmissionRegistry;
+    groups?: string[];
+    state: SubmitInteractionState;
+}): ResolvedSubmitState;

package/lib/types/client/table-details.d.ts

@@ -0,0 +1,20 @@
+/** 保存 repair 所需的原始 table 字段。 */
+export interface TableDetailSource {
+    columns?: unknown;
+    rows?: unknown;
+    data?: unknown;
+    types?: unknown;
+}
+/** 保存 repair 后的 table 列和行。 */
+export interface PreparedTableRows {
+    columns: string[];
+    rows: Array<Array<string | number>>;
+}
+/** 使用 table repair 相同的转换规则处理列和行。 */
+export declare function prepareTableRows(table: TableDetailSource): PreparedTableRows | null;
+/** 返回 repair 后可显示详情的 table 行。 */
+export declare function tableRowsForDetails<Row = unknown>(table: TableDetailSource): Row[];
+/** 按照 table renderer 的规则识别分组标题行。 */
+export declare function isTableGroupHeaderRow(row: unknown, types: unknown): boolean;
+/** 判断详情索引对应的行是否可展开并显示。 */
+export declare function isTableDetailReachable(table: TableDetailSource, rowIndex: number): boolean;

package/lib/types/client/walk-spec.d.ts

@@ -0,0 +1,3 @@
+import type { GenuiNode, GenuiSpec } from './spec.ts';
+/** 遍历完整 GenUI 组件树，并提供每个组件在 spec 中的路径。 */
+export declare function walkGenuiNodes(spec: GenuiSpec, visitor: (node: GenuiNode, path: string) => void): void;

package/lib/types/plugin/fence-feedback.d.ts

@@ -8,8 +8,10 @@
  *
  * The loop is deliberately narrow, matching the contract agreed on the issue:
  * - **默认开启。** 插件配置中的 `fenceFeedback: false` 可以关闭回合转向。
- * - **Bounded.** At most one correction per turn AND at most one per fence
- *   body per process, so a correction that is itself wrong cannot loop.
+ * - **修正上限。** 每个 turn 最多发送两条 correction；render failure 和 delivery reminder 共用上限，
+ *   每个 fence body 在当前回合中最多修正一次，新回合可重新修正。
+ * - **仅含 reasoning 的恢复。** 已验证的 GenUI 回合若只以 reasoning block 结束，使用宿主的
+ *   `EMPTY_RESPONSE` retry policy。
  * - **Never for subagents.** A child session's fence belongs to a parent reply.
  * - **Exact fence matching.** Only an info string of exactly `dsh-ui` opens a
  *   fence, so ` ```dsh-ui-dark `, indented prose, or a mention of the name is
@@ -28,6 +30,11 @@ import type { UserMessage } from '@deepseek-ai/dsh-session';
 export declare const FEEDBACK_PLUGIN_NAME = "@changfenhuang/dsh-genui";
 /** Source kind persisted by this plugin in Session format v4. */
 export declare const FEEDBACK_SOURCE_KIND: "plugin:@changfenhuang/dsh-genui";
+/**
+ * 同一个 turn 内 fence-feedback correction 的共享上限。
+ * Render failure 和 nothing-delivered reminder 共用该 budget；各自的 ledger 独立阻止重复修正。
+ */
+export declare const MAX_CORRECTIONS_PER_TURN = 2;
 /** One ```dsh-ui fence found in an assistant reply. */
 export interface ExtractedFence {
     /** Raw body between the fences (no delimiters). */
@@ -82,31 +89,67 @@ export declare function fenceCorrectionText(failures: readonly FenceFailure[]):
 export declare function createFeedbackMessage(text: string, sessionFormatVersion: number): UserMessage;
 /** What the pure planner needs to decide whether a correction may be sent. */
 export interface FenceFeedbackPlanInput {
+    /** Latest assistant reply text of the current turn. */
     readonly text: string;
     readonly turn: number;
-    readonly lastCorrectedTurn: number | undefined;
-    readonly corrected: ReadonlySet<string>;
+    /** Fence bodies already corrected for a render failure in the current turn. */
+    readonly correctedSpec: ReadonlySet<string>;
+    /** Turns already given the delivery reminder. */
+    readonly deliveryRemindedTurns?: ReadonlySet<number> | undefined;
+    /** A `validate_dsh_ui` call happened this turn (formal GenUI signal). */
+    readonly validatedThisTurn?: boolean | undefined;
+    /** The turn already delivered a body or a successful `render_ui` result. */
+    readonly deliveredThisTurn?: boolean | undefined;
     readonly aborted: boolean;
+    /** Corrections already steered in this turn (shared hard cap). */
+    readonly correctionsThisTurn?: number | undefined;
+    /** Turn {@link correctionsThisTurn} counts (stale counts are ignored). */
+    readonly correctionsTurn?: number | undefined;
+    /** Whether the host has registered the `render_ui` tool. Defaults to enabled. */
+    readonly renderUiToolEnabled?: boolean | undefined;
 }
 /** A correction the caller must account for before steering. */
 export interface FenceFeedbackPlan {
     readonly text: string;
     readonly fingerprints: readonly string[];
     readonly turn: number;
+    /**
+     * `render` corrects a fence that failed to resolve; `delivery` reminds the
+     * model that the turn produced nothing formal. They share the per-turn budget
+     * but keep separate ledgers.
+     */
+    readonly kind: 'render' | 'delivery';
 }
 /**
- * Decide whether this turn boundary should steer a fence correction — the pure
- * core of the loop, so every bound (one per turn, one per fence, cancellation)
- * is testable without a host.
+ * Decide whether this turn boundary should steer a correction — the pure core of
+ * the loop, so every bound (per-turn cap, per-fence ledger, cancellation) is
+ * testable without a host.
  *
- * @param input - reply text, turn identity, and the session's accounting.
+ * The decision is driven by FORMAL events only: fences in the reply body, a
+ * `validate_dsh_ui` call, a delivered body text or a successful `render_ui`
+ * result. The reasoning block is
+ * never read here — a draft inside the thinking block is not proof that the model
+ * chose to deliver it, so it must not change any decision.
+ *
+ * @param input - reply text, turn identity, formal signals, and the accounting.
  * @returns the correction to send, or null when the loop must stay silent.
  */
 export declare function planFenceFeedback(input: FenceFeedbackPlanInput): FenceFeedbackPlan | null;
 /**
- * 根据插件配置启用围栏反馈流程。
+ * Correction for a validated GenUI turn that reached the boundary without any
+ * formal delivery.
+ *
+ * @param turn - turn that reached the boundary.
+ * @param attempt - correction number within the shared turn budget.
+ * @param renderUiToolEnabled - whether the correction may recommend `render_ui`.
+ * @returns the message text to steer into the running turn.
+ */
+export declare function missingBodyCorrectionText(turn: number, attempt?: number, renderUiToolEnabled?: boolean): string;
+/**
+ * 注册 GenUI 回合跟踪、宿主重试判定和可选的围栏修正流程。
  *
- * @param ctx - the host context.
- * @param enabled - the plugin config flag; the loop is inert when false.
+ * @param ctx - 宿主 Context。
+ * @param enabled - 是否启用同回合围栏修正。
+ * @param renderUiToolEnabled - 是否已注册 `render_ui` 工具。
  */
-export declare function installFenceFeedback(ctx: Context, enabled: boolean): void;
+export declare function installFenceFeedback(ctx: Context, enabled: boolean, renderUiToolEnabled?: boolean): void;

package/lib/types/plugin/index.d.ts

@@ -13,7 +13,7 @@ import { Context } from '@deepseek-ai/cordis';
  *  Deliberately slim: the `genui` skill carries the full component→field
  *  mapping; this section keeps only the contract that must always be
  *  present (fence syntax, type whitelist, and critical behavioral rules). */
-export declare const GENUI_SECTION_TEXT = "You can render interactive UI components INSIDE your reply \u2014 between paragraphs \u2014 by emitting a fenced block with the language tag `dsh-ui` containing a JSON spec:\n\n```dsh-ui\n{\"title\":\"<user-language text>\",\"gap\":14,\"items\":[...]}\n```\n\nAllowed `type` values; the `genui` skill, when available, carries the full content\u2192component mapping and per-component field details:\n\n- \u5E03\u5C40: text \u00B7 row \u00B7 col \u00B7 grid \u00B7 card \u00B7 divider \u00B7 spacer \u00B7 hero\uFF08\u5C01\u9762\u5757\uFF0C\u4E00\u6761\u56DE\u7B54\u6700\u591A\u4E00\u4E2A\uFF09\n- \u5C55\u793A: badge \u00B7 stat \u00B7 progress \u00B7 list \u00B7 table \u00B7 keyvalue \u00B7 timeline \u00B7 file-tree \u00B7 breadcrumb \u00B7 callout \u00B7 steps \u00B7 diff \u00B7 json \u00B7 code \u00B7 copy \u00B7 avatar \u00B7 audio \u00B7 video\n- \u56FE\u8868: chart {\"kind\":\"bars|line|donut\",\"data\":[{\"label\":\"...\",\"value\":n}],\"series\":[{\"label\":\"...\",\"data\":[...]}]?,\"horizontal\":true?,\"stacked\":true?}\uFF08series\uFF1Abars \u5206\u7EC4/\u5806\u53E0 / line \u591A\u5E8F\u5217\uFF1Bhorizontal \u6A2A\u5411\u67F1\uFF09 \u00B7 echart (preset \u540D\u6216 option \u76F4\u901A\uFF0C\u9884\u8BBE\u6E05\u5355\u89C1 skill) \u00B7 plot (\u51FD\u6570\u56FE)\n- \u4EA4\u4E92: button \u00B7 input \u00B7 textarea \u00B7 select \u00B7 checkbox \u00B7 switch \u00B7 slider \u00B7 radio \u00B7 submit \u00B7 quiz \u00B7 link \u00B7 tabs \u00B7 accordion\n- \u9AD8\u7EA7: mermaid (\u6D41\u7A0B\u56FE/\u65F6\u5E8F/\u7518\u7279/ER \u7B49\uFF0C\u5173\u952E\u5B57\u89C1 skill) \u00B7 diagram (\u67B6\u6784/\u6D41\u7A0B\u56FE\uFF0C27 \u79CD kind) \u00B7 scene3d (3D WebGL)\n\n**\u9ED8\u8BA4\u5C31\u8BE5\u51FA UI**\uFF1A\u51FA\u73B0\u4E0B\u5217\u60C5\u51B5\u81F3\u5C11\u51FA\u4E00\u4E2A\u56F4\u680F\uFF1A\n- \u22653 \u6761\u5E76\u5217\u8981\u70B9 \u2192 `list`\uFF1B\u6570\u5B57\u5BF9\u6BD4 \u2192 `table`\uFF1B\u6307\u6807/\u8FDB\u5EA6/\u72B6\u6001 \u2192 `stat`/`progress`/`badge`\n- \u6B65\u9AA4/\u65F6\u95F4\u7EBF \u2192 `steps`/`timeline`/`mermaid`\uFF1B\u67B6\u6784/\u6D41\u7A0B \u2192 `diagram` \u6216 `mermaid`\uFF1B\u98CE\u9669/\u7ED3\u8BBA \u2192 `callout`\uFF1B\u4EE3\u7801/\u6539\u52A8 \u2192 `code`/`diff`/`json`\n- \u884C\u5185\u5BCC\u6587\u672C\uFF1A\u652F\u6301\u516C\u5F0F\u3001`code`\u3001\u52A0\u7C97\u3001\u9AD8\u4EAE\u3001\u94FE\u63A5\uFF1B\u7981\u7528 Markdown table / fenced code\uFF0C\u6539\u7528 table / code / diff / json\u3002\n- \u9ED8\u8BA4\u65E0\u5361\uFF1A\u6309\u89E6\u53D1\u6761\u4EF6\u4F7F\u7528\u7EC4\u4EF6\uFF0C\u6BCF\u4E2A\u7EC4\u4EF6\u627F\u8F7D\u4E0D\u540C\u4FE1\u606F\uFF1B\u5361\u7247\u53EA\u7528\u4E8E\u5E76\u6392\u9879\u4E0E\u6570\u636E\u5BF9\u8C61\uFF0C\u5355\u6BB5\u6587\u5B57\u7528\u6807\u9898\u3001\u6B63\u6587\u4E0E\u95F4\u8DDD\u3002\n\n**\u53D1\u56DE\u7B54\u524D\u6700\u540E\u81EA\u68C0\u4E00\u6B21**\uFF1A\u8FD9\u6BB5\u5185\u5BB9\u91CC\u6709\u6CA1\u6709 \u22653 \u6761\u5E76\u5217\u8981\u70B9\u3001\u4EFB\u4F55\u5BF9\u6BD4\u3001\u4EFB\u4F55\u6570\u5B57/\u6307\u6807\u3001\u4EFB\u4F55\u6B65\u9AA4\u6216\u6D41\u7A0B\uFF1F\u6709\u5C31\u5148\u8F6C\u6210\u7EC4\u4EF6\u518D\u5F00\u53E3\u3002**\u72B6\u6001\u6C47\u62A5\u3001\u8FDB\u5EA6\u8BF4\u660E\u3001\u63D0\u4EA4\u4E0E\u6539\u52A8\u6E05\u5355\u540C\u6837\u7B97**\u3002\n- \u8D8B\u52BF/\u5360\u6BD4 \u2192 `chart`\uFF08\u22648 \u70B9\uFF09\u6216 `echart`\uFF08\u591A\u5E8F\u5217/\u8981\u4EA4\u4E92\u65F6\uFF09\uFF1B\u914D\u8272\u9ED8\u8BA4\u8DDF\u968F\u4E3B\u9898\uFF0C\u53EA\u6709\u8BED\u4E49\u9700\u8981\u65F6\u624D\u7528 `palette`/`card.accent`\uFF1Bgrid \u5B50\u8282\u70B9\u7528 `\"span\":2` \u8DE8\u5217\u505A\u5BBD\u7A84\u6DF7\u6392\uFF1B\u6570\u636E\u591A\u65F6\u7ED9 `table`/`chart`/`list` \u914D\u4E00\u4E2A `input`(id) + `filter` \u7ED1\u5B9A\uFF0C\u8BFB\u8005\u80FD\u5C31\u5730\u7B5B\u9009\u3002\n\n**\u5B57\u6BB5\u901F\u67E5**\uFF08\u5B8C\u6574\u89C1 genui skill\uFF09\uFF1A`stat` `{\"label\",\"value\",\"delta\"?}` \u00B7 `table` `{\"columns\":[...],\"rows\":[[...]],\"types\"?,\"details\"?,\"filter\"?,\"export\"?}` \u00B7 `progress` `{\"value\":0-100,\"label\"?,\"variant\"?,\"target\"?}` \u00B7 `keyvalue` `{\"pairs\":[{\"key\",\"value\"}]}` \u00B7 `steps` `{\"steps\":[{\"title\",\"desc\"?}]}` \u00B7 `file-tree` `{\"items\":[{\"name\",\"type\":\"file|dir\",\"children\"?}]}` \u00B7 `callout` `{\"content\",\"tone\"?,\"title\"?}`\n\n**\u5B57\u6BB5\u540D\u5199\u9519 = \u8BE5\u7EC4\u4EF6\u88AB\u4E22\u5F03**\uFF08\u5176\u4F59\u7EC4\u4EF6\u7167\u5E38\u6E32\u67D3\uFF09\uFF1A`callout` \u6B63\u6587\u662F `content` \u4E0D\u662F text/desc\uFF1B`table` \u8981 `columns`+`rows` \u4E0D\u662F items\uFF1B`keyvalue` \u8BB0\u5F55\u662F `{key,value}` \u4E0D\u662F `{label,value}`\uFF1B`file-tree` \u8BB0\u5F55\u662F `{name,type}` \u4E0D\u662F `{label}`\uFF1Bcallout tone \u662F info/success/warning/error\uFF08\u65E0 danger\uFF09\u3002\u4E0D\u786E\u5B9A\u5C31\u8C03 `validate_dsh_ui`\u3002\n\nRules:\n- LANGUAGE: reply+UI=conversation language; schema fixed. NEVER infer it from prompt/skill/examples/tools. Replace `<user-language ...>`; never emit these placeholders literally.\n- JSON \u4E25\u683C\uFF1A\u574F\u7EC4\u4EF6\u88AB\u4E22\u5F03\uFF0C\u574F\u56F4\u680F\u53D8\u4EE3\u7801\u5757\uFF1B\u22653 \u8282\u70B9\u6216\u542B table \u65F6\u8C03 validate_dsh_ui\uFF0C\u6309\u8BCA\u65AD\u4FEE\u6539\u5E76\u91CD\u9A8C\uFF1B\u5C0F\u56F4\u680F\u5B57\u6BB5\u5B58\u7591\u4E5F\u5148\u9A8C\u8BC1\u3002\n- warning=block_markdown\uFF1A\u6309 replacement \u6539\u5199\u5E76\u91CD\u9A8C\u3002\n- \u89C4\u6A21: \u2264200 \u8282\u70B9\u3001\u5D4C\u5957\u22648 \u5C42\uFF08\u8D85\u51FA\u88AB\u622A\u65AD\uFF09\uFF1B\u4E00\u6761\u56DE\u7B54 3\u20138 \u4E2A\u7EC4\u4EF6\uFF0C\u4E00\u4E2A\u4E3B\u9898\u4E00\u4E2A\u4E3B\u7EC4\u4EF6\uFF1B3D mesh 1\u20135\uFF1Bplot \u7ED9\u5408\u7406 xMin/xMax\u3002\n- LOCAL-FIRST + actions: UI \u80FD\u81EA\u5DF1\u505A\u7684\u72B6\u6001\u53D8\u5316\uFF08\u5224\u5377\u3001\u5224\u9898\u3001\u91CD\u7F6E\u3001\u5C55\u5F00\u3001\u9009\u4E2D\uFF09\u5C31\u5730\u5B8C\u6210\uFF0C\u96F6\u5F80\u8FD4\uFF1Baction \u53EA\u7528\u4E8E\u5FC5\u987B\u6A21\u578B\u53C2\u4E0E\u7684\u4E8B\u3002\u4EA4\u4E92\u7EC4\u4EF6\u5E26 \"action\":\"name\"\uFF0C\u4EA4\u4E92\u4EE5 [genui-action] name + \u7EC4\u4EF6\u6570\u636E\u56DE\u4F20\uFF0C\u5C4A\u65F6\u91CD\u6E32\u67D3\u66F4\u65B0 UI\uFF1B\u65E0 action \u7684\u6309\u94AE\u7981\u7528\u3002\n- Durable state: \u4EA4\u4E92\u72B6\u6001\u6309\u300C\u4F1A\u8BDD+\u5185\u5BB9\u6307\u7EB9\u300D\u6301\u4E45\u5316\u2014\u2014\u5237\u65B0/\u91CD\u653E\u6062\u590D\uFF1B\u91CD\u6E32\u67D3\u76F8\u540C\u5185\u5BB9\u4FDD\u7559\uFF0C\u65B0\u5185\u5BB9\u91CD\u7F6E\u3002\n- \u5377\u5B50\u6A21\u5F0F: \u6BCF\u9898\u4E00\u4E2A radio\uFF08group+answer+explanation\uFF09+ \u4E00\u4E2A submit\uFF08groups \u5168\u5217\uFF09\uFF0C\u672C\u5730\u5224\u5206\u3002\n- Secrets ban: \u4E0D\u7D22\u53D6\u5BC6\u7801\u3001API Key\u3001Token\u3001\u6062\u590D\u7801\uFF1B\u9700\u8981\u65F6\u62D2\u7EDD\u5E76\u89E3\u91CA\u3002\n- Tool channel: render_ui \u5DE5\u5177\u628A\u540C\u4E00 spec \u6E32\u67D3\u4E3A\u5DE5\u5177\u884C\u5361\u7247\uFF08\u4EA4\u4ED8\u7269\u578B\u754C\u9762\u7528\uFF09\uFF1B\u56F4\u680F\u7528\u4E8E\u56DE\u7B54\u5185\u8054 UI\u3002\n- Panel: \"panel\":true \u53EA\u6E32\u67D3\u8FDB\u4F1A\u8BDD\u9762\u677F dock \u5E76\u539F\u5730\u66F4\u65B0\uFF1B\"append\":true \u8FFD\u52A0\u5408\u5E76\uFF08\u540C\u6807\u7B7E tabs \u8FFD\u52A0/\u65B0\u6807\u7B7E\u52A0\u5165/\u5C3E\u90E8\u8FFD\u52A0\uFF09\uFF1B\u4E0A\u9650 200 \u8282\u70B9/200 \u6B21\u8FFD\u52A0\uFF0C\u6EE1\u4E86\u53D1 replace \u91CD\u5EFA\u3002\u9762\u677F\u7EC4\u4EF6\u6765\u7684 [genui-action] \u53EA\u56DE\u4E00\u4E2A panel:true \u56F4\u680F + \u81F3\u591A\u4E00\u884C 10 \u5B57\u5185\u786E\u8BA4\uFF0C\u4E0D\u89E3\u91CA\u3001\u4E0D\u7528\u666E\u901A\u56F4\u680F\u3002";
+export declare const GENUI_SECTION_TEXT = "You can render interactive UI components INSIDE your reply \u2014 between paragraphs \u2014 by emitting a fenced block with the language tag `dsh-ui` containing a JSON spec:\n\n```dsh-ui\n{\"title\":\"<user-language text>\",\"gap\":14,\"items\":[...]}\n```\n\nAllowed `type` values; the `genui` skill, when available, carries the full content\u2192component mapping and per-component field details:\n\n- \u5E03\u5C40: text \u00B7 row \u00B7 col \u00B7 grid \u00B7 card \u00B7 divider \u00B7 spacer \u00B7 hero\uFF08\u5C01\u9762\u5757\uFF0C\u4E00\u6761\u56DE\u7B54\u6700\u591A\u4E00\u4E2A\uFF09\n- \u5C55\u793A: badge \u00B7 stat \u00B7 progress \u00B7 list \u00B7 table \u00B7 keyvalue \u00B7 timeline \u00B7 file-tree \u00B7 breadcrumb \u00B7 callout \u00B7 steps \u00B7 diff \u00B7 json \u00B7 code \u00B7 copy \u00B7 avatar \u00B7 audio \u00B7 video\n- \u56FE\u8868: chart {\"kind\":\"bars|line|donut\",\"data\":[{\"label\":\"...\",\"value\":n}],\"series\":[{\"label\":\"...\",\"data\":[...]}]?,\"horizontal\":true?,\"stacked\":true?}\uFF08series\uFF1Abars \u5206\u7EC4/\u5806\u53E0 / line \u591A\u5E8F\u5217\uFF1Bhorizontal \u6A2A\u5411\u67F1\uFF09 \u00B7 echart (preset \u540D\u6216 option \u76F4\u901A\uFF0C\u9884\u8BBE\u6E05\u5355\u89C1 skill) \u00B7 plot (\u51FD\u6570\u56FE)\n- \u4EA4\u4E92: button \u00B7 input \u00B7 textarea \u00B7 select \u00B7 checkbox \u00B7 switch \u00B7 slider \u00B7 radio \u00B7 submit \u00B7 quiz \u00B7 link \u00B7 tabs \u00B7 accordion\n- \u9AD8\u7EA7: mermaid (\u6D41\u7A0B\u56FE/\u65F6\u5E8F/\u7518\u7279/ER \u7B49\uFF0C\u5173\u952E\u5B57\u89C1 skill) \u00B7 diagram (\u67B6\u6784/\u6D41\u7A0B\u56FE\uFF0C27 \u79CD kind) \u00B7 scene3d (3D WebGL)\n\n**\u9ED8\u8BA4\u5C31\u8BE5\u51FA UI**\uFF1A\u51FA\u73B0\u4E0B\u5217\u60C5\u51B5\u81F3\u5C11\u51FA\u4E00\u4E2A\u56F4\u680F\uFF1A\n- \u22653 \u6761\u5E76\u5217\u8981\u70B9 \u2192 `list`\uFF1B\u6570\u5B57\u5BF9\u6BD4 \u2192 `table`\uFF1B\u6307\u6807/\u8FDB\u5EA6/\u72B6\u6001 \u2192 `stat`/`progress`/`badge`\n- \u6B65\u9AA4/\u65F6\u95F4\u7EBF \u2192 `steps`/`timeline`/`mermaid`\uFF1B\u67B6\u6784/\u6D41\u7A0B \u2192 `diagram` \u6216 `mermaid`\uFF1B\u98CE\u9669/\u7ED3\u8BBA \u2192 `callout`\uFF1B\u4EE3\u7801/\u6539\u52A8 \u2192 `code`/`diff`/`json`\n- \u884C\u5185\u5BCC\u6587\u672C\uFF1A\u652F\u6301\u516C\u5F0F\u3001`code`\u3001\u52A0\u7C97\u3001\u9AD8\u4EAE\u3001\u94FE\u63A5\uFF1B\u7981\u7528 Markdown table / fenced code\uFF0C\u6539\u7528 table / code / diff / json\u3002\n- \u9ED8\u8BA4\u65E0\u5361\uFF1A\u6309\u89E6\u53D1\u6761\u4EF6\u4F7F\u7528\u7EC4\u4EF6\uFF0C\u6BCF\u4E2A\u7EC4\u4EF6\u627F\u8F7D\u4E0D\u540C\u4FE1\u606F\uFF1B\u5361\u7247\u53EA\u7528\u4E8E\u5E76\u6392\u9879\u4E0E\u6570\u636E\u5BF9\u8C61\uFF0C\u5355\u6BB5\u6587\u5B57\u7528\u6807\u9898\u3001\u6B63\u6587\u4E0E\u95F4\u8DDD\u3002\n\n**\u53D1\u56DE\u7B54\u524D\u6700\u540E\u81EA\u68C0\u4E00\u6B21**\uFF1A\u8FD9\u6BB5\u5185\u5BB9\u91CC\u6709\u6CA1\u6709 \u22653 \u6761\u5E76\u5217\u8981\u70B9\u3001\u4EFB\u4F55\u5BF9\u6BD4\u3001\u4EFB\u4F55\u6570\u5B57/\u6307\u6807\u3001\u4EFB\u4F55\u6B65\u9AA4\u6216\u6D41\u7A0B\uFF1F\u6709\u5C31\u5148\u8F6C\u6210\u7EC4\u4EF6\u518D\u5F00\u53E3\u3002**\u72B6\u6001\u6C47\u62A5\u3001\u8FDB\u5EA6\u8BF4\u660E\u3001\u63D0\u4EA4\u4E0E\u6539\u52A8\u6E05\u5355\u540C\u6837\u7B97**\u3002\n- \u8D8B\u52BF/\u5360\u6BD4 \u2192 `chart`\uFF08\u22648 \u70B9\uFF09\u6216 `echart`\uFF08\u591A\u5E8F\u5217/\u8981\u4EA4\u4E92\u65F6\uFF09\uFF1B\u914D\u8272\u9ED8\u8BA4\u8DDF\u968F\u4E3B\u9898\uFF0C\u53EA\u6709\u8BED\u4E49\u9700\u8981\u65F6\u624D\u7528 `palette`/`card.accent`\uFF1Bgrid \u5B50\u8282\u70B9\u7528 `\"span\":2` \u8DE8\u5217\u505A\u5BBD\u7A84\u6DF7\u6392\uFF1B\u6570\u636E\u591A\u65F6\u7ED9 `table`/`chart`/`list` \u914D\u4E00\u4E2A `input`(id) + `filter` \u7ED1\u5B9A\uFF0C\u8BFB\u8005\u80FD\u5C31\u5730\u7B5B\u9009\u3002\n\n**\u5B57\u6BB5\u901F\u67E5**\uFF08\u5B8C\u6574\u89C1 genui skill\uFF09\uFF1A`stat` `{\"label\",\"value\",\"delta\"?}` \u00B7 `table` `{\"columns\":[...],\"rows\":[[...]],\"types\"?,\"details\"?,\"filter\"?,\"export\"?}` \u00B7 `progress` `{\"value\":0-100,\"label\"?,\"variant\"?,\"target\"?}` \u00B7 `keyvalue` `{\"pairs\":[{\"key\",\"value\"}]}` \u00B7 `steps` `{\"steps\":[{\"title\",\"desc\"?}]}` \u00B7 `file-tree` `{\"items\":[{\"name\",\"type\":\"file|dir\",\"children\"?}]}` \u00B7 `callout` `{\"content\",\"tone\"?,\"title\"?}`\n\n**\u5B57\u6BB5\u540D\u5199\u9519 = \u8BE5\u7EC4\u4EF6\u88AB\u4E22\u5F03**\uFF08\u5176\u4F59\u7EC4\u4EF6\u7167\u5E38\u6E32\u67D3\uFF09\uFF1A`callout` \u6B63\u6587\u662F `content` \u4E0D\u662F text/desc\uFF1B`table` \u8981 `columns`+`rows` \u4E0D\u662F items\uFF1B`keyvalue` \u8BB0\u5F55\u662F `{key,value}` \u4E0D\u662F `{label,value}`\uFF1B`file-tree` \u8BB0\u5F55\u662F `{name,type}` \u4E0D\u662F `{label}`\uFF1Bcallout tone \u662F info/success/warning/error\uFF08\u65E0 danger\uFF09\u3002\u4E0D\u786E\u5B9A\u5C31\u8C03 `validate_dsh_ui`\u3002\n\nRules:\n- LANGUAGE: reply+UI=conversation language; schema fixed. NEVER infer it from prompt/skill/examples/tools. Replace `<user-language ...>`; never emit these placeholders literally.\n- JSON \u4E25\u683C\uFF1A\u574F\u7EC4\u4EF6\u88AB\u4E22\u5F03\uFF0C\u574F\u56F4\u680F\u53D8\u4EE3\u7801\u5757\uFF1B\u22653 \u8282\u70B9\u6216\u542B table \u65F6\u8C03 validate_dsh_ui\uFF0C\u6309\u8BCA\u65AD\u4FEE\u6539\u5E76\u91CD\u9A8C\uFF1B\u5C0F\u56F4\u680F\u5B57\u6BB5\u5B58\u7591\u4E5F\u5148\u9A8C\u8BC1\u3002\n- warning=block_markdown\uFF1A\u6309 replacement \u6539\u5199\u5E76\u91CD\u9A8C\u3002\n- \u89C4\u6A21: \u2264200 \u8282\u70B9\u3001\u5D4C\u5957\u22648 \u5C42\uFF08\u8D85\u51FA\u88AB\u622A\u65AD\uFF09\uFF1B\u4E00\u6761\u56DE\u7B54 3\u20138 \u4E2A\u7EC4\u4EF6\uFF0C\u4E00\u4E2A\u4E3B\u9898\u4E00\u4E2A\u4E3B\u7EC4\u4EF6\uFF1B3D mesh 1\u20135\uFF1Bplot \u7ED9\u5408\u7406 xMin/xMax\u3002\n- LOCAL-FIRST + actions: UI \u80FD\u81EA\u5DF1\u505A\u7684\u72B6\u6001\u53D8\u5316\uFF08\u5224\u5377\u3001\u5224\u9898\u3001\u91CD\u7F6E\u3001\u5C55\u5F00\u3001\u9009\u4E2D\uFF09\u5C31\u5730\u5B8C\u6210\uFF0C\u96F6\u5F80\u8FD4\uFF1Baction \u53EA\u7528\u4E8E\u5FC5\u987B\u6A21\u578B\u53C2\u4E0E\u7684\u4E8B\u3002\u4EA4\u4E92\u4EE5 [genui-action] name + \u7EC4\u4EF6\u6570\u636E\u56DE\u4F20\uFF0C\u5C4A\u65F6\u91CD\u6E32\u67D3\u66F4\u65B0 UI\uFF1B\u65E0 action \u7684\u6309\u94AE\u7981\u7528\u3002\n- Durable state: \u4EA4\u4E92\u72B6\u6001\u6309\u300C\u4F1A\u8BDD+\u5185\u5BB9\u6307\u7EB9\u300D\u6301\u4E45\u5316\u2014\u2014\u5237\u65B0/\u91CD\u653E\u6062\u590D\uFF1B\u76F8\u540C\u5185\u5BB9\u4FDD\u7559\uFF0C\u65B0\u5185\u5BB9\u91CD\u7F6E\u3002\n- \u5377\u5B50\u6A21\u5F0F: \u6BCF\u9898\u4E00\u4E2A radio\uFF08group+answer+explanation\uFF09+ \u4E00\u4E2A submit\uFF08groups \u5168\u5217\uFF09\uFF0C\u672C\u5730\u5224\u5206\u3002\n- Secrets ban: \u4E0D\u7D22\u53D6\u5BC6\u7801\u3001API Key\u3001Token\u3001\u6062\u590D\u7801\uFF1B\u9700\u8981\u65F6\u62D2\u7EDD\u5E76\u89E3\u91CA\u3002\n- Tool channel: render_ui \u5DE5\u5177\u628A\u540C\u4E00 spec \u6E32\u67D3\u4E3A\u5DE5\u5177\u884C\u5361\u7247\uFF1B\u56F4\u680F\u7528\u4E8E\u56DE\u7B54\u5185\u8054 UI\u3002\n- \u56F4\u680F\u4F4D\u7F6E\uFF1A`dsh-ui` \u53EA\u5199\u5728**\u56DE\u7B54\u6B63\u6587**\uFF1B\u5199\u5728 reasoning/\u601D\u8003\u5757\u91CC\u4E0D\u6E32\u67D3\u3001\u7528\u6237\u770B\u4E0D\u5230\u2014\u2014\u601D\u8003\u91CC\u9A8C\u8BC1\u597D spec\uFF0C\u6B63\u6587\u518D\u8F93\u51FA\u540C\u4E00\u4EFD\u3002\n- Panel: \"panel\":true \u53EA\u6E32\u67D3\u8FDB\u4F1A\u8BDD\u9762\u677F dock \u5E76\u539F\u5730\u66F4\u65B0\uFF1B\"append\":true \u8FFD\u52A0\u5408\u5E76\uFF1B\u4E0A\u9650 200 \u8282\u70B9/200 \u6B21\u8FFD\u52A0\uFF0C\u6EE1\u4E86\u53D1 replace \u91CD\u5EFA\u3002\u9762\u677F\u6765\u7684 [genui-action] \u53EA\u56DE\u4E00\u4E2A panel:true \u56F4\u680F + \u81F3\u591A\u4E00\u884C 10 \u5B57\u5185\u786E\u8BA4\u3002";
 /**
  * Register the GenUI output-language section and the render_ui tool.
  * @param ctx - cordis context.
@@ -27,9 +27,13 @@ export declare const inject: string[];
 export interface GenuiPluginConfig {
     /**
      * 在最终 dsh-ui 围栏无法渲染的回合中请求模型发送一次修正版（issue #160）。
-     * 默认开启，设置为 false 可以关闭。每回合和每个围栏正文最多请求一次，子代理不触发，
-     * 每次请求会消耗模型步数。
+     * 默认开启，设置为 false 可以关闭同回合围栏修正。GenUI 回合的 reasoning-only 响应仍会交给宿主重试策略处理。
+     * 每回合和每个围栏正文最多请求一次，子代理不触发，每次修正请求会消耗模型步数。
      */
     fenceFeedback?: boolean;
+    /**
+     * 是否注册 render_ui 模型工具。默认开启，设置为 false 时关闭；不影响 validate_dsh_ui 和 dsh-ui 围栏渲染。
+     */
+    renderUiTool?: boolean;
 }
 export declare function apply(ctx: Context, config?: GenuiPluginConfig): void;

package/lib/types/shared/fence-repair.d.ts

@@ -31,12 +31,12 @@ export declare function describeJsonFailure(raw: string): string | null;
  *    with ASCII quotes (e.g. `对"别名路径"判定失败`), which makes JSON.parse
  *    fail near that quote with "Expected ',' or ']'...".
  * 2. Trailing commas before `}` / `]` or at end of input.
+ * 3. Valueless object keys immediately before a complete key-and-colon pair.
  *
- * The state-machine scan walks the raw body tracking string-open state:
- * - inside a string, a quote whose next non-space char is NOT one of `, ] } :`
- *   (or end of input) cannot legally close the string → escape it as `\"`;
- * - a `,` whose next non-space char is `}` / `]` / end of input is a trailing
- *   comma → drop it.
+ * A shared grammar-aware scan distinguishes object keys from values and
+ * checks the continuation after a potential string terminator. Ambiguous
+ * value quotes use bounded backtracking; trailing commas are dropped only
+ * outside strings.
  *
  * Returns `{ text, repairs }` on success, or null when nothing needed fixing
  * or the body still does not parse (callers fall through to tier-2 / banner).
@@ -45,6 +45,18 @@ export declare function repairFenceJson(raw: string): {
     text: string;
     repairs: number;
 } | null;
+/**
+ * 取**第一个平衡根值**的文本（丢弃其后的杂字符）；没有平衡根时返回 null。
+ *
+ * 与 {@link completeFenceJson} 里的前缀回退同源，但**只做裁剪、不做结构补全**：
+ * 内容识别用它来容忍「合法 JSON + 尾部泄漏文本」（真实样本：模型把自己的工具调用
+ * 模板泄漏在 JSON 之后，且围栏没闭合）。根值正好结束在末尾时返回 null —— 那种情况
+ * `JSON.parse` 本来就会成功。
+ *
+ * @param text - 候选正文。
+ * @returns 平衡根前缀；无可裁剪内容时 null。
+ */
+export declare function trimToBalancedRoot(text: string): string | null;
 /**
  * Tier-2 repair — SETTLED MESSAGES ONLY (never while streaming): heals
  * structural incompleteness — missing closing quotes/brackets — by appending
@@ -54,8 +66,8 @@ export declare function repairFenceJson(raw: string): {
  * client uses the host-provided fence source; the validate tool is by
  * definition pre-emission), so a streaming half can never flash premature UI.
  *
- * ONE unified scan: the tier-1 fixes (quote escaping + trailing-comma drops)
- * are folded into the same pass, so bodies that combine BOTH defect classes
+ * One shared scan implementation folds the tier-1 fixes (quote escaping +
+ * trailing-comma drops) into structural completion, so bodies with BOTH defects
  * (a trailing comma AND a missing closer) heal in one shot — the old
  * two-phase chain lost tier-1's partial work when its whole-body parse
  * failed, and re-scanning the raw text could not compose the repairs.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@changfenhuang/dsh-genui",
   "description": "GenUI for DeepSeek Harness: interactive UI components rendered inline in assistant replies via the ```dsh-ui fence — layout, charts, plots, forms, quizzes, mermaid, 3D scenes, and an action event loop back to the model. Ships the fence-teaching host plugin, the browser renderer (client half), and the genui skill.",
-  "version": "0.11.3",
+  "version": "0.12.0",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/types/plugin/index.d.ts",
@@ -10,10 +10,6 @@
       "types": "./lib/types/plugin/index.d.ts",
       "default": "./lib/index.js"
     },
-    "./invariant": {
-      "types": "./lib/types/plugin/invariant.d.ts",
-      "default": "./lib/invariant.js"
-    },
     "./client": {
       "types": "./lib/types/client/index.d.ts",
       "default": "./lib/client.js"
@@ -29,12 +25,10 @@
   },
   "files": [
     "lib/index.js",
-    "lib/invariant.js",
     "lib/client.js",
     "lib/assets/mermaid.js",
     "lib/assets/three.js",
     "lib/types/plugin/index.d.ts",
-    "lib/types/plugin/invariant.d.ts",
     "lib/types/client/index.d.ts",
     "SKILL.md",
     "README.md",
@@ -86,7 +80,6 @@
     "@deepseek-ai/dsh-client-ui-session": "^0.1.2-rc.1 || ^0.1.5-alpha.1 || ^0.1.6-alpha.1 || ^0.1.7-alpha.1 || >=0.2.0-rc.1 <0.3.0-0",
     "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-rc.1 || ^0.1.5-alpha.1 || ^0.1.6-alpha.1 || ^0.1.7-alpha.1 || >=0.2.0-rc.1 <0.3.0-0",
     "@deepseek-ai/dsh-client-ui-tool": "^0.1.2-rc.1 || ^0.1.5-alpha.1 || ^0.1.6-alpha.1 || ^0.1.7-alpha.1 || >=0.2.0-rc.1 <0.3.0-0",
-    "@deepseek-ai/dsh-invariants": "^0.1.2-rc.1 || ^0.1.5-alpha.1 || ^0.1.6-alpha.1 || ^0.1.7-alpha.1 || >=0.2.0-rc.1 <0.3.0-0",
     "@deepseek-ai/dsh-llm": "^0.1.2-rc.1 || ^0.1.5-alpha.1 || ^0.1.6-alpha.1 || ^0.1.7-alpha.1 || >=0.2.0-rc.1 <0.3.0-0",
     "@deepseek-ai/dsh-session": "^0.1.2-rc.1 || ^0.1.5-alpha.1 || ^0.1.6-alpha.1 || ^0.1.7-alpha.1 || >=0.2.0-rc.1 <0.3.0-0",
     "@deepseek-ai/dsh-skill": "^0.1.2-rc.1 || ^0.1.5-alpha.1 || ^0.1.6-alpha.1 || ^0.1.7-alpha.1 || >=0.2.0-rc.1 <0.3.0-0",
@@ -122,7 +115,6 @@
     "@deepseek-ai/dsh-deque": "0.1.2-rc.1",
     "@deepseek-ai/dsh-file-reference": "0.1.2-rc.1",
     "@deepseek-ai/dsh-home-paths": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-invariants": "0.1.2-rc.1",
     "@deepseek-ai/dsh-jobs": "0.1.2-rc.1",
     "@deepseek-ai/dsh-llm": "0.1.2-rc.1",
     "@deepseek-ai/dsh-native-command": "0.1.2-rc.1",
@@ -226,9 +218,6 @@
     "@deepseek-ai/dsh-client-ui-tool": {
       "optional": true
     },
-    "@deepseek-ai/dsh-invariants": {
-      "optional": true
-    },
     "@deepseek-ai/dsh-llm": {
       "optional": true
     },