@njuptlzf/agent-chat-server 0.2.1 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (55) hide show
  1. package/dist/branding-ui.d.ts +16 -0
  2. package/dist/branding-ui.js +119 -0
  3. package/dist/checkpoint-store.d.ts +78 -0
  4. package/dist/checkpoint-store.js +52 -0
  5. package/dist/components.d.ts +15 -0
  6. package/dist/components.js +50 -0
  7. package/dist/extension-admission.d.ts +32 -0
  8. package/dist/extension-admission.js +155 -0
  9. package/dist/flows.d.ts +49 -0
  10. package/dist/flows.js +208 -0
  11. package/dist/ledger.d.ts +90 -0
  12. package/dist/ledger.js +115 -0
  13. package/dist/main.js +14 -2
  14. package/dist/manifest.js +27 -1
  15. package/dist/orchestrator/engine.d.ts +132 -0
  16. package/dist/orchestrator/engine.js +1 -0
  17. package/dist/orchestrator/engines/fake.d.ts +14 -0
  18. package/dist/orchestrator/engines/fake.js +282 -0
  19. package/dist/orchestrator/engines/taskflow.d.ts +4 -0
  20. package/dist/orchestrator/engines/taskflow.js +541 -0
  21. package/dist/orchestrator/run-spec.d.ts +154 -0
  22. package/dist/orchestrator/run-spec.js +11 -0
  23. package/dist/persona-config.js +12 -0
  24. package/dist/server.d.ts +27 -2
  25. package/dist/server.js +595 -187
  26. package/dist/session.js +2 -1
  27. package/dist/sqlite-stores.d.ts +46 -6
  28. package/dist/sqlite-stores.js +292 -33
  29. package/dist/stores.d.ts +0 -36
  30. package/dist/stores.js +0 -27
  31. package/dist/suggestions.d.ts +60 -0
  32. package/dist/suggestions.js +107 -0
  33. package/dist/testing.d.ts +5 -4
  34. package/dist/testing.js +5 -4
  35. package/package.json +65 -64
  36. package/scripts/agentchat-integrate.mjs +852 -852
  37. package/src/branding-ui.ts +126 -0
  38. package/src/checkpoint-store.ts +122 -0
  39. package/src/components.ts +66 -0
  40. package/src/extension-admission.ts +131 -0
  41. package/src/flows.ts +244 -0
  42. package/src/ledger.ts +171 -0
  43. package/src/main.ts +16 -2
  44. package/src/manifest.ts +27 -1
  45. package/src/orchestrator/engine.ts +134 -0
  46. package/src/orchestrator/engines/fake.ts +330 -0
  47. package/src/orchestrator/engines/taskflow.ts +626 -0
  48. package/src/orchestrator/run-spec.ts +171 -0
  49. package/src/persona-config.ts +12 -1
  50. package/src/server.ts +611 -183
  51. package/src/session.ts +2 -1
  52. package/src/sqlite-stores.ts +343 -35
  53. package/src/stores.ts +0 -41
  54. package/src/suggestions.ts +146 -0
  55. package/src/testing.ts +4 -4
package/dist/server.js CHANGED
@@ -6,6 +6,7 @@ import { createEventMapper, createRunAccounting } from "./events.js";
6
6
  import { agentFor, personaIdsOf } from "./manifest.js";
7
7
  import { appendVersion, effectivePersonaVersion, PROMPT_MAX_CHARS, savePersonaConfig, validatePersona, versionEntry, versionsOf } from "./persona-config.js";
8
8
  import { runPersonaTrial, TRIAL_MAX_INPUT_CHARS } from "./persona-trial.js";
9
+ import { runSuggestions, clipMessages, SUGGESTIONS_DEFAULTS } from "./suggestions.js";
9
10
  import { MODEL_SWITCH } from "./audit.js";
10
11
  import { FAILOVER_NOTICE, candidateKey, isRetryableModelError, orderChain, processCooldown, rawModelError } from "./model-failover.js";
11
12
  import { resolveChain, resolveRunTier, saveModelConfig } from "./model-config.js";
