@tutti-os/agent-gui 0.0.117 → 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-7Y3OBABX.js";
+} from "./chunk-AD7EVK67.js";
 import "./chunk-A4WCTHWS.js";
 import "./chunk-NNIXG27Q.js";
 import "./chunk-TUWQV2MC.js";

package/dist/{chunk-7Y3OBABX.js → chunk-AD7EVK67.js}

@@ -11859,7 +11859,9 @@ function useAgentGUIProviderCatalogSelection(input) {
     providerRailMode,
     providerReadinessGates,
     agentTargets,
-    agentTargetsLoading
+    agentTargetsLoading,
+    handoffAgentTargets,
+    handoffAgentTargetsLoading
   } = input;
   const normalizedComingSoonProviders = useMemo15(
     () => comingSoonProviders && comingSoonProviders.length > 0 ? [...comingSoonProviders] : emptyComingSoonProviders,
@@ -11895,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({
@@ -11981,7 +11995,7 @@ function useAgentGUIProviderCatalogSelection(input) {
   return {
     effectiveSelectedProviderTarget,
     firstReadyHomeComposerProviderTarget,
-    handoffAgentTargets,
+    handoffAgentTargets: enabledHandoffAgentTargets,
     homeComposerTargetOverride,
     homeComposerTargetOverrideIsExplicit,
     normalizedComingSoonProviders,
@@ -12643,6 +12657,8 @@ function useAgentGUINodeController({
   data,
   agentTargets,
   agentTargetsLoading = false,
+  handoffAgentTargets,
+  handoffAgentTargetsLoading = false,
   providerRailMode = "catalog",
   comingSoonProviders,
   providerReadinessGates = null,
@@ -12675,7 +12691,9 @@ function useAgentGUINodeController({
     providerRailMode,
     providerReadinessGates,
     agentTargets,
-    agentTargetsLoading
+    agentTargetsLoading,
+    handoffAgentTargets,
+    handoffAgentTargetsLoading
   });
   const {
     effectiveSelectedProviderTarget,
@@ -35397,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
@@ -36304,6 +36322,8 @@ var AgentGUINode = memo14(function AgentGUINode2({
     accountMenuState = null,
     agentTargets,
     agentTargetsLoading = false,
+    handoffAgentTargets,
+    handoffAgentTargetsLoading = false,
     providerRailAllPresentation = null,
     providerRailMode = "catalog",
     comingSoonProviders,
@@ -36479,6 +36499,8 @@ var AgentGUINode = memo14(function AgentGUINode2({
     prefillPromptRequest,
     agentTargets,
     agentTargetsLoading,
+    handoffAgentTargets,
+    handoffAgentTargetsLoading,
     providerRailMode,
     comingSoonProviders,
     providerReadinessGates,
@@ -36785,6 +36807,7 @@ var AgentGUI = memo15(function AgentGUI2({
   agentActivityRuntime,
   agentHostApi,
   agentDirectory,
+  handoffAgentDirectory,
   allAgentsPresentation = null,
   renderAgentsEmpty,
   disabled,
@@ -36793,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 = {
@@ -36801,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"
@@ -36831,4 +36862,4 @@ export {
   resolveAgentGUIAgentTarget,
   AgentGUI
 };
-//# sourceMappingURL=chunk-7Y3OBABX.js.map
+//# sourceMappingURL=chunk-AD7EVK67.js.map