@vantran-se/openchamber-web 1.24.3 → 2.0.1

package/server/lib/small-model/catalog.js

@@ -1,13 +0,0 @@
-import { getModelsMetadata } from '../opencode/models-metadata.js';
-
-// The models.dev catalog is shared with the /api/openchamber/models-metadata
-// route through one in-process cache — no extra fetches, no cache files.
-export async function getModelCatalog() {
-  const { metadata } = await getModelsMetadata();
-  return metadata;
-}
-
-export function getCatalogProvider(catalog, providerID) {
-  const entry = catalog?.[providerID];
-  return entry && typeof entry === 'object' ? entry : null;
-}

package/server/lib/small-model/resolve.js

@@ -1,131 +0,0 @@
-import { getCatalogProvider } from './catalog.js';
-
-// Mirrors OpenCode's getSmallModel fallback chain:
-// 1. `small_model` from the merged config layers ("provider/model").
-// 2. GitHub Copilot's hidden utility models when Copilot is logged in.
-// 3. Family-priority scan of the authenticated providers' catalog models.
-const FAMILY_PRIORITY = ['gemini-flash', 'gpt-nano', 'claude-haiku'];
-const COPILOT_UTILITY_MODELS = ['gpt-5.4-nano', 'gpt-4.1', 'gpt-4o', 'gpt-4o-mini'];
-// The ChatGPT-plan codex backend only accepts a small allowlist of models
-// (nano/API-key models are rejected with 400) — this is its cheapest one.
-const OPENAI_OAUTH_SMALL_MODEL = 'gpt-5.4-mini';
-
-const AUTH_PROVIDER_ALIASES = {
-  'github-copilot': ['github-copilot', 'copilot'],
-};
-
-export function getAuthEntryForProvider(auth, providerID) {
-  const aliases = AUTH_PROVIDER_ALIASES[providerID] || [providerID];
-  for (const alias of aliases) {
-    const entry = auth?.[alias];
-    if (entry && typeof entry === 'object') {
-      return entry;
-    }
-  }
-  return null;
-}
-
-export function isUsableAuthEntry(entry) {
-  if (!entry || typeof entry !== 'object') return false;
-  if (entry.type === 'api') return typeof entry.key === 'string' && entry.key.length > 0;
-  if (entry.type === 'oauth') {
-    return (typeof entry.access === 'string' && entry.access.length > 0)
-      || (typeof entry.refresh === 'string' && entry.refresh.length > 0);
-  }
-  if (entry.type === 'wellknown') return typeof entry.token === 'string' && entry.token.length > 0;
-  return false;
-}
-
-export function parseModelRef(value) {
-  if (typeof value !== 'string') return null;
-  const trimmed = value.trim();
-  const slash = trimmed.indexOf('/');
-  if (slash <= 0 || slash === trimmed.length - 1) return null;
-  return {
-    providerID: trimmed.slice(0, slash),
-    modelID: trimmed.slice(slash + 1),
-  };
-}
-
-const pickByFamily = (models, family) => {
-  const matches = Object.values(models)
-    .filter((model) => model && typeof model === 'object' && model.family === family);
-  if (matches.length === 0) return null;
-  matches.sort((a, b) => String(b.release_date || '').localeCompare(String(a.release_date || '')));
-  return matches[0];
-};
-
-// Small-model candidates within ONE provider, by family priority. Copilot and
-// ChatGPT-plan OpenAI have fixed small models that never appear in the
-// catalog; everyone else is scanned through the catalog families.
-const pickWithinProvider = (providerID, auth, catalog, family) => {
-  if (providerID === 'openai' && auth.openai?.type === 'oauth') {
-    return family === 'gpt-nano'
-      ? { providerID, modelID: OPENAI_OAUTH_SMALL_MODEL, source: 'codex-small' }
-      : null;
-  }
-  if (providerID === 'github-copilot') {
-    return family === 'gpt-nano'
-      ? { providerID, modelID: COPILOT_UTILITY_MODELS[0], source: 'copilot-utility' }
-      : null;
-  }
-  const provider = getCatalogProvider(catalog, providerID);
-  if (!provider || !provider.models || typeof provider.models !== 'object') return null;
-  const model = pickByFamily(provider.models, family);
-  return model?.id ? { providerID, modelID: model.id, source: 'family-scan' } : null;
-};
-
-export function resolveSmallModel({ auth, catalog, settingsSmallModel, configSmallModel, preferredProviderID, preferredModelID }) {
-  // OpenChamber's own setting (Settings → Sessions → Small Model override)
-  // outranks everything, including the OpenCode config.
-  const fromSettings = parseModelRef(settingsSmallModel);
-  if (fromSettings) {
-    return { ...fromSettings, source: 'settings' };
-  }
-
-  const explicit = parseModelRef(configSmallModel);
-  if (explicit) {
-    return { ...explicit, source: 'config' };
-  }
-
-  // Like OpenCode: when the caller has a session context, the utility call
-  // stays on the session's provider. Scan its families for a small model,
-  // otherwise run on the session's own model — never silently switch to a
-  // different provider's subscription.
-  const preferred = typeof preferredProviderID === 'string' && preferredProviderID
-    ? preferredProviderID
-    : null;
-  if (preferred && isUsableAuthEntry(getAuthEntryForProvider(auth, preferred))) {
-    for (const family of FAMILY_PRIORITY) {
-      const match = pickWithinProvider(preferred, auth, catalog, family);
-      if (match) return match;
-    }
-    if (typeof preferredModelID === 'string' && preferredModelID) {
-      return { providerID: preferred, modelID: preferredModelID, source: 'session-model' };
-    }
-  }
-
-  // No session context (or its provider has no usable login): scan all
-  // authenticated providers by family priority.
-  const authedProviders = Object.keys(auth || {}).filter((providerID) =>
-    providerID !== preferred && isUsableAuthEntry(auth[providerID]));
-
-  for (const family of FAMILY_PRIORITY) {
-    for (const providerID of authedProviders) {
-      const match = pickWithinProvider(providerID, auth, catalog, family);
-      if (match) return match;
-    }
-  }
-
-  // Copilot's utility fallback for legacy auth aliases the loop above missed.
-  const copilotEntry = getAuthEntryForProvider(auth, 'github-copilot');
-  if (isUsableAuthEntry(copilotEntry)) {
-    return {
-      providerID: 'github-copilot',
-      modelID: COPILOT_UTILITY_MODELS[0],
-      source: 'copilot-utility',
-    };
-  }
-
-  return null;
-}

