@excitedjs/dreamux 0.1.1

package/dist/dispatcher/turn-manager.js

@@ -0,0 +1,167 @@
+/**
+ * Per-dispatcher FIFO turn worker.
+ *
+ * Issue #2 §"Codex 协议处理": the queue worker is the single executor for one
+ * dispatcher's Codex thread. Holds an in-memory FIFO; pulls from
+ * `inbound_buffer` lazily so we never lose messages across crashes.
+ *
+ * State machine (transitions are the only ones this worker performs):
+ *   queued
+ *     └─[worker]→ running
+ *           └─[turn/completed]→ awaiting_outbound
+ *                   ├─[feishu send OK]→ completed
+ *                   └─[feishu send fail]→ outbound_failed → retry → completed
+ *           └─[turn/start RPC failure]→ failed
+ *
+ * Server crash recovery is handled separately by `recoverDispatcher()`:
+ *   running          → unknown (at-most-once, see issue #2 §"崩溃与异常恢复")
+ *   awaiting_outbound → safe to retry the outbound
+ *   outbound_failed   → safe to retry the outbound
+ */
+import { extractAssistantText, runTurn } from '../codex/events.js';
+export class TurnManager {
+    opts;
+    running = false;
+    stopped = false;
+    wakeup = null;
+    log;
+    outboundRetries;
+    outboundRetryDelayMs;
+    emptyTurnPlaceholder;
+    constructor(opts) {
+        this.opts = opts;
+        this.log = opts.log ?? ((lvl, msg, err) => {
+            const prefix = `[turn-manager ${opts.dispatcherId}] ${lvl}`;
+            if (err !== undefined)
+                console.error(prefix, msg, err);
+            else
+                console.error(prefix, msg);
+        });
+        this.outboundRetries = opts.outboundRetries ?? 3;
+        this.outboundRetryDelayMs = opts.outboundRetryDelayMs ?? 1000;
+        this.emptyTurnPlaceholder =
+            opts.emptyTurnPlaceholder ?? '本轮没有文本回复。';
+    }
+    /**
+     * Notify the worker that new work may be available.
+     * Idempotent — multiple wakeups collapse into the next loop iteration.
+     */
+    notify() {
+        if (this.stopped)
+            return;
+        if (this.wakeup !== null) {
+            const w = this.wakeup;
+            this.wakeup = null;
+            w();
+        }
+        void this.drainLoop();
+    }
+    /** Drain queued rows until the queue is empty or we're stopped. */
+    async drainLoop() {
+        if (this.running)
+            return;
+        this.running = true;
+        try {
+            while (!this.stopped) {
+                const row = this.opts.inbound.takeNextQueued(this.opts.dispatcherId);
+                if (row === null) {
+                    await this.waitForNotify();
+                    if (this.stopped)
+                        return;
+                    continue;
+                }
+                await this.processInbound(row);
+            }
+        }
+        finally {
+            this.running = false;
+        }
+    }
+    waitForNotify() {
+        return new Promise((res) => {
+            this.wakeup = res;
+        });
+    }
+    async processInbound(row) {
+        const threadId = this.opts.getThreadId();
+        if (threadId === null) {
+            // Should not happen — dispatcher is "ready" only after thread is set.
+            this.log('error', `inbound row ${row.id} dequeued without thread_id`);
+            this.opts.inbound.markFailed(row.id, 'dispatcher has no thread_id');
+            return;
+        }
+        // Mark running first (before turn/start) so a crash mid-RPC still
+        // leaves a recoverable trace.
+        this.opts.inbound.markRunning(row.id, null);
+        let assistantText;
+        try {
+            const turn = await runTurn(this.opts.client, threadId, row.parsed_text, this.opts.turnCwd ?? null);
+            // Record the turn id for diagnostics — non-fatal if this column
+            // can't be updated (e.g. row was already advanced by another path).
+            this.opts.inbound.markRunning(row.id, turn.turnId);
+            assistantText =
+                extractAssistantText(turn) ?? this.emptyTurnPlaceholder;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            this.log('error', `turn execution failed for inbound ${row.id}: ${msg}`);
+            this.opts.inbound.markFailed(row.id, msg);
+            // Best-effort tell the user something went wrong.
+            try {
+                await this.opts.outbound.sendText(row.source_chat_id, `本次请求执行失败：${msg}`);
+            }
+            catch (sendErr) {
+                this.log('warn', `error notification also failed`, sendErr);
+            }
+            return;
+        }
+        this.opts.inbound.markAwaitingOutbound(row.id, assistantText);
+        await this.sendOutbound(row.id, row.source_chat_id, assistantText);
+    }
+    /** Send assistant text to feishu with bounded retry. */
+    async sendOutbound(inboundId, chatId, text) {
+        let lastError;
+        for (let attempt = 0; attempt <= this.outboundRetries; attempt++) {
+            try {
+                const ids = await this.opts.outbound.sendText(chatId, text);
+                this.opts.inbound.markCompleted(inboundId, ids);
+                return;
+            }
+            catch (err) {
+                lastError = err;
+                if (attempt < this.outboundRetries) {
+                    await new Promise((r) => setTimeout(r, this.outboundRetryDelayMs));
+                }
+            }
+        }
+        const msg = lastError instanceof Error ? lastError.message : String(lastError);
+        this.log('error', `outbound send failed for inbound ${inboundId}: ${msg}`);
+        this.opts.inbound.markOutboundFailed(inboundId, msg);
+    }
+    /**
+     * Retry rows previously left in awaiting_outbound / outbound_failed
+     * (no Codex turn re-runs — assistant_text is already in the DB).
+     * Called once at dispatcher startup, after thread/resume succeeds.
+     */
+    async retryPendingOutbound() {
+        const pending = this.opts.inbound.listAwaitingOrFailedOutbound(this.opts.dispatcherId);
+        for (const row of pending) {
+            if (row.assistant_text === null) {
+                // Should not happen — awaiting_outbound implies assistant_text was set.
+                this.log('warn', `pending outbound ${row.id} has no assistant_text; marking failed`);
+                this.opts.inbound.markFailed(row.id, 'awaiting_outbound row missing assistant_text');
+                continue;
+            }
+            await this.sendOutbound(row.id, row.source_chat_id, row.assistant_text);
+        }
+    }
+    async stop() {
+        this.stopped = true;
+        if (this.wakeup !== null) {
+            const w = this.wakeup;
+            this.wakeup = null;
+            w();
+        }
+    }
+}
+//# sourceMappingURL=turn-manager.js.map

