@qwen-code/web-shell 0.25.0 → 0.25.1-nightly.20261011.01d3e6d81a

package/dist/types/components/managed/managed-agent-provider.d.ts

@@ -1,3 +1,4 @@
+import type { components } from './generated/managed-agent-api';
 import type { ManagedToolResultReader } from './managed-tool-result-types';
 export type ManagedAgentSessionPhase = 'created' | 'admitted' | 'runtime_starting' | 'agent_running' | 'waiting_runtime' | 'tool_running' | 'cancelling' | 'completed' | 'failed' | 'cancelled';
 export type ManagedAgentRuntimeState = 'unknown' | 'starting' | 'ready' | 'failed';
@@ -9,6 +10,8 @@ export interface ManagedAgentSessionSummary {
     workspace?: {
         workspaceId: string;
         cwdRelative: string;
+        contextRevision?: number;
+        state?: 'ready' | 'changing' | 'recovery_blocked';
     };
     createdAt: number;
     admittedAt: number;
@@ -23,13 +26,14 @@ export interface ManagedAgentSessionSummary {
         artifacts?: boolean;
         /** The caller may submit later Turns to this Workspace-bound Session. */
         workspaceTurns?: boolean;
+        cwdChange?: boolean;
     };
     failure?: {
         code: string;
         message: string;
     };
 }
