@ai-agent-forge/agent-forge 0.86.6 → 0.87.0

package/dist/core/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"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","sourcesContent":["import { appendFileSync, mkdirSync, readdirSync, statSync, unlinkSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\n/**\n * Host-process logger: minimal kernel carrying-layer mechanism for runtime\n * diagnostics (design `会话轨迹与日志设计.md` §5). One JSONL entry per line,\n * written through with `appendFileSync` into `<dir>/<yyyy-mm-dd>-<pid>.log`\n * (local date). The file is created lazily on the first written entry.\n *\n * Failure contract: logging must never throw. Level filtering drops entries\n * below the configured level; write failures (disk full, permissions, bad dir)\n * are swallowed and counted, and `close()` reports `{ written, failed }`.\n * Expired log files are swept once at logger creation; sweep failures are\n * recorded as a warn entry through the logger itself.\n *\n * Crash contract: registering `uncaughtException`/`unhandledRejection`\n * listeners replaces Node's default fatal behavior, so the hooks restore it —\n * one log line per fatal value, Node-default crash text on stderr, exit(1).\n */\n\nexport type HostLogLevel = \"debug\" | \"info\" | \"warn\" | \"error\";\n\nconst LEVEL_RANK: Record<HostLogLevel, number> = { debug: 0, info: 1, warn: 2, error: 3 };\n\n/** All valid host log levels; the construction-time level check runs against this list. */\nconst HOST_LOG_LEVELS: readonly HostLogLevel[] = [\"debug\", \"info\", \"warn\", \"error\"];\n\nconst DAY_MS = 24 * 60 * 60 * 1000;\n\n/** Upper bound on retained stack lines for a logged cause. */\nconst MAX_STACK_LINES = 10;\n\n/** Default retention window for startup sweep, in days. `0` disables sweeping. */\nconst DEFAULT_MAX_AGE_DAYS = 14;\n\n/** Per-entry call-site detail. All members optional; `undefined` members are omitted from the line. */\nexport interface HostLogContext {\n\treadonly sessionId?: string;\n\treadonly traceId?: string;\n\treadonly fields?: Record<string, unknown>;\n\treadonly cause?: unknown;\n}\n\n/** One JSONL line in the host log file. */\nexport interface HostLogEntry {\n\treadonly v: 1;\n\t/** Host timestamp (epoch ms). */\n\treadonly t: number;\n\treadonly level: HostLogLevel;\n\t/** Call-site marker, e.g. \"sdk\", \"compaction\", \"process\". */\n\treadonly src: string;\n\treadonly msg: string;\n\treadonly sessionId?: string;\n\treadonly traceId?: string;\n\treadonly fields?: Record<string, unknown>;\n\t/** Bounded error facts (name/message + at most 10 stack lines, or safe JSON for non-Error values). */\n\treadonly cause?: unknown;\n}\n\nexport interface HostLoggerOptions {\n\t/** Log directory. Created recursively on first write. */\n\treadonly dir: string;\n\t/**\n\t * Minimum level to write; lower levels are dropped. Default \"info\". An\n\t * invalid level fails construction (programmer error), never a silent\n\t * fallback to a default.\n\t */\n\treadonly level?: HostLogLevel;\n\t/** Startup sweep retention in days; `0` disables sweeping. Default 14. */\n\treadonly maxAgeDays?: number;\n\t/** Injected clock for deterministic tests. Default `Date.now`. */\n\treadonly now?: () => number;\n\t/**\n\t * Injected process hooks to avoid attaching to the real process in tests.\n\t * Members left unset default to the real process.\n\t */\n\treadonly processHost?: HostProcessHost;\n}\n\n/**\n * Process-hook injection surface for the host logger. When the whole\n * processHost is omitted it falls back to the real process: both fatal hooks\n * are registered via `process.on`. With a processHost present, the two\n * registrar members are opt-in: a member left unset means that fatal hook is\n * NOT registered and there is no fallback to `process.on` — the process keeps\n * Node's default fatal behavior for that hook. The crash-restore members\n * (`exit`/`writeStderr`/`deferThrow`) fall back to the real process when\n * omitted, so tests can inject captured fakes that never exit or throw.\n */\nexport interface HostProcessHost {\n\t/**\n\t * Registrar for fatal uncaught exceptions. Omitted = no hook is registered\n\t * (no fallback to `process.on(\"uncaughtException\", cb)`).\n\t */\n\treadonly onUncaughtException?: (cb: (error: unknown) => void) => void;\n\t/**\n\t * Registrar for fatal unhandled rejections. Omitted = no hook is registered\n\t * (no fallback to `process.on(\"unhandledRejection\", cb)`).\n\t */\n\treadonly onUnhandledRejection?: (cb: (reason: unknown) => void) => void;\n\t/** Terminal exit. Omitted = falls back to the real `process.exit`. */\n\treadonly exit?: (code: number) => void;\n\t/** Crash-text sink. Omitted = falls back to the real `process.stderr.write`. */\n\treadonly writeStderr?: (chunk: string) => void;\n\t/**\n\t * Defers the rejection rethrow so it surfaces as an uncaughtException.\n\t * Omitted = falls back to the real `setImmediate(thrower)`.\n\t */\n\treadonly deferThrow?: (thrower: () => void) => void;\n}\n\nexport interface HostLoggerCloseSummary {\n\treadonly written: number;\n\treadonly failed: number;\n}\n\nexport interface HostLogger {\n\tdebug(src: string, msg: string, context?: HostLogContext): void;\n\tinfo(src: string, msg: string, context?: HostLogContext): void;\n\twarn(src: string, msg: string, context?: HostLogContext): void;\n\terror(src: string, msg: string, context?: HostLogContext): void;\n\t/**\n\t * Stop logging. Idempotent; later log calls are no-ops. Registered process\n\t * hooks stay attached: they stop writing log lines but still restore the\n\t * crash semantics (stderr + exit). Returns the write tally.\n\t */\n\tclose(): HostLoggerCloseSummary;\n}\n\n/** Real-process defaults for the crash-restore members; `Required` keeps resolved hooks callable. */\nconst NODE_PROCESS_CRASH_HOST: Required<Pick<HostProcessHost, \"exit\" | \"writeStderr\" | \"deferThrow\">> = {\n\texit(code) {\n\t\tprocess.exit(code);\n\t},\n\twriteStderr(chunk) {\n\t\tprocess.stderr.write(chunk);\n\t},\n\tdeferThrow(thrower) {\n\t\tsetImmediate(thrower);\n\t},\n};\n\nconst NODE_PROCESS_HOST: HostProcessHost = {\n\tonUncaughtException(cb) {\n\t\tprocess.on(\"uncaughtException\", cb);\n\t},\n\tonUnhandledRejection(cb) {\n\t\tprocess.on(\"unhandledRejection\", cb);\n\t},\n\t...NODE_PROCESS_CRASH_HOST,\n};\n\n/** Local-date file name for the given timestamp: `<yyyy-mm-dd>-<pid>.log`. */\nfunction logFileName(timestamp: number): string {\n\tconst date = new Date(timestamp);\n\tconst month = String(date.getMonth() + 1).padStart(2, \"0\");\n\tconst day = String(date.getDate()).padStart(2, \"0\");\n\treturn `${date.getFullYear()}-${month}-${day}-${process.pid}.log`;\n}\n\n/**\n * Convert an arbitrary value to JSON-safe data: cycles become \"[circular]\",\n * unserializable members become \"[unserializable]\", bigint/symbol/function are\n * stringified. Diamond references (same object in two places, no cycle) survive.\n */\nfunction toSafeJson(value: unknown): unknown {\n\tconst ancestors = new WeakSet<object>();\n\tconst walk = (input: unknown): unknown => {\n\t\tif (input === null || input === undefined) return null;\n\t\tconst kind = typeof input;\n\t\tif (kind === \"string\" || kind === \"boolean\" || kind === \"number\") return input;\n\t\tif (kind === \"bigint\") return `${String(input)}n`;\n\t\tif (kind === \"function\" || kind === \"symbol\") return \"[unserializable]\";\n\t\tconst obj = input as object;\n\t\tif (ancestors.has(obj)) return \"[circular]\";\n\t\tancestors.add(obj);\n\t\ttry {\n\t\t\tif (input instanceof Date) return input.toISOString();\n\t\t\tif (Array.isArray(input)) return input.map((item) => walk(item));\n\t\t\tconst out: Record<string, unknown> = {};\n\t\t\tfor (const [key, item] of Object.entries(input as Record<string, unknown>)) {\n\t\t\t\tout[key] = walk(item);\n\t\t\t}\n\t\t\treturn out;\n\t\t} catch {\n\t\t\treturn \"[unserializable]\";\n\t\t} finally {\n\t\t\tancestors.delete(obj);\n\t\t}\n\t};\n\treturn walk(value);\n}\n\nfunction boundedStack(stack: string | undefined): string | undefined {\n\tif (stack === undefined) return undefined;\n\tconst lines = stack.split(\"\\n\");\n\treturn lines.length <= MAX_STACK_LINES ? stack : lines.slice(0, MAX_STACK_LINES).join(\"\\n\");\n}\n\n/** Normalize a cause to bounded facts: Errors keep name/message + truncated stack, the rest become safe JSON. */\nfunction boundCause(cause: unknown): unknown {\n\tif (cause instanceof Error) {\n\t\treturn { name: cause.name, message: cause.message, stack: boundedStack(cause.stack) };\n\t}\n\treturn toSafeJson(cause);\n}\n\n/**\n * Node-default crash text for a fatal value: `name: message` plus the stack\n * for Errors (`err.stack` already opens with that header, so it is never\n * echoed twice), safe JSON for anything else.\n */\nfunction fatalStderrText(value: unknown): string {\n\tif (value instanceof Error) {\n\t\tconst header = `${value.name}: ${value.message}`;\n\t\tif (value.stack === undefined) return `${header}\\n`;\n\t\tconst body = value.stack.startsWith(`${header}\\n`) ? value.stack : `${header}\\n${value.stack}`;\n\t\treturn `${body}\\n`;\n\t}\n\treturn `${JSON.stringify(toSafeJson(value))}\\n`;\n}\n\nexport function createHostLogger(options: HostLoggerOptions): HostLogger {\n\t// 构造期校验（程序错误，非运行时降级）：非法 level 立即抛错，绝不静默回落\n\t// 默认级别——那会把配置错误伪装成\"日志变少了\"。\n\tif (options.level !== undefined && !HOST_LOG_LEVELS.includes(options.level)) {\n\t\tthrow new Error(\n\t\t\t`Host logger level must be one of ${HOST_LOG_LEVELS.map((level) => `\"${level}\"`).join(\" | \")}; got ${JSON.stringify(options.level)}`,\n\t\t);\n\t}\n\tconst minRank = LEVEL_RANK[options.level ?? \"info\"];\n\tconst now = options.now ?? Date.now;\n\tconst maxAgeDays = options.maxAgeDays ?? DEFAULT_MAX_AGE_DAYS;\n\tconst processHost = options.processHost ?? NODE_PROCESS_HOST;\n\n\tlet closed = false;\n\tlet dirReady = false;\n\tlet written = 0;\n\tlet failed = 0;\n\n\tconst write = (level: HostLogLevel, src: string, msg: string, context?: HostLogContext): void => {\n\t\tif (closed) return;\n\t\tif (LEVEL_RANK[level] < minRank) return;\n\t\tconst entry: HostLogEntry = {\n\t\t\tv: 1,\n\t\t\tt: now(),\n\t\t\tlevel,\n\t\t\tsrc,\n\t\t\tmsg,\n\t\t\tsessionId: context?.sessionId,\n\t\t\ttraceId: context?.traceId,\n\t\t\tfields: context?.fields === undefined ? undefined : (toSafeJson(context.fields) as Record<string, unknown>),\n\t\t\tcause: context?.cause === undefined ? undefined : boundCause(context.cause),\n\t\t};\n\t\ttry {\n\t\t\tif (!dirReady) {\n\t\t\t\tmkdirSync(options.dir, { recursive: true });\n\t\t\t\tdirReady = true;\n\t\t\t}\n\t\t\tappendFileSync(join(options.dir, logFileName(entry.t)), `${JSON.stringify(entry)}\\n`);\n\t\t\twritten += 1;\n\t\t} catch {\n\t\t\t// Never propagate write failures (disk full, permissions, dir is a file).\n\t\t\tfailed += 1;\n\t\t\tdirReady = false;\n\t\t}\n\t};\n\n\tconst sweep = (): void => {\n\t\tif (maxAgeDays <= 0) return;\n\t\tconst cutoff = now() - maxAgeDays * DAY_MS;\n\t\tconst currentName = logFileName(now());\n\t\tlet names: string[];\n\t\ttry {\n\t\t\tnames = readdirSync(options.dir);\n\t\t} catch (error) {\n\t\t\t// A missing directory means there is nothing to sweep; any other\n\t\t\t// read failure is a real fact and goes into the log itself.\n\t\t\tif ((error as NodeJS.ErrnoException).code === \"ENOENT\") return;\n\t\t\twrite(\"warn\", \"logger\", \"log sweep failed: cannot read log directory\", { cause: error });\n\t\t\treturn;\n\t\t}\n\t\tlet removed = 0;\n\t\tlet errors = 0;\n\t\tfor (const name of names) {\n\t\t\tif (!name.endsWith(\".log\") || name === currentName) continue;\n\t\t\tconst fullPath = join(options.dir, name);\n\t\t\ttry {\n\t\t\t\tconst stats = statSync(fullPath);\n\t\t\t\tif (!stats.isFile() || stats.mtimeMs >= cutoff) continue;\n\t\t\t\tunlinkSync(fullPath);\n\t\t\t\tremoved += 1;\n\t\t\t} catch {\n\t\t\t\terrors += 1;\n\t\t\t}\n\t\t}\n\t\tif (errors > 0) {\n\t\t\twrite(\"warn\", \"logger\", \"log sweep finished with failures\", { fields: { removed, errors } });\n\t\t}\n\t};\n\n\tsweep();\n\n\t// Registering uncaughtException/unhandledRejection listeners replaces Node's\n\t// default crash behavior, so these hooks restore it: crash text on stderr\n\t// and exit(1). Without this, a non-interactive crash (print/RPC/serve)\n\t// would leave the process running and disguise the failure as success.\n\t//\n\t// Fatal-value dedup: a rejection reason rethrown below arrives a second time\n\t// as an uncaughtException; the WeakSet keeps the log line to one write while\n\t// stderr + exit still run on every pass.\n\t//\n\t// Interactive boundary: the TUI registers its own uncaughtException handler\n\t// via `prependListener` and exits(1) first, so the uncaughtException branch\n\t// never fires under interactive mode (TUI crashes stay out of the host\n\t// log); a rejection rethrow surfaces to that prepended handler instead.\n\t//\n\t// After close(): the log line is skipped but stderr + exit still run, so a\n\t// closed logger can never swallow a crash.\n\tconst exit = processHost.exit ?? NODE_PROCESS_CRASH_HOST.exit;\n\tconst writeStderr = processHost.writeStderr ?? NODE_PROCESS_CRASH_HOST.writeStderr;\n\tconst deferThrow = processHost.deferThrow ?? NODE_PROCESS_CRASH_HOST.deferThrow;\n\tconst loggedFatalValues = new WeakSet<object>();\n\tconst isFatalValueLogged = (value: unknown): boolean =>\n\t\tvalue !== null && (typeof value === \"object\" || typeof value === \"function\") && loggedFatalValues.has(value);\n\tconst markFatalValueLogged = (value: unknown): void => {\n\t\tif (value !== null && (typeof value === \"object\" || typeof value === \"function\")) loggedFatalValues.add(value);\n\t};\n\tif (processHost.onUncaughtException) {\n\t\tprocessHost.onUncaughtException((error) => {\n\t\t\tif (!isFatalValueLogged(error)) {\n\t\t\t\tmarkFatalValueLogged(error);\n\t\t\t\twrite(\"error\", \"process\", \"uncaughtException\", { cause: error });\n\t\t\t}\n\t\t\twriteStderr(fatalStderrText(error));\n\t\t\texit(1);\n\t\t});\n\t}\n\tif (processHost.onUnhandledRejection) {\n\t\tprocessHost.onUnhandledRejection((reason) => {\n\t\t\tmarkFatalValueLogged(reason);\n\t\t\twrite(\"error\", \"process\", \"unhandledRejection\", { cause: reason });\n\t\t\tdeferThrow(() => {\n\t\t\t\tthrow reason;\n\t\t\t});\n\t\t});\n\t}\n\n\treturn {\n\t\tdebug: (src, msg, context) => write(\"debug\", src, msg, context),\n\t\tinfo: (src, msg, context) => write(\"info\", src, msg, context),\n\t\twarn: (src, msg, context) => write(\"warn\", src, msg, context),\n\t\terror: (src, msg, context) => write(\"error\", src, msg, context),\n\t\tclose: () => {\n\t\t\tclosed = true;\n\t\t\treturn { written, failed };\n\t\t},\n\t};\n}\n"]}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"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","sourcesContent":["import { appendFileSync, mkdirSync, readdirSync, statSync, unlinkSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { t } from \"./i18n/index.ts\";\n\n/**\n * Host-process logger: minimal kernel carrying-layer mechanism for runtime\n * diagnostics (design `会话轨迹与日志设计.md` §5). One JSONL entry per line,\n * written through with `appendFileSync` into `<dir>/<yyyy-mm-dd>-<pid>.log`\n * (local date). The file is created lazily on the first written entry.\n *\n * Failure contract: logging must never throw. Level filtering drops entries\n * below the configured level; write failures (disk full, permissions, bad dir)\n * are swallowed and counted, and `close()` reports `{ written, failed }`.\n * Expired log files are swept once at logger creation; sweep failures are\n * recorded as a warn entry through the logger itself.\n *\n * Crash contract: registering `uncaughtException`/`unhandledRejection`\n * listeners replaces Node's default fatal behavior, so the hooks restore it —\n * one log line per fatal value, Node-default crash text on stderr, exit(1).\n */\n\nexport type HostLogLevel = \"debug\" | \"info\" | \"warn\" | \"error\";\n\nconst LEVEL_RANK: Record<HostLogLevel, number> = { debug: 0, info: 1, warn: 2, error: 3 };\n\n/** All valid host log levels; the construction-time level check runs against this list. */\nconst HOST_LOG_LEVELS: readonly HostLogLevel[] = [\"debug\", \"info\", \"warn\", \"error\"];\n\nconst DAY_MS = 24 * 60 * 60 * 1000;\n\n/** Upper bound on retained stack lines for a logged cause. */\nconst MAX_STACK_LINES = 10;\n\n/** Default retention window for startup sweep, in days. `0` disables sweeping. */\nconst DEFAULT_MAX_AGE_DAYS = 14;\n\n/** Per-entry call-site detail. All members optional; `undefined` members are omitted from the line. */\nexport interface HostLogContext {\n\treadonly sessionId?: string;\n\treadonly traceId?: string;\n\treadonly fields?: Record<string, unknown>;\n\treadonly cause?: unknown;\n}\n\n/** One JSONL line in the host log file. */\nexport interface HostLogEntry {\n\treadonly v: 1;\n\t/** Host timestamp (epoch ms). */\n\treadonly t: number;\n\treadonly level: HostLogLevel;\n\t/** Call-site marker, e.g. \"sdk\", \"compaction\", \"process\". */\n\treadonly src: string;\n\treadonly msg: string;\n\treadonly sessionId?: string;\n\treadonly traceId?: string;\n\treadonly fields?: Record<string, unknown>;\n\t/** Bounded error facts (name/message + at most 10 stack lines, or safe JSON for non-Error values). */\n\treadonly cause?: unknown;\n}\n\nexport interface HostLoggerOptions {\n\t/** Log directory. Created recursively on first write. */\n\treadonly dir: string;\n\t/**\n\t * Minimum level to write; lower levels are dropped. Default \"info\". An\n\t * invalid level fails construction (programmer error), never a silent\n\t * fallback to a default.\n\t */\n\treadonly level?: HostLogLevel;\n\t/** Startup sweep retention in days; `0` disables sweeping. Default 14. */\n\treadonly maxAgeDays?: number;\n\t/** Injected clock for deterministic tests. Default `Date.now`. */\n\treadonly now?: () => number;\n\t/**\n\t * Injected process hooks to avoid attaching to the real process in tests.\n\t * Members left unset default to the real process.\n\t */\n\treadonly processHost?: HostProcessHost;\n}\n\n/**\n * Process-hook injection surface for the host logger. When the whole\n * processHost is omitted it falls back to the real process: both fatal hooks\n * are registered via `process.on`. With a processHost present, the two\n * registrar members are opt-in: a member left unset means that fatal hook is\n * NOT registered and there is no fallback to `process.on` — the process keeps\n * Node's default fatal behavior for that hook. The crash-restore members\n * (`exit`/`writeStderr`/`deferThrow`) fall back to the real process when\n * omitted, so tests can inject captured fakes that never exit or throw.\n */\nexport interface HostProcessHost {\n\t/**\n\t * Registrar for fatal uncaught exceptions. Omitted = no hook is registered\n\t * (no fallback to `process.on(\"uncaughtException\", cb)`).\n\t */\n\treadonly onUncaughtException?: (cb: (error: unknown) => void) => void;\n\t/**\n\t * Registrar for fatal unhandled rejections. Omitted = no hook is registered\n\t * (no fallback to `process.on(\"unhandledRejection\", cb)`).\n\t */\n\treadonly onUnhandledRejection?: (cb: (reason: unknown) => void) => void;\n\t/** Terminal exit. Omitted = falls back to the real `process.exit`. */\n\treadonly exit?: (code: number) => void;\n\t/** Crash-text sink. Omitted = falls back to the real `process.stderr.write`. */\n\treadonly writeStderr?: (chunk: string) => void;\n\t/**\n\t * Defers the rejection rethrow so it surfaces as an uncaughtException.\n\t * Omitted = falls back to the real `setImmediate(thrower)`.\n\t */\n\treadonly deferThrow?: (thrower: () => void) => void;\n}\n\nexport interface HostLoggerCloseSummary {\n\treadonly written: number;\n\treadonly failed: number;\n}\n\nexport interface HostLogger {\n\tdebug(src: string, msg: string, context?: HostLogContext): void;\n\tinfo(src: string, msg: string, context?: HostLogContext): void;\n\twarn(src: string, msg: string, context?: HostLogContext): void;\n\terror(src: string, msg: string, context?: HostLogContext): void;\n\t/**\n\t * Stop logging. Idempotent; later log calls are no-ops. Registered process\n\t * hooks stay attached: they stop writing log lines but still restore the\n\t * crash semantics (stderr + exit). Returns the write tally.\n\t */\n\tclose(): HostLoggerCloseSummary;\n}\n\n/** Real-process defaults for the crash-restore members; `Required` keeps resolved hooks callable. */\nconst NODE_PROCESS_CRASH_HOST: Required<Pick<HostProcessHost, \"exit\" | \"writeStderr\" | \"deferThrow\">> = {\n\texit(code) {\n\t\tprocess.exit(code);\n\t},\n\twriteStderr(chunk) {\n\t\tprocess.stderr.write(chunk);\n\t},\n\tdeferThrow(thrower) {\n\t\tsetImmediate(thrower);\n\t},\n};\n\nconst NODE_PROCESS_HOST: HostProcessHost = {\n\tonUncaughtException(cb) {\n\t\tprocess.on(\"uncaughtException\", cb);\n\t},\n\tonUnhandledRejection(cb) {\n\t\tprocess.on(\"unhandledRejection\", cb);\n\t},\n\t...NODE_PROCESS_CRASH_HOST,\n};\n\n/** Local-date file name for the given timestamp: `<yyyy-mm-dd>-<pid>.log`. */\nfunction logFileName(timestamp: number): string {\n\tconst date = new Date(timestamp);\n\tconst month = String(date.getMonth() + 1).padStart(2, \"0\");\n\tconst day = String(date.getDate()).padStart(2, \"0\");\n\treturn `${date.getFullYear()}-${month}-${day}-${process.pid}.log`;\n}\n\n/**\n * Convert an arbitrary value to JSON-safe data: cycles become \"[circular]\",\n * unserializable members become \"[unserializable]\", bigint/symbol/function are\n * stringified. Diamond references (same object in two places, no cycle) survive.\n */\nfunction toSafeJson(value: unknown): unknown {\n\tconst ancestors = new WeakSet<object>();\n\tconst walk = (input: unknown): unknown => {\n\t\tif (input === null || input === undefined) return null;\n\t\tconst kind = typeof input;\n\t\tif (kind === \"string\" || kind === \"boolean\" || kind === \"number\") return input;\n\t\tif (kind === \"bigint\") return `${String(input)}n`;\n\t\tif (kind === \"function\" || kind === \"symbol\") return \"[unserializable]\";\n\t\tconst obj = input as object;\n\t\tif (ancestors.has(obj)) return \"[circular]\";\n\t\tancestors.add(obj);\n\t\ttry {\n\t\t\tif (input instanceof Date) return input.toISOString();\n\t\t\tif (Array.isArray(input)) return input.map((item) => walk(item));\n\t\t\tconst out: Record<string, unknown> = {};\n\t\t\tfor (const [key, item] of Object.entries(input as Record<string, unknown>)) {\n\t\t\t\tout[key] = walk(item);\n\t\t\t}\n\t\t\treturn out;\n\t\t} catch {\n\t\t\treturn \"[unserializable]\";\n\t\t} finally {\n\t\t\tancestors.delete(obj);\n\t\t}\n\t};\n\treturn walk(value);\n}\n\nfunction boundedStack(stack: string | undefined): string | undefined {\n\tif (stack === undefined) return undefined;\n\tconst lines = stack.split(\"\\n\");\n\treturn lines.length <= MAX_STACK_LINES ? stack : lines.slice(0, MAX_STACK_LINES).join(\"\\n\");\n}\n\n/** Normalize a cause to bounded facts: Errors keep name/message + truncated stack, the rest become safe JSON. */\nfunction boundCause(cause: unknown): unknown {\n\tif (cause instanceof Error) {\n\t\treturn { name: cause.name, message: cause.message, stack: boundedStack(cause.stack) };\n\t}\n\treturn toSafeJson(cause);\n}\n\n/**\n * Node-default crash text for a fatal value: `name: message` plus the stack\n * for Errors (`err.stack` already opens with that header, so it is never\n * echoed twice), safe JSON for anything else.\n */\nfunction fatalStderrText(value: unknown): string {\n\tif (value instanceof Error) {\n\t\tconst header = `${value.name}: ${value.message}`;\n\t\tif (value.stack === undefined) return `${header}\\n`;\n\t\tconst body = value.stack.startsWith(`${header}\\n`) ? value.stack : `${header}\\n${value.stack}`;\n\t\treturn `${body}\\n`;\n\t}\n\treturn `${JSON.stringify(toSafeJson(value))}\\n`;\n}\n\nexport function createHostLogger(options: HostLoggerOptions): HostLogger {\n\t// 构造期校验（程序错误，非运行时降级）：非法 level 立即抛错，绝不静默回落\n\t// 默认级别——那会把配置错误伪装成\"日志变少了\"。\n\tif (options.level !== undefined && !HOST_LOG_LEVELS.includes(options.level)) {\n\t\tthrow new Error(\n\t\t\tt(\"Host logger level must be one of {levels}; got {value}\", {\n\t\t\t\tlevels: HOST_LOG_LEVELS.map((level) => `\"${level}\"`).join(\" | \"),\n\t\t\t\tvalue: JSON.stringify(options.level),\n\t\t\t}),\n\t\t);\n\t}\n\tconst minRank = LEVEL_RANK[options.level ?? \"info\"];\n\tconst now = options.now ?? Date.now;\n\tconst maxAgeDays = options.maxAgeDays ?? DEFAULT_MAX_AGE_DAYS;\n\tconst processHost = options.processHost ?? NODE_PROCESS_HOST;\n\n\tlet closed = false;\n\tlet dirReady = false;\n\tlet written = 0;\n\tlet failed = 0;\n\n\tconst write = (level: HostLogLevel, src: string, msg: string, context?: HostLogContext): void => {\n\t\tif (closed) return;\n\t\tif (LEVEL_RANK[level] < minRank) return;\n\t\tconst entry: HostLogEntry = {\n\t\t\tv: 1,\n\t\t\tt: now(),\n\t\t\tlevel,\n\t\t\tsrc,\n\t\t\tmsg,\n\t\t\tsessionId: context?.sessionId,\n\t\t\ttraceId: context?.traceId,\n\t\t\tfields: context?.fields === undefined ? undefined : (toSafeJson(context.fields) as Record<string, unknown>),\n\t\t\tcause: context?.cause === undefined ? undefined : boundCause(context.cause),\n\t\t};\n\t\ttry {\n\t\t\tif (!dirReady) {\n\t\t\t\tmkdirSync(options.dir, { recursive: true });\n\t\t\t\tdirReady = true;\n\t\t\t}\n\t\t\tappendFileSync(join(options.dir, logFileName(entry.t)), `${JSON.stringify(entry)}\\n`);\n\t\t\twritten += 1;\n\t\t} catch {\n\t\t\t// Never propagate write failures (disk full, permissions, dir is a file).\n\t\t\tfailed += 1;\n\t\t\tdirReady = false;\n\t\t}\n\t};\n\n\tconst sweep = (): void => {\n\t\tif (maxAgeDays <= 0) return;\n\t\tconst cutoff = now() - maxAgeDays * DAY_MS;\n\t\tconst currentName = logFileName(now());\n\t\tlet names: string[];\n\t\ttry {\n\t\t\tnames = readdirSync(options.dir);\n\t\t} catch (error) {\n\t\t\t// A missing directory means there is nothing to sweep; any other\n\t\t\t// read failure is a real fact and goes into the log itself.\n\t\t\tif ((error as NodeJS.ErrnoException).code === \"ENOENT\") return;\n\t\t\twrite(\"warn\", \"logger\", \"log sweep failed: cannot read log directory\", { cause: error });\n\t\t\treturn;\n\t\t}\n\t\tlet removed = 0;\n\t\tlet errors = 0;\n\t\tfor (const name of names) {\n\t\t\tif (!name.endsWith(\".log\") || name === currentName) continue;\n\t\t\tconst fullPath = join(options.dir, name);\n\t\t\ttry {\n\t\t\t\tconst stats = statSync(fullPath);\n\t\t\t\tif (!stats.isFile() || stats.mtimeMs >= cutoff) continue;\n\t\t\t\tunlinkSync(fullPath);\n\t\t\t\tremoved += 1;\n\t\t\t} catch {\n\t\t\t\terrors += 1;\n\t\t\t}\n\t\t}\n\t\tif (errors > 0) {\n\t\t\twrite(\"warn\", \"logger\", \"log sweep finished with failures\", { fields: { removed, errors } });\n\t\t}\n\t};\n\n\tsweep();\n\n\t// Registering uncaughtException/unhandledRejection listeners replaces Node's\n\t// default crash behavior, so these hooks restore it: crash text on stderr\n\t// and exit(1). Without this, a non-interactive crash (print/RPC/serve)\n\t// would leave the process running and disguise the failure as success.\n\t//\n\t// Fatal-value dedup: a rejection reason rethrown below arrives a second time\n\t// as an uncaughtException; the WeakSet keeps the log line to one write while\n\t// stderr + exit still run on every pass.\n\t//\n\t// Interactive boundary: the TUI registers its own uncaughtException handler\n\t// via `prependListener` and exits(1) first, so the uncaughtException branch\n\t// never fires under interactive mode (TUI crashes stay out of the host\n\t// log); a rejection rethrow surfaces to that prepended handler instead.\n\t//\n\t// After close(): the log line is skipped but stderr + exit still run, so a\n\t// closed logger can never swallow a crash.\n\tconst exit = processHost.exit ?? NODE_PROCESS_CRASH_HOST.exit;\n\tconst writeStderr = processHost.writeStderr ?? NODE_PROCESS_CRASH_HOST.writeStderr;\n\tconst deferThrow = processHost.deferThrow ?? NODE_PROCESS_CRASH_HOST.deferThrow;\n\tconst loggedFatalValues = new WeakSet<object>();\n\tconst isFatalValueLogged = (value: unknown): boolean =>\n\t\tvalue !== null && (typeof value === \"object\" || typeof value === \"function\") && loggedFatalValues.has(value);\n\tconst markFatalValueLogged = (value: unknown): void => {\n\t\tif (value !== null && (typeof value === \"object\" || typeof value === \"function\")) loggedFatalValues.add(value);\n\t};\n\tif (processHost.onUncaughtException) {\n\t\tprocessHost.onUncaughtException((error) => {\n\t\t\tif (!isFatalValueLogged(error)) {\n\t\t\t\tmarkFatalValueLogged(error);\n\t\t\t\twrite(\"error\", \"process\", \"uncaughtException\", { cause: error });\n\t\t\t}\n\t\t\twriteStderr(fatalStderrText(error));\n\t\t\texit(1);\n\t\t});\n\t}\n\tif (processHost.onUnhandledRejection) {\n\t\tprocessHost.onUnhandledRejection((reason) => {\n\t\t\tmarkFatalValueLogged(reason);\n\t\t\twrite(\"error\", \"process\", \"unhandledRejection\", { cause: reason });\n\t\t\tdeferThrow(() => {\n\t\t\t\tthrow reason;\n\t\t\t});\n\t\t});\n\t}\n\n\treturn {\n\t\tdebug: (src, msg, context) => write(\"debug\", src, msg, context),\n\t\tinfo: (src, msg, context) => write(\"info\", src, msg, context),\n\t\twarn: (src, msg, context) => write(\"warn\", src, msg, context),\n\t\terror: (src, msg, context) => write(\"error\", src, msg, context),\n\t\tclose: () => {\n\t\t\tclosed = true;\n\t\t\treturn { written, failed };\n\t\t},\n\t};\n}\n"]}

