toc-ocra 0.2.0

package/dist/src/providers/detection.js

@@ -0,0 +1,96 @@
+import { spawn } from 'node:child_process';
+import { hydrateShellPath, mergePathSegments } from '../runtime/cli/hydrate-shell-path.js';
+import { CLI_CATALOG, DETECTION_COMMANDS, getProviderDetectionProbeCommands, resolveDetectedProviderCommands } from './registry.js';
+import { resolveCliCommandDetailed } from '../shared/node-cli-command-resolution.js';
+function probeVersion(path, args) {
+    if (args.length === 0)
+        return Promise.resolve({});
+    return new Promise((resolve) => {
+        const child = spawn(path, [...args], { stdio: ['ignore', 'pipe', 'pipe'], shell: false });
+        let stdout = '';
+        let stderr = '';
+        let settled = false;
+        let timer;
+        const finish = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            if (timer)
+                clearTimeout(timer);
+            resolve(result);
+        };
+        timer = setTimeout(() => {
+            child.kill('SIGKILL');
+            finish({ detail: 'version probe timeout' });
+        }, 5_000);
+        child.stdout.on('data', (chunk) => { stdout += chunk.toString(); });
+        child.stderr.on('data', (chunk) => { stderr += chunk.toString(); });
+        child.on('error', (error) => finish({ detail: error.message }));
+        child.on('close', (code) => {
+            const detail = (stdout || stderr || `exit ${code ?? 'unknown'}`).trim().slice(0, 200);
+            const version = stdout.split(/\r?\n/).map((line) => line.trim()).find(Boolean);
+            finish(version ? { version, detail } : { detail });
+        });
+    });
+}
+export class CliDetectionService {
+    snapshot;
+    pending;
+    async detect(forceRefresh = false) {
+        if (this.pending)
+            return this.pending;
+        if (!forceRefresh && this.snapshot)
+            return this.snapshot;
+        this.pending = this.detectNow(forceRefresh).finally(() => {
+            this.pending = undefined;
+        });
+        return this.pending;
+    }
+    async detectNow(forceRefresh) {
+        const hydration = await hydrateShellPath({ force: forceRefresh });
+        const addedPathSegments = hydration.ok ? mergePathSegments(hydration.segments) : [];
+        const commands = getProviderDetectionProbeCommands(DETECTION_COMMANDS);
+        const resolved = new Map(commands.map((command) => [command, resolveCliCommandDetailed(command)]));
+        const foundCommands = new Set(commands.filter((command) => resolved.get(command)?.found));
+        const detected = resolveDetectedProviderCommands(foundCommands, DETECTION_COMMANDS);
+        const providers = await Promise.all(CLI_CATALOG.map(async (config) => {
+            const matchedDetectionCommand = detected.get(config.id);
+            const result = matchedDetectionCommand ? resolved.get(matchedDetectionCommand) : undefined;
+            const executablePath = result?.found ? result.path : undefined;
+            const installed = Boolean(executablePath);
+            const unsupported = config.detectUnsupportedRuntimes?.includes(process.platform) ?? false;
+            const diagnostic = executablePath ? await probeVersion(executablePath, config.versionArguments ?? []) : {};
+            const detail = installed
+                ? diagnostic.detail
+                : unsupported
+                    ? 'unsupported runtime'
+                    : config.detectRequiredCommands?.length
+                        ? 'command or required command not found'
+                        : 'command not found';
+            return {
+                id: config.id,
+                installed,
+                available: installed && Boolean(config.headless),
+                ...(matchedDetectionCommand ? { matchedDetectionCommand } : {}),
+                ...(result?.path ? { resolvedPath: result.path } : {}),
+                ...(diagnostic.version ? { version: diagnostic.version } : {}),
+                ...(detail ? { detail } : {})
+            };
+        }));
+        this.snapshot = {
+            providers,
+            detectedIds: providers.filter((provider) => provider.installed).map((provider) => provider.id),
+            addedPathSegments,
+            shellHydrationOk: hydration.ok,
+            pathSource: hydration.ok ? 'shell_hydrated' : 'process_path',
+            pathFailureReason: hydration.failureReason,
+            refreshedAt: new Date().toISOString()
+        };
+        return this.snapshot;
+    }
+}
+export const cliDetection = new CliDetectionService();
+export function providerCapabilityIds(snapshot) {
+    return snapshot.detectedIds;
+}
+//# sourceMappingURL=detection.js.map

