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

package/dist/types/daemon-react-sdk.d.ts

@@ -0,0 +1,319 @@
+/**
+ * @license
+ * Copyright 2025 Qwen Team
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Daemon React bindings owned by `@qwen-code/web-shell`.
+ *
+ * React bindings for the Qwen Code daemon process.
+ * Provides context Providers, hooks, types, and constants
+ * for building UIs that connect to and interact with the daemon.
+ *
+ * @example
+ * ```tsx
+ * import {
+ *   DaemonSessionProvider,
+ *   DaemonWorkspaceProvider,
+ *   useConnection,
+ *   useStreamingState,
+ * } from '@qwen-code/web-shell';
+ * ```
+ */
+/**
+ * Wraps children with session-level daemon context.
+ * Manages a single conversation session: transcript, streaming state,
+ * prompt submission, and permission handling.
+ */
+export { DaemonSessionProvider } from './daemon/index.js';
+/**
+ * Default transcript block-count window applied by `DaemonSessionProvider`
+ * when no `maxBlocks` prop is given. Exported so UI surfaces can reference
+ * the provider default instead of hard-coding a copy that can drift.
+ */
+export { DEFAULT_MAX_BLOCKS as DAEMON_SESSION_DEFAULT_MAX_BLOCKS } from './daemon/session/index.js';
+/**
+ * Wraps children with workspace-level daemon context.
+ * Provides access to cross-session resources: tools, skills, MCP servers,
+ * memory, agents, and file system operations.
+ */
+export { DaemonWorkspaceProvider } from './daemon/index.js';
+/** Send prompts, cancel requests, and submit permission responses. */
+export { useDaemonActions as useActions } from './daemon/index.js';
+/** Connection status, capabilities, and model info. */
+export { useDaemonConnection as useConnection } from './daemon/index.js';
+/** Current session metadata (id, model, approval mode). */
+export { useDaemonSession as useSession } from './daemon/index.js';
+/** Classified session notices for host-owned UI such as toast or banners. */
+export { useDaemonSessionNotices as useSessionNotices } from './daemon/index.js';
+export { useDaemonSessionOwnerGuard } from './daemon/index.js';
+/** Streaming state: `'idle' | 'thinking' | 'responding'`. */
+export { useDaemonStreamingState as useStreamingState } from './daemon/index.js';
+/** All unresolved permission requests in the current transcript. */
+export { useDaemonPendingPermissions as usePendingPermissions } from './daemon/index.js';
+/** The currently active (most relevant) todo list. */
+export { useDaemonActiveTodoList as useActiveTodoList } from './daemon/index.js';
+/** List and inspect configured agents. */
+export { useDaemonAgents as useAgents } from './daemon/index.js';
+/** Authentication state for the daemon connection. */
+export { useDaemonAuth as useAuth } from './daemon/index.js';
+/** Channel catalog, configuration, lifecycle, and pairing management. */
+export { useDaemonChannels as useChannels } from './daemon/index.js';
+/** Language diagnostics (errors, warnings) from the workspace. */
+export { useDaemonDiagnostics as useDiagnostics } from './daemon/index.js';
+/** Workspace file operations: glob, read, write, edit, stat, listDirectory. */
+export { useDaemonFiles as useFiles } from './daemon/index.js';
+/** Run glob queries against the workspace file system. */
+export { useDaemonGlob as useGlob } from './daemon/index.js';
+/** MCP server status, tools, and management operations. */
+export { useDaemonMcp as useMcp } from './daemon/index.js';
+/** Memory files (CLAUDE.md etc.) stored in the workspace. */
+export { useDaemonMemory as useMemory } from './daemon/index.js';
+/** Generic SWR-style resource fetcher for daemon REST endpoints. */
+export { useDaemonResource as useResource } from './daemon/index.js';
+/**
+ * List daemon sessions (workspace-level). Switch/new/release actions require
+ * a nested `DaemonSessionProvider` — they are `undefined` without one.
+ */
+export { useDaemonSessions as useSessions } from './daemon/index.js';
+/** Available slash-command skills. */
+export { useDaemonSkills as useSkills } from './daemon/index.js';
+/** Consolidated daemon status report (`GET /daemon/status`). */
+export { useDaemonStatusReport as useStatusReport } from './daemon/index.js';
+/** Options for `useStatusReport` (detail level + resource load flags). */
+export type { DaemonStatusReportOptions as StatusReportOptions } from './daemon/index.js';
+/** Aggregate token-usage dashboard (`GET /usage/dashboard`). */
+export { useDaemonUsageDashboard as useUsageDashboard } from './daemon/index.js';
+/** Options for `useUsageDashboard` (heatmap window + resource load flags). */
+export type { DaemonUsageDashboardOptions as UsageDashboardOptions } from './daemon/index.js';
+/** Registered tools and their configuration. */
+export { useDaemonTools as useTools } from './daemon/index.js';
+/** Workspace settings (read/write). */
+export { useDaemonSettings as useSettings } from './daemon/index.js';
+export { useDaemonProviders as useProviders } from './daemon/index.js';
+/** Workspace context value (file ops, directory listing). */
+export { useDaemonWorkspace as useWorkspace } from './daemon/index.js';
+/** Workspace-level actions (create session, switch model, etc.). */
+export { useDaemonWorkspaceActions as useWorkspaceActions } from './daemon/index.js';
+/** Like `useWorkspace()` but returns null when outside a WorkspaceProvider. */
+export { useOptionalDaemonWorkspace as useOptionalWorkspace } from './daemon/index.js';
+/** Workspace-level event signals (memory/agents/tools/settings/mcp/extensions version counters). */
+export { useDaemonWorkspaceEventSignals as useWorkspaceEventSignals } from './daemon/index.js';
+/** Raw transcript blocks from the SSE stream. For custom message conversion. */
+export { useDaemonTranscriptBlocks as useTranscriptBlocks } from './daemon/session/index.js';
+/** Load older persisted transcript pages for the active session. */
+export { useDaemonTranscriptHistory as useTranscriptHistory } from './daemon/session/index.js';
+/** Full transcript state including block index and progress tracking. */
+export { useDaemonTranscriptState as useTranscriptState } from './daemon/session/index.js';
+/** Direct access to the transcript store (subscribe, getSnapshot). */
+export { useDaemonTranscriptStore as useTranscriptStore } from './daemon/session/index.js';
+/** Headless session-wide turn metadata and historical-page state. */
+export { useDaemonTurnNavigationState as useTurnNavigationState } from './daemon/session/index.js';
+/** Direct access to the session-wide turn navigation external store. */
+export { useDaemonTurnNavigationStore as useTurnNavigationStore } from './daemon/session/index.js';
+/** Low-level prompt lifecycle status (queued, streaming, idle). */
+export { useDaemonPromptStatus as usePromptStatus } from './daemon/session/index.js';
+/** Server-pushed prompt follow-up suggestions for daemon-backed UIs. */
+export { useDaemonFollowupSuggestion } from './daemon/index.js';
+/** Notifies when the daemon drains browser-queued messages into the running turn. */
+export { useDaemonMidTurnInjected } from './daemon/index.js';
+/** Notifies when the daemon's pending prompt queue changes (added/started/completed). */
+export { getPendingPromptVersion, getPendingPromptEvents, consumePendingPromptEvents, subscribePendingPromptEvents, subscribePendingPromptVersion, } from './daemon/index.js';
+/** Ordered list of approval modes for cycling: `['auto', 'suggest', 'ask']`. */
+export { DAEMON_APPROVAL_MODES } from './daemon/index.js';
+/** HTTP statuses that mean the requested daemon session no longer exists. */
+export { isMissingSessionHttpStatus } from './daemon/index.js';
+/** Canonical Agent (sub-agent) tool name + predicate for permission UIs. */
+export { AGENT_TOOL_NAME, isAgentTool } from './constants/toolNames.js';
+export type { 
+/** Full connection state: status, session id, models, context, capabilities. */
+DaemonConnectionState, 
+/** Connection lifecycle: `'idle' | 'connecting' | 'connected' | 'disconnected' | 'error'`. */
+DaemonConnectionStatus, 
+/** Latest main-conversation token usage reported by the daemon. */
+DaemonTokenUsage, 
+/** Model descriptor: id, display label, context window size. */
+DaemonModelInfo, 
+/** Explicit workspace, standalone, or Live product session context. */
+DaemonProductSessionContext, 
+/** Standalone working-directory and create-recovery state. */
+DaemonStandaloneConnectionState, 
+/** Classified notice category for host-owned UI routing. */
+DaemonNoticeCategory, 
+/** Fine-grained operation associated with a session notice. */
+DaemonNoticeOperation, 
+/** Notice severity. */
+DaemonNoticeSeverity, 
+/** Slash-command descriptor with name, description, and argument hint. */
+DaemonCommandInfo, 
+/** All session-level actions: prompt, cancel, permission, model, session management. */
+DaemonSessionActions, 
+/** Internal session context value (store + connection + actions). */
+DaemonSessionContextValue, 
+/** Structured session notice emitted outside the transcript. */
+DaemonSessionNotice, 
+/** Props accepted by `<DaemonSessionProvider>`. */
+DaemonSessionProviderProps, DaemonTranscriptHistory, DaemonProvisionalTurn, DaemonSelectedTurnState, DaemonTurnIndexPage, DaemonTurnLocation, DaemonTurnNavigationError, DaemonTurnNavigationSnapshot, DaemonTurnNavigationStore, HistoricalTranscriptPage, HistoricalTranscriptRange, TranscriptBoundary, 
+/** Streaming lifecycle: `'idle' | 'waiting' | 'responding' | 'thinking'`. */
+DaemonStreamingState, 
+/** Prompt submission status: `'idle' | 'waiting' | 'streaming'`. */
+DaemonPromptStatus, DaemonReasoningControls, 
+/** Hook return value for daemon follow-up suggestions. */
+UseDaemonFollowupSuggestionReturn, 
+/** Image attachment (base64 data + MIME type) for prompt submission. */
+DaemonPromptImage, 
+/** Text file attachment (name + text content) for prompt submission. */
+DaemonPromptFile, 
+/** Permission approval level: `'plan' | 'default' | 'auto-edit' | 'auto' | 'yolo'`. */
+DaemonApprovalMode, DaemonAuthProviderBaseUrlOption, DaemonAuthProviderCatalog, DaemonAuthProviderDescriptor, DaemonAuthProviderInstallRequest, DaemonAuthProviderInstallResult, DaemonModelProviderRuntimeSyncResult, DaemonAuthProviderModel, DaemonContextCategoryBreakdown, DaemonContextMemoryDetail, DaemonContextSkillDetail, DaemonContextToolDetail, DaemonSessionContextUsage, DaemonSessionContextUsageStatus, DaemonSessionOwnerGuard, DaemonSessionOwnerSnapshot, 
+/** Per-model API and token metrics within a stats response. */
+DaemonSessionStatsModelMetrics, 
+/** Per-subagent token metrics within a stats response. */
+DaemonSessionStatsSource, 
+/** Structured session statistics from `GET /session/:id/stats`. */
+DaemonSessionStatsStatus, 
+/** Per-tool call count, success/fail, and duration within a stats response. */
+DaemonSessionStatsToolByName, 
+/** Options for pending prompt queue actions scoped to a session. */
+PendingPromptActionOptions, 
+/** Options for `sendPrompt()`: optimistic message, image attachments. */
+SendPromptOptions, 
+/** Options for non-blocking `submitPrompt()`. */
+SubmitPromptOptions, 
+/** Result of non-blocking `submitPrompt()`: the daemon-assigned promptId. */
+SubmitPromptResult, } from './daemon/index.js';
+export type { 
+/** Single item in a todo list: id, content, status, priority. */
+DaemonTodoItem, 
+/** Complete todo list: title, items, associated tool call block. */
+DaemonTodoList, 
+/** Todo priority level: `'low' | 'medium' | 'high'`. */
+DaemonTodoPriority, 
+/** Todo item status: `'pending' | 'in_progress' | 'completed'`. */
+DaemonTodoStatus, } from './daemon/index.js';
+export type { 
+/** All workspace-level actions: MCP, tools, memory, agents, files, auth. */
+DaemonWorkspaceActions, DaemonChannelPairingActions, DaemonChannelsResource, 
+/** Internal workspace context value (client + actions + status + error). */
+DaemonWorkspaceContextValue, 
+/** Props accepted by `<DaemonWorkspaceProvider>`. */
+DaemonWorkspaceProviderProps, 
+/** Workspace connection lifecycle: `'idle' | 'connecting' | 'connected' | 'error'`. */
+DaemonWorkspaceStatus, 
+/** Options for resource hooks: `{ autoLoad?, enabled? }`. */
+DaemonResourceOptions, 
+/** Resource fetch result: `{ data, loading, error, reload() }`. */
+ResourceResult, 
+/** Resource state snapshot: `{ data, loading, error }`. */
+ResourceState, } from './daemon/index.js';
+export type { 
+/** Single entry in a directory listing: name, kind, ignored status. */
+DaemonDirectoryEntry, 
+/** Full directory listing: path, entries array, truncation flag. */
+DaemonDirectoryListing, 
+/** File metadata: path, type, size, modification time. */
+DaemonFileStat, 
+/** Options for glob queries: maxResults, includeIgnored, cwd. */
+DaemonGlobOptions, 
+/** Glob match result containing matched file paths. */
+DaemonGlobResult, 
+/** One session's active `/goal`, as listed workspace-wide by the daemon. */
+DaemonGoal, 
+/** The `GET /goals` payload: the goals plus a count of unreachable sessions. */
+DaemonGoalList, 
+/** A durable scheduled task (cron) as returned by the daemon. */
+DaemonScheduledTask, 
+/** One recorded fire in a scheduled task's run history. */
+DaemonScheduledTaskRun, 
+/** Request body for creating a scheduled task. */
+DaemonCreateScheduledTaskRequest, 
+/** Partial-update body for a scheduled task. */
+DaemonUpdateScheduledTaskRequest, 
+/** Memory file scope: `'workspace' | 'global'`. */
+DaemonContextFileScope, } from './daemon/index.js';
+export type { 
+/** Session list entry: id, title, timestamps, client count, active prompt flag. */
+DaemonSessionSummary, 
+/** Daemon status report envelope from `GET /daemon/status`. */
+DaemonStatusReport, 
+/** Status report detail level: `'summary' | 'full'`. */
+DaemonStatusReportDetail, 
+/** One triage finding in the daemon status rollup. */
+DaemonStatusReportIssue, 
+/** Overall daemon health rollup: `'ok' | 'warning' | 'error'`. */
+DaemonStatusReportLevel, 
+/** Per-section workspace diagnostics in a `detail=full` report. */
+DaemonStatusReportSection, 
+/** Per-session diagnostics row in a `detail=full` report. */
+DaemonStatusReportSession, 
+/** One time-bucketed sample in the Daemon Status metrics series (charts). */
+DaemonMetricsSeriesBucket, 
+/** Usage-dashboard summary window: `today` | `week` (7D) | `month` (30D). */
+DaemonUsageRange, 
+/** Aggregate token-usage dashboard payload (`GET /usage/dashboard`). */
+DaemonUsageDashboard, 
+/** Flattened summary totals in the usage dashboard. */
+DaemonUsageDashboardTotals, 
+/** One model's token share of the range. */
+DaemonUsageModelShare, 
+/** One skill's invocation count over the range. */
+DaemonUsageSkillCall, 
+/** One day's tokens + sessions for the daily charts. */
+DaemonUsageDailyPoint, 
+/** One heatmap cell: tokens (intensity) + cache-read rate. */
+DaemonUsageHeatmapDay, 
+/** Full agent detail including system prompt, tools, and run config. */
+DaemonWorkspaceAgentDetail, 
+/** Agent list entry: name, description, level, model, builtin flag. */
+DaemonWorkspaceAgentSummary, DaemonWorkspaceGenerationEvent, 
+/** MCP server status: name, transport, connection state, disabled reason. */
+DaemonWorkspaceMcpServerStatus, 
+/** Single MCP tool: name, description, JSON schema, validity. */
+DaemonWorkspaceMcpToolStatus, 
+/** All tools from a single MCP server. */
+DaemonWorkspaceMcpToolsStatus, 
+/** Single MCP resource: uri, name, title, mime type, size, description. */
+DaemonWorkspaceMcpResourceStatus, 
+/** All resources from a single MCP server. */
+DaemonWorkspaceMcpResourcesStatus, 
+/** Memory file entry: path, scope, byte size. */
+DaemonWorkspaceMemoryFile, 
+/** Skill status: name, description, level, model-invocable flag. */
+DaemonWorkspaceSkillStatus, 
+/** Registered tool: name, displayName, description, enabled flag. */
+DaemonWorkspaceToolStatus, 
+/** Individual setting descriptor returned by GET /workspace/settings. */
+DaemonSettingDescriptor, 
+/** Full settings response including schema, values, and warnings. */
+DaemonWorkspaceSettingsStatus, 
+/** Result of POST /workspace/settings. */
+DaemonSettingUpdateResult, 
+/** Configured model providers returned by GET /workspace/providers. */
+DaemonWorkspaceProvidersStatus, DaemonWorkspaceProviderStatus, DaemonWorkspaceProviderModel, DaemonChannelConfigFieldKind, DaemonChannelConfigFieldDescriptor, DaemonChannelConfigValueFieldDescriptor, DaemonChannelConfigPlainValueFieldDescriptor, DaemonChannelConfigEnumFieldDescriptor, DaemonChannelConfigNumberFieldDescriptor, DaemonChannelConfigObjectFieldDescriptor, DaemonChannelConfigNestedFieldDescriptor, DaemonChannelTypeDescriptor, DaemonChannelTypeCatalog, DaemonChannelRuntimeState, DaemonChannelSecretState, DaemonChannelInstanceSnapshot, DaemonChannelsSnapshot, DaemonChannelSecretUpdate, DaemonRevisionRequest, DaemonChannelUpsertRequest, DaemonChannelStartupRequest, DaemonChannelMutationResult, DaemonChannelPairingRequest, DaemonChannelPairingSubject, DaemonChannelPairingRequestsSnapshot, DaemonChannelPairingApprovalRequest, DaemonChannelPairingApprovalResult, DaemonChannelPairingApprovalsSnapshot, DaemonChannelPairingRevocationRequest, DaemonChannelPairingRevocationResult, 
+/** Request/result for DELETE /workspace/models. */
+DaemonModelDeleteRequest, DaemonModelDeleteResult, } from './daemon/index.js';
+export type { 
+/** Shell output block: stdout/stderr text stream. */
+DaemonShellTranscriptBlock, 
+/** Status/error/debug informational block. */
+DaemonStatusTranscriptBlock, 
+/** User, assistant, or thought text block (may be streaming). */
+DaemonTextTranscriptBlock, 
+/** Tool invocation block with preview, content, locations. */
+DaemonToolTranscriptBlock, 
+/** Discriminated union of all transcript block types. */
+DaemonTranscriptBlock, 
+/** Block kind tag: `'user' | 'assistant' | 'thought' | 'tool' | 'shell' | 'permission' | 'status' | 'error' | 'debug'`. */
+DaemonTranscriptBlockKind, 
+/** Interactive question block (ask_user_question tool preview). */
+DaemonTranscriptQuestion, 
+/** Single option within a transcript question. */
+DaemonTranscriptQuestionOption, 
+/** Configuration for the transcript reducer: maxBlocks, initial timestamp. */
+DaemonTranscriptReducerOptions, 
+/** Non-chat side state: current tool call, approval mode, progress, resync. */
+DaemonTranscriptSidechannelState, 
+/** Full transcript snapshot: blocks array, indexes, active IDs, sidechannel. */
+DaemonTranscriptState, 
+/** External store interface: getSnapshot, subscribe, dispatch, reset. */
+DaemonTranscriptStore, } from '@qwen-code/sdk/daemon';

