@tutti-os/agent-gui 0.0.133 → 0.0.134

package/dist/{chunk-KPMQGPYU.js → chunk-ZVYUTXQJ.js}

@@ -40,4 +40,4 @@ export {
   useAgentTargetPresentations,
   resolveAgentTargetPresentation
 };
-//# sourceMappingURL=chunk-KPMQGPYU.js.map
+//# sourceMappingURL=chunk-ZVYUTXQJ.js.map

package/dist/chunk-ZVYUTXQJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../app/renderer/lib/utils.ts","../shared/AgentTargetPresentationContext.tsx"],"sourcesContent":["import { type ClassValue, clsx } from \"clsx\";\nimport { twMerge } from \"tailwind-merge\";\n\nexport function cn(...inputs: ClassValue[]): string {\n  return twMerge(clsx(inputs));\n}\n","import { createContext, useContext, type JSX, type ReactNode } from \"react\";\n\nexport interface AgentMessageMarkdownAgentTarget {\n  agentTargetId: string;\n  iconUrl?: string | null;\n  maskIconUrl?: string | null;\n  name?: string | null;\n  provider?: string | null;\n  workspaceId?: string | null;\n}\n\nconst EMPTY_AGENT_TARGETS: readonly AgentMessageMarkdownAgentTarget[] =\n  Object.freeze([]);\n\nconst AgentTargetPresentationContext =\n  createContext<readonly AgentMessageMarkdownAgentTarget[]>(\n    EMPTY_AGENT_TARGETS\n  );\n\nexport function AgentTargetPresentationProvider({\n  agentTargets,\n  children\n}: {\n  agentTargets: readonly AgentMessageMarkdownAgentTarget[];\n  children: ReactNode;\n}): JSX.Element {\n  return (\n    <AgentTargetPresentationContext.Provider value={agentTargets}>\n      {children}\n    </AgentTargetPresentationContext.Provider>\n  );\n}\n\nexport function useAgentTargetPresentations(): readonly AgentMessageMarkdownAgentTarget[] {\n  return useContext(AgentTargetPresentationContext);\n}\n\nexport function resolveAgentTargetPresentation(input: {\n  agentTargetId: string;\n  agentTargets: readonly AgentMessageMarkdownAgentTarget[];\n  workspaceId?: string | null;\n}): AgentMessageMarkdownAgentTarget | null {\n  const agentTargetId = input.agentTargetId.trim();\n  if (!agentTargetId) {\n    return null;\n  }\n  const workspaceId = input.workspaceId?.trim() ?? \"\";\n  return (\n    input.agentTargets.find(\n      (target) =>\n        target.agentTargetId.trim() === agentTargetId &&\n        (target.workspaceId?.trim() ?? \"\") === workspaceId\n    ) ??\n    input.agentTargets.find(\n      (target) => target.agentTargetId.trim() === agentTargetId\n    ) ??\n    null\n  );\n}\n"],"mappings":";AAAA,SAA0B,YAAY;AACtC,SAAS,eAAe;AAEjB,SAAS,MAAM,QAA8B;AAClD,SAAO,QAAQ,KAAK,MAAM,CAAC;AAC7B;;;ACLA,SAAS,eAAe,kBAA4C;AA2BhE;AAhBJ,IAAM,sBACJ,OAAO,OAAO,CAAC,CAAC;AAElB,IAAM,iCACJ;AAAA,EACE;AACF;AAEK,SAAS,gCAAgC;AAAA,EAC9C;AAAA,EACA;AACF,GAGgB;AACd,SACE,oBAAC,+BAA+B,UAA/B,EAAwC,OAAO,cAC7C,UACH;AAEJ;AAEO,SAAS,8BAA0E;AACxF,SAAO,WAAW,8BAA8B;AAClD;AAEO,SAAS,+BAA+B,OAIJ;AACzC,QAAM,gBAAgB,MAAM,cAAc,KAAK;AAC/C,MAAI,CAAC,eAAe;AAClB,WAAO;AAAA,EACT;AACA,QAAM,cAAc,MAAM,aAAa,KAAK,KAAK;AACjD,SACE,MAAM,aAAa;AAAA,IACjB,CAAC,WACC,OAAO,cAAc,KAAK,MAAM,kBAC/B,OAAO,aAAa,KAAK,KAAK,QAAQ;AAAA,EAC3C,KACA,MAAM,aAAa;AAAA,IACjB,CAAC,WAAW,OAAO,cAAc,KAAK,MAAM;AAAA,EAC9C,KACA;AAEJ;","names":[]}

package/dist/context-mention-palette/index.d.ts

@@ -1,4 +1,4 @@
-import { A as AgentContextMentionItem } from '../agentFileMentionContracts-CWAeuL7S.js';
+import { A as AgentContextMentionItem } from '../agentFileMentionContracts-B0yQizXB.js';
 import { AgentMentionSearchState, AgentMentionBrowseCategory, AgentMentionFilterId, AgentMentionGroupId } from '../mention-search.js';
 export { AgentMentionGroup, AgentMentionSearchController } from '../mention-search.js';
 import { ReactNode } from 'react';

package/dist/context-mention-palette/index.js

@@ -3,27 +3,28 @@ import {
   AgentFileMentionPalette,
   flattenAgentMentionPaletteEntries,
   groupStartKeys
-} from "../chunk-UARZZJJB.js";
+} from "../chunk-OI6BYC7P.js";
 import {
   AgentMentionSearchController
-} from "../chunk-J4TTEMRW.js";
+} from "../chunk-KWGMK4IZ.js";
 import "../chunk-USIFGHT3.js";
 import "../chunk-XJ34OIEQ.js";
 import "../chunk-R7AXDQCA.js";
-import "../chunk-OBWM2RFE.js";
+import "../chunk-QPEO4OQS.js";
 import "../chunk-5QPOMKMQ.js";
 import {
   AGENT_CONTEXT_MENTION_PROVIDER_IDS
 } from "../chunk-RMQREVJY.js";
-import "../chunk-QQRTUHCH.js";
+import "../chunk-FGLQZ6I4.js";
+import "../chunk-EU7DCT4F.js";
 import "../chunk-YMXYBG7U.js";
-import "../chunk-NE6H7S5Z.js";
+import "../chunk-OFJNIQWR.js";
 import "../chunk-F5UR6EJG.js";
 import "../chunk-EDNJMG5T.js";
-import "../chunk-SZOTLVH6.js";
+import "../chunk-GIYGO2PB.js";
 import "../chunk-PJP5BUU6.js";
 import "../chunk-7KVZPJ3O.js";
