@qwen-code/web-shell 0.26.3-preview.0 → 0.26.4

package/dist/types/App.d.ts

@@ -21,7 +21,7 @@ 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 WebShellCustomization, type WebShellAssistantFeedbackOptions, 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 WebShellAssistantTurnSettledEvent, type WebShellSessionArtifactsChange } from './customization';
+import { type WebShellCustomization, type WebShellWorkspaceDirectoryPicker, type WebShellAssistantFeedbackOptions, 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 WebShellAssistantTurnSettledEvent, type WebShellSessionArtifactsChange } from './customization';
 import type { CommandDisplayCategoryOrder } from './utils/commandDisplay';
 export interface BugReportInfo {
     title: string;
@@ -38,9 +38,9 @@ export interface WebShellSidebarOptions {
     showLive?: boolean;
     /** Hide or replace the complete sidebar branding row. */
     branding?: false | WebShellSidebarBranding;
-    /** Customize the primary navigation area (new task button, custom entries). */
+    /** Customize the primary navigation area (new session button, custom entries). */
     primaryNav?: WebShellSidebarPrimaryNavOptions;
-    /** Whether to hide the "Projects" header row (with search and add workspace). Defaults to false (shown). */
+    /** Whether to hide the "Workspaces" header row (with search and add workspace). Defaults to false (shown). */
     hideProjectHeader?: boolean;
     /** Customize which action buttons appear on session rows. */
     sessionActions?: WebShellSidebarSessionActionsOptions;
@@ -201,6 +201,8 @@ export interface WebShellProps {
     }>) => void;
     /** Open a workspace file in the embedding host instead of WebShell preview. */
     onWorkspaceFileOpen?: (path: string) => void;
+    /** Select a directory on the connected daemon. Overrides native picking without registering or trusting the path. */
+    onPickWorkspaceDirectory?: WebShellWorkspaceDirectoryPicker;
     /** 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. */
@@ -220,6 +222,8 @@ export interface WebShellProps {
     composerToolbarActions?: readonly ComposerToolbarAction[];
     /** Execution mode choices. Overrides ui.allowedApprovalModes; [] offers none. Presentation only. */
     allowedApprovalModes?: readonly WebShellApprovalMode[];
+    /** Composer presentation shared by the main chat, split panes, and side tasks. */
+    composerVariant?: 'default' | 'simple';
     /** Optionally filter main-model entries without changing shared defaults. */
     mainModelFilter?: (model: ModelDialogModel) => boolean;
     /** Stack completion details vertically for narrow embedded hosts. */
@@ -456,4 +460,4 @@ export declare function canArchiveSideTaskSummary(session: Pick<DaemonSessionSum
 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({ onRefreshModels, askUserFreeTextLabel, onSessionIdChange, onSessionInfoChange, onSessionCreated, managedAgentProvider, 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, assistantFeedback, getAssistantSourcesIcon, sourceReferences, renderComposerToolbarStart, renderComposerToolbarEnd, renderComposerToolbarRight, renderComposerHeader, renderComposerFooter, renderChatHeader, renderFooter, bottomStatusItems, chatMaxWidth, sidebar, settings: settingsPresentation, modelManagement, unavailableModels, mountUnavailableModelTooltip, header, rightPanel, showToolCalls, environmentPanel, splitSessionIds: externalSplitSessionIds, onSplitSessionIdsChange, renderPaneHeaderActions, onRightPanelOpen, onFileReviewOpen, onWorkspaceFileOpen, onInsightReportOpen, onContextUsageOpen, messageTurnOutputs, filterArtifact, shellRef, composerToolbarActions, allowedApprovalModes: allowedApprovalModesProp, mainModelFilter, compactComposerOverlays, autoSubmitSlashCommands, additionalSlashCommands, contextUsageAlwaysVisible, userMessageEditing, onUserMessageEditRequest, cycleModeOnTab, sessionSourceType, composerToolbarAdditionalActions, composerPlaceholders, compactThinking, hostOwnsEditDiffPreview, collapseCompletedTurns, markdownTableMode, virtualScrollThreshold, conversationSearchThreshold, markdown, loadingPhrases, onAgentTasksChange, onTranscriptChange, onSessionArtifactsChange, onToast, composerRef, onComposerReady, composerInput, composerInputVersion, onSessionChange, onAssistantTurnSettled, prepareSubmit, onSubmitBefore, restartSseOnPrompt, historyPageSize, initialSelectedWorkspaceCwd, lockedWorkspaceCwd, lockedWorkspaceCapability, }?: AppProps): import("react/jsx-runtime").JSX.Element;
+export declare function App({ onRefreshModels, askUserFreeTextLabel, onSessionIdChange, onSessionInfoChange, onSessionCreated, managedAgentProvider, 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, assistantFeedback, getAssistantSourcesIcon, sourceReferences, renderComposerToolbarStart, renderComposerToolbarEnd, renderComposerToolbarRight, renderComposerHeader, renderComposerFooter, renderChatHeader, renderFooter, bottomStatusItems, chatMaxWidth, sidebar, settings: settingsPresentation, modelManagement, unavailableModels, mountUnavailableModelTooltip, header, rightPanel, showToolCalls, environmentPanel, splitSessionIds: externalSplitSessionIds, onSplitSessionIdsChange, renderPaneHeaderActions, onRightPanelOpen, onFileReviewOpen, onWorkspaceFileOpen, onPickWorkspaceDirectory, onInsightReportOpen, onContextUsageOpen, messageTurnOutputs, filterArtifact, shellRef, composerToolbarActions, allowedApprovalModes: allowedApprovalModesProp, composerVariant, mainModelFilter, compactComposerOverlays, autoSubmitSlashCommands, additionalSlashCommands, contextUsageAlwaysVisible, userMessageEditing, onUserMessageEditRequest, cycleModeOnTab, sessionSourceType, composerToolbarAdditionalActions, composerPlaceholders, compactThinking, hostOwnsEditDiffPreview, collapseCompletedTurns, markdownTableMode, virtualScrollThreshold, conversationSearchThreshold, markdown, loadingPhrases, onAgentTasksChange, onTranscriptChange, onSessionArtifactsChange, onToast, composerRef, onComposerReady, composerInput, composerInputVersion, onSessionChange, onAssistantTurnSettled, prepareSubmit, onSubmitBefore, restartSseOnPrompt, historyPageSize, initialSelectedWorkspaceCwd, lockedWorkspaceCwd, lockedWorkspaceCapability, }?: AppProps): import("react/jsx-runtime").JSX.Element;

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

@@ -55,6 +55,13 @@ export interface DaemonMessageToolCall {
     endTime?: number;
     wasCancelled?: boolean;
     subContent?: string;
+    /**
+     * Path-style identity of the agent that produced this call's sub-content,
+     * e.g. `/root/general-purpose`. Carried from the transcript block's `agent`
+     * field so the panel can name a subagent precisely instead of by type alone
+     * — two parallel subagents of the same type are otherwise indistinguishable.
+     */
+    agentPath?: string;
     subTools?: DaemonMessageToolCall[];
     /** Transcript blocks folded into this tool presentation. */
     sourceBlockIds?: string[];

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

@@ -53,6 +53,8 @@ interface ChatEditorProps {
     currentModel?: string;
     modelControlsDisabled?: boolean;
     gitBranch?: string;
+    /** Service-owned Git control in the workspace row below the composer. */
+    gitContextControl?: ReactNode;
     /** Whether the session is in a worktree (styles the git chip purple). */
     gitWorktree?: boolean;
     /** Git working directory for worktree sessions; targets git operations. */

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

@@ -0,0 +1 @@
+export declare function DaemonConnectionBanner(): import("react/jsx-runtime").JSX.Element | null;

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

@@ -3,7 +3,8 @@
  * Copyright 2025 Qwen Team
  * SPDX-License-Identifier: Apache-2.0
  */
-import type { DaemonSessionGroupPresetColor, DaemonSessionPrInfo, DaemonSessionSummary, DaemonStatusReportSession } from '@qwen-code/sdk/daemon';
+import { type DaemonProductSessionContext } from '@qwen-code/web-shell/daemon-react-sdk';
+import { type DaemonSessionGroupPresetColor, type DaemonSessionPrInfo, type DaemonSessionSummary, type DaemonStatusReportSession } from '@qwen-code/sdk/daemon';
 export type SessionCardStatus = 'needsApproval' | 'askUserQuestion' | 'running' | 'idle';
 export interface SessionCard {
     sessionId: string;
@@ -17,6 +18,8 @@ export interface SessionCard {
     gitBranch?: string;
     /** The workspace the session lives in. */
     workspaceCwd: string;
+    /** Catalog the session came from; 'standalone' has no workspace of its own. */
+    sourceType?: string;
 }
 type SessionIdentity = Pick<SessionCard, 'sessionId' | 'workspaceCwd'>;
 /**
@@ -30,13 +33,13 @@ type SessionIdentity = Pick<SessionCard, 'sessionId' | 'workspaceCwd'>;
  * idle, then most-recent first, so sessions that want attention float to the
  * top of a 10+ session grid.
  */
-export declare function deriveSessionCards(sessions: DaemonSessionSummary[], currentSessionId: string | undefined, statusSessions?: DaemonStatusReportSession[], currentWorkspaceCwd?: string): SessionCard[];
+export declare function deriveSessionCards(sessions: DaemonSessionSummary[], currentSessionId: string | undefined, statusSessions?: DaemonStatusReportSession[], currentWorkspaceCwd?: string, currentContextKind?: string): SessionCard[];
 /**
  * A malformed daemon payload must not white-screen the shell; contain any
  * render throw to the panel, mirroring DaemonStatusDialog.
  */
 export declare function SessionOverviewPanel({ onOpenSession, onOpenSplit, onCurrentSessionRemoved, includeOtherWorkspaces, workspaceCwd, manageLiveState, }: {
-    onOpenSession: (sessionId: string, workspaceCwd?: string) => void;
+    onOpenSession: (sessionId: string, workspaceCwd?: string, sessionContext?: DaemonProductSessionContext) => void;
     onOpenSplit?: (sessionIds: string[]) => void;
     onCurrentSessionRemoved?: (session: SessionIdentity) => Promise<boolean | void> | boolean | void;
     includeOtherWorkspaces?: boolean;

package/dist/types/components/composer/AddMenu.d.ts

@@ -36,6 +36,7 @@ export interface AddMenuProps {
         onLiveVoice?: () => void;
     };
     commandsOnly?: boolean;
+    simpleMode?: boolean;
 }
 export interface AddMenuPlanControl {
     checked: boolean;
@@ -43,4 +44,4 @@ export interface AddMenuPlanControl {
     disabled?: boolean;
     onToggle: () => void;
 }
-export declare function AddMenu({ disabled, availabilityKey, addFileAvailable, uploadAvailable, onAddFiles, onFilePickerCancel, onInsertReference, onPrependSkill, getWorkspaceActions, skills, onSkillsOpenChange, skillsLoading, skillsLoadError, skillsLoaded, plan, btw, mobileActions, commandsOnly, }: AddMenuProps): import("react/jsx-runtime").JSX.Element;
+export declare function AddMenu({ disabled, availabilityKey, addFileAvailable, uploadAvailable, onAddFiles, onFilePickerCancel, onInsertReference, onPrependSkill, getWorkspaceActions, skills, onSkillsOpenChange, skillsLoading, skillsLoadError, skillsLoaded, plan, btw, mobileActions, commandsOnly, simpleMode, }: AddMenuProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/dialogs/AddWorkspaceDialog.d.ts

@@ -1,3 +1,4 @@
+import type { WebShellWorkspaceDirectoryPicker } from '../../customization';
 import { type WorkspaceExecutionMode } from '../workspaces/WorkspaceExecutionSelect';
 export interface WorkspacePathSuggestion {
     name: string;
@@ -37,7 +38,7 @@ export interface GitWorkspaceCloneControls {
     cancel(jobId: string): Promise<void>;
 }
 interface AddWorkspaceDialogProps {
-    /** Overrides the default "Add Workspace" heading. */
+    /** Overrides the default "Add workspace" heading. */
     title?: string;
     /** Overrides the default submit label; the in-flight label is unchanged. */
     submitLabel?: string;
@@ -59,7 +60,10 @@ interface AddWorkspaceDialogProps {
      * surfaces matching subdirectories in a listbox under the input.
      */
     onSuggest?: (prefix: string) => Promise<WorkspacePathSuggestions>;
-    onPick?: () => Promise<string | undefined>;
+    onPick?: WebShellWorkspaceDirectoryPicker;
+    /** Stable identity for the current connection/target; replace it to cancel a pick. */
+    pickerTarget?: unknown;
+    pickerUsesHostUi?: boolean;
     persistenceSupported?: boolean;
     /**
      * Git clone controls. Presence means the connected daemon advertises
@@ -67,5 +71,5 @@ interface AddWorkspaceDialogProps {
      */
     gitClone?: GitWorkspaceCloneControls;
 }
-export declare function AddWorkspaceDialog({ title, submitLabel, executionMode, onExecutionModeChange, executionModeLocked, browseDirectories, initialPath, pathHint, pathPlaceholder, onClose, onAdd, displayNameEnabled, locations, selectedLocation, onLocationChange, onSuggest, onPick, persistenceSupported, gitClone, }: AddWorkspaceDialogProps): import("react/jsx-runtime").JSX.Element;
+export declare function AddWorkspaceDialog({ title, submitLabel, executionMode, onExecutionModeChange, executionModeLocked, browseDirectories, initialPath, pathHint, pathPlaceholder, onClose, onAdd, displayNameEnabled, locations, selectedLocation, onLocationChange, onSuggest, onPick, pickerTarget, pickerUsesHostUi, persistenceSupported, gitClone, }: AddWorkspaceDialogProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/components/dialogs/DialogShell.d.ts

@@ -1,4 +1,4 @@
-import { type ReactNode } from 'react';
+import { type ReactNode, type RefObject } from 'react';
 type DialogSize = 'sm' | 'md' | 'lg' | 'xl' | 'auto';
 interface DialogShellProps {
     title: string;
@@ -6,10 +6,13 @@ interface DialogShellProps {
     size?: DialogSize;
     allowFullscreen?: boolean;
     dismissible?: boolean;
+    modal?: boolean;
+    modalRestoreFocusRef?: RefObject<HTMLElement | null>;
+    'aria-busy'?: boolean;
     onClose: () => void;
     children: ReactNode;
 }
 export declare const DialogShellIdContext: import("react").Context<object | null>;
 export declare function isTopDialogShellId(shellId: object | null): boolean;
-export declare function DialogShell({ title, subtitle, size, allowFullscreen, dismissible, onClose, children, }: DialogShellProps): import("react/jsx-runtime").JSX.Element;
+export declare function DialogShell({ title, subtitle, size, allowFullscreen, dismissible, modal, modalRestoreFocusRef, 'aria-busy': ariaBusy, onClose, children, }: DialogShellProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/components/local-control-api.d.ts

@@ -3,6 +3,7 @@
  * Copyright 2025 Qwen Team
  * SPDX-License-Identifier: Apache-2.0
  */
+import type { DaemonClient } from '@qwen-code/sdk/daemon';
 export interface LanCandidate {
     interfaceName: string;
     address: string;
@@ -29,4 +30,4 @@ export declare class LocalControlRequestError extends Error {
     readonly status?: number | undefined;
     constructor(message: string, payload?: LocalControlStatus | undefined, status?: number | undefined);
 }
-export declare function requestLocalControl(baseUrl: string, token: string | undefined, method: 'GET' | 'POST', path: string, body?: object): Promise<LocalControlStatus>;
+export declare function requestLocalControl(baseUrl: string, token: string | undefined, method: 'GET' | 'POST', path: string, body?: object, client?: DaemonClient): Promise<LocalControlStatus>;

package/dist/types/components/managed/ManagedSessionWorktrees.d.ts

@@ -0,0 +1,12 @@
+import type { ManagedAgentProvider, ManagedSessionWorktree } from './managed-agent-provider';
+export declare function ManagedWorktreeStatus({ worktree, compact, }: {
+    worktree: ManagedSessionWorktree;
+    compact?: boolean;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function ManagedSessionWorktrees({ provider, clientId, workspaceId, open, onOpenChange, }: {
+    provider: Pick<ManagedAgentProvider, 'storageKey' | 'sessionWorktrees'>;
+    clientId: string;
+    workspaceId: string;
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/managed/ManagedWorktreePopover.d.ts

@@ -0,0 +1,9 @@
+export declare function ManagedWorktreePopover({ worktree, currentBranch, open, onOpenChange, disabled, onWorktreeChange, onManage, }: {
+    worktree: boolean;
+    currentBranch?: string | null;
+    open: boolean;
+    onOpenChange: (value: boolean) => void;
+    disabled: boolean;
+    onWorktreeChange: (value: boolean) => void;
+    onManage: () => void;
+}): import("react/jsx-runtime").JSX.Element;

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

@@ -1057,6 +1057,74 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/agent/web-shell/v1/workspaces/worktrees/options": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Options a main Session worktree */
+        post: operations["webShellSessionWorktreeOptions"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/agent/web-shell/v1/workspaces/worktrees/query": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Query a main Session worktree */
+        post: operations["webShellSessionWorktreeQuery"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/agent/web-shell/v1/workspaces/worktrees/inspect": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Inspect a main Session worktree */
+        post: operations["webShellSessionWorktreeInspect"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/agent/web-shell/v1/workspaces/worktrees/cleanup": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Cleanup a main Session worktree */
+        post: operations["webShellSessionWorktreeCleanup"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 export type webhooks = Record<string, never>;
 export interface components {
@@ -1188,6 +1256,10 @@ export interface components {
             skills?: components["schemas"]["SessionCreationSkill"][];
             /** @description Optional immutable initial extension selection. Omission keeps the legacy configuration path; an explicit empty array starts the unified configuration format. Included in creation idempotency and applied before the first model request. Requires session-extension-packages/1 and an extension-capable original Runtime. */
             extensionPins?: components["schemas"]["ManagedExtensionPackagePin"][];
+            /** @description Opt into a main Session worktree on supported LOCAL storage. Omission uses the current directory; an empty object freezes HEAD at first admission. Requires an explicit Workspace. Preparation is durable and gates Runtime execution; replay preserves the original commit, directory and branch. */
+            worktree?: {
+                baseRef?: string;
+            };
         };
         WebShellSubmitRequest: {
             /** @description Trace correlation only. */
@@ -1290,6 +1362,7 @@ export interface components {
             /** @description Current unsettled lifecycle operation, queried in batch under Session read authorization. A failed close/delete may leave the Session closing/deleting; only explicit retry starts a new operation. Settled Sessions omit this projection. */
             lifecycleOperation?: components["schemas"]["WebShellLifecycleOperation"];
             recovery?: components["schemas"]["SessionRecovery"];
+            worktree?: components["schemas"]["WebShellSessionWorktree"] | null;
         };
         WebShellSessionCapabilities: {
             /**
@@ -2096,18 +2169,22 @@ export interface components {
             skills: components["schemas"]["WebShellSkill"][];
         };
         WebShellWorkspaceFileQueryRequest: {
-            workspaceId: string;
-            cwdRelative: string;
+            workspaceId?: string;
+            cwdRelative?: string;
             directory: string;
             query?: string;
             expectedScopeRevision?: string;
-        };
+            /** Format: uuid */
+            sessionId?: string;
+        } & (unknown | unknown);
         WebShellWorkspaceFileReadRequest: {
-            workspaceId: string;
-            cwdRelative: string;
+            workspaceId?: string;
+            cwdRelative?: string;
             path: string;
             expectedScopeRevision: string;
-        };
+            /** Format: uuid */
+            sessionId?: string;
+        } & (unknown | unknown);
         WebShellWorkspaceFileEntry: {
             path: string;
             name: string;
@@ -2522,6 +2599,52 @@ export interface components {
             /** Format: uuid */
             uploadId: string;
         };
+        WebShellSessionWorktree: {
+            id: string;
+            sessionId: string;
+            workspaceId: string;
+            branch: string;
+            baseCommit: string;
+            cwdRelative: string;
+            operationId: string;
+            /** @enum {string} */
+            state: "preparing" | "ready" | "failed" | "blocked" | "removing" | "removed";
+            revision: number;
+            errorCode?: string | null;
+        };
+        WebShellSessionWorktreeOptions: {
+            supported: boolean;
+            reason?: string | null;
+            baseCommit?: string | null;
+            /** @description Source checkout branch independent of base ref; HEAD when detached, null when unavailable. */
+            currentBranch?: string | null;
+            branches: string[];
+        };
+        WebShellSessionWorktreePage: {
+            data: components["schemas"]["WebShellSessionWorktree"][];
+        };
+        WebShellSessionWorktreeInspection: {
+            worktree: components["schemas"]["WebShellSessionWorktree"];
+            canCleanup: boolean;
+            cleanupBlocker?: string | null;
+        };
+        WebShellSessionWorktreeOptionsRequest: {
+            workspaceId: string;
+            cwdRelative: string;
+            baseRef?: string;
+        };
+        WebShellSessionWorktreeQueryRequest: {
+            workspaceId: string;
+        };
+        WebShellSessionWorktreeInspectRequest: {
+            workspaceId: string;
+            worktreeId: string;
+        };
+        WebShellSessionWorktreeCleanupRequest: {
+            workspaceId: string;
+            worktreeId: string;
+            idempotencyKey: string;
+        };
     };
     responses: {
         /** @description The authenticated actor belongs to another tenant than X-Qwen-Tenant-Id or has an invalid ID (actor_scope_mismatch, which the tenant filter answers on every /v1/agents/ and WebShell route), or the resource is readable but the actor lacks this operation or the original Action responder permission. Artifact content reads may also return artifact_content_forbidden when the actor cannot read the original bytes. */
@@ -4643,11 +4766,13 @@ export interface operations {
     webShellWorkspaceFilesUpload: {
         parameters: {
             query: {
-                workspaceId: string;
-                cwdRelative: string;
+                workspaceId?: string;
+                cwdRelative?: string;
                 path: string;
                 expectedScopeRevision: string;
                 uploadId: string;
+                /** @description Exactly one locator: Session ID, or Workspace ID plus cwdRelative. */
+                sessionId?: string;
             };
             header?: never;
             path?: never;
@@ -4724,4 +4849,120 @@ export interface operations {
             503: components["responses"]["Unavailable"];
         };
     };
+    webShellSessionWorktreeOptions: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["WebShellSessionWorktreeOptionsRequest"];
+            };
+        };
+        responses: {
+            /** @description Session worktree result. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WebShellSessionWorktreeOptions"];
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+        };
+    };
+    webShellSessionWorktreeQuery: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["WebShellSessionWorktreeQueryRequest"];
+            };
+        };
+        responses: {
+            /** @description Session worktree result. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WebShellSessionWorktreePage"];
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+        };
+    };
+    webShellSessionWorktreeInspect: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["WebShellSessionWorktreeInspectRequest"];
+            };
+        };
+        responses: {
+            /** @description Session worktree result. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WebShellSessionWorktreeInspection"];
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+        };
+    };
+    webShellSessionWorktreeCleanup: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["WebShellSessionWorktreeCleanupRequest"];
+            };
+        };
+        responses: {
+            /** @description Session worktree result. */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WebShellSessionWorktree"];
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+        };
+    };
 }

package/dist/types/components/managed/java-managed-agent-client.d.ts

@@ -1,5 +1,6 @@
 import type { ManagedExtensionManifest, ManagedExtensionPin, ManagedExtensionPackageOperation, ManagedExtensionSelection } from './managed-extension-types';
 import type { components } from './generated/managed-agent-api';
+import type { ManagedWorkspaceFileQueryRequest, ManagedWorkspaceFileReadRequest, ManagedWorkspaceFileUploadRequest } from './managed-agent-provider';
 import type { ManagedArtifact } from './managed-tool-result-types';
 type Schemas = components['schemas'];
 export type JavaAgentTurn = Schemas['WebShellTurn'];
@@ -98,15 +99,9 @@ export declare class JavaManagedAgentClient {
         replayed: boolean;
     }>;
     createWorkspace(request: Schemas['WebShellWorkspaceCreateRequest'], signal?: AbortSignal): Promise<JavaAgentWorkspace>;
-    queryWorkspaceFiles(request: Schemas['WebShellWorkspaceFileQueryRequest'], signal?: AbortSignal): Promise<Schemas['WebShellWorkspaceFilePage']>;
-    readWorkspaceFile(request: Schemas['WebShellWorkspaceFileReadRequest'], signal?: AbortSignal): Promise<Schemas['WebShellWorkspaceFileSnapshot']>;
-    uploadWorkspaceFile(request: {
-        workspaceId: string;
-        cwdRelative: string;
-        path: string;
-        expectedScopeRevision: string;
-        uploadId: string;
-    }, data: Blob, signal?: AbortSignal): Promise<Schemas['WebShellWorkspaceFileUploadResult']>;
+    queryWorkspaceFiles(request: ManagedWorkspaceFileQueryRequest, signal?: AbortSignal): Promise<Schemas['WebShellWorkspaceFilePage']>;
+    readWorkspaceFile(request: ManagedWorkspaceFileReadRequest, signal?: AbortSignal): Promise<Schemas['WebShellWorkspaceFileSnapshot']>;
+    uploadWorkspaceFile(request: ManagedWorkspaceFileUploadRequest, data: Blob, signal?: AbortSignal): Promise<Schemas['WebShellWorkspaceFileUploadResult']>;
     queryWorkspaceFileUpload(uploadId: string, signal?: AbortSignal): Promise<Schemas['WebShellWorkspaceFileUploadStatus']>;
     workspaceDirectories(request: Schemas['WebShellWorkspaceDirectoryQueryRequest'], signal?: AbortSignal): Promise<Schemas['WebShellWorkspaceDirectoryPage']>;
     getSessionApproval(sessionId: string, signal?: AbortSignal): Promise<Schemas['WebShellSessionApproval']>;
@@ -134,6 +129,10 @@ export declare class JavaManagedAgentClient {
     }>;
     getTranscript(request: Schemas['WebShellTranscriptRequest'], signal?: AbortSignal): Promise<JavaAgentTranscript>;
     createSession(request: Schemas['WebShellCreateRequest'], signal?: AbortSignal): Promise<JavaAgentCommandAdmission>;
+    worktreeOptions(request: Schemas['WebShellSessionWorktreeOptionsRequest'], signal?: AbortSignal): Promise<Schemas['WebShellSessionWorktreeOptions']>;
+    listSessionWorktrees(workspaceId: string, signal?: AbortSignal): Promise<Schemas['WebShellSessionWorktreePage']>;
+    inspectSessionWorktree(workspaceId: string, worktreeId: string, signal?: AbortSignal): Promise<Schemas['WebShellSessionWorktreeInspection']>;
+    cleanupSessionWorktree(request: Schemas['WebShellSessionWorktreeCleanupRequest'], signal?: AbortSignal): Promise<Schemas['WebShellSessionWorktree']>;
     submitTurn(request: Schemas['WebShellSubmitRequest'], signal?: AbortSignal): Promise<JavaAgentTurnAdmission>;
     cancelTurn(request: Schemas['WebShellCancelRequest'], signal?: AbortSignal): Promise<JavaAgentTurnAdmission>;
     queryActions(request: Schemas['WebShellActionQueryRequest'], signal?: AbortSignal): Promise<JavaAgentActionPage>;