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

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

@@ -0,0 +1,34 @@
+/**
+ * @license
+ * Copyright 2025 Qwen Team
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { DaemonCapabilities, DaemonSessionSummary, DaemonWorkspaceCapability } from '@qwen-code/sdk/daemon';
+/**
+ * Last path segment of an absolute workspace cwd, for a compact per-workspace
+ * label (e.g. `/home/me/projects/api` → `api`). Falls back to the full path when
+ * it has no segments.
+ */
+export declare function workspaceBasename(cwd: string): string;
+export declare function workspaceLabel(workspace: Pick<DaemonWorkspaceCapability, 'cwd' | 'displayName'>): string;
+export declare function workspaceLabelForCwd(cwd: string, workspaces: readonly Pick<DaemonWorkspaceCapability, 'cwd' | 'displayName'>[] | undefined): string;
+/**
+ * True when the daemon advertises more than one registered workspace — i.e. the
+ * multi-workspace session surfaces (per-workspace labels/tags) should show.
+ * A single-workspace daemon omits `workspaces` (or lists just the primary), so
+ * every workspace-scoped affordance stays hidden and the UI is unchanged.
+ */
+export declare function hasMultipleWorkspaces(capabilities: DaemonCapabilities | undefined): boolean;
+/**
+ * Whether a session belongs to a workspace other than the primary one. Both cwds
+ * are daemon-canonicalized, so a raw string compare is correct. Returns false
+ * when either cwd is unknown (treat as primary) so single-workspace never tags.
+ */
+export declare function isNonPrimaryWorkspaceSession(workspaceCwd: string | undefined, primaryCwd: string | undefined): boolean;
+/**
+ * Merge the primary workspace's sessions with the sessions collected from other
+ * workspaces into one list, keyed by `sessionId` (primary wins on the unlikely
+ * id collision). Returns the primary list unchanged (same reference) when there
+ * are no other-workspace sessions, so the single-workspace path is a no-op.
+ */
+export declare function mergeSessionsById(primary: DaemonSessionSummary[], others: DaemonSessionSummary[]): DaemonSessionSummary[];

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

@@ -0,0 +1,15 @@
+/**
+ * @license
+ * Copyright 2026 Qwen Team
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { DaemonCapabilities, DaemonSessionGroupPresetColor } from '@qwen-code/sdk/daemon';
+/**
+ * A stable accent color for a workspace, so split-view panes in the same
+ * workspace share a color and different workspaces read apart at a glance.
+ * Keyed by the workspace's position in the daemon's `workspaces[]` (stable per
+ * daemon), so the primary workspace always gets the first color; falls back to
+ * a deterministic hash of the cwd when the list doesn't include it. Returns
+ * `undefined` for a missing cwd so callers can skip the accent entirely.
+ */
+export declare function workspaceAccentColor(cwd: string | undefined, capabilities: DaemonCapabilities | undefined): DaemonSessionGroupPresetColor | undefined;

package/dist/types/voice/VoiceButton.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type React from 'react';
+import { type VoiceStatusRevision, type VoiceWorkspaceTarget } from './voice-workspace-target';
+export interface VoiceButtonProps {
+    /** Insert the final transcript into the composer (user reviews, then sends). */
+    onInsert: (text: string) => void;
+    onActiveChange?: (active: boolean) => void;
+    disabled?: boolean;
+    target: VoiceWorkspaceTarget | undefined;
+    statusRevision?: VoiceStatusRevision;
+}
+export declare function VoiceButton({ onInsert, onActiveChange, disabled, target, statusRevision, }: VoiceButtonProps): React.JSX.Element | null;

package/dist/types/voice/use-voice-workspace-settings.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { DaemonClient, DaemonSettingDescriptor, DaemonWorkspaceSettingsStatus } from '@qwen-code/sdk/daemon';
+import { type VoiceWorkspaceTarget } from './voice-workspace-target';
+interface VoiceWorkspaceSettingsState {
+    descriptor: DaemonSettingDescriptor | undefined;
+    reload: () => Promise<DaemonWorkspaceSettingsStatus | undefined>;
+}
+export declare function useVoiceWorkspaceSettings(client: DaemonClient, target: VoiceWorkspaceTarget | undefined, enabled: boolean, revisionKey: string): VoiceWorkspaceSettingsState;
+export {};

