@drscrewdriver/dsh-better-display 0.3.3-fork.1

package/lib/types/client/native/tool-call-model.js

@@ -0,0 +1,219 @@
+/**
+ * Pure row-model derivation for tool summary rows: variant classification,
+ * one-line summary, expanded-body text, and flattened result output from the
+ * frozen call slice. Input material comes from the call ARGUMENTS; output and
+ * error material from the settled result node. A call whose render intent is
+ * a terminal card gets its expanded body from the views instead, through
+ * `terminalCardModel` in terminal-card-model.ts.
+ */
+// The block union's defining home is runtime (fold-product types); this
+// contract only forwards it (type-definition authority stays with the layer
+// that produces the values).
+import { abbreviateHomePath } from '@deepseek-ai/dsh-util-workspace-path';
+/** Figma row titles per variant (design literals, not translatable copy). */
+export const VARIANT_TITLES = {
+    search: 'Search', read: 'Read', bash: 'Bash',
+    write: 'Write', edit: 'Edit', code: 'Code', others: 'Tool call',
+};
+/**
+ * Known tool name -> variant.
+ *
+ * `cordis_define` is deliberately absent: ui-cordis registers a keyed
+ * `tool.call.toolview` entry for it, and a keyed hit REPLACES the generic row
+ * (this table is only reached through GenericToolCard, the dispatch fallback in
+ * ToolCallTree). An entry here would be unreachable, and a second title for the
+ * same call would be a second answer to a question the card already owns.
+ */
+const TOOL_VARIANTS = {
+    bash: 'bash',
+    // The PowerShell twin is a shell tool: the bash row family (icon, colors)
+    // with its own title from TOOL_TITLES, not the generic `others` row.
+    pwsh: 'bash',
+    read: 'read',
+    web_fetch: 'read',
+    web_search: 'search',
+    grep: 'search',
+    glob: 'search',
+    write: 'write',
+    edit: 'edit',
+    run_code: 'code',
+    cordis_package_inspect: 'read',
+    cordis_runtime_inspect: 'read',
+    // The three run-control verbs take one package id and produce a receipt, so
+    // the generic row is the decided intent, not an unclassified default: there is
+    // no program to show (that is `cordis_define`'s card) and no file to open. The
+    // id lands in the summary slot, and the titles below name the act.
+    cordis_run: 'others',
+    cordis_stop: 'others',
+    cordis_undefine: 'others',
+};
+/** Tool-owned titles that refine a generic row variant without replacing it. */
+const TOOL_TITLES = {
+    cordis_package_inspect: 'Inspect',
+    cordis_runtime_inspect: 'Inspect',
+    cordis_run: 'Run Cordis Plugin',
+    cordis_stop: 'Stop Cordis Plugin',
+    cordis_undefine: 'Remove Cordis Plugin',
+    pwsh: 'Pwsh',
+};
+/**
+ * Classify a tool name into its row variant.
+ * @param toolName - wire tool name.
+ * @returns matching variant, others when unknown.
+ */
+export function classifyTool(toolName) {
+    return TOOL_VARIANTS[toolName] ?? 'others';
+}
+/**
+ * Flatten a settled result's content blocks to display text: text blocks
+ * verbatim, other block shapes as pretty JSON. Empty content on a failed call
+ * falls back to the structured error's `name: code` line.
+ * @param node - the settled result node.
+ * @returns the flattened result text (may be empty).
+ */
+export function resultText(node) {
+    const parts = [];
+    for (const block of node.content) {
+        if (block.type === 'text')
+            parts.push(block.text);
+        else
+            parts.push(JSON.stringify(block, null, 2));
+    }
+    if (parts.length === 0 && node.error !== undefined) {
+        parts.push(`${node.error.name}: ${node.error.code}`);
+    }
+    return parts.join('\n');
+}
+function parseArgs(argsRaw) {
+    try {
+        return JSON.parse(argsRaw);
+    }
+    catch {
+        // Non-JSON args (mid-stream truncation): summary/body fall back to the raw string.
+        return undefined;
+    }
+}
+function firstLine(text) {
+    const nl = text.indexOf('\n');
+    return nl === -1 ? text : text.slice(0, nl);
+}
+function pickString(args, keys) {
+    for (const key of keys) {
+        const v = args[key];
+        if (typeof v === 'string' && v !== '')
+            return v;
+    }
+    return undefined;
+}
+/** Summary key preference per variant (args-derived; result-derived summaries are a ledger item). */
+const SUMMARY_KEYS = {
+    bash: ['description', 'command'],
+    read: ['path', 'file_path', 'url'],
+    search: ['query', 'pattern', 'url'],
+    write: ['path', 'file_path'],
+    edit: ['path', 'file_path'],
+    code: ['description'],
+    others: [],
+};
+/**
+ * Strip the workspace root from a workspace-rooted absolute path (display only).
+ * @param text - the path to shorten.
+ * @param cwd - session workspace root; absent or empty leaves the path unchanged.
+ * @returns the path relative to the workspace root, or unchanged when it is not rooted there.
+ */
+export function relativizeToCwd(text, cwd) {
+    if (cwd === undefined || cwd === '')
+        return text;
+    const root = cwd.replace(/[/\\]+$/, '');
+    if (text.startsWith(`${root}/`) || text.startsWith(`${root}\\`))
+        return text.slice(root.length + 1);
+    return text;
+}
+function deriveSummary(variant, argsRaw) {
+    const parsed = parseArgs(argsRaw);
+    if (typeof parsed !== 'object' || parsed === null)
+        return firstLine(argsRaw);
+    const args = parsed;
+    if (variant === 'search' && Array.isArray(args.queries)) {
+        const queries = args.queries.filter((query) => typeof query === 'string' && query !== '');
+        if (queries.length > 0)
+            return queries.map(firstLine).join(', ');
+    }
+    const picked = pickString(args, SUMMARY_KEYS[variant]);
+    if (picked !== undefined)
+        return firstLine(picked);
+    for (const v of Object.values(args)) {
+        if (typeof v === 'string' && v !== '')
+            return firstLine(v);
+    }
+    return firstLine(argsRaw);
+}
+/** Path keys only — never `url` (web_fetch lands on the read variant). */
+const FILE_PATH_KEYS = ['path', 'file_path'];
+/** File-tool variants whose summary may be an openable workspace path. */
+const FILE_PATH_VARIANTS = new Set(['read', 'write', 'edit']);
+function deriveFilePath(variant, argsRaw) {
+    if (!FILE_PATH_VARIANTS.has(variant))
+        return undefined;
+    const parsed = parseArgs(argsRaw);
+    if (typeof parsed !== 'object' || parsed === null)
+        return undefined;
+    const picked = pickString(parsed, FILE_PATH_KEYS);
+    return picked === undefined ? undefined : firstLine(picked);
+}
+function deriveBody(variant, argsRaw) {
+    if (argsRaw === '')
+        return null;
+    const parsed = parseArgs(argsRaw);
+    if (parsed === undefined)
+        return argsRaw;
+    // The code row's expanded body IS the program (monospace via the row's
+    // variant styling), not the args JSON envelope around it.
+    if (variant === 'code' && typeof parsed === 'object' && parsed !== null) {
+        const code = parsed.code;
+        if (typeof code === 'string' && code !== '')
+            return code;
+    }
+    return JSON.stringify(parsed, null, 2);
+}
+/**
+ * Derive the full row model from a frozen call slice.
+ * @param toolName - wire tool name (dispatch-supplied; survives windowless results).
+ * @param block - RunningToolCall or ToolResultNode off the snapshot caches.
+ * @param cwd - session workspace root; workspace-rooted path summaries display relative to it.
+ * @param home - host account home; a leftover POSIX home path displays as `~`.
+ * @returns the row model.
+ */
+export function toolRowModel(toolName, block, cwd, home) {
+    const variant = classifyTool(toolName);
+    const done = 'kind' in block;
+    const argsRaw = (done ? block.call?.argsRaw : ('argsRaw' in block ? block.argsRaw : '')) ?? '';
+    const state = !done ? 'running'
+        : block.error?.code === 'interrupted' ? 'stopped'
+            : block.isError ? 'error' : 'ok';
+    const base = argsRaw === ''
+        ? block.callId
+        : abbreviateHomePath(relativizeToCwd(deriveSummary(variant, argsRaw), cwd), home);
+    const toolTitle = TOOL_TITLES[toolName];
+    // Others keeps the static "Tool call" title (figma literal); the real tool
+    // name rides the mutable summary slot unless the tool owns a specific title.
+    const summary = variant === 'others' && toolName !== '' && toolTitle === undefined
+        ? `${toolName} · ${base}`
+        : base;
+    // The empty string is "no text" for both derived result fields: a settled
+    // call with blank content has nothing to expand, and a blank first line
+    // would erase the collapsed error row's summary slot.
+    const output = done ? (resultText(block) || null) : null;
+    const errorSummary = state === 'error' && output !== null ? firstLine(output) : null;
+    return {
+        variant,
+        title: toolTitle ?? VARIANT_TITLES[variant],
+        summary,
+        filePath: deriveFilePath(variant, argsRaw),
+        body: deriveBody(variant, argsRaw),
+        output,
+        errorSummary,
+        state,
+    };
+}
+//# sourceMappingURL=tool-call-model.js.map

