dsh-plugin-soulbridge 0.0.113 → 0.0.114

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 : '';
@@ -810,7 +810,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>`);
@@ -2106,7 +2106,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 +2351,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 +2374,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.114",
   "description": "Inject soulbridge context into DSH sessions and feed user turns back as observations.",
   "type": "module",
   "main": "index.js",