@kmchai/cortico-bot-gateway 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -1,6 +1,11 @@
+## 0.1.1
+
+- 主 session 重新声明 `outputTap`,把挂载 World 的接收器扇进来。语音 World 的概率自动朗读此前在网关 bot 里完全拿不到主 session 正文,只有显式 `voice_speak` 工具能出声;现在纯文本回复能按语音 World 的概率触发。
+
 ## 0.1.0
 
 - 初版网关 bot:人设、情绪基调、能力路由与 `end_turn`。
+- 显示名统一为 `Kmch AI · 网关`(bot 默认名与 Persona 页标签)。
 - 声明 `console`、`qq`、`voice`、`service` 四个 World。
 - 前缀写入 QQ 语音交付链:`voice_speak({ silent: true })` → `[blob log:…]` → `qq_draft` → `qq_confirm`;失败退回文字。
 - 记忆未实现:只留 `memoryDir`、`FileBlobStore` 与 `MEMORY.seed.md`,不提供记忆工具或页面。

package/README.md

@@ -31,6 +31,6 @@ Live2D 的安装、启用与配置状态，并链接到对应的 World 页或扩
 
 - 工具只有各 World 的加 `end_turn`；不提供记忆工具，也没有 Memory 页。
 - `MEMORY.md` 只是以后挂记忆的落点，v0.1 不读写它。
-- 是否自动朗读由语音 World 的概率决定，网关不重复掷骰子。
+- 是否自动朗读由语音 World 的概率决定，网关不重复掷骰子；主 session 把挂载 World 的 `outputTap` 扇进来，语音才拿得到正文。
 - QQ 语音走显式工具链:`voice_speak({ silent: true })` → `[blob log:…]` →
   `qq_draft({ voice, to })` → `qq_confirm`；失败时退回文字。

package/index.ts

@@ -25,7 +25,7 @@ function gatewayPages(loaded: LoadedConfig<GatewayConfig>, worlds: World[]): Web
     {
       id: 'persona:gateway',
       kind: 'persona',
-      label: '网关',
+      label: 'Kmch AI · 网关',
       panels: [{ id: 'gateway', title: '能力', getMethods: ['status'] }],
       invoke: async (panel, method) => {
         if (panel !== 'gateway' || method !== 'status') {
@@ -58,7 +58,7 @@ const definition: BotDefinition<GatewayConfig> = {
   declares: DECLARES,
   defaults: () => ({
     ...structuredClone(CORE_DEFAULTS),
-    displayName: 'Kmch AI',
+    displayName: 'Kmch AI · 网关',
     rounds: { soft: 6, hard: 12 },
   }),
   build,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kmchai/cortico-bot-gateway",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "type": "module",
   "description": "Cortico bot: Kmch AI gateway persona that declares voice, service and QQ capabilities",
   "author": "kmchai",

package/persona/persona.ts

@@ -7,6 +7,7 @@ import { join } from 'node:path';
 import type {
   BlobStore,
   CoreApi,
+  OutputTap,
   Persona,
   PrefixSegment,
   RoundCaps,
@@ -16,6 +17,7 @@ import type {
   ToolDef,
   World,
 } from 'cortico/core/types.ts';
+import { defaultExternalizes } from 'cortico/core/types.ts';
 import { renderTemplate } from 'cortico/core/template.ts';
 import { readTextFile } from 'cortico/core/util.ts';
 import { FileBlobStore } from './blobs.ts';
@@ -89,6 +91,7 @@ export class GatewayPersona implements Persona {
   }
 
   declareSessions(): SessionDecl[] {
+    const self = this;
     return [
       {
         id: MAIN,
@@ -96,12 +99,33 @@ export class GatewayPersona implements Persona {
         rounds: this.opts.rounds,
         persistent: true,
         receivesEvents: true,
+        // World 的接收器扇入主 session;语音的自动朗读靠它拿到正文。
+        get outputTap() { return self.outputTap(); },
         // World 的工具在前、自有工具在后:工具表顺序影响请求前缀的缓存命中。
         tools: () => [...this.opts.worlds.flatMap((w) => w.tools()), endTurnTool()],
       },
     ];
   }
 
+  /**
+   * 主 session 的输出旁路:挂载 World 的接收器扇成一个 tap。没有任何接收器时不声明。
+   * 每批投递时现取,World 运行中挂载/卸载即生效。
+   */
+  private outputTap(): OutputTap | undefined {
+    const taps = this.opts.worlds.flatMap((world) => {
+      const tap = world.outputTap?.();
+      return tap ? [tap] : [];
+    });
+    if (taps.length === 0) return undefined;
+    if (taps.length === 1) return taps[0];
+    return {
+      onEvent: (event) => { for (const tap of taps) tap.onEvent(event); },
+      externalizes: (event) => taps.some((tap) => (tap.externalizes?.(event) ?? defaultExternalizes(event))),
+      onRoundEnd: () => { for (const tap of taps) tap.onRoundEnd?.(); },
+      onAbort: (reason) => { for (const tap of taps) tap.onAbort?.(reason); },
+    };
+  }
+
   /** 自有工具名;装配层据此拒绝与之撞名的 World。 */
   ownToolNames(): string[] {
     return GATEWAY_TOOL_DECLS.map((decl) => decl.name);