package/server/lib/small-model/resolve.test.js

@@ -1,197 +0,0 @@
-import { describe, it, expect } from 'bun:test';
-import { resolveSmallModel, parseModelRef, isUsableAuthEntry } from './resolve.js';
-
-const catalog = {
-  google: {
-    id: 'google',
-    models: {
-      'gemini-2.5-flash': { id: 'gemini-2.5-flash', family: 'gemini-flash', release_date: '2025-06-01' },
-      'gemini-2.0-flash': { id: 'gemini-2.0-flash', family: 'gemini-flash', release_date: '2024-12-01' },
-      'gemini-2.5-pro': { id: 'gemini-2.5-pro', family: 'gemini-pro', release_date: '2025-06-01' },
-    },
-  },
-  anthropic: {
-    id: 'anthropic',
-    models: {
-      'claude-haiku-4-5': { id: 'claude-haiku-4-5', family: 'claude-haiku', release_date: '2025-10-01' },
-      'claude-sonnet-4-5': { id: 'claude-sonnet-4-5', family: 'claude-sonnet', release_date: '2025-09-01' },
-    },
-  },
-};
-
-describe('parseModelRef', () => {
-  it('splits provider/model on the first slash', () => {
-    expect(parseModelRef('anthropic/claude-haiku-4-5')).toEqual({
-      providerID: 'anthropic',
-      modelID: 'claude-haiku-4-5',
-    });
-  });
-
-  it('keeps slashes inside the model id', () => {
-    expect(parseModelRef('openrouter/google/gemini-2.5-flash')).toEqual({
-      providerID: 'openrouter',
-      modelID: 'google/gemini-2.5-flash',
-    });
-  });
-
-  it('rejects values without a provider or model part', () => {
-    expect(parseModelRef('anthropic/')).toBeNull();
-    expect(parseModelRef('/model')).toBeNull();
-    expect(parseModelRef('plain')).toBeNull();
-    expect(parseModelRef(undefined)).toBeNull();
-  });
-});
-
-describe('isUsableAuthEntry', () => {
-  it('accepts api keys, oauth tokens, and wellknown tokens', () => {
-    expect(isUsableAuthEntry({ type: 'api', key: 'sk-x' })).toBe(true);
-    expect(isUsableAuthEntry({ type: 'oauth', access: 'a', refresh: 'r', expires: 0 })).toBe(true);
-    expect(isUsableAuthEntry({ type: 'wellknown', key: 'k', token: 't' })).toBe(true);
-  });
-
-  it('rejects empty or malformed entries', () => {
-    expect(isUsableAuthEntry({ type: 'api', key: '' })).toBe(false);
-    expect(isUsableAuthEntry({ type: 'oauth' })).toBe(false);
-    expect(isUsableAuthEntry(null)).toBe(false);
-  });
-});
-
-describe('resolveSmallModel', () => {
-  it('gives the OpenChamber settings override top priority', () => {
-    const result = resolveSmallModel({
-      auth: { anthropic: { type: 'api', key: 'sk-x' } },
-      catalog,
-      settingsSmallModel: 'anthropic/claude-haiku-4-5',
-      configSmallModel: 'openai/gpt-4o-mini',
-      preferredProviderID: 'anthropic',
-    });
-    expect(result).toEqual({ providerID: 'anthropic', modelID: 'claude-haiku-4-5', source: 'settings' });
-  });
-
-  it('prefers the configured small_model', () => {
-    const result = resolveSmallModel({
-      auth: { anthropic: { type: 'api', key: 'sk-x' } },
-      catalog,
-      configSmallModel: 'openai/gpt-4o-mini',
-    });
-    expect(result).toEqual({ providerID: 'openai', modelID: 'gpt-4o-mini', source: 'config' });
-  });
-
-  it('scans authenticated providers by family priority, newest first', () => {
-    const result = resolveSmallModel({
-      auth: {
-        google: { type: 'api', key: 'g-key' },
-        anthropic: { type: 'api', key: 'sk-x' },
-      },
-      catalog,
-      configSmallModel: null,
-    });
-    expect(result).toEqual({ providerID: 'google', modelID: 'gemini-2.5-flash', source: 'family-scan' });
-  });
-
-  it('skips providers without a usable credential', () => {
-    const result = resolveSmallModel({
-      auth: {
-        google: { type: 'api', key: '' },
-        anthropic: { type: 'api', key: 'sk-x' },
-      },
-      catalog,
-      configSmallModel: null,
-    });
-    expect(result).toEqual({ providerID: 'anthropic', modelID: 'claude-haiku-4-5', source: 'family-scan' });
-  });
-
-  it('falls back to Copilot utility models when only Copilot is logged in', () => {
-    const result = resolveSmallModel({
-      auth: { 'github-copilot': { type: 'oauth', access: 't', refresh: 't', expires: 0 } },
-      catalog,
-      configSmallModel: null,
-    });
-    expect(result?.providerID).toBe('github-copilot');
-    expect(result?.source).toBe('copilot-utility');
-  });
-
-  it('returns null when nothing is authenticated', () => {
-    expect(resolveSmallModel({ auth: {}, catalog, configSmallModel: null })).toBeNull();
-  });
-
-  it('prefers the session provider over other authenticated providers', () => {
-    const result = resolveSmallModel({
-      auth: {
-        google: { type: 'api', key: 'g-key' },
-        anthropic: { type: 'api', key: 'sk-x' },
-      },
-      catalog,
-      configSmallModel: null,
-      preferredProviderID: 'anthropic',
-    });
-    expect(result).toEqual({ providerID: 'anthropic', modelID: 'claude-haiku-4-5', source: 'family-scan' });
-  });
-
-  it('ignores a preferred provider without a usable login', () => {
-    const result = resolveSmallModel({
-      auth: { google: { type: 'api', key: 'g-key' } },
-      catalog,
-      configSmallModel: null,
-      preferredProviderID: 'anthropic',
-    });
-    expect(result).toEqual({ providerID: 'google', modelID: 'gemini-2.5-flash', source: 'family-scan' });
-  });
-
-  it('never uses a session provider without a login (opencode free models)', () => {
-    // Vanilla setups default the picker to opencode/big-pickle with no
-    // opencode token — those free models only work through OpenCode itself
-    // and must never be called directly, so the session context is ignored.
-    const result = resolveSmallModel({
-      auth: { openai: { type: 'oauth', access: 'a', refresh: 'r', expires: Date.now() + 60_000 } },
-      catalog,
-      configSmallModel: null,
-      preferredProviderID: 'opencode',
-      preferredModelID: 'big-pickle',
-    });
-    expect(result).toEqual({ providerID: 'openai', modelID: 'gpt-5.4-mini', source: 'codex-small' });
-  });
-
-  it('resolves nothing on a vanilla setup with no logins at all', () => {
-    const result = resolveSmallModel({
-      auth: {},
-      catalog,
-      configSmallModel: null,
-      preferredProviderID: 'opencode',
-      preferredModelID: 'big-pickle',
-    });
-    expect(result).toBeNull();
-  });
-
-  it('falls back to the session model instead of scanning other providers', () => {
-    const result = resolveSmallModel({
-      auth: {
-        'opencode-go': { type: 'api', key: 'oc-key' },
-        openai: { type: 'oauth', access: 'a', refresh: 'r', expires: Date.now() + 60_000 },
-      },
-      catalog: {
-        'opencode-go': {
-          id: 'opencode-go',
-          models: {
-            'deepseek-v4-flash': { id: 'deepseek-v4-flash', family: 'deepseek-flash', release_date: '2026-01-01' },
-          },
-        },
-      },
-      configSmallModel: null,
-      preferredProviderID: 'opencode-go',
-      preferredModelID: 'deepseek-v4-flash',
-    });
-    expect(result).toEqual({ providerID: 'opencode-go', modelID: 'deepseek-v4-flash', source: 'session-model' });
-  });
-
-  it('falls back to the session model itself when nothing resolves', () => {
-    const result = resolveSmallModel({
-      auth: { mistral: { type: 'api', key: 'm-key' } },
-      catalog,
-      configSmallModel: null,
-      preferredProviderID: 'mistral',
-      preferredModelID: 'mistral-large-latest',
-    });
-    expect(result).toEqual({ providerID: 'mistral', modelID: 'mistral-large-latest', source: 'session-model' });
-  });
-});

