@tutti-os/agent-gui 0.0.132 → 0.0.133

package/dist/agent-gui.d.ts

@@ -1,24 +1,1094 @@
-import 'react';
-import '@tutti-os/ui-i18n-runtime';
-export { n as AgentGUI, w as AgentGUIProps } from './AgentGUI-DxypmD7b.js';
-import './agentGuiNodeTypes-5TL1hyCN.js';
-export { m as AgentGUIHomeSuggestionId } from './types-BicfRVrV.js';
+import * as react from 'react';
+import { ReactNode } from 'react';
+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 { k as AgentHostAgentSessionComposerSettings, o as AgentHostUnactivateAgentSessionResult, b as AgentGUIAgentTarget, f as AgentGUIProvider, p as AgentPromptContentBlock, e as AgentGUINodeData, P as Point, g as AgentGUIProviderRailAllPresentation, h as AgentGUIProviderRailMode, i as AgentGUIProviderReadinessGate, d as AgentGUIHomeSuggestionId, N as NodeFrame, a as AgentGUIAgentDirectorySnapshot, c as AgentGUIAllAgentsPresentation } from './types-BeAVr4of.js';
+import { A as AgentComposerDraft, j as AgentSessionCommand, d as AgentGUIProviderSkillOption, b as AgentGUIComposerSettingsVM, e as AgentGUIQueueStatus, f as AgentGUIQueuedPromptVM, h as AgentMessageMarkdownWorkspaceAppIcon, k as AgentSlashCommandCapability, c as AgentGUINodeViewModel, i as AgentProbeSnapshot, a as AgentComposerDraftFile, g as AgentHostInputApi } from './agentGuiNodeTypes-B57MfwVo.js';
+import { WorkspaceFileReference, ReferenceLocateTarget, WorkspaceFileReferenceAdapter, ReferenceProvenanceCatalog } from '@tutti-os/workspace-file-reference/contracts';
 export { ReferenceProvenanceCatalog as AgentGUIReferenceProvenanceFilterCatalog } from '@tutti-os/workspace-file-reference/contracts';
-import './runtime-BBNdWgDU.js';
-import '@tutti-os/agent-activity-core';
-import './workspace-query-cache.js';
-import './agentFileMentionContracts-CWAeuL7S.js';
-import '@tutti-os/workspace-file-manager/services';
-import '@tutti-os/workspace-file-reference/core';
-import './agentConversationVM-BD0-gg6C.js';
+import { A as AgentContextMentionItem } from './agentFileMentionContracts-CWAeuL7S.js';
+import { WorkspaceFileEntry } from '@tutti-os/workspace-file-manager/services';
+import { ReferenceSourceAggregator } from '@tutti-os/workspace-file-reference/core';
+import { b as AgentConversationPromptVM, g as WorkspaceLinkAction } from './agentConversationVM-DWEy7jzx.js';
+import { WorkspaceUserProjectI18nRuntime } from '@tutti-os/workspace-user-project/i18n';
+import { AgentContextMentionProvider } from './context-mention-provider.js';
+import { WorkspaceUserProjectSelectChangeAction } from '@tutti-os/workspace-user-project/ui';
+import { WorkspaceUserProject } from '@tutti-os/workspace-user-project/contracts';
+import { ReferenceProvenanceFilterSnapshot, ReferenceProvenanceFilterController } from '@tutti-os/workspace-file-reference/react';
+import { RichTextMentionService } from '@tutti-os/ui-rich-text/service';
+import { A as AgentGuiI18nLocale } from './runtime-Dwf44VKc.js';
 import '@tutti-os/workspace-issue-manager/core';
-import './workspaceAgentActivityListTypes-DZfS_HgG.js';
-import '@tutti-os/workspace-user-project/i18n';
-import './context-mention-provider.js';
 import '@tutti-os/ui-rich-text/types';
 import '@tutti-os/workspace-external-core/contracts';
