@treeseed/dsh-chapters 0.1.0

package/lib/arrival.js

@@ -0,0 +1,86 @@
+/**
+ * Arrival-time artifacting (record architecture.md amendment, 2026-09-19):
+ * tool results at or above the floor never get to become context. The blob
+ * goes to the content-addressed artifact store; the surface node is replaced
+ * IN PLACE (the pruner's proven single-node form: a shadowing event + a
+ * replacement append carrying `surfaceOp: replace`) with a stub that cites
+ * the path and the query tool. Runs at the head of compactIfNeeded/compactNow,
+ * i.e. inside the awaited `agent/pre-step` chain, BEFORE the next request is
+ * composed — so the blob is prefilled zero times, ever.
+ *
+ * A plain factory over structural shims, per house rule (the r28 lesson:
+ * the LOGIC must be L0-testable against the real host Session shape).
+ */
+import { artifactPath, sha256 } from "./render.js";
+import fs from 'node:fs/promises';
+import path from 'node:path';
+export const ARRIVAL_MARKER = '[dsh:artifact';
+const kb = (n) => n < 1024 ? `${n} B` : `${(n / 1024).toFixed(1)} KB`;
+export async function applyArrivalStubs(session, opts) {
+    let stubbed = 0;
+    for (const seq of [...session.surface.nodes]) {
+        const event = session.eventAt(seq);
+        if (event?.type !== 'tool/result')
+            continue;
+        const data = event.data;
+        if (data?.message === undefined)
+            continue;
+        // REAL shape (measured e2e, 2026-09-19): message.content blocks are
+        // { type: 'tool-result', toolCallId, isError, content: [{type:'text',text}] }
+        // — the text is nested one level below the wrapper. A unit fixture that
+        // invented a flat shape hid this for a whole run; the fake mirrors the
+        // real from now on.
+        const blocks = Array.isArray(data.message.content) ? data.message.content : [];
+        const wrappers = blocks.filter((b) => b.type === 'tool-result');
+        if (wrappers.length === 0)
+            continue;
+        const textOf = (w) => Array.isArray(w.content)
+            ? w.content.filter((c) => c.type === 'text').map((c) => c.text ?? '').join('')
+            : typeof w.content === 'string' ? w.content : '';
+        const text = wrappers.map(textOf).join('');
+        if (text.length === 0 || text.includes(ARRIVAL_MARKER))
+            continue;
+        const tokens = opts.estimate(data.message);
+        if (tokens < opts.floorTokens)
+            continue;
+        const hash = sha256(text);
+        const rel = artifactPath(hash);
+        const abs = path.join(opts.cwd, opts.storeRoot, rel);
+        try {
+            await fs.mkdir(path.dirname(abs), { recursive: true, mode: 0o700 });
+            // content-addressed: rewriting identical bytes is a no-op by definition
+            await fs.writeFile(abs, text, 'utf8');
+        }
+        catch (error) {
+            // the blob stays inline — arrival artifacting is an optimization, and a
+            // disk problem must never eat the conversation (loud via detail).
+            return { stubbed, detail: `artifact write failed (${String(error?.message ?? error)}); ${stubbed} node(s) stubbed before the failure` };
+        }
+        const stub = `${ARRIVAL_MARKER} ${hash.slice(0, 12)}] ${kb(text.length)} ≈ ${tokens} tok stored at ${rel} — query it with chapters_artifact (path '${rel}' or the sha): action 'toc' for the heading map with line numbers, 'search' for term hits as small blocks, 'read' for exact line ranges. The full result is NOT elsewhere in this context; re-running the original tool only recreates it.`;
+        const stubbedWrappers = wrappers.map((w, i) => ({
+            ...w, content: [{ type: 'text', text: i === 0 ? stub : '' }],
+        }));
+        const message = {
+            ...data.message,
+            content: [...blocks.filter((b) => b.type !== 'tool-result'), ...stubbedWrappers],
+        };
+        try {
+            session.append('compaction/prune', {
+                shadowedRange: { start: seq, end: seq },
+                shadowedSeqs: [seq],
+                shadowedTokenCount: tokens,
+                by: 'dsh-chapters-arrival',
+            });
+            session.append('tool/result', { ...data, message }, {
+                surfaceOp: { op: 'replace', startSeq: seq, endSeq: seq },
+                sourceEventSeqs: [seq],
+            });
+            stubbed++;
+        }
+        catch (error) {
+            return { stubbed, detail: `surface replace refused at seq ${seq} (${String(error?.message ?? error)})` };
+        }
+    }
+    return { stubbed };
+}
+//# sourceMappingURL=arrival.js.map

