@barryfan2045/dsh-matrix 0.1.0

package/dist/matrix/transport.js

@@ -0,0 +1,510 @@
+/**
+ * Matrix transport: implements the Transport port over matrix-bot-sdk.
+ * Ported essentials from pi-courier src/transports/matrix.ts + matrix-utils.ts
+ * (MIT), with the spike-verified fixes (docs §7, §9):
+ *  - login with password → cache user_id (getUserId() is undefined pre-sync)
+ *  - skip history replayed by the initial sync via an origin_server_ts cut
+ *  - skip edits (m.new_content), notices, empty bodies, our own messages
+ *
+ * The SDK surface is behind a factory so seam tests inject a fake client.
+ */
+import { MatrixClient, AutojoinRoomsMixin, SimpleFsStorageProvider } from 'matrix-bot-sdk';
+import { MediaTooLargeError } from "../ports/attachments.js";
+import { translateRoomEvent } from "./matrix-events.js";
+import { BOT_POWER_LEVEL } from "../bridge/power-levels.js";
+import { createCryptoHealth } from "../bridge/crypto-health.js";
+/** T8 defaults: room-member facts are cached, >2 members means a group. */
+export const MEMBER_COUNT_TTL_MS = 60_000;
+/** Localpart of an MXID (@user:server → user). */
+function extractLocalpart(userId) {
+    return userId.replace(/^@/, '').replace(/:.*$/, '');
+}
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/** Mention check (pi-courier matrix-utils port): full MXID text or @localpart word. */
+function wasBotMentioned(text, botUserId) {
+    if (botUserId && text.includes(botUserId))
+        return true;
+    const localpart = extractLocalpart(botUserId);
+    if (!localpart)
+        return false;
+    return new RegExp(`@${escapeRegExp(localpart)}\\b`, 'i').test(text);
+}
+/** Strip bot mention tokens, symmetric with wasBotMentioned. */
+function stripBotMention(text, botUserId) {
+    if (!botUserId)
+        return text;
+    const localpart = extractLocalpart(botUserId);
+    let out = text.replace(new RegExp(escapeRegExp(botUserId), 'g'), '');
+    if (localpart)
+        out = out.replace(new RegExp(`@${escapeRegExp(localpart)}\\b`, 'gi'), '');
+    return out.trim();
+}
+export class MatrixTransport {
+    opts;
+    handlers = [];
+    joinHandlers = [];
+    client;
+    botUserId = '';
+    accessToken;
+    connectedAt = 0;
+    loggerRef;
+    now;
+    /** roomId → member count snapshot with fetch timestamp (T8). */
+    memberCache = new Map();
+    /** T13:解密健康观测(失败到阈值告警一次,成功则重置);start() 时按 logger 建。 */
+    cryptoHealth;
+    /**
+     * T6: mxc → 加密附件块 + 事件声明的 mimetype(translate 层填充)。
+     * downloadMedia 用它决定是否走 decryptMedia;有界 FIFO,防无界增长。
+     */
+    mediaHints = new Map();
+    mediaHintOrder = [];
+    constructor(opts) {
+        this.opts = opts;
+        this.accessToken = opts.accessToken ?? '';
+        this.now = opts.now ?? Date.now;
+    }
+    /** translate 层登记一条媒体事件的下载提示(E2EE 块 / 声明类型)。 */
+    noteMediaHint(mxc, hint) {
+        if (!this.mediaHints.has(mxc)) {
+            this.mediaHintOrder.push(mxc);
+            if (this.mediaHintOrder.length > 200) {
+                const drop = this.mediaHintOrder.splice(0, this.mediaHintOrder.length - 200);
+                for (const k of drop)
+                    this.mediaHints.delete(k);
+            }
+        }
+        this.mediaHints.set(mxc, hint);
+    }
+    onIncoming(handler) {
+        this.handlers.push(handler);
+        return () => {
+            const i = this.handlers.indexOf(handler);
+            if (i >= 0)
+                this.handlers.splice(i, 1);
+        };
+    }
+    /** T8: notified when the bot joins a room, with the group verdict. */
+    onRoomJoin(handler) {
+        this.joinHandlers.push(handler);
+        return () => {
+            const i = this.joinHandlers.indexOf(handler);
+            if (i >= 0)
+                this.joinHandlers.splice(i, 1);
+        };
+    }
+    async start(logger) {
+        this.loggerRef = logger;
+        this.cryptoHealth = this.opts.cryptoHealth ?? createCryptoHealth({ logger });
+        // T14:**crypto 存储必须在登录之前就位**,因为登录要带上它的 deviceId。
+        // 为什么:密码登录不带 device_id 时,Synapse 每次都会**新建一个设备**;而
+        // OlmMachine 仍然以存储里那个旧 deviceId 自居。于是两边分叉 ——
+        //   · 上传的 device keys 挂在旧设备上 → 发送方把房间密钥加密给旧设备;
+        //   · /sync 拿的却是新设备的 access_token → to-device 的密钥永远送不到。
+        // 症状就是那句 "Can't find the room key to decrypt the event, withheld code: None",
+        // 而且全程无声无息(桥照常启动、照常打 E2EE 已启用)。
+        const providers = await this.buildProviders(logger);
+        const storedDeviceId = await readStoredDeviceId(providers);
+        if (!this.accessToken) {
+            const { username, password, homeserver } = this.opts;
+            if (!username || !password)
+                throw new Error('dsh-matrix matrix: 无 accessToken 时需要 username+password');
+            const doFetch = this.opts.fetchImpl ?? fetch;
+            const res = await doFetch(`${homeserver.replace(/\/$/, '')}/_matrix/client/v3/login`, {
+                method: 'POST',
+                headers: { 'content-type': 'application/json' },
+                body: JSON.stringify({
+                    type: 'm.login.password',
+                    identifier: { type: 'm.id.user', user: username },
+                    password,
+                    // 复用存储里的设备身份:重启不再造新设备,E2EE 身份也就不会每次漂移
+                    ...(storedDeviceId ? { device_id: storedDeviceId } : {}),
+                }),
+            });
+            const login = (await res.json());
+            if (!login.access_token)
+                throw new Error(`dsh-matrix matrix login 失败: ${JSON.stringify(login)}`);
+            this.accessToken = login.access_token;
+            this.botUserId = login.user_id ?? '';
+            logger.info(`matrix 登录成功: ${this.botUserId}${storedDeviceId ? `(复用设备 ${storedDeviceId})` : ''}`);
+            // 服务端理论上会照办;真没照办就必须当场可见,否则又是"静默解不开"
+            if (storedDeviceId && login.device_id && login.device_id !== storedDeviceId) {
+                logger.warn(`matrix E2EE 设备身份不一致:存储是 ${storedDeviceId},登录拿到 ${login.device_id}。` +
+                    '加密房间会收不到消息,请跑 `dsh-matrix reset-crypto` 复位存储。');
+            }
+        }
+        const factory = this.opts.clientFactory ?? defaultClientFactory;
+        const client = factory(this.opts.homeserver, this.accessToken, providers);
+        this.client = client;
+        client.on('room.message', (roomId, event) => {
+            // T8: translation is async (member-count lookup); dispatch on settle.
+            void this.translate(roomId, event)
+                .then((translated) => {
+                if (!translated)
+                    return;
+                for (const h of [...this.handlers]) {
+                    try {
+                        void Promise.resolve(h(translated)).catch((error) => logger.warn('incoming handler:', error));
+                    }
+                    catch (error) {
+                        logger.warn('incoming handler:', error);
+                    }
+                }
+            })
+                .catch((error) => logger.warn('event translate:', error));
+        });
+        client.on('room.join', (roomId, event) => {
+            // Initial sync replays old joins: only act on fresh ones (same 2s slack
+            // as room.message). Group-room join hints are bridge policy, not ours.
+            const ts = typeof event?.origin_server_ts === 'number' ? event.origin_server_ts : this.now();
+            if (ts < this.connectedAt)
+                return;
+            void this.resolveIsGroup(roomId)
+                .then((isGroup) => {
+                for (const h of [...this.joinHandlers]) {
+                    try {
+                        h(roomId, isGroup);
+                    }
+                    catch (error) {
+                        logger.warn('join handler:', error);
+                    }
+                }
+            })
+                .catch((error) => logger.warn('room join:', error));
+        });
+        // T13:crypto 健康。SDK 对解密失败/成功各有一个一等公民事件,直接数,不猜。
+        client.on('room.failed_decryption', (roomId, event) => {
+            this.cryptoHealth.onFailedDecryption(roomId, typeof event?.event_id === 'string' ? event.event_id : undefined);
+        });
+        client.on('room.decrypted_event', (roomId, event) => {
+            if (event?.type === 'm.room.message')
+                this.cryptoHealth.onDecrypted(roomId);
+        });
+        // 成员变动会让"是不是群"的判定作废:有人在房里加入/退出时立刻删掉缓存。
+        // 否则一个刚变成 3 人的房间会在 TTL(60s)内继续被当成私聊 —— 群闸门被整个
+        // 绕过,未被 @ 的群消息会直接进模型(实测踩到:bot 进群时 2 人,第三人加入后
+        // 群消息被当私聊回答)。只认 m.room.member,避免把每条消息都变成一次 HTTP。
+        client.on('room.event', (roomId, event) => {
+            if (event?.type === 'm.room.member')
+                this.memberCache.delete(roomId);
+        });
+        // 初始同步会重放历史事件:只接受启动(留 2s 时钟容差)之后的新消息
+        this.connectedAt = this.now() - 2000;
+        await client.start();
+        // accessToken 直连时 login 响应缺席,问一次 client 拿 bot MXID(best effort)
+        if (!this.botUserId && typeof client.getUserId === 'function') {
+            try {
+                this.botUserId = await client.getUserId();
+            }
+            catch { /* pre-sync: mention detection degrades to body fallback */ }
+        }
+        // T14 兜底体检:accessToken 直连也走同一条分叉(存储设备 ≠ token 设备)。
+        // 这里只报警不擅自复位 —— 复位会换设备身份,必须由人显式决定(T13 §4)。
+        await this.warnOnDeviceMismatch(client, storedDeviceId, logger);
+    }
+    /** 持久化 sync 状态(重启不再全量重放)+ 可选 E2EE(失败降级明文)。 */
+    async buildProviders(logger) {
+        const providers = {};
+        if (this.opts.storePath) {
+            providers.storage = new SimpleFsStorageProvider(this.opts.storePath);
+        }
+        if (this.opts.encryption !== false && this.opts.cryptoPath) {
+            try {
+                const { RustSdkCryptoStorageProvider } = await import('matrix-bot-sdk');
+                const { StoreType } = await import('@matrix-org/matrix-sdk-crypto-nodejs');
+                const mkdirSync = (await import('node:fs')).mkdirSync;
+                mkdirSync(this.opts.cryptoPath, { recursive: true });
+                providers.crypto = new RustSdkCryptoStorageProvider(this.opts.cryptoPath, 0 /* StoreType.Sqlite */);
+                logger.info(`E2EE 已启用(crypto: ${this.opts.cryptoPath})`);
+            }
+            catch (error) {
+                logger.warn('E2EE 不可用,降级为明文:', error instanceof Error ? error.message : error);
+            }
+        }
+        return providers;
+    }
+    /**
+     * T14:校验"crypto 存储的设备"与"access_token 所属设备"是否同一个。
+     * 不一致 = 加密房必然收不到消息(见 start() 的长注释),所以必须吼一声。
+     * best-effort:任何失败都只是放弃体检,绝不影响启动。
+     */
+    async warnOnDeviceMismatch(client, storedDeviceId, logger) {
+        if (!storedDeviceId || typeof client.getWhoAmI !== 'function')
+            return;
+        try {
+            const who = await client.getWhoAmI();
+            const tokenDevice = typeof who?.device_id === 'string' ? who.device_id : '';
+            if (!tokenDevice || tokenDevice === storedDeviceId)
+                return;
+            logger.warn(`matrix E2EE 设备身份分叉:crypto 存储是 ${storedDeviceId},access_token 属于 ${tokenDevice}。` +
+                '加密房间的消息会因为拿不到房间密钥而收不到;请跑 `dsh-matrix reset-crypto` 复位存储,' +
+                '或改用不带 accessToken 的密码登录(登录会自动复用存储里的设备)。');
+        }
+        catch {
+            /* 体检失败不影响启动 */
+        }
+    }
+    /**
+     * T8: group fact = more than two joined members (bot + one other is a DM).
+     * Cached per room for memberTtlMs so the hot path never hits the API;
+     * any failure defaults to DM (skips the group gate, never the reverse).
+     */
+    async resolveIsGroup(roomId) {
+        const client = this.client;
+        if (!client?.getJoinedRoomMembers)
+            return false;
+        const now = this.now();
+        const ttl = this.opts.memberTtlMs ?? MEMBER_COUNT_TTL_MS;
+        const hit = this.memberCache.get(roomId);
+        if (hit && now - hit.at < ttl)
+            return hit.count > 2;
+        try {
+            const members = await client.getJoinedRoomMembers(roomId);
+            const count = Array.isArray(members) ? members.length : 2;
+            this.memberCache.set(roomId, { count, at: now });
+            return count > 2;
+        }
+        catch {
+            return false; // 不缓存失败:下一条消息重试
+        }
+    }
+    /**
+     * Unified translation: T6 pure event semantics (text/media/unsupported +
+     * self/replay/edit guards) THEN T8 group facts (isGroup via member count,
+     * mention detect+strip, replyTo). null = skip silently by design.
+     */
+    async translate(roomId, event) {
+        const { message, warn } = translateRoomEvent({
+            botUserId: this.botUserId,
+            connectedAt: this.connectedAt,
+            now: this.now,
+            noteMediaHint: (mxc, hint) => this.noteMediaHint(mxc, hint),
+        }, roomId, event);
+        if (warn)
+            this.loggerRef?.warn(`matrix: ${warn}`);
+        if (!message)
+            return null;
+        // ── T8 group facts ─────────────────────────────────────────────
+        const isGroup = await this.resolveIsGroup(roomId);
+        let mentionsBot = false;
+        let text = message.text;
+        if (isGroup && text) {
+            const content = (event.content ?? {});
+            const ids = content['m.mentions']?.user_ids;
+            mentionsBot = this.botUserId !== '' && Array.isArray(ids) && ids.includes(this.botUserId);
+            if (!mentionsBot)
+                mentionsBot = wasBotMentioned(text, this.botUserId);
+            if (mentionsBot && this.botUserId) {
+                text = stripBotMention(text, this.botUserId);
+                if (!text)
+                    return null; // 光@不说事:无事发生
+            }
+        }
+        const relates = (event.content?.['m.relates_to'] ?? {});
+        const replyEventId = relates['m.in_reply_to']?.event_id;
+        return {
+            ...message,
+            text,
+            isDm: !isGroup,
+            isGroup,
+            mentionsBot,
+            ...(typeof replyEventId === 'string' && replyEventId ? { replyTo: { eventId: replyEventId } } : {}),
+        };
+    }
+    async send(roomId, text) {
+        return this.requireClient().sendMessage(roomId, { msgtype: 'm.text', body: text });
+    }
+    async notify(roomId, text) {
+        return this.requireClient().sendMessage(roomId, { msgtype: 'm.notice', body: text });
+    }
+    async edit(roomId, editId, text) {
+        // Matrix rich edits: an m.replace relation carrying full new content.
+        await this.requireClient().sendMessage(roomId, {
+            msgtype: 'm.text',
+            body: `* ${text.slice(0, 80)}`,
+            'm.new_content': { msgtype: 'm.text', body: text },
+            'm.relates_to': { rel_type: 'm.replace', event_id: editId },
+        });
+    }
+    /**
+     * T6: download one mxc payload (E2EE-decrypted when the event carried an
+     * encrypted file block, see noteMediaHint). Throws a room-ready message on
+     * transport failure, MediaTooLargeError when the REAL bytes exceed the cap.
+     */
+    async downloadMedia(mxc, maxSizeBytes) {
+        const client = this.requireClient();
+        if (!client.downloadContent)
+            throw new Error('当前 Matrix 客户端不支持内容下载');
+        const hint = this.mediaHints.get(mxc);
+        // 先拒"需要解密但没有 crypto":省一次必然无用的下载。
+        if (hint?.file && !client.crypto) {
+            throw new Error('加密附件需要启用 E2EE(本部署未开启 crypto)');
+        }
+        let data;
+        let contentType;
+        try {
+            const res = await client.downloadContent(mxc, true);
+            data = hint?.file ? await client.crypto.decryptMedia(hint.file) : res.data;
+            contentType = res.contentType;
+        }
+        catch (error) {
+            if (error instanceof MediaTooLargeError)
+                throw error;
+            throw new Error(`附件下载失败: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        if (data.length > maxSizeBytes)
+            throw new MediaTooLargeError(data.length, maxSizeBytes);
+        // E2EE 下载 contentType 恒为 application/octet-stream:事件声明的
+        // info.mimetype 是唯一可信来源(明文路径以真实响应头为准)。
+        const mimeType = hint?.file && hint.mimeType ? hint.mimeType : contentType;
+        return {
+            bytes: new Uint8Array(data),
+            mimeType,
+        };
+    }
+    async stop() {
+        const client = this.client;
+        this.client = undefined;
+        if (!client)
+            return;
+        try {
+            client.stop();
+        }
+        catch { /* idempotent */ }
+    }
+    // ── T9 房间操作(移植 pi-courier matrix-rooms.ts 的最小子集) ──────────────
+    /** 建私有项目/管理房间:名字 + 邀请(preset=private_chat 让受邀者自动可见)。 */
+    async createRoom(opts) {
+        return this.requireClient().createRoom({
+            name: opts.name,
+            invite: [opts.inviteUserId],
+            preset: 'private_chat',
+            visibility: 'private',
+            ...this.botPowerOverride(),
+        });
+    }
+    /**
+     * 桥建自己的房间时,把自己的 PL 放到 101(用户仍是 100)。
+     * 不这样,Matrix 不允许桥改动"与自己同级"的人 —— `/revoke` 就降不动那些 100 的
+     * trusted 用户(M_FORBIDDEN: … equal to your own)。bot MXID 未知时不写。
+     */
+    botPowerOverride() {
+        if (!this.botUserId)
+            return {};
+        return { power_level_content_override: { users: { [this.botUserId]: BOT_POWER_LEVEL } } };
+    }
+    /** 设置房间显示名(m.room.name 状态事件,state_key 空串)。 */
+    async setRoomName(roomId, name) {
+        await this.requireClient().sendStateEvent(roomId, 'm.room.name', '', { name });
+    }
+    /** 设置用户权限等级(矩阵 SDK 参数序是 user,room,level)。 */
+    async setUserPowerLevel(roomId, userId, level) {
+        await this.requireClient().setUserPowerLevel(userId, roomId, level);
+    }
+    /**
+     * T12(US37):读某人在该房间的权限等级。
+     *
+     * 读 m.room.power_levels 状态事件:先看 users[userId],再回落 users_default,
+     * 最后回落 0(没有该状态事件也按 0 算)。提权前必须先读,否则没法区分"这个人
+     * 是我们提上来的"还是"管理员自己给的"。
+     */
+    async getUserPowerLevel(roomId, userId) {
+        const client = this.requireClient();
+        let content;
+        try {
+            content = await client.getRoomStateEvent(roomId, 'm.room.power_levels', '');
+        }
+        catch {
+            content = undefined; // 房间还没有 PL 状态事件:按默认 0 算
+        }
+        const users = (content?.users ?? {});
+        const own = users[userId];
+        if (typeof own === 'number')
+            return own;
+        const fallback = content?.users_default;
+        return typeof fallback === 'number' ? fallback : 0;
+    }
+    /** 独立邀请(SDK createRoom 已带 invite 时不必调,留给管理房补拉人等场景)。 */
+    async inviteUser(roomId, userId) {
+        await this.requireClient().inviteUser(userId, roomId);
+    }
+    // ── T12 空间与头像(US38) ────────────────────────────────────────────────
+    /** 建 space:私有 + `creation_content: {type:'m.space'}`(Matrix 的 space 标记)。 */
+    async createSpace(opts) {
+        return this.requireClient().createRoom({
+            name: opts.name,
+            ...(opts.inviteUserId ? { invite: [opts.inviteUserId] } : {}),
+            preset: 'private_chat',
+            visibility: 'private',
+            creation_content: { type: 'm.space' },
+            ...this.botPowerOverride(),
+        });
+    }
+    /** 读房间头像;没设过(或读不到)返回 undefined —— 调用方据此决定"补挂"。 */
+    async getRoomAvatar(roomId) {
+        const client = this.requireClient();
+        let content;
+        try {
+            content = await client.getRoomStateEvent(roomId, 'm.room.avatar', '');
+        }
+        catch {
+            return undefined;
+        }
+        if (!content)
+            return undefined;
+        const url = typeof content.url === 'string' ? content.url : undefined;
+        const info = typeof content.info === 'object' && content.info !== null
+            ? content.info
+            : undefined;
+        return { ...(url ? { url } : {}), ...(info ? { info } : {}) };
+    }
+    /** 设房间头像:先传图拿 mxc,再发 m.room.avatar(带 info 让客户端有尺寸可用)。 */
+    async setRoomAvatar(roomId, png, info) {
+        const client = this.requireClient();
+        const mxc = await client.uploadContent(png, 'image/png', 'avatar.png');
+        await client.sendStateEvent(roomId, 'm.room.avatar', '', { url: mxc, ...(info ? { info } : {}) });
+    }
+    /**
+     * 把房间挂进 space:在 **space** 里发 `m.space.child`,state_key 是房间 ID。
+     * `via` 缺省从房间 ID 的 server 部分取(加入该 space 的客户端据此找房间)。
+     */
+    async addRoomToSpace(spaceId, roomId, via) {
+        const client = this.requireClient();
+        const server = via ?? roomId.split(':')[1] ?? '';
+        await client.sendStateEvent(spaceId, 'm.space.child', roomId, { via: server ? [server] : [] });
+    }
+    /** 桥账号 MXID(密码登录时从 login 响应缓存;未知 → undefined)。 */
+    getBotUserId() {
+        return this.botUserId || undefined;
+    }
+    requireClient() {
+        if (!this.client)
+            throw new Error('dsh-matrix matrix transport 未启动');
+        return this.client;
+    }
+}
+function defaultClientFactory(homeserver, accessToken, providers) {
+    if (!providers.storage)
+        throw new Error('dsh-matrix: 生产 MatrixClient 需要 storePath(避免重启全量重放)');
+    const client = new MatrixClient(homeserver, accessToken, providers.storage, providers.crypto);
+    AutojoinRoomsMixin.setupOnClient(client);
+    return client;
+}
+/**
+ * T14:crypto 存储里记着的设备身份(没有则 undefined = 全新库,由 SDK 自己认领)。
+ * 读失败按"不知道"处理:登录退回不带 device_id 的旧行为,不会因此起不来。
+ */
+async function readStoredDeviceId(providers) {
+    if (!providers.crypto?.getDeviceId)
+        return undefined;
+    try {
+        const stored = await providers.crypto.getDeviceId();
+        return typeof stored === 'string' && stored ? stored : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/matrix/transport.js.map

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

package/dist/ports/attachments.d.ts

@@ -0,0 +1,51 @@
+/**
+ * T6 attachment vocabulary (spec US25-29, 实现决策 9).
+ *
+ * Kept transport-flavored on purpose: the Matrix msgtype/mxc naming is the
+ * agreed port shape (the only real transport is Matrix), while the bridge
+ * core only ever sees these plain data types - never an SDK object.
+ */
+/** Matrix msgtypes whose content carries a downloadable media payload. */
+export type MediaMsgtype = 'm.image' | 'm.file' | 'm.audio' | 'm.video' | 'm.sticker';
+export declare function isMediaMsgtype(value: unknown): value is MediaMsgtype;
+/** One media payload referenced by an inbound message (not yet downloaded). */
+export interface MediaIncoming {
+    /** mxc:// content URI - the download address (encrypted `file.url` wins). */
+    readonly mxc: string;
+    readonly msgtype: MediaMsgtype;
+    /** Original event body - Element puts the filename here for media. */
+    readonly filename?: string;
+    /** Declared info.size: a pre-check hint only, never trusted (servers lie). */
+    readonly size?: number;
+    /** Raw event body kept for diagnostics (usually identical to filename). */
+    readonly body: string;
+}
+/** Result of one Transport.downloadMedia call (post-decryption bytes). */
+export interface MediaDownload {
+    readonly bytes: Uint8Array;
+    /** Content type reported by the homeserver (info.mimetype is not authoritative). */
+    readonly mimeType: string;
+    readonly filename?: string;
+}
+/**
+ * One ledger attachment, already classified for the prompt path:
+ * 'image' → into the model as a native image block;
+ * 'file'  → persisted verbatim, the model sees the saved path.
+ */
+export interface PreparedAttachment {
+    readonly kind: 'image' | 'file';
+    readonly bytes: Uint8Array;
+    readonly mimeType: string;
+    readonly filename?: string;
+}
+/**
+ * Thrown by Transport.downloadMedia when the REAL downloaded bytes exceed the
+ * caller's cap. A distinct error so the bridge answers with the size refusal
+ * receipt instead of a generic download failure.
+ */
+export declare class MediaTooLargeError extends Error {
+    readonly bytes: number;
+    readonly maxBytes: number;
+    constructor(bytes: number, maxBytes: number);
+}
+//# sourceMappingURL=attachments.d.ts.map

package/dist/ports/attachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../../src/ports/attachments.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,0EAA0E;AAC1E,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,CAAA;AAIrF,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAEpE;AAED,+EAA+E;AAC/E,MAAM,WAAW,aAAa;IAC5B,6EAA6E;IAC7E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;IAC9B,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B,oFAAoF;IACpF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;aACf,KAAK,EAAE,MAAM;aAAkB,QAAQ,EAAE,MAAM;gBAA/C,KAAK,EAAE,MAAM,EAAkB,QAAQ,EAAE,MAAM;CAI5E"}

package/dist/ports/attachments.js

@@ -0,0 +1,27 @@
+/**
+ * T6 attachment vocabulary (spec US25-29, 实现决策 9).
+ *
+ * Kept transport-flavored on purpose: the Matrix msgtype/mxc naming is the
+ * agreed port shape (the only real transport is Matrix), while the bridge
+ * core only ever sees these plain data types - never an SDK object.
+ */
+const MEDIA_MSGTYPES = ['m.image', 'm.file', 'm.audio', 'm.video', 'm.sticker'];
+export function isMediaMsgtype(value) {
+    return MEDIA_MSGTYPES.includes(value);
+}
+/**
+ * Thrown by Transport.downloadMedia when the REAL downloaded bytes exceed the
+ * caller's cap. A distinct error so the bridge answers with the size refusal
+ * receipt instead of a generic download failure.
+ */
+export class MediaTooLargeError extends Error {
+    bytes;
+    maxBytes;
+    constructor(bytes, maxBytes) {
+        super(`下载内容 ${bytes} 字节超过上限 ${maxBytes} 字节`);
+        this.bytes = bytes;
+        this.maxBytes = maxBytes;
+        this.name = 'MediaTooLargeError';
+    }
+}
+//# sourceMappingURL=attachments.js.map

package/dist/ports/attachments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.js","sourceRoot":"","sources":["../../src/ports/attachments.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,cAAc,GAAsB,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,CAAC,CAAA;AAElG,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,cAAc,CAAC,QAAQ,CAAC,KAAe,CAAC,CAAA;AACjD,CAAC;AAmCD;;;;GAIG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IACf;IAA+B;IAA3D,YAA4B,KAAa,EAAkB,QAAgB;QACzE,KAAK,CAAC,QAAQ,KAAK,WAAW,QAAQ,KAAK,CAAC,CAAA;QADlB,UAAK,GAAL,KAAK,CAAQ;QAAkB,aAAQ,GAAR,QAAQ,CAAQ;QAEzE,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAA;IAClC,CAAC;CACF"}