@tutti-os/agent-gui 0.0.116 → 0.0.118

package/README.md

@@ -227,6 +227,11 @@ use `renderAgentsEmpty` for a host-specific loaded-empty state. Use
 `renderAgentReadinessState` for host-specific availability presentation, and
 handle install/login/refresh requests through `onAgentAvailabilityAction`.
 
+Hosts that launch handoffs across session-runtime boundaries may also pass
+`handoffAgentDirectory`. Its ready entries populate only the active-conversation
+Handoff menu; the conversation rail, session queries, and empty composer remain
+owned by `agentDirectory`. When omitted, Handoff uses `agentDirectory`.
+
 The old public `providerTargets`, `providerRailMode`, provider-target renderers,
 and `defaultProviderTargetId` contract is intentionally unsupported. Workbench
 state hydration performs a one-time read of legacy `providerTargetId` into

package/dist/{AgentGUI-Be6O5di1.d.ts → AgentGUI-B_K2lEDE.d.ts}

@@ -1006,6 +1006,9 @@ interface AgentGUINodeHostCapabilities {
     accountMenuState?: AgentGUIAccountMenuState | null;
     agentTargets?: readonly AgentGUIAgentTarget[];
     agentTargetsLoading?: boolean;
+    /** Launch-only targets for active-conversation handoff. */
+    handoffAgentTargets?: readonly AgentGUIAgentTarget[];
+    handoffAgentTargetsLoading?: boolean;
     providerRailAllPresentation?: AgentGUIProviderRailAllPresentation | null;
     providerRailMode?: AgentGUIProviderRailMode;
     comingSoonProviders?: readonly AgentGUIProvider[];
@@ -1053,10 +1056,15 @@ interface AgentGUINodeProps {
     renderSlots: AgentGUINodeRenderSlots;
 }
 
-type AgentGUIPublicHostCapabilities = Omit<AgentGUINodeProps["hostCapabilities"], "agentTargets" | "agentTargetsLoading" | "providerRailAllPresentation" | "providerRailMode" | "disabledHomeSuggestions">;
+type AgentGUIPublicHostCapabilities = Omit<AgentGUINodeProps["hostCapabilities"], "agentTargets" | "agentTargetsLoading" | "handoffAgentTargets" | "handoffAgentTargetsLoading" | "providerRailAllPresentation" | "providerRailMode" | "disabledHomeSuggestions">;
 type AgentGUIPublicRenderSlots = Omit<AgentGUINodeProps["renderSlots"], "providerRailEmpty">;
 interface AgentGUIProps extends Omit<AgentGUINodeProps, "hostCapabilities" | "renderSlots"> {
     agentDirectory: AgentGUIAgentDirectorySnapshot;
+    /**
+     * Host-owned launch catalog for conversation handoff. When omitted, handoff
+     * uses `agentDirectory`, preserving the single-runtime host contract.
+     */
+    handoffAgentDirectory?: AgentGUIAgentDirectorySnapshot;
     allAgentsPresentation?: AgentGUIAllAgentsPresentation | null;
     renderAgentsEmpty?: AgentGUIAgentsEmptyRenderer;
     agentActivityRuntime: AgentActivityRuntime;

package/dist/agent-gui.d.ts

@@ -1,6 +1,6 @@
 import 'react';
 import '@tutti-os/ui-i18n-runtime';
-export { n as AgentGUI, w as AgentGUIProps } from './AgentGUI-Be6O5di1.js';
+export { n as AgentGUI, w as AgentGUIProps } from './AgentGUI-B_K2lEDE.js';
 import './agentGuiNodeTypes-C_H3DbXt.js';
 export { l as AgentGUIHomeSuggestionId } from './types-COIp0SYP.js';
 import './runtime-BBNdWgDU.js';

package/dist/agent-gui.js

@@ -1,6 +1,6 @@
 import {
   AgentGUI
-} from "./chunk-IIQSQNS4.js";
+} from "./chunk-AD7EVK67.js";
 import "./chunk-A4WCTHWS.js";
 import "./chunk-NNIXG27Q.js";
 import "./chunk-TUWQV2MC.js";

package/dist/{chunk-IIQSQNS4.js → chunk-AD7EVK67.js}

@@ -11310,8 +11310,20 @@ function useAgentGUIProviderHome(input) {
   const selectConversationFilterTarget = useCallback21(
     (selection) => {
       const current = inputRef.current;
+      const agentTargetId = selection.agentTargetId.trim();
+      if (!agentTargetId) {
+        reportAgentGUIConversationFilterTargetUnresolved({
+          provider: selection.provider,
+          agentTargetId: null,
+          providerTargetCount: current.normalizedProviderTargets.length,
+          reason: "unresolved",
+          runtime: current.agentActivityRuntime,
+          workspaceId: current.workspaceId
+        });
+        return;
+      }
       const nextTarget = resolveAgentGUIAgentTarget({
-        agentTargetId: selection.agentTargetId,
+        agentTargetId,
         defaultAgentTargetId: current.defaultAgentTargetId,
         provider: selection.provider,
         agentTargets: current.normalizedProviderTargets,
@@ -11320,7 +11332,7 @@ function useAgentGUIProviderHome(input) {
       if (!nextTarget) {
         reportAgentGUIConversationFilterTargetUnresolved({
           provider: selection.provider,
-          agentTargetId: selection.agentTargetId ?? null,
+          agentTargetId,
           providerTargetCount: current.normalizedProviderTargets.length,
           reason: "unresolved",
           runtime: current.agentActivityRuntime,
@@ -11329,8 +11341,7 @@ function useAgentGUIProviderHome(input) {
         return;
       }
       current.clearRailRevealRequest();
-      const agentTargetId = nextTarget.agentTargetId?.trim() ?? "";
-      const nextFilter = agentTargetId ? { kind: "agentTarget", agentTargetId } : { kind: "all" };
+      const nextFilter = { kind: "agentTarget", agentTargetId };
       current.setConversationFilter(nextFilter);
       const activeId = current.activeConversationIdRef.current;
       const activeSummary = resolveConversationSummaryById(
@@ -11364,7 +11375,10 @@ function useAgentGUIProviderHome(input) {
         targetAgentTargetId: agentTargetId || null
       });
       if (rememberedSelection.kind === "restore") {
-        selectHomeComposerAgentTarget(selection);
+        selectHomeComposerAgentTarget({
+          provider: nextTarget.provider,
+          agentTargetId
+        });
         current.selectConversation(rememberedSelection.agentSessionId, {
           reloadConversations: false
         });
@@ -11380,7 +11394,10 @@ function useAgentGUIProviderHome(input) {
           staleIds
         );
       }
-      selectHomeComposerAgentTarget(selection);
+      selectHomeComposerAgentTarget({
+        provider: nextTarget.provider,
+        agentTargetId
+      });
     },
     [selectHomeComposerAgentTarget]
   );
@@ -11403,7 +11420,7 @@ function useAgentGUIProviderHome(input) {
     if (!target) return;
     selectHomeComposerAgentTarget({
       provider: target.provider,
-      agentTargetId: target.targetId
+      agentTargetId: filterAgentTargetId
     });
   }, [
     input.activeConversationId,
@@ -11842,7 +11859,9 @@ function useAgentGUIProviderCatalogSelection(input) {
     providerRailMode,
     providerReadinessGates,
     agentTargets,
-    agentTargetsLoading
+    agentTargetsLoading,
+    handoffAgentTargets,
+    handoffAgentTargetsLoading
   } = input;
   const normalizedComingSoonProviders = useMemo15(
     () => comingSoonProviders && comingSoonProviders.length > 0 ? [...comingSoonProviders] : emptyComingSoonProviders,
@@ -11878,11 +11897,23 @@ function useAgentGUIProviderCatalogSelection(input) {
     agentTargetsLoading
   ]);
   const shouldUseStaticProviderTargets = !isExactProviderRailMode && !agentTargetsLoading && (agentTargets === void 0 || normalizedExplicitProviderTargets.length === 0);
-  const handoffAgentTargets = useMemo15(
-    () => agentTargetsLoading ? [] : normalizedExplicitProviderTargets.filter(
+  const normalizedHandoffAgentTargets = useMemo15(
+    () => handoffAgentTargets === void 0 ? normalizedExplicitProviderTargets : normalizeAgentGUIAgentTargets(handoffAgentTargets, {
+      includeDisabledPlaceholders: false,
+      useStaticCatalog: false
+    }),
+    [handoffAgentTargets, normalizedExplicitProviderTargets]
+  );
+  const enabledHandoffAgentTargets = useMemo15(
+    () => (handoffAgentTargets === void 0 ? agentTargetsLoading : handoffAgentTargetsLoading) ? [] : normalizedHandoffAgentTargets.filter(
       (target) => target.disabled !== true
     ),
-    [normalizedExplicitProviderTargets, agentTargetsLoading]
+    [
+      agentTargetsLoading,
+      handoffAgentTargets,
+      handoffAgentTargetsLoading,
+      normalizedHandoffAgentTargets
+    ]
   );
   const selectedAgentTarget = useMemo15(
     () => resolveAgentGUIAgentTarget({
@@ -11964,7 +11995,7 @@ function useAgentGUIProviderCatalogSelection(input) {
   return {
     effectiveSelectedProviderTarget,
     firstReadyHomeComposerProviderTarget,
-    handoffAgentTargets,
+    handoffAgentTargets: enabledHandoffAgentTargets,
     homeComposerTargetOverride,
     homeComposerTargetOverrideIsExplicit,
     normalizedComingSoonProviders,
@@ -12626,6 +12657,8 @@ function useAgentGUINodeController({
   data,
   agentTargets,
   agentTargetsLoading = false,
+  handoffAgentTargets,
+  handoffAgentTargetsLoading = false,
   providerRailMode = "catalog",
   comingSoonProviders,
   providerReadinessGates = null,
@@ -12658,7 +12691,9 @@ function useAgentGUINodeController({
     providerRailMode,
     providerReadinessGates,
     agentTargets,
-    agentTargetsLoading
+    agentTargetsLoading,
+    handoffAgentTargets,
+    handoffAgentTargetsLoading
   });
   const {
     effectiveSelectedProviderTarget,
@@ -27145,32 +27180,20 @@ var AgentGUIProviderRail = memo4(function AgentGUIProviderRail2({
     ),
     [effectiveHiddenTargetIds, providerTiles]
   );
-  const selectedAgentTargetIsPlaceholder = selectedAgentTarget?.disabled === true && selectedAgentTarget.targetId === `local:${selectedAgentTarget.provider}`;
-  const allTileSelected = conversationFilter.kind === "all" && !selectedAgentTargetIsPlaceholder;
+  const allTileSelected = conversationFilter.kind === "all";
   const selectAllProviders = useCallback44(() => {
     onUpdateConversationFilter({ kind: "all" });
-    if (selectedAgentTargetIsPlaceholder) {
-      const fallbackTarget = railProviderTargets.find((target) => target.disabled !== true) ?? null;
-      if (fallbackTarget) {
-        onSelectConversationFilterTarget({
-          provider: fallbackTarget.provider,
-          agentTargetId: fallbackTarget.targetId
-        });
-      }
-    }
     onRequestComposerFocus();
-  }, [
-    onSelectConversationFilterTarget,
-    onRequestComposerFocus,
-    onUpdateConversationFilter,
-    railProviderTargets,
-    selectedAgentTargetIsPlaceholder
-  ]);
+  }, [onRequestComposerFocus, onUpdateConversationFilter]);
   const selectAgentTargetTile = useCallback44(
     (target) => {
+      const agentTargetId = target.agentTargetId?.trim() ?? "";
+      if (!agentTargetId) {
+        return;
+      }
       onSelectConversationFilterTarget({
         provider: target.provider,
-        agentTargetId: target.targetId
+        agentTargetId
       });
       onRequestComposerFocus();
     },
@@ -27338,10 +27361,13 @@ var AgentGUIProviderRail = memo4(function AgentGUIProviderRail2({
       );
       const fallbackTarget = fallbackTargets.find((target) => target.disabled !== true) ?? fallbackTargets[0];
       if (fallbackTarget && fallbackTarget.targetId !== targetId) {
-        onSelectHomeComposerAgentTarget({
-          provider: fallbackTarget.provider,
-          agentTargetId: fallbackTarget.targetId
-        });
+        const fallbackAgentTargetId = fallbackTarget.agentTargetId?.trim() ?? "";
+        if (fallbackAgentTargetId) {
+          onSelectHomeComposerAgentTarget({
+            provider: fallbackTarget.provider,
+            agentTargetId: fallbackAgentTargetId
+          });
+        }
       }
     }
     if (!visible && providerTiles.some(
@@ -27481,7 +27507,7 @@ var AgentGUIProviderRail = memo4(function AgentGUIProviderRail2({
             `provider-target-loading-${index}`
           )) : null,
           visibleProviderTiles.map((target) => {
-            const providerSelected = target.disabled === true ? selectedAgentTargetIsPlaceholder && selectedAgentTarget?.provider === target.provider && selectedAgentTarget?.targetId === target.targetId : agentGUIProviderTargetMatchesConversationFilter(
+            const providerSelected = agentGUIProviderTargetMatchesConversationFilter(
               target,
               conversationFilter
             );
@@ -35389,7 +35415,7 @@ function areAgentGUINodePropsEqual(previous, next) {
   const pc = previous.hostCapabilities, nc = next.hostCapabilities;
   const pa = previous.hostActions, na = next.hostActions;
   const ps = previous.renderSlots, ns = next.renderSlots;
-  return pi.nodeId === ni.nodeId && pi.workspaceId === ni.workspaceId && pi.currentUserId === ni.currentUserId && pi.title === ni.title && pw.path === nw.path && pw.fileReferenceAdapter === nw.fileReferenceAdapter && pw.onRequestGitBranches === nw.onRequestGitBranches && pw.selectProjectDirectory === nw.selectProjectDirectory && pw.resolveDroppedFileReferences === nw.resolveDroppedFileReferences && pw.referenceSourceAggregator === nw.referenceSourceAggregator && pw.resolveReferenceEntryIconUrl === nw.resolveReferenceEntryIconUrl && pw.resolveMentionReferenceTarget === nw.resolveMentionReferenceTarget && pw.resolveReferenceInitialTarget === nw.resolveReferenceInitialTarget && pw.onFileReferencesAdded === nw.onFileReferencesAdded && pw.agentSettings.avoidGroupingEdits === nw.agentSettings.avoidGroupingEdits && pc.referenceProvenanceFilterCatalog === nc.referenceProvenanceFilterCatalog && pc.referenceProvenanceFilterEnabled === nc.referenceProvenanceFilterEnabled && agentGuiStateEquals(previous.state, next.state) && pf.position.x === nf.position.x && pf.position.y === nf.position.y && pf.width === nf.width && pf.height === nf.height && pf.desktopSize.width === nf.desktopSize.width && pf.desktopSize.height === nf.desktopSize.height && pf.isMaximized === nf.isMaximized && pf.isActive === nf.isActive && pf.isVisible === nf.isVisible && pf.embedded === nf.embedded && pf.previewMode === nf.previewMode && pf.conversationRailAutoCollapseWidthPx === nf.conversationRailAutoCollapseWidthPx && pr.composerFocusSequence === nr.composerFocusSequence && pr.composerAppend === nr.composerAppend && pr.newConversationSequence === nr.newConversationSequence && pr.openSession === nr.openSession && pr.prefillPrompt === nr.prefillPrompt && pr.agentProbes === nr.agentProbes && pr.onProbeDemandChange === nr.onProbeDemandChange && pr.onProbeRefreshRequest === nr.onProbeRefreshRequest && pc.capabilityMenuState === nc.capabilityMenuState && pc.accountMenuState === nc.accountMenuState && pc.agentTargets === nc.agentTargets && pc.agentTargetsLoading === nc.agentTargetsLoading && pc.providerRailAllPresentation?.iconUrl === nc.providerRailAllPresentation?.iconUrl && pc.providerRailMode === nc.providerRailMode && pc.comingSoonProviders === nc.comingSoonProviders && pc.providerReadinessGates === nc.providerReadinessGates && pc.defaultAgentTargetId === nc.defaultAgentTargetId && pc.providerAuthAccountLabels === nc.providerAuthAccountLabels && pc.contextMentionProviders === nc.contextMentionProviders && pc.workspaceAppIcons === nc.workspaceAppIcons && pc.disabledHomeSuggestions === nc.disabledHomeSuggestions && pa.onLinkAction === na.onLinkAction && pa.onHandoffConversation === na.onHandoffConversation && pa.onCapabilitySettingsRequest === na.onCapabilitySettingsRequest && pa.onAgentProviderLogin === na.onAgentProviderLogin && pa.onOpenConversationWindow === na.onOpenConversationWindow && pa.onClose === na.onClose && pa.onResize === na.onResize && pa.onUpdateNode === na.onUpdateNode && pa.onRememberComposerDefaults === na.onRememberComposerDefaults && pa.isMuted === na.isMuted && pa.onMinimize === na.onMinimize && pa.onToggleMaximize === na.onToggleMaximize && pa.onShowMessage === na.onShowMessage && pa.onEngagementEvent === na.onEngagementEvent && ps.providerRailEmpty === ns.providerRailEmpty && ps.providerUnavailableState === ns.providerUnavailableState && ps.sidebarFooter === ns.sidebarFooter;
+  return pi.nodeId === ni.nodeId && pi.workspaceId === ni.workspaceId && pi.currentUserId === ni.currentUserId && pi.title === ni.title && pw.path === nw.path && pw.fileReferenceAdapter === nw.fileReferenceAdapter && pw.onRequestGitBranches === nw.onRequestGitBranches && pw.selectProjectDirectory === nw.selectProjectDirectory && pw.resolveDroppedFileReferences === nw.resolveDroppedFileReferences && pw.referenceSourceAggregator === nw.referenceSourceAggregator && pw.resolveReferenceEntryIconUrl === nw.resolveReferenceEntryIconUrl && pw.resolveMentionReferenceTarget === nw.resolveMentionReferenceTarget && pw.resolveReferenceInitialTarget === nw.resolveReferenceInitialTarget && pw.onFileReferencesAdded === nw.onFileReferencesAdded && pw.agentSettings.avoidGroupingEdits === nw.agentSettings.avoidGroupingEdits && pc.referenceProvenanceFilterCatalog === nc.referenceProvenanceFilterCatalog && pc.referenceProvenanceFilterEnabled === nc.referenceProvenanceFilterEnabled && agentGuiStateEquals(previous.state, next.state) && pf.position.x === nf.position.x && pf.position.y === nf.position.y && pf.width === nf.width && pf.height === nf.height && pf.desktopSize.width === nf.desktopSize.width && pf.desktopSize.height === nf.desktopSize.height && pf.isMaximized === nf.isMaximized && pf.isActive === nf.isActive && pf.isVisible === nf.isVisible && pf.embedded === nf.embedded && pf.previewMode === nf.previewMode && pf.conversationRailAutoCollapseWidthPx === nf.conversationRailAutoCollapseWidthPx && pr.composerFocusSequence === nr.composerFocusSequence && pr.composerAppend === nr.composerAppend && pr.newConversationSequence === nr.newConversationSequence && pr.openSession === nr.openSession && pr.prefillPrompt === nr.prefillPrompt && pr.agentProbes === nr.agentProbes && pr.onProbeDemandChange === nr.onProbeDemandChange && pr.onProbeRefreshRequest === nr.onProbeRefreshRequest && pc.capabilityMenuState === nc.capabilityMenuState && pc.accountMenuState === nc.accountMenuState && pc.agentTargets === nc.agentTargets && pc.agentTargetsLoading === nc.agentTargetsLoading && pc.handoffAgentTargets === nc.handoffAgentTargets && pc.handoffAgentTargetsLoading === nc.handoffAgentTargetsLoading && pc.providerRailAllPresentation?.iconUrl === nc.providerRailAllPresentation?.iconUrl && pc.providerRailMode === nc.providerRailMode && pc.comingSoonProviders === nc.comingSoonProviders && pc.providerReadinessGates === nc.providerReadinessGates && pc.defaultAgentTargetId === nc.defaultAgentTargetId && pc.providerAuthAccountLabels === nc.providerAuthAccountLabels && pc.contextMentionProviders === nc.contextMentionProviders && pc.workspaceAppIcons === nc.workspaceAppIcons && pc.disabledHomeSuggestions === nc.disabledHomeSuggestions && pa.onLinkAction === na.onLinkAction && pa.onHandoffConversation === na.onHandoffConversation && pa.onCapabilitySettingsRequest === na.onCapabilitySettingsRequest && pa.onAgentProviderLogin === na.onAgentProviderLogin && pa.onOpenConversationWindow === na.onOpenConversationWindow && pa.onClose === na.onClose && pa.onResize === na.onResize && pa.onUpdateNode === na.onUpdateNode && pa.onRememberComposerDefaults === na.onRememberComposerDefaults && pa.isMuted === na.isMuted && pa.onMinimize === na.onMinimize && pa.onToggleMaximize === na.onToggleMaximize && pa.onShowMessage === na.onShowMessage && pa.onEngagementEvent === na.onEngagementEvent && ps.providerRailEmpty === ns.providerRailEmpty && ps.providerUnavailableState === ns.providerUnavailableState && ps.sidebarFooter === ns.sidebarFooter;
 }
 
 // agent-gui/agentGuiNode/AgentGUINode.labels.ts
@@ -36296,6 +36322,8 @@ var AgentGUINode = memo14(function AgentGUINode2({
     accountMenuState = null,
     agentTargets,
     agentTargetsLoading = false,
+    handoffAgentTargets,
+    handoffAgentTargetsLoading = false,
     providerRailAllPresentation = null,
     providerRailMode = "catalog",
     comingSoonProviders,
@@ -36471,6 +36499,8 @@ var AgentGUINode = memo14(function AgentGUINode2({
     prefillPromptRequest,
     agentTargets,
     agentTargetsLoading,
+    handoffAgentTargets,
+    handoffAgentTargetsLoading,
     providerRailMode,
     comingSoonProviders,
     providerReadinessGates,
@@ -36777,6 +36807,7 @@ var AgentGUI = memo15(function AgentGUI2({
   agentActivityRuntime,
   agentHostApi,
   agentDirectory,
+  handoffAgentDirectory,
   allAgentsPresentation = null,
   renderAgentsEmpty,
   disabled,
@@ -36785,6 +36816,10 @@ var AgentGUI = memo15(function AgentGUI2({
   ...props
 }) {
   const normalizedAgents = normalizeAgentGUIAgents(agentDirectory.agents);
+  const effectiveHandoffAgentDirectory = handoffAgentDirectory ?? agentDirectory;
+  const normalizedHandoffAgents = normalizeAgentGUIAgents(
+    effectiveHandoffAgentDirectory.agents
+  );
   const hostCapabilities = props.hostCapabilities;
   const renderSlots = props.renderSlots;
   const nodeProps = {
@@ -36793,6 +36828,10 @@ var AgentGUI = memo15(function AgentGUI2({
       ...hostCapabilities,
       agentTargets: projectAgentGUIAgentsToInternalTargets(normalizedAgents),
       agentTargetsLoading: agentDirectory.agents.length === 0 && (agentDirectory.status === "idle" || agentDirectory.status === "loading"),
+      handoffAgentTargets: projectAgentGUIAgentsToInternalTargets(
+        normalizedHandoffAgents
+      ),
+      handoffAgentTargetsLoading: effectiveHandoffAgentDirectory.agents.length === 0 && (effectiveHandoffAgentDirectory.status === "idle" || effectiveHandoffAgentDirectory.status === "loading"),
       disabledHomeSuggestions: disabled,
       providerRailAllPresentation: allAgentsPresentation ?? null,
       providerRailMode: "exact"
@@ -36823,4 +36862,4 @@ export {
   resolveAgentGUIAgentTarget,
   AgentGUI
 };
-//# sourceMappingURL=chunk-IIQSQNS4.js.map
+//# sourceMappingURL=chunk-AD7EVK67.js.map