@barryfan2045/dsh-matrix 0.1.0

package/dist/bridge/reply.d.ts

@@ -0,0 +1,31 @@
+import type { Transport } from '../ports/transport.ts';
+import type { TurnStreamSource } from '../ports/streaming.ts';
+/** Default edit throttle (ticket T7: ~1.5s between Matrix edits). */
+export declare const STREAM_THROTTLE_MS = 1500;
+/** Body shown when a turn ends with nothing streamed and no reply text. */
+export declare const NO_OUTPUT_BODY = "(\u672C\u8F6E\u6CA1\u6709\u6587\u672C\u8F93\u51FA)";
+export interface TurnResponderOptions {
+    transport: Transport;
+    roomId: string;
+    /** Hard ceiling for any single Matrix body (placeholder clip + final split). */
+    maxChunk: number;
+    /** Streaming source; with `sessionId` present = stream mode. */
+    stream?: TurnStreamSource;
+    /** DSH session whose stream drives the placeholder. */
+    sessionId?: string;
+    /** Injectable clock (ms) so throttle windows are test-deterministic. */
+    now?: () => number;
+    throttleMs?: number;
+    /** Placeholder body sent at start. */
+    placeholder?: string;
+}
+export interface TurnResponder {
+    /** Stream mode: send the placeholder, then subscribe. Otherwise a no-op. */
+    start(): Promise<void>;
+    /** Turn settled: land the complete reply and release everything. */
+    finalize(fullText: string | undefined): Promise<void>;
+    /** Detach the stream without landing anything (idempotent). */
+    dispose(): void;
+}
+export declare function createTurnResponder(opts: TurnResponderOptions): TurnResponder;
+//# sourceMappingURL=reply.d.ts.map

package/dist/bridge/reply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reply.d.ts","sourceRoot":"","sources":["../../src/bridge/reply.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,KAAK,EAAsB,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAEjF,qEAAqE;AACrE,eAAO,MAAM,kBAAkB,OAAO,CAAA;AAEtC,2EAA2E;AAC3E,eAAO,MAAM,cAAc,uDAAe,CAAA;AAE1C,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,SAAS,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,gFAAgF;IAChF,QAAQ,EAAE,MAAM,CAAA;IAChB,gEAAgE;IAChE,MAAM,CAAC,EAAE,gBAAgB,CAAA;IACzB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,4EAA4E;IAC5E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrD,+DAA+D;IAC/D,OAAO,IAAI,IAAI,CAAA;CAChB;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,oBAAoB,GAAG,aAAa,CA+F7E"}

package/dist/bridge/reply.js