package/lib/types/client/native/tool-call-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call-model.js","sourceRoot":"","sources":["../../../../src/client/native/tool-call-model.ts"],"names":[],"mappings":"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"}

package/lib/types/client/native/tool-update.d.ts

@@ -0,0 +1,23 @@
+/** One developer tool-change block the 0.1.7-rc.2 context row names in place. */
+export interface ToolChangeBlock {
+    type: 'tool-addition' | 'tool-removal';
+    toolName: string;
+}
+/** Names collected from a context whose every block is a tool change. */
+export interface ToolUpdateRows {
+    added: readonly string[];
+    removed: readonly string[];
+    /** The only block, when the row is a single add or removal. */
+    single: ToolChangeBlock | null;
+}
+/**
+ * Classify a context as the rc.2 tool-update row.
+ * Mixed or empty content stays on the generic injection presentation.
+ * @param content - durable context blocks.
+ * @returns collected names, or null when any block is not a tool change.
+ */
+export declare function toolUpdateRows(content: readonly {
+    readonly type: string;
+    readonly toolName?: string;
+}[]): ToolUpdateRows | null;
+//# sourceMappingURL=tool-update.d.ts.map

package/lib/types/client/native/tool-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-update.d.ts","sourceRoot":"","sources":["../../../../src/client/native/tool-update.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,eAAe,GAAG,cAAc,CAAA;IACtC,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,yEAAyE;AACzE,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACxB,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1B,+DAA+D;IAC/D,MAAM,EAAE,eAAe,GAAG,IAAI,CAAA;CAC/B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,cAAc,GAAG,IAAI,CAW/H"}

