@tutti-os/agent-gui 0.0.93 → 0.0.95

package/dist/{agentConversationVM-CfXN_TQ2.d.ts → agentConversationVM-C335TR6S.d.ts}

@@ -1,4 +1,112 @@
-import { W as WorkspaceAgentActivityCard, n as WorkspaceAgentActivitySession, T as ToolCallStatusKind, q as WorkspaceAgentActivityTimelineItem } from './workspaceAgentActivityListViewModel-TXH1VXrk.js';
+import { WorkspaceIssueMentionMode } from '@tutti-os/workspace-issue-manager/core';
+import { W as WorkspaceAgentActivityCard, T as ToolCallStatusKind } from './workspaceAgentActivityListTypes-C7gPWYiA.js';
+import { AgentActivitySession } from '@tutti-os/agent-activity-core';
+
+type WorkspaceLinkActionSource = "agent-markdown" | "agent-file-change" | string;
+interface OpenWorkspaceFileLinkAction {
+    type: "open-workspace-file";
+    mode?: "reveal" | "open-directory";
+    path: string;
+    directoryPath: string;
+    workspaceRoot: string;
+    source: WorkspaceLinkActionSource;
+    prefetchedDirectoryListing?: WorkspaceFileLinkDirectoryListing | null;
+}
+interface OpenLocalAssetPreviewLinkAction {
+    type: "open-local-asset-preview";
+    path: string;
+    name: string;
+    source: WorkspaceLinkActionSource;
+}
+interface WorkspaceFileLinkDirectoryEntry {
+    path: string;
+    name: string;
+    kind: "file" | "directory" | "unknown";
+    hasChildren: boolean | null;
+    sizeBytes: number | null;
+    mtimeMs: number | null;
+}
+interface WorkspaceFileLinkDirectoryListing {
+    workspaceId: string;
+    root: string;
+    directoryPath: string;
+    entries: WorkspaceFileLinkDirectoryEntry[];
+}
+interface OpenWorkspaceUrlLinkAction {
+    type: "open-url";
+    url: string;
+    source: WorkspaceLinkActionSource;
+}
+interface OpenAgentSessionLinkAction {
+    type: "open-agent-session";
+    workspaceId: string;
+    agentSessionId: string;
+    agentTargetId?: string | null;
+    source: WorkspaceLinkActionSource;
+}
+interface OpenWorkspaceIssueLinkAction {
+    type: "open-workspace-issue";
+    workspaceId: string;
+    issueId: string | null;
+    mode?: WorkspaceIssueMentionMode;
+    outputDir?: string | null;
+    runId?: string | null;
+    taskId?: string | null;
+    topicId?: string | null;
+    source: WorkspaceLinkActionSource;
+}
+interface OpenWorkspaceAppLinkAction {
+    type: "open-workspace-app";
+    workspaceId: string;
+    appId: string;
+    conversationId?: string | null;
+    messageId?: string | null;
+    summaryTaskId?: string | null;
+    source: WorkspaceLinkActionSource;
+}
+interface OpenCustomMentionLinkAction {
+    type: "open-custom-mention";
+    /** 注册表里的 kind(= mention:// providerId)。 */
+    kind: string;
+    href: string;
+    source: WorkspaceLinkActionSource;
+}
+type WorkspaceLinkAction = OpenWorkspaceFileLinkAction | OpenLocalAssetPreviewLinkAction | OpenWorkspaceUrlLinkAction | OpenAgentSessionLinkAction | OpenWorkspaceIssueLinkAction | OpenWorkspaceAppLinkAction | OpenCustomMentionLinkAction;
+
+interface WorkspaceAgentActivityFileChange {
+    path: string;
+    change?: "added" | "modified" | "deleted" | "moved" | string;
+    tools?: string[];
+}
+interface WorkspaceAgentActivityFileChanges {
+    coverage?: string;
+    files?: WorkspaceAgentActivityFileChange[];
+}
+interface WorkspaceAgentActivityTimelineItem {
+    id: number;
+    workspaceId?: string;
+    agentSessionId: string;
+    seq?: number;
+    turnId?: string;
+    eventSource?: string;
+    eventId: string;
+    actorType: string;
+    actorId: string;
+    itemType: "message" | "call" | "event" | "error" | "lifecycle" | string;
+    role?: string;
+    callType?: "tool" | "skill" | "subagent" | "approval" | "workflow" | string;
+    callId?: string;
+    name?: string;
+    status?: string | null;
+    content?: string;
+    payload?: Record<string, unknown> & {
+        content?: unknown;
+        text?: unknown;
+        fileChanges?: WorkspaceAgentActivityFileChanges;
+    };
+    occurredAtUnixMs?: number;
+    createdAtUnixMs?: number;
+}
 
 interface WorkspaceAgentSessionDetailMessage {
     id: string;
@@ -81,7 +189,7 @@ interface WorkspaceAgentSessionDetailTurn {
 }
 interface WorkspaceAgentSessionDetailViewModel {
     activity: WorkspaceAgentActivityCard;
-    session: WorkspaceAgentActivitySession;
+    session: AgentActivitySession;
     cwd: string;
     workspaceRoot: string | null;
     turns: WorkspaceAgentSessionDetailTurn[];
@@ -89,7 +197,7 @@ interface WorkspaceAgentSessionDetailViewModel {
 }
 interface BuildWorkspaceAgentSessionDetailInput {
     activity: WorkspaceAgentActivityCard;
-    session: WorkspaceAgentActivitySession;
+    session: AgentActivitySession;
     timelineItems: WorkspaceAgentActivityTimelineItem[];
     workspaceRoot?: string | null;
 }
@@ -376,14 +484,11 @@ type AgentConversationPromptVM = AgentApprovalItemVM | {
     requestId: string;
     title: string;
 };
-type AgentConversationPendingInteractivePromptVM = Exclude<AgentConversationPromptVM, AgentApprovalItemVM>;
 interface AgentConversationVM {
     activity: WorkspaceAgentActivityCard;
     workspaceRoot: string | null;
     sourceDetail: WorkspaceAgentSessionDetailViewModel;
     rows: AgentTranscriptRowVM[];
-    pendingApproval: AgentApprovalItemVM | null;
-    pendingInteractivePrompt: AgentConversationPendingInteractivePromptVM | null;
 }
 
-export { type AgentApprovalItemVM as A, type BuildWorkspaceAgentSessionDetailInput as B, type WorkspaceAgentSessionDetailViewModel as W, type AgentAskUserQuestionVM as a, type AgentConversationPromptVM as b, type AgentConversationVM as c, buildWorkspaceAgentSessionDetailViewModel as d };
+export { type AgentApprovalItemVM as A, type BuildWorkspaceAgentSessionDetailInput as B, type WorkspaceAgentActivityTimelineItem as W, type AgentAskUserQuestionVM as a, type AgentConversationPromptVM as b, type AgentConversationVM as c, type WorkspaceAgentSessionDetailViewModel as d, type WorkspaceLinkAction as e, buildWorkspaceAgentSessionDetailViewModel as f };

package/dist/agentFileMentionContracts-Czvz6YMI.d.ts

@@ -0,0 +1,107 @@
+type AgentFileMentionKind = "file" | "directory" | "unknown";
+type AgentMentionFileNavigationAction = "agent-generated-folder" | "agent-generated-folder-back";
+type AgentMentionScope = "my_sessions" | "collab_sessions";
+type AgentMentionReferenceSource = "app" | "task";
+interface AgentMentionFileItem {
+    kind: "file";
+    path: string;
+    href: string;
+    name: string;
+    entryKind: AgentFileMentionKind;
+    directoryPath: string;
+    score?: number;
+    thumbnailUrl?: string | null;
+    mentionNavigation?: AgentMentionFileNavigationAction;
+    childCount?: number;
+}
+interface AgentMentionSessionItem {
+    kind: "session";
+    href: string;
+    workspaceId: string;
+    targetId: string;
+    agentTargetId?: string;
+    name: string;
+    title: string;
+    scope: AgentMentionScope;
+    initiatorName: string;
+    initiatorAvatarUrl?: string;
+    agentName: string;
+    status?: string;
+    inputPreview?: string;
+    summaryPreview?: string;
+    updatedAtUnixMs?: number;
+}
+interface AgentMentionWorkspaceIssueItem {
+    kind: "workspace-issue";
+    href: string;
+    workspaceId: string;
+    targetId: string;
+    topicId?: string;
+    name: string;
+    title: string;
+    creatorName?: string;
+    status?: string;
+    contentPreview?: string;
+    updatedAtUnixMs?: number;
+}
+interface AgentMentionWorkspaceAppItem {
+    kind: "workspace-app";
+    href: string;
+    workspaceId: string;
+    targetId: string;
+    appId: string;
+    name: string;
+    description?: string;
+    iconUrl?: string;
+    /** 应用是否能够提供产物文件(reference),决定 @ 面板行末尾是否展示「查看产物」入口。 */
+    referencesListSupported?: boolean;
+}
+interface AgentMentionAgentTargetItem {
+    kind: "agent-target";
+    href: string;
+    workspaceId: string;
+    targetId: string;
+    name: string;
+    description?: string;
+    agentProviderId?: string;
+    iconUrl?: string;
+}
+interface AgentMentionWorkspaceReferenceItem {
+    kind: "workspace-reference";
+    href: string;
+    workspaceId: string;
+    /** URI path id:source=app 时为 appId,source=task 时为 topicId。 */
+    targetId: string;
+    source: AgentMentionReferenceSource;
+    /** 子级 id:app 子分组 / issueId。缺省表示整个 app / topic。 */
+    groupId?: string;
+    name: string;
+    iconUrl?: string;
+    /** 展示用文件数(来自 picker 节点 childCount);序列化不再展开文件。 */
+    fileCount: number;
+}
+interface AgentMentionWorkspaceAppFactoryItem {
+    kind: "workspace-app-factory";
+    href: string;
+    workspaceId: string;
+    targetId: string;
+    jobId: string;
+    name: string;
+    action?: string;
+    contextPath?: string;
+}
+interface AgentMentionCustomItem {
+    kind: "custom";
+    /** 注册表里的 kind(= mention:// providerId)。 */
+    customKind: string;
+    href: string;
+    workspaceId: string;
+    targetId: string;
+    /** chip 第一行。 */
+    name: string;
+    /** chip 第二行(通用双行卡)。 */
+    summary?: string;
+}
+type AgentContextMentionItem = AgentMentionFileItem | AgentMentionAgentTargetItem | AgentMentionSessionItem | AgentMentionWorkspaceAppItem | AgentMentionWorkspaceReferenceItem | AgentMentionWorkspaceAppFactoryItem | AgentMentionWorkspaceIssueItem | AgentMentionCustomItem;
+
+export type { AgentContextMentionItem as A };

package/dist/{agentGuiNodeTypes-rGaDqxVR.d.ts → agentGuiNodeTypes-DppADPHW.d.ts}

@@ -1,7 +1,7 @@
-import { AgentActivityUsage } from '@tutti-os/agent-activity-core';
-import { k as AgentHostAgentSessionCommand, l as AgentHostAgentSessionComposerSettings, n as AgentHostAgentSessionReasoningEffort, o as AgentHostAgentSessionSpeed, m as AgentHostAgentSessionPermissionConfig, p as AgentHostAgentSessionState, h as AgentGUIProvider, s as AgentPromptContentBlock, g as AgentGUINodeData, e as AgentGUIAgentTarget, i as AgentGUIProviderReadinessGate } from './types-PLFZ8SBX.js';
-import { A as AgentHostBatchUserInfoInput, a as AgentHostBatchUserInfoResult, b as AgentHostDeleteWorkspaceAgentSessionInput, k as AgentHostWorkspaceAgentSessionSummaryInput, j as AgentHostWorkspaceAgentSessionSummary, e as AgentHostWorkspaceAgentListInput, l as AgentHostWorkspaceAgentSnapshot, i as AgentHostWorkspaceAgentSessionMessagesInput, h as AgentHostWorkspaceAgentSessionMessages, p as WorkspaceAgentActivitySyncState } from './workspaceAgentActivityListViewModel-TXH1VXrk.js';
-import { A as AgentApprovalItemVM, a as AgentAskUserQuestionVM, b as AgentConversationPromptVM, c as AgentConversationVM, W as WorkspaceAgentSessionDetailViewModel } from './agentConversationVM-CfXN_TQ2.js';
+import { AgentActivitySession, AgentActivitySlashCommandPolicy, AgentActivityUsage, CanonicalAgentSession } from '@tutti-os/agent-activity-core';
+import { s as AgentHostAgentSessionCommand, t as AgentHostAgentSessionComposerSettings, v as AgentHostAgentSessionReasoningEffort, w as AgentHostAgentSessionSpeed, u as AgentHostAgentSessionPermissionConfig, m as AgentGUIProvider, y as AgentPromptContentBlock, l as AgentGUINodeData, h as AgentGUIAgentTarget, o as AgentGUIProviderRailMode, p as AgentGUIProviderReadinessGate } from './types-DX2bxgB8.js';
+import { A as AgentApprovalItemVM, a as AgentAskUserQuestionVM, b as AgentConversationPromptVM, c as AgentConversationVM, d as WorkspaceAgentSessionDetailViewModel } from './agentConversationVM-C335TR6S.js';
+import { A as AgentHostBatchUserInfoInput, a as AgentHostBatchUserInfoResult } from './workspaceAgentActivityListTypes-C7gPWYiA.js';
 import { WorkspaceUserProjectService } from '@tutti-os/workspace-user-project/contracts';
 
 declare const APP_ERROR_CODES: readonly ["common.invalid_input", "common.approved_path_required", "common.unavailable", "common.unexpected", "session.not_found", "control_surface.unauthorized", "workspace.select_directory_failed", "workspace.select_files_failed", "workspace.ensure_directory_failed", "workspace.import_files_failed", "workspace.read_file_failed", "workspace.write_file_failed", "workspace.export_file_failed", "workspace.copy_path_failed", "workspace.host_unsupported", "workspace.runtime_artifact_unavailable", "runtime.guest_agent_lane_unavailable", "workspace.room_full", "workspace.room_delete_forbidden", "workspace.room_delete_not_found", "filesystem.create_directory_failed", "filesystem.read_file_bytes_failed", "filesystem.read_file_text_failed", "filesystem.write_file_text_failed", "filesystem.copy_entry_failed", "filesystem.move_entry_failed", "filesystem.rename_entry_failed", "filesystem.delete_entry_failed", "filesystem.read_directory_failed", "filesystem.stat_failed", "terminal.spawn_failed", "terminal.write_failed", "terminal.resize_failed", "terminal.close_failed", "terminal.attach_failed", "terminal.detach_failed", "terminal.snapshot_failed", "agent.list_models_failed", "agent.launch_failed", "agent.read_last_message_failed", "agent.provider_session_not_found", "agent.resume_session_not_local", "agent.resume_session_resolve_failed", "agent.settings_require_new_session", "task.suggest_title_failed", "persistence.unavailable", "persistence.quota_exceeded", "persistence.payload_too_large", "persistence.io_failed", "persistence.invalid_state", "persistence.invalid_node_id", "update.get_state_failed", "update.configure_failed", "update.check_failed", "update.download_failed", "update.install_failed", "PACKAGE_DOWNLOAD_INTERRUPTED", "PACKAGE_DOWNLOAD_HTTP_STATUS", "PACKAGE_DOWNLOAD_INVALID", "PACKAGE_DOWNLOAD_DISK_ERROR"];
@@ -112,35 +112,9 @@ interface ReadWorkspaceFileResult {
     bytes: Uint8Array;
 }
 
-type AgentSessionCommand = AgentHostAgentSessionCommand;
-type AgentSessionComposerSettings = AgentHostAgentSessionComposerSettings;
-type AgentSessionPermissionConfig = AgentHostAgentSessionPermissionConfig;
-type AgentSessionReasoningEffort = AgentHostAgentSessionReasoningEffort;
-type AgentSessionSpeed = AgentHostAgentSessionSpeed;
-type AgentSessionState = AgentHostAgentSessionState;
-
-type AgentGUIConversationFilter = {
-    kind: "all";
-} | {
-    kind: "agentTarget";
-    agentTargetId: string;
-};
-
-type AgentGUIResolvedProvider = AgentGUIProvider | "unknown";
-type AgentGUIConversationTitleFallback = "generic-agent" | null;
-
 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 = {
     writeImage?: (input: {
         data: string;
@@ -172,7 +146,6 @@ type AgentHostMetaApi = AgentHostRecord & {
 };
 type AgentHostEnvironmentApi = AgentHostRecord & {
     getBaseUrl?: () => AgentHostAsyncResult<string>;
-    warmupOpenclawGateway?: (input?: unknown) => AgentHostAsyncResult<unknown>;
 };
 type AgentHostPersistenceApi = AgentHostRecord & {
     readWorkspaceAgentReadState: (input: ReadWorkspaceAgentReadStateInput) => AgentHostAsyncResult<WorkspaceAgentReadStateSnapshot>;
@@ -260,7 +233,6 @@ interface AgentHostInputApi {
     userProjects?: AgentHostUserProjectsApi;
     workspace: AgentHostWorkspaceApi;
     workspaceAgentProbes?: AgentHostWorkspaceAgentProbesApi;
-    workspaceAgents?: AgentHostWorkspaceAgentsApi;
 }
 type AgentHostApi = AgentHostInputApi;
 type AgentHostAccountApi = AgentHostRecord & {
@@ -331,67 +303,13 @@ type AgentHostUserProjectsApi = AgentHostRecord & {
 };
 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;
     clipboard: AgentHostClipboardApi;
@@ -407,6 +325,21 @@ interface AgentHostRuntimeApi {
     workspaceAgentProbes?: AgentHostWorkspaceAgentProbesApi;
 }
 
+interface AgentMessageMarkdownWorkspaceAppIcon {
+    appId: string;
+    iconUrl: string | null;
+    workspaceId?: string | null;
+}
+
+type AgentSessionCommand = AgentHostAgentSessionCommand;
+type AgentSessionComposerSettings = AgentHostAgentSessionComposerSettings;
+type AgentSessionPermissionConfig = AgentHostAgentSessionPermissionConfig;
+type AgentSessionReasoningEffort = AgentHostAgentSessionReasoningEffort;
+type AgentSessionSpeed = AgentHostAgentSessionSpeed;
+
+type AgentGUIResolvedProvider = AgentGUIProvider | "unknown";
+type AgentGUIConversationTitleFallback = "generic-agent" | null;
+
 interface AgentGUIConversationProjectSummary {
     id: string;
     path: string;
@@ -418,6 +351,13 @@ interface AgentGUIConversationProjectSummary {
 }
 type AgentGUIConversationUserProject = Pick<AgentHostUserProject, "id" | "path" | "label" | "sectionKey" | "createdAtUnixMs" | "updatedAtUnixMs" | "lastUsedAtUnixMs">;
 
+type AgentGUIConversationFilter = {
+    kind: "all";
+} | {
+    kind: "agentTarget";
+    agentTargetId: string;
+};
+
 interface AgentGUIConversationSummary {
     id: string;
     userId?: string;
@@ -436,7 +376,7 @@ interface AgentGUIConversationSummary {
     hasUnreadCompletion?: boolean;
     unreadCompletionKey?: string | null;
     isImported?: boolean;
-    syncState?: WorkspaceAgentActivitySyncState;
+    activeTurn?: AgentActivitySession["activeTurn"];
 }
 type AgentGUIConversationStatus = "working" | "waiting" | "ready" | "completed" | "failed" | "canceled";
 type AgentGUIApprovalRequest = AgentApprovalItemVM;
@@ -454,6 +394,14 @@ type AgentGUIInteractivePrompt = AgentGUIApprovalRequest | {
     kind: "plan-implementation";
 }>;
 
+interface AgentSlashCommandCapability {
+    aliases?: readonly string[];
+    capability: "browserUse" | "computerUse";
+    kind: "capability";
+    name: string;
+}
+type AgentSlashCommandPolicy = AgentActivitySlashCommandPolicy;
+
 interface AgentGUISessionChrome {
     auth: {
         message: string;
@@ -463,13 +411,14 @@ interface AgentGUISessionChrome {
         kind: "activating" | "failed" | "warning";
         message: string;
         canRetry?: boolean;
-        followupAction?: "continue-in-new-conversation";
+        followupAction?: never;
+    } | {
+        kind: "resume-unavailable";
+        message: string;
+        followupAction: "continue-in-new-conversation";
+        canRetry?: never;
     } | null;
-    rawState: AgentSessionState | null;
-}
-interface OpenclawGatewayViewState {
-    status: "starting" | "ready" | "failed";
-    error: string | null;
+    rawState: CanonicalAgentSession | null;
 }
 interface AgentGUIInlineNotice {
     id: string;
@@ -478,13 +427,10 @@ interface AgentGUIInlineNotice {
     autoDismissMs: number | null;
 }
 interface AgentGUIProjectConversationDeleteTarget {
-    conversationCount: number | null;
+    conversationCount: number;
     label: string;
     path: string;
 }
-interface AgentGUIConversationSectionDeleteTarget {
-    conversationCount: number | null;
-}
 interface AgentGUIComposerSettingOption {
     value: string;
     label: string;
@@ -494,6 +440,8 @@ interface AgentGUIComposerSettingOption {
 interface AgentGUIProviderSkillOption {
     name: string;
     trigger: string;
+    /** Daemon-issued invocation contract; never infer this from provider id. */
+    invocation?: "promptItem" | "textTrigger";
     sourceKind: "project" | "personal" | "bundled" | "plugin" | "system" | "tutti-injected" | "connector";
     description?: string;
     pluginName?: string;
@@ -532,21 +480,7 @@ interface AgentComposerDraftLargeText {
     uploading?: boolean;
     uploadError?: string;
 }
-/**
- * Marks a prompt `file` content block as a pasted-text attachment (as opposed
- * to a user-attached file). Carried on the block `kind` so the round-trip
- * (submit → queue → edit-restore) can rebuild a large-text chip instead of a
- * regular file chip, and so the codex-style "read this file" instruction is
- * materialized only for these blocks at send time.
- */
-declare const AGENT_PASTED_TEXT_BLOCK_KIND = "pasted-text";
-/**
- * Provider id of the custom mention kind used to render a pasted-text chip in
- * the conversation flow. The mention href (`mention://pasted-text/...`) carries
- * the landed archive path + size so the host can render the chip and open a
- * preview on click. Registered via registerAgentCustomMentionKind.
- */
-declare const AGENT_PASTED_TEXT_MENTION_KIND = "pasted-text";
+
 interface AgentComposerDraft {
     prompt: string;
     images: AgentComposerDraftImage[];
@@ -572,7 +506,11 @@ interface AgentGUIComposerSettingsVM {
     planExclusiveWithPermissionMode?: boolean;
     supportsBrowser?: boolean;
     supportsComputerUse?: boolean;
+    permissionModeChangeDuringTurn?: boolean;
+    slashCommandPolicy?: AgentSlashCommandPolicy | null;
     isSettingsLoading: boolean;
+    /** Initial slash command and capability catalog request is in flight. */
+    isCapabilityOptionsLoading?: boolean;
     isModelOptionsLoading?: boolean;
     modelUnavailable: boolean;
     reasoningUnavailable: boolean;
@@ -586,7 +524,7 @@ interface AgentGUIComposerSettingsVM {
     selectedProjectPath?: string | null;
     projectLocked?: boolean;
     projectPathIsRemote?: boolean;
-    modelListCollapsedToLatest?: boolean;
+    collapseModelOptionsToLatest?: boolean;
     availableModels: AgentGUIComposerSettingOption[];
     availableReasoningEfforts: AgentGUIComposerSettingOption[];
     availableSpeeds: AgentGUIComposerSettingOption[];
@@ -599,71 +537,86 @@ interface AgentGUIQueuedPromptVM {
     displayPrompt?: string;
     createdAtUnixMs: number;
 }
-interface AgentGUINodeViewModel {
+interface AgentGUIShellViewModel {
     workspaceId: string;
     workspacePath?: string | null;
     currentUserId?: string | null;
     data: AgentGUINodeData;
+}
+interface AgentGUIRailViewModel {
     selectedAgentTarget: AgentGUIAgentTarget;
     agentTargets: readonly AgentGUIAgentTarget[];
-    handoffAgentTargets: readonly AgentGUIAgentTarget[];
     agentTargetsLoading: boolean;
+    /** How the rail composes its list — "exact" renders targets verbatim with no static injection. */
+    providerRailMode: AgentGUIProviderRailMode;
+    /** Providers gated by the host (feature-gated) — rail renders coming-soon placeholders. */
+    comingSoonProviders: readonly AgentGUIProvider[];
     conversationFilter: AgentGUIConversationFilter;
     conversations: AgentGUIConversationSummary[];
     userProjects: AgentGUIConversationUserProject[];
     activeConversation: AgentGUIConversationSummary | null;
     activeConversationId: string | null;
-    availableCommands: AgentSessionCommand[];
-    availableSkills: AgentGUIProviderSkillOption[];
-    draftPrompt: string;
-    draftContent: AgentComposerDraft;
     isLoadingConversations: boolean;
+    listError: string | null;
+}
+interface AgentGUIDetailViewModel {
     isLoadingMessages: boolean;
     isLoadingOlderMessages: boolean;
     hasOlderMessages: boolean;
+    usage: AgentActivityUsage | null;
+    backgroundAgentCount: number;
+    hasSentUserMessage: boolean;
+    avoidGroupingEdits: boolean;
+    conversation?: AgentConversationVM | null;
+    conversationDetail: WorkspaceAgentSessionDetailViewModel | null;
+}
+interface AgentGUIComposerViewModel {
+    handoffAgentTargets: readonly AgentGUIAgentTarget[];
+    availableCommands: AgentSessionCommand[];
+    availableSkills: AgentGUIProviderSkillOption[];
+    draftPrompt: string;
+    draftContent: AgentComposerDraft;
     isCreatingConversation: boolean;
     isSubmitting: boolean;
     isInterrupting: boolean;
     isCancelPending: boolean;
-    isRespondingApproval: boolean;
-    canCancel: boolean;
-    canSubmitInteractive: boolean;
-    canGoalControl: boolean;
-    canUploadAttachment: boolean;
     promptImagesSupported: boolean;
     compactSupported: boolean | null;
-    /**
-     * Provider goal supports a real paused state (codex thread goals). Claude
-     * Code's goal has none — the banner then omits pause/resume controls.
-     */
+    /** Provider goal exposes a real paused state and pause/resume controls. */
     goalPauseSupported: boolean;
-    usage: AgentActivityUsage | null;
-    backgroundAgentCount: number;
-    /** Codex plan turn finished: offer the TUI-equivalent implement prompt. */
-    listError: string | null;
-    isDeletingConversation: boolean;
-    isDeletingProjectConversations: boolean;
-    pendingDeleteConversation: AgentGUIConversationSummary | null;
-    pendingDeleteProjectConversations: AgentGUIProjectConversationDeleteTarget | null;
-    pendingDeleteConversations: AgentGUIConversationSectionDeleteTarget | null;
-    pendingApproval: AgentGUIApprovalRequest | null;
-    pendingInteractivePrompt: AgentGUIInteractivePrompt | null;
-    activeLiveState: "inactive" | "activating" | "active" | "failed";
-    activationError: string | null;
-    openclawGateway: OpenclawGatewayViewState | null;
-    activeConversationBusy: boolean;
     canSubmit: boolean;
     composerSettings: AgentGUIComposerSettingsVM;
-    queuedPrompts: readonly AgentGUIQueuedPromptVM[];
+    queuedPrompts: AgentGUIQueuedPromptVM[];
     drainingQueuedPromptId: string | null;
     canQueueWhileBusy: boolean;
-    hasSentUserMessage: boolean;
-    avoidGroupingEdits: boolean;
-    conversation?: AgentConversationVM | null;
-    conversationDetail: WorkspaceAgentSessionDetailViewModel | null;
+}
+interface AgentGUIInteractionViewModel {
+    isRespondingApproval: boolean;
+    pendingApproval: AgentGUIApprovalRequest | null;
+    pendingInteractivePrompt: AgentGUIInteractivePrompt | null;
     sessionChrome: AgentGUISessionChrome;
     inlineNotice: AgentGUIInlineNotice | null;
+}
+interface AgentGUIReadinessViewModel {
+    activeLiveState: "inactive" | "activating" | "active" | "failed";
+    activationError: string | null;
+    activeConversationBusy: boolean;
     providerReadinessGate: AgentGUIProviderReadinessGate | null;
 }
+interface AgentGUIOperationsViewModel {
+    isDeletingConversation: boolean;
+    isDeletingProjectConversations: boolean;
+    pendingDeleteConversation: AgentGUIConversationSummary | null;
+    pendingDeleteProjectConversations: AgentGUIProjectConversationDeleteTarget | null;
+}
+interface AgentGUINodeViewModel {
+    shell: AgentGUIShellViewModel;
+    rail: AgentGUIRailViewModel;
+    detail: AgentGUIDetailViewModel;
+    composer: AgentGUIComposerViewModel;
+    interaction: AgentGUIInteractionViewModel;
+    readiness: AgentGUIReadinessViewModel;
+    operations: AgentGUIOperationsViewModel;
+}
 
-export { AGENT_PASTED_TEXT_BLOCK_KIND as A, type PersistWriteResult as P, type ReadWorkspaceAgentReadStateInput as R, type WorkspaceAgentReadStateSnapshot as W, AGENT_PASTED_TEXT_MENTION_KIND as a, type AgentComposerDraft as b, type AgentGUIComposerSettingsVM as c, type AgentGUINodeViewModel as d, type AgentGUIProviderSkillOption as e, type AgentGUIQueuedPromptVM as f, type AgentHostApi as g, type AgentHostApplyWorkspaceGitPatchInput as h, type AgentHostInputApi as i, type AgentHostRuntimeApi as j, type AgentHostSelectFilesInput as k, type AgentProbeProvider as l, type AgentProbeSnapshot as m, type AgentProviderProbeListInput as n, type AgentProviderProbeListResult as o, type AgentSessionCommand as p, type AgentUsageQuota as q, type AgentUsageSnapshot as r, type WriteWorkspaceAgentReadStateInput as s };
+export type { AgentComposerDraft as A, PersistWriteResult as P, ReadWorkspaceAgentReadStateInput as R, WorkspaceAgentReadStateSnapshot as W, AgentGUIComposerSettingsVM as a, AgentGUINodeViewModel as b, AgentGUIProviderSkillOption as c, AgentGUIQueuedPromptVM as d, AgentHostApi as e, AgentHostApplyWorkspaceGitPatchInput as f, AgentHostInputApi as g, AgentHostRuntimeApi as h, AgentHostSelectFilesInput as i, AgentMessageMarkdownWorkspaceAppIcon as j, AgentProbeProvider as k, AgentProbeSnapshot as l, AgentProviderProbeListInput as m, AgentProviderProbeListResult as n, AgentSessionCommand as o, AgentSlashCommandCapability as p, AgentUsageQuota as q, AgentUsageSnapshot as r, WriteWorkspaceAgentReadStateInput as s };