@@ -0,0 +1,122 @@
+/**
+ * T7 turn responder: how one agent answer lands in the room.
+ *
+ * Non-stream mode (no source): byte-for-byte the T1 behavior - finalize sends
+ * the splitMessage chunks as fresh messages, nothing happens while the turn
+ * runs.
+ *
+ * Stream mode: start() posts a '…' placeholder (m.text, kept editable) and
+ * subscribes to the session's TurnStreamSource. Each text delta accumulates
+ * into a local buffer; at most one edit per throttle window renders it
+ * (tail-clipped to maxChunk + '…'). Turn completion is the pipeline's
+ * whenIdle - the stream's end frames settle single model ATTEMPTS, not the
+ * turn - and an abandoned attempt rewinds the buffer so retry content never
+ * stays in the room. finalize() retracts everything the stream guessed: the
+ * first split chunk EDITS the placeholder, any rest follows as new messages.
+ */
+import { splitMessage } from "../formatting.js";
+/** Default edit throttle (ticket T7: ~1.5s between Matrix edits). */
+export const STREAM_THROTTLE_MS = 1500;
+/** Body shown when a turn ends with nothing streamed and no reply text. */
+export const NO_OUTPUT_BODY = '(本轮没有文本输出)';
+export function createTurnResponder(opts) {
+    const now = opts.now ?? (() => Date.now());
+    const throttleMs = opts.throttleMs ?? STREAM_THROTTLE_MS;
+    const placeholder = opts.placeholder ?? '…';
+    const streaming = opts.stream !== undefined && opts.sessionId !== undefined;
+    let buffer = '';
+    /** buffer.length at the current attempt's start - the abandoned rewind point. */
+    let attemptMark = 0;
+    let editId;
+    /** Seeded so the FIRST delta edits immediately; later ones wait out the window. */
+    let lastEditAt = now() - throttleMs;
+    let rendered;
+    /** Serialized edit chain: no streaming edit may land after the final one. */
+    let chain = Promise.resolve();
+    let unsubscribe;
+    let done = false;
+    function clip(text) {
+        if (text.length <= opts.maxChunk)
+            return text;
+        return `${text.slice(0, Math.max(1, opts.maxChunk - 1))}…`;
+    }
+    function queueEdit(body) {
+        if (done || editId === undefined)
+            return;
+        const shown = body.length > 0 ? clip(body) : placeholder;
+        if (shown === rendered)
+            return; // identical render → skip the redundant edit
+        rendered = shown;
+        lastEditAt = now();
+        const id = editId;
+        chain = chain
+            .then(() => opts.transport.edit(opts.roomId, id, shown))
+            .catch(() => undefined); // edit is best-effort (port contract)
+    }
+    const handlers = {
+        onTextDelta(text) {
+            if (done || !text)
+                return;
+            buffer += text;
+            if (now() - lastEditAt >= throttleMs)
+                queueEdit(buffer);
+        },
+        onTurnEnd() {
+            queueEdit(buffer); // turn's last word from the stream side: flush
+        },
+        onAttemptStart() {
+            if (!done)
+                attemptMark = buffer.length;
+        },
+        onAttemptAbandoned() {
+            if (done)
+                return;
+            buffer = buffer.slice(0, attemptMark);
+            queueEdit(buffer); // retract the retry text from the room right away
+        },
+    };
+    return {
+        async start() {
+            if (!streaming || done)
+                return;
+            try {
+                editId = await opts.transport.send(opts.roomId, placeholder);
+                rendered = placeholder;
+            }
+            catch {
+                editId = undefined; // placeholder failed → degrade to plain sends
+            }
+            if (!done) {
+                unsubscribe = opts.stream.subscribe(opts.sessionId, handlers);
+            }
+        },
+        async finalize(fullText) {
+            if (done)
+                return;
+            done = true;
+            unsubscribe?.();
+            unsubscribe = undefined;
+            const body = fullText ?? NO_OUTPUT_BODY;
+            const chunks = splitMessage(body, opts.maxChunk);
+            if (editId !== undefined) {
+                const id = editId;
+                await chain; // land all streamed edits before overwriting with the truth
+                await opts.transport.edit(opts.roomId, id, chunks[0] ?? body).catch(() => undefined);
+                for (const chunk of chunks.slice(1)) {
+                    await opts.transport.send(opts.roomId, chunk);
+                }
+            }
+            else {
+                for (const chunk of chunks) {
+                    await opts.transport.send(opts.roomId, chunk);
+                }
+            }
+        },
+        dispose() {
+            done = true;
+            unsubscribe?.();
+            unsubscribe = undefined;
+        },
+    };
+}
+//# sourceMappingURL=reply.js.map

package/dist/bridge/reply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reply.js","sourceRoot":"","sources":["../../src/bridge/reply.ts"],"names":[],"mappings":"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"}

package/dist/bridge/space-identity.d.ts

