qwen-agent-server 0.11.1

package/README.md

@@ -0,0 +1,211 @@
+# qwen-agent-server
+
+Stateful MCP supervisor that exposes a local Qwen Code inference stack as a
+set of MCP tools. Stateful chat surface — `qwen_spawn`, `qwen_poll`,
+`qwen_send`, `qwen_stop`, `qwen_sessions` — manages long-lived `@qwen-code/sdk`
+sessions per task. Stateless single-turn — `qwen_oneshot`,
+`qwen_oneshot_vision` — for operator-dispatch shapes. Non-chat —
+`qwen_embed`, `qwen_rerank`, `qwen_tokenize` — POST direct to backend
+endpoints (bypass the SDK pipeline which is text-only). Lifecycle / introspection —
+`qwen_backends`, `qwen_extensions`, `qwen_reload_extensions`. See the top-level
+[README's MCP tools table](../../README.md#mcp-tools) for full per-tool detail.
+
+The server is intentionally minimal: it is a thin supervisor layer, not a
+framework. All inference happens inside Qwen Code via the SDK; the server's
+job is session lifecycle, backend routing, and the canUseTool permission gate.
+See `docs/rdr/RDR-001` for the full architecture rationale.
+
+---
+
+## Quick start
+
+**Step 1 — start the inference backend**
+
+```bash
+./scripts/start-stack.sh
+```
+
+This launches llama-server on `localhost:8080` running `qwen3.6-27b-instruct`.
+The health endpoint at `http://localhost:8080/health` must return 200 before
+the server can route traffic.
+
+**Step 2 — build and install**
+
+```bash
+./scripts/setup-qwen-agent-server.sh
+```
+
+Idempotent. Runs `npm install` + `npm run build`, creates the Qwen home
+directory (`~/.qwen-agent-server-home` by default), and prints the
+registration command.
+
+**Step 3 — register with Claude Code**
+
+Copy and run the registration command printed by the setup script:
+
+```bash
+claude mcp add --scope user qwen-agent-server \
+  "node /path/to/repo/mcp-bridges/qwen-agent-server/dist/server.js"
+```
+
+After registration, `qwen_spawn`, `qwen_poll`, `qwen_send`, `qwen_stop`,
+and `qwen_backends` appear in Claude Code's MCP tool list.
+
+---
+
+## Configuration
+
+All configuration is via environment variables passed to the server process.
+The setup script and registration command can be prefixed with these.
+
+| Variable | Default | Description |
+|---|---|---|
+| `QWEN_BACKENDS` | `[{"id":"local","url":"http://localhost:8080/v1","model":"qwen3.6-27b-instruct","tier":"local","capacity":"heavy"}]` | JSON array of `Backend` objects (see `src/types.ts`). Each entry requires `id`, `url`, `model`, `tier` (`"local"` or `"remote"`), `capacity` (`"fast"` or `"heavy"`). Optional: `weight` (default 1). |
+| `QWEN_SUPERVISOR_MAX_SESSIONS` | `3` | Maximum concurrent active sessions. `qwen_spawn` returns an error if the cap is reached. |
+| `QWEN_SUPERVISOR_IDLE_TTL_MS` | `1800000` | Milliseconds before an idle session (no `qwen_poll` activity) is evicted. Default = 30 minutes. |
+| `ROUTER_HEAVY_THRESHOLD_TOKENS` | `2000` | Estimated token count above which the router prefers a `capacity:heavy` backend. |
+| `ROUTER_HEAVY_KEYWORDS` | `prove,derive,architect,design` | Comma-separated prompt keywords that trigger routing to a `capacity:heavy` backend regardless of token count. |
+
+Example with a remote Strix Halo box (Tailscale-reachable) joined to the
+local Mac backend:
+
+```bash
+QWEN_BACKENDS='[
+  {"id":"local-mac","url":"http://localhost:8080/v1","model":"qwen3.6-27b-instruct","tier":"local","capacity":"fast"},
+  {"id":"strix","url":"http://your-strix-host:1234/v1","model":"qwen3.6-35b-a3b","tier":"remote","capacity":"heavy"}
+]' \
+  claude mcp add --scope user qwen-agent-server \
+  "node /path/to/repo/mcp-bridges/qwen-agent-server/dist/server.js"
+```
+
+The router prefers `capacity:heavy` for prompts over
+`ROUTER_HEAVY_THRESHOLD_TOKENS` or containing
+`ROUTER_HEAVY_KEYWORDS`, falling back to `capacity:fast`. The `model`
+field must match what `/v1/models` returns from each backend (for
+llama-server it's the `--alias` value; for LM Studio it's the loaded
+GGUF's identifier).
+
+---
+
+## Extensions
+
+Per-spawn Qwen Code extension loadout (RDR-002). The orchestrator chooses
+which extensions are active for each session via `qwen_spawn`'s
+`opts.extensions` field. The SDK doesn't expose `extensions` in
+`QueryOptions` directly — the supervisor bridges by setting
+`pathToQwenExecutable` to a wrapper script (`scripts/qwen-extensions-wrapper.sh`)
+that reads `QWEN_AGENT_EXTENSIONS` from env and prepends `--extensions <list>`
+to the CLI's argv.
+
+**Startup resolution.** The supervisor resolves the real `qwen` binary
+once at startup. `QWEN_REAL_BIN` (env override, verified to exist and be
+executable) takes precedence; otherwise `which qwen` is consulted. Either
+miss is a fail-fast non-zero exit — an operator who hasn't installed Qwen
+Code can't recover at first spawn, only by fixing the install.
+
+**Per-spawn semantics.** `opts.extensions` accepts three optional
+sub-fields:
+
+| Field | Effect |
+|---|---|
+| `only: ['a','b']` | Exact-set semantics. `enable` and `disable` are ignored in this branch. Empty `only: []` disables all extensions for the spawn (`--extensions none`). |
+| `enable: ['c']` | Additively unions onto the session-default base. |
+| `disable: ['a']` | Subtractively removes from the session-default base after `enable`. `disable` wins on overlap. |
+
+The session-default base is `QWEN_DEFAULT_EXTENSIONS` (a comma-list) when
+set, otherwise the CLI's defaults (all enabled per
+`extension-enablement.json`) — in which case the wrapper drops the
+`--extensions` flag and the CLI inherits its own behaviour. Because the
+supervisor cannot enumerate the implicit set, `enable`/`disable` without
+either `QWEN_DEFAULT_EXTENSIONS` or `only` is rejected with a
+`spawn_error` envelope rather than silently producing the wrong set.
+
+Example — pin a session to one extension:
+
+```jsonc
+// qwen_spawn input
+{
+  "task": "Refactor the auth module",
+  "opts": { "extensions": { "only": ["serena"] } }
+}
+```
+
+Names match `config.name` from each extension's `qwen-extension.json`,
+case-insensitive. Resolved unknown names produce a
+`{ error: { code: "spawn_error", message: "unknown extension(s): X" } }`
+envelope and no session is instantiated.
+
+**Cache + reload.** The supervisor caches the installed-extension name
+list at startup by parsing `qwen extensions list` output. Drain semantics
+apply: in-flight sessions retain whatever set was resolved at their spawn
+time; cache reloads only affect future spawns. Operators who install or
+uninstall extensions while the supervisor is running can pick up the
+change via the `qwen_reload_extensions` MCP tool. (Pre-v0.3 this was
+gated behind `QWEN_ADMIN_TOOLS=1`; the gate was removed when the slash-
+command surface took over operator-facing privileged ops — the tool is
+now registered unconditionally whenever an extensions cache is wired,
+which is always in `main()`.) See RDR-002 §Resolution-algorithm and
+§Installed-extensions cache for the full design.
+
+| Variable | Default | Description |
+|---|---|---|
+| `QWEN_REAL_BIN` | (resolved via `which qwen`) | Override for the real Qwen Code binary path. Verified at startup. |
+| `QWEN_DEFAULT_EXTENSIONS` | unset (CLI defaults apply) | Comma-list of extension names that the supervisor uses as the session-default base when `opts.extensions.only` is unset. |
+
+---
+
+## SDK pin policy
+
+`@qwen-code/sdk` is pinned **exact** to `0.1.7` in `package.json`. This is
+intentional and must not be bumped without running the integration test suite
+against a live backend.
+
+**Why exact?** RDR-001 §Q1 documents that the deny-with-message path
+(`{ behavior: 'deny', message: '<answer>' }` in `canUseTool`) is the proven
+mechanism by which `ask_user_question` answers are delivered back to the model.
+This is empirically verified (see `/tmp/qwen-sdk-probe/probe.mjs`, Spike B,
+2026-05-04) but is not part of the SDK's public API contract. A patch or minor
+release could silently change it.
+
+Similarly, KV-cache affinity depends on the SDK preserving context across turns
+within one `query()` call. The session layer pins `session.backend` at
+construction and never reassigns it (§Q3 KV-cache affinity) — but an SDK
+change to connection management could break cache locality invisibly.
+
+**Gate before bumping:**
+
+```bash
+# 1. Ensure llama-server is running
+curl -sf http://localhost:8080/health
+
+# 2. Run the integration suite
+cd mcp-bridges/qwen-agent-server
+npm run test:integration
+```
+
+If **any** of the three SDK pin assertions fail, do **not** bump the SDK.
+File a report against RDR-001 and investigate whether the fallback paths
+documented there cover the regression before proceeding.
+
+The three pin tests are in
+`tests/integration/sdk-behavior.test.ts`.
+
+---
+
+## Development
+
+```bash
+cd mcp-bridges/qwen-agent-server
+
+# Unit tests (no backend required)
+npm test
+
+# Integration tests (requires llama-server on :8080)
+npm run test:integration
+
+# Build
+npm run build
+
+# Run directly (after build)
+node dist/server.js
+```

package/dist/backends.js

@@ -0,0 +1,444 @@
+// SPDX-License-Identifier: MIT
+//
+// Backend pool, routing heuristic, and cached health probe.
+//
+// Pure-logic-plus-fetch — NO @qwen-code/sdk dependency. The supervisor
+// (session.ts) consumes Backend objects from chooseBackend() and uses
+// them to configure SDK queries; this module never imports the SDK or
+// touches session state.
+//
+// See RDR-001 §Routing for the 6-step algorithm and §Q4 for cap/idle
+// rationale (cap/idle live in server.ts; this module only routes).
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { createLogger } from "./log.js";
+const log = createLogger("qwen-backends");
+/**
+ * On-disk config file resolved at `~/.qwen-coprocessor-stack/config.json`.
+ *
+ * Supports a hot-reload pattern: callers re-invoke their reader on each
+ * spawn / health probe; we cache the parsed object by mtime and re-parse
+ * only when the file changes. Existing sessions stay pinned to their
+ * backend (RDR-001 §Q3) — only future spawns see the updated list.
+ *
+ * Schema (object form, forward-extensible):
+ *
+ *   {
+ *     "backends": [
+ *       { "id": "...", "url": "...", "model": "...",
+ *         "tier": "local" | "remote",
+ *         "capacity": "fast" | "heavy",
+ *         "weight": 1 }
+ *     ],
+ *     "default_extensions": ["serena", "context7"]
+ *   }
+ *
+ * Resolution priorities (highest first):
+ *   - backends:           QWEN_BACKENDS env → config.backends → DEFAULT_BACKEND
+ *   - default extensions: QWEN_DEFAULT_EXTENSIONS env → config.default_extensions → "leave-defaults"
+ */
+/** Default config dir; tests and operators can override via QWEN_CONFIG_DIR env var. */
+const DEFAULT_CONFIG_DIR = join(homedir(), ".qwen-coprocessor-stack");
+export function getConfigDir() {
+    const override = process.env["QWEN_CONFIG_DIR"];
+    return override && override.trim() !== "" ? override : DEFAULT_CONFIG_DIR;
+}
+export function getConfigPath() {
+    return join(getConfigDir(), "config.json");
+}
+let _configCache = null;
+/** Test-only: drop the cached config so the next read re-parses. */
+export function _resetConfigCache() {
+    _configCache = null;
+}
+/**
+ * Read the full config file, mtime-cached. Returns the parsed object on
+ * success, or null when the file doesn't exist / is unreadable / fails
+ * to parse. A non-null return doesn't imply any field is populated;
+ * consumers check the field they need.
+ */
+export function readConfig() {
+    const path = getConfigPath();
+    if (!existsSync(path))
+        return null;
+    let mtimeMs;
+    try {
+        mtimeMs = statSync(path).mtimeMs;
+    }
+    catch {
+        return null;
+    }
+    if (_configCache && _configCache.mtimeMs === mtimeMs) {
+        return _configCache.parsed;
+    }
+    try {
+        const raw = readFileSync(path, "utf8");
+        const parsed = JSON.parse(raw);
+        _configCache = { mtimeMs, parsed };
+        return parsed;
+    }
+    catch (err) {
+        log.warn({ event_type: "config_invalid", path, err: err instanceof Error ? err.message : String(err) }, "config.json present but unreadable; falling through to env / default");
+        _configCache = { mtimeMs, parsed: null };
+        return null;
+    }
+}
+function readConfigBackends() {
+    const cfg = readConfig();
+    if (!cfg || !Array.isArray(cfg.backends) || cfg.backends.length === 0)
+        return null;
+    return cfg.backends;
+}
+const DEFAULT_MAX_CONTEXT_TOKENS = 111_000;
+const DEFAULT_MAX_TOOL_CALLS = 0;
+const CTX_SIZE_HEADROOM = 0.85;
+function parseNumericEnv(name, env) {
+    const raw = env[name];
+    if (raw === undefined || raw.trim() === "")
+        return null;
+    const n = Number.parseInt(raw, 10);
+    if (!Number.isFinite(n) || n < 0) {
+        log.warn({ event_type: "config_invalid", source: "env", var: name, raw }, "env var ignored: not a non-negative integer");
+        return null;
+    }
+    return n;
+}
+export function getSessionBudgetDefaults(env = process.env, backend) {
+    const cfg = readConfig();
+    const cfgBudget = cfg?.session_budget;
+    const envMaxCtx = parseNumericEnv("QWEN_MAX_CONTEXT_TOKENS", env);
+    const cfgMaxCtx = typeof cfgBudget?.max_context_tokens === "number" && cfgBudget.max_context_tokens >= 0
+        ? cfgBudget.max_context_tokens
+        : null;
+    const backendDerivedCtx = backend !== undefined && typeof backend.ctx_size === "number" && backend.ctx_size > 0
+        ? Math.floor(backend.ctx_size * CTX_SIZE_HEADROOM)
+        : null;
+    const envMaxCalls = parseNumericEnv("QWEN_MAX_TOOL_CALLS", env);
+    const cfgMaxCalls = typeof cfgBudget?.max_tool_calls === "number" && cfgBudget.max_tool_calls >= 0
+        ? cfgBudget.max_tool_calls
+        : null;
+    return {
+        max_context_tokens: envMaxCtx ?? cfgMaxCtx ?? backendDerivedCtx ?? DEFAULT_MAX_CONTEXT_TOKENS,
+        max_tool_calls: envMaxCalls ?? cfgMaxCalls ?? DEFAULT_MAX_TOOL_CALLS,
+    };
+}
+/**
+ * Read `default_extensions` from the config file. Returns null when the
+ * field is unset or empty so callers can fall through to the next
+ * resolution tier.
+ */
+export function readConfigDefaultExtensions() {
+    const cfg = readConfig();
+    if (!cfg || !Array.isArray(cfg.default_extensions) || cfg.default_extensions.length === 0) {
+        return null;
+    }
+    return cfg.default_extensions;
+}
+// ─────────────────────────────────────────────────────────────────
+// Configuration
+const DEFAULT_BACKEND = {
+    id: "local-27b",
+    url: "http://localhost:8080/v1",
+    model: "qwen3.6-27b-instruct",
+    tier: "local",
+    capacity: "fast",
+};
+const HEALTH_TTL_MS = 30_000;
+const COLD_PROBE_TIMEOUT_MS = 2_000;
+const HEAVY_KEYWORDS_DEFAULT = "prove,derive,architect,design";
+const HEAVY_THRESHOLD_DEFAULT = 2_000;
+/**
+ * Refresh `pool.backends` in-place from `loadBackends()`. Mutates the
+ * existing array reference (splice) so any callers that captured a
+ * reference at pool construction time see the new list.
+ *
+ * Safe to call on every spawn / health probe — the env read is cheap
+ * and the file read is mtime-cached. Existing sessions stay pinned to
+ * their backend (RDR-001 §Q3); only future spawns and health listings
+ * see the updated list.
+ */
+export function refreshPoolBackends(pool) {
+    const fresh = loadBackends();
+    pool.backends.splice(0, pool.backends.length, ...fresh);
+}
+/**
+ * Read the active backend list, with hot-reload semantics.
+ *
+ * Resolution priority:
+ *   1. QWEN_BACKENDS env var — back-compat / shell override
+ *   2. ~/.qwen-coprocessor-stack/config.json `backends` array
+ *   3. DEFAULT_BACKEND fallback
+ *
+ * Invalid JSON at either source is logged as a warning and the next
+ * tier is consulted. The config file is mtime-cached so re-invocation
+ * on every spawn is cheap (one stat + maybe one parse).
+ */
+export function loadBackends() {
+    // 1. env override
+    const raw = process.env["QWEN_BACKENDS"];
+    if (raw && raw.trim() !== "") {
+        try {
+            const parsed = JSON.parse(raw);
+            if (Array.isArray(parsed) && parsed.length > 0) {
+                return parsed;
+            }
+        }
+        catch {
+            log.warn({ event_type: "config_invalid", source: "env" }, "QWEN_BACKENDS is not valid JSON; falling through to config file / default");
+        }
+    }
+    // 2. config file
+    const fromFile = readConfigBackends();
+    if (fromFile)
+        return fromFile;
+    // 3. default
+    return [DEFAULT_BACKEND];
+}
+// ─────────────────────────────────────────────────────────────────
+// Capacity classification
+/**
+ * Approx token count via a 1.3× word-count heuristic, floored by a
+ * chars/4 estimate so whitespace-poor inputs (base64 blobs, minified
+ * code, packed JSON) don't silently classify as fast when they're
+ * actually heavy. The chars/4 floor matches the budget enforcer's
+ * estimate so routing and budgeting agree on input size.
+ * NOT tiktoken — the threshold is a routing hint, not a billing
+ * number. (Round-2 critique bead 1m4.)
+ */
+export function approxTokens(text) {
+    const trimmed = text?.trim() ?? "";
+    if (trimmed === "")
+        return 0;
+    const wordEstimate = trimmed.split(/\s+/).length * 1.3;
+    const charEstimate = trimmed.length / 4;
+    return Math.round(Math.max(wordEstimate, charEstimate));
+}
+/**
+ * Classify a prompt into 'fast' or 'heavy'. Heavy if either:
+ *  - approx token count ≥ ROUTER_HEAVY_THRESHOLD_TOKENS (default 2000), or
+ *  - prompt matches any keyword in ROUTER_HEAVY_KEYWORDS (default
+ *    "prove,derive,architect,design"); whole-word case-insensitive.
+ */
+export function classifyCapacity(prompt) {
+    const threshold = parseInt(process.env["ROUTER_HEAVY_THRESHOLD_TOKENS"] ?? String(HEAVY_THRESHOLD_DEFAULT), 10);
+    if (approxTokens(prompt) >= threshold)
+        return "heavy";
+    const kwRaw = process.env["ROUTER_HEAVY_KEYWORDS"] ?? HEAVY_KEYWORDS_DEFAULT;
+    const keywords = kwRaw.split(",").map((k) => k.trim().toLowerCase()).filter(Boolean);
+    if (keywords.length === 0)
+        return "fast";
+    const lower = prompt.toLowerCase();
+    for (const kw of keywords) {
+        const re = new RegExp(`\\b${kw.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\b`, "i");
+        if (re.test(lower))
+            return "heavy";
+    }
+    return "fast";
+}
+const healthCache = new Map();
+const refreshInFlight = new Set();
+/** Test-only helper to clear all health state. */
+export function resetHealthCache() {
+    healthCache.clear();
+    refreshInFlight.clear();
+    rrCounters.clear();
+}
+/** Fire one /health probe (or /v1/models fallback) with a hard timeout.
+ *
+ *  llama-server exposes /health at the host root (NOT under /v1), so we
+ *  derive a host base by stripping the /v1 suffix. The OpenAI-compat
+ *  /v1/models endpoint is the secondary probe — works across more
+ *  backends but is heavier than /health.
+ */
+export async function probeHealth(backend) {
+    const probeUrl = async (url, timeoutMs) => {
+        const ac = new AbortController();
+        const t = setTimeout(() => ac.abort(), timeoutMs);
+        try {
+            const r = await fetch(url, { method: "GET", signal: ac.signal });
+            return r.ok;
+        }
+        catch {
+            return false;
+        }
+        finally {
+            clearTimeout(t);
+        }
+    };
+    const baseUrl = stripTrailingSlash(backend.url);
+    const hostBase = baseUrl.replace(/\/v1$/, "");
+    // Prefer llama-server /health at the host root.
+    if (await probeUrl(`${hostBase}/health`, COLD_PROBE_TIMEOUT_MS))
+        return true;
+    // Fall back to OpenAI-compat /v1/models — universally available on any
+    // OpenAI-shaped backend.
+    if (await probeUrl(`${baseUrl}/models`, COLD_PROBE_TIMEOUT_MS))
+        return true;
+    return false;
+}
+function stripTrailingSlash(s) {
+    return s.endsWith("/") ? s.slice(0, -1) : s;
+}
+/**
+ * Cache-aware health lookup.
+ *
+ * - Fresh cache (within TTL): return synchronously.
+ * - Stale cache: return cached value, kick off a background refresh.
+ * - No cache: SYNC PROBE with 2s timeout, store result. On timeout, store
+ *   `null` so the next call re-probes (rather than caching false and
+ *   refusing to ever try again).
+ *
+ * "null" is treated as healthy by chooseBackend (optimistic) so unprobed
+ * backends aren't permanently excluded.
+ */
+export async function getCachedHealth(backend) {
+    const now = Date.now();
+    const cached = healthCache.get(backend.id);
+    if (cached && now - cached.probed_at < HEALTH_TTL_MS) {
+        return cached.healthy;
+    }
+    if (cached) {
+        // Stale — return current value, refresh in background
+        if (!refreshInFlight.has(backend.id)) {
+            refreshInFlight.add(backend.id);
+            void (async () => {
+                try {
+                    const fresh = await probeHealth(backend);
+                    healthCache.set(backend.id, { healthy: fresh, probed_at: Date.now() });
+                }
+                finally {
+                    refreshInFlight.delete(backend.id);
+                }
+            })();
+        }
+        return cached.healthy;
+    }
+    // Cold — probe inline with timeout
+    try {
+        const fresh = await probeHealth(backend);
+        healthCache.set(backend.id, { healthy: fresh, probed_at: now });
+        return fresh;
+    }
+    catch {
+        // Treat unexpected probe failure as "unknown" — allow re-probe next call
+        healthCache.set(backend.id, { healthy: null, probed_at: now });
+        return null;
+    }
+}
+/** Test-only helper: pre-seed the health cache. */
+export function _seedHealth(backend_id, healthy) {
+    healthCache.set(backend_id, { healthy, probed_at: Date.now() });
+}
+// ─────────────────────────────────────────────────────────────────
+// Round-robin / weighted selection
+const rrCounters = new Map();
+function roundRobin(key, candidates) {
+    if (candidates.length === 0) {
+        throw new Error("roundRobin called with empty candidates");
+    }
+    // Weighted? Expand into a virtual list; otherwise plain RR.
+    const totalWeight = candidates.reduce((s, b) => s + (b.weight ?? 1), 0);
+    if (candidates.some((b) => b.weight !== undefined)) {
+        const i = (rrCounters.get(key) ?? 0) % totalWeight;
+        rrCounters.set(key, i + 1);
+        let cum = 0;
+        for (const b of candidates) {
+            cum += b.weight ?? 1;
+            if (i < cum)
+                return b;
+        }
+        return candidates[candidates.length - 1];
+    }
+    const i = (rrCounters.get(key) ?? 0) % candidates.length;
+    rrCounters.set(key, i + 1);
+    return candidates[i];
+}
+// ─────────────────────────────────────────────────────────────────
+// Routing
+/**
+ * Apply the 6-step routing algorithm. Returns a Backend or null if no
+ * candidate is available (caller surfaces this as state: "error").
+ *
+ * `healthy_lookup` is injectable for tests; production passes
+ * `getCachedHealth`. The function is async because health may need
+ * a sync probe on first call.
+ */
+export async function chooseBackend(pool, opts, prompt, healthy_lookup = getCachedHealth) {
+    if (pool.length === 0)
+        return null;
+    // 1. Explicit pin — caller knows best, bypass all filters
+    if (opts.backend) {
+        const pinned = pool.find((b) => b.id === opts.backend);
+        return pinned ?? null;
+    }
+    // 1b. Chat-compatibility filter — qwen_spawn / qwen_oneshot go
+    // through /v1/chat/completions, which embedding/rerank backends
+    // do not implement. Unset modality is treated as 'text'; both
+    // 'text' and 'multimodal' are accepted (multimodal models can
+    // serve text-only chat). See bead qwen-coprocessor-stack-w63.
+    const chatPool = pool.filter((b) => {
+        const m = b.modality ?? "text";
+        // vision_only multimodal backends are dedicated to qwen_oneshot_vision
+        // and excluded from text chat (so a vision model doesn't absorb coding
+        // traffic meant for the text pool). See Backend.vision_only.
+        if (m === "multimodal" && b.vision_only === true)
+            return false;
+        return m === "text" || m === "multimodal";
+    });
+    if (chatPool.length === 0)
+        return null;
+    // 2. Tier filter
+    let candidates = opts.tier ? chatPool.filter((b) => b.tier === opts.tier) : [...chatPool];
+    if (candidates.length === 0)
+        candidates = [...chatPool]; // tier mismatch: fall back
+    // 3. Capacity classification + filter
+    const capacity = opts.capacity ?? classifyCapacity(prompt);
+    const capFiltered = candidates.filter((b) => b.capacity === capacity);
+    // If no backend has the desired capacity, allow any — better to serve
+    // sub-optimally than to fail.
+    if (capFiltered.length > 0)
+        candidates = capFiltered;
+    // 4. Health filter
+    const healthChecks = await Promise.all(candidates.map(async (b) => ({ b, healthy: await healthy_lookup(b) })));
+    // Treat null (unprobed/timeout) as healthy — optimistic; first real
+    // call will mark it false if the backend's actually down.
+    const live = healthChecks.filter((h) => h.healthy !== false).map((h) => h.b);
+    if (live.length > 0) {
+        // 5. Round-robin / weighted
+        return roundRobin(`${opts.tier ?? "any"}:${capacity}`, live);
+    }
+    // 6. No survivors after health: fall back to local (chat-compatible only)
+    const local = chatPool.filter((b) => b.tier === "local");
+    const localHealthy = await Promise.all(local.map(async (b) => ({ b, healthy: await healthy_lookup(b) })));
+    const localLive = localHealthy.filter((h) => h.healthy !== false).map((h) => h.b);
+    if (localLive.length > 0)
+        return roundRobin("fallback:local", localLive);
+    return null;
+}
+/**
+ * Select a backend by declared modality. Used by `qwen_embed`,
+ * `qwen_rerank`, and `qwen_tokenize` — none of which go through the
+ * SDK / chat-completions path, so tier+capacity routing doesn't apply.
+ *
+ * - If `pinned_id` is supplied, return that backend iff it exists; the
+ *   caller validates the modality match and surfaces `wrong_modality`.
+ * - Otherwise filter by `wanted` (treating unset modality as `'text'`),
+ *   then round-robin across healthy candidates. `null` → no match.
+ */
+export async function chooseBackendByModality(pool, wanted, pinned_id, healthy_lookup = getCachedHealth) {
+    if (pool.length === 0)
+        return null;
+    if (pinned_id !== undefined) {
+        return pool.find((b) => b.id === pinned_id) ?? null;
+    }
+    const candidates = pool.filter((b) => (b.modality ?? "text") === wanted);
+    if (candidates.length === 0)
+        return null;
+    const healthChecks = await Promise.all(candidates.map(async (b) => ({ b, healthy: await healthy_lookup(b) })));
+    const live = healthChecks.filter((h) => h.healthy !== false).map((h) => h.b);
+    if (live.length === 0)
+        return null;
+    return roundRobin(`modality:${wanted}`, live);
+}
+//# sourceMappingURL=backends.js.map

package/dist/backends.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backends.js","sourceRoot":"","sources":["../src/backends.ts"],"names":[],"mappings":"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"}