@juli-os/ledger 0.1.1 → 0.1.3

package/dist/index.d.ts

@@ -1,7 +1,8 @@
 export { createLedgerStore, type LifecycleStore } from './platform/ledger/store.ts';
 export type { Workflow, Step, WorkflowStatus, StepStatus, StepKind } from './contracts/entities.ts';
-export { createUsageStore, type UsageStore, type UsageStats } from './platform/ledger/usage.ts';
-export { priceUsage, findPrice, type UsageCost, type UsageRow } from './platform/ledger/pricing.ts';
-export { emptyCaseFile, parseCaseFile, serializeCaseFile, type CaseFileDoc, appendSection, appendExecution, appendDecision, appendReference, originalEmail, } from './platform/ledger/casefile.ts';
+export { TERMINAL_WORKFLOW_STATUSES, STEP_KINDS, AGENT_STEP_KINDS, INSTRUCTABLE_STEP_KINDS, type LedgerEvent, type Run, type Prompt, type TaskView, } from './contracts/entities.ts';
+export { createUsageStore, type UsageRecord, type UsageStats, type TimelinePoint, type UsageStore, } from './platform/ledger/usage.ts';
+export { findPrice, priceUsage, type TierWhen, type PriceTier, type ModelPrice, PRICING_SOURCE, PRICING_RETRIEVED_AT, BIGMODEL_PRICES, type UsageRow, type CostBreakdown, type ModelUsageCost, type UsageCost, } from './platform/ledger/pricing.ts';
+export { emptyCaseFile, parseCaseFile, serializeCaseFile, withOriginal, appendSection, appendExecution, appendDecision, appendReference, originalEmail, type CaseDecision, type ArtifactRef, type CaseFileDoc, } from './platform/ledger/casefile.ts';
 export { rfc3339, systemClock, randomIds, type Clock, type IdGen } from './platform/shared/clock.ts';
 export { asRecord, safeParse, type JsonRecord, type JsonValue } from './platform/shared/json.ts';

package/dist/index.js

@@ -29,7 +29,18 @@ var TERMINAL_WORKFLOW_STATUSES = [
   "cancelled",
   "rejected"
 ];
+var STEP_KINDS = [
+  "triage",
+  "gate",
+  "agent",
+  "verify",
+  "draft",
+  "send",
+  "llm",
+  "share"
+];
 var AGENT_STEP_KINDS = ["agent", "verify"];
+var INSTRUCTABLE_STEP_KINDS = ["agent", "verify", "llm", "draft"];
 
 // src/contracts/statuses.ts
 var WORKFLOW_STATUSES = [
@@ -103,6 +114,21 @@ var parseCaseFile = (raw, now) => {
   };
 };
 var serializeCaseFile = (cf) => JSON.stringify(cf);