package/lib/types/client/native/tool-update.js

@@ -0,0 +1,22 @@
+/**
+ * Classify a context as the rc.2 tool-update row.
+ * Mixed or empty content stays on the generic injection presentation.
+ * @param content - durable context blocks.
+ * @returns collected names, or null when any block is not a tool change.
+ */
+export function toolUpdateRows(content) {
+    if (content.length === 0)
+        return null;
+    const rows = [];
+    for (const block of content) {
+        if (block.type !== 'tool-addition' && block.type !== 'tool-removal')
+            return null;
+        if (typeof block.toolName !== 'string')
+            return null;
+        rows.push({ type: block.type, toolName: block.toolName });
+    }
+    const added = rows.flatMap(row => row.type === 'tool-addition' ? [row.toolName] : []);
+    const removed = rows.flatMap(row => row.type === 'tool-removal' ? [row.toolName] : []);
+    return { added, removed, single: rows.length === 1 ? rows[0] : null };
+}
+//# sourceMappingURL=tool-update.js.map

package/lib/types/client/native/tool-update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-update.js","sourceRoot":"","sources":["../../../../src/client/native/tool-update.ts"],"names":[],"mappings":"AAcA;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,OAAyE;IACtG,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACrC,MAAM,IAAI,GAAsB,EAAE,CAAA;IAClC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc;YAAE,OAAO,IAAI,CAAA;QAChF,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAA;QACnD,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAA;IAC3D,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IACrF,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IACtF,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;AACxE,CAAC"}

