@huanlin/dsh-plugin-merge-tool-calls 0.1.0

package/lib/invariant.js

@@ -0,0 +1,11 @@
+//#region src/invariant.ts
+const PACKAGE_NAME = "@huanlin/dsh-plugin-merge-tool-calls";
+const name = "merge-tool-calls-invariant";
+const inject = ["invariants"];
+/** No runtime invariant: this package contributes client-only slot entries. */
+const install = () => {};
+/** Register package ownership with the invariant service. */
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+
+//#endregion
+export { apply, inject, name };

package/lib/types/client/card-model.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Pure card/row derivation from a frozen call slice, mirroring ui-tool's
+ * tool-call/read-card/search-card/diff-card/terminal-card/web-card models at
+ * the plugin boundary (those models are ui-tool internals and cannot be
+ * imported cross-package). Same wire contract, same defensive treatment of
+ * untrusted result views. A merged row renders the same surface the built-in
+ * row would: a variant title/icon plus a card primitive or IN/OUT text.
+ * @module
+ */
+import { type ToolCallBlock, type ToolResultNode } from '@deepseek-ai/dsh-client-runtime/client';
+import type { DiffBlockProps, ReadBlockProps, SearchBlockProps, TerminalBlockProps, WebBlockProps } from '@deepseek-ai/dsh-client-ui-primitives';
+import { type ToolVariant } from './tool-names.ts';
+/** Row state semantic, mirroring ui-tool's ToolRowState. */
+export type RowState = 'running' | 'ok' | 'error' | 'stopped';
+export type { ToolVariant } from './tool-names.ts';
+/** Read-card props the ReadBlock primitive draws (per-render maxLines owned by the caller). */
+export type ReadCardModel = Pick<ReadBlockProps, 'label' | 'lines' | 'totalLines' | 'lang'>;
+/**
+ * Distributive `Omit`: a plain `Omit<A | B, K>` keeps only the keys common to
+ * both members, dropping the discriminated `files`/`paths` fields. Distributing
+ * over the naked type parameter preserves each shape.
+ */
+type DistributiveOmit<T, K extends keyof T> = T extends unknown ? Omit<T, K> : never;
+/** Search-card props plus the capped-result recovery locator (mirrors ui-tool). */
+export interface SearchCardModel {
+    readonly card: DistributiveOmit<SearchBlockProps, 'maxLines' | 'className'>;
+    /** The result view's replacement title, which outranks the args summary. */
+    readonly title: string | undefined;
+    readonly recovery: string | undefined;
+}
+/** Diff-card props (mirrors ui-tool; maxLines/className belong to the render site). */
+export interface DiffCardModel {
+    readonly card: Pick<DiffBlockProps, 'diffs'>;
+}
+/** Terminal-card props (mirrors ui-tool; maxLines/className/labels belong to the render site). */
+export interface TerminalCardModel {
+    readonly card: Pick<TerminalBlockProps, 'command' | 'cwd' | 'output' | 'exitCode' | 'signal' | 'running'>;
+    /** The call view's model-authored description shown above the card. */
+    readonly description: string | undefined;
+}
+/** True when a settled terminal card reports a failing exit (mirrors ui-tool). */
+export declare function terminalFailed(model: TerminalCardModel): boolean;
+/** Everything a merged row needs, derived once from the frozen slice. */
+export interface CallRowModel {
+    readonly state: RowState;
+    readonly variant: ToolVariant;
+    /** Row title: variant title, or the tool-owned title when it refines one. */
+    readonly title: string;
+    /** Args/result-derived one-line summary (path for file tools, query for searches, …). */
+    readonly summary: string;
+    /** Expanded-body input text (pretty args); null = no input section. */
+    readonly body: string | null;
+    /** Flattened result text; null while running or when the result carries no text. */
+    readonly output: string | null;
+    /** First result line on an error row (the collapsed summary's error text). */
+    readonly errorSummary: string | null;
+    /** Openable workspace path from args; absent for non-file tools and errors. */
+    readonly filePath: string | undefined;
+    /** Whether the row has anything to expand (a card, args body, or output). */
+    readonly expandable: boolean;
+    /** Expanded-body content cards, mutually exclusive, or null when absent. */
+    readonly terminal: TerminalCardModel | null;
+    readonly diff: DiffCardModel | null;
+    readonly read: ReadCardModel | null;
+    readonly search: SearchCardModel | null;
+    readonly web: WebBlockProps | null;
+}
+/**
+ * Flatten a settled result's content blocks to display text.
+ * @param node - settled result node.
+ * @returns joined text (may be empty).
+ */
+export declare function resultText(node: ToolResultNode): string;
+/** Strip the workspace root from a workspace-rooted absolute path (display only). */
+export declare function relativizeToCwd(text: string, cwd: string | undefined): string;
+/** Derive the row model for one call of a grouped tool. */
+export declare function callRowModel(toolName: string, block: ToolCallBlock, cwd: string | undefined): CallRowModel;

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