package/server/lib/small-model/runtime-providers.js

@@ -1,164 +0,0 @@
-// Provider state that exists only inside the running OpenCode process.
-//
-// A plugin registers its provider from the `config` hook and supplies the
-// credential from its `auth` loader, both at startup. Neither ends up in
-// `opencode.json` or `auth.json`, so a server that only reads files sees
-// nothing — which is why plugin-backed models used to fail here with
-// "has no known API base URL" while working fine in chat (#2666).
-//
-// `GET /provider` is where that state becomes visible. It reports, per
-// provider, the resolved `options.baseURL` and `options.apiKey`, and per model
-// the wire adapter (`api.npm`) and endpoint (`api.url`). The provider-level
-// endpoint remains only as a fallback when the selected model has no endpoint.
-//
-// What it does NOT report is `options.fetch`. OpenCode strips functions from
-// the response, and a plugin is free to put its whole protocol in there:
-// rewriting the path, signing the request, translating the payload. Such a
-// provider advertises a perfectly ordinary base URL that answers nothing we
-// know how to ask, and no field distinguishes the two.
-//
-// Asking the endpoint (`GET /models`) looked like the way to tell them apart,
-// and it does answer correctly for that case — but measured against the 166
-// providers in the models.dev catalog it also denies six that work fine and
-// simply have no `/models` route. A provider that vanishes from the picker
-// explains nothing; one that fails on use says why. So this module reports
-// what it knows and leaves the verdict to the call itself.
-
-const SNAPSHOT_TTL_MS = 30_000;
-const SNAPSHOT_TIMEOUT_MS = 5_000;
-
-// opencode zen hands out this sentinel instead of a key when the user has no
-// zen login, and trims its catalog to the free models. Those run on OpenCode's
-// own subsidised infrastructure and are meant to be reached through OpenCode,
-// not by us. Treating the sentinel as a credential would do exactly that, so
-// it is never accepted as one.
-export const ZEN_ANONYMOUS_API_KEY = 'public';
-
-let connection = null;
-let snapshot = null;
-let snapshotAt = 0;
-let inflight = null;
-
-/**
- * Wires this module to the running OpenCode instance. Called once at server
- * startup; pass `null` to detach. Until it is wired every lookup answers
- * "nothing known", which leaves the file-based resolution unchanged.
- */
-export function configureOpenCodeRuntimeProviders(next) {
-  connection = next ?? null;
-  resetOpenCodeRuntimeProviders();
-}
-
-/**
- * Drops every cached answer. OpenCode restarts reload plugins, which can
- * change ports, keys and the provider list itself.
- */
-export function resetOpenCodeRuntimeProviders() {
-  snapshot = null;
-  snapshotAt = 0;
-  inflight = null;
-}
-
-/**
- * The boundary. Everything the `/provider` payload claims is checked here, so
- * the rest of this module and its callers work with settled values:
- * a credential we may use, provider and model endpoints, and whether the
- * provider is the anonymous zen case.
- *
- * The credential deliberately prefers `options.apiKey` over the `key` field:
- * for a plugin provider the former is what its auth loader produced and what
- * OpenCode itself sends, while `key` only carries env/auth.json values this
- * server can already read from disk.
- */
-function parseProviderListing(payload) {
-  const providers = new Map();
-  const connected = new Set();
-  if (!payload || typeof payload !== 'object') return { providers, connected };
-
-  const text = (value) => (typeof value === 'string' && value.trim() ? value.trim() : null);
-  const record = (value) => (value && typeof value === 'object' ? value : {});
-  const endpoint = (value) => text(value)?.replace(/\/+$/, '') ?? null;
-
-  for (const raw of Array.isArray(payload.all) ? payload.all : []) {
-    const id = text(record(raw).id);
-    if (!id) continue;
-    const options = record(record(raw).options);
-    const models = new Map();
-    for (const [modelID, rawModel] of Object.entries(record(record(raw).models))) {
-      const model = record(rawModel);
-      const api = record(model.api);
-      const modelURL = endpoint(api.url);
-      const modelNpm = text(api.npm);
-      models.set(modelID, { api: { url: modelURL, npm: modelNpm } });
-    }
-    const firstModel = models.values().next().value;
-    const declaredKey = text(options.apiKey);
-    providers.set(id, {
-      id,
-      source: text(record(raw).source),
-      apiKey: declaredKey === ZEN_ANONYMOUS_API_KEY ? null : (declaredKey ?? text(record(raw).key)),
-      baseURL: endpoint(options.baseURL) ?? firstModel?.api?.url ?? null,
-      models,
-      // True only for the zen-without-login case: a provider that is present
-      // and usable through OpenCode, but that we must not call ourselves.
-      anonymousZen: declaredKey === ZEN_ANONYMOUS_API_KEY,
-    });
-  }
-
-  // Providers OpenCode considers usable right now. A provider can be present
-  // in `all` (it is in the catalog) without any credential behind it.
-  for (const raw of Array.isArray(payload.connected) ? payload.connected : []) {
-    const id = text(raw);
-    if (id) connected.add(id);
-  }
-
-  return { providers, connected };
-}
-
-const fetchSnapshot = async () => {
-  const response = await fetch(connection.buildOpenCodeUrl('/provider', ''), {
-    headers: { Accept: 'application/json', ...connection.getOpenCodeAuthHeaders() },
-    signal: AbortSignal.timeout(SNAPSHOT_TIMEOUT_MS),
-  });
-  if (!response.ok) {
-    throw new Error(`OpenCode provider listing failed with ${response.status}`);
-  }
-  return parseProviderListing(await response.json());
-};
-
-/**
- * The current runtime provider snapshot, or `null` when OpenCode cannot be
- * reached.
- *
- * `null` means "unknown", never "no providers": callers must fall back to
- * their file-based resolution rather than treat an unreachable OpenCode as an
- * empty provider list.
- */
-export async function getRuntimeProviderSnapshot() {
-  if (!connection) return null;
-  if (snapshot && Date.now() - snapshotAt < SNAPSHOT_TTL_MS) return snapshot;
-  if (!inflight) {
-    inflight = fetchSnapshot().finally(() => {
-      inflight = null;
-    });
-  }
-  try {
-    snapshot = await inflight;
-    snapshotAt = Date.now();
-    return snapshot;
-  } catch {
-    // Keep serving the previous snapshot when there is one: a momentarily
-    // unreachable OpenCode should not retract providers that were resolving a
-    // second ago.
-    return snapshot;
-  }
-}
-
-/**
- * Runtime credential and endpoint for one provider, or `null` when OpenCode
- * knows nothing about it.
- */
-export async function getRuntimeProvider(providerID) {
-  const current = await getRuntimeProviderSnapshot();
-  return current?.providers.get(providerID) ?? null;
-}