package/lib/types/client/official-slots.d.ts

@@ -0,0 +1,71 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { SlotEntryDef, SlotMap, SlotSpec, StoredEntry } from '@deepseek-ai/dsh-client-ui-slots';
+/**
+ * RC2 composition adapter. Only public registry operations are used. We lend
+ * registrations a Reader-owned seat, not a second implementation of their UI.
+ * The platform still binds injection, hooks, locale, stores and boundaries.
+ * Original entries, declarations and components are never changed.
+ *
+ * Child seats have unique names because RC2 declarations have one owner. The
+ * sole component wrapper translates those names before delegating to the
+ * framework-provided renderSlot. It does not implement a slot renderer.
+ */
+export declare const OFFICIAL_SLOTS: {
+    readonly actions: "conversation.chat.assistant-actions";
+    readonly tools: "tool.call.toolview";
+    readonly tail: "conversation.chat.turnTail";
+    readonly nodes: "conversation.chat.node";
+    readonly images: "conversation.message.images";
+};
+export type OfficialFamily = keyof typeof OFFICIAL_SLOTS;
+export declare const OFFICIAL_SEATS: {
+    readonly actions: "dsh-better-display.official.actions/conversation.chat.assistant-actions";
+    readonly tools: "dsh-better-display.official.tools/tool.call.toolview";
+    readonly tail: "dsh-better-display.official.tail/conversation.chat.turnTail";
+    readonly nodes: "dsh-better-display.official.nodes/conversation.chat.node";
+    readonly images: "dsh-better-display.official.images/conversation.message.images";
+};
+export type OfficialSeat = typeof OFFICIAL_SEATS[OfficialFamily];
+export declare const officialSeat: (family: OfficialFamily, source?: string) => string;
+type Spec = SlotSpec<SlotEntryDef>;
+type Registration = StoredEntry['options'] & Omit<StoredEntry, 'options' | 'component'> & {
+    name: string;
+};
+/** The documented, type-erased registry inspection/registration boundary. */
+export interface CompositionRegistry {
+    spec(key: string): Spec | undefined;
+    entriesOfSlot(key: string): readonly StoredEntry[];
+    subscribe(key: string, listener: () => void): () => void;
+    inject(key: string, effect: () => () => void): () => void;
+    register(options: Registration, component: unknown): () => void;
+}
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface SlotMap {
+        'dsh-better-display.official.actions/conversation.chat.assistant-actions': SlotMap['conversation.chat.assistant-actions'];
+        'dsh-better-display.official.tools/tool.call.toolview': SlotMap['tool.call.toolview'];
+        'dsh-better-display.official.tail/conversation.chat.turnTail': SlotMap['conversation.chat.turnTail'];
+        'dsh-better-display.official.nodes/conversation.chat.node': SlotMap['conversation.chat.node'];
+        'dsh-better-display.official.images/conversation.message.images': SlotMap['conversation.message.images'];
+    }
+}
+/**
+ * Reader already presents produced paths with its copy/reveal actions. RC2's
+ * official tail additionally owns explicit `present` artifacts. Leave those
+ * cards, actions and state intact, and omit only the duplicate produced chips.
+ * This changes a presentation prop, never the source match or session data.
+ * Unrecognized shapes pass through intact for safe forward degradation.
+ */
+export declare function readerTailMatch(value: unknown, displayedPaths?: readonly string[]): unknown;
+export declare function officialChildren(slots: Pick<CompositionRegistry, 'spec'>): {
+    [K in OfficialSeat]: SlotSpec<SlotMap[K]>;
+};
+/**
+ * Mirror one elected contribution set incrementally. Unrelated additions do not
+ * remount existing cards or recreate their subscriptions. A source unload/HMR
+ * disposes the corresponding subtree and closures before its replacement.
+ */
+export declare function mirrorOfficialSlot(slots: CompositionRegistry, source: string, target: string, namespace: string, accept?: (entry: StoredEntry) => boolean): () => void;
+export declare function installOfficialSlots(ctx: Context): () => void;
+export type OfficialSlotKey = typeof OFFICIAL_SLOTS[OfficialFamily] & keyof SlotMap;
+export {};
+//# sourceMappingURL=official-slots.d.ts.map