package/dist/types/voice/useVoiceCapture.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Captures 16 kHz mono PCM in the browser and streams it to the immutable
+ * workspace owner selected when recording starts. Credentials remain in the
+ * browser-to-daemon transport; transcription stays server-side. The bearer
+ * subprotocol is verified by the daemon's ACP upgrade listener in
+ * `serve/acp-http/index.ts`.
+ */
+export type VoiceCaptureStatus = 'idle' | 'connecting' | 'recording' | 'transcribing' | 'error';
+export interface VoiceCaptureTarget {
+    ownerKey: string;
+    streamPath: string;
+}
+export interface VoiceUnexpectedClose {
+    code: number;
+    reason: string;
+}
+export interface UseVoiceCaptureOptions {
+    baseUrl: string;
+    token?: string;
+    target: VoiceCaptureTarget | undefined;
+    /** Called with the final transcript (may be empty). */
+    onFinal: (text: string) => void;
+    onError?: (message: string) => void;
+    onUnexpectedClose?: (event: VoiceUnexpectedClose) => void;
+}
+export interface UseVoiceCaptureReturn {
+    status: VoiceCaptureStatus;
+    interimText: string;
+    /** Recent input level, 0..1, for a live meter. */
+    audioLevel: number;
+    errorMessage: string | undefined;
+    start: () => void;
+    stop: () => void;
+    abort: () => void;
+}
+export declare function toVoiceWebSocketUrl(baseUrl: string, streamPath: string): string;
+export declare function useVoiceCapture({ baseUrl, token, target, onFinal, onError, onUnexpectedClose, }: UseVoiceCaptureOptions): UseVoiceCaptureReturn;

package/dist/types/voice/voice-workspace-target.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { DaemonCapabilities, DaemonClient, DaemonSettingUpdateResult, DaemonWorkspaceCapability, DaemonWorkspaceSettingsStatus, DaemonWorkspaceVoiceStatus } from '@qwen-code/sdk/daemon';
+interface VoiceTargetBase {
+    cwd?: string;
+    workspaceKey: string;
+    ownerKey: string;
+    sessionId?: string;
+}
+export type VoiceWorkspaceTarget = (VoiceTargetBase & {
+    route: 'legacy-primary';
+    streamPath: 'voice/stream';
+}) | (VoiceTargetBase & {
+    route: 'workspace-qualified';
+    cwd: string;
+    selector: {
+        kind: 'id' | 'cwd';
+        value: string;
+    };
+    streamPath: string;
+});
+export interface VoiceStatusRevision {
+    user: number;
+    workspace: number;
+}
+export interface ResolveVoiceWorkspaceTargetOptions {
+    capabilities: DaemonCapabilities | undefined;
+    intendedCwd: string | undefined;
+    sessionId?: string;
+    /**
+     * Pass App's merged list when a locked workspace has been registered before
+     * the next capabilities snapshot arrives.
+     */
+    workspaces?: readonly DaemonWorkspaceCapability[];
+}
+export declare function resolveVoiceWorkspaceTarget({ capabilities, intendedCwd, sessionId, workspaces, }: ResolveVoiceWorkspaceTargetOptions): VoiceWorkspaceTarget | undefined;
+export declare function supportsVoiceCapture(target: VoiceWorkspaceTarget | undefined, features: readonly string[]): boolean;
+export declare function supportsVoiceModelSettings(target: VoiceWorkspaceTarget | undefined, features: readonly string[]): boolean;
+export declare function loadVoiceStatus(client: DaemonClient, target: VoiceWorkspaceTarget): Promise<DaemonWorkspaceVoiceStatus>;
+export declare function loadVoiceSettings(client: DaemonClient, target: VoiceWorkspaceTarget): Promise<DaemonWorkspaceSettingsStatus>;
+export declare function setVoiceModelSetting(client: DaemonClient, target: VoiceWorkspaceTarget, scope: 'workspace' | 'user', value: string): Promise<DaemonSettingUpdateResult>;
+export {};

package/dist/types/voice/voiceModels.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/** A voice-transcription model option for the `/model --voice` picker. */
+export interface VoiceModelOption {
+    /** Raw model id (no auth suffix) — what gets persisted as `voiceModel`. */
+    id: string;
+    label?: string;
+    authType?: string;
+    baseUrl?: string;
+    contextWindow?: number;
+    modalities?: {
+        audio?: boolean;
+    };
+}
+/**
+ * Mirror of the CLI's `resolveVoiceTransport` id patterns (voice-model.ts): true
+ * for ids the daemon has an ASR transport for. Kept in sync by hand because the
+ * Web Shell can't import the CLI's voice modules.
+ */
+export declare function isVoiceModelId(id: string): boolean;

package/dist/types/workflowDetailsContext.d.ts

