@tutti-os/agent-gui 0.0.101 → 0.0.102

package/README.md

@@ -98,6 +98,37 @@ pnpm check:agent-activity-runtime-boundaries
 `hostCapabilities`, `hostActions`, and `renderSlots`. Extend the owning object;
 do not restore flat compatibility props.
 
+## Reference Provenance Filtering
+
+Reference provenance filtering is disabled by default. Collaboration hosts can
+opt in by injecting the complete catalog through
+`hostCapabilities.referenceProvenanceFilterCatalog`:
+
+```tsx
+<AgentGUI
+  {...props}
+  hostCapabilities={{
+    referenceProvenanceFilterCatalog: {
+      enabledDimensions: ["agent", "member"],
+      agentOptions: [{ id: "agent-1", label: "Agent 1" }],
+      memberOptions: [{ id: "member-1", label: "Member 1" }]
+    }
+  }}
+/>
+```
+
+The catalog is host-owned: option IDs must be durable identities understood by
+the host's injected reference/search providers. Active dimensions are passed
+to those providers as query metadata and must be enforced before pagination.
+Sources that cannot enforce an active dimension must fail closed instead of
+returning unfiltered results.
+
+`referenceProvenanceFilterEnabled` remains as the legacy Tutti personal-edition
+switch. When enabled without an explicit catalog, AgentGUI derives only the
+Agent options from the Agent directory and keeps `memberOptions` empty. Omitting
+both properties keeps the filter off. An explicitly supplied catalog (including
+`null`) takes precedence over the legacy switch.
+
 ## Home Suggestions
 
 The five starter entries below the empty new-session composer are enabled by

package/dist/{AgentGUI-FECh2x1p.d.ts → AgentGUI-BJ3As1gI.d.ts}

@@ -4,7 +4,7 @@ import { I18nRuntime } from '@tutti-os/ui-i18n-runtime';
 import { AgentActivityGoalControlInput, AgentActivityGoalControlResult, AgentActivityCreateSessionInput, AgentActivitySession, AgentActivityDeleteSessionInput, AgentActivityDeleteSessionResult, AgentActivitySendInput, AgentActivitySessionSettings, AgentActivityActivateSessionResult, AgentActivitySnapshot, AgentSessionEngine, AgentActivityMessageOrder, AgentActivityMessagePage, AgentActivitySendInputResult, AgentActivityRenameSessionInput, AgentActivitySubmitInteractiveInput, AgentActivitySubmitInteractiveResult, AgentActivitySnapshotListener, AgentActivitySubmitSettingsPatch } from '@tutti-os/agent-activity-core';
 import { u as AgentHostAgentSessionComposerSettings, y as AgentHostUnactivateAgentSessionResult, h as AgentGUIAgentTarget, n as AgentGUIProvider, z as AgentPromptContentBlock, m as AgentGUINodeData, P as Point, o as AgentGUIProviderRailAllPresentation, p as AgentGUIProviderRailMode, q as AgentGUIProviderReadinessGate, l as AgentGUIHomeSuggestionId, N as NodeFrame, e as AgentGUIAgentDirectorySnapshot, k as AgentGUIAllAgentsPresentation } from './types-CnT8rNUI.js';
 import { A as AgentComposerDraft, q as AgentSessionCommand, d as AgentGUIProviderSkillOption, b as AgentGUIComposerSettingsVM, e as AgentGUIQueueStatus, f as AgentGUIQueuedPromptVM, l as AgentMessageMarkdownWorkspaceAppIcon, r as AgentSlashCommandCapability, c as AgentGUINodeViewModel, n as AgentProbeSnapshot, a as AgentComposerDraftFile, i as AgentHostInputApi } from './agentGuiNodeTypes-BH3lz6gn.js';
-import { WorkspaceFileReference, ReferenceLocateTarget, WorkspaceFileReferenceAdapter } from '@tutti-os/workspace-file-reference/contracts';
+import { WorkspaceFileReference, ReferenceLocateTarget, WorkspaceFileReferenceAdapter, ReferenceProvenanceCatalog } from '@tutti-os/workspace-file-reference/contracts';
 import { A as AgentContextMentionItem } from './agentFileMentionContracts-58IjMU-u.js';
 import { WorkspaceFileEntry } from '@tutti-os/workspace-file-manager/services';
 import { ReferenceSourceAggregator } from '@tutti-os/workspace-file-reference/core';