package/dist/dispatcher/turn-manager.js.map

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

package/dist/feishu/bot.js

@@ -0,0 +1,137 @@
+/**
+ * The `FeishuBot` adapter — one per Dispatcher (D3: 1 Dispatcher = 1 Bot).
+ *
+ * Since issue #25 PR1 this is a thin adapter over `@excitedjs/feishu-transport`
+ * (the shared platform-I/O core): all Feishu SDK I/O — the inbound WebSocket,
+ * markdown→card render, content parse, the outbound message API — lives in the
+ * core, the single importer of `@larksuiteoapi/node-sdk`. This file only shapes
+ * the core's surface into the `FeishuBot` interface the server already wires:
+ *   - `start(handler)` registers the `im.message.receive_v1` route, normalizes
+ *     each raw event with the core's `parseInbound`, and forwards a
+ *     `FeishuInboundEvent`. The route handler awaits `handler`, so the message is
+ *     durably enqueued before the SDK acks (the deferred-ACK invariant).
+ *   - `sendText(chatId, text)` delegates to the core's `send({ chatId }, text)`.
+ *     The per-card size guard and the multi-card split both live in the core now.
+ *   - `botOpenId` surfaces the core transport's `selfId`.
+ *
+ * Tests inject a `FakeFeishuBot` via `createFakeFeishuBot()` instead of opening
+ * a live connection.
+ */
+import { createFeishuTransport, parseInbound, } from '@excitedjs/feishu-transport';
+/** The Feishu event_type carrying inbound chat messages. */
+const IM_MESSAGE_EVENT_TYPE = 'im.message.receive_v1';
+export function createFeishuBot(opts) {
+    const transport = createFeishuTransport({
+        appId: opts.appId,
+        appSecret: opts.appSecret,
+    });
+    return {
+        get appId() {
+            return transport.appId;
+        },
+        get botOpenId() {
+            return transport.selfId;
+        },
+        async start(handler) {
+            // The core opens the WebSocket and awaits this route handler before the
+            // SDK acks; awaiting `handler` here keeps the enqueue durable-before-ACK.
+            // `start` rejects if the connection does not come up, so the server's
+            // try/catch can fail the dispatcher loudly rather than leave it dark.
+            await transport.start({
+                [IM_MESSAGE_EVENT_TYPE]: async (raw) => {
+                    const event = normalizeInboundEvent(raw);
+                    if (event === null)
+                        return;
+                    await handler(event);
+                },
+            });
+        },
+        async sendText(chatId, text) {
+            const { messageIds } = await transport.send({ chatId }, text);
+            return { messageIds };
+        },
+        close() {
+            return transport.close();
+        },
+    };
+}
+/**
+ * Reshape a raw `im.message.receive_v1` payload into a `FeishuInboundEvent`,
+ * using the core's `parseInbound` for the content→text flattening (incl. the
+ * `interactive`-card parse the old in-package copy had lost). Returns `null`
+ * for a payload missing the message_id or chat_id that make it routable.
+ */
+function normalizeInboundEvent(raw) {
+    if (!raw || typeof raw !== 'object')
+        return null;
+    const root = raw;
+    const event = (root['event'] ?? root);
+    const message = (event['message'] ?? {});
+    const sender = (event['sender'] ?? {});
+    const senderId = sender['sender_id']?.['open_id'] ?? '';
+    const messageId = message['message_id'] ?? '';
+    const chatId = message['chat_id'] ?? '';
+    const chatType = message['chat_type'] ?? '';
+    const messageType = message['message_type'] ?? '';
+    const rawContent = message['content'] ?? '';
+    const mentions = message['mentions'] ?? [];
+    const createTime = message['create_time'] ?? '';
+    if (messageId === '' || chatId === '')
+        return null;
+    const parsed = parseInbound({
+        message_type: messageType,
+        content: rawContent,
+        mentions,
+    });
+    return {
+        messageId,
+        chatId,
+        chatType,
+        senderId,
+        messageType,
+        rawContent,
+        parsedText: parsed.text,
+        mentions,
+        createTime,
+        raw,
+    };
+}
+export function createFakeFeishuBot(appId = 'fake_bot') {
+    const sent = [];
+    let handler = null;
+    let nextMessageId = 1;
+    let sendError = null;
+    const openId = `ou_${appId}`;
+    return {
+        appId,
+        get botOpenId() {
+            return openId;
+        },
+        async start(h) {
+            handler = h;
+        },
+        async sendText(chatId, text) {
+            if (sendError !== null) {
+                throw sendError;
+            }
+            const id = `om_fake_${nextMessageId++}`;
+            sent.push({ chatId, text, messageIds: [id] });
+            return { messageIds: [id] };
+        },
+        async close() {
+            handler = null;
+        },
+        get sentMessages() {
+            return sent;
+        },
+        async inject(event) {
+            if (handler === null)
+                throw new Error('fake bot not started');
+            await handler(event);
+        },
+        setSendError(err) {
+            sendError = err;
+        },
+    };
+}
+//# sourceMappingURL=bot.js.map

