@sema-agent/server 7.80.1 → 7.80.2

package/dist/boot/runner-deps.d.ts

@@ -9,7 +9,7 @@
  * (`runnerTierFrozen` 判据就取自构造那一刻的 `config.tiers`)。
  * `getRunStore()` 是唯一的晚绑取值(runStore 在本段之后才构造),原文靠同作用域前向引用。
  */
-import { type RunnerDeps, type WorkflowRunStore, type AskOutcome } from "@sema-agent/core";
+import { type CacheBreakFinding, type RunnerDeps, type WorkflowRunStore, type AskOutcome } from "@sema-agent/core";
 import type { createBrain } from "../brain.js";
 import type { buildPricing, createTracer } from "../budget.js";
 import type { ServiceConfig } from "../config.js";
@@ -60,6 +60,22 @@ export declare function createRunnerDepsOnAsk(toolApproval: ToolApprovalCoordina
  *  `classificationKnown:false`(指标标签折 `unknown`),不吞不编;与安装包的锁步由 test/boot-runner-deps-shared-base.test.ts
  *  的 dist 扫描格钉住(core 加词/收进 d.ts 那天先红)。 */
 export declare const CONFIG_ADVISORY_CLASSIFICATIONS: ReadonlySet<string>;
+/** S-386:core 的 [ref] 前缀缓存**断裂**探测器交给宿主的根因**闭集**,以及每个词的日志级别。
+ *  闭集**不抄词**:词源直接取 core 公开导出的 `CacheBreakFinding["cause"]`(`@sema-agent/core` 根导出,
+ *  `dist/index.d.ts:128`;实现在 `dist/core/cache-break-detector.d.ts`),于是 core 加词/删词 ⇒
+ *  `Record<PromptCacheBreakCause, …>` 少键/多键 = **编译错**(CLAUDE.md [ref]「词表是闭集 + 穷举」)。
+ *  ⚠️ 首版在这里**手抄**了五个字面量,并在本注与 CHANGELOG 里声称「core 加词 = 编译错」—— 复审实测
+ *  证伪(给 core d.ts 加词后 tsc 照绿,只有一格正则扫描会红):抄来的联合与 core 无编译期联系。
+ *  运行期收到词表外的值(`ctx.classification` 在 core 的 onError 契约上只是 `string`)走最响的那一档
+ *  (error)并标 `classificationKnown:false`,退化方向永远是**多一条告警**。
+ *
+ *  🔴 定级判据是**事实**,不是 provider 名单:`dist/core/cache-break-detector.js` 的 `observe()` 里
+ *  `const before = prev.cacheRead; if (before <= 0) return undefined` —— 探测器只有在**上一轮真的从
+ *  前缀缓存读到过 token** 时才会给出 finding。所以「带 classification」这件事本身就证明了「这条路由
+ *  在服务前缀缓存」,前缀 bug 四词(model-switch / tool-schema / tool-set / system-prefix)落 error
+ *  是有据的;`server-or-ttl` 在 agentic 任务里是常态(慢工具 ⇒ 5min+ 间隔,provider 缓存到期)⇒ warn。 */
+export type PromptCacheBreakCause = CacheBreakFinding["cause"];
+export declare const PROMPT_CACHE_BREAK_CAUSE_LEVEL: Readonly<Record<PromptCacheBreakCause, "error" | "warn">>;
 export interface RunnerDepsCtx {
     config: ServiceConfig;
     logger: Logger;

package/dist/boot/runner-deps.js

@@ -24,6 +24,14 @@ export const CONFIG_ADVISORY_CLASSIFICATIONS = new Set([
     "shared-memory-not-mounted",
     "shell-gate-off",
 ]);
+export const PROMPT_CACHE_BREAK_CAUSE_LEVEL = {
+    "model-switch": "error",
+    "tool-schema": "error",
+    "tool-set": "error",
+    "system-prefix": "error",
+    "server-or-ttl": "warn",
+};
+const PROMPT_CACHE_BREAK_LEVELS = new Map(Object.entries(PROMPT_CACHE_BREAK_CAUSE_LEVEL));
 const CEILING_ORIGINS = new Set(["walltime", "turns"]);
 export function createEngineNoticeForwarder(logger, router = defaultEngineNoticeRouter, metrics) {
     return (notice) => {
@@ -224,9 +232,20 @@ export function createRunnerDeps(ctx) {
                 return;
             }
             if (ctx.phase === "prompt-cache") {
-                metrics.inc("prompt_cache_low_hit_total");
-                const fields = { sessionId: ctx.sessionId, ...(ctx.classification ? { classification: ctx.classification } : {}), err: String(err) };
-                if (ctx.classification === "server-or-ttl")
+                const classification = ctx.classification;
+                const causeLevel = classification === undefined ? undefined : PROMPT_CACHE_BREAK_LEVELS.get(classification);
+                const level = classification === undefined ? "warn" : (causeLevel ?? "error");
+                const fields = {
+                    sessionId: ctx.sessionId,
+                    confirmed: classification !== undefined,
+                    ...(classification !== undefined ? { classification, classificationKnown: causeLevel !== undefined } : {}),
+                    err: String(err),
+                };
+                metrics.inc("prompt_cache_low_hit_total", {
+                    ...(classification !== undefined ? { classification: causeLevel !== undefined ? classification : "unknown" } : {}),
+                    level,
+                });
+                if (level === "warn")
                     logger.warn("prompt_cache_break", fields);
                 else
                     logger.error("prompt_cache_break", fields);

package/dist/observability/metrics.js

@@ -206,7 +206,7 @@ export function createMetrics() {
     m.histogram("task_cache_hit_rate", "Prefix-cache hit rate per task (core-computed stats.cacheHitRate, 0..1)", [
         0.05, 0.1, 0.25, 0.5, 0.75, 0.9, 0.95, 1,
     ]);
-    m.counter("prompt_cache_low_hit_total", "Tasks the Runner flagged with a low prefix-cache hit rate");
+    m.counter("prompt_cache_low_hit_total", "Prefix-cache advisories the Runner handed the host, by {classification,level} (S-386: the design/31 break causes carry a classification; the task-end low-hit heuristic and the two cache-family wiring advisories carry none)");
     m.counter("model_cost_micro_usd_total", "Authoritative model spend (integer micro-USD) over all brain calls, by model");
     m.histogram("brain_first_token_ms", "Time to first content token per brain call (gateway-hang signal)", [
         50, 100, 250, 500, 1000, 2000, 5000, 10000, 30000,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema-agent/server",
-  "version": "7.80.1",
+  "version": "7.80.2",
   "description": "Sema Server — the server/API implementation layer for Sema, wiring core, registry, model providers, and cloud agent execution. Built on @sema-agent/core.",
   "type": "module",
   "license": "BUSL-1.1",