@try-works/dsh-recursive-mode 0.2.2 → 0.2.4

package/lib/client/board.d.ts

@@ -9,8 +9,14 @@ export interface BoardProps {
     workspacePath?: string;
     onOpenInspector?: (selection: BoardSelection) => void;
     onClose?: () => void;
+    /**
+     * 'overlay' (default) renders the board as a full-viewport fixed overlay
+     * (shell.overlay / launcher). 'view' renders it inline, filling its parent
+     * (a conversation.view tab), with no close button and no fixed positioning.
+     */
+    variant?: 'overlay' | 'view';
 }
-export declare function Board({ snapshot, workspacePath, onOpenInspector, onClose }: BoardProps): import("react").DetailedReactHTMLElement<{
+export declare function Board({ snapshot, workspacePath, onOpenInspector, onClose, variant }: BoardProps): import("react").DetailedReactHTMLElement<{
     className: string;
     'data-theme': import("./theme.ts").BoardTheme;
 }, HTMLElement> | null;

package/lib/client/doc-viewer.d.ts

@@ -0,0 +1,40 @@
+import type { ReactNode } from 'react';
+import type { BoardTheme } from './theme.ts';
+/** One rendered markdown line (parsePlan base + fenced code + tables). */
+export interface DocLine {
+    kind: 'blank' | 'h1' | 'h2' | 'h3' | 'h4' | 'li' | 'plain' | 'code' | 'table';
+    text: string;
+    /** table: data rows (header separator row dropped); first row is the header. */
+    cells?: string[][];
+}
+/** Inline segment parsed from line text (bold / code span / link). */
+export interface InlineSegment {
+    type: 'text' | 'bold' | 'code' | 'link';
+    text: string;
+    href?: string;
+}
+/**
+ * Markdown -> line tokens. Base is parsePlan (blank/h1-h4/li/plain, MIT),
+ * extended for fenced code blocks (one code line per block) and pipe tables
+ * (one table line per block, header separator row dropped).
+ */
+export declare function parseDoc(plan: string): DocLine[];
+/**
+ * Inline scanner: **bold**, `code`, [text](url); unmatched markers stay plain
+ * text. Used to build the React children of a line text.
+ */
+export declare function parseInline(text: string): InlineSegment[];
+export interface DocViewerProps {
+    runId: string;
+    worktreeRoot: string;
+    fileName: string;
+    theme: BoardTheme;
+    onClose: () => void;
+}
+/**
+ * The per-phase doc viewer. Fetches the route on mount / fileName change.
+ * Vim nav + / search + n/N + Esc; y copies the doc. Esc closes search first,
+ * else the viewer. data-theme is passed down by the hoisting Inspector
+ * (0.1.10 invariant: useBoardTheme lives in the panel).
+ */
+export declare function DocViewer({ runId, worktreeRoot, fileName, theme, onClose }: DocViewerProps): ReactNode;

package/lib/client/host-api.d.ts

@@ -15,6 +15,19 @@ export interface LiveScope {
 }
 /** Fetch the current state for one session scope (host resolves the workspace root). */
 export declare function fetchLiveState(scope: LiveScope, signal?: AbortSignal): Promise<LiveRecursiveState>;
+/** One doc fetch request: the host-known workspace root + run id + phase doc file. */
+export interface PhaseDocRequest {
+    root: string;
+    runId: string;
+    file: string;
+}
+/**
+ * Fetch one per-phase run doc (0.2.4) via the lazy GET /.recursive/api/doc
+ * route. Raw markdown text; the host validates the root (known workspace) and
+ * guards the file path (phase-doc basename only, containment under the run
+ * dir). Same 15s AbortController timeout as fetchLiveState.
+ */
+export declare function fetchPhaseDoc(req: PhaseDocRequest): Promise<string>;
 /**
  * Subscribe to the SSE events feed. Returns a disposer. The host pushes a full
  * {revision, root, projection} frame on every fs change + a 15s heartbeat.

package/lib/client/index.d.ts

@@ -14,6 +14,8 @@
 import type { ClientContext } from './contract.ts';
 export { Board, listRuns } from './board.tsx';
 export { Inspector } from './inspector.tsx';
+export { DocViewer, parseDoc, parseInline } from './doc-viewer.tsx';
+export { RecursiveView } from './slots.ts';
 export { RecursiveSettings } from './settings.tsx';
 export { useLiveProjection } from './use-live.ts';
 export type { LiveProjectionSnapshot } from './use-live.ts';

package/lib/client/slots.d.ts

@@ -41,6 +41,16 @@ export declare function useRecursiveSessions(useSessions: SnapshotSelectorHook<S
 export declare function RecursiveLauncherGate({ useSessions }: {
     useSessions: SnapshotSelectorHook<SessionListStateLike>;
 }): ReactNode;
+/**
+ * RecursiveView: the conversation.view tab body. Renders the run board INLINE
+ * (fills the view area) keyed on the CURRENT workspace, and swaps to the
+ * inspector modal when a run is opened. Read-only (R9): uses the live host
+ * route. No preset gate — the tab is discoverable in any session.
+ */
+export declare function RecursiveView({ useSessions, useWorkspaces }: {
+    useSessions: SnapshotSelectorHook<SessionListStateLike>;
+    useWorkspaces: SnapshotSelectorHook<WorkspaceListStateLike>;
+}): ReactNode;
 export declare function registerSlots(ctx: ClientContext): () => void;
 /**
  * Board overlay: subscribes to the shared board store, gates on open + recursive