package/dist/feishu/bot.js.map

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

package/dist/feishu/content.js

@@ -0,0 +1,108 @@
+/**
+ * Parsing inbound Feishu message content.
+ *
+ * Feishu delivers `message.content` as a JSON-encoded string whose shape
+ * depends on `message_type`. This module turns that into the plain text the
+ * channel forwards to Claude. Attachment message types (image, file) are
+ * summarized as a short text marker — the channel forwards text, not binaries.
+ */
+/**
+ * Parse one inbound Feishu message into forwardable text. Never throws —
+ * malformed content falls back to a best-effort string so a weird message
+ * still reaches Claude.
+ */
+export function parseInbound(message) {
+    const type = message.message_type ?? 'unknown';
+    let parsed;
+    try {
+        parsed = JSON.parse(message.content ?? '');
+    }
+    catch {
+        return { text: message.content ?? '(unparseable message)' };
+    }
+    const content = (parsed && typeof parsed === 'object' ? parsed : {});
+    switch (type) {
+        case 'text': {
+            const text = typeof content.text === 'string' ? content.text : '';
+            return { text: applyMentions(text, message.mentions) };
+        }
+        case 'post':
+            return { text: extractPostText(content) };
+        case 'image':
+            return { text: '(image)' };
+        case 'file': {
+            const fileName = typeof content.file_name === 'string' ? content.file_name : 'unknown';
+            return { text: `(file: ${fileName})` };
+        }
+        default:
+            return { text: `(${type} message)` };
+    }
+}
+/**
+ * Replace Feishu's `@_user_N` placeholders in text with the mentioned display
+ * names, so the forwarded message reads naturally.
+ */
+export function applyMentions(text, mentions) {
+    if (!mentions)
+        return text;
+    let out = text;
+    for (const m of mentions) {
+        if (m.key && m.name) {
+            out = out.split(m.key).join(`@${m.name}`);
+        }
+    }
+    return out;
+}
+/**
+ * Flatten a Feishu rich-text "post" payload into plain text. A post is
+ * locale-wrapped (`{ zh_cn: { title, content } }`) and its body is an array of
+ * paragraphs, each an array of tagged inline elements.
+ */
+export function extractPostText(content) {
+    const post = pickPostLocale(content);
+    const lines = [];
+    if (typeof post.title === 'string' && post.title.length > 0) {
+        lines.push(post.title);
+    }
+    const body = post.content;
+    if (Array.isArray(body)) {
+        for (const paragraph of body) {
+            if (!Array.isArray(paragraph))
+                continue;
+            lines.push(paragraph.map(renderPostElement).join(''));
+        }
+    }
+    return lines.join('\n');
+}
+/** Pick the first present locale block of a post, falling back to the raw object. */
+function pickPostLocale(content) {
+    for (const locale of ['zh_cn', 'en_us', 'ja_jp']) {
+        const block = content[locale];
+        if (block && typeof block === 'object')
+            return block;
+    }
+    return content;
+}
+/** Render one inline post element to text. */
+function renderPostElement(el) {
+    if (!el || typeof el !== 'object')
+        return '';
+    const e = el;
+    switch (e.tag) {
+        case 'text':
+            return typeof e.text === 'string' ? e.text : '';
+        case 'a':
+            return typeof e.text === 'string'
+                ? e.text
+                : typeof e.href === 'string'
+                    ? e.href
+                    : '';
+        case 'at':
+            return `@${typeof e.user_name === 'string' ? e.user_name : ''}`;
+        case 'img':
+            return '(image)';
+        default:
+            return '';
+    }
+}
+//# sourceMappingURL=content.js.map

package/dist/feishu/content.js.map

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