package/dist/types/extensions/inputHighlight.d.ts

@@ -0,0 +1,10 @@
+import { ViewPlugin, EditorView } from '@codemirror/view';
+import type { DecorationSet, ViewUpdate } from '@codemirror/view';
+import type { CommandInfo } from '../adapters/types';
+import type { WebShellLanguage } from '../i18n';
+export declare function buildInputHighlightDecorations(view: EditorView, getCommands: () => CommandInfo[], getLanguage: () => WebShellLanguage): DecorationSet;
+export declare function inputHighlight(getCommands?: () => CommandInfo[], getLanguage?: () => WebShellLanguage): ViewPlugin<{
+    decorations: DecorationSet;
+    update(update: ViewUpdate): void;
+}, undefined>;
+export declare const inputHighlightTheme: import("@codemirror/state").Extension;

package/dist/types/hooks/daemonSessionMappers.d.ts

@@ -0,0 +1,2 @@
+import type { CommandInfo } from '../adapters/types';
+export declare function mergeCommands(...groups: CommandInfo[][]): CommandInfo[];

package/dist/types/hooks/useAnimationFrameTranscriptBlocks.d.ts

@@ -0,0 +1,10 @@
+import type { DaemonTranscriptBlock, DaemonTranscriptBlockChangeSummary } from '@qwen-code/sdk/daemon';
+interface AnimationFrameTranscriptSnapshot {
+    blocks: readonly DaemonTranscriptBlock[];
+    blockChangeSummary?: DaemonTranscriptBlockChangeSummary;
+}
+interface AnimationFrameTranscriptSnapshotOptions {
+    structuralOnly?: boolean;
+}
+export declare function useAnimationFrameTranscriptSnapshot(options?: AnimationFrameTranscriptSnapshotOptions): AnimationFrameTranscriptSnapshot;
+export {};

