dsh-galatea 0.3.0 → 0.3.5

package/index.js

@@ -69,7 +69,7 @@ export const Config = z.object({
 });
 
 /** 需要宿主注入的服务。 */
-export const inject = ['systemPrompt', 'tools'];
+export const inject = ['systemPrompt', 'tools', 'agents'];
 
 /**
  * volatile 字段是**引用**，普通字段是**值**。

package/lib/beat-tool.js

@@ -12,6 +12,7 @@ import { defineTool } from '@deepseek-ai/dsh-tools';
 
 import { planBeat } from './beat.js';
 import { pickMaterial } from './material.js';
+import { renderJournal } from './journal.js';
 
 /**
  * 把 agents 服务里的 live agent 统一成 { id, header }。
@@ -58,6 +59,7 @@ export function makeBeatTool(deps) {
           switched: { type: 'boolean' },
           previous: { type: 'string' },
           text: { type: 'string' },
+          journal: { type: 'string' },
         },
       },
       render: (_args, v) => [{ type: 'text', text: v.text }],
@@ -68,6 +70,8 @@ export function makeBeatTool(deps) {
       const entries = deps.listEntries();
       const state = deps.loadState();
 
+      const liveCfg = typeof deps.config === 'function' ? deps.config() : (deps.config ?? {});
+
       const r = planBeat({
         now: new Date(),
         state,
@@ -75,12 +79,15 @@ export function makeBeatTool(deps) {
         entries,
         // 配置可以是函数：设置页改的是引用，每次现读才拿得到新值。
         // 传快照的话，界面上改了、跑起来还是旧的，而且不报错。
-        config: typeof deps.config === 'function' ? deps.config() : deps.config,
+        config: liveCfg,
       });
 
       const material = entries.find((e) => e.id === r.materialId) ?? null;
       const picked = material ?? pickMaterial(entries, state.lastSpokeAt ?? null).entry;
 
+      // 给人看的那几行：把它自己最近的决定翻成人话。
+      const journal = renderJournal(state, { quietRounds: liveCfg.quietRounds });
+
       const lines = [];
       lines.push(r.speak ? '现在会说话。' : '现在不会说话。');
       lines.push(`理由：${r.reason} —— ${r.detail}`);
@@ -100,6 +107,7 @@ export function makeBeatTool(deps) {
         switched: r.switched === true,
         previous: r.previous ?? '',
         text: lines.join('\n'),
+        journal,
       };
     },
   });

package/lib/journal.js

@@ -0,0 +1,86 @@
+/**
+ * 给"人"看的心跳记录。
+ *
+ * 来由：外面有人真机试完，说了一句最狠的话 ——
+ * **「Galatea 的能力都在用户看不见的地方。」**
+ *
+ * 门控、状态账本、素材选择全在后台跑；装完打开，用户看见的是一片空白。
+ * 更糟的是：**沉默看不见，就等于故障看不见。**
+ * 我在代码里写了七种「为什么没说」，但那些字只有读代码的人才看得到。
+ *
+ * 所以这里只做一件事：把那七种理由翻成人话。
+ * 不发明数据，不评价好坏，不排序打分——账本里记了什么就说什么。
+ */
+import { DEFAULTS } from './heartbeat.js';
+
+/** reason → 一句人话。门控那七种 + 三种"更早就断了"的，一种都不许漏。 */
+export const REASON_TEXT = {
+  // 门控给出的
+  quiet: '安静时段',
+  tooSoon: '离上一轮太近',
+  cooldown: '你刚说过话',
+  hard: '有具体的事要说',
+  floor: '太久没开口，这次强制说一句',
+  dice: '随机决定要说',
+  noMaterial: '记忆里没有可用的东西',
+  nothingNew: '记下的都说过了',
+  noHuman: '没有正在进行的对话',
+};
+
+/** HH:MM，本地时区。认不出的时间原样标出来，不替它猜一个像样的值。 */
+function clockOf(iso) {
+  const d = new Date(iso);
+  if (Number.isNaN(d.getTime())) return '--:--';
+  const p = (n) => String(n).padStart(2, '0');
+  return `${p(d.getHours())}:${p(d.getMinutes())}`;
+}
+
+/** 拿不准的一律原样显示，不替它编一个更好听的说法。 */
+export function explain(reason) {
+  return REASON_TEXT[reason] ?? `（未登记的理由：${reason}）`;
+}
+
+/**
+ * 把状态账本渲染成人能读的几行。
+ *
+ * 只读 `decisions`，不推测、不补空白。
+ * 一条记录都没有时，明说「还没有记录过」——不能显示空白，
+ * 那和「功能坏了」长得一样。这条规矩从记忆模块一路沿用到这里。
+ *
+ * @param {object} state  loadState() 的输出
+ * @param {{limit?: number}} [opts]
+ * @returns {string}
+ */
+export function renderJournal(state, opts = {}) {
+  const limit = opts.limit ?? 5;
+  const ds = Array.isArray(state?.decisions) ? state.decisions : [];
+
+  const lines = [];
+
+  if (ds.length === 0) {
+    // 不能直接 return —— 没有记录和"连续很多轮没开口"是两件可以同时成立的事，
+    // 早退会把 streak 吞掉，而那正是沉默和坏了唯一的分界。
+    lines.push('心跳还没有记录过。它至少跑过一次之后，这里才会有东西。');
+  } else {
+    lines.push(
+      ...ds
+        .slice(-limit)
+        .reverse()
+        .map((d) => `${clockOf(d.at)}　${d.speak ? '说了' : '没说'}　—　${explain(d.reason)}`),
+    );
+  }
+
+  // 连续没开口的次数：这是「沉默」和「坏了」唯一能分开的地方
+  const streak = Number(state?.quietStreak ?? 0);
+  if (streak > 0) {
+    const floor = Number(opts.quietRounds ?? DEFAULTS.quietRounds);
+    if (lines.length > 0) lines.push('');
+    lines.push(
+      floor > 0
+        ? `连续 ${streak} 轮没开口（到 ${floor} 会强制说一次）`
+        : `连续 ${streak} 轮没开口（保底已关闭，可能一直不说）`,
+    );
+  }
+
+  return lines.join('\n');
+}

