@qwen-code/web-shell 0.24.1-preview.0

package/dist/types/App.d.ts

@@ -0,0 +1,419 @@
+import './styles/globals.css';
+import { type DaemonProductSessionContext, type DaemonStreamingState } from '@qwen-code/web-shell/daemon-react-sdk';
+import type { DaemonAgentTrace, DaemonSessionAgentTaskStatus, DaemonTranscriptBlock, DaemonSessionMonitorTaskStatus, DaemonSessionTaskWithWorkflowStatus, DaemonWorkspaceCapability } from '@qwen-code/sdk/daemon';
+import { type ComposerToolbarAction } from './components/ChatEditor';
+import { type ToastTone } from './components/ToastHost';
+import { type EnvironmentAgentTask } from './components/panels/EnvironmentPanel';
+import { type ModelDialogModel } from './components/dialogs/ModelDialog';
+import type { PaneHeaderActionsRenderer } from './components/ChatPane';
+import { type SideTaskListItem } from './components/artifacts/ArtifactPanel';
+import type { TurnOutputKind, TurnOutputOpenRequest } from './components/artifacts/TurnOutputs';
+import { type WebShellSettingsOptions } from './settings';
+import { type WebShellShadowDom } from './shadowDom';
+import { type WebShellSidebarBranding, type WebShellSidebarFooterOptions, type WebShellSidebarWorkspaceOverviewOptions, type WebShellSidebarLockedWorkspace, type WebShellSidebarPrimaryNavOptions, type WebShellSidebarSessionActionsOptions } from './components/sidebar/WebShellSidebar';
+import { type WebShellLanguage } from './i18n';
+import { type ComposerPlaceholderState } from './utils/composerInputState';
+import type { CommandInfo, Message } from './adapters/types';
+import { type WebShellBrand, type WebShellResolvedBrand } from './brandContext';
+import { type WebShellTheme } from './themeContext';
+import { type WebShellComposerApi, type WebShellComposerInput, type WebShellMarkdownCustomization, type WebShellSourceIconResolver, type WebShellSourceReference, type ToolHeaderExtraRenderer, type UserMessageContentRenderer, type UserMessageContentParser, type AssistantTurnFooterRenderer, type WebShellArtifactCustomization, type WelcomeHeaderRenderer, type WelcomeFooterRenderer, type ComposerToolbarStartRenderer, type ComposerToolbarEndRenderer, type ComposerToolbarRightRenderer, type ComposerHeaderRenderer, type ComposerFooterRenderer, type ChatHeaderRenderer, type WebShellChatHeaderOptions, type WebShellRightPanelOptions, type WebShellEnvironmentPanelOptions, type FooterRenderer, type LoadingPhrasesResolver, type MarkdownTableMode, type WebShellAtProvider, type WebShellBuiltinAtProvidersConfig, type ComposerTagClickHandler, type ComposerTagRenderer, type WebShellComposerTagIconMap, type WebShellBottomStatusItem, type WebShellPreparedSubmit, type WebShellSubmitSnapshot, type WebShellSessionArtifactsChange } from './customization';
+import type { CommandDisplayCategoryOrder } from './utils/commandDisplay';
+export interface BugReportInfo {
+    title: string;
+    systemInfo: Record<string, string>;
+}
+export interface WebShellSidebarOptions {
+    enabled?: boolean;
+    defaultCollapsed?: boolean;
+    /** Whether to show WebShell's built-in compact drawer toggle. Defaults to true. */
+    showCompactToggle?: boolean;
+    /** Whether to show the Tasks/Channels session-source switch. Defaults to true. */
+    showSessionSourceSwitch?: boolean;
+    /** Whether to show daemon-owned Live conversations. Defaults to false. */
+    showLive?: boolean;
+    /** Hide or replace the complete sidebar branding row. */
+    branding?: false | WebShellSidebarBranding;
+    /** Customize the primary navigation area (new task button, custom entries). */
+    primaryNav?: WebShellSidebarPrimaryNavOptions;
+    /** Whether to hide the "Projects" header row (with search and add workspace). Defaults to false (shown). */
+    hideProjectHeader?: boolean;
+    /** Customize which action buttons appear on session rows. */
+    sessionActions?: WebShellSidebarSessionActionsOptions;
+    /** Hide the footer completely or select the built-in entries it exposes. */
+    footer?: false | WebShellSidebarFooterOptions;
+    /** Customize the workspace row shown when lockWorkspaceCwd is active. */
+    lockedWorkspace?: WebShellSidebarLockedWorkspace;
+    /**
+     * Session counts, full path and facet chips (MCP, skills, …) on workspace
+     * rows. Pass `false` to keep plain folder headers.
+     */
+    workspaceOverview?: false | WebShellSidebarWorkspaceOverviewOptions;
+}
+export type SessionChangeEvent = {
+    type: 'rename';
+    sessionId: string;
+    newName: string;
+} | {
+    type: 'submit';
+    sessionId: string;
+    prompt: string;
+    queued: boolean;
+} | {
+    type: 'turn_complete';
+    sessionId: string;
+    error?: Error;
+};
+export interface WebShellApi {
+    /** Open the in-window split view, matching the built-in sidebar button. */
+    openSplitView: () => void;
+    /** Open the Session Overview panel, matching the built-in sidebar button. */
+    openSessionOverview: () => void;
+    /** Open the compact session drawer, matching the hamburger control. */
+    openSessionDrawer: () => void;
+    /** Start a new session using the same lifecycle as the built-in New Chat action. */
+    createNewSession: () => Promise<boolean>;
+    /** Open the right panel with a new side-task draft. */
+    createSideTask: () => boolean;
+    /** Resolve the visible approval, optionally binding it to an exact request. */
+    respondToPendingPermission?: {
+        (decision: 'allow' | 'reject'): Promise<boolean>;
+        (requestId: string, decision: 'allow' | 'reject'): Promise<boolean>;
+    };
+}
+export type WebShellComposerPlaceholderState = ComposerPlaceholderState;
+export type WebShellComposerPlaceholders = Readonly<Partial<Record<WebShellComposerPlaceholderState, string>>>;
+export interface WebShellSlashCommand {
+    /** Slash command name without the leading slash, normalized to lower case. */
+    command: string;
+    /** Trimmed text following the command name. */
+    args: string;
+    /** Original text submitted from the composer. */
+    input: string;
+}
+export type WebShellSlashCommandHandler = (command: WebShellSlashCommand) => boolean | void;
+export interface WebShellProps {
+    /** Native settings-page presentation. Does not restrict commands or daemon access. */
+    settings?: WebShellSettingsOptions;
+    /** Host-specific label for the Ask User Question free-text choice. */
+    askUserFreeTextLabel?: string;
+    /** Called whenever the attached daemon session or workspace changes. */
+    onSessionIdChange?: (sessionId: string | undefined, workspaceId?: string, workspaceCwd?: string, sessionContext?: DaemonProductSessionContext) => void;
+    /** Called when the active session id or display name changes. */
+    onSessionInfoChange?: (session: {
+        sessionId?: string;
+        sessionName?: string;
+    }) => void;
+    /** Called after a new session is created. Session setup waits up to 30 seconds. */
+    onSessionCreated?: (sessionId: string) => Promise<void> | void;
+    /** Visual theme for the embedded shell. */
+    theme?: WebShellTheme;
+    /** Called when `/theme` changes the web-shell theme. */
+    onThemeChange?: (theme: WebShellTheme) => void;
+    /**
+     * Called when no `theme` prop was provided and the shell resolved a theme
+     * from the daemon's effective `ui.theme` setting. Unlike `onThemeChange`
+     * this is not a user action: a host that mirrors the theme onto document
+     * chrome (html class, `theme-color` meta) should follow it without
+     * persisting the value as its own preference, or the next settings edit
+     * would be shadowed by the stale copy.
+     */
+    onThemeResolved?: (theme: WebShellTheme) => void;
+    /** UI language for the web-shell. Defaults to `?language=` or browser language. */
+    language?: 'en' | 'zh-CN' | 'zh' | 'zh-cn';
+    /** Called when `/language ui` changes the web-shell UI language. */
+    onLanguageChange?: (language: WebShellLanguage) => void;
+    /**
+     * Called when no `language` prop was provided and the effective UI language
+     * changes without becoming a host opinion, including settings resolution and
+     * optimistic changes or rollbacks. Hosts may mirror document chrome but must
+     * not persist this value.
+     */
+    onLanguageResolved?: (language: WebShellLanguage) => void;
+    /**
+     * Product branding for the embedded shell. Replaces the daemon-resolved brand
+     * wholesale when provided: a host that sets `brand` owns both the name and the
+     * logo. `logo` may be any node, because the host owns its own document and
+     * Content Security Policy.
+     */
+    brand?: WebShellBrand;
+    /**
+     * Called with the resolved brand's name and logo URI once the brand is known,
+     * and again only when one of those two values changes — so a host may pass an
+     * inline handler alongside an inline `brand` object without re-firing on every
+     * render. The shell itself never writes `document.title` or the favicon; an
+     * embedded shell must not hijack its host page's tab.
+     */
+    onBrandResolved?: (brand: WebShellResolvedBrand) => void;
+    /** Additional CSS class name appended to the root element. */
+    className?: string;
+    /** Inline styles applied to the root element. */
+    style?: React.CSSProperties;
+    /** Optional Shadow DOM isolation for plugin content and/or all portals. */
+    shadowDom?: WebShellShadowDom;
+    /** Maximum chat content width in regular mode. Defaults to 1000px. */
+    chatMaxWidth?: number;
+    /** Optional workspace sidebar. Disabled by default. */
+    sidebar?: boolean | WebShellSidebarOptions;
+    /** Persistent chat header options. */
+    header?: WebShellChatHeaderOptions;
+    /** Right extension panel options. */
+    rightPanel?: WebShellRightPanelOptions;
+    /** Environment information panel options. */
+    environmentPanel?: WebShellEnvironmentPanelOptions;
+    /** Session ids to control the split view; an empty array closes it. */
+    splitSessionIds?: readonly string[];
+    /** Called when the split pane list changes from inside WebShell. */
+    onSplitSessionIdsChange?: (sessionIds: string[]) => void;
+    /**
+     * Extra actions rendered in each split-pane header, before the built-in
+     * close button. Receives the pane's session id (and workspace when known).
+     * When the actions no longer fit they collapse into a `…` overflow menu.
+     */
+    renderPaneHeaderActions?: PaneHeaderActionsRenderer;
+    /**
+     * Called instead of the built-in right panel open behavior when a user clicks
+     * a turn output such as review changes, an artifact, or a scheduled task.
+     */
+    onRightPanelOpen?: (request: TurnOutputOpenRequest) => void;
+    /** Override file-review links without replacing the other right panels. */
+    onFileReviewOpen?: (request: Extract<TurnOutputOpenRequest, {
+        kind: 'review';
+    }>) => void;
+    /** Open a workspace file in the embedding host instead of WebShell preview. */
+    onWorkspaceFileOpen?: (path: string) => void;
+    /** Open a completed Insight report in a host-native surface. */
+    onInsightReportOpen?: (path: string) => void;
+    /** Open context usage details in the host instead of the built-in panel. */
+    onContextUsageOpen?: (sessionId: string) => void;
+    /**
+     * Controls which turn output cards appear below messages. Defaults to all.
+     */
+    messageTurnOutputs?: readonly TurnOutputKind[];
+    /** Imperative handle for externally opening WebShell surfaces. */
+    shellRef?: React.Ref<WebShellApi>;
+    /**
+     * Built-in composer toolbar actions to show. Omitted uses the defaults.
+     * Excluding gitBranch skips chat Git reads unless the environment panel
+     * needs them. Plan must be explicitly included.
+     */
+    composerToolbarActions?: readonly ComposerToolbarAction[];
+    /** Optionally filter main-model entries without changing shared defaults. */
+    mainModelFilter?: (model: ModelDialogModel) => boolean;
+    /** Stack completion details vertically for narrow embedded hosts. */
+    compactComposerOverlays?: boolean;
+    /** Submit slash items marked as immediate actions when selected. */
+    autoSubmitSlashCommands?: boolean;
+    /** Host-only slash entries or presentation overrides. */
+    additionalSlashCommands?: readonly CommandInfo[];
+    /** Keep Context Usage available while restored-session usage is loading. */
+    contextUsageAlwaysVisible?: boolean;
+    /**
+     * Offer the last user turn's edit-and-resend action. On by default. Editing
+     * happens in place in the message bubble, and the rewind is deferred to send
+     * time, so abandoning the edit keeps the turns after it. Hosts that own the
+     * lifecycle pass `false`, or answer `onUserMessageEditRequest` with `true` to
+     * keep their own editor.
+     */
+    userMessageEditing?: boolean;
+    /**
+     * Called before WebShell starts its built-in user-message edit flow. Return
+     * true when the host owns the edit-and-resend lifecycle.
+     */
+    onUserMessageEditRequest?: (turnIndex: number, content: string) => boolean | void;
+    /** Cycle the approval mode when an otherwise-unhandled Tab is pressed. */
+    cycleModeOnTab?: boolean;
+    /**
+     * Creator attribution recorded on sessions this shell creates, and the
+     * source filter embedded hosts use to list only their own sessions. Defaults
+     * to the browser Web Shell's `'default'`; the VS Code companion overrides it
+     * so its sessions stay distinguishable from CLI and browser ones.
+     */
+    sessionSourceType?: string;
+    /** Built-in actions appended to the context-sensitive default toolbar. */
+    composerToolbarAdditionalActions?: readonly ComposerToolbarAction[];
+    /**
+     * Main-composer copy by semantic state. Omitted or blank entries retain the
+     * WebShell localized default; shell-mode and follow-up copy still wins.
+     */
+    composerPlaceholders?: WebShellComposerPlaceholders;
+    /** Called when connection status changes (idle/connecting/connected/disconnected/error). */
+    onConnectionChange?: (status: string) => void;
+    /** Called when prompt status changes (idle/waiting/responding). */
+    onStreamingStateChange?: (state: DaemonStreamingState) => void;
+    /**
+     * Called with the initial merged agent task snapshot and when its roster,
+     * status, or stable metadata changes. Poll-only runtime, stats, and activity
+     * updates are suppressed.
+     */
+    onAgentTasksChange?: (tasks: readonly DaemonSessionAgentTaskStatus[]) => void;
+    /**
+     * Called whenever transcript blocks change. Receives the full blocks array
+     * at most once per animation frame during active generation.
+     */
+    onTranscriptChange?: (blocks: readonly DaemonTranscriptBlock[]) => void;
+    /** Called with the complete Artifact snapshot after restore or change. */
+    onSessionArtifactsChange?: (change: WebShellSessionArtifactsChange) => void;
+    /**
+     * Called when a critical error occurs (auth failure, session gone, etc).
+     * Each distinct connection error value is reported once; reporting resets
+     * when the connection recovers. Replacing the handler while an error
+     * persists does not re-deliver that error.
+     */
+    onError?: (error: Error) => void;
+    /** Called when `/bug` is invoked. Receives system info. If omitted, web-shell opens the report URL itself. */
+    onBugReport?: (info: BugReportInfo) => void;
+    /** Slash command names to hide from completion/help, for example `['approval-mode']`. */
+    hiddenSlashCommands?: string[];
+    /** Slash command category order. Defaults to custom, skill, system. */
+    slashCommandCategoryOrder?: CommandDisplayCategoryOrder;
+    /**
+     * Called before Web Shell handles a slash command. Return true to skip the
+     * built-in or daemon behavior after handling the command in the host.
+     */
+    onSlashCommand?: WebShellSlashCommandHandler;
+    /** Built-in @ mention providers to enable. Defaults to all built-ins. */
+    builtinAtProviders?: WebShellBuiltinAtProvidersConfig;
+    /**
+     * Controls whether the composer's file-upload entry points (drag-and-drop
+     * and the @ panel upload item) are enabled. Does not disable attachments.
+     * Works alongside the daemon's
+     * `workspace_file_upload` capability, not instead of it: `false` force-
+     * disables upload even when the daemon advertises the capability, while
+     * `true`/omitted still requires the capability to be satisfied.
+     */
+    fileUploadEnabled?: boolean;
+    /** Preferred file-drop destination. Omitted: ask only when both are available.
+     * If the preference is unavailable, use the sole available destination.
+     */
+    fileDropAction?: 'upload' | 'attach';
+    /**
+     * Directory that drag-and-dropped files upload into, **relative to the
+     * workspace root**. Use a relative path WITHOUT a leading `/` — e.g.
+     * `'uploads'`, `'uploads/images'`, or omit it to upload into the
+     * workspace root (the default). A leading-slash path like `'/uploads'`
+     * is rejected by the daemon as outside the workspace. The directory
+     * (including intermediate components) is created automatically on upload
+     * when it does not exist.
+     */
+    fileUploadDirectory?: string;
+    /** Additional @ mention categories shown alongside built-in files/extensions. */
+    atProviders?: readonly WebShellAtProvider[];
+    /** Icon URLs for custom composer tag kinds used by @ mention chips. */
+    composerTagIcons?: WebShellComposerTagIconMap;
+    /** Custom renderer for the tool-card header content after the status icon and tool name. */
+    renderToolHeaderExtra?: ToolHeaderExtraRenderer;
+    /** Artifact-card rendering overrides. */
+    artifact?: WebShellArtifactCustomization;
+    /** Custom renderer for the welcome header. Receives version, cwd, model, and mode. */
+    renderWelcomeHeader?: WelcomeHeaderRenderer;
+    /** Custom renderer shown below the chat composer in the empty welcome state. */
+    renderWelcomeFooter?: WelcomeFooterRenderer;
+    /**
+     * Show renderWelcomeFooter between the welcome header and composer on
+     * mobile empty state. Requires renderWelcomeFooter to be provided for the
+     * mobile CSS reordering to take effect.
+     */
+    mobileWelcomeFooterMiddle?: boolean;
+    /** Parse user-message text into display parts such as chips. */
+    parseUserMessageContent?: UserMessageContentParser;
+    /** Custom renderer for the inside of user chat bubbles. Defaults to plain text. */
+    renderUserMessageContent?: UserMessageContentRenderer;
+    /** Custom renderer for composer and user-message tags. */
+    renderComposerTag?: ComposerTagRenderer;
+    /** Custom hover content for composer and user-message tags. */
+    renderComposerTagTooltip?: ComposerTagRenderer;
+    /** Click handler for composer and user-message tags. */
+    onComposerTagClick?: ComposerTagClickHandler;
+    /** Custom renderer displayed after the final assistant message of each turn. */
+    renderAssistantTurnFooter?: AssistantTurnFooterRenderer;
+    getAssistantSourcesIcon?: WebShellSourceIconResolver;
+    sourceReferences?: readonly WebShellSourceReference[];
+    /** Custom renderer inserted before the built-in chat composer toolbar controls. */
+    renderComposerToolbarStart?: ComposerToolbarStartRenderer;
+    /** Custom renderer inserted after the built-in composer toolbar controls. */
+    renderComposerToolbarEnd?: ComposerToolbarEndRenderer;
+    /** Custom renderer inserted into the composer toolbar's right-side action area. */
+    renderComposerToolbarRight?: ComposerToolbarRightRenderer;
+    /** Custom renderer shown directly above the chat composer input. */
+    renderComposerHeader?: ComposerHeaderRenderer;
+    /** Custom renderer shown directly below the chat composer input. */
+    renderComposerFooter?: ComposerFooterRenderer;
+    /**
+     * Replaces the complete persistent chat header. Only rendered when a
+     * session is active (not in the welcome/empty state).
+     */
+    renderChatHeader?: ChatHeaderRenderer;
+    /** Custom component for the footer area below the Editor. Replaces the built-in StatusBar. */
+    renderFooter?: FooterRenderer;
+    /** Extra status items shown in the floating bottom panel beside the TODO summary. */
+    bottomStatusItems?: readonly WebShellBottomStatusItem[];
+    /** Collapse thinking blocks to 5 lines with a click-to-expand toggle. */
+    compactThinking?: boolean;
+    /** Let the host own pending Edit diff previews instead of the inline tool row. */
+    hostOwnsEditDiffPreview?: boolean;
+    /** Auto-collapse completed turns to just the prompt and final answer, with a per-turn toggle. Defaults to true. */
+    collapseCompletedTurns?: boolean;
+    /** Markdown table rendering mode. Defaults to basic. */
+    markdownTableMode?: MarkdownTableMode;
+    /** Enable virtual scrolling only when rendered transcript rows exceed this threshold. Defaults to 200. */
+    virtualScrollThreshold?: number;
+    /** Custom Markdown behavior for assistant content only. */
+    markdown?: WebShellMarkdownCustomization;
+    /**
+     * Override the witty phrases cycled while a prompt is streaming. Receives the
+     * resolved UI language; return phrases to replace the built-in defaults, an
+     * empty array to hide the phrase, or `undefined`/`null` to keep the defaults.
+     */
+    loadingPhrases?: LoadingPhrasesResolver;
+    /** When provided, all toast notifications are forwarded to this callback and the built-in ToastHost is hidden. */
+    onToast?: (tone: ToastTone, message: string) => void;
+    /** Imperative handle for externally controlling the composer input. */
+    composerRef?: React.Ref<WebShellComposerApi>;
+    /** Called once the real composer API is mounted and safe to call. */
+    onComposerReady?: (api: WebShellComposerApi) => void;
+    /** Declarative composer input value. Increment composerInputVersion to replay the same value. */
+    composerInput?: WebShellComposerInput;
+    /** Replay key for composerInput. */
+    composerInputVersion?: number;
+    /** Called when a session-level event occurs (rename, submit, turn complete). */
+    onSessionChange?: (event: SessionChangeEvent) => void;
+    /**
+     * Prepare the immutable payload for a daemon submission. Called once for a
+     * direct or queued logical submit, after local command routing and before
+     * session creation, composer commit, optimistic rendering, or admission.
+     * Retries reuse the previously prepared payload and skip this callback.
+     * If this callback rejects, the submission is cancelled and the rejection's
+     * `Error.message` is surfaced to the user, so hosts must localize it.
+     */
+    prepareSubmit?: (submission: WebShellSubmitSnapshot) => Promise<void | WebShellPreparedSubmit>;
+    /**
+     * Called before a prompt is submitted. Return a Promise — the prompt is held
+     * until the Promise resolves. If the Promise rejects, the prompt is cancelled.
+     * `sessionId` is `undefined` when the session has not yet been created (deferred).
+     * Also called for queued prompts (submitted while a turn is streaming).
+     * A rejection's `Error.message` is surfaced to the user, so hosts must
+     * localize it.
+     */
+    onSubmitBefore?: (params: {
+        sessionId: string | undefined;
+        prompt: string;
+    }) => Promise<void>;
+}
+interface AppProps extends WebShellProps {
+    initialSelectedWorkspaceCwd?: string;
+    lockedWorkspaceCwd?: string;
+    lockedWorkspaceCapability?: DaemonWorkspaceCapability;
+    restartSseOnPrompt?: boolean;
+    historyPageSize?: number;
+}
+export { getTaskActivityKey } from './utils/taskActivity';
+export declare function mergeMonitorTaskSnapshot(current: DaemonSessionMonitorTaskStatus, next: DaemonSessionMonitorTaskStatus): DaemonSessionMonitorTaskStatus;
+interface SideTaskCatalogState {
+    parentSessionId?: string;
+    items: SideTaskListItem[];
+    loaded: boolean;
+}
+export declare function mergeSideTaskCatalog(catalog: SideTaskCatalogState, parentSessionId: string, listedItems: SideTaskListItem[], optimisticIds: ReadonlySet<string>): SideTaskCatalogState;
+export declare function getEnvironmentAgentTasks(messages: readonly Message[], sessionTasks: readonly DaemonSessionTaskWithWorkflowStatus[]): EnvironmentAgentTask[];
+export declare function mergeAgentTrace(liveAgents: readonly EnvironmentAgentTask[], trace: DaemonAgentTrace | undefined, now?: number): EnvironmentAgentTask[];
+export declare function App({ askUserFreeTextLabel, onSessionIdChange, onSessionInfoChange, onSessionCreated, theme: providedTheme, onThemeChange, onThemeResolved, language: providedLanguage, onLanguageChange, onLanguageResolved, brand: providedBrand, onBrandResolved, className: externalClassName, style: externalStyle, shadowDom, onConnectionChange, onStreamingStateChange, onError, onBugReport, hiddenSlashCommands, slashCommandCategoryOrder, onSlashCommand, builtinAtProviders, atProviders, composerTagIcons, fileUploadEnabled, fileUploadDirectory, artifact, fileDropAction, renderToolHeaderExtra, renderWelcomeHeader, renderWelcomeFooter, mobileWelcomeFooterMiddle, parseUserMessageContent, renderUserMessageContent, renderComposerTag, renderComposerTagTooltip, onComposerTagClick, renderAssistantTurnFooter, getAssistantSourcesIcon, sourceReferences, renderComposerToolbarStart, renderComposerToolbarEnd, renderComposerToolbarRight, renderComposerHeader, renderComposerFooter, renderChatHeader, renderFooter, bottomStatusItems, chatMaxWidth, sidebar, settings: settingsPresentation, header, rightPanel, environmentPanel, splitSessionIds: externalSplitSessionIds, onSplitSessionIdsChange, renderPaneHeaderActions, onRightPanelOpen, onFileReviewOpen, onWorkspaceFileOpen, onInsightReportOpen, onContextUsageOpen, messageTurnOutputs, shellRef, composerToolbarActions, mainModelFilter, compactComposerOverlays, autoSubmitSlashCommands, additionalSlashCommands, contextUsageAlwaysVisible, userMessageEditing, onUserMessageEditRequest, cycleModeOnTab, sessionSourceType, composerToolbarAdditionalActions, composerPlaceholders, compactThinking, hostOwnsEditDiffPreview, collapseCompletedTurns, markdownTableMode, virtualScrollThreshold, markdown, loadingPhrases, onAgentTasksChange, onTranscriptChange, onSessionArtifactsChange, onToast, composerRef, onComposerReady, composerInput, composerInputVersion, onSessionChange, prepareSubmit, onSubmitBefore, restartSseOnPrompt, historyPageSize, initialSelectedWorkspaceCwd, lockedWorkspaceCwd, lockedWorkspaceCapability, }?: AppProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/WebShellContexts.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @license
+ * Copyright 2026 Qwen Team
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type ReactNode } from 'react';
+import type { TodoDetail, TodoSnapshotDiff } from './utils/todos';
+export declare const CompactModeContext: import("react").Context<boolean>;
+/**
+ * Per-snapshot status diffs (keyed by tool callId or plan message id), so a
+ * history row can render what changed in that snapshot without re-deriving it
+ * from the whole transcript. Empty by default so a row rendered outside the
+ * provider still falls back gracefully.
+ */
+export declare const TodoTimelineContext: import("react").Context<Map<string, TodoSnapshotDiff>>;
+/**
+ * Per-todo timing and resource detail keyed by todoStateKey, consumed by the
+ * expanded todo list so a finished task can reveal when it ran and what it
+ * spent. Empty by default so a row rendered outside the provider (or in tests)
+ * simply shows no expander.
+ */
+export declare const TodoDetailContext: import("react").Context<Map<string, TodoDetail>>;
+/**
+ * Provides both todo contexts in one wrapper so the message list stays at a
+ * single nesting level (one provider in the tree, not two).
+ */
+export declare function TodoContextsProvider({ timeline, details, children, }: {
+    timeline: Map<string, TodoSnapshotDiff>;
+    details: Map<string, TodoDetail>;
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/types/adapters/localizedMessages.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2026 Qwen Team
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Leaf module for projecting transcript blocks into localized messages.
+ *
+ * This lives outside `hooks/useMessages.ts` on purpose. That module is a daemon
+ * consumer — it value-imports `useConnection` / `useTranscriptBlocks` /
+ * `useWorkspace` from the `daemon-react-sdk` barrel — so importing this one
+ * function from it dragged the daemon provider stack into the read-only
+ * transcript entry, which advertises the opposite. Same treatment as
+ * `utils/composerTag.ts`: the pure projection lives in a module with no daemon
+ * or editor imports, and `useMessages.ts` re-exports it for existing callers.
+ *
+ * Keep this module free of React hooks and of anything reaching
+ * `@qwen-code/web-shell/daemon-react-sdk`. `client/build-artifact.test.ts`
+ * asserts that `dist/transcript.js` carries no daemon provider code.
+ */
+import type { DaemonTranscriptBlock } from '@qwen-code/sdk/daemon';
+import type { Message } from './types';
+export type Translator = (key: string, vars?: Record<string, string | number>) => string;
+export declare function transcriptBlocksToLocalizedMessages(blocks: readonly DaemonTranscriptBlock[], t: Translator, safeToolProjection?: boolean): Message[];

package/dist/types/adapters/messageTypes.d.ts

@@ -0,0 +1,194 @@
+/**
+ * @license
+ * Copyright 2025 Qwen Team
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { DaemonBackgroundTurn, DaemonInputAnnotation } from '@qwen-code/sdk/daemon';
+export interface AttachmentPreviewRequest {
+    name: string;
+    mimeType?: string;
+    data?: Blob;
+    text?: string;
+    workspacePath?: string;
+    attachmentId?: string;
+}
+export type DaemonMessageToolCallStatus = 'pending' | 'in_progress' | 'completed' | 'failed';
+export type DaemonMessageToolKind = 'read' | 'edit' | 'delete' | 'move' | 'search' | 'execute' | 'think' | 'fetch' | 'switch_mode' | 'other';
+export interface DaemonMessageToolCallLocation {
+    file: string;
+    line?: number;
+}
+export interface DaemonMessageToolCallContent {
+    type: 'content' | 'diff' | 'terminal';
+    content?: {
+        type: string;
+        text?: string;
+        [key: string]: unknown;
+    };
+    path?: string;
+    oldText?: string;
+    newText?: string;
+    terminalId?: string;
+}
+export interface DaemonMessageToolCall {
+    callId: string;
+    toolName: string;
+    args?: Record<string, unknown>;
+    executionMode?: 'foreground' | 'background';
+    subagentSessionReady?: boolean;
+    backgroundResultPending?: boolean;
+    status: DaemonMessageToolCallStatus;
+    parentToolCallId?: string;
+    title?: string;
+    content?: readonly DaemonMessageToolCallContent[];
+    rawOutput?: unknown;
+    locations?: DaemonMessageToolCallLocation[];
+    kind?: DaemonMessageToolKind;
+    startTime?: number;
+    endTime?: number;
+    wasCancelled?: boolean;
+    subContent?: string;
+    subTools?: DaemonMessageToolCall[];
+    /** Transcript blocks folded into this tool presentation. */
+    sourceBlockIds?: string[];
+}
+export interface DaemonMessageTodoItem {
+    id: string;
+    content: string;
+    status: 'pending' | 'in_progress' | 'completed';
+    priority?: 'high' | 'medium' | 'low';
+    blockedBy?: string[];
+}
+/**
+ * Fields shared by every history message. Kept as a base interface so a new
+ * cross-cutting field is declared once rather than on each role.
+ */
+export interface DaemonMessageMeta {
+    backgroundTurn?: DaemonBackgroundTurn;
+    /**
+     * Wall-clock epoch milliseconds when the backing transcript block was first
+     * observed, populated from `serverTimestamp ?? clientReceivedAt`. Surfaced
+     * as a hover tooltip in the message list. Undefined for synthetic messages
+     * that have no backing block.
+     */
+    timestamp?: number;
+    /** Stable transcript blocks folded into this rendered message. */
+    sourceBlockIds?: string[];
+}
+export interface DaemonUserMessage extends DaemonMessageMeta {
+    id: string;
+    role: 'user';
+    content: string;
+    images?: Array<{
+        data: string;
+        mimeType: string;
+        /** Present when the image is a session attachment; keeps it re-fetchable. */
+        attachmentId?: string;
+    }>;
+    files?: Array<{
+        name: string;
+        mimeType: string;
+        data?: Blob;
+        text?: string;
+        attachmentId?: string;
+    }>;
+    inputAnnotations?: DaemonInputAnnotation[];
+    source?: string;
+}
+export interface DaemonAssistantMessage extends DaemonMessageMeta {
+    id: string;
+    role: 'assistant';
+    content: string;
+    isStreaming?: boolean;
+    branchRecordId?: string;
+    /**
+     * Token usage folded onto this assistant block by the daemon SDK reducer
+     * (summed when several blocks merge into one message). Summed again across a
+     * turn's assistant messages for the per-turn total shown on the fold toggle.
+     * Absent on sessions whose agent predates usage stamping.
+     */
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+        cachedTokens?: number;
+    };
+}
+export interface DaemonThinkingMessage extends DaemonMessageMeta {
+    id: string;
+    role: 'thinking';
+    content: string;
+    isStreaming?: boolean;
+}
+export interface DaemonToolGroupMessage extends DaemonMessageMeta {
+    id: string;
+    role: 'tool_group';
+    tools: DaemonMessageToolCall[];
+    /**
+     * Thinking folded into this group like a tool (compact mode). Streaming
+     * entries carry `isStreaming` so the summary can read "Thinking…" while
+     * the model works, then settle to a click-to-expand row when done.
+     * `beforeToolCallId` pins each thought to the tool that follows it so the
+     * group renders in the original interleaved order; thoughts without one
+     * trail the last tool.
+     */
+    thoughts?: Array<{
+        content: string;
+        isStreaming?: boolean;
+        beforeToolCallId?: string;
+    }>;
+}
+export interface DaemonPlanMessage extends DaemonMessageMeta {
+    id: string;
+    role: 'plan';
+    todos: DaemonMessageTodoItem[];
+}
+export interface DaemonSystemMessage extends DaemonMessageMeta {
+    id: string;
+    role: 'system';
+    content: string;
+    variant: 'info' | 'error' | 'warning';
+    retryable?: boolean;
+    source?: string;
+    data?: unknown;
+    images?: Array<{
+        data: string;
+        mimeType: string;
+    }>;
+    files?: Array<{
+        name: string;
+        mimeType: string;
+        attachmentId?: string;
+    }>;
+}
+export interface DaemonUserShellMessage extends DaemonMessageMeta {
+    id: string;
+    role: 'user_shell';
+    command: string;
+    output: string;
+    cwd?: string;
+}
+export interface DaemonBtwMessage extends DaemonMessageMeta {
+    id: string;
+    role: 'btw';
+    question: string;
+    answer: string;
+    isPending: boolean;
+}
+export interface DaemonInsightProgressMessage extends DaemonMessageMeta {
+    id: string;
+    role: 'insight_progress';
+    stage: string;
+    progress: number;
+    detail?: string;
+}
+export interface DaemonInsightReadyMessage extends DaemonMessageMeta {
+    id: string;
+    role: 'insight_ready';
+    path: string;
+}
+export interface DaemonInsightErrorMessage extends DaemonMessageMeta {
+    id: string;
+    role: 'insight_error';
+    error: string;
+}
+export type DaemonMessage = DaemonUserMessage | DaemonAssistantMessage | DaemonThinkingMessage | DaemonToolGroupMessage | DaemonPlanMessage | DaemonSystemMessage | DaemonUserShellMessage | DaemonBtwMessage | DaemonInsightProgressMessage | DaemonInsightReadyMessage | DaemonInsightErrorMessage;