package/lib/types/client/official-slots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"official-slots.d.ts","sourceRoot":"","sources":["../../../src/client/official-slots.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAGrG;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc;;;;;;CAMjB,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,cAAc,CAAC;AACzD,eAAO,MAAM,cAAc;;;;;;CAMjB,CAAC;AACX,MAAM,MAAM,YAAY,GAAG,OAAO,cAAc,CAAC,cAAc,CAAC,CAAC;AACjE,eAAO,MAAM,YAAY,GAAI,QAAQ,cAAc,EAAE,SAAQ,MAA+B,WACzC,CAAC;AAEpD,KAAK,IAAI,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;AAGnC,KAAK,YAAY,GAAG,WAAW,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,WAAW,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3G,6EAA6E;AAC7E,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACpC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,WAAW,EAAE,CAAC;IACnD,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IACzD,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAC1D,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,IAAI,CAAC;CACjE;AAED,OAAO,QAAQ,kCAAkC,CAAC;IAChD,UAAU,OAAO;QACf,yEAAyE,EAAE,OAAO,CAAC,qCAAqC,CAAC,CAAC;QAC1H,sDAAsD,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;QACtF,6DAA6D,EAAE,OAAO,CAAC,4BAA4B,CAAC,CAAC;QACrG,0DAA0D,EAAE,OAAO,CAAC,wBAAwB,CAAC,CAAC;QAC9F,gEAAgE,EAAE,OAAO,CAAC,6BAA6B,CAAC,CAAC;KAC1G;CACF;AAaD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAO3F;AAUD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,mBAAmB,EAAE,MAAM,CAAC,GAAG;KAAG,CAAC,IAAI,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;CAAE,CAUxH;AAqBD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,mBAAmB,EAC1B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAoB,GACnD,MAAM,IAAI,CA+CZ;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,IAAI,CAwB7D;AAED,MAAM,MAAM,eAAe,GAAG,OAAO,cAAc,CAAC,cAAc,CAAC,GAAG,MAAM,OAAO,CAAC"}

package/lib/types/client/official-slots.js