package/lib/material.js

@@ -45,7 +45,7 @@ export function pickMaterial(entries, lastSpokeAt) {
 
   // 时间认不出的条目不用 —— 宁可少说一条，不要拿一条没时间的去凑
   const dated = list
-    .map((e) => ({ entry: e, ms: toMs(e.at) }))
+    .map((e) => ({ entry: e, ms: toMs(e.at ?? e.date) }))
     .filter((x) => x.ms !== null);
 
   if (dated.length === 0) {

package/package.json

@@ -1,7 +1,12 @@
 {
   "name": "dsh-galatea",
-  "version": "0.3.0",
+  "version": "0.3.5",
   "description": "Galatea — memory, heartbeat and continuity for DeepSeek Harness agents.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Vounea/Galatea.git",
+    "directory": "."
+  },
   "type": "module",
   "main": "index.js",
   "license": "MIT",
@@ -16,7 +21,7 @@
     "node": ">=20.18"
   },
   "scripts": {
-    "test": "node --test test/store.test.mjs test/apply.test.mjs test/tools.test.mjs test/heartbeat.test.mjs test/heartbeat-runner.test.mjs test/target.test.mjs test/material.test.mjs test/beat.test.mjs"
+    "test": "node --test test/store.test.mjs test/apply.test.mjs test/tools.test.mjs test/heartbeat.test.mjs test/heartbeat-runner.test.mjs test/target.test.mjs test/material.test.mjs test/beat.test.mjs test/contract.test.mjs test/journal.test.mjs"
   },
   "peerDependencies": {
     "@deepseek-ai/dsh-tools": "*",