@opengeni/react 2.5.0-canary.2 → 3.0.0-canary.0

package/dist/hooks/use-file-attachments.d.ts

@@ -50,7 +50,14 @@ export type UseFileAttachmentsResult = {
      * source file). No-op for an id that isn't a known failed upload.
      */
     retry: (id: string) => void;
-    /** Remove one attachment; revokes its object-URL. */
+    /**
+     * Keep an attachment's object-URL alive for a consumer that outlives its
+     * queue entry (for example, an open route-level lightbox). The returned
+     * release is idempotent; pending revocation finishes after the last holder
+     * releases. Returns `undefined` when the attachment has no local preview.
+     */
+    retainPreview: (id: string) => (() => void) | undefined;
+    /** Remove one attachment; revokes its object-URL after retained users finish. */
     remove: (id: string) => void;
     /**
      * Remove only finalized files whose durable ids were accepted by a send.
@@ -58,7 +65,7 @@ export type UseFileAttachmentsResult = {
      * next message.
      */
     removeReadyFiles: (fileIds: Iterable<string>) => void;
-    /** Remove all attachments and revoke every object-URL. */
+    /** Remove all attachments and revoke every unretained object-URL. */
     clear: () => void;
 };
 /**

package/dist/human-input.d.ts

@@ -1,4 +1,4 @@
-import type { HumanInputQuestion, SessionEvent } from "@opengeni/sdk";
+import type { HumanInputQuestion, SessionEvent, SessionHumanInputRequest } from "@opengeni/sdk";
 /** Minimal actionable request shape available from the durable event log. */
 export type PendingHumanInputRequest = {
     id: string;
@@ -7,6 +7,8 @@ export type PendingHumanInputRequest = {
     allowSkip: boolean;
     expiresAt: string | null;
 };
+/** A pending row stops being actionable at its durable deadline, even before refresh. */
+export declare function isActionableHumanInputRequest(request: Pick<SessionHumanInputRequest, "status" | "expiresAt">, nowMs?: number): boolean;
 /** Parse one generic `session.humanInput.requested` event defensively. */
 export declare function humanInputRequestFromEvent(event: Pick<SessionEvent, "type" | "payload" | "turnId">): PendingHumanInputRequest | null;
 /**

package/dist/index.d.ts

@@ -4,7 +4,11 @@ export type { OpenGeniProviderProps } from "./provider.js";
 export { useOpenGeni, useOpenGeniClient } from "./session-context.js";
 export { useVideoArtifactPlaybackLoader } from "./hooks/use-video-artifact-playback.js";
 export type { ClientOverride, OpenGeniContextValue } from "./session-context.js";
+export { createEmbeddedSessionClient } from "./embedded-session-client.js";
+export type { ComposerDraftMapContext, CreateEmbeddedSessionClientOptions, } from "./embedded-session-client.js";
 export { usePageLiveActivity } from "./hooks/internal.js";
+export { filePathVisibility, visibleFileTree } from "./file-node-visibility.js";
+export type { FileNodeVisibilityContext, FileNodeVisibilityPredicate, FilePathVisibility, } from "./file-node-visibility.js";
 export { useSession, isTitleEvent } from "./hooks/use-session.js";
 export type { UseSessionOptions, UseSessionResult } from "./hooks/use-session.js";
 export { SESSION_EVENT_BROWSER_MAX_BYTES, SESSION_EVENT_BROWSER_MAX_COUNT, SESSION_EVENT_BROWSER_PENDING_MAX_BYTES, SESSION_EVENT_BROWSER_PENDING_MAX_COUNT, SESSION_EVENT_BROWSER_SINGLE_EVENT_MAX_BYTES, boundBrowserSessionEventWindow, useSessionEvents, } from "./hooks/use-session-events.js";
@@ -97,7 +101,7 @@ export type { ActivityItem, AgentMessageItem, AuthNeededItem, ContextCompactionI
 export { createDefaultToolRegistry, createToolRegistry, defaultToolRegistry, rawTypeOf, } from "./timeline/index.js";
 export type { CreateToolRegistryOptions, RetainedArtifactLoader, RetainedScreenshotLoader, VideoArtifactPlaybackLoader, ToolRegistry, ToolRegistryEntry, ToolRenderer, ToolRendererProps, } from "./timeline/index.js";
 export { ActivityDisclosure, ActivityRail, BodyNote, DisclosureDefaultsProvider, LightboxProvider, MediaEmpty, MediaSkeleton, PayloadBlock, ScreenshotFigure, TermBlock, Thumbnail, TurnSummary, BUILT_IN_TURN_SUMMARY_FACET_IDS, useLightbox, useLightboxOptional, } from "./timeline/index.js";
-export type { ActivityDisclosureProps, ActivityRailProps, DisclosureChip, BuiltInTurnSummaryFacetId, TurnOutcome, TurnSummaryContext, TurnSummaryFacet, TurnSummaryFacetConfiguration, TurnSummaryFacetResult, TurnSummaryOptions, TurnSummaryProps, } from "./timeline/index.js";
+export type { ActivityDisclosureProps, ActivityRailProps, DisclosureChip, BuiltInTurnSummaryFacetId, TurnOutcome, TurnSummaryContext, TurnSummaryFacet, TurnSummaryFacetConfiguration, TurnSummaryFacetResult, TurnSummaryOptions, TurnSummaryProps, LightboxControlLabels, } from "./timeline/index.js";
 export { applyPatchOps, applyPatchOpsFromToolItem, controlCaret, execTruncated, isApplyPatch, isExecSessionLostBanner, looksBinary, parseExecBannerSessionId, parseFreeformApplyPatch, parseToolArgs, sandboxCommandExitCode, stripExecBanner, tailPeek, unwrapMcpOutput, v4aToGitFileDiff, } from "./timeline/index.js";
 export type { ApplyPatchOperation } from "./timeline/index.js";
 export { argHint, defaultCommands, filterCommands, firstMissingRequiredArg, hasPermission, matchCommand, parseCommandLine, } from "./commands/registry.js";

package/dist/index.js

@@ -6,7 +6,7 @@ import {
   SESSION_EVENT_BROWSER_SINGLE_EVENT_MAX_BYTES,
   approvalsFromRequiresAction,
   boundBrowserSessionEventWindow,
-  humanInputRequestFromEvent,
+  createEmbeddedSessionClient,
   isGoalEvent,
   isHumanInputEvent,
   isLineageRefreshEvent,
@@ -14,7 +14,6 @@ import {
   isTitleEvent,
   isTurnQueueEvent,
   projectPendingApprovals,
-  projectPendingHumanInputRequests,
   useFileAttachments,
   useGoal,
   useHumanInputRequests,
@@ -24,7 +23,7 @@ import {
   useSessionLineage,
   useSessionMcpApprovalPolicy,
   useTurnQueue
-} from "./chunk-ATQJEWCA.js";
+} from "./chunk-YJFGAFBD.js";
 import {
   CONNECTION_STATUS_META,
   ConnectionDot,
@@ -109,14 +108,14 @@ import {
   useSlashCommands,
   useTranscription,
   useVoiceInput
-} from "./chunk-ZUT5QSQB.js";
+} from "./chunk-RGALCTWO.js";
 import {
   FILE_ONLY_MESSAGE_TEXT,
   composeSendInput,
   shouldSteerOnKey,
   shouldSubmitOnKey,
   useComposer
-} from "./chunk-T7VAYG2I.js";
+} from "./chunk-MZ2G2XBA.js";
 import {
   BillingClassMark,
   ModelPolicyPicker,
@@ -155,7 +154,6 @@ import {
   GeneratedVideoPlayer,
   HumanInputForm,
   HumanInputSurface,
-  LightboxProvider,
   Markdown,
   MediaEmpty,
   MediaSkeleton,
@@ -200,30 +198,33 @@ import {
   stripExecBanner,
   tailPeek,
   unwrapMcpOutput,
-  useLightbox,
-  useLightboxOptional,
   useThemeType,
   userMessageLikelyNeedsDisclosure,
   v4aToGitFileDiff
-} from "./chunk-6H6S5V4Z.js";
+} from "./chunk-HQVCKCLG.js";
 import {
   buildTimeline,
   createOlderHistoryLoadReceipt,
   creditExhaustedFromEvents,
   extractSessionRef,
   groupTimeline,
+  humanInputRequestFromEvent,
+  projectPendingHumanInputRequests,
   sessionStatusFromEvents,
   toolDisplayName
-} from "./chunk-MXJGO7LE.js";
+} from "./chunk-D3UIAJKY.js";
 import {
   TimelineAnnotationsChip
 } from "./chunk-WSK7G5LE.js";
 import {
+  LightboxProvider,
   Tooltip,
   TooltipContent,
   TooltipProvider,
-  TooltipTrigger
-} from "./chunk-FK6VG4LL.js";
+  TooltipTrigger,
+  useLightbox,
+  useLightboxOptional
+} from "./chunk-YFKJ7VZH.js";
 import {
   usePortalTokenSource,
   usePortalTokenStyle
@@ -251,6 +252,10 @@ import {
   useOpenGeni,
   useOpenGeniClient
 } from "./chunk-NEXLLTP4.js";
+import {
+  copyTextToClipboard,
+  tableElementToTsv
+} from "./chunk-JVYQRRC4.js";
 import {
   COMPOSER_PAYMENT_REQUIRED_MESSAGE,
   CREDIT_EXHAUSTION_MESSAGE,
@@ -267,10 +272,6 @@ import {
 import {
   cn
 } from "./chunk-22KP6LR5.js";
-import {
-  copyTextToClipboard,
-  tableElementToTsv
-} from "./chunk-JVYQRRC4.js";
 
 // src/hooks/use-video-artifact-playback.ts
 import { useMemo } from "react";
@@ -291,6 +292,39 @@ function useVideoArtifactPlaybackLoader(options = {}) {
   );
 }
 
+// src/file-node-visibility.ts
+function pathIsInsideDirectory(path, directory) {
+  if (!path.startsWith(directory) || path === directory) return false;
+  if (directory.endsWith("/") || directory.endsWith("\\")) return true;
+  const boundary = path[directory.length];
+  return boundary === "/" || boundary === "\\";
+}
+function visibleFileTree(nodes, predicate, parent = null, depth = 0) {
+  if (!predicate) return nodes;
+  const visible = [];
+  for (const node of nodes) {
+    if (!predicate(node, { depth, parent })) continue;
+    visible.push(
+      node.children === void 0 ? node : {
+        ...node,
+        children: visibleFileTree(node.children, predicate, node, depth + 1)
+      }
+    );
+  }
+  return visible;
+}
+function filePathVisibility(nodes, path, predicate, parent = null, depth = 0) {
+  if (!predicate) return "visible";
+  for (const node of nodes) {
+    if (node.path !== path && !pathIsInsideDirectory(path, node.path)) continue;
+    if (!predicate(node, { depth, parent })) return "hidden";
+    if (node.path === path) return "visible";
+    if (node.kind !== "dir" || node.children === void 0) return "unknown";
+    return filePathVisibility(node.children, path, predicate, node, depth + 1);
+  }
+  return "unknown";
+}
+
 // src/hooks/use-last-started-turn-policy.ts
 import { useCallback, useEffect } from "react";
 function isLastStartedTurnPolicyEvent(event) {
@@ -3942,7 +3976,7 @@ function ApprovalSurface({
 
 // src/components/chat-composer.tsx
 import { LayoutGroup, motion } from "motion/react";
-import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+import { Fragment as Fragment2, jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
 function ChatComposer({
   composer,
   responsiveBasis,
@@ -3993,7 +4027,7 @@ function ChatComposer({
     attachments || models || controlsLeading || controlsStart || transcription
   );
   const stackActions = hasControls && Boolean(actionsStart);
-  return /* @__PURE__ */ jsxs2(Root, { controller, responsiveBasis, className, children: [
+  return /* @__PURE__ */ jsx2(Fragment2, { children: /* @__PURE__ */ jsxs2(Root, { controller, responsiveBasis, className, children: [
     /* @__PURE__ */ jsxs2(Frame, { children: [
       /* @__PURE__ */ jsx2(CommandPalette2, {}),
       /* @__PURE__ */ jsxs2(Surface, { children: [
@@ -4080,7 +4114,7 @@ function ChatComposer({
     ] }),
     /* @__PURE__ */ jsx2(Help, {}),
     /* @__PURE__ */ jsx2(Status, {})
-  ] });
+  ] }) });
 }
 
 // src/components/fleet-tile.tsx
@@ -4758,7 +4792,7 @@ function collectUnicodeContent(values) {
 }
 
 // src/components/file-browser.tsx
-import { Fragment as Fragment2, jsx as jsx5, jsxs as jsxs5 } from "react/jsx-runtime";
+import { Fragment as Fragment3, jsx as jsx5, jsxs as jsxs5 } from "react/jsx-runtime";
 var STATUS_TINT = {
   added: "text-og-status-idle",
   modified: "text-og-status-running",
@@ -4786,7 +4820,7 @@ function itemKey(item) {
       return `residue:${item.path}`;
   }
 }
-function pathIsInsideDirectory(path, directory) {
+function pathIsInsideDirectory2(path, directory) {
   if (!path.startsWith(directory) || path === directory) return false;
   if (directory.endsWith("/") || directory.endsWith("\\")) return true;
   const boundary = path[directory.length];
@@ -4795,7 +4829,7 @@ function pathIsInsideDirectory(path, directory) {
 function findNode(nodes, path) {
   for (const node of nodes) {
     if (node.path === path) return node;
-    if (node.kind === "dir" && node.children && pathIsInsideDirectory(path, node.path)) {
+    if (node.kind === "dir" && node.children && pathIsInsideDirectory2(path, node.path)) {
       const hit = findNode(node.children, path);
       if (hit) return hit;
     }
@@ -4810,7 +4844,7 @@ function traceRevealPath(nodes, targetPath) {
         frontier: node.kind === "dir" && node.children === void 0 ? node.path : null
       };
     }
-    if (node.kind !== "dir" || !pathIsInsideDirectory(targetPath, node.path)) continue;
+    if (node.kind !== "dir" || !pathIsInsideDirectory2(targetPath, node.path)) continue;
     if (node.children === void 0) {
       return { directories: [node.path], frontier: node.path };
     }
@@ -4827,6 +4861,7 @@ function FileBrowser({
   fallback,
   onSelectFile,
   selectedPath,
+  isNodeVisible,
   revealPath,
   revealPathRequestId,
   renderNode,
@@ -4858,6 +4893,10 @@ function FileBrowser({
     () => typeof document === "undefined" ? null : document.getElementById(treeId),
     [treeId]
   );
+  const visibleTree = useMemo10(
+    () => visibleFileTree(result.tree, isNodeVisible),
+    [isNodeVisible, result.tree]
+  );
   useBrowserLayoutEffect(() => {
     if (typeof window === "undefined" || typeof window.matchMedia !== "function") return;
     const query = window.matchMedia("(pointer: coarse)");
@@ -4888,10 +4927,14 @@ function FileBrowser({
     setActive(null);
     setRevealRequest({ path: revealPath, requestId: effectiveRevealRequestId });
   }, [effectiveRevealRequestId, revealPath]);
-  const cursor = active ?? selectedPath ?? null;
+  const visibleActive = active && findNode(visibleTree, active) ? active : null;
+  const cursor = visibleActive ?? (selectedPath && findNode(visibleTree, selectedPath) ? selectedPath : null);
+  useEffect13(() => {
+    if (active !== null && visibleActive === null) setActive(null);
+  }, [active, visibleActive]);
   const expand = useCallback19(
     async (path) => {
-      const node = findNode(result.tree, path);
+      const node = findNode(visibleTree, path);
       if (node && node.kind === "dir" && node.children === void 0) {
         setLoadingPaths((prev) => new Set(prev).add(path));
         try {
@@ -4905,7 +4948,7 @@ function FileBrowser({
         }
       }
     },
-    [result]
+    [result, visibleTree]
   );
   const open = useCallback19(
     (path) => {
@@ -4916,7 +4959,7 @@ function FileBrowser({
   );
   useEffect13(() => {
     if (!revealRequest) return;
-    const trace = traceRevealPath(result.tree, revealRequest.path);
+    const trace = traceRevealPath(visibleTree, revealRequest.path);
     if (trace.directories.length > 0) {
       setExpanded((previous) => {
         const next = new Set(previous);
@@ -4935,7 +4978,7 @@ function FileBrowser({
     }
     attemptedRevealPathsRef.current.add(frontier);
     void expand(frontier);
-  }, [expand, loadingPaths, result.expandingPaths, result.tree, revealRequest]);
+  }, [expand, loadingPaths, result.expandingPaths, revealRequest, visibleTree]);
   const toggle = useCallback19(
     async (node) => {
       if (node.kind !== "dir") return;
@@ -4979,9 +5022,9 @@ function FileBrowser({
         }
       }
     };
-    walk(result.tree, 0);
+    walk(visibleTree, 0);
     return items;
-  }, [result.tree, expanded, draftCreate, loadingPaths, result.expandingPaths, cold]);
+  }, [visibleTree, expanded, draftCreate, loadingPaths, result.expandingPaths, cold]);
   const unicodeFontPaths = useMemo10(
     () => renderItems.flatMap((item) => item.type === "node" ? [item.node.path] : []),
     [renderItems]
@@ -5005,9 +5048,9 @@ function FileBrowser({
         if (node.children) visit(node.children);
       });
     };
-    visit(result.tree);
+    visit(visibleTree);
     return positions;
-  }, [result.tree]);
+  }, [visibleTree]);
   const cursorIndex = cursor ? rowIndexByPath.get(cursor) ?? -1 : -1;
   const activeDescendantId = cursorIndex >= 0 ? `${treeId}-item-${cursorIndex}` : void 0;
   const supportsMutation = editable && result.source === "live" && result.error === null && !result.loading;
@@ -5082,7 +5125,7 @@ function FileBrowser({
       const draft = draftRename;
       setDraftRename(null);
       if (!draft || !supportsMutation) return;
-      const node = findNode(result.tree, draft.path);
+      const node = findNode(visibleTree, draft.path);
       const trimmed = name.trim().replace(/\/+$/, "");
       if (!node || !trimmed || trimmed === node.name) return;
       const newPath = joinPath(parentOf2(draft.path), trimmed);
@@ -5098,19 +5141,19 @@ function FileBrowser({
         setBusy(false);
       }
     },
-    [draftRename, supportsMutation, result, selectedPath, active, onSelectFile]
+    [draftRename, supportsMutation, result, selectedPath, active, onSelectFile, visibleTree]
   );
   const startCreate = useCallback19(
     (kind) => {
       if (!supportsMutation) return;
-      const anchor = cursor ? findNode(result.tree, cursor) : void 0;
+      const anchor = cursor ? findNode(visibleTree, cursor) : void 0;
       const parent = anchor ? anchor.kind === "dir" ? anchor.path : parentOf2(anchor.path) : "";
       if (parent) open(parent);
       setDraftRename(null);
       setMenu(null);
       setDraftCreate({ parent, kind });
     },
-    [supportsMutation, cursor, result.tree, open]
+    [supportsMutation, cursor, open, visibleTree]
   );
   const startRename = useCallback19(
     (node) => {
@@ -5125,7 +5168,7 @@ function FileBrowser({
     async (targetDir, sourcePath) => {
       setDragOver(null);
       if (!supportsMutation || !sourcePath) return;
-      const src = findNode(result.tree, sourcePath);
+      const src = findNode(visibleTree, sourcePath);
       if (!src) return;
       if (parentOf2(sourcePath) === targetDir) return;
       if (targetDir === sourcePath || targetDir.startsWith(`${sourcePath}/`)) return;
@@ -5143,7 +5186,7 @@ function FileBrowser({
         setBusy(false);
       }
     },
-    [supportsMutation, result, selectedPath, active, onSelectFile]
+    [supportsMutation, result, selectedPath, active, onSelectFile, visibleTree]
   );
   const onKeyDown = useCallback19(
     (e) => {
@@ -5276,9 +5319,9 @@ function FileBrowser({
       window.removeEventListener("resize", close);
     };
   }, [menu]);
-  const showErrorEmpty = result.error && result.tree.length === 0 && !draftCreate;
-  const showDegradedTree = result.error && result.tree.length > 0;
-  const showEmpty = !result.loading && result.tree.length === 0 && !draftCreate;
+  const showErrorEmpty = result.error && visibleTree.length === 0 && !draftCreate;
+  const showDegradedTree = result.error && visibleTree.length > 0;
+  const showEmpty = !result.loading && visibleTree.length === 0 && !draftCreate;
   const showToolbar = supportsMutation || result.loading;
   const usesVirtualTree = !showErrorEmpty && !showEmpty && renderItems.length > 500;
   const renderNodeRow = (node, depth) => {
@@ -5473,7 +5516,7 @@ function FileBrowser({
         "aria-label": "File actions",
         className: "flex shrink-0 flex-wrap items-center gap-0.5 border-b border-og-border px-1 py-1",
         children: [
-          supportsMutation ? /* @__PURE__ */ jsxs5(Fragment2, { children: [
+          supportsMutation ? /* @__PURE__ */ jsxs5(Fragment3, { children: [
             /* @__PURE__ */ jsx5(ToolbarButton, { label: "New file", onClick: () => startCreate("file"), disabled: busy, children: /* @__PURE__ */ jsx5(FilePlusIcon, { className: "size-3.5" }) }),
             /* @__PURE__ */ jsx5(ToolbarButton, { label: "New folder", onClick: () => startCreate("dir"), disabled: busy, children: /* @__PURE__ */ jsx5(FolderPlusIcon, { className: "size-3.5" }) }),
             /* @__PURE__ */ jsx5(
@@ -5481,7 +5524,7 @@ function FileBrowser({
               {
                 label: "Rename",
                 onClick: () => {
-                  const node = cursor ? findNode(result.tree, cursor) : void 0;
+                  const node = cursor ? findNode(visibleTree, cursor) : void 0;
                   if (node) startRename(node);
                 },
                 disabled: busy || !cursor,
@@ -5493,7 +5536,7 @@ function FileBrowser({
               {
                 label: "Delete",
                 onClick: (event) => {
-                  const node = cursor ? findNode(result.tree, cursor) : void 0;
+                  const node = cursor ? findNode(visibleTree, cursor) : void 0;
                   if (node) void runDelete(node, event.currentTarget);
                 },
                 disabled: busy || !cursor,
@@ -5938,7 +5981,7 @@ function ContextMenu({
         "bg-og-surface-1"
       ),
       children: [
-        isDir && /* @__PURE__ */ jsxs5(Fragment2, { children: [
+        isDir && /* @__PURE__ */ jsxs5(Fragment3, { children: [
           item("New file", /* @__PURE__ */ jsx5(FilePlusIcon, { className: "size-3.5" }), onNewFile),
           item("New folder", /* @__PURE__ */ jsx5(FolderPlusIcon, { className: "size-3.5" }), onNewFolder),
           /* @__PURE__ */ jsx5("div", { role: "separator", className: "my-1 h-px bg-og-border" })
@@ -7154,7 +7197,7 @@ function EditorSkeleton() {
 import { FileCode2Icon, FileWarningIcon as FileWarningIcon2, LoaderCircleIcon } from "lucide-react";
 import { useCallback as useCallback23, useEffect as useEffect18, useRef as useRef15, useState as useState15 } from "react";
 import { Group, Panel, Separator } from "react-resizable-panels";
-import { Fragment as Fragment3, jsx as jsx10, jsxs as jsxs8 } from "react/jsx-runtime";
+import { Fragment as Fragment4, jsx as jsx10, jsxs as jsxs8 } from "react/jsx-runtime";
 function SandboxFiles({
   files,
   git,
@@ -7164,6 +7207,7 @@ function SandboxFiles({
   onEditIntent,
   initialSelectedPath,
   onSelectedPathChange,
+  isNodeVisible,
   requestedPath,
   requestedLine,
   requestedPathRequestId,
@@ -7200,6 +7244,19 @@ function SandboxFiles({
       setTreeRevealRequest(null);
       return;
     }
+    if (isNodeVisible && files.loading && files.tree.length === 0) return;
+    if (isNodeVisible && !files.loading && files.tree.length === 0) {
+      handledRequestRef.current = requestKey;
+      pendingRequestRef.current = null;
+      setTreeRevealRequest(null);
+      return;
+    }
+    if (filePathVisibility(files.tree, requestedPath, isNodeVisible) === "hidden") {
+      handledRequestRef.current = requestKey;
+      pendingRequestRef.current = null;
+      setTreeRevealRequest(null);
+      return;
+    }
     handledRequestRef.current = requestKey;
     pendingRequestRef.current = null;
     setSelected(requestedPath);
@@ -7208,7 +7265,16 @@ function SandboxFiles({
     setFocusLine(requestedLine != null && requestedLine > 0 ? requestedLine : null);
     setTreeRevealRequest({ path: requestedPath, requestId: requestKey });
     setViewReloadRevision((revision) => revision + 1);
-  }, [onSelectedPathChange, requestKey, requestedLine, requestedPath, requestedPathReady]);
+  }, [
+    files.loading,
+    files.tree,
+    isNodeVisible,
+    onSelectedPathChange,
+    requestKey,
+    requestedLine,
+    requestedPath,
+    requestedPathReady
+  ]);
   const rootRef = useRef15(null);
   const [wide, setWide] = useState15(false);
   useEffect18(() => {
@@ -7231,7 +7297,18 @@ function SandboxFiles({
     };
   }, []);
   const resolvedTheme = useThemeType(themeType);
-  const viewPath = selected;
+  const selectedVisibility = selected ? filePathVisibility(files.tree, selected, isNodeVisible) : "unknown";
+  const visibilityPending = Boolean(isNodeVisible && files.loading && files.tree.length === 0);
+  const viewPath = selectedVisibility === "hidden" || visibilityPending ? null : selected;
+  useEffect18(() => {
+    if (selected === null || selectedVisibility !== "hidden") return;
+    setSelected(null);
+    onSelectedPathChange?.(null);
+    setEditMode(false);
+    setFocusLine(null);
+    setTreeRevealRequest(null);
+    setLiveRequestedPath(null);
+  }, [onSelectedPathChange, selected, selectedVisibility]);
   const fileView = useFileView(
     viewPath,
     files.readFile,
@@ -7327,6 +7404,7 @@ function SandboxFiles({
                 FileBrowser,
                 {
                   result: files,
+                  isNodeVisible,
                   selectedPath: selected ?? void 0,
                   ...treeRevealRequest ? {
                     revealPath: treeRevealRequest.path,
@@ -7444,7 +7522,7 @@ function SandboxFiles({
                       " is a binary file (",
                       fileView.sizeBytes ?? 0,
                       " bytes)."
-                    ] }) : fileView.content !== null ? /* @__PURE__ */ jsxs8(Fragment3, { children: [
+                    ] }) : fileView.content !== null ? /* @__PURE__ */ jsxs8(Fragment4, { children: [
                       fileView.truncated && /* @__PURE__ */ jsxs8("div", { className: "border-b border-og-border bg-og-surface-1 px-2 py-1 text-og-xs text-og-status-running", children: [
                         "Large file \u2014 showing a truncated preview (",
                         fileView.sizeBytes ?? 0,
@@ -7781,7 +7859,7 @@ import {
   useDefaultLayout,
   usePanelRef
 } from "react-resizable-panels";
-import { Fragment as Fragment4, jsx as jsx11, jsxs as jsxs9 } from "react/jsx-runtime";
+import { Fragment as Fragment5, jsx as jsx11, jsxs as jsxs9 } from "react/jsx-runtime";
 var SERVER_LAYOUT_STORAGE = {
   getItem: () => null,
   setItem: () => {
@@ -8064,7 +8142,7 @@ function WorkspaceDock({
       current,
       onTab: setTab,
       accessory: headerAccessory,
-      controls: /* @__PURE__ */ jsxs9(Fragment4, { children: [
+      controls: /* @__PURE__ */ jsxs9(Fragment5, { children: [
         /* @__PURE__ */ jsx11(
           ChromeButton,
           {
@@ -8345,11 +8423,11 @@ import {
 } from "lucide-react";
 import { jsx as jsx12, jsxs as jsxs10 } from "react/jsx-runtime";
 var LazyBrowserViewer = lazy2(async () => {
-  const { BrowserViewer } = await import("./browser-viewer-GXUICIAG.js");
+  const { BrowserViewer } = await import("./browser-viewer-AEFHUYZK.js");
   return { default: BrowserViewer };
 });
 var LazyComputerViewer = lazy2(async () => {
-  const { ComputerViewer } = await import("./computer-viewer-ZOP4Q7A7.js");
+  const { ComputerViewer } = await import("./computer-viewer-FWEZISW4.js");
   return { default: ComputerViewer };
 });
 var WORKBENCH_TAB_CHANGES = "changes";
@@ -8482,6 +8560,7 @@ function useSandboxWorkspaceTabs(options) {
     onOpenFile,
     initialFilePath,
     onFilePathChange,
+    isFileNodeVisible,
     initialBrowserSessionId,
     onBrowserSessionIdChange,
     initialComputerSessionId,
@@ -8749,6 +8828,7 @@ function useSandboxWorkspaceTabs(options) {
           {
             files,
             git,
+            isNodeVisible: isFileNodeVisible,
             fileSystemAvailable: fileSystemOn || captureAvailable,
             editable: filesEditable && files.source === "live" && files.error === null && !files.loading,
             workspaceResting: !liveWorkspaceExpected && liveness !== void 0 && !capturePending && !captureAvailable && !workspaceWaking,
@@ -8856,6 +8936,7 @@ function useSandboxWorkspaceTabs(options) {
     onOpenFile,
     initialFilePath,
     onFilePathChange,
+    isFileNodeVisible,
     initialBrowserSessionId,
     onBrowserSessionIdChange,
     initialComputerSessionId,
@@ -8910,6 +8991,7 @@ function SandboxWorkspace(props) {
     onActiveTabChange,
     initialFilePath,
     onFilePathChange,
+    isFileNodeVisible,
     openFileRequest,
     initialBrowserSessionId,
     onBrowserSessionIdChange,
@@ -8991,6 +9073,7 @@ function SandboxWorkspace(props) {
     ...browserExtensionSetupUrl ? { browserExtensionSetupUrl } : {},
     initialFilePath,
     onFilePathChange,
+    isFileNodeVisible,
     initialBrowserSessionId,
     onBrowserSessionIdChange,
     initialComputerSessionId,
@@ -9548,6 +9631,7 @@ export {
   controlCaret,
   copyTextToClipboard,
   createDefaultToolRegistry,
+  createEmbeddedSessionClient,
   createOlderHistoryLoadReceipt,
   createToolRegistry,
   createVoiceRecordingManifest,
@@ -9564,6 +9648,7 @@ export {
   effortOptionsForModel,
   execTruncated,
   extractSessionRef,
+  filePathVisibility,
   filterCommands,
   findPickerRow,
   firstMissingRequiredArg,
@@ -9680,6 +9765,7 @@ export {
   useWorkspaces,
   userMessageLikelyNeedsDisclosure,
   v4aToGitFileDiff,
+  visibleFileTree,
   xtermThemeFromTokens
 };
 //# sourceMappingURL=index.js.map