@@ -0,0 +1,183 @@
+import { createElement, memo, useMemo } from 'react';
+/**
+ * RC2 composition adapter. Only public registry operations are used. We lend
+ * registrations a Reader-owned seat, not a second implementation of their UI.
+ * The platform still binds injection, hooks, locale, stores and boundaries.
+ * Original entries, declarations and components are never changed.
+ *
+ * Child seats have unique names because RC2 declarations have one owner. The
+ * sole component wrapper translates those names before delegating to the
+ * framework-provided renderSlot. It does not implement a slot renderer.
+ */
+export const OFFICIAL_SLOTS = {
+    actions: 'conversation.chat.assistant-actions',
+    tools: 'tool.call.toolview',
+    tail: 'conversation.chat.turnTail',
+    nodes: 'conversation.chat.node',
+    images: 'conversation.message.images',
+};
+export const OFFICIAL_SEATS = {
+    actions: 'dsh-better-display.official.actions/conversation.chat.assistant-actions',
+    tools: 'dsh-better-display.official.tools/tool.call.toolview',
+    tail: 'dsh-better-display.official.tail/conversation.chat.turnTail',
+    nodes: 'dsh-better-display.official.nodes/conversation.chat.node',
+    images: 'dsh-better-display.official.images/conversation.message.images',
+};
+export const officialSeat = (family, source = OFFICIAL_SLOTS[family]) => `dsh-better-display.official.${family}/${source}`;
+// Existing Reader presentations own these rows. All other node kinds, including
+// future registrations, reach the official renderer through the fallback seat.
+const READER_NODES = new Set(['user', 'steering', 'assistant-step', 'tool-call', 'turn-tail', 'turn-process']);
+const EXPECTED = {
+    actions: { kind: 'list', scope: 'session' },
+    tools: { kind: 'keyed', scope: 'session' },
+    tail: { kind: 'list', scope: 'session' },
+    nodes: { kind: 'keyed', scope: 'session' },
+    images: { kind: 'single', scope: 'session' },
+};
+/**
+ * Reader already presents produced paths with its copy/reveal actions. RC2's
+ * official tail additionally owns explicit `present` artifacts. Leave those
+ * cards, actions and state intact, and omit only the duplicate produced chips.
+ * This changes a presentation prop, never the source match or session data.
+ * Unrecognized shapes pass through intact for safe forward degradation.
+ */
+export function readerTailMatch(value, displayedPaths) {
+    if (!value || typeof value !== 'object')
+        return value;
+    const match = value;
+    const displayed = new Set(displayedPaths ?? []);
+    return displayed.size > 0 && Array.isArray(match.produced) && Array.isArray(match.presented)
+        ? { ...match, produced: match.produced.filter(path => !displayed.has(path)) }
+        : value;
+}
+function tailPresentation(component) {
+    const Original = component;
+    return memo(function ReaderTailPresentation(props) {
+        const matched = useMemo(() => readerTailMatch(props.matched, props.readerProducedPaths), [props.matched, props.readerProducedPaths]);
+        return createElement(Original, { ...props, matched });
+    });
+}
+export function officialChildren(slots) {
+    return Object.fromEntries(Object.entries(OFFICIAL_SLOTS).map(([name, source]) => {
+        const family = name;
+        const spec = slots.spec(source);
+        if (spec && (spec.kind !== EXPECTED[family].kind || spec.scope !== EXPECTED[family].scope)) {
+            throw new Error(`Official slot contract changed: ${source} (${spec.kind}/${spec.scope})`);
+        }
+        // In particular, retain conversation.chat.node's contextual turn-data hook.
+        return [officialSeat(family), spec ?? EXPECTED[family]];
+    }));
+}
+function translatedComponent(entry, names) {
+    if (names.size === 0)
+        return entry.component;
+    const Original = entry.component;
+    return memo(function OfficialSlotChildren(props) {
+        const renders = useMemo(() => {
+            const translate = (render) => (key, owner, options) => {
+                const seat = names.get(key);
+                if (!seat || !render)
+                    throw new Error(`Undeclared official child slot: ${key}`);
+                return render(seat, owner, options);
+            };
+            return {
+                renderSlot: translate(props.renderSlot),
+                ...(props.renderSlotChain ? { renderSlotChain: translate(props.renderSlotChain) } : {}),
+            };
+        }, [props.renderSlot, props.renderSlotChain]);
+        return createElement(Original, { ...props, ...renders });
+    });
+}
+/**
+ * Mirror one elected contribution set incrementally. Unrelated additions do not
+ * remount existing cards or recreate their subscriptions. A source unload/HMR
+ * disposes the corresponding subtree and closures before its replacement.
+ */
+export function mirrorOfficialSlot(slots, source, target, namespace, accept = () => true) {
+    const mounted = new Map();
+    let stopped = false;
+    const reconcile = () => {
+        if (stopped)
+            return;
+        const entries = slots.entriesOfSlot(source).filter(accept);
+        const wanted = new Set(entries);
+        for (const [entry, dispose] of mounted) {
+            if (wanted.has(entry))
+                continue;
+            dispose();
+            mounted.delete(entry);
+        }
+        for (const entry of entries) {
+            if (mounted.has(entry))
+                continue;
+            const names = new Map(Object.keys(entry.children ?? {}).map(key => [key, `${namespace}/${key}`]));
+            const children = Object.fromEntries([...names].map(([key, seat]) => [seat, entry.children[key]]));
+            const disposers = [];
+            const dispose = () => { for (const stop of disposers.splice(0).reverse())
+                stop(); };
+            try {
+                const { component: _component, options, children: _children, ...metadata } = entry;
+                const presentation = source === OFFICIAL_SLOTS.tail && entry.locale === 'deliverables'
+                    ? { ...entry, component: tailPresentation(entry.component) }
+                    : entry;
+                disposers.push(slots.register({
+                    ...options, ...metadata, name: target,
+                    ...(names.size ? { children } : {}),
+                    registrant: `dsh-better-display → ${entry.registrant ?? source}`,
+                }, translatedComponent(presentation, names)));
+                for (const [key, seat] of names) {
+                    disposers.push(mirrorOfficialSlot(slots, key, seat, namespace));
+                }
+                mounted.set(entry, dispose);
+            }
+            catch (error) {
+                dispose();
+                throw error;
+            }
+        }
+    };
+    const unsubscribe = slots.subscribe(source, reconcile);
+    const dispose = () => {
+        stopped = true;
+        unsubscribe();
+        for (const stop of [...mounted.values()].reverse())
+            stop();
+        mounted.clear();
+    };
+    try {
+        reconcile();
+    }
+    catch (error) {
+        dispose();
+        throw error;
+    }
+    return dispose;
+}
+export function installOfficialSlots(ctx) {
+    // The SlotMap overloads are for statically declared keys. Aliases are a
+    // runtime composition, using exactly the public erased metadata contract.
+    const slots = ctx.slots;
+    const disposers = [];
+    try {
+        for (const [name, source] of Object.entries(OFFICIAL_SLOTS)) {
+            const family = name;
+            disposers.push(slots.inject(source, () => {
+                const spec = slots.spec(source);
+                const target = officialSeat(family);
+                const declared = slots.spec(target);
+                if (spec.kind !== declared?.kind || spec.scope !== declared.scope) {
+                    throw new Error(`Official slot contract changed: ${source}`);
+                }
+                return mirrorOfficialSlot(slots, source, target, `dsh-better-display.official.${family}`, family === 'nodes' ? entry => !READER_NODES.has(entry.options.key ?? '') : undefined);
+            }));
+        }
+    }
+    catch (error) {
+        for (const stop of disposers.reverse())
+            stop();
+        throw error;
+    }
+    return () => { for (const stop of disposers.splice(0).reverse())
+        stop(); };
+}
+//# sourceMappingURL=official-slots.js.map