package/server/lib/small-model/runtime-providers.test.js

@@ -1,118 +0,0 @@
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-
-import {
-  ZEN_ANONYMOUS_API_KEY,
-  configureOpenCodeRuntimeProviders,
-  getRuntimeProvider,
-  getRuntimeProviderSnapshot,
-  resetOpenCodeRuntimeProviders,
-} from './runtime-providers.js';
-
-const providerPayload = (overrides = {}) => ({
-  all: [
-    {
-      id: 'llmapi',
-      source: 'config',
-      options: { apiKey: 'plugin-key', baseURL: 'https://api.llmapi.ai/v1/' },
-      models: {
-        'claude-opus-4-8': { api: { id: 'claude-opus-4-8', url: '', npm: '@ai-sdk/anthropic' } },
-        'gpt-5.6-luna': { api: { id: 'gpt-5.6-luna', url: 'https://api.llmapi.ai/v1', npm: '@ai-sdk/openai' } },
-      },
-    },
-    {
-      id: 'opencode',
-      source: 'custom',
-      options: { apiKey: ZEN_ANONYMOUS_API_KEY },
-      models: { 'free-model': { api: { id: 'free-model', url: 'https://opencode.ai/zen/v1', npm: '@ai-sdk/openai-compatible' } } },
-    },
-    {
-      id: 'zai-coding-plan',
-      source: 'api',
-      key: 'auth-json-key',
-      options: {},
-      models: { 'glm-5': { api: { id: 'glm-5', url: 'https://api.z.ai/api/coding/paas/v4', npm: '@ai-sdk/openai-compatible' } } },
-    },
-  ],
-  connected: ['llmapi', 'opencode', 'zai-coding-plan'],
-  ...overrides,
-});
-
-describe('OpenCode runtime provider snapshot', () => {
-  let fetchMock;
-
-  beforeEach(() => {
-    fetchMock = vi.fn(async () => new Response(JSON.stringify(providerPayload()), {
-      status: 200,
-      headers: { 'content-type': 'application/json' },
-    }));
-    vi.stubGlobal('fetch', fetchMock);
-    configureOpenCodeRuntimeProviders({
-      buildOpenCodeUrl: (pathname) => `http://127.0.0.1:4096${pathname}`,
-      getOpenCodeAuthHeaders: () => ({ Authorization: 'Basic test' }),
-    });
-  });
-
-  afterEach(() => {
-    configureOpenCodeRuntimeProviders(null);
-    resetOpenCodeRuntimeProviders();
-    vi.unstubAllGlobals();
-  });
-
-  it('reports the credential and endpoint a plugin registered at runtime', async () => {
-    const provider = await getRuntimeProvider('llmapi');
-
-    expect(provider).toMatchObject({ apiKey: 'plugin-key', baseURL: 'https://api.llmapi.ai/v1' });
-    expect(provider.models.get('gpt-5.6-luna')).toEqual({
-      api: { url: 'https://api.llmapi.ai/v1', npm: '@ai-sdk/openai' },
-    });
-    expect(fetchMock.mock.calls[0][0]).toBe('http://127.0.0.1:4096/provider');
-    expect(fetchMock.mock.calls[0][1].headers).toMatchObject({ Authorization: 'Basic test' });
-  });
-
-  it('refuses the zen sentinel as a credential', async () => {
-    const provider = await getRuntimeProvider('opencode');
-
-    expect(provider.apiKey).toBeNull();
-    expect(provider.anonymousZen).toBe(true);
-    // The endpoint is still reported; only the credential is withheld.
-    expect(provider.baseURL).toBe('https://opencode.ai/zen/v1');
-  });
-
-  it('falls back to the model endpoint when the provider carries no baseURL', async () => {
-    expect((await getRuntimeProvider('zai-coding-plan')).baseURL).toBe('https://api.z.ai/api/coding/paas/v4');
-  });
-
-  it('serves one snapshot to concurrent callers instead of refetching', async () => {
-    await Promise.all([getRuntimeProvider('llmapi'), getRuntimeProvider('opencode'), getRuntimeProvider('zai-coding-plan')]);
-
-    expect(fetchMock).toHaveBeenCalledTimes(1);
-  });
-
-  it('answers "unknown" rather than "no providers" when OpenCode is unreachable', async () => {
-    resetOpenCodeRuntimeProviders();
-    fetchMock.mockRejectedValue(new Error('connection refused'));
-
-    expect(await getRuntimeProviderSnapshot()).toBeNull();
-  });
-
-  it('keeps the previous snapshot when a later refresh fails', async () => {
-    await getRuntimeProviderSnapshot();
-    fetchMock.mockRejectedValue(new Error('connection refused'));
-
-    // Past the snapshot TTL, so the next read genuinely attempts a refresh.
-    vi.useFakeTimers();
-    vi.setSystemTime(Date.now() + 60_000);
-    const refreshed = await getRuntimeProviderSnapshot();
-    vi.useRealTimers();
-
-    expect(fetchMock).toHaveBeenCalledTimes(2);
-    expect(refreshed.providers.has('llmapi')).toBe(true);
-  });
-
-  it('stays on file-based resolution until it is configured', async () => {
-    configureOpenCodeRuntimeProviders(null);
-
-    expect(await getRuntimeProvider('llmapi')).toBeNull();
-    expect(fetchMock).not.toHaveBeenCalled();
-  });
-});