package/lib/arrival.js.map

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

package/lib/artifact-query.d.ts

@@ -0,0 +1,53 @@
+export type TocEntry = {
+    line: number;
+    depth: number;
+    title: string;
+};
+/**
+ * Resolve a user/model-supplied reference to an absolute artifact path INSIDE
+ * the store. Accepts a 64-hex sha, 'artifacts/xx/<sha>.txt', or an absolute
+ * path. Throws on anything escaping the store — this tool is read-only, the
+ * containment is the whole security story.
+ */
+export declare function resolveArtifactPath(storeDir: string, ref: string): string;
+/**
+ * Markdown heading map with 1-based line numbers — a 300-page book arrives
+ * with its own table of contents (fenced code blocks are skipped so '#
+ * comments' inside them never masquerade as headings).
+ */
+export declare function buildToc(text: string, maxEntries?: number): {
+    entries: TocEntry[];
+    truncated: boolean;
+};
+export type SearchBlock = {
+    start: number;
+    end: number;
+    lines: string[];
+};
+/**
+ * Case-insensitive query over lines: regex when it compiles, literal phrase
+ * otherwise. Matches expand to ±context lines and overlapping windows merge;
+ * the pack stops at maxTokens and REPORTS what it left behind.
+ */
+export declare function searchArtifact(text: string, query: string, opts?: {
+    maxTokens?: number;
+    contextLines?: number;
+}): {
+    total: number;
+    blocks: SearchBlock[];
+    truncated: boolean;
+    remaining: number;
+};
+/** Exact line window (1-based inclusive), capped per call; bounds reported. */
+export declare function readLines(text: string, offset: number, limit: number, hardCap?: number): {
+    start: number;
+    end: number;
+    of: number;
+    lines: string[];
+};
+/** Load an artifact with a size guard; returns text + totals for the pack. */
+export declare function loadArtifact(absPath: string): {
+    text: string;
+    bytes: number;
+    lines: number;
+};

package/lib/artifact-query.js

