@stigmer/react 3.1.1 → 3.1.2

package/internal/file-tree/FileTreeNode.d.ts

@@ -9,6 +9,12 @@ export interface FileTreeNodeProps {
     readonly node: TreeNode;
     readonly selectedPath: string;
     readonly onSelect: (path: string) => void;
+    /**
+     * Optional double-click handler for file nodes. When set, a double-click on a
+     * file calls `onActivate(path)` (used by the workspace surface to pin a
+     * previewed tab); the single click still fires `onSelect`. Folders ignore it.
+     */
+    readonly onActivate?: (path: string) => void;
     readonly depth: number;
     /**
      * When `true`, file nodes (not folders) become draggable and emit
@@ -18,6 +24,17 @@ export interface FileTreeNodeProps {
      * where file referencing is not applicable (e.g., SkillFileBrowser).
      */
     readonly enableDrag?: boolean;
+    /**
+     * When `true`, render monochrome file-type / folder icons before each name
+     * (VS Code explorer feel). Opt-in so drag/skill contexts stay icon-free.
+     */
+    readonly showIcons?: boolean;
+    /**
+     * When `true`, draw vertical indent guides down each nested group and indent
+     * via nested margins rather than per-row left padding. Opt-in; the default
+     * padding-based indentation is preserved for existing consumers.
+     */
+    readonly indentGuides?: boolean;
     /**
      * Maximum depth at which folders start collapsed instead of expanded.
      * Folders at depth >= maxInitialDepth render collapsed by default,
@@ -38,5 +55,5 @@ export interface FileTreeNodeProps {
  * Uses `role="treeitem"` / `role="group"` for a11y and `--stgm-*`
  * theme tokens for all visual properties.
  */
-export declare function FileTreeNode({ node, selectedPath, onSelect, depth, enableDrag, maxInitialDepth, }: FileTreeNodeProps): import("react/jsx-runtime").JSX.Element;
+export declare function FileTreeNode({ node, selectedPath, onSelect, onActivate, depth, enableDrag, showIcons, indentGuides, maxInitialDepth, }: FileTreeNodeProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=FileTreeNode.d.ts.map

package/internal/file-tree/FileTreeNode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FileTreeNode.d.ts","sourceRoot":"","sources":["../../../src/internal/file-tree/FileTreeNode.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;;GAIG;AACH,eAAO,MAAM,aAAa,mCAAmC,CAAC;AAE9D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;;;;OAOG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,EAC3B,IAAI,EACJ,YAAY,EACZ,QAAQ,EACR,KAAK,EACL,UAAkB,EAClB,eAAe,GAChB,EAAE,iBAAiB,2CAoEnB"}
+{"version":3,"file":"FileTreeNode.d.ts","sourceRoot":"","sources":["../../../src/internal/file-tree/FileTreeNode.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;;GAIG;AACH,eAAO,MAAM,aAAa,mCAAmC,CAAC;AAE9D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC;;;;;;;OAOG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,EAC3B,IAAI,EACJ,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,KAAK,EACL,UAAkB,EAClB,SAAiB,EACjB,YAAoB,EACpB,eAAe,GAChB,EAAE,iBAAiB,2CAuFnB"}

package/internal/file-tree/FileTreeNode.js

@@ -2,6 +2,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useCallback, useState } from "react";
 import { cn } from "@stigmer/theme";
+import { FileTypeIcon, FolderTypeIcon } from "../file-icons/index.js";
 /**
  * MIME type used to transfer workspace file-reference data during
  * drag-and-drop. The payload is `JSON.stringify({ path })` where
@@ -18,7 +19,7 @@ export const FILE_REF_MIME = "application/x-stigmer-file-ref";
  * Uses `role="treeitem"` / `role="group"` for a11y and `--stgm-*`
  * theme tokens for all visual properties.
  */
-export function FileTreeNode({ node, selectedPath, onSelect, depth, enableDrag = false, maxInitialDepth, }) {
+export function FileTreeNode({ node, selectedPath, onSelect, onActivate, depth, enableDrag = false, showIcons = false, indentGuides = false, maxInitialDepth, }) {
     const [expanded, setExpanded] = useState(maxInitialDepth === undefined ? true : depth < maxInitialDepth);
     const isFolder = !!node.children;
     const isSelected = node.path === selectedPath;
@@ -31,10 +32,18 @@ export function FileTreeNode({ node, selectedPath, onSelect, depth, enableDrag =
             onSelect(node.path);
         }
     }, [isFolder, node.path, onSelect]);
+    const handleDoubleClick = useCallback(() => {
+        if (!isFolder)
+            onActivate?.(node.path);
+    }, [isFolder, node.path, onActivate]);
     const handleDragStart = useCallback((e) => {
         e.dataTransfer.setData(FILE_REF_MIME, JSON.stringify({ path: node.path }));
         e.dataTransfer.effectAllowed = "link";
     }, [node.path]);
-    return (_jsxs("li", { role: "treeitem", "aria-expanded": isFolder ? expanded : undefined, children: [_jsxs("button", { type: "button", onClick: handleClick, draggable: isDraggable, onDragStart: isDraggable ? handleDragStart : undefined, className: cn("flex w-full items-center gap-1.5 px-3 py-1 text-left text-xs transition-colors", "hover:bg-muted", "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-ring", isSelected && !isFolder && "bg-muted text-foreground font-medium", !isSelected && "text-muted-foreground", isDraggable && "cursor-grab active:cursor-grabbing"), style: { paddingLeft: `${12 + depth * 12}px` }, "aria-current": isSelected ? "true" : undefined, children: [isFolder && (_jsx("span", { className: "text-[10px] text-muted-foreground-subtle", children: expanded ? "▼" : "▶" })), _jsx("span", { className: cn("truncate", isFolder && "font-medium text-foreground"), children: node.name })] }), isFolder && expanded && node.children && (_jsx("ul", { role: "group", children: node.children.map((child) => (_jsx(FileTreeNode, { node: child, selectedPath: selectedPath, onSelect: onSelect, depth: depth + 1, enableDrag: enableDrag, maxInitialDepth: maxInitialDepth }, child.path))) }))] }));
+    return (_jsxs("li", { role: "treeitem", "aria-expanded": isFolder ? expanded : undefined, children: [_jsxs("button", { type: "button", onClick: handleClick, onDoubleClick: onActivate ? handleDoubleClick : undefined, draggable: isDraggable, onDragStart: isDraggable ? handleDragStart : undefined, className: cn("flex w-full items-center gap-1.5 py-1 text-left text-xs transition-colors", "hover:bg-muted", "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-ring", isSelected && !isFolder && "bg-muted text-foreground font-medium", !isSelected && "text-muted-foreground", isDraggable && "cursor-grab active:cursor-grabbing"), 
+                // Indent-guide mode indents via the nested group's margin, so rows need
+                // only a small constant inset; padding mode keeps the per-depth inset.
+                style: { paddingLeft: indentGuides ? "8px" : `${12 + depth * 12}px`, paddingRight: "8px" }, "aria-current": isSelected ? "true" : undefined, children: [isFolder && (_jsx("span", { className: "text-[10px] text-muted-foreground-subtle", children: expanded ? "▼" : "▶" })), showIcons &&
+                        (isFolder ? (_jsx(FolderTypeIcon, { open: expanded })) : (_jsx(FileTypeIcon, { fileName: node.name }))), _jsx("span", { className: cn("truncate", isFolder && "font-medium text-foreground"), children: node.name })] }), isFolder && expanded && node.children && (_jsx("ul", { role: "group", className: cn(indentGuides && "ml-3 border-l border-border"), children: node.children.map((child) => (_jsx(FileTreeNode, { node: child, selectedPath: selectedPath, onSelect: onSelect, onActivate: onActivate, depth: depth + 1, enableDrag: enableDrag, showIcons: showIcons, indentGuides: indentGuides, maxInitialDepth: maxInitialDepth }, child.path))) }))] }));
 }
 //# sourceMappingURL=FileTreeNode.js.map

package/internal/file-tree/FileTreeNode.js.map

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

package/internal/markdown-components.d.ts

@@ -25,6 +25,14 @@ export declare function stripFrontmatter(content: string): string;
  * no-op for everything else (already-rich markdown, prose, or a reply that is
  * legitimately a single code block).
  *
+ * `allowBareFence` extends the unwrap to a whole-body fence with NO language
+ * tag. For an ordinary chat message a bare fence is ambiguous (it may be a
+ * legitimate single code block), so the default stays strict. A Plan-mode plan
+ * is different by contract: the turn's output IS a markdown document, so a
+ * reply that is one giant untagged fence is a wrapped plan, not code. Only
+ * plan-document surfaces pass `true`. A fence tagged with any other language
+ * (```python …) is never unwrapped in either mode.
+ *
  * Render-time only: callers pass it the text right before handing it to the
  * markdown renderer, so the transcript and the raw artifact stay faithful to
  * what the agent produced — a single source of truth for the unwrap, with no
@@ -32,7 +40,23 @@ export declare function stripFrontmatter(content: string): string;
  * arrived yet, so this no-ops and the live text renders as typed; it unwraps
  * once the block closes.
  */
-export declare function unwrapEnclosingMarkdownFence(content: string): string;
+export declare function unwrapEnclosingMarkdownFence(content: string, allowBareFence?: boolean): string;
+/**
+ * Splits a markdown document into its leading `# H1` title and the remaining
+ * body, for surfaces that render the title in their own chrome (the plan
+ * document header) instead of inside the prose flow.
+ *
+ * Only a heading at the very start of the document counts as the title — an
+ * `# H1` further down is document content and stays in the body. When there is
+ * no leading H1, `title` is `null` and `body` is the input unchanged.
+ *
+ * Render-time only, like {@link unwrapEnclosingMarkdownFence}: the stored
+ * message/artifact keeps its heading; only the presentation moves it.
+ */
+export declare function extractLeadingH1(markdown: string): {
+    readonly title: string | null;
+    readonly body: string;
+};
 /**
  * Styled react-markdown component overrides for SDK markdown surfaces.
  *
@@ -43,4 +67,17 @@ export declare function unwrapEnclosingMarkdownFence(content: string): string;
  * Used by `MessageEntry` (chat messages) and `SkillDetailView` (SKILL.md).
  */
 export declare const MARKDOWN_COMPONENTS: Components;
+/**
+ * Document-grade typography for a Plan-mode plan: one step up the heading
+ * scale from the chat-tuned {@link MARKDOWN_COMPONENTS}, wider section
+ * spacing, and a hairline under `##` section headings for scannability. The
+ * plan is a reviewable document, not a chat bubble — its headings must carry
+ * the structure at a glance.
+ *
+ * Everything except the headings is inherited from `MARKDOWN_COMPONENTS`, so
+ * body text, code, tables, and links render identically across chat and plan
+ * surfaces. Used by `PlanDocumentMessage` (thread) — the same treatment any
+ * plan-document surface should share.
+ */
+export declare const PLAN_DOCUMENT_MARKDOWN_COMPONENTS: Components;
 //# sourceMappingURL=markdown-components.d.ts.map

package/internal/markdown-components.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"markdown-components.d.ts","sourceRoot":"","sources":["../../src/internal/markdown-components.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,SAAS,MAAM,YAAY,CAAC;AAQnC;;;GAGG;AACH,eAAO,MAAM,cAAc,sBAAc,CAAC;AAI1C;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAgBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGpE;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,EAAE,UA4LjC,CAAC"}
+{"version":3,"file":"markdown-components.d.ts","sourceRoot":"","sources":["../../src/internal/markdown-components.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,SAAS,MAAM,YAAY,CAAC;AAQnC;;;GAGG;AACH,eAAO,MAAM,cAAc,sBAAc,CAAC;AAI1C;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAwBD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,cAAc,UAAQ,GACrB,MAAM,CASR;AASD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG;IAClD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAKA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,EAAE,UA4LjC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iCAAiC,EAAE,UAqC/C,CAAC"}

package/internal/markdown-components.js

@@ -33,6 +33,13 @@ export function stripFrontmatter(content) {
  * the kind of fuzzy heuristic this codebase avoids.
  */
 const ENCLOSING_MARKDOWN_FENCE_RE = /^(`{3,})[ \t]*(?:markdown|md)[ \t]*\r?\n([\s\S]*?)\r?\n\1[ \t]*$/i;
+/**
+ * Matches content whose ENTIRE body is a single fenced code block with an
+ * EMPTY info string (no language tag). Only meaningful for surfaces that know
+ * the body is markdown by contract (a Plan-mode plan) — see
+ * {@link unwrapEnclosingMarkdownFence}'s `allowBareFence`.
+ */
+const ENCLOSING_BARE_FENCE_RE = /^(`{3,})[ \t]*\r?\n([\s\S]*?)\r?\n\1[ \t]*$/;
 /**
  * Unwraps a message the model wrapped entirely in a ```markdown / ```md fence.
  *
@@ -43,6 +50,14 @@ const ENCLOSING_MARKDOWN_FENCE_RE = /^(`{3,})[ \t]*(?:markdown|md)[ \t]*\r?\n([\
  * no-op for everything else (already-rich markdown, prose, or a reply that is
  * legitimately a single code block).
  *
+ * `allowBareFence` extends the unwrap to a whole-body fence with NO language
+ * tag. For an ordinary chat message a bare fence is ambiguous (it may be a
+ * legitimate single code block), so the default stays strict. A Plan-mode plan
+ * is different by contract: the turn's output IS a markdown document, so a
+ * reply that is one giant untagged fence is a wrapped plan, not code. Only
+ * plan-document surfaces pass `true`. A fence tagged with any other language
+ * (```python …) is never unwrapped in either mode.
+ *
  * Render-time only: callers pass it the text right before handing it to the
  * markdown renderer, so the transcript and the raw artifact stay faithful to
  * what the agent produced — a single source of truth for the unwrap, with no
@@ -50,9 +65,42 @@ const ENCLOSING_MARKDOWN_FENCE_RE = /^(`{3,})[ \t]*(?:markdown|md)[ \t]*\r?\n([\
  * arrived yet, so this no-ops and the live text renders as typed; it unwraps
  * once the block closes.
  */
-export function unwrapEnclosingMarkdownFence(content) {
-    const match = ENCLOSING_MARKDOWN_FENCE_RE.exec(content.trim());
-    return match ? match[2] : content;
+export function unwrapEnclosingMarkdownFence(content, allowBareFence = false) {
+    const trimmed = content.trim();
+    const tagged = ENCLOSING_MARKDOWN_FENCE_RE.exec(trimmed);
+    if (tagged)
+        return tagged[2];
+    if (allowBareFence) {
+        const bare = ENCLOSING_BARE_FENCE_RE.exec(trimmed);
+        if (bare)
+            return bare[2];
+    }
+    return content;
+}
+/**
+ * Matches a document that OPENS with an `# H1` heading (optionally preceded by
+ * blank lines only). Group 1 is the heading text; the match spans through the
+ * heading's trailing newline(s) so `body` starts at the first content line.
+ */
+const LEADING_H1_RE = /^#[ \t]+(.+?)[ \t]*(?:\r?\n+|$)/;
+/**
+ * Splits a markdown document into its leading `# H1` title and the remaining
+ * body, for surfaces that render the title in their own chrome (the plan
+ * document header) instead of inside the prose flow.
+ *
+ * Only a heading at the very start of the document counts as the title — an
+ * `# H1` further down is document content and stays in the body. When there is
+ * no leading H1, `title` is `null` and `body` is the input unchanged.
+ *
+ * Render-time only, like {@link unwrapEnclosingMarkdownFence}: the stored
+ * message/artifact keeps its heading; only the presentation moves it.
+ */
+export function extractLeadingH1(markdown) {
+    const trimmed = markdown.trim();
+    const match = LEADING_H1_RE.exec(trimmed);
+    if (!match)
+        return { title: null, body: markdown };
+    return { title: match[1], body: trimmed.slice(match[0].length) };
 }
 /**
  * Styled react-markdown component overrides for SDK markdown surfaces.
@@ -65,22 +113,22 @@ export function unwrapEnclosingMarkdownFence(content) {
  */
 export const MARKDOWN_COMPONENTS = {
     p({ children, ...props }) {
-        return (_jsx("p", { className: "text-sm text-foreground mb-3 last:mb-0 leading-relaxed", ...props, children: children }));
+        return (_jsx("p", { className: "text-sm text-foreground mb-3 last:mb-0 leading-relaxed break-words", ...props, children: children }));
     },
     a({ children, href, ...props }) {
-        return (_jsx("a", { href: href, className: "text-primary underline underline-offset-2 hover:text-primary-muted", target: "_blank", rel: "noopener noreferrer", ...props, children: children }));
+        return (_jsx("a", { href: href, className: "text-primary underline underline-offset-2 hover:text-primary-muted break-words", target: "_blank", rel: "noopener noreferrer", ...props, children: children }));
     },
     h1({ children, ...props }) {
-        return (_jsx("h1", { className: "text-lg font-semibold text-foreground mt-5 mb-2 first:mt-0", ...props, children: children }));
+        return (_jsx("h1", { className: "text-lg font-semibold text-foreground mt-5 mb-2 first:mt-0 break-words", ...props, children: children }));
     },
     h2({ children, ...props }) {
-        return (_jsx("h2", { className: "text-base font-semibold text-foreground mt-5 mb-2 first:mt-0", ...props, children: children }));
+        return (_jsx("h2", { className: "text-base font-semibold text-foreground mt-5 mb-2 first:mt-0 break-words", ...props, children: children }));
     },
     h3({ children, ...props }) {
-        return (_jsx("h3", { className: "text-sm font-semibold text-foreground mt-4 mb-1.5 first:mt-0", ...props, children: children }));
+        return (_jsx("h3", { className: "text-sm font-semibold text-foreground mt-4 mb-1.5 first:mt-0 break-words", ...props, children: children }));
     },
     h4({ children, ...props }) {
-        return (_jsx("h4", { className: "text-sm font-medium text-foreground mt-3 mb-1 first:mt-0", ...props, children: children }));
+        return (_jsx("h4", { className: "text-sm font-medium text-foreground mt-3 mb-1 first:mt-0 break-words", ...props, children: children }));
     },
     ul({ children, ...props }) {
         return (_jsx("ul", { className: "list-disc pl-5 mb-3 last:mb-0 space-y-1 text-sm text-foreground", ...props, children: children }));
@@ -89,7 +137,7 @@ export const MARKDOWN_COMPONENTS = {
         return (_jsx("ol", { className: "list-decimal pl-5 mb-3 last:mb-0 space-y-1 text-sm text-foreground", ...props, children: children }));
     },
     li({ children, ...props }) {
-        return (_jsx("li", { className: "leading-relaxed", ...props, children: children }));
+        return (_jsx("li", { className: "leading-relaxed break-words", ...props, children: children }));
     },
     pre({ children, ...props }) {
         return (_jsx("pre", { className: "mb-3 last:mb-0 overflow-x-auto rounded-md bg-muted p-3", ...props, children: children }));
@@ -108,7 +156,7 @@ export const MARKDOWN_COMPONENTS = {
                 : null;
             return (_jsx("code", { className: cn("hljs font-mono text-xs text-foreground", codeClassName), ...props, children: highlighted ?? children }));
         }
-        return (_jsx("code", { className: "font-mono text-xs bg-muted px-1 py-0.5 rounded text-foreground", ...props, children: children }));
+        return (_jsx("code", { className: "font-mono text-xs bg-muted px-1 py-0.5 rounded text-foreground break-words", ...props, children: children }));
     },
     blockquote({ children, ...props }) {
         return (_jsx("blockquote", { className: "border-l-2 border-border pl-4 mb-3 last:mb-0 text-muted-foreground italic", ...props, children: children }));
@@ -132,4 +180,31 @@ export const MARKDOWN_COMPONENTS = {
         return (_jsx("em", { className: "italic", ...props, children: children }));
     },
 };
+/**
+ * Document-grade typography for a Plan-mode plan: one step up the heading
+ * scale from the chat-tuned {@link MARKDOWN_COMPONENTS}, wider section
+ * spacing, and a hairline under `##` section headings for scannability. The
+ * plan is a reviewable document, not a chat bubble — its headings must carry
+ * the structure at a glance.
+ *
+ * Everything except the headings is inherited from `MARKDOWN_COMPONENTS`, so
+ * body text, code, tables, and links render identically across chat and plan
+ * surfaces. Used by `PlanDocumentMessage` (thread) — the same treatment any
+ * plan-document surface should share.
+ */
+export const PLAN_DOCUMENT_MARKDOWN_COMPONENTS = {
+    ...MARKDOWN_COMPONENTS,
+    h1({ children, ...props }) {
+        return (_jsx("h1", { className: "text-lg font-semibold text-foreground mt-6 mb-3 first:mt-0 break-words", ...props, children: children }));
+    },
+    h2({ children, ...props }) {
+        return (_jsx("h2", { className: "text-base font-semibold text-foreground mt-6 mb-2.5 pb-1 border-b border-border-muted first:mt-0 break-words", ...props, children: children }));
+    },
+    h3({ children, ...props }) {
+        return (_jsx("h3", { className: "text-sm font-semibold text-foreground mt-5 mb-2 first:mt-0 break-words", ...props, children: children }));
+    },
+    h4({ children, ...props }) {
+        return (_jsx("h4", { className: "text-sm font-medium text-foreground mt-4 mb-1.5 first:mt-0 break-words", ...props, children: children }));
+    },
+};
 //# sourceMappingURL=markdown-components.js.map

package/internal/markdown-components.js.map

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

package/{workflow → internal}/motion-preference.d.ts

@@ -1,10 +1,13 @@
 /**
  * Utility for respecting the user's motion preference (prefers-reduced-motion)
- * in programmatic viewport animations (fitView, setCenter, etc.) that are NOT
- * covered by the CSS-level reduced-motion rule in styles.css.
+ * in programmatic viewport animations (fitView, setCenter, scrollIntoView, etc.)
+ * that are NOT covered by the CSS-level reduced-motion rule in styles.css.
  *
- * React Flow's JS-driven animations (duration parameter on fitView/setCenter)
- * bypass CSS media queries — they must be explicitly checked.
+ * JS-driven animations (React Flow's duration parameter on fitView/setCenter,
+ * smooth `scrollIntoView`) bypass CSS media queries — they must be explicitly
+ * checked. Lives in `internal/` because it is cross-cutting: the workflow graph
+ * and the workspace file viewer both depend on it, and `internal/` may not
+ * depend on a feature domain.
  */
 /**
  * Returns true if the user prefers reduced motion.

package/internal/motion-preference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"motion-preference.d.ts","sourceRoot":"","sources":["../../src/internal/motion-preference.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAaH;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAY9C;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE9D"}

package/{workflow → internal}/motion-preference.js

@@ -1,10 +1,13 @@
 /**
  * Utility for respecting the user's motion preference (prefers-reduced-motion)
- * in programmatic viewport animations (fitView, setCenter, etc.) that are NOT
- * covered by the CSS-level reduced-motion rule in styles.css.
+ * in programmatic viewport animations (fitView, setCenter, scrollIntoView, etc.)
+ * that are NOT covered by the CSS-level reduced-motion rule in styles.css.
  *
- * React Flow's JS-driven animations (duration parameter on fitView/setCenter)
- * bypass CSS media queries — they must be explicitly checked.
+ * JS-driven animations (React Flow's duration parameter on fitView/setCenter,
+ * smooth `scrollIntoView`) bypass CSS media queries — they must be explicitly
+ * checked. Lives in `internal/` because it is cross-cutting: the workflow graph
+ * and the workspace file viewer both depend on it, and `internal/` may not
+ * depend on a feature domain.
  */
 let cachedPreference = null;
 let mediaQuery = null;

package/internal/motion-preference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"motion-preference.js","sourceRoot":"","sources":["../../src/internal/motion-preference.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,IAAI,gBAAgB,GAAmB,IAAI,CAAC;AAC5C,IAAI,UAAU,GAA0B,IAAI,CAAC;AAE7C,SAAS,aAAa;IACpB,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAC/C,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,kCAAkC,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,KAAK,CAAC;IAChD,MAAM,EAAE,GAAG,aAAa,EAAE,CAAC;IAC3B,IAAI,CAAC,EAAE;QAAE,OAAO,KAAK,CAAC;IAEtB,IAAI,gBAAgB,KAAK,IAAI,EAAE,CAAC;QAC9B,gBAAgB,GAAG,EAAE,CAAC,OAAO,CAAC;QAC9B,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE;YAClC,gBAAgB,GAAG,CAAC,CAAC,OAAO,CAAC;QAC/B,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,OAAO,oBAAoB,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAChD,CAAC"}

package/internal/store/index.d.ts

@@ -1,10 +1,16 @@
 import type { AgentExecution } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
 import { ConversationStore, type StreamState } from "./conversation-store.js";
+import { WorkspaceFileSelectionStore, type SelectedWorkspaceFile } from "./workspace-file-selection-store.js";
+import { WorkspaceEditorsStore, type WorkspaceEditorsSnapshot } from "./workspace-editors-store.js";
 export { ConversationStore, type StreamState } from "./conversation-store.js";
 export { structuralShare } from "./structural-share.js";
 export { WorkflowExecutionEventStore, type WorkflowEventStreamState, type DerivedTaskState, type DerivedCostSummary, } from "./workflow-execution-event-store.js";
 export { SelectionStore } from "./selection-store.js";
 export type { SelectedThreadItem } from "./selection-store.js";
+export { WorkspaceFileSelectionStore } from "./workspace-file-selection-store.js";
+export type { SelectedWorkspaceFile } from "./workspace-file-selection-store.js";
+export { WorkspaceEditorsStore, editorKey, virtualEntryId, isVirtualEntryId, } from "./workspace-editors-store.js";
+export type { OpenEditor, OpenFileOptions, EditorReveal, WorkspaceEditorsSnapshot, } from "./workspace-editors-store.js";
 /**
  * Internal context for the conversation store. Not exported from the
  * public SDK barrel — used only within SDK hooks and components.
@@ -31,4 +37,31 @@ export declare function useStoreExecution(store: ConversationStore): AgentExecut
  * Returns a stable reference when the state is unchanged.
  */
 export declare function useStoreStreamState(store: ConversationStore): StreamState;
+/**
+ * Internal context carrying the {@link WorkspaceFileSelectionStore} instance
+ * (stable ref) to both columns of the session viewer. Not exported from the
+ * public SDK barrel — consumed only within SDK components and `SessionViewer`.
+ */
+export declare const WorkspaceFileSelectionContext: import("react").Context<WorkspaceFileSelectionStore | null>;
+/**
+ * Access the workspace-file selection store from context.
+ * Throws if called outside a `WorkspaceFileSelectionContext.Provider`.
+ */
+export declare function useWorkspaceFileSelectionStore(): WorkspaceFileSelectionStore;
+/**
+ * Create or reuse a `WorkspaceFileSelectionStore` instance, preserved across
+ * re-renders via ref. `SessionViewer` calls this and provides the result
+ * through {@link WorkspaceFileSelectionContext} (DD-07).
+ */
+export declare function useWorkspaceFileSelectionStoreRef(): WorkspaceFileSelectionStore;
+/** Subscribe to the currently-selected workspace file. */
+export declare function useWorkspaceFileSelection(store: WorkspaceFileSelectionStore): SelectedWorkspaceFile | null;
+/**
+ * Create or reuse a `WorkspaceEditorsStore` instance, preserved across
+ * re-renders via ref. Owned by `SessionViewer` alongside the selection store;
+ * the surface subscribes to it for its tab group.
+ */
+export declare function useWorkspaceEditorsStoreRef(): WorkspaceEditorsStore;
+/** Subscribe to the open-editor group snapshot. */
+export declare function useWorkspaceEditors(store: WorkspaceEditorsStore): WorkspaceEditorsSnapshot;
 //# sourceMappingURL=index.d.ts.map

package/internal/store/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/internal/store/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6DAA6D,CAAC;AAClG,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE9E,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EACL,2BAA2B,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,GACxB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAM/D;;;GAGG;AACH,eAAO,MAAM,wBAAwB,mDACU,CAAC;AAMhD;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,iBAAiB,CAQxD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,iBAAiB,CAM3D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,iBAAiB,GACvB,cAAc,GAAG,IAAI,CAEvB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,GAAG,WAAW,CAEzE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/internal/store/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6DAA6D,CAAC;AAClG,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EACL,2BAA2B,EAC3B,KAAK,qBAAqB,EAC3B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,qBAAqB,EACrB,KAAK,wBAAwB,EAC9B,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EACL,2BAA2B,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,GACxB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAClF,YAAY,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAEjF,OAAO,EACL,qBAAqB,EACrB,SAAS,EACT,cAAc,EACd,gBAAgB,GACjB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,UAAU,EACV,eAAe,EACf,YAAY,EACZ,wBAAwB,GACzB,MAAM,8BAA8B,CAAC;AAMtC;;;GAGG;AACH,eAAO,MAAM,wBAAwB,mDACU,CAAC;AAMhD;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,iBAAiB,CAQxD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,iBAAiB,CAM3D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,iBAAiB,GACvB,cAAc,GAAG,IAAI,CAEvB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,GAAG,WAAW,CAEzE;AAMD;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,6DACe,CAAC;AAE1D;;;GAGG;AACH,wBAAgB,8BAA8B,IAAI,2BAA2B,CAQ5E;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,IAAI,2BAA2B,CAM/E;AAED,0DAA0D;AAC1D,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,2BAA2B,GACjC,qBAAqB,GAAG,IAAI,CAE9B;AAMD;;;;GAIG;AACH,wBAAgB,2BAA2B,IAAI,qBAAqB,CAMnE;AAED,mDAAmD;AACnD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,qBAAqB,GAC3B,wBAAwB,CAE1B"}

package/internal/store/index.js

@@ -1,10 +1,14 @@
 "use client";
 import { createContext, useContext, useRef, useSyncExternalStore } from "react";
 import { ConversationStore } from "./conversation-store.js";
+import { WorkspaceFileSelectionStore, } from "./workspace-file-selection-store.js";
+import { WorkspaceEditorsStore, } from "./workspace-editors-store.js";
 export { ConversationStore } from "./conversation-store.js";
 export { structuralShare } from "./structural-share.js";
 export { WorkflowExecutionEventStore, } from "./workflow-execution-event-store.js";
 export { SelectionStore } from "./selection-store.js";
+export { WorkspaceFileSelectionStore } from "./workspace-file-selection-store.js";
+export { WorkspaceEditorsStore, editorKey, virtualEntryId, isVirtualEntryId, } from "./workspace-editors-store.js";
 // ---------------------------------------------------------------------------
 // Context
 // ---------------------------------------------------------------------------
@@ -53,4 +57,59 @@ export function useStoreExecution(store) {
 export function useStoreStreamState(store) {
     return useSyncExternalStore(store.subscribe, store.getStreamState);
 }
+// ---------------------------------------------------------------------------
+// Workspace file selection — the DD-07 shared "which file is open" store
+// ---------------------------------------------------------------------------
+/**
+ * Internal context carrying the {@link WorkspaceFileSelectionStore} instance
+ * (stable ref) to both columns of the session viewer. Not exported from the
+ * public SDK barrel — consumed only within SDK components and `SessionViewer`.
+ */
+export const WorkspaceFileSelectionContext = createContext(null);
+/**
+ * Access the workspace-file selection store from context.
+ * Throws if called outside a `WorkspaceFileSelectionContext.Provider`.
+ */
+export function useWorkspaceFileSelectionStore() {
+    const store = useContext(WorkspaceFileSelectionContext);
+    if (!store) {
+        throw new Error("useWorkspaceFileSelectionStore must be used within a WorkspaceFileSelectionContext.Provider");
+    }
+    return store;
+}
+/**
+ * Create or reuse a `WorkspaceFileSelectionStore` instance, preserved across
+ * re-renders via ref. `SessionViewer` calls this and provides the result
+ * through {@link WorkspaceFileSelectionContext} (DD-07).
+ */
+export function useWorkspaceFileSelectionStoreRef() {
+    const ref = useRef(null);
+    if (!ref.current) {
+        ref.current = new WorkspaceFileSelectionStore();
+    }
+    return ref.current;
+}
+/** Subscribe to the currently-selected workspace file. */
+export function useWorkspaceFileSelection(store) {
+    return useSyncExternalStore(store.subscribe, store.getSelection);
+}
+// ---------------------------------------------------------------------------
+// Workspace editors — the surface's open-editor group (Slice B)
+// ---------------------------------------------------------------------------
+/**
+ * Create or reuse a `WorkspaceEditorsStore` instance, preserved across
+ * re-renders via ref. Owned by `SessionViewer` alongside the selection store;
+ * the surface subscribes to it for its tab group.
+ */
+export function useWorkspaceEditorsStoreRef() {
+    const ref = useRef(null);
+    if (!ref.current) {
+        ref.current = new WorkspaceEditorsStore();
+    }
+    return ref.current;
+}
+/** Subscribe to the open-editor group snapshot. */
+export function useWorkspaceEditors(store) {
+    return useSyncExternalStore(store.subscribe, store.getSnapshot);
+}
 //# sourceMappingURL=index.js.map

package/internal/store/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/internal/store/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAEhF,OAAO,EAAE,iBAAiB,EAAoB,MAAM,yBAAyB,CAAC;AAE9E,OAAO,EAAE,iBAAiB,EAAoB,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EACL,2BAA2B,GAI5B,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GACnC,aAAa,CAA2B,IAAI,CAAC,CAAC;AAEhD,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,KAAK,GAAG,UAAU,CAAC,wBAAwB,CAAC,CAAC;IACnD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,8EAA8E,CAC/E,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB;IACrC,MAAM,GAAG,GAAG,MAAM,CAA2B,IAAI,CAAC,CAAC;IACnD,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACjB,GAAG,CAAC,OAAO,GAAG,IAAI,iBAAiB,EAAE,CAAC;IACxC,CAAC;IACD,OAAO,GAAG,CAAC,OAAO,CAAC;AACrB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAwB;IAExB,OAAO,oBAAoB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;AACnE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAwB;IAC1D,OAAO,oBAAoB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;AACrE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/internal/store/index.ts"],"names":[],"mappings":"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"}