package/dist/types/hooks/useAnimationFrameValue.d.ts

@@ -0,0 +1 @@
+export declare function useAnimationFrameValue<T>(value: T): T;

package/dist/types/hooks/useAtMentionMenu.d.ts

@@ -0,0 +1,72 @@
+import type { RefObject, ReactNode } from 'react';
+import type { StateEffect } from '@codemirror/state';
+import type { EditorView } from '@codemirror/view';
+import type { WebShellAtProvider, WebShellAtProviderTab, WebShellBuiltinAtProvidersConfig, WebShellComposerTag } from '../customization';
+import type { AtMentionItem, AtMentionWorkspaceActions } from './useAtMentionSources';
+export { FILE_PROVIDER_ID, MCP_RESOURCES_PROVIDER_ID, fileReferenceInsertText, sanitizeDisplayText, } from './useAtMentionSources';
+export type { AtMentionItem, AtMentionWorkspaceActions, } from './useAtMentionSources';
+export interface AtMentionProviderView {
+    id: string;
+    provider: WebShellAtProvider;
+    label: ReactNode;
+    textValue: string;
+    description?: string;
+    tabs?: readonly WebShellAtProviderTab[];
+    selectedTabId?: string;
+    renderItem?: WebShellAtProvider['renderItem'];
+}
+export interface AtMentionMenuState {
+    from: number;
+    to: number;
+    query: string;
+    level: 'categories' | 'items';
+    selectedProviderId?: string;
+    selectedIndex: number;
+    providers: AtMentionProviderView[];
+    items: AtMentionItem[];
+    loading: boolean;
+    itemMode?: 'default' | 'mcpServers' | 'mcpResources';
+    mcpServerName?: string;
+    fileDirectory?: string;
+    inputMode?: 'search' | 'context';
+    validateMcpServer?: boolean;
+    tabs?: readonly WebShellAtProviderTab[];
+    selectedTabId?: string;
+}
+export interface UseAtMentionMenuOptions {
+    viewRef: RefObject<EditorView | null>;
+    disabledRef: RefObject<boolean>;
+    shellModeRef: RefObject<boolean>;
+    workspaceActionsRef: RefObject<AtMentionWorkspaceActions | undefined>;
+    workspaceKey?: string;
+    builtinProviders?: WebShellBuiltinAtProvidersConfig;
+    providers?: readonly WebShellAtProvider[];
+    createInlineTagEffect?: (range: {
+        from: number;
+        to: number;
+        tag: WebShellComposerTag;
+    }) => StateEffect<unknown>;
+    /**
+     * Invoked when the user selects the synthetic "Upload file" item in the
+     * file provider. Receives the directory currently being browsed and a
+     * callback that re-inserts the mention query removed before the picker
+     * opened — call it when the picker closes without an upload so the typed
+     * text is not lost. When absent (upload unsupported), the item is hidden.
+     */
+    onUploadRequest?: (targetDir: string, restoreQuery?: () => void) => void;
+}
+export declare function useAtMentionMenu({ viewRef, disabledRef, shellModeRef, workspaceActionsRef, workspaceKey, builtinProviders, providers, createInlineTagEffect, onUploadRequest, }: UseAtMentionMenuOptions): {
+    state: AtMentionMenuState | null;
+    close: (options?: {
+        preserveProviderSelection?: boolean;
+    }) => void;
+    closeIfOpen: () => false | "closed" | "categories";
+    refreshForView: (view: EditorView | null) => boolean;
+    moveSelection: (direction: "up" | "down") => boolean;
+    select: (index: number) => boolean;
+    accept: (index?: number) => boolean;
+    enterCategory: (index?: number) => boolean;
+    selectTab: (tabId: string) => boolean;
+    backToCategories: () => false | "items" | "categories";
+    updateSearch: (query: string) => boolean;
+};