-import '@tutti-os/workspace-user-project/ui';
-import '@tutti-os/workspace-user-project/contracts';
-import '@tutti-os/workspace-file-reference/react';
-import '@tutti-os/ui-rich-text/service';
-import './pastedTextKinds-D-XuInaS.js';
+
+declare const APP_UPDATE_POLICIES: readonly ["off", "prompt", "auto"];
+type AppUpdatePolicy = (typeof APP_UPDATE_POLICIES)[number];
+
+interface WorkspaceQueryCacheEntry<TValue> {
+    readonly resolvedAtUnixMs: number;
+    readonly stale: boolean;
+    readonly value: TValue;
+    readonly version: number;
+}
+interface WorkspaceQueryCache<TValue> {
+    invalidate(key?: string): void;
+    read(key: string): WorkspaceQueryCacheEntry<TValue> | null;
+    request(key: string, load: () => Promise<TValue>): Promise<WorkspaceQueryCacheEntry<TValue>>;
+    write(key: string, value: TValue): WorkspaceQueryCacheEntry<TValue>;
+}
+
+interface AgentActivityRuntimeUpdateSessionSettingsResult {
+    agentSessionId: string;
+    settings: AgentHostAgentSessionComposerSettings;
+    session: AgentActivitySession;
+}
+interface AgentActivityRuntimeListSessionMessagesInput {
+    afterVersion?: number;
+    beforeVersion?: number;
+    cache?: boolean;
+    agentSessionId: string;
+    limit?: number;
+    order?: AgentActivityMessageOrder;
+    signal?: AbortSignal;
+    workspaceId: string;
+}
+interface AgentActivityRuntimeListGeneratedFilesInput {
+    agentTargetIds?: readonly string[];
+    cursor?: string;
+    limit?: number;
+    query?: string;
+    sectionKey: string;
+    signal?: AbortSignal;
+    workspaceId: string;
+}
+interface AgentActivityRuntimeListSessionsPageInput {
+    agentTargetId?: string | null;
+    cursor?: string;
+    limit?: number;
+    searchQuery?: string;
+    signal?: AbortSignal;
+    workspaceId: string;
+}
+interface AgentActivityRuntimeSessionPageResult {
+    hasMore: boolean;
+    nextCursor?: string;
+    sessions: AgentActivitySession[];
+    workspaceId: string;
+}
+interface AgentActivityRuntimeListSessionSectionsInput {
+    agentTargetId?: string | null;
+    limitPerSection?: number;
+    signal?: AbortSignal;
+    workspaceId: string;
+}
+interface AgentActivityRuntimeListSessionSectionPageInput {
+    agentTargetId?: string | null;
+    cursor?: string;
+    limit?: number;
+    sectionKey: string;
+    signal?: AbortSignal;
+    workspaceId: string;
+}
+interface AgentActivityRuntimeListPinnedSessionsPageInput {
+    agentTargetId?: string | null;
+    cursor?: string;
+    limit?: number;
+    signal?: AbortSignal;
+    workspaceId: string;
+}
+interface AgentActivityRuntimeUserProject {
+    createdAtUnixMs: number;
+    id: string;
+    label: string;
+    lastUsedAtUnixMs?: number;
+    path: string;
+    pinnedAtUnixMs: number;
+    sectionKey: string;
+    updatedAtUnixMs: number;
+}
+interface AgentActivityRuntimeSessionSection {
+    kind: "conversations" | "project";
+    sectionKey: string;
+    userProject?: AgentActivityRuntimeUserProject;
+    sessions: AgentActivitySession[];
+    hasMore: boolean;
+    totalCount: number;
+    nextCursor?: string;
+}
+interface AgentActivityRuntimeSessionPage {
+    sessions: AgentActivitySession[];
+    hasMore: boolean;
+    totalCount: number;
+    nextCursor?: string;
+}
+interface AgentActivityRuntimeSessionSectionsResult {
+    pinned?: AgentActivityRuntimeSessionPage;
+    sections: AgentActivityRuntimeSessionSection[];
+    workspaceId: string;
+}
+interface AgentActivityRuntimeGeneratedFile {
+    label: string;
+    path: string;
+}
+interface AgentActivityRuntimeGeneratedFileList {
+    entries: AgentActivityRuntimeGeneratedFile[];
+    hasMore?: boolean;
+    nextCursor?: string;
+    workspaceId: string;
+}
+interface AgentActivityRuntimeEnsureSessionSynchronizedInput {
+    afterVersion?: number;
+    agentSessionId: string;
+    onError?: (error: unknown) => void;
+    workspaceId: string;
+}
+interface AgentActivityRuntimeSetSessionPinnedInput {
+    agentSessionId: string;
+    pinned: boolean;
+    workspaceId: string;
+}
+interface AgentActivityRuntimeTrackSettingsProjectChangeInput {
+    action: "clear" | "create_new" | "select_existing";
+    agentSessionId: string;
+    provider?: string | null;
+    workspaceId: string;
+}
+interface AgentActivityRuntimeGetComposerOptionsInput {
+    agentTargetId: string;
+    cwd?: string | null;
+    force?: boolean;
+    provider?: string;
+    settings?: AgentHostAgentSessionComposerSettings | null;
+    workspaceId: string;
+}
+interface AgentActivityRuntimeUpdateSessionSettingsInput {
+    agentSessionId: string;
+    settings: AgentHostAgentSessionComposerSettings;
+    workspaceId: string;
+}
+interface AgentActivityRuntimeTrackDraftComposerSettingsChangeInput {
+    nextSettings: AgentHostAgentSessionComposerSettings;
+    previousSettings: AgentHostAgentSessionComposerSettings;
+    provider: string;
+    workspaceId: string;
+}
+interface AgentActivityRuntimeDiagnosticInput {
+    details?: Record<string, unknown>;
+    event: string;
+    level?: "debug" | "info" | "warn" | "error";
+    source?: string;
+    workspaceId?: string | null;
+}
+interface AgentActivityRuntimeActivateSessionInputBase {
+    agentSessionId: string;
+    cwd?: string;
+    initialContent?: AgentActivitySendInput["content"];
+    /** 仅展示用首轮文本(bundle 折叠成一个 chip);initialContent 仍带展开后的文件。 */
+    initialDisplayPrompt?: string | null;
+    submitDiagnostics?: AgentActivitySendInput["submitDiagnostics"];
+    settings?: AgentActivitySessionSettings;
+    title?: string;
+    visible?: boolean;
+    workspaceId: string;
+    signal?: AbortSignal;
+}
+type AgentActivityRuntimeActivateSessionInput = (AgentActivityRuntimeActivateSessionInputBase & {
+    agentTargetId: string;
+    clientSubmitId: string;
+    mode: "new";
+}) | (AgentActivityRuntimeActivateSessionInputBase & {
+    agentTargetId?: string | null;
+    clientSubmitId?: never;
+    mode: "existing";
+});
+interface AgentActivityRuntimeUnactivateSessionInput {
+    agentSessionId: string;
+    workspaceId: string;
+}
+interface AgentActivityRuntimeReadSessionAttachmentInput {
+    agentSessionId: string;
+    attachmentId: string;
+    workspaceId: string;
+}
+interface AgentActivityRuntimeReadPromptAssetInput {
+    agentSessionId?: string | null;
+    assetId?: string | null;
+    hostPath?: string | null;
+    kind?: string | null;
+    mimeType: string;
+    name?: string | null;
+    path?: string | null;
+    sha256?: string | null;
+    uploadStatus?: string | null;
+    uri?: string | null;
+    workspaceId: string;
+}
+type AgentActivityRuntimePromptContentBlock = AgentActivitySendInput["content"][number] & {
+    assetId?: string;
+    hostPath?: string;
+    kind?: string;
+    path?: string;
+    sizeBytes?: number;
+    uploadStatus?: string;
+    uri?: string;
+};
+interface AgentActivityRuntimeUploadPromptContentInput {
+    content: AgentActivityRuntimePromptContentBlock[];
+    workspaceId: string;
+}
+interface AgentActivityRuntimeUploadPromptContentResult {
+    content: AgentActivityRuntimePromptContentBlock[];
+}
+/**
+ * Dedicated host boundary for turning an in-memory text paste into a local
+ * prompt asset. The runtime owns persistence and returns a sendable host path;
+ * AgentGUI must not infer this capability from generic file-upload support.
+ */
+interface AgentActivityRuntimeStagePastedTextInput {
+    name: string;
+    text: string;
+    workspaceId: string;
+}
+interface AgentActivityRuntimeStagePastedTextResult {
+    name: string;
+    path: string;
+    sizeBytes: number;
+}
+interface AgentActivityRuntimeSessionSectionScopeInput {
+    agentTargetId?: string | null;
+    excludePinned?: boolean;
+    sectionKey: string;
+    signal?: AbortSignal;
+    workspaceId: string;
+}
+interface AgentActivityRuntimeSessionSectionDeletionCandidates {
+    agentTargetId?: string | null;
+    excludePinned: boolean;
+    sectionKey: string;
+    sessionIds: string[];
+    workspaceId: string;
+}
+interface AgentActivityRuntimeDeleteSessionsBatchInput {
+    sessionIds: string[];
+    signal?: AbortSignal;
+    workspaceId: string;
+}
+interface AgentActivityRuntimeDeleteSessionsBatchResult {
+    removedMessages: number;
+    removedSessionIds: string[];
+    removedSessions: number;
+}
+interface AgentActivityRuntimeSessionAttachment {
+    attachmentId: string;
+    mimeType: string;
+    name?: string;
+    data: string;
+}
+interface AgentActivityRuntimePromptAsset {
+    assetId?: string;
+    hostPath?: string;
+    kind?: string;
+    mimeType: string;
+    name?: string;
+    path: string;
+    uploadStatus?: string;
+    uri?: string;
+    data: string;
+}
+interface AgentActivityRuntime {
+    /**
+     * Stable identity of this runtime instance (e.g. a local origin vs a
+     * shared/room origin). The runtime owns one session engine per workspace and
+     * that engine verifies this origin as part of its injected identity. Runtime
+     * consumers resolve only through the nearest React provider; module-global
+     * runtime lookup and last-mounted fallback are forbidden. An absent origin
+     * means the canonical local origin.
+     */
+    origin?: string;
+    /**
+     * The session cwd is not resolvable on the local filesystem (e.g. a
+     * shared/cloud sandbox not mounted locally), so AgentGUI must not run its
+     * local stat-based "working directory missing" existence check — it would
+     * always false-positive. Absent/false (default) => local, legacy behaviour.
+     * Only that one guard is gated; project selection/listing is unaffected.
+     */
+    projectPathIsRemote?: boolean;
+    promptContentUploadSupport?: {
+        file?: boolean;
+        image?: boolean;
+    };
+    /** Set false to suppress AgentGUI diagnostics in development consoles. */
+    devDiagnosticConsoleSink?: boolean;
+    goalControl(input: AgentActivityGoalControlInput): Promise<AgentActivityGoalControlResult>;
+    createSession(input: AgentActivityCreateSessionInput): Promise<AgentActivitySession>;
+    deleteSession(input: AgentActivityDeleteSessionInput): Promise<AgentActivityDeleteSessionResult>;
+    activateSession(input: AgentActivityRuntimeActivateSessionInput): Promise<AgentActivityActivateSessionResult>;
+    getSession(workspaceId: string, agentSessionId: string): Promise<AgentActivitySession>;
+    getComposerOptions(input: AgentActivityRuntimeGetComposerOptionsInput): Promise<unknown>;
+    updateSessionSettings(input: AgentActivityRuntimeUpdateSessionSettingsInput): Promise<AgentActivityRuntimeUpdateSessionSettingsResult>;
+    getSnapshot(workspaceId: string): AgentActivitySnapshot;
+    getSessionEngine(workspaceId: string): AgentSessionEngine;
+    getSessionSectionsQueryCache?(workspaceId: string): WorkspaceQueryCache<unknown>;
+    listSessionMessages(input: AgentActivityRuntimeListSessionMessagesInput): Promise<AgentActivityMessagePage>;
+    listAgentGeneratedFiles?(input: AgentActivityRuntimeListGeneratedFilesInput): Promise<AgentActivityRuntimeGeneratedFileList>;
+    listSessionsPage?(input: AgentActivityRuntimeListSessionsPageInput): Promise<AgentActivityRuntimeSessionPageResult>;
+    listSessionSections?(input: AgentActivityRuntimeListSessionSectionsInput): Promise<AgentActivityRuntimeSessionSectionsResult>;
+    listSessionSectionPage?(input: AgentActivityRuntimeListSessionSectionPageInput): Promise<AgentActivityRuntimeSessionSection>;
+    listSessionSectionDeletionCandidates?(input: AgentActivityRuntimeSessionSectionScopeInput): Promise<AgentActivityRuntimeSessionSectionDeletionCandidates>;
+    deleteSessionsBatch?(input: AgentActivityRuntimeDeleteSessionsBatchInput): Promise<AgentActivityRuntimeDeleteSessionsBatchResult>;
+    listPinnedSessionsPage?(input: AgentActivityRuntimeListPinnedSessionsPageInput): Promise<AgentActivityRuntimeSessionPage>;
+    load(workspaceId: string, signal?: AbortSignal): Promise<AgentActivitySnapshot>;
+    ensureSessionSynchronized?(input: AgentActivityRuntimeEnsureSessionSynchronizedInput): () => void;
+    sendInput(input: AgentActivitySendInput): Promise<AgentActivitySendInputResult>;
+    uploadPromptContent?(input: AgentActivityRuntimeUploadPromptContentInput): Promise<AgentActivityRuntimeUploadPromptContentResult>;
+    stagePastedText?(input: AgentActivityRuntimeStagePastedTextInput): Promise<AgentActivityRuntimeStagePastedTextResult>;
+    readSessionAttachment?(input: AgentActivityRuntimeReadSessionAttachmentInput): Promise<AgentActivityRuntimeSessionAttachment>;
+    readPromptAsset?(input: AgentActivityRuntimeReadPromptAssetInput): Promise<AgentActivityRuntimePromptAsset>;
+    renameSession(input: AgentActivityRenameSessionInput): Promise<AgentActivitySession>;
+    setSessionPinned(input: AgentActivityRuntimeSetSessionPinnedInput): Promise<AgentActivitySession>;
+    trackSettingsProjectChange?(input: AgentActivityRuntimeTrackSettingsProjectChangeInput): Promise<void>;
+    trackDraftComposerSettingsChange?(input: AgentActivityRuntimeTrackDraftComposerSettingsChangeInput): Promise<void>;
+    reportDiagnostic?(input: AgentActivityRuntimeDiagnosticInput): Promise<void> | void;
+    unactivateSession(input: AgentActivityRuntimeUnactivateSessionInput): Promise<AgentHostUnactivateAgentSessionResult>;
+    submitInteractive(input: AgentActivitySubmitInteractiveInput): Promise<AgentActivitySubmitInteractiveResult>;
+    subscribeSessionEvents(workspaceId: string, listener: (event: unknown) => void): () => void;
+    subscribe(workspaceId: string, listener: AgentActivitySnapshotListener): () => void;
+}
+
+type AgentCustomModelEnabledByProvider<TProvider extends string> = Record<TProvider, boolean>;
+type AgentCustomModelByProvider<TProvider extends string> = Record<TProvider, string>;
+type AgentCustomModelOptionsByProvider<TProvider extends string> = Record<TProvider, string[]>;
+
+declare const AGENT_PROVIDERS: readonly ["claude-code", "codex", "cursor", "tutti-agent", "nexight", "opencode", "openclaw", "hermes"];
+type AgentProvider = (typeof AGENT_PROVIDERS)[number];
+
+type FocusNodeTargetZoom = number;
+
+declare const UI_LANGUAGES: readonly ["en", "zh-CN"];
+type UiLanguage = (typeof UI_LANGUAGES)[number];
+declare const UI_THEMES: readonly ["system", "light", "dark"];
+type UiTheme = (typeof UI_THEMES)[number];
+
+declare const COMMAND_IDS: readonly ["commandCenter.toggle", "app.togglePrimarySidebar", "workspaceCanvas.createTerminal"];
+type CommandId = (typeof COMMAND_IDS)[number];
+type KeyChord = {
+    code: string;
+    altKey: boolean;
+    ctrlKey: boolean;
+    metaKey: boolean;
+    shiftKey: boolean;
+};
+type KeybindingOverrides = Partial<Record<CommandId, KeyChord | null>>;
+
+declare const CANVAS_INPUT_MODES: readonly ["auto", "mouse", "trackpad"];
+type CanvasInputMode = (typeof CANVAS_INPUT_MODES)[number];
+declare const CANVAS_WHEEL_BEHAVIORS: readonly ["zoom", "pan"];
+type CanvasWheelBehavior = (typeof CANVAS_WHEEL_BEHAVIORS)[number];
+declare const CANVAS_WHEEL_ZOOM_MODIFIERS: readonly ["primary", "ctrl", "alt"];
+type CanvasWheelZoomModifier = (typeof CANVAS_WHEEL_ZOOM_MODIFIERS)[number];
+declare const STANDARD_WINDOW_SIZE_BUCKETS: readonly ["compact", "regular", "large"];
+type StandardWindowSizeBucket = (typeof STANDARD_WINDOW_SIZE_BUCKETS)[number];
+
+type QuickCommand = {
+    id: string;
+    title: string;
+    kind: "terminal";
+    command: string;
+    enabled: boolean;
+    pinned: boolean;
+} | {
+    id: string;
+    title: string;
+    kind: "url";
+    url: string;
+    enabled: boolean;
+    pinned: boolean;
+};
+
+type QuickPhrase = {
+    id: string;
+    title: string;
+    content: string;
+    enabled: boolean;
+};
+
+type AgentEnvRow = {
+    id: string;
+    key: string;
+    value: string;
+    enabled: boolean;
+};
+type AgentEnvByProvider = Record<AgentProvider, AgentEnvRow[]>;
+
+type TerminalProfileId = string | null;
+interface AgentSettings {
+    language: UiLanguage;
+    uiTheme: UiTheme;
+    isPrimarySidebarCollapsed: boolean;
+    defaultProvider: AgentProvider;
+    agentProviderOrder: AgentProvider[];
+    agentFullAccess: boolean;
+    defaultTerminalProfileId: TerminalProfileId;
+    customModelEnabledByProvider: AgentCustomModelEnabledByProvider<AgentProvider>;
+    customModelByProvider: AgentCustomModelByProvider<AgentProvider>;
+    customModelOptionsByProvider: AgentCustomModelOptionsByProvider<AgentProvider>;
+    quickCommands: QuickCommand[];
+    quickPhrases: QuickPhrase[];
+    agentEnvByProvider: AgentEnvByProvider;
+    focusNodeOnClick: boolean;
+    focusNodeTargetZoom: FocusNodeTargetZoom;
+    focusNodeUseVisibleCanvasCenter: boolean;
+    standbyBannerEnabled: boolean;
+    standbyBannerShowTask: boolean;
+    standbyBannerShowSpace: boolean;
+    standbyBannerShowBranch: boolean;
+    disableAppShortcutsWhenTerminalFocused: boolean;
+    keybindings: KeybindingOverrides;
+    canvasInputMode: CanvasInputMode;
+    canvasWheelBehavior: CanvasWheelBehavior;
+    canvasWheelZoomModifier: CanvasWheelZoomModifier;
+    standardWindowSizeBucket: StandardWindowSizeBucket;
+    defaultTerminalWindowScalePercent: number;
+    terminalFontSize: number;
+    terminalFontFamily: string | null;
+    uiFontSize: number;
+    avoidGroupingEdits: boolean;
+    updatePolicy: AppUpdatePolicy;
+    hideWorktreeMismatchDropWarning: boolean;
+}
+
+interface AgentGUIAccountMenuState {
+    user: {
+        userId: string;
+        name?: string | null;
+        email?: string | null;
+        avatar?: string | null;
+    } | null;
+    membershipLabel: string;
+    creditsLabel: string | null;
+    loading: boolean;
+    error: string | null;
+    partialError?: boolean;
+    registrationCreditsToast?: {
+        id: string;
+        creditsLabel: string;
+        visible: boolean;
+        autoDismissMs?: number;
+        onDismiss(): void;
+    } | null;
+    links: {
+        planUrl: string;
+        usageUrl: string;
+        settingsUrl: string;
+    };
+    onOpenChange(open: boolean): void;
+    onLogin(): void;
+    onLogout?(): void;
+    onSettings?(): void;
+    onOpenExternal(url: string): void;
+}
+
+type AgentDroppedFileReferenceResolver = (files: readonly File[]) => Promise<readonly WorkspaceFileReference[]> | readonly WorkspaceFileReference[];
+
+interface AgentProjectPathChangeMetadata {
+    action: WorkspaceUserProjectSelectChangeAction;
+    project?: WorkspaceUserProject;
+}
+
+type AgentGUIComposerFocusMethod = "keyboard" | "pointer" | "programmatic";
+type AgentGUIComposerContentType = "image" | "large_text" | "text";
+interface AgentGUIEngagementContext {
+    agentSessionId: string | null;
+    agentTargetId: string | null;
+    composerReady: boolean;
+    conversationState: "existing" | "new";
+    provider: string;
+}
+interface AgentGUIEngagementEventBase extends AgentGUIEngagementContext {
+    panelVisitId: string;
+}
+type AgentGUIEngagementEvent = (AgentGUIEngagementEventBase & {
+    type: "panel_exposed";
+}) | (AgentGUIEngagementEventBase & {
+    type: "composer_focused";
+    focusMethod: AgentGUIComposerFocusMethod;
+}) | (AgentGUIEngagementEventBase & {
+    type: "composer_content_entered";
+    contentType: AgentGUIComposerContentType;
+    hadPrefill: boolean;
+});
+interface AgentGUIComposerEngagement {
+    contentEntered(input: {
+        contentType: AgentGUIComposerContentType;
+        hadPrefill: boolean;
+    }): void;
+    focused(focusMethod: AgentGUIComposerFocusMethod): void;
+}
+type AgentGUIEngagementEventSink = (event: AgentGUIEngagementEvent) => Promise<void> | void;
+
+interface WorkspaceReferencePickResult {
+    files: readonly WorkspaceFileReference[];
+    mentionItems: readonly AgentContextMentionItem[];
+}
+
+interface AgentComposerReferenceProvenanceFilter {
+    snapshot: ReferenceProvenanceFilterSnapshot;
+    controller: Pick<ReferenceProvenanceFilterController, "reset" | "toggle" | "toggleAll">;
+}
+interface AgentComposerSubmitOptions {
+    requiredSettingsPatch?: AgentActivitySubmitSettingsPatch;
+}
+interface AgentComposerProps {
+    workspaceId: string;
+    workspacePath?: string | null;
+    currentUserId?: string | null;
+    provider: string;
+    slashStatus?: AgentComposerSlashStatus | null;
+    usage?: AgentComposerUsage | null;
+    draftContent: AgentComposerDraft;
+    engagement?: AgentGUIComposerEngagement;
+    /** Stable project/session owner for async draft attachment work. */
+    draftScopeKey?: string;
+    availableCommands: readonly AgentSessionCommand[];
+    hasCompactableContext?: boolean;
+    compactSupported?: boolean | null;
+    availableSkills?: readonly AgentGUIProviderSkillOption[];
+    disabled: boolean;
+    disabledReason?: string | null;
+    submitDisabled: boolean;
+    placeholder: string;
+    composerSettings: AgentGUIComposerSettingsVM;
+    queueStatus?: AgentGUIQueueStatus;
+    queuedPrompts: readonly AgentGUIQueuedPromptVM[];
+    drainingQueuedPromptId: string | null;
+    workspaceAppIcons?: readonly AgentMessageMarkdownWorkspaceAppIcon[];
+    selectedAgentTarget?: AgentGUIAgentTarget | null;
+    agentTargets?: readonly AgentGUIAgentTarget[];
+    handoffAgentTargets?: readonly AgentGUIAgentTarget[];
+    providerSelectReadonly?: boolean;
+    onProviderSelect?: (input: {
+        provider: AgentGUIProvider;
+        agentTargetId?: string | null;
+    }) => void;
+    onHandoffConversation?: (target: AgentGUIAgentTarget) => void;
+    canQueueWhileBusy: boolean;
+    showStopButton: boolean;
+    activePrompt: AgentConversationPromptVM | null;
+    activePromptKeyboardShortcutsEnabled?: boolean;
+    promptTips?: readonly AgentComposerPromptTip[];
+    isInterrupting: boolean;
+    isSendingTurn: boolean;
+    isSubmittingPrompt: boolean;
+    uiLanguage?: UiLanguage;
+    isActive?: boolean;
+    previewMode?: boolean;
+    workspaceReferencePickerOpen?: boolean;
+    promptImagesSupported?: boolean;
+    canGoalControl?: boolean;
+    canUploadAttachment?: boolean;
+    composerFocusRequestSequence?: number | null;
+    layoutMode?: "dock" | "hero";
+    providerSelectLabel?: string;
+    handoffLabel?: string;
+    handoffMenuLabel?: string;
+    labels: {
+        send: string;
+        modelLabel: string;
+        modelSelectionLabel: string;
+        modelContextWindowSuffix: string;
+        modelTooltipVersionLabel: string;
+        defaultModel: string;
+        loadingOptions: string;
+        inheritedUnavailable: string;
+        loadingConversation: string;
+        reasoningLabel: string;
+        reasoningDegreeLabel: string;
+        reasoningOptionDefault: string;
+        reasoningOptionMinimal: string;
+        reasoningOptionLow: string;
+        reasoningOptionMedium: string;
+        reasoningOptionHigh: string;
+        reasoningOptionXHigh: string;
+        reasoningOptionMax: string;
+        reasoningOptionUltra: string;
+        speedLabel: string;
+        speedSelectionLabel: string;
+        speedOptionStandard: string;
+        speedOptionStandardDescription: string;
+        speedOptionFast: string;
+        speedOptionFastDescription: string;
+        permissionLabel: string;
+        permissionModeReadOnly: string;
+        permissionModeAuto: string;
+        permissionModeFullAccess: string;
+        permissionModeChangeUnavailableDuringTurn: string;
+        modelDescriptions: {
+            frontierComplexCoding: string;
+            everydayCoding: string;
+            smallFastCostEfficient: string;
+            codingOptimized: string;
+            ultraFastCoding: string;
+            professionalLongRunning: string;
+        };
+        planModeLabel: string;
+        planModeOnLabel: string;
+        planModeOffLabel: string;
+        planUnavailable: string;
+        goalLabel: string;
+        browserUseCapabilityLabel: string;
+        browserUseCapabilityDescription: string;
+        browserUseCapabilityDescriptionAutoConnect: string;
+        browserUseCapabilityDescriptionIsolated: string;
+        browserUseCapabilitySettingsLabel: string;
+        browserUseCapabilitySettingsDescription: string;
+        capabilityInlineSettingsLabel: string;
+        computerUseCapabilityLabel: string;
+        computerUseCapabilityDescription: string;
+        computerUseCapabilitySetupRequiredDescription: string;
+        computerUseCapabilityAuthorizationRequiredDescription: string;
+        computerUseCapabilityAuthorizationUnknownDescription: string;
+        computerUseCapabilitySettingsLabel: string;
+        computerUseCapabilitySettingsDescription: string;
+        queuedLabel: string;
+        queuePausedByUserLabel: string;
+        sendQueuedPromptNext: string;
+        editQueuedPrompt: string;
+        deleteQueuedPrompt: string;
+        queuedPromptMoreActions: string;
+        stop: string;
+        stopping: string;
+        slashCommandPalette: string;
+        skillPickerPalette: string;
+        slashPaletteCommandsGroup: string;
+        slashPaletteCapabilitiesGroup: string;
+        slashPaletteCapabilitiesLoading: string;
+        slashPaletteSkillsGroup: string;
+        slashPalettePluginsGroup: string;
+        slashPaletteConnectorsGroup: string;
+        slashPaletteMcpGroup: string;
+        slashCommandCompactLabel: string;
+        slashCommandContextLabel: string;
+        slashCommandFastLabel: string;
+        slashCommandGoalLabel: string;
+        slashCommandInitLabel: string;
+        slashCommandPlanLabel: string;
+        slashCommandReviewLabel: string;
+        slashCommandStatusLabel: string;
+        slashCommandUsageLabel: string;
+        slashCommandCompactDescription: string;
+        slashCommandContextDescription: string;
+        slashCommandFastDescription: string;
+        slashCommandGoalDescription: string;
+        slashCommandInitDescription: string;
+        slashCommandPlanDescription: string;
+        slashCommandReviewDescription: string;
+        slashCommandStatusDescription: string;
+        slashCommandUsageDescription: string;
+        slashStatusTitle: string;
+        slashStatusSession: string;
+        slashStatusBaseUrl: string;
+        slashStatusContext: string;
+        slashStatusLimits: string;
+        slashStatusClose: string;
+        slashStatusContextValue: (input: {
+            percentLeft: number;
+            usedTokens: string;
+            totalTokens: string;
+        }) => string;
+        slashStatusContextUnavailable: string;
+        slashStatusLimitsUnavailable: string;
+        usageChipLabel: (input: {
+            percent: number;
+        }) => string;
+        usageTooltipLabel: string;
+        usagePopoverTitle: string;
+        usageContextWindowLabel: string;
+        usageTokensLabel: string;
+        usageLimitsLabel: string;
+        usageCompactAction: string;
+        approvalLead: string;
+        fileChangeApprovalLead: string;
+        planLead: string;
+        planModes: Array<{
+            id: string;
+            label: string;
+            description: string;
+        }>;
+        stayInPlan: string;
+        sendFeedback: string;
+        feedbackPlaceholder: string;
+        previousQuestion: string;
+        nextQuestion: string;
+        submitAnswers: string;
+        answerPlaceholder: string;
+        waitingForAnswer: string;
+        planImplementationLead: string;
+        planImplementationConfirm: string;
+        planImplementationFeedbackPlaceholder: string;
+        planImplementationSend: string;
+        planImplementationSkip: string;
+        fileMentionPalette: string;
+        fileMentionLoading: string;
+        fileMentionEmpty: string;
+        fileMentionError: string;
+        fileMentionTabHint: string;
+        fileDropHint: string;
+        mentionPalette: string;
+        removeMention: string;
+        addReference: string;
+        addContent: string;
+        referenceWorkspaceFiles: string;
+        handoffConversation: string;
+        handoffConversationTooltip: string;
+        handoffConversationMenu: string;
+        handoffTargetSelf: string;
+        handoffTargetShared: string;
+        providerSwitchLabel: string;
+        projectLocked: string;
+        projectMissingDescription: string;
+        promptTipsPrefix: string;
+        reviewPicker: {
+            title: string;
+            targetLabel: string;
+            searchPlaceholder: string;
+            noResults: string;
+            uncommitted: string;
+            baseBranch: string;
+            commit: string;
+            custom: string;
+            branchLabel: string;
+            branchPlaceholder: string;
+            branchLoading: string;
+            branchEmpty: string;
+            commitPlaceholder: string;
+            customPlaceholder: string;
+            submit: string;
+            cancel: string;
+        };
+    };
+    workspaceUserProjectI18n: WorkspaceUserProjectI18nRuntime;
+    onDraftContentChange: (draftContent: AgentComposerDraft, sourceScopeKey?: string) => void;
+    onProjectPathChange?: (path: string | null, metadata?: AgentProjectPathChangeMetadata) => void;
+    onSettingsChange: (settings: {
+        model?: string | null;
+        reasoningEffort?: string | null;
+        speed?: string | null;
+        planMode?: boolean;
+        browserUse?: boolean;
+        computerUse?: boolean;
+        permissionModeId?: string | null;
+    }) => void;
+    capabilityMenuState?: AgentComposerCapabilityMenuState;
+    onCapabilitySettingsRequest?: (capability: AgentComposerCapabilitySettingsTarget) => void;
+    onSlashStatusOpen?: () => void;
+    onSubmit: (content: AgentPromptContentBlock[], displayPrompt?: string, options?: AgentComposerSubmitOptions) => void;
+    onSubmitGuidance?: (content: AgentPromptContentBlock[], displayPrompt?: string) => void;
+    onSendQueuedPromptNext: (queuedPromptId: string) => void;
+    onRemoveQueuedPrompt: (queuedPromptId: string) => void;
+    onEditQueuedPrompt: (queuedPromptId: string) => void;
+    onInterruptCurrentTurn: () => void;
+    onPromptImagesUnsupported?: () => void;
+    onSubmitInteractivePrompt: (input: {
+        requestId: string;
+        action?: string;
+        optionId?: string;
+        payload?: Record<string, unknown>;
+    }) => void;
+    onLinkAction?: (action: WorkspaceLinkAction) => void;
+    onRequestWorkspaceReferences?: ((entity?: AgentContextMentionItem | null) => Promise<WorkspaceReferencePickResult>) | null;
+    resolveDroppedFileReferences?: AgentDroppedFileReferenceResolver | null;
+    selectProjectDirectory?: () => Promise<{
+        path: string;
+    } | null>;
+    onRequestGitBranches?: AgentComposerGitBranchLoader | null;
+    contextMentionProviders?: readonly AgentContextMentionProvider[];
+    referenceProvenanceFilter?: AgentComposerReferenceProvenanceFilter | null;
+}
+type AgentComposerCapabilitySettingsTarget = AgentSlashCommandCapability["capability"];
+interface AgentComposerCapabilityMenuState {
+    browserUse?: {
+        connectionMode?: "autoConnect" | "isolated" | null;
+    };
+    computerUse?: {
+        authorization?: AgentComposerComputerUseAuthorizationState | null;
+        installed?: boolean | null;
+    };
+}
+type AgentComposerComputerUseAuthorizationState = "authorized" | "needs-authorization" | "unknown";
+interface AgentComposerGitBranches {
+    branches: readonly string[];
+    currentBranch?: string | null;
+}
+type AgentComposerGitBranchLoader = (input: {
+    agentSessionId?: string | null;
+    workingDirectory?: string | null;
+}) => Promise<AgentComposerGitBranches>;
+interface AgentComposerPromptTip {
+    id: string;
+    label: string;
+    prompt: string;
+}
+interface AgentComposerSlashStatus {
+    agentSessionId?: string | null;
+    baseUrl?: string | null;
+    contextWindow?: {
+        usedTokens?: number | null;
+        totalTokens?: number | null;
+    } | null;
+    limits?: readonly AgentComposerSlashStatusLimit[];
+    limitsLoading?: boolean;
+    limitsUnavailable?: boolean;
+}
+interface AgentComposerSlashStatusLimit {
+    id: string;
+    label: string;
+    percentRemaining?: number | null;
+    value: string;
+    reset?: string | null;
+}
+interface AgentComposerUsage {
+    percentUsed: number | null;
+    usedTokens: number | null;
+    totalTokens: number | null;
+}
+
+/** Setup section requested by an AgentGUI remediation action. */
+type AgentEnvPanelFocus = "detect" | "install" | "repair" | "upgrade" | "auth" | "network" | "registry";
+interface OpenAgentEnvPanelInput {
+    provider?: string | null;
+    focus?: AgentEnvPanelFocus | null;
+}
+
+type AgentMentionReferenceTargetResolver = (item: AgentContextMentionItem) => ReferenceLocateTarget | null;
+interface AgentWorkspaceReferenceInitialTargetInput {
+    activeConversation: AgentGUINodeViewModel["rail"]["activeConversation"];
+    composerSelectedProjectPath: string | null;
+    userProjects: AgentGUINodeViewModel["rail"]["userProjects"];
+}
+type AgentWorkspaceReferenceInitialTargetResolver = (input: AgentWorkspaceReferenceInitialTargetInput) => ReferenceLocateTarget | null;
+interface AgentGUISidebarFooterContext {
+    currentUserId?: string | null;
+    activeConversation: AgentGUINodeViewModel["rail"]["activeConversation"];
+}
+/**
+ * Renders the provider rail body when the rail is in "exact" mode and the
+ * host-provided target list is empty (and not loading). Lets the host fully own
+ * the empty state (e.g. a "no shared agents" message or a create-agent prompt)
+ * instead of the library falling back to the static local catalog.
+ */
+type AgentGUIAgentsEmptyRenderer = () => ReactNode;
+interface AgentGUIProviderUnavailableStateContext {
+    provider: AgentGUIProvider;
+    providerLabel: string;
+    target: AgentGUIAgentTarget;
+    iconUrl: string;
+    unavailableReason: string | null;
+}
+/**
+ * Renders the main-pane unavailable state for a selected provider target that
+ * the host explicitly marks as disabled. This does not replace install,
+ * login, checking, or retry readiness gates.
+ */
+type AgentGUIProviderUnavailableStateRenderer = (ctx: AgentGUIProviderUnavailableStateContext) => ReactNode;
+
+interface DesktopSize {
+    width: number;
+    height: number;
+    bottomInset?: number;
+}
+/** Workspace-scoped agent probes for currently visible Agent GUI windows. */
+interface WorkspaceDesktopAgentProbesState {
+    snapshot: AgentProbeSnapshot | null;
+    isLoadingAvailability: boolean;
+    isLoadingUsage: boolean;
+    /** True when the most recent usage probe fetch failed (the retained snapshot,
+     * if any, is stale). Lets surfaces show a refresh/retry affordance instead of
+     * silently displaying old numbers. Absent is treated as "no failure". */
+    usageLoadFailed?: boolean;
+}
+type WorkspaceDesktopAgentProbeDemandChange = (provider: AgentProvider | null, sourceId?: string) => void;
+type WorkspaceDesktopAgentProbeRefreshRequest = (provider: AgentProvider, sourceId?: string) => void;
+
+interface AgentGUIComposerDefaults {
+    model?: string | null;
+    permissionModeId?: string | null;
+    reasoningEffort?: string | null;
+    speed?: string | null;
+}
+interface AgentGUIRememberComposerDefaultsInput {
+    agentTargetId: string | null;
+    provider: AgentGUINodeData["provider"];
+    defaults: AgentGUIComposerDefaults | null;
+}
+declare const rememberComposerDefaultsFields: readonly ["model", "permissionModeId", "reasoningEffort", "speed"];
+type AgentGUIComposerDefaultsField = (typeof rememberComposerDefaultsFields)[number];
+interface AgentGUIRememberComposerDefaultsResult {
+    acknowledgedFields: AgentGUIComposerDefaultsField[];
+    supersededFields: AgentGUIComposerDefaultsField[];
+}
+
+interface AgentGUIOpenSessionRequest {
+    agentSessionId: string;
+    sequence: number;
+}
+
+type AgentGUIComposerAppendRequest = {
+    files: readonly AgentComposerDraftFile[];
+    prompt?: string;
+    sequence: number;
+} | {
+    files?: never;
+    prompt: string;
+    sequence: number;
+};
+
+interface AgentGUIPrefillPromptRequest {
+    agentTargetId?: string | null;
+    autoSubmit?: boolean;
+    draftPrompt: string;
+    provider?: AgentGUIProvider;
+    sequence: number;
+    userProjectPath?: string | null;
+}
+
+interface AgentGUINodeIdentity {
+    nodeId: string;
+    workspaceId: string;
+    currentUserId?: string | null;
+    title: string;
+}
+interface AgentGUINodeWorkspace {
+    path: string;
+    fileReferenceAdapter?: WorkspaceFileReferenceAdapter | null;
+    onRequestGitBranches?: AgentComposerGitBranchLoader | null;
+    selectProjectDirectory?: () => Promise<{
+        path: string;
+    } | null>;
+    resolveDroppedFileReferences?: AgentComposerProps["resolveDroppedFileReferences"];
+    referenceSourceAggregator?: ReferenceSourceAggregator | null;
+    resolveReferenceEntryIconUrl?: (entry: WorkspaceFileEntry) => Promise<string | null | undefined>;
+    resolveMentionReferenceTarget?: AgentMentionReferenceTargetResolver | null;
+    resolveReferenceInitialTarget?: AgentWorkspaceReferenceInitialTargetResolver | null;
+    onFileReferencesAdded?: (input: {
+        provider: AgentGUIProvider;
+        references: readonly WorkspaceFileReference[];
+    }) => void | Promise<void>;
+    agentSettings: Pick<AgentSettings, "avoidGroupingEdits">;
+}
+interface AgentGUINodeFrameLayout {
+    position: Point;
+    width: number;
+    height: number;
+    desktopSize: DesktopSize;
+    isMaximized?: boolean;
+    isActive: boolean;
+    /** Host-projected presentation visibility. Independent from node focus. */
+    isVisible?: boolean;
+    embedded?: boolean;
+    previewMode?: boolean;
+    /**
+     * Container width at or below which the conversation rail auto-hides.
+     * Hosts with roomier layouts (e.g. the standalone agent window) raise this
+     * above the default AGENT_GUI_AUTO_COLLAPSE_WIDTH_PX.
+     */
+    conversationRailAutoCollapseWidthPx?: number | null;
+}
+interface AgentGUINodeRuntimeRequests {
+    composerAppend?: AgentGUIComposerAppendRequest | null;
+    composerFocusSequence?: number | null;
+    newConversationSequence?: number | null;
+    openSession?: AgentGUIOpenSessionRequest | null;
+    prefillPrompt?: AgentGUIPrefillPromptRequest | null;
+    agentProbes?: WorkspaceDesktopAgentProbesState | null;
+    onProbeDemandChange?: WorkspaceDesktopAgentProbeDemandChange;
+    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;
+    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[];
+    providerReadinessGates?: Partial<Record<AgentGUIProvider, AgentGUIProviderReadinessGate | null>> | null;
+    defaultAgentTargetId?: string | null;
+    providerAuthAccountLabels?: Partial<Record<string, string>>;
+    contextMentionProviders?: readonly AgentContextMentionProvider[];
+    mentionService?: RichTextMentionService;
+    workspaceAppIcons?: readonly AgentMessageMarkdownWorkspaceAppIcon[];
+    disabledHomeSuggestions?: readonly AgentGUIHomeSuggestionId[];
+}
+interface AgentGUINodeHostActions {
+    onLinkAction?: (action: WorkspaceLinkAction) => void;
+    onHandoffConversation?: (input: {
+        agentTargetId?: string | null;
+        draftPrompt: string;
+        provider: AgentGUIProvider;
+        userProjectPath?: string | null;
+    }) => void | Promise<void>;
+    onCapabilitySettingsRequest?: (capability: AgentComposerCapabilitySettingsTarget) => void;
+    onAgentProviderLogin?: (provider: AgentGUIProvider) => void;
+    onAgentEnvPanelOpen?: (input?: OpenAgentEnvPanelInput) => void;
+    onOpenConversationWindow?: (agentSessionId: string) => void;
+    onClose: () => void;
+    onResize: (frame: NodeFrame) => void;
+    onUpdateNode: (updater: (current: AgentGUINodeData) => AgentGUINodeData) => void;
+    onRememberComposerDefaults?: (input: AgentGUIRememberComposerDefaultsInput) => void | Promise<AgentGUIRememberComposerDefaultsResult>;
+    isMuted?: boolean;
+    onMinimize?: () => void;
+    onToggleMaximize?: () => void;
+    onShowMessage?: (message: string, tone?: "info" | "warning" | "error") => void;
+    onEngagementEvent?: AgentGUIEngagementEventSink;
+}
+interface AgentGUINodeRenderSlots {
+    providerRailEmpty?: AgentGUIAgentsEmptyRenderer;
+    providerUnavailableState?: AgentGUIProviderUnavailableStateRenderer;
+    sidebarFooter?: (ctx: AgentGUISidebarFooterContext) => ReactNode;
+}
+interface AgentGUINodeProps {
+    identity: AgentGUINodeIdentity;
+    workspace: AgentGUINodeWorkspace;
+    frame: AgentGUINodeFrameLayout;
+    state: AgentGUINodeData;
+    runtimeRequests: AgentGUINodeRuntimeRequests;
+    hostCapabilities: AgentGUINodeHostCapabilities;
+    hostActions: AgentGUINodeHostActions;
+    renderSlots: AgentGUINodeRenderSlots;
+}
+
+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;
+    agentHostApi?: AgentHostInputApi | null;
+    /** Starter entries to hide below the empty new-session composer. */
+    disabled?: readonly AgentGUIHomeSuggestionId[];
+    i18n?: I18nRuntime<string> | null;
+    locale?: AgentGuiI18nLocale;
+    hostCapabilities: AgentGUIPublicHostCapabilities;
+    renderSlots: AgentGUIPublicRenderSlots;
+}
+declare const AgentGUI: react.NamedExoticComponent<AgentGUIProps>;
+
+export { AgentGUI, AgentGUIHomeSuggestionId, type AgentGUIProps };