cortico 0.1.0

package/src/web/client/console-pages/builtins/llm-settings/pricing-panel.ts

@@ -0,0 +1,168 @@
+import type { ConsoleUi } from '../../../../shared/client-panel.ts';
+import type { Language } from '../../../core/language.ts';
+import { panel } from './strings.ts';
+
+interface Rule {
+  meter: string;
+  perMillion: number;
+}
+interface Quote {
+  currency: string;
+  basis: string;
+  rules: Rule[];
+  source: string;
+  inputBands?: unknown[];
+  serviceTiers?: unknown;
+}
+export interface ModelQuote {
+  model: string;
+  quotes: Quote[];
+}
+
+const FORM_METERS = ['cachedInput', 'uncachedInput', 'output'] as const;
+
+/** The one shape the three-rate form edits: a single `*` marginal definition with exactly the three meters. */
+interface SimpleCost {
+  currency: string;
+  rates: [number, number, number];
+}
+
+function readSimple(saved: unknown[]): SimpleCost | null {
+  if (saved.length !== 1) return null;
+  const definition = saved[0] as Record<string, unknown>;
+  if (!definition || typeof definition !== 'object') return null;
+  const models = definition.models;
+  if (!Array.isArray(models) || models.length !== 1 || models[0] !== '*') return null;
+  if (definition.basis !== 'marginal' || typeof definition.currency !== 'string') return null;
+  if (definition.inputBands !== undefined || definition.serviceTiers !== undefined) return null;
+  const rules = definition.rules;
+  if (!Array.isArray(rules) || rules.length !== FORM_METERS.length) return null;
+  const rates = FORM_METERS.map((meter) => {
+    const rule = rules.find((rule: Rule) => rule.meter === meter) as Rule | undefined;
+    return rule && typeof rule.perMillion === 'number' ? rule.perMillion : NaN;
+  });
+  if (rates.some((rate) => Number.isNaN(rate))) return null;
+  return { currency: definition.currency, rates: rates as [number, number, number] };
+}
+
+function writeSimple(cost: SimpleCost): unknown[] {
+  return [
+    {
+      models: ['*'],
+      currency: cost.currency,
+      basis: 'marginal',
+      source: 'console',
+      rules: FORM_METERS.map((meter, i) => ({ meter, perMillion: cost.rates[i] })),
+    },
+  ];
+}
+
+/**
+ * Pricing sheet: effective quotes, the three-rate form, the full-rules JSON (`details`) and the
+ * quote snapshot. The JSON textarea is the single draft; form edits write through into it, and
+ * every change commits the parsed textarea. An endpoint with no pricing keeps the form blank and
+ * commits an empty definition list until a rate is typed. Saved pricing the form cannot express
+ * opens the textarea and leaves the form blank until edited.
+ */
+export function pricingEditor(
+  ui: ConsoleUi,
+  saved: unknown[],
+  quotes: ModelQuote[],
+  commit: (pricing: unknown[]) => void,
+  language?: Language,
+) {
+  const S = language === 'en' ? panel.en : panel.zh;
+  const card = ui.sheet({
+    title: S.pricingTitle,
+    desc: S.pricingDescription,
+  });
+  const labels: Record<string, string> = S.meters;
+  for (const row of quotes) {
+    if (!row.quotes.length) card.body.append(ui.msgline(S.quoteUnknown(row.model)));
+    for (const quote of row.quotes) {
+      card.body.append(
+        ui.kv([
+          {
+            k: row.model,
+            v: `${quote.currency} · ${quote.basis === 'marginal' ? S.marginal : S.equivalent}`,
+          },
+        ]),
+        ui.msgline(
+          quote.rules.length
+            ? quote.rules
+                .map((rule) => S.perMillion(labels[rule.meter] ?? rule.meter, rule.perMillion))
+                .join(' · ')
+            : S.free,
+        ),
+        ui.msgline(quote.source),
+      );
+      if (quote.inputBands?.length || quote.serviceTiers)
+        card.body.append(ui.msgline(S.bandsNote));
+    }
+  }
+  const unset = saved.length === 0;
+  if (unset) card.body.append(ui.msgline(S.pricingUnset));
+  const simple: SimpleCost | null = unset ? null : readSimple(saved);
+  const raw = ui.textarea({
+    rows: 10,
+    value: JSON.stringify(simple ? writeSimple(simple) : saved, null, 2),
+    onChange: commitDraft,
+  });
+  const currency = ui.input({ value: simple?.currency ?? 'USD', onChange: writeThrough });
+  currency.setAttribute('aria-label', S.currencyField);
+  const problem = ui.msgline();
+  const rateLabels = [S.rateCached, S.rateUncached, S.rateOutput];
+  const rates = rateLabels.map((label, i) => {
+    const input = ui.input({
+      type: 'number',
+      value: simple ? String(simple.rates[i]) : '',
+      onChange: writeThrough,
+    });
+    input.min = '0';
+    input.step = 'any';
+    input.setAttribute('aria-label', label);
+    return input;
+  });
+  /** 三格全空 = 没有报价;填了任何一格,空格按 0 计。 */
+  function writeThrough() {
+    const blank = rates.every((input) => input.value.trim() === '');
+    raw.value = blank
+      ? '[]'
+      : JSON.stringify(
+          writeSimple({
+            currency: currency.value.trim() || 'USD',
+            rates: rates.map((input) => Number(input.value) || 0) as [number, number, number],
+          }),
+          null,
+          2,
+        );
+    commitDraft();
+  }
+  /** 完整规则那格可以写坏;解析不过就停在这张卡上说清楚,不往端点写。 */
+  function commitDraft(): void {
+    try {
+      const pricing = JSON.parse(raw.value) as unknown[];
+      problem.textContent = '';
+      problem.classList.remove('bad');
+      commit(pricing);
+    } catch (error) {
+      problem.textContent = String(error);
+      problem.classList.add('bad');
+    }
+  }
+  card.body.append(
+    ui.field(S.currencyField, currency),
+    ...rates.map((input, i) => ui.field(rateLabels[i], input)),
+    ui.msgline(simple || unset ? S.costFormNote : S.costFormOverridden),
+  );
+  const advanced = ui.h('details');
+  advanced.open = !simple && !unset;
+  advanced.append(ui.h('summary', null, S.editFull), raw, ui.msgline(S.fullNote), problem);
+  const preview = ui.h('details');
+  preview.append(
+    ui.h('summary', null, S.viewSnapshot),
+    ui.h('pre', 'mono', JSON.stringify(quotes, null, 2)),
+  );
+  card.body.append(advanced, preview);
+  return { el: card.el };
+}