@@ -0,0 +1,43 @@
+/** 共享头像池的图片数量(instance-01 … instance-12)。 */
+export declare const AVATAR_POOL_SIZE = 12;
+/**
+ * 内置头像池的版本标记。**只在整个池子换风格时**才 +1:配置里记的版本落后于它时,
+ * 启动自愈会把受管房间的头像重铺一次,然后记下新版本、回到"只补缺"模式。
+ * 本仓库从 1 起步(没有需要迁就的历史标记;上游的 3 是它自己的迁移账)。
+ */
+export declare const AVATAR_POOL_VERSION = 1;
+/** space 展示名:实例名前面加一个 π 前缀。 */
+export declare function spaceDisplayName(instanceName: string): string;
+/**
+ * 旧模板名字的精确匹配。只认**完全相等**,所以用户手打的同名之外的名字永远不会
+ * 被启动自愈改掉。保留 pi-courier 的旧模板,是为了让从上游迁过来的部署能认出并
+ * 复用/改名它原来的 space,而不是又建一个。
+ */
+export declare function isLegacySpaceName(name: string, instanceName: string): boolean;
+/** djb2 over UTF-8 bytes —— 极小、跨进程与运行时稳定(纯 u32 运算,不依赖 locale)。 */
+export declare function nameHash(name: string): number;
+/** 按名字挑一张池内图片:同一个名字永远同一张。 */
+export declare function pickPoolAvatarFile(name: string): string;
+/** 管理房间的专属图片(固定一张,不与池子撞)。 */
+export declare function managementAvatarFile(): string;
+/** 是否开启了空间模式(缺省 false:不建 space、不挂头像)。 */
+export declare function isSpaceMode(space: {
+    enabled: boolean;
+} | undefined): boolean;
+/** 头像池默认目录:`<包根>/assets/avatars`(src/ 与 dist/ 下都成立)。 */
+export declare function avatarDir(): string;
+/**
+ * 读一张内置头像。文件名先过白名单(只允许 `[\w.-]+.png`)——这一层是**防穿越**的
+ * 关键:头像文件名来自配置/名字哈希,但白名单保证它永远出不了 assets/avatars。
+ * `dir` 可注入,便于测试用夹具目录。
+ */
+export declare function readAvatarBundled(file: string, dir?: string): Buffer;
+/**
+ * m.room.avatar 的 `info` 子块。
+ *
+ * **尺寸从 PNG 的 IHDR 里读**(固定在第 16..24 字节,大端 u32),不硬编码:
+ * 我们的头像池是缩过图的(128×128),照抄上游的 512 会给出**假的元数据** ——
+ * 客户端据此排版会错,而且这是实打实的谎报。非 PNG 则只报 mimetype/size。
+ */
+export declare function avatarInfo(data: Buffer): Record<string, unknown>;
+//# sourceMappingURL=space-identity.d.ts.map

package/dist/bridge/space-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"space-identity.d.ts","sourceRoot":"","sources":["../../src/bridge/space-identity.ts"],"names":[],"mappings":"AAqBA,6CAA6C;AAC7C,eAAO,MAAM,gBAAgB,KAAK,CAAA;AAElC;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,IAAI,CAAA;AAEpC,+BAA+B;AAC/B,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAE7E;AAED,kEAAkE;AAClE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI7C;AAED,6BAA6B;AAC7B,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED,6BAA6B;AAC7B,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,yCAAyC;AACzC,wBAAgB,WAAW,CAAC,KAAK,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,GAAG,OAAO,CAE5E;AAED,wDAAwD;AACxD,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAoB,GAAG,MAAM,CAGjF;AAKD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOhE"}

package/dist/bridge/space-identity.js

