@stigmer/react 3.1.0 → 3.1.2

package/workspace/WorkspaceFileSearch.js

@@ -0,0 +1,155 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useCallback, useEffect, useId, useMemo, useRef, useState, } from "react";
+import { cn } from "@stigmer/theme";
+import { useWorkspaceFileSearch, } from "./useWorkspaceFileSearch.js";
+/** Cap on rendered rows — keeps the DOM bounded on huge repositories. */
+const MAX_RESULTS = 200;
+/**
+ * Workspace-wide filename/path search surface.
+ *
+ * Searches the already-loaded listings across every workspace entry (via
+ * {@link useWorkspaceFileSearch}) and opens a hit in the viewer through
+ * `onOpenFile` — the same seam a file-tree click uses. Filename-first by design;
+ * content search is a separate substrate-specific capability (DD-09).
+ *
+ * Keyboard/a11y follows the platform's combobox+listbox pattern (see
+ * `mcp-server/McpServerPicker`): the input is a `role="combobox"` driving
+ * `aria-activedescendant`, results are a `role="listbox"` of `role="option"`
+ * rows, and ArrowUp/Down move a virtual focus with Enter to open — focus stays
+ * in the input. All visual properties flow through `--stgm-*` tokens (DD-005).
+ */
+export function WorkspaceFileSearch({ entries, lister, onOpenFile, selectedFile, className, }) {
+    const [query, setQuery] = useState("");
+    const [focusIndex, setFocusIndex] = useState(-1);
+    const inputRef = useRef(null);
+    const listboxId = useId();
+    const optionId = useCallback((index) => `${listboxId}-opt-${index}`, [listboxId]);
+    const { groups, totalMatches, isLoading, isUnsupported } = useWorkspaceFileSearch({ entries, lister, query });
+    // Flat, capped view of every rendered match — the index space the keyboard
+    // and `aria-activedescendant` share with the grouped render below.
+    const flatResults = useMemo(() => {
+        const flat = [];
+        for (const group of groups) {
+            for (const match of group.matches) {
+                if (flat.length >= MAX_RESULTS)
+                    return flat;
+                flat.push({ entryId: group.entry.id, entry: group.entry, match });
+            }
+        }
+        return flat;
+    }, [groups]);
+    // A new query invalidates the previous virtual focus.
+    useEffect(() => {
+        setFocusIndex(-1);
+    }, [query]);
+    // Autofocus on mount — the user switched into Search intending to type.
+    useEffect(() => {
+        inputRef.current?.focus();
+    }, []);
+    // Keep the virtually-focused option in view (no-op where unsupported, e.g. tests).
+    useEffect(() => {
+        if (focusIndex < 0)
+            return;
+        const el = typeof document !== "undefined"
+            ? document.getElementById(optionId(focusIndex))
+            : null;
+        el?.scrollIntoView?.({ block: "nearest" });
+    }, [focusIndex, optionId]);
+    const handleKeyDown = useCallback((e) => {
+        if (e.key === "ArrowDown") {
+            e.preventDefault();
+            setFocusIndex((prev) => prev < flatResults.length - 1 ? prev + 1 : prev);
+        }
+        else if (e.key === "ArrowUp") {
+            e.preventDefault();
+            setFocusIndex((prev) => (prev > 0 ? prev - 1 : -1));
+        }
+        else if (e.key === "Enter") {
+            e.preventDefault();
+            const target = flatResults[focusIndex];
+            if (target)
+                onOpenFile(target.entryId, target.match.path);
+        }
+    }, [flatResults, focusIndex, onOpenFile]);
+    const trimmed = query.trim();
+    const showGroupHeaders = groups.length > 1;
+    return (_jsxs("div", { className: cn("flex h-full flex-col", className), children: [_jsxs("div", { className: "flex items-center gap-1.5 border-b border-border px-2 py-1.5", children: [_jsx(SearchIcon, {}), _jsx("input", { ref: inputRef, type: "text", role: "combobox", "aria-expanded": true, "aria-controls": listboxId, "aria-activedescendant": focusIndex >= 0 ? optionId(focusIndex) : undefined, value: query, onChange: (e) => setQuery(e.target.value), onKeyDown: handleKeyDown, placeholder: "Search files by name\u2026", disabled: isUnsupported, className: cn("min-w-0 flex-1 bg-transparent text-xs text-foreground", "placeholder:text-muted-foreground", "focus-visible:outline-none disabled:cursor-not-allowed"), "aria-label": "Search workspace files by name" }), trimmed.length > 0 && (_jsx("button", { type: "button", onClick: () => {
+                            setQuery("");
+                            inputRef.current?.focus();
+                        }, className: "shrink-0 text-muted-foreground transition-colors hover:text-foreground", "aria-label": "Clear search", children: _jsx(ClearIcon, {}) }))] }), _jsx("div", { className: "min-h-0 flex-1 overflow-y-auto", children: isUnsupported ? (_jsx(MessageState, { children: "File search isn\u2019t available here." })) : trimmed.length === 0 ? (_jsx(MessageState, { children: "Search files by name across the whole workspace." })) : isLoading && totalMatches === 0 && groups.length === 0 ? (_jsx(MessageState, { children: "Searching\u2026" })) : groups.length === 0 ? (_jsxs(MessageState, { children: ["No files matching \u201C", trimmed, "\u201D."] })) : (_jsxs(_Fragment, { children: [_jsx("ul", { id: listboxId, role: "listbox", "aria-label": "Search results", className: "py-0.5", children: renderRows({
+                                groups,
+                                showGroupHeaders,
+                                selectedFile: selectedFile ?? null,
+                                focusIndex,
+                                optionId,
+                                onOpenFile,
+                            }) }), totalMatches > flatResults.length && (_jsxs("p", { className: "border-t border-border px-3 py-1.5 text-[0.65rem] text-muted-foreground", children: ["Showing the first ", flatResults.length, " of ", totalMatches, " matches \u2014 refine your search to narrow the list."] }))] })) })] }));
+}
+// ---------------------------------------------------------------------------
+// Result rows — a single pass over groups that keeps the flat match index
+// aligned with `flatResults` (and thus keyboard focus / aria-activedescendant).
+// ---------------------------------------------------------------------------
+function renderRows({ groups, showGroupHeaders, selectedFile, focusIndex, optionId, onOpenFile, }) {
+    const rows = [];
+    let matchIndex = 0;
+    for (const group of groups) {
+        if (showGroupHeaders) {
+            rows.push(_jsx(GroupHeader, { name: group.entry.name }, `h:${group.entry.id}`));
+        }
+        for (const match of group.matches) {
+            if (matchIndex >= MAX_RESULTS)
+                break;
+            const index = matchIndex++;
+            const isOpen = selectedFile?.entryId === group.entry.id &&
+                selectedFile.path === match.path;
+            rows.push(_jsx(ResultRow, { id: optionId(index), match: match, isFocused: index === focusIndex, isOpen: isOpen, onOpen: () => onOpenFile(group.entry.id, match.path) }, `${group.entry.id}:${match.path}`));
+        }
+        if (group.truncated) {
+            rows.push(_jsx(GroupNotice, { children: "Partial listing \u2014 this repository has too many files to search in full." }, `t:${group.entry.id}`));
+        }
+        if (group.error) {
+            rows.push(_jsxs(GroupNotice, { isError: true, children: ["Couldn\u2019t list files: ", group.error.message] }, `e:${group.entry.id}`));
+        }
+        if (matchIndex >= MAX_RESULTS)
+            break;
+    }
+    return rows;
+}
+function ResultRow({ id, match, isFocused, isOpen, onOpen, }) {
+    const lastSlash = match.path.lastIndexOf("/");
+    const basename = match.path.slice(lastSlash + 1);
+    const dir = lastSlash >= 0 ? match.path.slice(0, lastSlash) : "";
+    return (_jsx("li", { id: id, role: "option", "aria-selected": isFocused, children: _jsxs("button", { type: "button", onClick: onOpen, tabIndex: -1, "aria-current": isOpen ? "true" : undefined, className: cn("flex w-full items-baseline gap-1.5 px-3 py-1 text-left text-xs transition-colors", isFocused && "bg-muted", isOpen && "bg-muted font-medium text-foreground", !isFocused && !isOpen && "hover:bg-muted"), children: [_jsx("span", { className: "truncate text-foreground", children: _jsx(HighlightedPath, { text: basename, offset: lastSlash + 1, matchStart: match.matchStart, matchEnd: match.matchEnd }) }), dir && (_jsx("span", { className: "truncate text-[0.65rem] text-muted-foreground", children: _jsx(HighlightedPath, { text: dir, offset: 0, matchStart: match.matchStart, matchEnd: match.matchEnd }) }))] }) }));
+}
+/**
+ * Renders a slice of the path (`text`, starting at `offset` within the full
+ * path), emphasizing the intersection with the match range `[matchStart,
+ * matchEnd)`. Non-overlapping slices render plain.
+ */
+function HighlightedPath({ text, offset, matchStart, matchEnd, }) {
+    const localStart = Math.max(0, matchStart - offset);
+    const localEnd = Math.min(text.length, matchEnd - offset);
+    if (localStart >= localEnd)
+        return _jsx(_Fragment, { children: text });
+    return (_jsxs(_Fragment, { children: [text.slice(0, localStart), _jsx("span", { className: "font-semibold text-foreground", children: text.slice(localStart, localEnd) }), text.slice(localEnd)] }));
+}
+function GroupHeader({ name }) {
+    return (_jsx("li", { role: "presentation", className: "truncate px-3 pb-0.5 pt-2 text-[0.6rem] font-medium uppercase tracking-wide text-muted-foreground", children: name }));
+}
+function GroupNotice({ children, isError, }) {
+    return (_jsx("li", { role: "presentation", className: cn("px-3 py-1 text-[0.65rem]", isError ? "text-destructive" : "text-muted-foreground"), children: children }));
+}
+function MessageState({ children }) {
+    return (_jsx("div", { className: "flex h-full items-center justify-center p-8 text-center text-xs text-muted-foreground", children: children }));
+}
+// ---------------------------------------------------------------------------
+// Inline SVG icons (SDK independence — no lucide dependency)
+// ---------------------------------------------------------------------------
+function SearchIcon() {
+    return (_jsxs("svg", { width: "12", height: "12", viewBox: "0 0 12 12", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", className: "shrink-0 text-muted-foreground", "aria-hidden": "true", children: [_jsx("circle", { cx: "5.25", cy: "5.25", r: "3.5" }), _jsx("path", { d: "M7.75 7.75L10.5 10.5" })] }));
+}
+function ClearIcon() {
+    return (_jsx("svg", { width: "12", height: "12", viewBox: "0 0 12 12", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: _jsx("path", { d: "M3 3L9 9M9 3L3 9" }) }));
+}
+//# sourceMappingURL=WorkspaceFileSearch.js.map

package/workspace/WorkspaceFileSearch.js.map

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

package/workspace/WorkspaceSurface.d.ts

@@ -0,0 +1,151 @@
+import { type ReactNode } from "react";
+import type { FileChange } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/message_pb";
+import { type OpenEditor, type OpenFileOptions, type SelectedWorkspaceFile } from "../internal/store/index.js";
+import type { RevealTarget } from "../internal/useRevealLine.js";
+import type { WorkspaceEntry } from "./useWorkspaceEntries.js";
+import type { WorkspaceFileLister } from "./WorkspaceFileLister.js";
+import type { WorkspaceFileReader } from "./WorkspaceFileReader.js";
+import type { WorkspaceContentSearcher } from "./WorkspaceContentSearcher.js";
+/**
+ * A host-injected rail view: an icon in the activity rail whose content
+ * renders in the sidebar pane when active.
+ *
+ * This is how session facets (Config, Changes, Artifacts, …) join the built-in
+ * Explorer/Search views without the surface knowing any session domain — the
+ * same composition philosophy as the injected lister/reader capabilities
+ * (DD-004). The surface stays an embeddable, domain-pure workspace organism;
+ * hosts extend its rail.
+ */
+export interface SurfaceRailView {
+    /** Unique view id. Must not collide with the built-in `"files"`/`"search"`. */
+    readonly id: string;
+    /** Accessible label; also rendered as the sidebar heading. */
+    readonly label: string;
+    /** Monochrome rail icon (tinted via `currentColor`, DD-005). */
+    readonly icon: ReactNode;
+    /** Optional count badge rendered over the rail icon (hidden when 0). */
+    readonly badge?: number;
+    /** Sidebar content rendered while this view is active. */
+    readonly content: ReactNode;
+}
+/**
+ * A host-injected virtual document: an editor tab whose content is not a
+ * workspace file — the session's `plan.md` today; execution artifacts are the
+ * anticipated next family.
+ *
+ * The editor-area counterpart of {@link SurfaceRailView}'s rail injection
+ * (DD-004): virtual documents share the tab group with file tabs (identical
+ * open / pin / close / activate semantics through the same editors store),
+ * and only the *body* rendering diverges — the surface renders `content`
+ * instead of breadcrumbs + `FileViewer`. The surface stays domain-pure: it
+ * matches tabs to virtual documents by identity and knows nothing about what
+ * the document is.
+ *
+ * `entryId` must come from `virtualEntryId(kind)` so it can never alias a
+ * real workspace entry; `path` doubles as the tab label's source (its
+ * basename), matching file-tab behavior.
+ */
+export interface SurfaceVirtualDocument {
+    /** Virtual entry id (from `virtualEntryId`) — the tab's owning "entry". */
+    readonly entryId: string;
+    /** Tab identity within the entry; its basename is the tab label. */
+    readonly path: string;
+    /** Editor-area content rendered while this document's tab is active. */
+    readonly content: ReactNode;
+}
+/** Props for {@link WorkspaceSurface}. */
+export interface WorkspaceSurfaceProps {
+    /** The workspace entries whose files are browsable (multi-root). */
+    readonly entries: readonly WorkspaceEntry[];
+    /** Platform-injected file lister. `undefined` disables explorer + search. */
+    readonly lister: WorkspaceFileLister | undefined;
+    /** Platform-injected content reader for the editor. */
+    readonly reader: WorkspaceFileReader | undefined;
+    /**
+     * Platform-injected content (text) searcher. When provided, the Search pane
+     * gains a `Name | Text` toggle offering full-text search; `undefined` (web/git
+     * today) keeps the Search pane filename-only (DD-09). Mirrors the lister's
+     * null contract — the honest "unavailable here" state.
+     */
+    readonly searcher?: WorkspaceContentSearcher;
+    /**
+     * The active rail view id (`"files"`, `"search"`, or an {@link SurfaceRailView.id}).
+     * Provide together with `onViewChange` to control the rail from the host;
+     * omit for internal (uncontrolled) view state. An id that matches no view
+     * (e.g. a contextual extra view that disappeared) falls back to `"files"`.
+     */
+    readonly view?: string;
+    /** Called when the user picks a rail view. */
+    readonly onViewChange?: (viewId: string) => void;
+    /**
+     * Host-injected rail views, rendered after the built-in Explorer/Search.
+     * Their `content` renders in the sidebar pane; the editor area stays for
+     * files (the VS Code model).
+     */
+    readonly extraViews?: readonly SurfaceRailView[];
+    /**
+     * Host-injected virtual documents (see {@link SurfaceVirtualDocument}).
+     * A tab whose identity matches one of these renders its `content` in the
+     * editor area instead of the file viewer. The host opens/activates the tab
+     * through the same editors-store seams as files.
+     */
+    readonly virtualDocuments?: readonly SurfaceVirtualDocument[];
+    /**
+     * Detach a workspace entry. When provided, explorer root headers carry a
+     * remove control (VS Code's "Remove Folder from Workspace").
+     */
+    readonly onRemoveEntry?: (entryId: string) => void;
+    /**
+     * Attach a local folder (host opens its native picker and adds the entry).
+     * When provided, the explorer renders an "Add Folder" footer action —
+     * desktop hosts wire this; web hosts omit it (no native picker).
+     */
+    readonly onAddLocalFolder?: () => void;
+    /** Open editor tabs in order (VS Code open-editors model). */
+    readonly editors: readonly OpenEditor[];
+    /** The active editor's file, or `null`. Highlighted in the tree and shown. */
+    readonly selectedFile: SelectedWorkspaceFile | null;
+    /**
+     * Opens a file as a preview (single click) from the explorer or search. The
+     * same seam the tree/search uses; the owner routes it to the editors store.
+     * `options.line` (content-search hits) requests a jump-to-line reveal.
+     */
+    readonly onOpenFile: (entryId: string, path: string, options?: OpenFileOptions) => void;
+    /** Focuses an already-open editor (tab single click). */
+    readonly onActivateEditor: (entryId: string, path: string) => void;
+    /** Pins an editor (tab double-click) so it stops being the preview tab. */
+    readonly onPinEditor: (entryId: string, path: string) => void;
+    /** Closes an editor (tab close control or middle click). */
+    readonly onCloseEditor: (entryId: string, path: string) => void;
+    /** Collapses the surface back to the chat-dominant layout. */
+    readonly onCollapse: () => void;
+    /**
+     * The session {@link FileChange} that touched the open file, when it was
+     * changed this session. When present the editor defaults to the authoritative
+     * `baseline→candidate` diff (DD-06), matching the inspector's Viewer tab.
+     */
+    readonly change?: FileChange;
+    /**
+     * Jump-to-line reveal for the **active** editor (already scoped by the owner
+     * to `reveal.key === activeKey`), or `undefined`. Forwarded to the editor's
+     * viewer, which opens in File view and scrolls to / highlights the line.
+     */
+    readonly reveal?: RevealTarget;
+    /** Additional CSS classes for the root element. */
+    readonly className?: string;
+}
+/**
+ * A VS Code / Cursor-inspired read-only workspace surface: a slim activity rail
+ * (Explorer / Search), a resizable sidebar, and a large editor area.
+ *
+ * This is the workspace-dominant counterpart to the inspector's cramped Viewer
+ * tab. The session viewer flips its layout to give this surface the majority of
+ * the screen while chat becomes a narrow column (see `SessionViewer`). It is a
+ * self-contained organism: given `entries`, a `lister`, a `reader`, and the
+ * open-file selection, it renders identically inside the Console or embedded in
+ * a third-party host (DD-004). Explicitly read-only — no editing, no commit UI.
+ *
+ * All visual properties flow through `--stgm-*` tokens (DD-005).
+ */
+export declare function WorkspaceSurface({ entries, lister, reader, searcher, view, onViewChange, extraViews, virtualDocuments, onRemoveEntry, onAddLocalFolder, editors, selectedFile, onOpenFile, onActivateEditor, onPinEditor, onCloseEditor, onCollapse, change, reveal, className, }: WorkspaceSurfaceProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=WorkspaceSurface.d.ts.map

package/workspace/WorkspaceSurface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkspaceSurface.d.ts","sourceRoot":"","sources":["../../src/workspace/WorkspaceSurface.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAqD,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE1F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iEAAiE,CAAC;AAElG,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC3B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAU9E;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe;IAC9B,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,wEAAwE;IACxE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,sBAAsB;IACrC,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;CAC7B;AAED,0CAA0C;AAC1C,MAAM,WAAW,qBAAqB;IACpC,oEAAoE;IACpE,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IAC5C,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACjD,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACjD;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,wBAAwB,CAAC;IAC7C;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IACjD;;;;;OAKG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAC9D;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IACvC,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IACxC,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACpD;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,CACnB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,eAAe,KACtB,IAAI,CAAC;IACV,yDAAyD;IACzD,QAAQ,CAAC,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACnE,2EAA2E;IAC3E,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9D,4DAA4D;IAC5D,QAAQ,CAAC,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChE,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAC/B,mDAAmD;IACnD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,OAAO,EACP,MAAM,EACN,MAAM,EACN,QAAQ,EACR,IAAI,EACJ,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,OAAO,EACP,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,UAAU,EACV,MAAM,EACN,MAAM,EACN,SAAS,GACV,EAAE,qBAAqB,2CAiFvB"}

package/workspace/WorkspaceSurface.js

@@ -0,0 +1,184 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useCallback, useRef, useState } from "react";
+import { cn } from "@stigmer/theme";
+import { ResizableSplit } from "../internal/ResizableSplit.js";
+import { editorKey, } from "../internal/store/index.js";
+import { WorkspaceFileSearch } from "./WorkspaceFileSearch.js";
+import { WorkspaceContentSearch } from "./WorkspaceContentSearch.js";
+import { FileViewer } from "./FileViewer.js";
+import { EditorTabs } from "./EditorTabs.js";
+import { ExplorerTree } from "./ExplorerTree.js";
+/** The built-in rail views every surface has. */
+const BUILT_IN_VIEWS = ["files", "search"];
+/**
+ * A VS Code / Cursor-inspired read-only workspace surface: a slim activity rail
+ * (Explorer / Search), a resizable sidebar, and a large editor area.
+ *
+ * This is the workspace-dominant counterpart to the inspector's cramped Viewer
+ * tab. The session viewer flips its layout to give this surface the majority of
+ * the screen while chat becomes a narrow column (see `SessionViewer`). It is a
+ * self-contained organism: given `entries`, a `lister`, a `reader`, and the
+ * open-file selection, it renders identically inside the Console or embedded in
+ * a third-party host (DD-004). Explicitly read-only — no editing, no commit UI.
+ *
+ * All visual properties flow through `--stgm-*` tokens (DD-005).
+ */
+export function WorkspaceSurface({ entries, lister, reader, searcher, view, onViewChange, extraViews, virtualDocuments, onRemoveEntry, onAddLocalFolder, editors, selectedFile, onOpenFile, onActivateEditor, onPinEditor, onCloseEditor, onCollapse, change, reveal, className, }) {
+    // Optionally controlled (standard React pattern): a host that owns view
+    // routing (e.g. the session panel's auto-view logic) passes `view` +
+    // `onViewChange`; standalone embedders get internal state for free.
+    const [uncontrolledView, setUncontrolledView] = useState("files");
+    const requestedView = view ?? uncontrolledView;
+    const handleViewChange = useCallback((next) => {
+        setUncontrolledView(next);
+        onViewChange?.(next);
+    }, [onViewChange]);
+    // A stale id (e.g. a contextual extra view that disappeared) degrades to the
+    // explorer rather than an empty sidebar.
+    const isKnownView = BUILT_IN_VIEWS.includes(requestedView) ||
+        (extraViews?.some((v) => v.id === requestedView) ?? false);
+    const activeView = isKnownView ? requestedView : "files";
+    const activeExtraView = extraViews?.find((v) => v.id === activeView);
+    return (_jsxs("div", { className: cn("flex h-full min-h-0", className), children: [_jsx(ActivityRail, { view: activeView, onViewChange: handleViewChange, extraViews: extraViews }), _jsx(ResizableSplit, { resizablePane: "primary", defaultSize: 288, minSize: 200, maxSize: 560, storageKey: "stgm-workspace-sidebar-width", ariaLabel: "Resize sidebar", 
+                // min-w-0: the split is a flex-row child of the surface; without it,
+                // the fixed-width sidebar sub-pane gives the whole surface a hard
+                // minimum width and content overflow escapes to the session panel.
+                className: "min-h-0 min-w-0 flex-1", primary: activeExtraView ? (_jsx(ExtraViewSidebar, { view: activeExtraView })) : activeView === "search" ? (_jsx(SearchSidebar, { entries: entries, lister: lister, searcher: searcher, selectedFile: selectedFile, onOpenFile: onOpenFile })) : (_jsx(ExplorerSidebar, { entries: entries, lister: lister, selectedFile: selectedFile, onOpenFile: onOpenFile, onActivateFile: onPinEditor, onRemoveEntry: onRemoveEntry, onAddLocalFolder: onAddLocalFolder })), secondary: _jsx(EditorArea, { entries: entries, reader: reader, editors: editors, selectedFile: selectedFile, virtualDocuments: virtualDocuments, change: change, reveal: reveal, onActivateEditor: onActivateEditor, onPinEditor: onPinEditor, onCloseEditor: onCloseEditor, onCollapse: onCollapse }) })] }));
+}
+function ActivityRail({ view, onViewChange, extraViews, }) {
+    const items = [
+        { id: "files", label: "Explorer", icon: _jsx(FilesIcon, {}) },
+        { id: "search", label: "Search", icon: _jsx(SearchIcon, {}) },
+        ...(extraViews ?? []),
+    ];
+    // Roving selection: arrows move relative to the *focused* item's position,
+    // so the rail scales to any number of injected views.
+    const handleKeyDown = useCallback((e, index) => {
+        let nextIndex = null;
+        if (e.key === "ArrowDown" || e.key === "ArrowRight") {
+            nextIndex = Math.min(index + 1, items.length - 1);
+        }
+        else if (e.key === "ArrowUp" || e.key === "ArrowLeft") {
+            nextIndex = Math.max(index - 1, 0);
+        }
+        if (nextIndex === null || nextIndex === index)
+            return;
+        e.preventDefault();
+        onViewChange(items[nextIndex].id);
+    }, [items, onViewChange]);
+    return (_jsx("div", { role: "radiogroup", "aria-label": "Workspace view", "aria-orientation": "vertical", className: "flex w-11 shrink-0 flex-col items-center gap-1 border-r border-border bg-muted-faint py-2", children: items.map((item, index) => {
+            const isSelected = view === item.id;
+            const showBadge = item.badge != null && item.badge > 0;
+            return (_jsxs("button", { type: "button", role: "radio", "aria-checked": isSelected, "aria-label": showBadge ? `${item.label} (${item.badge})` : item.label, title: item.label, tabIndex: isSelected ? 0 : -1, onClick: () => onViewChange(item.id), onKeyDown: (e) => handleKeyDown(e, index), className: cn("relative flex h-9 w-9 items-center justify-center rounded-md transition-colors", "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", isSelected
+                    ? "bg-accent text-foreground"
+                    : "text-muted-foreground hover:bg-accent-hover hover:text-foreground"), children: [item.icon, showBadge && (_jsx("span", { "aria-hidden": "true", className: "absolute -right-0.5 -top-0.5 inline-flex min-w-[0.875rem] items-center justify-center rounded-full bg-primary px-1 py-px text-[9px] font-medium leading-none text-primary-foreground", children: item.badge }))] }, item.id));
+        }) }));
+}
+// ---------------------------------------------------------------------------
+// Explorer sidebar — multi-root file tree
+// ---------------------------------------------------------------------------
+function ExplorerSidebar({ entries, lister, selectedFile, onOpenFile, onActivateFile, onRemoveEntry, onAddLocalFolder, }) {
+    return (_jsxs("div", { className: "flex h-full min-h-0 flex-col border-r border-border", children: [_jsx(SidebarHeader, { title: "Explorer" }), _jsx("div", { className: "min-h-0 flex-1 overflow-y-auto py-1.5", children: !lister || entries.length === 0 ? (_jsx(SidebarEmpty, { children: "No workspace attached." })) : (_jsx(ExplorerTree, { entries: entries, lister: lister, selectedFile: selectedFile, onOpenFile: onOpenFile, onActivateFile: onActivateFile, onRemoveEntry: onRemoveEntry })) }), onAddLocalFolder && (_jsx("div", { className: "shrink-0 border-t border-border-muted p-1.5", children: _jsxs("button", { type: "button", onClick: onAddLocalFolder, className: "flex w-full items-center gap-2 rounded-md px-2 py-1.5 text-xs text-foreground transition-colors hover:bg-accent-hover focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", children: [_jsx(FolderPlusIcon, {}), _jsx("span", { className: "flex-1 text-left", children: "Add Folder" })] }) }))] }));
+}
+function SearchSidebar({ entries, lister, searcher, selectedFile, onOpenFile, }) {
+    // Filename search is the default: cached, instant, and always available.
+    // Content (text) search is opt-in and only offered when a searcher exists.
+    const [mode, setMode] = useState("name");
+    return (_jsxs("div", { className: "flex h-full min-h-0 flex-col border-r border-border", children: [_jsx(SidebarHeader, { title: "Search" }), searcher && _jsx(SearchModeToggle, { value: mode, onChange: setMode }), searcher && mode === "text" ? (_jsx(WorkspaceContentSearch, { entries: entries, searcher: searcher, onOpenFile: onOpenFile, selectedFile: selectedFile, className: "min-h-0 flex-1" })) : (_jsx(WorkspaceFileSearch, { entries: entries, lister: lister, onOpenFile: onOpenFile, selectedFile: selectedFile, className: "min-h-0 flex-1" }))] }));
+}
+/**
+ * `Name | Text` search-mode selector, mirroring `FileViewer`'s `Diff | File`
+ * radiogroup (roving `tabindex`, arrow-key roving, `role="radio"`). Shown only
+ * when a content searcher is injected.
+ */
+function SearchModeToggle({ value, onChange, }) {
+    const options = [
+        { value: "name", label: "Name" },
+        { value: "text", label: "Text" },
+    ];
+    const handleKeyDown = useCallback((e) => {
+        if (e.key === "ArrowRight" || e.key === "ArrowLeft") {
+            e.preventDefault();
+            onChange(value === "name" ? "text" : "name");
+        }
+    }, [value, onChange]);
+    return (_jsx("div", { className: "shrink-0 border-b border-border px-2 py-1.5", children: _jsx("div", { role: "radiogroup", "aria-label": "Search mode", className: "inline-flex rounded-md bg-muted p-0.5", children: options.map((option) => {
+                const isSelected = value === option.value;
+                return (_jsx("button", { type: "button", role: "radio", "aria-checked": isSelected, tabIndex: isSelected ? 0 : -1, onClick: () => onChange(option.value), onKeyDown: handleKeyDown, className: cn("rounded px-2.5 py-0.5 text-[0.7rem] font-medium transition-colors", "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", isSelected
+                        ? "bg-background text-foreground shadow-sm"
+                        : "text-muted-foreground hover:text-foreground"), children: option.label }, option.value));
+            }) }) }));
+}
+// ---------------------------------------------------------------------------
+// Extra-view sidebar — host-injected facet content (Config, Changes, …)
+// ---------------------------------------------------------------------------
+function ExtraViewSidebar({ view }) {
+    return (_jsxs("div", { className: "flex h-full min-h-0 flex-col border-r border-border", children: [_jsx(SidebarHeader, { title: view.label }), _jsx("div", { className: "min-h-0 flex-1 overflow-y-auto px-3 py-3", children: view.content })] }));
+}
+// ---------------------------------------------------------------------------
+// Editor area — collapse control + tab strip + read-only FileViewer
+// ---------------------------------------------------------------------------
+function EditorArea({ entries, reader, editors, selectedFile, virtualDocuments, change, reveal, onActivateEditor, onPinEditor, onCloseEditor, onCollapse, }) {
+    const viewerRef = useRef(null);
+    const activeKey = selectedFile
+        ? editorKey(selectedFile.entryId, selectedFile.path)
+        : null;
+    // The active tab is a virtual document when its identity matches an injected
+    // one — the body renders the document's content instead of the file viewer.
+    const activeVirtualDocument = activeKey !== null
+        ? virtualDocuments?.find((d) => editorKey(d.entryId, d.path) === activeKey)
+        : undefined;
+    const activeEntryName = selectedFile
+        ? entries.find((e) => e.id === selectedFile.entryId)?.name
+        : undefined;
+    return (_jsxs("div", { className: "flex h-full min-h-0 flex-col", children: [_jsxs("div", { className: "flex shrink-0 items-stretch border-b border-border pr-24", children: [_jsx("button", { type: "button", onClick: onCollapse, "aria-label": "Back to chat", title: "Back to chat", className: "flex shrink-0 items-center border-r border-border px-2 text-muted-foreground transition-colors hover:bg-accent-hover hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-ring", children: _jsx(ChevronLeftIcon, {}) }), editors.length > 0 && (_jsx(EditorTabs, { editors: editors, activeKey: activeKey, onActivate: onActivateEditor, onPin: onPinEditor, onClose: onCloseEditor, className: "min-w-0 flex-1 border-b-0" }))] }), activeVirtualDocument ? (
+            // A virtual document owns its body wholesale: no breadcrumbs (there is
+            // no filesystem location) and no FileViewer (there is no reader-backed
+            // file). Keyed like files so switching documents resets cleanly.
+            // Vertical-only scrolling: a lone overflow-y-auto would compute
+            // overflow-x to auto too, giving the pane a horizontal scrollbar the
+            // moment any child refuses to shrink — documents must reflow instead.
+            _jsx("div", { className: "min-h-0 min-w-0 flex-1 overflow-y-auto overflow-x-hidden", children: activeVirtualDocument.content }, activeKey ?? undefined)) : selectedFile ? (_jsxs(_Fragment, { children: [_jsx(Breadcrumbs, { entryName: activeEntryName, path: selectedFile.path, onRefresh: reader ? () => viewerRef.current?.refresh() : undefined }), _jsx(FileViewer, { ref: viewerRef, selectedFile: selectedFile, entries: entries, reader: reader, change: change, reveal: reveal, onClose: onCollapse, showHeader: false, className: "min-h-0 flex-1" }, activeKey ?? undefined)] })) : (_jsx("div", { className: "flex flex-1 items-center justify-center p-8 text-center text-xs text-muted-foreground", children: "Select a file to view its contents." }))] }));
+}
+/**
+ * Location breadcrumb for the active file: entry › folder › … › file, with an
+ * optional refresh. Display-only orientation (clickable navigation is a future
+ * enhancement); the refresh re-fetches the live file content.
+ */
+function Breadcrumbs({ entryName, path, onRefresh, }) {
+    const segments = path.split("/").filter(Boolean);
+    const crumbs = entryName ? [entryName, ...segments] : segments;
+    return (_jsxs("div", { className: "flex shrink-0 items-center gap-1 border-b border-border-muted px-3 py-1 text-[0.65rem] text-muted-foreground", children: [_jsx("nav", { "aria-label": "File location", className: "flex min-w-0 flex-1 items-center gap-1", children: crumbs.map((crumb, i) => {
+                    const isLast = i === crumbs.length - 1;
+                    return (_jsxs("span", { className: "flex min-w-0 items-center gap-1", children: [i > 0 && _jsx("span", { className: "text-muted-foreground-subtle", "aria-hidden": "true", children: "\u203A" }), _jsx("span", { className: cn("truncate", isLast && "text-foreground"), children: crumb })] }, i));
+                }) }), onRefresh && (_jsx("button", { type: "button", onClick: onRefresh, "aria-label": "Reload file", title: "Reload file", className: "shrink-0 rounded p-0.5 text-muted-foreground transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring", children: _jsx(RefreshIcon, {}) }))] }));
+}
+// ---------------------------------------------------------------------------
+// Shared sidebar chrome
+// ---------------------------------------------------------------------------
+function SidebarHeader({ title }) {
+    return (_jsx("div", { className: "shrink-0 border-b border-border px-3 py-2 text-[0.65rem] font-semibold uppercase tracking-wide text-muted-foreground", children: title }));
+}
+function SidebarEmpty({ children }) {
+    return (_jsx("div", { className: "px-2 py-6 text-center text-xs text-muted-foreground", children: children }));
+}
+// ---------------------------------------------------------------------------
+// Inline SVG icons (SDK independence — no lucide dependency)
+// ---------------------------------------------------------------------------
+function FilesIcon() {
+    return (_jsxs("svg", { width: "18", height: "18", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "1.7", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [_jsx("path", { d: "M13 3H6a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z" }), _jsx("path", { d: "M13 3v5h5" })] }));
+}
+function SearchIcon() {
+    return (_jsxs("svg", { width: "18", height: "18", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "1.7", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [_jsx("circle", { cx: "11", cy: "11", r: "7" }), _jsx("path", { d: "M21 21l-4.3-4.3" })] }));
+}
+function FolderPlusIcon() {
+    return (_jsxs("svg", { width: "14", height: "14", viewBox: "0 0 14 14", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", className: "shrink-0 text-muted-foreground", "aria-hidden": "true", children: [_jsx("path", { d: "M1.5 3.5V11a1 1 0 001 1h9a1 1 0 001-1V5.5a1 1 0 00-1-1H7L5.5 3H2.5a1 1 0 00-1 .5z" }), _jsx("path", { d: "M7 7v3M5.5 8.5h3" })] }));
+}
+function ChevronLeftIcon() {
+    return (_jsx("svg", { width: "16", height: "16", viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: _jsx("path", { d: "M10 3L5 8L10 13" }) }));
+}
+function RefreshIcon() {
+    return (_jsxs("svg", { width: "12", height: "12", viewBox: "0 0 12 12", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [_jsx("path", { d: "M1.5 6a4.5 4.5 0 017.794-3.073M10.5 6a4.5 4.5 0 01-7.794 3.073" }), _jsx("path", { d: "M9.5 1v2.5H7M2.5 11V8.5H5" })] }));
+}
+//# sourceMappingURL=WorkspaceSurface.js.map

package/workspace/WorkspaceSurface.js.map

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

package/workspace/findChangeForSelection.d.ts

@@ -0,0 +1,19 @@
+import type { FileChange } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/message_pb";
+import type { SelectedWorkspaceFile } from "../internal/store/workspace-file-selection-store.js";
+import type { WorkspaceEntry } from "./useWorkspaceEntries.js";
+/**
+ * The session {@link FileChange} that touched the currently-open file, or
+ * `null` when the open file was not changed this session (or cannot be
+ * correlated with certainty).
+ *
+ * @param selection - The open file, keyed by `entryId` + repo/root-relative `path`.
+ * @param fileChanges - Net-per-file session changes (from `useSessionFileChanges`).
+ * @param entries - The client workspace entries — the SAME list the tree and
+ *   transcript resolve against (`flow.workspace.entries`), so the returned
+ *   `entryId` is directly comparable. Do not pass the proto `workspaceEntries`.
+ * @param sandboxWorkspaceRoot - The sandbox root for git sessions (strips
+ *   cloud-absolute change paths), identical to the transcript resolver's input.
+ * @returns The matching change, or `null`.
+ */
+export declare function findChangeForSelection(selection: SelectedWorkspaceFile, fileChanges: readonly FileChange[], entries: readonly WorkspaceEntry[], sandboxWorkspaceRoot?: string): FileChange | null;
+//# sourceMappingURL=findChangeForSelection.d.ts.map

package/workspace/findChangeForSelection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findChangeForSelection.d.ts","sourceRoot":"","sources":["../../src/workspace/findChangeForSelection.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iEAAiE,CAAC;AAClG,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qDAAqD,CAAC;AAEjG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,qBAAqB,EAChC,WAAW,EAAE,SAAS,UAAU,EAAE,EAClC,OAAO,EAAE,SAAS,cAAc,EAAE,EAClC,oBAAoB,CAAC,EAAE,MAAM,GAC5B,UAAU,GAAG,IAAI,CAgBnB"}