@@ -0,0 +1,29 @@
+/**
+ * merge-tool-calls — browser half.
+ *
+ * Shadows the shipped `tool.call.toolview` entries for every grouped tool at
+ * priority -1 (the keyed slot's shadowing rule: lowest priority renders). An
+ * empty `tools` config means every built-in generic-family tool
+ * (see {@link ALL_TOOL_NAMES}); a non-empty list is an explicit whitelist.
+ * The shadowed component merges consecutive calls of one tool in the chat flow
+ * into a single card with compact child rows.
+ *
+ * @module @dsh-external/dsh-merge-tool-calls/client
+ */
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+import { type MergeToolCallsConfig } from '../types.ts';
+import { type MergeToolCallsKey } from './locales.ts';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** Copy for the merged tool-call rows. */
+        'merge-tool-calls': MergeToolCallsKey;
+    }
+}
+/** Required services: the slot registry (toolview shadowing) and locale. */
+export declare const inject: string[];
+/**
+ * Register one shadowed toolview per grouped tool.
+ * @param ctx - client root context.
+ * @param config - row config; defaults apply when the loader passes none.
+ */
+export declare function apply(ctx: ClientContext, config?: Partial<MergeToolCallsConfig>): void;

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

@@ -0,0 +1,47 @@
+/** Product copy for the merged tool-call rows. */
+export declare const zh: {
+    running: string;
+    failed: string;
+    stopped: string;
+    expand: string;
+    collapse: string;
+    more: string;
+    showLess: string;
+    mergedCount: string;
+    'terminal.signal': string;
+    'terminal.exitCode': string;
+    'terminal.running': string;
+    'terminal.failed': string;
+    'terminal.done': string;
+    'terminal.copy': string;
+    'terminal.copied': string;
+    'terminal.noOutput': string;
+    'terminal.collapseAria': string;
+    'terminal.collapse': string;
+    'terminal.expandAria': string;
+    'terminal.expandRest': string;
+};
+export type MergeToolCallsKey = keyof typeof zh;
+export declare const en: {
+    running: string;
+    failed: string;
+    stopped: string;
+    expand: string;
+    collapse: string;
+    more: string;
+    showLess: string;
+    mergedCount: string;
+    'terminal.signal': string;
+    'terminal.exitCode': string;
+    'terminal.running': string;
+    'terminal.failed': string;
+    'terminal.done': string;
+    'terminal.copy': string;
+    'terminal.copied': string;
+    'terminal.noOutput': string;
+    'terminal.collapseAria': string;
+    'terminal.collapse': string;
+    'terminal.expandAria': string;
+    'terminal.expandRest': string;
+};
+export declare const NS = "merge-tool-calls";

