agent-shell-chat 1.2.2

package/dist/src/adapter/inbound.js

@@ -0,0 +1,264 @@
+/**
+ * Inbound adapter: convert WeChat messages to ACP ContentBlock[].
+ */
+import fsp from "node:fs/promises";
+import path from "node:path";
+import { MessageItemType } from "../weixin/types.js";
+import { parseAesKey, downloadAndDecrypt } from "../weixin/media.js";
+/**
+ * Extract text body from a WeChat message's item_list.
+ */
+function extractText(itemList) {
+    if (!itemList?.length)
+        return "";
+    for (const item of itemList) {
+        if (item.type === MessageItemType.TEXT && item.text_item?.text != null) {
+            const text = String(item.text_item.text);
+            const ref = item.ref_msg;
+            if (!ref)
+                return text;
+            // Build quoted context
+            const parts = [];
+            if (ref.title)
+                parts.push(ref.title);
+            if (ref.message_item?.text_item?.text)
+                parts.push(ref.message_item.text_item.text);
+            if (!parts.length)
+                return text;
+            return `[引用: ${parts.join(" | ")}]\n${text}`;
+        }
+        // Voice transcription
+        if (item.type === MessageItemType.VOICE && item.voice_item?.text) {
+            return item.voice_item.text;
+        }
+    }
+    return "";
+}
+/**
+ * Find the first media item in a message.
+ */
+function findMediaItem(itemList) {
+    if (!itemList)
+        return undefined;
+    return (itemList.find((i) => i.type === MessageItemType.IMAGE && i.image_item?.media?.encrypt_query_param) ??
+        itemList.find((i) => i.type === MessageItemType.VIDEO && i.video_item?.media?.encrypt_query_param) ??
+        itemList.find((i) => i.type === MessageItemType.FILE && i.file_item?.media?.encrypt_query_param) ??
+        itemList.find((i) => i.type === MessageItemType.VOICE && i.voice_item?.media?.encrypt_query_param && !i.voice_item.text));
+}
+/**
+ * Convert a WeChat message to ACP ContentBlock[] for use in session/prompt.
+ */
+export async function weixinMessageToPrompt(msg, cdnBaseUrl, log, inboxDir) {
+    const blocks = [];
+    // Extract text
+    const text = extractText(msg.item_list);
+    if (text) {
+        blocks.push({ type: "text", text });
+    }
+    // Try to download and attach media
+    const mediaItem = findMediaItem(msg.item_list);
+    if (mediaItem) {
+        try {
+            const attached = await convertMediaItem(mediaItem, cdnBaseUrl, log, inboxDir ?? null);
+            if (attached)
+                blocks.push(attached);
+        }
+        catch (err) {
+            log(`Media download failed, skipping: ${String(err)}`);
+            // Add a text note about the media
+            const mediaType = mediaItem.type === MessageItemType.IMAGE ? "image"
+                : mediaItem.type === MessageItemType.VIDEO ? "video"
+                    : mediaItem.type === MessageItemType.FILE ? `file (${mediaItem.file_item?.file_name ?? "unknown"})`
+                        : mediaItem.type === MessageItemType.VOICE ? "voice"
+                            : "media";
+            blocks.push({ type: "text", text: `[Received ${mediaType} - download failed]` });
+        }
+    }
+    // Fallback: always have at least one content block
+    if (blocks.length === 0) {
+        blocks.push({ type: "text", text: "[empty message]" });
+    }
+    return blocks;
+}
+async function convertMediaItem(item, cdnBaseUrl, log, inboxDir) {
+    if (item.type === MessageItemType.IMAGE && item.image_item?.media) {
+        const media = item.image_item.media;
+        const aesKey = parseAesKey(media);
+        if (!aesKey || !media.encrypt_query_param)
+            return null;
+        log("Downloading image from CDN...");
+        const buffer = await downloadAndDecrypt(media.encrypt_query_param, aesKey, cdnBaseUrl);
+        const base64 = buffer.toString("base64");
+        return {
+            type: "image",
+            data: base64,
+            mimeType: "image/jpeg",
+        };
+    }
+    if (item.type === MessageItemType.FILE && item.file_item?.media) {
+        const media = item.file_item.media;
+        const aesKey = parseAesKey(media);
+        if (!aesKey || !media.encrypt_query_param)
+            return null;
+        log(`Downloading file "${item.file_item.file_name}" from CDN...`);
+        const buffer = await downloadAndDecrypt(media.encrypt_query_param, aesKey, cdnBaseUrl);
+        // For text-like files, send as resource; for binary, describe it
+        const fileName = item.file_item.file_name ?? "file";
+        if (isTextFile(fileName)) {
+            const content = buffer.toString("utf-8");
+            return {
+                type: "resource",
+                resource: {
+                    uri: `file:///${fileName}`,
+                    mimeType: guessMimeType(fileName),
+                    text: content,
+                },
+            };
+        }
+        return { type: "text", text: await buildBinaryFileText(fileName, buffer, inboxDir, log) };
+    }
+    if (item.type === MessageItemType.VOICE && item.voice_item?.media) {
+        // If there's a transcription, it was already handled in extractText
+        // Otherwise, note we received voice
+        return { type: "text", text: "[Received voice message - no transcription available]" };
+    }
+    if (item.type === MessageItemType.VIDEO) {
+        return { type: "text", text: "[Received video message]" };
+    }
+    return null;
+}
+function isTextFile(name) {
+    const ext = name.split(".").pop()?.toLowerCase() ?? "";
+    return [
+        "txt", "md", "json", "js", "ts", "py", "java", "c", "cpp", "h",
+        "css", "html", "xml", "yaml", "yml", "toml", "ini", "cfg", "sh",
+        "bash", "rs", "go", "rb", "php", "sql", "csv", "log", "env",
+    ].includes(ext);
+}
+function guessMimeType(name) {
+    const ext = name.split(".").pop()?.toLowerCase() ?? "";
+    const map = {
+        txt: "text/plain", md: "text/markdown", json: "application/json",
+        js: "text/javascript", ts: "text/typescript", py: "text/x-python",
+        html: "text/html", css: "text/css", xml: "text/xml",
+        yaml: "text/yaml", yml: "text/yaml", csv: "text/csv",
+    };
+    return map[ext] ?? "text/plain";
+}
+/**
+ * Build the text block describing a received binary file.
+ *
+ * When `inboxDir` is set, the buffer is persisted to disk so the agent
+ * can read it by path. On any save failure we silently fall back to the
+ * legacy size-only notice (with a log line for diagnostics) — the agent
+ * still gets *something* and the message poll loop is not blocked.
+ */
+async function buildBinaryFileText(fileName, buffer, inboxDir, log) {
+    if (!inboxDir) {
+        return `[Received file: ${fileName}, ${buffer.length} bytes]`;
+    }
+    try {
+        const savedPath = await saveToInbox(buffer, fileName, inboxDir);
+        return `[Received file: ${fileName} (${buffer.length} bytes) \u2014 saved to: ${savedPath}]`;
+    }
+    catch (err) {
+        log(`Failed to save received file "${fileName}" to inbox: ${String(err)}`);
+        return `[Received file: ${fileName}, ${buffer.length} bytes]`;
+    }
+}
+// Permissions: 0o600 on the file and 0o700 on the inbox dir so that on
+// multi-user POSIX systems received files (which often contain personal
+// info: IDs, contracts, photos…) aren't readable by other local users.
+// We apply both via the {mode} option AND an explicit chmod after the
+// op, because:
+//   - mkdir's {mode} is only applied to dirs we *create*; if the inbox
+//     dir already exists with looser perms (e.g. from a previous bridge
+//     version, or a hand-created dir), {mode} silently does nothing.
+//   - writeFile's {mode} is subject to the process umask: in practice
+//     umask can only *remove* bits, so 0o600 → at most 0o600, which is
+//     fine for confidentiality — the explicit chmod is just belt-and-
+//     braces against a future change that uses a less minimal mode.
+// Both chmods are best-effort: failures (e.g. on Windows where chmod
+// is largely a no-op, or on a network mount with restricted perms)
+// don't block the save itself.
+const INBOX_DIR_MODE = 0o700;
+const INBOX_FILE_MODE = 0o600;
+// Safety cap on the EEXIST retry loop. With a deterministic numeric
+// suffix per attempt, true collision past this count is essentially
+// impossible; the cap exists only to bound a pathological hot loop.
+const INBOX_MAX_COLLISION_RETRIES = 100;
+/**
+ * Write `buffer` into `inboxDir` and return the absolute path.
+ *
+ * Filename convention: `${ISO-timestamp}-${safeName}` for the first
+ * attempt, `${ISO-timestamp}-${N}-${safeName}` on the Nth retry, where
+ *   - the timestamp uses ISO 8601 with colons and dots replaced by
+ *     dashes (so the name avoids characters reserved on Windows),
+ *   - `safeName` is `fileName` with path separators stripped, ASCII
+ *     control + Windows-reserved chars (`<>:"/\|?*`) replaced by `_`,
+ *     leading dots and trailing dots/spaces (which Windows silently
+ *     trims) normalized to `_`, while Unicode is preserved so Chinese
+ *     filenames stay readable,
+ *   - if the sanitized name is empty, it falls back to `"file"`.
+ *
+ * Writes use the `wx` flag (fail-if-exists) so a collision — two
+ * bridge instances sharing an inbox, the user re-sending the same
+ * file twice in quick succession, a stubbed/frozen clock — never
+ * silently overwrites an existing file. On `EEXIST` we keep the
+ * original timestamp and bump a deterministic numeric suffix
+ * (`-1-`, `-2-`, …) capped at `INBOX_MAX_COLLISION_RETRIES`.
+ *
+ * Reserved-name corner case (Windows `CON`, `PRN`, `NUL`, `COM1`, …):
+ * Windows matches reserved device names against the basename exactly
+ * (case-insensitive, with or without extension). Because we always
+ * prefix the saved name with a timestamp like `2026-05-21T...Z-`,
+ * the basename is never one of those reserved tokens, so no extra
+ * handling is needed here.
+ */
+export async function saveToInbox(buffer, fileName, inboxDir) {
+    await fsp.mkdir(inboxDir, { recursive: true, mode: INBOX_DIR_MODE });
+    // Best-effort chmod the dir in case it pre-existed with looser
+    // permissions — mkdir's {mode} only applies to dirs we just created.
+    await fsp.chmod(inboxDir, INBOX_DIR_MODE).catch(() => { });
+    const safeBase = sanitizeFilename(fileName);
+    const stamp = new Date().toISOString().replace(/[:.]/g, "-");
+    for (let attempt = 0; attempt < INBOX_MAX_COLLISION_RETRIES; attempt++) {
+        // attempt 0 → "stamp-name"; subsequent retries → "stamp-N-name".
+        // Putting the counter ahead of the user-supplied name keeps the
+        // file extension at the tail (so OS open-by-extension still works)
+        // and guarantees a fresh path even when the wall clock hasn't
+        // ticked between retries (super-fast disk, stubbed time, etc.).
+        const suffix = attempt === 0 ? "" : `-${attempt}`;
+        const target = path.resolve(inboxDir, `${stamp}${suffix}-${safeBase}`);
+        try {
+            await fsp.writeFile(target, buffer, { flag: "wx", mode: INBOX_FILE_MODE });
+            // Best-effort chmod the file too — belt-and-braces against
+            // a future change to a less minimal {mode} above.
+            await fsp.chmod(target, INBOX_FILE_MODE).catch(() => { });
+            return target;
+        }
+        catch (err) {
+            if (err.code !== "EEXIST")
+                throw err;
+            // Yield to the event loop between retries so we don't starve
+            // the bridge's poll loop on a pathological hot loop.
+            await new Promise((resolve) => setImmediate(resolve));
+        }
+    }
+    throw new Error(`saveToInbox: exhausted ${INBOX_MAX_COLLISION_RETRIES} collision retries for ${safeBase}`);
+}
+function sanitizeFilename(name) {
+    // Drop any path separators a remote sender might have included.
+    const tail = name.split(/[\\/]/).pop() ?? "";
+    // Replace ASCII control chars and Windows-reserved chars. Then:
+    //   - leading dots → `_` (no hidden files / no path-walk-via-dot)
+    //   - trailing dots and spaces → `_` (Windows silently trims them
+    //     when creating files, which would make the path we return to
+    //     the agent differ from the on-disk name).
+    const cleaned = tail
+        .replace(/[\x00-\x1f<>:"/\\|?*]/g, "_")
+        .replace(/^\.+/, "_")
+        .replace(/[. ]+$/, "_");
+    return cleaned.length > 0 ? cleaned : "file";
+}
+//# sourceMappingURL=inbound.js.map

package/dist/src/adapter/inbound.js.map

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

package/dist/src/bridge.d.ts

@@ -0,0 +1,115 @@
+/**
+ * AgentShellBridge — the main orchestrator.
+ *
+ * Connects WeChat's iLink long-poll to ACP agent subprocesses.
+ * One bridge = one WeChat bot account → many users → many agent sessions.
+ */
+import type { AgentShellConfig } from "./config.js";
+export declare class AgentShellBridge {
+    private config;
+    private abortController;
+    private sessionManager;
+    private injectionMonitor;
+    private tokenData;
+    private stateUpdate;
+    private typingTickets;
+    private lastSendAt;
+    private sendChains;
+    private messageBuffers;
+    private bufferTimers;
+    private bufferFlushing;
+    private log;
+    constructor(config: AgentShellConfig, log?: (msg: string) => void);
+    start(opts?: {
+        forceLogin?: boolean;
+        renderQrUrl?: (url: string) => void;
+    }): Promise<void>;
+    stop(): Promise<void>;
+    private handleMessage;
+    private enqueueMessage;
+    private enqueueInjectedMessage;
+    private handleAcpConfigCommand;
+    private handleAcpCancelCommand;
+    private formatAcpCancelResult;
+    private formatAcpCancelUsage;
+    private isBufferStartCommand;
+    private isBufferDoneCommand;
+    private handleBufferStart;
+    private handleBufferDone;
+    private doFlush;
+    private appendToBuffer;
+    private resetBufferTimer;
+    private clearBufferTimer;
+    private rememberActiveUser;
+    private sendReply;
+    private deliverReply;
+    /**
+     * Wait, if necessary, so that consecutive text messages to the same user
+     * are issued at least {@link REPLY_SEND_SPACING_MS} apart. This spaces
+     * out their server-receive timestamps so WeChat preserves the order the
+     * bridge sent them in, instead of racing and delivering them reversed
+     * (issue #38). Sends to different users are tracked independently and do
+     * not delay each other.
+     */
+    private paceConsecutiveSend;
+    private cancelTypingIndicator;
+    private sendTypingIndicator;
+    private getTypingTicket;
+    private previewMessage;
+    private messageKind;
+    private extractAcpConfigCommand;
+    private extractAcpCancelCommand;
+    private extractBridgeCommand;
+    /**
+     * Render a usage hint suffix listing any configured aliases for a
+     * canonical command, e.g. " (aliases: /cancel, /取消)". Returns an
+     * empty string when no aliases are configured.
+     */
+    private aliasHint;
+    private formatAcpConfigList;
+    private formatAcpConfigUsage;
+    private describeCurrentConfigValue;
+    private listConfigOptionChoices;
+    private resolveAcpConfigValue;
+    private flattenSelectOptions;
+    private findConfigOptionChoice;
+    private configChoiceAliases;
+    private describeConfigChoice;
+    private extractConfigValueTail;
+    /**
+     * Scan the reply text for file-path references (markdown links and
+     * backtick-enclosed paths), resolve them inside the agent workspace,
+     * and send the corresponding files as WeChat media messages.
+     *
+     * Modeled after codex-wechat's `sendAssistantAttachmentsForReply()` and
+     * `extractAutoSendFilePathsFromReply()`.
+     */
+    private tryAutoSendMedia;
+    /**
+     * Extract file-path candidates from reply text.
+     *
+     * Supports two patterns (matching codex-wechat):
+     *  - Markdown links: `![alt](path)` or `[text](path)`
+     *  - Backtick-enclosed paths: `` `path` ``
+     */
+    private extractFilePathsFromReply;
+    /**
+     * Extract file-path candidates tagged with `@send:` marker.
+     *
+     * Supports patterns:
+     *  - `@send:path/to/file` — explicit send marker
+     *  - `📎path/to/file` — emoji send marker
+     *
+     * Only these explicitly tagged paths are returned; regular file
+     * references in code discussions are ignored.
+     */
+    private extractTaggedFilePaths;
+    /**
+     * Strip decorations from a raw path candidate so it resolves cleanly:
+     *  - `< >` wrapping (auto-linked bare paths on some platforms)
+     *  - `#L…` line references from editor / code-review links
+     *  - `file.ext:line:col` suffixes
+     */
+    private stripPathDecorations;
+}
+//# sourceMappingURL=bridge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/bridge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AA2BpD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,eAAe,CAAyB;IAChD,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,gBAAgB,CAAiC;IACzD,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,WAAW,CAAqB;IAExC,OAAO,CAAC,aAAa,CAA4D;IAGjF,OAAO,CAAC,UAAU,CAA6B;IAI/C,OAAO,CAAC,UAAU,CAAoC;IAEtD,OAAO,CAAC,cAAc,CAKjB;IAEL,OAAO,CAAC,YAAY,CAAoD;IAKxE,OAAO,CAAC,cAAc,CAAoC;IAC1D,OAAO,CAAC,GAAG,CAAwB;gBAEvB,MAAM,EAAE,gBAAgB,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI;IAK3D,KAAK,CAAC,IAAI,CAAC,EAAE;QACjB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;KACrC,GAAG,OAAO,CAAC,IAAI,CAAC;IA+EX,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B,OAAO,CAAC,aAAa;YAyEP,cAAc;YAed,sBAAsB;YAsBtB,sBAAsB;YAmEtB,sBAAsB;IAmCpC,OAAO,CAAC,qBAAqB;IAoB7B,OAAO,CAAC,oBAAoB;IAY5B,OAAO,CAAC,oBAAoB;IAI5B,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,iBAAiB;IAsBzB,OAAO,CAAC,gBAAgB;YAyBV,OAAO;IA4CrB,OAAO,CAAC,cAAc;IAgDtB,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,kBAAkB;YAWZ,SAAS;YAgBT,YAAY;IA8E1B;;;;;;;OAOG;YACW,mBAAmB;YAYnB,qBAAqB;YAerB,mBAAmB;YAmBnB,eAAe;IAyB7B,OAAO,CAAC,cAAc;IAetB,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,uBAAuB;IAI/B,OAAO,CAAC,uBAAuB;IAI/B,OAAO,CAAC,oBAAoB;IAyB5B;;;;OAIG;IACH,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,mBAAmB;IAoC3B,OAAO,CAAC,oBAAoB;IAY5B,OAAO,CAAC,0BAA0B;IASlC,OAAO,CAAC,uBAAuB;IAK/B,OAAO,CAAC,qBAAqB;IA6C7B,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,sBAAsB;IAO9B,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,oBAAoB;IAQ5B,OAAO,CAAC,sBAAsB;IAgB9B;;;;;;;OAOG;YACW,gBAAgB;IA2D9B;;;;;;OAMG;IACH,OAAO,CAAC,yBAAyB;IAkCjC;;;;;;;;;OASG;IACH,OAAO,CAAC,sBAAsB;IA4B9B;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;CAyB7B"}