@@ -983,6 +983,14 @@ interface AgentGUINodeRuntimeRequests {
     onProbeRefreshRequest?: WorkspaceDesktopAgentProbeRefreshRequest;
 }
 interface AgentGUINodeHostCapabilities {
+    /**
+     * Complete host-owned catalog for reference provenance filtering. Supplying
+     * it explicitly opts the host into the dimensions declared by the catalog.
+     * Omit it to keep filtering disabled unless the legacy Agent-only flag is
+     * enabled.
+     */
+    referenceProvenanceFilterCatalog?: ReferenceProvenanceCatalog | null;
+    /** Legacy Tutti Agent-only opt-in. Prefer an explicit catalog in new hosts. */
     referenceProvenanceFilterEnabled?: boolean;
     capabilityMenuState?: AgentComposerCapabilityMenuState;
     accountMenuState?: AgentGUIAccountMenuState | null;

package/dist/agent-gui.d.ts

@@ -1,11 +1,11 @@
 import 'react';
 import '@tutti-os/ui-i18n-runtime';
-export { n as AgentGUI, w as AgentGUIProps } from './AgentGUI-FECh2x1p.js';
+export { n as AgentGUI, w as AgentGUIProps } from './AgentGUI-BJ3As1gI.js';
 import './agentGuiNodeTypes-BH3lz6gn.js';
 export { l as AgentGUIHomeSuggestionId } from './types-CnT8rNUI.js';
 import './runtime-BBNdWgDU.js';
+export { ReferenceProvenanceCatalog as AgentGUIReferenceProvenanceFilterCatalog } from '@tutti-os/workspace-file-reference/contracts';
 import '@tutti-os/agent-activity-core';
-import '@tutti-os/workspace-file-reference/contracts';
 import './agentFileMentionContracts-58IjMU-u.js';
 import '@tutti-os/workspace-file-manager/services';
 import '@tutti-os/workspace-file-reference/core';

package/dist/agent-gui.js

@@ -1,6 +1,6 @@
 import {
   AgentGUI
-} from "./chunk-VQOPBBBI.js";
+} from "./chunk-LHKBR77G.js";
 import "./chunk-D7HMQLBO.js";
 import "./chunk-KAV2WHTG.js";
 import "./chunk-4YVKAPKW.js";
@@ -9,11 +9,11 @@ import "./chunk-L3GMMGRS.js";
 import "./chunk-UHBCM6RO.js";
 import "./chunk-ZPKPIHMZ.js";
 import "./chunk-7BXWPI4F.js";
-import "./chunk-FAE7CXZO.js";
+import "./chunk-W4RYNKWO.js";
 import "./chunk-C35SNDVZ.js";
 import "./chunk-FGLQZ6I4.js";
 import "./chunk-4YG7YK7S.js";
-import "./chunk-EUW6VPIK.js";
+import "./chunk-YYE35EZ5.js";
 import "./chunk-4YCCATI4.js";
 import "./chunk-GCW57WYQ.js";
 import "./chunk-F5UR6EJG.js";

package/dist/{chunk-VQOPBBBI.js → chunk-LHKBR77G.js}

