@tutti-os/agent-gui 0.0.23 → 0.0.25

package/dist/index.js

@@ -13,7 +13,7 @@ import {
 import {
   AgentInteractivePromptSurface,
   approvalOptionDisplayLabel
-} from "./chunk-ZC4E2QJU.js";
+} from "./chunk-OSBLVO4N.js";
 import {
   PLAN_IMPLEMENTATION_ACTION_FEEDBACK,
   PLAN_IMPLEMENTATION_ACTION_IMPLEMENT,
@@ -36,21 +36,21 @@ import {
   skillDescriptionForDisplay,
   skillTriggerForPrefix,
   useProjectedAgentConversation
-} from "./chunk-MQAGIHYM.js";
+} from "./chunk-3QDLVPMJ.js";
 import {
   AgentMessageMarkdown,
   ZoomableImage,
   cn,
   resolveWorkspaceLinkAction
-} from "./chunk-7Q3JKSQ5.js";
+} from "./chunk-VNRRXUI3.js";
 import {
   AGENT_MENTION_FILTER_TAB_ORDER,
   AgentFileMentionPalette,
   AgentMentionSearchController,
   DEFAULT_AGENT_MENTION_FILTER,
-  flattenAgentMentionPaletteEntries,
+  agentMentionItemKey,
   preloadAgentMentionBrowse
-} from "./chunk-3LVEFR2N.js";
+} from "./chunk-5PIXN7UF.js";
 import {
   WORKSPACE_AGENT_ACTIVITY_RUNTIME_SESSION_ORIGIN,
   buildWorkspaceAgentActivityListViewModel,
@@ -90,7 +90,7 @@ import {
   useAgentActivitySnapshot,
   useAgentHostApi,
   useOptionalAgentActivityRuntime
-} from "./chunk-CCI6EK5W.js";
+} from "./chunk-YHRJD6HA.js";
 import "./chunk-TYGL25EL.js";
 import {
   AGENT_CONTEXT_MENTION_PROVIDER_IDS
@@ -3171,10 +3171,10 @@ function compareTimelineItemsForMerge(left, right) {
 // agent-gui/agentGuiNode/model/agentComposerDraft.ts
 var MAX_AGENT_COMPOSER_DRAFT_IMAGES = 8;
 function emptyAgentComposerDraft() {
-  return { prompt: "", images: [] };
+  return { prompt: "", images: [], files: [] };
 }
 function agentComposerDraftHasContent(draft) {
-  return draft.prompt.trim() !== "" || draft.images.length > 0;
+  return draft.prompt.trim() !== "" || draft.images.length > 0 || (draft.files?.length ?? 0) > 0;
 }
 function normalizeAgentPromptContentBlocks(content) {
   const result = [];
@@ -3201,6 +3201,26 @@ function normalizeAgentPromptContentBlocks(content) {
       });
       continue;
     }
+    if (block.type === "file") {
+      const filePath = block.path?.trim();
+      const hostPath = block.hostPath?.trim();
+      if (!filePath && !hostPath) {
+        continue;
+      }
+      result.push({
+        type: "file",
+        ...block.mimeType?.trim() ? { mimeType: block.mimeType.trim() } : {},
+        ...filePath ? { path: filePath } : {},
+        ...hostPath ? { hostPath } : {},
+        ...block.name?.trim() ? { name: block.name.trim() } : {},
+        ...block.uri?.trim() ? { uri: block.uri.trim() } : {},
+        ...block.uploadStatus?.trim() ? { uploadStatus: block.uploadStatus.trim() } : {},
+        ...block.assetId?.trim() ? { assetId: block.assetId.trim() } : {},
+        ...typeof block.sizeBytes === "number" ? { sizeBytes: block.sizeBytes } : {},
+        kind: "file"
+      });
+      continue;
+    }
     if (block.type === "skill" || block.type === "mention") {
       const name = block.name?.trim();
       const path = block.path?.trim();
@@ -3228,6 +3248,9 @@ function agentPromptContentToComposerDraft(content, idPrefix) {
     prompt: agentPromptContentDisplayText(normalizedContent),
     images: agentPromptContentImageBlocks(normalizedContent).slice(0, MAX_AGENT_COMPOSER_DRAFT_IMAGES).map(
       (image, index) => agentPromptImageBlockToDraftImage(image, idPrefix, index)
+    ),
+    files: agentPromptFileBlocks(normalizedContent).map(
+      (file, index) => agentPromptFileBlockToDraftFile(file, idPrefix, index)
     )
   };
 }
@@ -3249,9 +3272,24 @@ function agentComposerDraftToPromptContent(input) {
       mimeType: image.mimeType,
       ...image.path ? { path: image.path } : { data: image.data },
       name: image.name
+    })),
+    ...(input.draft.files ?? []).filter((file) => !file.uploading && !file.uploadError).map((file) => ({
+      type: "file",
+      ...file.mimeType ? { mimeType: file.mimeType } : {},
+      ...file.path ? { path: file.path } : {},
+      ...file.hostPath ? { hostPath: file.hostPath } : {},
+      ...file.assetId ? { assetId: file.assetId } : {},
+      ...file.sizeBytes ? { sizeBytes: file.sizeBytes } : {},
+      name: file.name,
+      kind: "file"
     }))
   ]);
 }