@@ -0,0 +1,92 @@
+/**
+ * T12 (US37/38):房间身份 —— 桥怎么给自己的房间命名与挂头像。
+ *
+ * 移植自 pi-courier `src/space-identity.ts`（MIT，见 THIRD_PARTY_NOTICES.md），
+ * 按 DSH 语境取用:
+ *
+ * - space 名 `π <实例名>`:短品牌前缀;旧模板只在**精确匹配**时才改名(见
+ *   isLegacySpaceName),用户自己起的名字永不被启动自愈覆盖。
+ * - 每个受管房间挂一张内置头像:space 按**实例名**哈希、项目房按**项目名**哈希,
+ *   所以同名永远同一张(重建/重启都不变),不同实例/项目通常不同;管理房固定用
+ *   management.png。
+ * - 头像池落在包根的 `assets/avatars/`(12 张 instance-NN.png + management.png,
+ *   512×512)。用户想换成自己的图,同名覆盖即可,不用改代码。
+ *
+ * 这里的函数都是**纯的**(除了 readAvatarBundled 读文件),因此可以在没有真实
+ * Matrix 连接的情况下把命名与选图规则钉死。
+ */
+import { readFileSync } from 'node:fs';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+/** 共享头像池的图片数量(instance-01 … instance-12)。 */
+export const AVATAR_POOL_SIZE = 12;
+/**
+ * 内置头像池的版本标记。**只在整个池子换风格时**才 +1:配置里记的版本落后于它时,
+ * 启动自愈会把受管房间的头像重铺一次,然后记下新版本、回到"只补缺"模式。
+ * 本仓库从 1 起步(没有需要迁就的历史标记;上游的 3 是它自己的迁移账)。
+ */
+export const AVATAR_POOL_VERSION = 1;
+/** space 展示名:实例名前面加一个 π 前缀。 */
+export function spaceDisplayName(instanceName) {
+    return `π ${instanceName}`;
+}
+/**
+ * 旧模板名字的精确匹配。只认**完全相等**,所以用户手打的同名之外的名字永远不会
+ * 被启动自愈改掉。保留 pi-courier 的旧模板,是为了让从上游迁过来的部署能认出并
+ * 复用/改名它原来的 space,而不是又建一个。
+ */
+export function isLegacySpaceName(name, instanceName) {
+    return name === `pi-courier · ${instanceName}`;
+}
+/** djb2 over UTF-8 bytes —— 极小、跨进程与运行时稳定(纯 u32 运算,不依赖 locale)。 */
+export function nameHash(name) {
+    let hash = 5381;
+    for (const byte of Buffer.from(name, 'utf8'))
+        hash = (hash * 33 + byte) >>> 0;
+    return hash;
+}
+/** 按名字挑一张池内图片:同一个名字永远同一张。 */
+export function pickPoolAvatarFile(name) {
+    const index = (nameHash(name) % AVATAR_POOL_SIZE) + 1;
+    return `instance-${String(index).padStart(2, '0')}.png`;
+}
+/** 管理房间的专属图片(固定一张,不与池子撞)。 */
+export function managementAvatarFile() {
+    return 'management.png';
+}
+/** 是否开启了空间模式(缺省 false:不建 space、不挂头像)。 */
+export function isSpaceMode(space) {
+    return space?.enabled === true;
+}
+/** 头像池默认目录:`<包根>/assets/avatars`(src/ 与 dist/ 下都成立)。 */
+export function avatarDir() {
+    return path.join(path.dirname(fileURLToPath(import.meta.url)), '..', '..', 'assets', 'avatars');
+}
+/**
+ * 读一张内置头像。文件名先过白名单(只允许 `[\w.-]+.png`)——这一层是**防穿越**的
+ * 关键:头像文件名来自配置/名字哈希,但白名单保证它永远出不了 assets/avatars。
+ * `dir` 可注入,便于测试用夹具目录。
+ */
+export function readAvatarBundled(file, dir = avatarDir()) {
+    if (!/^[\w.-]+\.png$/.test(file))
+        throw new Error(`非法的头像文件名: ${file}`);
+    return readFileSync(path.join(dir, file));
+}
+/** PNG 文件头(用来判"这是不是 PNG",以及读 IHDR 里的真实尺寸)。 */
+const PNG_MAGIC = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]);
+/**
+ * m.room.avatar 的 `info` 子块。
+ *
+ * **尺寸从 PNG 的 IHDR 里读**(固定在第 16..24 字节,大端 u32),不硬编码:
+ * 我们的头像池是缩过图的(128×128),照抄上游的 512 会给出**假的元数据** ——
+ * 客户端据此排版会错,而且这是实打实的谎报。非 PNG 则只报 mimetype/size。
+ */
+export function avatarInfo(data) {
+    const info = { mimetype: 'image/png', size: data.length };
+    if (data.length >= 24 && data.subarray(0, 8).equals(PNG_MAGIC)) {
+        info.width = data.readUInt32BE(16);
+        info.height = data.readUInt32BE(20);
+    }
+    return info;
+}
+//# sourceMappingURL=space-identity.js.map

package/dist/bridge/space-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"space-identity.js","sourceRoot":"","sources":["../../src/bridge/space-identity.ts"],"names":[],"mappings":"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"}

package/dist/bridge/space-sync.d.ts

