cortico 0.1.1 → 0.1.3

package/src/extensions.ts

@@ -14,8 +14,14 @@ import type { CoreConfig, Logger } from './core/types.ts';
 import type { BotDefinition } from './bot.ts';
 import type { WorldDefinition, WorldSection } from './world.ts';
 import type { ProviderModule } from './providers/base.ts';
-import type { ExtensionInfo, ExtensionInstallTarget, ExtensionSearchHit } from './web/server.ts';
+import type {
+  ExtensionInfo,
+  ExtensionInstallTarget,
+  ExtensionPackageDetail,
+  ExtensionSearchHit,
+} from './web/server.ts';
 import {
+  EXTENSION_API_VERSIONS,
   EXTENSION_KEYWORDS,
   parseExtensionManifest,
   type ExtensionConsoleAsset,
@@ -368,11 +374,59 @@ interface RegistrySearchResponse {
       description?: string;
       keywords?: string[];
       date?: string;
+      license?: string;
       links?: { npm?: string; homepage?: string; repository?: string };
       publisher?: { username?: string };
     };
+    /** 被依赖的包数。热门包回字符串,新包回数字。 */
+    dependents?: number | string;
     downloads?: { monthly?: number };
   }>;
+  total?: number;
+}
+
+/** registry 的包文档(`GET /<name>`)。只列我们要读的字段。 */
+interface RegistryPackument {
+  'dist-tags'?: Record<string, string>;
+  versions?: Record<string, ExtensionPackageJson & {
+    license?: string;
+    deprecated?: string;
+    engines?: Record<string, string>;
+    maintainers?: Array<{ username?: string; name?: string }>;
+    _npmUser?: { name?: string };
+    dist?: { unpackedSize?: number; fileCount?: number };
+    homepage?: string;
+    bugs?: { url?: string } | string;
+    repository?: { url?: string } | string;
+  }>;
+  /** `created`、`modified` 和每个版本号各一条发布时间 */
+  time?: Record<string, string>;
+}
+
+/** 一页取满 250:registry 的上限(传更大也只回 250)。 */
+const SEARCH_PAGE_SIZE = 250;
+/**
+ * 最多翻四页。`keywords:` 过滤后的全集现在是个位数;真涨到一千条,说明关键字被滥用,
+ * 再往后翻的也不是操作员要找的包。
+ */
+const SEARCH_MAX_HITS = 1000;
+
+/**
+ * registry 给的仓库地址是 npm 规范化过的 `git+https://….git`:浏览器不认这个 scheme。
+ * 收成可点的 https；认不出形状就原样返回，让操作员自己看。
+ */
+export function repositoryWebUrl(raw: string): string {
+  let url = raw.trim().replace(/^git\+/, '').replace(/^git:\/\//, 'https://');
+  const ssh = /^(?:ssh:\/\/)?git@([^:/]+)[:/](.+)$/.exec(url);
+  if (ssh) url = `https://${ssh[1]}/${ssh[2]}`;
+  url = url.replace(/\.git$/, '');
+  return /^https?:\/\//.test(url) ? url : raw;
+}
+
+/** `{ url }` 或裸串两种写法都收。 */
+function urlOf(v: { url?: string } | string | undefined): string | undefined {
+  const raw = typeof v === 'string' ? v : v?.url;
+  return raw && raw.trim() ? raw.trim() : undefined;
 }
 
 export interface ExtensionManagerOptions {
@@ -441,35 +495,105 @@ export class ExtensionManager {
     return { dir: this.dir, extensions: out };
   }
 
-  async search(query: string, kind: ExtensionKind = 'world'): Promise<ExtensionSearchHit[]> {
+  /**
+   * 列出 npm 上带这一类关键字的全部包。**不接文本查询**:registry 的 `text=` 在
+   * `keywords:` 过滤之下只影响排序不缩小结果(实测 `keywords:cortico-world 任意词`
+   * 仍返回同样 8 条),筛选交给控制台在整份结果上做。
+   */
+  async search(kind: ExtensionKind = 'world'): Promise<ExtensionSearchHit[]> {
     const keyword = EXTENSION_KEYWORDS[kind];
-    const text = `keywords:${keyword} ${query.trim()}`.trim();
-    const url = `${this.registry}/-/v1/search?text=${encodeURIComponent(text)}&size=50`;
-    const data = (await this.fetchJson(url)) as RegistrySearchResponse;
     const installed = new Set(readInstalled(this.dir).map((p) => p.name));
     const hits: ExtensionSearchHit[] = [];
-    for (const obj of data.objects ?? []) {
-      const p = obj.package;
-      if (!p?.name || !p.version || !(p.keywords ?? []).includes(keyword)) continue;
-      hits.push({
-        name: p.name,
-        version: p.version,
-        description: p.description ?? '',
-        kind,
-        ...(p.date ? { date: p.date } : {}),
-        ...(p.publisher?.username ? { publisher: p.publisher.username } : {}),
-        downloads: obj.downloads?.monthly ?? 0,
-        links: {
-          ...(p.links?.npm ? { npm: p.links.npm } : {}),
-          ...(p.links?.repository ? { repository: p.links.repository } : {}),
-          ...(p.links?.homepage ? { homepage: p.links.homepage } : {}),
-        },
-        installed: installed.has(p.name),
-      });
+    const seen = new Set<string>();
+    for (let from = 0; from < SEARCH_MAX_HITS; from += SEARCH_PAGE_SIZE) {
+      const text = encodeURIComponent(`keywords:${keyword}`);
+      const url = `${this.registry}/-/v1/search?text=${text}&size=${SEARCH_PAGE_SIZE}&from=${from}`;
+      const data = (await this.fetchJson(url)) as RegistrySearchResponse;
+      const objects = data.objects ?? [];
+      for (const obj of objects) {
+        const p = obj.package;
+        if (!p?.name || !p.version || !(p.keywords ?? []).includes(keyword)) continue;
+        if (seen.has(p.name)) continue;
+        seen.add(p.name);
+        const repository = p.links?.repository;
+        hits.push({
+          name: p.name,
+          version: p.version,
+          description: p.description ?? '',
+          kind,
+          ...(p.date ? { date: p.date } : {}),
+          ...(p.publisher?.username ? { publisher: p.publisher.username } : {}),
+          ...(p.license ? { license: p.license } : {}),
+          ...(p.keywords?.length ? { keywords: p.keywords } : {}),
+          downloads: obj.downloads?.monthly ?? 0,
+          dependents: Number(obj.dependents) || 0,
+          links: {
+            ...(p.links?.npm ? { npm: p.links.npm } : {}),
+            ...(repository ? { repository: repositoryWebUrl(repository) } : {}),
+            ...(p.links?.homepage ? { homepage: p.links.homepage } : {}),
+          },
+          installed: installed.has(p.name),
+        });
+      }
+      if (objects.length < SEARCH_PAGE_SIZE) break;
     }
     return hits;
   }
 
+  /**
+   * 一个包的详情。控制台在操作员点开某张卡片时才调，因此这里取整份包文档
+   * (`GET /<name>`，比搜索结果多出 cortico 声明、许可证、体积与版本史)。
+   * readme 不回传：一份 30KB 以上的 markdown，控制台也不渲染它。
+   */
+  async packageInfo(name: string): Promise<ExtensionPackageDetail> {
+    if (!PACKAGE_NAME.test(name)) throw new Error(`不是合法的 npm 包名: ${name}`);
+    const doc = (await this.fetchJson(`${this.registry}/${name.replace('/', '%2F')}`)) as RegistryPackument;
+    const latest = doc['dist-tags']?.latest;
+    const v = latest ? doc.versions?.[latest] : undefined;
+    if (!latest || !v) throw new Error(`registry 没有给出 ${name} 的 latest 版本`);
+
+    const parsed = parseExtensionManifest(v);
+    const times = Object.entries(doc.time ?? {}).filter(([k]) => k !== 'created' && k !== 'modified');
+    const history = times
+      .sort((a, b) => (a[1] < b[1] ? 1 : -1))
+      .slice(0, 6)
+      .map(([version, date]) => ({ version, date }));
+    const spec = readInstalled(this.dir).find((p) => p.name === name)?.spec;
+    const repository = urlOf(v.repository);
+    const bugs = urlOf(v.bugs);
+
+    return {
+      name,
+      version: latest,
+      ...(v.description ? { description: v.description } : {}),
+      ...(v.license ? { license: v.license } : {}),
+      ...(v.keywords?.length ? { keywords: v.keywords } : {}),
+      ...(doc.time?.[latest] ? { published: doc.time[latest] } : {}),
+      ...(doc.time?.created ? { created: doc.time.created } : {}),
+      versionCount: times.length,
+      history,
+      ...(v.deprecated ? { deprecated: v.deprecated } : {}),
+      ...(parsed.ok
+        ? { manifest: parsed.manifest, frameworkApi: EXTENSION_API_VERSIONS[parsed.manifest.kind] }
+        : { problems: parsed.reasons }),
+      warnings: parsed.warnings,
+      ...(v.engines?.node ? { engines: v.engines.node } : {}),
+      ...(v.dist?.unpackedSize ? { unpackedSize: v.dist.unpackedSize } : {}),
+      ...(v.dist?.fileCount ? { fileCount: v.dist.fileCount } : {}),
+      dependencies: Object.keys(v.dependencies ?? {}),
+      maintainers: (v.maintainers ?? []).map((m) => m.username ?? m.name ?? '').filter(Boolean),
+      ...(v._npmUser?.name ? { publisher: v._npmUser.name } : {}),
+      links: {
+        npm: `https://www.npmjs.com/package/${name}`,
+        ...(repository ? { repository: repositoryWebUrl(repository) } : {}),
+        ...(v.homepage ? { homepage: v.homepage } : {}),
+        ...(bugs ? { bugs } : {}),
+      },
+      installed: spec !== undefined,
+      ...(spec !== undefined ? { installedSpec: spec } : {}),
+    };
+  }
+
   async install(target: ExtensionInstallTarget): Promise<string> {
     const spec = this.installSpec(target);
     if (!existsSync(this.dir)) mkdirSync(this.dir, { recursive: true });

package/src/launcher.ts

@@ -13,7 +13,7 @@ import { createBot } from './bot.ts';
 import { createDeployment, ensureDeployment, listBots, loadDeployment } from './deploy.ts';
 import { buildListing, type BotDefaults } from './deploy-listing.ts';
 import { secretReader } from './core/secrets.ts';
-import { announceDataDir, consumeBootFlags } from './boot.ts';
+import { announceDataDir, consoleUrlOf, consumeBootFlags, listensOnEveryInterface, startsPaused, providerAtBoot } from './boot.ts';
 import { extensionsDir, importBotDefinition, loadExtensions, locateBotPackage, readInstalled, type ActiveBotPackage } from './extensions.ts';
 import { withWorlds } from './world.ts';
 import { BUILTIN_WORLDS } from './worlds/index.ts';
@@ -160,39 +160,47 @@ async function main(): Promise<void> {
     cfg.logging.file = levelArg as LogLevel;
   }
 
+  // 监听地址与端口:--host= / --port= 只覆盖本次运行,不写回 config.json。
+  const hostArg = flagValue('host');
+  if (hostArg !== null) {
+    if (!hostArg.trim()) { console.error('--host 需要一个地址,如 0.0.0.0'); process.exit(1); }
+    cfg.web.host = hostArg.trim();
+  }
+  const portArg = flagValue('port');
+  if (portArg !== null) {
+    const port = Number(portArg);
+    if (!Number.isInteger(port) || port < 0 || port > 65535) {
+      console.error(`无效端口: ${portArg}(0–65535 的整数,0 由系统分配)`);
+      process.exit(1);
+    }
+    cfg.web.port = port;
+  }
+
   // 重启标志必须在装配与 session 加载之前处理
   consumeBootFlags(loaded.dataDir);
 
-  const activeProvider = cfg.providers?.[cfg.activeProvider];
-  if (!activeProvider) {
-    console.error(
-      `activeProvider="${cfg.activeProvider}" 在 providers 段里不存在(现有: ${Object.keys(cfg.providers ?? {}).join(' / ') || '无'})`,
-    );
-    process.exit(1);
-  }
-  const endpointDir = providerDir(cfg.activeProvider);
+  const activeProvider = providerAtBoot(cfg);
+  const endpointDir = activeProvider ? providerDir(cfg.activeProvider) : null;
   const missingSecret =
-    activeProvider.secret && !secretReader(resolve(endpointDir, '.env'))(activeProvider.secret)
+    activeProvider?.secret && endpointDir && !secretReader(resolve(endpointDir, '.env'))(activeProvider.secret)
       ? activeProvider.secret
       : null;
 
   const bot = createBot(loaded, definition, { extensions });
 
   // 必须在启动主循环前暂停，避免首批事件提前投递。
-  const startPaused =
-    process.env.CORTICO_START_PAUSED === '1' ||
-    process.env.CORTICO_START_PAUSED === 'true' ||
-    process.argv.includes('--paused');
-  if (startPaused) bot.core.bus.setPaused(true);
+  const paused = startsPaused();
+  if (paused) bot.core.bus.setPaused(true);
 
   const { port } = await bot.start();
 
   console.log(`\n  Bot:       ${botName}${cfg.displayName && cfg.displayName !== botName ? ` (${cfg.displayName})` : ''}`);
+  const consoleUrl = port === null ? null : consoleUrlOf(bot.webApp?.boundAddress ?? null, port);
   if (port !== null) {
-    console.log(`  控制台:    http://127.0.0.1:${port}/`);
-    const assetsProblem = webAssetsProblem(fileURLToPath(new URL('../dist/web', import.meta.url)));
+    console.log(`  控制台:    ${consoleUrl}${listensOnEveryInterface(bot.webApp?.boundAddress ?? null) ? `(监听 ${bot.webApp?.boundAddress},所有网卡)` : ''}`);
+    const assetsProblem = webAssetsProblem(fileURLToPath(new URL('..', import.meta.url)));
     if (assetsProblem) {
-      console.log(`  ⚠ 控制台产物不完整(${assetsProblem});停止 bot 后运行 pnpm build:web`);
+      console.log(`  ⚠ 控制台产物需要重建(${assetsProblem});停止 bot 后运行 pnpm build:web`);
     }
   }
   for (const slot of bot.assembly.slots) {
@@ -208,13 +216,13 @@ async function main(): Promise<void> {
         ? `  扩展:      ${ext.name}@${ext.version} · bot 包,本部署未引用`
         : `  扩展:      ${ext.name} 未加载: ${ext.reason}`);
   }
-  console.log(`  主模型:    ${bot.core.mainSessionSpec().model}`);
-  if (missingSecret) {
+  console.log(`  主模型:    ${activeProvider?.spec?.model || '未配置；请在控制台「模型供应商」页选择连接与模型'}`);
+  if (missingSecret && endpointDir) {
     const envFile = resolve(endpointDir, '.env');
     const where = existsSync(envFile) ? `${envFile} 里也没有` : `${envFile} 不存在`;
     console.log(`  ⚠ 缺少 ${missingSecret}:进程环境里没有,${where}；可在控制台「模型提供商」页修改密钥变量名或补填密钥`);
   }
-  if (startPaused) {
+  if (paused) {
     console.log('  ⏸ 已暂停');
   }
   console.log('');
@@ -223,7 +231,7 @@ async function main(): Promise<void> {
     process.env.CORTICO_OPEN_BROWSER === '1' ||
     process.env.CORTICO_OPEN_BROWSER === 'true' ||
     process.argv.includes('--open');
-  if (openBrowserFlag && port !== null) openBrowser(`http://127.0.0.1:${port}/`);
+  if (openBrowserFlag && consoleUrl !== null) openBrowser(consoleUrl);
 
   // 此时限覆盖整个关机流程；各步骤的时限由 bot.shutdown() 管理。
   const SHUTDOWN_GRACE_MS = 35_000;

package/src/protocol/open-responses/context-helpers.ts

@@ -12,7 +12,9 @@ export function withoutPastReasoning(entries: readonly ContextRecord[]): Context
 }
 export function responseRequest(spec: ModelSpec, context: readonly ContextRecord[], tools: readonly ToolSchema[] = []): Request {
   return {
-    model: spec.model, input: context.map(inputItem), tools: tools.map(tool => ({ ...tool, type: 'function' })),
+    model: spec.model, input: context.map(inputItem),
+    // 只有协议声明的成员进线;运行时传进来的对象还带着分类标签,它归控制台与工具装配。
+    tools: tools.map(({ name, description, parameters }) => ({ type: 'function' as const, name, description, parameters })),
     // effort 词表归端点(见 ModelSpec.reasoningEffort);协议枚举只覆盖 OpenAI 自己的取值。
     reasoning: spec.thinking ? { ...(spec.reasoningEffort ? { effort: spec.reasoningEffort as Schemas['ReasoningEffortEnum'] } : {}) } : { effort: 'none' },
     ...(spec.temperature !== undefined ? { temperature: spec.temperature } : {}),

package/src/protocol/open-responses/context-log.ts

@@ -1,4 +1,4 @@
-import { appendFileSync, closeSync, existsSync, fsyncSync, mkdirSync, openSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { appendFileSync, closeSync, existsSync, fsyncSync, mkdirSync, openSync, readFileSync, renameSync, truncateSync, writeFileSync } from 'node:fs';
 import { dirname } from 'node:path';
 import type { ContextRecord } from './context.ts';
 
@@ -10,6 +10,20 @@ function freeze<T>(value: T): T {
   return value;
 }
 
+function isRecord(row: unknown): row is ContextRecord {
+  const r = row as ContextRecord | null;
+  return !!r && r.version === 2 && !!r.item && typeof r.item === 'object' && !Array.isArray(r.item)
+    && !!r.context && typeof r.context === 'object' && !Array.isArray(r.context);
+}
+
+/**
+ * The repair `load()` applied to a final line that has no trailing newline. A line that does not
+ * parse is cut off; a complete record only gets its newline.
+ */
+export type ContextLoadRepair =
+  | { kind: 'torn-tail'; bytes: number }
+  | { kind: 'unterminated-tail' };
+
 /** Immutable standard Items with runtime metadata stored in a separate field. */
 export class ContextLog {
   private entries: readonly ContextRecord[] = Object.freeze([]);
@@ -19,18 +33,32 @@ export class ContextLog {
 
   get records(): readonly ContextRecord[] { return this.entries; }
 
-  load(): void {
-    if (!existsSync(this.file)) { this.entries = Object.freeze([]); return; }
-    const rows = readFileSync(this.file, 'utf8').split(/\r?\n/).filter(line => line.trim()).map((line, index) => {
-      let row: ContextRecord;
-      try { row = JSON.parse(line) as ContextRecord; }
+  /** Any other damaged line throws and leaves the file untouched. */
+  load(): ContextLoadRepair | null {
+    if (!existsSync(this.file)) { this.entries = Object.freeze([]); return null; }
+    const raw = readFileSync(this.file, 'utf8');
+    let body = raw;
+    let repair: ContextLoadRepair | null = null;
+    if (raw.length > 0 && !raw.endsWith('\n')) {
+      const cut = raw.lastIndexOf('\n') + 1;
+      const tail = raw.slice(cut);
+      let parsed: unknown = null;
+      try { parsed = JSON.parse(tail); } catch { /* torn */ }
+      if (isRecord(parsed)) repair = { kind: 'unterminated-tail' };
+      else { body = raw.slice(0, cut); repair = { kind: 'torn-tail', bytes: Buffer.byteLength(tail, 'utf8') }; }
+    }
+    const rows = body.split(/\r?\n/).filter(line => line.trim()).map((line, index) => {
+      let row: unknown;
+      try { row = JSON.parse(line); }
       catch { throw new Error(`Invalid session JSON at ${this.file}:${index + 1}`); }
-      if (!row || row.version !== 2 || !row.item || typeof row.item !== 'object' || Array.isArray(row.item)
-        || !row.context || typeof row.context !== 'object' || Array.isArray(row.context))
-        throw new Error(`Invalid context record at ${this.file}:${index + 1}`);
+      if (!isRecord(row)) throw new Error(`Invalid context record at ${this.file}:${index + 1}`);
       return freeze(row);
     });
+    // Written only after every kept line validated.
+    if (repair?.kind === 'torn-tail') truncateSync(this.file, Buffer.byteLength(body, 'utf8'));
+    else if (repair) appendFileSync(this.file, '\n');
     this.entries = Object.freeze(rows);
+    return repair;
   }
 
   append(entry: ContextRecord): ContextRecord {

package/src/providers/README.md

@@ -1,4 +1,4 @@
-<!-- Owner: src/providers/base.ts, src/providers/registry.ts -->
+<!-- Owner: src/providers/base.ts, src/providers/console/hub.ts, src/providers/hub-api.ts, src/providers/name.ts, src/providers/registry.ts, src/providers/console/settings.ts, src/providers/console/config.ts, src/providers/openai-responses-compat/config.ts, src/providers/transport/responses-input.ts, src/providers/transport/history.ts, src/providers/llamacpp/native.ts -->
 
 # src/providers
 
@@ -22,20 +22,23 @@
 ## ProviderModule
 
 `id` 必须等于目录名(扩展包里则是包声明的 id)。必填:`title`、`reasoningTiers`(空表 = 开放,
-effort 收任意非空串)、`serviceTiers`、`create(name, entry, host)`。可选:`defaultBaseUrl` 与
+effort 收任意非空串)、`serviceTiers`、`create(name, entry, host)`。可选:`description`、`defaultBaseUrl` 与
 `baseUrlSuggestions`、`effortSuggestions`、`temperatureNote`、`localize()`、`normalize()`、
 `validateEntry()`、`validateModel()`、`accepts()`(多模态判定)、`config()` 与 `console()`
 (附加配置组与面板)、`prices()`、`estimateTokens()`、`contextOverflow()`。
 
-地址、密钥变量名与图像开关由控制台的端点面板编辑,模块不为它们声明配置组。模块自己的
-`options.*` 要么走 `config()` 的配置组,要么由 `console()` 声明一块挂进 `instance` 插槽的面板——
-内建 llamacpp 的运行时与模型两段走的是后者。
+地址、密钥变量名与图像开关不归模块:框架在 `console/config.ts` 里为每个端点声明这一组,
+扩展来的模块照样有。模块自己的 `options.*` 走 `config()` 的配置组,模块的面板作为端点编辑页的段落
+用控制台的 schema 渲染器画同一份声明、经 `ctx.setConfig` 暂存到连接草稿——内建 llamacpp 的运行时与启动
+两段走的是这条。段落顺序由 `console()` 的 `panels` 定:编辑页自带的四块(`console/config.ts` 的
+`connectionBlocks`)与模块自己的面板排成一列。`console()` 显式给空 `config` 表示这一页不另开配置页签,
+声明仍参与服务端校验。启停与模型操作这类动作走面板 invoke。
 
 `create()` 返回 `ProviderInstance`:`client`(实现 `respond`)、`listModels?`、`control?`、
 `compatibilityKey?`、`start?` / `stop?`、`contextWindow?(model)`。
 
 `ProviderHost` 给实例:`stateDir`(`<部署根>/providers/<端点名>/`,归实例独占)、`repoRoot`、
-`resource()`、`currentEntry()`、`secret(name)`(进程环境优先,否则读 `stateDir/.env` 一次)、
+`resource()`、`currentEntry()`、`secret(name)`(进程环境优先,否则现读 `stateDir/.env`)、
 `readBlob()`、`keepThinking()`、`log`。
 
 ## 注册与解析
@@ -44,10 +47,11 @@ effort 收任意非空串)、`serviceTiers`、`create(name, entry, host)`。可
 之前通过 `registerProviderModules()` 注册,id 重复时抛错。
 
 `ProviderRegistry.resolve(name)`:按 `entry.kind` 找模块,`normalize`,以去掉 `pricing` 与
-`spec` 的条目 JSON 为缓存键(改模型或价格不重建实例),填 `stateDir` 与 `secret`。
+`spec` 的条目 JSON 加端点 `.env` 的内容指纹为缓存键(改模型或价格不重建实例,密钥文件变更后
+下一次解析重建),填 `stateDir` 与 `secret`。
 `bind(name)` 在实例外包一层:注入 `quote`(报价快照)与 `origin`(实例、模块、模型、
 `compatibilityDomain` = sha256(kind + baseUrl + `compatibilityKey()`))。Responses 历史推理仅在实例、
-模块、兼容域与模型均匹配时回传。`invalidate()` 清除缓存;写入 `.env` 后必须调用,每个实例仅缓存一次文件内容。
+模块、兼容域与模型均匹配时回传。`invalidate()` 清除缓存,控制台保存端点后调用;`.env` 变更经缓存键在下一次解析生效。
 
 ## 配置形状
 
@@ -62,14 +66,18 @@ Core 侧:`activeProviderEntry()` / `activeSpec()` 每次现读;`contextWindowOf(
 ## transport
 
 `response-http.ts` 处理 HTTP/SSE:一次生成可包含多次请求尝试,重试间隔为 `[1s, 4s, 10s]`;超时
-四档(流式首包 300s、非流式 120s、帧空闲 120s、内容空闲 300s);只对状态 0 / 429 / 5xx 重试,
-401 / 403 先 `transport.refresh()` 一次;已提交不可逆增量后不再重试;输出字符超过
+四档(流式首包 300s、非流式 120s、帧空闲 120s、内容空闲 300s);只对状态 0 / 408 / 429 / 5xx
+重试,响应带 `Retry-After` 时按它退避,401 / 403 先 `transport.refresh()`
+一次;已提交不可逆增量后不再重试;输出字符超过
 `max_output_tokens × 12` 时终止请求并报告超限;终态只接受 `completed` / `incomplete`,`failed` 抛
 `LLMError`;每次请求尝试记录 `meters` 与 `charges`。
 
 `responses-input.ts` 是原生 Responses 的无状态重放(system / developer 上提为
-`instructions`);`chat.ts` + `native-input.ts` / `history.ts` 转换 Chat Completions 请求(历史
-思维链不回传);`response-assembly.ts` 把两种流归一成 Open Responses 的 Item 流,
+`instructions`;思维链按 `reasoningReplay` 以签名块或 `reasoning_text` 回传,明文形态下没有记录来源
+的调用前补一项合成推理);`chat.ts` + `native-input.ts` / `history.ts` 转换 Chat Completions 请求(历史
+思维链回不回传由模块定:`renderMessagesWithMedia` 的 `keepReasoning` 决定出不出线,`dropPastThinking`
+把合成开头之外的每条抹空);
+`response-assembly.ts` 把两种流归一成 Open Responses 的 Item 流,
 `finish_reason` 的 `length` / `content_filter` 落成 `incomplete_details.reason`;
 `response-meters.ts` 把两种 usage 归一成 `TokenMeters`,缺项保持 null。
 
@@ -83,3 +91,27 @@ Core 侧:`activeProviderEntry()` / `activeSpec()` 每次现读;`contextWindowOf(
 模块默认,快照带 sha256 id 与 `capturedAt`。计量键:`input` / `output` / `total` /
 `cachedInput` / `uncachedInput` / `reasoning` 与 `detail:*`,单价按每百万 token。实际扣费在
 `src/core/generation.ts` 的 `priceUsage()`,缺计量记 `amount: null`。
+
+## 端点配置接口
+
+`console/hub.ts` 的 `ProviderHub` 是控制台改端点的唯一入口,`hub-api.ts` 把它接到
+`/api/providers`(聚合、按名读取、保存、删除、设为当前、测试、模型列表)与
+`/api/provider-modules`(已注册模块)。列表保留 `kind` 没有对应模块的端点,active 与可用性
+分别报告;状态帧的 `modelConnection` 带当前端点的名称、模型、模块与地址。
+
+新名称由 `name.ts` 校验:英文字母、数字、`-` 或 `_`,首字符是字母或数字,不收空格与 Windows
+设备名——名字就是 `<部署根>/providers/` 下的目录名。已在磁盘上的名字不改就继续有效。保存带
+读取时的 revision(端点 `config.json` 与 `.env` 的 sha256),对不上返回 409。共享目录上的写锁
+`.write-lock` 串行化各进程的写入。改名同时改目录和部署根内各 `deployment.json` 的
+`activeProvider`,中途失败回滚已动过的文件和目录;还被引用的端点不能删。
+
+保存一次校验模型、连接与模块配置,再写 `config.json` 和可选密钥;密钥进该端点的 `.env`,读取
+接口不返回密钥值。写完清掉本进程的实例缓存,已绑定的请求与 fork 保持原客户端;其他进程在下次
+重读共享配置时跟上。
+
+`ProviderConsoleHost.editing` 表示这个实例来自还没保存的表单,模块据此拒绝运行时副作用,
+`host.save` 把配置交回浏览器暂存。`ProviderRegistry.previewRegistry` 按一份条目造注册表,实例不进
+运行实例缓存,浏览器刚输入的密钥作为覆盖值排在进程环境与端点 `.env` 之前;测试与模型列表带
+`{ entry, secretValue }` 时走它。
+
+连接列表的 usage 包含其他部署的选用记录及运行锁状态，排除当前部署。运行状态按部署配置的 paths.data（缺省使用 Core 默认值）检查实例锁，不代表供应商正在处理请求，也不建立供应商独占锁。

package/src/providers/base.ts

@@ -70,6 +70,7 @@ export interface ProviderAvailability {
 export interface ProviderModule {
   id: string;
   title: string;
+  description?: string;
   defaultBaseUrl?: string;
   /** Candidate endpoint URLs offered on the URL field. Candidates only: any URL is accepted. */
   baseUrlSuggestions?: readonly string[];
@@ -83,6 +84,7 @@ export interface ProviderModule {
    * Absent (or a field left out) = the tables above are shown as written.
    */
   localize?(language: Language): {
+    description?: string;
     reasoningTiers?: readonly ReasoningTier[];
     serviceTiers?: readonly ServiceTier[];
     temperatureNote?: string;

package/src/providers/console/config.ts

@@ -0,0 +1,36 @@
+import type { ConfigGroup } from '../../core/config-schema.ts';
+import type { LLMProviderEntry } from '../../core/types.ts';
+import type { Language } from '../../core/language.ts';
+import type { ConsolePanelDecl } from '../../web/shared/console-protocol.ts';
+import { text } from './strings.ts';
+
+/**
+ * The editor's own sections with their default wording. A module lists them among its panels,
+ * in the order its workflow wants, and may override title and description.
+ */
+export function connectionBlocks(language: Language): Record<'endpoint' | 'model' | 'pricing' | 'protocol', ConsolePanelDecl> {
+  const S = text(language);
+  return {
+    endpoint: { id: 'endpoint', title: S.endpointBlock, description: S.endpointBlockDescription, builtin: 'connection-endpoint' },
+    model: { id: 'model', title: S.modelBlock, description: S.modelBlockDescription, builtin: 'connection-model' },
+    pricing: { id: 'pricing', title: S.pricingBlock, builtin: 'connection-pricing' },
+    protocol: { id: 'protocol', title: S.protocolBlock, description: S.protocolBlockDescription, builtin: 'connection-protocol' },
+  };
+}
+
+export function connectionGroup(name: string, entry: LLMProviderEntry, language: Language): ConfigGroup {
+  const S = text(language);
+  const prefix = `providers.${name}.`;
+  return {
+    id: `llm.${entry.kind}.${name}.connection`,
+    owner: `provider:${entry.kind}`,
+    schema: {
+      type: 'object', title: name, description: S.connectionDescription,
+      properties: {
+        [`${prefix}baseUrl`]: { type: 'string', title: S.baseUrl, 'x-hot': true },
+        [`${prefix}secret`]: { type: 'string', title: S.secret, description: S.secretDescription, 'x-hot': true },
+        [`${prefix}multimodal`]: { type: 'boolean', title: S.multimodal, 'x-hot': true },
+      },
+    },
+  };
+}