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

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/index.d.ts

@@ -14,6 +14,7 @@
 import type { ClientContext } from './contract.ts';
 export { Board, listRuns } from './board.tsx';
 export { Inspector } from './inspector.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

package/lib/client.js

@@ -335,8 +335,8 @@ window.__ModuleLoader__.load({
 			for (const worktreeRoot of Object.keys(projection)) for (const runId of Object.keys(projection[worktreeRoot])) runs.push(projection[worktreeRoot][runId]);
 			return runs;
 		}
-		function closeButton$1(onClose) {
-			if (onClose === void 0) return null;
+		function closeButton$1(onClose, variant) {
+			if (onClose === void 0 || variant === "view") return null;
 			return (0, react.createElement)("button", {
 				type: "button",
 				className: "rec-close",
@@ -356,7 +356,7 @@ window.__ModuleLoader__.load({
 				"data-pill": kind
 			}, PILL_LABELS[kind]);
 		}
-		function Board({ snapshot, workspacePath, onOpenInspector, onClose }) {
+		function Board({ snapshot, workspacePath, onOpenInspector, onClose, variant = "overlay" }) {
 			const { theme, toggle } = useBoardTheme();
 			if (snapshot === null || snapshot.root === null) return null;
 			const runs = workspacePath !== void 0 && workspacePath !== "" && !sameWorkspacePath(workspacePath, snapshot.root) ? [] : listRuns(snapshot.projection);
@@ -365,21 +365,22 @@ window.__ModuleLoader__.load({
 				worktreeRoot: run.worktreeRoot,
 				runId: run.runId
 			});
+			const rootCls = variant === "view" ? "rec-board rec-board-view" : "rec-board";
 			if (runs.length === 0) return (0, react.createElement)("div", {
-				className: "rec-board",
+				className: rootCls,
 				"data-theme": theme,
 				"data-empty": true
 			}, (0, react.createElement)("header", { className: "rec-board-header" }, (0, react.createElement)("h2", { className: "rec-board-title" }, "Recursive runs"), (0, react.createElement)("span", { className: "rec-board-path" }, headerPath), (0, react.createElement)("span", { className: "rec-board-count" }, "0 runs"), (0, react.createElement)(ThemeToggle, {
 				theme,
 				toggle
-			}), closeButton$1(onClose)), (0, react.createElement)("p", { className: "rec-board-empty" }, "No recursive runs in this workspace yet."));
+			}), closeButton$1(onClose, variant)), (0, react.createElement)("p", { className: "rec-board-empty" }, "No recursive runs in this workspace yet."));
 			return (0, react.createElement)("div", {
-				className: "rec-board",
+				className: rootCls,
 				"data-theme": theme
 			}, (0, react.createElement)("header", { className: "rec-board-header" }, (0, react.createElement)("h2", { className: "rec-board-title" }, "Recursive runs"), (0, react.createElement)("span", { className: "rec-board-path" }, headerPath), (0, react.createElement)("span", { className: "rec-board-count" }, runs.length + " runs"), (0, react.createElement)(ThemeToggle, {
 				theme,
 				toggle
-			}), closeButton$1(onClose)), (0, react.createElement)("div", { className: "rec-columns" }, KANBAN_LANES.map((lane) => {
+			}), closeButton$1(onClose, variant)), (0, react.createElement)("div", { className: "rec-columns" }, KANBAN_LANES.map((lane) => {
 				const laneRuns = runs.filter((r) => columnForRun(r) === lane.id);
 				return (0, react.createElement)("section", {
 					key: lane.id,
@@ -781,6 +782,17 @@ window.__ModuleLoader__.load({
   overflow: hidden;
 }
 
+/* Inline board (conversation.view tab): fills its parent view area, not fixed. */
+.rec-board-view {
+  position: relative;
+  inset: auto;
+  z-index: auto;
+  width: 100%;
+  height: 100%;
+  min-height: 0;
+  flex: 1;
+}
+
 .rec-board-header {
   display: flex;
   align-items: center;
@@ -1257,9 +1269,51 @@ window.__ModuleLoader__.load({
 				onClick: () => boardState.openBoard()
 			}, "⧉");
 		}
+		/**
+		* 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.
+		*/
+		function RecursiveView({ useSessions, useWorkspaces }) {
+			const board = useBoardState();
+			const sessions = useRecursiveSessions(useSessions);
+			const wsPath = currentWorkspacePath(useWorkspaces((s) => s) ?? {
+				items: [],
+				recentWorkspaceId: void 0
+			}, sessions);
+			const snapshot = useLiveProjection({ cwd: wsPath });
+			if (board.selection !== null) return (0, react.createElement)(Inspector, {
+				runId: board.selection.runId,
+				worktreeRoot: board.selection.worktreeRoot,
+				snapshot,
+				onBackToToolDetails: () => boardState.backToBoard(),
+				onClose: () => boardState.close()
+			});
+			return (0, react.createElement)(Board, {
+				snapshot,
+				workspacePath: wsPath,
+				variant: "view",
+				onOpenInspector: (sel) => boardState.openInspector(sel)
+			});
+		}
 		function registerSlots(ctx) {
 			const disposers = [];
 			disposers.push(injectBoardStyles());
+			disposers.push(ctx.slots.inject("conversation.view", () => ctx.slots.register({
+				name: "conversation.view",
+				id: "recursive",
+				order: 20,
+				label: "Recursive"
+			}, (props) => {
+				const useSessions = props?.useSessions;
+				const useWorkspaces = props?.useWorkspaces;
+				if (useSessions === void 0 || useWorkspaces === void 0) return null;
+				return (0, react.createElement)(RecursiveView, {
+					useSessions,
+					useWorkspaces
+				});
+			})));
 			disposers.push(ctx.slots.inject("sidebar.footer.action", () => ctx.slots.register({
 				name: "sidebar.footer.action",
 				id: "recursive",
@@ -1355,6 +1409,7 @@ window.__ModuleLoader__.load({
 		exports.Board = Board;
 		exports.Inspector = Inspector;
 		exports.RecursiveSettings = RecursiveSettings;
+		exports.RecursiveView = RecursiveView;
 		exports.apply = apply;
 		exports.currentSessionCwd = currentSessionCwd;
 		exports.currentWorkspacePath = currentWorkspacePath;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@try-works/dsh-recursive-mode",
   "description": "recursive-mode workflow as a DeepSeek Harness bundle: RecursiveRuntime service + recursive_status tool",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

package/src/client/board.tsx

@@ -32,10 +32,16 @@ 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'
 }
 
-function closeButton(onClose: (() => void) | undefined) {
-  if (onClose === undefined) return null
+function closeButton(onClose: (() => void) | undefined, variant: 'overlay' | 'view') {
+  if (onClose === undefined || variant === 'view') return null
   return createElement('button', { type: 'button', className: 'rec-close', onClick: onClose, title: 'Close', 'aria-label': 'Close' }, '×')
 }
 
@@ -49,7 +55,7 @@ function solidPill(kind: ReturnType<typeof cardPill>) {
   return createElement('span', { className: 'rec-pill', 'data-pill': kind }, PILL_LABELS[kind])
 }
 
-export function Board({ snapshot, workspacePath, onOpenInspector, onClose }: BoardProps) {
+export function Board({ snapshot, workspacePath, onOpenInspector, onClose, variant = 'overlay' }: BoardProps) {
   const { theme, toggle } = useBoardTheme()
   if (snapshot === null || snapshot.root === null) return null
   // Run 16: when the synchronous workspace path differs from the async snapshot
@@ -59,25 +65,26 @@ export function Board({ snapshot, workspacePath, onOpenInspector, onClose }: Boa
   const runs = stale ? [] : listRuns(snapshot.projection)
   const headerPath = workspacePath ?? snapshot.root
   const open = (run: RecursiveRunCard) => () => onOpenInspector?.({ worktreeRoot: run.worktreeRoot, runId: run.runId })
+  const rootCls = variant === 'view' ? 'rec-board rec-board-view' : 'rec-board'
   if (runs.length === 0) {
-    return createElement('div', { className: 'rec-board', 'data-theme': theme, 'data-empty': true },
+    return createElement('div', { className: rootCls, 'data-theme': theme, 'data-empty': true },
       createElement('header', { className: 'rec-board-header' },
         createElement('h2', { className: 'rec-board-title' }, 'Recursive runs'),
         createElement('span', { className: 'rec-board-path' }, headerPath),
         createElement('span', { className: 'rec-board-count' }, '0 runs'),
         createElement(ThemeToggle, { theme, toggle }),
-        closeButton(onClose),
+        closeButton(onClose, variant),
       ),
       createElement('p', { className: 'rec-board-empty' }, 'No recursive runs in this workspace yet.'),
     )
   }
-  return createElement('div', { className: 'rec-board', 'data-theme': theme },
+  return createElement('div', { className: rootCls, 'data-theme': theme },
     createElement('header', { className: 'rec-board-header' },
       createElement('h2', { className: 'rec-board-title' }, 'Recursive runs'),
       createElement('span', { className: 'rec-board-path' }, headerPath),
       createElement('span', { className: 'rec-board-count' }, runs.length + ' runs'),
       createElement(ThemeToggle, { theme, toggle }),
-      closeButton(onClose),
+      closeButton(onClose, variant),
     ),
     createElement('div', { className: 'rec-columns' },
       KANBAN_LANES.map((lane) => {

package/src/client/index.ts

@@ -17,6 +17,7 @@ import { claimClientApply, releaseClientApply } from './apply-guard.ts'
 
 export { Board, listRuns } from './board.tsx'
 export { Inspector } from './inspector.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/src/client/slots.ts

@@ -64,11 +64,54 @@ export function RecursiveLauncherGate({ useSessions }: { useSessions: SnapshotSe
   return createElement('button', { className: 'rec-launcher', title: 'Recursive runs', onClick: () => boardState.openBoard() }, '⧉')
 }
 
+/**
+ * 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 function RecursiveView({ useSessions, useWorkspaces }: { useSessions: SnapshotSelectorHook<SessionListStateLike>; useWorkspaces: SnapshotSelectorHook<WorkspaceListStateLike> }): ReactNode {
+  const board = useBoardState()
+  const sessions = useRecursiveSessions(useSessions)
+  const workspaces: WorkspaceListStateLike = useWorkspaces((s) => s) ?? { items: [], recentWorkspaceId: undefined }
+  const wsPath = currentWorkspacePath(workspaces, sessions)
+  const scope = { cwd: wsPath }
+  const snapshot = useLiveProjection(scope)
+  // Inspector drill-down (modal over the inline board) when a run is selected.
+  if (board.selection !== null) {
+    return createElement(Inspector, {
+      runId: board.selection.runId,
+      worktreeRoot: board.selection.worktreeRoot,
+      snapshot,
+      onBackToToolDetails: () => boardState.backToBoard(),
+      onClose: () => boardState.close(),
+    })
+  }
+  return createElement(Board, { snapshot, workspacePath: wsPath, variant: 'view', onOpenInspector: (sel) => boardState.openInspector(sel) })
+}
+
 export function registerSlots(ctx: ClientContext): () => void {
   const disposers: (() => void)[] = []
   // Run 15: inject the one-shot theme-token stylesheet once per document (idempotent).
   disposers.push(injectBoardStyles())
 
+  // Conversation view tab (Chat | Trajectory | Recursive): the recursive run
+  // board as a first-class tab in the conversation header, rendered INLINE in
+  // the view area (not a fixed overlay). Order 20 places it to the RIGHT of
+  // Trajectory (order 10). Always present — no recursive-preset gate, so the
+  // entry point is discoverable in any session.
+  disposers.push(ctx.slots.inject('conversation.view', () => ctx.slots.register({
+    name: 'conversation.view',
+    id: 'recursive',
+    order: 20,
+    label: 'Recursive',
+  }, (props: RootSlotProps) => {
+    const useSessions = props?.useSessions
+    const useWorkspaces = props?.useWorkspaces
+    if (useSessions === undefined || useWorkspaces === undefined) return null
+    return createElement(RecursiveView, { useSessions, useWorkspaces })
+  })))
+
   // Board launcher in the sidebar footer action list — OPENS the shared board store (run 08 R1).
   // Run 11 (UX gate): the seat is root-scoped (visible in every session), but the board it
   // opens is recursive-preset-gated. In a code/other session the icon was a dead click — a

package/src/client/styles.ts

@@ -136,6 +136,17 @@ const BOARD_CSS = `
   overflow: hidden;
 }
 
+/* Inline board (conversation.view tab): fills its parent view area, not fixed. */
+.rec-board-view {
+  position: relative;
+  inset: auto;
+  z-index: auto;
+  width: 100%;
+  height: 100%;
+  min-height: 0;
+  flex: 1;
+}
+
 .rec-board-header {
   display: flex;
   align-items: center;