@tutti-os/agent-gui 0.0.146 → 0.0.147

package/README.md

@@ -49,15 +49,20 @@ contract; it is not a pasted-text or external-file capability signal.
 
 ## External File Preparation
 
-OS clipboard and drop files use the required workspace
-`prepareExternalPromptFiles` host port. AgentGUI owns classification, pending
-mentions, and draft reconciliation. The host owns native-path lookup, size
-enforcement, persistence, and remote transport.
-
-The preparer returns one result per input `sourceIndex`. Prepared files require
-a provider-readable `path` or `url`; failures require a typed `errorCode`.
-Hosts must isolate per-file failures and reject oversized inputs before reading
-or persisting their bytes.
+OS clipboard and drop entries first use the optional synchronous workspace
+`resolveExternalPromptEntries` host port. The host classifies every input as a
+live `WorkspaceFileReference` or a snapshot that needs preparation. AgentGUI
+inserts references directly as ordinary file/folder mentions, preserves mixed
+input order, and sends only `prepare` entries to `prepareExternalPromptFiles`.
+Without the resolver, every input uses preparation.
+
+Both ports return one result per input `sourceIndex`. The resolver is
+synchronous so paste/drop insertion position remains stable. Prepared files
+require a provider-readable `path` or `url`; failures require a typed
+`errorCode`. Hosts must isolate per-file failures and reject oversized inputs
+before reading or persisting their bytes. A host that resolves path-backed
+entries as references must also reject any such entry that unexpectedly reaches
+preparation, preventing a resolver failure from creating a duplicate snapshot.
 
 Slash commands come from the runtime session command snapshot. AgentGUI keeps
 legacy provider-default slash entries unless the host passes

package/dist/agent-gui.d.ts

@@ -492,6 +492,16 @@ interface AgentGUIAccountMenuState {
     onOpenExternal(url: string): void;
 }
 
+type AgentExternalPromptEntryResolution = {
+    disposition: "reference";
+    reference: WorkspaceFileReference;
+    sourceIndex: number;
+} | {
+    disposition: "prepare";
+    sourceIndex: number;
+};
+type AgentExternalPromptEntryResolver = (files: readonly File[]) => readonly AgentExternalPromptEntryResolution[];
+
 interface AgentPreparedExternalPromptFileMetadata {
     assetId?: string;
     mimeType?: string;
@@ -826,6 +836,7 @@ interface AgentComposerProps {
     }) => void;
     onLinkAction?: (action: WorkspaceLinkAction) => void;
     onRequestWorkspaceReferences?: ((entity?: AgentContextMentionItem | null) => Promise<WorkspaceReferencePickResult>) | null;
+    resolveExternalPromptEntries?: AgentExternalPromptEntryResolver | null;
     prepareExternalPromptFiles?: AgentExternalPromptFilePreparer | null;
     promptAssetLimit?: number | null;
     selectProjectDirectory?: () => Promise<{
@@ -994,6 +1005,7 @@ interface AgentGUINodeWorkspace {
     selectProjectDirectory?: () => Promise<{
         path: string;
     } | null>;
+    resolveExternalPromptEntries?: AgentComposerProps["resolveExternalPromptEntries"];
     prepareExternalPromptFiles?: AgentComposerProps["prepareExternalPromptFiles"];
     promptAssetLimit?: number | null;
     referenceSourceAggregator?: ReferenceSourceAggregator | null;

package/dist/agent-gui.js

@@ -1,6 +1,6 @@
 import {
   AgentGUI
-} from "./chunk-4WSWPMV7.js";
+} from "./chunk-LWXHBRDO.js";
 import "./chunk-A4WCTHWS.js";
 import "./chunk-ZF65NZ4B.js";
 import "./chunk-TUWQV2MC.js";