package/lib/types/client/merge-run.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Pure detection of a consecutive run of grouped tool calls in the chat flow,
+ * and the per-seat merged-group partition over it.
+ *
+ * A pure function of the chat snapshot (order + node store), so the merged
+ * display is deterministic under replay: the web layer recomputes it per frame.
+ * @module
+ */
+import type { ChatNodeStore, ToolCallBlock } from '@deepseek-ai/dsh-client-runtime/client';
+import type { MergeGroupMode } from '../types.ts';
+/** The wire tool name of a call in either lifecycle form (mirrors ui-tool). */
+export declare function callNameOf(block: ToolCallBlock): string;
+/** Whether the call's wire name is one of the grouped tools (empty = all). */
+export declare function isGroupedTool(name: string, tools: readonly string[]): boolean;
+/** One merged group: the group's first call plus its consecutive continuations. */
+export interface ReadRun {
+    /** Whether this seat is the group's rendering head (the only seat that shows the card). */
+    readonly isFirst: boolean;
+    /** The group's root blocks in flow order (first + continuations). */
+    readonly blocks: readonly ToolCallBlock[];
+}
+/**
+ * Compute the merged group this call belongs to.
+ *
+ * 1. Locates this call's node in the chat order; null when it is not a chat
+ *    tool-call node (e.g. a read dispatched as a subcall).
+ * 2. Walks backward/forward to the maximal consecutive run containing it. A
+ *    call continues the run when it is a grouped tool AND same-tool-same-run:
+ *    the identical wire name, or a sibling of the same known variant family
+ *    (grep+glob, bash+pwsh, read+web_fetch…). Unknown names (variant
+ *    `others`) only merge with themselves, so unrelated tools never share a
+ *    card (`adjacent`: any consecutive run; `step`: same agent step as this
+ *    call).
+ * 3. Partitions the run into `maxGroupSize`-sized groups; this call is the
+ *    group's first only when it heads one of those partitions. Truncation
+ *    therefore never orphans a call: the excess starts its own group.
+ *
+ * @param order - chat node key order.
+ * @param nodes - chat node store.
+ * @param myCallId - the call id of the seat asking about itself.
+ * @param tools - grouped wire tool names; empty means every tool.
+ * @param groupBy - grouping mode.
+ * @param maxGroupSize - per-group cap.
+ * @returns the group partition, or null when the call is not a chat tool-call node.
+ */
+export declare function readRun(order: readonly string[], nodes: ChatNodeStore, myCallId: string, tools: readonly string[], groupBy: MergeGroupMode, maxGroupSize: number): ReadRun | null;

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

@@ -0,0 +1,46 @@
+import type { ToolCallBlock } from '@deepseek-ai/dsh-client-runtime/client';
+import type { ToolCallViewProps } from '@deepseek-ai/dsh-client-ui-tool/client';
+import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import type { MergeToolCallsConfig } from '../types.ts';
+/** Locale seat and inject face of the merged row registration. */
+export type MergedToolRowProps = ToolCallViewProps & PropsLocale<'merge-tool-calls'> & {
+    readonly cfg: MergeToolCallsConfig;
+};
+/** The run's main card: the first call's full row (chrome + expandable card). */
+export declare const RowCard: import("react").NamedExoticComponent<{
+    toolName: string;
+    block: ToolCallBlock;
+    cwd: string | undefined;
+    openFile: (path: string) => void;
+    inspect: (() => void) | undefined;
+    t: MergedToolRowProps["t"];
+    /** Continuation-call count rendered as a muted `+n` suffix; 0 hides it. */
+    mergedCount: number;
+}>;
+/**
+ * One compact continuation row: the main row's tail structure ([sep dot][path]).
+ * An expandable call toggles the inline content card on click (mirroring the
+ * main row's whole-row disclosure); a read/write/edit-family path additionally
+ * renders as an open-file link (the sidebar preview) that stops propagation,
+ * exactly like the main row's summary link.
+ */
+export declare const ChildRow: import("react").NamedExoticComponent<{
+    toolName: string;
+    block: ToolCallBlock;
+    cwd: string | undefined;
+    openFile: (path: string) => void;
+    t: MergedToolRowProps["t"];
+}>;
+/**
+ * The shadowed toolview: renders the merged run card for the run's first call,
+ * nothing for continuation calls, and a plain single row when this call is not
+ * a chat tool-call node.
+ *
+ * Child-row alignment is measured at runtime, not hardcoded: the main row's
+ * separator dot sits after a variable-width title ("Read"/"Search"/"Bash"/…),
+ * so its column depends on the rendered font. A layout effect measures the
+ * dot's offset from the card root (once, plus on reflow via ResizeObserver)
+ * and indents the children so their dots and paths land on the main row's
+ * columns — no font/title constants to keep in sync.
+ */
+export declare function MergedToolRow({ callId, toolName, block, cwd, openFile, inspect, t, cfg, useSession }: MergedToolRowProps): import("react").JSX.Element | null;

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

