dsh-plugin-soulbridge 0.0.113 → 0.0.115

package/README.md

@@ -107,8 +107,17 @@ DSH 启动器对 `package.json` 直接 `JSON.parse`，不剥 BOM。用 Windows P
 
 计数来源是宿主的事件流：`step/start`（一次调用）、`assistant/attempt`（重试且没出消息）、
 `assistant/message.usage`（token）。子代理跑在自己的会话里，因此各自一条记录——事件流
-里没有父子关系，猜一个比写两条更坏。插件**不算钱**：金额只从 `scripts/billing.mjs`
-（读平台导出）来，价目有峰谷两档且会变。
+里没有父子关系，猜一个比写两条更坏。
+
+插件**不算钱**（价目有峰谷两档且会变）。账单是另一件事，也只属于宿主侧的运维：
+
+```powershell
+node scripts/billing.mjs --days 4   # 读平台导出，按天给金额/请求/三类 token 并复核单价
+```
+
+判读与限制见 [docs/cost-visibility.md](docs/cost-visibility.md)。这两样都**不属于 soulbridge**：
+记忆层存"发生了什么"，不记"值多少钱"。
+
 ## 升级提示：新增工具需要新开会话
 
 `ctx.inject(['tools'])` 注册的工具在**会话创建时**进入该会话的工具集。插件升级后

package/index.js