@@ -13,6 +14,9 @@ import { MCP_SPEC_ALLOWLIST_ENV, checkMcpDecl, mergedToolLabels, probeMcpProxy,
13
14
  import { baseUrlFromModelsJson, deleteProvider, keyEnvOf, modelToProbe, patchProvider, patchRouting, patchTiers, refreshProvider, testProvider, toModelsResponse } from "./models-api.js";
14
15
  import { buildCommands, compileSystemPrompt, createProductSession, disposeProductSession, expandCommand, exportHistory, loadProductSkills, narrowMcpExposure } from "./session.js";
15
16
  import { auditPageWindow, toHistoryMessages, truncateLastTurn } from "./stores.js";
17
+ import { createTaskflowEngine } from "./orchestrator/engines/taskflow.js";
18
+ import { persistCheckpoints, resumeFrom as loadResumeFrom } from "./checkpoint-store.js";
19
+ import { toRunSpec } from "./flows.js";
16
20
  const MAX_BODY_BYTES = 64 * 1024;
17
21
  /** 封号闸白名单:品牌壳与申诉入口在被封状态下仍要可用。 */
18
22
  const BAN_EXEMPT = new Set(["/api/branding", "/api/whoami"]);
@@ -899,6 +903,8 @@ async function handleAdminPersonas(deps, req, res, url, acting) {
899
903
  problems: cfg.problems,
900
904
  // 默认助手的 id:页面用它在列表里显示「默认助手」并区分展示字段的落点。
901
905
  defaultPersona: product.defaultPersona,
906
+ // 下一步建议的全局模式(只读):全局 off 是硬地板,页面据此禁用人格级下拉。
907
+ globalFollowUpMode: product.manifest.branding.ui?.followUp?.mode ?? "llm",
902
908
  personas: ids.map((id) => {
903
909
  const override = cfg.personas[id];
904
910
  // 生效文案(含运行时覆盖)——列表徽标与名称要用"用户看到的",不是 manifest 原文。
@@ -1374,6 +1380,27 @@ export function createChatServer(deps) {
1374
1380
  // 记下这一轮用的是第几版人格配置(0 = manifest)。与 persona 同一时刻
1375
1381
  // 定死——用户投诉「昨天不是这么说的」时,要查的是**当时生效的那一版**,不是现在这版。
1376
1382
  const personaVersion = deps.personaConfig ? effectivePersonaVersion(deps.personaConfig.get(), persona) : undefined;
1383
+ // 多 phase 入口(W4):`flow` 指向 manifest 声明的 `agent.flows.<id>`。
1384
+ // 不传 = 单 phase 老路径(档 1 字节流不变)。传了但 id 不存在 = 400(fail-closed,
1385
+ // 不让一个拼错的流程名静默退化成单助手回答——用户会以为流程跑过了)。
1386
+ if (body.flow !== undefined && (typeof body.flow !== "string" || !/^[a-z][a-z0-9_-]*$/.test(body.flow))) {
1387
+ return sendError(res, 400, "bad_request", "`flow` has an invalid format");
1388
+ }
1389
+ const flow = body.flow;
1390
+ if (flow !== undefined && !product.manifest.agent.flows?.[flow]) {
1391
+ return sendError(res, 400, "bad_request", `unknown flow "${flow}"`);
1392
+ }
1393
+ // resume 归属:`runId` 形如 `<sessionId>:<timestamp>`,前缀必须是**本会话**,
1394
+ // 否则等于用一个猜来的 id 把别人的产物塞进自己的回答(跨会话注入)。
1395
+ // 只在 flow 请求上有意义——单 phase 没有 phase checkpoint 可恢复。
1396
+ if (body.resumeRunId !== undefined) {
1397
+ if (flow === undefined) {
1398
+ return sendError(res, 400, "bad_request", "`resumeRunId` requires `flow`");
1399
+ }
1400
+ if (typeof body.resumeRunId !== "string" || !body.resumeRunId.startsWith(`${sessionId}:`)) {
1401
+ return sendError(res, 400, "bad_request", "`resumeRunId` does not belong to this session");
1402
+ }
1403
+ }
1377
1404
  // A leading "/" is UI semantics: expand it here so the command name (and the
1378
1405
  // skill's file path) never reaches the model. Checked before quota/billing so
1379
1406
  // a typo costs nothing and never opens a run. The surface is the scope's: an
@@ -1382,6 +1409,39 @@ export function createChatServer(deps) {
1382
1409
  const expanded = expandCommand(body.message, surface.commands, surface.skills);
1383
1410
  if ("error" in expanded)
1384
1411
  return sendError(res, 400, "bad_request", expanded.error);
1412
+ // prompt 文本在**建 RunSpec 之前**就要定下来:RunSpec 的 `JobSpec.task` 会被
1413
+ // 引擎的 validate 检查「agent phase 必须有 task」,算晚了就恒被拒(见下方注释)。
1414
+ // 附件/上下文的编织是纯函数,提前算不改变任何行为。
1415
+ const promptText = withContext(withAttachments(expanded.message, att.attachments), body.context);
1416
+ // ---- RunSpec 提前构造(W4)----
1417
+ // 提前到 reserve / writeHead 之前,是为了让 flow 的非法声明与无断点 resume
1418
+ // 能以 **400** 拒绝(开了 SSE 流就改不了状态码了)。档 1(无 flow)的形状
1419
+ // 与接入编排层之前逐字相同——这是 I8 字节流基线的另一半保证。
1420
+ const startedAt = new Date();
1421
+ const runId = `${sessionId}:${startedAt.getTime()}`;
1422
+ const engine = deps.engine ?? createTaskflowEngine({ cwd: deps.dataDir });
1423
+ const translated = flow === undefined
1424
+ ? { runId, phases: [{ id: "chat", kind: "agent", job: { persona, task: promptText }, final: true }] }
1425
+ : toRunSpec(product, flow, promptText, runId);
1426
+ // flow 声明的 phase 形状非法 ⇒ 400 fail-closed,而不是回退成单助手回答让用户误以为跑过。
1427
+ // (启动期 validateFlows 已拦过绝大多数;这里是第二道闸,也覆盖运行时注入。)
1428
+ if ("error" in translated)
1429
+ return sendError(res, 400, "bad_request", translated.error);
1430
+ let runSpec = translated;
1431
+ if (flow !== undefined && body.resumeRunId !== undefined) {
1432
+ if (!deps.checkpoints) {
1433
+ return sendError(res, 400, "bad_request", "resume is unavailable (no checkpoint store configured)");
1434
+ }
1435
+ const cp = await loadResumeFrom(deps.checkpoints, body.resumeRunId);
1436
+ if (!cp)
1437
+ return sendError(res, 400, "bad_request", "`resumeRunId` has no checkpoints to resume from");
1438
+ runSpec = { ...translated, resumeFrom: cp };
1439
+ }
1440
+ if (flow !== undefined) {
1441
+ const report = engine.validate(runSpec);
1442
+ if (!report.ok)
1443
+ return sendError(res, 400, "bad_request", `invalid flow: ${report.errors.join("; ")}`);
1444
+ }
1385
1445
  // 角色决定当日上限与池。authz 未装配 = 全员
1386
1446
  // user、caps 不传(现状);池只在会员在期时 lazy 发满当月。
1387
1447
  const limits = product.manifest.agent.limits ?? {};
@@ -1393,22 +1453,30 @@ export function createChatServer(deps) {
1393
1453
  const memberActive = memberUntil !== null && Date.parse(memberUntil) > Date.now();
1394
1454
  const personaMember = !!deps.authz && (roles.includes("admin") || memberActive);
1395
1455
  const poolCfg = deps.memberPool && memberActive ? (limitsForPersona(limits, persona).memberMonthlyTokenPool ?? 0) : 0;
1396
- const decision = await deps.quota.check(userId, deps.authz ? capsForPersona(limits, persona, personaMember) : undefined, persona);
1397
- if (!decision.ok)
1398
- return sendError(res, 429, "quota_exceeded", decision.reason);
1456
+ const caps = deps.authz ? capsForPersona(limits, persona, personaMember) : undefined;
1457
+ // 预留(I4):占位成功才允许调模型。operationId 一请求一个,是幂等键(I6)。
1458
+ const operationId = randomUUID();
1459
+ const reserved = await deps.ledger.reserve({ userId, persona, caps, operationId });
1460
+ if (!reserved.ok)
1461
+ return sendError(res, 429, "quota_exceeded", reserved.reason);
1399
1462
  // Billing gate: starting costs money, so a depleted (or never topped-up) balance stops here —
1400
1463
  // 但池内免余额:只要当月池还有剩,余额见底也能开跑,池尽才提示充值。
1464
+ // 以下三条早退都在**占位之后**,所以必须先归还占位——否则用户被 402/409 拒一次,
1465
+ // 额度要被白占一小时(预留 TTL)。
1401
1466
  if (billingActive && poolCfg <= 0 && (await deps.billing.balance(userId)) <= 0) {
1467
+ await deps.ledger.release(operationId);
1402
1468
  return sendError(res, 402, "payment_required", "余额不足,请先充值");
1403
1469
  }
1404
1470
  if (billingActive && poolCfg > 0) {
1405
1471
  const row = await deps.memberPool.getOrGrant(userId, persona, monthNow(), poolCfg);
1406
1472
  if (Math.max(0, row.granted - row.used) <= 0 && (await deps.billing.balance(userId)) <= 0) {
1473
+ await deps.ledger.release(operationId);
1407
1474
  return sendError(res, 402, "payment_required", "本月发放池已用尽且余额不足,请先充值");
1408
1475
  }
1409
1476
  }
1410
1477
  const runKey = `${userId}\u0000${sessionId}`;
1411
1478
  if (running.has(runKey)) {
1479
+ await deps.ledger.release(operationId);
1412
1480
  return sendError(res, 409, "bad_request", "this session already has a run in progress");
1413
1481
  }
1414
1482
  running.add(runKey);
@@ -1434,7 +1502,6 @@ export function createChatServer(deps) {
1434
1502
  let aborted = false;
1435
1503
  let limitSent = false;
1436
1504
  let runError;
1437
- const startedAt = new Date();
1438
1505
  const confirms = new Map();
1439
1506
  pendingRuns.set(runKey, confirms);
1440
1507
  const uiPrompts = new Map();
@@ -1449,203 +1516,439 @@ export function createChatServer(deps) {
1449
1516
  console.error("[audit] run.start failed (fail-open):", err);
1450
1517
  }
1451
1518
  }
1452
- try {
1453
- send({ type: "ready", v: PROTOCOL_VERSION, sessionId, product: product.manifest.id });
1454
- // 工具中文名随首帧一次性下发(用户视角不显示 mcp__ 声明名)。
1455
- send({ type: "tools_meta", labels: mergedToolLabels(deps.mcpConfig?.get(), product.manifest.agent.toolLabels) });
1456
- const history = await deps.history.load(userId, scope, sessionId);
1457
- // persona 与 createFeedback 一起注入:产品据此决定造哪些工具,工具本身碰不到 store。
1458
- // 工单正文由服务端截断、补 ref、按 roles 定优先级——模型只能递内容,改不了归属。
1459
- const feedbackSink = deps.feedback;
1460
- const tools = deps.toolFactory({
1461
- productId: product.manifest.id,
1462
- productDir: product.dir,
1463
- userId,
1464
- dataDir: deps.dataDir,
1465
- qual: scope,
1466
- persona,
1467
- ...(feedbackSink
1468
- ? {
1469
- createFeedback: async (content) => {
1470
- const row = await feedbackSink.submit({
1471
- userId,
1472
- kind: "other",
1473
- content,
1474
- sessionId,
1475
- ref: `${persona}:${sessionId}`,
1476
- priority: roles.includes("member") || roles.includes("admin") ? "high" : "normal",
1477
- });
1478
- return { id: row.id ?? 0 };
1479
- },
1480
- }
1481
- : {}),
1482
- });
1483
- // ---- 失败切换(设计稿):run 开始定一条有序候选链,模型调用失败换下一条。
1484
- // 链来自 model-config 的档位绑定;没配置就是 manifest 的单模型(链长 1 ⇒ 永不切换)。
1485
- const modelCfg = deps.modelConfig?.get();
1486
- const cooldown = deps.modelCooldown ?? processCooldown;
1487
- const chain = orderChain(resolveChain(product, body.tier, modelCfg), cooldown);
1488
- const failoverOn = modelCfg?.routing.failover ?? true;
1489
- const cooldownSeconds = modelCfg?.routing.cooldownSeconds ?? 120;
1490
- const promptText = withContext(withAttachments(expanded.message, att.attachments), body.context);
1491
- const promptImages = parsed.images.length > 0 ? { images: parsed.images } : undefined;
1492
- const buildSession = (candidate) => createProductSession({
1493
- product,
1494
- modelRuntime: deps.modelRuntime,
1495
- tools,
1496
- userId,
1497
- personaConfig: deps.personaConfig,
1498
- dataDir: deps.dataDir,
1499
- // 档位语义(label/thinking/multiplier)仍来自 manifest,只有物理模型跟着候选走。
1500
- tier: candidate.provider === tier.provider && candidate.model === tier.model
1501
- ? tier
1502
- : { ...tier, provider: candidate.provider, model: candidate.model },
1503
- qual: scope,
1504
- persona,
1505
- history,
1506
- mcpConfig: deps.mcpConfig,
1507
- requestConfirm: (info) => new Promise((resolve) => {
1508
- const settle = (allow) => {
1509
- clearTimeout(timer);
1510
- confirms.delete(info.toolCallId);
1511
- resolve(allow);
1512
- };
1513
- const timer = setTimeout(() => settle(false), CONFIRM_TIMEOUT_MS);
1514
- confirms.set(info.toolCallId, settle);
1515
- send({ type: "tool_confirm", toolCallId: info.toolCallId, name: info.name, args: info.args });
1516
- }),
1517
- // Extension dialogs (batch 3-4b): same pause-and-answer shape as the
1518
- // confirm gate, but answered through POST /api/ui-response. Nobody
1519
- // answering means the fail-closed default, never a hung run.
1520
- requestUI: (info, signal) => new Promise((resolve) => {
1521
- const settle = (answer) => {
1522
- clearTimeout(timer);
1523
- signal?.removeEventListener("abort", onAbort);
1524
- uiPrompts.delete(info.id);
1525
- resolve(answer);
1526
- };
1527
- const onAbort = () => settle({ cancelled: true });
1528
- const timeoutMs = info.timeoutMs
1529
- ? Math.min(Math.max(info.timeoutMs, UI_TIMEOUT_MIN_MS), UI_TIMEOUT_MAX_MS)
1530
- : UI_TIMEOUT_MS;
1531
- const timer = setTimeout(() => settle({ cancelled: true }), timeoutMs);
1532
- signal?.addEventListener("abort", onAbort, { once: true });
1533
- uiPrompts.set(info.id, settle);
1534
- send({
1535
- type: "ui_prompt",
1536
- id: info.id,
1537
- kind: info.kind,
1538
- title: info.title,
1539
- ...(info.message !== undefined ? { message: info.message } : {}),
1540
- ...(info.options !== undefined ? { options: info.options } : {}),
1541
- ...(info.placeholder !== undefined ? { placeholder: info.placeholder } : {}),
1542
- });
1543
- }),
1544
- onUINotify: (message, level) => send({ type: "ui_notify", message, level }),
1545
- });
1546
- // Client went away: stop spending tokens(读的是当前那一次尝试的会话)。
1547
- res.on("close", () => {
1548
- if (!res.writableEnded)
1549
- void session?.abort();
1550
- });
1551
- for (let attempt = 0;; attempt++) {
1552
- const candidate = chain[attempt];
1553
- session = await buildSession(candidate);
1554
- // 一次尝试内只有「还没吐字、还没跑工具」才允许换候选:重发会把已经流出去的
1555
- // 半句话再发一遍,或把已经发生的工具副作用再执行一遍。这条边界是 v1 的口径。
1556
- let pendingFailover;
1557
- let attemptText = false;
1558
- const toolRoundsAtStart = accounting.toolRounds();
1559
- session.subscribe((event) => {
1560
- const outs = mapper.map(event);
1561
- // 同一批里出现 model_error 且这次还能切:**整批吞掉**——包括那条空的
1562
- // message_end,否则前端会先落一个空气泡再被真正的回答顶下去。
1563
- const errOut = outs.find((o) => o.type === "error" && o.code === "model_error");
1564
- if (errOut && errOut.type === "error") {
1565
- // 判定用 pi 原始报错(rawModelError),不是折叠后的用户文案——文案里
1566
- // 已经没有 JSON/网络词,拿它匹配会让 failover 失明(2026-11-04)。
1567
- const canSwitch = failoverOn && attempt < chain.length - 1 && !attemptText && accounting.toolRounds() === toolRoundsAtStart;
1568
- if (canSwitch && isRetryableModelError(rawModelError(event))) {
1569
- // 用户不该看到一次注定会被掩盖的失败(也不显示模型名)。
1570
- pendingFailover = { message: rawModelError(event) };
1571
- void session?.abort();
1572
- return;
1519
+ // 单 phase 通路:把原来这一整段 try 体原样搬进 runSingleJob(缩进变了、语义没变)。
1520
+ // 为什么搬而不重写:里面的 pendingFailover 吞批、toolRoundsAtStart 判定、
1521
+ // limitSent 后 abort 都是逐次修出来的,重写必回退旧 bug。
1522
+ // runSingleJob 不发任何编排事件,SSE 字节流与接入编排层之前完全一致(I8)。
1523
+ let lastText = "";
1524
+ /** runSingleJob 是否已跑过——引擎抛错时据此判断要不要 fail-open 补跑一次。 */
1525
+ let started = false;
1526
+ const runSingleJob = async () => {
1527
+ started = true;
1528
+ try {
1529
+ send({ type: "ready", v: PROTOCOL_VERSION, sessionId, product: product.manifest.id });
1530
+ // 工具中文名随首帧一次性下发(用户视角不显示 mcp__ 声明名)。
1531
+ send({ type: "tools_meta", labels: mergedToolLabels(deps.mcpConfig?.get(), product.manifest.agent.toolLabels) });
1532
+ const history = await deps.history.load(userId, scope, sessionId);
1533
+ // persona 与 createFeedback 一起注入:产品据此决定造哪些工具,工具本身碰不到 store。
1534
+ // 工单正文由服务端截断、补 ref、按 roles 定优先级——模型只能递内容,改不了归属。
1535
+ const feedbackSink = deps.feedback;
1536
+ const tools = deps.toolFactory({
1537
+ productId: product.manifest.id,
1538
+ productDir: product.dir,
1539
+ userId,
1540
+ dataDir: deps.dataDir,
1541
+ qual: scope,
1542
+ persona,
1543
+ ...(feedbackSink
1544
+ ? {
1545
+ createFeedback: async (content) => {
1546
+ const row = await feedbackSink.submit({
1547
+ userId,
1548
+ kind: "other",
1549
+ content,
1550
+ sessionId,
1551
+ ref: `${persona}:${sessionId}`,
1552
+ priority: roles.includes("member") || roles.includes("admin") ? "high" : "normal",
1553
+ });
1554
+ return { id: row.id ?? 0 };
1555
+ },
1573
1556
  }
1574
- }
1575
- for (const out of outs) {
1576
- if (out.type === "text_delta" || out.type === "thinking_delta")
1577
- attemptText = true;
1578
- if (out.type === "done") {
1579
- if (pendingFailover)
1580
- return; // abort 带出来的 done 不发——真正的收口在最后一次尝试
1581
- doneSent = true;
1582
- aborted = out.aborted;
1557
+ : {}),
1558
+ });
1559
+ // ---- 失败切换(设计稿):run 开始定一条有序候选链,模型调用失败换下一条。
1560
+ // 链来自 model-config 的档位绑定;没配置就是 manifest 的单模型(链长 1 ⇒ 永不切换)。
1561
+ const modelCfg = deps.modelConfig?.get();
1562
+ const cooldown = deps.modelCooldown ?? processCooldown;
1563
+ const chain = orderChain(resolveChain(product, body.tier, modelCfg), cooldown);
1564
+ const failoverOn = modelCfg?.routing.failover ?? true;
1565
+ const cooldownSeconds = modelCfg?.routing.cooldownSeconds ?? 120;
1566
+ const promptImages = parsed.images.length > 0 ? { images: parsed.images } : undefined;
1567
+ const buildSession = (candidate) => createProductSession({
1568
+ product,
1569
+ modelRuntime: deps.modelRuntime,
1570
+ tools,
1571
+ userId,
1572
+ personaConfig: deps.personaConfig,
1573
+ dataDir: deps.dataDir,
1574
+ // 档位语义(label/thinking/multiplier)仍来自 manifest,只有物理模型跟着候选走。
1575
+ tier: candidate.provider === tier.provider && candidate.model === tier.model
1576
+ ? tier
1577
+ : { ...tier, provider: candidate.provider, model: candidate.model },
1578
+ qual: scope,
1579
+ persona,
1580
+ history,
1581
+ mcpConfig: deps.mcpConfig,
1582
+ requestConfirm: (info) => new Promise((resolve) => {
1583
+ const settle = (allow) => {
1584
+ clearTimeout(timer);
1585
+ confirms.delete(info.toolCallId);
1586
+ resolve(allow);
1587
+ };
1588
+ const timer = setTimeout(() => settle(false), CONFIRM_TIMEOUT_MS);
1589
+ confirms.set(info.toolCallId, settle);
1590
+ send({ type: "tool_confirm", toolCallId: info.toolCallId, name: info.name, args: info.args });
1591
+ }),
1592
+ // Extension dialogs (batch 3-4b): same pause-and-answer shape as the
1593
+ // confirm gate, but answered through POST /api/ui-response. Nobody
1594
+ // answering means the fail-closed default, never a hung run.
1595
+ requestUI: (info, signal) => new Promise((resolve) => {
1596
+ const settle = (answer) => {
1597
+ clearTimeout(timer);
1598
+ signal?.removeEventListener("abort", onAbort);
1599
+ uiPrompts.delete(info.id);
1600
+ resolve(answer);
1601
+ };
1602
+ const onAbort = () => settle({ cancelled: true });
1603
+ const timeoutMs = info.timeoutMs
1604
+ ? Math.min(Math.max(info.timeoutMs, UI_TIMEOUT_MIN_MS), UI_TIMEOUT_MAX_MS)
1605
+ : UI_TIMEOUT_MS;
1606
+ const timer = setTimeout(() => settle({ cancelled: true }), timeoutMs);
1607
+ signal?.addEventListener("abort", onAbort, { once: true });
1608
+ uiPrompts.set(info.id, settle);
1609
+ send({
1610
+ type: "ui_prompt",
1611
+ id: info.id,
1612
+ kind: info.kind,
1613
+ title: info.title,
1614
+ ...(info.message !== undefined ? { message: info.message } : {}),
1615
+ ...(info.options !== undefined ? { options: info.options } : {}),
1616
+ ...(info.placeholder !== undefined ? { placeholder: info.placeholder } : {}),
1617
+ });
1618
+ }),
1619
+ onUINotify: (message, level) => send({ type: "ui_notify", message, level }),
1620
+ });
1621
+ // Client went away: stop spending tokens(读的是当前那一次尝试的会话)。
1622
+ res.on("close", () => {
1623
+ if (!res.writableEnded)
1624
+ void session?.abort();
1625
+ });
1626
+ for (let attempt = 0;; attempt++) {
1627
+ const candidate = chain[attempt];
1628
+ session = await buildSession(candidate);
1629
+ // 一次尝试内只有「还没吐字、还没跑工具」才允许换候选:重发会把已经流出去的
1630
+ // 半句话再发一遍,或把已经发生的工具副作用再执行一遍。这条边界是 v1 的口径。
1631
+ let pendingFailover;
1632
+ let attemptText = false;
1633
+ const toolRoundsAtStart = accounting.toolRounds();
1634
+ session.subscribe((event) => {
1635
+ const outs = mapper.map(event);
1636
+ // 同一批里出现 model_error 且这次还能切:**整批吞掉**——包括那条空的
1637
+ // message_end,否则前端会先落一个空气泡再被真正的回答顶下去。
1638
+ const errOut = outs.find((o) => o.type === "error" && o.code === "model_error");
1639
+ if (errOut && errOut.type === "error") {
1640
+ // 判定用 pi 原始报错(rawModelError),不是折叠后的用户文案——文案里
1641
+ // 已经没有 JSON/网络词,拿它匹配会让 failover 失明(2026-11-04)。
1642
+ const canSwitch = failoverOn && attempt < chain.length - 1 && !attemptText && accounting.toolRounds() === toolRoundsAtStart;
1643
+ if (canSwitch && isRetryableModelError(rawModelError(event))) {
1644
+ // 用户不该看到一次注定会被掩盖的失败(也不显示模型名)。
1645
+ pendingFailover = { message: rawModelError(event) };
1646
+ void session?.abort();
1647
+ return;
1648
+ }
1583
1649
  }
1584
- accounting.observe(out);
1585
- if (out.type === "tool_end")
1586
- toolCalls[out.name] = (toolCalls[out.name] ?? 0) + 1;
1587
- send(out);
1588
- if (accounting.limitHit() && !limitSent) {
1589
- // One prompt must not loop forever: stop it at the cap, with a reason.
1590
- limitSent = true;
1591
- send({
1592
- type: "error",
1593
- code: "limit_exceeded",
1594
- message: `已达到单次运行 ${limits.maxToolRounds} 轮工具调用上限,已中止`,
1595
- retryable: false,
1596
- });
1597
- void session?.abort();
1650
+ for (const out of outs) {
1651
+ if (out.type === "text_delta" || out.type === "thinking_delta")
1652
+ attemptText = true;
1653
+ // 引擎的 RunOutcome.output 要能反映这轮回答;取最后一条 message_end 的全文。
1654
+ if (out.type === "message_end")
1655
+ lastText = out.text;
1656
+ if (out.type === "done") {
1657
+ if (pendingFailover)
1658
+ return; // abort 带出来的 done 不发——真正的收口在最后一次尝试
1659
+ doneSent = true;
1660
+ aborted = out.aborted;
1661
+ }
1662
+ accounting.observe(out);
1663
+ if (out.type === "tool_end")
1664
+ toolCalls[out.name] = (toolCalls[out.name] ?? 0) + 1;
1665
+ send(out);
1666
+ if (accounting.limitHit() && !limitSent) {
1667
+ // One prompt must not loop forever: stop it at the cap, with a reason.
1668
+ limitSent = true;
1669
+ send({
1670
+ type: "error",
1671
+ code: "limit_exceeded",
1672
+ message: `已达到单次运行 ${limits.maxToolRounds} 轮工具调用上限,已中止`,
1673
+ retryable: false,
1674
+ });
1675
+ void session?.abort();
1676
+ }
1598
1677
  }
1678
+ });
1679
+ try {
1680
+ await session.prompt(promptText, promptImages);
1681
+ await session.waitForIdle();
1682
+ }
1683
+ catch (err) {
1684
+ // abort 引起的抛出是切换路径的一部分;没有待切换的错误就照旧冒泡。
1685
+ if (!pendingFailover)
1686
+ throw err;
1599
1687
  }
1600
- });
1601
- try {
1602
- await session.prompt(promptText, promptImages);
1603
- await session.waitForIdle();
1604
- }
1605
- catch (err) {
1606
- // abort 引起的抛出是切换路径的一部分;没有待切换的错误就照旧冒泡。
1607
1688
  if (!pendingFailover)
1608
- throw err;
1689
+ break;
1690
+ // 换下一条:打冷却、留痕、告知用户,然后**重建会话**重发同一个 prompt。
1691
+ // 不用 session.setModel 原地重发——会话里已经记了这次失败的用户消息,重发会让
1692
+ // 历史多一条一模一样的提问;重建用的是 run 开始时那份 history,干净。
1693
+ cooldown.mark(candidate, cooldownSeconds);
1694
+ send({ type: "ui_notify", message: FAILOVER_NOTICE, level: "warning" });
1695
+ if (deps.audit) {
1696
+ void deps.audit
1697
+ .append({
1698
+ actor: userId,
1699
+ result: "ok",
1700
+ action: MODEL_SWITCH,
1701
+ target: `session:${sessionId}`,
1702
+ meta: { from: candidateKey(candidate), to: candidateKey(chain[attempt + 1]), reason: pendingFailover.message.slice(0, 200) },
1703
+ })
1704
+ .catch((err) => console.error("[audit] model.switch failed (fail-open):", err));
1705
+ }
1706
+ disposeProductSession(session);
1707
+ session = undefined;
1609
1708
  }
1610
- if (!pendingFailover)
1709
+ }
1710
+ catch (err) {
1711
+ runError = err instanceof Error ? err.message : String(err);
1712
+ console.error("[chat] run failed:", err);
1713
+ send({
1714
+ type: "error",
1715
+ code: "internal",
1716
+ message: "服务暂时不可用,请稍后重试",
1717
+ retryable: true,
1718
+ });
1719
+ }
1720
+ return {
1721
+ output: lastText,
1722
+ ok: runError === undefined,
1723
+ usage: mapper.totalUsage(),
1724
+ stopReason: runError === undefined ? "end_turn" : "error",
1725
+ ...(runError !== undefined ? { error: runError } : {}),
1726
+ };
1727
+ };
1728
+ // 一次 Run = 一个 agent phase。引擎只负责「校验 + 调 runJob + 汇总 usage」,
1729
+ // 真正的会话逻辑全在 runSingleJob 里,所以档 1 的行为与接入前逐字节一致。
1730
+ //
1731
+ // `JobSpec.task` 必须是真实的 prompt:它是 `RunSpec` 里唯一描述「这个 phase
1732
+ // 要干什么」的字段,引擎的静态校验会拒空 task。曾经这里是 `promptForEngine`
1733
+ // 变量、在 runSingleJob 内部才赋值,于是构造 runSpec 时它恒为空串 ⇒ validate
1734
+ // 恒拒 ⇒ 每次都静默 fail-open 回直连,**编排层在 W1/W2/W3 期间一次都没真正执行过**。
1735
+ // 由 `wire-baseline.test.ts` 的快照基线抓出来(它同时钉住档 1 的字节流)。
1736
+ const runAbort = new AbortController();
1737
+ const isFlow = flow !== undefined;
1738
+ /** 多 phase 的成员会话各自独立;档 1 恒为空(单 phase 仍用上面的 `session`)。 */
1739
+ const memberSessions = [];
1740
+ /** 入口 phase(无 dependsOn)才继承会话历史,其余成员从空上下文起跑。 */
1741
+ const entryPhaseIds = new Set(runSpec.phases.filter((p) => (p.dependsOn ?? []).length === 0).map((p) => p.id));
1742
+ /** 引擎收口产物;档 1 不用它,多 phase 的 usage/run_done 都从这里出。 */
1743
+ let runOutcome;
1744
+ /**
1745
+ * 多 phase 的一个成员 worker(W4)。与 `runSingleJob` 刻意分开写:
1746
+ * 那一路的每一帧都被 `wire-baseline.test.ts` 逐字节钉住,塞分支进来必回退。
1747
+ *
1748
+ * 成员路径的四条纪律:
1749
+ * ① 每个 job 一个独立 `createProductSession`(persona/task 来自 JobSpec);
1750
+ * ② 文本只走 `ctx.onDelta`(→ `member_delta`),**不发** text_delta / thinking_delta——
1751
+ * 多 phase 的用户视图是成员卡片,不是一根合并的气泡;
1752
+ * ③ 工具/确认/UI 事件一律不转发主线程(成员是后台 worker,不该弹确认卡);
1753
+ * ④ usage 只记在**局部** mapper 上,由引擎汇总,不碰主 `mapper`/`accounting`。
1754
+ */
1755
+ const runMemberJob = async (job, ctx) => {
1756
+ const memberMapper = createEventMapper();
1757
+ let memberText = "";
1758
+ let memberError;
1759
+ try {
1760
+ const history = entryPhaseIds.has(ctx.phaseId) ? ((await deps.history.load(userId, scope, sessionId)) ?? []) : [];
1761
+ const feedbackSink = deps.feedback;
1762
+ const tools = deps.toolFactory({
1763
+ productId: product.manifest.id,
1764
+ productDir: product.dir,
1765
+ userId,
1766
+ dataDir: deps.dataDir,
1767
+ qual: scope,
1768
+ persona: job.persona,
1769
+ ...(feedbackSink
1770
+ ? {
1771
+ createFeedback: async (content) => {
1772
+ const row = await feedbackSink.submit({
1773
+ userId,
1774
+ kind: "other",
1775
+ content,
1776
+ sessionId,
1777
+ ref: `${job.persona}:${sessionId}`,
1778
+ priority: roles.includes("member") || roles.includes("admin") ? "high" : "normal",
1779
+ });
1780
+ return { id: row.id ?? 0 };
1781
+ },
1782
+ }
1783
+ : {}),
1784
+ });
1785
+ const ms = await createProductSession({
1786
+ product,
1787
+ modelRuntime: deps.modelRuntime,
1788
+ tools,
1789
+ userId,
1790
+ personaConfig: deps.personaConfig,
1791
+ dataDir: deps.dataDir,
1792
+ tier,
1793
+ qual: scope,
1794
+ persona: job.persona,
1795
+ history,
1796
+ mcpConfig: deps.mcpConfig,
1797
+ // 成员是后台 worker:没人盯着确认卡,fail-closed 拒绝才是正确默认。
1798
+ requestConfirm: async () => false,
1799
+ });
1800
+ memberSessions.push(ms);
1801
+ const onAbort = () => void ms.abort();
1802
+ if (ctx.signal.aborted)
1803
+ onAbort();
1804
+ else
1805
+ ctx.signal.addEventListener("abort", onAbort, { once: true });
1806
+ ms.subscribe((event) => {
1807
+ for (const out of memberMapper.map(event)) {
1808
+ if (out.type === "text_delta" || out.type === "thinking_delta")
1809
+ ctx.onDelta?.(out.delta);
1810
+ if (out.type === "message_end")
1811
+ memberText = out.text;
1812
+ // tool_* / done / error:不转发,成员气泡只显示文本与状态。
1813
+ }
1814
+ });
1815
+ await ms.prompt(job.task, undefined);
1816
+ await ms.waitForIdle();
1817
+ ctx.signal.removeEventListener("abort", onAbort);
1818
+ }
1819
+ catch (err) {
1820
+ memberError = err instanceof Error ? err.message : String(err);
1821
+ console.error("[orchestrator] member job failed:", err);
1822
+ send({ type: "error", code: "internal", message: `成员 ${job.persona} 执行失败`, retryable: false });
1823
+ }
1824
+ const usage = memberMapper.totalUsage();
1825
+ return {
1826
+ output: memberText,
1827
+ ok: memberError === undefined,
1828
+ usage: {
1829
+ input: usage.input,
1830
+ output: usage.output,
1831
+ cacheRead: usage.cacheRead,
1832
+ cacheWrite: usage.cacheWrite,
1833
+ total: usage.total,
1834
+ costUsd: usage.costUsd,
1835
+ },
1836
+ stopReason: memberError === undefined ? "end_turn" : "error",
1837
+ ...(memberError !== undefined ? { error: memberError } : {}),
1838
+ };
1839
+ };
1840
+ /** EngineEvent(内部)→ ChatEvent(协议)+ runId。单 phase 时引擎不发事件,这个桥用不到。 */
1841
+ const bridgeEngineEvent = (ev) => {
1842
+ switch (ev.type) {
1843
+ case "member_started":
1844
+ send({ type: "member_started", runId, phaseId: ev.phaseId, memberId: ev.memberId, task: ev.task });
1845
+ if (deps.checkpoints) {
1846
+ void deps.checkpoints
1847
+ .saveJob(runId, {
1848
+ runId,
1849
+ phaseId: ev.phaseId,
1850
+ jobId: ev.jobId,
1851
+ state: "running",
1852
+ usage: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0, costUsd: 0 },
1853
+ leaseUntil: Date.now() + 5 * 60_000,
1854
+ })
1855
+ .catch((err) => console.error("[checkpoint] saveJob(running) failed:", err));
1856
+ }
1857
+ break;
1858
+ case "member_delta":
1859
+ send({ type: "member_delta", runId, phaseId: ev.phaseId, memberId: ev.memberId, delta: ev.delta });
1860
+ break;
1861
+ case "member_done": {
1862
+ const u = ev.usage;
1863
+ const usage = {
1864
+ input: u.input,
1865
+ output: u.output,
1866
+ cacheRead: u.cacheRead ?? 0,
1867
+ cacheWrite: u.cacheWrite ?? 0,
1868
+ total: u.total,
1869
+ costUsd: u.costUsd ?? 0,
1870
+ };
1871
+ send({ type: "member_done", runId, phaseId: ev.phaseId, memberId: ev.memberId, state: ev.state, usage });
1872
+ if (deps.checkpoints) {
1873
+ void deps.checkpoints
1874
+ .saveJob(runId, { runId, phaseId: ev.phaseId, jobId: ev.jobId, state: ev.state, usage })
1875
+ .catch((err) => console.error("[checkpoint] saveJob(done) failed:", err));
1876
+ }
1611
1877
  break;
1612
- // 换下一条:打冷却、留痕、告知用户,然后**重建会话**重发同一个 prompt。
1613
- // 不用 session.setModel 原地重发——会话里已经记了这次失败的用户消息,重发会让
1614
- // 历史多一条一模一样的提问;重建用的是 run 开始时那份 history,干净。
1615
- cooldown.mark(candidate, cooldownSeconds);
1616
- send({ type: "ui_notify", message: FAILOVER_NOTICE, level: "warning" });
1617
- if (deps.audit) {
1618
- void deps.audit
1619
- .append({
1620
- actor: userId,
1621
- result: "ok",
1622
- action: MODEL_SWITCH,
1623
- target: `session:${sessionId}`,
1624
- meta: { from: candidateKey(candidate), to: candidateKey(chain[attempt + 1]), reason: pendingFailover.message.slice(0, 200) },
1625
- })
1626
- .catch((err) => console.error("[audit] model.switch failed (fail-open):", err));
1627
1878
  }
1628
- disposeProductSession(session);
1629
- session = undefined;
1879
+ default:
1880
+ // phase_started / phase_settled:协议里没有对应事件,刻意不下发。
1881
+ break;
1882
+ }
1883
+ };
1884
+ // 客户端断开 → abort 所有成员会话(单 phase 的会话由 runSingleJob 内部的 close 监听处理)。
1885
+ if (isFlow) {
1886
+ res.on("close", () => {
1887
+ if (!res.writableEnded)
1888
+ for (const ms of memberSessions)
1889
+ void ms.abort();
1890
+ });
1891
+ }
1892
+ try {
1893
+ if (isFlow) {
1894
+ // 多 phase 也发 ready/tools_meta 作为传输头——前端的 sessionId 绑定与工具名
1895
+ // 都依赖它们;但成员事件从 member_started 开始,不给单 phase 气泡添帧。
1896
+ send({ type: "ready", v: PROTOCOL_VERSION, sessionId, product: product.manifest.id });
1897
+ send({ type: "tools_meta", labels: mergedToolLabels(deps.mcpConfig?.get(), product.manifest.agent.toolLabels) });
1898
+ const outcome = await engine.execute(runSpec, {
1899
+ runJob: runMemberJob,
1900
+ signal: runAbort.signal,
1901
+ emit: bridgeEngineEvent,
1902
+ ...(deps.checkpoints
1903
+ ? { persist: (o) => void persistCheckpoints(deps.checkpoints, o.runId, o.checkpoints).catch((err) => console.error("[checkpoint] persist failed:", err)) }
1904
+ : {}),
1905
+ });
1906
+ runOutcome = outcome;
1907
+ doneSent = true;
1908
+ aborted = outcome.state === "stopped";
1909
+ runError = outcome.error;
1910
+ lastText = outcome.output;
1911
+ send({
1912
+ type: "run_done",
1913
+ runId,
1914
+ state: outcome.state,
1915
+ usage: outcome.usage,
1916
+ output: outcome.output,
1917
+ durationMs: Date.now() - startedAt.getTime(),
1918
+ });
1919
+ }
1920
+ else {
1921
+ const report = engine.validate(runSpec);
1922
+ if (!report.ok) {
1923
+ // 单 phase 恒能通过;真不通过说明调用方给了非法组合。
1924
+ // **fail-open 回旧路径**:不能让客户端收到一个没有 ready 的空连接。
1925
+ console.error("[orchestrator] rejected run, falling back to direct path:", report.errors.join("; "));
1926
+ await runSingleJob();
1927
+ }
1928
+ else {
1929
+ await engine.execute(runSpec, { runJob: runSingleJob, signal: runAbort.signal });
1930
+ }
1630
1931
  }
1631
1932
  }
1632
1933
  catch (err) {
1633
- runError = err instanceof Error ? err.message : String(err);
1634
- console.error("[chat] run failed:", err);
1635
- send({
1636
- type: "error",
1637
- code: "internal",
1638
- message: "服务暂时不可用,请稍后重试",
1639
- retryable: true,
1640
- });
1934
+ // 编排层自身出错不得破坏已经流出去的响应:业务错误已由 runSingleJob 内部
1935
+ // 发成 error 事件,这里只留痕。
1936
+ console.error("[orchestrator] execute failed (fail-open):", err);
1937
+ if (!started && !isFlow)
1938
+ await runSingleJob();
1939
+ if (isFlow && !doneSent) {
1940
+ runError = err instanceof Error ? err.message : String(err);
1941
+ send({ type: "error", code: "internal", message: "流程执行失败", retryable: true });
1942
+ }
1641
1943
  }
1642
1944
  finally {
1643
1945
  clearInterval(heartbeat);
1644
- const usage = mapper.totalUsage();
1946
+ // 多 phase 的账走引擎汇总(含 resume 恢复的历史消耗,I3);档 1 仍走主 mapper。
1947
+ const usage = isFlow && runOutcome ? runOutcome.usage : mapper.totalUsage();
1645
1948
  const durationMs = Date.now() - startedAt.getTime();
1646
1949
  try {
1647
- if (usage.total > 0)
1648
- await deps.quota.record(userId, usage, persona);
1950
+ // 结算(I4):把占位换成实际消耗,多退少补。条件更新保证幂等(I6)。
1951
+ await deps.ledger.settle({ operationId, userId, persona, tokens: usage.total });
1649
1952
  // Charge after the fact: the run already spent the tokens; the balance gate stops the next one.
1650
1953
  if (billingActive) {
1651
1954
  // 池优先拆账(结算=发放检查点之二):结算时**重读**池——
@@ -1671,8 +1974,51 @@ export function createChatServer(deps) {
1671
1974
  }
1672
1975
  // persona 在这里首次落库(与 scope 同一行、同一时刻):没跑起来的会话不该有绑定。
1673
1976
  // persona_version 与它同一次写入、同样只绑一次。
1674
- if (session)
1977
+ //
1978
+ // 多 phase 的历史只落「用户原话 + Run 汇总输出」两条:成员的内部转录是后台
1979
+ // worker 的中间产物,混进用户历史会让下次续聊把整段分工都重放一遍。成员会话
1980
+ // 各自 dispose,不 exportHistory——它们的 token 已经记在 runOutcome.usage 里。
1981
+ if (isFlow) {
1982
+ if (runOutcome) {
1983
+ const now = new Date(startedAt.getTime()).toISOString();
1984
+ const entries = [
1985
+ {
1986
+ type: "message",
1987
+ id: `${runId}:user`,
1988
+ parentId: null,
1989
+ timestamp: now,
1990
+ message: { role: "user", content: promptText, timestamp: startedAt.getTime() },
1991
+ },
1992
+ {
1993
+ type: "message",
1994
+ id: `${runId}:answer`,
1995
+ parentId: `${runId}:user`,
1996
+ timestamp: now,
1997
+ message: {
1998
+ role: "assistant",
1999
+ content: [{ type: "text", text: runOutcome.output }],
2000
+ api: "openai-completions",
2001
+ provider: tier.provider,
2002
+ model: tier.model,
2003
+ usage: {
2004
+ input: usage.input,
2005
+ output: usage.output,
2006
+ cacheRead: usage.cacheRead,
2007
+ cacheWrite: usage.cacheWrite,
2008
+ totalTokens: usage.total,
2009
+ cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: usage.costUsd },
2010
+ },
2011
+ stopReason: "stop",
2012
+ timestamp: startedAt.getTime(),
2013
+ },
2014
+ },
2015
+ ];
2016
+ await deps.history.save(userId, scope, sessionId, entries, persona, personaVersion);
2017
+ }
2018
+ }
2019
+ else if (session) {
1675
2020
  await deps.history.save(userId, scope, sessionId, exportHistory(session), persona, personaVersion);
2021
+ }
1676
2022
  if (deps.runLog) {
1677
2023
  await deps.runLog.record({
1678
2024
  userId,
@@ -1726,6 +2072,8 @@ export function createChatServer(deps) {
1726
2072
  uiPrompts.clear();
1727
2073
  if (session)
1728
2074
  await disposeProductSession(session);
2075
+ for (const ms of memberSessions)
2076
+ await disposeProductSession(ms);
1729
2077
  running.delete(runKey);
1730
2078
  pendingRuns.delete(runKey);
1731
2079
  pendingUI.delete(runKey);
@@ -1803,6 +2151,17 @@ export function createChatServer(deps) {
1803
2151
  // 默认助手的人格 id(通用化):前端靠它把「老会话(persona 为 null)」
1804
2152
  // 认成默认助手那一批。只是一个 id,不带能力信息。
1805
2153
  defaultPersona: product.defaultPersona,
2154
+ // 多 phase 流程的**展示字段**(W4):前端据此渲染流程选择器。
2155
+ // 只出 id/label/description——phase/member/task 这些编制细节永不下发。
2156
+ ...(product.manifest.agent.flows
2157
+ ? {
2158
+ flows: Object.entries(product.manifest.agent.flows).map(([id, f]) => ({
2159
+ id,
2160
+ ...(f?.label ? { label: f.label } : {}),
2161
+ ...(f?.description ? { description: f.description } : {}),
2162
+ })),
2163
+ }
2164
+ : {}),
1806
2165
  };
1807
2166
  return sendJson(res, 200, body);
1808
2167
  }
@@ -1874,6 +2233,55 @@ export function createChatServer(deps) {
1874
2233
  }
1875
2234
  if (req.method === "POST" && url.pathname === "/api/chat")
1876
2235
  return await handleChat(req, res);
2236
+ if (req.method === "POST" && url.pathname === "/api/suggestions") {
2237
+ const auth = await deps.authenticate(req);
2238
+ if (!auth)
2239
+ return deny401(deps, req, res);
2240
+ let body;
2241
+ try {
2242
+ body = (await readJson(req));
2243
+ }
2244
+ catch {
2245
+ return sendError(res, 400, "bad_request", "body must be valid JSON under 64KB");
2246
+ }
2247
+ // 人格 id 合法性与 /api/chat 同一条规矩(400,不静默)。默认助手也显式带 id:
2248
+ // 这里没有会话绑定,服务端要按同一个 id 复核人格级覆盖。
2249
+ if (body.persona !== undefined &&
2250
+ (typeof body.persona !== "string" || !personaIdsOf(deps.product).has(body.persona))) {
2251
+ return sendError(res, 400, "bad_request", `unknown persona "${String(body.persona)}"`);
2252
+ }
2253
+ const personaId = (typeof body.persona === "string" ? body.persona : undefined) ?? deps.product.defaultPersona;
2254
+ const followUp = deps.product.manifest.branding.ui?.followUp;
2255
+ // 生效模式(前后端同一套优先级):全局 off 是硬地板——人格不能把全局关闭
2256
+ // 重新打开;否则人格 followUpMode > 全局 mode > 缺省 llm。
2257
+ const globalMode = followUp?.mode ?? "llm";
2258
+ if (globalMode === "off")
2259
+ return sendJson(res, 200, { suggestions: [] });
2260
+ const personaMode = effectiveUiOf(deps.product, deps.personaConfig?.get(), personaId)?.followUpMode;
2261
+ const mode = personaMode ?? globalMode;
2262
+ const count = followUp?.count ?? SUGGESTIONS_DEFAULTS.count;
2263
+ const staticFallback = Array.isArray(followUp?.static) ? followUp.static : [];
2264
+ if (mode === "off")
2265
+ return sendJson(res, 200, { suggestions: [] });
2266
+ if (mode === "static")
2267
+ return sendJson(res, 200, { suggestions: staticFallback.slice(0, count) });
2268
+ // llm:这是一轮问答的附属产物,任何失败(模型不可用/超时/输入非法)都静默
2269
+ // 回落 static——绝不 4xx/5xx 冒泡,也不接配额与计费。
2270
+ let suggestions = staticFallback.slice(0, count);
2271
+ try {
2272
+ suggestions = (await (deps.suggestions ?? runSuggestions)({ product: deps.product, modelRuntime: deps.modelRuntime }, {
2273
+ messages: clipMessages(body.messages, followUp?.maxMessages ?? SUGGESTIONS_DEFAULTS.maxMessages),
2274
+ count,
2275
+ staticFallback,
2276
+ ...(followUp?.systemPrompt !== undefined ? { systemPrompt: followUp.systemPrompt } : {}),
2277
+ timeoutMs: followUp?.timeoutMs ?? SUGGESTIONS_DEFAULTS.timeoutMs,
2278
+ })).slice(0, count);
2279
+ }
2280
+ catch {
2281
+ // 静默:回落内容已在初始值里。
2282
+ }
2283
+ return sendJson(res, 200, { suggestions });
2284
+ }
1877
2285
  if (req.method === "POST" && url.pathname === "/api/decision") {
1878
2286
  const auth = await deps.authenticate(req);
1879
2287
  if (!auth)
@@ -2242,7 +2650,7 @@ export function createChatServer(deps) {
2242
2650
  const memberActive = memberUntil !== null && Date.parse(memberUntil) > Date.now();
2243
2651
  const isMember = roles.includes("admin") || memberActive;
2244
2652
  // 配额展示看的是**这个人格**那本账(产品声明的 id)——core 不假定它叫什么。
2245
- const stats = (await deps.quota.todayStats?.(auth.userId, personaParam)) ?? { runsToday: 0, tokensToday: 0 };
2653
+ const stats = (await deps.ledger.todayStats(auth.userId, personaParam)) ?? { runsToday: 0, tokensToday: 0 };
2246
2654
  const caps = capsForPersona(limits, personaParam, isMember);
2247
2655
  // 池视图:whoami 本身就是「检查点」——会员打开订阅页即 lazy 发满当月池。
2248
2656
  let pool = null;