@tutti-os/agent-gui 0.0.23 → 0.0.24

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

@@ -27,8 +27,6 @@ interface AgentFileMentionPaletteProps {
     onSelectCategory: (categoryId: AgentMentionBrowseCategory["id"]) => void;
     onSelectFilter: (filter: AgentMentionFilterId) => void;
     onExpandGroup: (groupId: AgentMentionGroupId) => void;
-    onCycleFilter: () => void;
-    onMoveSelection: (delta: 1 | -1) => void;
     /**
      * 可选:点击 issue / app 行末尾的「查看产物文件」图标时回调(打开引用 picker 并定位)。
      * 仅 workspace-issue / workspace-app 行渲染该入口。
@@ -37,7 +35,7 @@ interface AgentFileMentionPaletteProps {
 }
 declare function flattenAgentMentionPaletteEntries(state: AgentMentionSearchState): AgentMentionPaletteEntry[];
 declare function groupStartKeys(state: AgentMentionSearchState): string[];
-declare function AgentFileMentionPalette({ state, highlightedKey, label, loadingLabel, emptyLabel, errorLabel, tabHintLabel, maxHeightPx, shouldCenterHighlightedItem, onHighlightChange, onSelectItem, onSelectCategory, onSelectFilter, onExpandGroup, onCycleFilter, onMoveSelection, onOpenReferences }: AgentFileMentionPaletteProps): React.JSX.Element;
+declare function AgentFileMentionPalette({ state, highlightedKey, label, loadingLabel, emptyLabel, errorLabel, tabHintLabel, maxHeightPx, shouldCenterHighlightedItem, onHighlightChange, onSelectItem, onSelectCategory, onSelectFilter, onExpandGroup, onOpenReferences }: AgentFileMentionPaletteProps): React.JSX.Element;
 declare const AgentContextMentionPalette: typeof AgentFileMentionPalette;
 type AgentContextMentionPaletteProps = AgentFileMentionPaletteProps;
 

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

@@ -4,7 +4,7 @@ import {
   AgentMentionSearchController,
   flattenAgentMentionPaletteEntries,
   groupStartKeys
-} from "../chunk-3LVEFR2N.js";
+} from "../chunk-Q6QE7JNG.js";
 import "../chunk-B7DTDZVT.js";
 import "../chunk-F7XLV7M3.js";
 import "../chunk-MTFSQWZ6.js";

package/dist/index.d.ts

@@ -1,10 +1,11 @@
 import { AgentActivityNeedsAttentionItem, AgentActivitySnapshot, AgentActivityCancelSessionInput, AgentActivityCancelSessionResult, AgentActivityCreateSessionInput, AgentActivitySession, AgentActivityDeleteSessionInput, AgentActivityDeleteSessionResult, AgentActivitySendInput, AgentActivityMessageOrder, AgentActivityMessagePage, AgentActivitySubmitInteractiveInput, AgentActivitySnapshotListener } from '@tutti-os/agent-activity-core';
 export { AgentActivityAdapter, AgentActivityController, AgentActivityMessage, AgentActivityNeedsAttentionItem, AgentActivitySnapshot, selectNeedsAttentionCount, selectNeedsAttentionItems } from '@tutti-os/agent-activity-core';
-import { m as WorkspaceAgentActivityListViewModel, g as AgentHostWorkspaceAgentSession, f as AgentHostWorkspaceAgentMessage, l as AgentHostWorkspaceAgentSnapshot, B as BuildWorkspaceAgentActivityListOptions, d as AgentHostRuntimeOpenclawGatewayWarmupResult, A as AgentHostBatchUserInfoInput, a as AgentHostBatchUserInfoResult, b as AgentHostDeleteWorkspaceAgentSessionInput, k as AgentHostWorkspaceAgentSessionSummaryInput, j as AgentHostWorkspaceAgentSessionSummary, e as AgentHostWorkspaceAgentListInput, i as AgentHostWorkspaceAgentSessionMessagesInput, h as AgentHostWorkspaceAgentSessionMessages, c as AgentHostManagedAgentsState } from './workspaceAgentActivityListViewModel-BK_J3aNX.js';
+import { m as WorkspaceAgentActivityListViewModel, g as AgentHostWorkspaceAgentSession, f as AgentHostWorkspaceAgentMessage, l as AgentHostWorkspaceAgentSnapshot, B as BuildWorkspaceAgentActivityListOptions, d as AgentHostRuntimeOpenclawGatewayWarmupResult, c as AgentHostManagedAgentsState } from './workspaceAgentActivityListViewModel-jRF8cP37.js';
 import * as react from 'react';
 import { PropsWithChildren, JSX } from 'react';
 import { I18nRuntime } from '@tutti-os/ui-i18n-runtime';
-import { WorkspaceUserProjectService } from '@tutti-os/workspace-user-project/contracts';
+import { d as AgentHostAgentSessionComposerSettings, c as AgentHostActivateAgentSessionResult, j as AgentHostUpdateAgentSessionSettingsResult, e as AgentHostAgentSessionState, i as AgentHostUnactivateAgentSessionResult, n as AgentProvider, m as AgentProbeSnapshot, a as AgentGUINodeViewModel, A as AgentGUINodeData, P as Point, N as NodeFrame, k as AgentMessageMarkdownWorkspaceAppIcon, g as AgentHostInputApi } from './AgentMessageMarkdown-DQL8udfP.js';
+export { f as AgentHostApi, h as AgentHostRuntimeApi, l as AgentProbeProvider, o as AgentProviderProbeListInput, p as AgentProviderProbeListResult, q as AgentUsageQuota, r as AgentUsageSnapshot } from './AgentMessageMarkdown-DQL8udfP.js';
 import { ReferenceLocateTarget, WorkspaceFileReferenceAdapter, WorkspaceFileReference } from '@tutti-os/workspace-file-reference/contracts';
 import { ReferenceSourceAggregator } from '@tutti-os/workspace-file-reference/core';
 import { W as WorkspaceLinkAction } from './workspaceLinkActions-CqWZaCY4.js';
@@ -12,174 +13,18 @@ import { A as AgentContextMentionItem } from './AgentMentionSearchController-2Vj
 export { p as preloadAgentMentionBrowse } from './AgentMentionSearchController-2Vjvmzh3.js';
 import { AgentContextMentionProvider } from './context-mention-provider.js';
 export { AGENT_CONTEXT_MENTION_PROVIDER_IDS, AgentContextMentionProviderId } from './context-mention-provider.js';
-import { A as AgentMessageMarkdownWorkspaceAppIcon } from './AgentMessageMarkdown-DeYPURtF.js';
 import { AgentGuiI18nLocale } from './i18n/index.js';
 export { AgentGuiI18nProvider, agentGuiI18nModule, agentGuiI18nResources } from './i18n/index.js';
+import './agentConversationVM-BvlmCNOm.js';
+import '@tutti-os/workspace-user-project/contracts';
 import '@tutti-os/workspace-issue-manager/core';
 import '@tutti-os/ui-rich-text/at-panel';
 import '@tutti-os/ui-rich-text/types';
 import '@tutti-os/workspace-external-core/contracts';
 
-type AgentHostAgentSessionProvider = "claude-code" | "codex" | "nexight" | "gemini" | "hermes" | "openclaw";
-type AgentHostAgentSessionPermissionModeSemantic = "ask-before-write" | "accept-edits" | "locked-down" | "auto" | "full-access" | "unconfigurable";
-type AgentHostAgentSessionReasoningEffort = "minimal" | "low" | "medium" | "high" | "xhigh" | string;
-type AgentHostAgentSessionSpeed = "standard" | "fast" | string;
-interface AgentHostAgentSessionPermissionModeOption {
-    id: string;
-    label?: string;
-    description?: string;
-    semantic: AgentHostAgentSessionPermissionModeSemantic;
-}
-interface AgentHostAgentSessionPermissionConfig {
-    configurable: boolean;
-    defaultValue?: string | null;
-    modes: AgentHostAgentSessionPermissionModeOption[];
-}
-interface AgentHostAgentSessionComposerSettings {
-    model?: string | null;
-    reasoningEffort?: AgentHostAgentSessionReasoningEffort | null;
-    speed?: AgentHostAgentSessionSpeed | null;
-    planMode?: boolean;
-    browserUse?: boolean;
-    computerUse?: boolean;
-    permissionModeId?: string | null;
-}
-interface AgentHostAgentSession {
-    workspaceId: string;
-    agentSessionId: string;
-    provider: AgentHostAgentSessionProvider;
-    providerSessionId: string;
-    resumable?: boolean;
-    cwd?: string;
-    status: "ready" | "working" | "canceled" | "failed" | "completed" | string;
-    title?: string;
-    pinnedAtUnixMs?: number | null;
-    visible?: boolean;
-    permissionModeId?: string;
-    permissionConfig?: AgentHostAgentSessionPermissionConfig;
-    settings?: AgentHostAgentSessionComposerSettings;
-    createdAtUnixMs: number;
-    updatedAtUnixMs: number;
-}
-interface AgentHostAgentSessionInteractivePrompt {
-    kind: string;
-    requestId?: string;
-    toolName?: string;
-    status?: string;
-    input?: Record<string, unknown>;
-    output?: Record<string, unknown>;
-    error?: Record<string, unknown>;
-    metadata?: Record<string, unknown>;
-}
-interface AgentHostAgentSessionState {
-    workspaceId: string;
-    agentSessionId: string;
-    provider: AgentHostAgentSessionProvider;
-    providerSessionId?: string;
-    resumable?: boolean;
-    status: AgentHostAgentSession["status"];
-    permissionModeId?: string;
-    permissionConfig?: AgentHostAgentSessionPermissionConfig;
-    settings?: AgentHostAgentSessionComposerSettings;
-    authState?: string;
-    runtimeContext?: Record<string, unknown>;
-    pinnedAtUnixMs?: number | null;
-    pendingInteractive?: AgentHostAgentSessionInteractivePrompt | null;
-    updatedAtUnixMs: number;
-}
-type AgentHostAgentSessionActivationMode = "new" | "existing";
-type AgentHostAgentSessionActivationStatus = "attached" | "already_attached" | "failed";
-interface AgentHostActivateAgentSessionResult {
-    session: AgentHostAgentSession;
-    activation: {
-        mode: AgentHostAgentSessionActivationMode;
-        status: AgentHostAgentSessionActivationStatus;
-    };
-    error?: {
-        code: string;
-        message: string;
-        debugMessage?: string;
-    };
-}
-interface AgentHostUnactivateAgentSessionResult {
-    agentSessionId: string;
-    buffered: boolean;
-}
-interface AgentHostUpdateAgentSessionSettingsResult {
-    agentSessionId: string;
-    settings: AgentHostAgentSessionComposerSettings;
-}
-
-type AgentAvailabilityStatus = "available" | "unavailable" | "unknown";
-type AgentQuotaType = "session" | "weekly" | "monthly" | "daily" | "model" | "cost";
-interface AgentAvailabilityCheck {
-    name: string;
-    passed: boolean;
-    detail?: string;
-}
-interface AgentAvailability {
-    status: AgentAvailabilityStatus;
-    detailsVisible: boolean;
-    checks?: AgentAvailabilityCheck[];
-}
-interface AgentUsageQuota {
-    quotaType: AgentQuotaType;
-    percentRemaining?: number;
-    resetsAtUnixMs?: number;
-    resetText?: string;
-    dollarRemaining?: number;
-    modelName?: string;
-}
-interface AgentCostUsage {
-    dollarUsed: number;
-    dollarLimit?: number;
-}
-interface AgentUsageSnapshot {
-    quotas?: AgentUsageQuota[];
-    accountTier?: string;
-    costUsage?: AgentCostUsage;
-    capturedAtUnixMs: number;
-}
-interface AgentProbeAttempt {
-    strategy: string;
-    success: boolean;
-    errorCode?: string;
-    errorMessage?: string;
-}
-interface AgentProbeError {
-    code: string;
-    message?: string;
-}
-interface AgentProbeProvider {
-    provider: string;
-    availability: AgentAvailability;
-    usage?: AgentUsageSnapshot;
-    attempts?: AgentProbeAttempt[];
-    lastError?: AgentProbeError;
-}
-interface AgentProbeSnapshot {
-    workspaceId: string;
-    roomId?: string;
-    capturedAtUnixMs: number;
-    providers: AgentProbeProvider[];
-}
-interface AgentHostListWorkspaceAgentProbesInput {
-    workspaceId: string;
-    /** Compatibility input while carried call sites finish migrating from TSH room naming. */
-    roomId?: string;
-    providers?: string[];
-    includeUsage?: boolean;
-    refresh?: boolean;
-}
-type AgentHostWorkspaceAgentProbesResult = AgentProbeSnapshot;
-
 declare const APP_UPDATE_POLICIES: readonly ["off", "prompt", "auto"];
 type AppUpdatePolicy = (typeof APP_UPDATE_POLICIES)[number];
 
