DeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.
Python ai-agentsai-tutorclawbotcli-tooldeepresearchinteractive-learninglearningmulti-agent-systemsrag
Integrate saved user workspace changes with reviewed dev updates
Bingxi Zhao (Frank)f8be7569062d
diff --git a/README.md b/README.mdindex aebc69fbc..3dde7f375 100644--- a/README.md+++ b/README.md@@ -248,6 +248,22 @@ DeepTutor is an agent-native learning workspace that connects tutoring, problem## 🚀 Get Started+### Let Your Agent Set Up DeepTutor++Copy this prompt into your terminal-capable AI agent (such as Codex or Claude Code):++```text+Help me install and configure DeepTutor locally from https://github.com/HKUDS/DeepTutor.+Clone the repository, or reuse my existing checkout, and read SKILL.md and+docs-for-user/AGENT_SETUP.md first. Follow that guide to prepare the environment,+configure my model provider, verify the setup, and start the Web app.+Ask me for any missing provider, model, or credential-source information;+do not print API keys. Preserve my existing files and settings, and finish+with the access URL and the results of your checks.+```++The [Agent Setup guide](docs-for-user/AGENT_SETUP.md) covers the full flow, including non-interactive CLI configuration. To install it yourself, choose one of the paths below.+DeepTutor ships four installation paths. They all share one runtime-home layout: private settings live in `data/user/settings/` under the directory you launch from (or under `DEEPTUTOR_HOME` / `deeptutor start --home` if you set one explicitly). For the full app, the recommended flow is **pick a runtime-home directory → install → `deeptutor init` → `deeptutor start`**.### One-Command Docker Trial@@ -972,7 +988,7 @@ SID=$(deeptutor run deep_research "Survey 2026 papers on RAG" \deeptutor run deep_question "Quiz me on that survey" --session "$SID" --format json```-The repo ships a root [`SKILL.md`](SKILL.md) — a ~200-line handover doc that teaches any tool-using LLM the whole surface in one read. Hand it to Claude Code, Codex, or OpenCode (they pick up `SKILL.md` automatically), or wrap `deeptutor run` as a tool in a LangChain / AutoGen loop. Full recipes: [Agent Handoff](https://deeptutor.info/docs/cli/agent-handoff/).+The repo ships a root [`SKILL.md`](SKILL.md) — a compact handover doc for the CLI. Ask your agent to read it explicitly; its [Agent Setup guide](docs-for-user/AGENT_SETUP.md) covers installation and configuration. You can also wrap `deeptutor run` as a tool in a LangChain / AutoGen loop. Full recipes: [Agent Handoff](https://deeptutor.info/docs/cli/agent-handoff/).</details>@@ -981,7 +997,7 @@ The repo ships a root [`SKILL.md`](SKILL.md) — a ~200-line handover doc that t| Command | Description ||:---|:---|-| `deeptutor init` | Create or update `data/user/settings` in the current runtime home |+| `deeptutor init [--non-interactive] [--home PATH]` | Run the setup wizard, or create missing defaults without prompts || `deeptutor doctor [--online]` | Check whether the runtime is ready to start a session; `--online` also probes the configured model provider, `--format json` prints the report || `deeptutor start [--home PATH] [--dev] [--detach] [--no-browser]` | Launch backend + frontend together; optionally detach or suppress browser opening || `deeptutor stop [--home PATH]` | Stop a launcher started with `--detach` |@@ -997,7 +1013,9 @@ The repo ships a root [`SKILL.md`](SKILL.md) — a ~200-line handover doc that t| `deeptutor notebook list/create/show/add-md/replace-md/remove-record` | Manage notebooks from Markdown files || `deeptutor book list/health/refresh-fingerprints` | Inspect books and refresh source fingerprints || `deeptutor plugin list/info` | Inspect registered tools and capabilities |-| `deeptutor config show` | Print configuration summary |+| `deeptutor config show [--home PATH]` | Show resolved runtime configuration with credentials redacted |+| `deeptutor config providers` | List supported setup providers and defaults as JSON |+| `deeptutor config apply FILE [--check] [--home PATH]` | Apply setup JSON without prompts, or validate it without writing settings || `deeptutor provider login <provider>` | Provider auth (`openai-codex` OAuth login; `github-copilot` validates an existing Copilot auth session; `codebuddy` validates CodeBuddy SDK auth and starts login when needed) |</details>diff --git a/SKILL.md b/SKILL.mdindex 8ef9e846a..d79bf4884 100644--- a/SKILL.md+++ b/SKILL.md@@ -11,20 +11,47 @@ description: Configure, manage, and use DeepTutor through its CLI, including capUse this skill when the user wants to:- Set up or configure DeepTutor+- Diagnose problems in an existing DeepTutor installation- Chat with DeepTutor or run a capability (deep solve, quiz generation, deep research, visualize, math animation, mastery path)- Create, manage, or search knowledge bases- Create, manage, or run Partners (IM-connected companions)-- Search, install, or manage skills from a hub (ClawHub)+- Search, install, or manage skills from a hub (EduHub or ClawHub)- Inspect or maintain interactive Books- View or manage learning memory, sessions, or notebooks- Start the DeepTutor API server or the full Web app## Prerequisites-- Python 3.11+-- DeepTutor installed: `pip install deeptutor` for the full Web app, `pip install deeptutor-cli` for CLI-only, or `pip install -e .` from a source checkout+- Python 3.11–3.14+- DeepTutor installed: `pip install deeptutor` for the packaged full Web app, `pip install -e .` for a full source checkout, or `pip install -e ./packaging/deeptutor-cli` for CLI-only from source. Full source installs also need Node.js 22 LTS and `npm ci --legacy-peer-deps` in `web/`.- Run `deeptutor init` for first-time interactive setup. It walks a guided wizard (ports → LLM → embedding → search → review) and writes the same settings as the Web Settings page under `data/user/settings`. Add `--cli` to skip the ports step for CLI-only use, or `--home <path>` to target a specific workspace.+## Agent Setup++When the user asks you to install, configure, or troubleshoot DeepTutor, follow+[docs-for-user/AGENT_SETUP.md](docs-for-user/AGENT_SETUP.md). It covers cloning,+environment preparation, credential sources, optional RAG/search, startup,+and verification, plus a [troubleshooting approach](docs-for-user/AGENT_SETUP.md#6-troubleshooting)+for existing installations. Read it before changing settings; reuse existing checkouts+and preserve the user's files. Keep `DEEPTUTOR_HOME` consistent for all commands.++```bash+deeptutor init --non-interactive # Create missing defaults; no model selected+deeptutor config providers # Discover supported providers as JSON+deeptutor config apply setup.json --check # Validate without settings writes/network+deeptutor config apply setup.json # Apply complete setup profiles from JSON+deeptutor config show # Inspect configuration with credentials redacted+deeptutor doctor --format json # Check local readiness+deeptutor doctor --online --format json # Small live LLM request (provider usage)+```++Use the guide's setup JSON schema, with `api_key_env` referencing a credential+in the CLI process's environment. Never print keys or place literal keys in+the setup JSON. For missing credentials/model choices, ask the user for the+source/selection; continue independent preparation. Use the installed CLI's+`--help` to confirm commands when working with an older release. Saving settings+is not proof of readiness: report actual verification and any unfinished step.+## Commands### Chat & Capabilities@@ -32,18 +59,18 @@ Use this skill when the user wants to:```bash# Interactive REPLdeeptutor chat-deeptutor chat --capability deep_solve --kb my-kb --tool rag --tool web_search+deeptutor chat --capability deep_solve --kb my-kb --tool web_search# One-shot capability executiondeeptutor run chat "Explain Fourier transform"-deeptutor run deep_solve "Solve x^2 = 4" --tool rag --kb textbook+deeptutor run deep_solve "Solve x^2 = 4" --kb textbookdeeptutor run deep_question "Linear algebra" --config num_questions=5deeptutor run deep_research "Attention mechanisms" --kb papers --config mode=report --config depth=standarddeeptutor run visualize "Plot the unit circle"deeptutor run math_animator "Visualize a Fourier series"# Capabilities accepted by `run` / `chat -c`:-# chat, deep_solve, deep_question, deep_research, visualize, math_animator, mastery_path+# Discover current capabilities and tool availability with `deeptutor plugin list`.# Options for `run`:# --session <id> Resume existing session@@ -59,7 +86,7 @@ deeptutor run math_animator "Visualize a Fourier series"`deeptutor chat` accepts the same `--session / --tool / --kb / --notebook-ref / --history-ref / --language / --config / --config-json` options, plus `--capability/-c <name>` to set the initial capability.-**Tools** for `--tool` / `-t`: user-toggleable tools are `brainstorm`, `web_search`, `paper_search`, `reason`, `geogebra_analysis`, `imagegen`, and `videogen`. Context-gated tools (`rag`, `exec`, `read_source`, `web_fetch`, `github`, `ask_user`, …) auto-mount when their context is present, but can also be force-enabled with `--tool`. Run `deeptutor plugin list` for the full registered set.+**Tools** for `--tool` / `-t`: user-toggleable tools are `brainstorm`, `web_search`, `paper_search`, `reason`, `geogebra_analysis`, `imagegen`, and `videogen`. Context-gated tools (`rag`, `exec`, memory, notebook, …) mount according to context/capability rules; `--tool` does not bypass those rules. Mount a knowledge base with `--kb` for RAG. Run `deeptutor plugin list` for the registered set.### Knowledge Bases@@ -93,8 +120,8 @@ deeptutor partner stop <id> # Stop a running partner### Skills-Install and manage skills, including packages from external hubs (ClawHub).-Hub refs use `<hub>:<slug>[@version]` (the hub prefix defaults to `clawhub`).+Install and manage skills, including packages from EduHub and ClawHub.+Hub refs use `<hub>:<slug>[@version]` (the hub prefix defaults to `eduhub`).```bashdeeptutor skill search "flashcards" [--hub clawhub] [--limit 10]@@ -147,17 +174,22 @@ deeptutor notebook remove-record <notebook_id> <record_id>```bashdeeptutor provider login openai-codex # OAuth login for OpenAI Codexdeeptutor provider login github-copilot # Validate an existing Copilot auth session+deeptutor provider login codebuddy # Validate CodeBuddy SDK login / open login```### System```bash-deeptutor config show # Print resolved configuration+deeptutor config show [--home <path>] # Print resolved configuration (redacted)+deeptutor config providers # Supported setup providers as JSON+deeptutor config apply <file.json> [--check] [--home <path>] # Apply/validate setup JSONdeeptutor plugin list # List registered tools and capabilitiesdeeptutor plugin info <name> # Show a tool/capability's schema + availabilitydeeptutor serve [--host 0.0.0.0] [--port 8001] [--reload] # Start the API server-deeptutor start [--home <path>] # Launch backend + frontend together-deeptutor init [--cli] [--home <path>] # Create/update workspace settings+deeptutor start [--home <path>] [--detach] [--no-browser] # Launch backend + frontend+deeptutor stop [--home <path>] # Stop a detached launcher+deeptutor init [--cli] [--home <path>] [--non-interactive] # Wizard or missing defaults+deeptutor doctor [--online] [--format json] # Local readiness / optional live LLM probe```## REPL Slash Commands@@ -191,13 +223,13 @@ deeptutor init # Interactive guided setup (add --cli for CLI-only)**Daily learning:**```bash-deeptutor chat --kb textbook --tool rag --tool web_search+deeptutor chat --kb textbook --tool web_search```**Build a knowledge base from documents:**```bashdeeptutor kb create physics --doc ch1.pdf --doc ch2.pdf-deeptutor run chat "Explain Newton's third law" --kb physics --tool rag+deeptutor run chat "Explain Newton's third law" --kb physics```**Generate quiz questions:**diff --git a/deeptutor/api/routers/auth.py b/deeptutor/api/routers/auth.pyindex 6e0dde4ca..dc7d4a01b 100644--- a/deeptutor/api/routers/auth.py+++ b/deeptutor/api/routers/auth.py@@ -496,7 +496,9 @@ def _install_request_workspace(request) -> None:catalog_management = library_request.get() or path.startswith(("/api/skills", "/api/space/mcp"))- management = path.startswith(("/api/settings", "/api/auth", "/api/multi-user"))+ management = path.startswith(+ ("/api/settings", "/api/auth", "/api/multi-user", "/api/task-board")+ )selected = install_workspace_scope(None if management or catalog_management else header if header is not None else query)@@ -515,7 +517,10 @@ def _install_request_workspace(request) -> None:):raise WorkspaceError("Restore this workspace before changing its data.")# Management/migration requests acquire their own exclusive lease.- if getattr(request, "method", None) is not None and not management:+ task_board_request = path == "/api/task-board" or path.startswith("/api/task-board/")+ if getattr(request, "method", None) is not None and (+ not management or (task_board_request and path != "/api/task-board/events")+ ):from deeptutor.services.workspace.activity import acquire_activitystate = getattr(request, "state", None)diff --git a/deeptutor/api/routers/sessions.py b/deeptutor/api/routers/sessions.pyindex 310c86d40..68d9d01c8 100644--- a/deeptutor/api/routers/sessions.py+++ b/deeptutor/api/routers/sessions.py@@ -533,6 +533,14 @@ async def purge_session(session_id: str):if not purged:raise HTTPException(status_code=404, detail="Session not found in recycle bin")await _cleanup_deleted_session(session_id)+ from deeptutor.services.task_board import get_task_board_store+ from deeptutor.services.workspace.context import current_workspace_id++ await asyncio.to_thread(+ get_task_board_store(migrate_legacy=False).remove_session,+ current_workspace_id(),+ session_id,+ )return {"purged": True, "session_id": session_id}diff --git a/deeptutor/api/routers/settings.py b/deeptutor/api/routers/settings.pyindex 13e8f4edf..7d6f4255d 100644--- a/deeptutor/api/routers/settings.py+++ b/deeptutor/api/routers/settings.py@@ -244,6 +244,21 @@ class VoicePreviewPayload(BaseModel):text: str = Field(min_length=1, max_length=500)+class VoiceDiscoveryPayload(BaseModel):+ catalog: dict[str, Any]+ profile_id: str+ model_id: str+++class ServicePreviewPayload(BaseModel):+ catalog: dict[str, Any]+ profile_id: str+ model_id: str | None = None+ text: str = Field(default="", max_length=2000)+ audio: str = Field(default="", max_length=11184812)+ content_type: str = ""++class CatalogPayload(BaseModel):catalog: dict[str, Any]@@ -2168,6 +2183,26 @@ async def update_enabled_tools(update: EnabledToolsUpdate):return {"enabled_optional_tools": sanitized}[email protected]("/voice/voices")+async def list_voice_choices(payload: VoiceDiscoveryPayload):+ """Read live account voices for a draft selection, without applying it."""+ _require_settings_admin()+ from deeptutor.services.voice.discovery import discover_voices++ service = get_model_catalog_service()+ current = service.load()+ saved = get_settings_draft_service().load().get("catalog")+ source = restore_catalog_secrets(saved, current) if isinstance(saved, dict) else current+ catalog = service.resolve_connections(restore_catalog_secrets(payload.catalog, source))+ try:+ result = await discover_voices(catalog, payload.profile_id, payload.model_id)+ except ValueError as exc:+ raise HTTPException(status_code=400, detail=str(exc)) from exc+ return Response(+ json.dumps(result), media_type="application/json", headers={"Cache-Control": "no-store"}+ )++@router.post("/voice/preview",response_class=Response,@@ -2203,6 +2238,45 @@ async def preview_voice(payload: VoicePreviewPayload) -> Response:return Response(audio, media_type=content_type, headers={"Cache-Control": "no-store"})[email protected]("/services/{service}/preview")+async def preview_service(service: str, payload: ServicePreviewPayload):+ """Stream a real result from the selected draft without applying it."""+ _require_settings_admin()+ from deeptutor.services.settings.service_preview import preview_events, validate_input+ from deeptutor.services.voice.discovery import selected_catalog++ try:+ audio = validate_input(service, payload.text, payload.audio, payload.content_type)+ catalog_service = get_model_catalog_service()+ current = catalog_service.load()+ saved = get_settings_draft_service().load().get("catalog")+ source = restore_catalog_secrets(saved, current) if isinstance(saved, dict) else current+ catalog = catalog_service.resolve_connections(+ restore_catalog_secrets(payload.catalog, source)+ )+ selected_catalog(catalog, service, payload.profile_id, payload.model_id)+ except ValueError as exc:+ raise HTTPException(status_code=400, detail=str(exc)) from exc++ async def stream():+ async for event in preview_events(+ catalog,+ service,+ payload.profile_id,+ payload.model_id,+ payload.text,+ audio,+ payload.content_type,+ ):+ yield json.dumps(event, ensure_ascii=False) + "\n"++ return StreamingResponse(+ stream(),+ media_type="application/x-ndjson",+ headers={"Cache-Control": "no-store", "X-Accel-Buffering": "no"},+ )++@router.post("/tests/{service}/start")async def start_service_test(service: str, payload: CatalogPayload | None = None):_require_settings_admin()diff --git a/deeptutor/api/routers/task_board.py b/deeptutor/api/routers/task_board.pyindex 9703748f9..4eaaa78a0 100644--- a/deeptutor/api/routers/task_board.py+++ b/deeptutor/api/routers/task_board.py@@ -1,28 +1,112 @@-"""Authenticated task board endpoints using the current content workspace."""+"""Independent account task board with workspace/conversation associations."""-from fastapi import APIRouter, HTTPException+from __future__ import annotations-from deeptutor.services.task_board import CreateCard, TaskBoard, UpdateCard, get_task_board_store+import asyncio++from fastapi import APIRouter, HTTPException, Request+from fastapi.responses import StreamingResponse++from deeptutor.services.task_board import (+ CreateCard,+ LinkStatus,+ LinkTasks,+ StatusColors,+ TaskBoard,+ UpdateCard,+ get_task_board_store,+)+from deeptutor.services.workspace.context import workspace_context+from deeptutor.services.workspace.models import WorkspaceErrorrouter = APIRouter()@router.get("", response_model=TaskBoard)def get_board() -> TaskBoard:- """Return active and archived cards in the current workspace."""return get_task_board_store().read()[email protected]("/events")+async def board_events(request: Request):+ # Resolve once before streaming; each connection retains its account identity.+ store = await asyncio.to_thread(get_task_board_store)++ async def events():+ revision = -1+ heartbeat = 0+ while not await request.is_disconnected():+ current_revision = await asyncio.to_thread(store.revision)+ if current_revision != revision:+ board = await asyncio.to_thread(store.read)+ revision = board.revision+ yield f"id: {revision}\ndata: {board.model_dump_json()}\n\n"+ elif heartbeat % 30 == 0:+ yield ": heartbeat\n\n"+ heartbeat += 1+ await asyncio.sleep(0.5)++ return StreamingResponse(+ events(),+ media_type="text/event-stream",+ headers={+ # Next's proxy must flush each event instead of gzip-buffering it.+ "Cache-Control": "no-cache, no-transform",+ "Content-Encoding": "identity",+ "X-Accel-Buffering": "no",+ },+ )++@router.post("/cards", response_model=TaskBoard, status_code=201)def create_card(payload: CreateCard) -> TaskBoard:- """Create a task in the To do column."""return get_task_board_store().create(payload)@router.patch("/cards/{card_id}", response_model=TaskBoard)def update_card(card_id: str, payload: UpdateCard) -> TaskBoard:- """Edit, move, archive or restore an existing task."""try:+ if "workspace_id" in payload.model_fields_set and payload.workspace_id is not None:+ with workspace_context(payload.workspace_id) as scope:+ payload.workspace_id = scope.workspace_id+ if scope.archived:+ raise WorkspaceError("Restore this workspace before assigning tasks.")return get_task_board_store().update(card_id, payload)+ except WorkspaceError as exc:+ raise HTTPException(status_code=404, detail=str(exc)) from excexcept KeyError as exc:raise HTTPException(status_code=404, detail="Task card not found.") from exc++[email protected]("/colors", response_model=TaskBoard)+def update_colors(payload: StatusColors) -> TaskBoard:+ return get_task_board_store().set_colors(payload)+++async def require_session(session_id: str, workspace_id: str) -> str:+ from deeptutor.services.session import get_session_store++ try:+ with workspace_context(workspace_id) as scope:+ if scope.archived:+ raise WorkspaceError("Restore this workspace before changing its conversations.")+ if await get_session_store().get_session(session_id) is None:+ raise HTTPException(status_code=404, detail="Conversation not found.")+ return scope.workspace_id+ except WorkspaceError as exc:+ raise HTTPException(status_code=404, detail=str(exc)) from exc++[email protected]("/sessions/{session_id}", response_model=TaskBoard)+async def link_tasks(session_id: str, payload: LinkTasks) -> TaskBoard:+ payload.workspace_id = await require_session(session_id, payload.workspace_id)+ try:+ return await asyncio.to_thread(get_task_board_store().link_tasks, session_id, payload)+ except KeyError as exc:+ raise HTTPException(status_code=404, detail="Task not found or archived.") from exc++[email protected]("/sessions/{session_id}/status", response_model=TaskBoard)+async def link_status(session_id: str, payload: LinkStatus) -> TaskBoard:+ payload.workspace_id = await require_session(session_id, payload.workspace_id)+ return await asyncio.to_thread(get_task_board_store().link_status, session_id, payload)diff --git a/deeptutor/logging/configure.py b/deeptutor/logging/configure.pyindex 9654efa94..2bd469acd 100644--- a/deeptutor/logging/configure.py+++ b/deeptutor/logging/configure.py@@ -6,6 +6,7 @@ import loggingfrom logging.handlers import RotatingFileHandlerfrom pathlib import Pathimport sys+from typing import TextIOfrom deeptutor.utils.secret_files import ensure_private_directory, ensure_private_file@@ -36,7 +37,9 @@ def _remove_managed_handlers(root: logging.Logger) -> None:handler.close()-def configure_logging(force: bool = False) -> LoggingConfig:+def configure_logging(+ force: bool = False, *, console_stream: TextIO | None = None+) -> LoggingConfig:"""Configure stdlib logging once for the whole process."""global _CONFIGURED@@ -52,7 +55,9 @@ def configure_logging(force: bool = False) -> LoggingConfig:root.setLevel(logging.DEBUG)if config.console_output:- console = _managed(logging.StreamHandler(sys.stdout))+ console = _managed(+ logging.StreamHandler(console_stream if console_stream is not None else sys.stdout)+ )console.setLevel(level)console.setFormatter(ConsoleFormatter())root.addHandler(console)diff --git a/deeptutor/services/config/model_catalog.py b/deeptutor/services/config/model_catalog.pyindex dfc0831ee..d60f6860a 100644--- a/deeptutor/services/config/model_catalog.py+++ b/deeptutor/services/config/model_catalog.py@@ -436,12 +436,27 @@ class ModelCatalogService:if field in connection and profile.get(field) != connection[field]:profile[field] = deepcopy(connection[field])changed = True- base_url = str(connection.get("base_url") or "").strip()+ overrides = connection.get("service_overrides")+ override = (+ overrides.get("llm" if service_name == "task" else service_name)+ if isinstance(overrides, dict)+ else None+ )+ if not isinstance(override, dict) or not override.get("enabled"):+ override = {}+ if override.get("binding"):+ field = "provider" if service_name == "search" else "binding"+ if profile.get(field) != override["binding"]:+ profile[field] = override["binding"]+ changed = True+ base_url = str(override.get("base_url") or connection.get("base_url") or "").strip()if base_url:# Gemini's native embedding endpoint carries the model in its path,# so it is not derivable from an API base — leave those alone.- if service_name == "embedding" and is_gemini_native_embedding_endpoint(- profile.get("base_url")+ if (+ not override.get("base_url")+ and service_name == "embedding"+ and is_gemini_native_embedding_endpoint(profile.get("base_url"))):return changedresolved = _connection_base_url_for(service_name, base_url)diff --git a/deeptutor/services/config/provider_links.py b/deeptutor/services/config/provider_links.pyindex 4c2ce9864..dd7a13429 100644--- a/deeptutor/services/config/provider_links.py+++ b/deeptutor/services/config/provider_links.py@@ -20,6 +20,7 @@ PROVIDER_FIELDS = (*CREDENTIAL_FIELDS,"discovery","source_service",+ "service_overrides","user_name",)@@ -110,26 +111,61 @@ def resolve_profile_provider() -> dict:ref = (model or {}).get("provider_ref") or profile.get("provider_ref")if not isinstance(ref, dict):- return profile+ overrides = profile.get("service_overrides")+ override = (+ overrides.get("llm" if service == "task" else service)+ if isinstance(overrides, dict)+ else None+ )+ if not isinstance(override, dict) or not override.get("enabled"):+ return profile+ result = deepcopy(profile)+ if override.get("binding"):+ result["provider" if service == "search" else "binding"] = override["binding"]+ if override.get("base_url"):+ result["base_url"] = override["base_url"]+ return resultsource, source_service = provider_source(catalog, ref)result = deepcopy(profile)- binding = ref.get("binding") or source.get("binding") or source.get("provider") or "custom"+ overrides = source.get("service_overrides")+ override = (+ overrides.get("llm" if service == "task" else service, {})+ if isinstance(overrides, dict)+ else {}+ )+ if not isinstance(override, dict) or not override.get("enabled"):+ override = {}+ binding = (+ override.get("binding")+ or ref.get("binding")+ or source.get("binding")+ or source.get("provider")+ or "custom"+ )result["provider" if service == "search" else "binding"] = bindingfor field in CREDENTIAL_FIELDS:result[field] = deepcopy(source.get(field, {} if field == "extra_headers" else ""))# An empty provider URL deliberately uses the service's registry default.source_url = str(source.get("base_url") or "")+ target_default = (+ _source_default_url({"binding": binding}, service)+ if override.get("binding") and binding != ref.get("binding")+ else ref.get("default_base_url", "")+ )result["base_url"] = (provider_endpoint(source_url, source_service, service, binding)if source_url- else ref.get("default_base_url", "")+ else target_default)uses_default = not source_url- if source_url and source_service != service and ref.get("default_base_url"):+ if source_url and source_service != service and target_default:default = _source_default_url(source, source_service)if default and source_url.rstrip("/") == default.rstrip("/"):- result["base_url"] = ref["default_base_url"]+ result["base_url"] = target_defaultuses_default = True+ if override.get("base_url"):+ result["base_url"] = str(override["base_url"])+ uses_default = Falseif service == "embedding":from .embedding_endpoint import normalize_embedding_endpoint_for_displaydiff --git a/deeptutor/services/config/provider_runtime.py b/deeptutor/services/config/provider_runtime.pyindex 4cf6e8b08..547acec4e 100644--- a/deeptutor/services/config/provider_runtime.py+++ b/deeptutor/services/config/provider_runtime.py@@ -325,73 +325,62 @@ TTS_PROVIDERS: dict[str, VoiceProviderSpec] = {default_api_base="https://api.xiaomimimo.com/v1",adapter="mimo_tts",default_model="mimo-v2.5-tts",- default_voice="mimo_default",),"minimax": VoiceProviderSpec(label="MiniMax",default_api_base="https://api.minimax.io/v1",adapter="minimax",default_model="speech-2.8-hd",- default_voice="English_expressive_narrator",),"volcengine_speech": VoiceProviderSpec(label="Volcengine Speech (Doubao)",default_api_base="https://openspeech.bytedance.com/api/v3",adapter="volcengine",default_model="seed-tts-2.0",- default_voice="zh_female_vv_uranus_bigtts",),"dashscope": VoiceProviderSpec(label="Aliyun DashScope",default_api_base="https://dashscope.aliyuncs.com/api/v1",adapter="dashscope",default_model="qwen3-tts-flash",- default_voice="Cherry",),"openai": VoiceProviderSpec(label="OpenAI",default_api_base="https://api.openai.com/v1",default_model="gpt-4o-mini-tts",- default_voice="alloy",),"openrouter": VoiceProviderSpec(label="OpenRouter",default_api_base="https://openrouter.ai/api/v1",adapter="openrouter_tts",default_model="openai/gpt-4o-mini-tts",- default_voice="alloy",),"groq": VoiceProviderSpec(label="Groq",default_api_base="https://api.groq.com/openai/v1",default_model="canopylabs/orpheus-v1-english",- default_voice="autumn",),"siliconflow": VoiceProviderSpec(label="SiliconFlow",default_api_base="https://api.siliconflow.cn/v1",default_model="FunAudioLLM/CosyVoice2-0.5B",- default_voice="FunAudioLLM/CosyVoice2-0.5B:alex",),"azure_openai": VoiceProviderSpec(label="Azure OpenAI",default_api_base="",auth_style=AUTH_API_KEY_HEADER,default_model="tts-1",- default_voice="alloy",),"vllm": VoiceProviderSpec(label="vLLM / Local",default_api_base="http://localhost:8000/v1",default_model="",- default_voice="",is_local=True,),"custom": VoiceProviderSpec(label="OpenAI Compatible",default_api_base="",default_model="",- default_voice="",),}@@ -1205,15 +1194,10 @@ def resolve_tts_runtime_config(api_key = _as_str((profile or {}).get("api_key"))if not api_key and spec.is_local:api_key = "sk-no-key-required"- from deeptutor.services.voice.options import is_qwen_audio_tts, voice_model_options+ from deeptutor.services.voice.options import voice_model_optionsoptions = voice_model_options(provider, "tts", resolved_model)- default_voice = spec.default_voice- if options["voices"]:- default_voice = options["voices"][0]["id"]- elif provider == "dashscope" and is_qwen_audio_tts(resolved_model):- default_voice = ""- voice = _as_str((model or {}).get("voice")) or default_voice+ voice = _as_str((model or {}).get("voice"))response_format = _as_str((model or {}).get("response_format")) or options["formats"][0]raw_speed = (model or {}).get("speed")speed = _coerce_optional_float(raw_speed)diff --git a/deeptutor/services/config/test_runner.py b/deeptutor/services/config/test_runner.pyindex dee557699..cd00814b4 100644--- a/deeptutor/services/config/test_runner.py+++ b/deeptutor/services/config/test_runner.py@@ -142,7 +142,11 @@ class ConfigTestRunner:raise ValueError(f"Unsupported service: {service}")if not run.cancelled and run.status == "running":run.status = "completed"- run.emit("completed", f"{service.upper()} test completed successfully.")+ message = {+ "stt": "Speech endpoint responded to a silent connection probe. Recognition quality was not tested.",+ "videogen": "Video task submitted. Generation and playback were not verified.",+ }.get(service, f"{service.upper()} test completed successfully.")+ run.emit("completed", message)except Exception as exc:run.status = "failed"run.emit("failed", str(exc))diff --git a/deeptutor/services/session/turns/executor.py b/deeptutor/services/session/turns/executor.pyindex d34799d17..d047945b9 100644--- a/deeptutor/services/session/turns/executor.py+++ b/deeptutor/services/session/turns/executor.py@@ -887,6 +887,17 @@ class TurnExecutor:**parent_kwargs,)+ if not selection_tutor_context:+ from deeptutor.services.task_board import get_task_board_store+ from deeptutor.services.workspace.context import current_workspace_id++ task_context = await asyncio.to_thread(+ get_task_board_store(migrate_legacy=False).context_text,+ current_workspace_id(),+ session_id,+ )+ source_manifest_text += task_context+context = UnifiedContext(session_id=session_id,user_message=effective_user_message,diff --git a/deeptutor/services/session/turns/request_preparer.py b/deeptutor/services/session/turns/request_preparer.pyindex 13965dc67..17e246c10 100644--- a/deeptutor/services/session/turns/request_preparer.py+++ b/deeptutor/services/session/turns/request_preparer.py@@ -155,6 +155,7 @@ class TurnRequestPreparer:payload = {**payload, "language": get_response_language(default="en")}raw_config = dict(payload.get("config", {}) or {})+ linked_task_ids = raw_config.pop("linked_task_ids", None)resource_reuse = raw_config.pop("_resource_reuse", None)persistent_kbs = raw_config.pop("_persistent_knowledge_bases", None)per_turn_auto_route = payload.get("auto_route")@@ -173,7 +174,6 @@ class TurnRequestPreparer:raise RuntimeError("Conversation not found in this workspace.")session = await self.store.ensure_session(payload.get("session_id"))preferences = session.get("preferences") or {}-# A conversation-level choice wins over the account default that the# browser sends on every turn. Only the selector's explicit field may# change or clear this durable override (#1511).@@ -549,6 +549,12 @@ class TurnRequestPreparer:],}payload = {**payload, "llm_selection": llm_selection}+ if linked_task_ids is not None:+ from deeptutor.services.task_board import LinkTasks, get_task_board_store+ from deeptutor.services.workspace.context import current_workspace_id++ task_links = LinkTasks(workspace_id=current_workspace_id(), task_ids=linked_task_ids)+ await asyncio.to_thread(get_task_board_store().link_tasks, session["id"], task_links)lease = Noneif self.coordinator is not None:turn_id = f"turn_{int(time.time() * 1000)}_{uuid.uuid4().hex[:10]}"diff --git a/deeptutor/services/settings/provider_probe.py b/deeptutor/services/settings/provider_probe.pyindex 8e190c2df..24fd763e0 100644--- a/deeptutor/services/settings/provider_probe.py+++ b/deeptutor/services/settings/provider_probe.py@@ -3,7 +3,7 @@from __future__ import annotationsimport asyncio-from urllib.parse import urlsplit+from urllib.parse import urlsplit, urlunsplitimport aiohttpimport requests@@ -12,56 +12,101 @@ from deeptutor.services.llm.cloud_provider import _auth_binding, _get_aiohttp_cofrom deeptutor.services.llm.utils import build_auth_headers, collect_model_names-def detect_capabilities(items: list) -> list[dict]:- """Only explicit metadata establishes support. Model names are not proof."""+def model_services(item: dict) -> list[str]:+ """Classify explicit metadata, never a model name or a vision input alone.++ Sources: OpenRouter /models architecture; Aliyun /api/v1/models capabilities.+ This describes model types, not protocol compatibility or account access.+ """detected = set()- for item in items:- if not isinstance(item, dict):- continue- methods = item.get(- "supportedGenerationMethods", item.get("supported_generation_methods", [])- )- architecture = item.get("architecture") or {}- if not isinstance(architecture, dict):- architecture = {}- def values(value):- return value if isinstance(value, list) else []+ def values(value):+ return value if isinstance(value, list) else []- input_values = [- *values(architecture.get("input_modalities")),- *values(item.get("input_modalities")),- ]- output_values = [+ architecture = item.get("architecture")+ architecture = architecture if isinstance(architecture, dict) else {}+ metadata = item.get("inference_metadata")+ metadata = metadata if isinstance(metadata, dict) else {}+ outputs = {+ str(value).lower()+ for value in [*values(architecture.get("output_modalities")),*values(item.get("output_modalities")),+ *values(metadata.get("response_modality")),]- inputs = {str(value).lower() for value in input_values}- outputs = {str(value).lower() for value in output_values}- if isinstance(methods, list):- if any(- method in {"generateContent", "generateMessage", "chat", "completion"}- for method in methods- ):- detected.add("llm")- if any(- method in {"embedContent", "batchEmbedContents", "embedText", "embedding"}- for method in methods- ):- detected.add("embedding")- # Understanding an image/video is not evidence of generating one.- # Audio input/output is reported separately from visual generation.- if "audio" in inputs | outputs:+ }+ methods = values(+ item.get("supportedGenerationMethods", item.get("supported_generation_methods"))+ )+ kinds = set(str(value) for value in values(item.get("capabilities")))+ if any(+ isinstance(method, str)+ and method in {"generateContent", "generateMessage", "chat", "completion"}+ for method in methods+ ) or kinds & {"TG", "Reasoning"}:+ detected.add("llm")+ if (+ any(+ isinstance(method, str)+ and method in {"embedContent", "batchEmbedContents", "embedText", "embedding"}+ for method in methods+ )+ or item.get("type") == "embedding"+ or "embeddings" in outputs+ or kinds & {"ME", "TR"}+ ):+ detected.add("embedding")+ if "text" in outputs and "embedding" not in detected and not kinds & {"ASR", "Realtime-ASR"}:+ detected.add("llm")+ if "audio" in outputs or kinds & {"TTS", "Realtime-Text-to-Speech"}:+ detected.add("tts")+ # Audio understanding does not establish a transcription endpoint.+ if kinds & {"ASR", "Realtime-ASR"} or item.get("type") in ("transcription", "speech-to-text"):+ detected.add("stt")+ if "image" in outputs or "IG" in kinds:+ detected.add("imagegen")+ if "video" in outputs or "VG" in kinds:+ detected.add("videogen")+ return sorted(detected)+++def detect_capabilities(items: list) -> list[dict]:+ detected = set()+ for item in items:+ if not isinstance(item, dict):+ continue+ services = model_services(item)+ detected.update(services)+ if {"tts", "stt"} & set(services):detected.add("voice")- if outputs & {"image", "video"}:+ if {"imagegen", "videogen"} & set(services):detected.add("generation")- if "text" in outputs and item.get("type") != "embedding":- detected.add("llm")- if item.get("type") == "embedding":- detected.add("embedding")return [{"category": category, "evidence": "metadata"} for category in sorted(detected)]+def discovery_request(binding: str, base_url: str, api_version: str = "") -> tuple[str, dict]:+ """Use vendor metadata on the configured host only; never infer another region."""+ parsed = urlsplit(base_url)+ path = parsed.path.rstrip("/")+ params = (+ {"api-version": api_version} if api_version and binding in {"azure", "azure_openai"} else {}+ )+ if binding == "ollama":+ path = path.removesuffix("/v1") + "/api/tags"+ elif binding == "dashscope" and (parsed.hostname or "").endswith(".aliyuncs.com"):+ # The official native catalog includes capability metadata and pagination.+ path = path.replace("/compatible-mode/v1", "/api/v1")+ if "/services/" in path:+ path = path.split("/services/", 1)[0]+ path += "/models"+ params = {"page_no": 1, "page_size": 100}+ else:+ path += "/models"+ if binding == "openrouter":+ params["output_modalities"] = "all"+ return urlunsplit(parsed._replace(path=path, query="", fragment="")), params++def test_search_access(binding: str,base_url: str,@@ -70,6 +115,7 @@ def test_search_access(proxy: str = "",max_results: int = 1,require_results: bool = True,+ query: str = "DeepTutor configuration health check",):"""Test exactly one search adapter, never a fallback or live credentials."""from deeptutor.services.config.provider_runtime import (@@ -87,9 +133,7 @@ def test_search_access(kwargs = {"api_key": api_key or "", "base_url": base_url, "max_results": max_results}if proxy:kwargs["proxy"] = proxy- response = get_provider(binding, **kwargs).search(- "DeepTutor configuration health check", **kwargs- )+ response = get_provider(binding, **kwargs).search(query, **kwargs)if require_results and not (response.answer or response.search_results):raise ValueError("Search provider returned no answer or results.")return response@@ -189,55 +233,115 @@ async def probe_provider(headers = build_auth_headers(api_key, _auth_binding(binding, api_format))headers.pop("Content-Type", None)headers.update(extra_headers or {})- url = f"{base_url}/models"- params = (- {"api-version": api_version}- if api_version and binding in {"azure", "azure_openai"}- else None- )- if binding == "ollama":- url = f"{base_url.removesuffix('/v1')}/api/tags"+ url, params = discovery_request(binding, base_url, api_version)try:- async with aiohttp.ClientSession(- timeout=aiohttp.ClientTimeout(total=20),- connector=_get_aiohttp_connector(),- trust_env=True,- ) as session:- # Do not forward custom credentials to another host on a redirect.- async with session.get(- url, headers=headers, params=params, allow_redirects=False- ) as response:- if response.status in {401, 403}:- return {"status": "auth_error", "models": [], "http_status": response.status}- if response.status in {404, 405, 501}:- return {"status": "unavailable", "models": [], "http_status": response.status}- if response.status == 429:- return {"status": "rate_limited", "models": [], "http_status": 429}- if response.status != 200:- return {"status": "http_error", "models": [], "http_status": response.status}- try:- payload = await response.json()- except (ValueError, aiohttp.ContentTypeError):- return {"status": "unavailable", "models": []}- items = (- payload- if isinstance(payload, list)- else (- payload.get("data", payload.get("models"))- if isinstance(payload, dict)- else None+ async with (+ asyncio.timeout(30),+ aiohttp.ClientSession(+ timeout=aiohttp.ClientTimeout(total=20),+ connector=_get_aiohttp_connector(),+ trust_env=True,+ ) as session,+ ):+ all_items = []+ seen = set()+ warning = None+ for _page in range(30):+ async with session.get(+ url, headers=headers, params=dict(params) or None, allow_redirects=False+ ) as response:+ if response.status in {401, 403}:+ return {+ "status": "auth_error",+ "models": [],+ "http_status": response.status,+ }+ if response.status in {404, 405, 501}:+ return {+ "status": "unavailable",+ "models": [],+ "http_status": response.status,+ }+ if response.status == 429:+ return {"status": "rate_limited", "models": [], "http_status": 429}+ if response.status != 200:+ return {+ "status": "http_error",+ "models": [],+ "http_status": response.status,+ }+ try:+ payload = await response.json()+ except (ValueError, aiohttp.ContentTypeError):+ return {"status": "unavailable", "models": []}+ output = payload.get("output") if isinstance(payload, dict) else None+ native = isinstance(output, dict) and isinstance(output.get("models"), list)+ items = (+ output["models"]+ if native+ else (+ payload+ if isinstance(payload, list)+ else payload.get("data", payload.get("models"))+ if isinstance(payload, dict)+ else None+ ))- )- if not isinstance(items, list):- return {"status": "unavailable", "models": []}- models = list(dict.fromkeys(collect_model_names(items)))- if items and not models:- return {"status": "unavailable", "models": []}- result = {"status": "connected", "models": [{"id": model} for model in models]}- capabilities = detect_capabilities(items)- if capabilities:- result["capabilities"] = capabilities- return result+ if not isinstance(items, list) or (+ isinstance(payload, dict) and payload.get("success") is False+ ):+ return {"status": "unavailable", "models": []}+ normalized = [+ {**item, "id": item.get("id") or item.get("model")}+ if isinstance(item, dict)+ else item+ for item in items+ ]+ names = list(dict.fromkeys(collect_model_names(normalized)))+ if items and not names:+ return {"status": "unavailable", "models": []}+ if items and all(name in seen for name in names):+ warning = "partial_models"+ break+ all_items.extend(normalized)+ seen.update(names)+ if native:+ total = output.get("total")+ if not isinstance(total, (int, float)) or len(seen) >= total or not items:+ break+ params["page_no"] = (+ int(output.get("page_no") or params.get("page_no", 1)) + 1+ )+ elif isinstance(payload, dict) and payload.get("has_more"):+ cursor = payload.get("last_id")+ if (+ not isinstance(cursor, str)+ or not cursor+ or params.get("after_id") == cursor+ ):+ warning = "partial_models"+ break+ params["after_id"] = cursor+ else:+ break+ else:+ warning = "partial_models"+ models = {}+ for item in all_items:+ names = collect_model_names([item])+ for name in names:+ entry = {"id": name}+ kinds = model_services(item) if isinstance(item, dict) else []+ if kinds:+ entry["services"] = kinds+ models[name] = entry+ result = {"status": "connected", "models": list(models.values())}+ capabilities = detect_capabilities(all_items)+ if capabilities:+ result["capabilities"] = capabilities+ if warning:+ result["warning"] = warning+ return resultexcept (asyncio.TimeoutError, TimeoutError):return {"status": "timeout", "models": []}except (aiohttp.ClientError, ValueError, OSError):diff --git a/deeptutor/services/settings/service_preview.py b/deeptutor/services/settings/service_preview.pynew file mode 100644index 000000000..0c984069b--- /dev/null+++ b/deeptutor/services/settings/service_preview.py@@ -0,0 +1,160 @@+"""Draft-only functional checks, with real results and bounded lifetimes.++The HTTP stream owns the operation: disconnecting cancels local polling and+releases results. Remote generation may continue if a vendor has accepted it.+"""++from __future__ import annotations++import asyncio+import base64+import binascii+from collections.abc import AsyncIterator++from deeptutor.services.voice.discovery import selected_catalog++MAX_AUDIO_BYTES = 8 * 1024 * 1024+MAX_RESULT_BYTES = 40 * 1024 * 1024+AUDIO_TYPES = {+ "audio/wav": "sample.wav",+ "audio/x-wav": "sample.wav",+ "audio/mpeg": "sample.mp3",+ "audio/mp3": "sample.mp3",+ "audio/mp4": "sample.m4a",+ "audio/x-m4a": "sample.m4a",+ "audio/webm": "sample.webm",+ "audio/ogg": "sample.ogg",+ "audio/flac": "sample.flac",+}+++def validate_input(service: str, text: str, audio: str, content_type: str) -> bytes:+ if service not in {"search", "stt", "imagegen", "videogen"}:+ raise ValueError("Unsupported preview service.")+ if service != "stt":+ if not text.strip() or len(text) > 2000:+ raise ValueError("Enter between 1 and 2000 characters.")+ return b""+ if content_type not in AUDIO_TYPES:+ raise ValueError("Choose a WAV, MP3, M4A, WebM, OGG or FLAC audio file.")+ if len(audio) > ((MAX_AUDIO_BYTES + 2) // 3) * 4:+ raise ValueError("Audio samples must be at most 8 MB.")+ try:+ raw = base64.b64decode(audio, validate=True)+ except (ValueError, binascii.Error) as exc:+ raise ValueError("The audio sample could not be read.") from exc+ if not raw or len(raw) > MAX_AUDIO_BYTES:+ raise ValueError("Choose a non-empty audio sample of at most 8 MB.")+ return raw+++def media_result(raw: bytes, content_type: str, kind: str) -> dict:+ allowed = {+ "image": {"image/png", "image/jpeg", "image/webp", "image/gif"},+ "video": {"video/mp4", "video/webm", "video/quicktime"},+ }+ mime = content_type.split(";", 1)[0].strip().lower()+ if not raw or len(raw) > MAX_RESULT_BYTES or mime not in allowed[kind]:+ raise ValueError("Unsupported or oversized media result.")+ return {+ "type": "result",+ "kind": kind,+ "content_type": mime,+ "data": base64.b64encode(raw).decode("ascii"),+ }+++async def preview_events(+ catalog: dict,+ service: str,+ profile_id: str,+ model_id: str | None,+ text: str,+ audio: bytes = b"",+ content_type: str = "",+) -> AsyncIterator[dict]:+ catalog = selected_catalog(catalog, service, profile_id, model_id)+ queue: asyncio.Queue[dict] = asyncio.Queue(maxsize=16)++ async def progress(_message: str):+ # Upstream progress can contain signed URLs; expose only our own status.+ if queue.empty():+ queue.put_nowait({"type": "progress", "phase": "rendering"})++ async def execute() -> dict:+ if service == "search":+ from deeptutor.services.config.provider_runtime import resolve_search_runtime_config+ from deeptutor.services.settings.provider_probe import test_search_access++ config = resolve_search_runtime_config(catalog=catalog)+ result = await asyncio.to_thread(+ test_search_access,+ config.requested_provider,+ config.base_url,+ config.api_key,+ proxy=config.proxy or "",+ max_results=config.max_results,+ require_results=False,+ query=text,+ )+ rows = result.search_results or result.citations+ return {+ "type": "result",+ "kind": "search",+ "text": result.answer[:12000],+ "results": [+ {"title": r.title[:500], "url": r.url[:4000], "snippet": r.snippet[:2000]}+ for r in rows[:10]+ ],+ }+ if service == "stt":+ from deeptutor.services.voice import transcribe_audio++ transcript = await transcribe_audio(+ audio,+ catalog=catalog,+ filename=AUDIO_TYPES[content_type],+ content_type=content_type,+ )+ return {"type": "result", "kind": "transcript", "text": transcript[:24000]}+ if service == "imagegen":+ from deeptutor.services.imagegen import generate_image++ images = await generate_image(text, catalog=catalog, n=1)+ if not images:+ raise ValueError("No image returned.")+ return media_result(*images[0], "image")+ from deeptutor.services.videogen import generate_video++ video = await generate_video(text, catalog=catalog, progress=progress)+ return media_result(*video, "video")++ task = asyncio.create_task(execute())+ pending = None+ try:+ yield {"type": "progress", "phase": "requesting"}+ async with asyncio.timeout(600 if service == "videogen" else 120):+ while not task.done():+ pending = asyncio.create_task(queue.get())+ done, _ = await asyncio.wait(+ {task, pending}, timeout=10, return_when=asyncio.FIRST_COMPLETED+ )+ if pending in done:+ yield pending.result()+ else:+ pending.cancel()+ await asyncio.gather(pending, return_exceptions=True)+ if not task.done():+ yield {"type": "heartbeat"}+ pending = None+ yield await task+ except TimeoutError:+ yield {"type": "error", "code": "timeout"}+ except Exception:+ # Provider errors may include credentials, request bodies and signed URLs.+ yield {"type": "error", "code": "failed"}+ finally:+ task.cancel()+ if pending:+ pending.cancel()+ await asyncio.gather(task, *([pending] if pending else []), return_exceptions=True)diff --git a/deeptutor/services/task_board.py b/deeptutor/services/task_board.pyindex c140ca16c..4d2d72d46 100644--- a/deeptutor/services/task_board.py+++ b/deeptutor/services/task_board.py@@ -1,68 +1,100 @@-"""Workspace-local task cards with transactional, multi-worker-safe persistence."""+"""Account-owned tasks, workspace projections and durable conversation links."""from __future__ import annotationsfrom contextlib import closingfrom datetime import datetime, timezone+import jsonfrom pathlib import Pathimport sqlite3from typing import Annotated, Literal-from uuid import uuid4+from uuid import NAMESPACE_URL, uuid4, uuid5-from pydantic import BaseModel, ConfigDict, StringConstraints, field_validator+from pydantic import BaseModel, ConfigDict, Field, StringConstraints, field_validator-from deeptutor.services.path_service import get_path_servicefrom deeptutor.utils.secret_files import ensure_private_directoryTaskStatus = Literal["todo", "doing", "done"]TaskTitle = Annotated[str, StringConstraints(strip_whitespace=True, min_length=1, max_length=160)]TaskNote = Annotated[str, StringConstraints(max_length=2000)]+TaskColor = Annotated[str, StringConstraints(pattern=r"^#[0-9a-fA-F]{6}$")]-class CreateCard(BaseModel):- """A learner-authored task; identifiers and timestamps are server-owned."""+class StatusColors(BaseModel):+ model_config = ConfigDict(extra="forbid")+ todo: TaskColor = "#2563eb"+ doing: TaskColor = "#a16207"+ done: TaskColor = "#15803d"++class CreateCard(BaseModel):model_config = ConfigDict(extra="forbid")title: TaskTitlenote: TaskNote = ""class UpdateCard(BaseModel):- """Only supplied fields change, preserving concurrent edits to other fields."""-model_config = ConfigDict(extra="forbid")title: TaskTitle | None = Nonenote: TaskNote | None = Nonestatus: TaskStatus | None = Nonearchived: bool | None = None+ # None = unassigned; empty string = the default conversation workspace.+ workspace_id: str | None = Field(default=None, max_length=200)@field_validator("title", "note", "status", "archived", mode="before")@classmethoddef reject_null(cls, value: object) -> object:- """Omission is allowed; explicitly clearing a required field is not."""if value is None:raise ValueError("Card fields cannot be null.")return valueclass TaskCard(CreateCard):- """Persisted card returned to the board, including archived cards."""-id: strstatus: TaskStatusarchived: boolcreated_at: strupdated_at: str+ workspace_id: str | None = None-class TaskBoard(BaseModel):- """A consistent snapshot of the current workspace's board."""+class SessionTaskLinks(BaseModel):+ workspace_id: str+ session_id: str+ # Ordered by association time; the last element controls the idle mark.+ task_ids: list[str] = Field(default_factory=list)+ status_link_enabled: bool = True++class TaskBoard(BaseModel):cards: list[TaskCard]+ colors: StatusColors = Field(default_factory=StatusColors)+ session_links: list[SessionTaskLinks] = Field(default_factory=list)+ revision: int = 0+++class LinkTasks(BaseModel):+ model_config = ConfigDict(extra="forbid")+ workspace_id: str = Field(default="", max_length=200)+ task_ids: list[str] = Field(max_length=100)++ @field_validator("task_ids")+ @classmethod+ def unique_ids(cls, value: list[str]) -> list[str]:+ if any(not item or len(item) > 200 for item in value):+ raise ValueError("Invalid task identifier.")+ return list(dict.fromkeys(value))+++class LinkStatus(BaseModel):+ model_config = ConfigDict(extra="forbid")+ workspace_id: str = Field(default="", max_length=200)+ enabled: boolclass TaskBoardStore:- """Open short-lived SQLite connections; never cache a user's active scope."""+ """SQLite is the shared authority across tabs, workspaces and API workers."""def __init__(self, path: Path):self.path = path@@ -71,69 +103,329 @@ class TaskBoardStore:ensure_private_directory(self.path.parent)connection = sqlite3.connect(self.path, timeout=10)connection.row_factory = sqlite3.Row+ connection.execute("PRAGMA foreign_keys = ON")+ connection.executescript("""+ CREATE TABLE IF NOT EXISTS cards (+ id TEXT PRIMARY KEY, title TEXT NOT NULL, note TEXT NOT NULL DEFAULT '',+ status TEXT NOT NULL CHECK(status IN ('todo','doing','done')),+ archived INTEGER NOT NULL DEFAULT 0 CHECK(archived IN (0,1)),+ created_at TEXT NOT NULL, updated_at TEXT NOT NULL, workspace_id TEXT+ );+ CREATE TABLE IF NOT EXISTS board_state (+ id INTEGER PRIMARY KEY CHECK(id=1), revision INTEGER NOT NULL,+ colors TEXT NOT NULL+ );+ CREATE TABLE IF NOT EXISTS session_task_status (+ workspace_id TEXT NOT NULL, session_id TEXT NOT NULL,+ enabled INTEGER NOT NULL DEFAULT 1,+ PRIMARY KEY(workspace_id, session_id)+ );+ CREATE TABLE IF NOT EXISTS session_tasks (+ association_id INTEGER PRIMARY KEY AUTOINCREMENT,+ workspace_id TEXT NOT NULL, session_id TEXT NOT NULL,+ task_id TEXT NOT NULL REFERENCES cards(id),+ UNIQUE(workspace_id, session_id, task_id)+ );+ CREATE TABLE IF NOT EXISTS legacy_imports (+ source TEXT NOT NULL, legacy_id TEXT NOT NULL, task_id TEXT NOT NULL,+ PRIMARY KEY(source, legacy_id)+ );+ """)+ if "workspace_id" not in {row[1] for row in connection.execute("PRAGMA table_info(cards)")}:+ try:+ connection.execute("ALTER TABLE cards ADD COLUMN workspace_id TEXT")+ except sqlite3.OperationalError:+ if "workspace_id" not in {+ row[1] for row in connection.execute("PRAGMA table_info(cards)")+ }:+ connection.close()+ raiseconnection.execute(- """CREATE TABLE IF NOT EXISTS cards (- id TEXT PRIMARY KEY,- title TEXT NOT NULL,- note TEXT NOT NULL DEFAULT '',- status TEXT NOT NULL CHECK(status IN ('todo', 'doing', 'done')),- archived INTEGER NOT NULL DEFAULT 0 CHECK(archived IN (0, 1)),- created_at TEXT NOT NULL,- updated_at TEXT NOT NULL- )"""+ "INSERT OR IGNORE INTO board_state VALUES (1,0,?)",+ (StatusColors().model_dump_json(),),)+ connection.commit()return connection+ @staticmethod+ def _changed(connection: sqlite3.Connection) -> None:+ connection.execute("UPDATE board_state SET revision=revision+1 WHERE id=1")+@staticmethoddef _snapshot(connection: sqlite3.Connection) -> TaskBoard:- rows = connection.execute("SELECT * FROM cards ORDER BY created_at, id")- return TaskBoard(cards=[TaskCard.model_validate(dict(row)) for row in rows])+ rows = connection.execute("SELECT * FROM cards ORDER BY created_at,id")+ cards = [TaskCard.model_validate(dict(row)) for row in rows]+ links = {+ (row["workspace_id"], row["session_id"]): SessionTaskLinks(+ workspace_id=row["workspace_id"],+ session_id=row["session_id"],+ status_link_enabled=bool(row["enabled"]),+ )+ for row in connection.execute(+ "SELECT * FROM session_task_status ORDER BY workspace_id,session_id"+ )+ }+ for row in connection.execute("SELECT * FROM session_tasks ORDER BY association_id"):+ key = (row["workspace_id"], row["session_id"])+ if key not in links:+ links[key] = SessionTaskLinks(workspace_id=key[0], session_id=key[1])+ links[key].task_ids.append(row["task_id"])+ state = connection.execute("SELECT * FROM board_state WHERE id=1").fetchone()+ return TaskBoard(+ cards=cards,+ colors=StatusColors.model_validate_json(state["colors"]),+ session_links=list(links.values()),+ revision=state["revision"],+ )def read(self) -> TaskBoard:- """Read cards without creating storage for an unused board."""if not self.path.exists():return TaskBoard(cards=[])- with closing(self._connect()) as connection:+ with closing(self._connect()) as connection, connection:+ # All SELECTs share a snapshot, even while another worker commits.+ connection.execute("BEGIN")return self._snapshot(connection)+ def revision(self) -> int:+ """A cheap event-stream probe; unchanged boards need no snapshot assembly."""+ if not self.path.exists():+ return 0+ with closing(sqlite3.connect(self.path, timeout=10)) as connection:+ try:+ row = connection.execute("SELECT revision FROM board_state WHERE id=1").fetchone()+ except sqlite3.OperationalError as exc:+ if "no such table" not in str(exc):+ raise+ return 0+ return row[0] if row else 0+def create(self, payload: CreateCard) -> TaskBoard:- """Add a task and return the snapshot committed by this transaction."""now = datetime.now(timezone.utc).isoformat()with closing(self._connect()) as connection, connection:+ connection.execute("BEGIN IMMEDIATE")connection.execute(- "INSERT INTO cards VALUES (?, ?, ?, 'todo', 0, ?, ?)",+ "INSERT INTO cards (id,title,note,status,archived,created_at,updated_at) VALUES (?,?,?,'todo',0,?,?)",(uuid4().hex, payload.title, payload.note, now, now),)+ self._changed(connection)return self._snapshot(connection)def update(self, card_id: str, payload: UpdateCard) -> TaskBoard:- """Edit, move, archive or restore a card atomically; fail if absent."""if not self.path.exists():raise KeyError(card_id)changes = payload.model_dump(exclude_unset=True)with closing(self._connect()) as connection, connection:- # Serialize the read/modify/write across processes as well as threads.connection.execute("BEGIN IMMEDIATE")- row = connection.execute("SELECT * FROM cards WHERE id = ?", (card_id,)).fetchone()+ row = connection.execute("SELECT * FROM cards WHERE id=?", (card_id,)).fetchone()if row is None:raise KeyError(card_id)- card = TaskCard.model_validate(dict(row))- updated = TaskCard.model_validate({**card.model_dump(), **changes})+ updated = TaskCard.model_validate({**dict(row), **changes})connection.execute(- """UPDATE cards SET title = ?, note = ?, status = ?, archived = ?,- updated_at = ? WHERE id = ?""",+ "UPDATE cards SET title=?,note=?,status=?,archived=?,workspace_id=?,updated_at=? WHERE id=?",(updated.title,updated.note,updated.status,updated.archived,+ updated.workspace_id,datetime.now(timezone.utc).isoformat(),card_id,),)+ self._changed(connection)+ return self._snapshot(connection)++ def set_colors(self, colors: StatusColors) -> TaskBoard:+ with closing(self._connect()) as connection, connection:+ connection.execute("BEGIN IMMEDIATE")+ connection.execute(+ "UPDATE board_state SET colors=? WHERE id=1", (colors.model_dump_json(),)+ )+ self._changed(connection)+ return self._snapshot(connection)++ def link_tasks(self, session_id: str, payload: LinkTasks) -> TaskBoard:+ with closing(self._connect()) as connection, connection:+ connection.execute("BEGIN IMMEDIATE")+ existing = {+ row[0]+ for row in connection.execute(+ "SELECT task_id FROM session_tasks WHERE workspace_id=? AND session_id=?",+ (payload.workspace_id, session_id),+ )+ }+ for task_id in payload.task_ids:+ row = connection.execute(+ "SELECT archived FROM cards WHERE id=?", (task_id,)+ ).fetchone()+ if row is None or (row["archived"] and task_id not in existing):+ raise KeyError(task_id)+ for task_id in existing - set(payload.task_ids):+ connection.execute(+ "DELETE FROM session_tasks WHERE workspace_id=? AND session_id=? AND task_id=?",+ (payload.workspace_id, session_id, task_id),+ )+ for task_id in payload.task_ids:+ if task_id not in existing:+ connection.execute(+ "INSERT INTO session_tasks (workspace_id,session_id,task_id) VALUES (?,?,?)",+ (payload.workspace_id, session_id, task_id),+ )+ if set(payload.task_ids) - existing:+ # Explicitly linking another task opts the session back into status sync.+ connection.execute(+ "INSERT INTO session_task_status VALUES (?,?,1) ON CONFLICT(workspace_id,session_id) DO UPDATE SET enabled=1",+ (payload.workspace_id, session_id),+ )+ self._changed(connection)return self._snapshot(connection)+ def link_status(self, session_id: str, payload: LinkStatus) -> TaskBoard:+ with closing(self._connect()) as connection, connection:+ connection.execute("BEGIN IMMEDIATE")+ connection.execute(+ "INSERT INTO session_task_status VALUES (?,?,?) ON CONFLICT(workspace_id,session_id) DO UPDATE SET enabled=excluded.enabled",+ (payload.workspace_id, session_id, payload.enabled),+ )+ self._changed(connection)+ return self._snapshot(connection)++ def move_session_links(self, session_ids: list[str], source: str, target: str) -> None:+ if not session_ids or not self.path.exists() or source == target:+ return+ with closing(self._connect()) as connection, connection:+ connection.execute("BEGIN IMMEDIATE")+ for sid in session_ids:+ for table in ("session_tasks", "session_task_status"):+ connection.execute(+ f"UPDATE {table} SET workspace_id=? WHERE workspace_id=? AND session_id=?",+ (target, source, sid),+ )+ self._changed(connection)++ def remove_session(self, workspace_id: str, session_id: str) -> None:+ if not self.path.exists():+ return+ with closing(self._connect()) as connection, connection:+ connection.execute("BEGIN IMMEDIATE")+ for table in ("session_tasks", "session_task_status"):+ connection.execute(+ f"DELETE FROM {table} WHERE workspace_id=? AND session_id=?",+ (workspace_id, session_id),+ )+ self._changed(connection)++ def import_legacy(self, source: Path, workspace_id: str) -> None:+ """Copy old cards once, preserving the original stores as recoverable backups."""+ if (+ not source.is_file()+ or source.is_symlink()+ or source.parent.is_symlink()+ or source == self.path+ ):+ return+ with closing(sqlite3.connect(f"{source.as_uri()}?mode=ro", uri=True)) as legacy:+ legacy.row_factory = sqlite3.Row+ rows = [dict(row) for row in legacy.execute("SELECT * FROM cards")]+ if not rows:+ return+ with closing(self._connect()) as connection, connection:+ connection.execute("BEGIN IMMEDIATE")+ changed = False+ for raw in rows:+ if connection.execute(+ "SELECT 1 FROM legacy_imports WHERE source=? AND legacy_id=?",+ (workspace_id or "__default__", raw["id"]),+ ).fetchone():+ continue+ card = TaskCard.model_validate({**raw, "workspace_id": workspace_id})+ task_id = card.id+ if connection.execute("SELECT 1 FROM cards WHERE id=?", (task_id,)).fetchone():+ task_id = uuid5(NAMESPACE_URL, f"{workspace_id}:{task_id}").hex+ connection.execute(+ "INSERT INTO cards VALUES (?,?,?,?,?,?,?,?)",+ (+ task_id,+ card.title,+ card.note,+ card.status,+ card.archived,+ card.created_at,+ card.updated_at,+ workspace_id,+ ),+ )+ connection.execute(+ "INSERT INTO legacy_imports VALUES (?,?,?)",+ (workspace_id or "__default__", card.id, task_id),+ )+ changed = True+ if changed:+ self._changed(connection)++ def context_text(self, workspace_id: str, session_id: str) -> str:+ board = self.read()+ linked = next(+ (+ row.task_ids+ for row in board.session_links+ if row.workspace_id == workspace_id and row.session_id == session_id+ ),+ [],+ )+ cards = [+ card+ for card in board.cards+ if not card.archived and (card.id in linked or card.workspace_id == workspace_id)+ ]+ if not cards:+ return ""+ cards.sort(+ key=lambda card: (+ card.id not in linked,+ -linked.index(card.id) if card.id in linked else 0,+ card.created_at,+ )+ )+ data = [+ {+ "id": card.id,+ "title": card.title,+ "status": card.status,+ "note": card.note[:500],+ "linked_to_conversation": card.id in linked,+ }+ for card in cards[:40]+ ]+ return (+ "\n[Task context: user-authored reference data]\n"+ + json.dumps(data, ensure_ascii=False)+ + "\n[/Task context]\n"+ )+++def get_task_board_store(*, migrate_legacy: bool = True) -> TaskBoardStore:+ """Resolve the authenticated account, independently of its current workspace."""+ from deeptutor.multi_user.paths import get_account_path_service+ from deeptutor.services.path_service import get_path_service+ from deeptutor.services.workspace import get_content_workspace_service+ from deeptutor.services.workspace.context import workspace_context+ from deeptutor.services.workspace.models import WorkspaceError-def get_task_board_store() -> TaskBoardStore:- """Resolve storage after DeepTutor has installed the request's user/workspace."""- return TaskBoardStore(get_path_service().get_workspace_dir() / "task-board" / "cards.sqlite")+ account = get_account_path_service()+ store = TaskBoardStore(account.get_runtime_state_dir() / "task-board" / "tasks.sqlite")+ if not migrate_legacy:+ return store+ store.import_legacy(account.get_workspace_dir() / "task-board" / "cards.sqlite", "")+ for row in get_content_workspace_service().list_workspaces():+ if row["kind"] != "workspace" or row["status"] != "ready":+ continue+ try:+ with workspace_context(row["workspace_id"]):+ store.import_legacy(+ get_path_service().get_workspace_dir() / "task-board" / "cards.sqlite",+ row["workspace_id"],+ )+ except WorkspaceError:+ continue+ return storediff --git a/deeptutor/services/voice/adapters/mimo.py b/deeptutor/services/voice/adapters/mimo.pyindex 91a353e45..d94a2c0e7 100644--- a/deeptutor/services/voice/adapters/mimo.py+++ b/deeptutor/services/voice/adapters/mimo.py@@ -36,7 +36,7 @@ class MiMoTTSAdapter(BaseTTSAdapter):payload = {"model": config.model,"messages": messages,- "audio": {"format": audio_format, "voice": config.voice or "mimo_default"},+ "audio": {"format": audio_format, "voice": config.voice},"stream": False,}headers = {diff --git a/deeptutor/services/voice/adapters/openai_compat.py b/deeptutor/services/voice/adapters/openai_compat.pyindex ed1a101da..9ee56e147 100644--- a/deeptutor/services/voice/adapters/openai_compat.py+++ b/deeptutor/services/voice/adapters/openai_compat.py@@ -219,7 +219,7 @@ class OpenRouterTTSAdapter(BaseTTSAdapter):],"modalities": ["text", "audio"],"audio": {- "voice": config.voice or "alloy",+ "voice": config.voice,"format": audio_format,},"stream": True,diff --git a/deeptutor/services/voice/discovery.py b/deeptutor/services/voice/discovery.pynew file mode 100644index 000000000..8e2cb3c2a--- /dev/null+++ b/deeptutor/services/voice/discovery.py@@ -0,0 +1,183 @@+"""Live voice discovery. No bundled voice IDs, guessed endpoints or static fallback.++MiniMax: https://platform.minimax.io/docs/api-reference/voice-management-get+DashScope: https://help.aliyun.com/en/model-studio/voice-clone-design-http-api+Only the selected connection is contacted; credentials never leave its host.+"""++from __future__ import annotations++import asyncio+from copy import deepcopy+from urllib.parse import urlsplit, urlunsplit++import httpx++from deeptutor.services.config.provider_runtime import resolve_tts_runtime_config+++class VoiceDiscoveryError(ValueError):+ """A public, credential-free failure message."""+++def selected_catalog(catalog: dict, service: str, profile_id: str, model_id: str | None) -> dict:+ snapshot = deepcopy(catalog)+ bucket = snapshot.get("services", {}).get(service, {})+ profile = next((p for p in bucket.get("profiles", []) if p.get("id") == profile_id), None)+ if profile is None or (+ service != "search" and not any(m.get("id") == model_id for m in profile.get("models", []))+ ):+ raise ValueError("The selected service configuration no longer exists.")+ bucket["active_profile_id"], bucket["active_model_id"] = profile_id, model_id+ return snapshot+++def discovery_url(base: str, provider: str) -> str:+ parsed = urlsplit(base)+ if (+ parsed.scheme not in {"https", "http"}+ or not parsed.hostname+ or parsed.username+ or parsed.password+ ):+ raise VoiceDiscoveryError("Check the provider URL before fetching voices.")+ path = parsed.path.rstrip("/")+ if provider == "minimax":+ if path.endswith("/t2a_v2"):+ path = path[: -len("/t2a_v2")]+ path += "/get_voice"+ else:+ if path == "/compatible-mode/v1" and (parsed.hostname.endswith(".aliyuncs.com")):+ path = "/api/v1"+ for suffix in (+ "/services/aigc/multimodal-generation/generation",+ "/services/audio/tts/SpeechSynthesizer",+ ):+ if path.endswith(suffix):+ path = path[: -len(suffix)]+ path += "/services/audio/tts/customization"+ return urlunsplit(parsed._replace(path=path, query="", fragment=""))+++async def discover_voices(catalog: dict, profile_id: str, model_id: str) -> dict:+ config = resolve_tts_runtime_config(selected_catalog(catalog, "tts", profile_id, model_id))+ provider = config.provider_name+ # A vendor's speech API key is not permission to call its separately signed+ # control plane. Never fabricate a generic /voices API for compatible hosts.+ if provider not in {"minimax", "dashscope"}:+ return {"status": "unsupported", "voices": [], "scope": "none"}+ native = config.model.startswith(("cosyvoice-", "qwen-audio-"))+ qwen_custom = config.model.startswith("qwen") and any(+ x in config.model for x in ("-vc-", "-vd-")+ )+ if provider == "dashscope" and not (native or qwen_custom):+ return {"status": "unsupported", "voices": [], "scope": "none"}+ if not config.api_key or config.api_key == "***":+ raise VoiceDiscoveryError("Enter provider credentials before fetching voices.")+ url = discovery_url(config.base_url, provider)+ headers = {**config.extra_headers, "Authorization": f"Bearer {config.api_key}"}+ voices: dict[str, dict] = {}++ async def post(client, body):+ response = await client.post(url, headers=headers, json=body)+ if response.status_code in (401, 403):+ raise VoiceDiscoveryError(+ "Voice access was denied. Check credentials, region and permissions."+ )+ response.raise_for_status()+ data = response.json()+ if not isinstance(data, dict) or data.get("code") not in (None, "", 0, "0"):+ raise VoiceDiscoveryError(+ "The provider rejected voice discovery. Check the model and region."+ )+ return data++ def add(identifier, label=None, language=None):+ if not isinstance(identifier, str) or not identifier.strip():+ return+ voices[identifier] = {+ "id": identifier,+ "label": label or identifier,+ **({"languages": [language]} if isinstance(language, str) and language else {}),+ }++ try:+ async with (+ asyncio.timeout(25),+ httpx.AsyncClient(timeout=10, follow_redirects=False) as client,+ ):+ if provider == "minimax":+ data = await post(client, {"voice_type": "all"})+ if data.get("base_resp", {}).get("status_code") != 0:+ raise VoiceDiscoveryError(+ "The provider rejected voice discovery. Check credentials and permissions."+ )+ if not any(+ isinstance(data.get(k), list)+ for k in ("system_voice", "voice_cloning", "voice_generation")+ ):+ raise VoiceDiscoveryError("The provider returned an invalid voice list.")+ for group in ("system_voice", "voice_cloning", "voice_generation"):+ for row in data.get(group) or []:+ if isinstance(row, dict):+ add(row.get("voice_id"), row.get("voice_name"))+ scope = "account"+ else:+ enrollment = "voice-enrollment" if native else "qwen-voice-enrollment"+ seen: set[str] = set()+ for page in range(100):+ data = await post(+ client,+ {+ "model": enrollment,+ "input": {+ "action": "list_voice" if native else "list",+ "page_index": page,+ "page_size": 100,+ },+ },+ )+ rows = data.get("output", {}).get("voice_list")+ if not isinstance(rows, list):+ raise VoiceDiscoveryError("The provider returned an invalid voice list.")+ for row in rows:+ if not isinstance(row, dict):+ raise VoiceDiscoveryError(+ "The provider returned an invalid voice list."+ )+ identifier = row.get("voice_id") or row.get("voice")+ if not isinstance(identifier, str) or identifier in seen:+ raise VoiceDiscoveryError(+ "The provider returned an invalid or repeated voice page."+ )+ seen.add(identifier)+ if native:+ if row.get("status") != "OK":+ continue+ detail = await post(+ client,+ {+ "model": enrollment,+ "input": {"action": "query_voice", "voice_id": identifier},+ },+ )+ row = {**row, **detail.get("output", {})}+ if (+ row.get("target_model") == config.model+ and row.get("status", "OK") == "OK"+ ):+ add(identifier, language=row.get("language"))+ if len(rows) < 100:+ break+ else:+ raise VoiceDiscoveryError(+ "The voice list is too large. Please enter a voice ID manually."+ )+ scope = "custom"+ return {"status": "ready", "scope": scope, "voices": list(voices.values())}+ except VoiceDiscoveryError:+ raise+ except (httpx.HTTPError, TimeoutError, ValueError, TypeError, AttributeError) as exc:+ raise VoiceDiscoveryError(+ "Could not fetch voices. Check the connection and try again."+ ) from excdiff --git a/deeptutor/services/voice/options.py b/deeptutor/services/voice/options.pyindex 0b6e0a612..f659c10af 100644--- a/deeptutor/services/voice/options.py+++ b/deeptutor/services/voice/options.py@@ -1,8 +1,8 @@-"""Speech configuration hints, shared by settings and runtime defaults.+"""Speech parameter hints, shared by settings and runtime defaults.-These are curated suggestions, not an exhaustive entitlement/model inventory.-Unknown models and private voices remain editable. Match the model family before-suggesting voices: a gateway's vendor name alone does not identify its TTS API.+Voice IDs are never bundled here. They are discovered live by voice.discovery.+These model/parameter hints are not an exhaustive entitlement/model inventory.+Unknown models and private voices remain editable.Sources checked 2026-09-17 are included in each provider's public metadata."""@@ -20,13 +20,6 @@ def is_qwen_audio_tts(model: str) -> bool:return model.startswith("qwen-audio-") and "-tts-" in model-OPENAI_VOICES = choices(- "alloy ash ballad coral echo fable nova onyx sage shimmer verse marin cedar".split()-)-LEGACY_OPENAI_VOICES = choices("alloy ash coral echo fable onyx nova sage shimmer".split())-GEMINI_VOICES = choices(- "Kore Puck Charon Fenrir Aoede Leda Orus Zephyr Achernar Achird Algenib Algieba Alnilam Autonoe Callirrhoe Despina Enceladus Erinome Gacrux Iapetus Laomedeia Pulcherrima Rasalgethi Sadachbia Sadaltager Schedar Sulafat Umbriel Vindemiatrix Zubenelgenubi".split()-)ISO_LANGUAGES = choices("zh en ja ko de fr es pt it ru ar id".split())VOLC_LANGUAGES = choices("zh-CN en-US ja-JP id-ID es-MX pt-BR de-DE fr-FR ko-KR fil-PH ms-MY th-TH ar-SA it-IT bn-BD el-GR nl-NL ru-RU tr-TR vi-VN pl-PL ro-RO ne-NP uk-UA yue-CN".split()@@ -34,11 +27,11 @@ VOLC_LANGUAGES = choices(OPENAI_FORMATS = ["mp3", "wav", "opus", "aac", "flac", "pcm"]-def preset(model: str, *, voices=None, languages=None, formats=None, **kwargs) -> dict:+def preset(model: str, *, languages=None, formats=None, **kwargs) -> dict:return {"id": model,"label": model,- "voices": voices or [],+ "voices": [],"languages": languages or [],"formats": formats or [],**kwargs,@@ -50,9 +43,6 @@ def _tts_models(provider: str) -> tuple[list[dict], str]:return [preset("mimo-v2.5-tts",- voices=choices(- ["mimo_default", "冰糖", "茉莉", "苏打", "白桦", "Mia", "Chloe", "Milo", "Dean"]- ),formats=["wav", "pcm16"],instructions=True,)@@ -61,7 +51,6 @@ def _tts_models(provider: str) -> tuple[list[dict], str]:return [preset(model,- voices=choices(["English_expressive_narrator"]),languages=choices(["auto", "Chinese", "English"]),formats=["mp3", "wav", "flac", "pcm"],sample_rates=[8000, 16000, 22050, 24000, 32000, 44100],@@ -81,7 +70,6 @@ def _tts_models(provider: str) -> tuple[list[dict], str]:openai = [preset("gpt-4o-mini-tts",- voices=OPENAI_VOICES,formats=OPENAI_FORMATS,speed={"min": 0.25, "max": 4, "step": 0.05},instructions=True,@@ -89,7 +77,6 @@ def _tts_models(provider: str) -> tuple[list[dict], str]:*[preset(m,- voices=LEGACY_OPENAI_VOICES,formats=OPENAI_FORMATS,speed={"min": 0.25, "max": 4, "step": 0.05},)@@ -103,7 +90,7 @@ def _tts_models(provider: str) -> tuple[list[dict], str]:model["id"] = model["label"] = "openai/" + model["id"]# Additional gateway model IDs can still be entered manually.return openai + [- preset(m, voices=GEMINI_VOICES, formats=["wav", "mp3", "pcm"])+ preset(m, formats=["wav", "mp3", "pcm"])for m in ["google/gemini-2.5-flash-preview-tts","google/gemini-2.5-pro-preview-tts",@@ -111,47 +98,9 @@ def _tts_models(provider: str) -> tuple[list[dict], str]:]], "https://openrouter.ai/docs/guides/overview/multimodal/audio"if provider == "volcengine_speech":- v2 = [- {- "id": "zh_female_vv_uranus_bigtts",- "label": "Vivi 2.0",- "languages": ["zh-cn", "en", "ja", "id", "es-mx"],- },- {- "id": "zh_female_xiaohe_uranus_bigtts",- "label": "小何 2.0",- "languages": ["zh-cn", "en"],- },- {"id": "zh_male_m191_uranus_bigtts", "label": "云舟 2.0", "languages": ["zh-cn", "en"]},- {- "id": "zh_male_taocheng_uranus_bigtts",- "label": "小天 2.0",- "languages": ["zh-cn", "en"],- },- {- "id": "zh_female_yingyujiaoxue_uranus_bigtts",- "label": "Tina老师 2.0",- "languages": ["zh-cn", "en"],- },- {"id": "en_male_tim_uranus_bigtts", "label": "Tim", "languages": ["en"]},- {"id": "en_female_dacey_uranus_bigtts", "label": "Dacey", "languages": ["en"]},- ]- v1 = [- {- "id": "zh_female_shuangkuaisisi_moon_bigtts",- "label": "爽快思思",- "languages": ["zh-cn", "en"],- },- {- "id": "zh_male_wennuanahu_moon_bigtts",- "label": "温暖阿虎",- "languages": ["zh-cn", "en"],- },- ]return [preset(m,- voices=v2 if m == "seed-tts-2.0" else v1,languages=choices(["zh-cn", "en", "ja", "id", "es-mx"]),formats=["mp3", "wav", "ogg_opus", "pcm"],sample_rates=[8000, 16000, 22050, 24000, 32000, 44100, 48000],@@ -161,60 +110,22 @@ def _tts_models(provider: str) -> tuple[list[dict], str]:for m in ["seed-tts-2.0", "seed-tts-1.0", "seed-tts-1.0-concurr"]], "https://www.volcengine.com/docs/6561/1257544"if provider == "dashscope":- # The September 2025 snapshot has fewer voices than current Flash.- qwen_voices = [- {"id": "Cherry", "label": "芊悦 · Cherry"},- {"id": "Serena", "label": "苏瑶 · Serena"},- {"id": "Ethan", "label": "晨煦 · Ethan"},- {"id": "Chelsie", "label": "千雪 · Chelsie"},- {"id": "Momo", "label": "茉兔 · Momo"},- {"id": "Kai", "label": "凯 · Kai"},- ]qwen_models = [preset(m,- voices=[v for v in qwen_voices if v["id"] in {"Cherry", "Ethan"}]- if m.endswith("2025-09-18")- else qwen_voices,languages=choices("Auto Chinese English German Italian Portuguese Spanish Japanese Korean French Russian".split()),formats=["wav"],instructions="instruct" in m,- configuration_note="Qwen3 TTS uses voices such as Cherry and outputs WAV audio. Match the API key region to the provider URL.",+ configuration_note="Qwen3 TTS outputs WAV audio. Match the API key region to the provider URL.",)for m in ["qwen3-tts-flash", "qwen3-tts-instruct-flash", "qwen3-tts-flash-2025-09-18"]]- audio_voices = {- "qwen-audio-3.0-tts-plus": [- {- "id": "longanlingxin",- "label": "龙安灵心 · longanlingxin",- "languages": ["zh", "en"],- },- {- "id": "longanlufeng",- "label": "龙安鲁风 · longanlufeng",- "languages": ["zh", "en"],- },- ],- "qwen-audio-3.0-tts-flash": [- {- "id": "longanfengyue",- "label": "龙安风悦 · longanfengyue",- "languages": ["zh", "en"],- },- {- "id": "longanhuan_v3.6",- "label": "龙安欢 · longanhuan_v3.6",- "languages": ["zh", "en"],- },- ],- }+ audio_models = ["qwen-audio-3.0-tts-plus", "qwen-audio-3.0-tts-flash"]return qwen_models + [preset(m,- voices=voices,languages=choices(["zh", "en"]),formats=["mp3", "wav", "opus", "pcm"],sample_rates=[8000, 12000, 16000, 24000, 48000],@@ -223,20 +134,18 @@ def _tts_models(provider: str) -> tuple[list[dict], str]:configuration_note="Qwen-Audio TTS requires a Beijing API key. You can set a Beijing workspace URL in the provider connection; the speech endpoint is selected automatically.",docs_url="https://help.aliyun.com/zh/model-studio/qwen-audio-tts-voice-list",)- for m, voices in audio_voices.items()+ for m in audio_models], "https://help.aliyun.com/zh/model-studio/qwen-tts-voice-list"if provider == "groq":return [preset("canopylabs/orpheus-v1-english",- voices=choices(["autumn", "diana", "hannah", "austin", "daniel", "troy"]),max_input_chars=200,formats=["wav"],language_note="English; vocal directions go in the spoken text.",),preset("canopylabs/orpheus-arabic-saudi",- voices=choices(["abdullah", "fahad", "sultan", "lulwa", "noura", "aisha"]),max_input_chars=200,formats=["wav"],language_note="Saudi Arabic; enter a voice ID from the provider documentation.",@@ -247,10 +156,6 @@ def _tts_models(provider: str) -> tuple[list[dict], str]:return [preset(siliconflow_model,- voices=[- {"id": f"{siliconflow_model}:{v}", "label": v}- for v in "alex benjamin charles david anna bella claire diana".split()- ],formats=["mp3", "wav", "opus", "pcm"],language_note="Language follows the text and selected voice. Custom speech: voice IDs are accepted.",)diff --git a/deeptutor/services/workspace/data_migration.py b/deeptutor/services/workspace/data_migration.pyindex 197d403f0..eb1b2e4c5 100644--- a/deeptutor/services/workspace/data_migration.py+++ b/deeptutor/services/workspace/data_migration.py@@ -32,7 +32,6 @@ FEATURES = {"reading": "Immersive Reading","timed_media": "Immersive Watching","notebook": "Notebooks",- "task-board": "Task Board","co-writer": "Writing","courses": "Courses","files": "File library",@@ -675,6 +674,11 @@ def migrate_data(original.unlink()else:shutil.rmtree(original)+ from deeptutor.services.task_board import get_task_board_store++ get_task_board_store(migrate_legacy=False).move_session_links(+ plan["session_ids"], source_id, target_id+ )result["status"] = "completed"atomic_write_json(journal, result)_clear_store_caches()@@ -966,6 +970,11 @@ def recover_operation(operation_id: str) -> dict:original.unlink()else:shutil.rmtree(original)+ from deeptutor.services.task_board import get_task_board_store++ get_task_board_store(migrate_legacy=False).move_session_links(+ plan["session_ids"], plan["source_workspace_id"], plan["target_workspace_id"]+ )result["status"] = "completed"else:if result["status"] in {"transferring", "recovery_required"}:diff --git a/deeptutor_cli/README.md b/deeptutor_cli/README.mdindex 98a90add0..dc3b5e1a4 100644--- a/deeptutor_cli/README.md+++ b/deeptutor_cli/README.md@@ -69,7 +69,7 @@ deeptutor run <capability> <message> [options]| 选项 | 缩写 | 说明 ||------|------|------|-| `--tool` | `-t` | 启用工具(可多次指定):`rag`, `web_search`, `exec`, `reason`, `brainstorm`, `paper_search`, `geogebra_analysis`, `imagegen`, `videogen` |+| `--tool` | `-t` | 启用工具(可多次指定):`web_search`, `reason`, `brainstorm`, `paper_search`, `geogebra_analysis`, `imagegen`, `videogen`;RAG 通过 `--kb` 挂载 || `--kb` | | 挂载知识库 || `--language` | `-l` | 回复语言(默认 `en`) || `--session` | | 继续已有会话 |@@ -86,7 +86,7 @@ deeptutor run <capability> <message> [options]deeptutor run chat "什么是傅里叶变换?" -l zh# 深度解题-deeptutor run deep_solve "证明 n^3-n 能被 6 整除" -t rag --kb math-textbook+deeptutor run deep_solve "证明 n^3-n 能被 6 整除" --kb math-textbook# 简要回答deeptutor run deep_solve "求 sin(x) 的导数" --config detailed_answer=false@@ -218,9 +218,30 @@ deeptutor plugin info <name> # 查看详情### `config` — 配置```bash-deeptutor config show+deeptutor config show [--home PATH] # 查看配置(隐藏凭据)+deeptutor config providers # JSON:支持的提供方和默认端点+deeptutor config apply setup.json --check # 无写入、无网络请求的预校验+deeptutor config apply setup.json [--home PATH] # 无交互应用配置```+让外部 Agent 配置 DeepTutor 时,先阅读根目录的 [SKILL.md](../SKILL.md),再按+[Agent Setup 指南](../docs-for-user/AGENT_SETUP.md) 完成安装、配置、启动和验证。+`deeptutor init --non-interactive [--home PATH]` 只创建缺失的默认设置,不询问参数、+不选择模型,也不会覆盖已有设置。CLI-only 可以同时加 `--cli`。++`config apply` 接受 JSON 中的 `llm`、`embedding`、`search`、`system` 配置段;+具体字段见指南。通过 `api_key_env` 引用进程环境中的凭据,不接受明文 `api_key`。+它会更新并选中对应服务的 Agent Setup profile,保留其他 profile 和未提供的设置,+重复应用不会创建重复 profile。校验和应用都输出 JSON,参数错误退出码为 2。+所有步骤应使用同一个 `DEEPTUTOR_HOME`;根目录 `.env` 不会自动加载。++```bash+deeptutor doctor --format json # 本地就绪检查+deeptutor doctor --online --format json # 发送一次小型 LLM 请求验证连接+```++在线检查会产生提供方用量,只验证 LLM;需要 RAG 时还要验证 embedding 和小样本文档检索。+### `provider` — 提供方认证 / 校验```bash@@ -260,7 +281,7 @@ Codex 令牌授权的是**你本人**的 ChatGPT 套餐,因此凭据只归当deeptutor kb create calculus --doc 微积分教材.pdf# 2. 用知识库解题-deeptutor run deep_solve "求 ∫sin(x)cos(x)dx" -t rag --kb calculus -l zh+deeptutor run deep_solve "求 ∫sin(x)cos(x)dx" --kb calculus -l zh# 3. 基于知识库出题deeptutor run deep_question "微积分" --kb calculus \diff --git a/deeptutor_cli/config_cmd.py b/deeptutor_cli/config_cmd.pyindex 3ce29166b..b5d4bfd5d 100644--- a/deeptutor_cli/config_cmd.py+++ b/deeptutor_cli/config_cmd.py@@ -7,6 +7,8 @@ View and update DeepTutor configuration.from __future__ import annotations+from pathlib import Path+from rich.console import Consoleimport typer@@ -14,11 +16,84 @@ console = Console()def register(app: typer.Typer) -> None:+ @app.command("providers")+ def config_providers() -> None:+ """List supported setup providers and their defaults as JSON."""+ import json++ from .setup_config import provider_options++ console.print_json(json.dumps(provider_options()))++ @app.command("apply")+ def config_apply(+ file: Path = typer.Argument(+ ..., help="Setup JSON file (see docs-for-user/AGENT_SETUP.md)."+ ),+ home: Path | None = typer.Option(None, "--home", help="Runtime workspace root."),+ check: bool = typer.Option(+ False, "--check", help="Validate without writing settings or contacting providers."+ ),+ ) -> None:+ """Apply LLM, embedding, search, and port configuration without prompts."""+ import json++ from pydantic import ValidationError++ from .setup_config import (+ SetupConfig,+ apply_setup,+ prepare_profiles,+ prepare_system,+ select_runtime_home,+ )++ try:+ config = SetupConfig.model_validate(json.loads(file.read_text(encoding="utf-8")))+ profiles = prepare_profiles(config)+ runtime_home = select_runtime_home(home)+ system = prepare_system(config)+ if not check:+ apply_setup(profiles, system)+ except ValidationError as exc:+ # Never include input values: a rejected literal api_key may be a secret.+ errors = [+ {"field": ".".join(map(str, error["loc"])), "message": error["msg"]}+ for error in exc.errors(include_input=False, include_url=False)+ ]+ console.print_json(json.dumps({"ok": False, "errors": errors}))+ raise typer.Exit(code=2) from None+ except (OSError, ValueError) as exc:+ console.print_json(json.dumps({"ok": False, "error": str(exc)}))+ raise typer.Exit(code=2) from None++ console.print_json(+ json.dumps(+ {+ "ok": True,+ "status": "validated" if check else "applied",+ "runtime_home": str(runtime_home),+ "sections": [+ name+ for name in ("llm", "embedding", "search", "system")+ if getattr(config, name) is not None+ ],+ }+ )+ )+@app.command("show")- def config_show() -> None:+ def config_show(+ home: Path | None = typer.Option(None, "--home", help="Runtime workspace root."),+ ) -> None:"""Show current configuration."""import json+ if home is not None:+ from .setup_config import select_runtime_home++ select_runtime_home(home)+from deeptutor.services.config import (load_config_with_main,load_system_settings,@@ -37,7 +112,7 @@ def register(app: typer.Typer) -> None:"model": llm_runtime.model,"base_url": llm_runtime.effective_url,"api_version": llm_runtime.api_version,- "extra_headers": llm_runtime.extra_headers,+ "extra_headers": {name: "***" for name in llm_runtime.extra_headers},"api_key": "***" if llm_runtime.api_key else "(not set)",}try:@@ -50,7 +125,7 @@ def register(app: typer.Typer) -> None:"model": embedding_runtime.model,"base_url": embedding_runtime.effective_url,"api_version": embedding_runtime.api_version,- "extra_headers": embedding_runtime.extra_headers,+ "extra_headers": {name: "***" for name in embedding_runtime.extra_headers},"api_key": "***" if embedding_runtime.api_key else "(not set)","dimension": embedding_runtime.dimension,}diff --git a/deeptutor_cli/init_cmd.py b/deeptutor_cli/init_cmd.pyindex 7d0db587a..5c8d41097 100644--- a/deeptutor_cli/init_cmd.py+++ b/deeptutor_cli/init_cmd.py@@ -16,8 +16,6 @@ from typing import Anyfrom rich.console import Consoleimport typer-from deeptutor.runtime.home import DEEPTUTOR_HOME_ENV, get_runtime_home-from . import init_wizard as wiz@@ -46,6 +44,21 @@ def _reset_runtime_singletons() -> None:ModelCatalogService._instances.clear()except Exception:pass+ # Multi-user paths can be imported by the CLI before --home is processed.+ # Their admin/global settings roots must follow the selected runtime too.+ import sys++ paths = sys.modules.get("deeptutor.multi_user.paths")+ if paths is not None:+ from deeptutor.runtime.home import get_runtime_home++ paths.PROJECT_ROOT = get_runtime_home()+ paths.ADMIN_WORKSPACE_ROOT = paths.PROJECT_ROOT / "data"+ paths.USERS_ROOT = paths.ADMIN_WORKSPACE_ROOT / "users"+ paths.SYSTEM_ROOT = paths.ADMIN_WORKSPACE_ROOT / "system"+ paths.LEGACY_MULTI_USER_ROOT = paths.PROJECT_ROOT / "multi-user"+ paths._path_services.clear()+ paths._legacy_migration_done = Falsedef _ensure_model_service(catalog: dict, service_name: str, profile_id: str, model_id: str):@@ -409,13 +422,13 @@ def _ensure_search_service(catalog: dict, profile_id: str) -> dict:return profile-def run_init(*, cli_only: bool = False, home: str | Path | None = None) -> None:- runtime_home = get_runtime_home(home)- runtime_home.mkdir(parents=True, exist_ok=True)- import os+def run_init(+ *, cli_only: bool = False, home: str | Path | None = None, non_interactive: bool = False+) -> None:+ from .setup_config import select_runtime_home- os.environ[DEEPTUTOR_HOME_ENV] = str(runtime_home)- _reset_runtime_singletons()+ runtime_home = select_runtime_home(home)+ runtime_home.mkdir(parents=True, exist_ok=True)from deeptutor.runtime.banner import labels_for, print_banner, resolve_languagefrom deeptutor.services.config import get_model_catalog_service, get_runtime_settings_service@@ -423,6 +436,23 @@ def run_init(*, cli_only: bool = False, home: str | Path | None = None) -> None:init_user_directories(runtime_home)+ if non_interactive:+ import json++ get_runtime_settings_service().ensure_defaults()+ get_model_catalog_service().load()+ Console().print_json(+ json.dumps(+ {+ "ok": True,+ "status": "initialized",+ "runtime_home": str(runtime_home),+ "next_step": "deeptutor config apply setup.json",+ }+ )+ )+ return+language = resolve_language()strings = labels_for(language)console = Console()@@ -543,7 +573,12 @@ def register(app: typer.Typer) -> None:def init_command(cli: bool = typer.Option(False, "--cli", help="Initialize for CLI-only use."),home: Path | None = typer.Option(None, "--home", help="Runtime workspace root."),+ non_interactive: bool = typer.Option(+ False,+ "--non-interactive",+ help="Create missing defaults without prompts; preserves saved settings.",+ ),) -> None:"""Create or update data/user/settings for this workspace."""- run_init(cli_only=cli, home=home)+ run_init(cli_only=cli, home=home, non_interactive=non_interactive)diff --git a/deeptutor_cli/main.py b/deeptutor_cli/main.pyindex ad4fb66b3..cb77f26f6 100644--- a/deeptutor_cli/main.py+++ b/deeptutor_cli/main.py@@ -3,6 +3,7 @@from __future__ import annotationsfrom pathlib import Path+import sysimport typer@@ -26,7 +27,7 @@ from .skill import register as register_skillfrom .workspace_cmd import register as register_workspaceset_mode(RunMode.CLI)-configure_logging()+configure_logging(console_stream=sys.stderr)app = typer.Typer(name="deeptutor",@@ -41,7 +42,7 @@ kb_app = typer.Typer(help="Manage knowledge bases.")skill_app = typer.Typer(help="Manage skills and install from hubs (ClawHub, …).")memory_app = typer.Typer(help="View and manage lightweight memory.")plugin_app = typer.Typer(help="List plugins.")-config_app = typer.Typer(help="Inspect configuration.")+config_app = typer.Typer(help="Inspect and apply configuration.")session_app = typer.Typer(help="Manage shared sessions.")notebook_app = typer.Typer(help="Manage notebooks and imported markdown records.")provider_app = typer.Typer(help="Manage provider OAuth login.")diff --git a/deeptutor_cli/setup_config.py b/deeptutor_cli/setup_config.pynew file mode 100644index 000000000..715fc930e--- /dev/null+++ b/deeptutor_cli/setup_config.py@@ -0,0 +1,272 @@+"""Validated, non-interactive setup using the shared runtime settings services."""++from __future__ import annotations++import json+import os+from pathlib import Path+import re+from typing import Annotated+from urllib.parse import parse_qsl, urlparse++from pydantic import BaseModel, ConfigDict, Field, StringConstraints, model_validator++from deeptutor.runtime.home import (+ DEEPTUTOR_HOME_ENV,+ get_runtime_home,+ validate_runtime_home,+)+from deeptutor.services.provider_registry import ApiFormat++NonEmptyString = Annotated[str, StringConstraints(strip_whitespace=True, min_length=1)]+Port = Annotated[int, Field(strict=True, ge=1, le=65535)]+++class _SetupSection(BaseModel):+ model_config = ConfigDict(extra="forbid")+++class ModelSetup(_SetupSection):+ provider: NonEmptyString+ model: NonEmptyString+ base_url: NonEmptyString | None = None+ api_key_env: NonEmptyString | None = None+ api_version: str = ""+ api_format: ApiFormat | None = None+ dimension: Annotated[int, Field(strict=True, gt=0)] | None = None+++class SearchSetup(_SetupSection):+ provider: NonEmptyString+ base_url: NonEmptyString | None = None+ api_key_env: NonEmptyString | None = None+++class SystemSetup(_SetupSection):+ backend_port: Port | None = None+ frontend_port: Port | None = None+++class SetupConfig(_SetupSection):+ llm: ModelSetup | None = None+ embedding: ModelSetup | None = None+ search: SearchSetup | None = None+ system: SystemSetup | None = None++ @model_validator(mode="after")+ def require_changes(self) -> SetupConfig:+ if not any((self.llm, self.embedding, self.search, self.system)):+ raise ValueError("Provide at least one of llm, embedding, search, or system.")+ if self.system is not None and not self.system.model_dump(exclude_none=True):+ raise ValueError("system must specify at least one port.")+ return self+++def select_runtime_home(home: str | Path | None) -> Path:+ """Select the target before importing services that cache settings paths."""+ from .init_cmd import _reset_runtime_singletons++ runtime_home = get_runtime_home(home)+ validate_runtime_home(runtime_home)+ os.environ[DEEPTUTOR_HOME_ENV] = str(runtime_home)+ _reset_runtime_singletons()+ return runtime_home+++def _api_key(env_name: str | None, *, required: bool, section: str) -> str:+ if env_name is None:+ if required:+ raise ValueError(f"{section}.api_key_env is required for this provider.")+ return ""+ if not re.fullmatch(r"[A-Za-z_][A-Za-z0-9_]*", env_name):+ raise ValueError(f"{section}.api_key_env must be an environment variable name.")+ value = os.environ.get(env_name, "")+ if not value.strip():+ raise ValueError(+ f"The environment variable named by {section}.api_key_env is empty or unset."+ )+ return value+++def _validate_endpoint(endpoint: str, section: str) -> None:+ parsed = urlparse(endpoint)+ if parsed.scheme not in {"http", "https"} or not parsed.hostname:+ raise ValueError(f"{section}.base_url must be an HTTP(S) URL.")+ if (+ parsed.username is not None+ or parsed.password is not None+ or any(+ key.lower() in {"access_token", "api_key", "key", "token"}+ for key, _ in parse_qsl(parsed.query)+ )+ ):+ raise ValueError(f"{section}.base_url must not contain credentials; use api_key_env.")+++def prepare_profiles(config: SetupConfig) -> dict[str, dict]:+ """Resolve credentials and validate every section before any settings writes."""+ from deeptutor.services.config.embedding_endpoint import (+ normalize_embedding_endpoint_for_display,+ )+ from deeptutor.services.config.provider_runtime import EMBEDDING_PROVIDERS, SEARCH_PROVIDERS+ from deeptutor.services.provider_registry import find_by_name++ profiles: dict[str, dict] = {}+ for section in ("llm", "embedding"):+ choice = getattr(config, section)+ if choice is None:+ continue+ provider = choice.provider.lower()+ spec = find_by_name(provider) if section == "llm" else EMBEDDING_PROVIDERS.get(provider)+ if spec is None:+ raise ValueError(f"Unsupported {section} provider. See 'deeptutor config providers'.")+ if section == "llm" and choice.dimension is not None:+ raise ValueError("dimension is only supported in the embedding section.")+ if section == "embedding" and choice.api_format is not None:+ raise ValueError("api_format is only supported in the llm section.")+ if section == "llm" and choice.api_format is not None:+ allowed = spec.api_formats or (spec.default_api_format,)+ if choice.api_format not in allowed:+ raise ValueError("llm.api_format is not supported by this provider.")+ default_endpoint = spec.default_api_base+ if section == "llm" and choice.api_format is not None:+ default_endpoint = dict(spec.api_base_by_format).get(+ choice.api_format, default_endpoint+ )+ endpoint = choice.base_url or default_endpoint+ if section == "embedding":+ endpoint = normalize_embedding_endpoint_for_display(+ provider, endpoint, model=choice.model+ )+ if not endpoint and not (section == "llm" and spec.is_oauth):+ raise ValueError(f"{section}.base_url is required for this provider.")+ if endpoint:+ _validate_endpoint(endpoint, section)+ requires_key = (+ not spec.is_local and provider != "custom" and not getattr(spec, "is_oauth", False)+ )+ key = _api_key(choice.api_key_env, required=requires_key, section=section)+ model = {"id": f"{section}-model-agent-setup", "name": choice.model, "model": choice.model}+ if choice.dimension is not None:+ model["dimension"] = choice.dimension+ profile = {+ "id": f"{section}-profile-agent-setup",+ "name": "Agent Setup",+ "binding": provider,+ "base_url": endpoint,+ "api_key": key,+ "api_version": choice.api_version,+ "extra_headers": {},+ "models": [model],+ }+ if choice.api_format is not None:+ profile["api_format"] = choice.api_format+ profiles[section] = profile++ if config.search is not None:+ choice = config.search+ provider = choice.provider.lower()+ spec = SEARCH_PROVIDERS.get(provider)+ if spec is None:+ raise ValueError("Unsupported search provider. See 'deeptutor config providers'.")+ endpoint = choice.base_url or ""+ if spec.requires_base_url and not endpoint:+ raise ValueError("search.base_url is required for this provider.")+ if endpoint:+ _validate_endpoint(endpoint, "search")+ profiles["search"] = {+ "id": "search-profile-agent-setup",+ "name": "Agent Setup",+ "provider": provider,+ "base_url": endpoint,+ "api_key": _api_key(+ choice.api_key_env, required=spec.requires_api_key, section="search"+ ),+ }+ return profiles+++def _read_settings(path: Path) -> dict:+ if not path.exists():+ return {}+ try:+ payload = json.loads(path.read_text(encoding="utf-8"))+ except (ValueError, UnicodeError):+ raise ValueError(f"Existing settings file is not valid JSON: {path}") from None+ if not isinstance(payload, dict):+ raise ValueError(f"Existing settings file must contain a JSON object: {path}")+ return payload+++def prepare_system(config: SetupConfig) -> dict | None:+ from deeptutor.services.config import get_model_catalog_service, get_runtime_settings_service+ from deeptutor.services.config.runtime_settings import DEFAULT_SYSTEM_SETTINGS++ # Refuse to replace an unreadable catalog with defaults during setup.+ if config.llm or config.embedding or config.search:+ _read_settings(get_model_catalog_service().path)+ if config.system is None:+ return None+ runtime = get_runtime_settings_service()+ system = {**DEFAULT_SYSTEM_SETTINGS, **_read_settings(runtime.path_for("system"))}+ system.update(config.system.model_dump(exclude_none=True))+ if system["backend_port"] == system["frontend_port"]:+ raise ValueError("Backend and frontend ports must be different.")+ return system+++def apply_setup(profiles: dict[str, dict], system: dict | None) -> None:+ """Update only supplied services in dedicated, repeatable setup profiles."""+ from deeptutor.services.config import get_model_catalog_service, get_runtime_settings_service++ if profiles:++ def update_catalog(catalog: dict) -> None:+ for section, profile in profiles.items():+ service = catalog["services"][section]+ existing = service["profiles"]+ index = next(+ (i for i, row in enumerate(existing) if row.get("id") == profile["id"]), None+ )+ if index is None:+ existing.append(profile)+ else:+ existing[index] = profile+ service["active_profile_id"] = profile["id"]+ if section != "search":+ service["active_model_id"] = profile["models"][0]["id"]++ get_model_catalog_service().update(update_catalog)+ if system is not None:+ get_runtime_settings_service().save_system(system)+++def provider_options() -> dict:+ """Machine-readable provider choices derived from the runtime registries."""+ from deeptutor.services.config.provider_runtime import EMBEDDING_PROVIDERS, SEARCH_PROVIDERS+ from deeptutor.services.provider_registry import PROVIDERS++ return {+ "llm": [+ {+ "provider": spec.name,+ "base_url": spec.default_api_base,+ "auth": spec.mode,+ "api_formats": list(spec.api_formats),+ }+ for spec in PROVIDERS+ if not spec.is_legacy+ ],+ "embedding": [+ {"provider": name, "base_url": spec.default_api_base, "local": spec.is_local}+ for name, spec in EMBEDDING_PROVIDERS.items()+ ],+ "search": [+ {+ "provider": name,+ "requires_api_key": spec.requires_api_key,+ "requires_base_url": spec.requires_base_url,+ }+ for name, spec in SEARCH_PROVIDERS.items()+ ],+ }diff --git a/docs-for-user/AGENT_SETUP.md b/docs-for-user/AGENT_SETUP.mdnew file mode 100644index 000000000..e72d79ad3--- /dev/null+++ b/docs-for-user/AGENT_SETUP.md@@ -0,0 +1,248 @@+# Set Up and Troubleshoot DeepTutor with Your Agent++This guide is for an external agent installing, configuring, and verifying+DeepTutor for a user, or investigating problems in an existing installation.+For an existing problem, start with [Troubleshooting](#6-troubleshooting) rather+than repeating installation. Read [SKILL.md](../SKILL.md) for the CLI overview. You need+terminal and file access; this flow does not require MCP or an agent-specific+plugin.++## 1. Establish the target++Ask only for missing information and continue independent preparation while+waiting:++- Installation folder and any existing DeepTutor checkout.+- Full Web app or CLI-only; default to the full app for the README setup prompt.+- LLM provider, exact model ID, and any custom/local endpoint.+- Credential source: an existing environment variable, a private local file+ the user identifies, or provider login. Do not ask for keys in chat.+- Whether knowledge bases/RAG are needed now; these also require embedding.+ Search is optional.++Reuse suitable checkouts/environments and preserve local edits and settings.+Use the user's existing `DEEPTUTOR_HOME`, or choose a runtime home explicitly.+It owns `data/`; it is not the `data/` directory itself or the Content Workspace+used for learning materials.++## 2. Clone and install++For a new full-app source installation (macOS/Linux example):++```bash+git clone https://github.com/HKUDS/DeepTutor.git+cd DeepTutor+python3 -m venv .venv+source .venv/bin/activate+python -m pip install --upgrade pip+python -m pip install -e .+cd web+npm ci --legacy-peer-deps+cd ..+```++Use Python **3.11–3.14** and **Node.js 22 LTS** for this flow. Check the actual+interpreter before creating the environment; `python3` may be older. On+Windows, use a supported `py -3.X` and `.venv\Scripts\Activate.ps1`. If shell+state does not persist between tool calls, invoke the environment's Python+and `deeptutor` by absolute path and pass environment variables to each process.++For CLI-only, replace the editable install with+`python -m pip install -e ./packaging/deeptutor-cli` and skip Node/npm. CLI-only+is currently installed from source. A packaged full app can use+`python -m pip install deeptutor` without cloning; it includes Web assets. Check+that installed version's `--help`: the non-interactive commands below are+available in the checkout containing this guide and releases that include it.++## 3. Initialize without prompts++Keep the same runtime home for initialization, configuration, diagnostics, and+startup. This example uses the checkout root; use the existing home instead+when the user has one:++```bash+export DEEPTUTOR_HOME="$PWD"+deeptutor init --non-interactive+deeptutor config providers+```++`init --non-interactive` creates missing defaults without selecting a model or+contacting a provider and preserves saved settings. `--cli` is also accepted;+no wizard runs in either mode. Initialization alone does not establish model+readiness.++`config providers` prints supported LLM, embedding, and search providers with+default endpoints and LLM API formats as JSON. Use its provider IDs. `init`,+`config apply`, and `config show` also accept `--home PATH`; for other commands+use `DEEPTUTOR_HOME` consistently.++## 4. Apply configuration++Write a UTF-8 JSON file such as `setup.json`, replacing the model placeholder+with the user's choice:++```json+{+ "llm": {+ "provider": "openai",+ "model": "YOUR_MODEL_ID",+ "api_key_env": "DEEPTUTOR_SETUP_LLM_KEY"+ },+ "system": {+ "backend_port": 8001,+ "frontend_port": 3782+ }+}+```++The variable named by `api_key_env` must exist in the CLI process's environment.+Read it from the user's authorized source without echoing it. The JSON contains+a variable name, not a literal key. Resolved keys are saved in DeepTutor's+private settings for later launches. Project-root `.env` files are not loaded+automatically.++```bash+deeptutor config apply setup.json --check+deeptutor config apply setup.json+deeptutor config show+```++`--check` validates input, providers, named credentials, endpoints, and port+conflicts without writing settings or contacting providers. Both modes+emit JSON; invalid input exits with code 2. Application selects a dedicated+**Agent Setup** profile for each supplied service. Repeating it updates those+same profiles; other profiles and omitted services/settings are preserved.+Supply complete profiles, including credential references, each time. Port+changes take effect on restart.++| Section | Required fields | Optional fields |+| :--- | :--- | :--- |+| `llm` | `provider`, `model` | `base_url`, `api_key_env`, `api_version`, `api_format` |+| `embedding` | `provider`, `model` | `base_url`, `api_key_env`, `api_version`, positive integer `dimension` |+| `search` | `provider` | `base_url`, `api_key_env` |+| `system` | At least one port | `backend_port`, `frontend_port` (integers 1–65535, distinct) |++Remote key-authenticated LLM/embedding providers require `api_key_env`; local,+OAuth, and `custom` endpoints may omit it. Search requirements come from+`config providers`. Providers without default endpoints require `base_url`.+LLM API formats are `auto`, `openai_chat`, `openai_responses`, and `anthropic`,+subject to the provider's supported list. Unknown fields, literal `api_key`+fields, and credentials in URLs are rejected. Advanced settings and other+service types remain available in Web Settings.++For knowledge bases/RAG, also configure an accessible embedding model. For example:++```json+{+ "embedding": {+ "provider": "openai",+ "model": "text-embedding-3-small",+ "api_key_env": "DEEPTUTOR_SETUP_EMBEDDING_KEY",+ "dimension": 1536+ },+ "search": { "provider": "duckduckgo" }+}+```++Embedding `base_url` is the full endpoint, such as+`https://api.openai.com/v1/embeddings`; the catalog normalizes it as the Web UI+does. Changing an existing KB's embedding model/dimensions requires planning+a rebuild. Omit search when unnecessary, or choose `none` to disable it.+DuckDuckGo needs no key; availability depends on the user's network.++For local Ollama, use `{"llm":{"provider":"ollama","model":"YOUR_LOCAL_MODEL"}}`+and verify that Ollama is running and the model is available.++For OAuth, apply the provider ID/model from `config providers`, then use its+existing login command in the same runtime home. The user completes any login+interaction:++```bash+deeptutor provider login openai-codex+# Other supported flows: github-copilot, codebuddy+```++OpenAI Codex uses DeepTutor's own OAuth credentials; the external agent's login+is not automatically reused. Login does not select a model.++## 5. Verify and start++```bash+deeptutor doctor --format json+deeptutor doctor --online --format json+```++The first checks local readiness; the second makes a small real model request+and may incur provider usage. Inspect exit status and required failures. Fix+actionable failures and rerun affected checks. Saved settings alone are not+proof of readiness. The LLM probe does not verify optional embedding: when RAG+is requested, also test its connection in Settings and ingest/search a small+user-approved document.++For the full app:++```bash+deeptutor start --detach --no-browser+```++Read the actual launcher URLs, verify backend `/health/ready`, and confirm the+frontend responds. Defaults are backend `http://127.0.0.1:8001` and frontend+`http://127.0.0.1:3782`; use the reported ports if different. Inspect launcher+logs on failure. Choose free ports through `config apply` instead of stopping+unrelated processes. For CLI-only, skip Web startup; a short+`deeptutor run chat` with `--format json` can verify turn execution if needed.++Finish with the checkout/environment, runtime home, provider/model without+credentials, passed checks, Web URL or CLI invocation, and any remaining user+action. Include `deeptutor stop` with the same home for a detached app. If+credentials or network access prevent verification, state the exact unfinished+step instead of declaring setup complete.++## 6. Troubleshooting++Use the following approach to investigate the user's symptom. Choose checks+based on evidence; there is no need to run every command for every problem.++1. **Identify the running instance and reproduce the symptom.** Establish the+ installation method, installed version or source commit, active Python+ environment, runtime home, and actual service URLs. For Docker, distinguish+ container paths/ports from host paths/ports. Ask for the failing action,+ expected result, approximate time, and relevant recent changes. Confirm+ that your CLI checks target the same instance, account, and workspace as+ the user; a healthy second installation tells you little about the failure.++2. **Collect the smallest useful evidence.** Use `config show` and `doctor`+ for configuration/readiness, `doctor --online` for a real LLM request, or+ `doctor runtime` for turn coordination, session storage, and migration+ preflight. Add `--format json` to either doctor mode. Inspect individual+ checks: top-level `ok: true` can coexist with optional failures such as RAG.+ A passing LLM probe does not prove that embedding, search, tools, or the+ browser's connection work.++3. **Follow the failing operation across its boundaries.** Start from the+ visible symptom and determine how far the operation got: browser → API →+ turn/capability → provider, tool, or storage. Inspect browser console and+ network errors for UI problems, and correlate server logs by time and+ `request_id`, `session_id`, or `turn_id` when present. For detached launches,+ check `<runtime-home>/data/user/runtime/launcher.log`; application logs+ normally live in `data/user/logs/deeptutor.jsonl`, subject to logging settings.+ Container deployments may also require container output. Read a narrow+ relevant excerpt and remove credentials and private content before sharing.++4. **Test one hypothesis at a time.** Reduce the failing action to a small+ reproduction and compare a working path with the failing one. For example,+ a successful CLI turn with a failing Web turn directs attention toward the+ browser/API path, provided both use equivalent settings and context. Use+ `--help`, `plugin info`, and the checked-out code to continue investigating.+ The root `AGENTS.md` maps the architecture; useful starting points include+ `deeptutor_cli/`, `deeptutor/api/`, `deeptutor/runtime/`,+ `deeptutor/capabilities/`, `deeptutor/services/`, and `web/`. Match source to+ the installed version before drawing conclusions.++5. **Make a focused fix and verify the original action.** Preserve existing+ data and configuration; avoid blanket reinstalls, resets, or KB rebuilds+ as exploratory steps. Rerun the user's failing operation after the change,+ not only a general health check. Report observations separately from+ hypotheses. If unresolved, provide a concise handoff: environment/version,+ reproduction, expected versus actual behavior, relevant redacted errors,+ checks already tried, and the next useful investigation.diff --git a/tests/api/test_settings_service_preview.py b/tests/api/test_settings_service_preview.pynew file mode 100644index 000000000..186a060de--- /dev/null+++ b/tests/api/test_settings_service_preview.py@@ -0,0 +1,115 @@+from copy import deepcopy+import json+from types import SimpleNamespace++from fastapi import FastAPI, HTTPException+from fastapi.testclient import TestClient+import pytest++from deeptutor.api.routers import settings+from deeptutor.services.settings import service_preview+from deeptutor.services.voice import discovery+++def catalog(key="secret"):+ return {+ "version": 1,+ "services": {+ name: {+ "active_profile_id": "p",+ "active_model_id": "old",+ "profiles": [+ {+ "id": "p",+ "binding": "minimax",+ "api_key": key,+ "models": [+ {"id": "old", "model": "old"},+ {"id": "m", "model": "speech-2.8-hd"},+ ],+ }+ ],+ }+ for name in ("tts", "search", "stt", "imagegen", "videogen")+ },+ }+++def client(monkeypatch):+ monkeypatch.setattr(settings, "_require_settings_admin", lambda: None)+ monkeypatch.setattr(+ settings,+ "get_model_catalog_service",+ lambda: SimpleNamespace(load=catalog, resolve_connections=deepcopy),+ )+ monkeypatch.setattr(+ settings,+ "get_settings_draft_service",+ lambda: SimpleNamespace(load=lambda: {"catalog": catalog("draft-secret")}),+ )+ app = FastAPI()+ app.include_router(settings.router, prefix="/settings")+ return TestClient(app)+++def test_preview_restores_draft_secrets_and_never_applies(client, monkeypatch):+ async def events(draft, service, profile, model, text, audio, content_type):+ assert draft["services"]["search"]["profiles"][0]["api_key"] == "draft-secret"+ assert draft["services"]["search"]["active_model_id"] == "old"+ assert service == "search" and profile == "p" and text == "test query"+ yield {"type": "result", "kind": "search", "text": "", "results": []}++ monkeypatch.setattr(service_preview, "preview_events", events)+ response = client.post(+ "/settings/services/search/preview",+ json={"catalog": catalog("***"), "profile_id": "p", "text": "test query"},+ )+ assert response.status_code == 200+ assert response.headers["cache-control"] == "no-store"+ assert json.loads(response.text)["results"] == []+++def test_voice_lookup_uses_draft_credentials(client, monkeypatch):+ async def discover(draft, profile, model):+ assert draft["services"]["tts"]["profiles"][0]["api_key"] == "draft-secret"+ assert profile == "p" and model == "m"+ return {"status": "unsupported", "voices": [], "scope": "none"}++ monkeypatch.setattr(discovery, "discover_voices", discover)+ response = client.post(+ "/settings/voice/voices",+ json={"catalog": catalog("***"), "profile_id": "p", "model_id": "m"},+ )+ assert response.status_code == 200+ assert response.json()["status"] == "unsupported"+++ "service,payload,status",+ [+ ("search", {"text": " "}, 400),+ ("llm", {"text": "test"}, 400),+ ("stt", {"audio": "not-base64", "content_type": "audio/wav"}, 400),+ ("imagegen", {"text": "test", "model_id": "missing"}, 400),+ ("search", {"text": "a" * 2001}, 422),+ ],+)+def test_invalid_previews_fail_before_calling_provider(client, service, payload, status):+ response = client.post(+ f"/settings/services/{service}/preview",+ json={"catalog": catalog(), "profile_id": "p", **payload},+ )+ assert response.status_code == status++[email protected]("path", ["/settings/voice/voices", "/settings/services/search/preview"])+def test_preview_and_discovery_require_settings_admin(client, monkeypatch, path):+ def deny():+ raise HTTPException(status_code=403, detail="Admin required")++ monkeypatch.setattr(settings, "_require_settings_admin", deny)+ response = client.post(+ path, json={"catalog": catalog(), "profile_id": "p", "model_id": "m", "text": "test"}+ )+ assert response.status_code == 403diff --git a/tests/api/test_unified_ws_turn_runtime.py b/tests/api/test_unified_ws_turn_runtime.pyindex 4d4fd3d4f..a18d223b7 100644--- a/tests/api/test_unified_ws_turn_runtime.py+++ b/tests/api/test_unified_ws_turn_runtime.py@@ -24,7 +24,13 @@ def _fake_skill_service() -> SimpleNamespace:@pytest.fixture(autouse=True)-def _isolate_runtime_services(monkeypatch):+def _isolate_runtime_services(monkeypatch, tmp_path):+ from deeptutor.services.task_board import TaskBoardStore++ board = TaskBoardStore(tmp_path / "tasks.sqlite")+ monkeypatch.setattr(+ "deeptutor.services.task_board.get_task_board_store", lambda **_kwargs: board+ )# Runtime now resolves multiple skill libraries; these turn tests use an# empty catalog and must not inspect the developer's real skill folders.monkeypatch.setattr(@@ -106,6 +112,17 @@ async def test_turn_runtime_replays_events_and_materializes_messages() -> None:store = SQLiteSessionStore(tmp_path / "chat_history.db")runtime = TurnRuntimeManager(store)+ from deeptutor.services.task_board import CreateCard, UpdateCard, get_task_board_store++ board = get_task_board_store()+ assigned = board.create(CreateCard(title="Shared workspace task")).cards[-1]+ board.update(assigned.id, UpdateCard(workspace_id=""))+ linked = board.create(CreateCard(title="Conversation task")).cards[-1]+ requested = consultation.get("config", consultation)+ consultation = {+ **consultation,+ "config": {**consultation.get("config", {}), "linked_task_ids": [linked.id]},+ }captured: dict[str, object] = {}publish_order: list[str] = []original_publish = runtime._publish_live_event@@ -153,6 +170,7 @@ async def test_turn_runtime_replays_events_and_materializes_messages(captured["partner_discussion_group_id"] = context.runtime.partner_discussion_group_idassert "consult_partner_id" not in context.config_overridesassert "partner_discussion_group_id" not in context.config_overrides+ assert "linked_task_ids" not in context.config_overridescaptured["user_message"] = context.user_messagecaptured["metadata"] = context.metadatacaptured["source_manifest"] = context.source_manifest@@ -228,7 +246,6 @@ async def test_turn_runtime_replays_events_and_materializes_messages(]done_event = next(e for e in events if e["type"] == "done")assert done_event["metadata"]["status"] == "completed"- requested = consultation.get("config", consultation)assert captured["consult_partner_id"] == requested.get("consult_partner_id")assert captured["partner_discussion_group_id"] == requested.get("partner_discussion_group_id")@@ -265,6 +282,9 @@ async def test_turn_runtime_replays_events_and_materializes_messages(# surfaces in ``context.source_manifest`` and ``metadata.source_index``.assert str(captured["user_message"]) == "hello, i'm frank"manifest = str(captured.get("source_manifest") or "")+ assert "Shared workspace task" in manifest+ assert "Conversation task" in manifest+ assert board.read().session_links[0].task_ids == [linked.id]assert "[Attached Sources]" in manifest# Book source id is now per-book (``bk-{book_id}``) so multi-book# sessions can read_source each independently. The mocked book has iddiff --git a/tests/cli/test_agent_setup.py b/tests/cli/test_agent_setup.pynew file mode 100644index 000000000..5f057e518--- /dev/null+++ b/tests/cli/test_agent_setup.py@@ -0,0 +1,262 @@+"""Exercise the headless setup flow against real, isolated settings files."""++from __future__ import annotations++import json+import os+from pathlib import Path+import subprocess+import sys++import pytest+from typer.testing import CliRunner++from deeptutor_cli.main import app+from deeptutor_cli.setup_config import select_runtime_home++runner = CliRunner()+++def runtime_home(tmp_path, monkeypatch):+ from deeptutor.multi_user import paths++ for name in (+ "PROJECT_ROOT",+ "ADMIN_WORKSPACE_ROOT",+ "USERS_ROOT",+ "SYSTEM_ROOT",+ "LEGACY_MULTI_USER_ROOT",+ "_path_services",+ "_legacy_migration_done",+ ):+ monkeypatch.setattr(paths, name, {} if name == "_path_services" else getattr(paths, name))+ home = tmp_path / "runtime"+ monkeypatch.setenv("DEEPTUTOR_HOME", str(home))+ monkeypatch.setenv("DT_SETUP_TEST_KEY", "setup-test-secret")+ select_runtime_home(home)+ yield home+ from deeptutor_cli.init_cmd import _reset_runtime_singletons++ _reset_runtime_singletons()+++def apply_file(tmp_path, payload, *options):+ path = tmp_path / "setup.json"+ path.write_text(json.dumps(payload), encoding="utf-8")+ return runner.invoke(app, ["config", "apply", str(path), *options])+++def test_setup_applies_runtime_resolvable_models_and_preserves_other_profiles(+ runtime_home, tmp_path+):+ from deeptutor.services.config import (+ get_model_catalog_service,+ get_runtime_settings_service,+ resolve_embedding_runtime_config,+ resolve_llm_runtime_config,+ resolve_search_runtime_config,+ )++ catalog_service = get_model_catalog_service()+ catalog = catalog_service.load()+ original = {+ "id": "existing",+ "name": "Keep me",+ "binding": "openai",+ "api_key": "existing-secret",+ "base_url": "https://api.openai.com/v1",+ "models": [{"id": "existing-model", "model": "existing-model"}],+ }+ catalog["services"]["llm"]["profiles"].append(original)+ catalog_service.save(catalog)+ runtime = get_runtime_settings_service()+ system = runtime.load_system(include_process_overrides=False)+ system["sandbox_allow_subprocess"] = False+ runtime.save_system(system)++ payload = {+ "llm": {+ "provider": "openai",+ "model": "chosen-model",+ "api_key_env": "DT_SETUP_TEST_KEY",+ "api_format": "openai_responses",+ },+ "embedding": {+ "provider": "gemini",+ "model": "gemini-embedding-2",+ "api_key_env": "DT_SETUP_TEST_KEY",+ "dimension": 3072,+ },+ "search": {"provider": "duckduckgo"},+ "system": {"backend_port": 8101, "frontend_port": 3882},+ }+ for _ in range(2):+ result = apply_file(tmp_path, payload)+ assert result.exit_code == 0, result.output+ assert json.loads(result.stdout)["status"] == "applied"+ assert "setup-test-secret" not in result.output++ profiles = catalog_service.load()["services"]["llm"]["profiles"]+ assert len(profiles) == 2+ assert profiles[0]["api_key"] == "existing-secret"+ assert profiles[0]["models"][0]["model"] == "existing-model"+ llm = resolve_llm_runtime_config()+ assert llm.model == "chosen-model"+ assert llm.api_key == "setup-test-secret"+ assert llm.api_format == "openai_responses"+ embedding = resolve_embedding_runtime_config()+ assert embedding.effective_url.endswith("/gemini-embedding-2:batchEmbedContents")+ assert embedding.dimension == 3072+ assert resolve_search_runtime_config().provider == "duckduckgo"+ saved_system = runtime.load_system(include_process_overrides=False)+ assert saved_system["backend_port"] == 8101+ assert saved_system["sandbox_allow_subprocess"] is False+++def test_check_creates_no_runtime_files_and_apply_honors_explicit_home(runtime_home, tmp_path):+ target = tmp_path / "explicit-home"+ payload = {"llm": {"provider": "ollama", "model": "local-model"}}+ checked = apply_file(tmp_path, payload, "--home", str(target), "--check")+ assert checked.exit_code == 0, checked.output+ assert json.loads(checked.stdout)["status"] == "validated"+ assert not target.exists()+ assert not runtime_home.exists()++ applied = apply_file(tmp_path, payload, "--home", str(target))+ assert applied.exit_code == 0, applied.output+ assert (target / "data/user/settings/model_catalog.json").exists()+ assert not runtime_home.exists()+ shown = runner.invoke(app, ["config", "show", "--home", str(target)])+ assert shown.exit_code == 0, shown.output+ assert json.loads(shown.stdout)["llm"]["model"] == "local-model"+++ "payload",+ [+ {},+ {"system": {"backend_port": 0}},+ {"system": {"frontend_port": True}},+ {"system": {"backend_port": 8001, "frontend_port": 8001}},+ {"llm": {"provider": "unknown", "model": "model"}},+ {"llm": {"provider": "openai", "model": "model", "api_key": "do-not-echo"}},+ {"llm": {"provider": "openai", "model": "model", "api_key_env": "MISSING_SETUP_KEY"}},+ {+ "llm": {+ "provider": "ollama",+ "model": "model",+ "base_url": "https://host/v1?api_key=do-not-echo",+ }+ },+ {"llm": {"provider": "ollama", "model": "model"}, "search": {"provider": "searxng"}},+ {"llm": {"provider": "ollama", "model": "model", "api_format": "anthropic"}},+ ],+)+def test_invalid_setup_fails_before_writes(runtime_home, tmp_path, payload, monkeypatch):+ monkeypatch.delenv("MISSING_SETUP_KEY", raising=False)+ result = apply_file(tmp_path, payload)+ assert result.exit_code == 2, result.output+ assert json.loads(result.stdout)["ok"] is False+ assert "do-not-echo" not in result.output+ assert not runtime_home.exists()+++def test_partial_port_conflict_does_not_apply_llm(runtime_home, tmp_path):+ from deeptutor.services.config import get_runtime_settings_service++ runtime = get_runtime_settings_service()+ system = runtime.load_system(include_process_overrides=False)+ before = runtime.path_for("system").read_bytes()+ result = apply_file(+ tmp_path,+ {+ "llm": {"provider": "ollama", "model": "local-model"},+ "system": {"backend_port": system["frontend_port"]},+ },+ )+ assert result.exit_code == 2, result.output+ assert runtime.path_for("system").read_bytes() == before+ assert not (runtime_home / "data/user/settings/model_catalog.json").exists()+++def test_non_interactive_init_never_prompts_or_overwrites_saved_choices(+ runtime_home, tmp_path, monkeypatch+):+ def unexpected_prompt(*args, **kwargs):+ pytest.fail("Headless initialization must not prompt")++ monkeypatch.setattr("typer.prompt", unexpected_prompt)+ monkeypatch.setattr("typer.confirm", unexpected_prompt)+ applied = apply_file(tmp_path, {"llm": {"provider": "ollama", "model": "keep-local"}})+ assert applied.exit_code == 0, applied.output+ catalog_path = runtime_home / "data/user/settings/model_catalog.json"+ before = catalog_path.read_bytes()+ for _ in range(2):+ result = runner.invoke(app, ["init", "--non-interactive", "--home", str(runtime_home)])+ assert result.exit_code == 0, result.output+ assert json.loads(result.stdout)["status"] == "initialized"+ assert catalog_path.read_bytes() == before+ assert (runtime_home / "data/user/settings/system.json").exists()+++def test_provider_discovery_includes_local_and_oauth_choices(runtime_home):+ result = runner.invoke(app, ["config", "providers"])+ assert result.exit_code == 0, result.output+ choices = json.loads(result.stdout)+ assert any(row["provider"] == "ollama" for row in choices["llm"])+ assert any(row["auth"] == "oauth" for row in choices["llm"])+ assert any(+ row["provider"] == "searxng" and row["requires_base_url"] for row in choices["search"]+ )+ assert not runtime_home.exists()+++def test_setup_json_is_parseable_across_separate_cli_processes(runtime_home, tmp_path):+ target = tmp_path / "explicit-process-home"+ path = tmp_path / "setup.json"+ path.write_text(+ json.dumps(+ {+ "llm": {+ "provider": "openai",+ "model": "process-test-model",+ "api_key_env": "DT_SETUP_TEST_KEY",+ },+ "system": {"backend_port": 8123, "frontend_port": 3891},+ }+ ),+ encoding="utf-8",+ )+ steps = [+ ["init", "--non-interactive", "--home", str(target)],+ ["config", "apply", str(path), "--home", str(target), "--check"],+ ["config", "apply", str(path), "--home", str(target)],+ ["config", "show", "--home", str(target)],+ ]+ for step in steps:+ result = subprocess.run(+ [sys.executable, "-m", "deeptutor_cli.main", *step],+ cwd=Path(__file__).resolve().parents[2],+ env=os.environ.copy(),+ capture_output=True,+ text=True,+ timeout=30,+ )+ assert result.returncode == 0, result.stderr+ payload = json.loads(result.stdout)+ assert "setup-test-secret" not in result.stdout + result.stderr+ if step[:2] == ["config", "show"]:+ assert payload["ports"] == {"backend": 8123, "frontend": 3891}+ assert payload["llm"]["model"] == "process-test-model"+ assert (target / "data/user/settings/model_catalog.json").exists()+ assert not (runtime_home / "data/user/settings/system.json").exists()+++def test_unreadable_existing_catalog_is_preserved(runtime_home, tmp_path):+ path = runtime_home / "data/user/settings/model_catalog.json"+ path.parent.mkdir(parents=True)+ path.write_text("{broken JSON", encoding="utf-8")+ result = apply_file(tmp_path, {"llm": {"provider": "ollama", "model": "local-model"}})+ assert result.exit_code == 2, result.output+ assert path.read_text(encoding="utf-8") == "{broken JSON"diff --git a/tests/cli/test_config_cli.py b/tests/cli/test_config_cli.pyindex 9e15b9186..68a965290 100644--- a/tests/cli/test_config_cli.py+++ b/tests/cli/test_config_cli.py@@ -30,7 +30,7 @@ def test_config_show_handles_missing_embedding(monkeypatch) -> None:model="gpt-4o-mini",effective_url="https://api.openai.com/v1",api_version=None,- extra_headers={},+ extra_headers={"Authorization": "header-secret"},api_key="",),)@@ -63,3 +63,5 @@ def test_config_show_handles_missing_embedding(monkeypatch) -> None:assert result.exit_code == 0, result.outputassert '"status": "not_configured"' in result.outputassert "No active embedding model is configured." in result.output+ assert "header-secret" not in result.output+ assert '"Authorization": "***"' in result.outputdiff --git a/tests/cli/test_docs_contract.py b/tests/cli/test_docs_contract.pyindex 81f1c41e2..a778c7ac9 100644--- a/tests/cli/test_docs_contract.py+++ b/tests/cli/test_docs_contract.py@@ -12,6 +12,7 @@ PUBLIC_DOCS = (ROOT / "README.md",ROOT / "deeptutor_cli" / "README.md",ROOT / "SKILL.md",+ ROOT / "docs-for-user" / "AGENT_SETUP.md",)@@ -77,6 +78,7 @@ def test_documented_deeptutor_subcommands_exist() -> None:"book","chat","config",+ "doctor","init","kb","memory",@@ -89,6 +91,7 @@ def test_documented_deeptutor_subcommands_exist() -> None:"session","skill","start",+ "stop","workspace",}provider_subcommands = {"login"}diff --git a/tests/logging/test_configure.py b/tests/logging/test_configure.pyindex dde84410b..6181e3702 100644--- a/tests/logging/test_configure.py+++ b/tests/logging/test_configure.py@@ -4,6 +4,7 @@ import loggingimport osfrom pathlib import Pathimport stat+import sysimport pytest@@ -23,6 +24,18 @@ def _flush_root_handlers() -> None:handler.flush()+def test_cli_console_logs_can_use_stderr_without_polluting_stdout(monkeypatch, capsys):+ configure_module = importlib.import_module("deeptutor.logging.configure")+ monkeypatch.setattr(+ configure_module, "load_logging_config", lambda: LoggingConfig(file_output=False)+ )+ configure_module.configure_logging(force=True, console_stream=sys.stderr)+ logging.getLogger("deeptutor.tests.cli").info("setup diagnostic")+ captured = capsys.readouterr()+ assert captured.out == ""+ assert "setup diagnostic" in captured.err++def test_configure_logging_writes_jsonl_and_respects_level(monkeypatch, tmp_path: Path):configure_module = importlib.import_module("deeptutor.logging.configure")monkeypatch.setattr(diff --git a/tests/multi_user/test_task_board.py b/tests/multi_user/test_task_board.pyindex 5a2a07682..d49d7901f 100644--- a/tests/multi_user/test_task_board.py+++ b/tests/multi_user/test_task_board.py@@ -10,6 +10,10 @@ from deeptutor.api.routers import auth, task_boardfrom deeptutor.services.auth import TokenPayloadfrom deeptutor.services.task_board import (CreateCard,+ LinkStatus,+ LinkTasks,+ StatusColors,+ TaskBoard,TaskBoardStore,UpdateCard,get_task_board_store,@@ -99,7 +103,9 @@ def test_learning_policy_allows_board_reads_and_writes_only_with_chat_surface(cldef test_create_edit_move_archive_restore_and_reload(client):- assert client.get("/api/task-board", headers=headers()).json() == {"cards": []}+ assert (+ client.get("/api/task-board", headers=headers()).json() == TaskBoard(cards=[]).model_dump()+ )response = client.post("/api/task-board/cards", json={"title": " Review derivatives "}, headers=headers())@@ -133,7 +139,9 @@ def test_create_edit_move_archive_restore_and_reload(client):)def test_rejects_invalid_new_cards(client, payload):assert client.post("/api/task-board/cards", json=payload, headers=headers()).status_code == 422- assert client.get("/api/task-board", headers=headers()).json() == {"cards": []}+ assert (+ client.get("/api/task-board", headers=headers()).json() == TaskBoard(cards=[]).model_dump()+ )@pytest.mark.parametrize(@@ -152,7 +160,10 @@ def test_other_accounts_cannot_read_or_modify_cards(client):card = client.post("/api/task-board/cards", json={"title": "Private task"}, headers=headers()).json()["cards"][0]- assert client.get("/api/task-board", headers=headers("bob")).json() == {"cards": []}+ assert (+ client.get("/api/task-board", headers=headers("bob")).json()+ == TaskBoard(cards=[]).model_dump()+ )response = client.patch(f"/api/task-board/cards/{card['id']}", json={"archived": True}, headers=headers("bob"))@@ -160,47 +171,59 @@ def test_other_accounts_cannot_read_or_modify_cards(client):assert client.get("/api/task-board", headers=headers()).json()["cards"] == [card]-def test_workspace_selection_and_archived_workspace_guard(client, as_user):+def test_independent_board_and_assignment_workspace_guards(client, as_user):with as_user("alice"):service = get_content_workspace_service()first = service.create_workspace("First")second = service.create_workspace("Second")- first_query = {"dt_workspace": first["workspace_id"]}- second_query = {"dt_workspace": second["workspace_id"]}card = client.post("/api/task-board/cards",- json={"title": "Scoped task"},+ json={"title": "Independent task"},headers=headers(),- params=first_query,+ params={"dt_workspace": first["workspace_id"]},+ ).json()["cards"][0]+ assert card["workspace_id"] is None+ for workspace in ("", first["workspace_id"], second["workspace_id"]):+ assert client.get(+ "/api/task-board", headers=headers(), params={"dt_workspace": workspace}+ ).json()["cards"] == [card]+ url = f"/api/task-board/cards/{card['id']}"+ assigned = client.patch(+ url, json={"workspace_id": first["workspace_id"]}, headers=headers()).json()["cards"][0]- assert client.get("/api/task-board", headers=headers(), params=second_query).json() == {- "cards": []- }- assert client.get("/api/task-board", headers=headers()).json() == {"cards": []}+ assert assigned["workspace_id"] == first["workspace_id"]+ assert client.patch(url, json={"workspace_id": "missing"}, headers=headers()).status_code == 404+ with as_user("bob"):+ other = get_content_workspace_service().create_workspace("Private")assert (client.patch(- f"/api/task-board/cards/{card['id']}",- json={"status": "done"},- headers=headers(),- params=second_query,+ url, json={"workspace_id": other["workspace_id"]}, headers=headers()).status_code== 404)- assert client.get(- "/api/task-board", headers=headers("bob"), params=first_query- ).status_code in {403, 404, 409}with as_user("alice"):- with workspace_context(first["workspace_id"]):- assert get_task_board_store().read().cards[0].id == card["id"]service.update_workspace(first["workspace_id"], archived=True)assert (client.patch(- f"/api/task-board/cards/{card['id']}",+ url, json={"workspace_id": first["workspace_id"]}, headers=headers()+ ).status_code+ == 404+ )+ # Selecting an archived workspace does not lock the independent board.+ assert (+ client.patch(+ url,json={"status": "done"},headers=headers(),- params=first_query,+ params={"dt_workspace": first["workspace_id"]},).status_code- == 404+ == 200+ )+ assert (+ client.patch(url, json={"workspace_id": None}, headers=headers()).json()["cards"][0][+ "workspace_id"+ ]+ is None)@@ -229,3 +252,151 @@ def test_concurrent_connections_preserve_cards_and_independent_fields(tmp_path):updated = TaskBoardStore(path).read().cards[0]assert updated.note == "Keep this note"assert updated.status == "done"+++def test_associations_preserve_latest_order_and_independent_status_switch(tmp_path):+ store = TaskBoardStore(tmp_path / "tasks.sqlite")+ first = store.create(CreateCard(title="First")).cards[0]+ second = store.create(CreateCard(title="Second")).cards[1]+ linked = store.link_tasks(+ "chat", LinkTasks(workspace_id="study", task_ids=[first.id, second.id])+ )+ assert linked.session_links[0].task_ids == [first.id, second.id]+ reordered = store.link_tasks(+ "chat", LinkTasks(workspace_id="study", task_ids=[second.id, first.id])+ )+ assert reordered.session_links[0].task_ids == [first.id, second.id]+ disabled = store.link_status("chat", LinkStatus(workspace_id="study", enabled=False))+ assert not disabled.session_links[0].status_link_enabled+ assert disabled.session_links[0].task_ids == [first.id, second.id]+ removed = store.link_tasks("chat", LinkTasks(workspace_id="study", task_ids=[first.id]))+ assert removed.session_links[0].task_ids == [first.id]+ relinked = store.link_tasks(+ "chat", LinkTasks(workspace_id="study", task_ids=[first.id, second.id])+ )+ assert relinked.session_links[0].status_link_enabled+ assert relinked.session_links[0].task_ids[-1] == second.id+ store.move_session_links(["chat"], "study", "other")+ assert store.read().session_links[0].workspace_id == "other"+++def test_workspace_task_context_and_linked_context_use_live_cards(tmp_path):+ store = TaskBoardStore(tmp_path / "tasks.sqlite")+ assigned = store.create(CreateCard(title="Workspace task")).cards[0]+ linked = store.create(CreateCard(title="Linked task")).cards[1]+ store.update(assigned.id, UpdateCard(workspace_id="study"))+ store.link_tasks("chat-one", LinkTasks(workspace_id="study", task_ids=[linked.id]))+ assert "Workspace task" in store.context_text("study", "chat-two")+ assert "Linked task" not in store.context_text("study", "chat-two")+ assert "Linked task" in store.context_text("study", "chat-one")+ store.update(linked.id, UpdateCard(status="done", note="Newest note"))+ assert "Newest note" in store.context_text("study", "chat-one")+ assert '"status": "done"' in store.context_text("study", "chat-one")+ assert store.context_text("other", "chat-one") == ""+ store.update(assigned.id, UpdateCard(archived=True))+ assert store.context_text("study", "chat-two") == ""+++def test_link_validation_is_transactional_and_colors_are_durable(tmp_path):+ store = TaskBoardStore(tmp_path / "tasks.sqlite")+ card = store.create(CreateCard(title="Keep")).cards[0]+ original = store.link_tasks("chat", LinkTasks(task_ids=[card.id]))+ with pytest.raises(KeyError):+ store.link_tasks("chat", LinkTasks(task_ids=["missing"]))+ assert store.read() == original+ colors = StatusColors(todo="#123456", doing="#abcdef", done="#777777")+ saved = store.set_colors(colors)+ assert TaskBoardStore(store.path).read().colors == colors+ assert saved.revision > original.revision+ store.update(card.id, UpdateCard(archived=True))+ with pytest.raises(KeyError):+ store.link_tasks("other-chat", LinkTasks(task_ids=[card.id]))+++def test_legacy_workspace_tasks_are_imported_once_without_losing_archive_state(as_user):+ from deeptutor.services.path_service import get_path_service++ with as_user("alice"):+ service = get_content_workspace_service()+ workspace = service.create_workspace("Original")+ with workspace_context(workspace["workspace_id"]):+ legacy_path = get_path_service().get_workspace_dir() / "task-board" / "cards.sqlite"+ legacy = TaskBoardStore(legacy_path)+ card = legacy.create(CreateCard(title="Legacy task")).cards[0]+ legacy.update(card.id, UpdateCard(status="done", archived=True))+ store = get_task_board_store()+ imported = store.read().cards[0]+ assert imported.title == "Legacy task"+ assert imported.archived and imported.status == "done"+ assert imported.workspace_id == workspace["workspace_id"]+ store.update(imported.id, UpdateCard(title="New title", archived=False))+ assert len(get_task_board_store().read().cards) == 1+ assert get_task_board_store().read().cards[0].title == "New title"+ assert legacy_path.exists()+++def test_session_link_routes_validate_session_and_account(client, as_user):+ import asyncio++ from deeptutor.services.session import get_session_store++ with as_user("alice"):+ session = asyncio.run(get_session_store().create_session())+ card = client.post("/api/task-board/cards", json={"title": "Task"}, headers=headers()).json()[+ "cards"+ ][0]+ url = f"/api/task-board/sessions/{session['id']}"+ assert client.put(url, json={"task_ids": [card["id"]]}, headers=headers()).status_code == 200+ assert (+ client.put(url, json={"task_ids": [card["id"]]}, headers=headers("bob")).status_code == 404+ )+ assert (+ client.put(+ "/api/task-board/sessions/missing", json={"task_ids": [card["id"]]}, headers=headers()+ ).status_code+ == 404+ )+ updated = client.patch(url + "/status", json={"enabled": False}, headers=headers()).json()+ assert not updated["session_links"][0]["status_link_enabled"]+ assert (+ client.put(+ "/api/task-board/colors", json={"todo": "not-a-color"}, headers=headers()+ ).status_code+ == 422+ )+ assert (+ client.put(+ "/api/task-board/colors",+ json={"todo": "#111111", "doing": "#222222", "done": "#333333"},+ headers=headers(),+ ).status_code+ == 200+ )+ assert (+ client.get("/api/task-board", headers=headers("bob")).json()["colors"]+ == StatusColors().model_dump()+ )+++async def test_events_observe_commits_from_another_store_connection(as_user):+ import json++ class Request:+ async def is_disconnected(self):+ return False++ with as_user("alice"):+ stream = await task_board.board_events(Request())+ assert "no-transform" in stream.headers["cache-control"]+ assert stream.headers["content-encoding"] == "identity"+ events = stream.body_iterator+ first = await anext(events)+ assert json.loads(first.split("data: ")[1])["revision"] == 0+ writer = TaskBoardStore(get_task_board_store().path)+ writer.create(CreateCard(title="Other worker"))+ second = await anext(events)+ snapshot = json.loads(second.split("data: ")[1])+ assert snapshot["cards"][0]["title"] == "Other worker"+ assert snapshot["revision"] == 1+ await events.aclose()diff --git a/tests/services/test_mimo_voice.py b/tests/services/test_mimo_voice.pyindex 37440a045..9d800b9b1 100644--- a/tests/services/test_mimo_voice.py+++ b/tests/services/test_mimo_voice.py@@ -74,16 +74,17 @@ class MiMoTTSTests(unittest.IsolatedAsyncioTestCase):},)- async def test_pcm_alias_and_default_voice(self) -> None:+ async def test_pcm_alias_preserves_explicit_voice(self) -> None:config = self.config()config.base_url += "/chat/completions"config.response_format = "pcm"+ config.voice = "account-voice"result, requests = await self.invoke(config, {"choices": [{"message": {"audio": {"data": "AAABAA=="}}}]})self.assertEqual(result, (b"\x00\x00\x01\x00", "audio/pcm;rate=24000;channels=1"))self.assertEqual(- json.loads(requests[0].content)["audio"], {"format": "pcm16", "voice": "mimo_default"}+ json.loads(requests[0].content)["audio"], {"format": "pcm16", "voice": "account-voice"})self.assertEqual(str(requests[0].url), config.base_url)@@ -152,12 +153,12 @@ class MiMoTTSTests(unittest.IsolatedAsyncioTestCase):config = resolve_tts_runtime_config(catalog, service=service)self.assertEqual(config.provider_name, "xiaomi_mimo")self.assertEqual(config.adapter, "mimo_tts")- self.assertEqual(config.voice, "mimo_default")+ self.assertEqual(config.voice, "")self.assertEqual(config.response_format, "wav")self.assertEqual(config.api_key, "test-key")self.assertIsInstance(get_tts_adapter(config.adapter), MiMoTTSAdapter)options = voice_model_options("xiaomi_mimo", "tts", config.model)- self.assertIn("苏打", [v["id"] for v in options["voices"]])+ self.assertEqual(options["voices"], [])self.assertTrue(options["instructions"])diff --git a/tests/services/test_minimax_voice.py b/tests/services/test_minimax_voice.pyindex 2a87857a9..623a990eb 100644--- a/tests/services/test_minimax_voice.py+++ b/tests/services/test_minimax_voice.py@@ -196,7 +196,7 @@ async def test_catalog_defaults_drive_read_aloud_and_request_overrides(monkeypatassert resolved.adapter == resolved.provider_name == "minimax"assert resolved.model == TTS_PROVIDERS["minimax"].default_model == "speech-2.8-hd"assert resolved.base_url == "https://api.minimax.io/v1"- assert resolved.voice == "English_expressive_narrator"+ assert resolved.voice == ""assert resolved.response_format == "mp3"def handle(request):diff --git a/tests/services/test_provider_probe.py b/tests/services/test_provider_probe.pyindex 290050e0c..9ddfceefa 100644--- a/tests/services/test_provider_probe.py+++ b/tests/services/test_provider_probe.py@@ -341,10 +341,10 @@ async def test_invalid_addresses_are_actionable_without_network_requests(monkeyp"inputs,outputs,expected",[(["image", "video"], ["text"], {"llm"}),- (["text"], ["audio"], {"voice"}),- (["audio"], ["text"], {"llm", "voice"}),- (["text"], ["image"], {"generation"}),- (["image"], ["video", "audio"], {"generation", "voice"}),+ (["text"], ["audio"], {"tts", "voice"}),+ (["audio"], ["text"], {"llm"}),+ (["text"], ["image"], {"generation", "imagegen"}),+ (["image"], ["video", "audio"], {"generation", "videogen", "tts", "voice"}),(["IMAGE"], ["TEXT"], {"llm"}),],)@@ -353,3 +353,110 @@ def test_voice_and_visual_generation_detection_are_independent(inputs, outputs,[{"architecture": {"input_modalities": inputs, "output_modalities": outputs}}])assert {item["category"] for item in result} == expected+++async def test_openrouter_requests_all_output_types_without_guessing_model_names(monkeypatch):+ session = install(+ monkeypatch,+ Response(+ payload={+ "data": [+ {"id": "image-looking-name"},+ {"id": "actual-image", "architecture": {"output_modalities": ["image"]}},+ ]+ }+ ),+ )+ result = await provider_probe.probe_provider(+ "openrouter", "https://openrouter.ai/api/v1", "key"+ )+ assert session.requests[0][1]["params"] == {"output_modalities": "all"}+ assert result["models"] == [+ {"id": "image-looking-name"},+ {"id": "actual-image", "services": ["imagegen"]},+ ]+++async def test_aliyun_catalog_paginates_on_configured_region_with_explicit_types(monkeypatch):+ session = install(monkeypatch, None)+ pages = [+ Response(payload={"output": {"total": 2, "page_no": page, "models": [model]}})+ for page, model in enumerate(+ [+ {"model": "speech", "capabilities": ["TTS"]},+ {+ "model": "transcribe",+ "capabilities": ["ASR"],+ "inference_metadata": {"response_modality": ["Text"]},+ },+ ],+ 1,+ )+ ]++ def get(url, **kwargs):+ session.requests.append((url, kwargs))+ return pages.pop(0)++ session.get = get+ result = await provider_probe.probe_provider(+ "dashscope", "https://dashscope-intl.aliyuncs.com/compatible-mode/v1", "key"+ )+ assert [request[0] for request in session.requests] == [+ "https://dashscope-intl.aliyuncs.com/api/v1/models"+ ] * 2+ assert [request[1]["params"]["page_no"] for request in session.requests] == [1, 2]+ assert all(+ request[1]["headers"]["Authorization"] == "Bearer key" for request in session.requests+ )+ assert result["models"] == [+ {"id": "speech", "services": ["tts"]},+ {"id": "transcribe", "services": ["stt"]},+ ]+++async def test_custom_anthropic_catalog_follows_cursors_and_uses_messages_auth(monkeypatch):+ session = install(monkeypatch, None)+ pages = [+ Response(payload={"data": [{"id": "first"}], "has_more": True, "last_id": "first"}),+ Response(payload={"data": [{"id": "second"}], "has_more": False}),+ ]++ def get(url, **kwargs):+ session.requests.append((url, kwargs))+ return pages.pop(0)++ session.get = get+ result = await provider_probe.probe_provider(+ "custom", "https://gateway.test/v1", "key", api_format="anthropic"+ )+ assert result["models"] == [{"id": "first"}, {"id": "second"}]+ assert session.requests[1][1]["params"] == {"after_id": "first"}+ assert session.requests[0][1]["headers"]["x-api-key"] == "key"+ assert not session.requests[0][1]["allow_redirects"]+++async def test_broken_pagination_stops_with_partial_warning(monkeypatch):+ session = install(+ monkeypatch,+ Response(payload={"output": {"total": 20, "page_no": 1, "models": [{"model": "one"}]}}),+ )+ result = await provider_probe.probe_provider(+ "dashscope", "https://dashscope.aliyuncs.com/compatible-mode/v1", "key"+ )+ assert result["models"] == [{"id": "one"}]+ assert result["warning"] == "partial_models"+ assert len(session.requests) == 2+++def test_malformed_metadata_is_ignored():+ assert (+ provider_probe.model_services(+ {"type": {}, "capabilities": None, "supportedGenerationMethods": [{}]}+ )+ == []+ )diff --git a/tests/services/test_provider_registry_workflow.py b/tests/services/test_provider_registry_workflow.pyindex 940b69520..9bcbe9b8e 100644--- a/tests/services/test_provider_registry_workflow.py+++ b/tests/services/test_provider_registry_workflow.py@@ -381,7 +381,10 @@ def test_capability_detection_uses_metadata_not_names():"architecture": {"input_modalities": ["text"], "output_modalities": ["image"]},}]- ) == [{"category": "generation", "evidence": "metadata"}]+ ) == [+ {"category": "generation", "evidence": "metadata"},+ {"category": "imagegen", "evidence": "metadata"},+ ]assert detect_capabilities([{"supportedGenerationMethods": ["embedContent"]},@@ -492,3 +495,45 @@ def test_managed_account_and_model_names_survive_catalog_refresh(tmp_path):)assert managed["name"] == "My signed-in account"assert managed["models"][0]["name"] == "My model label"++[email protected]("link", ["reference", "legacy_connection"])+def test_manual_service_adapter_and_url_survive_save_and_reach_runtime(tmp_path, link):+ store, catalog = fixture(tmp_path)+ overrides = {+ "tts": {"enabled": True, "binding": "minimax", "base_url": "https://speech.test/v1"}+ }+ catalog = merge_registry_edit(catalog, provider_edit(service_overrides=overrides))+ profile = catalog["services"]["tts"]["profiles"][0]+ if link == "reference":+ profile["provider_ref"] = {"connection_id": "account", "binding": "custom"}+ else:+ profile["connection_id"] = "account"+ saved = store.save(catalog)+ source = next(c for c in saved["connections"] if c["id"] == "account")+ assert source["service_overrides"] == overrides+ resolved = resolve_profile_provider(saved, "tts", saved["services"]["tts"]["profiles"][0])+ assert resolved["binding"] == "minimax"+ assert resolved["base_url"] == "https://speech.test/v1"+ assert resolved["api_key"] == "new-secret"+++def test_manual_service_changes_do_not_rekey_or_remove_existing_models(tmp_path):+ store, catalog = fixture(tmp_path)+ before = deepcopy(catalog["services"])+ catalog = merge_registry_edit(+ catalog,+ {+ "kind": "provider",+ "ref": {"service": "llm", "profile_id": "llm"},+ "fields": {+ "service_overrides": {+ "llm": {"enabled": False},+ "tts": {"enabled": True, "binding": "custom"},+ }+ },+ },+ )+ saved = store.save(catalog)+ saved["services"]["llm"]["profiles"][0].pop("service_overrides")+ assert saved["services"] == beforediff --git a/tests/services/test_settings_service_preview.py b/tests/services/test_settings_service_preview.pynew file mode 100644index 000000000..b538df759--- /dev/null+++ b/tests/services/test_settings_service_preview.py@@ -0,0 +1,297 @@+import asyncio+import base64+from copy import deepcopy+from types import SimpleNamespace++import httpx+import pytest++from deeptutor.services.settings import service_preview as preview+from deeptutor.services.voice import discovery+from deeptutor.services.voice.options import voice_options+++def catalog(service="tts", provider="minimax", model="speech-2.8-hd"):+ return {+ "version": 1,+ "services": {+ service: {+ "active_profile_id": "p",+ "active_model_id": "old",+ "profiles": [+ {+ "id": "p",+ "binding": provider,+ "provider": provider,+ "api_key": "test-secret",+ "base_url": "https://vendor.test/v1",+ "models": [+ {"id": "old", "model": "old-model"},+ {"id": "edited", "model": model},+ ],+ }+ ],+ }+ },+ }+++def mock_client(monkeypatch, handler):+ real_client = httpx.AsyncClient+ monkeypatch.setattr(+ discovery.httpx,+ "AsyncClient",+ lambda **kwargs: real_client(transport=httpx.MockTransport(handler), **kwargs),+ )+++async def test_minimax_queries_live_each_time_and_preserves_catalog(monkeypatch):+ calls = []++ def handler(request):+ calls.append(request)+ assert request.url == "https://vendor.test/v1/get_voice"+ assert request.headers["authorization"] == "Bearer test-secret"+ return httpx.Response(+ 200,+ json={+ "base_resp": {"status_code": 0},+ "system_voice": [{"voice_id": f"live-{len(calls)}", "voice_name": "Live"}],+ },+ )++ mock_client(monkeypatch, handler)+ draft = catalog()+ before = deepcopy(draft)+ first = await discovery.discover_voices(draft, "p", "edited")+ second = await discovery.discover_voices(draft, "p", "edited")+ assert first["voices"][0]["id"] == "live-1"+ assert second["voices"][0]["id"] == "live-2"+ assert first["scope"] == "account" and draft == before+++ "provider,model",+ [+ ("openai", "gpt-4o-mini-tts"),+ ("volcengine_speech", "seed-tts-2.0"),+ ("dashscope", "qwen3-tts-flash"),+ ],+)+async def test_unsupported_never_guesses_a_voice_endpoint(monkeypatch, provider, model):+ def handler(request):+ pytest.fail("Unsupported lookup must not send credentials")++ mock_client(monkeypatch, handler)+ result = await discovery.discover_voices(catalog(provider=provider, model=model), "p", "edited")+ assert result == {"status": "unsupported", "voices": [], "scope": "none"}+++async def test_dashscope_verifies_each_custom_voice_target_model(monkeypatch):+ import json++ def handler(request):+ body = json.loads(request.content)+ action = body["input"]["action"]+ if action == "list_voice":+ return httpx.Response(+ 200,+ json={+ "output": {+ "voice_list": [+ {"voice_id": "match", "status": "OK"},+ {"voice_id": "other", "status": "OK"},+ {"voice_id": "pending", "status": "DEPLOYING"},+ ]+ }+ },+ )+ return httpx.Response(+ 200,+ json={+ "output": {+ "target_model": "qwen-audio-3.0-tts-plus"+ if body["input"]["voice_id"] == "match"+ else "wrong-model"+ }+ },+ )++ mock_client(monkeypatch, handler)+ result = await discovery.discover_voices(+ catalog(provider="dashscope", model="qwen-audio-3.0-tts-plus"), "p", "edited"+ )+ assert result["voices"] == [{"id": "match", "label": "match"}]+ assert result["scope"] == "custom"+++ "status,body",+ [+ (401, {"detail": "test-secret"}),+ (200, {"base_resp": {"status_code": 1004, "status_msg": "test-secret"}}),+ (200, []),+ ],+)+async def test_voice_errors_are_not_empty_success_or_secret_echo(monkeypatch, status, body):+ mock_client(monkeypatch, lambda req: httpx.Response(status, json=body))+ with pytest.raises(discovery.VoiceDiscoveryError) as exc:+ await discovery.discover_voices(catalog(), "p", "edited")+ assert "test-secret" not in str(exc.value)+++def test_voice_hints_never_ship_voice_ids():+ for provider in (+ "openai",+ "azure_openai",+ "openrouter",+ "minimax",+ "dashscope",+ "volcengine_speech",+ "groq",+ "siliconflow",+ "xiaomi_mimo",+ ):+ options = voice_options(provider, "tts")+ assert all(model["voices"] == [] for model in [*options["models"], options["fallback"]])+++async def collect(service, **kwargs):+ return [+ event+ async for event in preview.preview_events(+ catalog(service), service, "p", "edited", "example", **kwargs+ )+ ]+++async def test_search_uses_query_and_no_fallback_and_returns_results(monkeypatch):+ from deeptutor.services.config import provider_runtime+ from deeptutor.services.settings import provider_probe++ monkeypatch.setattr(+ provider_runtime,+ "resolve_search_runtime_config",+ lambda **kw: SimpleNamespace(+ requested_provider="brave", base_url="test", api_key="key", proxy="", max_results=5+ ),+ )++ def search(*args, **kwargs):+ assert (+ args[0] == "brave"+ and kwargs["query"] == "example"+ and kwargs["require_results"] is False+ )+ return SimpleNamespace(+ answer="",+ citations=[],+ search_results=[+ SimpleNamespace(title="Title", url="https://example.org", snippet="Result")+ ],+ )++ monkeypatch.setattr(provider_probe, "test_search_access", search)+ events = await collect("search")+ assert events[-1]["results"][0]["title"] == "Title"+++async def test_stt_transcribes_actual_audio_against_draft_selection(monkeypatch):+ from deeptutor.services import voice++ async def transcribe(raw, **kwargs):+ assert raw == b"real sample" and kwargs["filename"] == "sample.wav"+ assert kwargs["catalog"]["services"]["stt"]["active_model_id"] == "edited"+ return "Recognized words"++ monkeypatch.setattr(voice, "transcribe_audio", transcribe)+ assert (await collect("stt", audio=b"real sample", content_type="audio/wav"))[-1][+ "text"+ ] == "Recognized words"+++async def test_image_returns_only_completed_media(monkeypatch):+ from deeptutor.services import imagegen++ async def generate(*args, **kwargs):+ assert kwargs["n"] == 1+ return [(b"image", "image/png")]++ monkeypatch.setattr(imagegen, "generate_image", generate)+ result = (await collect("imagegen"))[-1]+ assert result["kind"] == "image" and base64.b64decode(result["data"]) == b"image"+++async def test_video_does_not_succeed_when_task_is_only_submitted(monkeypatch):+ from deeptutor.services import videogen++ accepted = asyncio.Event()+ finish = asyncio.Event()++ async def generate(*args, progress, **kwargs):+ await progress("submitted with secret-url")+ accepted.set()+ await finish.wait()+ return b"video", "video/mp4"++ monkeypatch.setattr(videogen, "generate_video", generate)+ stream = preview.preview_events(catalog("videogen"), "videogen", "p", "edited", "prompt")+ assert (await anext(stream))["phase"] == "requesting"+ event = await anext(stream)+ assert event == {"type": "progress", "phase": "rendering"}+ finish.set()+ assert (await anext(stream))["kind"] == "video"+ await stream.aclose()+++async def test_disconnect_cancels_video_polling(monkeypatch):+ from deeptutor.services import videogen++ stopped = asyncio.Event()++ async def generate(*args, progress, **kwargs):+ try:+ await progress("submitted")+ await asyncio.Event().wait()+ finally:+ stopped.set()++ monkeypatch.setattr(videogen, "generate_video", generate)+ stream = preview.preview_events(catalog("videogen"), "videogen", "p", "edited", "prompt")+ await anext(stream)+ await anext(stream)+ await stream.aclose()+ assert stopped.is_set()+++async def test_preview_failure_redacts_provider_errors(monkeypatch):+ from deeptutor.services import imagegen++ async def generate(*args, **kwargs):+ raise ValueError("secret-key, upstream request body")++ monkeypatch.setattr(imagegen, "generate_image", generate)+ assert (await collect("imagegen"))[-1] == {"type": "error", "code": "failed"}+++def test_input_limits_and_non_media_results():+ with pytest.raises(ValueError):+ preview.validate_input("stt", "", "bad!", "audio/wav")+ with pytest.raises(ValueError):+ preview.validate_input("search", " ", "", "")+ with pytest.raises(ValueError):+ preview.media_result(b"<script>", "text/html", "image")+ assert (+ preview.validate_input("stt", "", base64.b64encode(b"sample").decode(), "audio/wav")+ == b"sample"+ )diff --git a/tests/services/test_voice.py b/tests/services/test_voice.pyindex 8172955cd..ee9b52832 100644--- a/tests/services/test_voice.py+++ b/tests/services/test_voice.py@@ -815,7 +815,7 @@ def test_resolve_dashscope_voice_configs() -> None:assert tts.provider_name == "dashscope"assert tts.adapter == "dashscope"assert tts.model == "qwen3-tts-flash"- assert tts.voice == "Cherry"+ assert tts.voice == "" # Voice IDs must be selected explicitly.assert tts.base_url == "https://dashscope.aliyuncs.com/api/v1"assert stt.provider_name == "dashscope"assert stt.adapter == "dashscope"diff --git a/tests/services/test_volcengine_voice.py b/tests/services/test_volcengine_voice.pyindex 59d031283..167ab0a70 100644--- a/tests/services/test_volcengine_voice.py+++ b/tests/services/test_volcengine_voice.py@@ -194,13 +194,13 @@ def test_model_specific_defaults_and_shared_legacy_credentials():assert config.provider_name == "volcengine_speech"assert config.app_id == "legacy" and config.api_key == "secret"assert config.base_url == "https://openspeech.bytedance.com/api/v3"- assert config.voice == "zh_female_vv_uranus_bigtts"- assert resolve_tts_runtime_config(catalog(model="seed-tts-1.0")).voice.endswith("moon_bigtts")+ assert config.voice == ""+ assert resolve_tts_runtime_config(catalog(model="seed-tts-1.0")).voice == ""assert (resolve_tts_runtime_config(catalog("openrouter", "google/gemini-3.1-flash-tts-preview")).voice- == "Kore"+ == "")assert (resolve_tts_runtime_config(catalog("groq", "canopylabs/orpheus-v1-english")).response_format@@ -216,30 +216,28 @@ def test_voice_choices_are_per_model_and_unknown_models_have_no_false_voice_defaassert "marin" not in [v["id"] for v in voice_model_options("openai", "tts", "tts-1-hd")["voices"]]- assert "marin" in [+ assert "marin" not in [v["id"]for v in voice_model_options("openai", "tts", "gpt-4o-mini-tts-2025-12-15")["voices"]]assert voice_model_options("openrouter", "tts", "private/voice-model")["voices"] == []assert voice_model_options("dashscope", "tts", "qwen3-tts-instruct-flash")["instructions"]- assert voice_model_options("siliconflow", "tts", "FunAudioLLM/CosyVoice2-0.5B")["voices"][0][- "id"- ].endswith(":alex")+ assert voice_model_options("siliconflow", "tts", "FunAudioLLM/CosyVoice2-0.5B")["voices"] == []def test_qwen_audio_defaults_and_hints_match_the_selected_model():plus = catalog("dashscope", "qwen-audio-3.0-tts-plus")before = deepcopy(plus)config = resolve_tts_runtime_config(plus)- assert config.voice == "longanlingxin" and config.response_format == "mp3"+ assert config.voice == "" and config.response_format == "mp3"assert plus == beforeoptions = voice_model_options("dashscope", "tts", "qwen-audio-3.0-tts-plus")- assert [v["id"] for v in options["voices"]] == ["longanlingxin", "longanlufeng"]+ assert options["voices"] == []assert options["docs_url"].endswith("qwen-audio-tts-voice-list")assert "Beijing" in options["configuration_note"]assert (resolve_tts_runtime_config(catalog("dashscope", "qwen-audio-3.0-tts-flash")).voice- == "longanfengyue"+ == "")# Future Qwen-Audio models must not silently acquire Qwen3's Cherry voice.assert resolve_tts_runtime_config(catalog("dashscope", "qwen-audio-9.0-tts-plus")).voice == ""diff --git a/tests/services/workspace/test_data_migration.py b/tests/services/workspace/test_data_migration.pyindex b31a5443f..71fea7bf3 100644--- a/tests/services/workspace/test_data_migration.py+++ b/tests/services/workspace/test_data_migration.py@@ -15,25 +15,66 @@ from deeptutor.services.workspace.models import WorkspaceErrorfrom tests.services.workspace.test_data_scope import account as account-def test_task_board_export_and_migration_preserve_archived_cards(account):+def test_independent_task_board_is_not_part_of_workspace_data_migration(account):from deeptutor.services.task_board import CreateCard, UpdateCard, get_task_board_store- from deeptutor.services.workspace.data_migration import export_pathtarget = account.create_workspace("Destination")["workspace_id"]with workspace_context():store = get_task_board_store()card = store.create(CreateCard(title="Review examples")).cards[0]expected = store.update(card.id, UpdateCard(status="done", archived=True))- feature = next(row for row in discover()["features"] if row["feature"] == "task-board")- assert not feature["error"]- exported = export_data("", ["task-board"])- with zipfile.ZipFile(export_path(exported["id"])) as archive:- assert any(name.endswith("cards.sqlite") for name in archive.namelist())- assert migrate_data("", target, ["task-board"])["status"] == "completed"+ assert "task-board" not in {row["feature"] for row in discover()["features"]}with workspace_context(target):assert get_task_board_store().read() == expectedwith workspace_context():- assert get_task_board_store().read().cards == []+ assert get_task_board_store().read() == expected++[email protected]("interrupt_links", [False, True])+async def test_conversation_move_preserves_task_links_and_recovers_cleanup(+ account, monkeypatch, interrupt_links+):+ from deeptutor.services.task_board import (+ CreateCard,+ LinkStatus,+ LinkTasks,+ TaskBoardStore,+ get_task_board_store,+ )+ from deeptutor.services.workspace.data_migration import operations, recover_operation+ from deeptutor.services.workspace.session_move import move_chat++ target = account.create_workspace("Destination")["workspace_id"]+ session = await get_sqlite_session_store().create_session("Task conversation")+ board = get_task_board_store()+ first = board.create(CreateCard(title="First")).cards[-1]+ second = board.create(CreateCard(title="Latest")).cards[-1]+ board.link_tasks(session["id"], LinkTasks(task_ids=[first.id, second.id]))+ board.link_status(session["id"], LinkStatus(enabled=False))+ original = TaskBoardStore.move_session_links+ if interrupt_links:++ def interrupted(*_args, **_kwargs):+ raise RuntimeError("interrupted task association cleanup")++ monkeypatch.setattr(TaskBoardStore, "move_session_links", interrupted)+ with pytest.raises(RuntimeError, match="cleanup"):+ move_chat(session["id"], target)+ operation = operations()[0]+ assert operation["status"] == "cleanup_required"+ monkeypatch.setattr(TaskBoardStore, "move_session_links", original)+ assert recover_operation(operation["id"])["status"] == "completed"+ else:+ move_chat(session["id"], target)+ links = board.read().session_links+ assert len(links) == 1+ assert links[0].workspace_id == target+ assert links[0].task_ids == [first.id, second.id]+ assert not links[0].status_link_enabled+ assert all(card.workspace_id is None for card in board.read().cards)+ with workspace_context(target):+ assert await get_sqlite_session_store().get_session(session["id"]) is not None@pytest.mark.asynciodiff --git a/web/app/(utility)/agents/page.tsx b/web/app/(utility)/agents/page.tsxindex a672c266a..b43b29e39 100644--- a/web/app/(utility)/agents/page.tsx+++ b/web/app/(utility)/agents/page.tsx@@ -1,11 +1,6 @@import AgentsHub from "@/components/agents/AgentsHub";+import { FeaturePage } from "@/components/layout/FeaturePage";export default function AgentsPage() {- return (- <div className="h-full overflow-y-auto [scrollbar-gutter:stable]">- <div className="mx-auto max-w-6xl px-6 py-10 pb-16 md:px-10">- <AgentsHub />- </div>- </div>- );+ return <FeaturePage><AgentsHub /></FeaturePage>;}diff --git a/web/app/(utility)/courses/[courseId]/page.tsx b/web/app/(utility)/courses/[courseId]/page.tsxindex a579b9d60..08cb8fb1e 100644--- a/web/app/(utility)/courses/[courseId]/page.tsx+++ b/web/app/(utility)/courses/[courseId]/page.tsx@@ -1,5 +1,6 @@"use client";+import { PageHeader, pageActionClass, pageGridClass } from '@/components/layout/FeaturePage'import { useCallback, useEffect, useMemo, useState } from "react";import Link from "next/link";import { useParams, useRouter } from "next/navigation";@@ -240,33 +241,15 @@ export default function CourseDetailPage() {{t("Courses")}</Link></div>- <header className="relative overflow-visible rounded-2xl border border-[var(--border)] bg-[var(--card)] p-6">- <div className="flex items-start justify-between gap-5">- <div className="min-w-0">- <h1 className="flex items-center gap-2.5 font-serif text-[28px] font-semibold leading-tight tracking-tight text-[var(--foreground)]">- <span- className="h-2 w-2 shrink-0 rounded-full"- style={{ backgroundColor: course.color }}- aria-hidden- />- {course.name}- {course.status === "archived" ? (- <span className="rounded-full border border-[var(--border)] px-2 py-0.5 text-[11px] font-normal tracking-normal text-[var(--muted-foreground)]">- {t("Archived")}- </span>- ) : null}- </h1>- <p className="mt-2 max-w-2xl text-[13px] leading-relaxed text-[var(--muted-foreground)]">- {course.description || t("A focused home for this subject.")}- </p>- <p className="mt-3 text-[11px] text-[var(--muted-foreground)]/75">- {t("{{count}} active conversations", { count: rootCount })}- </p>- </div>+ <PageHeader+ title={course.name}+ description={course.description || t("A focused home for this subject.")}+ meta={course.status === "archived" ? <span className="rounded-full border border-[var(--border)] px-2 py-0.5 text-[11px] text-[var(--muted-foreground)]">{t("Archived")}</span> : null}+ action={<div className="relative flex shrink-0 items-center gap-2"><Linkhref={`/chat?course=${encodeURIComponent(course.id)}&capability=course_study`}- className="inline-flex items-center gap-1.5 rounded-lg bg-[var(--foreground)] px-3 py-2 text-[12px] font-medium text-[var(--background)] hover:opacity-90 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[var(--ring)]"+ className={pageActionClass()}><Signpost size={14} />{t("Start course study")}@@ -334,8 +317,11 @@ export default function CourseDetailPage() {</div>) : null}</div>- </div>- </header>+ }+ />+ <p className="-mt-3 mb-6 text-[11px] text-[var(--muted-foreground)]">+ {t("{{count}} active conversations", { count: rootCount })}+ </p><div className="mt-4"><CourseNextStep state={state} courseId={courseId} />@@ -353,7 +339,7 @@ export default function CourseDetailPage() {/></div>- <div className="mt-4 grid gap-4 lg:grid-cols-2">+ <div className={`mt-4 ${pageGridClass(2)}`}><CourseResourcescourseId={course.id}resources={state?.resources ?? []}diff --git a/web/app/(utility)/courses/layout.tsx b/web/app/(utility)/courses/layout.tsxindex 263beb01c..48eeac6af 100644--- a/web/app/(utility)/courses/layout.tsx+++ b/web/app/(utility)/courses/layout.tsx@@ -1,3 +1,5 @@+import { FeaturePage } from "@/components/layout/FeaturePage";+/*** Page shell for the Courses surface.*@@ -11,8 +13,6 @@ export default function CoursesLayout({children,}: Readonly<{ children: React.ReactNode }>) {return (- <div className="h-full overflow-y-auto bg-[var(--background)] [scrollbar-gutter:stable]">- <div className="mx-auto max-w-5xl px-8 py-8 pb-12">{children}</div>- </div>+ <FeaturePage>{children}</FeaturePage>);}diff --git a/web/app/(utility)/memory/page.tsx b/web/app/(utility)/memory/page.tsxindex 3beb1d47d..736a081b1 100644--- a/web/app/(utility)/memory/page.tsx+++ b/web/app/(utility)/memory/page.tsx@@ -1,11 +1,6 @@import MemoryHub from "@/components/memory/MemoryHub";+import { FeaturePage } from "@/components/layout/FeaturePage";export default function MemoryPage() {- return (- <div className="h-full overflow-y-auto [scrollbar-gutter:stable]">- <div className="mx-auto max-w-6xl px-6 py-10 pb-16 md:px-10">- <MemoryHub />- </div>- </div>- );+ return <FeaturePage><MemoryHub /></FeaturePage>;}diff --git a/web/app/(utility)/profile/page.tsx b/web/app/(utility)/profile/page.tsxindex a4f9df246..ab63fd2d6 100644--- a/web/app/(utility)/profile/page.tsx+++ b/web/app/(utility)/profile/page.tsx@@ -1,5 +1,6 @@"use client";+import { FeaturePage, PageHeader } from '@/components/layout/FeaturePage'import { useCallback, useEffect, useRef, useState } from "react";import Link from "next/link";import { useRouter } from "next/navigation";@@ -207,10 +208,9 @@ export default function ProfilePage() {: null;return (- <div className="h-screen overflow-y-auto bg-[var(--background)] px-4 py-10 [scrollbar-gutter:stable]">- <div className="mx-auto max-w-2xl">+ <FeaturePage>{/* Header */}- <div className="mb-8">+ <div><Linkhref="/"className="mb-4 inline-flex items-center gap-1.5 text-sm text-[var(--muted-foreground)] hover:text-[var(--foreground)] transition-colors"@@ -218,14 +218,7 @@ export default function ProfilePage() {<ArrowLeft size={16} />{t("Back")}</Link>- <div>- <h1 className="text-xl font-semibold text-[var(--foreground)]">- {t("My profile")}- </h1>- <p className="mt-0.5 text-sm text-[var(--muted-foreground)]">- {t("View your account and personalize your avatar")}- </p>- </div>+ <PageHeader title={t("My profile")} description={t("View your account and personalize your avatar")} /></div>{error && (@@ -408,7 +401,6 @@ export default function ProfilePage() {</div></>)}- </div>- </div>+ </FeaturePage>);}diff --git a/web/app/(utility)/settings/progress/page.tsx b/web/app/(utility)/settings/progress/page.tsxindex b605de5fb..9504fb36e 100644--- a/web/app/(utility)/settings/progress/page.tsx+++ b/web/app/(utility)/settings/progress/page.tsx@@ -1,5 +1,6 @@"use client";+import { FeaturePage, PageHeader } from '@/components/layout/FeaturePage'import { useEffect, useState } from "react";import { useTranslation } from "react-i18next";@@ -37,11 +38,8 @@ export default function LearningProgressPage() {const hasRecords = progress.length > 0 || activities.length > 0;return (- <main className="mx-auto max-w-3xl px-6 py-8">- <h1 className="text-xl font-semibold">{t("Learning progress")}</h1>- <p className="mt-1 text-sm text-[var(--muted-foreground)]">- {t("Review your own reading and learning activity.")}- </p>+ <FeaturePage>+ <PageHeader title={t("Learning progress")} description={t("Review your own reading and learning activity.")} />{error ? (<p className="mt-8 text-sm text-red-600">{t("Unable to load learning progress")}</p>) : records === null ? (@@ -111,6 +109,6 @@ export default function LearningProgressPage() {</section></>)}- </main>+ </FeaturePage>);}diff --git a/web/app/(workspace)/co-writer/page.tsx b/web/app/(workspace)/co-writer/page.tsxindex 434511d97..90753f0c1 100644--- a/web/app/(workspace)/co-writer/page.tsx+++ b/web/app/(workspace)/co-writer/page.tsx@@ -1,5 +1,6 @@"use client";+import { FeaturePage, PageHeader, pageActionClass, pageGridClass } from '@/components/layout/FeaturePage'import { useCallback, useEffect, useRef, useState } from "react";import { useRouter } from "next/navigation";import { useTranslation } from "react-i18next";@@ -133,7 +134,7 @@ export default function CoWriterHomePage() {type="button"onClick={() => handleCreate(false)}disabled={creating || importing}- className="inline-flex items-center gap-1.5 rounded-lg bg-[var(--primary)] px-3.5 py-2 text-[12.5px] font-medium text-[var(--primary-foreground)] transition-opacity hover:opacity-90 disabled:opacity-60"+ className={pageActionClass()}>{creating ? (<Loader2 size={14} className="animate-spin" />@@ -146,7 +147,7 @@ export default function CoWriterHomePage() {type="button"onClick={() => handleCreate(true)}disabled={creating || importing}- className="inline-flex items-center gap-1.5 rounded-lg border border-[var(--border)] px-3.5 py-2 text-[12.5px] font-medium text-[var(--foreground)] transition-colors hover:bg-[var(--muted)] disabled:opacity-60"+ className={pageActionClass('secondary')}><FileText size={14} />{t("Start from template")}@@ -155,7 +156,7 @@ export default function CoWriterHomePage() {type="button"onClick={() => importInputRef.current?.click()}disabled={creating || importing}- className="inline-flex items-center gap-1.5 rounded-lg border border-[var(--border)] px-3.5 py-2 text-[12.5px] font-medium text-[var(--foreground)] transition-colors hover:bg-[var(--muted)] disabled:opacity-60"+ className={pageActionClass('secondary')}>{importing ? (<Loader2 size={14} className="animate-spin" />@@ -169,7 +170,7 @@ export default function CoWriterHomePage() {);return (- <div className="h-full overflow-y-auto bg-[var(--background)]">+ <FeaturePage><inputref={importInputRef}type="file"@@ -181,22 +182,16 @@ export default function CoWriterHomePage() {void handleImportDocx(file);}}/>- <div className="mx-auto max-w-5xl px-6 py-8">- <header className="mb-7 flex items-end justify-between gap-4">- <div>- <h1 className="text-[19px] font-semibold tracking-tight text-[var(--foreground)]">- {t("Co-Writer")}- </h1>- <p className="mt-1 text-[12.5px] text-[var(--muted-foreground)]">- {t("Manage your markdown drafts and projects.")}- </p>- </div>+ <PageHeader+ title={t("Co-Writer")}+ description={t("Manage your markdown drafts and projects.")}+ action={<div className="flex shrink-0 items-center gap-2"><buttontype="button"onClick={() => importInputRef.current?.click()}disabled={creating || importing}- className="inline-flex items-center gap-1.5 rounded-lg border border-[var(--border)] px-3.5 py-2 text-[12.5px] font-medium text-[var(--foreground)] transition-colors hover:bg-[var(--muted)] disabled:opacity-60"+ className={pageActionClass('secondary')}>{importing ? (<Loader2 size={14} className="animate-spin" />@@ -209,7 +204,7 @@ export default function CoWriterHomePage() {type="button"onClick={() => handleCreate(true)}disabled={creating || importing}- className="inline-flex items-center gap-1.5 rounded-lg border border-[var(--border)] px-3.5 py-2 text-[12.5px] font-medium text-[var(--foreground)] transition-colors hover:bg-[var(--muted)] disabled:opacity-60"+ className={pageActionClass('secondary')}><FileText size={14} />{t("From template")}@@ -218,7 +213,7 @@ export default function CoWriterHomePage() {type="button"onClick={() => handleCreate(false)}disabled={creating || importing}- className="inline-flex items-center gap-1.5 rounded-lg bg-[var(--primary)] px-3.5 py-2 text-[12.5px] font-medium text-[var(--primary-foreground)] transition-opacity hover:opacity-90 disabled:opacity-60"+ className={pageActionClass()}>{creating ? (<Loader2 size={14} className="animate-spin" />@@ -228,7 +223,8 @@ export default function CoWriterHomePage() {{t("New draft")}</button></div>- </header>+ }+ />{error ? (<div className="mb-4 rounded-lg border border-rose-300/30 bg-rose-50/40 px-3 py-2 text-[12px] text-rose-700 dark:bg-rose-950/30 dark:text-rose-300">@@ -244,7 +240,7 @@ export default function CoWriterHomePage() {) : documents.length === 0 ? (renderEmpty()) : (- <div className="grid grid-cols-1 gap-3 sm:grid-cols-2 xl:grid-cols-3">+ <div className={pageGridClass(3)}>{documents.map((doc) => {const isPendingDelete = pendingDeleteId === doc.id;const isDeleting = deletingId === doc.id;@@ -318,7 +314,6 @@ export default function CoWriterHomePage() {})}</div>)}- </div>- </div>+ </FeaturePage>);}diff --git a/web/app/(workspace)/kanban/page.tsx b/web/app/(workspace)/kanban/page.tsxindex b4f3f218d..22d9c04df 100644--- a/web/app/(workspace)/kanban/page.tsx+++ b/web/app/(workspace)/kanban/page.tsx@@ -1,12 +1,17 @@'use client'-import { useEffect, useRef, useState } from 'react'+import { FeaturePage, pageGridClass } from '@/components/layout/FeaturePage'+import { useRef, useState } from 'react'import {Archive,ArrowLeft,ArrowRight,Check,- ClipboardList,+ ChevronDown,+ CircleCheck,+ CircleDashed,+ CircleDot,+ Folder,Plus,RotateCcw,X,@@ -14,25 +19,31 @@ import {import { useTranslation } from 'react-i18next'import SpaceSectionHeader from '@/components/space/SpaceSectionHeader'import Tooltip from '@/shared/ui/Tooltip'+import TaskColorPicker from '@/components/tasks/TaskColorPicker'import {createTaskCard,- getTaskBoard,+ updateTaskColors,+ DEFAULT_TASK_COLORS,updateTaskCard,type TaskBoard,type TaskCard,type TaskStatus,} from '@/lib/task-board-api'-const columns: { id: TaskStatus; title: string; hint: string; tone: string }[] = [- { id: 'todo', title: 'kanban.todo', hint: 'kanban.todoHint', tone: 'var(--info)' },- { id: 'doing', title: 'kanban.doing', hint: 'kanban.doingHint', tone: 'var(--warning)' },- { id: 'done', title: 'kanban.done', hint: 'kanban.doneHint', tone: 'var(--success)' },-]+import { useTaskBoard, refreshTaskBoard } from '@/lib/task-board-store'+import { useChatWorkspaces } from '@/hooks/useChatWorkspaces'++const columns = [+ { id: 'todo', title: 'kanban.todo', hint: 'kanban.todoHint', icon: CircleDashed },+ { id: 'doing', title: 'kanban.doing', hint: 'kanban.doingHint', icon: CircleDot },+ { id: 'done', title: 'kanban.done', hint: 'kanban.doneHint', icon: CircleCheck },+] as constexport default function KanbanPage() {const { t } = useTranslation()- const [board, setBoard] = useState<TaskBoard | null>(null)+ const { board, error: loadError } = useTaskBoard()+ const { workspaces } = useChatWorkspaces()const [title, setTitle] = useState('')const [editing, setEditing] = useState<string | null>(null)const [draftTitle, setDraftTitle] = useState('')@@ -40,30 +51,17 @@ export default function KanbanPage() {const [busy, setBusy] = useState(false)const [error, setError] = useState('')const [dragged, setDragged] = useState<string | null>(null)+ const [dropTarget, setDropTarget] = useState<TaskStatus | null>(null)const pending = useRef(false)const [showArchived, setShowArchived] = useState(false)- const [reload, setReload] = useState(0)-- useEffect(() => {- const controller = new AbortController()- getTaskBoard(controller.signal)- .then(result => {- if (!controller.signal.aborted) setBoard(result)- })- .catch(() => {- if (!controller.signal.aborted) setError('kanban.loadError')- })- return () => controller.abort()- }, [reload])-async function act(operation: () => Promise<TaskBoard>, onSuccess?: () => void) {if (pending.current || !board) returnpending.current = truesetBusy(true)setError('')try {- setBoard(await operation())+ await operation()onSuccess?.()} catch {setError('kanban.saveError')@@ -84,35 +82,43 @@ export default function KanbanPage() {const count = (status: TaskStatus) => visible.filter(card => card.status === status).lengthreturn (- <div className="h-full overflow-y-auto bg-[var(--background)] [scrollbar-gutter:stable]">- <main className="mx-auto max-w-5xl px-4 py-8 sm:px-8 pb-12 font-sans text-[var(--foreground)]">+ <FeaturePage><SpaceSectionHeader- icon={ClipboardList}title={t('Task Board')}description={t('kanban.intro')}action={- <button- type="button"- aria-pressed={showArchived}- disabled={busy}- onClick={() => {- setShowArchived(value => !value)- setEditing(null)- }}- className="rounded-lg border border-[var(--border)] px-3 py-2 text-sm text-[var(--foreground)] hover:bg-[var(--accent)] disabled:opacity-40"- >- {t(showArchived ? 'kanban.showActive' : 'kanban.showArchived')}- </button>+ <div className="flex items-center gap-1">+ <TaskColorPicker+ colors={board?.colors ?? DEFAULT_TASK_COLORS}+ disabled={!board}+ busy={busy}+ error={error ? t(error) : undefined}+ onSave={(colors, onSuccess) => void act(() => updateTaskColors(colors), onSuccess)}+ />+ <button+ type="button"+ aria-pressed={showArchived}+ disabled={busy}+ onClick={() => {+ setShowArchived(value => !value)+ setEditing(null)+ }}+ className={`inline-flex h-9 items-center gap-2 rounded-lg px-3 text-[13px] font-medium transition-colors disabled:opacity-40 ${showArchived ? 'bg-muted text-foreground' : 'text-muted-foreground hover:bg-muted/60 hover:text-foreground'}`}+ >+ <Archive size={15} strokeWidth={1.7} />+ {t(showArchived ? 'kanban.showActive' : 'kanban.showArchived')}+ </button>+ </div>}meta={- <span className="rounded-full bg-[var(--muted)] px-2.5 py-1 font-sans text-xs font-medium text-[var(--muted-foreground)]">+ <span className="rounded-md bg-muted/65 px-2 py-0.5 font-sans text-[11px] font-medium text-muted-foreground">{active.filter(card => card.status === 'doing').length} {t('kanban.working')}</span>}/><form- className="mb-7 flex gap-2 rounded-2xl bg-[var(--card)] p-2 shadow-sm ring-1 ring-[var(--border)]"+ className="mb-6 flex items-center gap-2 rounded-xl border border-border/80 bg-card p-1.5 transition-[border-color,box-shadow] focus-within:border-primary/40 focus-within:ring-[3px] focus-within:ring-primary/5"onSubmit={event => {event.preventDefault()if (title.trim())@@ -128,7 +134,7 @@ export default function KanbanPage() {<inputdisabled={!board || busy}aria-label={t('kanban.newTask')}- className="min-w-0 flex-1 bg-transparent px-3 py-2 outline-none placeholder:text-[var(--muted-foreground)]"+ className="min-w-0 flex-1 bg-transparent px-3 py-2 text-[13px] outline-none placeholder:text-muted-foreground/75 focus-visible:outline-none"placeholder={t('kanban.placeholder')}maxLength={160}value={title}@@ -136,30 +142,27 @@ export default function KanbanPage() {/><buttondisabled={busy || !board || !title.trim()}- className="flex items-center gap-2 rounded-xl bg-[var(--primary)] px-4 py-2 font-semibold text-[var(--primary-foreground)] transition hover:opacity-90 disabled:opacity-40"+ className="flex shrink-0 items-center gap-1.5 rounded-lg bg-primary px-3.5 py-2 text-[13px] font-medium text-primary-foreground transition-colors hover:opacity-90 disabled:bg-muted disabled:text-muted-foreground disabled:opacity-60"type="submit">- <Plus size={18} /> {t('kanban.add')}+ <Plus size={15} strokeWidth={1.8} /> {t('kanban.add')}</button></form>- {!board && !error && (- <p role="status" className="mb-5 text-sm text-[var(--muted-foreground)]">+ {!board && !error && !loadError && (+ <p role="status" className="mb-5 text-sm text-muted-foreground">{t('kanban.loading')}</p>)}- {error && (- <p- role="alert"- className="mb-5 rounded-xl bg-[var(--secondary)] p-3 text-sm text-[var(--destructive)]"- >- {t(error)}+ {(error || loadError) && (+ <p role="alert" className="mb-5 rounded-xl bg-secondary p-3 text-sm text-destructive">+ {t(error || 'kanban.loadError')}{!board && (<buttontype="button"className="ml-3 underline"onClick={() => {setError('')- setReload(value => value + 1)+ void refreshTaskBoard()}}>{t('kanban.retry')}@@ -168,36 +171,48 @@ export default function KanbanPage() {</p>)}- <div aria-busy={busy || !board} className="grid gap-5 lg:grid-cols-3">+ <div aria-busy={busy || !board} className={pageGridClass('board')}>{columns.map((column, index) => (<sectionkey={column.id}aria-label={t(column.title)}- onDragOver={event => event.preventDefault()}+ onDragOver={event => {+ event.preventDefault()+ if (dragged && !showArchived) setDropTarget(column.id)+ }}+ onDragLeave={event => {+ if (!event.currentTarget.contains(event.relatedTarget as Node | null))+ setDropTarget(null)+ }}onDrop={event => {event.preventDefault()if (dragged && !showArchived)void act(() => updateTaskCard(dragged, { status: column.id }))setDragged(null)+ setDropTarget(null)}}- className="min-h-[22rem] rounded-2xl border border-[var(--border)] bg-[var(--secondary)] p-4"+ className={`min-h-[12rem] rounded-2xl border p-3 transition-colors sm:p-3.5 lg:min-h-[24rem] ${dropTarget === column.id ? 'border-primary/35 bg-primary/5 ring-2 ring-primary/10' : 'border-border/45 bg-secondary/65'}`}>- <div className="mb-4 flex items-center justify-between">- <div className="flex items-center gap-3">+ <div className="mb-3 flex items-center justify-between px-1 py-1.5">+ <div className="flex items-start gap-2.5"><span- className="h-2.5 w-2.5 rounded-full"- style={{ backgroundColor: column.tone }}+ className="mt-1.5 h-2 w-2 shrink-0 rounded-full"+ style={{+ backgroundColor: board?.colors[column.id] ?? DEFAULT_TASK_COLORS[column.id],+ }}/><div>- <h2 className="font-semibold">{t(column.title)}</h2>- <p className="text-xs text-[var(--muted-foreground)]">{t(column.hint)}</p>+ <h2 className="text-[13px] font-semibold leading-5">{t(column.title)}</h2>+ <p className="mt-0.5 text-[11px] leading-4 text-muted-foreground">+ {t(column.hint)}+ </p></div></div>- <span className="rounded-full bg-[var(--card)] px-2.5 py-1 text-xs font-bold text-[var(--muted-foreground)]">+ <span className="self-start px-1.5 py-0.5 text-[11px] font-medium tabular-nums text-muted-foreground">{count(column.id)}</span></div>- <div className="space-y-3">+ <div className="space-y-2.5">{visible.filter(card => card.status === column.id).map(card => (@@ -209,8 +224,11 @@ export default function KanbanPage() {event.dataTransfer.effectAllowed = 'move'setDragged(card.id)}}- onDragEnd={() => setDragged(null)}- className="rounded-xl bg-[var(--card)] p-4 shadow-sm ring-1 ring-[var(--border)]"+ onDragEnd={() => {+ setDragged(null)+ setDropTarget(null)+ }}+ className={`group/kanban-card rounded-xl border border-border/75 bg-card px-3.5 py-3 shadow-[0_1px_2px_rgba(0,0,0,0.025)] transition-[border-color,box-shadow,opacity] hover:border-border hover:shadow-[0_2px_8px_rgba(0,0,0,0.045)] ${dragged === card.id ? 'opacity-45' : ''}`}>{editing === card.id ? (<form@@ -226,14 +244,14 @@ export default function KanbanPage() {><inputaria-label={t('kanban.taskTitle')}- className="w-full rounded-lg border border-[var(--border)] bg-[var(--background)] px-2 py-1 font-semibold text-[var(--foreground)]"+ className="w-full rounded-lg border border-border bg-background px-2.5 py-2 text-[13px] font-medium text-foreground focus:border-primary/40 focus:outline-none focus:ring-2 focus:ring-primary/10"maxLength={160}value={draftTitle}onChange={event => setDraftTitle(event.target.value)}/><textareaaria-label={t('kanban.taskNote')}- className="mt-2 w-full rounded-lg border border-[var(--border)] bg-[var(--background)] px-2 py-1 text-sm text-[var(--foreground)]"+ className="mt-2 w-full resize-y rounded-lg border border-border bg-background px-2.5 py-2 text-xs leading-5 text-foreground focus:border-primary/40 focus:outline-none focus:ring-2 focus:ring-primary/10"placeholder={t('kanban.notePlaceholder')}rows={3}maxLength={2000}@@ -243,13 +261,13 @@ export default function KanbanPage() {<div className="mt-2 flex gap-2"><buttondisabled={busy || !draftTitle.trim()}- className="flex items-center gap-1 rounded-lg bg-[var(--primary)] px-3 py-1.5 text-xs font-semibold text-[var(--primary-foreground)] disabled:opacity-40"+ className="flex items-center gap-1 rounded-lg bg-primary px-3 py-1.5 text-xs font-semibold text-primary-foreground disabled:opacity-40"type="submit"><Check size={14} /> {t('kanban.save')}</button><button- className="flex items-center gap-1 rounded-lg px-2 py-1.5 text-xs text-[var(--muted-foreground)]"+ className="flex items-center gap-1 rounded-lg px-2 py-1.5 text-xs text-muted-foreground"type="button"onClick={() => setEditing(null)}>@@ -258,60 +276,108 @@ export default function KanbanPage() {</div></form>) : (- <>+ <div className="relative"><buttontype="button"+ aria-label={card.title}disabled={busy}- className="w-full text-left"+ className="block w-full text-left"onClick={() => startEdit(card)}>- <strong className="break-words text-sm leading-6">{card.title}</strong>+ <strong className="block break-words text-[13px] font-medium leading-6">+ {card.title}+ </strong>{card.note && (- <p className="mt-1 whitespace-pre-wrap break-words text-xs leading-5 text-[var(--muted-foreground)]">+ <p className="mt-1.5 whitespace-pre-wrap break-words text-xs leading-5 text-muted-foreground">{card.note}</p>)}</button>- <div className="mt-4 flex items-center justify-between border-t border-[var(--border)] pt-3">- <div className="flex gap-1">- {!showArchived && index > 0 && (- <Tooltip label={t('kanban.back')}>- <button- disabled={busy}- aria-label={`${card.title}: ${t('kanban.moveTo')} ${t(columns[index - 1].title)}`}- className="rounded-lg p-1.5 text-[var(--muted-foreground)] hover:bg-[var(--accent)]"- onClick={() =>- void act(() =>- updateTaskCard(card.id, { status: columns[index - 1].id })- )- }- >- <ArrowLeft size={16} />- </button>- </Tooltip>- )}- {!showArchived && index < 2 && (- <Tooltip label={t('kanban.forward')}>- <button- disabled={busy}- aria-label={`${card.title}: ${t('kanban.moveTo')} ${t(columns[index + 1].title)}`}- className="rounded-lg p-1.5 text-[var(--muted-foreground)] hover:bg-[var(--accent)]"- onClick={() =>- void act(() =>- updateTaskCard(card.id, { status: columns[index + 1].id })- )- }+ <label className="relative mt-3 inline-flex max-w-full items-center gap-1.5 rounded-md bg-muted/50 px-2 py-1 text-[11px] leading-4 text-muted-foreground transition-colors hover:bg-muted focus-within:ring-2 focus-within:ring-ring/40">+ <Folder aria-hidden size={11} strokeWidth={1.7} className="shrink-0" />+ <span className="truncate">+ {card.workspace_id === null+ ? t('tasks.unassigned')+ : card.workspace_id === ''+ ? t('General workspace')+ : (workspaces.find(row => row.workspace_id === card.workspace_id)+ ?.display_name ?? t('tasks.assign'))}+ </span>+ <ChevronDown+ aria-hidden+ size={11}+ strokeWidth={1.7}+ className="shrink-0 opacity-60"+ />+ <select+ aria-label={`${card.title}: ${t('tasks.assign')}`}+ disabled={busy}+ value={card.workspace_id ?? '__unassigned__'}+ onChange={event =>+ void act(() =>+ updateTaskCard(card.id, {+ workspace_id:+ event.target.value === '__unassigned__'+ ? null+ : event.target.value,+ })+ )+ }+ className="absolute inset-0 h-full w-full cursor-pointer opacity-0 disabled:cursor-default"+ >+ <option value="__unassigned__">{t('tasks.unassigned')}</option>+ <option value="">{t('General workspace')}</option>+ {workspaces+ .filter(row => row.kind === 'workspace')+ .map(row => (+ <option+ key={row.workspace_id}+ value={row.workspace_id}+ disabled={row.archived || row.status !== 'ready'}>- <ArrowRight size={16} />- </button>- </Tooltip>- )}- </div>+ {row.display_name}+ </option>+ ))}+ </select>+ </label>+ <div className="pointer-events-none absolute -right-0.5 -top-0.5 flex items-center gap-0.5 rounded-r-md bg-gradient-to-l from-popover from-80% to-transparent pl-4 opacity-0 transition-opacity duration-150 group-hover/kanban-card:pointer-events-auto group-hover/kanban-card:opacity-100 group-has-[:focus-visible]/kanban-card:pointer-events-auto group-has-[:focus-visible]/kanban-card:opacity-100 [@media(hover:none)]:pointer-events-auto [@media(hover:none)]:opacity-100">+ {!showArchived && index > 0 && (+ <Tooltip label={t('kanban.back')}>+ <button+ disabled={busy}+ aria-label={`${card.title}: ${t('kanban.moveTo')} ${t(columns[index - 1].title)}`}+ className="rounded-lg p-1.5 text-muted-foreground hover:bg-accent"+ onClick={() =>+ void act(() =>+ updateTaskCard(card.id, { status: columns[index - 1].id })+ )+ }+ >+ <ArrowLeft size={16} />+ </button>+ </Tooltip>+ )}+ {!showArchived && index < 2 && (+ <Tooltip label={t('kanban.forward')}>+ <button+ disabled={busy}+ aria-label={`${card.title}: ${t('kanban.moveTo')} ${t(columns[index + 1].title)}`}+ className="rounded-lg p-1.5 text-muted-foreground hover:bg-accent"+ onClick={() =>+ void act(() =>+ updateTaskCard(card.id, { status: columns[index + 1].id })+ )+ }+ >+ <ArrowRight size={16} />+ </button>+ </Tooltip>+ )}<Tooltip label={t(card.archived ? 'kanban.restore' : 'kanban.archive')}><buttondisabled={busy}aria-label={`${card.title}: ${t(card.archived ? 'kanban.restore' : 'kanban.archive')}`}- className="rounded-lg p-1.5 text-[var(--muted-foreground)] hover:bg-[var(--accent)]"+ className="rounded-lg p-1.5 text-muted-foreground hover:bg-accent"onClick={() =>void act(() =>updateTaskCard(card.id, { archived: !card.archived })@@ -322,21 +388,30 @@ export default function KanbanPage() {</button></Tooltip></div>- </>+ </div>)}</article>))}{board && count(column.id) === 0 && (- <p className="rounded-xl border border-dashed border-[var(--border)] px-4 py-10 text-center text-sm text-[var(--muted-foreground)]">- {t(showArchived ? 'kanban.emptyArchive' : 'kanban.empty')}- </p>+ <div className="flex min-h-28 flex-col items-center justify-center gap-2.5 rounded-xl border border-dashed border-border/65 px-4 py-6 text-center">+ <column.icon+ aria-hidden+ size={20}+ strokeWidth={1.3}+ className="text-muted-foreground/40"+ />+ <p className="text-[11px] text-muted-foreground">+ {t(showArchived ? 'kanban.emptyArchive' : 'kanban.empty')}+ </p>+ </div>)}</div></section>))}</div>- <p className="mt-6 text-xs text-[var(--muted-foreground)]">{t('kanban.footer')}</p>- </main>- </div>+ <p className="mt-5 px-1 text-[11px] leading-5 text-muted-foreground">+ {t('kanban.footer')}+ </p>+ </FeaturePage>)}diff --git a/web/app/(workspace)/layout.tsx b/web/app/(workspace)/layout.tsxindex 73535a0ab..420c77698 100644--- a/web/app/(workspace)/layout.tsx+++ b/web/app/(workspace)/layout.tsx@@ -1,3 +1,4 @@+import TaskBoardRuntime from "@/components/tasks/TaskBoardRuntime";import WorkspaceSidebar from "@/components/sidebar/WorkspaceSidebar";import AppShell from "@/components/layout/AppShell";import { CapabilityAccessProvider } from "@/components/access/CapabilityAccessContext";@@ -14,23 +15,25 @@ export default function WorkspaceLayout({children: React.ReactNode;}>) {return (- <CapabilityAccessProvider>- <Suspense>- <WorkspaceRuntimeBoundary>- <ChatRuntimeProvider>- {/* Above the page on purpose: sending the first message navigates+ <TaskBoardRuntime>+ <CapabilityAccessProvider>+ <Suspense>+ <WorkspaceRuntimeBoundary>+ <ChatRuntimeProvider>+ {/* Above the page on purpose: sending the first message navigates/chat → /chat/<id>, which remounts the page. The open documentmust not die with it. */}- <ReadingProvider>- <WatchingProvider>- <AppShell sidebar={<WorkspaceSidebar />}>- <CapabilityGate>{children}</CapabilityGate>- </AppShell>- </WatchingProvider>- </ReadingProvider>- </ChatRuntimeProvider>- </WorkspaceRuntimeBoundary>- </Suspense>- </CapabilityAccessProvider>+ <ReadingProvider>+ <WatchingProvider>+ <AppShell sidebar={<WorkspaceSidebar />}>+ <CapabilityGate>{children}</CapabilityGate>+ </AppShell>+ </WatchingProvider>+ </ReadingProvider>+ </ChatRuntimeProvider>+ </WorkspaceRuntimeBoundary>+ </Suspense>+ </CapabilityAccessProvider>+ </TaskBoardRuntime>);}diff --git a/web/app/(workspace)/learning/books/BooksRoute.tsx b/web/app/(workspace)/learning/books/BooksRoute.tsxindex 5b284fb11..37ac603c2 100644--- a/web/app/(workspace)/learning/books/BooksRoute.tsx+++ b/web/app/(workspace)/learning/books/BooksRoute.tsx@@ -1075,10 +1075,8 @@ function BookPageInner() {{displayView === 'creator' && (<div className="h-full overflow-y-auto [scrollbar-gutter:stable]">- <div className="mx-auto max-w-4xl px-6 pt-6">- <button type="button" onClick={() => void handleSelectBook(null)} className="inline-flex items-center gap-1.5 text-xs text-muted-foreground hover:text-foreground"><ArrowLeft size={14} />{t('All books')}</button>- </div><BookCreator+ back={<button type="button" onClick={() => void handleSelectBook(null)} className="inline-flex items-center gap-1.5 text-xs text-muted-foreground hover:text-foreground"><ArrowLeft size={14} />{t('All books')}</button>}book={pendingBook}onCreate={handleCreate}loading={creating}diff --git a/web/app/(workspace)/learning/books/components/BookCreator.tsx b/web/app/(workspace)/learning/books/components/BookCreator.tsxindex 23887c27f..58d90cd3b 100644--- a/web/app/(workspace)/learning/books/components/BookCreator.tsx+++ b/web/app/(workspace)/learning/books/components/BookCreator.tsx@@ -1,6 +1,7 @@'use client'-import { useEffect, useRef, useState } from 'react'+import { PageContainer, PageHeader } from '@/components/layout/FeaturePage'+import { useEffect, useRef, useState, type ReactNode } from 'react'import { ChevronUp, Database, Loader2, Pencil, Sparkles } from 'lucide-react'import { useTranslation } from 'react-i18next'import { useAppShell } from '@/context/AppShellContext'@@ -58,6 +59,7 @@ const DEPTH_OPTIONS: Array<{ value: BookDepth; label: string; hint: string }> =]export interface BookCreatorProps {+ back?: ReactNodeonCreate: (payload: {source_refs: TopicSourceInput[]user_intent: string@@ -80,6 +82,7 @@ export interface BookCreatorProps {}export default function BookCreator({+ back,onCreate,loading = false,book = null,@@ -158,17 +161,10 @@ export default function BookCreator({: []return (- <div className="mx-auto w-full max-w-4xl space-y-5 p-6">- <div className="space-y-1.5">- <h1 className="font-serif text-2xl font-semibold text-[var(--foreground)]">- {t('Create a new book')}- </h1>- <p className="text-sm text-[var(--muted-foreground)]">- {t(- 'Describe what you want to learn, then pick the knowledge sources to fuse into a structured, interactive book.'- )}- </p>- </div>+ <PageContainer>+ {back && <div className="mb-5">{back}</div>}+ <PageHeader title={t('Create a new book')} description={t('Describe what you want to learn, then pick the knowledge sources to fuse into a structured, interactive book.')} />+ <div className="space-y-5"><div className="rounded-2xl border border-[var(--border)] bg-[var(--card)] shadow-sm"><button@@ -338,7 +334,8 @@ export default function BookCreator({</div></div>)}- </div>+ </div>+ </PageContainer>)}diff --git a/web/app/(workspace)/learning/books/components/BookLibrary.tsx b/web/app/(workspace)/learning/books/components/BookLibrary.tsxindex f3ce6fd11..db53ef42d 100644--- a/web/app/(workspace)/learning/books/components/BookLibrary.tsx+++ b/web/app/(workspace)/learning/books/components/BookLibrary.tsx@@ -1,5 +1,6 @@'use client'+import { pageGridClass } from '@/components/layout/FeaturePage'import { useLibraryFilter, WorkspaceLabel } from '@/components/learning/LibraryWorkspace'import { libraryItemKey } from '@/lib/learning-library'import { LearningCardContent } from '@/components/learning/LearningCard'@@ -202,7 +203,7 @@ export default function BookLibrary({{t('No books match “{{query}}”.', { query })}</div>) : (- <div className="grid grid-cols-1 gap-4 sm:grid-cols-2 xl:grid-cols-3">+ <div className={pageGridClass(3)}>{filtered.map(book => {const isPendingDelete = pendingDeleteId === libraryItemKey(book, book.id)const status = STATUS_STYLES[book.status] || STATUS_STYLES.draftdiff --git a/web/app/(workspace)/learning/mastery/[pathId]/page.tsx b/web/app/(workspace)/learning/mastery/[pathId]/page.tsxindex 6202c6a38..5b4336758 100644--- a/web/app/(workspace)/learning/mastery/[pathId]/page.tsx+++ b/web/app/(workspace)/learning/mastery/[pathId]/page.tsx@@ -1,5 +1,6 @@"use client";+import { PageContainer, PAGE_DESCRIPTION_CLASS } from '@/components/layout/FeaturePage'import { scopedUrl } from "@/lib/workspace-scope";import { MASTERY_HOME, masterySessionRoute as existingMasterySessionRoute, masterySessionsRoute } from "@/lib/learning-routes";@@ -318,7 +319,7 @@ export default function MasteryTopicPage() {// no second column to balance, and a fixed-height stack there would just// be three tiny scrollers.<main className="mastery-shell flex h-full flex-col overflow-y-auto [scrollbar-gutter:stable]">- <div className="mx-auto flex w-full min-h-0 max-w-[1180px] flex-1 flex-col px-4 pb-40 pt-6 sm:px-7 sm:pb-10 lg:px-8 lg:py-8">+ <PageContainer className="flex min-h-0 flex-1 flex-col pb-40 sm:pb-10"><div className="flex items-center justify-between gap-3"><Linkhref={scopedUrl(MASTERY_HOME)}@@ -365,7 +366,7 @@ export default function MasteryTopicPage() {</div></div>- <header className="mt-6 flex flex-col gap-5 lg:flex-row lg:items-end lg:justify-between">+ <header className="dt-page-header mt-5 mb-6 flex flex-col gap-4"><div className="min-w-0"><div className="flex items-center gap-3"><div className="min-w-0">@@ -374,13 +375,13 @@ export default function MasteryTopicPage() {storedName={topic.name}onRename={handleRename}/>- <p className="mt-1 max-w-3xl text-sm text-[var(--muted-foreground)]">+ <p className={PAGE_DESCRIPTION_CLASS}>{topic.metadata.description || topic.metadata.goal}</p></div></div>{sourceLabels.length > 0 && (- <div className="mt-4 flex flex-wrap items-center gap-2 pl-0 sm:pl-[60px]">+ <div className="mt-4 flex flex-wrap items-center gap-2">{sourceLabels.map((source) => (<spankey={source.id}@@ -630,7 +631,7 @@ export default function MasteryTopicPage() {/></div></div>- </div>+ </PageContainer>{editorOpen && (<EditTopicRouteDialogtopic={topic}diff --git a/web/app/(workspace)/partners/groups/new/page.tsx b/web/app/(workspace)/partners/groups/new/page.tsxindex 544cdee4c..84082a7c6 100644--- a/web/app/(workspace)/partners/groups/new/page.tsx+++ b/web/app/(workspace)/partners/groups/new/page.tsx@@ -1,5 +1,6 @@"use client";+import { FeaturePage, PageHeader } from '@/components/layout/FeaturePage'import { useEffect, useMemo, useState } from "react";import Link from "next/link";import { useRouter } from "next/navigation";@@ -73,20 +74,15 @@ export default function NewPartnerGroupPage() {};return (- <div className="mx-auto h-full max-w-3xl overflow-y-auto px-6 py-7">+ <FeaturePage><Linkhref="/partners"- className="inline-flex items-center gap-1.5 text-[12px] text-[var(--muted-foreground)] transition-colors hover:text-[var(--foreground)]"+ className="mb-5 inline-flex items-center gap-1.5 text-[12px] text-[var(--muted-foreground)] transition-colors hover:text-[var(--foreground)]"><ArrowLeft size={14} /> {t("Partners")}</Link>- <h1 className="mt-6 text-[20px] font-semibold tracking-tight text-[var(--foreground)]">- {t("Create a Partner Group")}- </h1>- <p className="mt-1 text-[12.5px] text-[var(--muted-foreground)]">- {t("Choose at least two Partners, then how they should discuss.")}- </p>+ <PageHeader title={t("Create a Partner Group")} description={t("Choose at least two Partners, then how they should discuss.")} />{/* A live card of the thing being made: emoji, colour and name only meansomething once you can see them together the way the list will. */}@@ -291,6 +287,6 @@ export default function NewPartnerGroupPage() {</button></div></div>- </div>+ </FeaturePage>);}diff --git a/web/app/(workspace)/partners/new/page.tsx b/web/app/(workspace)/partners/new/page.tsxindex 753a3e055..27f02d0ab 100644--- a/web/app/(workspace)/partners/new/page.tsx+++ b/web/app/(workspace)/partners/new/page.tsx@@ -7,6 +7,7 @@* partner's Channels tab.*/+import { PageContainer, PageHeader } from '@/components/layout/FeaturePage'import { useEffect, useMemo, useState } from "react";import Link from "next/link";import { useRouter } from "next/navigation";@@ -294,29 +295,9 @@ export default function NewPartnerPage() {{/* Step body */}<div className="min-h-0 flex-1 overflow-y-auto">- <div- key={step}- className="mx-auto w-full max-w-2xl px-6 pb-8 pt-10 animate-fade-in"- >- <header className="mb-7 flex items-start gap-4">- {step === "identity" || step === "review" ? (- <PartnerAvatar- name={name || "?"}- emoji={face.emoji}- color={face.color}- image={face.avatar}- size={48}- />- ) : null}- <div>- <h1 className="text-[22px] font-semibold tracking-tight text-[var(--foreground)]">- {stepTitle[step].title}- </h1>- <p className="mt-1 text-[13.5px] leading-relaxed text-[var(--muted-foreground)]">- {stepTitle[step].subtitle}- </p>- </div>- </header>+ <PageContainer key={step} className="animate-fade-in">+ <PageHeader title={stepTitle[step].title} description={stepTitle[step].subtitle} />+ <div className="max-w-2xl">{step === "identity" && (<div className="space-y-5">@@ -503,12 +484,14 @@ export default function NewPartnerPage() {)}</div>)}- </div>+ </div>+ </PageContainer></div>{/* Footer actions */}- <div className="border-t border-[var(--border)] px-6 py-3.5">- <div className="mx-auto flex w-full max-w-2xl items-center justify-between">+ <div className="border-t border-[var(--border)]">+ <PageContainer spacing="toolbar">+ <div className="flex w-full max-w-2xl items-center justify-between"><buttontype="button"onClick={goBack}@@ -544,6 +527,7 @@ export default function NewPartnerPage() {</button>)}</div>+ </PageContainer></div></div>);diff --git a/web/app/(workspace)/partners/page.tsx b/web/app/(workspace)/partners/page.tsxindex 39d9a1af7..65480e941 100644--- a/web/app/(workspace)/partners/page.tsx+++ b/web/app/(workspace)/partners/page.tsx@@ -8,6 +8,7 @@* to alone and who you can convene — is visible in one place.*/+import { FeaturePage, PageHeader, pageActionClass, pageGridClass } from '@/components/layout/FeaturePage'import { useEffect, useState } from "react";import Link from "next/link";import { HeartHandshake, Loader2, Plus, Users } from "lucide-react";@@ -60,30 +61,22 @@ export default function PartnersPage() {}, []);return (- <div className="mx-auto h-full max-w-4xl overflow-y-auto px-6 py-8">- <header className="mb-7 flex items-end justify-between gap-4">- <div>- <h1 className="text-[19px] font-semibold tracking-tight text-[var(--foreground)]">- {t("Partners")}- </h1>- <p className="mt-1 text-[12.5px] text-[var(--muted-foreground)]">- {anyAssigned- ? t(- "Your companions, plus the ones shared with you — each with its own soul, library, and channels.",- )- : t(- "Companions with their own soul, library, and channels — reachable from your IM apps.",- )}- </p>- </div>+ <FeaturePage>+ <PageHeader+ title={t("Partners")}+ description={anyAssigned+ ? t("Your companions, plus the ones shared with you — each with its own soul, library, and channels.")+ : t("Companions with their own soul, library, and channels — reachable from your IM apps.")}+ action={<Linkhref="/partners/new"- className="inline-flex shrink-0 items-center gap-1.5 rounded-lg bg-[var(--primary)] px-3.5 py-2 text-[12.5px] font-medium text-[var(--primary-foreground)] hover:opacity-90"+ className={pageActionClass()}><Plus className="h-3.5 w-3.5" />{t("New partner")}</Link>- </header>+ }+ />{loading ? (<div className="flex min-h-[320px] items-center justify-center">@@ -112,7 +105,7 @@ export default function PartnersPage() {</Link></div>) : (- <div className="grid grid-cols-1 gap-3 sm:grid-cols-2">+ <div className={pageGridClass(2)}>{partners.map((partner) => {const channels = channelNames(partner);return (@@ -179,25 +172,20 @@ export default function PartnersPage() {{!loading && partners.length > 0 ? (<section className="mt-9 border-t border-[var(--border)] pt-7">- <div className="mb-3 flex items-end justify-between gap-4">- <div>- <h2 className="text-[14px] font-medium text-[var(--foreground)]">- {t("Groups")}- </h2>- <p className="mt-0.5 text-[11.5px] text-[var(--muted-foreground)]">- {t("Ask several Partners at once and compare how they differ.")}- </p>- </div>- {canFormGroup ? (+ <PageHeader+ level={2}+ title={t("Groups")}+ description={t("Ask several Partners at once and compare how they differ.")}+ action={canFormGroup ? (<Linkhref="/partners/groups/new"- className="inline-flex shrink-0 items-center gap-1.5 rounded-lg border border-[var(--border)] px-3 py-1.5 text-[12px] font-medium text-[var(--foreground)] transition-colors hover:bg-[var(--muted)]"+ className={pageActionClass('secondary')}><Plus className="h-3.5 w-3.5" />{t("New group")}</Link>) : null}- </div>+ />{groups.length === 0 ? (<div className="flex items-center gap-3 rounded-2xl border border-dashed border-[var(--border)] px-4 py-5">@@ -214,7 +202,7 @@ export default function PartnersPage() {</p></div>) : (- <div className="grid grid-cols-1 gap-3 sm:grid-cols-2">+ <div className={pageGridClass(2)}>{groups.map((group) => (<Linkkey={group.group_id}@@ -274,6 +262,6 @@ export default function PartnersPage() {)}</section>) : null}- </div>+ </FeaturePage>);}diff --git a/web/app/globals.css b/web/app/globals.cssindex 49bb3aa0f..d2d33b09d 100644--- a/web/app/globals.css+++ b/web/app/globals.css@@ -2,6 +2,71 @@@tailwind components;@tailwind utilities;+/* Feature-page standards. Queries measure usable content after the sidebar+ and gutters, so the same cards behave consistently in both route groups. */+.dt-page-container {+ container: feature-page / inline-size;+}++.dt-page-title {+ font-size: 27px;+}++.dt-page-action,+[data-page-actions] > button,+[data-page-actions] > a,+[data-page-actions] > div > button,+[data-page-actions] > div > a {+ min-height: 44px;+ font-size: 12.5px;+ font-weight: 500;+ line-height: 18px;+}++.dt-page-grid {+ display: grid;+ grid-template-columns: minmax(0, 1fr);+ gap: 12px;+}++.dt-page-grid > * {+ min-width: 0;+}++@container feature-page (min-width: 520px) {+ .dt-page-grid-2,+ .dt-page-grid-3,+ .dt-page-grid-5 {+ grid-template-columns: repeat(2, minmax(0, 1fr));+ }+}++@container feature-page (min-width: 640px) {+ .dt-page-title { font-size: 30px; }+ .dt-page-header {+ flex-direction: row;+ align-items: flex-end;+ justify-content: space-between;+ }+ .dt-page-action,+ [data-page-actions] > button,+ [data-page-actions] > a,+ [data-page-actions] > div > button,+ [data-page-actions] > div > a { min-height: 36px; }+}++@container feature-page (min-width: 800px) {+ .dt-page-grid-3,+ .dt-page-grid-5,+ .dt-page-grid-board {+ grid-template-columns: repeat(3, minmax(0, 1fr));+ }+}++@container feature-page (min-width: 1040px) {+ .dt-page-grid-5 { grid-template-columns: repeat(5, minmax(0, 1fr)); }+}+@layer base {/* ────────────────────────────────────────────────────────────────────────Theme palettes — four families:diff --git a/web/components/SessionList.tsx b/web/components/SessionList.tsxindex 7cf11a071..8df4bdeef 100644--- a/web/components/SessionList.tsx+++ b/web/components/SessionList.tsx@@ -3,7 +3,7 @@import { Check, Pencil, Trash2 } from "lucide-react";import { useMemo, useState } from "react";import { useTranslation } from "react-i18next";-import { type SessionSummary } from "@/lib/session-api";+import { sessionWorkspaceId, type SessionSummary } from "@/lib/session-api";import { normalizeMessageContent, truncateText } from "@/lib/message-content";import {deriveSessionMark,@@ -160,6 +160,7 @@ export default function SessionList({><SessionAvatarsessionId={session.session_id}+ workspaceId={sessionWorkspaceId(session)}mark={deriveSessionMark(session, undefined, unread)}kind={sessionKindOf(session)}className={diff --git a/web/components/agents/ConnectedAgents.tsx b/web/components/agents/ConnectedAgents.tsxindex becc987ca..83148d659 100644--- a/web/components/agents/ConnectedAgents.tsx+++ b/web/components/agents/ConnectedAgents.tsx@@ -1,5 +1,6 @@"use client";+import { pageActionClass, pageGridClass } from '@/components/layout/FeaturePage'import Tooltip from "@/shared/ui/Tooltip";import { useCallback, useEffect, useMemo, useState } from "react";import { useTranslation } from "react-i18next";@@ -97,7 +98,6 @@ export default function ConnectedAgents() {return (<section className="space-y-4"><SpaceSectionHeader- icon={Plug}title={tr({ zh: "连接的智能体", en: "Connected agents" })}description={tr({zh: "把本机智能体或已配置的远程 Hermes 网关接进来,在对话中选中后直接向它提问——运行过程会实时展示。",@@ -108,7 +108,7 @@ export default function ConnectedAgents() {<buttontype="button"onClick={() => setModalOpen(true)}- className="inline-flex items-center gap-1.5 rounded-lg bg-[var(--foreground)] px-3 py-1.5 text-[12px] font-medium text-[var(--background)] shadow-sm transition-opacity hover:opacity-90"+ className={pageActionClass()}><Plus className="h-3.5 w-3.5" />{tr({ zh: "连接智能体", en: "Connect agent" })}@@ -137,7 +137,7 @@ export default function ConnectedAgents() {})}</div>) : (- <div className="grid gap-3 sm:grid-cols-2">+ <div className={pageGridClass(2)}>{connections.map((conn) => {const Glyph = agentGlyph(conn.agent_kind);return (diff --git a/web/components/chat/home/ChatComposer.tsx b/web/components/chat/home/ChatComposer.tsxindex be1b41390..459320a92 100644--- a/web/components/chat/home/ChatComposer.tsx+++ b/web/components/chat/home/ChatComposer.tsx@@ -74,6 +74,10 @@ import ResourceSelector from "./ResourceSelector";import type { ComposerResourceCatalog } from "@/hooks/useComposerResources";import type { ResourceSelection } from "@/features/chat/ChatStateAdapter";+import TaskLinkSelector from "@/components/tasks/TaskLinkSelector";+import { useTaskBoard } from "@/lib/task-board-store";+import { sessionTaskLinks } from "@/lib/task-board-api";+type SpaceSelectionCounts = {attachments: number;knowledge: number;@@ -190,6 +194,10 @@ const SEND_STATE_CLASS: Record<SendState, string> = {};export default memo(function ChatComposer({+ taskSessionId,+ draftTaskIds = [],+ onDraftTaskIdsChange,+ onTasksLinked,composerRef,capMenuRef,capBtnRef,@@ -296,6 +304,10 @@ export default memo(function ChatComposer({inputHeader,showCapabilityChip = true,}: {+ taskSessionId?: string | null;+ draftTaskIds?: string[];+ onDraftTaskIdsChange?: (ids: string[]) => void;+ onTasksLinked?: () => void;composerRef: RefObject<HTMLDivElement | null>;capMenuRef: RefObject<HTMLDivElement | null>;capBtnRef: RefObject<HTMLButtonElement | null>;@@ -702,7 +714,21 @@ export default memo(function ChatComposer({[focusTextarea, onSend],);+ const { board: taskBoard } = useTaskBoard();+ const linkedTaskIds = taskSessionId+ ? sessionTaskLinks(taskBoard, taskSessionId, workspaceId ?? "")?.task_ids ?? []+ : draftTaskIds;+ const taskPanelPending = useRef(false);+ useEffect(() => {+ // Let users finish selecting tasks before the viewer changes the layout.+ if (taskPanelPending.current && !spaceMenuOpen && !personaSelectorOpen) {+ taskPanelPending.current = false;+ onTasksLinked?.();+ }+ }, [spaceMenuOpen, personaSelectorOpen, onTasksLinked]);+const hasReferences =+ !!linkedTaskIds.length ||!!attachments.length ||!!selectedBookReferences.length ||!!selectedReadingReferences.length ||@@ -883,6 +909,27 @@ export default memo(function ChatComposer({const selectedSkills = resourceSelection?.skills ?? [];const selectedMcp = resourceSelection?.mcp ?? [];const resourceItems: ComposerResourceItem[] = [];+ if (taskSessionId || onDraftTaskIdsChange) {+ resourceItems.push({+ key: "tasks",+ group: "Reference materials",+ label: t("tasks.linked"),+ icon: ClipboardList,+ count: linkedTaskIds.length,+ summary: linkedTaskIds.length ? `${linkedTaskIds.length} ${t("selected")}` : undefined,+ node: (+ <TaskLinkSelector+ sessionId={taskSessionId}+ workspaceId={workspaceId ?? ""}+ draftTaskIds={draftTaskIds}+ onDraftChange={onDraftTaskIdsChange}+ onLinked={() => {+ taskPanelPending.current = true;+ }}+ />+ ),+ });+ }if (knowledgeBases.length > 0) {resourceItems.push({key: "knowledge",@@ -1019,7 +1066,7 @@ export default memo(function ChatComposer({return (<divref={composerRef}- className={`relative z-20 mx-auto w-full shrink-0 px-6 pb-5 ${hasMessages ? "pt-1 max-w-[960px]" : "max-w-[768px]"}`}+ className={`relative ${spaceMenuOpen || personaSelectorOpen ? "z-[61]" : "z-20"} mx-auto w-full shrink-0 px-6 pb-5 ${hasMessages ? "pt-1 max-w-[960px]" : "max-w-[768px]"}`}style={{transition: "max-width 650ms cubic-bezier(0.16, 1, 0.3, 1)",}}diff --git a/web/components/chat/home/ComposerResources.tsx b/web/components/chat/home/ComposerResources.tsxindex b7c81d8b6..a428740be 100644--- a/web/components/chat/home/ComposerResources.tsx+++ b/web/components/chat/home/ComposerResources.tsx@@ -10,7 +10,7 @@ import { pickerFlight } from "@/lib/picker-origin";import ToolbarLabel from "./ToolbarLabel";import { useLingerExpand } from "@/hooks/use-linger-expand";import { ResourceReuseControl } from "./ResourceReuse";-import type { ResourceKind } from "@/lib/resource-reuse";+import { RESOURCE_KINDS, type ResourceKind } from "@/lib/resource-reuse";import {useEffect,useId,@@ -378,11 +378,13 @@ export default function ComposerResources({</button></div>)}- <div className="px-2 py-1.5">- <ResourceReuseControl- kind={current.key as ResourceKind}- />- </div>+ {RESOURCE_KINDS.includes(current.key as ResourceKind) && (+ <div className="px-2 py-1.5">+ <ResourceReuseControl+ kind={current.key as ResourceKind}+ />+ </div>+ )}{current.node}</div>) : (diff --git a/web/components/chat/home/SessionViewerPanel.tsx b/web/components/chat/home/SessionViewerPanel.tsxindex 016597101..921b9e4e4 100644--- a/web/components/chat/home/SessionViewerPanel.tsx+++ b/web/components/chat/home/SessionViewerPanel.tsx@@ -1,5 +1,7 @@"use client";+import TaskPanelSection from "@/components/tasks/TaskPanelSection";+import { browserStorage } from "@/shared/storage";/**@@ -210,6 +212,8 @@ export interface SessionViewerPanelProps {activity: SessionActivity;/** Optional capability-config card appended below the activity sections. */configSection?: ReactNode;+ taskDraftIds?: string[];+ onTaskDraftChange?: (ids: string[]) => void;}function fileTabIdFor(a: MessageAttachment, fallback: number): string {@@ -274,6 +278,8 @@ function SessionViewerPanelInner(onAutoOpen,activity,configSection,+ taskDraftIds,+ onTaskDraftChange,}: SessionViewerPanelProps,ref: React.Ref<SessionViewerPanelHandle>,) {@@ -774,6 +780,9 @@ function SessionViewerPanelInner(/>) : (<ActivityHome+ sessionId={sessionId}+ taskDraftIds={taskDraftIds}+ onTaskDraftChange={onTaskDraftChange}activity={activity}open={visible}configSection={configSection}@@ -941,6 +950,9 @@ function TabBar({* this same panel.*/function ActivityHome({+ sessionId,+ taskDraftIds,+ onTaskDraftChange,activity,open,configSection,@@ -948,6 +960,9 @@ function ActivityHome({onOpenWebTab,onOpenLocalFile,}: {+ sessionId: string | null;+ taskDraftIds?: string[];+ onTaskDraftChange?: (ids: string[]) => void;activity: SessionActivity;open: boolean;configSection?: ReactNode;@@ -957,6 +972,11 @@ function ActivityHome({}) {return (<div className="h-full space-y-5 overflow-y-auto px-3 pb-8 pt-1 sm:px-3.5">+ <TaskPanelSection+ sessionId={sessionId}+ draftTaskIds={taskDraftIds}+ onDraftChange={onTaskDraftChange}+ /><ActivityBodyactivity={activity}open={open}diff --git a/web/components/cli-apps/CliAppsSection.tsx b/web/components/cli-apps/CliAppsSection.tsxindex ac6892f6a..2291aacc7 100644--- a/web/components/cli-apps/CliAppsSection.tsx+++ b/web/components/cli-apps/CliAppsSection.tsx@@ -87,7 +87,6 @@ export default function CliAppsSection() {return (<div className="space-y-6"><SpaceSectionHeader- icon={Terminal}title={t("CLI Apps")}description={t("Command-line tools from the CLI-Anything catalog. Once enabled, the chat agent can call them directly.",diff --git a/web/components/courses/CoursesShelf.tsx b/web/components/courses/CoursesShelf.tsxindex 9833f83c2..bd0254ff0 100644--- a/web/components/courses/CoursesShelf.tsx+++ b/web/components/courses/CoursesShelf.tsx@@ -1,5 +1,6 @@"use client";+import { PageHeader, pageGridClass } from '@/components/layout/FeaturePage'import { useCallback, useEffect, useMemo, useState } from "react";import Link from "next/link";import {@@ -117,22 +118,14 @@ export default function CoursesShelf() {return (<section aria-labelledby="courses-shelf-title">- <div className="mb-4">- <h1- id="courses-shelf-title"- className="font-serif text-[22px] font-semibold tracking-tight text-[var(--foreground)]"- >- {t("My courses")}- </h1>- <p className="mt-1 text-[12.5px] text-[var(--muted-foreground)]">- {t(- "One subject's material, paths, notes and conversations, all in one place.",- )}- </p>- </div>+ <PageHeader+ titleId="courses-shelf-title"+ title={t("My courses")}+ description={t("One subject's material, paths, notes and conversations, all in one place.")}+ />{loading ? (- <div className="grid gap-3 sm:grid-cols-2 lg:grid-cols-3">+ <div className={pageGridClass(3)}>{[0, 1, 2].map((item) => (<divkey={item}@@ -156,7 +149,7 @@ export default function CoursesShelf() {</span></div>) : (- <div className="grid gap-3 sm:grid-cols-2 lg:grid-cols-3">+ <div className={pageGridClass(3)}>{active.map((course) => (<Linkkey={course.id}diff --git a/web/components/courses/OrganizedSessionList.tsx b/web/components/courses/OrganizedSessionList.tsxindex 1c9732bca..efa774ef6 100644--- a/web/components/courses/OrganizedSessionList.tsx+++ b/web/components/courses/OrganizedSessionList.tsx@@ -13,6 +13,7 @@ import {FolderOpen,GraduationCap,MoreHorizontal,+ Unlink,Pencil,Pin,PinOff,@@ -26,6 +27,9 @@ import {sessionKindOf,SessionAvatar,} from "@/components/sidebar/SessionAvatar";+import { useTaskBoard } from "@/lib/task-board-store";+import { sessionTaskLinks, setTaskStatusLink } from "@/lib/task-board-api";+import { notify } from "@/lib/notifications";import { useUnreadSessions } from "@/lib/session-unread";import type { StudyCourse } from "@/lib/courses-api";import type { ChatWorkspaceRegistration } from "@/lib/workspaces-api";@@ -126,6 +130,7 @@ export default function OrganizedSessionList({// Reads the set; `SessionList` owns keeping it current.const unread = useUnreadSessions();const { t } = useTranslation();+ const { board: taskBoard } = useTaskBoard();// Backend writes the English sentinel "New conversation" until the LLM// title lands; mirror SessionList by showing a localized, breathing label.const placeholderLabel = t("New chat");@@ -300,6 +305,9 @@ export default function OrganizedSessionList({const menuOpen = openMenuId === session.session_id;const archived = Boolean(session.preferences?.archived);const pinned = Boolean(session.preferences?.pinned);+ const taskLinks = sessionTaskLinks(+ taskBoard, session.session_id, sessionWorkspaceId(session),+ );return (<div key={session.session_id} className="relative">@@ -345,6 +353,7 @@ export default function OrganizedSessionList({) : null}<SessionAvatarsessionId={session.session_id}+ workspaceId={sessionWorkspaceId(session)}mark={deriveSessionMark(session, liveSessionIds, unread)}kind={sessionKindOf(session)}size={child ? 11 : 12}@@ -470,6 +479,21 @@ export default function OrganizedSessionList({setMenuPosition(null);}}/>+ {taskLinks?.task_ids.length ? (+ <MenuButton+ icon={Unlink}+ label={t(taskLinks.status_link_enabled ? "tasks.unlinkStatus" : "tasks.linkStatus")}+ onClick={() => {+ void setTaskStatusLink(+ session.session_id,+ sessionWorkspaceId(session),+ !taskLinks.status_link_enabled,+ ).catch(() => notify(t("tasks.saveError"), { tone: "error" }));+ setOpenMenuId(null);+ setMenuPosition(null);+ }}+ />+ ) : null}{courses.length > 0 ? (<><div className="my-1 border-t border-[var(--border)]/70" />diff --git a/web/components/knowledge/KnowledgeHome.tsx b/web/components/knowledge/KnowledgeHome.tsxindex 33c6ebb2e..d1706c6d2 100644--- a/web/components/knowledge/KnowledgeHome.tsx+++ b/web/components/knowledge/KnowledgeHome.tsx@@ -1,5 +1,6 @@"use client";+import { FeaturePage, PageHeader, pageActionClass, pageGridClass } from '@/components/layout/FeaturePage'import { knowledgeBaseRef } from "@/lib/knowledge-helpers";import { useMemo, useState } from "react";import { useTranslation } from "react-i18next";@@ -231,27 +232,21 @@ export default function KnowledgeHome({);return (- <div className="min-w-0 flex-1 overflow-y-auto bg-[var(--background)]">- <div className="mx-auto w-full max-w-5xl px-4 py-6 sm:px-6 sm:py-8">- {/* Header */}- <div className="flex items-start justify-between gap-4">- <div>- <h1 className="text-[19px] font-semibold tracking-tight text-[var(--foreground)]">- {t("Knowledge Center")}- </h1>- <p className="mt-1 text-[12.5px] text-[var(--muted-foreground)]">- {t("Manage your knowledge bases and retrieval engines.")}- </p>- </div>+ <FeaturePage>+ <PageHeader+ title={t("Knowledge Center")}+ description={t("Manage your knowledge bases and retrieval engines.")}+ action={<buttontype="button"onClick={onCreate}- className="inline-flex shrink-0 items-center gap-1.5 rounded-lg bg-[var(--primary)] px-3.5 py-2 text-[12.5px] font-medium text-[var(--primary-foreground)] transition-opacity hover:opacity-90"+ className={pageActionClass()}><Plus size={14} />{t("New knowledge base")}</button>- </div>+ }+ /><divrole="tablist"@@ -360,7 +355,7 @@ export default function KnowledgeHome({{t("No matches")}</div>) : (- <div className="grid grid-cols-1 gap-3 sm:grid-cols-2">+ <div className={pageGridClass(2)}>{filteredKbs.map((kb) => {const docs = kbDocCount(kb);return (@@ -429,7 +424,7 @@ export default function KnowledgeHome({</p></div></div>- <div className="grid grid-cols-1 items-stretch gap-3 md:grid-cols-2">+ <div className={pageGridClass(2)}>{groupedProviders.local.map(renderProvider)}</div></section>@@ -446,7 +441,7 @@ export default function KnowledgeHome({</p></div></div>- <div className="grid grid-cols-1 items-stretch gap-3 md:grid-cols-2">+ <div className={pageGridClass(2)}>{groupedProviders.server.map(renderProvider)}</div></section>@@ -463,7 +458,7 @@ export default function KnowledgeHome({</p></div></div>- <div className="grid grid-cols-1 items-stretch gap-3 md:grid-cols-2">+ <div className={pageGridClass(2)}>{groupedProviders.cloud.map(renderProvider)}</div></section>@@ -482,13 +477,12 @@ export default function KnowledgeHome({</p></div></div>- <div className="grid grid-cols-1 items-stretch gap-3 md:grid-cols-2">+ <div className={pageGridClass(2)}>{externalSources.map(renderExternalSource)}</div></section></div>)}- </div>- </div>+ </FeaturePage>);}diff --git a/web/components/layout/FeaturePage.tsx b/web/components/layout/FeaturePage.tsxnew file mode 100644index 000000000..c889d7923--- /dev/null+++ b/web/components/layout/FeaturePage.tsx@@ -0,0 +1,108 @@+import type { ComponentPropsWithRef, ReactNode, Ref, UIEventHandler } from 'react'++/** Feature page standard, based on Personalized Learning:+ * - Centered 1180px outer box; horizontal gutters 24px, 36px from 768px.+ * - Vertical padding 28px, 36px from 1024px; 24px from header to content.+ * - Serif page title 27px / 30px at 640px of usable content; no title icon.+ * - Sans description 12.5px, section label 13.5px; one h1 per page.+ * - Actions stack below the title under 640px of content and wrap in order.+ * - Grids share 520 / 800 / 1040px container breakpoints and a 12px gap.+ * - Readers, editors and chats retain pane-specific working toolbars.+ * Use FeaturePage once per scrolling page, or PageContainer inside an+ * existing scroller. Child components must not add another page gutter.+ */+export function PageContainer({+ children,+ className = '',+ spacing = 'page',+ ...props+}: ComponentPropsWithRef<'div'> & { spacing?: 'page' | 'toolbar' }) {+ return (+ <div+ {...props}+ data-page-container+ className={`dt-page-container mx-auto w-full min-w-0 max-w-[1180px] px-6 md:px-9 ${spacing === 'page' ? 'py-7 lg:py-9' : 'py-3'} ${className}`}+ >+ {children}+ </div>+ )+}++export function FeaturePage({+ children,+ className = '',+ scrollRef,+ onScroll,+}: {+ children: ReactNode+ className?: string+ scrollRef?: Ref<HTMLElement>+ onScroll?: UIEventHandler<HTMLElement>+}) {+ return (+ <section+ ref={scrollRef}+ onScroll={onScroll}+ data-feature-page+ className={`h-full min-h-0 w-full min-w-0 overflow-y-auto bg-[var(--background)] text-[var(--foreground)] [scrollbar-gutter:stable] ${className}`}+ >+ <PageContainer>{children}</PageContainer>+ </section>+ )+}++export const PAGE_TITLE_CLASS = 'dt-page-title min-w-0 break-words font-serif font-semibold leading-normal tracking-[-0.02em] text-[var(--foreground)]'+export const PAGE_DESCRIPTION_CLASS = 'mt-1.5 max-w-2xl text-[12.5px] leading-relaxed text-[var(--muted-foreground)]'+export const PAGE_SECTION_TITLE_CLASS = 'text-[13.5px] font-semibold text-[var(--foreground)]'++/** No decorative title icon or divider. Icons belong to cards and actions.+ * Secondary sections use h2 so a feature page always has one main heading.+ */+export function PageHeader({+ title,+ description,+ action,+ meta,+ level = 1,+ titleId,+ headingTour,+}: {+ title: ReactNode+ description?: ReactNode+ action?: ReactNode+ meta?: ReactNode+ level?: 1 | 2+ titleId?: string+ headingTour?: string+}) {+ const Heading = level === 1 ? 'h1' : 'h2'+ return (+ <header data-page-header className="dt-page-header mb-6 flex min-w-0 flex-col gap-4">+ <div className="min-w-0">+ <div className="flex flex-wrap items-center gap-2.5">+ <Heading id={titleId} data-tour={headingTour} className={level === 1 ? PAGE_TITLE_CLASS : PAGE_SECTION_TITLE_CLASS}>+ {title}+ </Heading>+ {meta}+ </div>+ {description && <p className={PAGE_DESCRIPTION_CLASS}>{description}</p>}+ </div>+ {action && <div data-page-actions className="flex max-w-full shrink-0 flex-wrap items-center gap-2 [&>div]:max-w-full [&>div]:flex-wrap">{action}</div>}+ </header>+ )+}++export function pageActionClass(variant: 'primary' | 'secondary' = 'primary') {+ return `dt-page-action inline-flex items-center justify-center gap-1.5 rounded-lg px-3.5 py-2 text-[12.5px] font-medium leading-[18px] transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[var(--ring)] disabled:opacity-60 ${+ variant === 'primary'+ ? 'bg-[var(--primary)] text-[var(--primary-foreground)] hover:opacity-90'+ : 'border border-[var(--border)] text-[var(--foreground)] hover:bg-[var(--muted)]'+ }`+}++/** Column limits describe the content, while one set of container breakpoints+ * controls every library. Works on divs and semantic lists alike.+ */+export function pageGridClass(columns: 2 | 3 | 5 | 'board' = 2) {+ return `dt-page-grid dt-page-grid-${columns}`+}diff --git a/web/components/learning/LearningDashboard.tsx b/web/components/learning/LearningDashboard.tsxindex 993fecb3f..a67ce67aa 100644--- a/web/components/learning/LearningDashboard.tsx+++ b/web/components/learning/LearningDashboard.tsx@@ -1,5 +1,6 @@'use client'+import { pageGridClass } from '@/components/layout/FeaturePage'import { useEffect, useState } from 'react'import { BookOpen, Route } from 'lucide-react'import { useTranslation } from 'react-i18next'@@ -111,7 +112,7 @@ export function LearningDashboard() {<h2 id="learning-todos" className="mb-3 text-[13.5px] font-semibold">{t('What needs your attention')}</h2>- <div className="grid gap-3 md:grid-cols-2">+ <div className={pageGridClass(2)}>{todos.reviews.map(topic => (<LearningCardkey={`${topic.content_workspace_id}:${topic.path_id}`}@@ -158,7 +159,7 @@ export function LearningDashboard() {<h2 id="learning-recent" className="mb-3 text-[13.5px] font-semibold">{t('Recent activity')}</h2>- <div className="grid gap-3 md:grid-cols-2">+ <div className={pageGridClass(2)}>{recent.map(item => {const surface = learningSurface(item.kind)return (diff --git a/web/components/learning/LearningShell.tsx b/web/components/learning/LearningShell.tsxindex b4066470e..8d5d6c9ff 100644--- a/web/components/learning/LearningShell.tsx+++ b/web/components/learning/LearningShell.tsx@@ -5,6 +5,7 @@ import { ArrowLeft, AlertCircle, RefreshCw } from 'lucide-react'import type { ReactNode, Ref, UIEventHandler } from 'react'import { useTranslation } from 'react-i18next'import { LEARNING_HUB } from '@/lib/learning-routes'+import { FeaturePage, PageHeader } from '@/components/layout/FeaturePage'/** The same page rhythm for the hub and each library; readers keep their full-screen layouts. */export function LearningShell({@@ -32,39 +33,24 @@ export function LearningShell({}) {const { t } = useTranslation()return (- <section- ref={scrollRef}+ <FeaturePage+ scrollRef={scrollRef}onScroll={onScroll}- className={`h-full min-h-0 w-full overflow-y-auto bg-[var(--background)] text-[var(--foreground)] ${className}`}+ className={className}>- <div className="mx-auto w-full max-w-[1180px] px-6 py-7 md:px-9 lg:py-9">- {back && (- <Link- href={LEARNING_HUB}- className="mb-5 inline-flex items-center gap-1.5 text-xs text-[var(--muted-foreground)] hover:text-[var(--foreground)]"- >- <ArrowLeft size={14} />- {t('Personalized Learning')}- </Link>- )}- <header className="flex flex-col gap-4 sm:flex-row sm:items-end sm:justify-between">- <div className="min-w-0">- <div className="flex flex-wrap items-center gap-2.5">- <h1 className="font-serif text-[27px] font-semibold tracking-[-0.02em] md:text-[30px]">- {title}- </h1>- {scopeChip}- </div>- <p className="mt-1.5 max-w-2xl text-[12.5px] leading-relaxed text-[var(--muted-foreground)]">- {subtitle}- </p>- </div>- {action && <div className="flex shrink-0 flex-wrap items-center gap-2">{action}</div>}- </header>- {tabs}- <div className="mt-6">{children}</div>- </div>- </section>+ {back && (+ <Link+ href={LEARNING_HUB}+ className="mb-5 inline-flex items-center gap-1.5 text-xs text-[var(--muted-foreground)] hover:text-[var(--foreground)]"+ >+ <ArrowLeft size={14} />+ {t('Personalized Learning')}+ </Link>+ )}+ <PageHeader title={title} description={subtitle} action={action} meta={scopeChip} />+ {tabs}+ <div className={tabs ? 'mt-6' : ''}>{children}</div>+ </FeaturePage>)}diff --git a/web/components/learning/LearningWays.tsx b/web/components/learning/LearningWays.tsxindex ca3947208..4f186085f 100644--- a/web/components/learning/LearningWays.tsx+++ b/web/components/learning/LearningWays.tsx@@ -1,5 +1,6 @@'use client'+import { pageGridClass } from '@/components/layout/FeaturePage'import Link from 'next/link'import { useCallback, useEffect, useId, useRef, useState } from 'react'import { createPortal } from 'react-dom'@@ -37,7 +38,7 @@ export function LearningWays() {<h2 id={id} className="sr-only">{t('Ways to learn')}</h2>- <div className="grid gap-3 sm:grid-cols-2 lg:grid-cols-3 xl:grid-cols-5">+ <div className={pageGridClass(5)}>{LEARNING_SURFACES.map(surface => {const opened = openKind === surface.kindreturn (diff --git a/web/components/learning/practice/PracticePage.tsx b/web/components/learning/practice/PracticePage.tsxindex 8067c654e..a941fdfce 100644--- a/web/components/learning/practice/PracticePage.tsx+++ b/web/components/learning/practice/PracticePage.tsx@@ -293,7 +293,6 @@ function PracticePageShell({return (<><SpaceSectionHeader- icon={ClipboardList}title={t("Question Bank")}description={t("Questions from every source, together with your own imports.")}action={action}diff --git a/web/components/memory/MemoryHub.tsx b/web/components/memory/MemoryHub.tsxindex 491629c41..4643b50a5 100644--- a/web/components/memory/MemoryHub.tsx+++ b/web/components/memory/MemoryHub.tsx@@ -1,10 +1,10 @@"use client";+import { PageHeader, pageActionClass, pageGridClass } from '@/components/layout/FeaturePage'import Link from "next/link";import { useCallback, useEffect, useState } from "react";import {ArrowRight,- Brain,Layers,Network,RefreshCw,@@ -86,26 +86,16 @@ export default function MemoryHub() {const latestBackup = overview?.backups?.[overview.backups.length - 1] ?? null;return (- <div className="space-y-10">- <header className="space-y-3">- <div className="flex items-center gap-3">- <span className="grid h-10 w-10 place-items-center rounded-xl bg-[var(--primary)]/10 text-[var(--primary)]">- <Brain className="h-5 w-5" />- </span>- <h1 className="font-serif text-[28px] font-semibold tracking-tight text-[var(--foreground)] md:text-[32px]">- {t("Memory")}- </h1>- </div>- <p className="max-w-2xl text-[14px] text-[var(--muted-foreground)] md:text-[15px]">- {t(- "Everything DeepTutor remembers about you, organised across three layers. Click into any layer to inspect or curate it.",- )}- </p>+ <div className="space-y-9">+ <PageHeader+ title={t("Memory")}+ description={t("Everything DeepTutor remembers about you, organised across three layers. Click into any layer to inspect or curate it.")}+ action={<div className="flex items-center gap-3 text-[12px] text-[var(--muted-foreground)]"><buttontype="button"onClick={() => void load()}- className="inline-flex items-center gap-1.5 rounded-md border border-[var(--border)] bg-[var(--background)] px-2.5 py-1 transition hover:bg-[var(--muted)]"+ className={pageActionClass('secondary')}><RefreshCwclassName={loading ? "h-3 w-3 animate-spin" : "h-3 w-3"}@@ -119,9 +109,10 @@ export default function MemoryHub() {{t("Memory settings")}</Link></div>- </header>+ }+ />- <div className="grid grid-cols-1 gap-5 md:grid-cols-3">+ <div className={pageGridClass(3)}><LayerCardhref="/memory/l1"icon={Layers}diff --git a/web/components/memory/MemorySection.tsx b/web/components/memory/MemorySection.tsxindex f2c02b729..e23b64203 100644--- a/web/components/memory/MemorySection.tsx+++ b/web/components/memory/MemorySection.tsx@@ -450,7 +450,6 @@ export default function MemorySection({<div className="space-y-6">{!hideHeader && (<SpaceSectionHeader- icon={Brain}title={t("Memory")}description={t("L1 mirrors your workspace, L2 summarises per-surface content, L3 is cross-surface knowledge.",diff --git a/web/components/reading/library/ReadingFolder.tsx b/web/components/reading/library/ReadingFolder.tsxindex 7ba731903..537c7721a 100644--- a/web/components/reading/library/ReadingFolder.tsx+++ b/web/components/reading/library/ReadingFolder.tsx@@ -1,5 +1,6 @@"use client";+import { FeaturePage, PageHeader, PAGE_SECTION_TITLE_CLASS } from '@/components/layout/FeaturePage'import {ArrowRight,BookOpen,@@ -38,7 +39,6 @@ import { activeWorkspaceId, scopedUrl } from "@/lib/workspace-scope";import { AddMaterialsDialog } from "./AddMaterialsDialog";import { FolderDialog } from "./FolderDialog";-import { FolderGlyph } from "./FolderGlyph";import { DeleteCollectionDialog } from "./ReadingLibrary";import { MaterialGlyph, materialDetail, relativeDate } from "./shared";@@ -173,23 +173,11 @@ export function ReadingFolderPage({ folderId }: { folderId: string }) {<span className="truncate text-[var(--foreground)]">{folder.title}</span></nav>- <header className="mt-6 flex flex-col gap-5 sm:flex-row sm:items-end">- <FolderGlyph- color={folder.color}- files={files.length}- size={84}- className="shrink-0"- />- <div className="min-w-0 flex-1">- <h1 className="font-serif text-[26px] font-semibold leading-tight tracking-[-0.02em] md:text-[28px]">- {folder.title}- </h1>- <p className="mt-1.5 text-[12.5px] text-[var(--muted-foreground)]">- {t("{{count}} files", { count: files.length })}- {" · "}- {t("Stored in {{workspace}}", { workspace: workspaceLabel })}- </p>- </div>+ <div className="mt-5">+ <PageHeader+ title={folder.title}+ description={<>{t("{{count}} files", { count: files.length })}{" · "}{t("Stored in {{workspace}}", { workspace: workspaceLabel })}</>}+ action={<div className="relative flex shrink-0 items-center gap-2">{files.length ? (<Link@@ -255,7 +243,9 @@ export function ReadingFolderPage({ folderId }: { folderId: string }) {</>)}</div>- </header>+ }+ />+ </div>{error && (<p role="alert" className="mt-4 text-[12px] text-[var(--destructive)]">@@ -369,18 +359,12 @@ export function ReadingFolderPage({ folderId }: { folderId: string }) {}function FolderFrame({ children }: { children: React.ReactNode }) {- return (- <section className="h-full min-h-0 w-full overflow-y-auto bg-[var(--background)] text-[var(--foreground)]">- <div className="mx-auto w-full max-w-[920px] px-6 py-7 md:px-9 lg:py-9">- {children}- </div>- </section>- );+ return <FeaturePage>{children}</FeaturePage>;}function SectionHeading({ label, count }: { label: string; count: number }) {return (- <h2 className="flex items-center gap-1.5 px-1 text-[11.5px] font-medium text-[var(--muted-foreground)]">+ <h2 className={`mb-3 flex items-center gap-1.5 ${PAGE_SECTION_TITLE_CLASS}`}>{label}<span className="tabular-nums opacity-70">{count}</span></h2>diff --git a/web/components/settings/AddProviderPanel.tsx b/web/components/settings/AddProviderPanel.tsxnew file mode 100644index 000000000..39bbca50d--- /dev/null+++ b/web/components/settings/AddProviderPanel.tsx@@ -0,0 +1,220 @@+'use client'++import { useId, useState } from 'react'+import { useTranslation } from 'react-i18next'+import ProviderIcon from '@/components/common/ProviderIcon'+import type { ApiFormat, ServiceName } from '@/lib/model-catalog-types'+import { SERVICE_TITLES } from '@/lib/provider-registry'+import { inputClass, selectClass, subPanelClass } from './shared'+import { registryButton, registryPrimary } from './RegistryControls'++export type ProviderCatalogOption = { value: string; label: string; services: ServiceName[] }+export type CustomProviderInput = { name: string; base_url: string; api_format: ApiFormat }+const FILTERS = [+ 'all',+ 'multi',+ 'llm',+ 'embedding',+ 'voice',+ 'search',+ 'imagegen',+ 'videogen',+ 'custom',+] as const+const PROTOCOLS = {+ openai_chat: 'OpenAI Chat Completions',+ openai_responses: 'OpenAI Responses',+ anthropic: 'Anthropic Messages',+} as const+export function ProviderProtocol({+ value,+ onChange,+ allowAuto = true,+}: {+ value: ApiFormat+ onChange: (value: ApiFormat) => void+ allowAuto?: boolean+}) {+ const { t } = useTranslation()+ return (+ <label className="block space-y-1.5 text-xs font-medium">+ <span>{t('settings.providerServices.protocol')}</span>+ <select+ className={selectClass}+ value={value}+ onChange={e => onChange(e.target.value as ApiFormat)}+ >+ {allowAuto && <option value="auto">{t('Auto')}</option>}+ {Object.entries(PROTOCOLS).map(([key, label]) => (+ <option key={key} value={key}>+ {t(label)}+ </option>+ ))}+ </select>+ </label>+ )+}+export function AddProviderPanel({+ options,+ vendor,+ onVendor,+ onCreate,+ onCancel,+}: {+ options: ProviderCatalogOption[]+ vendor: string+ onVendor: (value: string) => void+ onCreate: (custom?: CustomProviderInput) => void+ onCancel: () => void+}) {+ const { t } = useTranslation()+ const radioName = useId()+ const [filter, setFilter] = useState<string>('all')+ const [query, setQuery] = useState('')+ const [name, setName] = useState('')+ const [url, setUrl] = useState('')+ const [protocol, setProtocol] = useState<ApiFormat>('openai_chat')+ const custom = vendor === 'custom'+ const visible = options.filter(option => {+ const category =+ filter === 'all' ||+ (filter === 'custom'+ ? option.value === 'custom'+ : option.value !== 'custom' &&+ (filter === 'multi'+ ? option.services.length > 1+ : filter === 'voice'+ ? option.services.some(s => s === 'tts' || s === 'stt')+ : option.services.includes(filter as ServiceName)))+ return (+ category &&+ `${option.label} ${option.value}`.toLowerCase().includes(query.trim().toLowerCase())+ )+ })+ let validUrl = false+ try {+ const parsed = new URL(url)+ validUrl =+ ['https:', 'http:'].includes(parsed.protocol) &&+ !parsed.username &&+ !parsed.password &&+ Boolean(parsed.hostname)+ } catch {}+ return (+ <section aria-label={t('Add provider')} className={`min-w-0 space-y-4 p-5 ${subPanelClass}`}>+ <h3 className="text-base font-semibold">{t('Add provider')}</h3>+ <input+ type="search"+ className={inputClass}+ value={query}+ aria-label={t('settings.providerServices.search')}+ placeholder={t('settings.providerServices.search')}+ onChange={e => setQuery(e.target.value)}+ />+ <div+ role="group"+ aria-label={t('settings.providerServices.filter')}+ className="flex flex-wrap gap-1.5"+ >+ {FILTERS.map(item => (+ <button+ type="button"+ key={item}+ aria-pressed={filter === item}+ onClick={() => {+ setFilter(item)+ onVendor('')+ }}+ className={`rounded-full border px-3 py-1.5 text-xs ${filter === item ? 'border-[var(--foreground)] bg-[var(--foreground)] text-[var(--background)]' : 'border-[var(--border)] hover:bg-[var(--accent)]'}`}+ >+ {t(`settings.providerServices.filter.${item}`)}+ </button>+ ))}+ </div>+ <div+ role="radiogroup"+ aria-label={t('Provider type')}+ className="grid max-h-80 gap-2 overflow-y-auto p-0.5 sm:grid-cols-2"+ >+ {visible.map(option => (+ <label+ key={option.value}+ className={`min-w-0 rounded-xl border p-3 text-left cursor-pointer outline-none focus-within:ring-2 focus-within:ring-[var(--ring)] ${vendor === option.value ? 'border-[var(--primary)] bg-[var(--accent)]' : 'border-[var(--border)] bg-[var(--background)] hover:bg-[var(--accent)]'}`}+ >+ <input type="radio" className="sr-only" name={radioName} value={option.value} aria-label={option.value === 'custom' ? t('Custom') : option.label} checked={vendor === option.value} onChange={() => onVendor(option.value)} />+ <span className="flex items-center gap-2 text-sm font-medium">+ <ProviderIcon provider={option.value} size={16} />+ {option.value === 'custom' ? t('Custom') : option.label}+ </span>+ <span className="mt-2 flex flex-wrap gap-1">+ {option.value === 'custom' ? (+ <span className="text-xs text-[var(--muted-foreground)]">+ {t('settings.providerServices.customHint')}+ </span>+ ) : (+ option.services.map(service => (+ <span+ key={service}+ className="rounded bg-[var(--muted)] px-1.5 py-0.5 text-[10px] text-[var(--muted-foreground)]"+ >+ {t(SERVICE_TITLES[service])}+ </span>+ ))+ )}+ </span>+ </label>+ ))}+ </div>+ {!visible.length && (+ <p role="status" className="py-3 text-xs text-[var(--muted-foreground)]">+ {t('settings.providerServices.noMatch')}+ </p>+ )}+ {custom && (+ <div className="space-y-3 rounded-xl border border-[var(--border)] bg-[var(--background)] p-4">+ <label className="block space-y-1.5 text-xs font-medium">+ <span>{t('settings.providerServices.name')}</span>+ <input className={inputClass} value={name} onChange={e => setName(e.target.value)} />+ </label>+ <label className="block space-y-1.5 text-xs font-medium">+ <span>{t('Provider URL')}</span>+ <input className={inputClass} value={url} onChange={e => setUrl(e.target.value)} />+ </label>+ {url && !validUrl && (+ <p role="status" className="text-xs text-red-600">+ {t('Enter a valid HTTP or HTTPS provider address.')}+ </p>+ )}+ <ProviderProtocol value={protocol} onChange={setProtocol} allowAuto={false} />+ <p className="text-xs leading-relaxed text-[var(--muted-foreground)]">+ {t('settings.providerServices.customDescription')}+ </p>+ </div>+ )}+ <p className="text-xs leading-relaxed text-[var(--muted-foreground)]">+ {t('settings.providerServices.addHint')}+ </p>+ <div className="flex gap-2 border-t border-[var(--border)] pt-4">+ <button+ type="button"+ className={registryPrimary}+ disabled={+ !vendor ||+ !visible.some(p => p.value === vendor) ||+ (custom && (!name.trim() || !validUrl))+ }+ onClick={() =>+ onCreate(+ custom ? { name: name.trim(), base_url: url.trim(), api_format: protocol } : undefined+ )+ }+ >+ {t('Continue')}+ </button>+ <button type="button" className={registryButton} onClick={onCancel}>+ {t('Cancel')}+ </button>+ </div>+ </section>+ )+}diff --git a/web/components/settings/AgentSetupHelp.tsx b/web/components/settings/AgentSetupHelp.tsxnew file mode 100644index 000000000..25a58e590--- /dev/null+++ b/web/components/settings/AgentSetupHelp.tsx@@ -0,0 +1,81 @@+"use client";++import { useState } from "react";+import { Bot, Check, Copy } from "lucide-react";+import { useTranslation } from "react-i18next";+import Modal from "@/components/common/Modal";+import { copyText } from "@/lib/clipboard";++export default function AgentSetupHelp() {+ const { t } = useTranslation();+ const [open, setOpen] = useState(false);+ const [copyState, setCopyState] = useState<"idle" | "copying" | "copied" | "failed">("idle");+ const prompt = t("settings.agentSetup.prompt");++ const copy = async () => {+ setCopyState("copying");+ try {+ await copyText(prompt);+ setCopyState("copied");+ } catch {+ setCopyState("failed");+ }+ };++ return (+ <>+ <div className="flex flex-wrap items-center justify-between gap-3 border-b border-[var(--border)]/50 py-4">+ <p className="text-[13px] leading-relaxed text-[var(--muted-foreground)]">+ {t("settings.agentSetup.description")}+ </p>+ <button+ type="button"+ onClick={() => {+ setCopyState("idle");+ setOpen(true);+ }}+ className="inline-flex items-center gap-2 rounded-lg border border-[var(--border)] px-3 py-2 text-[13px] font-medium hover:bg-[var(--muted)] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[var(--ring)]"+ >+ <Bot size={16} aria-hidden="true" />+ {t("settings.agentSetup.title")}+ </button>+ </div>+ <Modal+ isOpen={open}+ onClose={() => setOpen(false)}+ title={t("settings.agentSetup.title")}+ width="lg"+ footer={+ <div className="flex flex-wrap items-center justify-end gap-3">+ <p role="status" className="text-xs text-[var(--muted-foreground)]">+ {copyState === "failed" ? t("settings.agentSetup.copyFailed") : copyState === "copied" ? t("Copied") : ""}+ </p>+ <button+ type="button"+ onClick={() => void copy()}+ disabled={copyState === "copying"}+ className="inline-flex items-center gap-2 rounded-lg bg-[var(--foreground)] px-4 py-2 text-sm font-medium text-[var(--background)] disabled:opacity-50 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[var(--ring)] focus-visible:ring-offset-2"+ >+ {copyState === "copied" ? <Check size={16} aria-hidden="true" /> : <Copy size={16} aria-hidden="true" />}+ {t("settings.agentSetup.copy")}+ </button>+ </div>+ }+ >+ <div className="space-y-4 p-5">+ <p className="text-sm leading-relaxed text-[var(--muted-foreground)]">+ {t("settings.agentSetup.instructions")}+ </p>+ <textarea+ readOnly+ data-autofocus+ aria-label={t("settings.agentSetup.title")}+ value={prompt}+ onFocus={(event) => event.currentTarget.select()}+ className="h-72 w-full resize-y rounded-lg border border-[var(--border)] bg-[var(--background)] p-3 text-sm leading-relaxed text-[var(--foreground)] focus:outline-none focus:ring-2 focus:ring-[var(--ring)]"+ />+ </div>+ </Modal>+ </>+ );+}diff --git a/web/components/settings/ModelsWorkspace.tsx b/web/components/settings/ModelsWorkspace.tsxindex 1b23bdb44..86962f5d0 100644--- a/web/components/settings/ModelsWorkspace.tsx+++ b/web/components/settings/ModelsWorkspace.tsx@@ -20,12 +20,15 @@ import {providerIdentity,providerProbeInput,providerRegistry,+ providerServiceSupport,SERVICE_TITLES,type ProviderSource,} from "@/lib/provider-registry";import { voiceModelOptions } from "@/lib/voice-settings";+import { VoiceDiscoveryField } from "./VoiceDiscoveryField";import { VoiceModelFields } from "./VoiceModelFields";import { VoicePreviewPanel } from "./VoicePreviewPanel";+import { ServicePreviewPanel } from "./ServicePreviewPanel";import { ModelTestPanel } from "./ModelTestPanel";import EmbeddingModelUsage from "./EmbeddingModelUsage";import {@@ -110,33 +113,9 @@ export function ModelsWorkspace({const selectedRow = rows.find((r) => r.key === selected);// Providers and models can be created together in the same draft.const sources = providerRegistry(draft);- /** Whether a built-in adapter is on record for this vendor and service. */- const declared = (source: ProviderSource, service: ServiceName) => {- const adapterService = service === "task" ? "llm" : service;- const exact = providers[adapterService]?.some(- (option) =>- option.value === source.provider &&- option.value !== "none" &&- option.status !== "deprecated",- );- const mapped = connectionTargets.find(- (target) => target.provider === source.provider,- )?.services[adapterService];- return Boolean(- exact ||- mapped ||- (service !== "search" && source.service === service) ||- (service === "task" && source.service === "llm") ||- (service !== "search" && source.provider === "custom"),- );- };- // Not being on record is not a veto for any service. Whether a vendor serves- // a given model type is not knowable from its registry entry — plenty of- // OpenAI-compatible endpoints serve embeddings or speech without appearing in- // that service's table — so every provider is selectable, the ones with no- // adapter on record are only grouped apart, and a wrong pick is reported by- // the model test rather than pre-empted here. Managed credentials stay out:- // that is not a capability judgement, their models arrive with them.+ const declared = (source: ProviderSource, service: ServiceName) =>+ providerServiceSupport(source, service, connectionTargets, providers).enabled;+ // Keep compatible custom connections available behind an explicit choice.const selectable = sources.filter((source) => !("managed_by" in source.source && source.source.managed_by),);@@ -183,7 +162,7 @@ export function ModelsWorkspace({provider_ref: ref,...(newService === "tts"? {- voice: target?.default_voice || "",+ voice: "",response_format: voiceModelOptions(target?.voice_options, target?.default_model || "")?.formats[0] || "mp3",}: {}),@@ -248,10 +227,10 @@ export function ModelsWorkspace({</button>}search={{- label: t("Find model"),+ label: t(page === "search" ? "settings.serviceConfig.findSearch" : "Find model"),value: query,onChange: setQuery,- placeholder: t("Search by model or provider"),+ placeholder: t(page === "search" ? "settings.serviceConfig.findSearch" : "Search by model or provider"),}}filter={page === "voice" || page === "multimodal" ? (@@ -274,8 +253,8 @@ export function ModelsWorkspace({filtered.length? undefined: rows.length- ? t("No models match your search.")- : t("No models configured yet.")+ ? t(page === "search" ? "settings.serviceConfig.noSearchMatch" : "No models match your search.")+ : t(page === "search" ? "settings.serviceConfig.noSearch" : "No models configured yet.")}>{filtered.map((row) => {@@ -323,7 +302,7 @@ export function ModelsWorkspace({className="inline-flex shrink-0 items-center gap-0.5 text-[10px] text-[var(--primary)]"><Check size={13} />- {t("Default model")}+ {t(row.service === "search" ? "settings.serviceConfig.defaultSearch" : "Default model")}</span>)}</span>@@ -380,7 +359,7 @@ export function ModelsWorkspace({icon={<SlidersHorizontal size={17} />}title={t("Nothing selected")}hint={t(- "Select a model to view its settings and connection test.",+ page === "search" ? "settings.serviceConfig.selectSearch" : "Select a model to view its settings and connection test.",)}/>)}@@ -391,11 +370,7 @@ export function ModelsWorkspace({);}-/**- * Provider options for one service. Vendors with no adapter on record are- * offered rather than hidden — they are only separated out, so the list still- * says which ones are a known quantity without deciding for you.- */+/** Group known adapters before explicitly requested custom connections. */function ProviderOptions({sources,declared,@@ -453,6 +428,8 @@ function AddModelPanel({onCancel: () => void;}) {const { t } = useTranslation();+ const [custom, setCustom] = useState(false);+ const visible = sources.filter(source => declared(source) || (service !== "search" && custom && source.source.service_overrides?.[service === "task" ? "llm" : service]?.enabled !== false));const title = t(page === "search" ? "Add search configuration" : "Add model",);@@ -493,21 +470,21 @@ function AddModelPanel({onChange={(e) => onProvider(e.target.value)}><option value="">{t("Choose a provider")}</option>- <ProviderOptions sources={sources} declared={declared} />+ <ProviderOptions sources={visible} declared={declared} /></select></label></div>+ {service !== "search" && sources.some(source => !declared(source)) && <label className="mt-3 flex items-center gap-2 text-xs">+ <input type="checkbox" checked={custom} onChange={e => { setCustom(e.target.checked); onProvider(""); }} />+ {t("settings.serviceConfig.custom")}+ </label>}<p className="mt-3 text-xs leading-relaxed text-[var(--muted-foreground)]">- {t(- service === "search"- ? "Every provider is selectable. Search has no generic adapter, so a provider without a search API of its own is rejected by the search test — that is where a wrong pick shows up."- : "Every provider is selectable. One with no adapter on record for this model type is called as an OpenAI-compatible endpoint derived from its provider URL — add the model, then run the model test to see whether it answers.",- )}+ {t(service === "search" ? "settings.serviceConfig.search" : service === "videogen" ? "settings.serviceConfig.video" : "settings.serviceConfig.providers")}</p><div className="mt-5 flex flex-wrap items-center gap-2 border-t border-[color-mix(in_srgb,var(--border)_70%,transparent)] pt-4"><buttontype="button"- disabled={!provider}+ disabled={!provider || !visible.some(source => source.id === provider)}onClick={onCreate}className={registryPrimary}>@@ -534,6 +511,7 @@ function ModelEditor({onRemoved: () => void;}) {const { t } = useTranslation();+ const [custom, setCustom] = useState(false);const {draft,providers,@@ -547,12 +525,13 @@ function ModelEditor({};const { service, profile, model } = row;const provider = modelProvider(draft, service, profile, model);- const speechProvider = model?.provider_ref?.binding || profile.provider_ref?.binding || provider?.provider || profile.binding || "custom";+ const visible = sources.filter(source => declared(source) || source.id === provider?.id || (service !== "search" && custom && source.source.service_overrides?.[service === "task" ? "llm" : service]?.enabled !== false));+ const speechProvider = (provider?.source.service_overrides?.[service]?.enabled && provider.source.service_overrides[service]?.binding) || model?.provider_ref?.binding || profile.provider_ref?.binding || provider?.provider || profile.binding || "custom";const speechOptions = providers[service]?.find(p => p.value === speechProvider)?.voice_options;const speechPreset = voiceModelOptions(speechOptions, model?.model ?? "");const [listed, setListed] = useState<{provider: string;- models: { id: string }[];+ models: { id: string; services?: ServiceName[] }[];} | null>(null);const name = model? model.name || model.model || t("New model")@@ -588,8 +567,6 @@ function ModelEditor({const before = voiceModelOptions(speechOptions, target.model);const after = voiceModelOptions(speechOptions, String(value));if (after && after !== speechOptions?.fallback) {- if (before?.voices.some(v => v.id === target.voice) && !after.voices.some(v => v.id === target.voice))- target.voice = after.voices[0]?.id ?? "";if (before?.formats.includes(target.response_format ?? "") && !after.formats.includes(target.response_format ?? ""))target.response_format = after.formats[0] ?? "";if (before?.languages.some(l => l.id === target.language) && !after.languages.some(l => l.id === target.language))@@ -621,10 +598,9 @@ function ModelEditor({else updateSearch("provider_ref", ref);setListed(null);};- const list =- listed && listed.provider === provider?.id- ? listed.models- : provider?.source.discovery?.models || [];+ const list = (listed && listed.provider === provider?.id+ ? listed.models : provider?.source.discovery?.models || [])+ .filter(item => !item.services?.length || item.services.includes(service === "task" ? "llm" : service));const remove = async () => {await stageRegistry({ kind: "model", service, profile_id: profile.id, model_id: model?.id, delete: true });onRemoved();@@ -654,7 +630,7 @@ function ModelEditor({</div><EditableRegistryNamename={name}- label={t("Rename model")}+ label={t(service === "search" ? "settings.serviceConfig.renameSearch" : "Rename model")}onChange={(value) =>model ? update("name", value) : updateSearch("display_name", value)}@@ -690,17 +666,21 @@ function ModelEditor({{provider && !sources.some((p) => p.id === provider.id) && (<option value={provider.id}>{provider.name}</option>)}- <ProviderOptions sources={sources} declared={declared} />+ <ProviderOptions sources={visible} declared={declared} /></select></label>+ {service !== "search" && sources.some(source => !declared(source) && source.id !== provider?.id) && <label className="flex items-center gap-2 text-xs">+ <input type="checkbox" checked={custom} disabled={managed} onChange={e => setCustom(e.target.checked)} />+ {t("settings.serviceConfig.custom")}+ </label>}{/* Why the test below matters more here: nothing vouches for thispairing yet, so say what request it will actually make. */}{provider && !declared(provider) && (<p className="text-xs leading-relaxed text-[var(--muted-foreground)]">{t(service === "search"- ? "No search adapter is on record for this provider, and search has no OpenAI-compatible fallback. Run the test below — it will say so rather than search with the wrong engine."- : "No adapter for this model type is on record for this provider. DeepTutor calls it as an OpenAI-compatible endpoint derived from the provider URL; run the model test below to confirm it answers.",+ ? "settings.serviceConfig.unsupportedSearch"+ : service === "videogen" ? "settings.serviceConfig.video" : "settings.serviceConfig.providers",)}</p>)}@@ -750,6 +730,8 @@ function ModelEditor({)}</div>{model && provider && !managed && service !== "search" && (+ <details open={service === "llm" || service === "task" || service === "embedding"}>+ <summary className="mb-3 cursor-pointer text-xs text-[var(--muted-foreground)]">{t("settings.serviceConfig.discovery")}</summary><RegistryProbeinput={providerProbeInput(provider,@@ -765,12 +747,18 @@ function ModelEditor({setListed({ provider: provider.id, models: result.models })}/>+ </details>)}+ {service === "tts" && model && <VoiceDiscoveryField profileId={profile.id} modelId={model.id} value={model.voice || ""} update={value => update("voice", value)} disabled={managed} />}{model && (service === "tts" || service === "stt") ? (<VoiceModelFields service={service} provider={speechProvider} model={model}options={speechOptions} preset={speechPreset} update={update} disabled={managed} />) : model && <ModelParameters service={service} model={model} update={update} managed={managed} />}- {service === "tts" && model ? <VoicePreviewPanel profileId={profile.id} modelId={model.id} maxChars={Math.min(500, speechPreset?.max_input_chars ?? 500)} /> : <ModelTestPanel service={service} profile={profile} model={model} />}+ {service === "tts" && model ? <VoicePreviewPanel profileId={profile.id} modelId={model.id} maxChars={Math.min(500, speechPreset?.max_input_chars ?? 500)} /> : (service === "search" || service === "stt" || service === "imagegen" || service === "videogen") ? <ServicePreviewPanel service={service} profile={profile} model={model} /> : <ModelTestPanel service={service} profile={profile} model={model} />}+ {(service === "search" || service === "imagegen" || service === "videogen") && <p className="text-xs leading-relaxed text-[var(--muted-foreground)]">+ {t("settings.serviceConfig.tools")} {" "}+ <Link href="/settings/tools" className="underline underline-offset-4">{t("settings.serviceConfig.openTools")}</Link>+ </p>}<div className="flex flex-wrap items-center gap-2 border-t border-[var(--border)] pt-4"><button@@ -787,12 +775,12 @@ function ModelEditor({className={registryButton}>{active && <Check size={13} />}{" "}- {t(active ? "Default model" : "Set as default")}+ {t(active ? (service === "search" ? "settings.serviceConfig.defaultSearch" : "Default model") : "Set as default")}</button>- <Tooltip label={assignedToTask ? t("Choose another background task model before removing this model.") : t("Remove model")} side="top">+ <Tooltip label={assignedToTask ? t("Choose another background task model before removing this model.") : t(service === "search" ? "settings.serviceConfig.removeSearch" : "Remove model")} side="top"><buttontype="button"- aria-label={t("Remove model")}+ aria-label={t(service === "search" ? "settings.serviceConfig.removeSearch" : "Remove model")}disabled={applying || managed || assignedToTask}onClick={() => void remove()}className={`${registryDanger} ml-auto`}diff --git a/web/components/settings/ProviderServices.tsx b/web/components/settings/ProviderServices.tsxnew file mode 100644index 000000000..2fec08115--- /dev/null+++ b/web/components/settings/ProviderServices.tsx@@ -0,0 +1,138 @@+'use client'++import { useTranslation } from 'react-i18next'+import { useSettings, type ServiceName } from '@/features/settings/store/SettingsStore'+import type { ProviderServiceOverrides } from '@/lib/model-catalog-types'+import {+ PROVIDER_SERVICES,+ SERVICE_TITLES,+ providerAdapter,+ providerServiceSupport,+ type ProviderSource,+} from '@/lib/provider-registry'+import { inputClass, selectClass, subPanelClass } from './shared'++export function ProviderServices({+ source,+ onChange,+}: {+ source: ProviderSource+ onChange: (value: ProviderServiceOverrides) => void+}) {+ const { t } = useTranslation()+ const { providers, connectionTargets } = useSettings()+ const overrides = source.source.service_overrides ?? {}+ function patch(service: ServiceName, value: object) {+ onChange({ ...overrides, [service]: { ...overrides[service], ...value } })+ }+ return (+ <section+ aria-label={t('settings.providerServices.title')}+ className={`space-y-3 p-4 ${subPanelClass}`}+ >+ <div className="flex flex-wrap items-center justify-between gap-2">+ <h4 className="text-sm font-medium">{t('settings.providerServices.title')}</h4>+ {Object.keys(overrides).length > 0 && (+ <button+ type="button"+ className="text-xs underline underline-offset-4"+ onClick={() => onChange({})}+ >+ {t('settings.providerServices.reset')}+ </button>+ )}+ </div>+ <p className="text-xs leading-relaxed text-[var(--muted-foreground)]">+ {t('settings.providerServices.description')}+ </p>+ <div className="grid gap-2 sm:grid-cols-2">+ {PROVIDER_SERVICES.map(service => {+ const support = providerServiceSupport(source, service, connectionTargets, providers)+ const adapter = providerAdapter(source, service, connectionTargets, providers)+ const options = (providers[service] ?? []).filter(+ p => p.value !== 'none' && p.status !== 'deprecated'+ )+ const defaultBinding = options.some(p => p.value === adapter.binding)+ ? adapter.binding+ : service === 'search'+ ? options[0]?.value+ : 'custom'+ const binding = overrides[service]?.binding || defaultBinding || ''+ return (+ <div+ key={service}+ className="rounded-lg border border-[var(--border)] bg-[var(--background)] p-3"+ >+ <label className="flex items-start gap-2 text-xs">+ <input+ type="checkbox"+ className="mt-0.5"+ checked={support.enabled}+ onChange={e =>+ patch(service, {+ enabled: e.target.checked,+ ...(e.target.checked ? { binding } : {}),+ })+ }+ />+ <span>+ <span className="block font-medium">{t(SERVICE_TITLES[service])}</span>+ <span className="mt-1 block text-[11px] text-[var(--muted-foreground)]">+ {t(`settings.providerServices.evidence.${support.evidence}`)}+ </span>+ </span>+ </label>+ {support.enabled && service !== 'llm' && (+ <details className="mt-3 text-xs">+ <summary className="cursor-pointer text-[var(--muted-foreground)]">+ {t('settings.providerServices.connection')}+ </summary>+ <div className="mt-3 space-y-3">+ <label className="block space-y-1.5">+ <span>{t('settings.providerServices.adapter')}</span>+ <select+ className={selectClass}+ value={binding}+ onChange={e => patch(service, { enabled: true, binding: e.target.value })}+ >+ {!options.some(p => p.value === binding) && (+ <option value={binding}>{binding || t('Choose a provider')}</option>+ )}+ {options.map(option => (+ <option key={option.value} value={option.value}>+ {option.label}+ </option>+ ))}+ </select>+ </label>+ <label className="block space-y-1.5">+ <span>{t('settings.providerServices.url')}</span>+ <input+ className={inputClass}+ value={overrides[service]?.base_url ?? ''}+ placeholder={t('settings.providerServices.inheritUrl')}+ onChange={e =>+ patch(service, { enabled: true, binding, base_url: e.target.value })+ }+ />+ </label>+ {service === 'search' && (+ <p className="leading-relaxed text-[var(--muted-foreground)]">+ {t('settings.providerServices.searchProtocol')}+ </p>+ )}+ {service === 'videogen' && (+ <p className="leading-relaxed text-[var(--muted-foreground)]">+ {t('settings.serviceConfig.video')}+ </p>+ )}+ </div>+ </details>+ )}+ </div>+ )+ })}+ </div>+ </section>+ )+}diff --git a/web/components/settings/ProvidersWorkspace.tsx b/web/components/settings/ProvidersWorkspace.tsxindex 737d5e071..d0e6f01e3 100644--- a/web/components/settings/ProvidersWorkspace.tsx+++ b/web/components/settings/ProvidersWorkspace.tsx@@ -19,6 +19,9 @@ import {providerProbeInput,updateProvider,REGISTRY_SERVICES,+ SERVICE_TITLES,+ PROVIDER_SERVICES,+ providerServiceSupport,} from "@/lib/provider-registry";import {EditableRegistryName,@@ -28,9 +31,11 @@ import {registryDanger,registryPrimary,} from "./RegistryControls";+import { ProviderServices } from "./ProviderServices";+import { AddProviderPanel, ProviderProtocol, type CustomProviderInput } from "./AddProviderPanel";import { CodexOAuthCard } from "./CodexOAuthCard";import { CodeBuddyAuthCard } from "./CodeBuddyAuthCard";-import { selectClass, stringifyExtraHeaders, subPanelClass } from "./shared";+import { stringifyExtraHeaders, subPanelClass } from "./shared";import {WorkspaceDetailEmpty,WorkspaceRail,@@ -82,13 +87,14 @@ export function ProvidersWorkspace() {}, [sources.length]);const options = [...new Map(- REGISTRY_SERVICES.flatMap((service) =>- (providers[service] ?? [])- .filter((p) => p.value !== "none" && p.status !== "deprecated")- .map((option) => [option.value, { ...option, service }] as const),- ).reverse(),+ REGISTRY_SERVICES.flatMap((service) => (providers[service] ?? [])+ .filter(p => p.value !== "none" && p.status !== "deprecated")+ .map(option => [option.value, { ...option, service }] as const)).reverse(),).values(),- ].sort((a, b) => a.label.localeCompare(b.label));+ ].map(option => ({ ...option, services: PROVIDER_SERVICES.filter(service =>+ providers[service]?.some(p => p.value === option.value && p.status !== "deprecated") ||+ Boolean(connectionTargets.find(target => target.provider === option.value)?.services[service]))+ })).sort((a, b) => a.label.localeCompare(b.label));const source = sources.find((p) => p.id === selected);const option = options.find((p) => p.value === source?.provider);const managed = source?.provider === "openai_codex";@@ -101,7 +107,7 @@ export function ProvidersWorkspace() {updateProvider(next, source.ref, "user_name", value);});};- const create = () => {+ const create = (custom?: CustomProviderInput) => {const option = options.find((o) => o.value === vendor);if (!option) return;if (option.value === "openai_codex") {@@ -112,13 +118,15 @@ export function ProvidersWorkspace() {const id = `conn-${randomUuid()}`;const entry: CatalogConnection = {id,- name: option.label,+ name: custom?.name || option.label,provider: option.value,source_service: option.service,api_key: "",- base_url: "",+ base_url: custom?.base_url || "",api_version: "",+ ...(custom ? { service_overrides: { llm: { enabled: true, binding: "custom" } } } : {}),api_format:+ custom?.api_format ||(option.default_api_format as CatalogConnection["api_format"]) ||"auto",};@@ -140,26 +148,8 @@ export function ProvidersWorkspace() {const filtered = sources.filter((p) =>`${p.name} ${p.provider}`.toLowerCase().includes(query.toLowerCase()),);- const hints = source- ? Object.keys(- connectionTargets.find((target) => target.provider === source.provider)- ?.services ?? {},- ).map((service) =>- ["tts", "stt"].includes(service)- ? "voice"- : ["imagegen", "videogen"].includes(service)- ? "generation"- : service,- )- : [];- if (- source &&- (providers.search ?? []).some(- (p) => p.value === source.provider && p.status !== "deprecated",- )- )- hints.push("search");- if (source && ["tts", "stt"].some(service => providers[service as "tts" | "stt"]?.some(p => p.value === source.provider))) hints.push("voice");+ const hints = source ? PROVIDER_SERVICES.filter(service => providerServiceSupport(source, service, connectionTargets, providers).enabled)+ .map(service => ["tts", "stt"].includes(service) ? "voice" : ["imagegen", "videogen"].includes(service) ? "generation" : service) : [];return (<div className="space-y-5"><WorkspaceSplit@@ -220,6 +210,9 @@ export function ProvidersWorkspace() {})}{!savedIds.has(p.id) && ` · ${t("Not saved")}`}</span>+ <span className="mt-2 flex flex-wrap gap-1 pl-6">+ {PROVIDER_SERVICES.filter(service => providerServiceSupport(p, service, connectionTargets, providers).enabled).map(service => <span key={service} className="rounded bg-[var(--muted)] px-1.5 py-0.5 text-[10px] text-[var(--muted-foreground)]">{t(SERVICE_TITLES[service])}</span>)}+ </span></button>);})}@@ -327,33 +320,14 @@ export function ProvidersWorkspace() {</p></div>)}+ {providerServiceSupport(source, "llm", connectionTargets, providers).enabled && <ProviderProtocol value={connection.api_format || "auto"} onChange={value => change("api_format", value)} />}+ <ProviderServices key={source.id} source={source} onChange={value => change("service_overrides", value)} /><details className={`p-3.5 ${subPanelClass}`}><summary className="cursor-pointer select-none rounded text-xs font-medium marker:text-[var(--muted-foreground)]">{t("Advanced connection settings")}</summary><div className="mt-4 grid gap-4 sm:grid-cols-2">{source.provider !== "volcengine_speech" && <>- <label className="block space-y-1.5 text-xs font-medium">- <span className="block">{t("API format")}</span>- <select- className={selectClass}- value={connection.api_format || "auto"}- onChange={(e) =>- change("api_format", e.target.value)- }- >- <option value="auto">{t("Auto")}</option>- <option value="openai_chat">- {t("OpenAI Chat Completions")}- </option>- <option value="openai_responses">- {t("OpenAI Responses")}- </option>- <option value="anthropic">- {t("Anthropic Messages")}- </option>- </select>- </label><RegistryFieldlabel={t("API version")}value={connection.api_version || ""}@@ -382,6 +356,7 @@ export function ProvidersWorkspace() {input={providerProbeInput(source, option?.base_url)}discovery={connection.discovery}hints={hints}+ showCapabilities={false}onResult={(result) => change("discovery", result)}/></>@@ -418,7 +393,10 @@ export function ProvidersWorkspace() {["search", "Search"],["voice", "Voice"],["multimodal", "Multimodal generation"],- ].map(([path, label]) => (+ ].filter(([path]) => PROVIDER_SERVICES.some(service =>+ (path === "voice" ? service === "tts" || service === "stt" : path === "multimodal" ? service === "imagegen" || service === "videogen" : service === path) &&+ providerServiceSupport(source, service, connectionTargets, providers).enabled+ )).map(([path, label]) => (<Linkkey={path}href={`/settings/${path}?provider=${encodeURIComponent(source.id)}`}@@ -447,64 +425,3 @@ export function ProvidersWorkspace() {</div>);}--/**- * The add flow. It lives in the detail pane, opposite the list, because that is- * the one place on the page that means "what you are configuring right now" —- * and only one thing can be there at a time.- */-function AddProviderPanel({- options,- vendor,- onVendor,- onCreate,- onCancel,-}: {- options: { value: string; label: string }[];- vendor: string;- onVendor: (value: string) => void;- onCreate: () => void;- onCancel: () => void;-}) {- const { t } = useTranslation();- return (- <section- aria-label={t("Add provider")}- className={`min-w-0 p-5 ${subPanelClass}`}- >- <h3 className="mb-4 text-base font-semibold">{t("Add provider")}</h3>- <label className="block space-y-1.5 text-xs font-medium sm:max-w-sm">- <span className="block">{t("Provider type")}</span>- <select- aria-label={t("Provider type")}- className={selectClass}- value={vendor}- onChange={(e) => onVendor(e.target.value)}- >- <option value="">{t("Choose a provider")}</option>- {options.map((o) => (- <option key={o.value} value={o.value}>- {o.label}- </option>- ))}- </select>- </label>- <p className="mt-3 text-xs leading-relaxed text-[var(--muted-foreground)]">- {t("Connect once. Reuse the provider across your models.")}- </p>- <div className="mt-5 flex flex-wrap items-center gap-2 border-t border-[color-mix(in_srgb,var(--border)_70%,transparent)] pt-4">- <button- type="button"- disabled={!vendor}- onClick={onCreate}- className={registryPrimary}- >- {t("Continue")}- </button>- <button type="button" onClick={onCancel} className={registryButton}>- {t("Cancel")}- </button>- </div>- </section>- );-}diff --git a/web/components/settings/RegistryControls.tsx b/web/components/settings/RegistryControls.tsxindex 4c9f71e00..5f9fcd740 100644--- a/web/components/settings/RegistryControls.tsx+++ b/web/components/settings/RegistryControls.tsx@@ -116,12 +116,14 @@ export function RegistryProbe({onResult,listing = false,hints = [],+ showCapabilities = true,}: {input: ProviderProbeInput;discovery?: Discovery;onResult: (result: Discovery) => void;listing?: boolean;hints?: string[];+ showCapabilities?: boolean;}) {// Credentials are only an in-memory request signature, never rendered or persisted.return (@@ -132,6 +134,7 @@ export function RegistryProbe({onResult={onResult}listing={listing}hints={hints}+ showCapabilities={showCapabilities}/>);}@@ -141,23 +144,26 @@ function ProbeForm({onResult,listing,hints,+ showCapabilities,}: {input: ProviderProbeInput;discovery?: Discovery;onResult: (result: Discovery) => void;listing: boolean;hints: string[];+ showCapabilities: boolean;}) {const { t } = useTranslation();const [result, setResult] = useState(discovery);const [pending, setPending] = useState(false);const controller = useRef<AbortController | null>(null);- useEffect(() => () => controller.current?.abort(), []);+ useEffect(() => () => { controller.current?.abort(); controller.current = null; }, []);const probe = async () => {controller.current?.abort();const request = new AbortController();controller.current = request;setPending(true);+ const timeout = setTimeout(() => request.abort(), 35000);try {const response = await apiFetch(apiUrl("/api/settings/test-provider"), {method: "POST",@@ -173,10 +179,14 @@ function ProbeForm({setResult(next);onResult(next);} catch {- if (!request.signal.aborted)- setResult({ status: "unreachable", models: [] });+ if (controller.current === request) {+ const failed: Discovery = { status: request.signal.aborted ? "timeout" : "unreachable", models: [], checked_at: new Date().toISOString() };+ setResult(failed);+ onResult(failed);+ }} finally {- if (!request.signal.aborted) setPending(false);+ clearTimeout(timeout);+ if (controller.current === request) setPending(false);}};return (@@ -215,7 +225,8 @@ function ProbeForm({role="status"className={`text-xs leading-relaxed ${result.status === "connected" ? "text-emerald-700 dark:text-emerald-400" : "text-[var(--muted-foreground)]"}`}>- {t(PROBE_MESSAGES[result.status] || PROBE_MESSAGES.http_error)}+ {t(result.status === "connected" && input.service !== "search" ? "settings.providerServices.catalogListed" : PROBE_MESSAGES[result.status] || PROBE_MESSAGES.http_error)}+ {result.warning === "partial_models" && <p className="mt-2">{t("settings.providerServices.partial")}</p>}{result.http_status != null && ` · HTTP ${result.http_status}`}{result.warning === "empty_results" && (<p className="mt-2">@@ -232,7 +243,7 @@ function ProbeForm({` · ${t("{{count}} models available", { count: result.models.length })}`}</div>)}- {!listing && (+ {!listing && showCapabilities && (<><div className="grid grid-cols-2 gap-2 sm:grid-cols-3">{CATEGORIES.map((label, i) => {diff --git a/web/components/settings/ServiceConfigEditor.tsx b/web/components/settings/ServiceConfigEditor.tsxindex 8344bbde7..b16b60f9c 100644--- a/web/components/settings/ServiceConfigEditor.tsx+++ b/web/components/settings/ServiceConfigEditor.tsx@@ -1607,9 +1607,6 @@ function ProfileFields({) {updateModelField(service, "model", match.default_model);}- if (service === "tts" && match?.default_voice) {- updateModelField(service, "voice", match.default_voice);- }}}><option className={selectOptionClass} value="">diff --git a/web/components/settings/ServicePreviewPanel.tsx b/web/components/settings/ServicePreviewPanel.tsxnew file mode 100644index 000000000..8b79380db--- /dev/null+++ b/web/components/settings/ServicePreviewPanel.tsx@@ -0,0 +1,353 @@+'use client'++import { useEffect, useRef, useState } from 'react'+import { FlaskConical, Loader2, Square } from 'lucide-react'+import { useTranslation } from 'react-i18next'+import {+ useSettings,+ type CatalogModel,+ type CatalogProfile,+} from '@/features/settings/store/SettingsStore'+import { apiFetch, apiUrl } from '@/lib/api'+import { modelTestFingerprint } from '@/lib/model-settings'+import { inputClass, subPanelClass } from './shared'+import { registryButton, registryPrimary } from './RegistryControls'++type Service = 'search' | 'stt' | 'imagegen' | 'videogen'+type Result = {+ kind: 'search' | 'transcript' | 'image' | 'video'+ text?: string+ results?: { title: string; url: string; snippet: string }[]+ url?: string+}+type Props = { service: Service; profile: CatalogProfile; model?: CatalogModel | null }+const audioTypes: Record<string, string> = {+ wav: 'audio/wav',+ mp3: 'audio/mpeg',+ m4a: 'audio/mp4',+ webm: 'audio/webm',+ ogg: 'audio/ogg',+ flac: 'audio/flac',+}+function safeLink(value: string) {+ try {+ const u = new URL(value)+ return ['https:', 'http:'].includes(u.protocol) ? u.href : undefined+ } catch {+ return undefined+ }+}++/** Replacing the edited connection/model aborts its request and releases media. */+export function ServicePreviewPanel(props: Props) {+ const { draft } = useSettings()+ return (+ <Preview+ key={modelTestFingerprint(draft, props.service, props.profile.id, props.model?.id)}+ {...props}+ />+ )+}++function Preview({ service, profile, model }: Props) {+ const { t } = useTranslation()+ const { draft } = useSettings()+ const [text, setText] = useState('')+ const [file, setFile] = useState<File | null>(null)+ const [audioUrl, setAudioUrl] = useState('')+ const [result, setResult] = useState<Result | null>(null)+ const [state, setState] = useState('idle')+ const [phase, setPhase] = useState('requesting')+ const request = useRef<AbortController | null>(null)+ const mediaUrl = useRef('')+ const running = state === 'running'+ useEffect(+ () => () => {+ request.current?.abort()+ if (mediaUrl.current) URL.revokeObjectURL(mediaUrl.current)+ },+ []+ )+ useEffect(() => {+ if (!file) {+ setAudioUrl('')+ return+ }+ const url = URL.createObjectURL(file)+ setAudioUrl(url)+ return () => URL.revokeObjectURL(url)+ }, [file])+ function clearResult() {+ setResult(null)+ setState('idle')+ if (mediaUrl.current) URL.revokeObjectURL(mediaUrl.current)+ mediaUrl.current = ''+ }+ async function run() {+ clearResult()+ const controller = new AbortController()+ request.current = controller+ setState('running')+ setPhase('requesting')+ const timeout = setTimeout(+ () => {+ controller.abort()+ setState('timeout')+ },+ service === 'videogen' ? 610000 : 130000+ )+ try {+ let audio = ''+ let contentType = ''+ if (service === 'stt' && file) {+ contentType = audioTypes[file.name.split('.').pop()?.toLowerCase() || ''] || file.type+ audio = await new Promise<string>((resolve, reject) => {+ const reader = new FileReader()+ reader.onload = () => resolve(String(reader.result).split(',')[1])+ reader.onerror = () => reject(new Error('audio'))+ reader.readAsDataURL(file)+ })+ }+ if (controller.signal.aborted) return+ const response = await apiFetch(apiUrl(`/api/settings/services/${service}/preview`), {+ method: 'POST',+ headers: { 'Content-Type': 'application/json' },+ signal: controller.signal,+ body: JSON.stringify({+ catalog: draft,+ profile_id: profile.id,+ model_id: model?.id,+ text: text.trim(),+ audio,+ content_type: contentType,+ }),+ })+ if (!response.ok || !response.body) throw new Error('request')+ const reader = response.body.getReader()+ const decoder = new TextDecoder()+ let buffer = ''+ let completed = false+ try {+ while (!completed) {+ const chunk = await reader.read()+ buffer += decoder.decode(chunk.value, { stream: !chunk.done })+ if (buffer.length > 60 * 1024 * 1024) throw new Error('size')+ let newline: number+ while ((newline = buffer.indexOf('\n')) !== -1) {+ const line = buffer.slice(0, newline)+ buffer = buffer.slice(newline + 1)+ if (!line.trim()) continue+ const event = JSON.parse(line)+ if (controller.signal.aborted) return+ if (event.type === 'progress')+ setPhase(event.phase === 'rendering' ? 'rendering' : 'requesting')+ if (event.type === 'error') {+ setState(event.code === 'timeout' ? 'timeout' : 'failed')+ completed = true+ }+ if (event.type === 'result') {+ const next: Result = { kind: event.kind, text: event.text, results: event.results }+ if (event.kind === 'image' || event.kind === 'video') {+ const raw = atob(event.data)+ const bytes = Uint8Array.from(raw, char => char.charCodeAt(0))+ mediaUrl.current = URL.createObjectURL(+ new Blob([bytes], { type: event.content_type })+ )+ next.url = mediaUrl.current+ }+ setResult(next)+ setState('success')+ completed = true+ }+ }+ if (chunk.done) {+ if (!completed) throw new Error('incomplete')+ break+ }+ }+ } finally {+ await reader.cancel().catch(() => {})+ reader.releaseLock()+ }+ } catch {+ if (!controller.signal.aborted) setState('failed')+ } finally {+ clearTimeout(timeout)+ if (request.current === controller) request.current = null+ }+ }+ const empty =+ result &&+ (result.kind === 'search'+ ? !result.text && !result.results?.length+ : result.kind === 'transcript' && !result.text?.trim())+ const message =+ state === 'success' ? (empty ? 'empty' : 'success') : state === 'running' ? phase : state+ return (+ <section+ aria-label={t(`settings.servicePreview.title.${service}`)}+ className={`space-y-4 p-4 ${subPanelClass}`}+ >+ <div>+ <h4 className="text-sm font-medium">{t(`settings.servicePreview.title.${service}`)}</h4>+ <p className="mt-1 text-xs leading-relaxed text-[var(--muted-foreground)]">+ {t(`settings.servicePreview.description.${service}`)}+ </p>+ </div>+ {service === 'stt' ? (+ <div className="space-y-3">+ <label className="block space-y-2 text-xs font-medium">+ <span>{t('settings.servicePreview.audio')}</span>+ <input+ type="file"+ accept=".wav,.mp3,.m4a,.webm,.ogg,.flac,audio/*"+ disabled={running}+ className={`${inputClass} file:mr-3 file:rounded-md file:border-0 file:px-3 file:py-1.5 file:text-xs`}+ onChange={e => {+ clearResult()+ const next = e.target.files?.[0] || null+ if (+ next &&+ (!next.size ||+ next.size > 8 * 1024 * 1024 ||+ !audioTypes[next.name.split('.').pop()?.toLowerCase() || ''])+ ) {+ setFile(null)+ setState('invalidAudio')+ e.target.value = ''+ return+ }+ setFile(next)+ }}+ />+ </label>+ {audioUrl && (+ <audio+ controls+ src={audioUrl}+ className="h-10 w-full"+ aria-label={t('settings.servicePreview.audio')}+ />+ )}+ </div>+ ) : (+ <label className="block space-y-2 text-xs font-medium">+ <span>+ {t(+ service === 'search'+ ? 'settings.servicePreview.query'+ : 'settings.servicePreview.prompt'+ )}+ </span>+ <textarea+ className={inputClass}+ rows={2}+ maxLength={2000}+ value={text}+ disabled={running}+ placeholder={t(`settings.servicePreview.placeholder.${service}`)}+ onChange={e => {+ clearResult()+ setText(e.target.value)+ }}+ />+ </label>+ )}+ <div className="flex flex-wrap items-center gap-3">+ <button+ type="button"+ className={registryPrimary}+ disabled={+ running ||+ (service === 'stt' ? !file : !text.trim()) ||+ (service !== 'search' && !model?.model.trim())+ }+ onClick={() => void run()}+ >+ {running ? <Loader2 size={14} className="animate-spin" /> : <FlaskConical size={14} />}+ {t(`settings.servicePreview.action.${service}`)}+ </button>+ {running && (+ <button+ type="button"+ className={registryButton}+ onClick={() => {+ request.current?.abort()+ setState('cancelled')+ }}+ >+ <Square size={12} />+ {t('Cancel')}+ </button>+ )}+ </div>+ {state !== 'idle' && (+ <p+ role="status"+ aria-live="polite"+ className={`text-xs leading-relaxed ${['failed', 'timeout', 'invalidAudio'].includes(state) ? 'text-red-600 dark:text-red-400' : 'text-[var(--muted-foreground)]'}`}+ >+ {t(`settings.servicePreview.status.${message}`)}+ </p>+ )}+ {(running || state === 'cancelled' || state === 'timeout') && service === 'videogen' && (+ <p className="text-xs text-[var(--muted-foreground)]">+ {t('settings.servicePreview.remoteTask')}+ </p>+ )}+ {result && !empty && (+ <div className="space-y-3 rounded-lg bg-[var(--background)] p-3">+ {result.text && (+ <p className="whitespace-pre-wrap break-words text-sm leading-relaxed">{result.text}</p>+ )}+ {result.results?.map((row, index) => (+ <div key={index} className="space-y-1 text-xs">+ {safeLink(row.url) ? (+ <a+ href={safeLink(row.url)}+ target="_blank"+ rel="noopener noreferrer"+ className="break-words font-medium underline underline-offset-4"+ >+ {row.title || row.url}+ </a>+ ) : (+ <p className="font-medium">{row.title}</p>+ )}+ <p className="break-words leading-relaxed text-[var(--muted-foreground)]">+ {row.snippet}+ </p>+ </div>+ ))}+ {/* Provider-generated images are temporary blob URLs, never optimized. */}+ {result.kind === 'image' && result.url && (+ // eslint-disable-next-line @next/next/no-img-element+ <img+ src={result.url}+ alt={text}+ className="max-h-96 w-full rounded-lg object-contain"+ />+ )}+ {result.kind === 'video' && result.url && (+ <video+ controls+ preload="metadata"+ src={result.url}+ aria-label={text}+ className="max-h-96 w-full rounded-lg"+ />+ )}+ {result.url && (+ <a+ href={result.url}+ download={result.kind === 'image' ? 'deeptutor-preview' : 'deeptutor-preview-video'}+ className="inline-block text-xs underline underline-offset-4"+ >+ {t('Download')}+ </a>+ )}+ </div>+ )}+ </section>+ )+}diff --git a/web/components/settings/SettingsMain.tsx b/web/components/settings/SettingsMain.tsxindex 8b213e468..a2db14e70 100644--- a/web/components/settings/SettingsMain.tsx+++ b/web/components/settings/SettingsMain.tsx@@ -1,5 +1,6 @@'use client'+import { PageContainer } from '@/components/layout/FeaturePage'import { useEffect, useRef, useState } from 'react'import { browserStorage } from '@/shared/storage'import { usePathname, useRouter } from 'next/navigation'@@ -9,7 +10,6 @@ import SettingsNav from './SettingsNav'import { SettingsToolbar } from './SettingsToolbar'import { SettingsLoadStatusBanner } from './SettingsLoadStatusBanner'import { SETTINGS_RETURN_KEY } from './SettingsReturnTracker'-import { isWideSettingsPage } from '@/features/settings/navigation/settings-pages'import Modal from '@/components/common/Modal'import { useSettings } from '@/features/settings/store/SettingsStore'@@ -62,15 +62,8 @@ export default function SettingsMain({ children }: { children: React.ReactNode }<div className="px-2.5 pb-1.5 pt-4">{returnButton}</div><SettingsNav /></aside>- {/* Master–detail pages publish a wider content box; the save toolbar- below reads the same variable so the two stay aligned. */}<mainclassName="flex min-w-0 flex-1 flex-col overflow-hidden"- style={- {- '--settings-content': isWideSettingsPage(section) ? '1280px' : '960px',- } as React.CSSProperties- }><div className="flex h-14 shrink-0 items-center justify-between border-b border-border/50 px-3 md:hidden">{returnButton}@@ -89,14 +82,14 @@ export default function SettingsMain({ children }: { children: React.ReactNode }data-settings-scrollclassName="min-h-0 flex-1 overflow-y-auto overflow-x-hidden [scrollbar-gutter:stable]">- <div+ <PageContainerref={content}tabIndex={-1}- className="mx-auto w-full max-w-[var(--settings-content,960px)] px-5 pb-20 pt-8 outline-none sm:px-10 md:pt-12 lg:px-14"+ className="pb-20 outline-none"><SettingsLoadStatusBanner />{children}- </div>+ </PageContainer></div><SettingsToolbar /></main>diff --git a/web/components/settings/SettingsOverview.tsx b/web/components/settings/SettingsOverview.tsxindex 05f6c3540..22d13ab08 100644--- a/web/components/settings/SettingsOverview.tsx+++ b/web/components/settings/SettingsOverview.tsx@@ -4,7 +4,7 @@ import Link from "next/link";import { ArrowRight } from "lucide-react";import { useTranslation } from "react-i18next";import { APP_LANGUAGES, isAppLanguage, type AppLanguage } from "@/i18n/init";-import SettingsPresetsPanel from "@/components/settings/SettingsPresetsPanel";+import AgentSetupHelp from "@/components/settings/AgentSetupHelp";import {SettingRow,SettingSection,@@ -96,11 +96,11 @@ export default function SettingsOverview() {}/></SettingSection>- {catalogEditable === true && <SettingsPresetsPanel enabled={true} />}{catalogEditable && <SettingSectiontitle={t("Set up chat first")}description={t("Connect a provider and choose a language model. Other services are optional.")}>+ <AgentSetupHelp />{[{href: "/settings/connections",diff --git a/web/components/settings/SettingsToolbar.tsx b/web/components/settings/SettingsToolbar.tsxindex 8b1a0d94e..10bc52e97 100644--- a/web/components/settings/SettingsToolbar.tsx+++ b/web/components/settings/SettingsToolbar.tsx@@ -1,6 +1,7 @@"use client";import Tooltip from "@/shared/ui/Tooltip";+import { PageContainer } from "@/components/layout/FeaturePage";import { Loader2, Save, Undo2, Check } from "lucide-react";import { useTranslation } from "react-i18next";import { useSettings } from "@/features/settings/store/SettingsStore";@@ -30,9 +31,9 @@ export function SettingsToolbar() {return (<divdata-tour="tour-actions"- className="shrink-0 border-t border-[var(--border)] bg-[var(--background)] px-5 py-3 sm:px-8"+ className="shrink-0 border-t border-[var(--border)] bg-[var(--background)]">- <div className="mx-auto flex max-w-[calc(var(--settings-content,960px)_-_7rem)] flex-wrap items-center justify-between gap-3">+ <PageContainer spacing="toolbar" className="flex flex-wrap items-center justify-between gap-3"><div className="min-w-0" role="status"><p className="text-[13px] font-medium">{draftState === "saved"@@ -82,7 +83,7 @@ export function SettingsToolbar() {{t("Apply changes")}</button></div>- </div>+ </PageContainer></div>);}diff --git a/web/components/settings/VoiceDiscoveryField.tsx b/web/components/settings/VoiceDiscoveryField.tsxnew file mode 100644index 000000000..65db06f58--- /dev/null+++ b/web/components/settings/VoiceDiscoveryField.tsx@@ -0,0 +1,215 @@+'use client'++import { useEffect, useRef, useState } from 'react'+import { Loader2, RefreshCw } from 'lucide-react'+import { useTranslation } from 'react-i18next'+import { useSettings } from '@/features/settings/store/SettingsStore'+import { apiFetch, apiUrl } from '@/lib/api'+import { modelTestFingerprint } from '@/lib/model-settings'+import type { VoiceChoice } from '@/lib/model-catalog-types'+import { inputClass, selectClass } from './shared'+import { registryButton } from './RegistryControls'++type Result = {+ status: 'ready' | 'unsupported'+ scope: 'account' | 'custom' | 'none'+ voices: VoiceChoice[]+}++export function VoiceDiscoveryField({+ profileId,+ modelId,+ value,+ update,+ disabled,+}: {+ profileId: string+ modelId: string+ value: string+ update: (value: string) => void+ disabled: boolean+}) {+ const { draft } = useSettings()+ // Changing a voice must not itself start another account lookup.+ const snapshot = structuredClone(draft)+ const model = snapshot.services.tts.profiles+ .find(p => p.id === profileId)+ ?.models.find(m => m.id === modelId)+ if (model) {+ const identity = {+ id: model.id,+ name: model.name,+ model: model.model,+ provider_ref: model.provider_ref,+ }+ Object.keys(model).forEach(key => {+ delete (model as unknown as Record<string, unknown>)[key]+ })+ Object.assign(model, identity)+ }+ const fingerprint = modelTestFingerprint(snapshot, 'tts', profileId, modelId)+ return (+ <VoiceLookup+ key={fingerprint}+ profileId={profileId}+ modelId={modelId}+ value={value}+ update={update}+ disabled={disabled}+ />+ )+}++function VoiceLookup({+ profileId,+ modelId,+ value,+ update,+ disabled,+}: {+ profileId: string+ modelId: string+ value: string+ update: (value: string) => void+ disabled: boolean+}) {+ const { t } = useTranslation()+ const { draft } = useSettings()+ const catalog = useRef(draft)+ const hasModel = Boolean(+ draft.services.tts.profiles+ .find(p => p.id === profileId)+ ?.models.find(m => m.id === modelId)+ ?.model.trim()+ )+ const [attempt, setAttempt] = useState(0)+ const [result, setResult] = useState<Result | null>(null)+ const [loading, setLoading] = useState(true)+ const [error, setError] = useState(false)+ const [manual, setManual] = useState(false)+ useEffect(() => {+ if (!hasModel) {+ setLoading(false)+ return+ }+ const controller = new AbortController()+ let active = true+ const timeout = setTimeout(() => controller.abort(), 30000)+ setLoading(true)+ setError(false)+ setResult(null)+ const debounce = setTimeout(() => {+ void (async () => {+ try {+ const response = await apiFetch(apiUrl('/api/settings/voice/voices'), {+ method: 'POST',+ headers: { 'Content-Type': 'application/json' },+ signal: controller.signal,+ body: JSON.stringify({+ catalog: catalog.current,+ profile_id: profileId,+ model_id: modelId,+ }),+ })+ if (!response.ok) throw new Error('Voice lookup failed')+ const data = (await response.json()) as Result+ if (!['ready', 'unsupported'].includes(data.status) || !Array.isArray(data.voices))+ throw new Error('Invalid voice response')+ if (active) setResult(data)+ } catch {+ if (active) setError(true)+ } finally {+ clearTimeout(timeout)+ if (active) setLoading(false)+ }+ })()+ }, 250)+ return () => {+ clearTimeout(debounce)+ active = false+ controller.abort()+ clearTimeout(timeout)+ }+ }, [profileId, modelId, attempt, hasModel])+ const listed = result?.voices.some(v => v.id === value)+ return (+ <section+ className="space-y-3 rounded-xl border border-[var(--border)] p-4"+ aria-label={t('Voice')}+ >+ <div className="flex flex-wrap items-center justify-between gap-2">+ <h4 className="text-sm font-medium">{t('Voice')}</h4>+ <button+ type="button"+ disabled={loading || !hasModel}+ onClick={() => setAttempt(a => a + 1)}+ className={registryButton}+ >+ {loading ? <Loader2 size={14} className="animate-spin" /> : <RefreshCw size={14} />}+ {t(loading ? 'settings.voiceDiscovery.loading' : 'Refresh')}+ </button>+ </div>+ <p role="status" className="text-xs leading-relaxed text-[var(--muted-foreground)]">+ {t(+ !hasModel+ ? 'settings.voiceDiscovery.modelFirst'+ : loading+ ? 'settings.voiceDiscovery.loading'+ : error+ ? 'settings.voiceDiscovery.failed'+ : result?.status === 'unsupported'+ ? 'settings.voiceDiscovery.unsupported'+ : !result?.voices.length+ ? 'settings.voiceDiscovery.empty'+ : result.scope === 'custom'+ ? 'settings.voiceDiscovery.custom'+ : 'settings.voiceDiscovery.account'+ )}+ </p>+ {Boolean(result?.voices.length) && (+ <label className="block space-y-1.5 text-xs font-medium">+ <span>{t('settings.voiceDiscovery.choose')}</span>+ <select+ className={selectClass}+ disabled={disabled}+ value={listed ? value : ''}+ onChange={e => {+ if (e.target.value) update(e.target.value)+ }}+ >+ <option value="">{t('settings.voiceDiscovery.choose')}</option>+ {result?.voices.map(voice => (+ <option key={voice.id} value={voice.id}>+ {voice.label}+ </option>+ ))}+ </select>+ </label>+ )}+ {value && !listed && (+ <p className="break-all text-xs text-[var(--muted-foreground)]">+ {t('settings.voiceDiscovery.current')}: {value}+ </p>+ )}+ <button+ type="button"+ className="text-xs underline underline-offset-4"+ aria-expanded={manual}+ onClick={() => setManual(v => !v)}+ >+ {t('settings.voiceDiscovery.manual')}+ </button>+ {manual && (+ <label className="block space-y-1.5 text-xs font-medium">+ <span>{t('Voice ID')}</span>+ <input+ className={inputClass}+ value={value}+ disabled={disabled}+ onChange={e => update(e.target.value)}+ />+ </label>+ )}+ </section>+ )+}diff --git a/web/components/settings/VoiceModelFields.tsx b/web/components/settings/VoiceModelFields.tsxindex 1fa6c3e5a..109c81771 100644--- a/web/components/settings/VoiceModelFields.tsx+++ b/web/components/settings/VoiceModelFields.tsx@@ -3,9 +3,13 @@import { useId } from 'react'import { useTranslation } from 'react-i18next'import type { CatalogModel, VoiceModelOption, VoiceOptions } from '@/lib/model-catalog-types'-import { DEFAULT_SPEECH_REQUEST_TIMEOUT, MIN_SPEECH_REQUEST_TIMEOUT, MAX_SPEECH_REQUEST_TIMEOUT } from '@/lib/voice-settings'+import {+ DEFAULT_SPEECH_REQUEST_TIMEOUT,+ MIN_SPEECH_REQUEST_TIMEOUT,+ MAX_SPEECH_REQUEST_TIMEOUT,+} from '@/lib/voice-settings'import { RegistryField, RegistryModelIdField } from './RegistryControls'-import { inputClass, selectClass } from './shared'+import { inputClass } from './shared'export function VoiceModelFields({service,@@ -28,9 +32,7 @@ export function VoiceModelFields({const speedId = useId()const instructionId = useId()const timeoutId = useId()- const voice = preset?.voices.find(v => v.id === model.voice)- const languages =- preset?.languages.filter(l => !voice?.languages || voice.languages.includes(l.id)) ?? []+ const languages = preset?.languages ?? []const docsUrl = preset?.docs_url ?? options?.docs_urlreturn (<section aria-label={t('Speech options')} className="space-y-4">@@ -53,46 +55,14 @@ export function VoiceModelFields({onChange={e => update('request_timeout', e.target.value)}/><p className="text-xs text-[var(--muted-foreground)]">- {t('5–600 seconds. Leave blank for 60 seconds. Applies to voice previews and speech playback.')}+ {t(+ '5–600 seconds. Leave blank for 60 seconds. Applies to voice previews and speech playback.'+ )}</p></div>)}{service === 'tts' && (<>- <label className="space-y-1.5 text-xs font-medium">- <span className="block">{t('Suggested voice')}</span>- <select- className={selectClass}- disabled={disabled}- value={voice?.id ?? ''}- onChange={e => {- const selected = preset?.voices.find(v => v.id === e.target.value)- if (!selected) return- update('voice', selected.id)- if (- model.language &&- selected.languages &&- !selected.languages.includes(model.language)- )- update('language', '')- }}- >- <option value="">{t('Custom voice ID')}</option>- {preset?.voices.map(v => (- <option key={v.id} value={v.id}>- {v.label}- </option>- ))}- </select>- </label>- <RegistryModelIdField- label={t('Voice ID')}- value={model.voice ?? ''}- options={preset?.voices.map(v => v.id) ?? []}- disabled={disabled}- onChange={v => update('voice', v)}- placeholder={t('Enter a preset or private voice ID')}- /><RegistryModelIdFieldlabel={t('Response format')}value={model.response_format ?? ''}@@ -171,11 +141,6 @@ export function VoiceModelFields({/></div>)}- {voice?.languages && (- <p className="text-xs text-[var(--muted-foreground)]">- {t('Voice languages')}: {voice.languages.join(', ')}- </p>- )}{!preset?.languages.length && service === 'tts' && (<p className="text-xs text-[var(--muted-foreground)]">{t(preset?.language_note ?? 'Language follows the text and selected voice.')}@@ -188,7 +153,9 @@ export function VoiceModelFields({)}{service === 'tts' && (<p className="text-xs leading-relaxed text-[var(--muted-foreground)]">- {t('Fetching the model list does not test speech synthesis. Use Preview voice to test this model and voice.')}+ {t(+ 'Fetching the model list does not test speech synthesis. Use Preview voice to test this model and voice.'+ )}</p>)}{service === 'tts' && provider === 'volcengine_speech' && (diff --git a/web/components/settings/shared.tsx b/web/components/settings/shared.tsxindex 0292c17dc..88c21721c 100644--- a/web/components/settings/shared.tsx+++ b/web/components/settings/shared.tsx@@ -1,5 +1,6 @@"use client";+import { PageHeader } from '@/components/layout/FeaturePage'import type {CatalogProfile,ServiceName,@@ -215,23 +216,6 @@ export function SettingsPageHeader({actions?: React.ReactNode;}) {return (- <header className="mb-7 flex flex-wrap items-start justify-between gap-x-6 gap-y-3">- <div className="min-w-0">- <h1- data-tour="tour-page-heading"- className="text-[26px] font-semibold tracking-tight text-[var(--foreground)]"- >- {title}- </h1>- {description && (- <p className="mt-1.5 max-w-[62ch] text-[13px] leading-relaxed text-[var(--muted-foreground)]">- {description}- </p>- )}- </div>- {actions && (- <div className="flex shrink-0 items-center gap-2">{actions}</div>- )}- </header>+ <PageHeader title={title} description={description} action={actions} headingTour="tour-page-heading" />);}diff --git a/web/components/sidebar/SessionAvatar.tsx b/web/components/sidebar/SessionAvatar.tsxindex 387f8a89c..cbdf71e28 100644--- a/web/components/sidebar/SessionAvatar.tsx+++ b/web/components/sidebar/SessionAvatar.tsx@@ -1,5 +1,8 @@"use client";+import { useTaskBoard } from "@/lib/task-board-store";+import { sessionTaskColor } from "@/lib/task-board-api";+import { activeWorkspaceId } from "@/lib/workspace-scope";import { ActivityOrb } from "@/components/activity";/**@@ -40,12 +43,14 @@ function SettledMark({size,mark,kind,+ taskColor,}: {+ taskColor?: string;size: number;mark: SessionMark;kind: SessionKind;}) {- const filled = mark === "unread" || mark === "failed";+ const filled = Boolean(taskColor) || mark === "unread" || mark === "failed";const shape = `transition-[fill] duration-300 ease-out ${filled ? "fill-current" : "fill-transparent"}`;@@ -59,6 +64,7 @@ function SettledMark({viewBox="0 0 12 12"width={size}height={size}+ style={taskColor ? { color: taskColor, opacity: 1 } : undefined}className={`transition-[color,opacity] duration-300 ease-out ${mark === "failed"? "text-amber-500 opacity-100 dark:text-amber-400"@@ -67,7 +73,7 @@ function SettledMark({: "text-[var(--muted-foreground)] opacity-45 group-hover/session:opacity-75"}`}>- {kind === "reading" ? (+ {kind === "reading" && !taskColor ? (// A page: the ring stood on end with its corners let out. Same box,// stroke and ink, so it reads as the same mark in another key.<rect@@ -155,6 +161,7 @@ export function sessionKindOf(session: {interface SessionAvatarProps {sessionId: string;+ workspaceId?: string;mark?: SessionMark;kind?: SessionKind;size?: number;@@ -177,12 +184,17 @@ interface SessionAvatarProps {* and the mark column says only what state the session is in.*/export function SessionAvatar({- sessionId: _sessionId,+ sessionId,+ workspaceId = activeWorkspaceId(),mark = "idle",kind = "chat",size = 12,className = "",}: SessionAvatarProps) {+ const { board } = useTaskBoard();+ const taskColor = mark !== "running"+ ? sessionTaskColor(board, sessionId, workspaceId)+ : undefined;const ring = Math.round(size * RING_RATIO);const running = mark === "running";@@ -209,7 +221,7 @@ export function SessionAvatar({running ? "scale-[1.55] opacity-0" : "scale-100 opacity-100"}`}>- <SettledMark size={ring} mark={mark} kind={kind} />+ <SettledMark size={ring} mark={mark} kind={kind} taskColor={taskColor} /></span></span>);diff --git a/web/components/space/ChatHistorySection.tsx b/web/components/space/ChatHistorySection.tsxindex 9b97da9b4..7e07518fb 100644--- a/web/components/space/ChatHistorySection.tsx+++ b/web/components/space/ChatHistorySection.tsx@@ -1,5 +1,6 @@"use client";+import { pageGridClass } from '@/components/layout/FeaturePage'import { navigateTask } from "@/lib/workspace-scope";import { sessionWorkspaceId } from "@/lib/session-api";import { useCallback, useEffect, useMemo, useRef, useState } from "react";@@ -285,7 +286,6 @@ export default function ChatHistorySection({return (<div className="space-y-6"><SpaceSectionHeader- icon={HeaderIcon}title={headerTitle}description={headerDescription}meta={@@ -325,7 +325,7 @@ export default function ChatHistorySection({{/* Course filter temporarily hidden pending further product work;courseFilter stays at its "all" default so filteredSessions isunaffected. */}- <div className="mt-2 grid gap-2 sm:grid-cols-2">+ <div className={`mt-2 ${pageGridClass(2)}`}><label className="sr-only" htmlFor="history-kind-filter">{t("Filter by conversation type")}</label>diff --git a/web/components/space/McpStoreSection.tsx b/web/components/space/McpStoreSection.tsxindex 83b4af270..43b4c5938 100644--- a/web/components/space/McpStoreSection.tsx+++ b/web/components/space/McpStoreSection.tsx@@ -38,7 +38,6 @@ export default function McpStoreSection() {return (<div className="space-y-6"><SpaceSectionHeader- icon={Plug}title={t("MCP Services")}description={t("Connect hosted MCP services to your account — their tools become available to the chat agent.",diff --git a/web/components/space/MyAgentsSection.tsx b/web/components/space/MyAgentsSection.tsxindex e36082246..c5ba8f9f4 100644--- a/web/components/space/MyAgentsSection.tsx+++ b/web/components/space/MyAgentsSection.tsx@@ -1,5 +1,6 @@"use client";+import { pageActionClass, pageGridClass } from '@/components/layout/FeaturePage'import Tooltip from "@/shared/ui/Tooltip";import { useCallback, useEffect, useMemo, useRef, useState } from "react";import { useRouter } from "next/navigation";@@ -272,7 +273,7 @@ export default function MyAgentsSection() {return (<div className="space-y-6"><SpaceSectionHeader- icon={Bot}+ level={2}title={t("Imported conversations")}description={t("Import ChatGPT exports or connect Claude Code and Codex folders. Open any imported conversation to keep chatting.",@@ -282,7 +283,7 @@ export default function MyAgentsSection() {<buttontype="button"onClick={() => setWizardOpen(true)}- className="inline-flex items-center gap-1.5 rounded-lg bg-[var(--foreground)] px-3 py-1.5 text-[12px] font-medium text-[var(--background)] shadow-sm transition-opacity hover:opacity-90"+ className={pageActionClass()}><Plus className="h-3.5 w-3.5" />{t("Import conversations")}@@ -295,7 +296,7 @@ export default function MyAgentsSection() {<EmptyState onAdd={() => setWizardOpen(true)} />) : (<>- <div className="grid gap-3 sm:grid-cols-2">+ <div className={pageGridClass(2)}>{cards.map((card) =>card.kind === "agent" ? (<AgentCarddiff --git a/web/components/space/PersonasSection.tsx b/web/components/space/PersonasSection.tsxindex 83f402b8d..bc28d0e3e 100644--- a/web/components/space/PersonasSection.tsx+++ b/web/components/space/PersonasSection.tsx@@ -1,5 +1,6 @@"use client";+import { pageGridClass } from '@/components/layout/FeaturePage'import Tooltip from "@/shared/ui/Tooltip";import { useCallback, useEffect, useState } from "react";import dynamic from "next/dynamic";@@ -241,7 +242,6 @@ export default function PersonasSection() {return (<div className="space-y-6"><SpaceSectionHeader- icon={UserRound}title={t("Personas")}description={t("Behavior presets that shape the assistant's tone and style. Apply one per chat turn from the composer.",@@ -294,7 +294,7 @@ export default function PersonasSection() {</button></div>) : (- <ul className="grid gap-3 md:grid-cols-2">+ <ul className={pageGridClass(2)}>{personas.map((persona) => {const readOnly = Boolean(persona.read_only);return (diff --git a/web/components/space/SkillsSection.tsx b/web/components/space/SkillsSection.tsxindex d5cd244c7..0dd61f346 100644--- a/web/components/space/SkillsSection.tsx+++ b/web/components/space/SkillsSection.tsx@@ -1,5 +1,6 @@"use client";+import { pageGridClass } from '@/components/layout/FeaturePage'import Tooltip from "@/shared/ui/Tooltip";import { resourceUsage } from "@/lib/workspaces-api";import { useCallback, useEffect, useMemo, useState } from "react";@@ -399,7 +400,6 @@ export default function SkillsSection() {return (<div className="space-y-6"><SpaceSectionHeader- icon={Wand2}title={t("Skills")}description={t("Capability playbooks the model reads on demand. Built-in and preset skills are read-only.",@@ -614,7 +614,7 @@ export default function SkillsSection() {{t("No skills match this filter.")}</div>) : (- <ul className="grid gap-3 md:grid-cols-2">+ <ul className={pageGridClass(2)}>{filteredSkills.map((skill) => {const readOnly = Boolean(skill.read_only);const sourceBadge =diff --git a/web/components/space/SpaceDashboard.tsx b/web/components/space/SpaceDashboard.tsxindex 31a7e7e73..90dd2d743 100644--- a/web/components/space/SpaceDashboard.tsx+++ b/web/components/space/SpaceDashboard.tsx@@ -1,5 +1,6 @@"use client";+import { PageHeader, PAGE_SECTION_TITLE_CLASS, pageGridClass } from '@/components/layout/FeaturePage'import { useCallback, useEffect, useMemo, useState } from "react";import Link from "next/link";import { useTranslation } from "react-i18next";@@ -304,25 +305,21 @@ export default function SpaceDashboard() {return (<div>- <header className="mb-8">- <h1 className="font-serif text-[24px] font-semibold leading-tight tracking-tight text-[var(--foreground)]">- {tr({ zh: "学习空间", en: "Learning Space" })}- </h1>- <p className="mt-1.5 max-w-xl text-[13px] leading-relaxed text-[var(--muted-foreground)]">- {tr({+ <PageHeader+ title={tr({ zh: "学习空间", en: "Learning Space" })}+ description={tr({zh: "你的对话、智能体、笔记与题目,集中在一处 —— 从这里进入。",en: "Your conversations, agents, notebooks, and questions in one place — enter from here.",})}- </p>- </header>+ /><div className="space-y-9">{groups.map(group => (<section key={group.label.en}>- <h2 className="mb-3 px-0.5 font-serif text-[16px] font-semibold tracking-tight text-[var(--foreground)]">+ <h2 className={`mb-3 ${PAGE_SECTION_TITLE_CLASS}`}>{tr(group.label)}</h2>- <div className="grid gap-3 sm:grid-cols-2">+ <div className={pageGridClass(2)}>{group.items.map(item => (<DashboardCardkey={item.key}diff --git a/web/components/space/SpaceMain.tsx b/web/components/space/SpaceMain.tsxindex 15c74dce3..0b26ddbdd 100644--- a/web/components/space/SpaceMain.tsx+++ b/web/components/space/SpaceMain.tsx@@ -5,6 +5,7 @@ import { SkillLibraryScope } from "./SkillLibraryScope";import { usePathname } from "next/navigation";import { ArrowLeft } from "lucide-react";import { useTranslation } from "react-i18next";+import { FeaturePage } from "@/components/layout/FeaturePage";// Hub-and-spoke: the dashboard at `/space` is the only navigator. Once inside a// section we don't re-list every sibling on a rail — a single "back to the hub"@@ -33,22 +34,20 @@ export default function SpaceMain({const isDashboard = pathname === "/space";return (- <div className="h-full overflow-y-auto bg-[var(--background)] [scrollbar-gutter:stable]">- <div className="mx-auto max-w-5xl px-8 py-8 pb-12">- {!isDashboard && (- <div className="mb-5">- <BackToHub />- </div>- )}- {['/space/skills', '/space/mcp'].includes(pathname) && (- <div className="mb-5 rounded-lg border border-[var(--border)] p-3 text-sm text-[var(--muted-foreground)]">- <ResourceLibraryNote />- </div>- )}- {pathname === "/space/skills" && <SkillLibraryScope />}- {children}- </div>- </div>+ <FeaturePage>+ {!isDashboard && (+ <div className="mb-5">+ <BackToHub />+ </div>+ )}+ {['/space/skills', '/space/mcp'].includes(pathname) && (+ <div className="mb-5 rounded-lg border border-[var(--border)] p-3 text-sm text-[var(--muted-foreground)]">+ <ResourceLibraryNote />+ </div>+ )}+ {pathname === "/space/skills" && <SkillLibraryScope />}+ {children}+ </FeaturePage>);}diff --git a/web/components/space/SpaceSectionHeader.tsx b/web/components/space/SpaceSectionHeader.tsxindex bee3ed1f1..cad648e59 100644--- a/web/components/space/SpaceSectionHeader.tsx+++ b/web/components/space/SpaceSectionHeader.tsx@@ -1,47 +1,24 @@"use client";import { type ReactNode } from "react";-import { type LucideIcon } from "lucide-react";+import { PageHeader } from "@/components/layout/FeaturePage";interface SpaceSectionHeaderProps {- icon: LucideIcon;title: string;description: string;action?: ReactNode;meta?: ReactNode;+ level?: 1 | 2;}export default function SpaceSectionHeader({- icon: Icon,title,description,action,meta,+ level,}: SpaceSectionHeaderProps) {return (- <header className="mb-6 flex flex-col gap-4 border-b border-[var(--border)]/60 pb-5 md:flex-row md:items-end md:justify-between">- <div className="flex items-start gap-3.5">- <span- aria-hidden- className="mt-0.5 flex h-9 w-9 shrink-0 items-center justify-center rounded-xl border border-[var(--border)]/60 bg-[var(--card)] text-[var(--foreground)] shadow-sm"- >- <Icon size={16} strokeWidth={1.6} />- </span>- <div className="min-w-0">- <div className="flex flex-wrap items-center gap-2">- <h1 className="font-serif text-[19px] font-semibold leading-tight tracking-tight text-[var(--foreground)]">- {title}- </h1>- {meta}- </div>- <p className="mt-1 max-w-xl text-[13px] leading-relaxed text-[var(--muted-foreground)]">- {description}- </p>- </div>- </div>- {action && (- <div className="shrink-0 self-start md:self-end">{action}</div>- )}- </header>+ <PageHeader title={title} description={description} action={action} meta={meta} level={level} />);}diff --git a/web/components/space/learning/PathTitle.tsx b/web/components/space/learning/PathTitle.tsxindex 7ffdac28c..0c90f80fd 100644--- a/web/components/space/learning/PathTitle.tsx+++ b/web/components/space/learning/PathTitle.tsx@@ -1,5 +1,6 @@"use client";+import { PAGE_TITLE_CLASS } from '@/components/layout/FeaturePage'import { Check, Pencil, X } from "lucide-react";import { useTranslation } from "react-i18next";import { useEffect, useRef, useState } from "react";@@ -81,8 +82,7 @@ export function PathTitle({setEditing(false);};- const TITLE_TYPE =- "font-serif text-[22px] font-semibold tracking-[-0.01em] text-[var(--foreground)]";+ const TITLE_TYPE = PAGE_TITLE_CLASS;if (!editing) {return (diff --git a/web/components/space/learning/TopicAtlas.tsx b/web/components/space/learning/TopicAtlas.tsxindex 20b12f387..351ff3bae 100644--- a/web/components/space/learning/TopicAtlas.tsx+++ b/web/components/space/learning/TopicAtlas.tsx@@ -1,5 +1,6 @@'use client'+import { pageGridClass } from '@/components/layout/FeaturePage'import {LearningShell,LearningEmptyState,@@ -119,7 +120,7 @@ export function TopicAtlas({) : activeTopics.length > 0 ? (<sectionaria-label={t('Active learning topics')}- className="mt-9 grid gap-6 md:grid-cols-2 xl:grid-cols-3"+ className={`mt-9 ${pageGridClass(3)}`}>{activeTopics.map(topic => (<TopicMapCard key={libraryItemKey(topic, topic.path_id)} topic={topic} />diff --git a/web/components/space/question-bank/QuestionBankSection.tsx b/web/components/space/question-bank/QuestionBankSection.tsxindex 296b4d678..39892b312 100644--- a/web/components/space/question-bank/QuestionBankSection.tsx+++ b/web/components/space/question-bank/QuestionBankSection.tsx@@ -96,7 +96,6 @@ export default function QuestionBankSection({<div className="space-y-3">{!embedded && (<SpaceSectionHeader- icon={ClipboardList}title={t("Question Bank")}description={t("Review and organize quiz questions across sessions. Bookmark items, group them into categories, and jump back to the original chat.",diff --git a/web/components/tasks/TaskBoardRuntime.tsx b/web/components/tasks/TaskBoardRuntime.tsxnew file mode 100644index 000000000..6b0947786--- /dev/null+++ b/web/components/tasks/TaskBoardRuntime.tsx@@ -0,0 +1,9 @@+'use client'++import { useEffect, type ReactNode } from 'react'+import { startTaskBoardSync } from '@/lib/task-board-store'++export default function TaskBoardRuntime({ children }: { children: ReactNode }) {+ useEffect(startTaskBoardSync, [])+ return children+}diff --git a/web/components/tasks/TaskColorPicker.tsx b/web/components/tasks/TaskColorPicker.tsxnew file mode 100644index 000000000..455633cc4--- /dev/null+++ b/web/components/tasks/TaskColorPicker.tsx@@ -0,0 +1,247 @@+'use client'++import { useRef, useState, type RefObject } from 'react'+import { Check, Palette, RotateCcw, X } from 'lucide-react'+import { useTranslation } from 'react-i18next'+import { useOutsideClick } from '@/hooks/use-outside-click'+import { useModalDialog } from '@/hooks/useModalDialog'+import { DEFAULT_TASK_COLORS, type TaskColors, type TaskStatus } from '@/lib/task-board-api'++const statuses: TaskStatus[] = ['todo', 'doing', 'done']+const swatches = [+ '#2563eb',+ '#4f46e5',+ '#8b5cf6',+ '#db2777',+ '#e11d48',+ '#ea580c',+ '#0284c7',+ '#0d9488',+ '#15803d',+ '#65a30d',+ '#a16207',+ '#64748b',+]++type SaveColors = (colors: TaskColors, onSuccess: () => void) => void++export default function TaskColorPicker({+ colors,+ disabled,+ busy,+ error,+ onSave,+}: {+ colors: TaskColors+ disabled: boolean+ busy: boolean+ error?: string+ onSave: SaveColors+}) {+ const { t } = useTranslation()+ const [open, setOpen] = useState(false)+ const rootRef = useRef<HTMLDivElement>(null)+ const triggerRef = useRef<HTMLButtonElement>(null)+ useOutsideClick(rootRef, open && !busy, () => setOpen(false))++ return (+ <div ref={rootRef} className="relative">+ <button+ ref={triggerRef}+ type="button"+ disabled={disabled || busy}+ aria-label={t('tasks.colors')}+ aria-expanded={open}+ aria-haspopup="dialog"+ onClick={() => setOpen(value => !value)}+ className={`dt-page-action inline-flex h-9 items-center gap-2 rounded-lg px-3 text-[13px] font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring/40 disabled:opacity-40 ${open ? 'bg-muted text-foreground' : 'text-muted-foreground hover:bg-muted/60 hover:text-foreground'}`}+ >+ <Palette size={15} strokeWidth={1.7} />+ {t('tasks.colors')}+ <span aria-hidden className="ml-1 flex items-center -space-x-1">+ {statuses.map(status => (+ <span+ key={status}+ className="h-2.5 w-2.5 rounded-full ring-2 ring-background"+ style={{ backgroundColor: colors[status] }}+ />+ ))}+ </span>+ </button>+ {open && (+ <ColorPanel+ colors={colors}+ busy={busy}+ error={error}+ onSave={onSave}+ onClose={() => setOpen(false)}+ triggerRef={triggerRef}+ />+ )}+ </div>+ )+}++function ColorPanel({+ colors,+ busy,+ error,+ onSave,+ onClose,+ triggerRef,+}: {+ colors: TaskColors+ busy: boolean+ error?: string+ onSave: SaveColors+ onClose: () => void+ triggerRef: RefObject<HTMLButtonElement | null>+}) {+ const { t } = useTranslation()+ const [draft, setDraft] = useState(colors)+ const [status, setStatus] = useState<TaskStatus>('todo')+ const [hex, setHex] = useState(colors.todo)+ const dialogRef = useModalDialog(onClose, busy, triggerRef)+ const validHex = /^#[0-9a-f]{6}$/i.test(hex)+ const changed = statuses.some(key => draft[key].toLowerCase() !== colors[key].toLowerCase())++ function choose(color: string) {+ setHex(color)+ setDraft(value => ({ ...value, [status]: color }))+ }++ return (+ <div+ ref={dialogRef}+ role="dialog"+ aria-label={t('tasks.colors')}+ style={{ boxShadow: 'var(--shadow-raised)' }}+ className="absolute left-0 top-full z-50 mt-2 w-[min(320px,calc(100vw-48px))] overflow-hidden rounded-2xl border border-border/70 bg-popover text-foreground backdrop-blur-xl md:left-auto md:right-0"+ >+ <div className="flex items-center justify-between px-4 pb-3 pt-4">+ <h2 className="text-[13px] font-semibold">{t('tasks.colors')}</h2>+ <button+ type="button"+ aria-label={t('Close')}+ disabled={busy}+ onClick={onClose}+ className="rounded-md p-1 text-muted-foreground transition-colors hover:bg-muted focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring/40"+ >+ <X size={14} strokeWidth={1.7} />+ </button>+ </div>+ <div className="px-4 pb-4">+ <div+ role="group"+ aria-label={t('tasks.status')}+ className="flex gap-1 rounded-xl bg-muted/65 p-1"+ >+ {statuses.map(key => (+ <button+ key={key}+ type="button"+ aria-pressed={status === key}+ data-modal-initial-focus={status === key || undefined}+ disabled={busy}+ onClick={() => {+ setStatus(key)+ setHex(draft[key])+ }}+ className={`flex min-w-0 flex-1 items-center justify-center gap-1.5 rounded-lg px-1 py-2 text-xs font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring/40 ${status === key ? 'bg-card text-foreground shadow-sm' : 'text-muted-foreground hover:text-foreground'}`}+ >+ <span+ className="h-2 w-2 shrink-0 rounded-full"+ style={{ backgroundColor: draft[key] }}+ />+ {t(`kanban.${key}`)}+ </button>+ ))}+ </div>+ <div role="group" aria-label={t('Choose color')} className="mt-4 grid grid-cols-6 gap-2">+ {swatches.map(color => {+ const selected = draft[status].toLowerCase() === color+ return (+ <button+ key={color}+ type="button"+ aria-label={`${t('Choose color')}: ${color}`}+ aria-pressed={selected}+ disabled={busy}+ onClick={() => choose(color)}+ className="group flex h-10 items-center justify-center rounded-lg focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring/40 disabled:opacity-40"+ >+ <span+ className={`flex h-7 w-7 items-center justify-center rounded-full text-white transition-transform duration-150 group-hover:scale-110 ${selected ? 'ring-2 ring-foreground/65 ring-offset-[3px] ring-offset-popover' : ''}`}+ style={{ backgroundColor: color }}+ >+ {selected && <Check size={13} strokeWidth={2.3} />}+ </span>+ </button>+ )+ })}+ </div>+ <div className="mt-4 flex items-center justify-between gap-3 rounded-xl bg-muted/45 px-3 py-2">+ <span className="text-xs text-muted-foreground">{t('Custom')}</span>+ <span className="flex items-center gap-2">+ <span className="relative flex h-6 w-6 items-center justify-center rounded-md focus-within:ring-2 focus-within:ring-ring/40">+ <span+ aria-hidden+ className="h-3.5 w-3.5 rounded-full shadow-[inset_0_0_0_1px_rgba(0,0,0,0.08)]"+ style={{ backgroundColor: draft[status] }}+ />+ <input+ type="color"+ aria-label={`${t(`kanban.${status}`)}: ${t('Choose color')}`}+ disabled={busy}+ value={draft[status]}+ onChange={event => choose(event.target.value)}+ className="absolute inset-0 h-full w-full cursor-pointer opacity-0"+ />+ </span>+ <input+ aria-label={`${t(`kanban.${status}`)}: ${t('tasks.color')}`}+ aria-invalid={!validHex}+ value={hex.toUpperCase()}+ maxLength={7}+ spellCheck={false}+ disabled={busy}+ onChange={event => {+ const value = event.target.value+ setHex(value)+ if (/^#[0-9a-f]{6}$/i.test(value))+ setDraft(current => ({ ...current, [status]: value }))+ }}+ className="w-[76px] rounded bg-transparent py-1 text-right font-mono text-xs uppercase tracking-wide outline-none focus-visible:ring-2 focus-visible:ring-ring/40 aria-[invalid=true]:text-destructive"+ />+ </span>+ </div>+ {error && (+ <p role="alert" className="mt-3 text-xs text-destructive">+ {error}+ </p>+ )}+ </div>+ <div className="flex items-center justify-between border-t border-border/60 px-4 py-3">+ <button+ type="button"+ disabled={busy}+ onClick={() => {+ setDraft({ ...DEFAULT_TASK_COLORS })+ setHex(DEFAULT_TASK_COLORS[status])+ }}+ className="inline-flex items-center gap-1.5 text-xs text-muted-foreground transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring/40"+ >+ <RotateCcw size={12} strokeWidth={1.7} /> {t('Reset')}+ </button>+ <button+ type="button"+ disabled={busy || !validHex || !changed}+ onClick={() => onSave(draft, onClose)}+ className="rounded-lg bg-primary px-3.5 py-1.5 text-xs font-medium text-primary-foreground transition-opacity hover:opacity-90 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring/40 focus-visible:ring-offset-2 disabled:opacity-40"+ >+ {t('kanban.save')}+ </button>+ </div>+ </div>+ )+}diff --git a/web/components/tasks/TaskLinkSelector.tsx b/web/components/tasks/TaskLinkSelector.tsxnew file mode 100644index 000000000..7764c94df--- /dev/null+++ b/web/components/tasks/TaskLinkSelector.tsx@@ -0,0 +1,106 @@+'use client'++import { useState } from 'react'+import { useTranslation } from 'react-i18next'+import { linkSessionTasks, sessionTaskLinks } from '@/lib/task-board-api'+import { useTaskBoard } from '@/lib/task-board-store'++export default function TaskLinkSelector({+ sessionId,+ workspaceId,+ draftTaskIds = [],+ onDraftChange,+ onLinked,+}: {+ sessionId?: string | null+ workspaceId: string+ draftTaskIds?: string[]+ onDraftChange?: (ids: string[]) => void+ onLinked?: () => void+}) {+ const { t } = useTranslation()+ const { board, error } = useTaskBoard()+ const [query, setQuery] = useState('')+ const [busy, setBusy] = useState(false)+ const [saveError, setSaveError] = useState(false)+ const ids = sessionId+ ? (sessionTaskLinks(board, sessionId, workspaceId)?.task_ids ?? [])+ : draftTaskIds+ const cards =+ board?.cards.filter(+ card =>+ (!card.archived || ids.includes(card.id)) &&+ `${card.title} ${card.note}`.toLowerCase().includes(query.toLowerCase())+ ) ?? []++ async function toggle(id: string) {+ const next = ids.includes(id) ? ids.filter(value => value !== id) : [...ids, id]+ if (!sessionId) {+ onDraftChange?.(next)+ onLinked?.()+ return+ }+ setBusy(true)+ setSaveError(false)+ try {+ await linkSessionTasks(sessionId, workspaceId, next)+ onLinked?.()+ } catch {+ setSaveError(true)+ } finally {+ setBusy(false)+ }+ }+ return (+ <div className="space-y-2 p-3">+ <input+ aria-label={t('tasks.search')}+ placeholder={t('tasks.search')}+ value={query}+ onChange={event => setQuery(event.target.value)}+ className="w-full rounded-lg border border-[var(--border)] bg-transparent px-3 py-2 text-sm"+ />+ {(error || saveError) && (+ <p role="alert" className="text-xs text-[var(--destructive)]">+ {t('tasks.saveError')}+ </p>+ )}+ {!board && !error && (+ <p role="status" className="text-sm text-[var(--muted-foreground)]">+ {t('kanban.loading')}+ </p>+ )}+ {board && !cards.length && (+ <p className="py-3 text-sm text-[var(--muted-foreground)]">{t('tasks.empty')}</p>+ )}+ <div className="max-h-72 space-y-1 overflow-y-auto">+ {cards.map(card => (+ <label+ key={card.id}+ className="flex cursor-pointer items-start gap-2 rounded-lg px-2 py-2 hover:bg-[var(--accent)]"+ >+ <input+ type="checkbox"+ disabled={busy || (!sessionId && !onDraftChange)}+ checked={ids.includes(card.id)}+ onChange={() => void toggle(card.id)}+ className="mt-1 shrink-0"+ />+ <span+ className="mt-1.5 h-2 w-2 shrink-0 rounded-full"+ style={{ backgroundColor: board?.colors[card.status] }}+ />+ <span className="min-w-0 flex-1 break-words text-sm">+ {card.title}+ <span className="block text-xs text-[var(--muted-foreground)]">+ {t(`kanban.${card.status}`)}+ {card.archived ? ` · ${t('Archive')}` : ''}+ </span>+ </span>+ </label>+ ))}+ </div>+ <p className="text-xs text-[var(--muted-foreground)]">{t('tasks.latestHint')}</p>+ </div>+ )+}diff --git a/web/components/tasks/TaskPanelSection.tsx b/web/components/tasks/TaskPanelSection.tsxnew file mode 100644index 000000000..114cd78ba--- /dev/null+++ b/web/components/tasks/TaskPanelSection.tsx@@ -0,0 +1,134 @@+'use client'++import { useState } from 'react'+import Link from 'next/link'+import { X } from 'lucide-react'+import { useTranslation } from 'react-i18next'+import {+ linkSessionTasks,+ sessionTaskLinks,+ updateTaskCard,+ type TaskCard,+ type TaskStatus,+} from '@/lib/task-board-api'+import { useTaskBoard } from '@/lib/task-board-store'+import { activeWorkspaceId } from '@/lib/workspace-scope'++export default function TaskPanelSection({+ sessionId,+ draftTaskIds = [],+ onDraftChange,+}: {+ sessionId: string | null+ draftTaskIds?: string[]+ onDraftChange?: (ids: string[]) => void+}) {+ const { t } = useTranslation()+ const { board } = useTaskBoard()+ const [busy, setBusy] = useState(false)+ const [error, setError] = useState(false)+ const workspaceId = activeWorkspaceId()+ const ids = sessionId+ ? (sessionTaskLinks(board, sessionId, workspaceId)?.task_ids ?? [])+ : draftTaskIds+ const linked = [...ids].reverse().flatMap(id => board?.cards.find(card => card.id === id) ?? [])+ const assigned =+ board?.cards.filter(+ card => !card.archived && card.workspace_id === workspaceId && !ids.includes(card.id)+ ) ?? []+ if (!linked.length && !assigned.length) return null++ async function save(operation: () => Promise<unknown>) {+ setBusy(true)+ setError(false)+ try {+ await operation()+ } catch {+ setError(true)+ } finally {+ setBusy(false)+ }+ }+ function rows(cards: TaskCard[], allowUnlink: boolean) {+ return cards.map(card => (+ <div key={card.id} className="space-y-1 rounded-xl bg-[var(--muted)] p-3">+ <div className="flex items-start gap-2">+ <span+ className="mt-1.5 h-2 w-2 shrink-0 rounded-full"+ style={{ backgroundColor: board?.colors[card.status] }}+ />+ <span className="min-w-0 flex-1 break-words text-sm font-medium">{card.title}</span>+ {allowUnlink && (sessionId || onDraftChange) && (+ <button+ type="button"+ disabled={busy}+ aria-label={`${card.title}: ${t('tasks.unlink')}`}+ onClick={() => {+ const next = ids.filter(id => id !== card.id)+ if (sessionId) void save(() => linkSessionTasks(sessionId, workspaceId, next))+ else onDraftChange?.(next)+ }}+ className="rounded p-1 text-[var(--muted-foreground)] hover:bg-[var(--accent)]"+ >+ <X size={14} />+ </button>+ )}+ </div>+ {card.note && (+ <p className="whitespace-pre-wrap break-words text-xs text-[var(--muted-foreground)]">+ {card.note}+ </p>+ )}+ <select+ aria-label={`${card.title}: ${t('tasks.status')}`}+ value={card.status}+ disabled={busy}+ onChange={event =>+ void save(() => updateTaskCard(card.id, { status: event.target.value as TaskStatus }))+ }+ className="rounded-md bg-[var(--card)] px-2 py-1 text-xs"+ >+ {(['todo', 'doing', 'done'] as const).map(status => (+ <option key={status} value={status}>+ {t(`kanban.${status}`)}+ </option>+ ))}+ </select>+ {card.archived && (+ <span className="ml-2 text-xs text-[var(--muted-foreground)]">{t('Archive')}</span>+ )}+ </div>+ ))+ }+ return (+ <section aria-label={t('tasks.linked')} className="space-y-3">+ {error && (+ <p role="alert" className="text-xs text-[var(--destructive)]">+ {t('tasks.saveError')}+ </p>+ )}+ {linked.length > 0 && (+ <div className="space-y-2">+ <h3 className="px-1 text-xs font-medium text-[var(--muted-foreground)]">+ {t('tasks.linked')}+ </h3>+ {rows(linked, true)}+ </div>+ )}+ {assigned.length > 0 && (+ <div className="space-y-2">+ <h3 className="px-1 text-xs font-medium text-[var(--muted-foreground)]">+ {t('tasks.workspace')}+ </h3>+ {rows(assigned, false)}+ </div>+ )}+ <Link+ href="/kanban"+ className="inline-block text-xs text-[var(--muted-foreground)] hover:text-[var(--foreground)]"+ >+ {t('tasks.openBoard')}+ </Link>+ </section>+ )+}diff --git a/web/contracts/generated/api.ts b/web/contracts/generated/api.tsindex 7db477feb..2fe002d3b 100644--- a/web/contracts/generated/api.ts+++ b/web/contracts/generated/api.ts@@ -1713,7 +1713,7 @@ export interface paths {};/*** List Knowledge Bases- * @description List all available knowledge bases with their details.+ * @description Disk probes must not block the async worker or its other requests (#1711).*/readonly get: operations["list_knowledge_bases_api_knowledge_bases_get"];readonly put?: never;@@ -2686,7 +2686,7 @@ export interface paths {};/*** Health Check- * @description Health check endpoint+ * @description Count registered KBs without constructing/probing the catalog (#1711).*/readonly get: operations["health_check_api_knowledge_bases_health_get"];readonly put?: never;@@ -8292,6 +8292,26 @@ export interface paths {readonly patch?: never;readonly trace?: never;};+ readonly "/api/settings/services/{service}/preview": {+ readonly parameters: {+ readonly query?: never;+ readonly header?: never;+ readonly path?: never;+ readonly cookie?: never;+ };+ readonly get?: never;+ readonly put?: never;+ /**+ * Preview Service+ * @description Stream a real result from the selected draft without applying it.+ */+ readonly post: operations["preview_service_api_settings_services__service__preview_post"];+ readonly delete?: never;+ readonly options?: never;+ readonly head?: never;+ readonly patch?: never;+ readonly trace?: never;+ };readonly "/api/settings/sidebar": {readonly parameters: {readonly query?: never;@@ -8656,6 +8676,26 @@ export interface paths {readonly patch?: never;readonly trace?: never;};+ readonly "/api/settings/voice/voices": {+ readonly parameters: {+ readonly query?: never;+ readonly header?: never;+ readonly path?: never;+ readonly cookie?: never;+ };+ readonly get?: never;+ readonly put?: never;+ /**+ * List Voice Choices+ * @description Read live account voices for a draft selection, without applying it.+ */+ readonly post: operations["list_voice_choices_api_settings_voice_voices_post"];+ readonly delete?: never;+ readonly options?: never;+ readonly head?: never;+ readonly patch?: never;+ readonly trace?: never;+ };readonly "/api/settings/workspace": {readonly parameters: {readonly query?: never;@@ -9775,10 +9815,7 @@ export interface paths {readonly path?: never;readonly cookie?: never;};- /**- * Get Board- * @description Return active and archived cards in the current workspace.- */+ /** Get Board */readonly get: operations["get_board_api_task_board_get"];readonly put?: never;readonly post?: never;@@ -9797,10 +9834,7 @@ export interface paths {};readonly get?: never;readonly put?: never;- /**- * Create Card- * @description Create a task in the To do column.- */+ /** Create Card */readonly post: operations["create_card_api_task_board_cards_post"];readonly delete?: never;readonly options?: never;@@ -9821,13 +9855,78 @@ export interface paths {readonly delete?: never;readonly options?: never;readonly head?: never;- /**- * Update Card- * @description Edit, move, archive or restore an existing task.- */+ /** Update Card */readonly patch: operations["update_card_api_task_board_cards__card_id__patch"];readonly trace?: never;};+ readonly "/api/task-board/colors": {+ readonly parameters: {+ readonly query?: never;+ readonly header?: never;+ readonly path?: never;+ readonly cookie?: never;+ };+ readonly get?: never;+ /** Update Colors */+ readonly put: operations["update_colors_api_task_board_colors_put"];+ readonly post?: never;+ readonly delete?: never;+ readonly options?: never;+ readonly head?: never;+ readonly patch?: never;+ readonly trace?: never;+ };+ readonly "/api/task-board/events": {+ readonly parameters: {+ readonly query?: never;+ readonly header?: never;+ readonly path?: never;+ readonly cookie?: never;+ };+ /** Board Events */+ readonly get: operations["board_events_api_task_board_events_get"];+ readonly put?: never;+ readonly post?: never;+ readonly delete?: never;+ readonly options?: never;+ readonly head?: never;+ readonly patch?: never;+ readonly trace?: never;+ };+ readonly "/api/task-board/sessions/{session_id}": {+ readonly parameters: {+ readonly query?: never;+ readonly header?: never;+ readonly path?: never;+ readonly cookie?: never;+ };+ readonly get?: never;+ /** Link Tasks */+ readonly put: operations["link_tasks_api_task_board_sessions__session_id__put"];+ readonly post?: never;+ readonly delete?: never;+ readonly options?: never;+ readonly head?: never;+ readonly patch?: never;+ readonly trace?: never;+ };+ readonly "/api/task-board/sessions/{session_id}/status": {+ readonly parameters: {+ readonly query?: never;+ readonly header?: never;+ readonly path?: never;+ readonly cookie?: never;+ };+ readonly get?: never;+ readonly put?: never;+ readonly post?: never;+ readonly delete?: never;+ readonly options?: never;+ readonly head?: never;+ /** Link Status */+ readonly patch: operations["link_status_api_task_board_sessions__session_id__status_patch"];+ readonly trace?: never;+ };readonly "/api/tools": {readonly parameters: {readonly query?: never;@@ -11695,10 +11794,7 @@ export interface components {*/readonly user_intent: string;};- /**- * CreateCard- * @description A learner-authored task; identifiers and timestamps are server-owned.- */+ /** CreateCard */readonly CreateCard: {/*** Note@@ -12980,6 +13076,26 @@ export interface components {/** Folder Path */readonly folder_path: string;};+ /** LinkStatus */+ readonly LinkStatus: {+ /** Enabled */+ readonly enabled: boolean;+ /**+ * Workspace Id+ * @default+ */+ readonly workspace_id: string;+ };+ /** LinkTasks */+ readonly LinkTasks: {+ /** Task Ids */+ readonly task_ids: readonly string[];+ /**+ * Workspace Id+ * @default+ */+ readonly workspace_id: string;+ };/** ListImaRequest */readonly ListImaRequest: {/**@@ -14017,11 +14133,8 @@ export interface components {readonly PositionPayload: {/** Locator */readonly locator: number;- /**- * Percentage- * @default 0- */- readonly percentage: number;+ /** Percentage */+ readonly percentage?: number | null;/*** Source Anchor* @default@@ -14808,6 +14921,32 @@ export interface components {readonly [key: string]: string;};};+ /** ServicePreviewPayload */+ readonly ServicePreviewPayload: {+ /**+ * Audio+ * @default+ */+ readonly audio: string;+ /** Catalog */+ readonly catalog: {+ readonly [key: string]: unknown;+ };+ /**+ * Content Type+ * @default+ */+ readonly content_type: string;+ /** Model Id */+ readonly model_id?: string | null;+ /** Profile Id */+ readonly profile_id: string;+ /**+ * Text+ * @default+ */+ readonly text: string;+ };/** SessionBranchBody */readonly SessionBranchBody: {/** New Key */@@ -14919,6 +15058,20 @@ export interface components {*/readonly updated_at: number | null;};+ /** SessionTaskLinks */+ readonly SessionTaskLinks: {+ /** Session Id */+ readonly session_id: string;+ /**+ * Status Link Enabled+ * @default true+ */+ readonly status_link_enabled: boolean;+ /** Task Ids */+ readonly task_ids?: readonly string[];+ /** Workspace Id */+ readonly workspace_id: string;+ };/*** SetRoleRequest* @description Payload for the PUT /users/{username}/role endpoint.@@ -15047,6 +15200,24 @@ export interface components {/** Content */readonly content: string;};+ /** StatusColors */+ readonly StatusColors: {+ /**+ * Doing+ * @default #a16207+ */+ readonly doing: string;+ /**+ * Done+ * @default #15803d+ */+ readonly done: string;+ /**+ * Todo+ * @default #2563eb+ */+ readonly todo: string;+ };/** SubagentMessageRequest */readonly SubagentMessageRequest: {/**@@ -15207,18 +15378,20 @@ export interface components {/** Updated */readonly updated: number;};- /**- * TaskBoard- * @description A consistent snapshot of the current workspace's board.- */+ /** TaskBoard */readonly TaskBoard: {/** Cards */readonly cards: readonly components["schemas"]["TaskCard"][];+ readonly colors?: components["schemas"]["StatusColors"];+ /**+ * Revision+ * @default 0+ */+ readonly revision: number;+ /** Session Links */+ readonly session_links?: readonly components["schemas"]["SessionTaskLinks"][];};- /**- * TaskCard- * @description Persisted card returned to the board, including archived cards.- */+ /** TaskCard */readonly TaskCard: {/** Archived */readonly archived: boolean;@@ -15240,6 +15413,8 @@ export interface components {readonly title: string;/** Updated At */readonly updated_at: string;+ /** Workspace Id */+ readonly workspace_id?: string | null;};/** TestResponse */readonly TestResponse: {@@ -15844,10 +16019,7 @@ export interface components {/** Title */readonly title?: string | null;};- /**- * UpdateCard- * @description Only supplied fields change, preserving concurrent edits to other fields.- */+ /** UpdateCard */readonly UpdateCard: {/** Archived */readonly archived?: boolean | null;@@ -15857,6 +16029,8 @@ export interface components {readonly status?: ("todo" | "doing" | "done") | null;/** Title */readonly title?: string | null;+ /** Workspace Id */+ readonly workspace_id?: string | null;};/** UpdateCourseRequest */readonly UpdateCourseRequest: {@@ -16332,6 +16506,17 @@ export interface components {/** Voice Autoplay */readonly voice_autoplay: boolean;};+ /** VoiceDiscoveryPayload */+ readonly VoiceDiscoveryPayload: {+ /** Catalog */+ readonly catalog: {+ readonly [key: string]: unknown;+ };+ /** Model Id */+ readonly model_id: string;+ /** Profile Id */+ readonly profile_id: string;+ };/** VoiceMathSpeakUpdate */readonly VoiceMathSpeakUpdate: {/** Voice Math Speak */@@ -16839,6 +17024,8 @@ export type SchemaLightRagVisionModel =export type SchemaLinkedFolderInfo = components["schemas"]["LinkedFolderInfo"];export type SchemaLinkFolderRequest =components["schemas"]["LinkFolderRequest"];+export type SchemaLinkStatus = components["schemas"]["LinkStatus"];+export type SchemaLinkTasks = components["schemas"]["LinkTasks"];export type SchemaListImaRequest = components["schemas"]["ListImaRequest"];export type SchemaListImaResponse = components["schemas"]["ListImaResponse"];export type SchemaLlamaIndexConfigUpdate =@@ -16977,6 +17164,8 @@ export type SchemaRoundSummaryRequest =export type SchemaRunStartRequest = components["schemas"]["RunStartRequest"];export type SchemaRuntimeStatus = components["schemas"]["RuntimeStatus"];export type SchemaServerPayload = components["schemas"]["ServerPayload"];+export type SchemaServicePreviewPayload =+ components["schemas"]["ServicePreviewPayload"];export type SchemaSessionBranchBody =components["schemas"]["SessionBranchBody"];export type SchemaSessionDetail = components["schemas"]["SessionDetail"];@@ -16994,6 +17183,7 @@ export type SchemaSessionRenameRequest =export type SchemaSessionReplyLanguageRequest =components["schemas"]["SessionReplyLanguageRequest"];export type SchemaSessionSummary = components["schemas"]["SessionSummary"];+export type SchemaSessionTaskLinks = components["schemas"]["SessionTaskLinks"];export type SchemaSetRoleRequest = components["schemas"]["SetRoleRequest"];export type SchemaSetSessionModeRequest =components["schemas"]["SetSessionModeRequest"];@@ -17018,6 +17208,7 @@ export type SchemaSoulSpec = components["schemas"]["SoulSpec"];export type SchemaSoulTemplateUpdateRequest =components["schemas"]["SoulTemplateUpdateRequest"];export type SchemaSoulUpdateBody = components["schemas"]["SoulUpdateBody"];+export type SchemaStatusColors = components["schemas"]["StatusColors"];export type SchemaSubagentMessageRequest =components["schemas"]["SubagentMessageRequest"];export type SchemaSubagentSettingsPayload =@@ -17105,6 +17296,8 @@ export type SchemaVideoLearningSettingsRequest =components["schemas"]["VideoLearningSettingsRequest"];export type SchemaVoiceAutoplayUpdate =components["schemas"]["VoiceAutoplayUpdate"];+export type SchemaVoiceDiscoveryPayload =+ components["schemas"]["VoiceDiscoveryPayload"];export type SchemaVoiceMathSpeakUpdate =components["schemas"]["VoiceMathSpeakUpdate"];export type SchemaVoicePreviewPayload =@@ -35689,6 +35882,45 @@ export interface operations {};};};+ readonly preview_service_api_settings_services__service__preview_post: {+ readonly parameters: {+ readonly query?: never;+ readonly header?: {+ readonly Authorization?: string | null;+ };+ readonly path: {+ readonly service: string;+ };+ readonly cookie?: {+ readonly dt_token?: string | null;+ };+ };+ readonly requestBody: {+ readonly content: {+ readonly "application/json": components["schemas"]["ServicePreviewPayload"];+ };+ };+ readonly responses: {+ /** @description Successful Response */+ readonly 200: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": unknown;+ };+ };+ /** @description Validation Error */+ readonly 422: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": components["schemas"]["HTTPValidationError"];+ };+ };+ };+ };readonly get_sidebar_settings_api_settings_sidebar_get: {readonly parameters: {readonly query?: never;@@ -36437,6 +36669,43 @@ export interface operations {};};};+ readonly list_voice_choices_api_settings_voice_voices_post: {+ readonly parameters: {+ readonly query?: never;+ readonly header?: {+ readonly Authorization?: string | null;+ };+ readonly path?: never;+ readonly cookie?: {+ readonly dt_token?: string | null;+ };+ };+ readonly requestBody: {+ readonly content: {+ readonly "application/json": components["schemas"]["VoiceDiscoveryPayload"];+ };+ };+ readonly responses: {+ /** @description Successful Response */+ readonly 200: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": unknown;+ };+ };+ /** @description Validation Error */+ readonly 422: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": components["schemas"]["HTTPValidationError"];+ };+ };+ };+ };readonly get_workspace_settings_api_settings_workspace_get: {readonly parameters: {readonly query?: never;@@ -38996,6 +39265,154 @@ export interface operations {};};};+ readonly update_colors_api_task_board_colors_put: {+ readonly parameters: {+ readonly query?: never;+ readonly header?: {+ readonly Authorization?: string | null;+ };+ readonly path?: never;+ readonly cookie?: {+ readonly dt_token?: string | null;+ };+ };+ readonly requestBody: {+ readonly content: {+ readonly "application/json": components["schemas"]["StatusColors"];+ };+ };+ readonly responses: {+ /** @description Successful Response */+ readonly 200: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": components["schemas"]["TaskBoard"];+ };+ };+ /** @description Validation Error */+ readonly 422: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": components["schemas"]["HTTPValidationError"];+ };+ };+ };+ };+ readonly board_events_api_task_board_events_get: {+ readonly parameters: {+ readonly query?: never;+ readonly header?: {+ readonly Authorization?: string | null;+ };+ readonly path?: never;+ readonly cookie?: {+ readonly dt_token?: string | null;+ };+ };+ readonly requestBody?: never;+ readonly responses: {+ /** @description Successful Response */+ readonly 200: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": unknown;+ };+ };+ /** @description Validation Error */+ readonly 422: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": components["schemas"]["HTTPValidationError"];+ };+ };+ };+ };+ readonly link_tasks_api_task_board_sessions__session_id__put: {+ readonly parameters: {+ readonly query?: never;+ readonly header?: {+ readonly Authorization?: string | null;+ };+ readonly path: {+ readonly session_id: string;+ };+ readonly cookie?: {+ readonly dt_token?: string | null;+ };+ };+ readonly requestBody: {+ readonly content: {+ readonly "application/json": components["schemas"]["LinkTasks"];+ };+ };+ readonly responses: {+ /** @description Successful Response */+ readonly 200: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": components["schemas"]["TaskBoard"];+ };+ };+ /** @description Validation Error */+ readonly 422: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": components["schemas"]["HTTPValidationError"];+ };+ };+ };+ };+ readonly link_status_api_task_board_sessions__session_id__status_patch: {+ readonly parameters: {+ readonly query?: never;+ readonly header?: {+ readonly Authorization?: string | null;+ };+ readonly path: {+ readonly session_id: string;+ };+ readonly cookie?: {+ readonly dt_token?: string | null;+ };+ };+ readonly requestBody: {+ readonly content: {+ readonly "application/json": components["schemas"]["LinkStatus"];+ };+ };+ readonly responses: {+ /** @description Successful Response */+ readonly 200: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": components["schemas"]["TaskBoard"];+ };+ };+ /** @description Validation Error */+ readonly 422: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": components["schemas"]["HTTPValidationError"];+ };+ };+ };+ };readonly list_builtin_tools_api_tools_get: {readonly parameters: {readonly query?: never;diff --git a/web/contracts/schema/openapi.json b/web/contracts/schema/openapi.jsonindex 3c62404b4..55b81f02b 100644--- a/web/contracts/schema/openapi.json+++ b/web/contracts/schema/openapi.json@@ -2332,7 +2332,6 @@},"CreateCard": {"additionalProperties": false,- "description": "A learner-authored task; identifiers and timestamps are server-owned.","properties": {"note": {"default": "",@@ -5266,6 +5265,50 @@"title": "LinkFolderRequest","type": "object"},+ "LinkStatus": {+ "additionalProperties": false,+ "properties": {+ "enabled": {+ "title": "Enabled",+ "type": "boolean"+ },+ "workspace_id": {+ "default": "",+ "maxLength": 200,+ "title": "Workspace Id",+ "type": "string"+ }+ },+ "required": [+ "enabled"+ ],+ "title": "LinkStatus",+ "type": "object"+ },+ "LinkTasks": {+ "additionalProperties": false,+ "properties": {+ "task_ids": {+ "items": {+ "type": "string"+ },+ "maxItems": 100,+ "title": "Task Ids",+ "type": "array"+ },+ "workspace_id": {+ "default": "",+ "maxLength": 200,+ "title": "Workspace Id",+ "type": "string"+ }+ },+ "required": [+ "task_ids"+ ],+ "title": "LinkTasks",+ "type": "object"+ },"LinkedFolderInfo": {"description": "Response model for linked folder information.","properties": {@@ -7188,8 +7231,6 @@},"percentage": {"default": 0.0,- "maximum": 1.0,- "minimum": 0.0,"title": "Percentage","type": "number"},@@ -7219,11 +7260,17 @@"type": "integer"},"percentage": {- "default": 0.0,- "maximum": 1.0,- "minimum": 0.0,- "title": "Percentage",- "type": "number"+ "anyOf": [+ {+ "maximum": 1.0,+ "minimum": 0.0,+ "type": "number"+ },+ {+ "type": "null"+ }+ ],+ "title": "Percentage"},"source_anchor": {"default": "",@@ -8923,6 +8970,53 @@"title": "ServerPayload","type": "object"},+ "ServicePreviewPayload": {+ "properties": {+ "audio": {+ "default": "",+ "maxLength": 11184812,+ "title": "Audio",+ "type": "string"+ },+ "catalog": {+ "additionalProperties": true,+ "title": "Catalog",+ "type": "object"+ },+ "content_type": {+ "default": "",+ "title": "Content Type",+ "type": "string"+ },+ "model_id": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Model Id"+ },+ "profile_id": {+ "title": "Profile Id",+ "type": "string"+ },+ "text": {+ "default": "",+ "maxLength": 2000,+ "title": "Text",+ "type": "string"+ }+ },+ "required": [+ "catalog",+ "profile_id"+ ],+ "title": "ServicePreviewPayload",+ "type": "object"+ },"SessionBranchBody": {"properties": {"new_key": {@@ -9239,6 +9333,36 @@"title": "SessionSummary","type": "object"},+ "SessionTaskLinks": {+ "properties": {+ "session_id": {+ "title": "Session Id",+ "type": "string"+ },+ "status_link_enabled": {+ "default": true,+ "title": "Status Link Enabled",+ "type": "boolean"+ },+ "task_ids": {+ "items": {+ "type": "string"+ },+ "title": "Task Ids",+ "type": "array"+ },+ "workspace_id": {+ "title": "Workspace Id",+ "type": "string"+ }+ },+ "required": [+ "workspace_id",+ "session_id"+ ],+ "title": "SessionTaskLinks",+ "type": "object"+ },"SetRoleRequest": {"description": "Payload for the PUT /users/{username}/role endpoint.","properties": {@@ -9538,6 +9662,31 @@"title": "SoulUpdateBody","type": "object"},+ "StatusColors": {+ "additionalProperties": false,+ "properties": {+ "doing": {+ "default": "#a16207",+ "pattern": "^#[0-9a-fA-F]{6}$",+ "title": "Doing",+ "type": "string"+ },+ "done": {+ "default": "#15803d",+ "pattern": "^#[0-9a-fA-F]{6}$",+ "title": "Done",+ "type": "string"+ },+ "todo": {+ "default": "#2563eb",+ "pattern": "^#[0-9a-fA-F]{6}$",+ "title": "Todo",+ "type": "string"+ }+ },+ "title": "StatusColors",+ "type": "object"+ },"SubagentMessageRequest": {"properties": {"chat_session_id": {@@ -9986,7 +10135,6 @@"type": "object"},"TaskBoard": {- "description": "A consistent snapshot of the current workspace's board.","properties": {"cards": {"items": {@@ -9994,6 +10142,21 @@},"title": "Cards","type": "array"+ },+ "colors": {+ "$ref": "#/components/schemas/StatusColors"+ },+ "revision": {+ "default": 0,+ "title": "Revision",+ "type": "integer"+ },+ "session_links": {+ "items": {+ "$ref": "#/components/schemas/SessionTaskLinks"+ },+ "title": "Session Links",+ "type": "array"}},"required": [@@ -10004,7 +10167,6 @@},"TaskCard": {"additionalProperties": false,- "description": "Persisted card returned to the board, including archived cards.","properties": {"archived": {"title": "Archived",@@ -10042,6 +10204,17 @@"updated_at": {"title": "Updated At","type": "string"+ },+ "workspace_id": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Workspace Id"}},"required": [@@ -11293,7 +11466,6 @@},"UpdateCard": {"additionalProperties": false,- "description": "Only supplied fields change, preserving concurrent edits to other fields.","properties": {"archived": {"anyOf": [@@ -11346,6 +11518,18 @@}],"title": "Title"+ },+ "workspace_id": {+ "anyOf": [+ {+ "maxLength": 200,+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Workspace Id"}},"title": "UpdateCard",@@ -12566,6 +12750,30 @@"title": "VoiceAutoplayUpdate","type": "object"},+ "VoiceDiscoveryPayload": {+ "properties": {+ "catalog": {+ "additionalProperties": true,+ "title": "Catalog",+ "type": "object"+ },+ "model_id": {+ "title": "Model Id",+ "type": "string"+ },+ "profile_id": {+ "title": "Profile Id",+ "type": "string"+ }+ },+ "required": [+ "catalog",+ "profile_id",+ "model_id"+ ],+ "title": "VoiceDiscoveryPayload",+ "type": "object"+ },"VoiceMathSpeakUpdate": {"properties": {"voice_math_speak": {@@ -20727,7 +20935,7 @@},"/api/knowledge-bases": {"get": {- "description": "List all available knowledge bases with their details.",+ "description": "Disk probes must not block the async worker or its other requests (#1711).","operationId": "list_knowledge_bases_api_knowledge_bases_get","parameters": [{@@ -21793,7 +22001,7 @@},"/api/knowledge-bases/health": {"get": {- "description": "Health check endpoint",+ "description": "Count registered KBs without constructing/probing the catalog (#1711).","operationId": "health_check_api_knowledge_bases_health_get","parameters": [{@@ -51966,73 +52174,20 @@]}},- "/api/settings/sidebar": {- "get": {- "operationId": "get_sidebar_settings_api_settings_sidebar_get",+ "/api/settings/services/{service}/preview": {+ "post": {+ "description": "Stream a real result from the selected draft without applying it.",+ "operationId": "preview_service_api_settings_services__service__preview_post","parameters": [{- "in": "header",- "name": "Authorization",- "required": false,- "schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Authorization"- }- },- {- "in": "cookie",- "name": "dt_token",- "required": false,+ "in": "path",+ "name": "service",+ "required": true,"schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Dt Token"+ "title": "Service",+ "type": "string"}- }- ],- "responses": {- "200": {- "content": {- "application/json": {- "schema": {}- }- },- "description": "Successful Response"},- "422": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- },- "description": "Validation Error"- }- },- "summary": "Get Sidebar Settings",- "tags": [- "settings"- ]- }- },- "/api/settings/sidebar/description": {- "put": {- "operationId": "update_sidebar_description_api_settings_sidebar_description_put",- "parameters": [{"in": "header","name": "Authorization",@@ -52070,7 +52225,7 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/SidebarDescriptionUpdate"+ "$ref": "#/components/schemas/ServicePreviewPayload"}}},@@ -52096,15 +52251,151 @@"description": "Validation Error"}},- "summary": "Update Sidebar Description",+ "summary": "Preview Service","tags": ["settings"]}},- "/api/settings/sidebar/nav-order": {- "put": {- "operationId": "update_sidebar_nav_order_api_settings_sidebar_nav_order_put",+ "/api/settings/sidebar": {+ "get": {+ "operationId": "get_sidebar_settings_api_settings_sidebar_get",+ "parameters": [+ {+ "in": "header",+ "name": "Authorization",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"+ }+ },+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }+ }+ ],+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {}+ }+ },+ "description": "Successful Response"+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Get Sidebar Settings",+ "tags": [+ "settings"+ ]+ }+ },+ "/api/settings/sidebar/description": {+ "put": {+ "operationId": "update_sidebar_description_api_settings_sidebar_description_put",+ "parameters": [+ {+ "in": "header",+ "name": "Authorization",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"+ }+ },+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }+ }+ ],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/SidebarDescriptionUpdate"+ }+ }+ },+ "required": true+ },+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {}+ }+ },+ "description": "Successful Response"+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Update Sidebar Description",+ "tags": [+ "settings"+ ]+ }+ },+ "/api/settings/sidebar/nav-order": {+ "put": {+ "operationId": "update_sidebar_nav_order_api_settings_sidebar_nav_order_put","parameters": [{"in": "header",@@ -53461,6 +53752,80 @@]}},+ "/api/settings/voice/voices": {+ "post": {+ "description": "Read live account voices for a draft selection, without applying it.",+ "operationId": "list_voice_choices_api_settings_voice_voices_post",+ "parameters": [+ {+ "in": "header",+ "name": "Authorization",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"+ }+ },+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }+ }+ ],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/VoiceDiscoveryPayload"+ }+ }+ },+ "required": true+ },+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {}+ }+ },+ "description": "Successful Response"+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "List Voice Choices",+ "tags": [+ "settings"+ ]+ }+ },"/api/settings/workspace": {"get": {"operationId": "get_workspace_settings_api_settings_workspace_get",@@ -58527,7 +58892,6 @@},"/api/task-board": {"get": {- "description": "Return active and archived cards in the current workspace.","operationId": "get_board_api_task_board_get","parameters": [{@@ -58593,7 +58957,6 @@},"/api/task-board/cards": {"post": {- "description": "Create a task in the To do column.","operationId": "create_card_api_task_board_cards_post","parameters": [{@@ -58669,7 +59032,6 @@},"/api/task-board/cards/{card_id}": {"patch": {- "description": "Edit, move, archive or restore an existing task.","operationId": "update_card_api_task_board_cards__card_id__patch","parameters": [{@@ -58752,6 +59114,312 @@]}},+ "/api/task-board/colors": {+ "put": {+ "operationId": "update_colors_api_task_board_colors_put",+ "parameters": [+ {+ "in": "header",+ "name": "Authorization",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"+ }+ },+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }+ }+ ],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/StatusColors"+ }+ }+ },+ "required": true+ },+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/TaskBoard"+ }+ }+ },+ "description": "Successful Response"+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Update Colors",+ "tags": [+ "task-board"+ ]+ }+ },+ "/api/task-board/events": {+ "get": {+ "operationId": "board_events_api_task_board_events_get",+ "parameters": [+ {+ "in": "header",+ "name": "Authorization",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"+ }+ },+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }+ }+ ],+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {}+ }+ },+ "description": "Successful Response"+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Board Events",+ "tags": [+ "task-board"+ ]+ }+ },+ "/api/task-board/sessions/{session_id}": {+ "put": {+ "operationId": "link_tasks_api_task_board_sessions__session_id__put",+ "parameters": [+ {+ "in": "path",+ "name": "session_id",+ "required": true,+ "schema": {+ "title": "Session Id",+ "type": "string"+ }+ },+ {+ "in": "header",+ "name": "Authorization",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"+ }+ },+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }+ }+ ],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/LinkTasks"+ }+ }+ },+ "required": true+ },+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/TaskBoard"+ }+ }+ },+ "description": "Successful Response"+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Link Tasks",+ "tags": [+ "task-board"+ ]+ }+ },+ "/api/task-board/sessions/{session_id}/status": {+ "patch": {+ "operationId": "link_status_api_task_board_sessions__session_id__status_patch",+ "parameters": [+ {+ "in": "path",+ "name": "session_id",+ "required": true,+ "schema": {+ "title": "Session Id",+ "type": "string"+ }+ },+ {+ "in": "header",+ "name": "Authorization",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"+ }+ },+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }+ }+ ],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/LinkStatus"+ }+ }+ },+ "required": true+ },+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/TaskBoard"+ }+ }+ },+ "description": "Successful Response"+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Link Status",+ "tags": [+ "task-board"+ ]+ }+ },"/api/tools": {"get": {"description": "Return all built-in tools the chat agent can invoke, plus any\ncoming-soon placeholders for the settings page.",diff --git a/web/features/chat/components/ChatWorkspace.tsx b/web/features/chat/components/ChatWorkspace.tsxindex 97673f243..8e05ace70 100644--- a/web/features/chat/components/ChatWorkspace.tsx+++ b/web/features/chat/components/ChatWorkspace.tsx@@ -363,6 +363,11 @@ export default function ChatWorkspace({// What the composer's skill / MCP pickers may offer, clipped to what this// conversation's workspace already allows.const resourceCatalog = useComposerResources(state.workspaceId, workspaces);+ const [draftTaskSelections, setDraftTaskSelections] = useState<Record<string, string[]>>({});+ const draftTaskIds = useMemo(+ () => draftTaskSelections[state.sessionKey] ?? [],+ [draftTaskSelections, state.sessionKey],+ );const activeWorkspace = useMemo(() =>state.workspaceId@@ -2015,6 +2020,9 @@ export default function ChatWorkspace({_persistent_knowledge_bases: retainedKnowledgeBases(state.knowledgeBases, agentNameSet, resourceReuse.policy),};+ if (!state.sessionId && draftTaskIds.length) {+ config = { ...(config ?? {}), linked_task_ids: draftTaskIds };+ }const memoryPayload = [...memoryReferencesPayload];const messageContent =content ||@@ -2063,7 +2071,7 @@ export default function ChatWorkspace({if (!resourceReuse.policy.memory) setSelectedMemoryFiles([]);},[- resourceReuse, state.knowledgeBases, state.resourceSelection, agentNameSet, setKBs, setPersonaSelection, setResourceSelection,+ draftTaskIds, state.sessionId, resourceReuse, state.knowledgeBases, state.resourceSelection, agentNameSet, setKBs, setPersonaSelection, setResourceSelection,attachments,bookReferencesPayload,courseId,@@ -2811,6 +2819,10 @@ export default function ChatWorkspace({onSetSpaceMenuOpen={setSpaceMenuOpen}onToggleKB={handleToggleKB}onSelectLLM={setLLMSelection}+ taskSessionId={state.sessionId}+ draftTaskIds={draftTaskIds}+ onDraftTaskIdsChange={ids => setDraftTaskSelections(value => ({ ...value, [state.sessionKey]: ids }))}+ onTasksLinked={ensureActivityPanelOpen}onSelectNotebookPicker={handleSelectNotebookPicker}onSelectBookPicker={handleSelectBookPicker}onSelectReadingPicker={handleSelectReadingPicker}@@ -2930,6 +2942,8 @@ export default function ChatWorkspace({onClose={handleClosePreview}/><SessionViewerPanel+ taskDraftIds={draftTaskIds}+ onTaskDraftChange={ids => setDraftTaskSelections(value => ({ ...value, [state.sessionKey]: ids }))}ref={viewerPanelRef}open={viewerPanelOpen && previewSource === null}sessionId={state.sessionId}diff --git a/web/features/settings/navigation/settings-pages.ts b/web/features/settings/navigation/settings-pages.tsindex 1248ef26d..a19f59d86 100644--- a/web/features/settings/navigation/settings-pages.ts+++ b/web/features/settings/navigation/settings-pages.ts@@ -12,14 +12,14 @@ import type { SettingsAccess } from './settings-access'export const SETTINGS_PAGE_GROUPS: { label: Lang; keys: string[] }[] = [{ label: { en: 'Personal', zh: '个人' }, keys: ['general', 'workspace', 'data-migration', 'appearance', 'usage'] },- {- label: { en: 'Learning & conversation', zh: '学习与对话' },- keys: ['starters', 'attachments', 'video-learning', 'learner-profile', 'progress', 'guardian', 'memory'],- },{label: { en: 'Models & services', zh: '模型与服务' },keys: ['connections', 'llm', 'task-models', 'embedding', 'search', 'voice', 'multimodal'],},+ {+ label: { en: 'Learning & conversation', zh: '学习与对话' },+ keys: ['starters', 'attachments', 'video-learning', 'learner-profile', 'progress', 'guardian', 'memory'],+ },{label: { en: 'Features & integrations', zh: '功能与集成' },keys: ['tools', 'capabilities', 'agent-claude-code', 'knowledge'],diff --git a/web/features/settings/sections/models/SttSettingsSection.tsx b/web/features/settings/sections/models/SttSettingsSection.tsxindex e9aecf112..7b07aaca7 100644--- a/web/features/settings/sections/models/SttSettingsSection.tsx+++ b/web/features/settings/sections/models/SttSettingsSection.tsx@@ -7,7 +7,7 @@ export default function SttSettingsPage() {return (<div><SettingsPageHeader- title={t("Voice")}+ title={t("settings.serviceConfig.voiceServices")}description={t("Manage speech synthesis and transcription models using saved providers.",)}diff --git a/web/features/settings/sections/models/TtsSettingsSection.tsx b/web/features/settings/sections/models/TtsSettingsSection.tsxindex 90ee87dc6..4633ea8aa 100644--- a/web/features/settings/sections/models/TtsSettingsSection.tsx+++ b/web/features/settings/sections/models/TtsSettingsSection.tsx@@ -8,7 +8,7 @@ export default function TtsSettingsPage() {return (<div><SettingsPageHeader- title={t("Voice")}+ title={t("settings.serviceConfig.voiceServices")}description={t("Manage speech synthesis and transcription models using saved providers.",)}diff --git a/web/features/settings/sections/models/VoiceSettingsSection.tsx b/web/features/settings/sections/models/VoiceSettingsSection.tsxindex 9931f98a0..7134c9160 100644--- a/web/features/settings/sections/models/VoiceSettingsSection.tsx+++ b/web/features/settings/sections/models/VoiceSettingsSection.tsx@@ -8,7 +8,7 @@ export default function VoiceSettingsPage() {return (<div><SettingsPageHeader- title={t("Voice")}+ title={t("settings.serviceConfig.voiceServices")}description={t("Manage speech synthesis and transcription models using saved providers.",)}diff --git a/web/features/settings/store/SettingsStore.tsx b/web/features/settings/store/SettingsStore.tsxindex 06aef62ac..aebcb74e8 100644--- a/web/features/settings/store/SettingsStore.tsx+++ b/web/features/settings/store/SettingsStore.tsx@@ -1004,7 +1004,7 @@ export function SettingsProvider({ children }: { children: ReactNode }) {: {}),...(service === "tts"? {- voice: providerOption?.default_voice ?? "",+ voice: "",response_format: "",}: {}),@@ -1069,7 +1069,7 @@ export function SettingsProvider({ children }: { children: ReactNode }) {: {}),...(service === "tts"? {- voice: providerOption?.default_voice ?? "",+ voice: "",response_format: "",}: {}),@@ -1244,7 +1244,7 @@ export function SettingsProvider({ children }: { children: ReactNode }) {: {}),...(item.service === "tts"? {- voice: item.spec.default_voice || "",+ voice: "",response_format: "",}: {}),diff --git a/web/lib/model-catalog-types.ts b/web/lib/model-catalog-types.tsindex efcc5bbd9..eac342179 100644--- a/web/lib/model-catalog-types.ts+++ b/web/lib/model-catalog-types.ts@@ -8,7 +8,7 @@ export type ProviderRef = {};export type Discovery = {status: string;- models: { id: string }[];+ models: { id: string; services?: ServiceName[] }[];capabilities?: { category: string; evidence: string }[];checked_at?: string;http_status?: number | null;@@ -88,7 +88,12 @@ export type LlmContextWindowDetection = {detectedAt?: string;};+/** User-selected service access. Missing entries follow registry/live metadata. */+export type ProviderServiceOverride = { enabled: boolean; binding?: string; base_url?: string };+export type ProviderServiceOverrides = Partial<Record<ServiceName, ProviderServiceOverride>>;+export type CatalogProfile = {+ service_overrides?: ProviderServiceOverrides;user_name?: string;provider_ref?: ProviderRef;provider_only?: boolean;@@ -159,6 +164,7 @@ export type TaskKindInfo = { id: string; group: string };* they were typed, not how they resolve.*/export type CatalogConnection = {+ service_overrides?: ProviderServiceOverrides;source_service?: ServiceName;discovery?: Discovery;api_format?: ApiFormat;diff --git a/web/lib/model-settings.ts b/web/lib/model-settings.tsindex 23f969646..de862a4e8 100644--- a/web/lib/model-settings.ts+++ b/web/lib/model-settings.ts@@ -113,6 +113,7 @@ export function modelTestFingerprint("api_format","wire_api","proxy",+ "service_overrides",].map((key) => [key, Reflect.get(providerSource, key)]),): undefined;diff --git a/web/lib/provider-registry.ts b/web/lib/provider-registry.tsindex 48cce1cf9..67e3b0092 100644--- a/web/lib/provider-registry.ts+++ b/web/lib/provider-registry.ts@@ -162,12 +162,30 @@ export function providerUsage() === source.id,).length;}+export const PROVIDER_SERVICES: ServiceName[] = ["llm", "embedding", "tts", "stt", "imagegen", "videogen", "search"];++export function providerServiceSupport(+ source: ProviderSource, service: ServiceName,+ targets: ConnectionTarget[], providers: Record<ServiceName, ProviderOption[]>,+): { enabled: boolean; evidence: "manual" | "detected" | "builtin" | "unknown" } {+ const kind = service === "task" ? "llm" : service;+ const override = source.source.service_overrides?.[kind];+ if (override) return { enabled: override.enabled, evidence: "manual" };+ const detected = source.source.discovery?.status === "connected" && source.source.discovery.capabilities?.some(c => c.category === kind && c.evidence === "metadata");+ const known = Boolean((source.provider !== "custom" && targets.find(t => t.provider === source.provider)?.services[kind]) ||+ providers[kind]?.some(p => p.value === source.provider && (source.provider !== "custom" || kind === "llm") && p.value !== "none" && p.status !== "deprecated") || (source.service === "task" ? "llm" : source.service) === kind);+ // Search has no general-purpose compatibility protocol.+ return { enabled: known || Boolean(detected && kind !== "search"), evidence: detected ? "detected" : known ? "builtin" : "unknown" };+}+export function providerAdapter(source: ProviderSource,service: ServiceName,targets: ConnectionTarget[],providers: Record<ServiceName, ProviderOption[]>,) {+ const kind = service === "task" ? "llm" : service;+ const override = source.source.service_overrides?.[kind];const target = targets.find((t) => t.provider === source.provider)?.services[service === "task" ? "llm" : service];@@ -177,6 +195,7 @@ export function providerAdapter(// generic adapter, so it keeps the vendor's own name and gets rejected by name// rather than masquerading as an OpenAI-compatible search engine.const binding =+ (override?.enabled && override.binding) ||target?.provider ||exact?.value ||(service === "llm" ||@@ -188,7 +207,7 @@ export function providerAdapter(return {...source.ref,binding,- default_base_url: target?.base_url || exact?.base_url || "",+ default_base_url: (override?.enabled && override.base_url) || target?.base_url || exact?.base_url || "",};}export function providerProbeInput(source: ProviderSource, fallbackUrl = "") {@@ -216,7 +235,7 @@ export function updateProvider()?.source;if (!source) return;Object.assign(source, { [field]: value });- if (!["name", "discovery"].includes(field)) delete source.discovery;+ if (!["name", "discovery", "service_overrides"].includes(field)) delete source.discovery;}/** Three-way, entity-scoped reconciliation: edits made while a save was indiff --git a/web/lib/task-board-api.ts b/web/lib/task-board-api.tsindex 4a1defa63..e12edf145 100644--- a/web/lib/task-board-api.ts+++ b/web/lib/task-board-api.ts@@ -1,6 +1,13 @@-import { apiFetch, apiUrl } from '@/shared/api/client'+import { apiFetch } from '@/shared/api/client'+import { scopedUrl } from '@/lib/workspace-scope'export type TaskStatus = 'todo' | 'doing' | 'done'+export type TaskColors = Record<TaskStatus, string>+export const DEFAULT_TASK_COLORS: TaskColors = {+ todo: '#2563eb',+ doing: '#a16207',+ done: '#15803d',+}export interface TaskCard {id: string@@ -10,39 +17,116 @@ export interface TaskCard {archived: booleancreated_at: stringupdated_at: string+ workspace_id: string | null+}+export interface SessionTaskLinks {+ workspace_id: string+ session_id: string+ task_ids: string[]+ status_link_enabled: boolean}-export interface TaskBoard {cards: TaskCard[]+ colors: TaskColors+ session_links: SessionTaskLinks[]+ revision: number}const endpoint = '/api/task-board'+const listeners = new Set<(board: TaskBoard) => void>()+export function subscribeTaskBoardChanges(listener: (board: TaskBoard) => void) {+ listeners.add(listener)+ return () => {+ listeners.delete(listener)+ }+}+export function normalizeTaskBoard(board: TaskBoard): TaskBoard {+ return {+ ...board,+ colors: board.colors ?? DEFAULT_TASK_COLORS,+ session_links: board.session_links ?? [],+ revision: board.revision ?? 0,+ }+}+export function publishTaskBoard(board: TaskBoard) {+ listeners.forEach(listener => listener(normalizeTaskBoard(board)))+}+export function taskBoardUrl(path = '') {+ return scopedUrl(`${endpoint}${path}`, '')+}async function request(path: string, init?: RequestInit): Promise<TaskBoard> {- const response = await apiFetch(apiUrl(path), init)+ const response = await apiFetch(taskBoardUrl(path), init)if (!response.ok) throw new Error('Task board request failed')- return response.json() as Promise<TaskBoard>+ const board = normalizeTaskBoard(await response.json())+ if (init?.method) publishTaskBoard(board)+ return board}-export function getTaskBoard(signal?: AbortSignal): Promise<TaskBoard> {- return request(endpoint, { signal, cache: 'no-store' })+ return request('', { signal, cache: 'no-store' })}-export function createTaskCard(title: string): Promise<TaskBoard> {- return request(`${endpoint}/cards`, {+ return request('/cards', {method: 'POST',headers: { 'Content-Type': 'application/json' },body: JSON.stringify({ title }),})}-export function updateTaskCard(id: string,- changes: Partial<Pick<TaskCard, 'title' | 'note' | 'status' | 'archived'>>+ changes: Partial<Pick<TaskCard, 'title' | 'note' | 'status' | 'archived' | 'workspace_id'>>): Promise<TaskBoard> {- return request(`${endpoint}/cards/${encodeURIComponent(id)}`, {+ return request(`/cards/${encodeURIComponent(id)}`, {method: 'PATCH',headers: { 'Content-Type': 'application/json' },body: JSON.stringify(changes),})}+export function updateTaskColors(colors: TaskColors): Promise<TaskBoard> {+ return request('/colors', {+ method: 'PUT',+ headers: { 'Content-Type': 'application/json' },+ body: JSON.stringify(colors),+ })+}+export function linkSessionTasks(+ sessionId: string,+ workspaceId: string,+ taskIds: string[]+): Promise<TaskBoard> {+ return request(`/sessions/${encodeURIComponent(sessionId)}`, {+ method: 'PUT',+ headers: { 'Content-Type': 'application/json' },+ body: JSON.stringify({ workspace_id: workspaceId, task_ids: taskIds }),+ })+}+export function setTaskStatusLink(+ sessionId: string,+ workspaceId: string,+ enabled: boolean+): Promise<TaskBoard> {+ return request(`/sessions/${encodeURIComponent(sessionId)}/status`, {+ method: 'PATCH',+ headers: { 'Content-Type': 'application/json' },+ body: JSON.stringify({ workspace_id: workspaceId, enabled }),+ })+}+export function sessionTaskLinks(+ board: TaskBoard | null,+ sessionId: string | null,+ workspaceId: string+): SessionTaskLinks | undefined {+ return board?.session_links.find(+ row => row.session_id === sessionId && row.workspace_id === workspaceId+ )+}+export function sessionTaskColor(+ board: TaskBoard | null,+ sessionId: string,+ workspaceId: string+): string | undefined {+ const links = sessionTaskLinks(board, sessionId, workspaceId)+ if (!links || !links.status_link_enabled) return undefined+ const card = board?.cards.find(card => card.id === links.task_ids.at(-1))+ return card ? board?.colors[card.status] : undefined+}diff --git a/web/lib/task-board-store.ts b/web/lib/task-board-store.tsnew file mode 100644index 000000000..680173465--- /dev/null+++ b/web/lib/task-board-store.ts@@ -0,0 +1,113 @@+'use client'++import { useSyncExternalStore } from 'react'+import {+ getTaskBoard,+ normalizeTaskBoard,+ subscribeTaskBoardChanges,+ taskBoardUrl,+ type TaskBoard,+} from './task-board-api'++interface State {+ board: TaskBoard | null+ error: boolean+}+const empty: State = { board: null, error: false }+let state = empty+const listeners = new Set<() => void>()+let generation = 0+let refreshing: Promise<void> | undefined+let owners = 0+let stop: (() => void) | undefined++function accept(board: TaskBoard) {+ // A delayed GET or mutation must not roll back a newer streamed snapshot.+ if (state.board && board.revision < state.board.revision) return+ state = { board: normalizeTaskBoard(board), error: false }+ listeners.forEach(listener => listener())+}+export async function refreshTaskBoard() {+ if (refreshing) return refreshing+ const currentGeneration = generation+ refreshing = (async () => {+ try {+ const board = await getTaskBoard()+ if (generation === currentGeneration) accept(board)+ } catch {+ if (generation === currentGeneration) {+ state = { ...state, error: true }+ listeners.forEach(listener => listener())+ }+ } finally {+ if (generation === currentGeneration) refreshing = undefined+ }+ })()+ return refreshing+}++/** One account-level connection, owned by the workspace shell, outside its scope reset. */+export function startTaskBoardSync() {+ if (++owners === 1) {+ const unsubscribe = subscribeTaskBoardChanges(accept)+ void refreshTaskBoard()+ const source =+ typeof EventSource !== 'undefined'+ ? new EventSource(taskBoardUrl('/events'), { withCredentials: true })+ : null+ let fallback: ReturnType<typeof setInterval> | undefined+ const startFallback = () => {+ fallback ??= setInterval(() => {+ if (!document.hidden) void refreshTaskBoard()+ }, 3000)+ }+ if (source) {+ source.onmessage = event => {+ try {+ accept(JSON.parse(event.data))+ } catch {+ void refreshTaskBoard()+ }+ }+ source.onerror = startFallback+ source.onopen = () => {+ clearInterval(fallback)+ fallback = undefined+ }+ } else startFallback()+ const focus = () => {+ if (!document.hidden) void refreshTaskBoard()+ }+ window.addEventListener('focus', focus)+ document.addEventListener('visibilitychange', focus)+ stop = () => {+ unsubscribe()+ source?.close()+ clearInterval(fallback)+ window.removeEventListener('focus', focus)+ document.removeEventListener('visibilitychange', focus)+ }+ }+ return () => {+ if (--owners === 0) {+ stop?.()+ stop = undefined+ state = empty+ generation+++ refreshing = undefined+ }+ }+}+function subscribe(listener: () => void) {+ listeners.add(listener)+ return () => {+ listeners.delete(listener)+ }+}+export function useTaskBoard() {+ return useSyncExternalStore(+ subscribe,+ () => state,+ () => empty+ )+}diff --git a/web/lib/workspace-scope.ts b/web/lib/workspace-scope.tsindex 9c6f26c21..d5c506130 100644--- a/web/lib/workspace-scope.ts+++ b/web/lib/workspace-scope.ts@@ -13,6 +13,11 @@ export function scopedUrl(path: string, workspaceId = activeWorkspaceId()): striif (!path.startsWith('/') && !absolute) return pathconst url = new URL(path, origin)if (url.origin !== origin) return path+ if (url.pathname === '/kanban' || url.pathname === '/api/task-board' || url.pathname.startsWith('/api/task-board/')) {+ url.searchParams.delete('dt_workspace')+ url.searchParams.delete('workspace')+ return absolute ? url.toString() : `${url.pathname}${url.search}${url.hash}`+ }if (!url.searchParams.has('dt_workspace'))url.searchParams.set('dt_workspace', url.searchParams.get('workspace') ?? workspaceId)return absolute ? url.toString() : `${url.pathname}${url.search}${url.hash}`diff --git a/web/locales/de/app.json b/web/locales/de/app.jsonindex f694035cb..36933b878 100644--- a/web/locales/de/app.json+++ b/web/locales/de/app.json@@ -5228,7 +5228,7 @@"kanban.forward": "Eine Spalte weiter","kanban.moveTo": "Verschieben nach","kanban.archive": "Archivieren",- "kanban.footer": "Die Karten werden in diesem Workspace gespeichert. Ziehe eine Karte oder nutze die Pfeilschaltflächen, um sie zu verschieben.",+ "kanban.footer": "Aufgaben werden auf einem unabhängigen Board gespeichert und können Arbeitsbereichen zugewiesen oder mit Unterhaltungen verknüpft werden.","kanban.loadError": "Das Aufgabenboard konnte nicht geöffnet werden. Lade die Seite neu.","kanban.saveError": "Die Karte konnte nicht gespeichert werden.","kanban.loading": "Aufgabenboard wird geladen…",@@ -5334,5 +5334,110 @@"Request timeout (seconds)": "Zeitlimit für Anfragen (Sekunden)","Show API token": "API-Token anzeigen","Hide API token": "API-Token ausblenden",- "Failed to link this follow-up chat to its notebook entry.": "Dieser Folgechat konnte nicht mit seinem Notizbucheintrag verknüpft werden."+ "Failed to link this follow-up chat to its notebook entry.": "Dieser Folgechat konnte nicht mit seinem Notizbucheintrag verknüpft werden.",+ "tasks.linked": "Verknüpfte Aufgaben",+ "tasks.workspace": "Aufgaben im Arbeitsbereich",+ "tasks.assign": "Arbeitsbereich zuweisen",+ "tasks.unassigned": "Keinem Arbeitsbereich zugewiesen",+ "tasks.search": "Aufgaben suchen",+ "tasks.empty": "Keine passenden Aufgaben. Erstelle Aufgaben auf dem Aufgabenboard.",+ "tasks.latestHint": "Die zuletzt verknüpfte Aufgabe bestimmt die Farbe der Unterhaltung.",+ "tasks.unlink": "Aufgabe lösen",+ "tasks.status": "Aufgabenstatus",+ "tasks.openBoard": "Aufgabenboard öffnen",+ "tasks.colors": "Statusfarben",+ "tasks.color": "Farbe",+ "tasks.unlinkStatus": "Verknüpfung mit Aufgabenstatus lösen",+ "tasks.linkStatus": "Aufgabenstatus verknüpfen",+ "tasks.saveError": "Die Änderung konnte nicht gespeichert werden. Bitte erneut versuchen.",+ "settings.agentSetup.title": "Lass deinen Agenten bei der Einrichtung helfen",+ "settings.agentSetup.description": "Folge den Schritten unten oder lass deinen eigenen Agenten DeepTutor einrichten.",+ "settings.agentSetup.instructions": "Kopiere diesen Prompt in einen Agenten mit Terminalzugriff auf deine DeepTutor-Installation, etwa Codex oder Claude Code.",+ "settings.agentSetup.copy": "Prompt kopieren",+ "settings.agentSetup.copyFailed": "Kopieren fehlgeschlagen. Markiere den Text oben und kopiere ihn manuell.",+ "settings.agentSetup.prompt": "Hilf mir, meine vorhandene DeepTutor-Installation einzurichten: https://github.com/HKUDS/DeepTutor.\nLies zuerst SKILL.md und docs-for-user/AGENT_SETUP.md im Quellcode der passenden Version oder im Repository, falls kein lokaler Quellcode vorliegt.\nErmittle Installation, Version, laufende Instanz, Konto und Laufzeitverzeichnis. Verwende meine Umgebung weiter und bewahre vorhandene Dateien, Einstellungen und noch nicht angewendete Entwürfe.\nVerbinde einen Anbieter und wähle ein Chatmodell; richte Embedding, Suche und weitere Dienste nur bei Bedarf ein. Frage nach fehlenden Modellentscheidungen oder Zugangsdatenquellen. Fordere keine API-Schlüssel im Chat an und gib sie nicht aus.\nNutze die Anleitung und --help der installierten CLI zur Einrichtung und Prüfung derselben Instanz. Berichte über Änderungen, tatsächliche Prüfergebnisse und offene Schritte.",+ "settings.voiceDiscovery.loading": "Stimmen werden geladen…",+ "settings.voiceDiscovery.modelFirst": "Wähle zuerst ein Modell.",+ "settings.voiceDiscovery.failed": "Stimmen konnten nicht geladen werden. Prüfe Verbindung und Berechtigungen und versuche es erneut.",+ "settings.voiceDiscovery.unsupported": "Für diese Verbindung ist keine Live-Stimmabfrage verfügbar. Eine Stimmen-ID kann manuell eingegeben werden; es gibt keine feste Stimmenliste.",+ "settings.voiceDiscovery.empty": "Der Anbieter hat keine passenden Stimmen zurückgegeben.",+ "settings.voiceDiscovery.custom": "Aktuelle benutzerdefinierte Stimmen für dieses Modell. Diese API listet keine Systemstimmen. Vor dem Anwenden probehören.",+ "settings.voiceDiscovery.account": "Live-Stimmen deines Kontos. Der Anbieter filtert nicht nach Modell; prüfe die Kompatibilität durch Probehören.",+ "settings.voiceDiscovery.choose": "Stimme auswählen",+ "settings.voiceDiscovery.current": "Aktuelle Stimme (nicht im Ergebnis)",+ "settings.voiceDiscovery.manual": "Stimmen-ID manuell eingeben",+ "settings.serviceConfig.custom": "Weitere Anbieter für eigene Anbindungen anzeigen",+ "settings.serviceConfig.providers": "Wähle Anbieter und Modell. Prüfe bei eigenen Anbindungen, ob der Anbieter die erforderliche API unterstützt.",+ "settings.serviceConfig.search": "Wähle eine unterstützte Suchmaschine. Sie verwendet eine eigene API und benötigt kein Modell.",+ "settings.serviceConfig.unsupportedSearch": "Für diese Verbindung gibt es keinen Suchadapter. Wähle einen unterstützten Anbieter.",+ "settings.serviceConfig.video": "Videoerzeugung erfordert Aufgabenübermittlung, Statusabfragen und Downloads. Eigene Endpunkte müssen DeepTutors Videoprotokoll unterstützen; eine Chat-API allein reicht nicht.",+ "settings.serviceConfig.discovery": "Modellsuche (optional)",+ "settings.serviceConfig.tools": "Aktiviere nach dem Anwenden das entsprechende Werkzeug für den Chat.",+ "settings.serviceConfig.openTools": "Chat-Werkzeuge verwalten",+ "settings.servicePreview.title.search": "Suche testen",+ "settings.servicePreview.title.stt": "Spracherkennung testen",+ "settings.servicePreview.title.imagegen": "Testbild erzeugen",+ "settings.servicePreview.title.videogen": "Testvideo erzeugen",+ "settings.servicePreview.description.search": "Suche mit diesem Entwurf und prüfe die Ergebnisse. Die aktive Konfiguration bleibt unverändert.",+ "settings.servicePreview.description.stt": "Lade eine kurze Sprachaufnahme hoch und prüfe den Text. Verwendet diesen Entwurf; Anbietergebühren sind möglich.",+ "settings.servicePreview.description.imagegen": "Erzeugt ein echtes Bild mit diesem Entwurf. Der Anbieter kann Gebühren berechnen.",+ "settings.servicePreview.description.videogen": "Sendet eine echte Anfrage und wartet bis zu 10 Minuten auf ein abspielbares Video. Anbietergebühren sind möglich.",+ "settings.servicePreview.audio": "Audiobeispiel · WAV, MP3, M4A, WebM, OGG oder FLAC · bis 8 MB",+ "settings.servicePreview.query": "Suchanfrage",+ "settings.servicePreview.prompt": "Beschreibe das gewünschte Ergebnis",+ "settings.servicePreview.placeholder.search": "Zum Beispiel: Wie funktionieren Solarzellen?",+ "settings.servicePreview.placeholder.imagegen": "Zum Beispiel: Ein blaues Buch auf weißem Hintergrund",+ "settings.servicePreview.placeholder.videogen": "Zum Beispiel: Eine sanfte Welle am Strand",+ "settings.servicePreview.action.search": "Suchen",+ "settings.servicePreview.action.stt": "Aufnahme transkribieren",+ "settings.servicePreview.action.imagegen": "Bild erzeugen",+ "settings.servicePreview.action.videogen": "Video erzeugen",+ "settings.servicePreview.status.requesting": "Testanfrage wird gesendet…",+ "settings.servicePreview.status.rendering": "Aufgabe übermittelt. Warte auf das fertige Video…",+ "settings.servicePreview.status.success": "Ergebnis erhalten. Prüfe es vor dem Anwenden.",+ "settings.servicePreview.status.empty": "Der Dienst hat ohne Inhalt geantwortet. Versuche eine andere Aufnahme oder Anfrage.",+ "settings.servicePreview.status.failed": "Kein nutzbares Ergebnis. Prüfe Verbindung, Modellzugriff und Parameter und versuche es erneut.",+ "settings.servicePreview.status.timeout": "Zeitüberschreitung. Prüfe den Aufgabenstatus beim Anbieter, bevor du erneut generierst.",+ "settings.servicePreview.status.cancelled": "Test gestoppt.",+ "settings.servicePreview.status.invalidAudio": "Wähle eine unterstützte, nicht leere Audiodatei bis 8 MB.",+ "settings.servicePreview.remoteTask": "Das Stoppen beendet nur das lokale Warten. Bereits angenommene Aufgaben können weiterlaufen und Kosten verursachen.",+ "settings.serviceConfig.findSearch": "Suchkonfiguration finden",+ "settings.serviceConfig.noSearchMatch": "Keine passende Suchkonfiguration.",+ "settings.serviceConfig.noSearch": "Noch keine Suchmaschine konfiguriert.",+ "settings.serviceConfig.selectSearch": "Wähle eine Suchmaschine zum Konfigurieren und Testen.",+ "settings.serviceConfig.defaultSearch": "Standard-Suchmaschine",+ "settings.serviceConfig.renameSearch": "Suchkonfiguration umbenennen",+ "settings.serviceConfig.removeSearch": "Suchkonfiguration entfernen",+ "settings.serviceConfig.voiceServices": "Sprachdienste",+ "settings.providerServices.title": "Verfügbare Diensttypen",+ "settings.providerServices.description": "Integrationen und Live-Metadaten schlagen Diensttypen vor. Du kannst Typen ergänzen oder ausblenden. Wähle den passenden Adapter und teste ein Modell; bestehende Modelle bleiben erhalten.",+ "settings.providerServices.reset": "Erkannte und integrierte Typen verwenden",+ "settings.providerServices.evidence.manual": "Manuell festgelegt",+ "settings.providerServices.evidence.detected": "Aus Modellmetadaten erkannt",+ "settings.providerServices.evidence.builtin": "Integrierter Adapter",+ "settings.providerServices.evidence.unknown": "Nicht erkannt · bei Unterstützung manuell hinzufügen",+ "settings.providerServices.connection": "Verbindung dieses Dienstes",+ "settings.providerServices.adapter": "Dienst-API / Adapter",+ "settings.providerServices.url": "Dienst-URL (optional)",+ "settings.providerServices.inheritUrl": "Anbieter-URL oder Adapterstandard verwenden",+ "settings.providerServices.searchProtocol": "Wähle die Such-API dieses Endpunkts. Suche verwendet kein Sprachmodellprotokoll.",+ "settings.providerServices.protocol": "Sprachmodell-API-Protokoll",+ "settings.providerServices.search": "Anbieter suchen",+ "settings.providerServices.filter": "Anbietertypen filtern",+ "settings.providerServices.filter.all": "Alle",+ "settings.providerServices.filter.multi": "Mehrere Dienste",+ "settings.providerServices.filter.llm": "Sprachmodelle",+ "settings.providerServices.filter.embedding": "Einbettungen",+ "settings.providerServices.filter.voice": "Sprache",+ "settings.providerServices.filter.search": "Suche",+ "settings.providerServices.filter.imagegen": "Bilder",+ "settings.providerServices.filter.videogen": "Video",+ "settings.providerServices.filter.custom": "Eigene",+ "settings.providerServices.customHint": "Eigene URL und unterstütztes API-Protokoll",+ "settings.providerServices.noMatch": "Keine passenden Anbieter. Wähle eine andere Kategorie oder eine eigene Verbindung.",+ "settings.providerServices.name": "Anbietername",+ "settings.providerServices.customDescription": "Die URL muss die gewählte API implementieren. Ergänze danach Zugangsdaten und weitere Diensttypen mit ihren Adaptern.",+ "settings.providerServices.addHint": "Tags zeigen Integrationen, keine Kontoberechtigungen. Eine Verbindung kann mehrere Modelltypen bedienen; Konten und Produkte können getrennte Verbindungen nutzen.",+ "settings.providerServices.catalogListed": "Modellliste geladen. Teste ein Modell, um den Zugriff auf die Inferenz zu prüfen.",+ "settings.providerServices.partial": "Nur ein Teil der Modellliste wurde geladen. Fehlende Typen bleiben unbekannt und können manuell ergänzt werden."}diff --git a/web/locales/en/app.json b/web/locales/en/app.jsonindex f756131fa..3c330e8b4 100644--- a/web/locales/en/app.json+++ b/web/locales/en/app.json@@ -5229,7 +5229,7 @@"kanban.forward": "Move forward","kanban.moveTo": "Move to","kanban.archive": "Archive",- "kanban.footer": "Cards are saved in this workspace. Drag a card or use the arrow buttons to move it.",+ "kanban.footer": "Tasks are saved to your independent board. Assign them to workspaces or link them to conversations.","kanban.loadError": "Could not open the board. Refresh the page.","kanban.saveError": "Could not save the card.","kanban.loading": "Loading task board…",@@ -5334,5 +5334,110 @@"Request timeout (seconds)": "Request timeout (seconds)","Show API token": "Show API token","Hide API token": "Hide API token",- "Failed to link this follow-up chat to its notebook entry.": "Failed to link this follow-up chat to its notebook entry."+ "Failed to link this follow-up chat to its notebook entry.": "Failed to link this follow-up chat to its notebook entry.",+ "tasks.linked": "Linked tasks",+ "tasks.workspace": "Workspace tasks",+ "tasks.assign": "Assign workspace",+ "tasks.unassigned": "Not assigned to a workspace",+ "tasks.search": "Search tasks",+ "tasks.empty": "No matching tasks. Create tasks in the Task Board.",+ "tasks.latestHint": "The most recently linked task controls the conversation’s status color.",+ "tasks.unlink": "Unlink task",+ "tasks.status": "Task status",+ "tasks.openBoard": "Open Task Board",+ "tasks.colors": "Status colors",+ "tasks.color": "Color",+ "tasks.unlinkStatus": "Unlink task status",+ "tasks.linkStatus": "Link task status",+ "tasks.saveError": "Could not save the task change. Please try again.",+ "settings.agentSetup.title": "Let your Agent help you configure",+ "settings.agentSetup.description": "Follow the steps below, or let your own Agent help you configure DeepTutor.",+ "settings.agentSetup.instructions": "Copy this prompt into an Agent with terminal access to your DeepTutor installation, such as Codex or Claude Code.",+ "settings.agentSetup.copy": "Copy prompt",+ "settings.agentSetup.copyFailed": "Could not copy. Select the text above and copy it manually.",+ "settings.agentSetup.prompt": "Help me configure my existing DeepTutor installation: https://github.com/HKUDS/DeepTutor.\nFirst read SKILL.md and docs-for-user/AGENT_SETUP.md in the matching checkout (or in that repository if no local source is available).\nIdentify the installation, version, running instance, account, and runtime home. Reuse my environment and preserve existing files, settings, and pending drafts.\nHelp me connect a provider and select a chat model; configure embedding, search, and other services only as needed. Ask for missing model choices or credential sources; do not ask me to paste API keys into chat or print them.\nFollow the guide and the installed CLI's --help to configure and verify this same instance. Finish with what changed, actual check results, and any remaining steps.",+ "settings.voiceDiscovery.loading": "Fetching voices…",+ "settings.voiceDiscovery.modelFirst": "Choose a model to fetch its voices.",+ "settings.voiceDiscovery.failed": "Could not fetch voices. Check the provider connection and permissions, then retry.",+ "settings.voiceDiscovery.unsupported": "This provider/model has no supported live voice lookup with this connection. You can enter a voice ID from your provider; no built-in voice list is used.",+ "settings.voiceDiscovery.empty": "The provider returned no available voices for this selection.",+ "settings.voiceDiscovery.custom": "Live custom voices for this model. This API does not list system voices. Preview a voice before applying.",+ "settings.voiceDiscovery.account": "Voices returned live by your account. The provider does not filter by model; preview to confirm compatibility.",+ "settings.voiceDiscovery.choose": "Choose a voice",+ "settings.voiceDiscovery.current": "Current voice (not in this result)",+ "settings.voiceDiscovery.manual": "Enter a voice ID manually",+ "settings.serviceConfig.custom": "Show other providers for custom integration",+ "settings.serviceConfig.providers": "Choose a supported provider, then a model. For custom connections, verify that the provider implements the API required by this service.",+ "settings.serviceConfig.search": "Choose a supported search engine. Search uses its own API and does not require a model.",+ "settings.serviceConfig.unsupportedSearch": "This connection has no supported search adapter. Choose a supported search provider.",+ "settings.serviceConfig.video": "Video generation requires task submission, status polling and downloading. A custom endpoint must implement DeepTutor’s video task protocol; a chat-compatible API alone is insufficient.",+ "settings.serviceConfig.discovery": "Model discovery (optional)",+ "settings.serviceConfig.tools": "After applying a default, enable the corresponding tool so chat can use this service.",+ "settings.serviceConfig.openTools": "Manage chat tools",+ "settings.servicePreview.title.search": "Try a search",+ "settings.servicePreview.title.stt": "Try speech recognition",+ "settings.servicePreview.title.imagegen": "Generate a test image",+ "settings.servicePreview.title.videogen": "Generate a test video",+ "settings.servicePreview.description.search": "Search with this draft and inspect the actual results. Your active configuration stays unchanged.",+ "settings.servicePreview.description.stt": "Upload a short speech sample to verify the recognized text. Uses this draft; provider charges may apply.",+ "settings.servicePreview.description.imagegen": "Makes one real generation request using this draft. The provider may charge for the image.",+ "settings.servicePreview.description.videogen": "Submits a real generation request and waits for a playable video, up to 10 minutes. Provider charges may apply.",+ "settings.servicePreview.audio": "Audio sample · WAV, MP3, M4A, WebM, OGG or FLAC · up to 8 MB",+ "settings.servicePreview.query": "Search query",+ "settings.servicePreview.prompt": "Describe what to generate",+ "settings.servicePreview.placeholder.search": "For example: How do solar cells work?",+ "settings.servicePreview.placeholder.imagegen": "For example: A blue book on a white background",+ "settings.servicePreview.placeholder.videogen": "For example: A gentle wave reaching the beach",+ "settings.servicePreview.action.search": "Search",+ "settings.servicePreview.action.stt": "Transcribe sample",+ "settings.servicePreview.action.imagegen": "Generate image",+ "settings.servicePreview.action.videogen": "Generate video",+ "settings.servicePreview.status.requesting": "Sending the test request…",+ "settings.servicePreview.status.rendering": "Task submitted. Waiting for the generated video…",+ "settings.servicePreview.status.success": "Result received. Review it below before applying your settings.",+ "settings.servicePreview.status.empty": "The service responded but returned no content. Try another sample or query.",+ "settings.servicePreview.status.failed": "The test did not return a usable result. Check the connection, model access and service parameters, then retry.",+ "settings.servicePreview.status.timeout": "The test timed out. Check the provider’s task status before submitting another generation request.",+ "settings.servicePreview.status.cancelled": "Test stopped.",+ "settings.servicePreview.status.invalidAudio": "Choose a supported, non-empty audio file of at most 8 MB.",+ "settings.servicePreview.remoteTask": "Stopping this test stops local waiting. A task already accepted by the provider may continue and incur charges.",+ "settings.serviceConfig.findSearch": "Find search configuration",+ "settings.serviceConfig.noSearchMatch": "No search configurations match.",+ "settings.serviceConfig.noSearch": "No search engines configured yet.",+ "settings.serviceConfig.selectSearch": "Select a search engine to configure it and try a search.",+ "settings.serviceConfig.defaultSearch": "Default search engine",+ "settings.serviceConfig.renameSearch": "Rename search configuration",+ "settings.serviceConfig.removeSearch": "Remove search configuration",+ "settings.serviceConfig.voiceServices": "Voice services",+ "settings.providerServices.title": "Available service types",+ "settings.providerServices.description": "Built-in integrations and live model metadata suggest service types. You can add or hide types here. Choose the matching adapter and test a model to verify access; existing models are kept.",+ "settings.providerServices.reset": "Use detected and built-in types",+ "settings.providerServices.evidence.manual": "Set by you",+ "settings.providerServices.evidence.detected": "Detected from model metadata",+ "settings.providerServices.evidence.builtin": "Built-in integration",+ "settings.providerServices.evidence.unknown": "Not detected · add manually if supported",+ "settings.providerServices.connection": "Service connection options",+ "settings.providerServices.adapter": "Service API / adapter",+ "settings.providerServices.url": "Service URL (optional)",+ "settings.providerServices.inheritUrl": "Use the provider URL or adapter default",+ "settings.providerServices.searchProtocol": "Select the search API implemented by this endpoint. Search does not use the language-model protocol.",+ "settings.providerServices.protocol": "Language-model API protocol",+ "settings.providerServices.search": "Search providers",+ "settings.providerServices.filter": "Filter provider types",+ "settings.providerServices.filter.all": "All",+ "settings.providerServices.filter.multi": "Multiple services",+ "settings.providerServices.filter.llm": "Language models",+ "settings.providerServices.filter.embedding": "Embedding",+ "settings.providerServices.filter.voice": "Voice",+ "settings.providerServices.filter.search": "Search",+ "settings.providerServices.filter.imagegen": "Images",+ "settings.providerServices.filter.videogen": "Video",+ "settings.providerServices.filter.custom": "Custom",+ "settings.providerServices.customHint": "Your own URL and supported API protocol",+ "settings.providerServices.noMatch": "No matching providers. Try another category or use a custom connection.",+ "settings.providerServices.name": "Provider name",+ "settings.providerServices.customDescription": "The URL must implement the selected API. On the next step, add credentials and choose any additional service types and their adapters.",+ "settings.providerServices.addHint": "Tags show built-in integrations, not account permissions. One connection can serve several model types; separate accounts and products can have separate connections.",+ "settings.providerServices.catalogListed": "Model list retrieved. Test a specific model to verify inference access.",+ "settings.providerServices.partial": "The provider returned only part of the model list. Missing types remain unknown and can be added manually."}diff --git a/web/locales/fr/app.json b/web/locales/fr/app.jsonindex adcf607be..2c6daed71 100644--- a/web/locales/fr/app.json+++ b/web/locales/fr/app.json@@ -5671,7 +5671,7 @@"kanban.forward": "Avancer","kanban.moveTo": "Déplacer vers","kanban.archive": "Archiver",- "kanban.footer": "Les cartes sont enregistrées dans cet espace de travail. Déplacez-les par glisser-déposer ou avec les boutons fléchés.",+ "kanban.footer": "Les tâches sont conservées dans un tableau indépendant et peuvent être attribuées à des espaces de travail ou associées à des conversations.","kanban.loadError": "Impossible d'ouvrir le tableau. Actualisez la page.","kanban.saveError": "Impossible d'enregistrer la carte.","kanban.loading": "Chargement du tableau…",@@ -5777,5 +5777,110 @@"Fetching the model list does not test speech synthesis. Use Preview voice to test this model and voice.": "Récupérer la liste des modèles ne teste pas la synthèse vocale. Utilisez l’aperçu vocal pour tester ce modèle et cette voix.","Show API token": "Afficher le jeton API","Hide API token": "Masquer le jeton API",- "Failed to link this follow-up chat to its notebook entry.": "Impossible de lier cette conversation de suivi à son entrée dans le carnet."+ "Failed to link this follow-up chat to its notebook entry.": "Impossible de lier cette conversation de suivi à son entrée dans le carnet.",+ "tasks.linked": "Tâches associées",+ "tasks.workspace": "Tâches de l’espace de travail",+ "tasks.assign": "Attribuer un espace de travail",+ "tasks.unassigned": "Sans espace de travail",+ "tasks.search": "Rechercher des tâches",+ "tasks.empty": "Aucune tâche correspondante. Créez des tâches dans le tableau.",+ "tasks.latestHint": "La dernière tâche associée détermine la couleur de la conversation.",+ "tasks.unlink": "Dissocier la tâche",+ "tasks.status": "État de la tâche",+ "tasks.openBoard": "Ouvrir le tableau",+ "tasks.colors": "Couleurs des états",+ "tasks.color": "Couleur",+ "tasks.unlinkStatus": "Dissocier l’état des tâches",+ "tasks.linkStatus": "Associer l’état des tâches",+ "tasks.saveError": "Impossible d’enregistrer la modification. Réessayez.",+ "settings.agentSetup.title": "Laissez votre Agent vous aider à configurer",+ "settings.agentSetup.description": "Suivez les étapes ci-dessous ou confiez la configuration à votre propre Agent.",+ "settings.agentSetup.instructions": "Copiez cette consigne dans un Agent ayant accès au terminal de votre installation DeepTutor, comme Codex ou Claude Code.",+ "settings.agentSetup.copy": "Copier la consigne",+ "settings.agentSetup.copyFailed": "Échec de la copie. Sélectionnez le texte ci-dessus et copiez-le manuellement.",+ "settings.agentSetup.prompt": "Aide-moi à configurer mon installation existante de DeepTutor : https://github.com/HKUDS/DeepTutor.\nLis d’abord SKILL.md et docs-for-user/AGENT_SETUP.md dans les sources de la version correspondante, ou dans ce dépôt si les sources locales sont absentes.\nIdentifie l’installation, la version, l’instance active, le compte et le répertoire d’exécution. Réutilise mon environnement et préserve les fichiers, paramètres et brouillons en attente.\nConnecte un fournisseur et sélectionne un modèle de conversation ; configure les embeddings, la recherche et les autres services selon mes besoins. Demande les choix de modèles ou les sources d’identifiants manquants ; ne me demande pas de coller des clés API dans le chat et ne les affiche pas.\nSuis le guide et l’aide --help de la CLI installée pour configurer et vérifier cette même instance. Termine par les changements, les résultats réels des vérifications et les étapes restantes.",+ "settings.voiceDiscovery.loading": "Chargement des voix…",+ "settings.voiceDiscovery.modelFirst": "Choisissez d’abord un modèle.",+ "settings.voiceDiscovery.failed": "Impossible de charger les voix. Vérifiez la connexion et les autorisations, puis réessayez.",+ "settings.voiceDiscovery.unsupported": "Cette connexion ne permet pas de rechercher les voix en direct. Vous pouvez saisir un identifiant de voix ; aucune liste prédéfinie n’est utilisée.",+ "settings.voiceDiscovery.empty": "Le fournisseur n’a renvoyé aucune voix disponible pour cette sélection.",+ "settings.voiceDiscovery.custom": "Voix personnalisées de ce modèle obtenues en direct. Cette API ne liste pas les voix système. Écoutez avant d’appliquer.",+ "settings.voiceDiscovery.account": "Voix de votre compte obtenues en direct. Le fournisseur ne filtre pas par modèle ; vérifiez la compatibilité par une écoute.",+ "settings.voiceDiscovery.choose": "Choisir une voix",+ "settings.voiceDiscovery.current": "Voix actuelle (absente du résultat)",+ "settings.voiceDiscovery.manual": "Saisir un identifiant de voix",+ "settings.serviceConfig.custom": "Afficher les autres fournisseurs pour une intégration personnalisée",+ "settings.serviceConfig.providers": "Choisissez un fournisseur puis un modèle. Pour une connexion personnalisée, vérifiez la prise en charge de l’API requise.",+ "settings.serviceConfig.search": "Choisissez un moteur de recherche pris en charge. Il utilise sa propre API et ne nécessite aucun modèle.",+ "settings.serviceConfig.unsupportedSearch": "Cette connexion n’a pas d’adaptateur de recherche. Choisissez un fournisseur pris en charge.",+ "settings.serviceConfig.video": "La vidéo nécessite la soumission d’une tâche, le suivi et le téléchargement. Une API personnalisée doit prendre en charge le protocole vidéo de DeepTutor ; une API de chat ne suffit pas.",+ "settings.serviceConfig.discovery": "Découverte des modèles (facultatif)",+ "settings.serviceConfig.tools": "Après application du choix par défaut, activez l’outil correspondant pour le chat.",+ "settings.serviceConfig.openTools": "Gérer les outils du chat",+ "settings.servicePreview.title.search": "Tester la recherche",+ "settings.servicePreview.title.stt": "Tester la transcription",+ "settings.servicePreview.title.imagegen": "Générer une image de test",+ "settings.servicePreview.title.videogen": "Générer une vidéo de test",+ "settings.servicePreview.description.search": "Recherchez avec ce brouillon et examinez les résultats. La configuration active reste inchangée.",+ "settings.servicePreview.description.stt": "Importez un court extrait vocal et vérifiez le texte. Ce test utilise le brouillon ; des frais peuvent s’appliquer.",+ "settings.servicePreview.description.imagegen": "Génère une image réelle avec ce brouillon. Le fournisseur peut facturer la génération.",+ "settings.servicePreview.description.videogen": "Lance une génération réelle et attend une vidéo lisible, jusqu’à 10 minutes. Des frais peuvent s’appliquer.",+ "settings.servicePreview.audio": "Extrait audio · WAV, MP3, M4A, WebM, OGG ou FLAC · 8 Mo max.",+ "settings.servicePreview.query": "Requête de recherche",+ "settings.servicePreview.prompt": "Décrivez le contenu à générer",+ "settings.servicePreview.placeholder.search": "Par exemple : comment fonctionnent les cellules solaires ?",+ "settings.servicePreview.placeholder.imagegen": "Par exemple : un livre bleu sur fond blanc",+ "settings.servicePreview.placeholder.videogen": "Par exemple : une vague douce sur la plage",+ "settings.servicePreview.action.search": "Rechercher",+ "settings.servicePreview.action.stt": "Transcrire l’extrait",+ "settings.servicePreview.action.imagegen": "Générer l’image",+ "settings.servicePreview.action.videogen": "Générer la vidéo",+ "settings.servicePreview.status.requesting": "Envoi de la requête de test…",+ "settings.servicePreview.status.rendering": "Tâche soumise. En attente de la vidéo…",+ "settings.servicePreview.status.success": "Résultat reçu. Vérifiez-le avant d’appliquer les réglages.",+ "settings.servicePreview.status.empty": "Le service a répondu sans contenu. Essayez un autre extrait ou une autre requête.",+ "settings.servicePreview.status.failed": "Aucun résultat exploitable. Vérifiez la connexion, l’accès au modèle et les paramètres, puis réessayez.",+ "settings.servicePreview.status.timeout": "Délai dépassé. Vérifiez l’état de la tâche chez le fournisseur avant de relancer une génération.",+ "settings.servicePreview.status.cancelled": "Test arrêté.",+ "settings.servicePreview.status.invalidAudio": "Choisissez un fichier audio pris en charge, non vide, de 8 Mo maximum.",+ "settings.servicePreview.remoteTask": "L’arrêt met fin à l’attente locale. Une tâche acceptée par le fournisseur peut continuer et être facturée.",+ "settings.serviceConfig.findSearch": "Trouver une configuration de recherche",+ "settings.serviceConfig.noSearchMatch": "Aucune configuration correspondante.",+ "settings.serviceConfig.noSearch": "Aucun moteur de recherche configuré.",+ "settings.serviceConfig.selectSearch": "Sélectionnez un moteur pour le configurer et tester une recherche.",+ "settings.serviceConfig.defaultSearch": "Moteur de recherche par défaut",+ "settings.serviceConfig.renameSearch": "Renommer la configuration",+ "settings.serviceConfig.removeSearch": "Supprimer la configuration",+ "settings.serviceConfig.voiceServices": "Services vocaux",+ "settings.providerServices.title": "Types de services disponibles",+ "settings.providerServices.description": "Les intégrations et métadonnées suggèrent des types de services. Vous pouvez en ajouter ou en masquer. Choisissez l’adaptateur puis testez un modèle ; les modèles existants sont conservés.",+ "settings.providerServices.reset": "Utiliser les types détectés et intégrés",+ "settings.providerServices.evidence.manual": "Défini manuellement",+ "settings.providerServices.evidence.detected": "Détecté dans les métadonnées",+ "settings.providerServices.evidence.builtin": "Intégration disponible",+ "settings.providerServices.evidence.unknown": "Non détecté · à ajouter si pris en charge",+ "settings.providerServices.connection": "Connexion de ce service",+ "settings.providerServices.adapter": "API / adaptateur du service",+ "settings.providerServices.url": "URL du service (facultatif)",+ "settings.providerServices.inheritUrl": "Utiliser l’URL du fournisseur ou celle de l’adaptateur",+ "settings.providerServices.searchProtocol": "Sélectionnez l’API de recherche de cette adresse. La recherche n’utilise pas le protocole des modèles de langage.",+ "settings.providerServices.protocol": "Protocole API du modèle de langage",+ "settings.providerServices.search": "Rechercher un fournisseur",+ "settings.providerServices.filter": "Filtrer les types de fournisseurs",+ "settings.providerServices.filter.all": "Tous",+ "settings.providerServices.filter.multi": "Plusieurs services",+ "settings.providerServices.filter.llm": "Modèles de langage",+ "settings.providerServices.filter.embedding": "Plongements",+ "settings.providerServices.filter.voice": "Voix",+ "settings.providerServices.filter.search": "Recherche",+ "settings.providerServices.filter.imagegen": "Images",+ "settings.providerServices.filter.videogen": "Vidéo",+ "settings.providerServices.filter.custom": "Personnalisé",+ "settings.providerServices.customHint": "Votre URL et un protocole API pris en charge",+ "settings.providerServices.noMatch": "Aucun fournisseur correspondant. Essayez une autre catégorie ou une connexion personnalisée.",+ "settings.providerServices.name": "Nom du fournisseur",+ "settings.providerServices.customDescription": "L’URL doit implémenter l’API choisie. Ajoutez ensuite les identifiants et les autres types de services avec leurs adaptateurs.",+ "settings.providerServices.addHint": "Les étiquettes indiquent les intégrations, pas les autorisations du compte. Une connexion peut servir plusieurs types de modèles ; les comptes et produits peuvent rester séparés.",+ "settings.providerServices.catalogListed": "Liste des modèles obtenue. Testez un modèle pour vérifier l’accès à l’inférence.",+ "settings.providerServices.partial": "Seule une partie de la liste a été obtenue. Les types manquants restent inconnus et peuvent être ajoutés manuellement."}diff --git a/web/locales/pl/app.json b/web/locales/pl/app.jsonindex 5d9d6b3a2..d57b4674b 100644--- a/web/locales/pl/app.json+++ b/web/locales/pl/app.json@@ -5227,7 +5227,7 @@"kanban.forward": "Przenieś dalej","kanban.moveTo": "Przejdź do","kanban.archive": "Archiwizuj",- "kanban.footer": "Karty są zapisywane w tym obszarze roboczym. Przeciągnij kartę lub użyj strzałek, aby ją przesunąć.",+ "kanban.footer": "Zadania są zapisywane na niezależnej tablicy. Można je przypisać do obszarów roboczych lub powiązać z rozmowami.","kanban.loadError": "Nie można otworzyć tablicy. Odśwież stronę.","kanban.saveError": "Nie można zapisać karty.","kanban.loading": "Wczytywanie tablicy zadań…",@@ -5350,5 +5350,110 @@"Fetching the model list does not test speech synthesis. Use Preview voice to test this model and voice.": "Pobranie listy modeli nie sprawdza syntezy mowy. Użyj podglądu głosu, aby przetestować model i głos.","Show API token": "Pokaż token API","Hide API token": "Ukryj token API",- "Failed to link this follow-up chat to its notebook entry.": "Nie udało się powiązać tej rozmowy uzupełniającej z wpisem w notatniku."+ "Failed to link this follow-up chat to its notebook entry.": "Nie udało się powiązać tej rozmowy uzupełniającej z wpisem w notatniku.",+ "tasks.linked": "Powiązane zadania",+ "tasks.workspace": "Zadania obszaru roboczego",+ "tasks.assign": "Przypisz obszar roboczy",+ "tasks.unassigned": "Bez obszaru roboczego",+ "tasks.search": "Szukaj zadań",+ "tasks.empty": "Brak pasujących zadań. Utwórz zadania na tablicy.",+ "tasks.latestHint": "Ostatnio powiązane zadanie określa kolor rozmowy.",+ "tasks.unlink": "Odłącz zadanie",+ "tasks.status": "Stan zadania",+ "tasks.openBoard": "Otwórz tablicę zadań",+ "tasks.colors": "Kolory stanów",+ "tasks.color": "Kolor",+ "tasks.unlinkStatus": "Odłącz stan zadania",+ "tasks.linkStatus": "Powiąż stan zadania",+ "tasks.saveError": "Nie można zapisać zmiany. Spróbuj ponownie.",+ "settings.agentSetup.title": "Pozwól swojemu Agentowi pomóc w konfiguracji",+ "settings.agentSetup.description": "Wykonaj poniższe kroki lub powierz konfigurację własnemu Agentowi.",+ "settings.agentSetup.instructions": "Skopiuj ten prompt do Agenta z dostępem do terminala instalacji DeepTutor, na przykład Codex lub Claude Code.",+ "settings.agentSetup.copy": "Kopiuj prompt",+ "settings.agentSetup.copyFailed": "Kopiowanie nie powiodło się. Zaznacz powyższy tekst i skopiuj go ręcznie.",+ "settings.agentSetup.prompt": "Pomóż mi skonfigurować istniejącą instalację DeepTutor: https://github.com/HKUDS/DeepTutor.\nNajpierw przeczytaj SKILL.md i docs-for-user/AGENT_SETUP.md w źródłach odpowiedniej wersji lub w tym repozytorium, jeśli brak lokalnych źródeł.\nUstal instalację, wersję, uruchomioną instancję, konto i katalog środowiska uruchomieniowego. Wykorzystaj istniejące środowisko i zachowaj pliki, ustawienia oraz niezastosowane wersje robocze.\nPodłącz dostawcę i wybierz model rozmowy; skonfiguruj embeddingi, wyszukiwanie i pozostałe usługi tylko w razie potrzeby. Zapytaj o brakujące wybory modeli lub źródła danych uwierzytelniających; nie proś o wklejanie kluczy API na czacie i nie wyświetlaj ich.\nKorzystaj z przewodnika i --help zainstalowanego CLI, aby skonfigurować i zweryfikować tę samą instancję. Na końcu podaj zmiany, rzeczywiste wyniki kontroli i pozostałe kroki.",+ "settings.voiceDiscovery.loading": "Pobieranie głosów…",+ "settings.voiceDiscovery.modelFirst": "Najpierw wybierz model.",+ "settings.voiceDiscovery.failed": "Nie udało się pobrać głosów. Sprawdź połączenie i uprawnienia, a następnie ponów próbę.",+ "settings.voiceDiscovery.unsupported": "To połączenie nie obsługuje pobierania głosów na żywo. Możesz wpisać identyfikator głosu; nie korzystamy ze stałej listy.",+ "settings.voiceDiscovery.empty": "Dostawca nie zwrócił dostępnych głosów dla tego wyboru.",+ "settings.voiceDiscovery.custom": "Aktualne głosy niestandardowe tego modelu. To API nie zwraca głosów systemowych. Odsłuchaj przed zastosowaniem.",+ "settings.voiceDiscovery.account": "Głosy pobrane z konta. Dostawca nie filtruje według modelu; sprawdź zgodność przez odsłuch.",+ "settings.voiceDiscovery.choose": "Wybierz głos",+ "settings.voiceDiscovery.current": "Obecny głos (poza wynikami)",+ "settings.voiceDiscovery.manual": "Wpisz identyfikator głosu ręcznie",+ "settings.serviceConfig.custom": "Pokaż innych dostawców do własnej integracji",+ "settings.serviceConfig.providers": "Wybierz dostawcę, a potem model. Przy własnym połączeniu sprawdź obsługę wymaganego API.",+ "settings.serviceConfig.search": "Wybierz obsługiwaną wyszukiwarkę. Korzysta ona z własnego API i nie wymaga modelu.",+ "settings.serviceConfig.unsupportedSearch": "To połączenie nie ma adaptera wyszukiwania. Wybierz obsługiwanego dostawcę.",+ "settings.serviceConfig.video": "Generowanie wideo wymaga wysłania zadania, sprawdzania stanu i pobrania. Własny endpoint musi obsługiwać protokół wideo DeepTutor; samo API czatu nie wystarczy.",+ "settings.serviceConfig.discovery": "Wyszukiwanie modeli (opcjonalne)",+ "settings.serviceConfig.tools": "Po zastosowaniu ustawienia domyślnego włącz odpowiednie narzędzie czatu.",+ "settings.serviceConfig.openTools": "Zarządzaj narzędziami czatu",+ "settings.servicePreview.title.search": "Przetestuj wyszukiwanie",+ "settings.servicePreview.title.stt": "Przetestuj rozpoznawanie mowy",+ "settings.servicePreview.title.imagegen": "Wygeneruj obraz testowy",+ "settings.servicePreview.title.videogen": "Wygeneruj film testowy",+ "settings.servicePreview.description.search": "Wyszukaj z tym szkicem i sprawdź wyniki. Aktywna konfiguracja nie zmieni się.",+ "settings.servicePreview.description.stt": "Prześlij krótką próbkę mowy i sprawdź tekst. Test używa szkicu; dostawca może naliczyć opłaty.",+ "settings.servicePreview.description.imagegen": "Generuje jeden rzeczywisty obraz z tym szkicem. Dostawca może naliczyć opłatę.",+ "settings.servicePreview.description.videogen": "Wysyła rzeczywiste zadanie i czeka do 10 minut na film. Dostawca może naliczyć opłatę.",+ "settings.servicePreview.audio": "Próbka audio · WAV, MP3, M4A, WebM, OGG lub FLAC · do 8 MB",+ "settings.servicePreview.query": "Zapytanie",+ "settings.servicePreview.prompt": "Opisz, co wygenerować",+ "settings.servicePreview.placeholder.search": "Na przykład: jak działają ogniwa słoneczne?",+ "settings.servicePreview.placeholder.imagegen": "Na przykład: niebieska książka na białym tle",+ "settings.servicePreview.placeholder.videogen": "Na przykład: łagodna fala docierająca do plaży",+ "settings.servicePreview.action.search": "Szukaj",+ "settings.servicePreview.action.stt": "Transkrybuj próbkę",+ "settings.servicePreview.action.imagegen": "Generuj obraz",+ "settings.servicePreview.action.videogen": "Generuj film",+ "settings.servicePreview.status.requesting": "Wysyłanie żądania testowego…",+ "settings.servicePreview.status.rendering": "Zadanie wysłane. Oczekiwanie na film…",+ "settings.servicePreview.status.success": "Otrzymano wynik. Sprawdź go przed zastosowaniem ustawień.",+ "settings.servicePreview.status.empty": "Usługa odpowiedziała bez treści. Spróbuj innej próbki lub zapytania.",+ "settings.servicePreview.status.failed": "Brak użytecznego wyniku. Sprawdź połączenie, dostęp do modelu i parametry, po czym ponów próbę.",+ "settings.servicePreview.status.timeout": "Przekroczono czas. Sprawdź stan zadania u dostawcy przed kolejną próbą generowania.",+ "settings.servicePreview.status.cancelled": "Test zatrzymany.",+ "settings.servicePreview.status.invalidAudio": "Wybierz obsługiwany, niepusty plik audio do 8 MB.",+ "settings.servicePreview.remoteTask": "Zatrzymanie kończy lokalne oczekiwanie. Zadanie przyjęte przez dostawcę może nadal działać i generować koszty.",+ "settings.serviceConfig.findSearch": "Znajdź konfigurację wyszukiwania",+ "settings.serviceConfig.noSearchMatch": "Brak pasujących konfiguracji.",+ "settings.serviceConfig.noSearch": "Nie skonfigurowano wyszukiwarki.",+ "settings.serviceConfig.selectSearch": "Wybierz wyszukiwarkę do konfiguracji i testu.",+ "settings.serviceConfig.defaultSearch": "Domyślna wyszukiwarka",+ "settings.serviceConfig.renameSearch": "Zmień nazwę konfiguracji wyszukiwania",+ "settings.serviceConfig.removeSearch": "Usuń konfigurację wyszukiwania",+ "settings.serviceConfig.voiceServices": "Usługi głosowe",+ "settings.providerServices.title": "Dostępne typy usług",+ "settings.providerServices.description": "Integracje i metadane sugerują typy usług. Możesz je dodawać lub ukrywać. Wybierz adapter i przetestuj model; istniejące modele pozostaną.",+ "settings.providerServices.reset": "Użyj wykrytych i wbudowanych typów",+ "settings.providerServices.evidence.manual": "Ustawione ręcznie",+ "settings.providerServices.evidence.detected": "Wykryto z metadanych",+ "settings.providerServices.evidence.builtin": "Wbudowana integracja",+ "settings.providerServices.evidence.unknown": "Nie wykryto · dodaj, jeśli obsługiwane",+ "settings.providerServices.connection": "Połączenie tej usługi",+ "settings.providerServices.adapter": "API / adapter usługi",+ "settings.providerServices.url": "Adres usługi (opcjonalnie)",+ "settings.providerServices.inheritUrl": "Użyj adresu dostawcy lub domyślnego adaptera",+ "settings.providerServices.searchProtocol": "Wybierz API wyszukiwania tego adresu. Wyszukiwanie nie używa protokołu modelu językowego.",+ "settings.providerServices.protocol": "Protokół API modelu językowego",+ "settings.providerServices.search": "Szukaj dostawców",+ "settings.providerServices.filter": "Filtruj typy dostawców",+ "settings.providerServices.filter.all": "Wszystkie",+ "settings.providerServices.filter.multi": "Wiele usług",+ "settings.providerServices.filter.llm": "Modele językowe",+ "settings.providerServices.filter.embedding": "Osadzanie",+ "settings.providerServices.filter.voice": "Głos",+ "settings.providerServices.filter.search": "Wyszukiwanie",+ "settings.providerServices.filter.imagegen": "Obrazy",+ "settings.providerServices.filter.videogen": "Wideo",+ "settings.providerServices.filter.custom": "Własne",+ "settings.providerServices.customHint": "Własny adres i obsługiwany protokół API",+ "settings.providerServices.noMatch": "Brak pasujących dostawców. Wybierz inną kategorię lub własne połączenie.",+ "settings.providerServices.name": "Nazwa dostawcy",+ "settings.providerServices.customDescription": "Adres musi implementować wybrane API. Następnie dodaj dane dostępowe oraz dodatkowe typy usług i adaptery.",+ "settings.providerServices.addHint": "Etykiety oznaczają integracje, nie uprawnienia konta. Jedno połączenie może obsługiwać różne modele; konta i produkty mogą mieć osobne połączenia.",+ "settings.providerServices.catalogListed": "Pobrano listę modeli. Przetestuj model, aby sprawdzić dostęp do wnioskowania.",+ "settings.providerServices.partial": "Pobrano tylko część listy. Brakujące typy pozostają nieznane i można je dodać ręcznie."}diff --git a/web/locales/uk/app.json b/web/locales/uk/app.jsonindex 5619c8038..8989eca01 100644--- a/web/locales/uk/app.json+++ b/web/locales/uk/app.json@@ -5244,7 +5244,7 @@"kanban.forward": "Уперед","kanban.moveTo": "Перемістити до","kanban.archive": "Архівувати",- "kanban.footer": "Картки зберігаються в цьому робочому просторі. Перетягніть картку або скористайтеся кнопками зі стрілками.",+ "kanban.footer": "Завдання зберігаються на незалежній дошці. Призначайте їх робочим просторам або пов’язуйте з розмовами.","kanban.loadError": "Не вдалося відкрити дошку. Оновіть сторінку.","kanban.saveError": "Не вдалося зберегти картку.","kanban.loading": "Завантаження дошки завдань…",@@ -5350,5 +5350,110 @@"Fetching the model list does not test speech synthesis. Use Preview voice to test this model and voice.": "Отримання списку моделей не перевіряє синтез мовлення. Скористайтеся попереднім прослуховуванням голосу, щоб перевірити модель і голос.","Show API token": "Показати токен API","Hide API token": "Приховати токен API",- "Failed to link this follow-up chat to its notebook entry.": "Не вдалося пов’язати цей додатковий чат із відповідним записом у нотатнику."+ "Failed to link this follow-up chat to its notebook entry.": "Не вдалося пов’язати цей додатковий чат із відповідним записом у нотатнику.",+ "tasks.linked": "Пов’язані завдання",+ "tasks.workspace": "Завдання робочого простору",+ "tasks.assign": "Призначити робочий простір",+ "tasks.unassigned": "Без робочого простору",+ "tasks.search": "Пошук завдань",+ "tasks.empty": "Немає відповідних завдань. Створіть їх на дошці.",+ "tasks.latestHint": "Останнє пов’язане завдання визначає колір розмови.",+ "tasks.unlink": "Від’єднати завдання",+ "tasks.status": "Стан завдання",+ "tasks.openBoard": "Відкрити дошку завдань",+ "tasks.colors": "Кольори станів",+ "tasks.color": "Колір",+ "tasks.unlinkStatus": "Від’єднати стан завдання",+ "tasks.linkStatus": "Пов’язати стан завдання",+ "tasks.saveError": "Не вдалося зберегти зміну. Спробуйте ще раз.",+ "settings.agentSetup.title": "Нехай ваш Агент допоможе з налаштуванням",+ "settings.agentSetup.description": "Виконайте наведені нижче кроки або доручіть налаштування власному Агенту.",+ "settings.agentSetup.instructions": "Скопіюйте цей запит в Агента з доступом до термінала вашої інсталяції DeepTutor, наприклад Codex або Claude Code.",+ "settings.agentSetup.copy": "Копіювати запит",+ "settings.agentSetup.copyFailed": "Не вдалося скопіювати. Виділіть текст вище та скопіюйте вручну.",+ "settings.agentSetup.prompt": "Допоможи налаштувати мою наявну інсталяцію DeepTutor: https://github.com/HKUDS/DeepTutor.\nСпочатку прочитай SKILL.md і docs-for-user/AGENT_SETUP.md у вихідному коді відповідної версії або в цьому репозиторії, якщо локального коду немає.\nВизнач спосіб встановлення, версію, запущений екземпляр, обліковий запис і робочий каталог середовища виконання. Використовуй наявне середовище, збережи файли, налаштування та незастосовані чернетки.\nПідключи постачальника й вибери модель для розмов; налаштовуй ембеддинги, пошук та інші сервіси за потреби. Запитай про відсутні рішення щодо моделей чи джерела облікових даних; не проси вставляти ключі API в чат і не виводь їх.\nДотримуйся посібника та --help встановленого CLI, щоб налаштувати й перевірити саме цей екземпляр. Наприкінці повідом про зміни, фактичні результати перевірок і решту кроків.",+ "settings.voiceDiscovery.loading": "Завантаження голосів…",+ "settings.voiceDiscovery.modelFirst": "Спочатку виберіть модель.",+ "settings.voiceDiscovery.failed": "Не вдалося отримати голоси. Перевірте підключення та дозволи й повторіть спробу.",+ "settings.voiceDiscovery.unsupported": "Це підключення не підтримує отримання голосів наживо. Можна ввести ID голосу; вбудований список не використовується.",+ "settings.voiceDiscovery.empty": "Постачальник не повернув доступних голосів для цього вибору.",+ "settings.voiceDiscovery.custom": "Власні голоси цієї моделі, отримані наживо. API не повертає системних голосів. Прослухайте перед застосуванням.",+ "settings.voiceDiscovery.account": "Голоси вашого облікового запису. Постачальник не фільтрує їх за моделлю; перевірте сумісність прослуховуванням.",+ "settings.voiceDiscovery.choose": "Виберіть голос",+ "settings.voiceDiscovery.current": "Поточний голос (відсутній у результаті)",+ "settings.voiceDiscovery.manual": "Ввести ID голосу вручну",+ "settings.serviceConfig.custom": "Показати інших постачальників для власного підключення",+ "settings.serviceConfig.providers": "Виберіть постачальника, потім модель. Для власного підключення перевірте підтримку потрібного API.",+ "settings.serviceConfig.search": "Виберіть підтримувану пошукову систему. Вона має власний API і не потребує моделі.",+ "settings.serviceConfig.unsupportedSearch": "Це підключення не має пошукового адаптера. Виберіть підтримуваного постачальника.",+ "settings.serviceConfig.video": "Генерація відео потребує надсилання завдання, перевірки стану та завантаження. Власний API має підтримувати відеопротокол DeepTutor; API чату недостатньо.",+ "settings.serviceConfig.discovery": "Пошук моделей (необов’язково)",+ "settings.serviceConfig.tools": "Після застосування типового налаштування увімкніть відповідний інструмент чату.",+ "settings.serviceConfig.openTools": "Керувати інструментами чату",+ "settings.servicePreview.title.search": "Перевірити пошук",+ "settings.servicePreview.title.stt": "Перевірити розпізнавання мовлення",+ "settings.servicePreview.title.imagegen": "Згенерувати тестове зображення",+ "settings.servicePreview.title.videogen": "Згенерувати тестове відео",+ "settings.servicePreview.description.search": "Виконайте пошук із цією чернеткою та перегляньте результати. Активні налаштування не зміняться.",+ "settings.servicePreview.description.stt": "Завантажте короткий запис мовлення та перевірте текст. Використовується чернетка; можлива оплата постачальнику.",+ "settings.servicePreview.description.imagegen": "Створює одне справжнє зображення з цією чернеткою. Постачальник може стягнути плату.",+ "settings.servicePreview.description.videogen": "Надсилає справжній запит і чекає до 10 хвилин на відео. Можлива оплата постачальнику.",+ "settings.servicePreview.audio": "Аудіозапис · WAV, MP3, M4A, WebM, OGG або FLAC · до 8 МБ",+ "settings.servicePreview.query": "Пошуковий запит",+ "settings.servicePreview.prompt": "Опишіть, що згенерувати",+ "settings.servicePreview.placeholder.search": "Наприклад: як працюють сонячні елементи?",+ "settings.servicePreview.placeholder.imagegen": "Наприклад: синя книга на білому тлі",+ "settings.servicePreview.placeholder.videogen": "Наприклад: лагідна хвиля на пляжі",+ "settings.servicePreview.action.search": "Шукати",+ "settings.servicePreview.action.stt": "Розпізнати запис",+ "settings.servicePreview.action.imagegen": "Створити зображення",+ "settings.servicePreview.action.videogen": "Створити відео",+ "settings.servicePreview.status.requesting": "Надсилання тестового запиту…",+ "settings.servicePreview.status.rendering": "Завдання надіслано. Очікування відео…",+ "settings.servicePreview.status.success": "Результат отримано. Перевірте його перед застосуванням налаштувань.",+ "settings.servicePreview.status.empty": "Сервіс відповів без вмісту. Спробуйте інший запис або запит.",+ "settings.servicePreview.status.failed": "Немає придатного результату. Перевірте підключення, доступ до моделі та параметри й повторіть спробу.",+ "settings.servicePreview.status.timeout": "Час очікування вичерпано. Перевірте стан завдання у постачальника перед новою генерацією.",+ "settings.servicePreview.status.cancelled": "Тест зупинено.",+ "settings.servicePreview.status.invalidAudio": "Виберіть підтримуваний непорожній аудіофайл до 8 МБ.",+ "settings.servicePreview.remoteTask": "Зупинка завершує локальне очікування. Прийняте постачальником завдання може продовжуватися та оплачуватися.",+ "settings.serviceConfig.findSearch": "Знайти налаштування пошуку",+ "settings.serviceConfig.noSearchMatch": "Немає відповідних налаштувань.",+ "settings.serviceConfig.noSearch": "Пошукову систему ще не налаштовано.",+ "settings.serviceConfig.selectSearch": "Виберіть пошукову систему для налаштування та перевірки.",+ "settings.serviceConfig.defaultSearch": "Типова пошукова система",+ "settings.serviceConfig.renameSearch": "Перейменувати налаштування пошуку",+ "settings.serviceConfig.removeSearch": "Видалити налаштування пошуку",+ "settings.serviceConfig.voiceServices": "Голосові сервіси",+ "settings.providerServices.title": "Доступні типи сервісів",+ "settings.providerServices.description": "Інтеграції та метадані пропонують типи сервісів. Їх можна додавати або приховувати. Виберіть адаптер і перевірте модель; наявні моделі зберігаються.",+ "settings.providerServices.reset": "Використати виявлені та вбудовані типи",+ "settings.providerServices.evidence.manual": "Задано вручну",+ "settings.providerServices.evidence.detected": "Виявлено з метаданих",+ "settings.providerServices.evidence.builtin": "Вбудована інтеграція",+ "settings.providerServices.evidence.unknown": "Не виявлено · додайте, якщо підтримується",+ "settings.providerServices.connection": "Підключення цього сервісу",+ "settings.providerServices.adapter": "API / адаптер сервісу",+ "settings.providerServices.url": "Адреса сервісу (необов’язково)",+ "settings.providerServices.inheritUrl": "Використати адресу постачальника або адаптера",+ "settings.providerServices.searchProtocol": "Виберіть пошуковий API цієї адреси. Пошук не використовує протокол мовної моделі.",+ "settings.providerServices.protocol": "Протокол API мовної моделі",+ "settings.providerServices.search": "Пошук постачальників",+ "settings.providerServices.filter": "Фільтрувати типи постачальників",+ "settings.providerServices.filter.all": "Усі",+ "settings.providerServices.filter.multi": "Кілька сервісів",+ "settings.providerServices.filter.llm": "Мовні моделі",+ "settings.providerServices.filter.embedding": "Векторизація",+ "settings.providerServices.filter.voice": "Голос",+ "settings.providerServices.filter.search": "Пошук",+ "settings.providerServices.filter.imagegen": "Зображення",+ "settings.providerServices.filter.videogen": "Відео",+ "settings.providerServices.filter.custom": "Власний",+ "settings.providerServices.customHint": "Власна адреса та підтримуваний протокол API",+ "settings.providerServices.noMatch": "Немає відповідних постачальників. Оберіть іншу категорію або власне підключення.",+ "settings.providerServices.name": "Назва постачальника",+ "settings.providerServices.customDescription": "Адреса має реалізувати вибраний API. Далі додайте облікові дані та інші типи сервісів з адаптерами.",+ "settings.providerServices.addHint": "Позначки показують інтеграції, а не дозволи облікового запису. Одне підключення може обслуговувати різні моделі; облікові записи й продукти можуть мати окремі підключення.",+ "settings.providerServices.catalogListed": "Список моделей отримано. Перевірте конкретну модель, щоб підтвердити доступ до викликів.",+ "settings.providerServices.partial": "Отримано лише частину списку. Відсутні типи залишаються невідомими, їх можна додати вручну."}diff --git a/web/locales/zh/app.json b/web/locales/zh/app.jsonindex df2bc4b3e..bdcca343b 100644--- a/web/locales/zh/app.json+++ b/web/locales/zh/app.json@@ -5229,7 +5229,7 @@"kanban.forward": "向前移动","kanban.moveTo": "移至","kanban.archive": "归档",- "kanban.footer": "卡片保存在当前工作区中。拖动卡片或使用箭头按钮移动。",+ "kanban.footer": "任务保存在独立看板中,可分配到工作区,或关联到对话。","kanban.loadError": "无法打开看板。请刷新页面。","kanban.saveError": "无法保存卡片。","kanban.loading": "正在加载任务看板…",@@ -5334,5 +5334,110 @@"Request timeout (seconds)": "请求超时(秒)","Show API token": "显示 API 令牌","Hide API token": "隐藏 API 令牌",- "Failed to link this follow-up chat to its notebook entry.": "无法将此追问对话关联到对应的笔记条目。"+ "Failed to link this follow-up chat to its notebook entry.": "无法将此追问对话关联到对应的笔记条目。",+ "tasks.linked": "关联任务",+ "tasks.workspace": "工作区任务",+ "tasks.assign": "分配工作区",+ "tasks.unassigned": "未分配工作区",+ "tasks.search": "搜索任务",+ "tasks.empty": "没有匹配的任务,请先在任务看板创建。",+ "tasks.latestHint": "最新关联的任务决定对话的状态颜色。",+ "tasks.unlink": "取消任务关联",+ "tasks.status": "任务状态",+ "tasks.openBoard": "打开任务看板",+ "tasks.colors": "状态颜色",+ "tasks.color": "颜色",+ "tasks.unlinkStatus": "取消任务状态关联",+ "tasks.linkStatus": "关联任务状态",+ "tasks.saveError": "无法保存任务更改,请重试。",+ "settings.agentSetup.title": "让你的 Agent 帮你配置",+ "settings.agentSetup.description": "按下方步骤完成配置,也可以交给你自己的 Agent。",+ "settings.agentSetup.instructions": "复制这段提示词,粘贴给能够通过终端访问 DeepTutor 安装环境的 Agent,例如 Codex 或 Claude Code。",+ "settings.agentSetup.copy": "复制提示词",+ "settings.agentSetup.copyFailed": "复制失败,请选中上方文本手动复制。",+ "settings.agentSetup.prompt": "请帮我配置已经安装的 DeepTutor:https://github.com/HKUDS/DeepTutor。\n先阅读对应版本源码中的 SKILL.md 和 docs-for-user/AGENT_SETUP.md;没有本地源码时,从上述仓库读取指南。\n确认安装方式、版本、正在运行的实例、账号和运行目录,复用现有环境,保留已有文件、设置和待应用的草稿。\n帮我连接提供方并选择对话模型,嵌入模型、搜索等其他服务按需配置。缺少模型选择或凭据来源时再问我,不要让我在聊天中粘贴 API Key,也不要输出密钥。\n根据指南和已安装 CLI 的 --help 完成配置,并验证当前这个实例是否可用。最后告诉我改了什么、实际检查结果和仍需完成的步骤。",+ "settings.voiceDiscovery.loading": "正在获取音色…",+ "settings.voiceDiscovery.modelFirst": "请先选择模型,再获取音色。",+ "settings.voiceDiscovery.failed": "音色获取失败,请检查提供方连接和权限后重试。",+ "settings.voiceDiscovery.unsupported": "当前提供方或模型不支持通过此连接自动获取音色。可填写提供方提供的音色 ID;系统不会使用内置音色表。",+ "settings.voiceDiscovery.empty": "提供方未返回适用于当前选择的音色。",+ "settings.voiceDiscovery.custom": "已实时获取适用于该模型的自定义音色。此接口不返回系统音色,请试听后再应用。",+ "settings.voiceDiscovery.account": "已实时获取账号音色。提供方未按模型筛选,请通过试听确认兼容性。",+ "settings.voiceDiscovery.choose": "选择音色",+ "settings.voiceDiscovery.current": "当前音色(不在本次查询结果中)",+ "settings.voiceDiscovery.manual": "手动填写音色 ID",+ "settings.serviceConfig.custom": "显示其他提供方,用于自定义接入",+ "settings.serviceConfig.providers": "先选择支持此服务的提供方,再选择模型。自定义接入时,请确认提供方支持此服务所需的接口。",+ "settings.serviceConfig.search": "选择已支持的搜索引擎。搜索使用专用接口,无需选择模型。",+ "settings.serviceConfig.unsupportedSearch": "此连接没有可用的搜索适配器,请选择已支持的搜索提供方。",+ "settings.serviceConfig.video": "视频生成需要提交任务、查询进度和下载结果。自定义接口须支持 DeepTutor 的视频任务协议,仅支持聊天接口还不够。",+ "settings.serviceConfig.discovery": "获取模型列表(可选)",+ "settings.serviceConfig.tools": "应用默认配置后,还需启用对应工具,聊天才能调用此服务。",+ "settings.serviceConfig.openTools": "管理聊天工具",+ "settings.servicePreview.title.search": "测试搜索",+ "settings.servicePreview.title.stt": "测试语音识别",+ "settings.servicePreview.title.imagegen": "生成测试图片",+ "settings.servicePreview.title.videogen": "生成测试视频",+ "settings.servicePreview.description.search": "使用当前草稿搜索并查看真实结果,不会更改已生效的配置。",+ "settings.servicePreview.description.stt": "上传一段简短的人声音频,检查识别文字是否正确。使用当前草稿测试,提供方可能收费。",+ "settings.servicePreview.description.imagegen": "使用当前草稿真实生成一张图片,提供方可能收取生成费用。",+ "settings.servicePreview.description.videogen": "提交真实生成任务并等待可播放的视频,最多等待 10 分钟。提供方可能收取生成费用。",+ "settings.servicePreview.audio": "音频样本 · WAV、MP3、M4A、WebM、OGG 或 FLAC · 最大 8 MB",+ "settings.servicePreview.query": "搜索问题",+ "settings.servicePreview.prompt": "描述想要生成的内容",+ "settings.servicePreview.placeholder.search": "例如:太阳能电池是如何工作的?",+ "settings.servicePreview.placeholder.imagegen": "例如:白色背景上的一本蓝色书籍",+ "settings.servicePreview.placeholder.videogen": "例如:轻柔的海浪涌向沙滩",+ "settings.servicePreview.action.search": "搜索",+ "settings.servicePreview.action.stt": "识别音频",+ "settings.servicePreview.action.imagegen": "生成图片",+ "settings.servicePreview.action.videogen": "生成视频",+ "settings.servicePreview.status.requesting": "正在发送测试请求…",+ "settings.servicePreview.status.rendering": "任务已提交,正在等待视频生成完成…",+ "settings.servicePreview.status.success": "已收到结果,请检查后再应用设置。",+ "settings.servicePreview.status.empty": "服务已响应,但未返回内容。请换一段音频或换个问题重试。",+ "settings.servicePreview.status.failed": "测试未返回可用结果。请检查连接、模型权限和服务参数后重试。",+ "settings.servicePreview.status.timeout": "测试等待超时。再次生成前,请先检查提供方的任务状态。",+ "settings.servicePreview.status.cancelled": "已停止测试。",+ "settings.servicePreview.status.invalidAudio": "请选择支持的音频文件,文件不能为空且不得超过 8 MB。",+ "settings.servicePreview.remoteTask": "停止测试会结束本地等待;提供方已接收的任务可能继续运行并产生费用。",+ "settings.serviceConfig.findSearch": "查找搜索配置",+ "settings.serviceConfig.noSearchMatch": "没有匹配的搜索配置。",+ "settings.serviceConfig.noSearch": "尚未配置搜索引擎。",+ "settings.serviceConfig.selectSearch": "选择一个搜索引擎,查看配置并测试搜索。",+ "settings.serviceConfig.defaultSearch": "默认搜索引擎",+ "settings.serviceConfig.renameSearch": "重命名搜索配置",+ "settings.serviceConfig.removeSearch": "移除搜索配置",+ "settings.serviceConfig.voiceServices": "语音服务",+ "settings.providerServices.title": "可用服务类型",+ "settings.providerServices.description": "系统根据内置适配器和实时模型信息提示服务类型。你可以补充或隐藏类型,选择对应接口后测试模型确认可用性;已有模型会保留。",+ "settings.providerServices.reset": "恢复自动与内置类型",+ "settings.providerServices.evidence.manual": "手动设置",+ "settings.providerServices.evidence.detected": "从模型信息中检测到",+ "settings.providerServices.evidence.builtin": "已有内置适配器",+ "settings.providerServices.evidence.unknown": "尚未检测到 · 支持时可手动添加",+ "settings.providerServices.connection": "此服务的接入设置",+ "settings.providerServices.adapter": "服务接口/适配器",+ "settings.providerServices.url": "服务地址(可选)",+ "settings.providerServices.inheritUrl": "使用提供方地址或适配器默认地址",+ "settings.providerServices.searchProtocol": "请选择此地址实际支持的搜索接口。搜索不使用语言模型协议。",+ "settings.providerServices.protocol": "语言模型接口协议",+ "settings.providerServices.search": "搜索提供方",+ "settings.providerServices.filter": "筛选提供方类型",+ "settings.providerServices.filter.all": "全部",+ "settings.providerServices.filter.multi": "综合服务",+ "settings.providerServices.filter.llm": "语言模型",+ "settings.providerServices.filter.embedding": "嵌入",+ "settings.providerServices.filter.voice": "语音",+ "settings.providerServices.filter.search": "搜索",+ "settings.providerServices.filter.imagegen": "图片",+ "settings.providerServices.filter.videogen": "视频",+ "settings.providerServices.filter.custom": "自定义",+ "settings.providerServices.customHint": "自有地址与支持的接口协议",+ "settings.providerServices.noMatch": "没有匹配的提供方,请换个分类或使用自定义接入。",+ "settings.providerServices.name": "提供方名称",+ "settings.providerServices.customDescription": "此地址需要实现所选协议。下一步填写凭据,并按需增加其他服务类型及其适配器。",+ "settings.providerServices.addHint": "标签表示已有内置适配器,不代表账号权限。同一连接可以用于多类模型,不同账号或独立产品也可以分别添加。",+ "settings.providerServices.catalogListed": "已获取模型列表。请测试具体模型,确认账号的实际调用权限。",+ "settings.providerServices.partial": "本次仅获取到部分模型列表。未返回的类型仍视为未知,可手动补充。"}diff --git a/web/tests/provider-registry-workflow.spec.tsx b/web/tests/provider-registry-workflow.spec.tsxindex 390ddfd0d..068c8ba08 100644--- a/web/tests/provider-registry-workflow.spec.tsx+++ b/web/tests/provider-registry-workflow.spec.tsx@@ -19,7 +19,10 @@ import {providerRegistry,providerProbeInput,reconcileRegistrySave,+ providerServiceSupport,+ updateProvider,} from "@/lib/provider-registry";+import { AddProviderPanel } from "@/components/settings/AddProviderPanel";import { modelTestFingerprint } from "@/lib/model-settings";const mocks = vi.hoisted(() => ({@@ -256,33 +259,21 @@ it("search is a flat engine configuration without a fake context or model ID", (expect(screen.queryByLabelText("Model ID")).toBeNull();expect(screen.queryByLabelText("Context length (tokens)")).toBeNull();});-it("offers a provider with no search API and leaves the rejection to the search test", () => {+it("only offers search engines with a supported adapter", () => {live.connections = [xai()];render(<Harness page="search" />);- fireEvent.click(- screen.getByRole("button", { name: "Add search configuration" }),- );+ fireEvent.click(screen.getByRole("button", { name: "Add search configuration" }));const select = screen.getByLabelText("Configured provider");- // Nothing says xAI runs a search API, and that is not a veto either: it is- // offered, grouped apart, and the search test is what rejects it.- expect(within(select).getByRole("option", { name: "xAI" })).toBeTruthy();- fireEvent.change(select, { target: { value: "connection:x" } });- fireEvent.click(screen.getByRole("button", { name: "Continue" }));- const profile = mocks.settings.draft.services.search.profiles.at(-1)!;- // Staged under the vendor's own name: search has no OpenAI-compatible- // fallback, so `custom` here would only hide which engine was meant.- expect(profile.provider).toBe("xai");- expect(- screen.getByRole("region", { name: "Model connection test" }),- ).toBeTruthy();+ expect(within(select).queryByRole("option", { name: "xAI" })).toBeNull();+ expect(within(select).getByRole("option", { name: "Search account" })).toBeTruthy();});-it("offers embedding providers with no adapter on record and leaves the verdict to the test", async () => {+it("offers unverified embedding providers after opting into custom integration", async () => {live.connections = [xai()];render(<Harness page="embedding" />);fireEvent.click(screen.getByRole("button", { name: "Add model" }));const select = screen.getByLabelText("Configured provider");- // Nothing on the backend claims xAI serves embeddings, and that is not a- // veto: it is offered, grouped apart, and settled by the model test.+ expect(within(select).queryByRole("option", { name: "xAI" })).toBeNull();+ fireEvent.click(screen.getByLabelText("settings.serviceConfig.custom"));expect(within(select).getByRole("option", { name: "xAI" })).toBeTruthy();fireEvent.change(select, { target: { value: "connection:x" } });fireEvent.click(screen.getByRole("button", { name: "Continue" }));@@ -449,12 +440,13 @@ it("adds a provider over plain HTTP, where crypto.randomUUID does not exist", ()try {render(<Harness page="providers" />);fireEvent.click(screen.getByRole("button", { name: "Add provider" }));- fireEvent.change(screen.getByLabelText("Provider type"), {- target: { value: "custom" },- });+ fireEvent.click(screen.getByRole("radio", { name: "Custom" }));+ fireEvent.change(screen.getByLabelText("settings.providerServices.name"), { target: { value: "My gateway" } });+ fireEvent.change(screen.getByLabelText("Provider URL"), { target: { value: "http://gateway.test/v1" } });+ fireEvent.change(screen.getByLabelText("settings.providerServices.protocol"), { target: { value: "anthropic" } });fireEvent.click(screen.getByRole("button", { name: "Continue" }));const staged = (mocks.settings.draft.connections ?? []).at(-1)!;- expect(staged).toMatchObject({ provider: "custom", api_key: "" });+ expect(staged).toMatchObject({ provider: "custom", api_key: "", name: "My gateway", base_url: "http://gateway.test/v1", api_format: "anthropic" });expect(staged.id).toMatch(/^conn-[0-9a-f-]{36}$/);expect(screen.getByRole("region", { name: "Provider settings" }),@@ -463,3 +455,64 @@ it("adds a provider over plain HTTP, where crypto.randomUUID does not exist", ()if (webCrypto) webCrypto.randomUUID = original;}});++it("enabling speech on a provider makes it selectable and keeps the chosen service adapter", () => {+ window.history.replaceState(null, "", "/settings/connections?provider=llm%3Alegacy");+ const view = render(<Harness page="providers" />);+ fireEvent.click(screen.getByRole("checkbox", { name: /Text-to-Speech/ }));+ expect(mocks.settings.draft.services.llm.profiles[0].service_overrides?.tts).toEqual({ enabled: true, binding: "custom" });+ view.rerender(<Harness page="voice" />);+ fireEvent.click(screen.getByRole("button", { name: "Add model" }));+ const select = screen.getByLabelText("Configured provider");+ expect(within(select).getByRole("option", { name: "My account" })).toBeTruthy();+ fireEvent.change(select, { target: { value: "llm:legacy" } });+ fireEvent.click(screen.getByRole("button", { name: "Continue" }));+ expect(mocks.settings.draft.services.tts.profiles.at(-1)?.provider_ref).toMatchObject({ service: "llm", profile_id: "legacy", binding: "custom" });+});++it("keeps explicit disabled services out of new model choices even in custom mode", () => {+ live.services.llm.profiles[0].service_overrides = { tts: { enabled: false } };+ render(<Harness page="voice" />);+ fireEvent.click(screen.getByRole("button", { name: "Add model" }));+ fireEvent.click(screen.getByLabelText("settings.serviceConfig.custom"));+ expect(within(screen.getByLabelText("Configured provider")).queryByRole("option", { name: "My account" })).toBeNull();+ expect(live.services.llm.profiles[0].models).toHaveLength(2);+});++it("uses live service metadata while manual choices survive reprobes and credential edits", () => {+ const source = providerRegistry(live)[0];+ source.source.discovery = { status: "connected", models: [], capabilities: [{ category: "tts", evidence: "metadata" }] };+ const providers = { llm: [], tts: [] } as unknown as SettingsContextValue["providers"];+ expect(providerServiceSupport(source, "tts", [], providers)).toEqual({ enabled: true, evidence: "detected" });+ updateProvider(live, source.ref, "service_overrides", { tts: { enabled: false }, stt: { enabled: true, binding: "custom" } });+ expect(source.source.discovery?.status).toBe("connected");+ expect(providerServiceSupport(source, "tts", [], providers)).toEqual({ enabled: false, evidence: "manual" });+ updateProvider(live, source.ref, "api_key", "rotated");+ expect(source.source.discovery).toBeUndefined();+ expect(providerServiceSupport(source, "stt", [], providers)).toEqual({ enabled: true, evidence: "manual" });+});++it("categorizes cross-service providers without duplicating accounts and supports search", () => {+ const props = { options: [+ { value: "a", label: "Aggregate", services: ["llm", "tts"] as const },+ { value: "b", label: "Search only", services: ["search"] as const },+ { value: "custom", label: "Custom", services: [] },+ ].map(p => ({ ...p, services: [...p.services] })), vendor: "", onVendor: vi.fn(), onCreate: vi.fn(), onCancel: vi.fn() };+ render(<AddProviderPanel {...props} />);+ fireEvent.click(screen.getByRole("button", { name: "settings.providerServices.filter.multi" }));+ expect(screen.getByRole("radio", { name: "Aggregate" })).toBeTruthy();+ expect(screen.queryByRole("radio", { name: "Search only" })).toBeNull();+ fireEvent.click(screen.getByRole("button", { name: "settings.providerServices.filter.all" }));+ fireEvent.change(screen.getByRole("searchbox"), { target: { value: "Search only" } });+ expect(screen.getAllByRole("radio")).toHaveLength(1);+ expect(screen.getByRole("radio", { name: "Search only" })).toBeTruthy();+});++it("failed reprobes replace stale discovery instead of retaining a green capability result", async () => {+ mocks.fetch.mockRejectedValue(new Error("network"));+ const onResult = vi.fn();+ render(<RegistryProbe input={{ binding: "custom", base_url: "https://gateway.test/v1" }} discovery={{ status: "connected", models: [{ id: "old" }] }} onResult={onResult} />);+ fireEvent.click(screen.getByRole("button", { name: "Test provider" }));+ await waitFor(() => expect(onResult).toHaveBeenCalledWith(expect.objectContaining({ status: "unreachable", models: [] })));+ expect(screen.queryByText("settings.providerServices.catalogListed")).toBeNull();+});diff --git a/web/tests/settings-agent-setup.spec.tsx b/web/tests/settings-agent-setup.spec.tsxnew file mode 100644index 000000000..4ecd9c4f0--- /dev/null+++ b/web/tests/settings-agent-setup.spec.tsx@@ -0,0 +1,63 @@+import { fireEvent, render, screen, waitFor } from "@testing-library/react";+import { beforeEach, describe, expect, it, vi } from "vitest";+import AgentSetupHelp from "@/components/settings/AgentSetupHelp";+import { copyText } from "@/lib/clipboard";+import en from "@/locales/en/app.json";+import zh from "@/locales/zh/app.json";++let locale: Record<string, string> = en;+vi.mock("react-i18next", () => ({+ useTranslation: () => ({ t: (key: string) => locale[key] ?? key }),+}));+vi.mock("@/lib/clipboard", () => ({ copyText: vi.fn() }));++beforeEach(() => {+ locale = en;+ vi.mocked(copyText).mockReset();+});++describe("Agent setup handoff", () => {+ it("copies the complete displayed guide and restores focus on Escape", async () => {+ vi.mocked(copyText).mockResolvedValue(undefined);+ render(<AgentSetupHelp />);+ const trigger = screen.getByRole("button", { name: en["settings.agentSetup.title"] });+ trigger.focus();+ fireEvent.click(trigger);+ const prompt = screen.getByRole("textbox") as HTMLTextAreaElement;+ expect(prompt).toHaveAttribute("readonly");+ expect(prompt.value).toContain("docs-for-user/AGENT_SETUP.md");+ expect(prompt.value).toContain("existing DeepTutor installation");+ expect(prompt.value).toContain("pending drafts");+ fireEvent.click(screen.getByRole("button", { name: en["settings.agentSetup.copy"] }));+ await waitFor(() => expect(screen.getByRole("status")).toHaveTextContent(en.Copied));+ expect(copyText).toHaveBeenCalledWith(prompt.value);+ fireEvent.keyDown(prompt, { key: "Escape" });+ expect(screen.queryByRole("dialog")).not.toBeInTheDocument();+ expect(trigger).toHaveFocus();+ });++ it("keeps the prompt selectable and allows retry when clipboard access fails", async () => {+ vi.mocked(copyText).mockRejectedValueOnce(new Error("Clipboard blocked"));+ render(<AgentSetupHelp />);+ fireEvent.click(screen.getByRole("button", { name: en["settings.agentSetup.title"] }));+ const copy = screen.getByRole("button", { name: en["settings.agentSetup.copy"] });+ fireEvent.click(copy);+ await waitFor(() => expect(screen.getByRole("status")).toHaveTextContent(en["settings.agentSetup.copyFailed"]));+ const prompt = screen.getByRole("textbox") as HTMLTextAreaElement;+ fireEvent.focus(prompt);+ expect(prompt.selectionEnd - prompt.selectionStart).toBe(prompt.value.length);+ vi.mocked(copyText).mockResolvedValueOnce(undefined);+ fireEvent.click(copy);+ await waitFor(() => expect(screen.getByRole("status")).toHaveTextContent(en.Copied));+ });++ it("shows and copies the Chinese prompt when the interface is Chinese", async () => {+ locale = zh;+ vi.mocked(copyText).mockResolvedValue(undefined);+ render(<AgentSetupHelp />);+ fireEvent.click(screen.getByRole("button", { name: zh["settings.agentSetup.title"] }));+ expect(screen.getByRole("textbox")).toHaveValue(zh["settings.agentSetup.prompt"]);+ fireEvent.click(screen.getByRole("button", { name: zh["settings.agentSetup.copy"] }));+ await waitFor(() => expect(copyText).toHaveBeenCalledWith(zh["settings.agentSetup.prompt"]));+ });+});diff --git a/web/tests/settings-service-preview.spec.tsx b/web/tests/settings-service-preview.spec.tsxnew file mode 100644index 000000000..b750de1a6--- /dev/null+++ b/web/tests/settings-service-preview.spec.tsx@@ -0,0 +1,112 @@+import React from 'react'+import { act, fireEvent, render, screen, waitFor } from '@testing-library/react'+import { beforeEach, expect, it, vi } from 'vitest'+import { ServicePreviewPanel } from '@/components/settings/ServicePreviewPanel'+import { VoiceDiscoveryField } from '@/components/settings/VoiceDiscoveryField'+import type { Catalog } from '@/lib/model-catalog-types'+const mock = vi.hoisted(() => ({ draft: {} as Catalog, fetch: vi.fn() }))+vi.mock('@/features/settings/store/SettingsStore', () => ({ useSettings: () => ({ draft: mock.draft }) }))+vi.mock('@/lib/api', () => ({ apiUrl: (s: string) => s, apiFetch: (...args: unknown[]) => mock.fetch(...args) }))+vi.mock('react-i18next', () => ({ useTranslation: () => ({ t: (s: string) => s }) }))+const profile = { id: 'p', name: 'Provider', binding: 'minimax', api_version: '', api_key: 'secret', base_url: 'https://example.test', models: [{ id: 'm', name: 'Model', model: 'test-model', voice: 'saved' }] }+function stream(events: object[]) {+ return { ok: true, body: new ReadableStream({ start(c) { for (const event of events) c.enqueue(new TextEncoder().encode(JSON.stringify(event) + '\n')); c.close() } }) }+}+beforeEach(() => {+ mock.fetch.mockReset()+ mock.draft = { version: 1, connections: [], services: Object.fromEntries(['llm','task','embedding','search','tts','stt','imagegen','videogen'].map(s => [s, { active_profile_id: 'old', active_model_id: 'old', profiles: [structuredClone(profile)] }])) } as unknown as Catalog+ URL.createObjectURL = vi.fn(() => 'blob:result')+ URL.revokeObjectURL = vi.fn()+})++it('loads live voices, preserves a saved ID and refreshes from the provider', async () => {+ mock.fetch.mockResolvedValue({ ok: true, json: async () => ({ status: 'ready', scope: 'account', voices: [{ id: 'live', label: 'Live voice' }] }) })+ const update = vi.fn()+ render(<VoiceDiscoveryField profileId="p" modelId="m" value="saved" update={update} disabled={false} />)+ await screen.findByRole('option', { name: 'Live voice' })+ expect(update).not.toHaveBeenCalled()+ fireEvent.change(screen.getByLabelText('settings.voiceDiscovery.choose'), { target: { value: 'live' } })+ expect(update).toHaveBeenCalledWith('live')+ fireEvent.click(screen.getByText('Refresh'))+ await waitFor(() => expect(mock.fetch).toHaveBeenCalledTimes(2))+ await screen.findByRole('option', { name: 'Live voice' })+})++it('ignores late voice results after switching models and retains manual entry', async () => {+ let resolve!: (v: unknown) => void+ mock.fetch.mockReturnValueOnce(new Promise(r => { resolve = r }))+ const update = vi.fn()+ const { rerender } = render(<VoiceDiscoveryField profileId="p" modelId="m" value="saved" update={update} disabled={false} />)+ await waitFor(() => expect(mock.fetch).toHaveBeenCalledTimes(1))+ const signal = mock.fetch.mock.calls[0][1].signal+ mock.draft = structuredClone(mock.draft)+ mock.draft.services.tts.profiles[0].models[0].model = 'other'+ mock.fetch.mockResolvedValue({ ok: true, json: async () => ({ status: 'unsupported', voices: [], scope: 'none' }) })+ rerender(<VoiceDiscoveryField profileId="p" modelId="m" value="saved" update={update} disabled={false} />)+ await screen.findByText('settings.voiceDiscovery.unsupported')+ expect(signal.aborted).toBe(true)+ await act(async () => resolve({ ok: true, json: async () => ({ status: 'ready', voices: [{ id: 'stale', label: 'Stale voice' }], scope: 'account' }) }))+ expect(screen.queryByRole('option', { name: 'Stale voice' })).toBeNull()+ fireEvent.click(screen.getByText('settings.voiceDiscovery.manual'))+ fireEvent.change(screen.getByLabelText('Voice ID'), { target: { value: 'manual-voice' } })+ expect(update).toHaveBeenCalledWith('manual-voice')+})++it('distinguishes voice failure from an empty live list and allows retry', async () => {+ mock.fetch.mockResolvedValueOnce({ ok: false }).mockResolvedValueOnce({ ok: true, json: async () => ({ status: 'ready', voices: [], scope: 'account' }) })+ render(<VoiceDiscoveryField profileId="p" modelId="m" value="" update={vi.fn()} disabled={false} />)+ await screen.findByText('settings.voiceDiscovery.failed')+ fireEvent.click(screen.getByText('Refresh'))+ await screen.findByText('settings.voiceDiscovery.empty')+})++it('searches the addressed draft and renders safe result links without applying', async () => {+ mock.fetch.mockResolvedValue(stream([{ type: 'result', kind: 'search', text: '', results: [{ title: 'Result', url: 'https://example.org', snippet: 'Found' }, { title: 'Unsafe', url: 'javascript:alert(1)', snippet: '' }] }]))+ render(<ServicePreviewPanel service="search" profile={profile} />)+ fireEvent.change(screen.getByLabelText('settings.servicePreview.query'), { target: { value: 'a real question' } })+ fireEvent.click(screen.getByRole('button', { name: 'settings.servicePreview.action.search' }))+ await screen.findByRole('link', { name: 'Result' })+ expect(screen.queryByRole('link', { name: 'Unsafe' })).toBeNull()+ const sent = JSON.parse(mock.fetch.mock.calls[0][1].body)+ expect(sent.profile_id).toBe('p')+ expect(sent.text).toBe('a real question')+ expect(sent.catalog.services.search.active_profile_id).toBe('old')+})++it('shows completed image output and releases it on parameter change', async () => {+ mock.fetch.mockResolvedValue(stream([{ type: 'result', kind: 'image', data: btoa('image'), content_type: 'image/png' }]))+ const { rerender } = render(<ServicePreviewPanel service="imagegen" profile={profile} model={profile.models[0]} />)+ fireEvent.change(screen.getByLabelText('settings.servicePreview.prompt'), { target: { value: 'test image' } })+ fireEvent.click(screen.getByRole('button', { name: 'settings.servicePreview.action.imagegen' }))+ await screen.findByRole('img', { name: 'test image' })+ mock.draft = structuredClone(mock.draft)+ mock.draft.services.imagegen.profiles[0].models[0].model = 'other'+ rerender(<ServicePreviewPanel service="imagegen" profile={profile} model={profile.models[0]} />)+ expect(URL.revokeObjectURL).toHaveBeenCalledWith('blob:result')+ expect(screen.queryByRole('img')).toBeNull()+})++it('video submission remains running until media is returned and can be cancelled', async () => {+ let source!: ReadableStreamDefaultController<Uint8Array>+ mock.fetch.mockResolvedValue({ ok: true, body: new ReadableStream({ start(c) { source = c } }) })+ const { unmount } = render(<ServicePreviewPanel service="videogen" profile={profile} model={profile.models[0]} />)+ fireEvent.change(screen.getByLabelText('settings.servicePreview.prompt'), { target: { value: 'a wave' } })+ fireEvent.click(screen.getByRole('button', { name: 'settings.servicePreview.action.videogen' }))+ await act(async () => { source.enqueue(new TextEncoder().encode('{"type":"progress","phase":"rendering"}\n')) })+ expect(screen.getByText('settings.servicePreview.status.rendering')).toBeTruthy()+ expect(screen.queryByText('settings.servicePreview.status.success')).toBeNull()+ fireEvent.click(screen.getByRole('button', { name: 'Cancel' }))+ expect(mock.fetch.mock.calls[0][1].signal.aborted).toBe(true)+ expect(screen.getByText('settings.servicePreview.status.cancelled')).toBeTruthy()+ await act(async () => source.close())+ unmount()+})++it('uploads real audio and displays its transcript', async () => {+ mock.fetch.mockResolvedValue(stream([{ type: 'result', kind: 'transcript', text: 'Hello from the recording' }]))+ render(<ServicePreviewPanel service="stt" profile={profile} model={profile.models[0]} />)+ fireEvent.change(screen.getByLabelText('settings.servicePreview.audio'), { target: { files: [new File(['spoken audio'], 'speech.wav', { type: 'audio/wav' })] } })+ fireEvent.click(screen.getByRole('button', { name: 'settings.servicePreview.action.stt' }))+ await screen.findByText('Hello from the recording')+ expect(JSON.parse(mock.fetch.mock.calls[0][1].body).audio).toBe(btoa('spoken audio'))+})diff --git a/web/tests/task-board.spec.tsx b/web/tests/task-board.spec.tsxindex 074f8d55e..f3777396d 100644--- a/web/tests/task-board.spec.tsx+++ b/web/tests/task-board.spec.tsx@@ -1,7 +1,8 @@import { act, fireEvent, render, screen, waitFor, within } from '@testing-library/react'import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'+import TaskBoardRuntime from '@/components/tasks/TaskBoardRuntime'import KanbanPage from '@/app/(workspace)/kanban/page'-import type { TaskBoard } from '@/lib/task-board-api'+import { DEFAULT_TASK_COLORS, type TaskBoard } from '@/lib/task-board-api'import translations from '@/locales/en/app.json'vi.mock('react-i18next', () => ({@@ -14,14 +15,15 @@ let board: TaskBoardlet failSave: booleanbeforeEach(() => {- board = { cards: [] }+ board = { cards: [], colors: DEFAULT_TASK_COLORS, session_links: [], revision: 0 }failSave = falsewindow.history.replaceState({}, '', '/kanban?dt_workspace=study')vi.stubGlobal('fetch',vi.fn(async (input: string, init?: RequestInit) => {const url = new URL(input, window.location.origin)- expect(url.searchParams.get('dt_workspace')).toBe('study')+ if (url.pathname.includes('/settings/workspace/registrations')) return Response.json({ workspaces: [] })+ expect(url.searchParams.get('dt_workspace')).toBeNull()expect(init?.credentials).toBe('include')if (init?.method === 'POST') {if (failSave) return Response.json({}, { status: 500 })@@ -30,6 +32,7 @@ beforeEach(() => {id: 'task-1',title: payload.title,note: '',+ workspace_id: null,status: 'todo',archived: false,created_at: '2026-01-01',@@ -39,6 +42,7 @@ beforeEach(() => {if (failSave) return Response.json({}, { status: 500 })board.cards[0] = { ...board.cards[0], ...JSON.parse(String(init.body)) }}+ if (init?.method) board.revision++return Response.json(board)}))@@ -60,7 +64,7 @@ async function addTask() {describe('Task Board', () => {it('creates, edits, moves, archives and restores cards through the scoped API', async () => {- render(<KanbanPage />)+ render(<TaskBoardRuntime><KanbanPage /></TaskBoardRuntime>)await addTask()fireEvent.click(screen.getByRole('button', { name: 'Review derivatives' }))fireEvent.change(screen.getByRole('textbox', { name: 'Task note' }), {@@ -87,7 +91,7 @@ describe('Task Board', () => {})it('moves a dragged card and reads it again after remounting', async () => {- const view = render(<KanbanPage />)+ const view = render(<TaskBoardRuntime><KanbanPage /></TaskBoardRuntime>)await addTask()const dataTransfer = { setData: vi.fn(), effectAllowed: '' }fireEvent.dragStart(screen.getByRole('article'), { dataTransfer })@@ -98,7 +102,7 @@ describe('Task Board', () => {).toBeInTheDocument())view.unmount()- render(<KanbanPage />)+ render(<TaskBoardRuntime><KanbanPage /></TaskBoardRuntime>)await waitFor(() =>expect(within(screen.getByRole('region', { name: 'Done' })).getByText('Review derivatives')@@ -107,7 +111,7 @@ describe('Task Board', () => {})it('keeps the draft and existing card when saving fails', async () => {- render(<KanbanPage />)+ render(<TaskBoardRuntime><KanbanPage /></TaskBoardRuntime>)await addTask()fireEvent.click(screen.getByRole('button', { name: 'Review derivatives' }))fireEvent.change(screen.getByRole('textbox', { name: 'Task note' }), {@@ -122,13 +126,16 @@ describe('Task Board', () => {it('disables creation during loading and lets a failed load retry', async () => {let rejectLoad!: (error: Error) => void- vi.mocked(fetch).mockImplementationOnce(- () =>- new Promise((_resolve, reject) => {- rejectLoad = reject- })- )- render(<KanbanPage />)+ const normalFetch = vi.mocked(fetch).getMockImplementation()!+ let firstLoad = true+ vi.mocked(fetch).mockImplementation((input, init) => {+ if (firstLoad && new URL(String(input), window.location.origin).pathname === '/api/task-board' && !init?.method) {+ firstLoad = false+ return new Promise((_resolve, reject) => { rejectLoad = reject })+ }+ return normalFetch(input, init)+ })+ render(<TaskBoardRuntime><KanbanPage /></TaskBoardRuntime>)expect(screen.getByRole('status')).toHaveTextContent('Loading task board')expect(screen.getByRole('button', { name: 'Add' })).toBeDisabled()await act(async () => rejectLoad(new Error('Offline')))diff --git a/web/tests/task-links.spec.tsx b/web/tests/task-links.spec.tsxnew file mode 100644index 000000000..4a106e806--- /dev/null+++ b/web/tests/task-links.spec.tsx@@ -0,0 +1,211 @@+import { act, fireEvent, render, screen, waitFor } from '@testing-library/react'+import { beforeEach, afterEach, describe, expect, it, vi } from 'vitest'+import TaskBoardRuntime from '@/components/tasks/TaskBoardRuntime'+import TaskLinkSelector from '@/components/tasks/TaskLinkSelector'+import TaskPanelSection from '@/components/tasks/TaskPanelSection'+import { SessionAvatar } from '@/components/sidebar/SessionAvatar'+import {+ DEFAULT_TASK_COLORS,+ publishTaskBoard,+ sessionTaskColor,+ type TaskBoard,+} from '@/lib/task-board-api'+import translations from '@/locales/en/app.json'+import OrganizedSessionList from '@/components/courses/OrganizedSessionList'++vi.mock('react-i18next', () => ({+ useTranslation: () => ({+ t: (key: string) => (translations as Record<string, string>)[key] ?? key,+ i18n: { language: 'en' },+ }),+}))+let board: TaskBoard+let source: { onmessage?: (event: { data: string }) => void; close: ReturnType<typeof vi.fn> }+beforeEach(() => {+ window.history.replaceState({}, '', '/chat/chat?dt_workspace=study')+ board = {+ cards: [+ {+ id: 'one',+ title: 'First task',+ note: 'First note',+ status: 'todo',+ archived: false,+ workspace_id: null,+ created_at: '',+ updated_at: '',+ },+ {+ id: 'two',+ title: 'Second task',+ note: '',+ status: 'done',+ archived: false,+ workspace_id: null,+ created_at: '',+ updated_at: '',+ },+ {+ id: 'workspace',+ title: 'Shared workspace task',+ note: '',+ status: 'doing',+ archived: false,+ workspace_id: 'study',+ created_at: '',+ updated_at: '',+ },+ ],+ colors: { ...DEFAULT_TASK_COLORS },+ session_links: [],+ revision: 1,+ }+ vi.stubGlobal(+ 'EventSource',+ class {+ onmessage?: (event: { data: string }) => void+ close = vi.fn()+ constructor() {+ source = this+ }+ }+ )+ vi.stubGlobal(+ 'fetch',+ vi.fn(async (input: string, init?: RequestInit) => {+ const path = new URL(input, window.location.origin).pathname+ if (init?.method === 'PUT') {+ const payload = JSON.parse(String(init.body))+ board.session_links = [+ {+ session_id: 'chat',+ workspace_id: payload.workspace_id,+ task_ids: payload.task_ids,+ status_link_enabled: true,+ },+ ]+ board.revision+++ } else if (init?.method === 'PATCH' && path.endsWith('/status')) {+ board.session_links[0].status_link_enabled = JSON.parse(String(init.body)).enabled+ board.revision+++ } else if (init?.method === 'PATCH') {+ Object.assign(+ board.cards.find(card => path.endsWith(card.id))!,+ JSON.parse(String(init.body))+ )+ board.revision+++ }+ return Response.json(board)+ })+ )+})+afterEach(() => {+ vi.unstubAllGlobals()+ window.history.replaceState({}, '', '/')+})+function show(mark: 'idle' | 'running' = 'idle') {+ return render(+ <TaskBoardRuntime>+ <TaskLinkSelector sessionId="chat" workspaceId="study" />+ <TaskPanelSection sessionId="chat" />+ <SessionAvatar sessionId="chat" workspaceId="study" mark={mark} />+ </TaskBoardRuntime>+ )+}+function color(view: ReturnType<typeof render>) {+ return view.container.querySelector('svg circle')?.closest('svg')?.style.color+}++describe('task conversation integration', () => {+ it('links multiple tasks, shows them separately and follows the latest task in streamed updates', async () => {+ const view = show()+ await screen.findByRole('combobox', { name: 'Shared workspace task: Task status' })+ const first = await screen.findByRole('checkbox', { name: /First task/ })+ fireEvent.click(first)+ await screen.findByRole('combobox', { name: 'First task: Task status' })+ expect(color(view)).toBe('rgb(37, 99, 235)')+ fireEvent.click(screen.getByRole('checkbox', { name: /Second task/ }))+ await screen.findByRole('combobox', { name: 'Second task: Task status' })+ expect(color(view)).toBe('rgb(21, 128, 61)')+ await act(async () => {+ board.cards[1].status = 'doing'+ board.colors.doing = '#112233'+ board.revision+++ source.onmessage?.({ data: JSON.stringify(board) })+ })+ expect(color(view)).toBe('rgb(17, 34, 51)')+ expect(screen.getByRole('combobox', { name: 'Second task: Task status' })).toHaveValue('doing')+ fireEvent.click(screen.getByRole('button', { name: 'Second task: Unlink task' }))+ await waitFor(() =>+ expect(+ screen.queryByRole('combobox', { name: 'Second task: Task status' })+ ).not.toBeInTheDocument()+ )+ expect(color(view)).toBe('rgb(37, 99, 235)')+ })+ it('lets the sidebar menu stop status sync without removing the task references', async () => {+ board.session_links = [+ { session_id: 'chat', workspace_id: 'study', task_ids: ['one'], status_link_enabled: true },+ ]+ render(+ <TaskBoardRuntime>+ <OrganizedSessionList+ sessions={[+ {+ id: 'chat',+ session_id: 'chat',+ title: 'Study chat',+ created_at: 1,+ updated_at: 1,+ message_count: 0,+ last_message: '',+ content_workspace_id: 'study',+ },+ ]}+ courses={[]}+ activeSessionId="chat"+ onSelect={vi.fn()}+ onRename={vi.fn()}+ onDelete={vi.fn()}+ onOrganize={vi.fn()}+ />+ <TaskPanelSection sessionId="chat" />+ </TaskBoardRuntime>+ )+ await screen.findByRole('combobox', { name: 'First task: Task status' })+ fireEvent.click(screen.getByRole('button', { name: 'Conversation actions' }))+ fireEvent.click(screen.getByRole('menuitem', { name: 'Unlink task status' }))+ await waitFor(() => expect(board.session_links[0].status_link_enabled).toBe(false))+ expect(screen.getByRole('combobox', { name: 'First task: Task status' })).toBeInTheDocument()+ expect(sessionTaskColor(board, 'chat', 'study')).toBeUndefined()+ })+ it('preserves the live orb while running, ignores stale responses and closes the stream', async () => {+ board.session_links = [+ { session_id: 'chat', workspace_id: 'study', task_ids: ['one'], status_link_enabled: true },+ ]+ const view = show('running')+ await screen.findByRole('combobox', { name: 'First task: Task status' })+ expect(color(view)).toBe('')+ const latest = structuredClone(board)+ latest.revision = 5+ latest.cards[0].status = 'done'+ await act(async () => {+ source.onmessage?.({ data: JSON.stringify(latest) })+ publishTaskBoard({ ...board, revision: 2 })+ })+ expect(screen.getByRole('combobox', { name: 'First task: Task status' })).toHaveValue('done')+ view.unmount()+ expect(source.close).toHaveBeenCalledOnce()+ })+ it('keeps draft associations local until the conversation exists', async () => {+ const onDraftChange = vi.fn()+ render(+ <TaskBoardRuntime>+ <TaskLinkSelector workspaceId="study" draftTaskIds={[]} onDraftChange={onDraftChange} />+ </TaskBoardRuntime>+ )+ fireEvent.click(await screen.findByRole('checkbox', { name: /First task/ }))+ expect(onDraftChange).toHaveBeenCalledWith(['one'])+ expect(vi.mocked(fetch).mock.calls.every(([, init]) => !init?.method)).toBe(true)+ })+})diff --git a/web/tests/voice-settings.spec.tsx b/web/tests/voice-settings.spec.tsxindex f95b175d4..9fb6a1a7b 100644--- a/web/tests/voice-settings.spec.tsx+++ b/web/tests/voice-settings.spec.tsx@@ -128,6 +128,7 @@ function Harness({ workspace = false, timeout }: { workspace?: boolean; timeout?}beforeEach(() => {mock.fetch.mockReset()+ mock.fetch.mockResolvedValue({ ok: true, json: async () => ({ status: 'unsupported', scope: 'none', voices: [] }) })mock.notify.mockReset()vi.stubGlobal('matchMedia', () => ({ matches: false }))URL.createObjectURL = vi.fn(() => 'blob:preview')@@ -140,7 +141,7 @@ it('selects model families without inventing voices for unknown models', () => {expect(voiceModelOptions(options, 'private-model')?.voices).toEqual([])})-it('shows provider-specific voices, speed and language choices and accepts private IDs', () => {+it('shows speech parameters without exposing bundled voice choices', () => {const update = vi.fn()render(<VoiceModelFields@@ -153,13 +154,9 @@ it('shows provider-specific voices, speed and language choices and accepts privadisabled={false}/>)- expect(screen.getByRole('option', { name: 'Vivi 2.0' })).toBeTruthy()+ expect(screen.queryByRole('option', { name: 'Vivi 2.0' })).toBeNull()expect(screen.queryByRole('option', { name: 'Sisi 1.0' })).toBeNull()expect(screen.getByRole('spinbutton', { name: 'Speech speed' }).getAttribute('max')).toBe('2')- fireEvent.change(screen.getByRole('combobox', { name: 'Voice ID' }), {- target: { value: 'private-speaker' },- })- expect(update).toHaveBeenCalledWith('voice', 'private-speaker')fireEvent.change(screen.getByRole('spinbutton', { name: 'Request timeout (seconds)' }), {target: { value: '180' },})@@ -187,21 +184,20 @@ it('shows the Qwen-Audio voice, regional guidance and documentation for the seledisabled={false}/>)- expect(screen.getByRole('combobox', { name: 'Suggested voice' })).toHaveValue('longanlingxin')+ expect(screen.queryByRole('combobox', { name: 'Suggested voice' })).toBeNull()expect(screen.getByText(preset.configuration_note)).toBeTruthy()expect(screen.getByRole('link', { name: 'Provider voice documentation' })).toHaveAttribute('href', preset.docs_url)expect(screen.getByText(/Fetching the model list does not test speech synthesis/)).toBeTruthy()})-it('switching model updates an incompatible preset voice and clears unsupported instructions', async () => {+it('switching model preserves an explicit voice without substituting a static voice', async () => {render(<Harness workspace />)fireEvent.click(screen.getByRole('button', { name: /Draft voice/ }))fireEvent.change(screen.getByRole('combobox', { name: 'Model \/ resource ID' }), {target: { value: 'seed-tts-1.0' },})- expect((screen.getByRole('combobox', { name: 'Voice ID' }) as HTMLInputElement).value).toBe(- 'sisi-v1'- )+ expect(mock.settings.draft.services.tts.profiles[0].models[1].voice).toBe('vivi-v2')+ await waitFor(() => expect(screen.getByText('settings.voiceDiscovery.unsupported')).toBeTruthy())expect(screen.queryByRole('textbox', { name: 'Voice instructions' })).toBeNull()expect(mock.settings.draft.services.tts.active_model_id).toBe('old')})