@@ -0,0 +1,130 @@
+/**
+ * Artifact query surface (arrival-time artifacting plan, Phase 3): pure,
+ * bounded readers over content-addressed artifact files. The point of this
+ * module is that a stored blob is USEFUL without ever being loaded whole —
+ * toc/search/read are the small-block windows the RLM result calls an
+ * 'external environment', implemented with files and line numbers instead
+ * of a code sandbox. Every function is deterministic and refuses rather
+ * than silently clipping (bounds reported, never applied by truncation
+ * without a flag).
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+/** Rough token estimate consistent with the est-token convention elsewhere (chars/4). */
+const estTokens = (s) => Math.ceil(s.length / 4);
+/**
+ * Resolve a user/model-supplied reference to an absolute artifact path INSIDE
+ * the store. Accepts a 64-hex sha, 'artifacts/xx/<sha>.txt', or an absolute
+ * path. Throws on anything escaping the store — this tool is read-only, the
+ * containment is the whole security story.
+ */
+export function resolveArtifactPath(storeDir, ref) {
+    const clean = ref.trim();
+    if (/^[0-9a-f]{64}$/.test(clean))
+        return path.join(storeDir, 'artifacts', clean.slice(0, 2), `${clean}.txt`);
+    const abs = path.isAbsolute(clean) ? path.normalize(clean) : path.normalize(path.join(storeDir, clean));
+    const root = path.resolve(storeDir);
+    if (abs !== root && !abs.startsWith(root + path.sep))
+        throw new Error(`artifact reference escapes the store: ${ref}`);
+    return abs;
+}
+/**
+ * Markdown heading map with 1-based line numbers — a 300-page book arrives
+ * with its own table of contents (fenced code blocks are skipped so '#
+ * comments' inside them never masquerade as headings).
+ */
+export function buildToc(text, maxEntries = 400) {
+    const entries = [];
+    let inFence = false;
+    let fenceMarker = '';
+    let lineNo = 0;
+    for (const line of text.split('\n')) {
+        lineNo++;
+        const fence = /^\s{0,3}(`{3,}|~{3,})/.test(line);
+        if (fence) {
+            const marker = line.trim().slice(0, 3);
+            if (!inFence) {
+                inFence = true;
+                fenceMarker = marker[0];
+            }
+            else if (marker[0] === fenceMarker) {
+                inFence = false;
+            }
+            continue;
+        }
+        if (inFence)
+            continue;
+        const m = /^(#{1,6})\s+(.*)$/.exec(line);
+        if (m === null)
+            continue;
+        if (entries.length >= maxEntries)
+            return { entries, truncated: true };
+        entries.push({ line: lineNo, depth: m[1].length, title: m[2].trim().slice(0, 120) });
+    }
+    return { entries, truncated: false };
+}
+/**
+ * Case-insensitive query over lines: regex when it compiles, literal phrase
+ * otherwise. Matches expand to ±context lines and overlapping windows merge;
+ * the pack stops at maxTokens and REPORTS what it left behind.
+ */
+export function searchArtifact(text, query, opts = {}) {
+    const maxTokens = opts.maxTokens ?? 400;
+    const context = opts.contextLines ?? 2;
+    const lines = text.split('\n');
+    let re = null;
+    try {
+        re = new RegExp(query, 'i');
+    }
+    catch {
+        re = null;
+    }
+    const hit = (l) => re !== null ? re.test(l) : l.toLowerCase().includes(query.trim().toLowerCase());
+    const matched = [];
+    for (let i = 0; i < lines.length; i++)
+        if (hit(lines[i]))
+            matched.push(i);
+    const blocks = [];
+    let used = 0;
+    for (const idx of matched) {
+        const start = Math.max(0, idx - context);
+        const end = Math.min(lines.length - 1, idx + context);
+        const last = blocks[blocks.length - 1];
+        if (last !== undefined && start <= last.end + 1) {
+            if (end > last.end) {
+                const add = lines.slice(last.end + 1, end + 1).map((l, k) => `${last.end + 2 + k}: ${l.slice(0, 400)}`).join('\n');
+                const addTokens = estTokens(add);
+                if (used + addTokens > maxTokens)
+                    break;
+                last.lines.push(...lines.slice(last.end + 1, end + 1).map((l, k) => `${last.end + 2 + k}: ${l.slice(0, 400)}`));
+                last.end = end;
+                used += addTokens;
+            }
+            continue;
+        }
+        const chunk = lines.slice(start, end + 1).map((l, k) => `${start + k + 1}: ${l.slice(0, 400)}`);
+        const tokens = estTokens(chunk.join('\n'));
+        if (used + tokens > maxTokens)
+            break;
+        blocks.push({ start: start + 1, end: end + 1, lines: chunk });
+        used += tokens;
+    }
+    const lastIncluded = blocks.length === 0 ? -1 : blocks[blocks.length - 1].end - 1;
+    const remaining = matched.filter((i) => i > lastIncluded).length;
+    return { total: matched.length, blocks, truncated: remaining > 0, remaining };
+}
+/** Exact line window (1-based inclusive), capped per call; bounds reported. */
+export function readLines(text, offset, limit, hardCap = 400) {
+    const lines = text.split('\n');
+    const start = Math.max(1, Math.floor(offset));
+    const want = Math.max(1, Math.floor(limit));
+    const take = Math.min(want, hardCap);
+    const end = Math.min(lines.length, start + take - 1);
+    return { start, end, of: lines.length, lines: lines.slice(start - 1, end).map((l, k) => `${start + k}: ${l.slice(0, 1000)}`) };
+}
+/** Load an artifact with a size guard; returns text + totals for the pack. */
+export function loadArtifact(absPath) {
+    const st = fs.statSync(absPath);
+    return { text: fs.readFileSync(absPath, 'utf8'), bytes: st.size, lines: 0 };
+}
+//# sourceMappingURL=artifact-query.js.map

package/lib/artifact-query.js.map

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

package/lib/client.js

@@ -0,0 +1,234 @@
+window.__ModuleLoader__.load({
+	id: "@treeseed/dsh-chapters",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let react = require("react");
+		let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
+		//#region src/client/index.ts
+		/**
+		* dsh-chapters client entry: the per-message fork action.
+		*
+		* Registers one button into the assistant action row
+		* (`conversation.chat.assistant-actions` — the slot the official feedback
+		* package populates beside copy/branch). Clicking it executes `/chapters-fork`
+		* through `remote.commands` — the exact wire the composer's input line rides —
+		* then SWITCHES the app to the fresh branch:
+		*
+		*   1. `sessions.open(child)` — the client sessions service carries open() on
+		*      its prototype (Playwright-verified against this host; a keys-dump alone
+		*      hid it, which is why an earlier round wrongly gave up on this path);
+		*   2. fallback: click the branch's sidebar row after expanding collapsed
+		*      groups (plugin children can render under collapsed 'Ungrouped' heads);
+		*   3. last resort: an inline note — the branch is durable either way.
+		*
+		* There is deliberately NO second implementation of fork logic here: the
+		* button is a mouth for the host command (watermark, segmentation, budget,
+		* titles, refusal-with-numbers all server-side, all tested). The purity gate
+		* in tsdown.client.config.ts keeps this file cross-plugin-free.
+		*
+		* @module dsh-chapters/src/client
+		*/
+		const inject = [
+			"slots",
+			"remote",
+			"remote.commands",
+			"sessions"
+		];
+		/** Pull the child id and branch title out of the command's durable texts. */
+		const CHILD_ID = /is session (ch-[\w-]+)/;
+		const BRANCH_TITLE = /branch \u201C([^\u201D]+)\u201D is session/;
+		function openByService(sessions, sessionId) {
+			return (async () => {
+				const svc = sessions;
+				if (typeof svc?.open !== "function") return false;
+				try {
+					await svc.refresh?.();
+				} catch {}
+				const started = Date.now();
+				for (;;) try {
+					svc.open(sessionId);
+					return true;
+				} catch {
+					if (Date.now() - started > 4e3) return false;
+					await new Promise((r) => setTimeout(r, 250));
+				}
+			})();
+		}
+		/**
+		* Fallback path: expand collapsed groups / show-more buttons, then click the
+		* newest treeitem whose label contains the branch title (newest-updated sorts
+		* first, so the first match is the fresh branch).
+		*/
+		async function openBranchRow(title, budgetMs = 4e3) {
+			if (typeof document === "undefined") return false;
+			const needle = title.toLowerCase();
+			const tryClick = () => {
+				const hit = Array.from(document.querySelectorAll("[role=\"treeitem\"]")).find((row) => (row.textContent ?? "").toLowerCase().includes(needle));
+				if (hit === void 0) return false;
+				hit.click();
+				return true;
+			};
+			const clickMore = () => {
+				const buttons = Array.from(document.querySelectorAll("button")).filter((b) => /more sessions|ungrouped/i.test(b.textContent ?? "") && b.getAttribute("aria-expanded") !== "true");
+				for (const b of buttons) b.click();
+				return buttons.length;
+			};
+			const started = Date.now();
+			let expansions = 0;
+			while (Date.now() - started < budgetMs) {
+				if (tryClick()) return true;
+				if (expansions < 4 && clickMore() > 0) {
+					expansions += 1;
+					await new Promise((r) => setTimeout(r, 250));
+					continue;
+				}
+				await new Promise((resolve) => setTimeout(resolve, 150));
+			}
+			return tryClick();
+		}
+		function makeForker(remote, sessions) {
+			return async function fork(sessionId) {
+				try {
+					if (remote.commands?.execute === void 0) return {
+						ok: false,
+						message: "commands remote unavailable"
+					};
+					const res = await remote.commands.execute(sessionId, "/chapters-fork", []);
+					if (res.ok !== true) return {
+						ok: false,
+						message: (res.error?.message ?? "the fork call failed").slice(0, 90)
+					};
+					const result = res.value?.result;
+					const text = typeof result?.text === "string" ? result.text : "";
+					if (result?.kind !== "success") return {
+						ok: false,
+						message: (text || "the fork was refused — see the command result").slice(0, 90)
+					};
+					const child = CHILD_ID.exec(text)?.[1];
+					if (child === void 0) return {
+						ok: true,
+						message: "forked — the branch is appearing in the sidebar"
+					};
+					if (await openByService(sessions, child)) return {
+						ok: true,
+						message: ""
+					};
+					const title = BRANCH_TITLE.exec(text)?.[1];
+					if (title !== void 0 && await openBranchRow(title)) return {
+						ok: true,
+						message: ""
+					};
+					return {
+						ok: true,
+						message: "forked — open the branch in the sidebar"
+					};
+				} catch (error) {
+					return {
+						ok: false,
+						message: String(error?.message ?? error).slice(0, 90)
+					};
+				}
+			};
+		}
+		/**
+		* Style parity with the native IconActions row: rules copied verbatim from the
+		* host's MessageIconActions module (`._xzv4MW_action` in dsh-client-ui-chat's
+		* compiled client + the feedback package's :disabled) — same metrics, tokens,
+		* hover. Update this string if the host restyles its action row.
+		*
+		* The final rule hides the native branch action IN THE MESSAGE ROW only
+		* (user-approved cosmetic decision, docs/architecture.md): built-in chrome, so
+		* the selector is its accessible label scoped to action-row buttons; both
+		* locale spellings covered. If the host rewords the label the button simply
+		* reappears — fails open, visibly.
+		*/
+		const CSS = [
+			".dsh-chapters_forkAction{width:calc(28px + var(--dsh-content-font-delta,0px));height:calc(28px + var(--dsh-content-font-delta,0px));color:var(--dsw-alias-label-tertiary);cursor:pointer;background:0 0;border:none;border-radius:28px;justify-content:center;align-items:center;padding:6px;display:inline-flex}",
+			".dsh-chapters_forkAction svg{width:calc(15px + var(--dsh-content-font-delta,0px));height:calc(15px + var(--dsh-content-font-delta,0px))}",
+			".dsh-chapters_forkAction:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-secondary)}",
+			".dsh-chapters_forkAction:disabled{cursor:default;opacity:.4}",
+			".dsh-chapters_forkNote{color:var(--dsw-alias-label-tertiary);padding-left:4px;font-size:13px;line-height:20px}",
+			"button[class*=\"_action\"][aria-label=\"Branch into a new conversation\"],button[class*=\"_action\"][aria-label=\"在新对话中分支\"]{display:none !important}"
+		].join("\n");
+		const CSS_TAG_ID = "dsh-chapters/assistant-action.css";
+		function injectStyles() {
+			try {
+				if (typeof document === "undefined" || document.querySelector(`style[data-plugin-css=${JSON.stringify(CSS_TAG_ID)}]`) !== null) return;
+				const tag = document.createElement("style");
+				tag.dataset.plugin = "dsh-chapters";
+				tag.dataset.pluginCss = CSS_TAG_ID;
+				tag.textContent = CSS;
+				document.head.appendChild(tag);
+			} catch {}
+		}
+		function ChaptersForkAction({ fork }) {
+			const [busy, setBusy] = (0, react.useState)(false);
+			const [note, setNote] = (0, react.useState)(null);
+			const alive = (0, react.useRef)(true);
+			(0, react.useEffect)(() => () => {
+				alive.current = false;
+			}, []);
+			const onClick = (0, react.useCallback)(() => {
+				if (busy) return;
+				setBusy(true);
+				setNote(null);
+				fork().then((result) => {
+					if (!alive.current) return;
+					setBusy(false);
+					setNote(result.message === "" ? null : result.message);
+					setTimeout(() => {
+						if (alive.current) setNote(null);
+					}, 8e3);
+				});
+			}, [busy, fork]);
+			const button = (0, react.createElement)("button", {
+				type: "button",
+				"aria-label": "Fork with chapters",
+				disabled: busy,
+				onClick,
+				className: "dsh-chapters_forkAction"
+			}, (0, react.createElement)("svg", {
+				viewBox: "0 0 16 16",
+				width: "15",
+				height: "15",
+				fill: "currentColor",
+				"aria-hidden": "true"
+			}, (0, react.createElement)("path", { d: "M5 3.25a2.25 2.25 0 1 0-1.5 2.12v5.26a2.25 2.25 0 1 0 1.5 0V9h5a2.25 2.25 0 0 0 2.25-2.25v-1.4a2.25 2.25 0 1 0-1.5 0v1.4A.75.75 0 0 1 10 7.5H5V5.37A2.25 2.25 0 0 0 5 3.25Z" })));
+			return (0, react.createElement)("span", { style: {
+				display: "inline-flex",
+				alignItems: "center",
+				gap: "4px"
+			} }, (0, react.createElement)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
+				label: "Fork with chapters",
+				side: "bottom",
+				children: button
+			}), note !== null ? (0, react.createElement)("span", { className: "dsh-chapters_forkNote" }, note) : null);
+		}
+		function apply(ctx) {
+			injectStyles();
+			const slots = ctx.slots;
+			const remote = ctx.get("remote") ?? {};
+			let sessions;
+			try {
+				sessions = ctx.get("sessions");
+			} catch {
+				sessions = void 0;
+			}
+			const fork = makeForker(remote, sessions);
+			slots.inject("conversation.chat.assistant-actions", () => slots.register({
+				name: "conversation.chat.assistant-actions",
+				id: "chapters-fork",
+				order: 30,
+				inject: (sessionId) => ({ fork: () => fork(sessionId) })
+			}, ChaptersForkAction));
+		}
+		//#endregion
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map

package/lib/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","names":["useState","useRef","useCallback","h","Tooltip"],"sources":["../src/client/index.ts"],"sourcesContent":["/**\n * dsh-chapters client entry: the per-message fork action.\n *\n * Registers one button into the assistant action row\n * (`conversation.chat.assistant-actions` — the slot the official feedback\n * package populates beside copy/branch). Clicking it executes `/chapters-fork`\n * through `remote.commands` — the exact wire the composer's input line rides —\n * then SWITCHES the app to the fresh branch:\n *\n *   1. `sessions.open(child)` — the client sessions service carries open() on\n *      its prototype (Playwright-verified against this host; a keys-dump alone\n *      hid it, which is why an earlier round wrongly gave up on this path);\n *   2. fallback: click the branch's sidebar row after expanding collapsed\n *      groups (plugin children can render under collapsed 'Ungrouped' heads);\n *   3. last resort: an inline note — the branch is durable either way.\n *\n * There is deliberately NO second implementation of fork logic here: the\n * button is a mouth for the host command (watermark, segmentation, budget,\n * titles, refusal-with-numbers all server-side, all tested). The purity gate\n * in tsdown.client.config.ts keeps this file cross-plugin-free.\n *\n * @module dsh-chapters/src/client\n */\n\nimport { createElement as h, useCallback, useEffect, useRef, useState, type ReactElement } from 'react'\n// The host's own tooltip bubble — a platform module served by the loader table,\n// external like react. Every action in this row labels through it.\nimport { Tooltip } from '@deepseek-ai/dsh-client-ui-primitives'\n\n/** Structural slice of the aggregated remote service (@deepseek-ai/dsh-api-remotes).\n * `remote.commands` must ALSO appear in inject — the federation gates each\n * sub-service individually (the live feedback package declares\n * remote.messageFeedback beside remote for exactly this reason). */\ninterface ClientRemote {\n  commands?: {\n    execute(sessionId: string, line: string, attachments: readonly unknown[]): Promise<{\n      ok?: boolean\n      value?: { commandId?: string; result?: { kind?: string; text?: string } }\n      error?: { code?: string; message?: string }\n    }>\n  }\n}\n\ninterface ClientSlots {\n  inject(name: string, factory: () => unknown): void\n  register(registration: Record<string, unknown>, component: unknown): unknown\n}\n\n/** The client sessions service (dsh-client-runtime): open() lives on the\n * prototype; everything else on the surface stays untrusted and unused. */\ninterface ClientSessions {\n  open(sessionId: string): unknown\n}\n\ninterface Ctx {\n  slots: ClientSlots\n  get(name: string): unknown\n}\n\nexport const inject = ['slots', 'remote', 'remote.commands', 'sessions'] as const\n\n/** Pull the child id and branch title out of the command's durable texts. */\nconst CHILD_ID = /is session (ch-[\\w-]+)/\nconst BRANCH_TITLE = /branch \\u201C([^\\u201D]+)\\u201D is session/\n\nfunction openByService(sessions: ClientSessions | undefined, sessionId: string): Promise<boolean> {\n  return (async () => {\n    const svc = sessions as unknown as { open?: (id: string) => unknown; refresh?: () => unknown } | undefined\n    if (typeof svc?.open !== 'function') return false\n    try { await svc.refresh?.() } catch { /* refresh best-effort */ }\n    // The store must know the session before open() resolves it; a child\n    // created seconds ago is only server-known until refresh lands. Retry\n    // open briefly across that window.\n    const started = Date.now()\n    for (;;) {\n      try { svc.open(sessionId); return true } catch {\n        if (Date.now() - started > 4_000) return false\n        await new Promise((r) => setTimeout(r, 250))\n      }\n    }\n  })()\n}\n\n/**\n * Fallback path: expand collapsed groups / show-more buttons, then click the\n * newest treeitem whose label contains the branch title (newest-updated sorts\n * first, so the first match is the fresh branch).\n */\nasync function openBranchRow(title: string, budgetMs = 4_000): Promise<boolean> {\n  if (typeof document === 'undefined') return false\n  const needle = title.toLowerCase()\n  const tryClick = (): boolean => {\n    const rows = Array.from(document.querySelectorAll<HTMLElement>('[role=\"treeitem\"]'))\n    const hit = rows.find((row) => (row.textContent ?? '').toLowerCase().includes(needle))\n    if (hit === undefined) return false\n    hit.click()\n    return true\n  }\n  const clickMore = (): number => {\n    const buttons = Array.from(document.querySelectorAll<HTMLElement>('button'))\n      .filter((b) => /more sessions|ungrouped/i.test(b.textContent ?? '') && b.getAttribute('aria-expanded') !== 'true')\n    for (const b of buttons) b.click()\n    return buttons.length\n  }\n  const started = Date.now()\n  let expansions = 0\n  while (Date.now() - started < budgetMs) {\n    if (tryClick()) return true\n    if (expansions < 4 && clickMore() > 0) { expansions += 1; await new Promise((r) => setTimeout(r, 250)); continue }\n    await new Promise((resolve) => setTimeout(resolve, 150))\n  }\n  return tryClick()\n}\n\nfunction makeForker(remote: ClientRemote, sessions: ClientSessions | undefined) {\n  return async function fork(sessionId: string): Promise<{ ok: boolean; message: string }> {\n    try {\n      if (remote.commands?.execute === undefined) return { ok: false, message: 'commands remote unavailable' }\n      const res = await remote.commands.execute(sessionId, '/chapters-fork', [])\n      if (res.ok !== true) return { ok: false, message: (res.error?.message ?? 'the fork call failed').slice(0, 90) }\n      const result = res.value?.result\n      const text = typeof result?.text === 'string' ? result.text : ''\n      if (result?.kind !== 'success') return { ok: false, message: (text || 'the fork was refused — see the command result').slice(0, 90) }\n      const child = CHILD_ID.exec(text)?.[1]\n      if (child === undefined) return { ok: true, message: 'forked — the branch is appearing in the sidebar' }\n      const opened = await openByService(sessions, child)\n      if (opened) return { ok: true, message: '' }\n      const title = BRANCH_TITLE.exec(text)?.[1]\n      if (title !== undefined && await openBranchRow(title)) return { ok: true, message: '' }\n      return { ok: true, message: 'forked — open the branch in the sidebar' }\n    } catch (error) {\n      return { ok: false, message: String((error as Error)?.message ?? error).slice(0, 90) }\n    }\n  }\n}\n\n/** Props composed by the slot framework: owner (`messageId`) + our injected verb. */\ninterface ForkActionProps {\n  messageId: string\n  fork: () => Promise<{ ok: boolean; message: string }>\n}\n\n/**\n * Style parity with the native IconActions row: rules copied verbatim from the\n * host's MessageIconActions module (`._xzv4MW_action` in dsh-client-ui-chat's\n * compiled client + the feedback package's :disabled) — same metrics, tokens,\n * hover. Update this string if the host restyles its action row.\n *\n * The final rule hides the native branch action IN THE MESSAGE ROW only\n * (user-approved cosmetic decision, docs/architecture.md): built-in chrome, so\n * the selector is its accessible label scoped to action-row buttons; both\n * locale spellings covered. If the host rewords the label the button simply\n * reappears — fails open, visibly.\n */\nconst CSS = [\n  '.dsh-chapters_forkAction{width:calc(28px + var(--dsh-content-font-delta,0px));height:calc(28px + var(--dsh-content-font-delta,0px));color:var(--dsw-alias-label-tertiary);cursor:pointer;background:0 0;border:none;border-radius:28px;justify-content:center;align-items:center;padding:6px;display:inline-flex}',\n  '.dsh-chapters_forkAction svg{width:calc(15px + var(--dsh-content-font-delta,0px));height:calc(15px + var(--dsh-content-font-delta,0px))}',\n  '.dsh-chapters_forkAction:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-secondary)}',\n  '.dsh-chapters_forkAction:disabled{cursor:default;opacity:.4}',\n  '.dsh-chapters_forkNote{color:var(--dsw-alias-label-tertiary);padding-left:4px;font-size:13px;line-height:20px}',\n  'button[class*=\"_action\"][aria-label=\"Branch into a new conversation\"],button[class*=\"_action\"][aria-label=\"\\u5728\\u65b0\\u5bf9\\u8bdd\\u4e2d\\u5206\\u652f\"]{display:none !important}',\n].join('\\n')\nconst CSS_TAG_ID = 'dsh-chapters/assistant-action.css'\n\nfunction injectStyles(): void {\n  try {\n    if (typeof document === 'undefined' || document.querySelector(`style[data-plugin-css=${JSON.stringify(CSS_TAG_ID)}]`) !== null) return\n    const tag = document.createElement('style')\n    tag.dataset.plugin = 'dsh-chapters'\n    tag.dataset.pluginCss = CSS_TAG_ID\n    tag.textContent = CSS\n    document.head.appendChild(tag)\n  } catch { /* styling is cosmetic; the action still works without it */ }\n}\n\nfunction ChaptersForkAction({ fork }: ForkActionProps) {\n  const [busy, setBusy] = useState(false)\n  const [note, setNote] = useState<string | null>(null)\n  const alive = useRef(true)\n  useEffect(() => () => { alive.current = false }, [])\n  const onClick = useCallback(() => {\n    if (busy) return\n    setBusy(true)\n    setNote(null)\n    void fork().then((result) => {\n      if (!alive.current) return\n      setBusy(false)\n      setNote(result.message === '' ? null : result.message)\n      setTimeout(() => { if (alive.current) setNote(null) }, 8000)\n    })\n  }, [busy, fork])\n  const button = h('button', {\n    type: 'button',\n    'aria-label': 'Fork with chapters',\n    disabled: busy,\n    onClick,\n    className: 'dsh-chapters_forkAction',\n  },\n    h('svg', { viewBox: '0 0 16 16', width: '15', height: '15', fill: 'currentColor', 'aria-hidden': 'true' },\n      h('path', { d: 'M5 3.25a2.25 2.25 0 1 0-1.5 2.12v5.26a2.25 2.25 0 1 0 1.5 0V9h5a2.25 2.25 0 0 0 2.25-2.25v-1.4a2.25 2.25 0 1 0-1.5 0v1.4A.75.75 0 0 1 10 7.5H5V5.37A2.25 2.25 0 0 0 5 3.25Z' })))\n  return h('span', { style: { display: 'inline-flex', alignItems: 'center', gap: '4px' } },\n    h(Tooltip, { label: 'Fork with chapters', side: 'bottom' as const, children: button as ReactElement<Record<string, unknown>> }),\n    note !== null\n      ? h('span', { className: 'dsh-chapters_forkNote' }, note)\n      : null)\n}\n\nexport function apply(ctx: Ctx): void {\n  injectStyles()\n  const slots = ctx.slots\n  const remote = (ctx.get('remote') ?? {}) as ClientRemote\n  let sessions: ClientSessions | undefined\n  try { sessions = ctx.get('sessions') as ClientSessions | undefined } catch { sessions = undefined }\n  // No early return on missing descriptors: the button registers regardless\n  // and the click reports the gap. A missing button is worse than a button\n  // that explains itself.\n  const fork = makeForker(remote, sessions)\n  slots.inject('conversation.chat.assistant-actions', () => slots.register({\n    name: 'conversation.chat.assistant-actions',\n    id: 'chapters-fork',\n    order: 30,\n    inject: (sessionId: string) => ({ fork: () => fork(sessionId) }),\n  }, ChaptersForkAction))\n}\n"],"mappings":"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"}

package/lib/commands.d.ts

@@ -0,0 +1,28 @@
+import { type SyncScheduler } from './sync.ts';
+import type { DomainLike } from './store.ts';
+import type { ToolsCtx } from './tools.ts';
+/** Structural slice of EnrichWiring the commands need (keeps queue types out). */
+export interface EnrichCommandSurface {
+    runNow(cwd?: string): Promise<{
+        processed: number;
+        remaining: number;
+    }>;
+    setModelOverride(v: string | null): Promise<void>;
+    modelOverride(): string | null;
+    statusLine(): string;
+    pendingCount(): Promise<number>;
+}
+export interface HostCommandsConfig {
+    artifactStoreRoot: string;
+    harnessId: string;
+    /** The sync scheduler to arm after a link (record §5). */
+    scheduler?: SyncScheduler;
+    /** P2 enrichment command surface (host plane; manual-drain semantics). */
+    enrich?: EnrichCommandSurface;
+    /** P3 rule lifecycle family, bound to a workspace (S2 module underneath). */
+    rules?: (cwd: string, args: string) => Promise<{
+        kind: 'success' | 'error';
+        text: string;
+    }>;
+}
+export declare function registerHostCommands(ctx: ToolsCtx, domain: DomainLike, config: HostCommandsConfig): () => void;