package/src/web/client/console-pages/builtins/llm-settings/strings.ts

@@ -0,0 +1,213 @@
+/** 端点表面板与报价编辑器的文案。按 `ctx.language` 选表——面板的语言跟着调用它的那一页走。 */
+const zh = {
+  saved: '已保存，下一次请求生效。',
+  instancesTitle: '供应实例',
+  instancesDescription:
+    '每个实例独立保存连接、模型档与报价。当前请求与已启动的后台会话保持原有绑定。',
+  activeSuffix: ' · 当前',
+  instanceField: '供应实例',
+  newInstanceName: '新实例名称',
+  newInstanceUrl: 'HTTP(S) 供应地址',
+  addInstance: '添加实例',
+  connectionTitle: '连接',
+  connectionDescription: '地址与密钥全局共用：别的部署选中同一实例时读的是同一份。',
+  baseUrl: '供应地址',
+  secretName: '密钥变量名',
+  secretNamePlaceholder: '环境变量名；留空 = 无鉴权',
+  secretStatus: '密钥',
+  secretSource: { env: '进程环境', file: '端点 .env', none: '未配置' },
+  secretValue: '密钥值',
+  secretValuePlaceholder: '只写入端点 .env，不回显',
+  saveSecret: '写入密钥',
+  secretSaved: '密钥已写入端点 .env。',
+  secretNameFirst: '先保存密钥变量名，再写入密钥值。',
+  multimodal: '接受图片输入',
+  endpointPath: '请求路径',
+  extraHeaders: '附加请求头（JSON 对象）',
+  extraBody: '附加请求体（JSON 对象）',
+  jsonObjectRequired: (label: string) => `${label} 必须是 JSON 对象`,
+  advancedProtocolTitle: '协议与请求扩展',
+  advancedProtocolDescription: '',
+  modelFieldLabel: '模型标识',
+  effortFieldLabel: '推理强度',
+  temperatureFieldLabel: '采样温度',
+  specTitle: '模型档',
+  specDescription: '此端点的每次调用共用这份模型配置；fork 使用创建时的快照。',
+  modelName: '明确模型名',
+  fetchModels: '取模型列表',
+  modelsFetched: (count: number) => `取到 ${count} 个模型。`,
+  modelListFailed: (message: string) => `取不到模型列表：${message}`,
+  selectModel: '选择模型',
+  unsupportedTier: (current: string) => `当前档位未支持：${current}`,
+  thinkingOn: '开启',
+  thinkingOff: '关闭',
+  effortPlaceholder: '推理强度；空 = 端点默认，none = 关闭',
+  effortAria: '推理强度',
+  temperaturePlaceholder: '温度默认',
+  modelAria: '模型',
+  tierAria: '推理档位',
+  temperatureAria: '温度',
+  maxTokens: '最大输出 token',
+  contextWindow: '上下文窗口',
+  serviceTier: '服务档',
+  serverDefault: '服务端默认',
+  activate: '设为当前供应实例',
+  probe: '测试可用性',
+  probeTitle: '测试结果',
+  probeStatus: '状态',
+  probeOk: '成功',
+  probeFailed: '失败',
+  probeLatency: '耗时',
+  probeModel: '回显模型',
+  probeUsage: '用量',
+  probeUsageLine: (input: string, cached: string, output: string, reasoning: string) =>
+    `输入 ${input} · 缓存命中 ${cached} · 输出 ${output} · 推理 ${reasoning}`,
+  probeEncrypted: '加密思维链',
+  yes: '有',
+  no: '无',
+  probeCost: '本次费用',
+  duplicate: '复制',
+  duplicateName: '副本名称',
+  duplicateConfirm: '复制为',
+  duplicated: '已复制。',
+  delete: '删除',
+  deleteConfirmTitle: (name: string) => `删除实例 ${name}？`,
+  deleteConfirmBody: '端点配置与 .env 一并删除。别的部署若选中了它，无法在此得知。',
+  deleted: '已删除。',
+  pricingTitle: '报价',
+  pricingDescription: '历史流水固定使用请求时的报价。自定义报价按模型与费用口径覆盖模块默认值。',
+  pricingUnset: '未设报价：这个端点的调用在用量与成本页只计 token，不计金额。',
+  meters: {
+    input: '输入',
+    cachedInput: '缓存命中',
+    uncachedInput: '未缓存输入',
+    output: '输出',
+    reasoning: '推理',
+    total: '总量',
+  },
+  quoteUnknown: (model: string) => `${model}：报价未知`,
+  marginal: '边际费用',
+  equivalent: 'API 等价费用',
+  perMillion: (label: string, rate: number) => `${label} ${rate}/百万`,
+  free: '已明确免费',
+  bandsNote: '含输入阶梯或服务档；按本次实际用量与服务档计费。',
+  rateCached: '缓存命中 / 百万 token',
+  rateUncached: '未缓存输入 / 百万 token',
+  rateOutput: '输出 / 百万 token',
+  currencyField: '币种',
+  costFormNote: '基础费率统一适用于全部模型；阶梯或多模型规则请在下方完整规则中配置。',
+  costFormOverridden: '当前报价不是三格表能表达的形状，以下方完整规则为准；改动三格表会覆盖它。',
+  editFull: '高级定价规则 (JSON)',
+  fullNote:
+    '空数组恢复模块默认报价；rules 为空数组表示明确免费。完整规则支持输入阶梯、服务档及额外计量单位。',
+  viewSnapshot: '查看当前生效报价快照',
+};
+const en: typeof zh = {
+  saved: 'Saved; applies from the next request.',
+  instancesTitle: 'Provider instances',
+  instancesDescription:
+    'Each instance keeps its own connection, model spec and pricing. In-flight requests and running background sessions keep their existing binding.',
+  activeSuffix: ' · active',
+  instanceField: 'Provider instance',
+  newInstanceName: 'New instance name',
+  newInstanceUrl: 'HTTP(S) provider URL',
+  addInstance: 'Add instance',
+  connectionTitle: 'Connection',
+  connectionDescription:
+    'URL and key are global: other deployments selecting this instance read the same copy.',
+  baseUrl: 'Provider URL',
+  secretName: 'Key variable name',
+  secretNamePlaceholder: 'Environment variable name; empty = no auth',
+  secretStatus: 'API key',
+  secretSource: { env: 'process env', file: 'endpoint .env', none: 'not set' },
+  secretValue: 'Key value',
+  secretValuePlaceholder: 'Written to the endpoint .env only; never shown',
+  saveSecret: 'Save key',
+  secretSaved: 'Key written to the endpoint .env.',
+  secretNameFirst: 'Save the key variable name before writing a key value.',
+  multimodal: 'Accepts image input',
+  endpointPath: 'Request path',
+  extraHeaders: 'Extra headers (JSON object)',
+  extraBody: 'Extra body (JSON object)',
+  jsonObjectRequired: (label: string) => `${label} must be a JSON object`,
+  advancedProtocolTitle: 'Protocol & Request Overrides',
+  advancedProtocolDescription: '',
+  modelFieldLabel: 'Model identifier',
+  effortFieldLabel: 'Reasoning effort',
+  temperatureFieldLabel: 'Sampling temperature',
+  specTitle: 'Model',
+  specDescription: 'Calls on this endpoint share its model configuration; forks use the snapshot from their creation.',
+  modelName: 'Exact model name',
+  fetchModels: 'Fetch models',
+  modelsFetched: (count: number) => `Fetched ${count} models.`,
+  modelListFailed: (message: string) => `Could not fetch the model list: ${message}`,
+  selectModel: 'Pick a model',
+  unsupportedTier: (current: string) => `Unsupported current tier: ${current}`,
+  thinkingOn: 'on',
+  thinkingOff: 'off',
+  effortPlaceholder: 'Reasoning effort; empty = endpoint default, none = off',
+  effortAria: 'Reasoning effort',
+  temperaturePlaceholder: 'Default temperature',
+  modelAria: 'Model',
+  tierAria: 'Reasoning tier',
+  temperatureAria: 'Temperature',
+  maxTokens: 'Max output tokens',
+  contextWindow: 'Context window',
+  serviceTier: 'Service tier',
+  serverDefault: 'Server default',
+  activate: 'Set as active provider instance',
+  probe: 'Test endpoint',
+  probeTitle: 'Test result',
+  probeStatus: 'Status',
+  probeOk: 'ok',
+  probeFailed: 'failed',
+  probeLatency: 'Latency',
+  probeModel: 'Model echoed',
+  probeUsage: 'Usage',
+  probeUsageLine: (input: string, cached: string, output: string, reasoning: string) =>
+    `input ${input} · cached ${cached} · output ${output} · reasoning ${reasoning}`,
+  probeEncrypted: 'Encrypted reasoning',
+  yes: 'yes',
+  no: 'no',
+  probeCost: 'Cost of this call',
+  duplicate: 'Duplicate',
+  duplicateName: 'Copy name',
+  duplicateConfirm: 'Duplicate as',
+  duplicated: 'Duplicated.',
+  delete: 'Delete',
+  deleteConfirmTitle: (name: string) => `Delete instance ${name}?`,
+  deleteConfirmBody:
+    'Removes the endpoint config and its .env. Whether another deployment selects it cannot be known here.',
+  deleted: 'Deleted.',
+  pricingTitle: 'Pricing',
+  pricingDescription:
+    'Historical records keep the quote in effect at request time. Custom quotes override module defaults per model and cost basis.',
+  pricingUnset: 'No pricing set: calls on this endpoint count tokens but no amount on the usage page.',
+  meters: {
+    input: 'Input',
+    cachedInput: 'Cache hit',
+    uncachedInput: 'Uncached input',
+    output: 'Output',
+    reasoning: 'Reasoning',
+    total: 'Total',
+  },
+  quoteUnknown: (model: string) => `${model}: quote unknown`,
+  marginal: 'Marginal cost',
+  equivalent: 'API-equivalent cost',
+  perMillion: (label: string, rate: number) => `${label} ${rate}/M`,
+  free: 'Explicitly free',
+  bandsNote: 'Includes input bands or service tiers; billed by actual usage and service tier per request.',
+  rateCached: 'Cache hit / M tokens',
+  rateUncached: 'Uncached input / M tokens',
+  rateOutput: 'Output / M tokens',
+  currencyField: 'Currency',
+  costFormNote:
+    'Base rates apply to all models; input bands and service tiers go in the full rules below.',
+  costFormOverridden:
+    'The saved pricing is not a shape the three-rate form can express; the full rules below apply. Editing the form replaces them.',
+  editFull: 'Advanced Pricing Rules (JSON)',
+  fullNote:
+    'An empty array restores the module default quote; an empty rules array means explicitly free. Full rules support input bands, service tiers and extra meters.',
+  viewSnapshot: 'View active pricing snapshot',
+};
+export const panel = { zh, en };