package/dist/src/providers/detection.js.map

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

package/dist/src/providers/model-catalog-collector.d.ts

@@ -0,0 +1,22 @@
+import type { ModelCatalogReport } from '../types/protocol.js';
+import { type ModelSource } from './model-catalog.js';
+/**
+ * Collects the model catalogs of the CLIs installed on this device.
+ *
+ * A catalog is re-read only when one of its source's watch files changed or
+ * its refresh interval elapsed, so calling `collect` every heartbeat is cheap.
+ * The report carries a content hash: the runtime sends it to the server only
+ * when the hash differs from the last one the server accepted.
+ */
+export declare class ModelCatalogCollector {
+    private readonly sources;
+    private readonly cache;
+    constructor(sources?: Readonly<Record<string, ModelSource>>);
+    /** CLI ids that have a model source, among the detected ones. */
+    supported(detectedIds: readonly string[]): string[];
+    collect(detectedIds: readonly string[], options?: {
+        force?: boolean;
+        only?: string;
+    }): Promise<ModelCatalogReport>;
+    private readOne;
+}

package/dist/src/providers/model-catalog-collector.js

@@ -0,0 +1,66 @@
+import { createHash } from 'node:crypto';
+import { stat } from 'node:fs/promises';
+import { MODEL_SOURCES } from './model-catalog.js';
+async function fileStamp(path) {
+    try {
+        const info = await stat(path);
+        return `${path}:${info.mtimeMs}:${info.size}`;
+    }
+    catch {
+        return `${path}:-`;
+    }
+}
+/** Stable content hash: ignores fetched_at so an unchanged list keeps its hash. */
+function reportHash(items) {
+    const stable = items.map((item) => ({
+        agent_type: item.agent_type,
+        error: item.error ?? '',
+        ...(item.catalog ? { catalog: { ...item.catalog, fetched_at: '' } } : {})
+    }));
+    return createHash('sha256').update(JSON.stringify(stable)).digest('hex');
+}
+/**
+ * Collects the model catalogs of the CLIs installed on this device.
+ *
+ * A catalog is re-read only when one of its source's watch files changed or
+ * its refresh interval elapsed, so calling `collect` every heartbeat is cheap.
+ * The report carries a content hash: the runtime sends it to the server only
+ * when the hash differs from the last one the server accepted.
+ */
+export class ModelCatalogCollector {
+    sources;
+    cache = new Map();
+    constructor(sources = MODEL_SOURCES) {
+        this.sources = sources;
+    }
+    /** CLI ids that have a model source, among the detected ones. */
+    supported(detectedIds) {
+        return [...new Set(detectedIds.map((id) => (id === 'claude-code' ? 'claude' : id)))].filter((id) => id in this.sources).sort();
+    }
+    async collect(detectedIds, options = {}) {
+        const ids = this.supported(detectedIds);
+        const items = await Promise.all(ids.map((id) => this.readOne(id, Boolean(options.force && (!options.only || options.only === id)))));
+        return { hash: reportHash(items), items };
+    }
+    async readOne(id, force) {
+        const source = this.sources[id];
+        const now = Date.now();
+        const stamps = await Promise.all(source.watchFiles().map(fileStamp));
+        const fingerprint = stamps.join('|');
+        const cached = this.cache.get(id);
+        const expired = source.refreshEveryMs !== undefined && cached !== undefined && now - cached.readAt >= source.refreshEveryMs;
+        if (cached && !force && !expired && cached.fingerprint === fingerprint)
+            return cached.item;
+        let item;
+        try {
+            const catalog = await source.read();
+            item = { agent_type: id, catalog: { ...catalog, agent_type: id } };
+        }
+        catch (error) {
+            item = { agent_type: id, error: error instanceof Error ? error.message : String(error) };
+        }
+        this.cache.set(id, { fingerprint, readAt: now, item });
+        return item;
+    }
+}
+//# sourceMappingURL=model-catalog-collector.js.map