-import "../chunk-OQR3HXPF.js";
+import "../chunk-VUNVGEQG.js";
 import "../chunk-MIJXEELH.js";
 import "../chunk-D2JUDUYY.js";
 import "../chunk-6CUELYIF.js";

package/dist/{contribution-BbW-kkpi.d.ts → contribution-CDdwTppn.d.ts}

@@ -34,6 +34,8 @@ interface AgentGUIAgent {
     agentTargetId: string;
     name: string;
     iconUrl: string;
+    /** Single-color artwork rendered through the conversation rail CSS mask. */
+    maskIconUrl?: string | null;
     sidebarIconUrl?: string | null;
     heroImageUrl?: string | null;
     description?: string | null;

package/dist/custom-mention.js

@@ -1,3 +1,4 @@
+import "./chunk-DLCZJKCA.js";
 import {
   AGENT_PASTED_TEXT_BLOCK_KIND,
   AGENT_PASTED_TEXT_MENTION_KIND

package/dist/i18n/index.d.ts

@@ -370,6 +370,9 @@ declare const agentGuiI18nResources: {
                 readonly fileMentionError: "Unable to search Files.";
                 readonly fileMentionTabHint: "Tab switch category | ←→ enter/leave folder | ↑↓ switch selection";
                 readonly fileDropHint: "Drop files to add them to the session";
+                readonly composerFileFolderUnsupported: "Folders cannot be attached here";
+                readonly composerFileTooLarge: "File is too large";
+                readonly composerFilePreparationFailed: "File preparation failed";
                 readonly mentionPalette: "Mention context";
                 readonly addReference: "Add reference";
                 readonly addContent: "Add files and more";
@@ -2954,6 +2957,9 @@ declare const agentGuiI18nResources: {
                 readonly fileMentionError: "无法搜索工作区文件。";
                 readonly fileMentionTabHint: "Tab 切换分类 ｜ ←→ 进入/返回文件夹 ｜ ↑↓ 切换选中";
                 readonly fileDropHint: "拖放文件以添加到会话";
+                readonly composerFileFolderUnsupported: "暂不支持在这里附加文件夹";
+                readonly composerFileTooLarge: "文件过大";
+                readonly composerFilePreparationFailed: "文件处理失败";
                 readonly mentionPalette: "提及上下文";
                 readonly addReference: "添加引用";
                 readonly addContent: "添加文件等内容";

package/dist/i18n/index.js

@@ -6,8 +6,8 @@ import {
   translate,
   translateInUiLanguage,
   useTranslation
-} from "../chunk-SZOTLVH6.js";
-import "../chunk-OQR3HXPF.js";
+} from "../chunk-GIYGO2PB.js";
+import "../chunk-VUNVGEQG.js";
 export {
   AgentGuiI18nProvider,
   agentGuiI18nModule,

package/dist/index.d.ts

@@ -667,10 +667,6 @@ type AgentHostWorkspaceApi = AgentHostRecord & {
     ensureDirectory: (input: {
         path: string;
     }) => AgentHostAsyncResult<void>;
-    getReferenceForFile?: (file: File) => {
-        kind: "file" | "folder";
-        path: string;
-    };
     readFile: (input: {
         path: string;
     }) => AgentHostAsyncResult<ReadWorkspaceFileResult>;
@@ -1015,6 +1011,8 @@ interface AgentGUIAgent {
     agentTargetId: string;
     name: string;
     iconUrl: string;
+    /** Single-color artwork rendered through the conversation rail CSS mask. */
+    maskIconUrl?: string | null;
     sidebarIconUrl?: string | null;
     heroImageUrl?: string | null;
     description?: string | null;
@@ -1055,6 +1053,7 @@ interface AgentGUIAgentTarget {
     label: string;
     description?: string;
     iconUrl?: string | null;
+    maskIconUrl?: string | null;
     sidebarIconUrl?: string | null;
     heroImageUrl?: string | null;
     badge?: AgentGUIAgentTargetBadge | null;
@@ -1702,11 +1701,16 @@ interface AgentMentionFileItem {
     name: string;
     entryKind: AgentFileMentionKind;
     directoryPath: string;
+    /** Present only for a regular file attached from the local composer. */
+    attachmentId?: string;
+    attachmentStatus?: AgentComposerFileMentionStatus;
+    attachmentErrorCode?: string;
     score?: number;
     thumbnailUrl?: string | null;
     mentionNavigation?: AgentMentionFileNavigationAction;
     childCount?: number;
 }
+type AgentComposerFileMentionStatus = "uploading" | "ready" | "error";
 interface AgentMentionSessionItem {
     kind: "session";
     href: string;
@@ -1830,8 +1834,6 @@ type AgentContextMentionProvider<TItem = any> = Omit<RichTextTriggerProvider<TIt
     queryDirectory?(input: AgentContextMentionDirectoryQueryInput): Promise<readonly TItem[]> | readonly TItem[];
 };
 
-type AgentDroppedFileReferenceResolver = (files: readonly File[]) => Promise<readonly WorkspaceFileReference[]> | readonly WorkspaceFileReference[];
-
 type AgentGUIResolvedProvider = AgentGUIProvider | "unknown";
 type AgentGUIConversationTitleFallback = "untitled-conversation" | null;
 type AgentGUIConversationTitleLeadingMentionKind = "agent" | "app" | "file" | "session" | "task";
@@ -1984,10 +1986,15 @@ interface AgentComposerFileBlockBase {
     mimeType?: string;
     path?: string;
     hostPath?: string;
+    url?: string;
+    uri?: string;
     assetId?: string;
+    uploadStatus?: string;
     sizeBytes?: number;
     uploading?: boolean;
     uploadError?: string;
+    uploadErrorCode?: string;
+    uploadRetryable?: boolean;
 }
 interface AgentComposerRegularFileBlock extends AgentComposerFileBlockBase {
     kind: "file";
@@ -2146,6 +2153,34 @@ interface AgentGUINodeViewModel {
     operations: AgentGUIOperationsViewModel;
 }
 
+interface AgentPreparedExternalPromptFileMetadata {
+    assetId?: string;
+    mimeType?: string;
+    name: string;
+    sizeBytes?: number;
+    uploadStatus?: string;
+    uri?: string;
+}
+type AgentPreparedExternalPromptFile = AgentPreparedExternalPromptFileMetadata & ({
+    path: string;
+    url?: string;
+} | {
+    path?: string;
+    url: string;
+});
+type AgentExternalPromptFilePreparationErrorCode = "file_too_large" | "folder_unsupported" | "preparation_failed";
+type AgentExternalPromptFilePreparationResult = {
+    sourceIndex: number;
+    status: "prepared";
+    file: AgentPreparedExternalPromptFile;
+} | {
+    sourceIndex: number;
+    status: "error";
+    errorCode: AgentExternalPromptFilePreparationErrorCode;
+    retryable?: boolean;
+};
+type AgentExternalPromptFilePreparer = (files: readonly File[]) => Promise<readonly AgentExternalPromptFilePreparationResult[]>;
+
 interface AgentProjectPathChangeMetadata {
     action: WorkspaceUserProjectSelectChangeAction;
     project?: WorkspaceUserProject;
@@ -2452,7 +2487,8 @@ interface AgentComposerProps {
     }) => void;
     onLinkAction?: (action: WorkspaceLinkAction) => void;
     onRequestWorkspaceReferences?: ((entity?: AgentContextMentionItem | null) => Promise<WorkspaceReferencePickResult>) | null;
-    resolveDroppedFileReferences?: AgentDroppedFileReferenceResolver | null;
+    prepareExternalPromptFiles?: AgentExternalPromptFilePreparer | null;
+    promptAssetLimit?: number | null;
     selectProjectDirectory?: () => Promise<{
         path: string;
     } | null>;
@@ -2621,7 +2657,8 @@ interface AgentGUINodeWorkspace {
     selectProjectDirectory?: () => Promise<{
         path: string;
     } | null>;
-    resolveDroppedFileReferences?: AgentComposerProps["resolveDroppedFileReferences"];
+    prepareExternalPromptFiles?: AgentComposerProps["prepareExternalPromptFiles"];
+    promptAssetLimit?: number | null;
     referenceSourceAggregator?: ReferenceSourceAggregator | null;
     resolveReferenceEntryIconUrl?: (entry: WorkspaceFileEntry) => Promise<string | null | undefined>;
     resolveMentionReferenceTarget?: AgentMentionReferenceTargetResolver | null;
@@ -3089,6 +3126,9 @@ declare const agentGuiI18nResources: {
                 readonly fileMentionError: "Unable to search Files.";
                 readonly fileMentionTabHint: "Tab switch category | ←→ enter/leave folder | ↑↓ switch selection";
                 readonly fileDropHint: "Drop files to add them to the session";
+                readonly composerFileFolderUnsupported: "Folders cannot be attached here";
+                readonly composerFileTooLarge: "File is too large";
+                readonly composerFilePreparationFailed: "File preparation failed";
                 readonly mentionPalette: "Mention context";
                 readonly addReference: "Add reference";
                 readonly addContent: "Add files and more";
@@ -5673,6 +5713,9 @@ declare const agentGuiI18nResources: {
                 readonly fileMentionError: "无法搜索工作区文件。";
                 readonly fileMentionTabHint: "Tab 切换分类 ｜ ←→ 进入/返回文件夹 ｜ ↑↓ 切换选中";
                 readonly fileDropHint: "拖放文件以添加到会话";
+                readonly composerFileFolderUnsupported: "暂不支持在这里附加文件夹";
+                readonly composerFileTooLarge: "文件过大";
+                readonly composerFilePreparationFailed: "文件处理失败";
                 readonly mentionPalette: "提及上下文";
                 readonly addReference: "添加引用";
                 readonly addContent: "添加文件等内容";
@@ -7945,6 +7988,7 @@ declare function createSharedAgentGUIAgentTarget(input: {
     badge?: AgentGUIAgentTargetBadge | null;
     ownerLabel?: string | null;
     iconUrl?: string | null;
+    maskIconUrl?: string | null;
     sidebarIconUrl?: string | null;
     unavailableReason?: string | null;
     disabled?: boolean;
@@ -8044,4 +8088,4 @@ declare function dispatchAgentPlanPromptAction(input: {
     workspaceId: string;
 }): boolean;
 
-export { AGENT_CONTEXT_MENTION_PROVIDER_IDS, AGENT_GUI_DETAIL_MIN_WIDTH_PX, AGENT_GUI_EXPANDED_TARGET_WIDTH_PX, AGENT_GUI_STANDALONE_AUTO_COLLAPSE_WIDTH_PX, AGENT_PASTED_TEXT_BLOCK_KIND, AGENT_PASTED_TEXT_MENTION_KIND, AgentActivityHostProvider, type AgentActivityHostProviderProps, type AgentActivityRuntime, type AgentActivityRuntimeDeleteSessionsBatchInput, type AgentActivityRuntimeDeleteSessionsBatchResult, type AgentActivityRuntimeListSessionMessagesInput, type AgentActivityRuntimePromptContentBlock, AgentActivityRuntimeProvider, type AgentActivityRuntimeProviderProps, type AgentActivityRuntimeSessionSectionDeletionCandidates, type AgentActivityRuntimeSessionSectionScopeInput, type AgentActivityRuntimeSetSessionPinnedInput, type AgentActivityRuntimeUpdateSessionSettingsInput, type AgentActivityRuntimeUpdateSessionSettingsResult, type AgentActivityRuntimeUploadPromptContentInput, type AgentActivityRuntimeUploadPromptContentResult, type AgentComposerDraftFile, type AgentContextMentionProvider, type AgentContextMentionProviderId, type AgentCustomMentionChipContext, type AgentCustomMentionIdentity, type AgentCustomMentionKindDefinition, type AgentCustomMentionPresentation, AgentGUI, type AgentGUIAccountMenuState, type AgentGUIAgent, type AgentGUIAgentAvailability, type AgentGUIAgentAvailabilityAction, type AgentGUIAgentAvailabilityStatus, type AgentGUIAgentDirectoryPort, type AgentGUIAgentDirectorySnapshot, type AgentGUIAgentDirectoryStatus, type AgentGUIAgentOwner, type AgentGUIAgentOwnership, type AgentGUIAgentTarget, type AgentGUIAgentTargetBadge, type AgentGUIAgentTargetRef, type AgentGUIAgentsEmptyRenderer, type AgentGUIAllAgentsPresentation, type AgentGUIComposerAppendRequest, type AgentGUIComposerContentType, type AgentGUIComposerFocusMethod, type AgentGUIEngagementContext, type AgentGUIEngagementEvent, type AgentGUIEngagementEventSink, type AgentGUIHomeSuggestionId, type AgentGUIProps, type AgentGUIProvider, type AgentGUIProviderRailAllPresentation, type AgentGUIProviderRailMode, type AgentGUIProviderReadinessGate, type AgentGUIProviderReadinessGateAction, type AgentGUIProviderReadinessGateStatus, type AgentGUIProviderUnavailableStateContext, type AgentGUIProviderUnavailableStateRenderer, type AgentGUISidebarFooterContext, type AgentGUISidebarFooterRenderer, type AgentGuiI18nLocale, AgentGuiI18nProvider, type AgentHostAgentTargetAuthenticatedAccount, type AgentHostAgentTargetSetupSnapshot, type AgentHostAgentTargetSetupState, type AgentHostAgentTargetSetupWatch, type AgentHostApi, type AgentHostApplyWorkspaceGitPatchInput, type AgentHostInputApi, type AgentHostRuntimeApi, type AgentHostSelectFilesInput, type AgentHostUserProject, type AgentPlanPromptAction, type AgentProbeProvider, type AgentProbeSnapshot, type AgentProviderProbeListInput, type AgentProviderProbeListResult, type AgentUsageQuota, type AgentUsageSnapshot, type EngineStateStore, type PersistWriteResult, type ReadWorkspaceAgentReadStateInput, type WorkspaceAgentReadStateSnapshot, type WriteWorkspaceAgentReadStateInput, agentGUIAgentIsReady, agentGUIDefaultTargetProviders, agentGuiDockIconUrl, agentGuiDockIconUrls, agentGuiI18nModule, agentGuiI18nResources, createLocalAgentGUIAgentTarget, createLocalAgentGUIAgentTargets, createSharedAgentGUIAgentTarget, dispatchAgentPlanPromptAction, getAgentCustomMentionKind, localAgentGUIAgentTargetId, normalizeAgentGUIAgentTargets, normalizeAgentGUIAgents, preloadAgentMentionBrowse, registerAgentCustomMentionKind, resetAgentActivityRuntimeForTests, resetAgentCustomMentionKindsForTests, resolveAgentGUIAgentTarget, resolveAgentGUIExpandedWindowFrame, resolveAgentGUISelectedDirectoryAgent, selectAgentPlanPromptTurn, setAgentActivityRuntimeForTests, shouldAutoCollapseAgentGUIConversationRail, useAgentActivityRuntime, useAgentActivitySnapshot, useEngineSelector, useOptionalAgentActivityRuntime };
+export { AGENT_CONTEXT_MENTION_PROVIDER_IDS, AGENT_GUI_DETAIL_MIN_WIDTH_PX, AGENT_GUI_EXPANDED_TARGET_WIDTH_PX, AGENT_GUI_STANDALONE_AUTO_COLLAPSE_WIDTH_PX, AGENT_PASTED_TEXT_BLOCK_KIND, AGENT_PASTED_TEXT_MENTION_KIND, AgentActivityHostProvider, type AgentActivityHostProviderProps, type AgentActivityRuntime, type AgentActivityRuntimeDeleteSessionsBatchInput, type AgentActivityRuntimeDeleteSessionsBatchResult, type AgentActivityRuntimeListSessionMessagesInput, type AgentActivityRuntimePromptContentBlock, AgentActivityRuntimeProvider, type AgentActivityRuntimeProviderProps, type AgentActivityRuntimeSessionSectionDeletionCandidates, type AgentActivityRuntimeSessionSectionScopeInput, type AgentActivityRuntimeSetSessionPinnedInput, type AgentActivityRuntimeUpdateSessionSettingsInput, type AgentActivityRuntimeUpdateSessionSettingsResult, type AgentActivityRuntimeUploadPromptContentInput, type AgentActivityRuntimeUploadPromptContentResult, type AgentComposerDraftFile, type AgentContextMentionProvider, type AgentContextMentionProviderId, type AgentCustomMentionChipContext, type AgentCustomMentionIdentity, type AgentCustomMentionKindDefinition, type AgentCustomMentionPresentation, type AgentExternalPromptFilePreparationErrorCode, type AgentExternalPromptFilePreparationResult, type AgentExternalPromptFilePreparer, AgentGUI, type AgentGUIAccountMenuState, type AgentGUIAgent, type AgentGUIAgentAvailability, type AgentGUIAgentAvailabilityAction, type AgentGUIAgentAvailabilityStatus, type AgentGUIAgentDirectoryPort, type AgentGUIAgentDirectorySnapshot, type AgentGUIAgentDirectoryStatus, type AgentGUIAgentOwner, type AgentGUIAgentOwnership, type AgentGUIAgentTarget, type AgentGUIAgentTargetBadge, type AgentGUIAgentTargetRef, type AgentGUIAgentsEmptyRenderer, type AgentGUIAllAgentsPresentation, type AgentGUIComposerAppendRequest, type AgentGUIComposerContentType, type AgentGUIComposerFocusMethod, type AgentGUIEngagementContext, type AgentGUIEngagementEvent, type AgentGUIEngagementEventSink, type AgentGUIHomeSuggestionId, type AgentGUIProps, type AgentGUIProvider, type AgentGUIProviderRailAllPresentation, type AgentGUIProviderRailMode, type AgentGUIProviderReadinessGate, type AgentGUIProviderReadinessGateAction, type AgentGUIProviderReadinessGateStatus, type AgentGUIProviderUnavailableStateContext, type AgentGUIProviderUnavailableStateRenderer, type AgentGUISidebarFooterContext, type AgentGUISidebarFooterRenderer, type AgentGuiI18nLocale, AgentGuiI18nProvider, type AgentHostAgentTargetAuthenticatedAccount, type AgentHostAgentTargetSetupSnapshot, type AgentHostAgentTargetSetupState, type AgentHostAgentTargetSetupWatch, type AgentHostApi, type AgentHostApplyWorkspaceGitPatchInput, type AgentHostInputApi, type AgentHostRuntimeApi, type AgentHostSelectFilesInput, type AgentHostUserProject, type AgentPlanPromptAction, type AgentPreparedExternalPromptFile, type AgentProbeProvider, type AgentProbeSnapshot, type AgentProviderProbeListInput, type AgentProviderProbeListResult, type AgentUsageQuota, type AgentUsageSnapshot, type EngineStateStore, type PersistWriteResult, type ReadWorkspaceAgentReadStateInput, type WorkspaceAgentReadStateSnapshot, type WriteWorkspaceAgentReadStateInput, agentGUIAgentIsReady, agentGUIDefaultTargetProviders, agentGuiDockIconUrl, agentGuiDockIconUrls, agentGuiI18nModule, agentGuiI18nResources, createLocalAgentGUIAgentTarget, createLocalAgentGUIAgentTargets, createSharedAgentGUIAgentTarget, dispatchAgentPlanPromptAction, getAgentCustomMentionKind, localAgentGUIAgentTargetId, normalizeAgentGUIAgentTargets, normalizeAgentGUIAgents, preloadAgentMentionBrowse, registerAgentCustomMentionKind, resetAgentActivityRuntimeForTests, resetAgentCustomMentionKindsForTests, resolveAgentGUIAgentTarget, resolveAgentGUIExpandedWindowFrame, resolveAgentGUISelectedDirectoryAgent, selectAgentPlanPromptTurn, setAgentActivityRuntimeForTests, shouldAutoCollapseAgentGUIConversationRail, useAgentActivityRuntime, useAgentActivitySnapshot, useEngineSelector, useOptionalAgentActivityRuntime };

package/dist/index.js

@@ -7,7 +7,7 @@ import {
   localAgentGUIAgentTargetId,
   normalizeAgentGUIAgentTargets,
   resolveAgentGUIAgentTarget
-} from "./chunk-IZ626FDO.js";
+} from "./chunk-Y5HD6XHP.js";
 import "./chunk-A4WCTHWS.js";
 import {
   AGENT_GUI_DETAIL_MIN_WIDTH_PX,
@@ -15,51 +15,51 @@ import {
   AGENT_GUI_STANDALONE_AUTO_COLLAPSE_WIDTH_PX,
   resolveAgentGUIExpandedWindowFrame,
   shouldAutoCollapseAgentGUIConversationRail
-} from "./chunk-HCRROERX.js";
+} from "./chunk-IN3HXYOO.js";
 import "./chunk-TUWQV2MC.js";
 import "./chunk-MHOYBRCY.js";
-import "./chunk-PVTAFUDS.js";
+import "./chunk-VGS7S7YT.js";
 import "./chunk-5HIF53K5.js";
 import "./chunk-R2ZADXRB.js";
-import "./chunk-A6NSHCRP.js";
-import "./chunk-XNE2ROCP.js";
+import "./chunk-JI5KND3K.js";
+import "./chunk-UA75CGAG.js";
 import "./chunk-FM42UN2J.js";
 import "./chunk-UP3ZDYTN.js";
-import "./chunk-UARZZJJB.js";
+import "./chunk-OI6BYC7P.js";
 import {
   agentGUIAgentIsReady,
   normalizeAgentGUIAgents,
   resolveAgentGUISelectedDirectoryAgent
-} from "./chunk-VS5BRBY6.js";
-import {
-  AGENT_PASTED_TEXT_BLOCK_KIND,
-  AGENT_PASTED_TEXT_MENTION_KIND
-} from "./chunk-FGLQZ6I4.js";
+} from "./chunk-5WOCGIXJ.js";
 import {
   agentGuiDockIconUrl,
   agentGuiDockIconUrls
 } from "./chunk-DXT4W2SU.js";
 import {
   preloadAgentMentionBrowse
-} from "./chunk-J4TTEMRW.js";
+} from "./chunk-KWGMK4IZ.js";
 import "./chunk-USIFGHT3.js";
 import "./chunk-XJ34OIEQ.js";
 import "./chunk-R7AXDQCA.js";
-import "./chunk-OBWM2RFE.js";
+import "./chunk-QPEO4OQS.js";
 import "./chunk-5QPOMKMQ.js";
 import {
   AGENT_CONTEXT_MENTION_PROVIDER_IDS
 } from "./chunk-RMQREVJY.js";
+import {
+  AGENT_PASTED_TEXT_BLOCK_KIND,
+  AGENT_PASTED_TEXT_MENTION_KIND
+} from "./chunk-FGLQZ6I4.js";
 import {
   dispatchAgentPlanPromptAction,
   selectAgentPlanPromptTurn
-} from "./chunk-GBBNYGL7.js";
+} from "./chunk-25VMCMAQ.js";
 import {
   useEngineSelector
 } from "./chunk-2RQM7PJN.js";
-import "./chunk-N62NVPHT.js";
-import "./chunk-KPMQGPYU.js";
-import "./chunk-QQRTUHCH.js";
+import "./chunk-IYZ4GOSN.js";
+import "./chunk-ZVYUTXQJ.js";
+import "./chunk-EU7DCT4F.js";
 import "./chunk-YMXYBG7U.js";
 import {
   AgentActivityHostProvider,
@@ -69,17 +69,17 @@ import {
   useAgentActivityRuntime,
   useAgentActivitySnapshot,
   useOptionalAgentActivityRuntime
-} from "./chunk-NE6H7S5Z.js";
+} from "./chunk-OFJNIQWR.js";
 import "./chunk-F5UR6EJG.js";
 import "./chunk-EDNJMG5T.js";
 import {
   AgentGuiI18nProvider,
   agentGuiI18nModule,
   agentGuiI18nResources
-} from "./chunk-SZOTLVH6.js";
+} from "./chunk-GIYGO2PB.js";
 import "./chunk-PJP5BUU6.js";
 import "./chunk-7KVZPJ3O.js";
-import "./chunk-OQR3HXPF.js";
+import "./chunk-VUNVGEQG.js";
 import "./chunk-MIJXEELH.js";
 import {
   getAgentCustomMentionKind,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../index.ts"],"sourcesContent":["export {\n  getAgentCustomMentionKind,\n  registerAgentCustomMentionKind,\n  resetAgentCustomMentionKindsForTests,\n  type AgentCustomMentionChipContext,\n  type AgentCustomMentionIdentity,\n  type AgentCustomMentionKindDefinition,\n  type AgentCustomMentionPresentation\n} from \"./shared/agentCustomMentionKinds\";\nexport {\n  AGENT_PASTED_TEXT_BLOCK_KIND,\n  AGENT_PASTED_TEXT_MENTION_KIND\n} from \"./shared/pastedTextKinds\";\nexport { AgentGUI } from \"./AgentGUI\";\nexport type {\n  AgentGUIProps,\n  AgentGUIReferenceProvenanceFilterCatalog\n} from \"./AgentGUI\";\nexport type { AgentGUIComposerAppendRequest } from \"./agent-gui/agentGuiNode/controller/useAgentGUIComposerAppendRequest\";\nexport type { AgentComposerDraftFile } from \"./agent-gui/agentGuiNode/model/agentGuiNodeTypes\";\nexport type { AgentGUIAccountMenuState } from \"./agent-gui/agentGuiNode/accountMenuState\";\nexport type {\n  AgentGUIComposerContentType,\n  AgentGUIComposerFocusMethod,\n  AgentGUIEngagementContext,\n  AgentGUIEngagementEvent,\n  AgentGUIEngagementEventSink\n} from \"./agent-gui/agentGuiNode/engagement/agentGUIEngagement.types\";\nexport {\n  agentGUIAgentIsReady,\n  normalizeAgentGUIAgents,\n  resolveAgentGUISelectedDirectoryAgent\n} from \"./agents\";\nexport {\n  agentGUIDefaultTargetProviders,\n  createLocalAgentGUIAgentTarget,\n  createLocalAgentGUIAgentTargets,\n  createSharedAgentGUIAgentTarget,\n  localAgentGUIAgentTargetId,\n  normalizeAgentGUIAgentTargets,\n  resolveAgentGUIAgentTarget\n} from \"./agentTargets\";\nexport type {\n  AgentGUIAgent,\n  AgentGUIAgentDirectoryPort,\n  AgentGUIAgentDirectorySnapshot,\n  AgentGUIAgentDirectoryStatus,\n  AgentGUIAgentAvailability,\n  AgentGUIAgentAvailabilityAction,\n  AgentGUIAgentAvailabilityStatus,\n  AgentGUIAgentOwner,\n  AgentGUIAgentOwnership,\n  AgentGUIHomeSuggestionId,\n  AgentGUIAllAgentsPresentation,\n  AgentGUIProvider,\n  AgentGUIProviderRailAllPresentation,\n  AgentGUIProviderRailMode,\n  AgentGUIProviderReadinessGate,\n  AgentGUIProviderReadinessGateAction,\n  AgentGUIProviderReadinessGateStatus,\n  AgentGUIAgentTarget,\n  AgentGUIAgentTargetBadge,\n  AgentGUIAgentTargetRef\n} from \"./types\";\nexport {\n  AgentGuiI18nProvider,\n  agentGuiI18nModule,\n  agentGuiI18nResources\n} from \"./i18n/index\";\nexport type { AgentGuiI18nLocale } from \"./i18n/index\";\nexport { agentGuiDockIconUrl, agentGuiDockIconUrls } from \"./dockIcons\";\nexport {\n  AGENT_GUI_DETAIL_MIN_WIDTH_PX,\n  AGENT_GUI_EXPANDED_TARGET_WIDTH_PX,\n  AGENT_GUI_STANDALONE_AUTO_COLLAPSE_WIDTH_PX,\n  resolveAgentGUIExpandedWindowFrame,\n  shouldAutoCollapseAgentGUIConversationRail\n} from \"./agent-gui/agentGuiNode/model/agentGuiRailLayout\";\nexport type {\n  AgentGUIAgentsEmptyRenderer,\n  AgentGUIProviderUnavailableStateContext,\n  AgentGUIProviderUnavailableStateRenderer,\n  AgentGUISidebarFooterContext,\n  AgentGUISidebarFooterRenderer\n} from \"./agent-gui/agentGuiNode/AgentGUINodeView\";\nexport {\n  AGENT_CONTEXT_MENTION_PROVIDER_IDS,\n  type AgentContextMentionProviderId,\n  type AgentContextMentionProvider\n} from \"./agent-gui/agentGuiNode/agentContextMentionProvider\";\nexport { preloadAgentMentionBrowse } from \"./agent-gui/agentGuiNode/AgentMentionSearchController\";\nexport { AgentActivityHostProvider } from \"./agentActivityHost\";\nexport type { AgentActivityHostProviderProps } from \"./agentActivityHost\";\nexport { useEngineSelector } from \"./shared/engine/useEngineSelector\";\nexport type { EngineStateStore } from \"./shared/engine/useEngineSelector\";\nexport {\n  dispatchAgentPlanPromptAction,\n  selectAgentPlanPromptTurn\n} from \"./shared/agentConversation/agentPlanPromptDispatch\";\nexport type { AgentPlanPromptAction } from \"./shared/agentConversation/agentPlanPromptDispatch\";\nexport {\n  AgentActivityRuntimeProvider,\n  resetAgentActivityRuntimeForTests,\n  setAgentActivityRuntimeForTests,\n  useAgentActivitySnapshot,\n  useAgentActivityRuntime,\n  useOptionalAgentActivityRuntime\n} from \"./agentActivityRuntime\";\nexport type {\n  AgentActivityRuntime,\n  AgentActivityRuntimeListSessionMessagesInput,\n  AgentActivityRuntimeProviderProps,\n  AgentActivityRuntimePromptContentBlock,\n  AgentActivityRuntimeDeleteSessionsBatchInput,\n  AgentActivityRuntimeDeleteSessionsBatchResult,\n  AgentActivityRuntimeSessionSectionDeletionCandidates,\n  AgentActivityRuntimeSessionSectionScopeInput,\n  AgentActivityRuntimeSetSessionPinnedInput,\n  AgentActivityRuntimeUploadPromptContentInput,\n  AgentActivityRuntimeUploadPromptContentResult,\n  AgentActivityRuntimeUpdateSessionSettingsInput,\n  AgentActivityRuntimeUpdateSessionSettingsResult\n} from \"./agentActivityRuntime\";\nexport type {\n  AgentHostApi,\n  AgentHostAgentTargetAuthenticatedAccount,\n  AgentHostAgentTargetSetupSnapshot,\n  AgentHostAgentTargetSetupState,\n  AgentHostAgentTargetSetupWatch,\n  AgentHostApplyWorkspaceGitPatchInput,\n  AgentHostInputApi,\n  AgentHostSelectFilesInput,\n  AgentHostRuntimeApi,\n  AgentHostUserProject,\n  AgentProviderProbeListInput,\n  AgentProviderProbeListResult\n} from \"./host/agentHostApi\";\nexport type {\n  AgentProbeProvider,\n  AgentProbeSnapshot,\n  PersistWriteResult,\n  ReadWorkspaceAgentReadStateInput,\n  AgentUsageQuota,\n  AgentUsageSnapshot,\n  WorkspaceAgentReadStateSnapshot,\n  WriteWorkspaceAgentReadStateInput\n} from \"./shared/contracts/dto\";\nexport {\n  selectNeedsAttentionCount,\n  selectNeedsAttentionItems\n} from \"@tutti-os/agent-activity-core\";\nexport type {\n  AgentActivityAdapter,\n  AgentActivityMessage,\n  AgentActivityNeedsAttentionItem,\n  AgentActivitySnapshot\n} from \"@tutti-os/agent-activity-core\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmJA;AAAA,EACE;AAAA,EACA;AAAA,OACK;","names":[]}
+{"version":3,"sources":["../index.ts"],"sourcesContent":["export {\n  getAgentCustomMentionKind,\n  registerAgentCustomMentionKind,\n  resetAgentCustomMentionKindsForTests,\n  type AgentCustomMentionChipContext,\n  type AgentCustomMentionIdentity,\n  type AgentCustomMentionKindDefinition,\n  type AgentCustomMentionPresentation\n} from \"./shared/agentCustomMentionKinds\";\nexport {\n  AGENT_PASTED_TEXT_BLOCK_KIND,\n  AGENT_PASTED_TEXT_MENTION_KIND\n} from \"./shared/pastedTextKinds\";\nexport { AgentGUI } from \"./AgentGUI\";\nexport type {\n  AgentGUIProps,\n  AgentGUIReferenceProvenanceFilterCatalog\n} from \"./AgentGUI\";\nexport type { AgentGUIComposerAppendRequest } from \"./agent-gui/agentGuiNode/controller/useAgentGUIComposerAppendRequest\";\nexport type { AgentComposerDraftFile } from \"./agent-gui/agentGuiNode/model/agentGuiNodeTypes\";\nexport type {\n  AgentExternalPromptFilePreparationErrorCode,\n  AgentExternalPromptFilePreparationResult,\n  AgentExternalPromptFilePreparer,\n  AgentPreparedExternalPromptFile\n} from \"./agent-gui/agentGuiNode/model/agentExternalPromptFiles\";\nexport type { AgentGUIAccountMenuState } from \"./agent-gui/agentGuiNode/accountMenuState\";\nexport type {\n  AgentGUIComposerContentType,\n  AgentGUIComposerFocusMethod,\n  AgentGUIEngagementContext,\n  AgentGUIEngagementEvent,\n  AgentGUIEngagementEventSink\n} from \"./agent-gui/agentGuiNode/engagement/agentGUIEngagement.types\";\nexport {\n  agentGUIAgentIsReady,\n  normalizeAgentGUIAgents,\n  resolveAgentGUISelectedDirectoryAgent\n} from \"./agents\";\nexport {\n  agentGUIDefaultTargetProviders,\n  createLocalAgentGUIAgentTarget,\n  createLocalAgentGUIAgentTargets,\n  createSharedAgentGUIAgentTarget,\n  localAgentGUIAgentTargetId,\n  normalizeAgentGUIAgentTargets,\n  resolveAgentGUIAgentTarget\n} from \"./agentTargets\";\nexport type {\n  AgentGUIAgent,\n  AgentGUIAgentDirectoryPort,\n  AgentGUIAgentDirectorySnapshot,\n  AgentGUIAgentDirectoryStatus,\n  AgentGUIAgentAvailability,\n  AgentGUIAgentAvailabilityAction,\n  AgentGUIAgentAvailabilityStatus,\n  AgentGUIAgentOwner,\n  AgentGUIAgentOwnership,\n  AgentGUIHomeSuggestionId,\n  AgentGUIAllAgentsPresentation,\n  AgentGUIProvider,\n  AgentGUIProviderRailAllPresentation,\n  AgentGUIProviderRailMode,\n  AgentGUIProviderReadinessGate,\n  AgentGUIProviderReadinessGateAction,\n  AgentGUIProviderReadinessGateStatus,\n  AgentGUIAgentTarget,\n  AgentGUIAgentTargetBadge,\n  AgentGUIAgentTargetRef\n} from \"./types\";\nexport {\n  AgentGuiI18nProvider,\n  agentGuiI18nModule,\n  agentGuiI18nResources\n} from \"./i18n/index\";\nexport type { AgentGuiI18nLocale } from \"./i18n/index\";\nexport { agentGuiDockIconUrl, agentGuiDockIconUrls } from \"./dockIcons\";\nexport {\n  AGENT_GUI_DETAIL_MIN_WIDTH_PX,\n  AGENT_GUI_EXPANDED_TARGET_WIDTH_PX,\n  AGENT_GUI_STANDALONE_AUTO_COLLAPSE_WIDTH_PX,\n  resolveAgentGUIExpandedWindowFrame,\n  shouldAutoCollapseAgentGUIConversationRail\n} from \"./agent-gui/agentGuiNode/model/agentGuiRailLayout\";\nexport type {\n  AgentGUIAgentsEmptyRenderer,\n  AgentGUIProviderUnavailableStateContext,\n  AgentGUIProviderUnavailableStateRenderer,\n  AgentGUISidebarFooterContext,\n  AgentGUISidebarFooterRenderer\n} from \"./agent-gui/agentGuiNode/AgentGUINodeView\";\nexport {\n  AGENT_CONTEXT_MENTION_PROVIDER_IDS,\n  type AgentContextMentionProviderId,\n  type AgentContextMentionProvider\n} from \"./agent-gui/agentGuiNode/agentContextMentionProvider\";\nexport { preloadAgentMentionBrowse } from \"./agent-gui/agentGuiNode/AgentMentionSearchController\";\nexport { AgentActivityHostProvider } from \"./agentActivityHost\";\nexport type { AgentActivityHostProviderProps } from \"./agentActivityHost\";\nexport { useEngineSelector } from \"./shared/engine/useEngineSelector\";\nexport type { EngineStateStore } from \"./shared/engine/useEngineSelector\";\nexport {\n  dispatchAgentPlanPromptAction,\n  selectAgentPlanPromptTurn\n} from \"./shared/agentConversation/agentPlanPromptDispatch\";\nexport type { AgentPlanPromptAction } from \"./shared/agentConversation/agentPlanPromptDispatch\";\nexport {\n  AgentActivityRuntimeProvider,\n  resetAgentActivityRuntimeForTests,\n  setAgentActivityRuntimeForTests,\n  useAgentActivitySnapshot,\n  useAgentActivityRuntime,\n  useOptionalAgentActivityRuntime\n} from \"./agentActivityRuntime\";\nexport type {\n  AgentActivityRuntime,\n  AgentActivityRuntimeListSessionMessagesInput,\n  AgentActivityRuntimeProviderProps,\n  AgentActivityRuntimePromptContentBlock,\n  AgentActivityRuntimeDeleteSessionsBatchInput,\n  AgentActivityRuntimeDeleteSessionsBatchResult,\n  AgentActivityRuntimeSessionSectionDeletionCandidates,\n  AgentActivityRuntimeSessionSectionScopeInput,\n  AgentActivityRuntimeSetSessionPinnedInput,\n  AgentActivityRuntimeUploadPromptContentInput,\n  AgentActivityRuntimeUploadPromptContentResult,\n  AgentActivityRuntimeUpdateSessionSettingsInput,\n  AgentActivityRuntimeUpdateSessionSettingsResult\n} from \"./agentActivityRuntime\";\nexport type {\n  AgentHostApi,\n  AgentHostAgentTargetAuthenticatedAccount,\n  AgentHostAgentTargetSetupSnapshot,\n  AgentHostAgentTargetSetupState,\n  AgentHostAgentTargetSetupWatch,\n  AgentHostApplyWorkspaceGitPatchInput,\n  AgentHostInputApi,\n  AgentHostSelectFilesInput,\n  AgentHostRuntimeApi,\n  AgentHostUserProject,\n  AgentProviderProbeListInput,\n  AgentProviderProbeListResult\n} from \"./host/agentHostApi\";\nexport type {\n  AgentProbeProvider,\n  AgentProbeSnapshot,\n  PersistWriteResult,\n  ReadWorkspaceAgentReadStateInput,\n  AgentUsageQuota,\n  AgentUsageSnapshot,\n  WorkspaceAgentReadStateSnapshot,\n  WriteWorkspaceAgentReadStateInput\n} from \"./shared/contracts/dto\";\nexport {\n  selectNeedsAttentionCount,\n  selectNeedsAttentionItems\n} from \"@tutti-os/agent-activity-core\";\nexport type {\n  AgentActivityAdapter,\n  AgentActivityMessage,\n  AgentActivityNeedsAttentionItem,\n  AgentActivitySnapshot\n} from \"@tutti-os/agent-activity-core\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyJA;AAAA,EACE;AAAA,EACA;AAAA,OACK;","names":[]}

package/dist/mention-search.d.ts

@@ -1,4 +1,4 @@
-import { A as AgentContextMentionItem } from './agentFileMentionContracts-CWAeuL7S.js';
+import { A as AgentContextMentionItem } from './agentFileMentionContracts-B0yQizXB.js';
 import { AgentContextMentionProvider } from './context-mention-provider.js';
 import { MentionPaletteGroup, MentionPaletteState } from '@tutti-os/ui-rich-text/at-panel';
 import { ReferenceProvenanceFilter, ReferenceProvenanceCatalog } from '@tutti-os/workspace-file-reference/contracts';

package/dist/mention-search.js

@@ -3,21 +3,22 @@ import {
   MAX_BROWSE_CACHE_ENTRIES,
   preloadAgentMentionBrowse,
   resetAgentMentionSearchBrowseCacheForTests
-} from "./chunk-J4TTEMRW.js";
+} from "./chunk-KWGMK4IZ.js";
 import "./chunk-USIFGHT3.js";
 import "./chunk-XJ34OIEQ.js";
 import "./chunk-R7AXDQCA.js";
-import "./chunk-OBWM2RFE.js";
+import "./chunk-QPEO4OQS.js";
 import "./chunk-5QPOMKMQ.js";
 import "./chunk-RMQREVJY.js";
+import "./chunk-FGLQZ6I4.js";
 import "./chunk-YMXYBG7U.js";
-import "./chunk-NE6H7S5Z.js";
+import "./chunk-OFJNIQWR.js";
 import "./chunk-F5UR6EJG.js";
 import "./chunk-EDNJMG5T.js";
-import "./chunk-SZOTLVH6.js";
+import "./chunk-GIYGO2PB.js";
 import "./chunk-PJP5BUU6.js";
 import "./chunk-7KVZPJ3O.js";
-import "./chunk-OQR3HXPF.js";
+import "./chunk-VUNVGEQG.js";
 import "./chunk-MIJXEELH.js";
 import "./chunk-D2JUDUYY.js";
 import "./chunk-6CUELYIF.js";

package/dist/{types-BeAVr4of.d.ts → types-ee3zJ6Cc.d.ts}

@@ -96,6 +96,8 @@ interface AgentGUIAgent {
     agentTargetId: string;
     name: string;
     iconUrl: string;
+    /** Single-color artwork rendered through the conversation rail CSS mask. */
+    maskIconUrl?: string | null;
     sidebarIconUrl?: string | null;
     heroImageUrl?: string | null;
     description?: string | null;
@@ -132,6 +134,7 @@ interface AgentGUIAgentTarget {
     label: string;
     description?: string;
     iconUrl?: string | null;
+    maskIconUrl?: string | null;
     sidebarIconUrl?: string | null;
     heroImageUrl?: string | null;
     badge?: AgentGUIAgentTargetBadge | null;

package/dist/workbench/browser-element-context/index.d.ts

@@ -0,0 +1,37 @@
+import { ReactNode } from 'react';
+
+interface BrowserElementContextCopy {
+    cancel: string;
+    failed: string;
+    select: string;
+}
+declare function BrowserElementContextAction({ copy, onAppendMention, onError, workspaceId }: {
+    copy: BrowserElementContextCopy;
+    onAppendMention: (mention: string) => void;
+    onError: (message: string) => void;
+    workspaceId: string;
+}): ReactNode;
+
+declare const browserElementMentionKind = "browser-element";
+interface BrowserElementMentionReference {
+    context: string;
+    id: string;
+    tagName: string;
+    workspaceId: string;
+}
+interface BrowserElementMentionIdentity {
+    label: string;
+    scope?: Readonly<Record<string, string>>;
+}
+interface BrowserElementMentionPresentation {
+    name: string;
+    workspaceId?: string;
+}
+declare function createBrowserElementMentionMarkdown(reference: BrowserElementMentionReference): string;
+declare function browserElementMentionLabel(tagName: string): string;
+declare function presentBrowserElementMention(mention: BrowserElementMentionIdentity): BrowserElementMentionPresentation | null;
+
+/** Registers browser DOM references before the first AgentGUI surface mounts. */
+declare function registerBrowserElementMention(): void;
+
+export { BrowserElementContextAction, type BrowserElementContextCopy, type BrowserElementMentionIdentity, type BrowserElementMentionPresentation, type BrowserElementMentionReference, browserElementMentionKind, browserElementMentionLabel, createBrowserElementMentionMarkdown, presentBrowserElementMention, registerBrowserElementMention };