package/server/lib/system-prompt/DOCUMENTATION.md

@@ -1,36 +0,0 @@
-# Managed System Prompt Optimizer
-
-## Purpose
-
-This module injects an opt-in OpenCode plugin only when OpenChamber launches
-and owns the OpenCode process and `optimizeSystemPrompt` is enabled. The plugin
-replaces OpenCode's built-in behavioral/provider prompt with a short identity
-while preserving the environment, project instructions, MCP instructions,
-skills, conversation history, and separately supplied tools.
-
-## Runtime flow
-
-1. Settings persist `optimizeSystemPrompt` in OpenChamber's `settings.json`.
-2. The setting is applied when managed OpenCode restarts.
-3. The runtime materializes the plugin under
-   `<openchamber-data-dir>/system-prompt/` and appends its `file://` URL to
-   `OPENCODE_CONFIG_CONTENT` without replacing existing plugin entries.
-4. The plugin tracks the selected agent through `chat.message`. The transform
-   runs only for sessions using the built-in `build` or `plan` agent.
-5. The transform locates OpenCode's environment boundary and removes only the
-   preceding text. If the boundary is absent, it leaves the prompt unchanged.
-
-## Limitations
-
-OpenCode exposes the assembled prompt rather than structured sections. A custom
-prompt configured by overriding the `build` or `plan` agent occupies the same
-prefix as the built-in provider prompt, so the optimizer also removes that
-override. Other agents are never transformed. The setting is off by default.
-
-Plan-mode restrictions and build-mode transitions are not part of the removed
-prefix. OpenCode injects those as synthetic message reminders after system
-prompt transformation and separately enforces plan restrictions through tool
-permissions.
-
-The plugin is not injected for external OpenCode servers or VS Code's separate
-OpenCode lifecycle.