package/dist/src/providers/model-catalog-collector.js.map

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

package/dist/src/providers/model-catalog.d.ts

@@ -0,0 +1,45 @@
+import type { AgentCliModelCatalog } from '../types/protocol.js';
+/**
+ * Claude Code builds its interactive model picker from the local
+ * ANTHROPIC_DEFAULT_<alias>_MODEL mappings. Read those same mappings rather
+ * than maintaining a provider-side list that inevitably drifts from the
+ * installed CLI configuration.
+ */
+export declare function parseClaudeModelCatalog(settings: unknown, environment?: NodeJS.ProcessEnv, fetchedAt?: string): AgentCliModelCatalog;
+export declare function readClaudeModelCatalog(): Promise<AgentCliModelCatalog>;
+/**
+ * Codex writes the locally available model metadata to models_cache.json. This is
+ * intentionally read on the device, so the server never guesses another machine's
+ * model access or supported reasoning levels.
+ */
+export declare function readCodexModelCatalog(): Promise<AgentCliModelCatalog>;
+/** Normalizes the JSON emitted by `kiro-cli chat --list-models --format json`. */
+export declare function parseKiroModelCatalog(payload: unknown, fetchedAt?: string): AgentCliModelCatalog;
+/** Runs a CLI's model-list command and returns stdout; fails on timeout or a non-zero exit. */
+export declare function runModelListCommand(executable: string, args: readonly string[], label: string): Promise<string>;
+/**
+ * Kiro is queried from the physical device. Its current CLI returns models but
+ * does not advertise reasoning efforts, so the empty effort lists deliberately
+ * preserve Kiro's device default rather than inventing unsupported choices.
+ */
+export declare function readKiroModelCatalog(): Promise<AgentCliModelCatalog>;
+export declare function parseGeminiModelCatalog(payload: unknown, defaultModel?: string, fetchedAt?: string): AgentCliModelCatalog;
+export declare function readGeminiModelCatalog(): Promise<AgentCliModelCatalog>;
+export declare function parseGrokModelCatalog(output: string, config?: string, fetchedAt?: string): AgentCliModelCatalog;
+export declare function readGrokModelCatalog(): Promise<AgentCliModelCatalog>;
+/** `opencode models` prints one `provider/model` id per line. */
+export declare function parseOpencodeModelCatalog(output: string, config?: string, fetchedAt?: string): AgentCliModelCatalog;
+export declare function readOpencodeModelCatalog(): Promise<AgentCliModelCatalog>;
+/**
+ * Where a CLI's model list comes from. `watchFiles` are the local files whose
+ * change means the list may have changed (checked by mtime every heartbeat);
+ * sources that also ask the CLI or a remote API are re-read every
+ * `refreshEveryMs` even when no file changed.
+ */
+export type ModelSource = {
+    read: () => Promise<AgentCliModelCatalog>;
+    watchFiles: () => string[];
+    refreshEveryMs?: number;
+};
+export declare const MODEL_SOURCES: Readonly<Record<string, ModelSource>>;
+export declare function readAgentModelCatalog(agentType: string): Promise<AgentCliModelCatalog>;

package/dist/src/providers/model-catalog.js