@@ -0,0 +1,94 @@
+/**
+ * T12 (US38):space 归集与头像自愈。
+ *
+ * 规则(移植自 pi-courier src/space.ts 的 identity 部分,MIT,按本仓库语境收紧):
+ *
+ * - **space**:开启空间模式时,给实例建一个私有 space `π <实例名>`;已认领过就复用
+ *   (不重复建),然后把受管房间(管理房 + 项目房)都挂进去(`m.space.child`)。
+ * - **头像**:space 按**实例名**哈希、项目房按**项目名**哈希、管理房用专属图;
+ *   同名永远同一张(重建/重启都不变)。
+ * - **永不覆盖用户手动设置的头像**:只在"房间还没有头像"时补挂;唯一的例外是
+ *   内置头像池**整体换风格**(配置里记的版本落后于 AVATAR_POOL_VERSION),那时
+ *   按上游语义重铺一次,铺完把版本记上,之后回到"只补缺"。
+ * - **版本只在整趟都没失败时才记**:否则部分房间没铺上,却因为版本已记而永远
+ *   不再重铺。
+ *
+ * 本模块不碰持久层:它就地更新传入的 `state`,由调用方决定何时存盘(与 power-sync
+ * 同一分工)。头像字节通过注入的 `readAvatar` 读取,便于测试用夹具、也让"池子缺图"
+ * 这条失败路径可测。
+ */
+import type { Logger } from '../types.ts';
+/** space 与头像的持久状态(调用方负责存盘)。 */
+export interface SpaceIdentityState {
+    /** 已认领的 space 房间 ID;复用而不是重复建。 */
+    roomId?: string;
+    /** 已铺过的内置头像池版本;落后于 AVATAR_POOL_VERSION 时重铺一次。 */
+    avatarPoolVersion?: number;
+}
+/** 空间操作需要的原语(Transport 上都是可选的;缺关键项就整体跳过)。 */
+export interface SpaceOps {
+    createSpace?(opts: {
+        name: string;
+        inviteUserId?: string;
+    }): Promise<string>;
+    getRoomAvatar?(roomId: string): Promise<{
+        url?: string;
+        info?: Record<string, unknown>;
+    } | undefined>;
+    setRoomAvatar?(roomId: string, png: Buffer, info?: Record<string, unknown>): Promise<void>;
+    addRoomToSpace?(spaceId: string, roomId: string, via?: string): Promise<void>;
+    /** 读内置头像(缺省走包内 assets/avatars;测试注入夹具目录)。 */
+    readAvatar?(file: string): Buffer;
+}
+export interface SpaceFailure {
+    what: 'space' | 'avatar' | 'child';
+    roomId?: string;
+    error: string;
+}
+export interface SpaceSyncResult {
+    /** 本次是否新建了 space(复用时为 false)。 */
+    spaceCreated: boolean;
+    spaceId?: string;
+    avatarsSet: string[];
+    avatarsKept: string[];
+    childrenAdded: string[];
+    failures: SpaceFailure[];
+}
+export type AvatarTarget = {
+    kind: 'management';
+} | {
+    kind: 'pool';
+    name: string;
+};
+/** 头像文件名:管理房专属图,其它按名字哈希进池子。 */
+export declare function avatarFileFor(target: AvatarTarget): string;
+/** space 是否还能建(缺 createSpace 就跳过)。 */
+export declare function canManageSpace(ops: SpaceOps): boolean;
+/**
+ * 确保有一个可用的 space:已认领过就复用(哪怕它已不存在 —— 那是自愈下一趟的事,
+ * 不该在本趟重复建房),否则建一个并就地记账。
+ */
+export declare function ensureSpace(instanceName: string, state: SpaceIdentityState, ops: SpaceOps, logger?: Logger): Promise<SpaceSyncResult>;
+/**
+ * 确保房间头像正确。返回 'set'(补挂/重铺)或 'kept'(已有且不需要重铺)。
+ *
+ * 重铺的唯一触发条件是**池子版本落后**:用户手动换过的头像在那之前一直会被保住。
+ */
+export declare function ensureRoomAvatar(roomId: string, target: AvatarTarget, state: SpaceIdentityState, ops: SpaceOps, logger?: Logger): Promise<'set' | 'kept' | 'failed'>;
+/** 把房间挂进 space(盲写 m.space.child;重复写是幂等的,不额外读状态)。 */
+export declare function ensureRoomInSpace(spaceId: string, roomId: string, ops: SpaceOps, logger?: Logger): Promise<boolean>;
+/**
+ * 启动对账:建/复用 space → 给每个房间补头像 → 把每个房间挂进 space。
+ *
+ * `targets` 给出每个房间该用哪张图(管理房 / 项目名)。池子版本**只在整趟零失败时**
+ * 才记上,否则部分房间没铺到却再也不会重铺。
+ */
+export declare function healSpaceIdentity(input: {
+    instanceName: string;
+    /** 受管房间:roomId → 该用哪张头像。 */
+    rooms: ReadonlyArray<{
+        roomId: string;
+        target: AvatarTarget;
+    }>;
+}, state: SpaceIdentityState, ops: SpaceOps, logger?: Logger): Promise<SpaceSyncResult>;
+//# sourceMappingURL=space-sync.d.ts.map