+function agentPromptFileBlocks(content) {
+  return normalizeAgentPromptContentBlocks(content).filter(
+    (block) => block.type === "file" && (typeof block.path === "string" || typeof block.hostPath === "string")
+  );
+}
 function promptItemBlocksForProviderSkills(input) {
   if (input.provider.trim() !== "codex") {
     return [];
@@ -3289,11 +3327,22 @@ function agentPromptImageBlockToDraftImage(image, idPrefix, index) {
     id: `${idPrefix}:image:${index}`,
     name: image.name?.trim() || `image-${index + 1}`,
     mimeType: image.mimeType,
-    data: image.data,
-    path: image.path,
+    ...image.data ? { data: image.data } : {},
+    ...image.path ? { path: image.path } : {},
     previewUrl: typeof image.data === "string" && image.data ? `data:${image.mimeType};base64,${image.data}` : image.path ?? ""
   };
 }
+function agentPromptFileBlockToDraftFile(file, idPrefix, index) {
+  return {
+    id: `${idPrefix}:file:${index}`,
+    name: file.name?.trim() || `file-${index + 1}`,
+    mimeType: file.mimeType,
+    path: file.path,
+    hostPath: file.hostPath,
+    assetId: file.assetId,
+    sizeBytes: file.sizeBytes
+  };
+}
 
 // shared/agentConversation/projection/workspaceAgentMessageProjection.ts
 function projectWorkspaceAgentMessagesToTimelineItems(messages) {
@@ -13486,7 +13535,11 @@ import {
 // agent-gui/agentGuiNode/AgentComposer.tsx
 import { AddIcon, Select as Select2, SelectTrigger as SelectTrigger2 } from "@tutti-os/ui-system";
 import { ListChecks, X } from "lucide-react";
-import { makeAtPanelKeyDown } from "@tutti-os/ui-rich-text/at-panel";
+import {
+  createMentionPaletteStateAdapter,
+  makeAtPanelKeyDown,
+  repairMentionPaletteHighlight
+} from "@tutti-os/ui-rich-text/at-panel";
 
 // agent-gui/agentGuiNode/model/agentComposerTriggerQueries.ts
 import { findRichTextTriggerQuery } from "@tutti-os/ui-rich-text/editor";
@@ -17104,6 +17157,7 @@ function AgentComposer({
   "use memo";
   const draftPrompt = draftContent.prompt;
   const draftImages = draftContent.images;
+  const draftFiles = draftContent.files ?? [];
   const agentActivityRuntime = useOptionalAgentActivityRuntime();
   const [isPaletteOpen, setIsPaletteOpen] = useState10(true);
   const [isReviewPickerOpen, setIsReviewPickerOpen] = useState10(false);
@@ -17140,6 +17194,7 @@ function AgentComposer({
   const paletteContentRef = useRef12(null);
   const draftPromptRef = useRef12(draftPrompt);
   const draftImagesRef = useRef12(draftImages);
+  const draftFilesRef = useRef12(draftFiles);
   const submittedImagePreviewObservedBusyRef = useRef12(false);
   const promptTipRef = useRef12(null);
   const mentionControllerRef = useRef12(
@@ -17283,40 +17338,40 @@ function AgentComposer({
     highlightedIndex,
     slashPaletteEntries.length
   );
-  const mentionPaletteEntries = useMemo9(
-    () => flattenAgentMentionPaletteEntries(mentionSearchState),
-    [mentionSearchState]
-  );
   const [mentionPaletteFrame, setMentionPaletteFrame] = useState10(null);
   useEffect11(() => {
     setHighlightedIndex(0);
   }, [skillQueryMatch?.prefix, skillQueryMatch?.query, slashQuery]);
   useEffect11(() => {
-    const firstKey = mentionPaletteEntries[0]?.key ?? null;
-    if (!firstKey) {
-      autoMentionHighlightedKeyRef.current = null;
-      setMentionHighlightedKey(null);
-      return;
-    }
+    const preferredKey = shouldResetMentionHighlightToFilter && mentionSearchState.mode === "browse" ? `category:${mentionSearchState.filter}` : null;
     if (shouldResetMentionHighlightToFilter) {
-      const resetKey = mentionSearchState.mode === "browse" ? `category:${mentionSearchState.filter}` : null;
-      autoMentionHighlightedKeyRef.current = resetKey;
-      setMentionHighlightedKey(resetKey);
+      const nextKey = repairMentionPaletteHighlight({
+        state: mentionSearchState,
+        currentKey: null,
+        preferredKey,
+        getItemKey: agentMentionItemKey
+      });
+      autoMentionHighlightedKeyRef.current = nextKey;
+      setMentionHighlightedKey(nextKey);
       setShouldResetMentionHighlightToFilter(false);
       return;
     }
     setMentionHighlightedKey((current) => {
-      const hasCurrent = current !== null && mentionPaletteEntries.some((entry) => entry.key === current);
-      if (hasCurrent && current !== autoMentionHighlightedKeyRef.current) {
+      const nextKey = repairMentionPaletteHighlight({
+        state: mentionSearchState,
+        currentKey: current,
+        getItemKey: agentMentionItemKey
+      });
+      if (nextKey === current && current !== autoMentionHighlightedKeyRef.current) {
         return current;
       }
-      autoMentionHighlightedKeyRef.current = firstKey;
-      return firstKey;
+      autoMentionHighlightedKeyRef.current = nextKey;
+      return nextKey;
     });
   }, [
-    mentionPaletteEntries,
     mentionSearchState.filter,
     mentionSearchState.mode,
+    mentionSearchState,
     shouldResetMentionHighlightToFilter
   ]);
   useEffect11(() => {
@@ -17346,6 +17401,9 @@ function AgentComposer({
   useEffect11(() => {
     draftImagesRef.current = draftImages;
   }, [draftImages]);
+  useEffect11(() => {
+    draftFilesRef.current = draftFiles;
+  }, [draftFiles]);
   useEffect11(() => {
     if (previousSlashStatusAgentSessionIdRef.current === slashStatusAgentSessionId) {
       return;
@@ -17665,22 +17723,40 @@ function AgentComposer({
     }
     setIsPaletteOpen(false);
   }, [closeFileMentionPalette, showFileMentionPalette]);
+  const createFileMentionPaletteAdapter = useCallback9(
+    (highlightedKey = mentionHighlightedKey) => createMentionPaletteStateAdapter({
+      state: mentionSearchState,
+      highlightedKey,
+      categoryCycleOrder: mentionSearchState.mode === "browse" ? mentionSearchState.categories : AGENT_MENTION_FILTER_TAB_ORDER,
+      getItemKey: agentMentionItemKey,
+      callbacks: {
+        onHighlightChange: (key) => {
+          setShouldCenterMentionHighlight(true);
+          autoMentionHighlightedKeyRef.current = null;
+          setMentionHighlightedKey(key);
+        },
+        onActiveCategoryIdChange: (categoryId) => {
+          mentionControllerRef.current?.setFilter(
+            categoryId
+          );
+          setShouldResetMentionHighlightToFilter(true);
+          setShouldCenterMentionHighlight(false);
+        },
+        onExpandGroup: (groupId) => {
+          mentionControllerRef.current?.expandGroup(
+            groupId
+          );
+        },
+        onSelectItem: selectFileMention
+      }
+    }),
+    [mentionHighlightedKey, mentionSearchState, selectFileMention]
+  );
   const moveFileMentionSelection = useCallback9(
     (delta) => {
-      const focusableEntries = flattenAgentMentionPaletteEntries(mentionSearchState);
-      if (focusableEntries.length === 0) {
-        return;
-      }
-      const currentIndex = mentionHighlightedKey ? focusableEntries.findIndex(
-        (entry) => entry.key === mentionHighlightedKey
-      ) : -1;
-      const baseIndex = currentIndex >= 0 ? currentIndex : delta > 0 ? -1 : 0;
-      const nextIndex = (baseIndex + delta + focusableEntries.length) % focusableEntries.length;
-      setShouldCenterMentionHighlight(true);
-      autoMentionHighlightedKeyRef.current = null;
-      setMentionHighlightedKey(focusableEntries[nextIndex]?.key ?? null);
+      createFileMentionPaletteAdapter().moveSelection(delta);
     },
-    [mentionHighlightedKey, mentionSearchState]
+    [createFileMentionPaletteAdapter]
   );
   const handleMentionHighlightChange = useCallback9((key) => {
     autoMentionHighlightedKeyRef.current = null;
@@ -17688,57 +17764,19 @@ function AgentComposer({
   }, []);
   const cycleFileMentionFilter = useCallback9(
     (delta = 1) => {
-      const filters = mentionSearchState.mode === "browse" ? mentionSearchState.categories.map((category) => category.id) : [...AGENT_MENTION_FILTER_TAB_ORDER];
-      if (filters.length === 0) {
-        return;
-      }
-      const currentFilterIndex = filters.findIndex(
-        (filter) => filter === mentionSearchState.filter
-      );
-      const baseIndex = currentFilterIndex >= 0 ? currentFilterIndex : delta > 0 ? -1 : 0;
-      const nextIndex = (baseIndex + delta + filters.length) % filters.length;
-      const nextFilter = filters[nextIndex];
-      if (!nextFilter) {
-        return;
-      }
-      mentionControllerRef.current?.setFilter(nextFilter);
-      setShouldResetMentionHighlightToFilter(true);
-      setShouldCenterMentionHighlight(false);
+      createFileMentionPaletteAdapter().cycleCategory(delta);
     },
-    [mentionSearchState]
+    [createFileMentionPaletteAdapter]
   );
   const handleFileMentionKeyDown = useCallback9(
     (event) => {
       if (!showFileMentionPalette) {
         return false;
       }
-      const focusableEntries = flattenAgentMentionPaletteEntries(mentionSearchState);
       return makeAtPanelKeyDown({
         close: closeFileMentionPalette,
         commitSelection: () => {
-          const activeEntry = focusableEntries.find(
-            (entry) => entry.key === mentionHighlightedKey
-          );
-          if (!activeEntry) {
-            const highlightedCategoryId = mentionHighlightedKey?.startsWith(
-              "category:"
-            ) ? mentionHighlightedKey.slice("category:".length) : null;
-            if (highlightedCategoryId && mentionSearchState.categories.some(
-              (category) => category.id === highlightedCategoryId
-            )) {
-              mentionControllerRef.current?.setFilter(
-                highlightedCategoryId
-              );
-            }
-            return;
-          }
-          if (activeEntry.type === "category" && activeEntry.categoryId) {
-            mentionControllerRef.current?.setFilter(activeEntry.categoryId);
-          } else if (activeEntry.type === "expand" && activeEntry.groupId) {
-            mentionControllerRef.current?.expandGroup(activeEntry.groupId);
-          } else if (activeEntry.type === "item" && activeEntry.item) {
-            selectFileMention(activeEntry.item);
-          }
+          createFileMentionPaletteAdapter().commitHighlighted();
         },
         cycleFilter: cycleFileMentionFilter,
         moveSelection: moveFileMentionSelection
@@ -17746,11 +17784,9 @@ function AgentComposer({
     },
     [
       closeFileMentionPalette,
+      createFileMentionPaletteAdapter,
       cycleFileMentionFilter,
-      mentionHighlightedKey,
-      mentionSearchState,
       moveFileMentionSelection,
-      selectFileMention,
       showFileMentionPalette
     ]
   );
@@ -17919,7 +17955,8 @@ function AgentComposer({
       draftImagesRef.current = nextDraftImages;
       onDraftContentChange({
         prompt: draftPromptRef.current,
-        images: nextDraftImages
+        images: nextDraftImages,
+        files: draftFilesRef.current
       });
       if (!uploadPromptContent) {
         return;
@@ -17956,7 +17993,8 @@ function AgentComposer({
           draftImagesRef.current = uploadedDraftImages;
           onDraftContentChange({
             prompt: draftPromptRef.current,
-            images: uploadedDraftImages
+            images: uploadedDraftImages,
+            files: draftFilesRef.current
           });
         }).catch((error) => {
           const message = error instanceof Error ? error.message : String(error);
@@ -17970,7 +18008,8 @@ function AgentComposer({
           draftImagesRef.current = failedDraftImages;
           onDraftContentChange({
             prompt: draftPromptRef.current,
-            images: failedDraftImages
+            images: failedDraftImages,
+            files: draftFilesRef.current
           });
         });
       }
@@ -17997,7 +18036,103 @@ function AgentComposer({
       draftImagesRef.current = nextDraftImages;
       onDraftContentChange({
         prompt: draftPromptRef.current,
-        images: nextDraftImages
+        images: nextDraftImages,
+        files: draftFilesRef.current
+      });
+    },
+    [onDraftContentChange]
+  );
+  const addDraftFiles = useCallback9(
+    (attachments) => {
+      if (attachments.length === 0) {
+        return;
+      }
+      const uploadPromptContent = agentActivityRuntime?.uploadPromptContent;
+      const nextFiles = attachments.map((attachment) => ({
+        id: `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`,
+        name: attachment.name,
+        mimeType: attachment.mimeType?.trim() || "application/octet-stream",
+        hostPath: attachment.hostPath,
+        uploading: Boolean(uploadPromptContent)
+      }));
+      const nextDraftFiles = [...draftFilesRef.current, ...nextFiles];
+      draftFilesRef.current = nextDraftFiles;
+      onDraftContentChange({
+        prompt: draftPromptRef.current,
+        images: draftImagesRef.current,
+        files: nextDraftFiles
+      });
+      if (!uploadPromptContent) {
+        return;
+      }
+      for (const draftFile of nextFiles) {
+        void uploadPromptContent({
+          workspaceId,
+          content: [
+            {
+              type: "file",
+              mimeType: draftFile.mimeType,
+              hostPath: draftFile.hostPath,
+              name: draftFile.name,
+              kind: "file"
+            }
+          ]
+        }).then((result) => {
+          const uploadedFile = result.content.find(
+            (block) => block.type === "file"
+          );
+          const uploadedPath = uploadedFile?.path?.trim() ?? "";
+          if (!uploadedPath) {
+            throw new Error("Prompt file upload completed without path.");
+          }
+          const uploadedDraftFiles = draftFilesRef.current.map(
+            (file) => file.id === draftFile.id ? {
+              id: file.id,
+              name: uploadedFile?.name ?? file.name,
+              mimeType: uploadedFile?.mimeType ?? file.mimeType,
+              path: uploadedPath,
+              hostPath: uploadedFile?.hostPath ?? file.hostPath,
+              assetId: uploadedFile?.assetId,
+              sizeBytes: uploadedFile?.sizeBytes,
+              uploading: false
+            } : file
+          );
+          draftFilesRef.current = uploadedDraftFiles;
+          onDraftContentChange({
+            prompt: draftPromptRef.current,
+            images: draftImagesRef.current,
+            files: uploadedDraftFiles
+          });
+        }).catch((error) => {
+          const message = error instanceof Error ? error.message : String(error);
+          const failedDraftFiles = draftFilesRef.current.map(
+            (file) => file.id === draftFile.id ? {
+              ...file,
+              uploading: false,
+              uploadError: message
+            } : file
+          );
+          draftFilesRef.current = failedDraftFiles;
+          onDraftContentChange({
+            prompt: draftPromptRef.current,
+            images: draftImagesRef.current,
+            files: failedDraftFiles
+          });
+        });
+      }
+    },
+    [agentActivityRuntime, onDraftContentChange, workspaceId]
+  );
+  const removeDraftFile = useCallback9(
+    (id) => {
+      const nextDraftFiles = draftFilesRef.current.filter(
+        (file) => file.id !== id
+      );
+      draftFilesRef.current = nextDraftFiles;
+      onDraftContentChange({
+        prompt: draftPromptRef.current,
+        images: draftImagesRef.current,
+        files: nextDraftFiles
       });
     },
     [onDraftContentChange]
@@ -18010,8 +18145,11 @@ function AgentComposer({
       if (result.mentionItems.length > 0) {
         editorHandleRef.current?.insertMentionItems(result.mentionItems);
       }
+      if (result.hostAttachments && result.hostAttachments.length > 0) {
+        addDraftFiles(result.hostAttachments);
+      }
     },
-    []
+    [addDraftFiles]
   );
   const handleWorkspaceReferencePicker = useCallback9(async () => {
     if (!onRequestWorkspaceReferences) {
@@ -18278,6 +18416,7 @@ function AgentComposer({
   const effectivePlaceholder = disabledReasonText || placeholder;
   const showingSubmittedImagePreview = draftImages.length === 0 && submittedImagePreview.length > 0;
   const visibleDraftImages = draftImages.length > 0 ? draftImages : submittedImagePreview;
+  const visibleDraftFiles = draftFiles;
   useEffect11(() => {
     if (submittedImagePreview.length === 0) {
       submittedImagePreviewObservedBusyRef.current = false;
@@ -18520,6 +18659,56 @@ function AgentComposer({
                             ))
                           }
                         ) : null,
+                        visibleDraftFiles.length > 0 ? /* @__PURE__ */ jsx26(
+                          "div",
+                          {
+                            className: "mb-2 flex max-w-[520px] flex-wrap gap-2",
+                            "data-testid": "agent-gui-composer-file-drafts",
+                            children: visibleDraftFiles.map((file) => /* @__PURE__ */ jsxs13(
+                              "div",
+                              {
+                                className: cn(
+                                  "group inline-flex max-w-full items-center gap-2 rounded-[6px] border border-[var(--line-1)] bg-[var(--background-fronted)] px-2 py-1 text-xs text-[var(--text-primary)]",
+                                  file.uploadError && "border-[color:color-mix(in_srgb,var(--danger)_55%,var(--line-1))]"
+                                ),
+                                "data-uploading": file.uploading ? "true" : void 0,
+                                "data-upload-error": file.uploadError ? "true" : void 0,
+                                title: file.hostPath ?? file.path ?? file.name,
+                                children: [
+                                  file.uploading ? /* @__PURE__ */ jsx26(
+                                    Spinner,
+                                    {
+                                      className: "shrink-0 text-[var(--text-primary)]",
+                                      size: 14,
+                                      strokeWidth: 2.4,
+                                      trackColor: "var(--transparency-hover)",
+                                      testId: "agent-gui-composer-file-upload-spinner"
+                                    }
+                                  ) : /* @__PURE__ */ jsx26(
+                                    "span",
+                                    {
+                                      className: "size-2 shrink-0 rounded-full bg-[var(--text-tertiary)]",
+                                      "aria-hidden": true
+                                    }
+                                  ),
+                                  /* @__PURE__ */ jsx26("span", { className: "min-w-0 max-w-[220px] truncate", children: file.name }),
+                                  /* @__PURE__ */ jsx26(
+                                    "button",
+                                    {
+                                      type: "button",
+                                      className: "inline-flex size-5 shrink-0 items-center justify-center rounded-full text-[var(--text-secondary)] transition hover:bg-[var(--transparency-hover)] hover:text-[var(--text-primary)] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[color:color-mix(in_srgb,var(--text-primary)_34%,transparent)]",
+                                      "aria-label": labels.removeMention,
+                                      title: labels.removeMention,
+                                      onClick: () => removeDraftFile(file.id),
+                                      children: /* @__PURE__ */ jsx26(X, { size: 12, strokeWidth: 2.4, "aria-hidden": true })
+                                    }
+                                  )
+                                ]
+                              },
+                              file.id
+                            ))
+                          }
+                        ) : null,
                         /* @__PURE__ */ jsx26(
                           AgentRichTextEditor,
                           {
@@ -18571,8 +18760,6 @@ function AgentComposer({
                                 onSelectCategory: (filter) => mentionControllerRef.current?.setFilter(filter),
                                 onSelectFilter: (filter) => mentionControllerRef.current?.setFilter(filter),
                                 onExpandGroup: (groupId) => mentionControllerRef.current?.expandGroup(groupId),
-                                onCycleFilter: cycleFileMentionFilter,
-                                onMoveSelection: moveFileMentionSelection,
                                 onOpenReferences: onRequestWorkspaceReferences ? handleOpenReferencesForEntity : void 0
                               }
                             )
@@ -19508,9 +19695,11 @@ function AgentGUINodeView({
   contextMentionProviders,
   referenceSourceAggregator = null,
   resolveMentionReferenceTarget = null,
+  resolveWorkspaceReferenceInitialTarget = null,
   workspaceAppIcons = EMPTY_WORKSPACE_APP_ICONS3
 }) {
   "use memo";
+  const agentHostApi = useAgentHostApi();
   const layoutElementRef = useRef13(null);
   const railResizeInteractionRef = useRef13(null);
   const [isRailResizing, setIsRailResizing] = useState11(false);
@@ -19528,18 +19717,121 @@ function AgentGUINodeView({
   );
   const workspaceReferencePickerResolverRef = useRef13(null);
   const emptyReferencePickResult = useMemo10(
-    () => ({ files: [], mentionItems: [] }),
+    () => ({ files: [], mentionItems: [], hostAttachments: [] }),
     []
   );
+  const hostLocalFileLabel = uiLanguage === "zh-CN" ? "\u672C\u5730\u6587\u4EF6(\u5BBF\u4E3B\u673A)" : "Local files (Host)";
+  const hostLocalFileSelectLabel = uiLanguage === "zh-CN" ? "\u4ECE\u7535\u8111\u9009\u62E9\u2026" : "Choose from computer\u2026";
+  const hostLocalFileActionPath = "host-local-file://select";
+  const referenceSourceAggregatorWithHostLocalFile = useMemo10(() => {
+    if (!referenceSourceAggregator) {
+      return null;
+    }
+    const sourceId = "host-local-file";
+    const actionNode = {
+      ref: { sourceId, nodeId: "select-files" },
+      kind: "file",
+      displayName: hostLocalFileSelectLabel
+    };
+    const rootNode = {
+      ref: { sourceId, nodeId: "\0source-root" },
+      kind: "folder",
+      displayName: hostLocalFileLabel,
+      hasChildren: true
+    };
+    return {
+      ...referenceSourceAggregator,
+      async listSources(scope) {
+        const sources = await referenceSourceAggregator.listSources(scope);
+        return [
+          ...sources,
+          {
+            sourceId,
+            label: hostLocalFileLabel,
+            icon: "file",
+            capabilities: {
+              searchable: false,
+              previewable: false,
+              paginated: false,
+              navigable: false,
+              filterable: false
+            }
+          }
+        ];
+      },
+      async listRoot(scope) {
+        const root = await referenceSourceAggregator.listRoot(scope);
+        return [...root, rootNode];
+      },
+      async listChildren(scope, node, input) {
+        if (node.sourceId === sourceId) {
+          return { entries: [actionNode], nextCursor: null };
+        }
+        return await referenceSourceAggregator.listChildren(scope, node, input);
+      },
+      async search(scope, currentSourceId, input) {
+        if (currentSourceId === sourceId) {
+          return { entries: [], nextCursor: null };
+        }
+        return await referenceSourceAggregator.search(
+          scope,
+          currentSourceId,
+          input
+        );
+      },
+      async open(scope, node) {
+        if (node.ref.sourceId === sourceId) {
+          return;
+        }
+        await referenceSourceAggregator.open(scope, node);
+      },
+      async readPreview(scope, node) {
+        if (node.ref.sourceId === sourceId) {
+          return null;
+        }
+        return await referenceSourceAggregator.readPreview(scope, node);
+      },
+      resolveSelection(node) {
+        if (node.ref.sourceId === sourceId) {
+          return {
+            path: hostLocalFileActionPath,
+            kind: "file",
+            displayName: actionNode.displayName
+          };
+        }
+        return referenceSourceAggregator.resolveSelection(node);
+      },
+      async locateTarget(scope, currentSourceId, params) {
+        if (currentSourceId === sourceId) {
+          return null;
+        }
+        return await referenceSourceAggregator.locateTarget(
+          scope,
+          currentSourceId,
+          params
+        );
+      },
+      getLoadedSource(currentSourceId) {
+        if (currentSourceId === sourceId) {
+          return void 0;
+        }
+        return referenceSourceAggregator.getLoadedSource(currentSourceId);
+      }
+    };
+  }, [hostLocalFileLabel, hostLocalFileSelectLabel, referenceSourceAggregator]);
   const requestWorkspaceReferences = useCallback10(
     async (entity) => {
       if (previewMode) {
         return emptyReferencePickResult;
       }
-      if (!workspaceFileReferenceAdapter && !referenceSourceAggregator || !workspaceFileReferenceCopy) {
+      if (!workspaceFileReferenceAdapter && !referenceSourceAggregatorWithHostLocalFile || !workspaceFileReferenceCopy) {
         return emptyReferencePickResult;
       }
-      const target = entity && referenceSourceAggregator ? resolveMentionReferenceTarget?.(entity) ?? null : null;
+      const target = entity && referenceSourceAggregatorWithHostLocalFile ? resolveMentionReferenceTarget?.(entity) ?? null : referenceSourceAggregatorWithHostLocalFile ? resolveWorkspaceReferenceInitialTarget?.({
+        activeConversation: viewModel.activeConversation,
+        composerSelectedProjectPath: viewModel.composerSettings.selectedProjectPath ?? null,
+        userProjects: viewModel.userProjects
+      }) ?? null : null;
       setWorkspaceReferencePickerTarget(target);
       setWorkspaceReferencePickerOpen(true);
       return await new Promise((resolve) => {
@@ -19549,8 +19841,12 @@ function AgentGUINodeView({
     [
       emptyReferencePickResult,
       previewMode,
-      referenceSourceAggregator,
+      referenceSourceAggregatorWithHostLocalFile,
       resolveMentionReferenceTarget,
+      resolveWorkspaceReferenceInitialTarget,
+      viewModel.activeConversation,
+      viewModel.composerSettings.selectedProjectPath,
+      viewModel.userProjects,
       workspaceFileReferenceAdapter,
       workspaceFileReferenceCopy
     ]
@@ -19574,10 +19870,32 @@ function AgentGUINodeView({
     [onWorkspaceFileReferencesAdded]
   );
   const confirmWorkspaceReferencePicker = useCallback10(
-    (refs) => {
-      settleReferencePicker({ files: refs, mentionItems: [] }, refs);
+    async (refs) => {
+      const wantsHostFiles = refs.some(
+        (ref) => ref.path === hostLocalFileActionPath
+      );
+      if (!wantsHostFiles) {
+        settleReferencePicker(
+          { files: refs, mentionItems: [], hostAttachments: [] },
+          refs
+        );
+        return;
+      }
+      const workspaceRefs = refs.filter(
+        (ref) => ref.path !== hostLocalFileActionPath
+      );
+      const selected = await agentHostApi.workspace.selectFiles();
+      const hostAttachments = selected.map((file) => ({
+        hostPath: file.path,
+        name: file.name || file.path.split("/").pop() || file.path,
+        mimeType: null
+      }));
+      settleReferencePicker(
+        { files: workspaceRefs, mentionItems: [], hostAttachments },
+        workspaceRefs
+      );
     },
-    [settleReferencePicker]
+    [agentHostApi.workspace, settleReferencePicker]
   );
   const confirmWorkspaceReferenceBundles = useCallback10(
     (result) => {
@@ -19608,7 +19926,7 @@ function AgentGUINodeView({
         };
       });
       settleReferencePicker(
-        { files: result.files, mentionItems },
+        { files: result.files, mentionItems, hostAttachments: [] },
         result.files
       );
     },
@@ -19655,12 +19973,20 @@ function AgentGUINodeView({
       }
       if (options) {
         createConversationAction(options);
+      } else if (viewModel.composerSettings.selectedProjectPath) {
+        createConversationAction({
+          projectPath: viewModel.composerSettings.selectedProjectPath
+        });
       } else {
         createConversationAction();
       }
       setLocalComposerFocusRequestSequence((current) => current + 1);
     },
-    [createConversationAction, previewMode]
+    [
+      createConversationAction,
+      previewMode,
+      viewModel.composerSettings.selectedProjectPath
+    ]
   );
   useEffect12(() => {
     if (newConversationRequestSequence === null || handledNewConversationRequestSequenceRef.current === newConversationRequestSequence) {
@@ -19946,10 +20272,10 @@ function AgentGUINodeView({
         ]
       }
     ),
-    referenceSourceAggregator ? /* @__PURE__ */ jsx29(
+    referenceSourceAggregatorWithHostLocalFile ? /* @__PURE__ */ jsx29(
       ReferenceSourcePicker,
       {
-        aggregator: referenceSourceAggregator,
+        aggregator: referenceSourceAggregatorWithHostLocalFile,
         copy: workspaceFileReferenceCopy ?? fallbackWorkspaceFileReferenceCopy,
         initialTarget: workspaceReferencePickerTarget,
         open: workspaceReferencePickerOpen,
@@ -21630,6 +21956,15 @@ var AgentGUIConversationRailSection = memo(
     const showLessConversations = useCallback10(() => {
       setVisibleItemLimit(AGENT_GUI_CONVERSATION_RAIL_SECTION_PAGE_SIZE);
     }, []);
+    const canCreateConversationFromSection = section.kind === "conversations" || Boolean(projectPath);
+    const createConversationLabel = projectPath ? labels.projectSectionEdit : labels.newConversation;
+    const handleCreateConversation = useCallback10(() => {
+      if (projectPath) {
+        onCreateConversation({ projectPath });
+        return;
+      }
+      onCreateConversation({ projectPath: null });
+    }, [onCreateConversation, projectPath]);
     return /* @__PURE__ */ jsxs15(
       "section",
       {
@@ -21666,16 +22001,16 @@ var AgentGUIConversationRailSection = memo(
                 ]
               }
             ) : /* @__PURE__ */ jsx29("div", { className: AgentGUINode_styles_default.conversationSectionToggle, children: /* @__PURE__ */ jsx29("span", { className: AgentGUINode_styles_default.conversationSectionLabel, children: /* @__PURE__ */ jsx29("span", { children: section.label }) }) }),
-            projectPath ? /* @__PURE__ */ jsxs15("div", { className: AgentGUINode_styles_default.conversationSectionActions, children: [
+            canCreateConversationFromSection ? /* @__PURE__ */ jsxs15("div", { className: AgentGUINode_styles_default.conversationSectionActions, children: [
               /* @__PURE__ */ jsxs15("span", { className: AgentGUINode_styles_default.conversationSectionActionTooltipWrap, children: [
                 /* @__PURE__ */ jsx29(
                   BareIconButton,
                   {
                     className: AgentGUINode_styles_default.conversationSectionMoreButton,
-                    "aria-label": labels.projectSectionEdit,
+                    "aria-label": createConversationLabel,
                     size: "sm",
                     disabled: createConversationDisabled,
-                    onClick: () => onCreateConversation({ projectPath }),
+                    onClick: handleCreateConversation,
                     children: /* @__PURE__ */ jsx29(EditIcon, { "aria-hidden": "true" })
                   }
                 ),
@@ -21684,30 +22019,36 @@ var AgentGUIConversationRailSection = memo(
                   {
                     "aria-hidden": "true",
                     className: AgentGUINode_styles_default.conversationSectionActionTooltip,
-                    children: labels.projectSectionEdit
+                    children: createConversationLabel
                   }
                 )
               ] }),
-              /* @__PURE__ */ jsxs15(DropdownMenu, { children: [
-                /* @__PURE__ */ jsx29(DropdownMenuTrigger, { asChild: true, children: /* @__PURE__ */ jsxs15("span", { className: AgentGUINode_styles_default.conversationSectionActionTooltipWrap, children: [
-                  /* @__PURE__ */ jsx29(
-                    BareIconButton,
-                    {
-                      className: AgentGUINode_styles_default.conversationSectionMoreButton,
-                      "aria-label": labels.projectSectionMoreActions,
-                      size: "sm",
-                      children: /* @__PURE__ */ jsx29(MoreHorizontalIcon, { "aria-hidden": "true" })
-                    }
-                  ),
-                  /* @__PURE__ */ jsx29(
-                    "span",
-                    {
-                      "aria-hidden": "true",
-                      className: AgentGUINode_styles_default.conversationSectionActionTooltip,
-                      children: labels.projectSectionMoreActions
-                    }
-                  )
-                ] }) }),
+              projectPath ? /* @__PURE__ */ jsxs15(DropdownMenu, { children: [
+                /* @__PURE__ */ jsx29(DropdownMenuTrigger, { asChild: true, children: /* @__PURE__ */ jsxs15(
+                  "span",
+                  {
+                    className: AgentGUINode_styles_default.conversationSectionActionTooltipWrap,
+                    children: [
+                      /* @__PURE__ */ jsx29(
+                        BareIconButton,
+                        {
+                          className: AgentGUINode_styles_default.conversationSectionMoreButton,
+                          "aria-label": labels.projectSectionMoreActions,
+                          size: "sm",
+                          children: /* @__PURE__ */ jsx29(MoreHorizontalIcon, { "aria-hidden": "true" })
+                        }
+                      ),
+                      /* @__PURE__ */ jsx29(
+                        "span",
+                        {
+                          "aria-hidden": "true",
+                          className: AgentGUINode_styles_default.conversationSectionActionTooltip,
+                          children: labels.projectSectionMoreActions
+                        }
+                      )
+                    ]
+                  }
+                ) }),
                 /* @__PURE__ */ jsxs15(
                   DropdownMenuContent,
                   {
@@ -21767,7 +22108,7 @@ var AgentGUIConversationRailSection = memo(
                     ]
                   }
                 )
-              ] })
+              ] }) : null
             ] }) : null
           ] }),
           /* @__PURE__ */ jsx29(
@@ -22768,7 +23109,7 @@ function composerOverridesByProviderEqual(left, right) {
   return true;
 }
 function areAgentGUINodePropsEqual(previous, next) {
-  return previous.nodeId === next.nodeId && previous.workspaceId === next.workspaceId && previous.currentUserId === next.currentUserId && previous.workspacePath === next.workspacePath && previous.workspaceFileReferenceAdapter === next.workspaceFileReferenceAdapter && previous.referenceSourceAggregator === next.referenceSourceAggregator && previous.resolveMentionReferenceTarget === next.resolveMentionReferenceTarget && previous.onWorkspaceFileReferencesAdded === next.onWorkspaceFileReferencesAdded && previous.agentSettings.avoidGroupingEdits === next.agentSettings.avoidGroupingEdits && previous.title === next.title && agentGuiStateEquals(previous.state, next.state) && previous.position.x === next.position.x && previous.position.y === next.position.y && previous.width === next.width && previous.height === next.height && previous.desktopSize.width === next.desktopSize.width && previous.desktopSize.height === next.desktopSize.height && previous.onLinkAction === next.onLinkAction && previous.onCapabilitySettingsRequest === next.onCapabilitySettingsRequest && previous.onAgentProviderLogin === next.onAgentProviderLogin && previous.onClose === next.onClose && previous.onResize === next.onResize && previous.onUpdateNode === next.onUpdateNode && previous.onOpenConversationWindow === next.onOpenConversationWindow && previous.isMaximized === next.isMaximized && previous.isMuted === next.isMuted && previous.onMinimize === next.onMinimize && previous.onToggleMaximize === next.onToggleMaximize && previous.onShowMessage === next.onShowMessage && workspaceAgentProbeRenderStateEqualsForProvider(
+  return previous.nodeId === next.nodeId && previous.workspaceId === next.workspaceId && previous.currentUserId === next.currentUserId && previous.workspacePath === next.workspacePath && previous.workspaceFileReferenceAdapter === next.workspaceFileReferenceAdapter && previous.referenceSourceAggregator === next.referenceSourceAggregator && previous.resolveMentionReferenceTarget === next.resolveMentionReferenceTarget && previous.resolveWorkspaceReferenceInitialTarget === next.resolveWorkspaceReferenceInitialTarget && previous.onWorkspaceFileReferencesAdded === next.onWorkspaceFileReferencesAdded && previous.agentSettings.avoidGroupingEdits === next.agentSettings.avoidGroupingEdits && previous.title === next.title && agentGuiStateEquals(previous.state, next.state) && previous.position.x === next.position.x && previous.position.y === next.position.y && previous.width === next.width && previous.height === next.height && previous.desktopSize.width === next.desktopSize.width && previous.desktopSize.height === next.desktopSize.height && previous.onLinkAction === next.onLinkAction && previous.onCapabilitySettingsRequest === next.onCapabilitySettingsRequest && previous.onAgentProviderLogin === next.onAgentProviderLogin && previous.onClose === next.onClose && previous.onResize === next.onResize && previous.onUpdateNode === next.onUpdateNode && previous.onOpenConversationWindow === next.onOpenConversationWindow && previous.isMaximized === next.isMaximized && previous.isMuted === next.isMuted && previous.onMinimize === next.onMinimize && previous.onToggleMaximize === next.onToggleMaximize && previous.onShowMessage === next.onShowMessage && workspaceAgentProbeRenderStateEqualsForProvider(
     previous.workspaceAgentProbes,
     next.workspaceAgentProbes,
     previous.state.provider
@@ -22783,6 +23124,7 @@ var AgentGUINode = memo2(function AgentGUINode2({
   onRequestGitBranches = null,
   referenceSourceAggregator = null,
   resolveMentionReferenceTarget = null,
+  resolveWorkspaceReferenceInitialTarget = null,
   agentSettings,
   title,
   state,
@@ -23553,6 +23895,7 @@ var AgentGUINode = memo2(function AgentGUINode2({
             onRequestGitBranches,
             referenceSourceAggregator,
             resolveMentionReferenceTarget,
+            resolveWorkspaceReferenceInitialTarget,
             workspaceFileReferenceCopy,
             contextMentionProviders,
             workspaceAppIcons