package/lib/types/client/official-slots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"official-slots.js","sourceRoot":"","sources":["../../../src/client/official-slots.tsx"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,29 @@
+export type DeliverableOpenMode = 'external' | 'sidebar';
+export interface OpenModeSnapshot {
+    getSnapshot: () => {
+        deliverableOpenMode?: DeliverableOpenMode;
+    };
+    subscribe?: (fn: () => void) => () => void;
+}
+export declare function deliverableOpenModeOf(value: unknown): DeliverableOpenMode;
+export declare function modeFromSnapshot(store: OpenModeSnapshot | undefined): DeliverableOpenMode;
+/** Workspace-folder affordances stay on the OS opener, not the Sidebar switch. */
+export declare function isFolderOpenPath(path: string): boolean;
+/**
+ * Session-scoped `dsh-resource://file/session/<id>/…` address.
+ * Matches official `fileAddressFor` / `sessionFileAddress` (0.1.5).
+ */
+export declare function fileAddressFor(sessionId: string, cwd: string | undefined, path: string): string;
+export declare function resolveOpenWorkspacePath(cwd: string | undefined, path: string, resolveWorkspacePath: (cwd: string | undefined, path: string) => string): string;
+export declare function openDeliverableFile(args: {
+    path: string;
+    mode: DeliverableOpenMode;
+    sessionId: string;
+    cwd: string | undefined;
+    resolveWorkspacePath: (cwd: string | undefined, path: string) => string;
+    openExternal: (absolutePath: string) => Promise<void>;
+    openSidebar?: (address: string) => void;
+    fileAddressFor?: (sessionId: string, cwd: string | undefined, path: string) => string;
+    warn?: (message: string, extra?: unknown) => void;
+}): Promise<'sidebar' | 'external'>;
+//# sourceMappingURL=open-file.d.ts.map

package/lib/types/client/open-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-file.d.ts","sourceRoot":"","sources":["../../../src/client/open-file.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,SAAS,CAAC;AAEzD,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM;QAAE,mBAAmB,CAAC,EAAE,mBAAmB,CAAA;KAAE,CAAC;IACjE,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;CAC5C;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAEzE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,GAAG,SAAS,GAAG,mBAAmB,CAMzF;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAkBD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAW/F;AAED,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,IAAI,EAAE,MAAM,EACZ,oBAAoB,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,GACtE,MAAM,CAER;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,mBAAmB,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,oBAAoB,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACxE,YAAY,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACtF,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CACnD,GAAG,OAAO,CAAC,SAAS,GAAG,UAAU,CAAC,CAkBlC"}