package/dist/types/hooks/useAtMentionSources.d.ts

@@ -0,0 +1,113 @@
+import type { WebShellAtItem, WebShellAtProvider, WebShellBuiltinAtProviderId, WebShellComposerTag } from '../customization';
+type GlobWorkspaceFn = (pattern: string, opts?: {
+    maxResults?: number;
+    signal?: AbortSignal;
+}) => Promise<{
+    matches: string[];
+}>;
+interface ExtensionEntry {
+    name: string;
+    displayName?: string;
+    description?: string;
+    isActive: boolean;
+}
+type LoadExtensionsStatusFn = () => Promise<{
+    extensions: ExtensionEntry[];
+}>;
+interface DirectoryEntry {
+    name: string;
+    kind: 'file' | 'directory' | 'symlink' | 'other';
+    ignored: boolean;
+}
+type ListDirectoryFn = (dirPath: string, options?: {
+    signal?: AbortSignal;
+}) => Promise<{
+    kind: 'list';
+    path: string;
+    entries: DirectoryEntry[];
+    truncated: boolean;
+}>;
+interface McpServerEntry {
+    kind: 'mcp_server';
+    name: string;
+    disabled: boolean;
+    mcpStatus?: string;
+    resourceCount?: number;
+    description?: string;
+}
+type LoadMcpStatusFn = () => Promise<{
+    servers: McpServerEntry[];
+}>;
+type LoadMcpResourcesFn = (serverName: string, options?: {
+    signal?: AbortSignal;
+}) => Promise<{
+    resources: Array<{
+        uri: string;
+        name?: string;
+        title?: string;
+        description?: string;
+        mimeType?: string;
+        size?: number;
+    }>;
+}>;
+type DirectoryListing = Awaited<ReturnType<ListDirectoryFn>>;
+type GlobWorkspaceResult = Awaited<ReturnType<GlobWorkspaceFn>>;
+type ExtensionsStatus = Awaited<ReturnType<LoadExtensionsStatusFn>>;
+export type McpStatus = Awaited<ReturnType<LoadMcpStatusFn>>;
+type McpResources = Awaited<ReturnType<LoadMcpResourcesFn>>;
+export interface BuiltinProviderCache {
+    directories: Map<string, Promise<DirectoryListing>>;
+    globResults: Map<string, Promise<GlobWorkspaceResult>>;
+    extensionsStatus?: Promise<ExtensionsStatus>;
+    mcpStatus?: Promise<McpStatus>;
+    mcpResources: Map<string, Promise<McpResources>>;
+}
+export declare function createBuiltinProviderCache(): BuiltinProviderCache;
+export declare function getCached<K, V>(cache: Map<K, Promise<V>>, key: K, load: () => Promise<V>): Promise<V>;
+export interface AtMentionWorkspaceActions {
+    globWorkspace?: GlobWorkspaceFn;
+    loadExtensionsStatus?: LoadExtensionsStatusFn;
+    listDirectory?: ListDirectoryFn;
+    loadMcpStatus?: LoadMcpStatusFn;
+    loadMcpResources?: LoadMcpResourcesFn;
+}
+export interface AtMentionItem extends WebShellAtItem {
+    kind?: 'insert' | 'directory' | 'mcp-server' | 'upload';
+    fileKind?: DirectoryEntry['kind'];
+    targetPath?: string;
+    serverName?: string;
+}
+export declare const ITEM_LIMIT = 50;
+export declare const FILE_ROOT_ITEM_LIMIT: number;
+export declare const FILE_PROVIDER_ID = "files";
+export declare const EXTENSIONS_PROVIDER_ID = "extensions";
+export declare const MCP_RESOURCES_PROVIDER_ID = "mcp-resources";
+export declare const BUILTIN_PROVIDER_IDS: readonly WebShellBuiltinAtProviderId[];
+export declare const SAFE_DISPLAY_FALLBACK = "[invalid]";
+export declare function normalizeDirectoryPath(path: string): string;
+export declare function escapeGlobQuery(query: string): string;
+export declare function fileSearchGlobPattern(query: string): string;
+export declare function matchesQuery(query: string, ...values: Array<string | undefined>): boolean;
+export declare function escapeAtReferenceText(ref: string): string;
+export declare function unescapeAtReferenceText(ref: string): string;
+export declare function splitFileQuery(query: string, fallbackDir: string): {
+    dirPath: string;
+    entryQuery: string;
+};
+export declare function sanitizeDisplayText(raw: string): string | undefined;
+export declare function sanitizeInsertText(raw: string): string;
+/**
+ * Build the composer insert text for a workspace file reference, e.g.
+ * `@path/to/file `. Shared by the @ file provider and the file-upload flow so
+ * both escape identically (filenames with spaces / non-ASCII / `%` are common).
+ */
+export declare function fileReferenceInsertText(filePath: string): string;
+export declare function safeDisplayText(raw: string | undefined): string;
+export declare function sanitizeAtMentionItem(item: AtMentionItem, options?: {
+    customProvider?: boolean;
+}): AtMentionItem;
+export declare function createComposerTagForItem(providerId: string | undefined, item: AtMentionItem, insert: string): WebShellComposerTag | null;
+export declare function createFileProvider(getActions: () => AtMentionWorkspaceActions | undefined, getCurrentDir: () => string, getCache: () => BuiltinProviderCache, label: string, description: string, getUploadItem: () => AtMentionItem | null, browseDirectories?: boolean): WebShellAtProvider;
+export declare function createExtensionProvider(getActions: () => AtMentionWorkspaceActions | undefined, getCache: () => BuiltinProviderCache, label: string, description: string): WebShellAtProvider;
+export declare function createMcpResourcesProvider(getActions: () => AtMentionWorkspaceActions | undefined, getCache: () => BuiltinProviderCache, label: string, description: string, formatResourceCount: (count: number) => string): WebShellAtProvider;
+export {};

package/dist/types/hooks/useBackgroundTasks.d.ts

@@ -0,0 +1,8 @@
+import type { DaemonSessionTaskWithWorkflowStatus } from '@qwen-code/sdk/daemon';
+export declare function useBackgroundTasks(sessionId: string | undefined, taskActivityKey: string, 
+/**
+ * Whether any background task tool call is still running. Passed in as a
+ * fact rather than re-parsed out of `taskActivityKey`, whose rendering is
+ * not injective (callId is unconstrained text).
+ */
+taskActivityActive: boolean, connected: boolean, refreshTrigger?: number, workflowsEnabled?: boolean): DaemonSessionTaskWithWorkflowStatus[];

package/dist/types/hooks/useChatNavigationVisible.d.ts

@@ -0,0 +1,2 @@
+import { type RefObject } from 'react';
+export declare function useChatNavigationVisible(ref: RefObject<HTMLElement | null>, enabled: boolean): boolean;