@tutti-os/agent-gui 0.0.93 → 0.0.95

package/dist/AgentGUI-CwBLYtv-.d.ts

@@ -0,0 +1,992 @@
+import * as react from 'react';
+import { PropsWithChildren, JSX, HTMLAttributes, 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 } from '@tutti-os/agent-activity-core';
+import { t as AgentHostAgentSessionComposerSettings, x as AgentHostUnactivateAgentSessionResult, z as AgentProvider, h as AgentGUIAgentTarget, m as AgentGUIProvider, y as AgentPromptContentBlock, l as AgentGUINodeData, P as Point, n as AgentGUIProviderRailAllPresentation, o as AgentGUIProviderRailMode, p as AgentGUIProviderReadinessGate, N as NodeFrame, e as AgentGUIAgentDirectorySnapshot, k as AgentGUIAllAgentsPresentation } from './types-DX2bxgB8.js';
+import { A as AgentComposerDraft, o as AgentSessionCommand, c as AgentGUIProviderSkillOption, a as AgentGUIComposerSettingsVM, d as AgentGUIQueuedPromptVM, j as AgentMessageMarkdownWorkspaceAppIcon, p as AgentSlashCommandCapability, b as AgentGUINodeViewModel, l as AgentProbeSnapshot, g as AgentHostInputApi } from './agentGuiNodeTypes-DppADPHW.js';
+import { WorkspaceFileReference, ReferenceLocateTarget, WorkspaceFileReferenceAdapter } from '@tutti-os/workspace-file-reference/contracts';
+import { A as AgentContextMentionItem } from './agentFileMentionContracts-Czvz6YMI.js';
+import { WorkspaceFileEntry } from '@tutti-os/workspace-file-manager/services';
+import { ReferenceSourceAggregator } from '@tutti-os/workspace-file-reference/core';
+import { U as UiLanguage, a as UiTheme } from './uiSettings-BQS9r2eo.js';
+import { b as AgentConversationPromptVM, e as WorkspaceLinkAction } from './agentConversationVM-C335TR6S.js';
+import { AgentContextMentionProvider } from './context-mention-provider.js';
+import { WorkspaceUserProjectI18nRuntime } from '@tutti-os/workspace-user-project/i18n';
+import { WorkspaceUserProjectSelectChangeAction } from '@tutti-os/workspace-user-project/ui';
+import { WorkspaceUserProject } from '@tutti-os/workspace-user-project/contracts';
+import { A as AgentGuiI18nLocale } from './runtime-BBNdWgDU.js';
+
+interface AgentHostManagedAgentsStateItem {
+    toolId: string;
+    toolClass: string;
+    agentId?: string;
+    hostDetected?: boolean;
+    hostConfigDetected?: boolean;
+    hostVersion?: string;
+    targetVersion: string;
+    recommendedVersion?: string;
+    decisionReason: string;
+    fallbackApplied: boolean;
+    notes?: string;
+}
+interface AgentHostToolchainConfigSyncedAgent {
+    agentId: string;
+    /** RFC3339 timestamp for when Tutti last synced this agent's host config. */
+    syncedAt?: string;
+}
+interface AgentHostManagedAgentsState {
+    metadataSynced: boolean;
+    toolCatalogRevision: string;
+    agentProfileRevision: string;
+    totalCount: number;
+    items: AgentHostManagedAgentsStateItem[];
+    /** Agent IDs ready for normal AgentGUI use (installed and authenticated/ready). */
+    readyAgentIds: string[];
+    /** Agent IDs whose host config has been synced to the VM through Manage Agents. */
+    configSyncedAgentIds: string[];
+    /** Agent config sync metadata, including when Tutti last copied host config. */
+    configSyncedAgents?: AgentHostToolchainConfigSyncedAgent[];
+}
+
+declare const APP_UPDATE_POLICIES: readonly ["off", "prompt", "auto"];
+type AppUpdatePolicy = (typeof APP_UPDATE_POLICIES)[number];
+
+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 {
+    limit?: number;
+    query?: string;
+    sessionCwd?: string;
+    signal?: AbortSignal;
+    workspaceId: string;
+}
+interface AgentActivityRuntimeListSessionsPageInput {
+    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;
+    sectionKey: string;
+    updatedAtUnixMs: number;
+}
+interface AgentActivityRuntimeSessionSection {
+    kind: "conversations" | "project";
+    sectionKey: string;
+    userProject?: AgentActivityRuntimeUserProject;
+    sessions: AgentActivitySession[];
+    hasMore: boolean;
+    nextCursor?: string;
+}
+interface AgentActivityRuntimeSessionPage {
+    sessions: AgentActivitySession[];
+    hasMore: boolean;
+    nextCursor?: string;
+}
+interface AgentActivityRuntimeSessionSectionsResult {
+    pinned?: AgentActivityRuntimeSessionPage;
+    sections: AgentActivityRuntimeSessionSection[];
+    workspaceId: string;
+}
+interface AgentActivityRuntimeGeneratedFile {
+    label: string;
+    path: string;
+}
+interface AgentActivityRuntimeGeneratedFileList {
+    entries: AgentActivityRuntimeGeneratedFile[];
+    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[];
+}
+interface AgentActivityRuntimeSessionSectionScopeInput {
+    agentTargetId?: string | null;
+    sectionKey: string;
+    signal?: AbortSignal;
+    workspaceId: string;
+}
+interface AgentActivityRuntimeSessionSectionCount {
+    agentTargetId?: string | null;
+    count: number;
+    sectionKey: string;
+    workspaceId: string;
+}
+interface AgentActivityRuntimeDeleteSessionSectionResult {
+    agentTargetId?: string | null;
+    removedMessages: number;
+    removedSessionIds: string[];
+    removedSessions: number;
+    sectionKey: string;
+    workspaceId: string;
+}
+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;
+    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>;
+    countSessionSection?(input: AgentActivityRuntimeSessionSectionScopeInput): Promise<AgentActivityRuntimeSessionSectionCount>;
+    deleteSessionSection?(input: AgentActivityRuntimeSessionSectionScopeInput): Promise<AgentActivityRuntimeDeleteSessionSectionResult>;
+    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>;
+    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;
+}
+interface AgentActivityRuntimeProviderProps extends PropsWithChildren {
+    runtime?: AgentActivityRuntime | null;
+}
+declare function AgentActivityRuntimeProvider({ children, runtime }: AgentActivityRuntimeProviderProps): JSX.Element;
+declare function useAgentActivityRuntime(): AgentActivityRuntime;
+declare function useOptionalAgentActivityRuntime(): AgentActivityRuntime | null;
+declare function useAgentActivitySnapshot(workspaceId: string): AgentActivitySnapshot;
+declare function resetAgentActivityRuntimeForTests(): void;
+declare function setAgentActivityRuntimeForTests(runtime: AgentActivityRuntime | null): 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[]>;
+
+type FocusNodeTargetZoom = 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;
+}
+
+interface WorkspaceReferencePickResult {
+    files: readonly WorkspaceFileReference[];
+    mentionItems: readonly AgentContextMentionItem[];
+}
+
+interface AgentComposerSubmitOptions {
+}
+interface AgentComposerProps {
+    workspaceId: string;
+    workspacePath?: string | null;
+    currentUserId?: string | null;
+    provider: string;
+    slashStatus?: AgentComposerSlashStatus | null;
+    usage?: AgentComposerUsage | null;
+    draftContent: AgentComposerDraft;
+    availableCommands: readonly AgentSessionCommand[];
+    hasCompactableContext?: boolean;
+    compactSupported?: boolean | null;
+    availableSkills?: readonly AgentGUIProviderSkillOption[];
+    disabled: boolean;
+    disabledReason?: string | null;
+    submitDisabled: boolean;
+    placeholder: string;
+    composerSettings: AgentGUIComposerSettingsVM;
+    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;
+    backgroundAgentStatusText?: string | 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;
+        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;
+        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;
+        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;
+        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) => 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;
+    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[];
+}
+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;
+}
+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;
+}
+
+type DotLottieElementProps = HTMLAttributes<HTMLElement> & {
+    autoplay?: boolean;
+    loop?: boolean;
+    src?: string;
+};
+declare module "react" {
+    namespace JSX {
+        interface IntrinsicElements {
+            "dotlottie-wc": DotLottieElementProps;
+        }
+    }
+}
+
+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"];
+}
+type AgentGUISidebarFooterRenderer = (ctx: AgentGUISidebarFooterContext) => ReactNode;
+/**
+ * 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;
+}
+
+interface AgentGUIOpenSessionRequest {
+    agentSessionId: 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: AgentProvider;
+        references: readonly WorkspaceFileReference[];
+    }) => void | Promise<void>;
+    agentSettings: Pick<AgentSettings, "avoidGroupingEdits">;
+}
+interface AgentGUINodeFrameLayout {
+    position: Point;
+    width: number;
+    height: number;
+    desktopSize: DesktopSize;
+    isMaximized?: boolean;
+    isActive: boolean;
+    embedded?: boolean;
+    previewMode?: boolean;
+}
+interface AgentGUINodeRuntimeRequests {
+    composerFocusSequence?: number | null;
+    newConversationSequence?: number | null;
+    openSession?: AgentGUIOpenSessionRequest | null;
+    prefillPrompt?: AgentGUIPrefillPromptRequest | null;
+    agentProbes?: WorkspaceDesktopAgentProbesState | null;
+    onProbeDemandChange?: WorkspaceDesktopAgentProbeDemandChange;
+    onProbeRefreshRequest?: WorkspaceDesktopAgentProbeRefreshRequest;
+}
+interface AgentGUINodeHostCapabilities {
+    capabilityMenuState?: AgentComposerCapabilityMenuState;
+    accountMenuState?: AgentGUIAccountMenuState | null;
+    agentTargets?: readonly AgentGUIAgentTarget[];
+    agentTargetsLoading?: boolean;
+    providerRailAllPresentation?: AgentGUIProviderRailAllPresentation | null;
+    providerRailMode?: AgentGUIProviderRailMode;
+    comingSoonProviders?: readonly AgentGUIProvider[];
+    providerReadinessGates?: Partial<Record<AgentGUIProvider, AgentGUIProviderReadinessGate | null>> | null;
+    defaultAgentTargetId?: string | null;
+    providerAuthAccountLabels?: Partial<Record<string, string>>;
+    managedAgentsState?: AgentHostManagedAgentsState | null;
+    contextMentionProviders?: readonly AgentContextMentionProvider[];
+    workspaceAppIcons?: readonly AgentMessageMarkdownWorkspaceAppIcon[];
+}
+interface AgentGUINodeHostActions {
+    onLinkAction?: (action: WorkspaceLinkAction) => void;
+    onHandoffConversation?: (input: {
+        agentTargetId?: string | null;
+        draftPrompt: string;
+        provider: AgentProvider;
+        userProjectPath?: string | null;
+    }) => void | Promise<void>;
+    onCapabilitySettingsRequest?: (capability: AgentComposerCapabilitySettingsTarget) => void;
+    onAgentProviderLogin?: (provider: AgentProvider) => void;
+    onOpenConversationWindow?: (agentSessionId: string) => void;
+    onClose: () => void;
+    onResize: (frame: NodeFrame) => void;
+    onUpdateNode: (updater: (current: AgentGUINodeData) => AgentGUINodeData) => void;
+    onRememberComposerDefaults?: (input: AgentGUIRememberComposerDefaultsInput) => void | Promise<void>;
+    isMuted?: boolean;
+    onMinimize?: () => void;
+    onToggleMaximize?: () => void;
+    onShowMessage?: (message: string, tone?: "info" | "warning" | "error") => void;
+}
+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" | "providerRailAllPresentation" | "providerRailMode">;
+type AgentGUIPublicRenderSlots = Omit<AgentGUINodeProps["renderSlots"], "providerRailEmpty">;
+interface AgentGUIProps extends Omit<AgentGUINodeProps, "hostCapabilities" | "renderSlots"> {
+    agentDirectory: AgentGUIAgentDirectorySnapshot;
+    allAgentsPresentation?: AgentGUIAllAgentsPresentation | null;
+    renderAgentsEmpty?: AgentGUIAgentsEmptyRenderer;
+    agentActivityRuntime: AgentActivityRuntime;
+    agentHostApi?: AgentHostInputApi | null;
+    i18n?: I18nRuntime<string> | null;
+    locale?: AgentGuiI18nLocale;
+    hostCapabilities: AgentGUIPublicHostCapabilities;
+    renderSlots: AgentGUIPublicRenderSlots;
+}
+declare const AgentGUI: react.NamedExoticComponent<AgentGUIProps>;
+
+export { type AgentActivityRuntime as A, type AgentActivityRuntimeDeleteSessionSectionResult as a, type AgentActivityRuntimeListSessionMessagesInput as b, type AgentActivityRuntimePromptContentBlock as c, AgentActivityRuntimeProvider as d, type AgentActivityRuntimeProviderProps as e, type AgentActivityRuntimeSessionSectionCount as f, type AgentActivityRuntimeSessionSectionScopeInput as g, type AgentActivityRuntimeSetSessionPinnedInput as h, type AgentActivityRuntimeUpdateSessionSettingsInput as i, type AgentActivityRuntimeUpdateSessionSettingsResult as j, type AgentActivityRuntimeUploadPromptContentInput as k, type AgentActivityRuntimeUploadPromptContentResult as l, AgentGUI as m, type AgentGUIAccountMenuState as n, type AgentGUIAgentsEmptyRenderer as o, type AgentGUIProps as p, type AgentGUIProviderUnavailableStateContext as q, type AgentGUIProviderUnavailableStateRenderer as r, type AgentGUISidebarFooterContext as s, type AgentGUISidebarFooterRenderer as t, resetAgentActivityRuntimeForTests as u, setAgentActivityRuntimeForTests as v, useAgentActivityRuntime as w, useAgentActivitySnapshot as x, useOptionalAgentActivityRuntime as y };