-interface ReadWorkspaceFileResult {
-    bytes: Uint8Array;
-}
-
 interface AgentActivitySnapshotProjection {
     view: WorkspaceAgentActivityListViewModel;
     sessionsById: Record<string, AgentHostWorkspaceAgentSession>;
@@ -365,242 +210,10 @@ declare function getOptionalAgentActivityRuntime(): AgentActivityRuntime | null;
 declare function resetAgentActivityRuntimeForTests(): void;
 declare function setAgentActivityRuntimeForTests(runtime: AgentActivityRuntime | null): void;
 
-type AgentHostAsyncResult<T = any> = Promise<T>;
-type AgentHostRecord = Record<string, unknown>;
-type AgentHostUnsubscribe = () => void;
-type AgentHostWorkspaceScopedInput<T extends {
-    workspaceId?: string | null;
-}> = Omit<T, "workspaceId"> & {
-    workspaceId: string;
-};
-type AgentHostWorkspaceAgentsListInput = AgentHostWorkspaceScopedInput<AgentHostWorkspaceAgentListInput>;
-type AgentHostWorkspaceAgentSessionMessagesRuntimeInput = AgentHostWorkspaceScopedInput<AgentHostWorkspaceAgentSessionMessagesInput>;
-type AgentHostWorkspaceAgentSessionSummaryRuntimeInput = AgentHostWorkspaceScopedInput<AgentHostWorkspaceAgentSessionSummaryInput>;
-type AgentHostDeleteWorkspaceAgentSessionRuntimeInput = AgentHostWorkspaceScopedInput<AgentHostDeleteWorkspaceAgentSessionInput>;
-type AgentHostClipboardApi = {
-    writeText: (text: string) => AgentHostAsyncResult<void>;
-};
-type AgentHostDebugApi = {
-    logRuntimeDiagnostics: (payload: unknown) => AgentHostAsyncResult<void> | void;
-    logTerminalDiagnostics?: (payload: unknown) => AgentHostAsyncResult<void> | void;
-};
-type AgentHostFilesystemApi = AgentHostRecord & {
-    readFileText: (payload: {
-        path?: string;
-        uri?: string;
-    }) => AgentHostAsyncResult<{
-        content: string;
-        name?: string;
-        path?: string;
-    }>;
-};
-type AgentHostMetaApi = AgentHostRecord & {
-    appVersion?: string | null;
-    isPackaged?: boolean;
-    isTest?: boolean;
-    mainPid?: number | null;
-    platform?: string;
-    workspaceId?: string;
-};
-type AgentHostEnvironmentApi = AgentHostRecord & {
-    getBaseUrl?: () => AgentHostAsyncResult<string>;
-    warmupOpenclawGateway?: (input?: unknown) => AgentHostAsyncResult<unknown>;
-};
-interface AgentHostSelectedFile {
-    name?: string;
-    path: string;
-}
-type AgentHostWorkspaceApi = AgentHostRecord & {
-    copyPath?: (input: {
-        path: string;
-    }) => AgentHostAsyncResult<void>;
-    ensureDirectory: (input: {
-        path: string;
-    }) => AgentHostAsyncResult<void>;
-    getPathForFile: (file: File) => string;
-    readFile: (input: {
-        path: string;
-    }) => AgentHostAsyncResult<ReadWorkspaceFileResult>;
-    selectContextEntries?: () => AgentHostAsyncResult<{
-        entries: unknown[];
-    }>;
-    selectDirectory: () => AgentHostAsyncResult<{
-        path: string;
-    } | null>;
-    selectFiles: () => AgentHostAsyncResult<AgentHostSelectedFile[]>;
-    writeFileText: (input: {
-        content: string;
-        path: string;
-    }) => AgentHostAsyncResult<unknown>;
-};
-interface AgentHostInputApi {
-    account?: AgentHostAccountApi;
-    agentGuiBatch?: AgentHostAgentGuiBatchApi;
-    agentSessions?: AgentHostAgentSessionsApi;
-    clipboard: AgentHostClipboardApi;
-    debug?: AgentHostDebugApi;
-    filesystem: AgentHostFilesystemApi;
-    meta?: AgentHostMetaApi;
-    onHostEvent?: (listener: (event: any) => void) => AgentHostUnsubscribe;
-    runtime?: AgentHostEnvironmentApi;
-    userProjects?: AgentHostUserProjectsApi;
-    workspace: AgentHostWorkspaceApi;
-    workspaceAgentProbes?: AgentHostWorkspaceAgentProbesApi;
-    workspaceAgents?: AgentHostWorkspaceAgentsApi;
-}
-type AgentHostApi = AgentHostInputApi;
-type AgentHostAccountApi = AgentHostRecord & {
-    batchGetUserInfo: (input: AgentHostBatchUserInfoInput) => AgentHostAsyncResult<AgentHostBatchUserInfoResult>;
-    ensureProfiles?: (input: any) => AgentHostAsyncResult<any>;
-};
-type AgentHostAgentGuiBatchApi = AgentHostRecord & {
-    exportRun: (input: any) => AgentHostAsyncResult<any>;
-};
-type AgentHostWorkspaceAgentProbesApi = AgentHostRecord & {
-    list: (input: AgentHostListWorkspaceAgentProbesInput) => AgentHostAsyncResult<AgentHostWorkspaceAgentProbesResult>;
-};
-type AgentProviderProbeListInput = AgentHostListWorkspaceAgentProbesInput;
-type AgentProviderProbeListResult = AgentHostWorkspaceAgentProbesResult;
-interface AgentHostUserProject {
-    id: string;
-    path: string;
-    label: string;
-    createdAtUnixMs?: number;
-    updatedAtUnixMs?: number;
-    lastUsedAtUnixMs?: number;
-}
-type AgentHostUserProjectsApi = AgentHostRecord & {
-    service?: WorkspaceUserProjectService;
-    checkPath?: (input: {
-        path: string;
-    }) => AgentHostAsyncResult<{
-        exists: boolean;
-        isDirectory: boolean;
-        path: string;
-    }>;
-    create?: (input: {
-        name: string;
-    }) => AgentHostAsyncResult<AgentHostUserProject>;
-    getDefaultSelection?: () => AgentHostAsyncResult<{
-        path: string | null;
-    } | null>;
-    list: () => AgentHostAsyncResult<{
-        projects: AgentHostUserProject[];
-    }>;
-    subscribe?: (listener: () => void) => AgentHostUnsubscribe;
-    prepareSelection?: (input: {
-        projectLocked: boolean;
-        selectedPath: string | null;
-    }) => AgentHostAsyncResult<{
-        isSelectedPathMissing: boolean;
-        projects: AgentHostUserProject[];
-        selection: {
-            kind: "clear";
-            suppressedPath: string;
-        } | {
-            kind: "none";
-        } | {
-            kind: "select";
-            path: string;
-        };
-    }>;
-    remove?: (input: {
-        path: string;
-    }) => AgentHostAsyncResult<void>;
-    isNoProjectPath?: (input: {
-        path: string;
-    }) => boolean;
-    rememberDefaultSelection?: (input: {
-        path: string | null;
-    }) => AgentHostAsyncResult<void>;
-    use: (input: {
-        path: string;
-    }) => AgentHostAsyncResult<AgentHostUserProject>;
-};
-type AgentHostAgentSessionsApi = AgentHostRecord & {
-    activate: (input: any) => AgentHostAsyncResult<any>;
-    /**
-     * @deprecated AgentGUI production writes must use AgentActivityRuntime.cancelSession.
-     */
-    cancel: (input: any) => AgentHostAsyncResult<any>;
-    /**
-     * @deprecated AgentGUI production writes must use AgentActivityRuntime.sendInput.
-     */
-    exec: (input: any) => AgentHostAsyncResult<any>;
-    getComposerOptions?: (input: any) => AgentHostAsyncResult<any>;
-    getState: (input: any) => AgentHostAsyncResult<any>;
-    onEvent?: (listener: (event: any) => void) => AgentHostUnsubscribe;
-    /**
-     * @deprecated AgentGUI production writes must use AgentActivityRuntime.setSessionPinned.
-     */
-    pinSession?: (input: any) => AgentHostAsyncResult<any>;
-    /**
-     * @deprecated AgentGUI production sync must use AgentActivityRuntime.ensureSessionSynchronized.
-     */
-    releaseEventStream?: (input?: any) => AgentHostAsyncResult;
-    /**
-     * @deprecated AgentGUI production sync must use AgentActivityRuntime.ensureSessionSynchronized.
-     */
-    retainEventStream?: (input: any) => AgentHostAsyncResult;
-    /**
-     * @deprecated AgentGUI production writes must use AgentActivityRuntime.submitInteractive.
-     */
-    submitInteractive: (input: any) => AgentHostAsyncResult<any>;
-    /**
-     * @deprecated AgentGUI production UI must derive events from AgentActivityRuntime snapshots.
-     */
-    trackSettingsProjectChange?: (input: {
-        action: "clear" | "create_new" | "select_existing";
-        agentSessionId: string;
-        provider?: string | null;
-    }) => AgentHostAsyncResult<void>;
-    subscribeEvents: (input: any, listener: (event: any) => void) => AgentHostUnsubscribe;
-    unactivate: (input: any) => AgentHostAsyncResult<any>;
-    updateSettings: (input: any) => AgentHostAsyncResult<any>;
-};
-/**
- * @deprecated Legacy host DTO projection. AgentGUI production reads and writes
- * must use AgentActivityRuntime and AgentActivity* models.
- */
-type AgentHostWorkspaceAgentsApi = AgentHostRecord & {
-    /**
-     * @deprecated Use AgentActivityRuntime.deleteSession.
-     */
-    deleteSession: (input: AgentHostDeleteWorkspaceAgentSessionRuntimeInput) => AgentHostAsyncResult<any>;
-    /**
-     * @deprecated Derive summaries from AgentActivitySnapshot/session messages.
-     */
-    getSessionSummary: (input: AgentHostWorkspaceAgentSessionSummaryRuntimeInput) => AgentHostAsyncResult<AgentHostWorkspaceAgentSessionSummary>;
-    /**
-     * @deprecated Use AgentActivityRuntime.load/getSnapshot.
-     */
-    list: (input: string | AgentHostWorkspaceAgentsListInput) => AgentHostAsyncResult<AgentHostWorkspaceAgentSnapshot>;
-    /**
-     * @deprecated Use AgentActivityRuntime.listSessionMessages.
-     */
-    listSessionMessages: (input: AgentHostWorkspaceAgentSessionMessagesRuntimeInput) => AgentHostAsyncResult<AgentHostWorkspaceAgentSessionMessages>;
-};
-interface AgentHostRuntimeApi {
-    account?: AgentHostAccountApi;
-    agentGuiBatch: AgentHostAgentGuiBatchApi;
-    clipboard: AgentHostClipboardApi;
-    debug?: AgentHostDebugApi;
-    filesystem: AgentHostFilesystemApi;
-    meta?: AgentHostMetaApi;
-    onHostEvent?: (listener: (event: any) => void) => AgentHostUnsubscribe;
-    runtime?: AgentHostEnvironmentApi;
-    userProjects?: AgentHostUserProjectsApi;
-    workspace: AgentHostWorkspaceApi;
-    workspaceAgentProbes?: AgentHostWorkspaceAgentProbesApi;
-}
-
 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", "nexight", "opencode", "gemini", "openclaw", "hermes"];
-type AgentProvider = (typeof AGENT_PROVIDERS)[number];
-
 type FocusNodeTargetZoom = number;
 
 declare const UI_LANGUAGES: readonly ["en", "zh-CN"];
@@ -696,30 +309,6 @@ interface AgentSettings {
     hideWorktreeMismatchDropWarning: boolean;
 }
 
-interface AgentGUINodeData {
-    provider: AgentGUIProvider;
-    lastActiveAgentSessionId: string | null;
-    lastActiveConversationTitle?: string | null;
-    conversationCount?: number | null;
-    conversationRailWidthPx?: number | null;
-    conversationRailCollapsed?: boolean | null;
-    composerOverrides?: AgentHostAgentSessionComposerSettings | null;
-    composerOverridesByProvider?: Partial<Record<AgentGUIProvider, AgentHostAgentSessionComposerSettings | null>> | null;
-}
-type AgentGUIProvider = Extract<AgentProvider, "claude-code" | "codex" | "nexight" | "gemini" | "hermes" | "openclaw">;
-interface Size {
-    width: number;
-    height: number;
-}
-interface Point {
-    x: number;
-    y: number;
-}
-interface NodeFrame {
-    position: Point;
-    size: Size;
-}
-
 interface DesktopSize {
     width: number;
     height: number;
@@ -776,6 +365,12 @@ type AgentComposerGitBranchLoader = (input: {
  * 由宿主(desktop)注入 —— 源 id 与 params 形态是宿主侧 reference source 的知识。
  */
 type AgentMentionReferenceTargetResolver = (item: AgentContextMentionItem) => ReferenceLocateTarget | null;
+interface AgentWorkspaceReferenceInitialTargetInput {
+    activeConversation: AgentGUINodeViewModel["activeConversation"];
+    composerSelectedProjectPath: string | null;
+    userProjects: AgentGUINodeViewModel["userProjects"];
+}
+type AgentWorkspaceReferenceInitialTargetResolver = (input: AgentWorkspaceReferenceInitialTargetInput) => ReferenceLocateTarget | null;
 
 interface AgentGUINodeProps {
     nodeId: string;
@@ -786,6 +381,7 @@ interface AgentGUINodeProps {
     onRequestGitBranches?: AgentComposerGitBranchLoader | null;
     referenceSourceAggregator?: ReferenceSourceAggregator | null;
     resolveMentionReferenceTarget?: AgentMentionReferenceTargetResolver | null;
+    resolveWorkspaceReferenceInitialTarget?: AgentWorkspaceReferenceInitialTargetResolver | null;
     agentSettings: Pick<AgentSettings, "avoidGroupingEdits">;
     title: string;
     state: AgentGUINodeData;
@@ -875,4 +471,4 @@ interface AgentActivityHostProviderProps extends PropsWithChildren {
 }
 declare function AgentActivityHostProvider({ agentActivityRuntime, agentHostApi, children }: AgentActivityHostProviderProps): JSX.Element;
 
-export { AgentActivityHostProvider, type AgentActivityHostProviderProps, type AgentActivityRuntime, type AgentActivityRuntimeListSessionMessagesInput, type AgentActivityRuntimePromptContentBlock, AgentActivityRuntimeProvider, type AgentActivityRuntimeProviderProps, type AgentActivityRuntimeRetainSessionEventsInput, type AgentActivityRuntimeSetSessionPinnedInput, type AgentActivityRuntimeUpdateSessionSettingsInput, type AgentActivityRuntimeUploadPromptContentInput, type AgentActivityRuntimeUploadPromptContentResult, type AgentActivityRuntimeWarmupOpenclawGatewayInput, type AgentActivitySnapshotProjection, AgentContextMentionProvider, AgentGUI, type AgentGUIProps, AgentGuiI18nLocale, type AgentHostApi, type AgentHostInputApi, type AgentHostRuntimeApi, type AgentProbeProvider, type AgentProbeSnapshot, type AgentProviderProbeListInput, type AgentProviderProbeListResult, type AgentUsageQuota, type AgentUsageSnapshot, agentGuiDockIconUrl, agentGuiDockIconUrls, agentHostSnapshotFromAgentActivitySnapshot, buildAgentActivitySnapshotProjection, getAgentActivityRuntime, getOptionalAgentActivityRuntime, projectCoreSessionStatus, resetAgentActivityRuntimeForTests, resolveAgentGUIExpandedWindowFrame, setAgentActivityRuntimeForTests, shouldAutoCollapseAgentGUIConversationRail, useAgentActivityRuntime, useAgentActivitySnapshot, useOptionalAgentActivityRuntime };
+export { AgentActivityHostProvider, type AgentActivityHostProviderProps, type AgentActivityRuntime, type AgentActivityRuntimeListSessionMessagesInput, type AgentActivityRuntimePromptContentBlock, AgentActivityRuntimeProvider, type AgentActivityRuntimeProviderProps, type AgentActivityRuntimeRetainSessionEventsInput, type AgentActivityRuntimeSetSessionPinnedInput, type AgentActivityRuntimeUpdateSessionSettingsInput, type AgentActivityRuntimeUploadPromptContentInput, type AgentActivityRuntimeUploadPromptContentResult, type AgentActivityRuntimeWarmupOpenclawGatewayInput, type AgentActivitySnapshotProjection, AgentContextMentionProvider, AgentGUI, type AgentGUIProps, AgentGuiI18nLocale, AgentHostInputApi, AgentProbeSnapshot, agentGuiDockIconUrl, agentGuiDockIconUrls, agentHostSnapshotFromAgentActivitySnapshot, buildAgentActivitySnapshotProjection, getAgentActivityRuntime, getOptionalAgentActivityRuntime, projectCoreSessionStatus, resetAgentActivityRuntimeForTests, resolveAgentGUIExpandedWindowFrame, setAgentActivityRuntimeForTests, shouldAutoCollapseAgentGUIConversationRail, useAgentActivityRuntime, useAgentActivitySnapshot, useOptionalAgentActivityRuntime };