@@ -0,0 +1,19 @@
+/**
+ * One scoped stylesheet injected for the lifetime of the client activation.
+ *
+ * Two jobs:
+ *  1. The empty-seat collapse rule: the shadowed toolview renders `null` for
+ *     every non-first call of a merged run. The built-in `ToolCallTree` still
+ *     wraps that null in its `.callRow` div, and the renderer wraps every
+ *     toolview in an empty `<div data-slot="tool.call.toolview">` (display:
+ *     contents), so the seat's `.flowItem` is never `:empty` itself and the
+ *     built-in `.flowItem:empty { display:none }` rule does not fire. This
+ *     rule extends the same intent ("a renderer may decline its row") to a
+ *     tool seat whose toolview rendered nothing.
+ *  2. The plugin's own `.mtc-*` chrome for the merged card and its child rows.
+ *
+ * All colors come from the shared `--dsw-*` tokens (never literals).
+ */
+export declare const CSS = "\n/* A tool-call seat whose toolview declined to render (merged-run continuation\n   calls) must not consume the flow column's gap. The empty toolview slot\n   wrapper is the decline signal; the callRow around it always exists. */\n[data-chat-flow-kind=\"tool-call\"]:has([data-slot=\"tool.call.toolview\"]:empty) { display: none; }\n\n.mtc-root { display: flex; flex-direction: column; min-width: 0; }\n.mtc-row { display: flex; flex-direction: column; min-width: 0; }\n.mtc-row[data-state='running'] .mtc-title-row { position: relative; overflow: hidden; }\n.mtc-row[data-state='running'] .mtc-title-row::after {\n  content: '';\n  position: absolute;\n  top: 0; bottom: 0; left: 0;\n  width: 300px;\n  background: linear-gradient(90deg, transparent 0%, color-mix(in srgb, var(--dsw-alias-bg-base) 60%, transparent) 55%, transparent 100%);\n  animation: dsh-mtc-sweep 2.6s ease-out infinite;\n  pointer-events: none;\n}\n@keyframes dsh-mtc-sweep {\n  0% { left: -300px; }\n  90%, 100% { left: 100%; }\n}\n\n.mtc-title { font-weight: 400; }\n.mtc-sep { flex: none; width: 2px; height: 2px; border-radius: 1px; margin: 0 8px; background: var(--dsw-alias-label-caption); }\n.mtc-summary {\n  flex: 1 1 auto; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap;\n  font-size: 14px; line-height: 24px; color: var(--dsw-alias-label-tertiary);\n}\n.mtc-summary-link {\n  flex: 1 1 auto; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap;\n  margin: 0; padding: 0; border: none; background: none; font: inherit; text-align: left;\n  font-size: 14px; line-height: 24px; color: var(--dsw-alias-label-secondary);\n  text-decoration: underline; text-decoration-color: var(--dsw-alias-label-quaternary);\n  text-underline-offset: 3px; cursor: pointer;\n}\n.mtc-summary-link:hover { color: var(--dsw-alias-label-primary); text-decoration-color: currentColor; }\n.mtc-summary-error { color: var(--dsw-alias-state-error-primary); }\n.mtc-summary-suffix { flex: none; margin-left: 4px; white-space: nowrap; font-size: 14px; line-height: 24px; color: var(--dsw-alias-label-tertiary); }\n\n.mtc-card-body { margin: 4px 0 4px 4px; min-width: 0; }\n.mtc-recovery { margin: 4px 0 4px 4px; white-space: pre-wrap; overflow-wrap: anywhere; font: var(--dsw-font-xs-13); color: var(--dsw-alias-label-tertiary); }\n/* IN/OUT text card for calls without a card primitive (mirrors ToolRow). */\n.mtc-io-card {\n  display: flex; flex-direction: column; min-width: 0;\n  border: 1px solid var(--dsw-alias-border-l2); border-radius: 12px;\n  background: var(--dsw-alias-bg-base);\n}\n.mtc-io-section { display: flex; gap: 10px; padding: 8px 12px; min-width: 0; }\n.mtc-io-label {\n  flex: none; font-size: 11px; line-height: 16px; font-weight: 600;\n  color: var(--dsw-alias-label-tertiary);\n}\n.mtc-io-text {\n  flex: 1 1 auto; min-width: 0; white-space: pre-wrap; overflow-wrap: anywhere;\n  font-size: 13px; line-height: 20px; color: var(--dsw-alias-label-secondary);\n}\n.mtc-io-text[data-error] { color: var(--dsw-alias-state-error-primary); }\n.mtc-io-divider { height: 1px; background: var(--dsw-alias-border-l2); }\n.mtc-inspect {\n  display: inline-flex; align-self: flex-start; align-items: center; gap: 4px;\n  margin: 4px 0 2px 4px; padding: 2px 8px;\n  border: 1px solid var(--dsw-alias-border-l2); border-radius: 999px;\n  background: var(--dsw-alias-bg-base); color: var(--dsw-alias-label-secondary);\n  font-size: 11px; line-height: 16px; cursor: pointer;\n  opacity: 0; transition: opacity 100ms ease;\n}\n.mtc-root:hover .mtc-inspect, .mtc-inspect:focus-visible { opacity: 1; }\n.mtc-inspect:hover { background: var(--dsw-alias-interactive-bg-hover-solid); color: var(--dsw-alias-label-primary); }\n\n/* Compact child rows: each is the main row's tail structure \u2014 [sep dot][path].\n   The dot/path columns are set at runtime by the component (it measures the\n   main row's sep offset and sets the --mtc-sep-left custom property on the\n   children block), so this is only the pre-measure fallback. */\n.mtc-children { display: flex; flex-direction: column; gap: 1px; margin: 2px 0 2px var(--mtc-sep-left, 61px); }\n.mtc-child { display: flex; flex-direction: column; min-width: 0; }\n.mtc-child-row {\n  display: flex; align-items: center; gap: 0; min-width: 0; height: 20px;\n  margin: 0; padding: 0; border: 0; border-radius: 4px; background: none;\n  font: inherit; text-align: left; color: var(--dsw-alias-label-secondary); cursor: pointer;\n}\n.mtc-child-row:hover { background: var(--dsw-alias-interactive-bg-hover); color: var(--dsw-alias-label-primary); }\n.mtc-child-row[data-static] { cursor: default; }\n.mtc-child-row[data-static]:hover { background: none; color: var(--dsw-alias-label-secondary); }\n.mtc-child-row .mtc-sep { margin: 0 8px 0 0; }\n.mtc-child-path {\n  flex: 1 1 auto; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap;\n  font-size: 14px; line-height: 20px;\n}\n/* Read-family child paths are open-file links (sidebar preview), same affordance\n   as the main row's summary link. */\n.mtc-child-path-link {\n  flex: 1 1 auto; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap;\n  margin: 0; padding: 0; border: none; background: none; font: inherit; text-align: left;\n  font-size: 14px; line-height: 20px; color: var(--dsw-alias-label-secondary);\n  text-decoration: underline; text-decoration-color: var(--dsw-alias-label-quaternary);\n  text-underline-offset: 3px; cursor: pointer;\n}\n.mtc-child-path-link:hover { color: var(--dsw-alias-label-primary); text-decoration-color: currentColor; }\n.mtc-child-state { flex: none; font-size: 11px; line-height: 16px; color: var(--dsw-alias-label-tertiary); }\n.mtc-child-state[data-error] { color: var(--dsw-alias-state-error-primary); }\n/* The expanded child card must not inherit the children block's sep indent:\n   pull its left edge back to the main card body's column (root + 4px) so the\n   card spans the card width instead of leaving a blank gutter on its left. */\n.mtc-child-body { margin: 2px 0 2px calc(4px - var(--mtc-sep-left, 61px)); min-width: 0; }\n\n.mtc-visually-hidden {\n  position: absolute; width: 1px; height: 1px; overflow: hidden;\n  clip: rect(0 0 0 0); white-space: nowrap;\n}\n";
+/** Install the stylesheet and return its disposer. */
+export declare function installStyles(): () => void;