package/src/web/client/console-pages/builtins.ts

@@ -0,0 +1,10 @@
+/** 内置面板注册表，键对应 ConsolePanelDecl.builtin。 */
+
+import type { ConsolePanel } from '../../shared/client-panel.ts';
+import { llmSettingsPanel } from './builtins/llm-settings/panel.ts';
+
+export type BuiltinPanels = Readonly<Record<string, ConsolePanel>>;
+
+export const BUILTIN_PANELS: BuiltinPanels = {
+  'llm-settings': llmSettingsPanel,
+};

package/src/web/client/console-pages/context.ts

@@ -0,0 +1,135 @@
+/**
+ * ConsolePanelContext 组装入口，为扩展提供调用、UI、流与资源管理。signal、interval、frame、own、guardLeave 及 UI 资源均绑定本次面板挂载的生命周期。
+ */
+
+import {
+  type ConsoleMemo,
+  type ConsolePanelContext,
+  type ConsoleStreamHandle,
+  type ConsoleStreamHandlers,
+  type Disposable,
+} from '../../shared/client-panel.ts';
+import { panelStreamRoute } from '../../shared/console-protocol.ts';
+import {
+  invokePanel,
+  invokePanelBinary,
+  pickPath as pickHostPath,
+  setConfig as writeConfig,
+} from '../core/api.ts';
+import { LANGUAGE } from '../core/language.ts';
+import { Lifecycle } from '../core/lifecycle.ts';
+import { openStream, type SocketLike } from '../core/stream.ts';
+import { createConsoleUi } from '../ui/index.ts';
+
+export interface PanelContextDeps {
+  pageId: string;
+  panelId: string;
+  root: HTMLElement;
+  /** 该面板的资源账本。host 建、host 在 unmount 时 dispose。 */
+  lifecycle: Lifecycle;
+  /** 浮层宿主。**不能是 `root`**——那个 unmount 时会被清空。 */
+  overlayHost: HTMLElement;
+  /** 重取 manifest 刷新 host 那部分（徽标 / 导航 / 三态）。 */
+  refresh(): Promise<void>;
+  /** 注册离开拦截，返回解除函数。由 router 提供。 */
+  addLeaveGuard(fn: () => string | null): Disposable;
+  /** 持久化后端。host 给一个按 `page:panel` 命名空间隔离过的实现。 */
+  memo: ConsoleMemo;
+  /** WS 构造。注入以便测试。 */
+  createSocket(url: string): SocketLike;
+  /** 绝对化 WS 地址（`/ws/...` → `ws://host/ws/...`）。 */
+  wsUrl(path: string): string;
+  onError(err: unknown): void;
+  doc?: Document;
+  /** 宿主面板挂载本面板时给的作用域；自己占一个页签时为空对象。 */
+  scope?: Readonly<Record<string, string>>;
+  /** 把本页声明到某插槽的面板挂进容器。host 提供实现。 */
+  mountSlot(
+    slot: string,
+    host: HTMLElement,
+    scope: Readonly<Record<string, string>>,
+  ): Promise<Disposable>;
+}
+
+/**
+ * memo 按 page:panel 隔离，命名空间由 context 加入，避免不同面板的同名键互相覆盖。
+ */
+export function namespacedMemo(
+  backing: ConsoleMemo,
+  pageId: string,
+  panelId: string,
+): ConsoleMemo {
+  const prefix = `${pageId}${panelId}`;
+  return {
+    get: (key, fallback) => backing.get(prefix + key, fallback),
+    set: (key, value) => backing.set(prefix + key, value),
+  };
+}
+
+export function createPanelContext(deps: PanelContextDeps): ConsolePanelContext {
+  const { pageId, panelId, lifecycle } = deps;
+  const signal = lifecycle.signal;
+
+  const ui = createConsoleUi({
+    memo: deps.memo,
+    overlayHost: deps.overlayHost,
+    signal,
+    ...(deps.doc ? { doc: deps.doc } : {}),
+  });
+
+  return {
+    pageId,
+    panelId,
+    language: LANGUAGE,
+    root: deps.root,
+    signal,
+
+    invoke: <T>(method: string, args?: unknown[]): Promise<T> =>
+      invokePanel<T>(pageId, panelId, method, args, { signal }),
+
+    invokeBinary: (method: string, args?: unknown[]): Promise<Blob> =>
+      invokePanelBinary(pageId, panelId, method, args, { signal }),
+
+    notifyOnUnmount(method: string, args?: unknown[]): void {
+      signal.addEventListener('abort', () => {
+        void invokePanel(pageId, panelId, method, args, { keepalive: true }).catch(deps.onError);
+      }, { once: true });
+    },
+
+    scope: deps.scope ?? {},
+
+    mountSlot: (slot, host, scope) => deps.mountSlot(slot, host, scope ?? {}),
+
+    pickPath: (options) => pickHostPath(options, { signal }),
+
+    setConfig: (groupId, values) => writeConfig(groupId, values, { signal }),
+
+    stream(handlers: ConsoleStreamHandlers): ConsoleStreamHandle {
+      const handle = openStream({
+        url: deps.wsUrl(panelStreamRoute(pageId, panelId)),
+        handlers,
+        signal,
+        createSocket: deps.createSocket,
+        setTimer: (fn, ms) => setTimeout(fn, ms) as unknown as number,
+        clearTimer: (id) => clearTimeout(id),
+        onError: deps.onError,
+      });
+      // openStream 自己听 signal 收场;再登记一次是为了让"提前 dispose"也走同一条路。
+      lifecycle.own(handle);
+      return handle;
+    },
+
+    interval: (fn, ms) => lifecycle.interval(fn, ms),
+    timeout: (fn, ms) => lifecycle.timeout(fn, ms),
+    frame: (fn) => lifecycle.frame(fn),
+    own: (d) => lifecycle.own(d),
+
+    memo: deps.memo,
+
+    guardLeave: (fn) => lifecycle.own(deps.addLeaveGuard(fn)),
+
+    ui,
+
+    refresh: () => deps.refresh(),
+  };
+}