-export type ManagedAgentSessionEventType = 'accepted' | 'runtime_starting' | 'runtime_ready' | 'runtime_failed' | 'runtime_released' | 'agent_started' | 'assistant_thought' | 'assistant_delta' | 'tool_requested' | 'tool_started' | 'tool_completed' | 'tool_result_updated' | 'completed' | 'failed' | 'cancelling' | 'cancelled' | 'action_updated' | 'stream_gap';
+export type ManagedAgentSessionEventType = 'accepted' | 'runtime_starting' | 'runtime_ready' | 'runtime_failed' | 'runtime_released' | 'agent_started' | 'assistant_thought' | 'assistant_delta' | 'tool_requested' | 'tool_started' | 'tool_completed' | 'tool_result_updated' | 'completed' | 'failed' | 'cancelling' | 'cancelled' | 'action_updated' | 'context_changed' | 'stream_gap';
 export interface ManagedAgentSessionEvent {
     id: number;
     at: number;
@@ -60,6 +64,7 @@ export interface ManagedAgentRequestOptions {
 export interface ManagedAgentCommandOptions extends ManagedAgentRequestOptions {
     idempotencyKey: string;
 }
+export type ManagedCwdOperation = components['schemas']['WebShellCwdOperation'];
 /** A Hosted tool approval waiting for the Session owner's answer. */
 export interface ManagedAgentPendingAction {
     actionId: string;
@@ -75,6 +80,7 @@ export interface ManagedAgentPendingAction {
         id: string;
         label: string;
     }>;
+    inputPreview?: components['schemas']['WebShellActionInputPreview'];
 }
 export interface ManagedAgentProvider {
     readonly kind: 'daemon' | 'java';
@@ -87,6 +93,13 @@ export interface ManagedAgentProvider {
         respond(action: ManagedAgentPendingAction, optionId: string, options: ManagedAgentCommandOptions): Promise<void>;
     };
     readonly toolResults?: ManagedToolResultReader;
+    readonly cwdChange?: {
+        submit(sessionId: string, request: {
+            cwdRelative: string;
+            expectedContextRevision: number;
+        }, options: ManagedAgentCommandOptions): Promise<ManagedCwdOperation>;
+        query(sessionId: string, operationId: string, options: ManagedAgentRequestOptions): Promise<ManagedCwdOperation>;
+    };
     readonly workspaceBinding?: {
         readonly agentId: string;
         list(options: ManagedAgentRequestOptions & {
@@ -130,6 +143,19 @@ export interface ManagedAgentProvider {
     cancel(sessionId: string, turnId: string, options: ManagedAgentCommandOptions): Promise<void>;
     subscribeEvents(sessionId: string, options: ManagedAgentRequestOptions & {
         lastEventId?: number;
+        /**
+         * Called once the stream connection has been (re-)established. An
+         * established stream can stay silent indefinitely — heartbeats are
+         * not events — so this is the only liveness signal that does not
+         * depend on stream activity.
+         */
+        onEstablished?(): void;
+        /**
+         * Called for each complete heartbeat or comment frame the stream
+         * delivers. Heartbeats never decode into events, so on an idle
+         * Session this is the only sign of life an established stream gives.
+         */
+        onAlive?(): void;
     }): AsyncIterable<ManagedAgentSessionEvent>;
 }
 export interface ManagedAgentWorkspace {

package/dist/types/components/managed/managed-request-error.d.ts

@@ -12,3 +12,9 @@
  * are worth another attempt.
  */
 export declare function isNonRetryableClientError(error: unknown): boolean;
+/**
+ * A 401/403. This client re-derives its credentials on every request, so an
+ * expired short-lived token gets a fresh answer on the very next attempt
+ * once the host refreshes — never a terminal condition.
+ */
+export declare function isAuthFailure(error: unknown): boolean;

package/dist/types/components/managed/use-managed-actions.d.ts

@@ -12,11 +12,12 @@ export interface ManagedActionsState {
     /** Sending an answer failed; the approval is shown again. */
     answerError?: unknown;
     /**
-     * The service refused an answer as creator-only. That is a fact about the
-     * viewer and the Session, not about one Action, so it outlives the refused
-     * Action, covers every later approval the same Session raises, and survives
-     * leaving that Session and coming back. It is remembered per mount: a reload
-     * or reopening the panel starts clean.
+     * The service refused an answer under the owner-or-Workspace-operator
+     * rule. That refusal is a fact about the viewer's Workspace role row,
+     * which an operator can raise while the page stays open, so the latch
+     * covers every later approval the same Session raises and survives
+     * leaving that Session and coming back — but `retry()` drops it and
+     * re-probes instead of treating one 403 as permanent for the mount.
      */
     respondForbidden: boolean;
     respond(actionId: string, optionId: string): Promise<void>;

package/dist/types/components/managed/use-managed-cwd-change.d.ts

@@ -0,0 +1,21 @@
+import type { ManagedAgentProvider, ManagedAgentSessionSummary } from './managed-agent-provider';
+interface CwdIntent {
+    sessionId: string;
+    workspaceId: string;
+    cwdRelative: string;
+    expectedContextRevision: number;
+    idempotencyKey: string;
+    operationId?: string;
+}
+export declare function useManagedCwdChange(provider: ManagedAgentProvider, clientId: string, sessionId: string | undefined, summary: ManagedAgentSessionSummary | undefined, refreshSummary: (signal?: AbortSignal) => Promise<ManagedAgentSessionSummary | undefined>): {
+    blocked: boolean;
+    submit: (cwdRelative: string, expectedContextRevision: number) => Promise<true | undefined>;
+    confirm: () => Promise<void>;
+    isBlocked: () => boolean;
+    key: string;
+    pending?: CwdIntent;
+    busy: boolean;
+    errorCode?: string;
+    target?: string;
+};
+export {};

package/dist/types/components/managed/use-managed-session.d.ts

@@ -1,12 +1,26 @@
 import type { ManagedAgentProvider, ManagedAgentSessionEvent, ManagedAgentSessionSummary } from './managed-agent-provider';
+type SignalLeg = 'session' | 'transcript' | 'stream';
+interface SignalEntry {
+    readonly message: string;
+    readonly final: boolean;
+    readonly seq: number;
+    readonly leg: SignalLeg;
+    readonly stall?: boolean;
+}
+export declare function failureRetryDelayMs(failures: number): number;
 export declare function useManagedSession(provider: ManagedAgentProvider, clientId: string, sessionId: string | undefined): {
+    stoppedReason: string | undefined;
+    stoppedLeg: SignalLeg | undefined;
+    error: string | undefined;
     loadingOlder: boolean;
     loadOlder: () => Promise<void>;
     reload: () => void;
+    refreshSummary: (signal?: AbortSignal) => Promise<ManagedAgentSessionSummary | undefined>;
     sessionId?: string;
     summary?: ManagedAgentSessionSummary;
     events: ManagedAgentSessionEvent[];
     olderCursor?: string;
     loading: boolean;
-    error?: string;
+    signals?: Partial<Record<SignalLeg, SignalEntry>>;
 };
+export {};

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

@@ -1,9 +1,11 @@
 import { type WebShellAssistantFeedbackRating, type WebShellAssistantTurnFooterRenderInfo, type WebShellSource } from '../../customization';
-import type { DaemonSessionGenerationEvent } from '@qwen-code/sdk/daemon';
+import type { DaemonSessionGenerationEvent, QwenAgentMessageMeta } from '@qwen-code/sdk/daemon';
 import type { DaemonMessageAuthor } from '../../adapters/messageTypes';
 interface AssistantMessageProps {
     content: string;
     author?: DaemonMessageAuthor;
+    /** A workspace agent's reply: its run status, error, steps and tokens. */
+    agentMessage?: QwenAgentMessageMeta;
     isStreaming?: boolean;
     timestamp?: number;
     onBranchSession?: () => void | Promise<void>;

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

@@ -1,6 +1,6 @@
 import type { DaemonInputAnnotation } from '@qwen-code/sdk/daemon';
 import type { ComposerTagClickHandler, ComposerTagRenderer, WebShellComposerTag, WebShellComposerTagIconMap } from '../../customization';
-import type { AttachmentPreviewRequest } from '../../adapters/messageTypes';
+import type { AttachmentPreviewRequest, DaemonMessageAuthor } from '../../adapters/messageTypes';
 import type { ImageTabSource } from '../artifacts/ArtifactPanel';
 interface UserMessageImage {
     data: string;
@@ -32,6 +32,8 @@ interface UserMessageProps {
     /** Click an uploaded image to preview it in the right panel. */
     onImagePreview?: (src: string, alt?: string, source?: ImageTabSource) => void;
     onAttachmentPreview?: (file: AttachmentPreviewRequest) => void;
+    /** Set when a workspace agent, not the user, posted this message. */
+    author?: DaemonMessageAuthor;
 }
 export declare const UserMessage: import("react").NamedExoticComponent<UserMessageProps>;
 export declare function ReadonlyComposerTag({ tag, composerTagIcons, renderComposerTag, renderComposerTagTooltip, onComposerTagClick, title, preserveCustomKindLabel, }: {

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

@@ -0,0 +1,36 @@
+/**
+ * @license
+ * Copyright 2026 Qwen Team
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { QwenAgentMessageMeta, SessionAgentStep } from '@qwen-code/sdk/daemon';
+/** True when an agent's text shows nothing: render it as no text at all. */
+export declare function isBlankAgentText(text: string): boolean;
+/**
+ * One line per tool call an agent made, like a CI job's step list. Shared by
+ * the live run card and the finished reply, so a run reads the same before
+ * and after its record lands.
+ *
+ * Renders in exported transcripts: only `agentMessage.*` strings (i18n.tsx),
+ * never the collaboration dictionary.
+ */
+export declare function AgentStepList({ steps, label, settled, }: {
+    steps: readonly SessionAgentStep[];
+    label?: string;
+    /**
+     * The run has ended (completed, failed, stopped, offline). A step still
+     * marked running then never finished; show it as stopped, not spinning.
+     */
+    settled?: boolean;
+}): import("react/jsx-runtime").JSX.Element | null;
+/** "1,234 tokens", or nothing when the run reported no usage. */
+export declare function AgentTokenUsage({ totalTokens }: {
+    totalTokens?: number;
+}): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * Status, error, steps and token usage of a finished agent reply. A completed
+ * run shows no status word: its text is the result.
+ */
+export declare function AgentMessageDetails({ meta }: {
+    meta: QwenAgentMessageMeta;
+}): import("react/jsx-runtime").JSX.Element | null;

package/dist/types/components/messages/squad-tag.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2026 Qwen Team
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * "This belongs to squad X": a small muted pill, the squad's counterpart to
+ * AuthorAvatar. Used on a leader's and a member's author line, the leader's
+ * no-action line and the live engagement bar, so a reader learns it once.
+ *
+ * Renders in exported transcripts: no collaboration strings here.
+ */
+export declare function SquadTag({ name, className, }: {
+    name: string;
+    className?: string;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/sidebar/WebShellSidebar.d.ts

@@ -58,8 +58,6 @@ export interface WebShellSidebarWorkspaceOverviewOptions {
 }
 export type { WorkspaceManagementTarget, WorkspaceOverviewItem };
 interface WebShellSidebarProps {
-    selectedCollaborationId?: string;
-    onOpenCollaboration?: (id: string, cwd: string) => void;
     collapsed: boolean;
     layout?: 'single' | 'rail';
     activePage?: string;
@@ -67,7 +65,7 @@ interface WebShellSidebarProps {
     onOpenHome?: () => void;
     onCollapsedChange: (collapsed: boolean) => void;
     onOpenSettings: () => void;
-    onOpenAgents?: (view?: 'agents' | 'tasks' | 'runtime') => void;
+    onOpenAgents?: (view?: 'agents' | 'squads' | 'runtime') => void;
     onOpenPlugins: () => void;
     onOpenChannels: () => void;
     onOpenLive?: () => void;
@@ -91,6 +89,12 @@ interface WebShellSidebarProps {
     onNewSession: (workspaceCwd?: string) => Promise<boolean> | boolean;
     onNewStandaloneSession?: () => Promise<boolean> | boolean;
     onLoadSession: (sessionId: string, workspaceCwd?: string) => Promise<void> | void;
+    /**
+     * Opens a session listed by a fan-out host group (#13727): the caller
+     * focuses that host in-app and loads the session there. When absent, the
+     * groups fall back to full navigation via `openHostedWorkspace`.
+     */
+    onOpenHostSession?: (origin: string, sessionId: string, workspaceCwd?: string) => void;
     onSelectCurrentSession?: () => void;
     onSessionRenameConfirmed?: (workspaceCwd: string | undefined, sessionId: string, displayName: string) => void;
     /**
@@ -158,4 +162,4 @@ interface WebShellSidebarProps {
     onLoadStandaloneSession?: (sessionId: string) => Promise<void> | void;
     onStandaloneNotice?: (message: string) => void;
 }
-export declare function WebShellSidebar({ selectedCollaborationId, onOpenCollaboration, collapsed, layout, activePage, containerWidth, onOpenHome, onCollapsedChange, onOpenSettings, onOpenAgents, onOpenPlugins, onOpenChannels, onOpenLive, onLiveVoiceSlotChange, onOpenManagedSessions, onOpenDaemonStatus, onOpenScheduledTasks, onOpenWorkflows, onOpenGoals, onOpenSessions, canOpenSessionsOverview, onOpenWorkspacesOverview, onOpenSplitView, canOpenSplitView, onNewSession, onNewStandaloneSession, onLoadSession, onSelectCurrentSession, onSessionRenameConfirmed, onSessionsDeleted, onError, theme, onThemeChange, mobileOpen, onMobileClose, selectedWorkspaceCwd, onSelectWorkspace, onOpenGitDiff, onOpenCommit, onOpenAddWorkspace, workspaces: providedWorkspaces, lockedWorkspaceCwd, lockedWorkspace: lockedWorkspaceOptions, branding, primaryNav: primaryNavOptions, showSessionSourceSwitch, showLive, hideProjectHeader, sessionActions: sessionActionsOptions, footer, workspaceOverview, onOpenWorkspaceManagement, onNewWorktreeSession, projectFeaturesEnabled, onLoadStandaloneSession, onStandaloneNotice, }: WebShellSidebarProps): import("react/jsx-runtime").JSX.Element;
+export declare function WebShellSidebar({ collapsed, layout, activePage, containerWidth, onOpenHome, onCollapsedChange, onOpenSettings, onOpenAgents, onOpenPlugins, onOpenChannels, onOpenLive, onLiveVoiceSlotChange, onOpenManagedSessions, onOpenDaemonStatus, onOpenScheduledTasks, onOpenWorkflows, onOpenGoals, onOpenSessions, canOpenSessionsOverview, onOpenWorkspacesOverview, onOpenSplitView, canOpenSplitView, onNewSession, onNewStandaloneSession, onLoadSession, onOpenHostSession, onSelectCurrentSession, onSessionRenameConfirmed, onSessionsDeleted, onError, theme, onThemeChange, mobileOpen, onMobileClose, selectedWorkspaceCwd, onSelectWorkspace, onOpenGitDiff, onOpenCommit, onOpenAddWorkspace, workspaces: providedWorkspaces, lockedWorkspaceCwd, lockedWorkspace: lockedWorkspaceOptions, branding, primaryNav: primaryNavOptions, showSessionSourceSwitch, showLive, hideProjectHeader, sessionActions: sessionActionsOptions, footer, workspaceOverview, onOpenWorkspaceManagement, onNewWorktreeSession, projectFeaturesEnabled, onLoadStandaloneSession, onStandaloneNotice, }: WebShellSidebarProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/sidebar/WorkspaceSection.d.ts

@@ -9,8 +9,15 @@ export interface WorkspaceHeaderActionsContext {
     gitBranch: string | null | undefined;
 }
 interface WorkspaceSectionProps {
-    additionalSessions?: readonly DaemonSessionSummary[];
     workspace: DaemonWorkspaceCapability;
+    /**
+     * localStorage seed for the expansion/collapsed-group preferences,
+     * defaulting to the workspace id. Multi-host renderers pass an
+     * origin-prefixed id so two daemons hosting the same workspace id
+     * never share a preference; single-host callers leave it unset and
+     * keep the keys they always had.
+     */
+    storageKey?: string;
     remote?: boolean;
     renderHeader?: (expanded: boolean) => ReactNode;
     hideHeader?: boolean;
@@ -118,5 +125,5 @@ interface WorkspaceSectionProps {
     /** Commit entry for the same picker; the row still opens without it. */
     onOpenCommit?: (workspaceCwd: string) => void;
 }
-export declare function WorkspaceSection({ additionalSessions, workspace, remote, renderHeader, hideHeader, client, reloadToken, untrustedLabel, readOnlyLabel, trustToOpenLabel, noSessionsLabel, loadErrorLabel, organizationEnabled, sessionCatalogRequestsEnabled, sessionGroupCatalog, sessionLiveStateEnabled, sourceType, channelGroupingEnabled, ungroupedLabel, searchQuery, expanded: controlledExpanded, autoExpandKey, forceAutoExpand, onExpandedChange, renderSessions, renderSession, pendingSession, mapSession, showSessionDetails, headerActions, overviewEnabled, overviewMenuOpen, overviewItems, gitBranchWanted, sessionStats, onRenameGroup, onDeleteGroup, renameGroupLabel, deleteGroupLabel, groupActionsDisabled, excludePinned, limitSessions, isPinnedSectionMember, onOpenPathLocally, onOpenTerminalLocally, onOpenGitDiff, onOpenCommit, }: WorkspaceSectionProps): import("react/jsx-runtime").JSX.Element;
+export declare function WorkspaceSection({ workspace, storageKey, remote, renderHeader, hideHeader, client, reloadToken, untrustedLabel, readOnlyLabel, trustToOpenLabel, noSessionsLabel, loadErrorLabel, organizationEnabled, sessionCatalogRequestsEnabled, sessionGroupCatalog, sessionLiveStateEnabled, sourceType, channelGroupingEnabled, ungroupedLabel, searchQuery, expanded: controlledExpanded, autoExpandKey, forceAutoExpand, onExpandedChange, renderSessions, renderSession, pendingSession, mapSession, showSessionDetails, headerActions, overviewEnabled, overviewMenuOpen, overviewItems, gitBranchWanted, sessionStats, onRenameGroup, onDeleteGroup, renameGroupLabel, deleteGroupLabel, groupActionsDisabled, excludePinned, limitSessions, isPinnedSectionMember, onOpenPathLocally, onOpenTerminalLocally, onOpenGitDiff, onOpenCommit, }: WorkspaceSectionProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/components/workspace-agents/ThreadsPage.d.ts

@@ -3,9 +3,10 @@
  * Copyright 2026 Qwen Team
  * SPDX-License-Identifier: Apache-2.0
  */
-import { type JoinToken } from './add-runtime-dialog';
+import { type ConnectExistingInput, type JoinCoordinatorInput, type JoinToken } from './add-runtime-dialog';
 import { type AgentShare, type AgentShareSummary } from './share-agent-dialog';
-import { type AgentProgramView, type RoutingPreviewTarget, type ThreadSummaryView } from './agents-view-logic';
+import { type AgentProgramView } from './agents-view-logic';
+import { type SquadsSectionProps } from './squads-section';
 /**
  * A change to one agent's configuration. Absent leaves a field alone; `null`
  * clears the override and returns the agent to what its definition says.
@@ -19,41 +20,34 @@ export interface AgentConfigPatch {
     maxConcurrentRuns?: number | null;
     execution?: {
         mode: 'local';
+        /** Program on this computer; Qwen Code when absent. */
+        provider?: AgentProgramView;
     } | {
         mode: 'managed-host';
         hostIds: string[];
         provider?: AgentProgramView;
     };
 }
-/** What every agent in this workspace may do. A property of the subsystem. */
-export interface AgentCapabilitiesView {
-    readOnly: boolean;
-    allowed: readonly string[];
-    threadTools: readonly string[];
-}
 export interface ThreadsPageProps {
-    onConnectRemoteHost?: (input: {
-        remoteUrl: string;
-        remoteToken: string;
-        remoteCwd: string;
-        serverUrl: string;
-        provider: 'qwen';
-        allowHttp: boolean;
-    }) => Promise<boolean>;
-    createError?: string;
+    onConnectRemoteHost?: (input: ConnectExistingInput) => Promise<boolean>;
+    /** Joins this daemon to another coordinator as one of its runtimes. */
+    onJoinCoordinator?: (input: JoinCoordinatorInput) => Promise<boolean>;
     agents: readonly WorkspaceAgentSummaryView[];
-    threads: readonly ThreadSummaryView[];
     runtimes?: readonly WorkspaceAgentRuntimeView[];
     view: AgentWorkspaceView;
     onViewChange: (view: AgentWorkspaceView) => void;
-    onOpenThread: (threadId: string) => void;
+    /**
+     * Puts `@name ` into the chat composer. Absent hides the agent card's
+     * mention button.
+     */
+    onMentionAgent?: (name: string) => void;
     onDeleteAgent: (agentId: string) => void;
     onSetAgentEnabled: (agentId: string, enabled: boolean) => void;
     onUpdateAgent?: (agentId: string, patch: AgentConfigPatch) => void;
     onOpenAgentBuilder?: (hostId?: string) => void;
     onOpenDefinitions?: () => void;
     /** Issues a single-use join token for the Add runtime dialog. */
-    onCreateJoinToken?: () => Promise<JoinToken>;
+    onCreateJoinToken?: (supersedesHostId?: string) => Promise<JoinToken>;
     onRemoveRuntime?: (hostId: string) => void;
     hostServerUrl?: string;
     /** A2A shares of one agent; absent hides Share. */
@@ -62,15 +56,11 @@ export interface ThreadsPageProps {
         list: (agentId: string) => Promise<AgentShareSummary[]>;
         revoke: (agentId: string, callerId: string) => Promise<unknown>;
     };
-    capabilities?: AgentCapabilitiesView;
-    onCreateThread: (input: NewThread) => Promise<boolean> | void;
-    workspaceCwd?: string;
-    workspaces?: readonly {
-        cwd: string;
-    }[];
-    onWorkspaceChange?: (cwd: string) => void;
-    onPreviewThread?: (assignee?: string) => void;
-    createPreview?: readonly RoutingPreviewTarget[];
+    /**
+     * The workspace's squads and their actions. Absent (a daemon without squad
+     * routes, or not loaded yet) shows the Squads view empty, with no New squad.
+     */
+    squads?: Pick<SquadsSectionProps, 'squads' | 'onCreate' | 'onUpdate' | 'onRetire'>;
     pending?: boolean;
 }
 export interface WorkspaceAgentSummaryView {
@@ -86,16 +76,12 @@ export interface WorkspaceAgentSummaryView {
     maxConcurrentRuns?: number;
     execution?: AgentConfigPatch['execution'];
     enabled: boolean;
-    status: 'offline' | 'idle' | 'working' | 'blocked' | 'error';
+    status: 'offline' | 'idle' | 'working' | 'error';
     /** Absent from a daemon older than runtimes; that agent runs here. */
     runtime?: WorkspaceAgentRuntimeView;
     /** Set once the identity is retired: it keeps its posts and takes no work. */
     retiredAt?: number;
-    workingOn?: {
-        id: string;
-        title: string;
-        state: 'working' | 'finishing' | 'stopping';
-    };
+    /** Queued session-agent runs waiting for this agent. */
     waiting: number;
 }
 export interface WorkspaceAgentRuntimeView {
@@ -103,19 +89,21 @@ export interface WorkspaceAgentRuntimeView {
     kind: 'local' | 'external';
     label: string;
     provider: string;
-    /** Program ids the runtime reported it can run. */
+    /**
+     * Program ids (`qwen` | `claude` | `codex`) the runtime reported it can run,
+     * the local daemon included (from its program probe). None means Qwen Code.
+     */
     programs?: readonly string[];
     status: 'online' | 'offline';
     workspaceId?: string;
     workspaceCwd?: string;
-    hostSessionId?: string;
     lastSeenAt?: number;
     agentCount?: number;
     sessionCount?: number;
     runningTaskCount?: number;
     queuedTaskCount?: number;
 }
-export type AgentWorkspaceView = 'agents' | 'tasks' | 'runtime';
+export type AgentWorkspaceView = 'agents' | 'squads' | 'runtime';
 export interface NewWorkspaceAgent {
     name: string;
     description?: string;
@@ -125,22 +113,10 @@ export interface NewWorkspaceAgent {
     maxConcurrentRuns?: number;
     execution?: AgentConfigPatch['execution'];
 }
-export type ThreadPriorityChoice = 'urgent' | 'high' | 'normal' | 'low';
-export interface NewThread {
-    title: string;
-    body: string;
-    /** What "done" means. Sent only when written, so a blank stays absent. */
-    acceptanceCriteria?: string;
-    priority?: ThreadPriorityChoice;
-    assignee?: string;
-    /** The first post; the assignee starts from it. */
-    message?: string;
-}
 /**
- * The thread list, grouped by what each thread needs.
- *
- * Recency sorting is the obvious default and it buries the two threads that
- * need a person under twenty that do not. Grouping answers the question
- * someone actually opens this page with.
+ * The Agents page: the workspace's agent roster, its squads, and the runtimes
+ * agents run on.
+ * Agents are addressed by @-mention in a chat session; this page only manages
+ * who they are and where they run.
  */
-export declare function ThreadsPage({ agents, threads, runtimes, view, onViewChange, onOpenThread, onDeleteAgent, onSetAgentEnabled, onUpdateAgent, onOpenAgentBuilder, onOpenDefinitions, onCreateJoinToken, onRemoveRuntime, onConnectRemoteHost, hostServerUrl, shares, capabilities, onCreateThread, workspaceCwd, workspaces, onWorkspaceChange, createError, onPreviewThread, createPreview, pending, }: ThreadsPageProps): import("react/jsx-runtime").JSX.Element;
+export declare function ThreadsPage({ agents, runtimes, view, onViewChange, onMentionAgent, onDeleteAgent, onSetAgentEnabled, onUpdateAgent, onOpenAgentBuilder, onOpenDefinitions, onCreateJoinToken, onRemoveRuntime, onConnectRemoteHost, onJoinCoordinator, hostServerUrl, shares, squads, pending, }: ThreadsPageProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/workspace-agents/add-runtime-dialog.d.ts

@@ -8,22 +8,48 @@ export interface RuntimeSummary {
     kind: 'local' | 'external';
     label: string;
     provider: string;
-    providers?: readonly string[];
+    /** Program ids the runtime reported it can run. */
+    programs?: readonly string[];
     status: 'online' | 'offline';
 }
 export interface JoinToken {
     token: string;
     workspaceId: string;
     expiresAt: number;
+    replacementHostId?: string;
 }
 export interface ConnectExistingInput {
     remoteUrl: string;
     remoteToken: string;
     remoteCwd: string;
     serverUrl: string;
-    provider: 'qwen';
     allowHttp: boolean;
 }
+/** `POST /hosts/connect`: this daemon joins another coordinator as a runtime. */
+export interface JoinCoordinatorInput {
+    serverUrl: string;
+    workspaceId: string;
+    enrollmentToken: string;
+    allowHttp: boolean;
+}
+/**
+ * Reads the link a coordinator shows under Runtime › Add runtime,
+ * `<coordinator URL>/join/<workspace id>`. Same rules as `parseJoinLink` in
+ * `packages/cli/src/serve/agent-host-join.ts` (keep the two in step); returns
+ * undefined instead of throwing so a form can validate as the user types.
+ */
+export declare function parseJoinLink(link: string): {
+    serverUrl: string;
+    workspaceId: string;
+} | undefined;
+/**
+ * The terminal equivalent of "Join a coordinator": `qwen agents join <link>`
+ * asks the running local `qwen serve` to join with the same link (it calls
+ * that daemon's `/hosts/connect`, exactly as this dialog does). The token
+ * rides in the environment, never in argv.
+ */
+export declare function joinCoordinatorCommand(link: string, token: string, allowHttp: boolean): string;
+export declare function findReplacementRuntime(runtimes: readonly RuntimeSummary[], knownIds: ReadonlySet<string>, supersededHostId: string, replacementHostId?: string): RuntimeSummary | undefined;
 export declare function joinCommands(address: string, join: JoinToken): {
     qwen: string;
     npx: string;
@@ -31,17 +57,20 @@ export declare function joinCommands(address: string, join: JoinToken): {
 };
 /**
  * "Add runtime": hand another machine a one-line command, then wait for it to
- * show up. The dialog notices the new runtime through the same live stream
+ * show up. The dialog notices the new runtime through the same roster poll
  * that updates the Runtime tab, so it flips from waiting to connected by
  * itself (the Tailscale/Vercel "add device" pattern).
  */
-export declare function AddRuntimeDialog({ open, onOpenChange, serverUrl, runtimes, onCreateJoinToken, onConnectExisting, onCreateAgentOn, }: {
+export declare function AddRuntimeDialog({ open, onOpenChange, serverUrl, runtimes, onCreateJoinToken, onConnectExisting, onJoinCoordinator, onCreateAgentOn, replacementTarget, }: {
     open: boolean;
     onOpenChange: (open: boolean) => void;
     /** The coordinator address this page talks to; the link's default. */
     serverUrl: string;
     runtimes: readonly RuntimeSummary[];
-    onCreateJoinToken: () => Promise<JoinToken>;
+    onCreateJoinToken: (supersedesHostId?: string) => Promise<JoinToken>;
     onConnectExisting?: (input: ConnectExistingInput) => Promise<boolean>;
+    /** Joins THIS daemon to another coordinator; absent hides that entry. */
+    onJoinCoordinator?: (input: JoinCoordinatorInput) => Promise<boolean>;
     onCreateAgentOn?: (runtimeId: string) => void;
+    replacementTarget?: RuntimeSummary;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/workspace-agents/agent-events.d.ts

@@ -4,47 +4,17 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 /**
- * Client for `GET /workspaces/:ws/agent/events`, the collaboration stream.
+ * Client for the session-agents stream under `/workspaces/:ws/agent/`
+ * (`session-events?sessionId=`: a chat session's live agent runs). The roster
+ * has no stream; the Agents page polls it.
  *
  * `fetch` rather than `EventSource`: the daemon wants a bearer header, which
  * `EventSource` cannot send. Frames are plain `event:` + one `data:` line.
  */
-export interface AgentPermissionPromptView {
-    requestId: string;
-    title: string;
-    options: Array<{
-        optionId: string;
-        name: string;
-        kind?: string;
-    }>;
-}
-export interface AgentRunStepView {
-    id: string;
-    title: string;
-    status: 'running' | 'done' | 'failed';
-}
-export interface AgentRunProgressEvent {
-    type: 'progress';
-    threadId: string;
-    runId: string;
-    attempt: number;
-    sessionId: string;
-    stage: string;
-    detail: string;
-    outputText: string;
-    thoughtText: string;
-    activityAt: number;
-    permission?: AgentPermissionPromptView;
-    steps?: AgentRunStepView[];
-}
-export type AgentLiveEvent = {
-    type: 'changed';
-    threadId?: string;
-} | AgentRunProgressEvent;
 export type AgentStreamState = 'open' | 'closed';
 /**
  * Subscribes to a workspace's stream. Subscribers of the same URL share one
  * connection: browsers allow only a handful per origin, and the sidebar plus
  * an open conversation would otherwise hold several for the same workspace.
  */
-export declare function subscribeAgentStream(url: string, token: string | undefined, onEvent: (event: AgentLiveEvent) => void, onState: (state: AgentStreamState) => void): () => void;
+export declare function subscribeAgentStream<T = unknown>(url: string, token: string | undefined, onEvent: (event: T) => void, onState: (state: AgentStreamState) => void): () => void;

package/dist/types/components/workspace-agents/agents-route.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2026 Qwen Team
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type AgentWorkspaceView } from './ThreadsPage';
+export interface AgentsRouteProps {
+    /** `new-agent` opens straight into the New agent page. */
+    initialView?: AgentWorkspaceView | 'new-agent';
+    workspaceCwd?: string;
+    onOpenDefinitions?: () => void;
+    /** Puts `@name ` into the chat composer; absent hides the card button. */
+    onMentionAgent?: (name: string) => void;
+}
+/**
+ * The Agents page with its data: the workspace's roster and runtimes, kept
+ * fresh by polling.
+ */
+export declare function AgentsRoute({ initialView, workspaceCwd: boundWorkspaceCwd, onOpenDefinitions, onMentionAgent, }: AgentsRouteProps): import("react/jsx-runtime").JSX.Element;