package/dist/core/logger.js

@@ -1,5 +1,6 @@
 import { appendFileSync, mkdirSync, readdirSync, statSync, unlinkSync } from "node:fs";
 import { join } from "node:path";
+import { t } from "./i18n/index.js";
 const LEVEL_RANK = { debug: 0, info: 1, warn: 2, error: 3 };
 /** All valid host log levels; the construction-time level check runs against this list. */
 const HOST_LOG_LEVELS = ["debug", "info", "warn", "error"];
@@ -109,7 +110,10 @@ export function createHostLogger(options) {
     // 构造期校验（程序错误，非运行时降级）：非法 level 立即抛错，绝不静默回落
     // 默认级别——那会把配置错误伪装成"日志变少了"。
     if (options.level !== undefined && !HOST_LOG_LEVELS.includes(options.level)) {
-        throw new Error(`Host logger level must be one of ${HOST_LOG_LEVELS.map((level) => `"${level}"`).join(" | ")}; got ${JSON.stringify(options.level)}`);
+        throw new Error(t("Host logger level must be one of {levels}; got {value}", {
+            levels: HOST_LOG_LEVELS.map((level) => `"${level}"`).join(" | "),
+            value: JSON.stringify(options.level),
+        }));
     }
     const minRank = LEVEL_RANK[options.level ?? "info"];
     const now = options.now ?? Date.now;

package/dist/core/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACvF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAqBjC,MAAM,UAAU,GAAiC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AAE1F,2FAA2F;AAC3F,MAAM,eAAe,GAA4B,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAEpF,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAEnC,8DAA8D;AAC9D,MAAM,eAAe,GAAG,EAAE,CAAC;AAE3B,kFAAkF;AAClF,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAgGhC,qGAAqG;AACrG,MAAM,uBAAuB,GAA2E;IACvG,IAAI,CAAC,IAAI,EAAE;QACV,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAAA,CACnB;IACD,WAAW,CAAC,KAAK,EAAE;QAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAAA,CAC5B;IACD,UAAU,CAAC,OAAO,EAAE;QACnB,YAAY,CAAC,OAAO,CAAC,CAAC;IAAA,CACtB;CACD,CAAC;AAEF,MAAM,iBAAiB,GAAoB;IAC1C,mBAAmB,CAAC,EAAE,EAAE;QACvB,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;IAAA,CACpC;IACD,oBAAoB,CAAC,EAAE,EAAE;QACxB,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;IAAA,CACrC;IACD,GAAG,uBAAuB;CAC1B,CAAC;AAEF,8EAA8E;AAC9E,SAAS,WAAW,CAAC,SAAiB,EAAU;IAC/C,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC;IACjC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC3D,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACpD,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,KAAK,IAAI,GAAG,IAAI,OAAO,CAAC,GAAG,MAAM,CAAC;AAAA,CAClE;AAED;;;;GAIG;AACH,SAAS,UAAU,CAAC,KAAc,EAAW;IAC5C,MAAM,SAAS,GAAG,IAAI,OAAO,EAAU,CAAC;IACxC,MAAM,IAAI,GAAG,CAAC,KAAc,EAAW,EAAE,CAAC;QACzC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACvD,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC;QAC1B,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC/E,IAAI,IAAI,KAAK,QAAQ;YAAE,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;QAClD,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,QAAQ;YAAE,OAAO,kBAAkB,CAAC;QACxE,MAAM,GAAG,GAAG,KAAe,CAAC;QAC5B,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,YAAY,CAAC;QAC5C,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC;YACJ,IAAI,KAAK,YAAY,IAAI;gBAAE,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;YACtD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACjE,MAAM,GAAG,GAA4B,EAAE,CAAC;YACxC,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;gBAC5E,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;YACvB,CAAC;YACD,OAAO,GAAG,CAAC;QACZ,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,kBAAkB,CAAC;QAC3B,CAAC;gBAAS,CAAC;YACV,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;IAAA,CACD,CAAC;IACF,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;AAAA,CACnB;AAED,SAAS,YAAY,CAAC,KAAyB,EAAsB;IACpE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChC,OAAO,KAAK,CAAC,MAAM,IAAI,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAAA,CAC5F;AAED,iHAAiH;AACjH,SAAS,UAAU,CAAC,KAAc,EAAW;IAC5C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC5B,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;IACvF,CAAC;IACD,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;AAAA,CACzB;AAED;;;;GAIG;AACH,SAAS,eAAe,CAAC,KAAc,EAAU;IAChD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;QACjD,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;YAAE,OAAO,GAAG,MAAM,IAAI,CAAC;QACpD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/F,OAAO,GAAG,IAAI,IAAI,CAAC;IACpB,CAAC;IACD,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC;AAAA,CAChD;AAED,MAAM,UAAU,gBAAgB,CAAC,OAA0B,EAAc;IACxE,0GAA0C;IAC1C,uEAA2B;IAC3B,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7E,MAAM,IAAI,KAAK,CACd,oCAAoC,eAAe,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CACpI,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACpC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,oBAAoB,CAAC;IAC9D,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,iBAAiB,CAAC;IAE7D,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf,MAAM,KAAK,GAAG,CAAC,KAAmB,EAAE,GAAW,EAAE,GAAW,EAAE,OAAwB,EAAQ,EAAE,CAAC;QAChG,IAAI,MAAM;YAAE,OAAO;QACnB,IAAI,UAAU,CAAC,KAAK,CAAC,GAAG,OAAO;YAAE,OAAO;QACxC,MAAM,KAAK,GAAiB;YAC3B,CAAC,EAAE,CAAC;YACJ,CAAC,EAAE,GAAG,EAAE;YACR,KAAK;YACL,GAAG;YACH,GAAG;YACH,SAAS,EAAE,OAAO,EAAE,SAAS;YAC7B,OAAO,EAAE,OAAO,EAAE,OAAO;YACzB,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,UAAU,CAAC,OAAO,CAAC,MAAM,CAA6B;YAC3G,KAAK,EAAE,OAAO,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC;SAC3E,CAAC;QACF,IAAI,CAAC;YACJ,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACf,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC5C,QAAQ,GAAG,IAAI,CAAC;YACjB,CAAC;YACD,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACtF,OAAO,IAAI,CAAC,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACR,0EAA0E;YAC1E,MAAM,IAAI,CAAC,CAAC;YACZ,QAAQ,GAAG,KAAK,CAAC;QAClB,CAAC;IAAA,CACD,CAAC;IAEF,MAAM,KAAK,GAAG,GAAS,EAAE,CAAC;QACzB,IAAI,UAAU,IAAI,CAAC;YAAE,OAAO;QAC5B,MAAM,MAAM,GAAG,GAAG,EAAE,GAAG,UAAU,GAAG,MAAM,CAAC;QAC3C,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC;QACvC,IAAI,KAAe,CAAC;QACpB,IAAI,CAAC;YACJ,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,iEAAiE;YACjE,4DAA4D;YAC5D,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO;YAC/D,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,6CAA6C,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YACzF,OAAO;QACR,CAAC;QACD,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YAC1B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,KAAK,WAAW;gBAAE,SAAS;YAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACzC,IAAI,CAAC;gBACJ,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBACjC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,OAAO,IAAI,MAAM;oBAAE,SAAS;gBACzD,UAAU,CAAC,QAAQ,CAAC,CAAC;gBACrB,OAAO,IAAI,CAAC,CAAC;YACd,CAAC;YAAC,MAAM,CAAC;gBACR,MAAM,IAAI,CAAC,CAAC;YACb,CAAC;QACF,CAAC;QACD,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YAChB,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,kCAAkC,EAAE,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;QAC9F,CAAC;IAAA,CACD,CAAC;IAEF,KAAK,EAAE,CAAC;IAER,6EAA6E;IAC7E,0EAA0E;IAC1E,uEAAuE;IACvE,uEAAuE;IACvE,EAAE;IACF,6EAA6E;IAC7E,6EAA6E;IAC7E,yCAAyC;IACzC,EAAE;IACF,4EAA4E;IAC5E,4EAA4E;IAC5E,uEAAuE;IACvE,wEAAwE;IACxE,EAAE;IACF,2EAA2E;IAC3E,2CAA2C;IAC3C,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,IAAI,uBAAuB,CAAC,IAAI,CAAC;IAC9D,MAAM,WAAW,GAAG,WAAW,CAAC,WAAW,IAAI,uBAAuB,CAAC,WAAW,CAAC;IACnF,MAAM,UAAU,GAAG,WAAW,CAAC,UAAU,IAAI,uBAAuB,CAAC,UAAU,CAAC;IAChF,MAAM,iBAAiB,GAAG,IAAI,OAAO,EAAU,CAAC;IAChD,MAAM,kBAAkB,GAAG,CAAC,KAAc,EAAW,EAAE,CACtD,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC,IAAI,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC9G,MAAM,oBAAoB,GAAG,CAAC,KAAc,EAAQ,EAAE,CAAC;QACtD,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC;YAAE,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAAA,CAC/G,CAAC;IACF,IAAI,WAAW,CAAC,mBAAmB,EAAE,CAAC;QACrC,WAAW,CAAC,mBAAmB,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;YAC1C,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;gBAChC,oBAAoB,CAAC,KAAK,CAAC,CAAC;gBAC5B,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YAClE,CAAC;YACD,WAAW,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;YACpC,IAAI,CAAC,CAAC,CAAC,CAAC;QAAA,CACR,CAAC,CAAC;IACJ,CAAC;IACD,IAAI,WAAW,CAAC,oBAAoB,EAAE,CAAC;QACtC,WAAW,CAAC,oBAAoB,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;YAC5C,oBAAoB,CAAC,MAAM,CAAC,CAAC;YAC7B,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;YACnE,UAAU,CAAC,GAAG,EAAE,CAAC;gBAChB,MAAM,MAAM,CAAC;YAAA,CACb,CAAC,CAAC;QAAA,CACH,CAAC,CAAC;IACJ,CAAC;IAED,OAAO;QACN,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC;QAC/D,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC;QAC7D,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC;QAC7D,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC;QAC/D,KAAK,EAAE,GAAG,EAAE,CAAC;YACZ,MAAM,GAAG,IAAI,CAAC;YACd,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAA,CAC3B;KACD,CAAC;AAAA,CACF","sourcesContent":["import { appendFileSync, mkdirSync, readdirSync, statSync, unlinkSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\n/**\n * Host-process logger: minimal kernel carrying-layer mechanism for runtime\n * diagnostics (design `会话轨迹与日志设计.md` §5). One JSONL entry per line,\n * written through with `appendFileSync` into `<dir>/<yyyy-mm-dd>-<pid>.log`\n * (local date). The file is created lazily on the first written entry.\n *\n * Failure contract: logging must never throw. Level filtering drops entries\n * below the configured level; write failures (disk full, permissions, bad dir)\n * are swallowed and counted, and `close()` reports `{ written, failed }`.\n * Expired log files are swept once at logger creation; sweep failures are\n * recorded as a warn entry through the logger itself.\n *\n * Crash contract: registering `uncaughtException`/`unhandledRejection`\n * listeners replaces Node's default fatal behavior, so the hooks restore it —\n * one log line per fatal value, Node-default crash text on stderr, exit(1).\n */\n\nexport type HostLogLevel = \"debug\" | \"info\" | \"warn\" | \"error\";\n\nconst LEVEL_RANK: Record<HostLogLevel, number> = { debug: 0, info: 1, warn: 2, error: 3 };\n\n/** All valid host log levels; the construction-time level check runs against this list. */\nconst HOST_LOG_LEVELS: readonly HostLogLevel[] = [\"debug\", \"info\", \"warn\", \"error\"];\n\nconst DAY_MS = 24 * 60 * 60 * 1000;\n\n/** Upper bound on retained stack lines for a logged cause. */\nconst MAX_STACK_LINES = 10;\n\n/** Default retention window for startup sweep, in days. `0` disables sweeping. */\nconst DEFAULT_MAX_AGE_DAYS = 14;\n\n/** Per-entry call-site detail. All members optional; `undefined` members are omitted from the line. */\nexport interface HostLogContext {\n\treadonly sessionId?: string;\n\treadonly traceId?: string;\n\treadonly fields?: Record<string, unknown>;\n\treadonly cause?: unknown;\n}\n\n/** One JSONL line in the host log file. */\nexport interface HostLogEntry {\n\treadonly v: 1;\n\t/** Host timestamp (epoch ms). */\n\treadonly t: number;\n\treadonly level: HostLogLevel;\n\t/** Call-site marker, e.g. \"sdk\", \"compaction\", \"process\". */\n\treadonly src: string;\n\treadonly msg: string;\n\treadonly sessionId?: string;\n\treadonly traceId?: string;\n\treadonly fields?: Record<string, unknown>;\n\t/** Bounded error facts (name/message + at most 10 stack lines, or safe JSON for non-Error values). */\n\treadonly cause?: unknown;\n}\n\nexport interface HostLoggerOptions {\n\t/** Log directory. Created recursively on first write. */\n\treadonly dir: string;\n\t/**\n\t * Minimum level to write; lower levels are dropped. Default \"info\". An\n\t * invalid level fails construction (programmer error), never a silent\n\t * fallback to a default.\n\t */\n\treadonly level?: HostLogLevel;\n\t/** Startup sweep retention in days; `0` disables sweeping. Default 14. */\n\treadonly maxAgeDays?: number;\n\t/** Injected clock for deterministic tests. Default `Date.now`. */\n\treadonly now?: () => number;\n\t/**\n\t * Injected process hooks to avoid attaching to the real process in tests.\n\t * Members left unset default to the real process.\n\t */\n\treadonly processHost?: HostProcessHost;\n}\n\n/**\n * Process-hook injection surface for the host logger. When the whole\n * processHost is omitted it falls back to the real process: both fatal hooks\n * are registered via `process.on`. With a processHost present, the two\n * registrar members are opt-in: a member left unset means that fatal hook is\n * NOT registered and there is no fallback to `process.on` — the process keeps\n * Node's default fatal behavior for that hook. The crash-restore members\n * (`exit`/`writeStderr`/`deferThrow`) fall back to the real process when\n * omitted, so tests can inject captured fakes that never exit or throw.\n */\nexport interface HostProcessHost {\n\t/**\n\t * Registrar for fatal uncaught exceptions. Omitted = no hook is registered\n\t * (no fallback to `process.on(\"uncaughtException\", cb)`).\n\t */\n\treadonly onUncaughtException?: (cb: (error: unknown) => void) => void;\n\t/**\n\t * Registrar for fatal unhandled rejections. Omitted = no hook is registered\n\t * (no fallback to `process.on(\"unhandledRejection\", cb)`).\n\t */\n\treadonly onUnhandledRejection?: (cb: (reason: unknown) => void) => void;\n\t/** Terminal exit. Omitted = falls back to the real `process.exit`. */\n\treadonly exit?: (code: number) => void;\n\t/** Crash-text sink. Omitted = falls back to the real `process.stderr.write`. */\n\treadonly writeStderr?: (chunk: string) => void;\n\t/**\n\t * Defers the rejection rethrow so it surfaces as an uncaughtException.\n\t * Omitted = falls back to the real `setImmediate(thrower)`.\n\t */\n\treadonly deferThrow?: (thrower: () => void) => void;\n}\n\nexport interface HostLoggerCloseSummary {\n\treadonly written: number;\n\treadonly failed: number;\n}\n\nexport interface HostLogger {\n\tdebug(src: string, msg: string, context?: HostLogContext): void;\n\tinfo(src: string, msg: string, context?: HostLogContext): void;\n\twarn(src: string, msg: string, context?: HostLogContext): void;\n\terror(src: string, msg: string, context?: HostLogContext): void;\n\t/**\n\t * Stop logging. Idempotent; later log calls are no-ops. Registered process\n\t * hooks stay attached: they stop writing log lines but still restore the\n\t * crash semantics (stderr + exit). Returns the write tally.\n\t */\n\tclose(): HostLoggerCloseSummary;\n}\n\n/** Real-process defaults for the crash-restore members; `Required` keeps resolved hooks callable. */\nconst NODE_PROCESS_CRASH_HOST: Required<Pick<HostProcessHost, \"exit\" | \"writeStderr\" | \"deferThrow\">> = {\n\texit(code) {\n\t\tprocess.exit(code);\n\t},\n\twriteStderr(chunk) {\n\t\tprocess.stderr.write(chunk);\n\t},\n\tdeferThrow(thrower) {\n\t\tsetImmediate(thrower);\n\t},\n};\n\nconst NODE_PROCESS_HOST: HostProcessHost = {\n\tonUncaughtException(cb) {\n\t\tprocess.on(\"uncaughtException\", cb);\n\t},\n\tonUnhandledRejection(cb) {\n\t\tprocess.on(\"unhandledRejection\", cb);\n\t},\n\t...NODE_PROCESS_CRASH_HOST,\n};\n\n/** Local-date file name for the given timestamp: `<yyyy-mm-dd>-<pid>.log`. */\nfunction logFileName(timestamp: number): string {\n\tconst date = new Date(timestamp);\n\tconst month = String(date.getMonth() + 1).padStart(2, \"0\");\n\tconst day = String(date.getDate()).padStart(2, \"0\");\n\treturn `${date.getFullYear()}-${month}-${day}-${process.pid}.log`;\n}\n\n/**\n * Convert an arbitrary value to JSON-safe data: cycles become \"[circular]\",\n * unserializable members become \"[unserializable]\", bigint/symbol/function are\n * stringified. Diamond references (same object in two places, no cycle) survive.\n */\nfunction toSafeJson(value: unknown): unknown {\n\tconst ancestors = new WeakSet<object>();\n\tconst walk = (input: unknown): unknown => {\n\t\tif (input === null || input === undefined) return null;\n\t\tconst kind = typeof input;\n\t\tif (kind === \"string\" || kind === \"boolean\" || kind === \"number\") return input;\n\t\tif (kind === \"bigint\") return `${String(input)}n`;\n\t\tif (kind === \"function\" || kind === \"symbol\") return \"[unserializable]\";\n\t\tconst obj = input as object;\n\t\tif (ancestors.has(obj)) return \"[circular]\";\n\t\tancestors.add(obj);\n\t\ttry {\n\t\t\tif (input instanceof Date) return input.toISOString();\n\t\t\tif (Array.isArray(input)) return input.map((item) => walk(item));\n\t\t\tconst out: Record<string, unknown> = {};\n\t\t\tfor (const [key, item] of Object.entries(input as Record<string, unknown>)) {\n\t\t\t\tout[key] = walk(item);\n\t\t\t}\n\t\t\treturn out;\n\t\t} catch {\n\t\t\treturn \"[unserializable]\";\n\t\t} finally {\n\t\t\tancestors.delete(obj);\n\t\t}\n\t};\n\treturn walk(value);\n}\n\nfunction boundedStack(stack: string | undefined): string | undefined {\n\tif (stack === undefined) return undefined;\n\tconst lines = stack.split(\"\\n\");\n\treturn lines.length <= MAX_STACK_LINES ? stack : lines.slice(0, MAX_STACK_LINES).join(\"\\n\");\n}\n\n/** Normalize a cause to bounded facts: Errors keep name/message + truncated stack, the rest become safe JSON. */\nfunction boundCause(cause: unknown): unknown {\n\tif (cause instanceof Error) {\n\t\treturn { name: cause.name, message: cause.message, stack: boundedStack(cause.stack) };\n\t}\n\treturn toSafeJson(cause);\n}\n\n/**\n * Node-default crash text for a fatal value: `name: message` plus the stack\n * for Errors (`err.stack` already opens with that header, so it is never\n * echoed twice), safe JSON for anything else.\n */\nfunction fatalStderrText(value: unknown): string {\n\tif (value instanceof Error) {\n\t\tconst header = `${value.name}: ${value.message}`;\n\t\tif (value.stack === undefined) return `${header}\\n`;\n\t\tconst body = value.stack.startsWith(`${header}\\n`) ? value.stack : `${header}\\n${value.stack}`;\n\t\treturn `${body}\\n`;\n\t}\n\treturn `${JSON.stringify(toSafeJson(value))}\\n`;\n}\n\nexport function createHostLogger(options: HostLoggerOptions): HostLogger {\n\t// 构造期校验（程序错误，非运行时降级）：非法 level 立即抛错，绝不静默回落\n\t// 默认级别——那会把配置错误伪装成\"日志变少了\"。\n\tif (options.level !== undefined && !HOST_LOG_LEVELS.includes(options.level)) {\n\t\tthrow new Error(\n\t\t\t`Host logger level must be one of ${HOST_LOG_LEVELS.map((level) => `\"${level}\"`).join(\" | \")}; got ${JSON.stringify(options.level)}`,\n\t\t);\n\t}\n\tconst minRank = LEVEL_RANK[options.level ?? \"info\"];\n\tconst now = options.now ?? Date.now;\n\tconst maxAgeDays = options.maxAgeDays ?? DEFAULT_MAX_AGE_DAYS;\n\tconst processHost = options.processHost ?? NODE_PROCESS_HOST;\n\n\tlet closed = false;\n\tlet dirReady = false;\n\tlet written = 0;\n\tlet failed = 0;\n\n\tconst write = (level: HostLogLevel, src: string, msg: string, context?: HostLogContext): void => {\n\t\tif (closed) return;\n\t\tif (LEVEL_RANK[level] < minRank) return;\n\t\tconst entry: HostLogEntry = {\n\t\t\tv: 1,\n\t\t\tt: now(),\n\t\t\tlevel,\n\t\t\tsrc,\n\t\t\tmsg,\n\t\t\tsessionId: context?.sessionId,\n\t\t\ttraceId: context?.traceId,\n\t\t\tfields: context?.fields === undefined ? undefined : (toSafeJson(context.fields) as Record<string, unknown>),\n\t\t\tcause: context?.cause === undefined ? undefined : boundCause(context.cause),\n\t\t};\n\t\ttry {\n\t\t\tif (!dirReady) {\n\t\t\t\tmkdirSync(options.dir, { recursive: true });\n\t\t\t\tdirReady = true;\n\t\t\t}\n\t\t\tappendFileSync(join(options.dir, logFileName(entry.t)), `${JSON.stringify(entry)}\\n`);\n\t\t\twritten += 1;\n\t\t} catch {\n\t\t\t// Never propagate write failures (disk full, permissions, dir is a file).\n\t\t\tfailed += 1;\n\t\t\tdirReady = false;\n\t\t}\n\t};\n\n\tconst sweep = (): void => {\n\t\tif (maxAgeDays <= 0) return;\n\t\tconst cutoff = now() - maxAgeDays * DAY_MS;\n\t\tconst currentName = logFileName(now());\n\t\tlet names: string[];\n\t\ttry {\n\t\t\tnames = readdirSync(options.dir);\n\t\t} catch (error) {\n\t\t\t// A missing directory means there is nothing to sweep; any other\n\t\t\t// read failure is a real fact and goes into the log itself.\n\t\t\tif ((error as NodeJS.ErrnoException).code === \"ENOENT\") return;\n\t\t\twrite(\"warn\", \"logger\", \"log sweep failed: cannot read log directory\", { cause: error });\n\t\t\treturn;\n\t\t}\n\t\tlet removed = 0;\n\t\tlet errors = 0;\n\t\tfor (const name of names) {\n\t\t\tif (!name.endsWith(\".log\") || name === currentName) continue;\n\t\t\tconst fullPath = join(options.dir, name);\n\t\t\ttry {\n\t\t\t\tconst stats = statSync(fullPath);\n\t\t\t\tif (!stats.isFile() || stats.mtimeMs >= cutoff) continue;\n\t\t\t\tunlinkSync(fullPath);\n\t\t\t\tremoved += 1;\n\t\t\t} catch {\n\t\t\t\terrors += 1;\n\t\t\t}\n\t\t}\n\t\tif (errors > 0) {\n\t\t\twrite(\"warn\", \"logger\", \"log sweep finished with failures\", { fields: { removed, errors } });\n\t\t}\n\t};\n\n\tsweep();\n\n\t// Registering uncaughtException/unhandledRejection listeners replaces Node's\n\t// default crash behavior, so these hooks restore it: crash text on stderr\n\t// and exit(1). Without this, a non-interactive crash (print/RPC/serve)\n\t// would leave the process running and disguise the failure as success.\n\t//\n\t// Fatal-value dedup: a rejection reason rethrown below arrives a second time\n\t// as an uncaughtException; the WeakSet keeps the log line to one write while\n\t// stderr + exit still run on every pass.\n\t//\n\t// Interactive boundary: the TUI registers its own uncaughtException handler\n\t// via `prependListener` and exits(1) first, so the uncaughtException branch\n\t// never fires under interactive mode (TUI crashes stay out of the host\n\t// log); a rejection rethrow surfaces to that prepended handler instead.\n\t//\n\t// After close(): the log line is skipped but stderr + exit still run, so a\n\t// closed logger can never swallow a crash.\n\tconst exit = processHost.exit ?? NODE_PROCESS_CRASH_HOST.exit;\n\tconst writeStderr = processHost.writeStderr ?? NODE_PROCESS_CRASH_HOST.writeStderr;\n\tconst deferThrow = processHost.deferThrow ?? NODE_PROCESS_CRASH_HOST.deferThrow;\n\tconst loggedFatalValues = new WeakSet<object>();\n\tconst isFatalValueLogged = (value: unknown): boolean =>\n\t\tvalue !== null && (typeof value === \"object\" || typeof value === \"function\") && loggedFatalValues.has(value);\n\tconst markFatalValueLogged = (value: unknown): void => {\n\t\tif (value !== null && (typeof value === \"object\" || typeof value === \"function\")) loggedFatalValues.add(value);\n\t};\n\tif (processHost.onUncaughtException) {\n\t\tprocessHost.onUncaughtException((error) => {\n\t\t\tif (!isFatalValueLogged(error)) {\n\t\t\t\tmarkFatalValueLogged(error);\n\t\t\t\twrite(\"error\", \"process\", \"uncaughtException\", { cause: error });\n\t\t\t}\n\t\t\twriteStderr(fatalStderrText(error));\n\t\t\texit(1);\n\t\t});\n\t}\n\tif (processHost.onUnhandledRejection) {\n\t\tprocessHost.onUnhandledRejection((reason) => {\n\t\t\tmarkFatalValueLogged(reason);\n\t\t\twrite(\"error\", \"process\", \"unhandledRejection\", { cause: reason });\n\t\t\tdeferThrow(() => {\n\t\t\t\tthrow reason;\n\t\t\t});\n\t\t});\n\t}\n\n\treturn {\n\t\tdebug: (src, msg, context) => write(\"debug\", src, msg, context),\n\t\tinfo: (src, msg, context) => write(\"info\", src, msg, context),\n\t\twarn: (src, msg, context) => write(\"warn\", src, msg, context),\n\t\terror: (src, msg, context) => write(\"error\", src, msg, context),\n\t\tclose: () => {\n\t\t\tclosed = true;\n\t\t\treturn { written, failed };\n\t\t},\n\t};\n}\n"]}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"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","sourcesContent":["import { appendFileSync, mkdirSync, readdirSync, statSync, unlinkSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { t } from \"./i18n/index.ts\";\n\n/**\n * Host-process logger: minimal kernel carrying-layer mechanism for runtime\n * diagnostics (design `会话轨迹与日志设计.md` §5). One JSONL entry per line,\n * written through with `appendFileSync` into `<dir>/<yyyy-mm-dd>-<pid>.log`\n * (local date). The file is created lazily on the first written entry.\n *\n * Failure contract: logging must never throw. Level filtering drops entries\n * below the configured level; write failures (disk full, permissions, bad dir)\n * are swallowed and counted, and `close()` reports `{ written, failed }`.\n * Expired log files are swept once at logger creation; sweep failures are\n * recorded as a warn entry through the logger itself.\n *\n * Crash contract: registering `uncaughtException`/`unhandledRejection`\n * listeners replaces Node's default fatal behavior, so the hooks restore it —\n * one log line per fatal value, Node-default crash text on stderr, exit(1).\n */\n\nexport type HostLogLevel = \"debug\" | \"info\" | \"warn\" | \"error\";\n\nconst LEVEL_RANK: Record<HostLogLevel, number> = { debug: 0, info: 1, warn: 2, error: 3 };\n\n/** All valid host log levels; the construction-time level check runs against this list. */\nconst HOST_LOG_LEVELS: readonly HostLogLevel[] = [\"debug\", \"info\", \"warn\", \"error\"];\n\nconst DAY_MS = 24 * 60 * 60 * 1000;\n\n/** Upper bound on retained stack lines for a logged cause. */\nconst MAX_STACK_LINES = 10;\n\n/** Default retention window for startup sweep, in days. `0` disables sweeping. */\nconst DEFAULT_MAX_AGE_DAYS = 14;\n\n/** Per-entry call-site detail. All members optional; `undefined` members are omitted from the line. */\nexport interface HostLogContext {\n\treadonly sessionId?: string;\n\treadonly traceId?: string;\n\treadonly fields?: Record<string, unknown>;\n\treadonly cause?: unknown;\n}\n\n/** One JSONL line in the host log file. */\nexport interface HostLogEntry {\n\treadonly v: 1;\n\t/** Host timestamp (epoch ms). */\n\treadonly t: number;\n\treadonly level: HostLogLevel;\n\t/** Call-site marker, e.g. \"sdk\", \"compaction\", \"process\". */\n\treadonly src: string;\n\treadonly msg: string;\n\treadonly sessionId?: string;\n\treadonly traceId?: string;\n\treadonly fields?: Record<string, unknown>;\n\t/** Bounded error facts (name/message + at most 10 stack lines, or safe JSON for non-Error values). */\n\treadonly cause?: unknown;\n}\n\nexport interface HostLoggerOptions {\n\t/** Log directory. Created recursively on first write. */\n\treadonly dir: string;\n\t/**\n\t * Minimum level to write; lower levels are dropped. Default \"info\". An\n\t * invalid level fails construction (programmer error), never a silent\n\t * fallback to a default.\n\t */\n\treadonly level?: HostLogLevel;\n\t/** Startup sweep retention in days; `0` disables sweeping. Default 14. */\n\treadonly maxAgeDays?: number;\n\t/** Injected clock for deterministic tests. Default `Date.now`. */\n\treadonly now?: () => number;\n\t/**\n\t * Injected process hooks to avoid attaching to the real process in tests.\n\t * Members left unset default to the real process.\n\t */\n\treadonly processHost?: HostProcessHost;\n}\n\n/**\n * Process-hook injection surface for the host logger. When the whole\n * processHost is omitted it falls back to the real process: both fatal hooks\n * are registered via `process.on`. With a processHost present, the two\n * registrar members are opt-in: a member left unset means that fatal hook is\n * NOT registered and there is no fallback to `process.on` — the process keeps\n * Node's default fatal behavior for that hook. The crash-restore members\n * (`exit`/`writeStderr`/`deferThrow`) fall back to the real process when\n * omitted, so tests can inject captured fakes that never exit or throw.\n */\nexport interface HostProcessHost {\n\t/**\n\t * Registrar for fatal uncaught exceptions. Omitted = no hook is registered\n\t * (no fallback to `process.on(\"uncaughtException\", cb)`).\n\t */\n\treadonly onUncaughtException?: (cb: (error: unknown) => void) => void;\n\t/**\n\t * Registrar for fatal unhandled rejections. Omitted = no hook is registered\n\t * (no fallback to `process.on(\"unhandledRejection\", cb)`).\n\t */\n\treadonly onUnhandledRejection?: (cb: (reason: unknown) => void) => void;\n\t/** Terminal exit. Omitted = falls back to the real `process.exit`. */\n\treadonly exit?: (code: number) => void;\n\t/** Crash-text sink. Omitted = falls back to the real `process.stderr.write`. */\n\treadonly writeStderr?: (chunk: string) => void;\n\t/**\n\t * Defers the rejection rethrow so it surfaces as an uncaughtException.\n\t * Omitted = falls back to the real `setImmediate(thrower)`.\n\t */\n\treadonly deferThrow?: (thrower: () => void) => void;\n}\n\nexport interface HostLoggerCloseSummary {\n\treadonly written: number;\n\treadonly failed: number;\n}\n\nexport interface HostLogger {\n\tdebug(src: string, msg: string, context?: HostLogContext): void;\n\tinfo(src: string, msg: string, context?: HostLogContext): void;\n\twarn(src: string, msg: string, context?: HostLogContext): void;\n\terror(src: string, msg: string, context?: HostLogContext): void;\n\t/**\n\t * Stop logging. Idempotent; later log calls are no-ops. Registered process\n\t * hooks stay attached: they stop writing log lines but still restore the\n\t * crash semantics (stderr + exit). Returns the write tally.\n\t */\n\tclose(): HostLoggerCloseSummary;\n}\n\n/** Real-process defaults for the crash-restore members; `Required` keeps resolved hooks callable. */\nconst NODE_PROCESS_CRASH_HOST: Required<Pick<HostProcessHost, \"exit\" | \"writeStderr\" | \"deferThrow\">> = {\n\texit(code) {\n\t\tprocess.exit(code);\n\t},\n\twriteStderr(chunk) {\n\t\tprocess.stderr.write(chunk);\n\t},\n\tdeferThrow(thrower) {\n\t\tsetImmediate(thrower);\n\t},\n};\n\nconst NODE_PROCESS_HOST: HostProcessHost = {\n\tonUncaughtException(cb) {\n\t\tprocess.on(\"uncaughtException\", cb);\n\t},\n\tonUnhandledRejection(cb) {\n\t\tprocess.on(\"unhandledRejection\", cb);\n\t},\n\t...NODE_PROCESS_CRASH_HOST,\n};\n\n/** Local-date file name for the given timestamp: `<yyyy-mm-dd>-<pid>.log`. */\nfunction logFileName(timestamp: number): string {\n\tconst date = new Date(timestamp);\n\tconst month = String(date.getMonth() + 1).padStart(2, \"0\");\n\tconst day = String(date.getDate()).padStart(2, \"0\");\n\treturn `${date.getFullYear()}-${month}-${day}-${process.pid}.log`;\n}\n\n/**\n * Convert an arbitrary value to JSON-safe data: cycles become \"[circular]\",\n * unserializable members become \"[unserializable]\", bigint/symbol/function are\n * stringified. Diamond references (same object in two places, no cycle) survive.\n */\nfunction toSafeJson(value: unknown): unknown {\n\tconst ancestors = new WeakSet<object>();\n\tconst walk = (input: unknown): unknown => {\n\t\tif (input === null || input === undefined) return null;\n\t\tconst kind = typeof input;\n\t\tif (kind === \"string\" || kind === \"boolean\" || kind === \"number\") return input;\n\t\tif (kind === \"bigint\") return `${String(input)}n`;\n\t\tif (kind === \"function\" || kind === \"symbol\") return \"[unserializable]\";\n\t\tconst obj = input as object;\n\t\tif (ancestors.has(obj)) return \"[circular]\";\n\t\tancestors.add(obj);\n\t\ttry {\n\t\t\tif (input instanceof Date) return input.toISOString();\n\t\t\tif (Array.isArray(input)) return input.map((item) => walk(item));\n\t\t\tconst out: Record<string, unknown> = {};\n\t\t\tfor (const [key, item] of Object.entries(input as Record<string, unknown>)) {\n\t\t\t\tout[key] = walk(item);\n\t\t\t}\n\t\t\treturn out;\n\t\t} catch {\n\t\t\treturn \"[unserializable]\";\n\t\t} finally {\n\t\t\tancestors.delete(obj);\n\t\t}\n\t};\n\treturn walk(value);\n}\n\nfunction boundedStack(stack: string | undefined): string | undefined {\n\tif (stack === undefined) return undefined;\n\tconst lines = stack.split(\"\\n\");\n\treturn lines.length <= MAX_STACK_LINES ? stack : lines.slice(0, MAX_STACK_LINES).join(\"\\n\");\n}\n\n/** Normalize a cause to bounded facts: Errors keep name/message + truncated stack, the rest become safe JSON. */\nfunction boundCause(cause: unknown): unknown {\n\tif (cause instanceof Error) {\n\t\treturn { name: cause.name, message: cause.message, stack: boundedStack(cause.stack) };\n\t}\n\treturn toSafeJson(cause);\n}\n\n/**\n * Node-default crash text for a fatal value: `name: message` plus the stack\n * for Errors (`err.stack` already opens with that header, so it is never\n * echoed twice), safe JSON for anything else.\n */\nfunction fatalStderrText(value: unknown): string {\n\tif (value instanceof Error) {\n\t\tconst header = `${value.name}: ${value.message}`;\n\t\tif (value.stack === undefined) return `${header}\\n`;\n\t\tconst body = value.stack.startsWith(`${header}\\n`) ? value.stack : `${header}\\n${value.stack}`;\n\t\treturn `${body}\\n`;\n\t}\n\treturn `${JSON.stringify(toSafeJson(value))}\\n`;\n}\n\nexport function createHostLogger(options: HostLoggerOptions): HostLogger {\n\t// 构造期校验（程序错误，非运行时降级）：非法 level 立即抛错，绝不静默回落\n\t// 默认级别——那会把配置错误伪装成\"日志变少了\"。\n\tif (options.level !== undefined && !HOST_LOG_LEVELS.includes(options.level)) {\n\t\tthrow new Error(\n\t\t\tt(\"Host logger level must be one of {levels}; got {value}\", {\n\t\t\t\tlevels: HOST_LOG_LEVELS.map((level) => `\"${level}\"`).join(\" | \"),\n\t\t\t\tvalue: JSON.stringify(options.level),\n\t\t\t}),\n\t\t);\n\t}\n\tconst minRank = LEVEL_RANK[options.level ?? \"info\"];\n\tconst now = options.now ?? Date.now;\n\tconst maxAgeDays = options.maxAgeDays ?? DEFAULT_MAX_AGE_DAYS;\n\tconst processHost = options.processHost ?? NODE_PROCESS_HOST;\n\n\tlet closed = false;\n\tlet dirReady = false;\n\tlet written = 0;\n\tlet failed = 0;\n\n\tconst write = (level: HostLogLevel, src: string, msg: string, context?: HostLogContext): void => {\n\t\tif (closed) return;\n\t\tif (LEVEL_RANK[level] < minRank) return;\n\t\tconst entry: HostLogEntry = {\n\t\t\tv: 1,\n\t\t\tt: now(),\n\t\t\tlevel,\n\t\t\tsrc,\n\t\t\tmsg,\n\t\t\tsessionId: context?.sessionId,\n\t\t\ttraceId: context?.traceId,\n\t\t\tfields: context?.fields === undefined ? undefined : (toSafeJson(context.fields) as Record<string, unknown>),\n\t\t\tcause: context?.cause === undefined ? undefined : boundCause(context.cause),\n\t\t};\n\t\ttry {\n\t\t\tif (!dirReady) {\n\t\t\t\tmkdirSync(options.dir, { recursive: true });\n\t\t\t\tdirReady = true;\n\t\t\t}\n\t\t\tappendFileSync(join(options.dir, logFileName(entry.t)), `${JSON.stringify(entry)}\\n`);\n\t\t\twritten += 1;\n\t\t} catch {\n\t\t\t// Never propagate write failures (disk full, permissions, dir is a file).\n\t\t\tfailed += 1;\n\t\t\tdirReady = false;\n\t\t}\n\t};\n\n\tconst sweep = (): void => {\n\t\tif (maxAgeDays <= 0) return;\n\t\tconst cutoff = now() - maxAgeDays * DAY_MS;\n\t\tconst currentName = logFileName(now());\n\t\tlet names: string[];\n\t\ttry {\n\t\t\tnames = readdirSync(options.dir);\n\t\t} catch (error) {\n\t\t\t// A missing directory means there is nothing to sweep; any other\n\t\t\t// read failure is a real fact and goes into the log itself.\n\t\t\tif ((error as NodeJS.ErrnoException).code === \"ENOENT\") return;\n\t\t\twrite(\"warn\", \"logger\", \"log sweep failed: cannot read log directory\", { cause: error });\n\t\t\treturn;\n\t\t}\n\t\tlet removed = 0;\n\t\tlet errors = 0;\n\t\tfor (const name of names) {\n\t\t\tif (!name.endsWith(\".log\") || name === currentName) continue;\n\t\t\tconst fullPath = join(options.dir, name);\n\t\t\ttry {\n\t\t\t\tconst stats = statSync(fullPath);\n\t\t\t\tif (!stats.isFile() || stats.mtimeMs >= cutoff) continue;\n\t\t\t\tunlinkSync(fullPath);\n\t\t\t\tremoved += 1;\n\t\t\t} catch {\n\t\t\t\terrors += 1;\n\t\t\t}\n\t\t}\n\t\tif (errors > 0) {\n\t\t\twrite(\"warn\", \"logger\", \"log sweep finished with failures\", { fields: { removed, errors } });\n\t\t}\n\t};\n\n\tsweep();\n\n\t// Registering uncaughtException/unhandledRejection listeners replaces Node's\n\t// default crash behavior, so these hooks restore it: crash text on stderr\n\t// and exit(1). Without this, a non-interactive crash (print/RPC/serve)\n\t// would leave the process running and disguise the failure as success.\n\t//\n\t// Fatal-value dedup: a rejection reason rethrown below arrives a second time\n\t// as an uncaughtException; the WeakSet keeps the log line to one write while\n\t// stderr + exit still run on every pass.\n\t//\n\t// Interactive boundary: the TUI registers its own uncaughtException handler\n\t// via `prependListener` and exits(1) first, so the uncaughtException branch\n\t// never fires under interactive mode (TUI crashes stay out of the host\n\t// log); a rejection rethrow surfaces to that prepended handler instead.\n\t//\n\t// After close(): the log line is skipped but stderr + exit still run, so a\n\t// closed logger can never swallow a crash.\n\tconst exit = processHost.exit ?? NODE_PROCESS_CRASH_HOST.exit;\n\tconst writeStderr = processHost.writeStderr ?? NODE_PROCESS_CRASH_HOST.writeStderr;\n\tconst deferThrow = processHost.deferThrow ?? NODE_PROCESS_CRASH_HOST.deferThrow;\n\tconst loggedFatalValues = new WeakSet<object>();\n\tconst isFatalValueLogged = (value: unknown): boolean =>\n\t\tvalue !== null && (typeof value === \"object\" || typeof value === \"function\") && loggedFatalValues.has(value);\n\tconst markFatalValueLogged = (value: unknown): void => {\n\t\tif (value !== null && (typeof value === \"object\" || typeof value === \"function\")) loggedFatalValues.add(value);\n\t};\n\tif (processHost.onUncaughtException) {\n\t\tprocessHost.onUncaughtException((error) => {\n\t\t\tif (!isFatalValueLogged(error)) {\n\t\t\t\tmarkFatalValueLogged(error);\n\t\t\t\twrite(\"error\", \"process\", \"uncaughtException\", { cause: error });\n\t\t\t}\n\t\t\twriteStderr(fatalStderrText(error));\n\t\t\texit(1);\n\t\t});\n\t}\n\tif (processHost.onUnhandledRejection) {\n\t\tprocessHost.onUnhandledRejection((reason) => {\n\t\t\tmarkFatalValueLogged(reason);\n\t\t\twrite(\"error\", \"process\", \"unhandledRejection\", { cause: reason });\n\t\t\tdeferThrow(() => {\n\t\t\t\tthrow reason;\n\t\t\t});\n\t\t});\n\t}\n\n\treturn {\n\t\tdebug: (src, msg, context) => write(\"debug\", src, msg, context),\n\t\tinfo: (src, msg, context) => write(\"info\", src, msg, context),\n\t\twarn: (src, msg, context) => write(\"warn\", src, msg, context),\n\t\terror: (src, msg, context) => write(\"error\", src, msg, context),\n\t\tclose: () => {\n\t\t\tclosed = true;\n\t\t\treturn { written, failed };\n\t\t},\n\t};\n}\n"]}