+var withOriginal = (cf, o, now) => ({
+  ...cf,
+  original: {
+    from: o.from,
+    // Sender display name (RFC2047-decoded) — recorded into the case file with
+    // the original message after the 2026-10-01 Chen Lijun hallucination
+    // incident: the legitimate source for reply salutations, so the agent is no
+    // longer forced to invent a name from the address.
+    ...o.fromName !== void 0 && o.fromName !== "" ? { from_name: o.fromName } : {},
+    subject: o.subject,
+    body: o.body,
+    message_id: o.messageId
+  },
+  updatedAt: rfc3339(now)
+});
 var appendSection = (cf, section, value, now) => ({
   ...cf,
   ...section === "extract" ? { extract: value } : { draft: value },
@@ -573,9 +599,11 @@ var createLedgerStore = (dbPath, deps = {}) => {
       };
     },
     activeRunForSession: (session) => activeRunOf(session),
-    /** 活跃去重：同 dedup_key 且工作流仍在途 → 跳过重复建流。
-     * ⚠ ESCAPE '\' 必须与转义成对：message-id 几乎必含 `_`，漏写 ESCAPE 时
-     * `\_` 成了"字面反斜杠+任意字符"，模式永不匹配——去重整体失效（09-07 事故）。 */
+    /** Active dedup: same dedup_key and the workflow still in flight → skip
+     * creating a duplicate. ⚠ ESCAPE '\' must pair with the escaping: a
+     * message-id almost always contains `_`; without ESCAPE, `\_` becomes
+     * "literal backslash + any character", the pattern never matches — and
+     * dedup fails wholesale (09-07 incident). */
     hasActiveDedup(key) {
       const r = db.prepare(
         `SELECT 1 FROM workflows WHERE status IN (${sqlInList(DEDUP_WINDOW_STATUSES)})
@@ -583,8 +611,10 @@ var createLedgerStore = (dbPath, deps = {}) => {
       ).get(dedupPattern(key));
       return r !== void 0;
     },
-    /** 已摄取去重（轮询层）：同 dedup_key 存在任何非 rejected 工作流 → 这封
-     * 邮件已被处理过（含 failed），轮询不再重复拉取。重试走步骤 retry，不走再摄取。 */
+    /** Ingested dedup (polling layer): any non-rejected workflow with the same
+     * dedup_key → this email has already been handled (failed included);
+     * polling won't fetch it again. Retries go through step retry, not
+     * re-ingestion. */
     hasSeenDedup(key) {
       const r = db.prepare(
         `SELECT 1 FROM workflows WHERE status != 'rejected'
@@ -592,11 +622,14 @@ var createLedgerStore = (dbPath, deps = {}) => {
       ).get(dedupPattern(key));
       return r !== void 0;
     },
-    /** 自回环守卫查询（2026-09-20 断点十三）：message_id 是否命中本引擎已
-     * 发送记录——completed send 步的 output.message_id（email_sent 事件同源
-     * 落账）。进件层据此丢弃投递副本回灌（引擎给轮询邮箱自己发信的 echo）。
-     * LIKE 预筛 + 精确比对：JSON 编码取实际存储字节，%/_/\ 照 dedupPattern
-     * 成对转义（message-id 几乎必含 `_`）。 */
+    /** Self-loop guard query (2026-09-20 breakpoint 13): does the message_id
+     * hit a record this engine already sent — the output.message_id of a
+     * completed send step (booked from the same source as email_sent events)?
+     * The intake layer uses this to discard delivery-copy feedback (the echo
+     * of the engine mailing the polling mailbox itself). LIKE prefilter +
+     * exact comparison: JSON-encode to the actually stored bytes; %/_/\ are
+     * escaped in pairs like dedupPattern (a message-id almost always contains
+     * `_`). */
     recordSentMessageId(messageId, meta) {
       if (messageId === "") return;
       db.prepare(
@@ -708,59 +741,61 @@ var PRICING_SOURCE = "https://docs.bigmodel.cn/cn/guide/start/pricing";
 var PRICING_RETRIEVED_AT = "2026-10-06";
 var K32 = 32e3;
 var K200 = 200;
-var flat = (input, cache, output, note = "\u7EDF\u4E00\u4EF7") => ({ when: {}, input, cache, output, note });
+var flat = (input, cache, output, note = "flat rate") => ({ when: {}, input, cache, output, note });
 var BIGMODEL_PRICES = [
+  // ---- Flagship ----
   { id: "glm-5.3", label: "GLM-5.3", tiers: [flat(8, 2, 28)] },
   { id: "glm-5.3-flash", label: "GLM-5.3-Flash", tiers: [flat(0.8, 0.23, 2.8)] },
   { id: "glm-5.3-flashx", label: "GLM-5.3-FlashX", tiers: [flat(2, 0.57, 7)] },
+  // ---- Text ----
   { id: "glm-5.2", label: "GLM-5.2", tiers: [flat(8, 2, 28)] },
   {
     id: "glm-5.1",
     label: "GLM-5.1",
     tiers: [
-      { when: { inputLt: K32 }, input: 6, cache: 1.3, output: 24, note: "\u5165<32K" },
-      { when: { inputGte: K32 }, input: 8, cache: 2, output: 28, note: "\u5165\u226532K" }
+      { when: { inputLt: K32 }, input: 6, cache: 1.3, output: 24, note: "in<32K" },
+      { when: { inputGte: K32 }, input: 8, cache: 2, output: 28, note: "in>=32K" }
     ]
   },
   {
     id: "glm-5-turbo",
     label: "GLM-5-Turbo",
     tiers: [
-      { when: { inputLt: K32 }, input: 5, cache: 1.2, output: 22, note: "\u5165<32K" },
-      { when: { inputGte: K32 }, input: 7, cache: 1.8, output: 26, note: "\u5165\u226532K" }
+      { when: { inputLt: K32 }, input: 5, cache: 1.2, output: 22, note: "in<32K" },
+      { when: { inputGte: K32 }, input: 7, cache: 1.8, output: 26, note: "in>=32K" }
     ]
   },
   {
     id: "glm-5",
     label: "GLM-5",
     tiers: [
-      { when: { inputLt: K32 }, input: 4, cache: 1, output: 18, note: "\u5165<32K" },
-      { when: { inputGte: K32 }, input: 6, cache: 1.5, output: 22, note: "\u5165\u226532K" }
+      { when: { inputLt: K32 }, input: 4, cache: 1, output: 18, note: "in<32K" },
+      { when: { inputGte: K32 }, input: 6, cache: 1.5, output: 22, note: "in>=32K" }
     ]
   },
   {
     id: "glm-4.7",
     label: "GLM-4.7",
     tiers: [
-      { when: { inputLt: K32, outputLt: K200 }, input: 2, cache: 0.4, output: 8, note: "\u5165<32K\xB7\u51FA<0.2K" },
-      { when: { inputLt: K32, outputGte: K200 }, input: 3, cache: 0.6, output: 14, note: "\u5165<32K\xB7\u51FA\u22650.2K" },
-      { when: { inputGte: K32 }, input: 4, cache: 0.8, output: 16, note: "\u516532K\u2013200K" }
+      { when: { inputLt: K32, outputLt: K200 }, input: 2, cache: 0.4, output: 8, note: "in<32K\xB7out<0.2K" },
+      { when: { inputLt: K32, outputGte: K200 }, input: 3, cache: 0.6, output: 14, note: "in<32K\xB7out>=0.2K" },
+      { when: { inputGte: K32 }, input: 4, cache: 0.8, output: 16, note: "in 32K\u2013200K" }
     ]
   },
   {
     id: "glm-4.5-air",
     label: "GLM-4.5-Air",
     tiers: [
-      { when: { inputLt: K32, outputLt: K200 }, input: 0.8, cache: 0.16, output: 2, note: "\u5165<32K\xB7\u51FA<0.2K" },
-      { when: { inputLt: K32, outputGte: K200 }, input: 0.8, cache: 0.16, output: 6, note: "\u5165<32K\xB7\u51FA\u22650.2K" },
-      { when: { inputGte: K32 }, input: 1.2, cache: 0.24, output: 8, note: "\u516532K\u2013128K" }
+      { when: { inputLt: K32, outputLt: K200 }, input: 0.8, cache: 0.16, output: 2, note: "in<32K\xB7out<0.2K" },
+      { when: { inputLt: K32, outputGte: K200 }, input: 0.8, cache: 0.16, output: 6, note: "in<32K\xB7out>=0.2K" },
+      { when: { inputGte: K32 }, input: 1.2, cache: 0.24, output: 8, note: "in 32K\u2013128K" }
     ]
   },
   { id: "glm-4.7-flashx", label: "GLM-4.7-FlashX", tiers: [flat(0.5, 0.1, 3)] },
-  { id: "glm-4.7-flash", label: "GLM-4.7-Flash\uFF08\u514D\u8D39\uFF09", tiers: [flat(0, 0, 0, "\u514D\u8D39")] },
+  { id: "glm-4.7-flash", label: "GLM-4.7-Flash (free)", tiers: [flat(0, 0, 0, "free")] },
   { id: "glm-4-plus", label: "GLM-4-Plus", tiers: [flat(5, 2.5, 5)] },
   { id: "glm-4-air-250414", label: "GLM-4-Air-250414", tiers: [flat(0.5, 0.25, 0.5)] },
-  { id: "glm-4-air", label: "GLM-4-Air\uFF08\u540C 250414 \u7248\u4EF7\uFF09", tiers: [flat(0.5, 0.25, 0.5)] },
+  { id: "glm-4-air", label: "GLM-4-Air (same price as 250414)", tiers: [flat(0.5, 0.25, 0.5)] },
   { id: "glm-4-airx", label: "GLM-4-AirX", tiers: [flat(10, null, 10)] },
   { id: "glm-4-long", label: "GLM-4-Long", tiers: [flat(1, 0.5, 1)] },
   { id: "glm-4-assistant", label: "GLM-4-Assistant", tiers: [flat(5, null, 5)] },
@@ -768,53 +803,55 @@ var BIGMODEL_PRICES = [
   { id: "glm-z1-airx", label: "GLM-Z1-AirX", tiers: [flat(5, null, 5)] },
   { id: "glm-z1-flashx", label: "GLM-Z1-FlashX", tiers: [flat(0.1, null, 0.1)] },
   { id: "glm-4-flashx-250414", label: "GLM-4-FlashX-250414", tiers: [flat(0.1, 0.05, 0.1)] },
-  { id: "glm-4-flashx", label: "GLM-4-FlashX\uFF08\u540C 250414 \u7248\u4EF7\uFF09", tiers: [flat(0.1, 0.05, 0.1)] },
-  { id: "glm-4-flash-250414", label: "GLM-4-Flash-250414\uFF08\u514D\u8D39\uFF09", tiers: [flat(0, null, 0, "\u514D\u8D39\xB7\u7F13\u5B58\u4E0D\u652F\u6301")] },
-  { id: "glm-4-flash", label: "GLM-4-Flash\uFF08\u514D\u8D39\uFF09", tiers: [flat(0, null, 0, "\u514D\u8D39\xB7\u7F13\u5B58\u4E0D\u652F\u6301")] },
-  { id: "glm-z1-flash", label: "GLM-Z1-Flash\uFF08\u514D\u8D39\uFF09", tiers: [flat(0, null, 0, "\u514D\u8D39\xB7\u7F13\u5B58\u4E0D\u652F\u6301")] },
+  { id: "glm-4-flashx", label: "GLM-4-FlashX (same price as 250414)", tiers: [flat(0.1, 0.05, 0.1)] },
+  { id: "glm-4-flash-250414", label: "GLM-4-Flash-250414 (free)", tiers: [flat(0, null, 0, "free \xB7 cache unsupported")] },
+  { id: "glm-4-flash", label: "GLM-4-Flash (free)", tiers: [flat(0, null, 0, "free \xB7 cache unsupported")] },
+  { id: "glm-z1-flash", label: "GLM-Z1-Flash (free)", tiers: [flat(0, null, 0, "free \xB7 cache unsupported")] },
+  // ---- Vision ----
   { id: "glm-ocr", label: "GLM-OCR", tiers: [flat(0.2, null, 0.2)] },
   {
     id: "glm-5v-turbo",
     label: "GLM-5V-Turbo",
     tiers: [
-      { when: { inputLt: K32 }, input: 5, cache: 1.2, output: 22, note: "\u5165<32K" },
-      { when: { inputGte: K32 }, input: 7, cache: 1.8, output: 26, note: "\u5165\u226532K" }
+      { when: { inputLt: K32 }, input: 5, cache: 1.2, output: 22, note: "in<32K" },
+      { when: { inputGte: K32 }, input: 7, cache: 1.8, output: 26, note: "in>=32K" }
     ]
   },
   {
     id: "glm-4.6v",
     label: "GLM-4.6V",
     tiers: [
-      { when: { inputLt: K32 }, input: 1, cache: 0.2, output: 3, note: "\u5165<32K" },
-      { when: { inputGte: K32 }, input: 2, cache: 0.4, output: 6, note: "\u516532K\u2013128K\uFF08\u8D85\u4E0A\u754C\u5E76\u5165\u9AD8\u6863\uFF09" }
+      { when: { inputLt: K32 }, input: 1, cache: 0.2, output: 3, note: "in<32K" },
+      { when: { inputGte: K32 }, input: 2, cache: 0.4, output: 6, note: "in 32K\u2013128K (above the upper bound folds into the top tier)" }
     ]
   },
   {
     id: "glm-4.6v-flashx",
     label: "GLM-4.6V-FlashX",
     tiers: [
-      { when: { inputLt: K32 }, input: 0.15, cache: 0.03, output: 1.5, note: "\u5165<32K" },
-      { when: { inputGte: K32 }, input: 0.3, cache: 0.03, output: 3, note: "\u516532K\u2013128K\uFF08\u8D85\u4E0A\u754C\u5E76\u5165\u9AD8\u6863\uFF09" }
+      { when: { inputLt: K32 }, input: 0.15, cache: 0.03, output: 1.5, note: "in<32K" },
+      { when: { inputGte: K32 }, input: 0.3, cache: 0.03, output: 3, note: "in 32K\u2013128K (above the upper bound folds into the top tier)" }
     ]
   },
-  { id: "glm-4.6v-flash", label: "GLM-4.6V-Flash\uFF08\u514D\u8D39\uFF09", tiers: [flat(0, 0, 0, "\u514D\u8D39")] },
+  { id: "glm-4.6v-flash", label: "GLM-4.6V-Flash (free)", tiers: [flat(0, 0, 0, "free")] },
   {
     id: "glm-4.5v",
     label: "GLM-4.5V",
     tiers: [
-      { when: { inputLt: K32 }, input: 2, cache: 0.4, output: 6, note: "\u5165<32K" },
-      { when: { inputGte: K32 }, input: 4, cache: 0.8, output: 12, note: "\u516532K\u201364K\uFF08\u8D85\u4E0A\u754C\u5E76\u5165\u9AD8\u6863\uFF09" }
+      { when: { inputLt: K32 }, input: 2, cache: 0.4, output: 6, note: "in<32K" },
+      { when: { inputGte: K32 }, input: 4, cache: 0.8, output: 12, note: "in 32K\u201364K (above the upper bound folds into the top tier)" }
     ]
   },
   { id: "glm-4v-plus-0111", label: "GLM-4V-Plus-0111", tiers: [flat(4, 2, 4)] },
-  { id: "glm-4v-plus", label: "GLM-4V-Plus\uFF08\u540C 0111 \u7248\u4EF7\uFF09", tiers: [flat(4, 2, 4)] },
-  { id: "glm-4v-flash", label: "GLM-4V-Flash\uFF08\u514D\u8D39\uFF09", tiers: [flat(0, null, 0, "\u514D\u8D39\xB7\u7F13\u5B58\u4E0D\u652F\u6301")] },
+  { id: "glm-4v-plus", label: "GLM-4V-Plus (same price as 0111)", tiers: [flat(4, 2, 4)] },
+  { id: "glm-4v-flash", label: "GLM-4V-Flash (free)", tiers: [flat(0, null, 0, "free \xB7 cache unsupported")] },
   { id: "glm-4.1v-thinking-flashx", label: "GLM-4.1V-Thinking-FlashX", tiers: [flat(2, null, 2)] },
-  { id: "glm-4.1v-thinking-flash", label: "GLM-4.1V-Thinking-Flash\uFF08\u514D\u8D39\uFF09", tiers: [flat(0, null, 0, "\u514D\u8D39\xB7\u7F13\u5B58\u4E0D\u652F\u6301")] },
-  { id: "embedding-3", label: "Embedding-3", tiers: [flat(0.5, null, 0.5, "\u5355\u503C\u4EF7\u76EE\xB7input \u8BA1")] },
-  { id: "embedding-2", label: "Embedding-2", tiers: [flat(0.5, null, 0.5, "\u5355\u503C\u4EF7\u76EE\xB7input \u8BA1")] },
-  { id: "rerank", label: "Rerank", tiers: [flat(0.8, null, 0.8, "\u5355\u503C\u4EF7\u76EE")] },
-  { id: "codegeex-4", label: "CodeGeeX-4", tiers: [flat(0.1, null, 0.1, "\u5355\u503C\u4EF7\u76EE")] }
+  { id: "glm-4.1v-thinking-flash", label: "GLM-4.1V-Thinking-Flash (free)", tiers: [flat(0, null, 0, "free \xB7 cache unsupported")] },
+  // ---- Embeddings / other (single-value prices are input-based; output billed at the same rate as a floor) ----
+  { id: "embedding-3", label: "Embedding-3", tiers: [flat(0.5, null, 0.5, "single-value \xB7 billed on input")] },
+  { id: "embedding-2", label: "Embedding-2", tiers: [flat(0.5, null, 0.5, "single-value \xB7 billed on input")] },
+  { id: "rerank", label: "Rerank", tiers: [flat(0.8, null, 0.8, "single-value")] },
+  { id: "codegeex-4", label: "CodeGeeX-4", tiers: [flat(0.1, null, 0.1, "single-value")] }
 ];
 var findPrice = (model) => {
   const m = model.trim().toLowerCase();
@@ -843,7 +880,7 @@ var priceUsage = (rows) => {
   const accs = /* @__PURE__ */ new Map();
   for (const r of rows) {
     if (r.inputTokens === 0 && r.outputTokens === 0) continue;
-    const key = r.model === "" ? "\uFF08\u672A\u8BB0\u5F55\u6A21\u578B\uFF09" : r.model;
+    const key = r.model === "" ? "(no model recorded)" : r.model;
     let a = accs.get(key);
     if (a === void 0) {
       const p = findPrice(key);
@@ -919,9 +956,10 @@ CREATE TABLE IF NOT EXISTS prompt_usage (
   note TEXT NOT NULL DEFAULT '',
   model TEXT NOT NULL DEFAULT '',
   input_tokens INTEGER NOT NULL DEFAULT 0,
-  -- cached_tokens\uFF1Az.ai \u53E3\u5F84\u7F13\u5B58\u547D\u4E2D\uFF08input \u5B50\u96C6\uFF0Cwf_66a9b632154d\uFF09
-  --\uFF08\u5341\u4E09\u8DD1 R1 \u987A\u624B\u4FEE\uFF1A\u539F JS \u98CE\u683C // \u6CE8\u91CA\u5199\u5728 SQL \u4E32\u5185\uFF0CSQLite \u4E0D\u8BA4\uFF0C
-  -- db.exec(MIGRATIONS) \u76F4\u63A5\u629B near "/": syntax error\uFF0C\u5168\u4ED3 store \u7EA7\u6D4B\u8BD5\u5C3D\u7EA2\uFF09
+  -- cached_tokens: z.ai-convention cache hits (subset of input, wf_66a9b632154d)
+  -- (fixed in passing during run-13 R1: the original JS-style // comments inside
+  -- the SQL string are not valid SQLite; db.exec(MIGRATIONS) threw near "/":
+  -- syntax error and every store-level test in the repo went red)
   cached_tokens INTEGER NOT NULL DEFAULT 0,
   output_tokens INTEGER NOT NULL DEFAULT 0,
   duration_ms INTEGER NOT NULL DEFAULT 0,
@@ -1228,6 +1266,13 @@ var parseAssistantLine = (line) => {
   }
 };
 export {
+  AGENT_STEP_KINDS,
+  BIGMODEL_PRICES,
+  INSTRUCTABLE_STEP_KINDS,
+  PRICING_RETRIEVED_AT,
+  PRICING_SOURCE,
+  STEP_KINDS,
+  TERMINAL_WORKFLOW_STATUSES,
   appendDecision,
   appendExecution,
   appendReference,
@@ -1244,5 +1289,6 @@ export {
   rfc3339,
   safeParse,
   serializeCaseFile,
-  systemClock
+  systemClock,
+  withOriginal
 };

package/dist/juli-ledger.js

@@ -553,9 +553,11 @@ var createLedgerStore = (dbPath, deps = {}) => {
       };
     },
     activeRunForSession: (session) => activeRunOf(session),
-    /** 活跃去重：同 dedup_key 且工作流仍在途 → 跳过重复建流。
-     * ⚠ ESCAPE '\' 必须与转义成对：message-id 几乎必含 `_`，漏写 ESCAPE 时
-     * `\_` 成了"字面反斜杠+任意字符"，模式永不匹配——去重整体失效（09-07 事故）。 */
+    /** Active dedup: same dedup_key and the workflow still in flight → skip
+     * creating a duplicate. ⚠ ESCAPE '\' must pair with the escaping: a
+     * message-id almost always contains `_`; without ESCAPE, `\_` becomes
+     * "literal backslash + any character", the pattern never matches — and
+     * dedup fails wholesale (09-07 incident). */
     hasActiveDedup(key) {
       const r = db.prepare(
         `SELECT 1 FROM workflows WHERE status IN (${sqlInList(DEDUP_WINDOW_STATUSES)})
@@ -563,8 +565,10 @@ var createLedgerStore = (dbPath, deps = {}) => {
       ).get(dedupPattern(key));
       return r !== void 0;
     },
-    /** 已摄取去重（轮询层）：同 dedup_key 存在任何非 rejected 工作流 → 这封
-     * 邮件已被处理过（含 failed），轮询不再重复拉取。重试走步骤 retry，不走再摄取。 */
+    /** Ingested dedup (polling layer): any non-rejected workflow with the same
+     * dedup_key → this email has already been handled (failed included);
+     * polling won't fetch it again. Retries go through step retry, not
+     * re-ingestion. */
     hasSeenDedup(key) {
       const r = db.prepare(
         `SELECT 1 FROM workflows WHERE status != 'rejected'
@@ -572,11 +576,14 @@ var createLedgerStore = (dbPath, deps = {}) => {
       ).get(dedupPattern(key));
       return r !== void 0;
     },
-    /** 自回环守卫查询（2026-09-20 断点十三）：message_id 是否命中本引擎已
-     * 发送记录——completed send 步的 output.message_id（email_sent 事件同源
-     * 落账）。进件层据此丢弃投递副本回灌（引擎给轮询邮箱自己发信的 echo）。
-     * LIKE 预筛 + 精确比对：JSON 编码取实际存储字节，%/_/\ 照 dedupPattern
-     * 成对转义（message-id 几乎必含 `_`）。 */
+    /** Self-loop guard query (2026-09-20 breakpoint 13): does the message_id
+     * hit a record this engine already sent — the output.message_id of a
+     * completed send step (booked from the same source as email_sent events)?
+     * The intake layer uses this to discard delivery-copy feedback (the echo
+     * of the engine mailing the polling mailbox itself). LIKE prefilter +
+     * exact comparison: JSON-encode to the actually stored bytes; %/_/\ are
+     * escaped in pairs like dedupPattern (a message-id almost always contains
+     * `_`). */
     recordSentMessageId(messageId, meta) {
       if (messageId === "") return;
       db.prepare(
@@ -688,59 +695,61 @@ var PRICING_SOURCE = "https://docs.bigmodel.cn/cn/guide/start/pricing";
 var PRICING_RETRIEVED_AT = "2026-10-06";
 var K32 = 32e3;
 var K200 = 200;
-var flat = (input, cache, output, note = "\u7EDF\u4E00\u4EF7") => ({ when: {}, input, cache, output, note });
+var flat = (input, cache, output, note = "flat rate") => ({ when: {}, input, cache, output, note });
 var BIGMODEL_PRICES = [
+  // ---- Flagship ----
   { id: "glm-5.3", label: "GLM-5.3", tiers: [flat(8, 2, 28)] },
   { id: "glm-5.3-flash", label: "GLM-5.3-Flash", tiers: [flat(0.8, 0.23, 2.8)] },
   { id: "glm-5.3-flashx", label: "GLM-5.3-FlashX", tiers: [flat(2, 0.57, 7)] },
+  // ---- Text ----
   { id: "glm-5.2", label: "GLM-5.2", tiers: [flat(8, 2, 28)] },
   {
     id: "glm-5.1",
     label: "GLM-5.1",
     tiers: [
-      { when: { inputLt: K32 }, input: 6, cache: 1.3, output: 24, note: "\u5165<32K" },
-      { when: { inputGte: K32 }, input: 8, cache: 2, output: 28, note: "\u5165\u226532K" }
+      { when: { inputLt: K32 }, input: 6, cache: 1.3, output: 24, note: "in<32K" },
+      { when: { inputGte: K32 }, input: 8, cache: 2, output: 28, note: "in>=32K" }
     ]
   },
   {
     id: "glm-5-turbo",
     label: "GLM-5-Turbo",
     tiers: [
-      { when: { inputLt: K32 }, input: 5, cache: 1.2, output: 22, note: "\u5165<32K" },
-      { when: { inputGte: K32 }, input: 7, cache: 1.8, output: 26, note: "\u5165\u226532K" }
+      { when: { inputLt: K32 }, input: 5, cache: 1.2, output: 22, note: "in<32K" },
+      { when: { inputGte: K32 }, input: 7, cache: 1.8, output: 26, note: "in>=32K" }
     ]
   },
   {
     id: "glm-5",
     label: "GLM-5",
     tiers: [
-      { when: { inputLt: K32 }, input: 4, cache: 1, output: 18, note: "\u5165<32K" },
-      { when: { inputGte: K32 }, input: 6, cache: 1.5, output: 22, note: "\u5165\u226532K" }
+      { when: { inputLt: K32 }, input: 4, cache: 1, output: 18, note: "in<32K" },
+      { when: { inputGte: K32 }, input: 6, cache: 1.5, output: 22, note: "in>=32K" }
     ]
   },
   {
     id: "glm-4.7",
     label: "GLM-4.7",
     tiers: [
-      { when: { inputLt: K32, outputLt: K200 }, input: 2, cache: 0.4, output: 8, note: "\u5165<32K\xB7\u51FA<0.2K" },
-      { when: { inputLt: K32, outputGte: K200 }, input: 3, cache: 0.6, output: 14, note: "\u5165<32K\xB7\u51FA\u22650.2K" },
-      { when: { inputGte: K32 }, input: 4, cache: 0.8, output: 16, note: "\u516532K\u2013200K" }
+      { when: { inputLt: K32, outputLt: K200 }, input: 2, cache: 0.4, output: 8, note: "in<32K\xB7out<0.2K" },
+      { when: { inputLt: K32, outputGte: K200 }, input: 3, cache: 0.6, output: 14, note: "in<32K\xB7out>=0.2K" },
+      { when: { inputGte: K32 }, input: 4, cache: 0.8, output: 16, note: "in 32K\u2013200K" }
     ]
   },
   {
     id: "glm-4.5-air",
     label: "GLM-4.5-Air",
     tiers: [
-      { when: { inputLt: K32, outputLt: K200 }, input: 0.8, cache: 0.16, output: 2, note: "\u5165<32K\xB7\u51FA<0.2K" },
-      { when: { inputLt: K32, outputGte: K200 }, input: 0.8, cache: 0.16, output: 6, note: "\u5165<32K\xB7\u51FA\u22650.2K" },
-      { when: { inputGte: K32 }, input: 1.2, cache: 0.24, output: 8, note: "\u516532K\u2013128K" }
+      { when: { inputLt: K32, outputLt: K200 }, input: 0.8, cache: 0.16, output: 2, note: "in<32K\xB7out<0.2K" },
+      { when: { inputLt: K32, outputGte: K200 }, input: 0.8, cache: 0.16, output: 6, note: "in<32K\xB7out>=0.2K" },
+      { when: { inputGte: K32 }, input: 1.2, cache: 0.24, output: 8, note: "in 32K\u2013128K" }
     ]
   },
   { id: "glm-4.7-flashx", label: "GLM-4.7-FlashX", tiers: [flat(0.5, 0.1, 3)] },
-  { id: "glm-4.7-flash", label: "GLM-4.7-Flash\uFF08\u514D\u8D39\uFF09", tiers: [flat(0, 0, 0, "\u514D\u8D39")] },
+  { id: "glm-4.7-flash", label: "GLM-4.7-Flash (free)", tiers: [flat(0, 0, 0, "free")] },
   { id: "glm-4-plus", label: "GLM-4-Plus", tiers: [flat(5, 2.5, 5)] },
   { id: "glm-4-air-250414", label: "GLM-4-Air-250414", tiers: [flat(0.5, 0.25, 0.5)] },
-  { id: "glm-4-air", label: "GLM-4-Air\uFF08\u540C 250414 \u7248\u4EF7\uFF09", tiers: [flat(0.5, 0.25, 0.5)] },
+  { id: "glm-4-air", label: "GLM-4-Air (same price as 250414)", tiers: [flat(0.5, 0.25, 0.5)] },
   { id: "glm-4-airx", label: "GLM-4-AirX", tiers: [flat(10, null, 10)] },
   { id: "glm-4-long", label: "GLM-4-Long", tiers: [flat(1, 0.5, 1)] },
   { id: "glm-4-assistant", label: "GLM-4-Assistant", tiers: [flat(5, null, 5)] },
@@ -748,53 +757,55 @@ var BIGMODEL_PRICES = [
   { id: "glm-z1-airx", label: "GLM-Z1-AirX", tiers: [flat(5, null, 5)] },
   { id: "glm-z1-flashx", label: "GLM-Z1-FlashX", tiers: [flat(0.1, null, 0.1)] },
   { id: "glm-4-flashx-250414", label: "GLM-4-FlashX-250414", tiers: [flat(0.1, 0.05, 0.1)] },
-  { id: "glm-4-flashx", label: "GLM-4-FlashX\uFF08\u540C 250414 \u7248\u4EF7\uFF09", tiers: [flat(0.1, 0.05, 0.1)] },
-  { id: "glm-4-flash-250414", label: "GLM-4-Flash-250414\uFF08\u514D\u8D39\uFF09", tiers: [flat(0, null, 0, "\u514D\u8D39\xB7\u7F13\u5B58\u4E0D\u652F\u6301")] },
-  { id: "glm-4-flash", label: "GLM-4-Flash\uFF08\u514D\u8D39\uFF09", tiers: [flat(0, null, 0, "\u514D\u8D39\xB7\u7F13\u5B58\u4E0D\u652F\u6301")] },
-  { id: "glm-z1-flash", label: "GLM-Z1-Flash\uFF08\u514D\u8D39\uFF09", tiers: [flat(0, null, 0, "\u514D\u8D39\xB7\u7F13\u5B58\u4E0D\u652F\u6301")] },
+  { id: "glm-4-flashx", label: "GLM-4-FlashX (same price as 250414)", tiers: [flat(0.1, 0.05, 0.1)] },
+  { id: "glm-4-flash-250414", label: "GLM-4-Flash-250414 (free)", tiers: [flat(0, null, 0, "free \xB7 cache unsupported")] },
+  { id: "glm-4-flash", label: "GLM-4-Flash (free)", tiers: [flat(0, null, 0, "free \xB7 cache unsupported")] },
+  { id: "glm-z1-flash", label: "GLM-Z1-Flash (free)", tiers: [flat(0, null, 0, "free \xB7 cache unsupported")] },
+  // ---- Vision ----
   { id: "glm-ocr", label: "GLM-OCR", tiers: [flat(0.2, null, 0.2)] },
   {
     id: "glm-5v-turbo",
     label: "GLM-5V-Turbo",
     tiers: [
-      { when: { inputLt: K32 }, input: 5, cache: 1.2, output: 22, note: "\u5165<32K" },
-      { when: { inputGte: K32 }, input: 7, cache: 1.8, output: 26, note: "\u5165\u226532K" }
+      { when: { inputLt: K32 }, input: 5, cache: 1.2, output: 22, note: "in<32K" },
+      { when: { inputGte: K32 }, input: 7, cache: 1.8, output: 26, note: "in>=32K" }
     ]
   },
   {
     id: "glm-4.6v",
     label: "GLM-4.6V",
     tiers: [
-      { when: { inputLt: K32 }, input: 1, cache: 0.2, output: 3, note: "\u5165<32K" },
-      { when: { inputGte: K32 }, input: 2, cache: 0.4, output: 6, note: "\u516532K\u2013128K\uFF08\u8D85\u4E0A\u754C\u5E76\u5165\u9AD8\u6863\uFF09" }
+      { when: { inputLt: K32 }, input: 1, cache: 0.2, output: 3, note: "in<32K" },
+      { when: { inputGte: K32 }, input: 2, cache: 0.4, output: 6, note: "in 32K\u2013128K (above the upper bound folds into the top tier)" }
     ]
   },
   {
     id: "glm-4.6v-flashx",
     label: "GLM-4.6V-FlashX",
     tiers: [
-      { when: { inputLt: K32 }, input: 0.15, cache: 0.03, output: 1.5, note: "\u5165<32K" },
-      { when: { inputGte: K32 }, input: 0.3, cache: 0.03, output: 3, note: "\u516532K\u2013128K\uFF08\u8D85\u4E0A\u754C\u5E76\u5165\u9AD8\u6863\uFF09" }
+      { when: { inputLt: K32 }, input: 0.15, cache: 0.03, output: 1.5, note: "in<32K" },
+      { when: { inputGte: K32 }, input: 0.3, cache: 0.03, output: 3, note: "in 32K\u2013128K (above the upper bound folds into the top tier)" }
     ]
   },
-  { id: "glm-4.6v-flash", label: "GLM-4.6V-Flash\uFF08\u514D\u8D39\uFF09", tiers: [flat(0, 0, 0, "\u514D\u8D39")] },
+  { id: "glm-4.6v-flash", label: "GLM-4.6V-Flash (free)", tiers: [flat(0, 0, 0, "free")] },
   {
     id: "glm-4.5v",
     label: "GLM-4.5V",
     tiers: [
-      { when: { inputLt: K32 }, input: 2, cache: 0.4, output: 6, note: "\u5165<32K" },
-      { when: { inputGte: K32 }, input: 4, cache: 0.8, output: 12, note: "\u516532K\u201364K\uFF08\u8D85\u4E0A\u754C\u5E76\u5165\u9AD8\u6863\uFF09" }
+      { when: { inputLt: K32 }, input: 2, cache: 0.4, output: 6, note: "in<32K" },
+      { when: { inputGte: K32 }, input: 4, cache: 0.8, output: 12, note: "in 32K\u201364K (above the upper bound folds into the top tier)" }
     ]
   },
   { id: "glm-4v-plus-0111", label: "GLM-4V-Plus-0111", tiers: [flat(4, 2, 4)] },
-  { id: "glm-4v-plus", label: "GLM-4V-Plus\uFF08\u540C 0111 \u7248\u4EF7\uFF09", tiers: [flat(4, 2, 4)] },
-  { id: "glm-4v-flash", label: "GLM-4V-Flash\uFF08\u514D\u8D39\uFF09", tiers: [flat(0, null, 0, "\u514D\u8D39\xB7\u7F13\u5B58\u4E0D\u652F\u6301")] },
+  { id: "glm-4v-plus", label: "GLM-4V-Plus (same price as 0111)", tiers: [flat(4, 2, 4)] },
+  { id: "glm-4v-flash", label: "GLM-4V-Flash (free)", tiers: [flat(0, null, 0, "free \xB7 cache unsupported")] },
   { id: "glm-4.1v-thinking-flashx", label: "GLM-4.1V-Thinking-FlashX", tiers: [flat(2, null, 2)] },
-  { id: "glm-4.1v-thinking-flash", label: "GLM-4.1V-Thinking-Flash\uFF08\u514D\u8D39\uFF09", tiers: [flat(0, null, 0, "\u514D\u8D39\xB7\u7F13\u5B58\u4E0D\u652F\u6301")] },
-  { id: "embedding-3", label: "Embedding-3", tiers: [flat(0.5, null, 0.5, "\u5355\u503C\u4EF7\u76EE\xB7input \u8BA1")] },
-  { id: "embedding-2", label: "Embedding-2", tiers: [flat(0.5, null, 0.5, "\u5355\u503C\u4EF7\u76EE\xB7input \u8BA1")] },
-  { id: "rerank", label: "Rerank", tiers: [flat(0.8, null, 0.8, "\u5355\u503C\u4EF7\u76EE")] },
-  { id: "codegeex-4", label: "CodeGeeX-4", tiers: [flat(0.1, null, 0.1, "\u5355\u503C\u4EF7\u76EE")] }
+  { id: "glm-4.1v-thinking-flash", label: "GLM-4.1V-Thinking-Flash (free)", tiers: [flat(0, null, 0, "free \xB7 cache unsupported")] },
+  // ---- Embeddings / other (single-value prices are input-based; output billed at the same rate as a floor) ----
+  { id: "embedding-3", label: "Embedding-3", tiers: [flat(0.5, null, 0.5, "single-value \xB7 billed on input")] },
+  { id: "embedding-2", label: "Embedding-2", tiers: [flat(0.5, null, 0.5, "single-value \xB7 billed on input")] },
+  { id: "rerank", label: "Rerank", tiers: [flat(0.8, null, 0.8, "single-value")] },
+  { id: "codegeex-4", label: "CodeGeeX-4", tiers: [flat(0.1, null, 0.1, "single-value")] }
 ];
 var findPrice = (model) => {
   const m = model.trim().toLowerCase();
@@ -823,7 +834,7 @@ var priceUsage = (rows) => {
   const accs = /* @__PURE__ */ new Map();
   for (const r of rows) {
     if (r.inputTokens === 0 && r.outputTokens === 0) continue;
-    const key = r.model === "" ? "\uFF08\u672A\u8BB0\u5F55\u6A21\u578B\uFF09" : r.model;
+    const key = r.model === "" ? "(no model recorded)" : r.model;
     let a = accs.get(key);
     if (a === void 0) {
       const p = findPrice(key);
@@ -899,9 +910,10 @@ CREATE TABLE IF NOT EXISTS prompt_usage (
   note TEXT NOT NULL DEFAULT '',
   model TEXT NOT NULL DEFAULT '',
   input_tokens INTEGER NOT NULL DEFAULT 0,
-  -- cached_tokens\uFF1Az.ai \u53E3\u5F84\u7F13\u5B58\u547D\u4E2D\uFF08input \u5B50\u96C6\uFF0Cwf_66a9b632154d\uFF09
-  --\uFF08\u5341\u4E09\u8DD1 R1 \u987A\u624B\u4FEE\uFF1A\u539F JS \u98CE\u683C // \u6CE8\u91CA\u5199\u5728 SQL \u4E32\u5185\uFF0CSQLite \u4E0D\u8BA4\uFF0C
-  -- db.exec(MIGRATIONS) \u76F4\u63A5\u629B near "/": syntax error\uFF0C\u5168\u4ED3 store \u7EA7\u6D4B\u8BD5\u5C3D\u7EA2\uFF09
+  -- cached_tokens: z.ai-convention cache hits (subset of input, wf_66a9b632154d)
+  -- (fixed in passing during run-13 R1: the original JS-style // comments inside
+  -- the SQL string are not valid SQLite; db.exec(MIGRATIONS) threw near "/":
+  -- syntax error and every store-level test in the repo went red)
   cached_tokens INTEGER NOT NULL DEFAULT 0,
   output_tokens INTEGER NOT NULL DEFAULT 0,
   duration_ms INTEGER NOT NULL DEFAULT 0,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juli-os/ledger",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "juli-os L1 layer: the ledger of record for agent work — workflows, steps, case files, and token usage in one zero-dependency SQLite layer.",
   "type": "module",
   "main": "./dist/index.js",
@@ -30,13 +30,17 @@
     "prepublishOnly": "npm run build"
   },
   "devDependencies": {
+    "@types/node": "^22.0.0",
     "esbuild": "^0.24.0",
-    "typescript": "^5.6.0",
-    "@types/node": "^22.0.0"
+    "typescript": "^5.6.0"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
   },
-  "license": "Apache-2.0"
-}
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/juli-os/ledger.git"
+  }
+}