@tutti-os/agent-gui 0.0.146 → 0.0.148

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";

package/dist/agent-message-center/index.d.ts

@@ -176,6 +176,8 @@ interface WorkspaceAgentMessageCenterCardProps {
     interactive?: boolean;
     isSubmitting: boolean;
     lazySummary?: boolean;
+    promptVariant?: "compact" | "full";
+    showSummaryWithPrompt?: boolean;
     summaryAccessory?: ReactNode;
     onLinkAction?: (action: WorkspaceLinkAction) => void;
     onOpenChat: (input: {
@@ -471,14 +473,42 @@ declare function useEngineSelector<TState, TSelected>(engine: EngineStateStore<T
 declare function buildWorkspaceAgentMessageCenterModelFromEngine(presentation: WorkspaceAgentMessageCenterPresentation, snapshot: Pick<AgentActivitySnapshot, "sessionMessagesById" | "workspaceId">, options?: BuildWorkspaceAgentMessageCenterOptions): WorkspaceAgentMessageCenterModel;
 interface WorkspaceAgentMessageCenterPresentation {
     consumers: readonly WorkspaceAgentConsumerSession[];
+    dismissedPlanTurnKeys: Readonly<Record<string, true>>;
     promptStatusByKey: Readonly<Record<string, WorkspaceAgentMessageCenterPromptStatus>>;
 }
 declare function selectWorkspaceAgentMessageCenterPresentation(state: AgentSessionEngineState): WorkspaceAgentMessageCenterPresentation;
 declare function workspaceAgentMessageCenterPresentationEqual(left: WorkspaceAgentMessageCenterPresentation, right: WorkspaceAgentMessageCenterPresentation): boolean;
+type WorkspaceAgentAttentionTarget = {
+    kind: "interaction";
+    workspaceId: string;
+    agentSessionId: string;
+    turnId: string;
+    requestId: string;
+} | {
+    kind: "plan-implementation";
+    workspaceId: string;
+    agentSessionId: string;
+    turnId: string;
+    requestId: string;
+};
+interface WorkspaceAgentAttentionItem {
+    item: WorkspaceAgentMessageCenterItem;
+    status: WorkspaceAgentMessageCenterPromptStatus;
+    target: WorkspaceAgentAttentionTarget;
+}
+/**
+ * Projects every canonical actionable target instead of collapsing a root
+ * conversation to its latest interaction. The display item keeps the root
+ * conversation identity for navigation while target keeps the exact child
+ * session/turn/request identity used by the command.
+ */
+declare function selectWorkspaceAgentAttentionItems(presentation: WorkspaceAgentMessageCenterPresentation, snapshot: Pick<AgentActivitySnapshot, "sessionMessagesById" | "workspaceId">, options?: BuildWorkspaceAgentMessageCenterOptions): WorkspaceAgentAttentionItem[];
+declare function workspaceAgentAttentionItemsEqual(left: readonly WorkspaceAgentAttentionItem[], right: readonly WorkspaceAgentAttentionItem[]): boolean;
 type WorkspaceAgentMessageCenterPromptStatus = "idle" | "responding" | "unknown" | "failed";
 declare function workspaceAgentMessageCenterPromptStatus(presentation: WorkspaceAgentMessageCenterPresentation, item: Pick<WorkspaceAgentMessageCenterItem, "agentSessionId" | "pendingInteractionTarget" | "pendingPrompt">): WorkspaceAgentMessageCenterPromptStatus;
 
 declare function stabilizeWorkspaceAgentMessageCenterModel(previous: WorkspaceAgentMessageCenterModel | null, next: WorkspaceAgentMessageCenterModel): WorkspaceAgentMessageCenterModel;
+declare function workspaceAgentMessageCenterItemEqual(left: WorkspaceAgentMessageCenterItem, right: WorkspaceAgentMessageCenterItem): boolean;
 
 declare const messageCenterFiltersStorageKey = "tutti.agent-message-center.filters";
 interface MessageCenterFilterPreferences {
@@ -489,4 +519,4 @@ interface MessageCenterFilterPreferences {
 declare function readMessageCenterFilterPreferences(): MessageCenterFilterPreferences;
 declare function writeMessageCenterFilterPreferences(preferences: MessageCenterFilterPreferences): void;
 
-export { AgentInteractivePromptSurface, AgentVerticalScrollArea, type BuildWorkspaceAgentMessageCenterOptions, type MessageCenterAgentUserStack, type MessageCenterFilterPreferences, type MessageCenterGroup, type MessageCenterGroupBy, MessageCenterGroupHeading, MessageCenterIdentityAvatarMark, MessageCenterIdentityAvatarStack, MessageCenterIdentityLabel, MessageCenterOpenChatButton, type MessageCenterProviderOption, type MessageCenterStatusFilter, type MessageCenterStatusOption, type MessageCenterStatusTone, MessageCenterSummary, type MessageCenterTranslate, PLAN_IMPLEMENTATION_ACTION_IMPLEMENT, PLAN_IMPLEMENTATION_PROMPT, type PromptToolDetail, type WorkspaceAgentMessageCenterAgentPresentation, WorkspaceAgentMessageCenterAttentionDeck, type WorkspaceAgentMessageCenterAttentionDeckProps, type WorkspaceAgentMessageCenterAttentionDeckRenderCardInput, WorkspaceAgentMessageCenterCard, type WorkspaceAgentMessageCenterCardProps, type WorkspaceAgentMessageCenterCounts, type WorkspaceAgentMessageCenterDigest, type WorkspaceAgentMessageCenterDigestPrimary, type WorkspaceAgentMessageCenterDigestPrimaryKind, type WorkspaceAgentMessageCenterIdentity, type WorkspaceAgentMessageCenterInteractionTarget, type WorkspaceAgentMessageCenterItem, type WorkspaceAgentMessageCenterModel, WorkspaceAgentMessageCenterPanel, type WorkspaceAgentMessageCenterPanelPresentation, type WorkspaceAgentMessageCenterPanelProps, type WorkspaceAgentMessageCenterPresentation, type WorkspaceAgentMessageCenterPromptStatus, WorkspaceAgentMessageCenterStack, MessageCenterViewMenu as WorkspaceAgentMessageCenterViewMenu, approvalOptionDisplayLabel, buildMessageCenterProviderOptions, buildMessageCenterStatusOptions, buildWorkspaceAgentInteractivePromptLabels, buildWorkspaceAgentMessageCenterModelFromEngine, dispatchAgentPlanPromptAction, getPromptToolDetails, groupMessageCenterItems, isInteractiveMessageCenterItem, isPromptRequestIdTitle, isRecentlyCompletedMessageCenterItem, isWaitingMessageCenterItem, itemMatchesViewFilters, managedAgentRoundedIconUrl, messageCenterAgentUserStackId, messageCenterFiltersStorageKey, messageCenterGroupLabel, messageCenterStackPreviewNodes, messageCenterStackPreviewText, messageCenterStackRenderId, messageCenterStackScrollSyncSegment, messageCenterStatusFilterValue, messageCenterStatusTone, messageCenterStatusToneClass, partitionMessageCenterItemsByAgentUser, readMessageCenterFilterPreferences, resolveMessageCenterNotificationAction, selectMessageCenterAttentionDeckItems, selectWorkspaceAgentMessageCenterPresentation, stabilizeWorkspaceAgentMessageCenterModel, statusFilterSummary, useEngineSelector, userAvatarPlaceholderUrl, workspaceAgentActivityStatusLabel, workspaceAgentMessageCenterPresentationEqual, workspaceAgentMessageCenterPromptStatus, writeMessageCenterFilterPreferences };
+export { AgentInteractivePromptSurface, AgentVerticalScrollArea, type BuildWorkspaceAgentMessageCenterOptions, type MessageCenterAgentUserStack, type MessageCenterFilterPreferences, type MessageCenterGroup, type MessageCenterGroupBy, MessageCenterGroupHeading, MessageCenterIdentityAvatarMark, MessageCenterIdentityAvatarStack, MessageCenterIdentityLabel, MessageCenterOpenChatButton, type MessageCenterProviderOption, type MessageCenterStatusFilter, type MessageCenterStatusOption, type MessageCenterStatusTone, MessageCenterSummary, type MessageCenterTranslate, PLAN_IMPLEMENTATION_ACTION_IMPLEMENT, PLAN_IMPLEMENTATION_PROMPT, type PromptToolDetail, type WorkspaceAgentAttentionItem, type WorkspaceAgentAttentionTarget, type WorkspaceAgentMessageCenterAgentPresentation, WorkspaceAgentMessageCenterAttentionDeck, type WorkspaceAgentMessageCenterAttentionDeckProps, type WorkspaceAgentMessageCenterAttentionDeckRenderCardInput, WorkspaceAgentMessageCenterCard, type WorkspaceAgentMessageCenterCardProps, type WorkspaceAgentMessageCenterCounts, type WorkspaceAgentMessageCenterDigest, type WorkspaceAgentMessageCenterDigestPrimary, type WorkspaceAgentMessageCenterDigestPrimaryKind, type WorkspaceAgentMessageCenterIdentity, type WorkspaceAgentMessageCenterInteractionTarget, type WorkspaceAgentMessageCenterItem, type WorkspaceAgentMessageCenterModel, WorkspaceAgentMessageCenterPanel, type WorkspaceAgentMessageCenterPanelPresentation, type WorkspaceAgentMessageCenterPanelProps, type WorkspaceAgentMessageCenterPresentation, type WorkspaceAgentMessageCenterPromptStatus, WorkspaceAgentMessageCenterStack, MessageCenterViewMenu as WorkspaceAgentMessageCenterViewMenu, approvalOptionDisplayLabel, buildMessageCenterProviderOptions, buildMessageCenterStatusOptions, buildWorkspaceAgentInteractivePromptLabels, buildWorkspaceAgentMessageCenterModelFromEngine, dispatchAgentPlanPromptAction, getPromptToolDetails, groupMessageCenterItems, isInteractiveMessageCenterItem, isPromptRequestIdTitle, isRecentlyCompletedMessageCenterItem, isWaitingMessageCenterItem, itemMatchesViewFilters, managedAgentRoundedIconUrl, messageCenterAgentUserStackId, messageCenterFiltersStorageKey, messageCenterGroupLabel, messageCenterStackPreviewNodes, messageCenterStackPreviewText, messageCenterStackRenderId, messageCenterStackScrollSyncSegment, messageCenterStatusFilterValue, messageCenterStatusTone, messageCenterStatusToneClass, partitionMessageCenterItemsByAgentUser, readMessageCenterFilterPreferences, resolveMessageCenterNotificationAction, selectMessageCenterAttentionDeckItems, selectWorkspaceAgentAttentionItems, selectWorkspaceAgentMessageCenterPresentation, stabilizeWorkspaceAgentMessageCenterModel, statusFilterSummary, useEngineSelector, userAvatarPlaceholderUrl, workspaceAgentActivityStatusLabel, workspaceAgentAttentionItemsEqual, workspaceAgentMessageCenterItemEqual, workspaceAgentMessageCenterPresentationEqual, workspaceAgentMessageCenterPromptStatus, writeMessageCenterFilterPreferences };