package/dist/core/model-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-registry.d.ts","sourceRoot":"","sources":["../../src/core/model-registry.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n\tApi,\n\tAssistantMessage,\n\tAssistantMessageEventStream,\n\tAuthResult,\n\tContext,\n\tModel,\n\tModelsApiStreamOptions,\n\tModelsRefreshOptions,\n\tModelsRefreshResult,\n\tModelsSimpleStreamOptions,\n\tProvider,\n\tProviderHeaders,\n} from \"@agent-forge/ai\";\nimport type { ModelRuntime } from \"./model-runtime.ts\";\nimport type { AuthStatus, ProviderConfigInput } from \"./provider-composer.ts\";\n\nexport type { ProviderConfigInput } from \"./provider-composer.ts\";\nexport type ResolvedRequestAuth =\n\t| {\n\t\t\tok: true;\n\t\t\tapiKey?: string;\n\t\t\theaders?: ProviderHeaders;\n\t\t\tbaseUrl?: string;\n\t\t\tenv?: Record<string, string>;\n\t  }\n\t| { ok: false; error: string };\nexport { clearApiKeyCache } from \"./provider-composer.ts\";\n\n/**\n * Synchronous model registry facade over models.json-declared models.\n * Coding-agent internals use ModelRuntime directly.\n */\nexport class ModelRegistry {\n\tprivate readonly runtime: ModelRuntime;\n\n\tconstructor(runtime: ModelRuntime) {\n\t\tthis.runtime = runtime;\n\t}\n\n\t/** Reload models.json asynchronously. Await before making synchronous registry reads. */\n\trefresh(options?: ModelsRefreshOptions): Promise<ModelsRefreshResult> {\n\t\treturn this.runtime.refresh(options);\n\t}\n\n\tgetError(): string | undefined {\n\t\treturn this.runtime.getError();\n\t}\n\n\tgetAll(): Model<Api>[] {\n\t\treturn [...this.runtime.getModels()];\n\t}\n\n\tgetAvailable(): Model<Api>[] {\n\t\treturn [...this.runtime.getAvailableSnapshot()];\n\t}\n\n\tfind(provider: string, modelId: string): Model<Api> | undefined {\n\t\treturn this.runtime.getModel(provider, modelId);\n\t}\n\n\thasConfiguredAuth(model: Model<Api>): boolean {\n\t\treturn this.runtime.hasConfiguredAuth(model.provider);\n\t}\n\n\tasync getApiKeyAndHeaders(model: Model<Api>): Promise<ResolvedRequestAuth> {\n\t\ttry {\n\t\t\tconst resolution = await this.runtime.getAuth(model);\n\t\t\tif (!resolution) {\n\t\t\t\tconst compatibility = this.runtime.getCompatibilityRequestConfig(model);\n\t\t\t\tif (compatibility.authHeader) {\n\t\t\t\t\treturn { ok: false, error: `No API key found for \"${model.provider}\"` };\n\t\t\t\t}\n\t\t\t\treturn { ok: true, headers: compatibility.headers };\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tok: true,\n\t\t\t\tapiKey: resolution.auth.apiKey,\n\t\t\t\theaders: resolution.auth.headers,\n\t\t\t\t...(resolution.auth.baseUrl ? { baseUrl: resolution.auth.baseUrl } : {}),\n\t\t\t\tenv: resolution.env,\n\t\t\t};\n\t\t} catch (error) {\n\t\t\tconst cause = error instanceof Error ? error.cause : undefined;\n\t\t\tconst message =\n\t\t\t\tcause instanceof Error ? cause.message : error instanceof Error ? error.message : String(error);\n\t\t\treturn {\n\t\t\t\tok: false,\n\t\t\t\terror:\n\t\t\t\t\tmessage === \"authHeader requires a resolved API key\"\n\t\t\t\t\t\t? `No API key found for \"${model.provider}\"`\n\t\t\t\t\t\t: message,\n\t\t\t};\n\t\t}\n\t}\n\n\tgetProviderAuthStatus(provider: string): AuthStatus {\n\t\treturn this.runtime.getProviderAuthStatus(provider);\n\t}\n\n\tgetProvider(provider: string): Provider | undefined {\n\t\treturn this.runtime.getProvider(provider);\n\t}\n\n\t/** Stream through the configured provider with request-time authentication. */\n\tstream<TApi extends Api>(\n\t\tmodel: Model<TApi>,\n\t\tcontext: Context,\n\t\toptions?: ModelsApiStreamOptions<TApi>,\n\t): AssistantMessageEventStream {\n\t\treturn this.runtime.stream(model, context, options);\n\t}\n\n\tcomplete<TApi extends Api>(\n\t\tmodel: Model<TApi>,\n\t\tcontext: Context,\n\t\toptions?: ModelsApiStreamOptions<TApi>,\n\t): Promise<AssistantMessage> {\n\t\treturn this.runtime.complete(model, context, options);\n\t}\n\n\t/** Stream with provider-neutral options and request-time authentication. */\n\tstreamSimple(model: Model<Api>, context: Context, options?: ModelsSimpleStreamOptions): AssistantMessageEventStream {\n\t\treturn this.runtime.streamSimple(model, context, options);\n\t}\n\n\tgetProviderDisplayName(provider: string): string {\n\t\treturn this.runtime.getProvider(provider)?.name ?? provider;\n\t}\n\n\tgetProviderAuth(provider: string): Promise<AuthResult | undefined> {\n\t\treturn this.runtime.getAuth(provider);\n\t}\n\n\tasync getApiKeyForProvider(provider: string): Promise<string | undefined> {\n\t\ttry {\n\t\t\treturn (await this.runtime.getAuth(provider))?.auth.apiKey;\n\t\t} catch {\n\t\t\treturn undefined;\n\t\t}\n\t}\n\n\tisUsingOAuth(model: Model<Api>): boolean {\n\t\treturn this.runtime.isUsingOAuth(model.provider);\n\t}\n\n\tregisterProvider(provider: Provider): void;\n\tregisterProvider(providerName: string, config: ProviderConfigInput): void;\n\tregisterProvider(providerOrName: Provider | string, config?: ProviderConfigInput): void {\n\t\tif (typeof providerOrName === \"string\") {\n\t\t\tif (!config) throw new Error(\"Provider config is required when registering by name\");\n\t\t\tthis.runtime.registerProvider(providerOrName, config);\n\t\t\treturn;\n\t\t}\n\t\tthis.runtime.registerNativeProvider(providerOrName);\n\t}\n\n\tunregisterProvider(providerName: string): void {\n\t\tthis.runtime.unregisterProvider(providerName);\n\t}\n\n\tgetRegisteredProviderConfig(providerName: string): ProviderConfigInput | undefined {\n\t\treturn this.runtime.getRegisteredProviderConfig(providerName);\n\t}\n\n\tgetRegisteredNativeProvider(providerName: string): Provider | undefined {\n\t\treturn this.runtime.getRegisteredNativeProvider(providerName);\n\t}\n\n\tgetRegisteredProviderIds(): readonly string[] {\n\t\treturn this.runtime.getRegisteredProviderIds();\n\t}\n}\n"]}
+{"version":3,"file":"model-registry.d.ts","sourceRoot":"","sources":["../../src/core/model-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,GAAG,EACH,gBAAgB,EAChB,2BAA2B,EAC3B,UAAU,EACV,OAAO,EACP,KAAK,EACL,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,EACzB,QAAQ,EACR,eAAe,EACf,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE9E,YAAY,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,MAAM,MAAM,mBAAmB,GAC5B;IACA,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5B,GACD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;;GAGG;AACH,qBAAa,aAAa;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IAEvC,YAAY,OAAO,EAAE,YAAY,EAEhC;IAED,yFAAyF;IACzF,OAAO,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAEpE;IAED,QAAQ,IAAI,MAAM,GAAG,SAAS,CAE7B;IAED,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAErB;IAED,YAAY,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAE3B;IAED,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAE9D;IAED,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,CAE5C;IAEK,mBAAmB,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA6BzE;IAED,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAElD;IAED,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAElD;IAED,+EAA+E;IAC/E,MAAM,CAAC,IAAI,SAAS,GAAG,EACtB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAClB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,sBAAsB,CAAC,IAAI,CAAC,GACpC,2BAA2B,CAE7B;IAED,QAAQ,CAAC,IAAI,SAAS,GAAG,EACxB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAClB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,sBAAsB,CAAC,IAAI,CAAC,GACpC,OAAO,CAAC,gBAAgB,CAAC,CAE3B;IAED,4EAA4E;IAC5E,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,yBAAyB,GAAG,2BAA2B,CAElH;IAED,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE/C;IAED,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAEjE;IAEK,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAMxE;IAED,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,CAEvC;IAED,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC3C,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAU1E,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAE7C;IAED,2BAA2B,CAAC,YAAY,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAEjF;IAED,2BAA2B,CAAC,YAAY,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAEtE;IAED,wBAAwB,IAAI,SAAS,MAAM,EAAE,CAE5C;CACD","sourcesContent":["import type {\n\tApi,\n\tAssistantMessage,\n\tAssistantMessageEventStream,\n\tAuthResult,\n\tContext,\n\tModel,\n\tModelsApiStreamOptions,\n\tModelsRefreshOptions,\n\tModelsRefreshResult,\n\tModelsSimpleStreamOptions,\n\tProvider,\n\tProviderHeaders,\n} from \"@agent-forge/ai\";\nimport { t } from \"./i18n/index.ts\";\nimport type { ModelRuntime } from \"./model-runtime.ts\";\nimport type { AuthStatus, ProviderConfigInput } from \"./provider-composer.ts\";\n\nexport type { ProviderConfigInput } from \"./provider-composer.ts\";\nexport type ResolvedRequestAuth =\n\t| {\n\t\t\tok: true;\n\t\t\tapiKey?: string;\n\t\t\theaders?: ProviderHeaders;\n\t\t\tbaseUrl?: string;\n\t\t\tenv?: Record<string, string>;\n\t  }\n\t| { ok: false; error: string };\nexport { clearApiKeyCache } from \"./provider-composer.ts\";\n\n/**\n * Synchronous model registry facade over models.json-declared models.\n * Coding-agent internals use ModelRuntime directly.\n */\nexport class ModelRegistry {\n\tprivate readonly runtime: ModelRuntime;\n\n\tconstructor(runtime: ModelRuntime) {\n\t\tthis.runtime = runtime;\n\t}\n\n\t/** Reload models.json asynchronously. Await before making synchronous registry reads. */\n\trefresh(options?: ModelsRefreshOptions): Promise<ModelsRefreshResult> {\n\t\treturn this.runtime.refresh(options);\n\t}\n\n\tgetError(): string | undefined {\n\t\treturn this.runtime.getError();\n\t}\n\n\tgetAll(): Model<Api>[] {\n\t\treturn [...this.runtime.getModels()];\n\t}\n\n\tgetAvailable(): Model<Api>[] {\n\t\treturn [...this.runtime.getAvailableSnapshot()];\n\t}\n\n\tfind(provider: string, modelId: string): Model<Api> | undefined {\n\t\treturn this.runtime.getModel(provider, modelId);\n\t}\n\n\thasConfiguredAuth(model: Model<Api>): boolean {\n\t\treturn this.runtime.hasConfiguredAuth(model.provider);\n\t}\n\n\tasync getApiKeyAndHeaders(model: Model<Api>): Promise<ResolvedRequestAuth> {\n\t\ttry {\n\t\t\tconst resolution = await this.runtime.getAuth(model);\n\t\t\tif (!resolution) {\n\t\t\t\tconst compatibility = this.runtime.getCompatibilityRequestConfig(model);\n\t\t\t\tif (compatibility.authHeader) {\n\t\t\t\t\treturn { ok: false, error: `No API key found for \"${model.provider}\"` };\n\t\t\t\t}\n\t\t\t\treturn { ok: true, headers: compatibility.headers };\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tok: true,\n\t\t\t\tapiKey: resolution.auth.apiKey,\n\t\t\t\theaders: resolution.auth.headers,\n\t\t\t\t...(resolution.auth.baseUrl ? { baseUrl: resolution.auth.baseUrl } : {}),\n\t\t\t\tenv: resolution.env,\n\t\t\t};\n\t\t} catch (error) {\n\t\t\tconst cause = error instanceof Error ? error.cause : undefined;\n\t\t\tconst message =\n\t\t\t\tcause instanceof Error ? cause.message : error instanceof Error ? error.message : String(error);\n\t\t\treturn {\n\t\t\t\tok: false,\n\t\t\t\terror:\n\t\t\t\t\tmessage === \"authHeader requires a resolved API key\"\n\t\t\t\t\t\t? `No API key found for \"${model.provider}\"`\n\t\t\t\t\t\t: message,\n\t\t\t};\n\t\t}\n\t}\n\n\tgetProviderAuthStatus(provider: string): AuthStatus {\n\t\treturn this.runtime.getProviderAuthStatus(provider);\n\t}\n\n\tgetProvider(provider: string): Provider | undefined {\n\t\treturn this.runtime.getProvider(provider);\n\t}\n\n\t/** Stream through the configured provider with request-time authentication. */\n\tstream<TApi extends Api>(\n\t\tmodel: Model<TApi>,\n\t\tcontext: Context,\n\t\toptions?: ModelsApiStreamOptions<TApi>,\n\t): AssistantMessageEventStream {\n\t\treturn this.runtime.stream(model, context, options);\n\t}\n\n\tcomplete<TApi extends Api>(\n\t\tmodel: Model<TApi>,\n\t\tcontext: Context,\n\t\toptions?: ModelsApiStreamOptions<TApi>,\n\t): Promise<AssistantMessage> {\n\t\treturn this.runtime.complete(model, context, options);\n\t}\n\n\t/** Stream with provider-neutral options and request-time authentication. */\n\tstreamSimple(model: Model<Api>, context: Context, options?: ModelsSimpleStreamOptions): AssistantMessageEventStream {\n\t\treturn this.runtime.streamSimple(model, context, options);\n\t}\n\n\tgetProviderDisplayName(provider: string): string {\n\t\treturn this.runtime.getProvider(provider)?.name ?? provider;\n\t}\n\n\tgetProviderAuth(provider: string): Promise<AuthResult | undefined> {\n\t\treturn this.runtime.getAuth(provider);\n\t}\n\n\tasync getApiKeyForProvider(provider: string): Promise<string | undefined> {\n\t\ttry {\n\t\t\treturn (await this.runtime.getAuth(provider))?.auth.apiKey;\n\t\t} catch {\n\t\t\treturn undefined;\n\t\t}\n\t}\n\n\tisUsingOAuth(model: Model<Api>): boolean {\n\t\treturn this.runtime.isUsingOAuth(model.provider);\n\t}\n\n\tregisterProvider(provider: Provider): void;\n\tregisterProvider(providerName: string, config: ProviderConfigInput): void;\n\tregisterProvider(providerOrName: Provider | string, config?: ProviderConfigInput): void {\n\t\tif (typeof providerOrName === \"string\") {\n\t\t\tif (!config) throw new Error(t(\"Provider config is required when registering by name\"));\n\t\t\tthis.runtime.registerProvider(providerOrName, config);\n\t\t\treturn;\n\t\t}\n\t\tthis.runtime.registerNativeProvider(providerOrName);\n\t}\n\n\tunregisterProvider(providerName: string): void {\n\t\tthis.runtime.unregisterProvider(providerName);\n\t}\n\n\tgetRegisteredProviderConfig(providerName: string): ProviderConfigInput | undefined {\n\t\treturn this.runtime.getRegisteredProviderConfig(providerName);\n\t}\n\n\tgetRegisteredNativeProvider(providerName: string): Provider | undefined {\n\t\treturn this.runtime.getRegisteredNativeProvider(providerName);\n\t}\n\n\tgetRegisteredProviderIds(): readonly string[] {\n\t\treturn this.runtime.getRegisteredProviderIds();\n\t}\n}\n"]}

package/dist/core/model-registry.js

@@ -1,3 +1,4 @@
+import { t } from "./i18n/index.js";
 export { clearApiKeyCache } from "./provider-composer.js";
 /**
  * Synchronous model registry facade over models.json-declared models.
@@ -93,7 +94,7 @@ export class ModelRegistry {
     registerProvider(providerOrName, config) {
         if (typeof providerOrName === "string") {
             if (!config)
-                throw new Error("Provider config is required when registering by name");
+                throw new Error(t("Provider config is required when registering by name"));
             this.runtime.registerProvider(providerOrName, config);
             return;
         }

package/dist/core/model-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"model-registry.js","sourceRoot":"","sources":["../../src/core/model-registry.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n\tApi,\n\tAssistantMessage,\n\tAssistantMessageEventStream,\n\tAuthResult,\n\tContext,\n\tModel,\n\tModelsApiStreamOptions,\n\tModelsRefreshOptions,\n\tModelsRefreshResult,\n\tModelsSimpleStreamOptions,\n\tProvider,\n\tProviderHeaders,\n} from \"@agent-forge/ai\";\nimport type { ModelRuntime } from \"./model-runtime.ts\";\nimport type { AuthStatus, ProviderConfigInput } from \"./provider-composer.ts\";\n\nexport type { ProviderConfigInput } from \"./provider-composer.ts\";\nexport type ResolvedRequestAuth =\n\t| {\n\t\t\tok: true;\n\t\t\tapiKey?: string;\n\t\t\theaders?: ProviderHeaders;\n\t\t\tbaseUrl?: string;\n\t\t\tenv?: Record<string, string>;\n\t  }\n\t| { ok: false; error: string };\nexport { clearApiKeyCache } from \"./provider-composer.ts\";\n\n/**\n * Synchronous model registry facade over models.json-declared models.\n * Coding-agent internals use ModelRuntime directly.\n */\nexport class ModelRegistry {\n\tprivate readonly runtime: ModelRuntime;\n\n\tconstructor(runtime: ModelRuntime) {\n\t\tthis.runtime = runtime;\n\t}\n\n\t/** Reload models.json asynchronously. Await before making synchronous registry reads. */\n\trefresh(options?: ModelsRefreshOptions): Promise<ModelsRefreshResult> {\n\t\treturn this.runtime.refresh(options);\n\t}\n\n\tgetError(): string | undefined {\n\t\treturn this.runtime.getError();\n\t}\n\n\tgetAll(): Model<Api>[] {\n\t\treturn [...this.runtime.getModels()];\n\t}\n\n\tgetAvailable(): Model<Api>[] {\n\t\treturn [...this.runtime.getAvailableSnapshot()];\n\t}\n\n\tfind(provider: string, modelId: string): Model<Api> | undefined {\n\t\treturn this.runtime.getModel(provider, modelId);\n\t}\n\n\thasConfiguredAuth(model: Model<Api>): boolean {\n\t\treturn this.runtime.hasConfiguredAuth(model.provider);\n\t}\n\n\tasync getApiKeyAndHeaders(model: Model<Api>): Promise<ResolvedRequestAuth> {\n\t\ttry {\n\t\t\tconst resolution = await this.runtime.getAuth(model);\n\t\t\tif (!resolution) {\n\t\t\t\tconst compatibility = this.runtime.getCompatibilityRequestConfig(model);\n\t\t\t\tif (compatibility.authHeader) {\n\t\t\t\t\treturn { ok: false, error: `No API key found for \"${model.provider}\"` };\n\t\t\t\t}\n\t\t\t\treturn { ok: true, headers: compatibility.headers };\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tok: true,\n\t\t\t\tapiKey: resolution.auth.apiKey,\n\t\t\t\theaders: resolution.auth.headers,\n\t\t\t\t...(resolution.auth.baseUrl ? { baseUrl: resolution.auth.baseUrl } : {}),\n\t\t\t\tenv: resolution.env,\n\t\t\t};\n\t\t} catch (error) {\n\t\t\tconst cause = error instanceof Error ? error.cause : undefined;\n\t\t\tconst message =\n\t\t\t\tcause instanceof Error ? cause.message : error instanceof Error ? error.message : String(error);\n\t\t\treturn {\n\t\t\t\tok: false,\n\t\t\t\terror:\n\t\t\t\t\tmessage === \"authHeader requires a resolved API key\"\n\t\t\t\t\t\t? `No API key found for \"${model.provider}\"`\n\t\t\t\t\t\t: message,\n\t\t\t};\n\t\t}\n\t}\n\n\tgetProviderAuthStatus(provider: string): AuthStatus {\n\t\treturn this.runtime.getProviderAuthStatus(provider);\n\t}\n\n\tgetProvider(provider: string): Provider | undefined {\n\t\treturn this.runtime.getProvider(provider);\n\t}\n\n\t/** Stream through the configured provider with request-time authentication. */\n\tstream<TApi extends Api>(\n\t\tmodel: Model<TApi>,\n\t\tcontext: Context,\n\t\toptions?: ModelsApiStreamOptions<TApi>,\n\t): AssistantMessageEventStream {\n\t\treturn this.runtime.stream(model, context, options);\n\t}\n\n\tcomplete<TApi extends Api>(\n\t\tmodel: Model<TApi>,\n\t\tcontext: Context,\n\t\toptions?: ModelsApiStreamOptions<TApi>,\n\t): Promise<AssistantMessage> {\n\t\treturn this.runtime.complete(model, context, options);\n\t}\n\n\t/** Stream with provider-neutral options and request-time authentication. */\n\tstreamSimple(model: Model<Api>, context: Context, options?: ModelsSimpleStreamOptions): AssistantMessageEventStream {\n\t\treturn this.runtime.streamSimple(model, context, options);\n\t}\n\n\tgetProviderDisplayName(provider: string): string {\n\t\treturn this.runtime.getProvider(provider)?.name ?? provider;\n\t}\n\n\tgetProviderAuth(provider: string): Promise<AuthResult | undefined> {\n\t\treturn this.runtime.getAuth(provider);\n\t}\n\n\tasync getApiKeyForProvider(provider: string): Promise<string | undefined> {\n\t\ttry {\n\t\t\treturn (await this.runtime.getAuth(provider))?.auth.apiKey;\n\t\t} catch {\n\t\t\treturn undefined;\n\t\t}\n\t}\n\n\tisUsingOAuth(model: Model<Api>): boolean {\n\t\treturn this.runtime.isUsingOAuth(model.provider);\n\t}\n\n\tregisterProvider(provider: Provider): void;\n\tregisterProvider(providerName: string, config: ProviderConfigInput): void;\n\tregisterProvider(providerOrName: Provider | string, config?: ProviderConfigInput): void {\n\t\tif (typeof providerOrName === \"string\") {\n\t\t\tif (!config) throw new Error(\"Provider config is required when registering by name\");\n\t\t\tthis.runtime.registerProvider(providerOrName, config);\n\t\t\treturn;\n\t\t}\n\t\tthis.runtime.registerNativeProvider(providerOrName);\n\t}\n\n\tunregisterProvider(providerName: string): void {\n\t\tthis.runtime.unregisterProvider(providerName);\n\t}\n\n\tgetRegisteredProviderConfig(providerName: string): ProviderConfigInput | undefined {\n\t\treturn this.runtime.getRegisteredProviderConfig(providerName);\n\t}\n\n\tgetRegisteredNativeProvider(providerName: string): Provider | undefined {\n\t\treturn this.runtime.getRegisteredNativeProvider(providerName);\n\t}\n\n\tgetRegisteredProviderIds(): readonly string[] {\n\t\treturn this.runtime.getRegisteredProviderIds();\n\t}\n}\n"]}
+{"version":3,"file":"model-registry.js","sourceRoot":"","sources":["../../src/core/model-registry.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n\tApi,\n\tAssistantMessage,\n\tAssistantMessageEventStream,\n\tAuthResult,\n\tContext,\n\tModel,\n\tModelsApiStreamOptions,\n\tModelsRefreshOptions,\n\tModelsRefreshResult,\n\tModelsSimpleStreamOptions,\n\tProvider,\n\tProviderHeaders,\n} from \"@agent-forge/ai\";\nimport { t } from \"./i18n/index.ts\";\nimport type { ModelRuntime } from \"./model-runtime.ts\";\nimport type { AuthStatus, ProviderConfigInput } from \"./provider-composer.ts\";\n\nexport type { ProviderConfigInput } from \"./provider-composer.ts\";\nexport type ResolvedRequestAuth =\n\t| {\n\t\t\tok: true;\n\t\t\tapiKey?: string;\n\t\t\theaders?: ProviderHeaders;\n\t\t\tbaseUrl?: string;\n\t\t\tenv?: Record<string, string>;\n\t  }\n\t| { ok: false; error: string };\nexport { clearApiKeyCache } from \"./provider-composer.ts\";\n\n/**\n * Synchronous model registry facade over models.json-declared models.\n * Coding-agent internals use ModelRuntime directly.\n */\nexport class ModelRegistry {\n\tprivate readonly runtime: ModelRuntime;\n\n\tconstructor(runtime: ModelRuntime) {\n\t\tthis.runtime = runtime;\n\t}\n\n\t/** Reload models.json asynchronously. Await before making synchronous registry reads. */\n\trefresh(options?: ModelsRefreshOptions): Promise<ModelsRefreshResult> {\n\t\treturn this.runtime.refresh(options);\n\t}\n\n\tgetError(): string | undefined {\n\t\treturn this.runtime.getError();\n\t}\n\n\tgetAll(): Model<Api>[] {\n\t\treturn [...this.runtime.getModels()];\n\t}\n\n\tgetAvailable(): Model<Api>[] {\n\t\treturn [...this.runtime.getAvailableSnapshot()];\n\t}\n\n\tfind(provider: string, modelId: string): Model<Api> | undefined {\n\t\treturn this.runtime.getModel(provider, modelId);\n\t}\n\n\thasConfiguredAuth(model: Model<Api>): boolean {\n\t\treturn this.runtime.hasConfiguredAuth(model.provider);\n\t}\n\n\tasync getApiKeyAndHeaders(model: Model<Api>): Promise<ResolvedRequestAuth> {\n\t\ttry {\n\t\t\tconst resolution = await this.runtime.getAuth(model);\n\t\t\tif (!resolution) {\n\t\t\t\tconst compatibility = this.runtime.getCompatibilityRequestConfig(model);\n\t\t\t\tif (compatibility.authHeader) {\n\t\t\t\t\treturn { ok: false, error: `No API key found for \"${model.provider}\"` };\n\t\t\t\t}\n\t\t\t\treturn { ok: true, headers: compatibility.headers };\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tok: true,\n\t\t\t\tapiKey: resolution.auth.apiKey,\n\t\t\t\theaders: resolution.auth.headers,\n\t\t\t\t...(resolution.auth.baseUrl ? { baseUrl: resolution.auth.baseUrl } : {}),\n\t\t\t\tenv: resolution.env,\n\t\t\t};\n\t\t} catch (error) {\n\t\t\tconst cause = error instanceof Error ? error.cause : undefined;\n\t\t\tconst message =\n\t\t\t\tcause instanceof Error ? cause.message : error instanceof Error ? error.message : String(error);\n\t\t\treturn {\n\t\t\t\tok: false,\n\t\t\t\terror:\n\t\t\t\t\tmessage === \"authHeader requires a resolved API key\"\n\t\t\t\t\t\t? `No API key found for \"${model.provider}\"`\n\t\t\t\t\t\t: message,\n\t\t\t};\n\t\t}\n\t}\n\n\tgetProviderAuthStatus(provider: string): AuthStatus {\n\t\treturn this.runtime.getProviderAuthStatus(provider);\n\t}\n\n\tgetProvider(provider: string): Provider | undefined {\n\t\treturn this.runtime.getProvider(provider);\n\t}\n\n\t/** Stream through the configured provider with request-time authentication. */\n\tstream<TApi extends Api>(\n\t\tmodel: Model<TApi>,\n\t\tcontext: Context,\n\t\toptions?: ModelsApiStreamOptions<TApi>,\n\t): AssistantMessageEventStream {\n\t\treturn this.runtime.stream(model, context, options);\n\t}\n\n\tcomplete<TApi extends Api>(\n\t\tmodel: Model<TApi>,\n\t\tcontext: Context,\n\t\toptions?: ModelsApiStreamOptions<TApi>,\n\t): Promise<AssistantMessage> {\n\t\treturn this.runtime.complete(model, context, options);\n\t}\n\n\t/** Stream with provider-neutral options and request-time authentication. */\n\tstreamSimple(model: Model<Api>, context: Context, options?: ModelsSimpleStreamOptions): AssistantMessageEventStream {\n\t\treturn this.runtime.streamSimple(model, context, options);\n\t}\n\n\tgetProviderDisplayName(provider: string): string {\n\t\treturn this.runtime.getProvider(provider)?.name ?? provider;\n\t}\n\n\tgetProviderAuth(provider: string): Promise<AuthResult | undefined> {\n\t\treturn this.runtime.getAuth(provider);\n\t}\n\n\tasync getApiKeyForProvider(provider: string): Promise<string | undefined> {\n\t\ttry {\n\t\t\treturn (await this.runtime.getAuth(provider))?.auth.apiKey;\n\t\t} catch {\n\t\t\treturn undefined;\n\t\t}\n\t}\n\n\tisUsingOAuth(model: Model<Api>): boolean {\n\t\treturn this.runtime.isUsingOAuth(model.provider);\n\t}\n\n\tregisterProvider(provider: Provider): void;\n\tregisterProvider(providerName: string, config: ProviderConfigInput): void;\n\tregisterProvider(providerOrName: Provider | string, config?: ProviderConfigInput): void {\n\t\tif (typeof providerOrName === \"string\") {\n\t\t\tif (!config) throw new Error(t(\"Provider config is required when registering by name\"));\n\t\t\tthis.runtime.registerProvider(providerOrName, config);\n\t\t\treturn;\n\t\t}\n\t\tthis.runtime.registerNativeProvider(providerOrName);\n\t}\n\n\tunregisterProvider(providerName: string): void {\n\t\tthis.runtime.unregisterProvider(providerName);\n\t}\n\n\tgetRegisteredProviderConfig(providerName: string): ProviderConfigInput | undefined {\n\t\treturn this.runtime.getRegisteredProviderConfig(providerName);\n\t}\n\n\tgetRegisteredNativeProvider(providerName: string): Provider | undefined {\n\t\treturn this.runtime.getRegisteredNativeProvider(providerName);\n\t}\n\n\tgetRegisteredProviderIds(): readonly string[] {\n\t\treturn this.runtime.getRegisteredProviderIds();\n\t}\n}\n"]}

package/dist/core/model-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-runtime.d.ts","sourceRoot":"","sources":["../../src/core/model-runtime.ts"],"names":[],"mappings":"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","sourcesContent":["import { dirname, join } from \"node:path\";\nimport {\n\ttype Api,\n\ttype ApiStreamOptions,\n\ttype AssistantMessage,\n\ttype AssistantMessageEventStream,\n\ttype AuthCheck,\n\ttype AuthInteraction,\n\ttype AuthOperationOptions,\n\ttype AuthResult,\n\ttype AuthType,\n\ttype Context,\n\ttype Credential,\n\ttype CredentialInfo,\n\ttype CredentialStore,\n\tcreateModels,\n\ttype DeferredCancelOptions,\n\ttype DeferredFetchOptions,\n\ttype DeferredHandle,\n\tlazyStream,\n\ttype Model,\n\ttype Models,\n\ttype ModelsApiStreamOptions,\n\ttype ModelsDeferredCancelOptions,\n\ttype ModelsDeferredFetchOptions,\n\tModelsError,\n\ttype ModelsRefreshOptions,\n\ttype ModelsRefreshResult,\n\ttype ModelsRequestTransforms,\n\ttype ModelsSimpleStreamOptions,\n\ttype ModelsStore,\n\ttype MutableModels,\n\ttype Provider,\n\ttype ProviderHeaders,\n\ttype ProviderRequestOptions,\n\ttype SimpleStreamOptions,\n\ttype StreamOptions,\n} from \"@agent-forge/ai\";\nimport * as builtinProviderCatalog from \"@agent-forge/ai/providers/all\";\nimport { getAgentDir } from \"../config.ts\";\nimport { operationSignal, raceWithAbortSignal } from \"../utils/abort.ts\";\nimport { AuthStorage as DefaultAuthStorage } from \"./auth-storage.ts\";\nimport { ModelConfig } from \"./model-config.ts\";\nimport { FileModelsStore, InMemoryCodingAgentModelsStore } from \"./models-store.ts\";\nimport {\n\ttype AuthStatus,\n\ttype CompatibilityRequestConfig,\n\tcomposeModelProvider,\n\tconfiguredRequestAuthStatus,\n\ttype ProviderConfigInput,\n\tresolveCompatibilityRequestConfig,\n\tresolveConfiguredModelHeaders,\n\tvalidateExtensionProvider,\n} from \"./provider-composer.ts\";\nimport { withRemoteCatalog } from \"./remote-catalog-provider.ts\";\nimport { RuntimeCredentials } from \"./runtime-credentials.ts\";\n\ninterface ModelRuntimeSnapshot {\n\tall: readonly Model<Api>[];\n\tavailable: readonly Model<Api>[];\n\tconfiguredProviders: ReadonlySet<string>;\n\tstoredProviders: ReadonlySet<string>;\n\tauth: ReadonlyMap<string, AuthCheck | undefined>;\n}\n\nexport interface CreateModelRuntimeOptions {\n\t/** Credential storage. Defaults to the file at authPath. */\n\tcredentials?: CredentialStore;\n\tauthPath?: string;\n\tmodelsPath?: string | null;\n\tmodelsStore?: ModelsStore;\n\tmodelsStorePath?: string;\n\t/** Allow create() to refresh model catalogs over the network. Defaults to false. */\n\tallowModelNetwork?: boolean;\n\t/** Timeout for the create-time network model refresh. */\n\tmodelRefreshTimeoutMs?: number;\n\tcatalogBaseUrl?: string;\n\t/** Optional caller cancellation for initial cache restoration and availability checks. */\n\tsignal?: AbortSignal;\n\t/** Skip initial catalog and availability refresh. Static models remain available. */\n\trefreshOnCreate?: boolean;\n}\n\nexport interface ModelRuntimeAuthOverrides extends AuthOperationOptions {\n\tapiKey?: string;\n\tenv?: Record<string, string>;\n\t/** Require this much remaining OAuth-token validity; defaults to five minutes. */\n\tminOAuthValidityMs?: number;\n}\n\nexport type CredentialSynchronizationOperation = \"login\" | \"logout\" | \"setRuntimeApiKey\" | \"removeRuntimeApiKey\";\n\n/** Credentials changed successfully, but the local model/auth snapshot could not be synchronized. */\nexport class CredentialSynchronizationError extends Error {\n\treadonly providerId: string;\n\treadonly operation: CredentialSynchronizationOperation;\n\treadonly credential: Credential | undefined;\n\n\tconstructor(\n\t\tproviderId: string,\n\t\toperation: CredentialSynchronizationOperation,\n\t\tcredential: Credential | undefined,\n\t\toptions: ErrorOptions,\n\t) {\n\t\tsuper(`Credential ${operation} committed for ${providerId}, but local synchronization failed`, options);\n\t\tthis.name = \"CredentialSynchronizationError\";\n\t\tthis.providerId = providerId;\n\t\tthis.operation = operation;\n\t\tthis.credential = credential;\n\t}\n}\n\nfunction mergeHeaders(\n\tbase: ProviderHeaders | undefined,\n\toverride: ProviderHeaders | undefined,\n): ProviderHeaders | undefined {\n\tif (!base && !override) return undefined;\n\tconst merged = { ...base };\n\tfor (const [name, value] of Object.entries(override ?? {})) {\n\t\tconst lowerName = name.toLowerCase();\n\t\tfor (const existingName of Object.keys(merged)) {\n\t\t\tif (existingName.toLowerCase() === lowerName) delete merged[existingName];\n\t\t}\n\t\tmerged[name] = value;\n\t}\n\treturn merged;\n}\n\n/** Configured Agent Forge Models collection used by coding-agent and SDK consumers. */\nexport class ModelRuntime implements Models {\n\tprivate readonly models: MutableModels;\n\tprivate readonly credentials: RuntimeCredentials;\n\tprivate readonly defaultBuiltins: ReadonlyMap<string, Provider>;\n\tprivate readonly builtins = new Map<string, Provider>();\n\tprivate readonly nativeExtensionProviders = new Map<string, Provider>();\n\tprivate readonly extensionProviders = new Map<string, ProviderConfigInput>();\n\tprivate readonly compositionErrors = new Map<string, string>();\n\tprivate readonly modelsPath: string | undefined;\n\tprivate readonly modelNetworkEnabled: boolean;\n\tprivate config: ModelConfig;\n\tprivate snapshot: ModelRuntimeSnapshot = {\n\t\tall: [],\n\t\tavailable: [],\n\t\tconfiguredProviders: new Set(),\n\t\tstoredProviders: new Set(),\n\t\tauth: new Map(),\n\t};\n\tprivate availabilityRefreshSeq = 0;\n\tprivate availabilityErrorSeq = 0;\n\tprivate readonly providerAvailabilitySeq = new Map<string, number>();\n\tprivate availabilityError: string | undefined;\n\tprivate readonly credentialOperations = new Map<string, Promise<unknown>>();\n\n\tprivate constructor(\n\t\tcredentials: RuntimeCredentials,\n\t\tconfig: ModelConfig,\n\t\tmodelsPath: string | undefined,\n\t\tmodelsStore: ModelsStore,\n\t\tproviders: readonly Provider[],\n\t\tmodelNetworkEnabled: boolean,\n\t) {\n\t\tthis.credentials = credentials;\n\t\tthis.config = config;\n\t\tthis.modelsPath = modelsPath;\n\t\tthis.modelNetworkEnabled = modelNetworkEnabled;\n\t\tthis.defaultBuiltins = new Map(providers.map((provider) => [provider.id, provider]));\n\t\tfor (const [providerId, provider] of this.defaultBuiltins) this.builtins.set(providerId, provider);\n\t\tthis.models = createModels({ credentials, modelsStore });\n\t\tthis.rebuildProviders();\n\t}\n\n\tstatic async create(options: CreateModelRuntimeOptions = {}): Promise<ModelRuntime> {\n\t\tconst credentials = new RuntimeCredentials(options.credentials ?? DefaultAuthStorage.create(options.authPath));\n\t\tconst modelsPath =\n\t\t\toptions.modelsPath === null ? undefined : (options.modelsPath ?? join(getAgentDir(), \"models.json\"));\n\t\tconst config = await ModelConfig.load(modelsPath);\n\t\tconst modelsStore =\n\t\t\toptions.modelsStore ??\n\t\t\t(modelsPath\n\t\t\t\t? new FileModelsStore(options.modelsStorePath ?? join(dirname(modelsPath), \"models-store.json\"))\n\t\t\t\t: new InMemoryCodingAgentModelsStore());\n\t\tconst builtinModelDataGeneratedAt = builtinProviderCatalog.getBuiltinModelDataGeneratedAt();\n\t\tconst providers = builtinProviderCatalog\n\t\t\t.builtinProviders()\n\t\t\t.map((provider) =>\n\t\t\t\tprovider.id === \"radius\"\n\t\t\t\t\t? provider\n\t\t\t\t\t: withRemoteCatalog(provider, options.catalogBaseUrl, builtinModelDataGeneratedAt),\n\t\t\t);\n\t\tconst runtime = new ModelRuntime(\n\t\t\tcredentials,\n\t\t\tconfig,\n\t\t\tmodelsPath,\n\t\t\tmodelsStore,\n\t\t\tproviders,\n\t\t\tprocess.env.AGENT_FORGE_OFFLINE === undefined,\n\t\t);\n\t\truntime.configureRadiusProviders();\n\t\truntime.rebuildProviders();\n\t\tconst refreshFromNetwork = runtime.modelNetworkEnabled && options.allowModelNetwork === true;\n\t\t// v8 ignore next -- 测试与 CI 恒置 AGENT_FORGE_OFFLINE=1，modelNetworkEnabled 恒为 false，创建期网络刷新超时分支仅真实网络场景可达\n\t\tconst controller =\n\t\t\trefreshFromNetwork && options.modelRefreshTimeoutMs !== undefined ? new AbortController() : undefined;\n\t\t// v8 ignore next -- 同上：controller 仅在网络刷新时创建\n\t\tconst timeout = controller ? setTimeout(() => controller.abort(), options.modelRefreshTimeoutMs) : undefined;\n\t\t// v8 ignore next -- 同上：AbortSignal.any 组合仅在网络刷新时发生\n\t\tconst signal = controller\n\t\t\t? options.signal\n\t\t\t\t? AbortSignal.any([options.signal, controller.signal])\n\t\t\t\t: controller.signal\n\t\t\t: options.signal;\n\t\ttry {\n\t\t\tif (options.refreshOnCreate !== false) {\n\t\t\t\tawait runtime.refresh({ allowNetwork: refreshFromNetwork, signal });\n\t\t\t}\n\t\t} finally {\n\t\t\t// v8 ignore next -- 同上：timeout 仅在网络刷新时创建\n\t\t\tif (timeout) clearTimeout(timeout);\n\t\t}\n\t\treturn runtime;\n\t}\n\n\tprivate configureRadiusProviders(): void {\n\t\tthis.builtins.clear();\n\t\tfor (const [providerId, provider] of this.defaultBuiltins) this.builtins.set(providerId, provider);\n\t\tfor (const providerId of this.config.getProviderIds()) {\n\t\t\tconst config = this.config.getProvider(providerId);\n\t\t\tif (config?.oauth !== \"radius\" || !config.baseUrl) continue;\n\t\t\tthis.builtins.set(\n\t\t\t\tproviderId,\n\t\t\t\tbuiltinProviderCatalog.radiusProvider({\n\t\t\t\t\tid: providerId,\n\t\t\t\t\tname: config.name ?? providerId,\n\t\t\t\t\tgateway: config.baseUrl.replace(/\\/v1\\/?$/u, \"\"),\n\t\t\t\t}),\n\t\t\t);\n\t\t}\n\t}\n\n\tprivate providerIds(): Set<string> {\n\t\treturn new Set([\n\t\t\t...this.builtins.keys(),\n\t\t\t...this.nativeExtensionProviders.keys(),\n\t\t\t...this.config.getProviderIds(),\n\t\t\t...this.extensionProviders.keys(),\n\t\t]);\n\t}\n\n\tprivate recomposeProvider(providerId: string): void {\n\t\tconst base = this.nativeExtensionProviders.get(providerId) ?? this.builtins.get(providerId);\n\t\tconst extension = this.extensionProviders.get(providerId);\n\t\tif (!base && !this.config.getProvider(providerId) && !extension) {\n\t\t\tthis.models.deleteProvider(providerId);\n\t\t\tthis.compositionErrors.delete(providerId);\n\t\t\treturn;\n\t\t}\n\t\tif (base && !this.config.getProvider(providerId) && !extension) {\n\t\t\t// No overlays: use the builtin untouched so its auth/login/stream behavior is exact.\n\t\t\tthis.models.setProvider(base);\n\t\t\tthis.compositionErrors.delete(providerId);\n\t\t\treturn;\n\t\t}\n\t\ttry {\n\t\t\tthis.models.setProvider(composeModelProvider(providerId, base, this.config, extension));\n\t\t\tthis.compositionErrors.delete(providerId);\n\t\t} catch (error) {\n\t\t\tthis.compositionErrors.set(providerId, error instanceof Error ? error.message : String(error));\n\t\t\tif (base) this.models.setProvider(base);\n\t\t\telse this.models.deleteProvider(providerId);\n\t\t}\n\t}\n\n\tprivate rebuildProviders(): void {\n\t\tthis.models.clearProviders();\n\t\tthis.compositionErrors.clear();\n\t\tfor (const providerId of this.providerIds()) this.recomposeProvider(providerId);\n\t\tthis.updateModelSnapshot();\n\t}\n\n\tprivate updateModelSnapshot(): void {\n\t\tconst all = [...this.models.getModels()];\n\t\tthis.snapshot = {\n\t\t\t...this.snapshot,\n\t\t\tall,\n\t\t\tavailable: all.filter((model) => this.snapshot.configuredProviders.has(model.provider)),\n\t\t};\n\t}\n\n\tprivate async runAvailabilityRefresh(seq: number, errorSeq: number, signal: AbortSignal): Promise<void> {\n\t\tconst providers = this.models.getProviders();\n\t\tconst [available, checks, credentials] = await Promise.all([\n\t\t\tthis.models.getAvailable(undefined, { signal }),\n\t\t\tPromise.all(\n\t\t\t\tproviders.map(\n\t\t\t\t\tasync (provider): Promise<[string, AuthCheck | undefined]> => [\n\t\t\t\t\t\tprovider.id,\n\t\t\t\t\t\tawait this.models.checkAuth(provider.id, { signal }),\n\t\t\t\t\t],\n\t\t\t\t),\n\t\t\t),\n\t\t\tthis.credentials.list({ signal }),\n\t\t]);\n\t\tif (seq !== this.availabilityRefreshSeq) return;\n\t\tconst auth = new Map(checks);\n\t\tconst configuredProviders = new Set(\n\t\t\tchecks\n\t\t\t\t.filter((entry): entry is [string, AuthCheck] => entry[1] !== undefined)\n\t\t\t\t.map(([providerId]) => providerId),\n\t\t);\n\t\tthis.snapshot = {\n\t\t\tall: [...this.models.getModels()],\n\t\t\tavailable: [...available],\n\t\t\tconfiguredProviders,\n\t\t\tstoredProviders: new Set(credentials.map((entry) => entry.providerId)),\n\t\t\tauth,\n\t\t};\n\t\tif (errorSeq === this.availabilityErrorSeq) this.availabilityError = undefined;\n\t}\n\n\tprivate queueAvailabilityRefresh(signal?: AbortSignal): Promise<void> {\n\t\tconst seq = ++this.availabilityRefreshSeq;\n\t\tfor (const [providerId, providerSeq] of this.providerAvailabilitySeq) {\n\t\t\tthis.providerAvailabilitySeq.set(providerId, providerSeq + 1);\n\t\t}\n\t\tconst errorSeq = ++this.availabilityErrorSeq;\n\t\tconst effectiveSignal = operationSignal(signal);\n\t\treturn this.runAvailabilityRefresh(seq, errorSeq, effectiveSignal).catch((error) => {\n\t\t\tif (errorSeq === this.availabilityErrorSeq && !effectiveSignal.aborted) {\n\t\t\t\tthis.availabilityError = error instanceof Error ? error.message : String(error);\n\t\t\t}\n\t\t\tthrow error;\n\t\t});\n\t}\n\n\tprivate async refreshProviderAvailability(providerId: string, signal: AbortSignal): Promise<void> {\n\t\t// Invalidate any full availability pass that started before this credential change.\n\t\t++this.availabilityRefreshSeq;\n\t\tconst providerSeq = (this.providerAvailabilitySeq.get(providerId) ?? 0) + 1;\n\t\tthis.providerAvailabilitySeq.set(providerId, providerSeq);\n\t\tconst errorSeq = ++this.availabilityErrorSeq;\n\t\ttry {\n\t\t\tconst [available, auth, credential] = await Promise.all([\n\t\t\t\tthis.models.getAvailable(providerId, { signal }),\n\t\t\t\tthis.models.checkAuth(providerId, { signal }),\n\t\t\t\tthis.credentials.read(providerId, { signal }),\n\t\t\t]);\n\t\t\tsignal.throwIfAborted();\n\t\t\tif (this.providerAvailabilitySeq.get(providerId) !== providerSeq) return;\n\t\t\tconst configuredProviders = new Set(this.snapshot.configuredProviders);\n\t\t\tconst storedProviders = new Set(this.snapshot.storedProviders);\n\t\t\tconst authByProvider = new Map(this.snapshot.auth);\n\t\t\tif (auth) {\n\t\t\t\tconfiguredProviders.add(providerId);\n\t\t\t\tauthByProvider.set(providerId, auth);\n\t\t\t} else {\n\t\t\t\tconfiguredProviders.delete(providerId);\n\t\t\t\tauthByProvider.delete(providerId);\n\t\t\t}\n\t\t\tif (credential) storedProviders.add(providerId);\n\t\t\telse storedProviders.delete(providerId);\n\t\t\tconst all = [...this.models.getModels()];\n\t\t\tconst availableById = new Map(\n\t\t\t\t[...this.snapshot.available.filter((model) => model.provider !== providerId), ...available].map((model) => [\n\t\t\t\t\t`${model.provider}\\0${model.id}`,\n\t\t\t\t\tmodel,\n\t\t\t\t]),\n\t\t\t);\n\t\t\tthis.snapshot = {\n\t\t\t\tall,\n\t\t\t\tavailable: all.flatMap((model) => availableById.get(`${model.provider}\\0${model.id}`) ?? []),\n\t\t\t\tconfiguredProviders,\n\t\t\t\tstoredProviders,\n\t\t\t\tauth: authByProvider,\n\t\t\t};\n\t\t\tif (errorSeq === this.availabilityErrorSeq) this.availabilityError = undefined;\n\t\t} catch (error) {\n\t\t\tif (\n\t\t\t\tthis.providerAvailabilitySeq.get(providerId) === providerSeq &&\n\t\t\t\terrorSeq === this.availabilityErrorSeq &&\n\t\t\t\t!signal.aborted\n\t\t\t) {\n\t\t\t\tthis.availabilityError = error instanceof Error ? error.message : String(error);\n\t\t\t}\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\tgetProviders(): readonly Provider[] {\n\t\treturn this.models.getProviders();\n\t}\n\n\tgetProvider(providerId: string): Provider | undefined {\n\t\treturn this.models.getProvider(providerId);\n\t}\n\n\tgetModels(providerId?: string): readonly Model<Api>[] {\n\t\treturn this.models.getModels(providerId);\n\t}\n\n\tgetModel(providerId: string, modelId: string): Model<Api> | undefined {\n\t\treturn this.models.getModel(providerId, modelId);\n\t}\n\n\tasync checkAuth(providerId: string, options?: AuthOperationOptions): Promise<AuthCheck | undefined> {\n\t\treturn this.models.checkAuth(providerId, options);\n\t}\n\n\tasync getAvailable(providerId?: string, options?: AuthOperationOptions): Promise<readonly Model<Api>[]> {\n\t\tif (providerId) {\n\t\t\tconst errorSeq = ++this.availabilityErrorSeq;\n\t\t\ttry {\n\t\t\t\tconst available = await this.models.getAvailable(providerId, options);\n\t\t\t\tif (errorSeq === this.availabilityErrorSeq) this.availabilityError = undefined;\n\t\t\t\treturn available;\n\t\t\t} catch (error) {\n\t\t\t\tif (errorSeq === this.availabilityErrorSeq && !options?.signal?.aborted) {\n\t\t\t\t\tthis.availabilityError = error instanceof Error ? error.message : String(error);\n\t\t\t\t}\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t}\n\t\tawait this.queueAvailabilityRefresh(options?.signal);\n\t\treturn this.snapshot.available;\n\t}\n\n\tgetAvailableSnapshot(): readonly Model<Api>[] {\n\t\treturn this.snapshot.available;\n\t}\n\n\tgetError(): string | undefined {\n\t\tconst errors: string[] = [];\n\t\tconst configError = this.config.getError();\n\t\tif (configError) errors.push(configError);\n\t\tfor (const [providerId, error] of this.compositionErrors) {\n\t\t\terrors.push(`Provider \"${providerId}\": ${error}`);\n\t\t}\n\t\tif (this.availabilityError) errors.push(`Availability refresh: ${this.availabilityError}`);\n\t\treturn errors.length > 0 ? errors.join(\"\\n\\n\") : undefined;\n\t}\n\n\tgetRegisteredProviderConfig(providerId: string): ProviderConfigInput | undefined {\n\t\treturn this.extensionProviders.get(providerId);\n\t}\n\n\tgetRegisteredProviderIds(): readonly string[] {\n\t\treturn [...new Set([...this.extensionProviders.keys(), ...this.nativeExtensionProviders.keys()])];\n\t}\n\n\tgetRegisteredNativeProvider(providerId: string): Provider | undefined {\n\t\treturn this.nativeExtensionProviders.get(providerId);\n\t}\n\n\t/** @internal Compatibility request configuration for ModelRegistry. */\n\tgetCompatibilityRequestConfig(model: Model<Api>): CompatibilityRequestConfig {\n\t\treturn resolveCompatibilityRequestConfig(\n\t\t\tmodel,\n\t\t\tthis.config.getProvider(model.provider),\n\t\t\tthis.extensionProviders.get(model.provider),\n\t\t);\n\t}\n\n\tisUsingOAuth(providerId: string): boolean {\n\t\treturn this.snapshot.auth.get(providerId)?.type === \"oauth\";\n\t}\n\n\tisUsingSubscription(providerId: string): boolean {\n\t\treturn this.isUsingOAuth(providerId) && this.models.getProvider(providerId)?.auth.oauth?.isSubscription === true;\n\t}\n\n\thasConfiguredAuth(providerId: string): boolean {\n\t\treturn this.snapshot.configuredProviders.has(providerId);\n\t}\n\n\t/**\n\t * 生图模型目录快照透传（供应商能力槽位设计 §3.3 装配注入）：宿主在装配期经\n\t * `configOverride` 把快照注入 image-generation 插件（注入键 `imageModelCatalog`），\n\t * 供插件运行期做主供应商/唯一候选推断（设计 §3.2 第 4/5 层）。纯投影，无状态。\n\t */\n\tgetImageModelCatalog(): Readonly<Record<string, ReadonlyArray<{ id: string; name?: string }>>> {\n\t\treturn this.config.getImageModelCatalog();\n\t}\n\n\tgetAuth(providerId: string, overrides?: ModelRuntimeAuthOverrides): Promise<AuthResult | undefined>;\n\tgetAuth(model: Model<Api>, overrides?: ModelRuntimeAuthOverrides): Promise<AuthResult | undefined>;\n\tasync getAuth(\n\t\tproviderOrModel: string | Model<Api>,\n\t\toverrides: ModelRuntimeAuthOverrides = {},\n\t): Promise<AuthResult | undefined> {\n\t\tif (typeof providerOrModel === \"string\") return this.models.getAuth(providerOrModel, overrides);\n\t\tconst resolution = await this.models.getAuth(providerOrModel, overrides);\n\t\tif (!resolution) return undefined;\n\t\tconst configuredHeaders = resolveConfiguredModelHeaders(\n\t\t\tproviderOrModel,\n\t\t\tthis.config.getProvider(providerOrModel.provider),\n\t\t\tthis.extensionProviders.get(providerOrModel.provider),\n\t\t\t{ ...(resolution.env ?? {}), ...(overrides.env ?? {}) },\n\t\t);\n\t\treturn {\n\t\t\t...resolution,\n\t\t\tauth: {\n\t\t\t\t...resolution.auth,\n\t\t\t\theaders: mergeHeaders(resolution.auth.headers, configuredHeaders),\n\t\t\t},\n\t\t};\n\t}\n\n\tprivate enqueueCredentialOperation<T>(providerId: string, signal: AbortSignal, task: () => Promise<T>): Promise<T> {\n\t\tconst previous = this.credentialOperations.get(providerId) ?? Promise.resolve();\n\t\tlet markStarted: (() => void) | undefined;\n\t\tconst started = new Promise<void>((resolve) => {\n\t\t\tmarkStarted = resolve;\n\t\t});\n\t\tconst operation = (async () => {\n\t\t\tawait previous.catch(() => {});\n\t\t\tsignal.throwIfAborted();\n\t\t\tmarkStarted?.();\n\t\t\treturn task();\n\t\t})();\n\t\tconst tail = operation.catch(() => {});\n\t\tthis.credentialOperations.set(providerId, tail);\n\t\tvoid tail.then(() => {\n\t\t\tif (this.credentialOperations.get(providerId) === tail) this.credentialOperations.delete(providerId);\n\t\t});\n\t\treturn raceWithAbortSignal(started, signal).then(() => operation);\n\t}\n\n\tprivate async synchronizeCredentialState(\n\t\tproviderId: string,\n\t\toperation: CredentialSynchronizationOperation,\n\t\tcredential: Credential | undefined,\n\t\tsignal: AbortSignal,\n\t): Promise<void> {\n\t\ttry {\n\t\t\tsignal.throwIfAborted();\n\t\t\tthis.recomposeProvider(providerId);\n\t\t\tconst compositionError = this.compositionErrors.get(providerId);\n\t\t\tif (compositionError) throw new Error(compositionError);\n\t\t\tconst result = await this.models.refresh({ allowNetwork: false, providers: [providerId], signal });\n\t\t\tif (result.aborted) signal.throwIfAborted();\n\t\t\tconst refreshError = result.errors.get(providerId);\n\t\t\tif (refreshError) throw refreshError;\n\t\t\tthis.updateModelSnapshot();\n\t\t\tawait this.refreshProviderAvailability(providerId, signal);\n\t\t} catch (cause) {\n\t\t\tthrow new CredentialSynchronizationError(providerId, operation, credential, { cause });\n\t\t}\n\t}\n\n\tsetRuntimeApiKey(providerId: string, apiKey: string, options: AuthOperationOptions = {}): Promise<void> {\n\t\tconst signal = operationSignal(options.signal);\n\t\treturn this.enqueueCredentialOperation(providerId, signal, async () => {\n\t\t\tthis.credentials.setRuntimeApiKey(providerId, apiKey);\n\t\t\tawait this.synchronizeCredentialState(\n\t\t\t\tproviderId,\n\t\t\t\t\"setRuntimeApiKey\",\n\t\t\t\t{ type: \"api_key\", key: apiKey },\n\t\t\t\tsignal,\n\t\t\t);\n\t\t});\n\t}\n\n\tremoveRuntimeApiKey(providerId: string, options: AuthOperationOptions = {}): Promise<void> {\n\t\tconst signal = operationSignal(options.signal);\n\t\treturn this.enqueueCredentialOperation(providerId, signal, async () => {\n\t\t\tthis.credentials.removeRuntimeApiKey(providerId);\n\t\t\tawait this.synchronizeCredentialState(providerId, \"removeRuntimeApiKey\", undefined, signal);\n\t\t});\n\t}\n\n\tlistCredentials(options?: AuthOperationOptions): Promise<readonly CredentialInfo[]> {\n\t\treturn this.credentials.list(options);\n\t}\n\n\tgetProviderAuthStatus(providerId: string): AuthStatus {\n\t\tif (this.credentials.hasRuntimeApiKey(providerId)) return { configured: true, source: \"runtime\" };\n\t\tif (this.snapshot.storedProviders.has(providerId)) return { configured: true, source: \"stored\" };\n\t\tconst configured = configuredRequestAuthStatus(\n\t\t\tthis.config.getProvider(providerId),\n\t\t\tthis.extensionProviders.get(providerId),\n\t\t);\n\t\tif (configured) return configured;\n\t\tconst check = this.snapshot.auth.get(providerId);\n\t\treturn check ? { configured: true, source: \"environment\", label: check.source } : { configured: false };\n\t}\n\n\tprivate async prepareRequest<TOptions extends ProviderRequestOptions & ModelsRequestTransforms>(\n\t\tmodel: Model<Api>,\n\t\toptions: TOptions | undefined,\n\t): Promise<{\n\t\tprovider: Provider;\n\t\tmodel: Model<Api>;\n\t\toptions: Omit<TOptions, \"transformHeaders\"> & ProviderRequestOptions;\n\t}> {\n\t\tconst provider = this.models.getProvider(model.provider);\n\t\tif (!provider) throw new ModelsError(\"provider\", `Unknown provider: ${model.provider}`);\n\t\tconst resolution = await this.getAuth(model, {\n\t\t\tapiKey: options?.apiKey,\n\t\t\tenv: options?.env,\n\t\t\tsignal: options?.signal,\n\t\t});\n\t\tif (!resolution) throw new ModelsError(\"auth\", `Provider is not configured: ${model.provider}`);\n\n\t\tconst { transformHeaders, ...rawProviderOptions } = options ?? {};\n\t\tconst providerOptions = rawProviderOptions as Omit<TOptions, \"transformHeaders\"> & ProviderRequestOptions;\n\t\tlet headers = mergeHeaders(resolution.auth.headers, providerOptions.headers);\n\t\tif (transformHeaders) headers = await transformHeaders(headers ?? {});\n\t\tconst env =\n\t\t\tresolution.env || providerOptions.env\n\t\t\t\t? { ...(resolution.env ?? {}), ...(providerOptions.env ?? {}) }\n\t\t\t\t: undefined;\n\t\treturn {\n\t\t\tprovider,\n\t\t\tmodel: resolution.auth.baseUrl ? { ...model, baseUrl: resolution.auth.baseUrl } : model,\n\t\t\toptions: {\n\t\t\t\t...providerOptions,\n\t\t\t\tapiKey: providerOptions.apiKey ?? resolution.auth.apiKey,\n\t\t\t\theaders,\n\t\t\t\tenv,\n\t\t\t} as Omit<TOptions, \"transformHeaders\"> & ProviderRequestOptions,\n\t\t};\n\t}\n\n\tstream<TApi extends Api>(\n\t\tmodel: Model<TApi>,\n\t\tcontext: Context,\n\t\toptions?: ModelsApiStreamOptions<TApi>,\n\t): AssistantMessageEventStream {\n\t\treturn lazyStream(model, async () => {\n\t\t\tconst prepared = await this.prepareRequest(\n\t\t\t\tmodel,\n\t\t\t\toptions as (StreamOptions & ModelsRequestTransforms) | undefined,\n\t\t\t);\n\t\t\treturn prepared.provider.stream(\n\t\t\t\tprepared.model as Model<TApi>,\n\t\t\t\tcontext,\n\t\t\t\tprepared.options as ApiStreamOptions<TApi>,\n\t\t\t);\n\t\t});\n\t}\n\n\tcomplete<TApi extends Api>(\n\t\tmodel: Model<TApi>,\n\t\tcontext: Context,\n\t\toptions?: ModelsApiStreamOptions<TApi>,\n\t): Promise<AssistantMessage> {\n\t\treturn this.stream(model, context, options).result();\n\t}\n\n\tstreamSimple(model: Model<Api>, context: Context, options?: ModelsSimpleStreamOptions): AssistantMessageEventStream {\n\t\treturn lazyStream(model, async () => {\n\t\t\tconst prepared = await this.prepareRequest(model, options);\n\t\t\treturn prepared.provider.streamSimple(prepared.model, context, prepared.options as SimpleStreamOptions);\n\t\t});\n\t}\n\n\tcompleteSimple(model: Model<Api>, context: Context, options?: ModelsSimpleStreamOptions): Promise<AssistantMessage> {\n\t\treturn this.streamSimple(model, context, options).result();\n\t}\n\n\tasync fetchDeferred(\n\t\tmodel: Model<Api>,\n\t\thandle: DeferredHandle,\n\t\toptions?: ModelsDeferredFetchOptions,\n\t): Promise<AssistantMessage> {\n\t\treturn lazyStream(model, async () => {\n\t\t\tconst prepared = await this.prepareRequest(model, options);\n\t\t\tif (!prepared.provider.fetchDeferred) {\n\t\t\t\tthrow new ModelsError(\"provider\", `Provider ${model.provider} does not support deferred responses`);\n\t\t\t}\n\t\t\treturn prepared.provider.fetchDeferred(prepared.model, handle, prepared.options as DeferredFetchOptions);\n\t\t}).result();\n\t}\n\n\tasync cancelDeferred(\n\t\tmodel: Model<Api>,\n\t\thandle: DeferredHandle,\n\t\toptions?: ModelsDeferredCancelOptions,\n\t): Promise<void> {\n\t\tconst prepared = await this.prepareRequest(model, options);\n\t\tif (!prepared.provider.cancelDeferred) {\n\t\t\tthrow new ModelsError(\"provider\", `Provider ${model.provider} does not support deferred responses`);\n\t\t}\n\t\tawait prepared.provider.cancelDeferred(prepared.model, handle, prepared.options as DeferredCancelOptions);\n\t}\n\n\tlogin(providerId: string, type: AuthType, interaction: AuthInteraction): Promise<Credential> {\n\t\tconst signal = operationSignal(interaction.signal);\n\t\treturn this.enqueueCredentialOperation(providerId, signal, async () => {\n\t\t\tconst credential = await this.models.login(providerId, type, { ...interaction, signal });\n\t\t\tawait this.synchronizeCredentialState(providerId, \"login\", credential, signal);\n\t\t\treturn credential;\n\t\t});\n\t}\n\n\tlogout(providerId: string, options: AuthOperationOptions = {}): Promise<void> {\n\t\tconst signal = operationSignal(options.signal);\n\t\treturn this.enqueueCredentialOperation(providerId, signal, async () => {\n\t\t\tawait this.models.logout(providerId, { signal });\n\t\t\tawait this.synchronizeCredentialState(providerId, \"logout\", undefined, signal);\n\t\t});\n\t}\n\n\tasync refresh(options: ModelsRefreshOptions = {}): Promise<ModelsRefreshResult> {\n\t\tthis.config = await ModelConfig.load(this.modelsPath);\n\t\tthis.configureRadiusProviders();\n\t\tif (options.providers) {\n\t\t\tfor (const providerId of new Set(options.providers)) this.recomposeProvider(providerId);\n\t\t\tthis.updateModelSnapshot();\n\t\t} else {\n\t\t\tthis.rebuildProviders();\n\t\t}\n\t\tconst refreshOptions = {\n\t\t\t...options,\n\t\t\tallowNetwork: options.allowNetwork ?? this.modelNetworkEnabled,\n\t\t};\n\t\tconst result = await this.models.refresh(refreshOptions);\n\t\tconst errors = new Map(result.errors);\n\t\tthis.updateModelSnapshot();\n\t\tif (options.providers) {\n\t\t\tawait Promise.all(\n\t\t\t\t[...new Set(options.providers)].map(async (providerId) => {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tawait this.refreshProviderAvailability(providerId, operationSignal(options.signal));\n\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\tif (!options.signal?.aborted) {\n\t\t\t\t\t\t\terrors.set(providerId, error instanceof Error ? error : new Error(String(error)));\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}),\n\t\t\t);\n\t\t} else {\n\t\t\ttry {\n\t\t\t\tawait this.queueAvailabilityRefresh(options.signal);\n\t\t\t} catch {\n\t\t\t\t// Availability errors are recorded by the latest pass; refreshed models remain usable.\n\t\t\t}\n\t\t}\n\t\treturn { aborted: result.aborted || (options.signal?.aborted ?? false), errors };\n\t}\n\n\tregisterNativeProvider(provider: Provider): void {\n\t\tif (!provider.id.trim()) throw new Error(\"Provider id must not be empty.\");\n\t\tthis.extensionProviders.delete(provider.id);\n\t\tthis.nativeExtensionProviders.set(provider.id, provider);\n\t\tthis.recomposeProvider(provider.id);\n\t\tthis.updateModelSnapshot();\n\t\tthis.markProvisionallyConfigured(\n\t\t\tprovider.id,\n\t\t\tconfiguredRequestAuthStatus(this.config.getProvider(provider.id), undefined),\n\t\t\tprovider.auth.oauth && !provider.auth.apiKey ? \"oauth\" : \"api_key\",\n\t\t);\n\t\tvoid this.refresh({ allowNetwork: false });\n\t}\n\n\t/**\n\t * Mark a newly registered provider as configured when it has a stored credential or a configured\n\t * API key. Availability checks run asynchronously, and callers such as initial model selection\n\t * read the snapshot before they finish. The next availability pass replaces this entry.\n\t */\n\tprivate markProvisionallyConfigured(\n\t\tproviderId: string,\n\t\tconfiguredStatus: AuthStatus | undefined,\n\t\ttype: AuthType,\n\t): void {\n\t\tif (!this.snapshot.storedProviders.has(providerId) && !configuredStatus?.configured) return;\n\t\tconst configuredProviders = new Set(this.snapshot.configuredProviders).add(providerId);\n\t\tconst auth = new Map(this.snapshot.auth);\n\t\t// Never clobber a real check result.\n\t\tif (!auth.get(providerId)) auth.set(providerId, { type, source: \"configured provider\" });\n\t\tthis.snapshot = {\n\t\t\t...this.snapshot,\n\t\t\tauth,\n\t\t\tconfiguredProviders,\n\t\t\tavailable: this.snapshot.all.filter((model) => configuredProviders.has(model.provider)),\n\t\t};\n\t}\n\n\tregisterProvider(providerId: string, config: ProviderConfigInput): void {\n\t\t// Validate the incoming registration on its own, like the legacy registry:\n\t\t// a broken re-registration must throw without touching the stored config.\n\t\tvalidateExtensionProvider(providerId, this.builtins.get(providerId), this.config.getProvider(providerId), config);\n\t\tthis.nativeExtensionProviders.delete(providerId);\n\t\t// Re-registration merges defined values over the previous registration and\n\t\t// preserves undefined ones, matching the legacy ModelRegistry contract.\n\t\tconst previous = this.extensionProviders.get(providerId);\n\t\tconst effective: ProviderConfigInput = { ...previous };\n\t\tfor (const [key, value] of Object.entries(config)) {\n\t\t\tif (value !== undefined) (effective as Record<string, unknown>)[key] = value;\n\t\t}\n\t\tthis.extensionProviders.set(providerId, effective);\n\t\tthis.recomposeProvider(providerId);\n\t\tthis.updateModelSnapshot();\n\t\tthis.markProvisionallyConfigured(\n\t\t\tproviderId,\n\t\t\tconfiguredRequestAuthStatus(this.config.getProvider(providerId), effective),\n\t\t\teffective.oauth && !effective.apiKey ? \"oauth\" : \"api_key\",\n\t\t);\n\t\tvoid this.refresh({ allowNetwork: false });\n\t}\n\n\tunregisterProvider(providerId: string): void {\n\t\tthis.extensionProviders.delete(providerId);\n\t\tthis.nativeExtensionProviders.delete(providerId);\n\t\tthis.recomposeProvider(providerId);\n\t\tthis.updateModelSnapshot();\n\t\tvoid this.refresh({ allowNetwork: false });\n\t}\n}\n"]}
+{"version":3,"file":"model-runtime.d.ts","sourceRoot":"","sources":["../../src/core/model-runtime.ts"],"names":[],"mappings":"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","sourcesContent":["import { dirname, join } from \"node:path\";\nimport {\n\ttype Api,\n\ttype ApiStreamOptions,\n\ttype AssistantMessage,\n\ttype AssistantMessageEventStream,\n\ttype AuthCheck,\n\ttype AuthInteraction,\n\ttype AuthOperationOptions,\n\ttype AuthResult,\n\ttype AuthType,\n\ttype Context,\n\ttype Credential,\n\ttype CredentialInfo,\n\ttype CredentialStore,\n\tcreateModels,\n\ttype DeferredCancelOptions,\n\ttype DeferredFetchOptions,\n\ttype DeferredHandle,\n\tlazyStream,\n\ttype Model,\n\ttype Models,\n\ttype ModelsApiStreamOptions,\n\ttype ModelsDeferredCancelOptions,\n\ttype ModelsDeferredFetchOptions,\n\tModelsError,\n\ttype ModelsRefreshOptions,\n\ttype ModelsRefreshResult,\n\ttype ModelsRequestTransforms,\n\ttype ModelsSimpleStreamOptions,\n\ttype ModelsStore,\n\ttype MutableModels,\n\ttype Provider,\n\ttype ProviderHeaders,\n\ttype ProviderRequestOptions,\n\ttype SimpleStreamOptions,\n\ttype StreamOptions,\n} from \"@agent-forge/ai\";\nimport * as builtinProviderCatalog from \"@agent-forge/ai/providers/all\";\nimport { getAgentDir } from \"../config.ts\";\nimport { operationSignal, raceWithAbortSignal } from \"../utils/abort.ts\";\nimport { AuthStorage as DefaultAuthStorage } from \"./auth-storage.ts\";\nimport { t } from \"./i18n/index.ts\";\nimport { ModelConfig } from \"./model-config.ts\";\nimport { FileModelsStore, InMemoryCodingAgentModelsStore } from \"./models-store.ts\";\nimport {\n\ttype AuthStatus,\n\ttype CompatibilityRequestConfig,\n\tcomposeModelProvider,\n\tconfiguredRequestAuthStatus,\n\ttype ProviderConfigInput,\n\tresolveCompatibilityRequestConfig,\n\tresolveConfiguredModelHeaders,\n\tvalidateExtensionProvider,\n} from \"./provider-composer.ts\";\nimport { withRemoteCatalog } from \"./remote-catalog-provider.ts\";\nimport { RuntimeCredentials } from \"./runtime-credentials.ts\";\n\ninterface ModelRuntimeSnapshot {\n\tall: readonly Model<Api>[];\n\tavailable: readonly Model<Api>[];\n\tconfiguredProviders: ReadonlySet<string>;\n\tstoredProviders: ReadonlySet<string>;\n\tauth: ReadonlyMap<string, AuthCheck | undefined>;\n}\n\nexport interface CreateModelRuntimeOptions {\n\t/** Credential storage. Defaults to the file at authPath. */\n\tcredentials?: CredentialStore;\n\tauthPath?: string;\n\tmodelsPath?: string | null;\n\tmodelsStore?: ModelsStore;\n\tmodelsStorePath?: string;\n\t/** Allow create() to refresh model catalogs over the network. Defaults to false. */\n\tallowModelNetwork?: boolean;\n\t/** Timeout for the create-time network model refresh. */\n\tmodelRefreshTimeoutMs?: number;\n\tcatalogBaseUrl?: string;\n\t/** Optional caller cancellation for initial cache restoration and availability checks. */\n\tsignal?: AbortSignal;\n\t/** Skip initial catalog and availability refresh. Static models remain available. */\n\trefreshOnCreate?: boolean;\n}\n\nexport interface ModelRuntimeAuthOverrides extends AuthOperationOptions {\n\tapiKey?: string;\n\tenv?: Record<string, string>;\n\t/** Require this much remaining OAuth-token validity; defaults to five minutes. */\n\tminOAuthValidityMs?: number;\n}\n\nexport type CredentialSynchronizationOperation = \"login\" | \"logout\" | \"setRuntimeApiKey\" | \"removeRuntimeApiKey\";\n\n/** Credentials changed successfully, but the local model/auth snapshot could not be synchronized. */\nexport class CredentialSynchronizationError extends Error {\n\treadonly providerId: string;\n\treadonly operation: CredentialSynchronizationOperation;\n\treadonly credential: Credential | undefined;\n\n\tconstructor(\n\t\tproviderId: string,\n\t\toperation: CredentialSynchronizationOperation,\n\t\tcredential: Credential | undefined,\n\t\toptions: ErrorOptions,\n\t) {\n\t\tsuper(\n\t\t\tt(\"Credential {operation} committed for {providerId}, but local synchronization failed\", {\n\t\t\t\toperation,\n\t\t\t\tproviderId,\n\t\t\t}),\n\t\t\toptions,\n\t\t);\n\t\tthis.name = \"CredentialSynchronizationError\";\n\t\tthis.providerId = providerId;\n\t\tthis.operation = operation;\n\t\tthis.credential = credential;\n\t}\n}\n\nfunction mergeHeaders(\n\tbase: ProviderHeaders | undefined,\n\toverride: ProviderHeaders | undefined,\n): ProviderHeaders | undefined {\n\tif (!base && !override) return undefined;\n\tconst merged = { ...base };\n\tfor (const [name, value] of Object.entries(override ?? {})) {\n\t\tconst lowerName = name.toLowerCase();\n\t\tfor (const existingName of Object.keys(merged)) {\n\t\t\tif (existingName.toLowerCase() === lowerName) delete merged[existingName];\n\t\t}\n\t\tmerged[name] = value;\n\t}\n\treturn merged;\n}\n\n/** Configured Agent Forge Models collection used by coding-agent and SDK consumers. */\nexport class ModelRuntime implements Models {\n\tprivate readonly models: MutableModels;\n\tprivate readonly credentials: RuntimeCredentials;\n\tprivate readonly defaultBuiltins: ReadonlyMap<string, Provider>;\n\tprivate readonly builtins = new Map<string, Provider>();\n\tprivate readonly nativeExtensionProviders = new Map<string, Provider>();\n\tprivate readonly extensionProviders = new Map<string, ProviderConfigInput>();\n\tprivate readonly compositionErrors = new Map<string, string>();\n\tprivate readonly modelsPath: string | undefined;\n\tprivate readonly modelNetworkEnabled: boolean;\n\tprivate config: ModelConfig;\n\tprivate snapshot: ModelRuntimeSnapshot = {\n\t\tall: [],\n\t\tavailable: [],\n\t\tconfiguredProviders: new Set(),\n\t\tstoredProviders: new Set(),\n\t\tauth: new Map(),\n\t};\n\tprivate availabilityRefreshSeq = 0;\n\tprivate availabilityErrorSeq = 0;\n\tprivate readonly providerAvailabilitySeq = new Map<string, number>();\n\tprivate availabilityError: string | undefined;\n\tprivate readonly credentialOperations = new Map<string, Promise<unknown>>();\n\n\tprivate constructor(\n\t\tcredentials: RuntimeCredentials,\n\t\tconfig: ModelConfig,\n\t\tmodelsPath: string | undefined,\n\t\tmodelsStore: ModelsStore,\n\t\tproviders: readonly Provider[],\n\t\tmodelNetworkEnabled: boolean,\n\t) {\n\t\tthis.credentials = credentials;\n\t\tthis.config = config;\n\t\tthis.modelsPath = modelsPath;\n\t\tthis.modelNetworkEnabled = modelNetworkEnabled;\n\t\tthis.defaultBuiltins = new Map(providers.map((provider) => [provider.id, provider]));\n\t\tfor (const [providerId, provider] of this.defaultBuiltins) this.builtins.set(providerId, provider);\n\t\tthis.models = createModels({ credentials, modelsStore });\n\t\tthis.rebuildProviders();\n\t}\n\n\tstatic async create(options: CreateModelRuntimeOptions = {}): Promise<ModelRuntime> {\n\t\tconst credentials = new RuntimeCredentials(options.credentials ?? DefaultAuthStorage.create(options.authPath));\n\t\tconst modelsPath =\n\t\t\toptions.modelsPath === null ? undefined : (options.modelsPath ?? join(getAgentDir(), \"models.json\"));\n\t\tconst config = await ModelConfig.load(modelsPath);\n\t\tconst modelsStore =\n\t\t\toptions.modelsStore ??\n\t\t\t(modelsPath\n\t\t\t\t? new FileModelsStore(options.modelsStorePath ?? join(dirname(modelsPath), \"models-store.json\"))\n\t\t\t\t: new InMemoryCodingAgentModelsStore());\n\t\tconst builtinModelDataGeneratedAt = builtinProviderCatalog.getBuiltinModelDataGeneratedAt();\n\t\tconst providers = builtinProviderCatalog\n\t\t\t.builtinProviders()\n\t\t\t.map((provider) =>\n\t\t\t\tprovider.id === \"radius\"\n\t\t\t\t\t? provider\n\t\t\t\t\t: withRemoteCatalog(provider, options.catalogBaseUrl, builtinModelDataGeneratedAt),\n\t\t\t);\n\t\tconst runtime = new ModelRuntime(\n\t\t\tcredentials,\n\t\t\tconfig,\n\t\t\tmodelsPath,\n\t\t\tmodelsStore,\n\t\t\tproviders,\n\t\t\tprocess.env.AGENT_FORGE_OFFLINE === undefined,\n\t\t);\n\t\truntime.configureRadiusProviders();\n\t\truntime.rebuildProviders();\n\t\tconst refreshFromNetwork = runtime.modelNetworkEnabled && options.allowModelNetwork === true;\n\t\t// v8 ignore next -- 测试与 CI 恒置 AGENT_FORGE_OFFLINE=1，modelNetworkEnabled 恒为 false，创建期网络刷新超时分支仅真实网络场景可达\n\t\tconst controller =\n\t\t\trefreshFromNetwork && options.modelRefreshTimeoutMs !== undefined ? new AbortController() : undefined;\n\t\t// v8 ignore next -- 同上：controller 仅在网络刷新时创建\n\t\tconst timeout = controller ? setTimeout(() => controller.abort(), options.modelRefreshTimeoutMs) : undefined;\n\t\t// v8 ignore next -- 同上：AbortSignal.any 组合仅在网络刷新时发生\n\t\tconst signal = controller\n\t\t\t? options.signal\n\t\t\t\t? AbortSignal.any([options.signal, controller.signal])\n\t\t\t\t: controller.signal\n\t\t\t: options.signal;\n\t\ttry {\n\t\t\tif (options.refreshOnCreate !== false) {\n\t\t\t\tawait runtime.refresh({ allowNetwork: refreshFromNetwork, signal });\n\t\t\t}\n\t\t} finally {\n\t\t\t// v8 ignore next -- 同上：timeout 仅在网络刷新时创建\n\t\t\tif (timeout) clearTimeout(timeout);\n\t\t}\n\t\treturn runtime;\n\t}\n\n\tprivate configureRadiusProviders(): void {\n\t\tthis.builtins.clear();\n\t\tfor (const [providerId, provider] of this.defaultBuiltins) this.builtins.set(providerId, provider);\n\t\tfor (const providerId of this.config.getProviderIds()) {\n\t\t\tconst config = this.config.getProvider(providerId);\n\t\t\tif (config?.oauth !== \"radius\" || !config.baseUrl) continue;\n\t\t\tthis.builtins.set(\n\t\t\t\tproviderId,\n\t\t\t\tbuiltinProviderCatalog.radiusProvider({\n\t\t\t\t\tid: providerId,\n\t\t\t\t\tname: config.name ?? providerId,\n\t\t\t\t\tgateway: config.baseUrl.replace(/\\/v1\\/?$/u, \"\"),\n\t\t\t\t}),\n\t\t\t);\n\t\t}\n\t}\n\n\tprivate providerIds(): Set<string> {\n\t\treturn new Set([\n\t\t\t...this.builtins.keys(),\n\t\t\t...this.nativeExtensionProviders.keys(),\n\t\t\t...this.config.getProviderIds(),\n\t\t\t...this.extensionProviders.keys(),\n\t\t]);\n\t}\n\n\tprivate recomposeProvider(providerId: string): void {\n\t\tconst base = this.nativeExtensionProviders.get(providerId) ?? this.builtins.get(providerId);\n\t\tconst extension = this.extensionProviders.get(providerId);\n\t\tif (!base && !this.config.getProvider(providerId) && !extension) {\n\t\t\tthis.models.deleteProvider(providerId);\n\t\t\tthis.compositionErrors.delete(providerId);\n\t\t\treturn;\n\t\t}\n\t\tif (base && !this.config.getProvider(providerId) && !extension) {\n\t\t\t// No overlays: use the builtin untouched so its auth/login/stream behavior is exact.\n\t\t\tthis.models.setProvider(base);\n\t\t\tthis.compositionErrors.delete(providerId);\n\t\t\treturn;\n\t\t}\n\t\ttry {\n\t\t\tthis.models.setProvider(composeModelProvider(providerId, base, this.config, extension));\n\t\t\tthis.compositionErrors.delete(providerId);\n\t\t} catch (error) {\n\t\t\tthis.compositionErrors.set(providerId, error instanceof Error ? error.message : String(error));\n\t\t\tif (base) this.models.setProvider(base);\n\t\t\telse this.models.deleteProvider(providerId);\n\t\t}\n\t}\n\n\tprivate rebuildProviders(): void {\n\t\tthis.models.clearProviders();\n\t\tthis.compositionErrors.clear();\n\t\tfor (const providerId of this.providerIds()) this.recomposeProvider(providerId);\n\t\tthis.updateModelSnapshot();\n\t}\n\n\tprivate updateModelSnapshot(): void {\n\t\tconst all = [...this.models.getModels()];\n\t\tthis.snapshot = {\n\t\t\t...this.snapshot,\n\t\t\tall,\n\t\t\tavailable: all.filter((model) => this.snapshot.configuredProviders.has(model.provider)),\n\t\t};\n\t}\n\n\tprivate async runAvailabilityRefresh(seq: number, errorSeq: number, signal: AbortSignal): Promise<void> {\n\t\tconst providers = this.models.getProviders();\n\t\tconst [available, checks, credentials] = await Promise.all([\n\t\t\tthis.models.getAvailable(undefined, { signal }),\n\t\t\tPromise.all(\n\t\t\t\tproviders.map(\n\t\t\t\t\tasync (provider): Promise<[string, AuthCheck | undefined]> => [\n\t\t\t\t\t\tprovider.id,\n\t\t\t\t\t\tawait this.models.checkAuth(provider.id, { signal }),\n\t\t\t\t\t],\n\t\t\t\t),\n\t\t\t),\n\t\t\tthis.credentials.list({ signal }),\n\t\t]);\n\t\tif (seq !== this.availabilityRefreshSeq) return;\n\t\tconst auth = new Map(checks);\n\t\tconst configuredProviders = new Set(\n\t\t\tchecks\n\t\t\t\t.filter((entry): entry is [string, AuthCheck] => entry[1] !== undefined)\n\t\t\t\t.map(([providerId]) => providerId),\n\t\t);\n\t\tthis.snapshot = {\n\t\t\tall: [...this.models.getModels()],\n\t\t\tavailable: [...available],\n\t\t\tconfiguredProviders,\n\t\t\tstoredProviders: new Set(credentials.map((entry) => entry.providerId)),\n\t\t\tauth,\n\t\t};\n\t\tif (errorSeq === this.availabilityErrorSeq) this.availabilityError = undefined;\n\t}\n\n\tprivate queueAvailabilityRefresh(signal?: AbortSignal): Promise<void> {\n\t\tconst seq = ++this.availabilityRefreshSeq;\n\t\tfor (const [providerId, providerSeq] of this.providerAvailabilitySeq) {\n\t\t\tthis.providerAvailabilitySeq.set(providerId, providerSeq + 1);\n\t\t}\n\t\tconst errorSeq = ++this.availabilityErrorSeq;\n\t\tconst effectiveSignal = operationSignal(signal);\n\t\treturn this.runAvailabilityRefresh(seq, errorSeq, effectiveSignal).catch((error) => {\n\t\t\tif (errorSeq === this.availabilityErrorSeq && !effectiveSignal.aborted) {\n\t\t\t\tthis.availabilityError = error instanceof Error ? error.message : String(error);\n\t\t\t}\n\t\t\tthrow error;\n\t\t});\n\t}\n\n\tprivate async refreshProviderAvailability(providerId: string, signal: AbortSignal): Promise<void> {\n\t\t// Invalidate any full availability pass that started before this credential change.\n\t\t++this.availabilityRefreshSeq;\n\t\tconst providerSeq = (this.providerAvailabilitySeq.get(providerId) ?? 0) + 1;\n\t\tthis.providerAvailabilitySeq.set(providerId, providerSeq);\n\t\tconst errorSeq = ++this.availabilityErrorSeq;\n\t\ttry {\n\t\t\tconst [available, auth, credential] = await Promise.all([\n\t\t\t\tthis.models.getAvailable(providerId, { signal }),\n\t\t\t\tthis.models.checkAuth(providerId, { signal }),\n\t\t\t\tthis.credentials.read(providerId, { signal }),\n\t\t\t]);\n\t\t\tsignal.throwIfAborted();\n\t\t\tif (this.providerAvailabilitySeq.get(providerId) !== providerSeq) return;\n\t\t\tconst configuredProviders = new Set(this.snapshot.configuredProviders);\n\t\t\tconst storedProviders = new Set(this.snapshot.storedProviders);\n\t\t\tconst authByProvider = new Map(this.snapshot.auth);\n\t\t\tif (auth) {\n\t\t\t\tconfiguredProviders.add(providerId);\n\t\t\t\tauthByProvider.set(providerId, auth);\n\t\t\t} else {\n\t\t\t\tconfiguredProviders.delete(providerId);\n\t\t\t\tauthByProvider.delete(providerId);\n\t\t\t}\n\t\t\tif (credential) storedProviders.add(providerId);\n\t\t\telse storedProviders.delete(providerId);\n\t\t\tconst all = [...this.models.getModels()];\n\t\t\tconst availableById = new Map(\n\t\t\t\t[...this.snapshot.available.filter((model) => model.provider !== providerId), ...available].map((model) => [\n\t\t\t\t\t`${model.provider}\\0${model.id}`,\n\t\t\t\t\tmodel,\n\t\t\t\t]),\n\t\t\t);\n\t\t\tthis.snapshot = {\n\t\t\t\tall,\n\t\t\t\tavailable: all.flatMap((model) => availableById.get(`${model.provider}\\0${model.id}`) ?? []),\n\t\t\t\tconfiguredProviders,\n\t\t\t\tstoredProviders,\n\t\t\t\tauth: authByProvider,\n\t\t\t};\n\t\t\tif (errorSeq === this.availabilityErrorSeq) this.availabilityError = undefined;\n\t\t} catch (error) {\n\t\t\tif (\n\t\t\t\tthis.providerAvailabilitySeq.get(providerId) === providerSeq &&\n\t\t\t\terrorSeq === this.availabilityErrorSeq &&\n\t\t\t\t!signal.aborted\n\t\t\t) {\n\t\t\t\tthis.availabilityError = error instanceof Error ? error.message : String(error);\n\t\t\t}\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\tgetProviders(): readonly Provider[] {\n\t\treturn this.models.getProviders();\n\t}\n\n\tgetProvider(providerId: string): Provider | undefined {\n\t\treturn this.models.getProvider(providerId);\n\t}\n\n\tgetModels(providerId?: string): readonly Model<Api>[] {\n\t\treturn this.models.getModels(providerId);\n\t}\n\n\tgetModel(providerId: string, modelId: string): Model<Api> | undefined {\n\t\treturn this.models.getModel(providerId, modelId);\n\t}\n\n\tasync checkAuth(providerId: string, options?: AuthOperationOptions): Promise<AuthCheck | undefined> {\n\t\treturn this.models.checkAuth(providerId, options);\n\t}\n\n\tasync getAvailable(providerId?: string, options?: AuthOperationOptions): Promise<readonly Model<Api>[]> {\n\t\tif (providerId) {\n\t\t\tconst errorSeq = ++this.availabilityErrorSeq;\n\t\t\ttry {\n\t\t\t\tconst available = await this.models.getAvailable(providerId, options);\n\t\t\t\tif (errorSeq === this.availabilityErrorSeq) this.availabilityError = undefined;\n\t\t\t\treturn available;\n\t\t\t} catch (error) {\n\t\t\t\tif (errorSeq === this.availabilityErrorSeq && !options?.signal?.aborted) {\n\t\t\t\t\tthis.availabilityError = error instanceof Error ? error.message : String(error);\n\t\t\t\t}\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t}\n\t\tawait this.queueAvailabilityRefresh(options?.signal);\n\t\treturn this.snapshot.available;\n\t}\n\n\tgetAvailableSnapshot(): readonly Model<Api>[] {\n\t\treturn this.snapshot.available;\n\t}\n\n\tgetError(): string | undefined {\n\t\tconst errors: string[] = [];\n\t\tconst configError = this.config.getError();\n\t\tif (configError) errors.push(configError);\n\t\tfor (const [providerId, error] of this.compositionErrors) {\n\t\t\terrors.push(`Provider \"${providerId}\": ${error}`);\n\t\t}\n\t\tif (this.availabilityError) errors.push(`Availability refresh: ${this.availabilityError}`);\n\t\treturn errors.length > 0 ? errors.join(\"\\n\\n\") : undefined;\n\t}\n\n\tgetRegisteredProviderConfig(providerId: string): ProviderConfigInput | undefined {\n\t\treturn this.extensionProviders.get(providerId);\n\t}\n\n\tgetRegisteredProviderIds(): readonly string[] {\n\t\treturn [...new Set([...this.extensionProviders.keys(), ...this.nativeExtensionProviders.keys()])];\n\t}\n\n\tgetRegisteredNativeProvider(providerId: string): Provider | undefined {\n\t\treturn this.nativeExtensionProviders.get(providerId);\n\t}\n\n\t/** @internal Compatibility request configuration for ModelRegistry. */\n\tgetCompatibilityRequestConfig(model: Model<Api>): CompatibilityRequestConfig {\n\t\treturn resolveCompatibilityRequestConfig(\n\t\t\tmodel,\n\t\t\tthis.config.getProvider(model.provider),\n\t\t\tthis.extensionProviders.get(model.provider),\n\t\t);\n\t}\n\n\tisUsingOAuth(providerId: string): boolean {\n\t\treturn this.snapshot.auth.get(providerId)?.type === \"oauth\";\n\t}\n\n\tisUsingSubscription(providerId: string): boolean {\n\t\treturn this.isUsingOAuth(providerId) && this.models.getProvider(providerId)?.auth.oauth?.isSubscription === true;\n\t}\n\n\thasConfiguredAuth(providerId: string): boolean {\n\t\treturn this.snapshot.configuredProviders.has(providerId);\n\t}\n\n\t/**\n\t * 生图模型目录快照透传（供应商能力槽位设计 §3.3 装配注入）：宿主在装配期经\n\t * `configOverride` 把快照注入 image-generation 插件（注入键 `imageModelCatalog`），\n\t * 供插件运行期做主供应商/唯一候选推断（设计 §3.2 第 4/5 层）。纯投影，无状态。\n\t */\n\tgetImageModelCatalog(): Readonly<Record<string, ReadonlyArray<{ id: string; name?: string }>>> {\n\t\treturn this.config.getImageModelCatalog();\n\t}\n\n\tgetAuth(providerId: string, overrides?: ModelRuntimeAuthOverrides): Promise<AuthResult | undefined>;\n\tgetAuth(model: Model<Api>, overrides?: ModelRuntimeAuthOverrides): Promise<AuthResult | undefined>;\n\tasync getAuth(\n\t\tproviderOrModel: string | Model<Api>,\n\t\toverrides: ModelRuntimeAuthOverrides = {},\n\t): Promise<AuthResult | undefined> {\n\t\tif (typeof providerOrModel === \"string\") return this.models.getAuth(providerOrModel, overrides);\n\t\tconst resolution = await this.models.getAuth(providerOrModel, overrides);\n\t\tif (!resolution) return undefined;\n\t\tconst configuredHeaders = resolveConfiguredModelHeaders(\n\t\t\tproviderOrModel,\n\t\t\tthis.config.getProvider(providerOrModel.provider),\n\t\t\tthis.extensionProviders.get(providerOrModel.provider),\n\t\t\t{ ...(resolution.env ?? {}), ...(overrides.env ?? {}) },\n\t\t);\n\t\treturn {\n\t\t\t...resolution,\n\t\t\tauth: {\n\t\t\t\t...resolution.auth,\n\t\t\t\theaders: mergeHeaders(resolution.auth.headers, configuredHeaders),\n\t\t\t},\n\t\t};\n\t}\n\n\tprivate enqueueCredentialOperation<T>(providerId: string, signal: AbortSignal, task: () => Promise<T>): Promise<T> {\n\t\tconst previous = this.credentialOperations.get(providerId) ?? Promise.resolve();\n\t\tlet markStarted: (() => void) | undefined;\n\t\tconst started = new Promise<void>((resolve) => {\n\t\t\tmarkStarted = resolve;\n\t\t});\n\t\tconst operation = (async () => {\n\t\t\tawait previous.catch(() => {});\n\t\t\tsignal.throwIfAborted();\n\t\t\tmarkStarted?.();\n\t\t\treturn task();\n\t\t})();\n\t\tconst tail = operation.catch(() => {});\n\t\tthis.credentialOperations.set(providerId, tail);\n\t\tvoid tail.then(() => {\n\t\t\tif (this.credentialOperations.get(providerId) === tail) this.credentialOperations.delete(providerId);\n\t\t});\n\t\treturn raceWithAbortSignal(started, signal).then(() => operation);\n\t}\n\n\tprivate async synchronizeCredentialState(\n\t\tproviderId: string,\n\t\toperation: CredentialSynchronizationOperation,\n\t\tcredential: Credential | undefined,\n\t\tsignal: AbortSignal,\n\t): Promise<void> {\n\t\ttry {\n\t\t\tsignal.throwIfAborted();\n\t\t\tthis.recomposeProvider(providerId);\n\t\t\tconst compositionError = this.compositionErrors.get(providerId);\n\t\t\tif (compositionError) throw new Error(compositionError);\n\t\t\tconst result = await this.models.refresh({ allowNetwork: false, providers: [providerId], signal });\n\t\t\tif (result.aborted) signal.throwIfAborted();\n\t\t\tconst refreshError = result.errors.get(providerId);\n\t\t\tif (refreshError) throw refreshError;\n\t\t\tthis.updateModelSnapshot();\n\t\t\tawait this.refreshProviderAvailability(providerId, signal);\n\t\t} catch (cause) {\n\t\t\tthrow new CredentialSynchronizationError(providerId, operation, credential, { cause });\n\t\t}\n\t}\n\n\tsetRuntimeApiKey(providerId: string, apiKey: string, options: AuthOperationOptions = {}): Promise<void> {\n\t\tconst signal = operationSignal(options.signal);\n\t\treturn this.enqueueCredentialOperation(providerId, signal, async () => {\n\t\t\tthis.credentials.setRuntimeApiKey(providerId, apiKey);\n\t\t\tawait this.synchronizeCredentialState(\n\t\t\t\tproviderId,\n\t\t\t\t\"setRuntimeApiKey\",\n\t\t\t\t{ type: \"api_key\", key: apiKey },\n\t\t\t\tsignal,\n\t\t\t);\n\t\t});\n\t}\n\n\tremoveRuntimeApiKey(providerId: string, options: AuthOperationOptions = {}): Promise<void> {\n\t\tconst signal = operationSignal(options.signal);\n\t\treturn this.enqueueCredentialOperation(providerId, signal, async () => {\n\t\t\tthis.credentials.removeRuntimeApiKey(providerId);\n\t\t\tawait this.synchronizeCredentialState(providerId, \"removeRuntimeApiKey\", undefined, signal);\n\t\t});\n\t}\n\n\tlistCredentials(options?: AuthOperationOptions): Promise<readonly CredentialInfo[]> {\n\t\treturn this.credentials.list(options);\n\t}\n\n\tgetProviderAuthStatus(providerId: string): AuthStatus {\n\t\tif (this.credentials.hasRuntimeApiKey(providerId)) return { configured: true, source: \"runtime\" };\n\t\tif (this.snapshot.storedProviders.has(providerId)) return { configured: true, source: \"stored\" };\n\t\tconst configured = configuredRequestAuthStatus(\n\t\t\tthis.config.getProvider(providerId),\n\t\t\tthis.extensionProviders.get(providerId),\n\t\t);\n\t\tif (configured) return configured;\n\t\tconst check = this.snapshot.auth.get(providerId);\n\t\treturn check ? { configured: true, source: \"environment\", label: check.source } : { configured: false };\n\t}\n\n\tprivate async prepareRequest<TOptions extends ProviderRequestOptions & ModelsRequestTransforms>(\n\t\tmodel: Model<Api>,\n\t\toptions: TOptions | undefined,\n\t): Promise<{\n\t\tprovider: Provider;\n\t\tmodel: Model<Api>;\n\t\toptions: Omit<TOptions, \"transformHeaders\"> & ProviderRequestOptions;\n\t}> {\n\t\tconst provider = this.models.getProvider(model.provider);\n\t\tif (!provider) throw new ModelsError(\"provider\", t(\"Unknown provider: {provider}\", { provider: model.provider }));\n\t\tconst resolution = await this.getAuth(model, {\n\t\t\tapiKey: options?.apiKey,\n\t\t\tenv: options?.env,\n\t\t\tsignal: options?.signal,\n\t\t});\n\t\tif (!resolution)\n\t\t\tthrow new ModelsError(\"auth\", t(\"Provider is not configured: {provider}\", { provider: model.provider }));\n\n\t\tconst { transformHeaders, ...rawProviderOptions } = options ?? {};\n\t\tconst providerOptions = rawProviderOptions as Omit<TOptions, \"transformHeaders\"> & ProviderRequestOptions;\n\t\tlet headers = mergeHeaders(resolution.auth.headers, providerOptions.headers);\n\t\tif (transformHeaders) headers = await transformHeaders(headers ?? {});\n\t\tconst env =\n\t\t\tresolution.env || providerOptions.env\n\t\t\t\t? { ...(resolution.env ?? {}), ...(providerOptions.env ?? {}) }\n\t\t\t\t: undefined;\n\t\treturn {\n\t\t\tprovider,\n\t\t\tmodel: resolution.auth.baseUrl ? { ...model, baseUrl: resolution.auth.baseUrl } : model,\n\t\t\toptions: {\n\t\t\t\t...providerOptions,\n\t\t\t\tapiKey: providerOptions.apiKey ?? resolution.auth.apiKey,\n\t\t\t\theaders,\n\t\t\t\tenv,\n\t\t\t} as Omit<TOptions, \"transformHeaders\"> & ProviderRequestOptions,\n\t\t};\n\t}\n\n\tstream<TApi extends Api>(\n\t\tmodel: Model<TApi>,\n\t\tcontext: Context,\n\t\toptions?: ModelsApiStreamOptions<TApi>,\n\t): AssistantMessageEventStream {\n\t\treturn lazyStream(model, async () => {\n\t\t\tconst prepared = await this.prepareRequest(\n\t\t\t\tmodel,\n\t\t\t\toptions as (StreamOptions & ModelsRequestTransforms) | undefined,\n\t\t\t);\n\t\t\treturn prepared.provider.stream(\n\t\t\t\tprepared.model as Model<TApi>,\n\t\t\t\tcontext,\n\t\t\t\tprepared.options as ApiStreamOptions<TApi>,\n\t\t\t);\n\t\t});\n\t}\n\n\tcomplete<TApi extends Api>(\n\t\tmodel: Model<TApi>,\n\t\tcontext: Context,\n\t\toptions?: ModelsApiStreamOptions<TApi>,\n\t): Promise<AssistantMessage> {\n\t\treturn this.stream(model, context, options).result();\n\t}\n\n\tstreamSimple(model: Model<Api>, context: Context, options?: ModelsSimpleStreamOptions): AssistantMessageEventStream {\n\t\treturn lazyStream(model, async () => {\n\t\t\tconst prepared = await this.prepareRequest(model, options);\n\t\t\treturn prepared.provider.streamSimple(prepared.model, context, prepared.options as SimpleStreamOptions);\n\t\t});\n\t}\n\n\tcompleteSimple(model: Model<Api>, context: Context, options?: ModelsSimpleStreamOptions): Promise<AssistantMessage> {\n\t\treturn this.streamSimple(model, context, options).result();\n\t}\n\n\tasync fetchDeferred(\n\t\tmodel: Model<Api>,\n\t\thandle: DeferredHandle,\n\t\toptions?: ModelsDeferredFetchOptions,\n\t): Promise<AssistantMessage> {\n\t\treturn lazyStream(model, async () => {\n\t\t\tconst prepared = await this.prepareRequest(model, options);\n\t\t\tif (!prepared.provider.fetchDeferred) {\n\t\t\t\tthrow new ModelsError(\"provider\", `Provider ${model.provider} does not support deferred responses`);\n\t\t\t}\n\t\t\treturn prepared.provider.fetchDeferred(prepared.model, handle, prepared.options as DeferredFetchOptions);\n\t\t}).result();\n\t}\n\n\tasync cancelDeferred(\n\t\tmodel: Model<Api>,\n\t\thandle: DeferredHandle,\n\t\toptions?: ModelsDeferredCancelOptions,\n\t): Promise<void> {\n\t\tconst prepared = await this.prepareRequest(model, options);\n\t\tif (!prepared.provider.cancelDeferred) {\n\t\t\tthrow new ModelsError(\"provider\", `Provider ${model.provider} does not support deferred responses`);\n\t\t}\n\t\tawait prepared.provider.cancelDeferred(prepared.model, handle, prepared.options as DeferredCancelOptions);\n\t}\n\n\tlogin(providerId: string, type: AuthType, interaction: AuthInteraction): Promise<Credential> {\n\t\tconst signal = operationSignal(interaction.signal);\n\t\treturn this.enqueueCredentialOperation(providerId, signal, async () => {\n\t\t\tconst credential = await this.models.login(providerId, type, { ...interaction, signal });\n\t\t\tawait this.synchronizeCredentialState(providerId, \"login\", credential, signal);\n\t\t\treturn credential;\n\t\t});\n\t}\n\n\tlogout(providerId: string, options: AuthOperationOptions = {}): Promise<void> {\n\t\tconst signal = operationSignal(options.signal);\n\t\treturn this.enqueueCredentialOperation(providerId, signal, async () => {\n\t\t\tawait this.models.logout(providerId, { signal });\n\t\t\tawait this.synchronizeCredentialState(providerId, \"logout\", undefined, signal);\n\t\t});\n\t}\n\n\tasync refresh(options: ModelsRefreshOptions = {}): Promise<ModelsRefreshResult> {\n\t\tthis.config = await ModelConfig.load(this.modelsPath);\n\t\tthis.configureRadiusProviders();\n\t\tif (options.providers) {\n\t\t\tfor (const providerId of new Set(options.providers)) this.recomposeProvider(providerId);\n\t\t\tthis.updateModelSnapshot();\n\t\t} else {\n\t\t\tthis.rebuildProviders();\n\t\t}\n\t\tconst refreshOptions = {\n\t\t\t...options,\n\t\t\tallowNetwork: options.allowNetwork ?? this.modelNetworkEnabled,\n\t\t};\n\t\tconst result = await this.models.refresh(refreshOptions);\n\t\tconst errors = new Map(result.errors);\n\t\tthis.updateModelSnapshot();\n\t\tif (options.providers) {\n\t\t\tawait Promise.all(\n\t\t\t\t[...new Set(options.providers)].map(async (providerId) => {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tawait this.refreshProviderAvailability(providerId, operationSignal(options.signal));\n\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\tif (!options.signal?.aborted) {\n\t\t\t\t\t\t\terrors.set(providerId, error instanceof Error ? error : new Error(String(error)));\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}),\n\t\t\t);\n\t\t} else {\n\t\t\ttry {\n\t\t\t\tawait this.queueAvailabilityRefresh(options.signal);\n\t\t\t} catch {\n\t\t\t\t// Availability errors are recorded by the latest pass; refreshed models remain usable.\n\t\t\t}\n\t\t}\n\t\treturn { aborted: result.aborted || (options.signal?.aborted ?? false), errors };\n\t}\n\n\tregisterNativeProvider(provider: Provider): void {\n\t\tif (!provider.id.trim()) throw new Error(t(\"Provider id must not be empty.\"));\n\t\tthis.extensionProviders.delete(provider.id);\n\t\tthis.nativeExtensionProviders.set(provider.id, provider);\n\t\tthis.recomposeProvider(provider.id);\n\t\tthis.updateModelSnapshot();\n\t\tthis.markProvisionallyConfigured(\n\t\t\tprovider.id,\n\t\t\tconfiguredRequestAuthStatus(this.config.getProvider(provider.id), undefined),\n\t\t\tprovider.auth.oauth && !provider.auth.apiKey ? \"oauth\" : \"api_key\",\n\t\t);\n\t\tvoid this.refresh({ allowNetwork: false });\n\t}\n\n\t/**\n\t * Mark a newly registered provider as configured when it has a stored credential or a configured\n\t * API key. Availability checks run asynchronously, and callers such as initial model selection\n\t * read the snapshot before they finish. The next availability pass replaces this entry.\n\t */\n\tprivate markProvisionallyConfigured(\n\t\tproviderId: string,\n\t\tconfiguredStatus: AuthStatus | undefined,\n\t\ttype: AuthType,\n\t): void {\n\t\tif (!this.snapshot.storedProviders.has(providerId) && !configuredStatus?.configured) return;\n\t\tconst configuredProviders = new Set(this.snapshot.configuredProviders).add(providerId);\n\t\tconst auth = new Map(this.snapshot.auth);\n\t\t// Never clobber a real check result.\n\t\tif (!auth.get(providerId)) auth.set(providerId, { type, source: \"configured provider\" });\n\t\tthis.snapshot = {\n\t\t\t...this.snapshot,\n\t\t\tauth,\n\t\t\tconfiguredProviders,\n\t\t\tavailable: this.snapshot.all.filter((model) => configuredProviders.has(model.provider)),\n\t\t};\n\t}\n\n\tregisterProvider(providerId: string, config: ProviderConfigInput): void {\n\t\t// Validate the incoming registration on its own, like the legacy registry:\n\t\t// a broken re-registration must throw without touching the stored config.\n\t\tvalidateExtensionProvider(providerId, this.builtins.get(providerId), this.config.getProvider(providerId), config);\n\t\tthis.nativeExtensionProviders.delete(providerId);\n\t\t// Re-registration merges defined values over the previous registration and\n\t\t// preserves undefined ones, matching the legacy ModelRegistry contract.\n\t\tconst previous = this.extensionProviders.get(providerId);\n\t\tconst effective: ProviderConfigInput = { ...previous };\n\t\tfor (const [key, value] of Object.entries(config)) {\n\t\t\tif (value !== undefined) (effective as Record<string, unknown>)[key] = value;\n\t\t}\n\t\tthis.extensionProviders.set(providerId, effective);\n\t\tthis.recomposeProvider(providerId);\n\t\tthis.updateModelSnapshot();\n\t\tthis.markProvisionallyConfigured(\n\t\t\tproviderId,\n\t\t\tconfiguredRequestAuthStatus(this.config.getProvider(providerId), effective),\n\t\t\teffective.oauth && !effective.apiKey ? \"oauth\" : \"api_key\",\n\t\t);\n\t\tvoid this.refresh({ allowNetwork: false });\n\t}\n\n\tunregisterProvider(providerId: string): void {\n\t\tthis.extensionProviders.delete(providerId);\n\t\tthis.nativeExtensionProviders.delete(providerId);\n\t\tthis.recomposeProvider(providerId);\n\t\tthis.updateModelSnapshot();\n\t\tvoid this.refresh({ allowNetwork: false });\n\t}\n}\n"]}

package/dist/core/model-runtime.js

@@ -4,6 +4,7 @@ import * as builtinProviderCatalog from "@agent-forge/ai/providers/all";
 import { getAgentDir } from "../config.js";
 import { operationSignal, raceWithAbortSignal } from "../utils/abort.js";
 import { AuthStorage as DefaultAuthStorage } from "./auth-storage.js";
+import { t } from "./i18n/index.js";
 import { ModelConfig } from "./model-config.js";
 import { FileModelsStore, InMemoryCodingAgentModelsStore } from "./models-store.js";
 import { composeModelProvider, configuredRequestAuthStatus, resolveCompatibilityRequestConfig, resolveConfiguredModelHeaders, validateExtensionProvider, } from "./provider-composer.js";
@@ -15,7 +16,10 @@ export class CredentialSynchronizationError extends Error {
     operation;
     credential;
     constructor(providerId, operation, credential, options) {
-        super(`Credential ${operation} committed for ${providerId}, but local synchronization failed`, options);
+        super(t("Credential {operation} committed for {providerId}, but local synchronization failed", {
+            operation,
+            providerId,
+        }), options);
         this.name = "CredentialSynchronizationError";
         this.providerId = providerId;
         this.operation = operation;
@@ -434,14 +438,14 @@ export class ModelRuntime {
     async prepareRequest(model, options) {
         const provider = this.models.getProvider(model.provider);
         if (!provider)
-            throw new ModelsError("provider", `Unknown provider: ${model.provider}`);
+            throw new ModelsError("provider", t("Unknown provider: {provider}", { provider: model.provider }));
         const resolution = await this.getAuth(model, {
             apiKey: options?.apiKey,
             env: options?.env,
             signal: options?.signal,
         });
         if (!resolution)
-            throw new ModelsError("auth", `Provider is not configured: ${model.provider}`);
+            throw new ModelsError("auth", t("Provider is not configured: {provider}", { provider: model.provider }));
         const { transformHeaders, ...rawProviderOptions } = options ?? {};
         const providerOptions = rawProviderOptions;
         let headers = mergeHeaders(resolution.auth.headers, providerOptions.headers);
@@ -552,7 +556,7 @@ export class ModelRuntime {
     }
     registerNativeProvider(provider) {
         if (!provider.id.trim())
-            throw new Error("Provider id must not be empty.");
+            throw new Error(t("Provider id must not be empty."));
         this.extensionProviders.delete(provider.id);
         this.nativeExtensionProviders.set(provider.id, provider);
         this.recomposeProvider(provider.id);