package/dist/bridge/space-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"space-sync.d.ts","sourceRoot":"","sources":["../../src/bridge/space-sync.ts"],"names":[],"mappings":"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"}

package/dist/bridge/space-sync.js

@@ -0,0 +1,137 @@
+import { AVATAR_POOL_VERSION, avatarInfo, managementAvatarFile, pickPoolAvatarFile, readAvatarBundled, spaceDisplayName, } from "./space-identity.js";
+function emptyResult() {
+    return { spaceCreated: false, avatarsSet: [], avatarsKept: [], childrenAdded: [], failures: [] };
+}
+function describe(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function readAvatar(ops, file) {
+    return (ops.readAvatar ?? ((f) => readAvatarBundled(f)))(file);
+}
+/** 头像文件名:管理房专属图,其它按名字哈希进池子。 */
+export function avatarFileFor(target) {
+    return target.kind === 'management' ? managementAvatarFile() : pickPoolAvatarFile(target.name);
+}
+/** space 是否还能建(缺 createSpace 就跳过)。 */
+export function canManageSpace(ops) {
+    return typeof ops.createSpace === 'function';
+}
+/**
+ * 确保有一个可用的 space:已认领过就复用(哪怕它已不存在 —— 那是自愈下一趟的事,
+ * 不该在本趟重复建房),否则建一个并就地记账。
+ */
+export async function ensureSpace(instanceName, state, ops, logger) {
+    const result = emptyResult();
+    if (state.roomId) {
+        result.spaceId = state.roomId;
+        return result;
+    }
+    if (!canManageSpace(ops))
+        return result;
+    const name = spaceDisplayName(instanceName);
+    try {
+        const roomId = await ops.createSpace({ name });
+        state.roomId = roomId;
+        result.spaceId = roomId;
+        result.spaceCreated = true;
+        logger?.info(`T12 space 已创建:${name} (${roomId})`);
+    }
+    catch (error) {
+        result.failures.push({ what: 'space', error: describe(error) });
+        logger?.warn(`T12 space 创建失败(${name}),下次启动重试:${describe(error)}`);
+    }
+    return result;
+}
+/**
+ * 确保房间头像正确。返回 'set'(补挂/重铺)或 'kept'(已有且不需要重铺)。
+ *
+ * 重铺的唯一触发条件是**池子版本落后**:用户手动换过的头像在那之前一直会被保住。
+ */
+export async function ensureRoomAvatar(roomId, target, state, ops, logger) {
+    if (typeof ops.getRoomAvatar !== 'function' || typeof ops.setRoomAvatar !== 'function')
+        return 'kept';
+    const rebrand = state.avatarPoolVersion !== AVATAR_POOL_VERSION;
+    let current;
+    try {
+        current = await ops.getRoomAvatar(roomId);
+    }
+    catch (error) {
+        logger?.warn(`T12 读房间头像失败 ${roomId}:${describe(error)}`);
+        return 'failed';
+    }
+    // 已经有头像、且不是"整池换风格" → 一律不碰(用户手动设置的尤其不能动)
+    if (current && !rebrand)
+        return 'kept';
+    const file = avatarFileFor(target);
+    let data;
+    try {
+        data = readAvatar(ops, file);
+    }
+    catch (error) {
+        logger?.warn(`T12 头像文件读不到(${file}),下次启动重试:${describe(error)}`);
+        return 'failed';
+    }
+    try {
+        await ops.setRoomAvatar(roomId, data, avatarInfo(data));
+        return 'set';
+    }
+    catch (error) {
+        logger?.warn(`T12 设置头像失败 ${roomId}:${describe(error)}`);
+        return 'failed';
+    }
+}
+/** 把房间挂进 space(盲写 m.space.child;重复写是幂等的,不额外读状态)。 */
+export async function ensureRoomInSpace(spaceId, roomId, ops, logger) {
+    if (typeof ops.addRoomToSpace !== 'function')
+        return false;
+    try {
+        await ops.addRoomToSpace(spaceId, roomId);
+        return true;
+    }
+    catch (error) {
+        logger?.warn(`T12 挂房间进 space 失败 ${roomId}:${describe(error)}`);
+        return false;
+    }
+}
+/**
+ * 启动对账:建/复用 space → 给每个房间补头像 → 把每个房间挂进 space。
+ *
+ * `targets` 给出每个房间该用哪张图(管理房 / 项目名)。池子版本**只在整趟零失败时**
+ * 才记上,否则部分房间没铺到却再也不会重铺。
+ */
+export async function healSpaceIdentity(input, state, ops, logger) {
+    const result = await ensureSpace(input.instanceName, state, ops, logger);
+    const spaceId = result.spaceId;
+    // space 自己也是一间桥建的房:按**实例名**哈希挂头像(与房间同一套规则:
+    // 已有且不需要重铺就不碰,用户自己换过的不会被覆盖)。
+    if (spaceId) {
+        const spaceAvatar = await ensureRoomAvatar(spaceId, { kind: 'pool', name: input.instanceName }, state, ops, logger);
+        if (spaceAvatar === 'set')
+            result.avatarsSet.push(spaceId);
+        else if (spaceAvatar === 'kept')
+            result.avatarsKept.push(spaceId);
+        else
+            result.failures.push({ what: 'avatar', roomId: spaceId, error: '见日志' });
+    }
+    for (const { roomId, target } of input.rooms) {
+        const avatar = await ensureRoomAvatar(roomId, target, state, ops, logger);
+        if (avatar === 'set')
+            result.avatarsSet.push(roomId);
+        else if (avatar === 'kept')
+            result.avatarsKept.push(roomId);
+        else
+            result.failures.push({ what: 'avatar', roomId, error: '见日志' });
+        if (spaceId && typeof ops.addRoomToSpace === 'function') {
+            const added = await ensureRoomInSpace(spaceId, roomId, ops, logger);
+            if (added)
+                result.childrenAdded.push(roomId);
+            else
+                result.failures.push({ what: 'child', roomId, error: '见日志' });
+        }
+    }
+    // 版本只在整趟都没失败时记:否则没铺到的房间会永远失去重铺机会
+    if (result.failures.length === 0)
+        state.avatarPoolVersion = AVATAR_POOL_VERSION;
+    return result;
+}
+//# sourceMappingURL=space-sync.js.map

package/dist/bridge/space-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"space-sync.js","sourceRoot":"","sources":["../../src/bridge/space-sync.ts"],"names":[],"mappings":"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"}