@@ -0,0 +1,11 @@
+import { type ReactNode } from 'react';
+import type { DaemonSessionTaskWithWorkflowStatus } from '@qwen-code/sdk/daemon';
+interface WorkflowDetailsContextValue {
+    tasks: readonly DaemonSessionTaskWithWorkflowStatus[];
+}
+export declare function WorkflowDetailsProvider({ tasks, children, }: {
+    tasks: readonly DaemonSessionTaskWithWorkflowStatus[];
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function useWorkflowDetails(): WorkflowDetailsContextValue | undefined;
+export {};

package/package.json

@@ -0,0 +1,102 @@
+{
+  "name": "@qwen-code/web-shell",
+  "version": "0.24.1-preview.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./daemon-react-sdk": {
+      "types": "./dist/types/daemon-react-sdk.d.ts",
+      "import": "./dist/daemon-react-sdk.js"
+    },
+    "./transcript": {
+      "types": "./dist/types/transcript.d.ts",
+      "import": "./dist/transcript.js"
+    }
+  },
+  "files": [
+    "dist/*.js",
+    "dist/types"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build && vite build --config vite.lib.config.ts && vite build --config vite.lib.config.ts --mode transcript && tsc -p tsconfig.lib.json",
+    "lint": "cd ../.. && eslint packages/web-shell --ext .ts,.tsx",
+    "lint:fix": "cd ../.. && eslint packages/web-shell --ext .ts,.tsx --fix",
+    "format:check": "cd ../.. && prettier --experimental-cli --check packages/web-shell",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --config vitest.config.ts",
+    "test:ci": "vitest run --config vitest.config.ts",
+    "test:coverage": "vitest run --config vitest.config.ts --coverage",
+    "test:e2e:smoke": "playwright test --config playwright.config.ts --grep @smoke",
+    "test:e2e:perf": "cross-env WEB_SHELL_PERF=1 playwright test --config playwright.config.ts --grep @perf --project=chromium",
+    "test:e2e": "playwright test --config playwright.config.ts",
+    "test:e2e:visuals": "playwright test --config playwright.visuals.config.ts",
+    "test:e2e:report": "playwright show-report client/e2e/playwright-report",
+    "verify": "npm run lint && npm run format:check && npm run typecheck && npm run test:ci"
+  },
+  "dependencies": {
+    "@codemirror/autocomplete": "^6.18.0",
+    "@codemirror/commands": "^6.7.0",
+    "@codemirror/language": "^6.10.0",
+    "@codemirror/merge": "^6.12.2",
+    "@codemirror/state": "^6.5.0",
+    "@codemirror/view": "^6.35.0",
+    "@datafe-open/markdown-chart": "^0.1.12",
+    "@datafe-open/markdown-chart-echarts": "^0.1.12",
+    "@datafe-open/markdown-chart-react": "^0.1.12",
+    "@modelcontextprotocol/ext-apps": "^1.7.5",
+    "@tanstack/react-table": "^8.21.3",
+    "@tanstack/react-virtual": "^3.13.26",
+    "@xterm/addon-fit": "^0.11.0",
+    "@xterm/xterm": "^6.0.0",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "codemirror": "^6.0.0",
+    "echarts": "^6.0.0",
+    "fzf": "^0.5.2",
+    "katex": "^0.16.47",
+    "lucide-react": "^1.24.0",
+    "mermaid": "^11.15.0",
+    "radix-ui": "^1.6.2",
+    "react-markdown": "^9.0.0",
+    "rehype-katex": "^7.0.1",
+    "remark-cjk-friendly": "^2.3.1",
+    "remark-gfm": "^4.0.0",
+    "remark-math": "^6.0.0",
+    "shiki": "^1.29.2",
+    "tailwind-merge": "^3.6.0",
+    "vaul": "^1.1.2"
+  },
+  "peerDependencies": {
+    "@qwen-code/sdk": ">=0.1.8",
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@playwright/test": "1.61.1",
+    "@qwen-code/sdk": "file:../sdk-typescript",
+    "@tailwindcss/vite": "^4.3.2",
+    "@types/hast": "^3.0.5",
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.2.0",
+    "@types/react-dom": "^19.0.0",
+    "@vitejs/plugin-react": "^4.2.0",
+    "jsdom": "^26.1.0",
+    "postcss": "^8.5.17",
+    "postcss-selector-parser": "^7.1.4",
+    "react": "^19.2.0",
+    "react-dom": "^19.0.0",
+    "shadcn": "^4.13.0",
+    "tailwindcss": "^4.3.2",
+    "tw-animate-css": "^1.4.0",
+    "typescript": "^5.3.3",
+    "vite": "^5.0.0",
+    "vitest": "^3.2.4"
+  }
+}