@mindexec/cli 0.2.478 → 0.2.480

package/codex-model-catalog.js

@@ -1,202 +1,202 @@
-import path from 'path';
-import { exec } from 'child_process';
-import { promisify } from 'util';
-
-const execAsync = promisify(exec);
-
-const DEFAULT_CACHE_TTL_MS = 15 * 60 * 1000;
-const DEFAULT_FAILURE_CACHE_TTL_MS = 60 * 1000;
-const DEFAULT_TIMEOUT_MS = 20 * 1000;
-const DEFAULT_MAX_BUFFER = 16 * 1024 * 1024;
-
-function getPathEnvironmentKey(env) {
-    return Object.keys(env).find(key => key.toLowerCase() === 'path') || 'PATH';
-}
-
-function isPackageBinPath(value) {
-    const normalized = path.normalize(String(value || '').trim()).replace(/[\\/]+$/, '');
-    return /[\\/]node_modules[\\/]\.bin$/i.test(normalized);
-}
-
-/**
- * The LocalBridge npm package carries a version-pinned Codex CLI through
- * @openai/codex-sdk. That CLI is the execution runtime, but it must not shadow
- * the user's newer installed Codex CLI when resolving the authoritative model
- * catalog.
- */
-export function buildExternalCodexCatalogEnv(sourceEnv = process.env) {
-    const env = { ...sourceEnv };
-    const pathKey = getPathEnvironmentKey(env);
-    const pathValue = String(env[pathKey] || '');
-    env[pathKey] = pathValue
-        .split(path.delimiter)
-        .map(item => item.trim())
-        .filter(Boolean)
-        .filter(item => !isPackageBinPath(item))
-        .join(path.delimiter);
-    return env;
-}
-
-export function normalizeCodexDebugModel(item) {
-    if (!item || typeof item !== 'object') {
-        return null;
-    }
-
-    const id = String(item.slug || '').trim();
-    if (!id || String(item.visibility || '').toLowerCase() !== 'list') {
-        return null;
-    }
-
-    return {
-        id,
-        displayName: String(item.display_name || id).trim(),
-        description: String(item.description || '').trim(),
-        priority: Number.isFinite(Number(item.priority)) ? Number(item.priority) : 999,
-        defaultReasoningLevel: String(item.default_reasoning_level || '').trim(),
-        supportedReasoningLevels: Array.isArray(item.supported_reasoning_levels)
-            ? item.supported_reasoning_levels
-                .map(level => String(level?.effort || '').trim())
-                .filter(Boolean)
-            : [],
-        supportedInApi: Boolean(item.supported_in_api)
-    };
-}
-
-function parseCodexDebugModels(stdout) {
-    const parsed = JSON.parse(String(stdout || '{}'));
-    const models = Array.isArray(parsed.models)
-        ? parsed.models
-            .map(normalizeCodexDebugModel)
-            .filter(Boolean)
-            .sort((a, b) => a.priority - b.priority || a.id.localeCompare(b.id))
-        : [];
-
-    if (models.length === 0) {
-        throw new Error('Codex live model catalog returned no list-visible models.');
-    }
-
-    return models;
-}
-
-function formatAttemptError(error) {
-    const message = String(error?.stderr || error?.message || error || 'unknown-error').trim();
-    return message.length > 1200 ? `${message.slice(0, 1200)}...` : message;
-}
-
-/**
- * Contract:
- * - `forceRefresh` always bypasses the completed-result TTL.
- * - Concurrent refreshes share one authoritative CLI request sequence.
- * - The user's external Codex CLI is tried before the SDK-pinned package CLI.
- * - A failed refresh never replaces a previously verified non-empty catalog.
- */
-export function createCodexModelCatalog(options = {}) {
-    const execute = options.execute || execAsync;
-    const sourceEnv = options.env || process.env;
-    const packageRoot = options.packageRoot || process.cwd();
-    const cacheTtlMs = Number(options.cacheTtlMs) > 0
-        ? Number(options.cacheTtlMs)
-        : DEFAULT_CACHE_TTL_MS;
-    const failureCacheTtlMs = Number(options.failureCacheTtlMs) > 0
-        ? Number(options.failureCacheTtlMs)
-        : DEFAULT_FAILURE_CACHE_TTL_MS;
-    const timeoutMs = Number(options.timeoutMs) > 0
-        ? Number(options.timeoutMs)
-        : DEFAULT_TIMEOUT_MS;
-    const now = typeof options.now === 'function' ? options.now : Date.now;
-
-    let cachedCatalog = null;
-    let cachedCatalogExpiresAt = 0;
-    let refreshPromise = null;
-
-    async function refresh() {
-        const attemptedAtMs = now();
-        const attemptedAt = new Date(attemptedAtMs).toISOString();
-        const attempts = [
-            {
-                commandSource: 'external',
-                command: 'codex debug models',
-                env: buildExternalCodexCatalogEnv(sourceEnv)
-            },
-            {
-                commandSource: 'package-local',
-                // Older SDK-pinned CLIs may not understand a newer configured
-                // reasoning level. The catalog itself is independent of this
-                // preference, so use a broadly supported value for fallback.
-                command: 'codex debug models --config model_reasoning_effort=high',
-                env: { ...sourceEnv }
-            }
-        ];
-        const attemptErrors = [];
-
-        for (const attempt of attempts) {
-            try {
-                const { stdout } = await execute(attempt.command, {
-                    cwd: packageRoot,
-                    env: attempt.env,
-                    timeout: timeoutMs,
-                    maxBuffer: DEFAULT_MAX_BUFFER,
-                    windowsHide: true
-                });
-                const models = parseCodexDebugModels(stdout);
-                cachedCatalog = {
-                    source: 'codex debug models',
-                    commandSource: attempt.commandSource,
-                    updatedAt: attemptedAt,
-                    refreshAttemptedAt: attemptedAt,
-                    stale: false,
-                    error: null,
-                    models
-                };
-                cachedCatalogExpiresAt = attemptedAtMs + cacheTtlMs;
-                return cachedCatalog;
-            } catch (error) {
-                attemptErrors.push(`${attempt.commandSource}: ${formatAttemptError(error)}`);
-            }
-        }
-
-        const error = attemptErrors.join(' | ');
-        cachedCatalogExpiresAt = attemptedAtMs + failureCacheTtlMs;
-        if (cachedCatalog?.models?.length > 0) {
-            cachedCatalog = {
-                ...cachedCatalog,
-                refreshAttemptedAt: attemptedAt,
-                stale: true,
-                error
-            };
-            return cachedCatalog;
-        }
-
-        cachedCatalog = {
-            source: 'codex debug models',
-            commandSource: null,
-            updatedAt: null,
-            refreshAttemptedAt: attemptedAt,
-            stale: true,
-            error,
-            models: []
-        };
-        return cachedCatalog;
-    }
-
-    async function getCatalog(requestOptions = {}) {
-        const forceRefresh = Boolean(requestOptions.forceRefresh);
-        if (!forceRefresh && cachedCatalog && cachedCatalogExpiresAt > now()) {
-            return cachedCatalog;
-        }
-
-        if (refreshPromise) {
-            return refreshPromise;
-        }
-
-        refreshPromise = refresh().finally(() => {
-            refreshPromise = null;
-        });
-        return refreshPromise;
-    }
-
-    return {
-        getCatalog,
-        peek: () => cachedCatalog
-    };
-}
+import path from 'path';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+
+const execAsync = promisify(exec);
+
+const DEFAULT_CACHE_TTL_MS = 15 * 60 * 1000;
+const DEFAULT_FAILURE_CACHE_TTL_MS = 60 * 1000;
+const DEFAULT_TIMEOUT_MS = 20 * 1000;
+const DEFAULT_MAX_BUFFER = 16 * 1024 * 1024;
+
+function getPathEnvironmentKey(env) {
+    return Object.keys(env).find(key => key.toLowerCase() === 'path') || 'PATH';
+}
+
+function isPackageBinPath(value) {
+    const normalized = path.normalize(String(value || '').trim()).replace(/[\\/]+$/, '');
+    return /[\\/]node_modules[\\/]\.bin$/i.test(normalized);
+}
+
+/**
+ * The LocalBridge npm package carries a version-pinned Codex CLI through
+ * @openai/codex-sdk. That CLI is the execution runtime, but it must not shadow
+ * the user's newer installed Codex CLI when resolving the authoritative model
+ * catalog.
+ */
+export function buildExternalCodexCatalogEnv(sourceEnv = process.env) {
+    const env = { ...sourceEnv };
+    const pathKey = getPathEnvironmentKey(env);
+    const pathValue = String(env[pathKey] || '');
+    env[pathKey] = pathValue
+        .split(path.delimiter)
+        .map(item => item.trim())
+        .filter(Boolean)
+        .filter(item => !isPackageBinPath(item))
+        .join(path.delimiter);
+    return env;
+}
+
+export function normalizeCodexDebugModel(item) {
+    if (!item || typeof item !== 'object') {
+        return null;
+    }
+
+    const id = String(item.slug || '').trim();
+    if (!id || String(item.visibility || '').toLowerCase() !== 'list') {
+        return null;
+    }
+
+    return {
+        id,
+        displayName: String(item.display_name || id).trim(),
+        description: String(item.description || '').trim(),
+        priority: Number.isFinite(Number(item.priority)) ? Number(item.priority) : 999,
+        defaultReasoningLevel: String(item.default_reasoning_level || '').trim(),
+        supportedReasoningLevels: Array.isArray(item.supported_reasoning_levels)
+            ? item.supported_reasoning_levels
+                .map(level => String(level?.effort || '').trim())
+                .filter(Boolean)
+            : [],
+        supportedInApi: Boolean(item.supported_in_api)
+    };
+}
+
+function parseCodexDebugModels(stdout) {
+    const parsed = JSON.parse(String(stdout || '{}'));
+    const models = Array.isArray(parsed.models)
+        ? parsed.models
+            .map(normalizeCodexDebugModel)
+            .filter(Boolean)
+            .sort((a, b) => a.priority - b.priority || a.id.localeCompare(b.id))
+        : [];
+
+    if (models.length === 0) {
+        throw new Error('Codex live model catalog returned no list-visible models.');
+    }
+
+    return models;
+}
+
+function formatAttemptError(error) {
+    const message = String(error?.stderr || error?.message || error || 'unknown-error').trim();
+    return message.length > 1200 ? `${message.slice(0, 1200)}...` : message;
+}
+
+/**
+ * Contract:
+ * - `forceRefresh` always bypasses the completed-result TTL.
+ * - Concurrent refreshes share one authoritative CLI request sequence.
+ * - The user's external Codex CLI is tried before the SDK-pinned package CLI.
+ * - A failed refresh never replaces a previously verified non-empty catalog.
+ */
+export function createCodexModelCatalog(options = {}) {
+    const execute = options.execute || execAsync;
+    const sourceEnv = options.env || process.env;
+    const packageRoot = options.packageRoot || process.cwd();
+    const cacheTtlMs = Number(options.cacheTtlMs) > 0
+        ? Number(options.cacheTtlMs)
+        : DEFAULT_CACHE_TTL_MS;
+    const failureCacheTtlMs = Number(options.failureCacheTtlMs) > 0
+        ? Number(options.failureCacheTtlMs)
+        : DEFAULT_FAILURE_CACHE_TTL_MS;
+    const timeoutMs = Number(options.timeoutMs) > 0
+        ? Number(options.timeoutMs)
+        : DEFAULT_TIMEOUT_MS;
+    const now = typeof options.now === 'function' ? options.now : Date.now;
+
+    let cachedCatalog = null;
+    let cachedCatalogExpiresAt = 0;
+    let refreshPromise = null;
+
+    async function refresh() {
+        const attemptedAtMs = now();
+        const attemptedAt = new Date(attemptedAtMs).toISOString();
+        const attempts = [
+            {
+                commandSource: 'external',
+                command: 'codex debug models',
+                env: buildExternalCodexCatalogEnv(sourceEnv)
+            },
+            {
+                commandSource: 'package-local',
+                // Older SDK-pinned CLIs may not understand a newer configured
+                // reasoning level. The catalog itself is independent of this
+                // preference, so use a broadly supported value for fallback.
+                command: 'codex debug models --config model_reasoning_effort=high',
+                env: { ...sourceEnv }
+            }
+        ];
+        const attemptErrors = [];
+
+        for (const attempt of attempts) {
+            try {
+                const { stdout } = await execute(attempt.command, {
+                    cwd: packageRoot,
+                    env: attempt.env,
+                    timeout: timeoutMs,
+                    maxBuffer: DEFAULT_MAX_BUFFER,
+                    windowsHide: true
+                });
+                const models = parseCodexDebugModels(stdout);
+                cachedCatalog = {
+                    source: 'codex debug models',
+                    commandSource: attempt.commandSource,
+                    updatedAt: attemptedAt,
+                    refreshAttemptedAt: attemptedAt,
+                    stale: false,
+                    error: null,
+                    models
+                };
+                cachedCatalogExpiresAt = attemptedAtMs + cacheTtlMs;
+                return cachedCatalog;
+            } catch (error) {
+                attemptErrors.push(`${attempt.commandSource}: ${formatAttemptError(error)}`);
+            }
+        }
+
+        const error = attemptErrors.join(' | ');
+        cachedCatalogExpiresAt = attemptedAtMs + failureCacheTtlMs;
+        if (cachedCatalog?.models?.length > 0) {
+            cachedCatalog = {
+                ...cachedCatalog,
+                refreshAttemptedAt: attemptedAt,
+                stale: true,
+                error
+            };
+            return cachedCatalog;
+        }
+
+        cachedCatalog = {
+            source: 'codex debug models',
+            commandSource: null,
+            updatedAt: null,
+            refreshAttemptedAt: attemptedAt,
+            stale: true,
+            error,
+            models: []
+        };
+        return cachedCatalog;
+    }
+
+    async function getCatalog(requestOptions = {}) {
+        const forceRefresh = Boolean(requestOptions.forceRefresh);
+        if (!forceRefresh && cachedCatalog && cachedCatalogExpiresAt > now()) {
+            return cachedCatalog;
+        }
+
+        if (refreshPromise) {
+            return refreshPromise;
+        }
+
+        refreshPromise = refresh().finally(() => {
+            refreshPromise = null;
+        });
+        return refreshPromise;
+    }
+
+    return {
+        getCatalog,
+        peek: () => cachedCatalog
+    };
+}