package/lib/types/client/tool-names.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The built-in tool universe this plugin shadows by default, plus the
+ * variant-classification vocabulary mirroring ui-tool's tool-call model.
+ *
+ * The keyed `tool.call.toolview` slot dispatches on the exact wire tool name,
+ * so a shadowed registration is needed per name (there is no wildcard). This
+ * list names every shipped tool whose row belongs to the generic ToolRow
+ * family — a variant title/icon plus read/search/diff/terminal/web card or
+ * IN/OUT text — which the merged row reproduces faithfully.
+ *
+ * Deliberately excluded: tools with custom row cards this plugin does not
+ * replicate (`skill`, `cordis_define`, and the live `cordis_run` /
+ * `cordis_stop` / `cordis_undefine` rows), and `todo_write` /
+ * `ask_user_question` whose summary formatting is tool-specific. They keep
+ * their built-in rows unless the user names them in the `tools` config
+ * explicitly.
+ * @module
+ */
+/** Wire tool names merged by default (empty `tools` config = this list). */
+export declare const ALL_TOOL_NAMES: readonly string[];
+/** Tool-row visual variant, mirroring ui-tool's ToolRowVariant. */
+export type ToolVariant = 'search' | 'read' | 'bash' | 'write' | 'edit' | 'code' | 'others';
+/** Figma row titles per variant (design literals, not translatable copy). */
+export declare const VARIANT_TITLES: Record<ToolVariant, string>;
+/** Tool-owned titles refining a generic row variant (mirrors ui-tool). */
+export declare const TOOL_TITLES: Record<string, string>;
+/** Classify a tool name into its row variant (mirrors ui-tool). */
+export declare function classifyTool(toolName: string): ToolVariant;
+/** The variant title a row shows, honoring tool-owned refinements. */
+export declare function variantTitle(toolName: string): string;

