@qwen-code/web-shell 0.25.2-preview.0 → 0.25.2

package/dist/types/App.d.ts

@@ -287,8 +287,8 @@ export interface WebShellProps {
     /** 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.
+     * Controls composer uploads (drag-and-drop and the @ panel upload item)
+     * and Files tree drag-and-drop uploads. 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
@@ -300,13 +300,14 @@ export interface WebShellProps {
      */
     fileDropAction?: 'upload' | 'attach';
     /**
-     * Directory that drag-and-dropped files upload into, **relative to the
+     * Directory that composer-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.
+     * when it does not exist. Files tree drops use the explicit tree destination
+     * instead of this setting.
      */
     fileUploadDirectory?: string;
     /** Additional @ mention categories shown alongside built-in files/extensions. */
@@ -423,6 +424,7 @@ export interface WebShellProps {
     onSubmitBefore?: (params: {
         sessionId: string | undefined;
         prompt: string;
+        source?: 'mcp-app';
     }) => Promise<void>;
 }
 interface AppProps extends WebShellProps {

package/dist/types/components/ChatContextHeader.d.ts

@@ -6,12 +6,17 @@ interface ChatContextHeaderProps {
     /**
      * Workspace shown as the header's leading icon. Omitting it means the shell
      * has no workspace: the icon stays the same folder and only its tooltip says
-     * so, because the icon is the one place that always answers "which workspace
-     * is this session in?".
+     * so. In a session this icon always reports the workspace; the empty-state
+     * header can defer to a visible composer workspace selector.
      */
     workspaceName?: string;
     /** Full workspace path, shown as the leading icon's hover tooltip. */
     workspacePath?: string;
+    /**
+     * Hides the leading workspace icon when the new-task composer's workspace
+     * selector is visible and already names the workspace.
+     */
+    hideWorkspaceIcon?: boolean;
     environmentOpen: boolean;
     environmentAvailable: boolean;
     /** Whether the panel holds an in-progress subagent or background task. */
@@ -27,5 +32,5 @@ interface ChatContextHeaderProps {
     /** Shows the Local Control QR entry; hidden when omitted. */
     onOpenLocalControlSettings?: () => void;
 }
-export declare function ChatContextHeader({ content, location, workspaceName, workspacePath, environmentOpen, environmentAvailable, environmentRunning, rightPanelOpen, rightPanelAvailable, onToggleEnvironment, onToggleRightPanel, onOpenTokenUsage, onOpenContextUsage, onOpenLocalControlSettings, }: ChatContextHeaderProps): import("react/jsx-runtime").JSX.Element;
+export declare function ChatContextHeader({ content, location, workspaceName, workspacePath, hideWorkspaceIcon, environmentOpen, environmentAvailable, environmentRunning, rightPanelOpen, rightPanelAvailable, onToggleEnvironment, onToggleRightPanel, onOpenTokenUsage, onOpenContextUsage, onOpenLocalControlSettings, }: ChatContextHeaderProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/components/artifacts/files-messages.d.ts

@@ -3,6 +3,7 @@ export declare const FILES_MESSAGES_EN: {
     'files.copyAbsolutePath': string;
     'files.reference': string;
     'files.title': string;
+    'files.uploadTo': string;
     'files.description': string;
     'files.filter': string;
     'files.noMatches': string;
@@ -20,6 +21,7 @@ export declare const FILES_MESSAGES_ZH: {
     'files.copyAbsolutePath': string;
     'files.reference': string;
     'files.title': string;
+    'files.uploadTo': string;
     'files.description': string;
     'files.filter': string;
     'files.noMatches': string;

package/dist/types/components/artifacts/useArtifactWorkspaceTarget.d.ts

@@ -1,6 +1,7 @@
 import type { DaemonCapabilities } from '@qwen-code/sdk/daemon';
 import { type DaemonWorkspaceActions } from '@qwen-code/web-shell/daemon-react-sdk';
-export type ArtifactWorkspaceActions = Pick<DaemonWorkspaceActions, 'readWorkspaceFile' | 'readFileBytes' | 'stat' | 'listDirectory' | 'listScheduledTasks' | 'updateScheduledTask' | 'deleteScheduledTask'>;
+import type { FileUploadClient } from '../../hooks/useFileUpload';
+export type ArtifactWorkspaceActions = Pick<DaemonWorkspaceActions, 'readWorkspaceFile' | 'readFileBytes' | 'stat' | 'listDirectory' | 'listScheduledTasks' | 'updateScheduledTask' | 'deleteScheduledTask'> & Partial<FileUploadClient>;
 interface ArtifactWorkspaceOwner {
     cwd: string;
     id?: string;

package/dist/types/components/managed/generated/managed-agent-api.d.ts

@@ -57,7 +57,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** @description POST SSE consumed through fetch response.body. An afterSequence below the replay floor ends the stream with one agent.session.resync_required frame instead of a 409 only while the Snapshot backs the floor (replay_floor_sequence <= snapshot_through_sequence); a stream reconciliation discards the Snapshot without lowering the floor, and during that rebuild such a cursor is served from the retained events. On the resync frame, reload the transcript and resume after its lastSequence. */
+        /** @description POST SSE consumed through fetch response.body. An afterSequence strictly below the durable replay floor ends the stream with one agent.session.resync_required frame. Projection rebuilds preserve that floor and the current immutable Snapshot. On the resync frame, reload the transcript and resume after its lastSequence. */
         post: operations["webShellStreamEvents"];
         delete?: never;
         options?: never;
@@ -404,7 +404,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** @description Synchronously restores an archived Session to closed. Workspace-bound Sessions require completed reliable-close evidence and the Session's recorded owner with current read access (404 unreadable, 403 readable non-owner). Bound keys are tenant/Session/actor scoped. Replay returns the current visible Session without repeating the mutation; a deleted Session returns 404. The permanent close fence is preserved and no Harness or Runtime call is made. */
+        /** @description Synchronously restores an archived Session to closed. Workspace-bound Sessions require completed reliable-close evidence and the Session's recorded owner with current read access (404 unreadable, 403 readable non-owner). Bound keys are tenant/Session/actor scoped. Replay returns the recorded outcome without repeating the mutation; a replay after delete answers with the Session as last visible — its pre-delete status — rather than 404. The permanent close fence is preserved and no Harness or Runtime call is made. */
         post: operations["unarchiveWebShellSession"];
         delete?: never;
         options?: never;
@@ -474,6 +474,7 @@ export interface components {
             agentId: string;
             /** @description Planned; phase one rejects non-blank values. */
             environmentId?: string | null;
+            /** @description The server enforces the bound in UTF-16 code units (Java String.length()), so an astral character counts as two: a title this schema's code-point maxLength accepts can still exceed the server's 256-unit bound and answer 400 invalid_title. */
             title?: string | null;
             /** @description Each block adds to a 4,000,000-character aggregate admission budget per command (per-block 1,000,000-character cap applies). Admission ceiling only: a command whose serialized prompt or durable Session-store record exceeds the Hosted Harness's 64 KiB durable-record limit is accepted and then fails the Turn with hosted_harness_rejected. */
             input?: components["schemas"]["InputBlock"][];
@@ -921,7 +922,7 @@ export interface components {
          */
         TaskRuntimeState: "unbound" | "provisioning" | "ready" | "draining" | "lost";
         /**
-         * @description Actions the task supports now, the same for every caller. cancel: the cancel route accepts a new command for this task (since 1.40, child_agent tasks in pending, running, waiting or degraded, in an active Session); whether a caller may use it is an authorization check (403 on the cancel route). send_input: reserved for a later capability route. read_output: the task events route returns output events for this task to any caller that can read it. read_output does not change during the task's life, and a task without it produces no output events: its output goes only to Artifacts, so the events route never filters out events that exist.
+         * @description Actions the task supports now, the same for every caller. cancel: the cancel route accepts a new command for this task (since 1.40 for child_agent and 1.46 for workflow, tasks of those kinds in pending, running, waiting or degraded, in an active Session); whether a caller may use it is an authorization check (403 on the cancel route). send_input: reserved for a later capability route. read_output: the task events route returns output events for this task to any caller that can read it. read_output does not change during the task's life, and a task without it produces no output events: its output goes only to Artifacts, so the events route never filters out events that exist.
          * @enum {string}
          */
         TaskActionCapability: "cancel" | "send_input" | "read_output";
@@ -1174,7 +1175,7 @@ export interface components {
     parameters: never;
     requestBodies: never;
     headers: {
-        /** @description True when an accepted command or operation was replayed for the same idempotency key and digest without repeating its mutation. Session mutation responses represent the current visible Session; operation responses represent the original operation at its current state. */
+        /** @description True when an accepted command or operation was replayed for the same idempotency key and digest without repeating its mutation. Session mutation responses represent the recorded outcome on the Session as last visible — a rename or unarchive replay after delete answers with the Session's pre-delete status rather than 404, while a create replay after delete answers 404 on the public create route, which re-reads the Session before responding, and answers the recorded 202 admission carrying the tombstoned sessionId on the WebShell create route, which does not re-read it; operation responses represent the original operation at its current state. */
         IdempotentReplay: boolean;
         /** @description Trace-only correlation identifier; never an idempotency key. */
         RequestId: string;

package/dist/types/components/messages/TasksStatusMessage.d.ts

@@ -1,6 +1,7 @@
 import type { DaemonSessionMonitorTaskStatus, DaemonSessionShellTaskStatus, DaemonSessionWorkflowTasksStatus } from '@qwen-code/sdk/daemon';
 import { type DaemonSessionActions } from '@qwen-code/web-shell/daemon-react-sdk';
 import type { ACPToolCall, TodoItem } from '../../adapters/types';
+import type { OpenSubagentDetails } from '../../subagentDetailsContext';
 declare const ACTIVE_EVENT = "web-shell:tasks-panel-active";
 type DaemonSessionTasksStatus = DaemonSessionWorkflowTasksStatus;
 export interface SerializedTasksMessage {
@@ -24,7 +25,7 @@ export declare function TasksStatusMessage({ message, embedded, manageActiveEven
     onClose?: () => void;
     planTodos?: readonly TodoItem[];
     agentTools?: readonly ACPToolCall[];
-    onOpenSubagent?: (tool: ACPToolCall) => void;
+    onOpenSubagent?: OpenSubagentDetails;
     onOpenMonitor?: (task: DaemonSessionMonitorTaskStatus) => void;
 }): import("react/jsx-runtime").JSX.Element | null;
 export declare function MonitorTaskDetail({ task, actions: providedActions, }: {

package/dist/types/components/messages/WorkflowExecutionView.d.ts

@@ -1,5 +1,6 @@
 import { type ReactNode } from 'react';
 import type { DaemonSessionWorkflowTaskStatus, DaemonWorkflowDispatchStatus, DaemonWorkflowDispatchStatusEntry } from '@qwen-code/sdk/daemon';
+import type { OpenSubagentDetails } from '../../subagentDetailsContext';
 export declare const WORKFLOW_GRAPH_RENDER_LIMITS: {
     readonly lanes: 64;
     readonly nodes: 240;
@@ -36,7 +37,7 @@ export interface WorkflowGraphLayout {
 export declare function buildWorkflowGraphLayout(task: DaemonSessionWorkflowTaskStatus, options?: {
     laneWidth?: number;
 }): WorkflowGraphLayout;
-export declare function WorkflowExecutionView({ task, sourceTask, historyTasks, historyActionBusy, onDeleteHistory, actions, }: {
+export declare function WorkflowExecutionView({ task, sourceTask, historyTasks, historyActionBusy, onDeleteHistory, actions, onOpenSubagent, }: {
     task: DaemonSessionWorkflowTaskStatus;
     sourceTask?: DaemonSessionWorkflowTaskStatus;
     historyTasks?: readonly DaemonSessionWorkflowTaskStatus[];
@@ -44,5 +45,6 @@ export declare function WorkflowExecutionView({ task, sourceTask, historyTasks,
     onDeleteHistory?: (runId: string) => void;
     /** Run controls (pause / stop / rerun …) shown at the end of the metrics strip. */
     actions?: ReactNode;
+    onOpenSubagent?: OpenSubagentDetails;
 }): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/components/messages/workflow-agent-details.d.ts

@@ -0,0 +1,3 @@
+import type { DaemonSessionWorkflowTaskStatus, DaemonWorkflowDispatchStatusEntry } from '@qwen-code/sdk/daemon';
+import { type OpenSubagentDetails } from '../../subagentDetailsContext';
+export declare function useWorkflowAgentDetails(task: DaemonSessionWorkflowTaskStatus, onOpenSubagent?: OpenSubagentDetails): (dispatch: DaemonWorkflowDispatchStatusEntry) => void;

package/dist/types/components/messages/workflow-agent-details.transcript-stub.d.ts

@@ -0,0 +1 @@
+export declare function useWorkflowAgentDetails(): () => void;

package/dist/types/components/workflows/WorkflowRunsPage.d.ts

@@ -1,6 +1,8 @@
+import type { OpenSubagentDetails } from '../../subagentDetailsContext';
 interface WorkflowRunsPageProps {
     onCreateViaChat: () => void;
     onWorkflowRunStarted?: () => void;
+    onOpenSubagent?: OpenSubagentDetails;
 }
-export declare function WorkflowRunsPage({ onCreateViaChat, onWorkflowRunStarted, }: WorkflowRunsPageProps): import("react/jsx-runtime").JSX.Element;
+export declare function WorkflowRunsPage({ onCreateViaChat, onWorkflowRunStarted, onOpenSubagent, }: WorkflowRunsPageProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/customization.d.ts

@@ -205,6 +205,7 @@ export interface WebShellSubmitSnapshot {
     sessionId?: string;
     prompt: string;
     inputAnnotations: readonly DaemonInputAnnotation[];
+    source?: 'mcp-app';
 }
 export type UserMessageContentRenderer = (info: UserMessageContentRenderInfo) => ReactNode;
 export interface WebShellBottomStatusItem {
@@ -557,8 +558,8 @@ export interface WebShellCustomization {
     markdown?: WebShellMarkdownCustomization;
     loadingPhrases?: LoadingPhrasesResolver;
     /**
-     * Controls whether the composer's file-upload entry points (drag-and-drop
-     * and the @ panel upload item) are enabled. Does not disable attachments.
+     * Controls composer uploads (drag-and-drop and the @ panel upload item)
+     * and Files tree drag-and-drop uploads. Does not disable attachments.
      * Works alongside the daemon's
      * `workspace_file_upload` capability, not instead of it: setting `false`
      * force-disables upload even when the daemon advertises the capability,
@@ -571,13 +572,14 @@ export interface WebShellCustomization {
      */
     fileDropAction?: 'upload' | 'attach';
     /**
-     * Directory that drag-and-dropped files upload into, **relative to the
+     * Directory that composer-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.
+     * when it does not exist. Files tree drops use the explicit tree destination
+     * instead of this setting.
      */
     fileUploadDirectory?: string;
 }

package/dist/types/daemon/session/types.d.ts

@@ -266,6 +266,7 @@ export interface DaemonCommandInfo {
 export interface SendPromptOptions {
     /** Original text declared at the user submission boundary, before host preparation. */
     submittedPrompt?: string;
+    source?: 'mcp-app';
     optimisticUserMessage?: boolean;
     images?: DaemonPromptImage[];
     files?: DaemonPromptFile[];
@@ -278,6 +279,8 @@ export interface SendPromptOptions {
     retry?: boolean;
     /** Fired after local validation, immediately before dispatch to the daemon. */
     onAdmissionStarted?: () => void;
+    /** Revalidates the caller before every HTTP attempt, including client recovery. */
+    beforeDispatch?: (clientId: string | undefined) => void;
     /**
      * Fired once the daemon has ACCEPTED the prompt (admission), before the turn
      * runs to completion. Lets a caller act on "the prompt reached the session"
@@ -290,7 +293,7 @@ export interface SendPromptOptions {
         promptId: string;
     }) => void;
 }
-export interface SubmitPromptOptions extends SendPromptOptions {
+export interface SubmitPromptOptions extends Omit<SendPromptOptions, 'beforeDispatch' | 'source'> {
     sessionId?: string;
     signal?: AbortSignal;
 }

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

@@ -0,0 +1,22 @@
+import type { McpAppMessages } from '../mcpAppHostContext';
+import type { DaemonSessionOwnerSnapshot } from '../daemon/session/types';
+export interface McpAppPromptSubmission {
+    signal: AbortSignal;
+    isCurrent(): boolean;
+    onDispatched(): void;
+    onAdmitted(admission: {
+        promptId: string;
+    }): void;
+}
+interface MessageHost {
+    enabled: boolean;
+    sessionId?: string;
+    clientId?: string;
+    captureOwner(): DaemonSessionOwnerSnapshot;
+    submit(text: string, options: McpAppPromptSubmission): Promise<unknown>;
+}
+export declare function useMcpAppMessages(host: MessageHost): {
+    context: McpAppMessages | undefined;
+    review: import("react/jsx-runtime").JSX.Element | null;
+};
+export {};

package/dist/types/mcp-app/messages.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2026 Qwen Team
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare const MCP_APP_MESSAGES_EN: Record<string, string>;
+export declare const MCP_APP_MESSAGES_ZH: Record<string, string>;

package/dist/types/mcp-app/messages.transcript-stub.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2026 Qwen Team
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare const MCP_APP_MESSAGES_EN: {};
+export declare const MCP_APP_MESSAGES_ZH: {};

package/dist/types/mcpAppHostContext.d.ts

@@ -2,6 +2,19 @@ import type { DaemonMcpAppToolCall, DaemonMcpAppToolResult } from '@qwen-code/sd
 export declare const McpAppHostContext: import("react").Context<string | undefined>;
 export type McpAppToolCallRequest = DaemonMcpAppToolCall;
 export declare const McpAppSessionContext: import("react").Context<string | undefined>;
+export interface McpAppMessageRequest {
+    serverName: string;
+    resourceUri: string;
+    text: string;
+    signal: AbortSignal;
+}
+export interface McpAppMessages {
+    sessionId: string;
+    requestMessage(request: McpAppMessageRequest): Promise<{
+        isError?: boolean;
+    }>;
+}
+export declare const McpAppMessagesContext: import("react").Context<McpAppMessages | undefined>;
 export declare const McpAppToolsContext: import("react").Context<{
     sessionId: string;
     callTool: (request: McpAppToolCallRequest, signal: AbortSignal) => Promise<DaemonMcpAppToolResult>;

package/dist/types/subagentDetailsContext.d.ts

@@ -1,7 +1,7 @@
 import type { DaemonBackgroundTurn } from '@qwen-code/sdk/daemon';
 import { type ReactNode } from 'react';
 import type { ACPToolCall } from './adapters/types';
-export type OpenSubagentDetails = (tool: ACPToolCall) => void;
+export type OpenSubagentDetails = (tool: ACPToolCall, parentSessionId?: string) => void;
 interface SubagentDetailsContextValue {
     onOpen: OpenSubagentDetails;
     onOpenBackground?: (turn: DaemonBackgroundTurn) => void;

package/dist/types/utils/promptAdmission.d.ts

@@ -1 +1,5 @@
+export declare class PromptDispatchCancelledError extends Error {
+    name: string;
+}
+export declare function isMcpAppPromptAdmissionRejected(error: unknown): boolean;
 export declare function isDefinitelyRejectedPromptAdmission(error: unknown): boolean;