@@ -72,7 +72,7 @@ import {
 import {
   AgentFileMentionPalette,
   agentMentionItemKey
-} from "./chunk-FAE7CXZO.js";
+} from "./chunk-W4RYNKWO.js";
 import {
   normalizeAgentGUIAgents,
   projectAgentGUIAgentsToInternalTargets
@@ -83,7 +83,7 @@ import {
   DEFAULT_AGENT_MENTION_FILTER,
   agentGuiScheduler,
   buildWorkspaceAgentActivityListViewModel
-} from "./chunk-EUW6VPIK.js";
+} from "./chunk-YYE35EZ5.js";
 import {
   AGENT_RICH_TEXT_CARET_ANCHOR,
   createAgentSessionMarkdownLink,
@@ -32414,6 +32414,31 @@ function AgentProbeInfoPopover({
   );
 }
 
+// agent-gui/agentGuiNode/model/agentReferenceProvenanceCatalog.ts
+function resolveAgentGUIReferenceProvenanceFilterCatalog(input) {
+  if (input.injectedCatalog !== void 0) {
+    return input.injectedCatalog;
+  }
+  if (!input.legacyAgentFilterEnabled) {
+    return null;
+  }
+  return {
+    enabledDimensions: ["agent"],
+    agentOptions: (input.agentTargets ?? []).flatMap((target) => {
+      const agentTargetId = target.agentTargetId?.trim();
+      return agentTargetId ? [
+        {
+          disabled: target.disabled,
+          iconUrl: target.iconUrl,
+          id: agentTargetId,
+          label: target.label
+        }
+      ] : [];
+    }),
+    memberOptions: []
+  };
+}
+
 // agent-gui/agentGuiNode/AgentGUINode.types.ts
 function agentGuiStateEquals(left, right) {
   return left === right || left.provider === right.provider && (left.agentTargetId ?? null) === (right.agentTargetId ?? null) && left.lastActiveAgentSessionId === right.lastActiveAgentSessionId && left.conversationRailWidthPx === right.conversationRailWidthPx && left.conversationRailCollapsed === right.conversationRailCollapsed && (left.composerOverrides?.model ?? null) === (right.composerOverrides?.model ?? null) && (left.composerOverrides?.reasoningEffort ?? null) === (right.composerOverrides?.reasoningEffort ?? null) && (left.composerOverrides?.planMode ?? null) === (right.composerOverrides?.planMode ?? null) && (left.composerOverrides?.permissionModeId ?? null) === (right.composerOverrides?.permissionModeId ?? null) && composerOverridesByProviderEqual(
@@ -32461,7 +32486,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.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.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
@@ -33309,6 +33334,11 @@ function resolveAgentGUIRailStatusProvider(input) {
 // agent-gui/agentGuiNode/AgentGUINode.tsx
 import { jsx as jsx62, jsxs as jsxs45 } from "react/jsx-runtime";
 var EMPTY_SLASH_STATUS_QUOTAS = [];
+var DISABLED_REFERENCE_PROVENANCE_CATALOG = {
+  enabledDimensions: [],
+  agentOptions: [],
+  memberOptions: []
+};
 var AgentGUINode = memo14(function AgentGUINode2({
   identity,
   workspace,
@@ -33371,24 +33401,18 @@ var AgentGUINode = memo14(function AgentGUINode2({
     contextMentionProviders,
     workspaceAppIcons,
     disabledHomeSuggestions,
+    referenceProvenanceFilterCatalog: injectedReferenceProvenanceFilterCatalog,
     referenceProvenanceFilterEnabled = false
   } = hostCapabilities;
-  const referenceProvenanceFilterBinding = useReferenceProvenanceFilterCatalog({
-    enabledDimensions: referenceProvenanceFilterEnabled ? ["agent"] : [],
-    agentOptions: referenceProvenanceFilterEnabled ? (agentTargets ?? []).flatMap((target) => {
-      const agentTargetId = target.agentTargetId?.trim();
-      return agentTargetId ? [
-        {
-          disabled: target.disabled,
-          iconUrl: target.iconUrl,
-          id: agentTargetId,
-          label: target.label
-        }
-      ] : [];
-    }) : [],
-    memberOptions: []
+  const referenceProvenanceFilterCatalog = resolveAgentGUIReferenceProvenanceFilterCatalog({
+    agentTargets,
+    injectedCatalog: injectedReferenceProvenanceFilterCatalog,
+    legacyAgentFilterEnabled: referenceProvenanceFilterEnabled
   });
-  const referenceProvenanceFilter = referenceProvenanceFilterEnabled ? referenceProvenanceFilterBinding : null;
+  const referenceProvenanceFilterBinding = useReferenceProvenanceFilterCatalog(
+    referenceProvenanceFilterCatalog ?? DISABLED_REFERENCE_PROVENANCE_CATALOG
+  );
+  const referenceProvenanceFilter = referenceProvenanceFilterBinding.snapshot.catalog.enabledDimensions.length > 0 ? referenceProvenanceFilterBinding : null;
   const {
     onLinkAction,
     onHandoffConversation,
@@ -33895,4 +33919,4 @@ export {
   resolveAgentGUIAgentTarget,
   AgentGUI
 };
-//# sourceMappingURL=chunk-VQOPBBBI.js.map
+//# sourceMappingURL=chunk-LHKBR77G.js.map