@@ -663,7 +663,7 @@ export function buildFactHooks(text, options = {}) {
       for (const fact of [...earliest, ...recent]) {
         if (seen.has(fact.id)) continue;
         seen.add(fact.id);
-        const when = fact.atText ?? (fact.at ? new Date(fact.at).toISOString().slice(0, 10) : '');
+        const when = fact.validFromText ?? (fact.validFrom ? new Date(fact.validFrom).toISOString().slice(0, 10) : '');
         // ADR 0035: a fact from my side of the exchange is inferred. Two characters plus one
         // explanation below the block, because a per-line sentence would double the text.
         const marker = fact.source === 'inferred' ? INFERRED_MARKER : '';
@@ -694,11 +694,16 @@ export function buildFactHooks(text, options = {}) {
  * When the question names a subject, the entity timeline is the answer and the
  * related-pairs search is the contamination: it is how "上次和 a 吃饭" ends up
  * answered with something about b. So the plan chooses one or the other.
+ *
+ * A time question is different: the window block answers "what happened last week",
+ * and the relevance block stays on because it is where relative/unknown facts and
+ * not-yet-extracted conversation still surface (0027 §八: they must never be dropped
+ * just because their date cannot be located).
  */
 export function planBlocks(plan) {
-  if (!plan) return { related: true, timeline: false };
-  if (plan.primitive === 'entity') return { related: false, timeline: true };
-  return { related: true, timeline: false };
+  if (!plan) return { related: true, timeline: false, window: false };
+  if (plan.primitive === 'entity') return { related: false, timeline: true, window: false };
+  return { related: true, timeline: false, window: Boolean(plan.window) };
 }
 
 const PROFILE_CORE_DIMENSION = '价值观';
@@ -755,7 +760,52 @@ export function renderRulesBlock(rules) {
   return `<rules fired="${ids}">\n${lines}\n</rules>`;
 }
 
-function buildRelatedContext(text, state = {}) {
+/** How many facts one window may put in the prompt before it is cut. */
+const TIME_WINDOW_LIMIT = 10;
+
+/** A calendar day as the user reads it — local, not UTC: a date is a day, not an instant. */
+function isoDay(ms) {
+  const date = new Date(ms);
+  const pad = (n) => String(n).padStart(2, '0');
+  return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
+}
+
+/** When a fact happened, as the injection may say it: a located date, or the words said. */
+function factWhen(fact) {
+  // A range ("10 月下旬") is not a day: printing its start as a date would claim an
+  // exactness the model never had. The original words are the honest answer.
+  if (fact.validFromPrecision === 'range' && fact.validFromText) return fact.validFromText;
+  return fact.validFrom ? isoDay(fact.validFrom) : fact.validFromText ?? '';
+}
+
+/**
+ * The facts that happened in one window (0027 §八, reader 1).
+ *
+ * Only located dates reach this block — the query already excluded the rest. The dates
+ * are shown because "when" is the question; an empty window says so explicitly rather
+ * than leaving the model to fill the gap. Truncation is stated, never silent: a block
+ * that looks complete but is not is worse than a short one.
+ */
+export function renderTimeWindow(window, facts, options = {}) {
+  const cue = escapeAttr(String(window.cue ?? ''));
+  // `to` is exclusive; the last day in the window is the millisecond before it.
+  const head = `<time-window cue="${cue}" from="${isoDay(window.from)}" to="${isoDay(window.to - 1)}">`;
+  if (!Array.isArray(facts) || facts.length === 0) {
+    return `${head}\n（${escapeBlockText(String(window.cue ?? '这段时间'))}没有记录）\n</time-window>`;
+  }
+  let sawInferred = false;
+  const lines = facts.map((fact) => {
+    const marker = fact.source === 'inferred' ? INFERRED_MARKER : '';
+    if (marker) sawInferred = true;
+    const when = escapeBlockText(String(factWhen(fact)));
+    return `- ${marker}[${fact.id}]${when ? ` ${when}` : ''} ${escapeBlockText(fact.statement)}`;
+  });
+  if (options.truncated) lines.push(`- （只显示最早 ${facts.length} 条）`);
+  const block = `${head}\n${lines.join('\n')}\n</time-window>`;
+  return sawInferred ? `${block}\n${SOURCE_NOTES}` : block;
+}
+
+export function buildRelatedContext(text, state = {}) {
   const parts = [];
   const used = [];
   // The profile is the merged description of the person; it is the only block that
@@ -810,7 +860,7 @@ function buildRelatedContext(text, state = {}) {
         const body = timeline
           .map(
             (fact) =>
-              `- [${fact.id}] ${fact.atText ? `${escapeBlockText(fact.atText)} ` : ''}${escapeBlockText(fact.statement)}`,
+              `- [${fact.id}] ${fact.validFromText ? `${escapeBlockText(fact.validFromText)} ` : ''}${escapeBlockText(fact.statement)}`,
           )
           .join('\n');
         parts.push(`<about-now name="${escapeAttr(plan.subject)}">\n${body}\n</about-now>`);
@@ -824,6 +874,21 @@ function buildRelatedContext(text, state = {}) {
       log(`timeline failed: ${error instanceof Error ? error.message : String(error)}`);
     }
   }
+  if (policy.window && plan?.window) {
+    try {
+      // +1 is a probe, not a fact: when it comes back there were more rows than the
+      // block may carry, and the renderer says so instead of pretending completeness.
+      const hits = ensureSoul().factsInWindow(plan.window, { limit: TIME_WINDOW_LIMIT + 1 });
+      const facts = hits.slice(0, TIME_WINDOW_LIMIT);
+      const truncated = hits.length > TIME_WINDOW_LIMIT;
+      parts.push(renderTimeWindow(plan.window, facts, { truncated }));
+      used.push(...facts.map((fact) => fact.id));
+      trace({ event: 'time_window', cue: plan.window.cue, from: plan.window.from, to: plan.window.to, hits: facts.length, truncated });
+      log(`time-window: ${plan.window.cue} hits=${facts.length}${truncated ? ' (truncated)' : ''}`);
+    } catch (error) {
+      log(`time window failed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+  }
   if (policy.related) {
     const pairs = ensureSoul().recallTurnPairs(text);
     if (pairs.length > 0) {
@@ -2106,7 +2171,7 @@ async function runConsolidationStep() {
   const batch = context.facts.slice(0, CONSOLIDATION_MAX_FACTS).map((fact) => ({
     id: fact.id,
     statement: fact.statement,
-    atText: fact.atText,
+    validFromText: fact.validFromText,
   }));
   let raw;
   try {
@@ -2351,8 +2416,9 @@ function detailTool() {
         properties: {
           ok: { type: 'boolean' },
           statement: { type: 'string' },
-          at: { type: 'number' },
-          atText: { type: 'string' },
+          validFrom: { type: 'number' },
+          validFromText: { type: 'string' },
+          validTo: { type: 'number' },
           userText: { type: 'string' },
           assistantText: { type: 'string' },
           reason: { type: 'string' },
@@ -2373,8 +2439,9 @@ function detailTool() {
         return {
           ok: true,
           statement: detail.fact.statement,
-          at: detail.fact.at,
-          atText: detail.fact.atText,
+          validFrom: detail.fact.validFrom,
+          validFromText: detail.fact.validFromText,
+          validTo: detail.fact.validTo,
           userText: detail.turn?.userText,
           assistantText: detail.turn?.assistantText,
         };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-soulbridge",
-  "version": "0.0.113",
+  "version": "0.0.115",
   "description": "Inject soulbridge context into DSH sessions and feed user turns back as observations.",
   "type": "module",
   "main": "index.js",
@@ -42,6 +42,6 @@
     "setup": "node scripts/install-hooks.mjs"
   },
   "dependencies": {
-    "soulbridge": ">=0.0.112 <0.1.0"
+    "soulbridge": ">=0.0.114 <0.1.0"
   }
 }