package/lib/types/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * merge-tool-calls — host entry.
+ *
+ * The plugin is browser-only: it shadows the shipped `read`/`grep`/`glob`
+ * toolviews inside `tool.call.toolview` (see `src/client/`). The host half
+ * exists to declare the validated Config schema for the bundle row; its apply
+ * is intentionally empty.
+ *
+ * @module @huanlin/dsh-plugin-merge-tool-calls
+ */
+import z from '@deepseek-ai/schemastery';
+import type { MergeToolCallsConfig } from './types.ts';
+export declare const name = "merge-tool-calls";
+export type { MergeToolCallsConfig } from './types.ts';
+/** Validated output shape of {@link Config} (defaults applied). */
+export interface Config extends MergeToolCallsConfig {
+}
+/** Schemastery schema: validated Config fields with the row's runtime defaults. */
+export declare const Config: z<Config>;
+/**
+ * Empty host apply: all registrations live in the browser half.
+ * @param _ctx - cordis context (unused; the plugin contributes client slots only).
+ */
+export declare function apply(_ctx: unknown): void;

package/lib/types/invariant.d.ts

@@ -0,0 +1,12 @@
+/** Package invariant companion for dsh-merge-tool-calls. */
+import type { InvariantInstaller } from '@deepseek-ai/dsh-invariants';
+export declare const name = "merge-tool-calls-invariant";
+export declare const inject: string[];
+interface InvariantContext {
+    invariants: {
+        register: (name: string, installer: InvariantInstaller) => () => void;
+    };
+}
+/** Register package ownership with the invariant service. */
+export declare const apply: (ctx: InvariantContext) => Promise<() => void>;
+export {};