package/dist/bridge/turn-commands.d.ts

@@ -0,0 +1,28 @@
+/**
+ * T3 回合控制命令表:/stop /queue /interrupt /last。
+ *
+ * UX 移植自 pi-courier src/rpc/command-map.ts(🛑→⏹️ 换 DSH cancel 语义),
+ * 独立成文件避免与 T2 的桥命令表(src/bridge/commands.ts)冲突;主代理合并时
+ * 可把本表的 switch 并进总表,`handleTurnCommand(name, args, ctx)` 即入口契约。
+ *
+ * 返回约定:
+ *   string     → 命令已处理,调用方(pipeline)把文本作为回帖发出
+ *   undefined  → 不是回合命令(未知斜杠/普通文本),走既有消息流(steer/prompt)
+ */
+import type { SessionHandle } from '../ports/backend.ts';
+export interface TurnCommandContext {
+    session: SessionHandle;
+}
+export interface ParsedCommand {
+    /** 含前导 '/',全小写化前的原样名字 */
+    name: string;
+    /** 首个空格之后的参数(已 trim) */
+    args: string;
+}
+/** "/name args…" 的极简解析;非斜杠开头的文本返回 undefined。 */
+export declare function parseTurnCommand(text: string): ParsedCommand | undefined;
+/** Names owned by this table (pipeline uses it to keep the T4 router from
+ * claiming /stop etc.). Values keep the leading slash, matching parseTurnCommand. */
+export declare const TURN_COMMANDS: ReadonlySet<string>;
+export declare function handleTurnCommand(name: string, args: string, ctx: TurnCommandContext): Promise<string | undefined>;
+//# sourceMappingURL=turn-commands.d.ts.map

package/dist/bridge/turn-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-commands.d.ts","sourceRoot":"","sources":["../../src/bridge/turn-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAc,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAEpE,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,aAAa,CAAA;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,gDAAgD;AAChD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAOxE;AAyCD;qFACqF;AACrF,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,MAAM,CAAiE,CAAA;AAE/G,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA0C7B"}