@@ -0,0 +1,382 @@
+import { spawn } from 'node:child_process';
+import { readFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { isAbsolute, join, resolve } from 'node:path';
+import { resolveCliCommand } from '../shared/node-cli-command-resolution.js';
+function stringValue(value) {
+    return typeof value === 'string' && value.trim() ? value.trim() : undefined;
+}
+const CLAUDE_REASONING_EFFORTS = ['low', 'medium', 'high', 'xhigh', 'max'];
+/**
+ * Claude Code builds its interactive model picker from the local
+ * ANTHROPIC_DEFAULT_<alias>_MODEL mappings. Read those same mappings rather
+ * than maintaining a provider-side list that inevitably drifts from the
+ * installed CLI configuration.
+ */
+export function parseClaudeModelCatalog(settings, environment = process.env, fetchedAt = new Date().toISOString()) {
+    const source = settings && typeof settings === 'object' ? settings : {};
+    const configuredEnv = source.env && typeof source.env === 'object'
+        ? source.env
+        : {};
+    const mergedEnv = { ...configuredEnv, ...environment };
+    const models = new Map();
+    for (const [key, rawModel] of Object.entries(mergedEnv)) {
+        const match = key.match(/^ANTHROPIC_DEFAULT_([A-Z0-9_]+)_MODEL$/);
+        const id = stringValue(rawModel);
+        if (!match || !id)
+            continue;
+        const configuredName = stringValue(mergedEnv[`${key}_NAME`]);
+        const existing = models.get(id);
+        if (!existing) {
+            models.set(id, {
+                id,
+                name: configuredName ?? id,
+                supported_reasoning_efforts: [...CLAUDE_REASONING_EFFORTS]
+            });
+        }
+    }
+    const catalog = {
+        agent_type: 'claude',
+        fetched_at: fetchedAt,
+        models: [...models.values()]
+    };
+    const defaultModel = stringValue(mergedEnv.ANTHROPIC_MODEL);
+    if (defaultModel)
+        catalog.default_model = defaultModel;
+    return catalog;
+}
+const claudeHome = () => process.env.CLAUDE_CONFIG_DIR?.trim() || join(homedir(), '.claude');
+const codexHome = () => process.env.CODEX_HOME?.trim() || join(homedir(), '.codex');
+const geminiHome = () => process.env.GEMINI_CLI_HOME?.trim() || join(homedir(), '.gemini');
+const grokHome = () => process.env.GROK_HOME?.trim() || join(homedir(), '.grok');
+const opencodeHome = () => join(process.env.XDG_CONFIG_HOME?.trim() || join(homedir(), '.config'), 'opencode');
+export async function readClaudeModelCatalog() {
+    const home = claudeHome();
+    const content = await readFile(join(home, 'settings.json'), 'utf8').catch(() => '');
+    let settings = {};
+    if (content) {
+        try {
+            settings = JSON.parse(content);
+        }
+        catch {
+            throw new Error('Claude 本机 settings.json 不是有效 JSON');
+        }
+    }
+    const catalog = parseClaudeModelCatalog(settings);
+    if (catalog.models.length === 0) {
+        throw new Error('Claude 本机未配置可发现的模型映射');
+    }
+    return catalog;
+}
+function configValue(content, key) {
+    const match = content.match(new RegExp(`^\\s*${key}\\s*=\\s*[\"']([^\"']+)[\"']\\s*(?:#.*)?$`, 'm'));
+    return match?.[1]?.trim() || undefined;
+}
+function toModel(entry) {
+    const id = stringValue(entry.slug);
+    if (!id)
+        return undefined;
+    const supported = Array.isArray(entry.supported_reasoning_levels)
+        ? entry.supported_reasoning_levels.flatMap((value) => {
+            const level = stringValue(value) ?? (value && typeof value === 'object'
+                ? stringValue(value.effort)
+                : undefined);
+            return level ? [level] : [];
+        })
+        : [];
+    const defaultReasoning = stringValue(entry.default_reasoning_level);
+    const description = stringValue(entry.description);
+    const model = {
+        id,
+        name: stringValue(entry.display_name) ?? id,
+        supported_reasoning_efforts: supported
+    };
+    if (description)
+        model.description = description;
+    if (defaultReasoning)
+        model.default_reasoning_effort = defaultReasoning;
+    return model;
+}
+function parseCodexModels(content) {
+    if (!content)
+        return undefined;
+    try {
+        const parsed = JSON.parse(content);
+        if (!parsed || typeof parsed !== 'object' || !Array.isArray(parsed.models)) {
+            return undefined;
+        }
+        return parsed.models.flatMap((entry) => {
+            const model = toModel(entry);
+            return model ? [model] : [];
+        });
+    }
+    catch {
+        return undefined;
+    }
+}
+async function readCodexModels(codexHome, config) {
+    const configuredCatalog = configValue(config, 'model_catalog_json');
+    if (configuredCatalog) {
+        const catalogPath = isAbsolute(configuredCatalog)
+            ? configuredCatalog
+            : resolve(codexHome, configuredCatalog);
+        const configuredModels = parseCodexModels(await readFile(catalogPath, 'utf8').catch(() => ''));
+        if (configuredModels?.length)
+            return configuredModels;
+    }
+    return parseCodexModels(await readFile(join(codexHome, 'models_cache.json'), 'utf8').catch(() => '')) ?? [];
+}
+/**
+ * Codex writes the locally available model metadata to models_cache.json. This is
+ * intentionally read on the device, so the server never guesses another machine's
+ * model access or supported reasoning levels.
+ */
+export async function readCodexModelCatalog() {
+    const home = codexHome();
+    const config = await readFile(join(home, 'config.toml'), 'utf8').catch(() => '');
+    const models = await readCodexModels(home, config);
+    const defaultModel = configValue(config, 'model');
+    const defaultReasoningEffort = configValue(config, 'model_reasoning_effort');
+    const catalog = {
+        agent_type: 'codex',
+        fetched_at: new Date().toISOString(),
+        models
+    };
+    if (defaultModel)
+        catalog.default_model = defaultModel;
+    if (defaultReasoningEffort)
+        catalog.default_reasoning_effort = defaultReasoningEffort;
+    return catalog;
+}
+/** Normalizes the JSON emitted by `kiro-cli chat --list-models --format json`. */
+export function parseKiroModelCatalog(payload, fetchedAt = new Date().toISOString()) {
+    const source = payload && typeof payload === 'object' ? payload : {};
+    const models = Array.isArray(source.models)
+        ? source.models.flatMap((item) => {
+            const entry = item && typeof item === 'object' ? item : {};
+            const id = stringValue(entry.model_id) ?? stringValue(entry.model_name);
+            if (!id)
+                return [];
+            const model = {
+                id,
+                name: stringValue(entry.model_name) ?? id,
+                supported_reasoning_efforts: []
+            };
+            const description = stringValue(entry.description);
+            if (description)
+                model.description = description;
+            return [model];
+        })
+        : [];
+    const catalog = {
+        agent_type: 'kiro',
+        fetched_at: fetchedAt,
+        models
+    };
+    const defaultModel = stringValue(source.default_model);
+    if (defaultModel)
+        catalog.default_model = defaultModel;
+    return catalog;
+}
+const MODEL_LIST_TIMEOUT_MS = 20_000;
+/** Runs a CLI's model-list command and returns stdout; fails on timeout or a non-zero exit. */
+export function runModelListCommand(executable, args, label) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(executable, [...args], { shell: false, stdio: ['ignore', 'pipe', 'pipe'] });
+        let stdout = '';
+        let stderr = '';
+        const timer = setTimeout(() => {
+            child.kill('SIGKILL');
+            reject(new Error(`${label} 读取模型列表超时`));
+        }, MODEL_LIST_TIMEOUT_MS);
+        child.stdout.setEncoding('utf8');
+        child.stderr.setEncoding('utf8');
+        child.stdout.on('data', (chunk) => { stdout += chunk; });
+        child.stderr.on('data', (chunk) => { stderr += chunk; });
+        child.once('error', (error) => { clearTimeout(timer); reject(error); });
+        child.once('close', (code) => {
+            clearTimeout(timer);
+            if (code === 0)
+                resolve(stdout);
+            else
+                reject(new Error((stderr || stdout || `${label} exited with code ${code ?? 'unknown'}`).trim()));
+        });
+    });
+}
+/**
+ * Kiro is queried from the physical device. Its current CLI returns models but
+ * does not advertise reasoning efforts, so the empty effort lists deliberately
+ * preserve Kiro's device default rather than inventing unsupported choices.
+ */
+export async function readKiroModelCatalog() {
+    const executable = resolveCliCommand('kiro-cli');
+    const output = await runModelListCommand(executable, ['chat', '--list-models', '--format', 'json'], 'kiro-cli');
+    let payload;
+    try {
+        payload = JSON.parse(output);
+    }
+    catch {
+        throw new Error('kiro-cli 返回的模型目录不是有效 JSON');
+    }
+    return parseKiroModelCatalog(payload);
+}
+function parseEnvFile(content) {
+    const values = {};
+    for (const line of content.split(/\r?\n/)) {
+        const match = line.match(/^\s*(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*?)\s*$/);
+        const key = match?.[1];
+        let value = match?.[2];
+        if (!key || value === undefined)
+            continue;
+        if ((value.startsWith('"') && value.endsWith('"')) ||
+            (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        values[key] = value;
+    }
+    return values;
+}
+export function parseGeminiModelCatalog(payload, defaultModel, fetchedAt = new Date().toISOString()) {
+    const source = payload && typeof payload === 'object'
+        ? payload
+        : {};
+    const models = Array.isArray(source.models)
+        ? source.models.flatMap((item) => {
+            const entry = item && typeof item === 'object' ? item : {};
+            const rawId = stringValue(entry.name);
+            if (!rawId)
+                return [];
+            const id = rawId.replace(/^models\//, '');
+            const model = {
+                id,
+                name: stringValue(entry.displayName) ?? id,
+                supported_reasoning_efforts: []
+            };
+            const description = stringValue(entry.description);
+            if (description)
+                model.description = description;
+            return [model];
+        })
+        : [];
+    const catalog = {
+        agent_type: 'gemini',
+        fetched_at: fetchedAt,
+        models
+    };
+    if (defaultModel?.trim())
+        catalog.default_model = defaultModel.trim();
+    return catalog;
+}
+function geminiModelsUrl(baseUrl) {
+    const url = new URL(baseUrl);
+    const path = url.pathname.replace(/\/+$/, '');
+    url.pathname = path.endsWith('/v1beta') ? `${path}/models` : `${path}/v1beta/models`;
+    url.search = '';
+    return url;
+}
+export async function readGeminiModelCatalog() {
+    const fileEnvironment = parseEnvFile(await readFile(join(geminiHome(), '.env'), 'utf8').catch(() => ''));
+    const environment = { ...fileEnvironment, ...process.env };
+    const baseUrl = environment.GOOGLE_GEMINI_BASE_URL?.trim();
+    const apiKey = environment.GEMINI_API_KEY?.trim();
+    if (!baseUrl)
+        throw new Error('Gemini 本机未配置 GOOGLE_GEMINI_BASE_URL');
+    if (!apiKey)
+        throw new Error('Gemini 本机未配置 GEMINI_API_KEY');
+    const url = geminiModelsUrl(baseUrl);
+    url.searchParams.set('key', apiKey);
+    const response = await fetch(url, {
+        headers: { 'x-goog-api-key': apiKey }
+    });
+    if (!response.ok) {
+        throw new Error(`Gemini 模型目录请求失败 (${response.status})`);
+    }
+    return parseGeminiModelCatalog(await response.json(), environment.GEMINI_MODEL);
+}
+const GROK_REASONING_EFFORTS = ['low', 'medium', 'high'];
+export function parseGrokModelCatalog(output, config = '', fetchedAt = new Date().toISOString()) {
+    const plain = output.replace(/\u001b\[[0-?]*[ -/]*[@-~]/g, '');
+    const defaultModel = plain.match(/^\s*Default model:\s*(\S+)\s*$/m)?.[1]
+        ?? configValue(config, 'default');
+    const availableBlock = plain.split(/^\s*Available models:\s*$/m)[1] ?? '';
+    const ids = [...new Set(availableBlock.split(/\r?\n/).flatMap((line) => {
+            const match = line.match(/^\s*(?:\*|-)\s+(\S+)(?:\s+\(default\))?\s*$/);
+            const id = match?.[1];
+            return id ? [id] : [];
+        }))];
+    const catalog = {
+        agent_type: 'grok',
+        fetched_at: fetchedAt,
+        models: ids.map((id) => ({
+            id,
+            name: id,
+            supported_reasoning_efforts: [...GROK_REASONING_EFFORTS]
+        }))
+    };
+    if (defaultModel)
+        catalog.default_model = defaultModel;
+    const defaultReasoningEffort = configValue(config, 'default_reasoning_effort');
+    if (defaultReasoningEffort)
+        catalog.default_reasoning_effort = defaultReasoningEffort;
+    return catalog;
+}
+export async function readGrokModelCatalog() {
+    const config = await readFile(join(grokHome(), 'config.toml'), 'utf8').catch(() => '');
+    const output = await runModelListCommand(resolveCliCommand('grok'), ['models'], 'grok');
+    const catalog = parseGrokModelCatalog(output, config);
+    if (catalog.models.length === 0)
+        throw new Error('Grok 本机未返回可用模型');
+    return catalog;
+}
+/** `opencode models` prints one `provider/model` id per line. */
+export function parseOpencodeModelCatalog(output, config = '', fetchedAt = new Date().toISOString()) {
+    const plain = output.replace(/\u001b\[[0-?]*[ -/]*[@-~]/g, '');
+    const ids = [...new Set(plain.split(/\r?\n/).map((line) => line.trim()).filter((line) => /^[^\s/]+\/\S+$/.test(line)))];
+    const catalog = {
+        agent_type: 'opencode',
+        fetched_at: fetchedAt,
+        models: ids.map((id) => ({ id, name: id, supported_reasoning_efforts: [] }))
+    };
+    const defaultModel = config.match(/"model"\s*:\s*"([^"]+)"/)?.[1]?.trim();
+    if (defaultModel)
+        catalog.default_model = defaultModel;
+    return catalog;
+}
+export async function readOpencodeModelCatalog() {
+    const config = await readFile(join(opencodeHome(), 'opencode.json'), 'utf8').catch(() => '')
+        || await readFile(join(opencodeHome(), 'opencode.jsonc'), 'utf8').catch(() => '');
+    const output = await runModelListCommand(resolveCliCommand('opencode'), ['models'], 'opencode');
+    const catalog = parseOpencodeModelCatalog(output, config);
+    if (catalog.models.length === 0)
+        throw new Error('OpenCode 本机未返回可用模型');
+    return catalog;
+}
+const TEN_MINUTES = 10 * 60 * 1_000;
+export const MODEL_SOURCES = {
+    claude: { read: readClaudeModelCatalog, watchFiles: () => [join(claudeHome(), 'settings.json')] },
+    codex: {
+        read: readCodexModelCatalog,
+        watchFiles: () => {
+            const home = codexHome();
+            return [join(home, 'config.toml'), join(home, 'models_cache.json')];
+        },
+        // model_catalog_json may point anywhere; a periodic re-read covers it.
+        refreshEveryMs: TEN_MINUTES
+    },
+    gemini: { read: readGeminiModelCatalog, watchFiles: () => [join(geminiHome(), '.env')], refreshEveryMs: TEN_MINUTES },
+    grok: { read: readGrokModelCatalog, watchFiles: () => [join(grokHome(), 'config.toml')], refreshEveryMs: TEN_MINUTES },
+    kiro: { read: readKiroModelCatalog, watchFiles: () => [], refreshEveryMs: TEN_MINUTES },
+    opencode: {
+        read: readOpencodeModelCatalog,
+        watchFiles: () => [join(opencodeHome(), 'opencode.json'), join(opencodeHome(), 'opencode.jsonc')],
+        refreshEveryMs: TEN_MINUTES
+    }
+};
+export async function readAgentModelCatalog(agentType) {
+    const id = agentType.trim().toLowerCase() === 'claude-code' ? 'claude' : agentType.trim().toLowerCase();
+    const source = MODEL_SOURCES[id];
+    if (!source)
+        throw new Error(`当前 Agent 暂不支持 ${agentType} 的模型目录`);
+    return source.read();
+}
+//# sourceMappingURL=model-catalog.js.map