package/lib/types/types.d.ts

@@ -0,0 +1,19 @@
+/** Shared config surface of the merge-tool-calls plugin (host + client halves). */
+/** How consecutive same-tool calls are grouped into one merged card. */
+export type MergeGroupMode = 'adjacent' | 'step';
+/** Plugin configuration; defaults live in the Schemastery schema and cordis.patch.yml. */
+export interface MergeToolCallsConfig {
+    /**
+     * Wire tool names whose consecutive calls merge. Empty = every built-in
+     * generic-family tool (read/grep/glob/edit/write/bash/pwsh/web_search/
+     * web_fetch/run_code/cordis_package_inspect/cordis_runtime_inspect); a
+     * non-empty list is an explicit whitelist (any wire name works).
+     */
+    readonly tools: readonly string[];
+    /** `adjacent`: any consecutive run in the chat flow; `step`: only within one agent step. */
+    readonly groupBy: MergeGroupMode;
+    /** Max calls per merged group; the run is truncated and the excess starts a new group. */
+    readonly maxGroupSize: number;
+}
+/** Runtime defaults applied when a half receives no config (defensive only). */
+export declare const DEFAULT_MERGE_CONFIG: MergeToolCallsConfig;

package/package.json

@@ -0,0 +1,114 @@
+{
+  "name": "@huanlin/dsh-plugin-merge-tool-calls",
+  "version": "0.1.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "dsh-plugin"
+  ],
+  "description": "Merge consecutive same-tool calls in the DSH WebUI chat flow into one card with compact child rows (all built-in tools by default).",
+  "type": "module",
+  "license": "MIT",
+  "main": "./lib/index.js",
+  "types": "./lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "import": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "import": "./lib/invariant.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/",
+    "cordis.patch.yml"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-tool",
+        "@deepseek-ai/dsh-client-ui-slots",
+        "@deepseek-ai/dsh-client-ui-primitives"
+      ],
+      "platform": "web"
+    }
+  },
+  "peerDependencies": {
+    "cordis": "^4.0.0-rc.7",
+    "react": "^18.2.0",
+    "schemastery": "^3.18.0",
+    "@deepseek-ai/dsh-client-locale": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-runtime": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-tool": "0.1.0-rc.6"
+  },
+  "peerDependenciesMeta": {
+    "cordis": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "schemastery": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-locale": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-runtime": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-primitives": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-slots": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-tool": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-client-locale": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-runtime": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-tool": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-invariants": "0.1.0-rc.6",
+    "@deepseek-ai/schemastery": "^3.18.1",
+    "@types/node": "^22.20.1",
+    "@types/react": "~18.3.31",
+    "cordis": "^4.0.0-rc.7",
+    "jsdom": "^26.0.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "schemastery": "^3.18.0",
+    "tsdown": "^0.15.0",
+    "typescript": "^5.9.0",
+    "vitest": "^3.2.0"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run",
+    "build": "tsdown -c tsdown.config.ts && tsc -p tsconfig.json"
+  }
+}