dsh-connect 0.7.2 → 0.9.0

package/lib/channels/telegram/client.js

@@ -0,0 +1,198 @@
+/**
+ * Minimal Telegram Bot API client built on the global `fetch` — long-polling
+ * update intake, message send / edit / photo, file download, and inline
+ * keyboards. Zero third-party HTTP dependency (Node ≥ 18 / ≥ 20).
+ *
+ * @module dsh-connect/channels/telegram/client
+ */
+import { mkdirSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { extname, join } from "node:path";
+const API_BASE = "https://api.telegram.org";
+export class TelegramClient {
+    config;
+    offset = 0;
+    constructor(config) {
+        if (!config.botToken)
+            throw new Error("connect-telegram: botToken is required");
+        this.config = config;
+    }
+    base() {
+        return this.config.baseUrl ?? API_BASE;
+    }
+    async call(method, body, opts) {
+        const url = `${this.base()}/bot${this.config.botToken}/${method}`;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), opts?.timeoutMs ?? this.config.timeoutMs ?? 15_000);
+        try {
+            const response = await fetch(url, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: body === undefined ? "{}" : JSON.stringify(body),
+                signal: controller.signal,
+            });
+            const parsed = (await response.json());
+            if (!parsed.ok || parsed.result === undefined) {
+                throw new Error(`Telegram API ${method}: ${parsed.description ?? `error ${parsed.error_code ?? "?"}`}`);
+            }
+            return parsed.result;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    /** Long-poll for new updates. Does NOT advance the offset — the caller confirms each update via {@link confirmOffset} after processing it, so a failure mid-batch never loses the remaining updates. */
+    async pollUpdates() {
+        // The generic per-call HTTP timeout (15s) must not kill a long poll:
+        // give getUpdates a client-side timeout comfortably above the server-side
+        // long-poll window (otherwise every idle poll is aborted at 15s and the
+        // "50s long poll" degrades into short polling + sleep churn).
+        const longPollMs = ((this.config.pollingTimeoutSeconds ?? 50) + 10) * 1000;
+        return this.call("getUpdates", {
+            offset: this.offset,
+            timeout: this.config.pollingTimeoutSeconds ?? 50,
+            allowed_updates: ["message", "callback_query"],
+        }, { timeoutMs: longPollMs });
+    }
+    /** Advance the polling offset past `updateId` — call only after the update was fully handled. */
+    confirmOffset(updateId) {
+        this.offset = Math.max(this.offset, updateId + 1);
+    }
+    /** Skip all pending updates (used on startup so we don't replay history). */
+    async resetOffset() {
+        const result = await this.call("getUpdates", { offset: -1, timeout: 0 });
+        if (result.length > 0) {
+            this.offset = result[result.length - 1].update_id + 1;
+        }
+    }
+    /** Fetch the bot's own identity (id + username) — used for @-mention / reply-to checks. */
+    async getMe() {
+        return this.call("getMe", {});
+    }
+    async sendMessage(chatId, text, opts = {}) {
+        return this.call("sendMessage", {
+            chat_id: chatId,
+            text,
+            ...(opts.parse_mode === undefined ? {} : { parse_mode: opts.parse_mode }),
+            ...(opts.reply_to_message_id === undefined ? {} : { reply_to_message_id: opts.reply_to_message_id }),
+            ...(opts.reply_markup === undefined ? {} : { reply_markup: opts.reply_markup }),
+            ...(opts.disable_web_page_preview === undefined ? {} : { disable_web_page_preview: opts.disable_web_page_preview }),
+        });
+    }
+    async editMessageText(chatId, messageId, text, opts = {}) {
+        return this.call("editMessageText", {
+            chat_id: chatId,
+            message_id: messageId,
+            text,
+            ...(opts.parse_mode === undefined ? {} : { parse_mode: opts.parse_mode }),
+            ...(opts.reply_markup === undefined ? {} : { reply_markup: opts.reply_markup }),
+        });
+    }
+    async sendPhoto(chatId, photoPath, caption, opts = {}) {
+        // sendPhoto needs multipart; the fetch FormData path with a Blob is the
+        // modern zero-dependency route. Read the file into a Blob.
+        const { readFileSync } = await import("node:fs");
+        const buffer = readFileSync(photoPath);
+        const blob = new Blob([buffer]);
+        const form = new FormData();
+        form.append("chat_id", String(chatId));
+        form.append("photo", blob, photoPath.split(/[\\/]/).pop() ?? "photo");
+        if (caption !== undefined)
+            form.append("caption", caption);
+        if (opts.parse_mode !== undefined)
+            form.append("parse_mode", opts.parse_mode);
+        if (opts.reply_to_message_id !== undefined)
+            form.append("reply_to_message_id", String(opts.reply_to_message_id));
+        const url = `${this.base()}/bot${this.config.botToken}/sendPhoto`;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.config.timeoutMs ?? 15_000);
+        try {
+            const response = await fetch(url, { method: "POST", body: form, signal: controller.signal });
+            const parsed = (await response.json());
+            if (!parsed.ok || parsed.result === undefined) {
+                throw new Error(`Telegram API sendPhoto: ${parsed.description ?? "unknown error"}`);
+            }
+            return parsed.result;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async sendDocument(chatId, documentPath, opts = {}) {
+        const { readFileSync } = await import("node:fs");
+        const buffer = readFileSync(documentPath);
+        const blob = new Blob([buffer]);
+        const form = new FormData();
+        form.append("chat_id", String(chatId));
+        form.append("document", blob, documentPath.split(/[\\/]/).pop() ?? "document");
+        if (opts.reply_to_message_id !== undefined)
+            form.append("reply_to_message_id", String(opts.reply_to_message_id));
+        const url = `${this.base()}/bot${this.config.botToken}/sendDocument`;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.config.timeoutMs ?? 15_000);
+        try {
+            const response = await fetch(url, { method: "POST", body: form, signal: controller.signal });
+            const parsed = (await response.json());
+            if (!parsed.ok || parsed.result === undefined) {
+                throw new Error(`Telegram API sendDocument: ${parsed.description ?? "unknown error"}`);
+            }
+            return parsed.result;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async answerCallbackQuery(callbackQueryId, text) {
+        return this.call("answerCallbackQuery", {
+            callback_query_id: callbackQueryId,
+            ...(text === undefined ? {} : { text }),
+        });
+    }
+    /** Download a file (photo / document / …) by file_id into a temp dir; returns the local path. */
+    async downloadFile(fileId, dir, fileName) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.config.timeoutMs ?? 30_000);
+        try {
+            const file = await this.call("getFile", { file_id: fileId });
+            if (file.file_path === undefined)
+                throw new Error("getFile returned no file_path");
+            const url = `${this.base()}/file/bot${this.config.botToken}/${file.file_path}`;
+            const response = await fetch(url, { signal: controller.signal });
+            if (!response.ok)
+                throw new Error(`download HTTP ${response.status}`);
+            const buffer = Buffer.from(await response.arrayBuffer());
+            const safeName = sanitizeFileName(fileName ?? file.file_path.split("/").pop() ?? fileId);
+            const dest = join(dir, safeName);
+            mkdirSync(dir, { recursive: true });
+            writeFileSync(dest, buffer);
+            return { path: dest, kind: "file" };
+        }
+        catch (error) {
+            return { path: "", kind: "file", error: error instanceof Error ? error.message : String(error) };
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    /** Convenience: download to the OS temp dir. */
+    async downloadFileToTemp(fileId, fileName) {
+        const dir = join(tmpdir(), "dsh-connect-telegram");
+        return this.downloadFile(fileId, dir, fileName);
+    }
+}
+/** Image extensions Telegram renders inline via sendPhoto. */
+const PHOTO_EXTENSIONS = new Set([".png", ".jpg", ".jpeg", ".webp", ".gif"]);
+/** Pick the Bot API method for a local file (sendPhoto vs sendDocument). */
+export function telegramFileMethod(filename) {
+    const ext = extname(filename).toLowerCase();
+    return PHOTO_EXTENSIONS.has(ext) ? "sendPhoto" : "sendDocument";
+}
+/** Strip path separators / control chars from a downloaded file's name. */
+export function sanitizeFileName(name) {
+    const clean = name
+        .replace(/[\\/:*?"<>|\u0000-\u001f]/g, "_")
+        .trim()
+        .slice(0, 200);
+    return clean === "" ? "file" : clean;
+}
+//# sourceMappingURL=client.js.map

package/lib/channels/telegram/client.js.map

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

package/lib/channels/telegram/i18n.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Telegram-adapter user-facing strings (zh/en).
+ * @module dsh-connect/channels/telegram/i18n
+ */
+import type { Language } from "../../i18n.js";
+export interface TelegramMessages {
+    tokenMissing: string;
+    pollFailed(error: string): string;
+    choiceExpired: string;
+    choiceDone: string;
+    menuExpired: string;
+}
+export declare function telegramMessages(lang: Language): TelegramMessages;
+//# sourceMappingURL=i18n.d.ts.map

package/lib/channels/telegram/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../../src/channels/telegram/i18n.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAkBD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,GAAG,gBAAgB,CAEjE"}

package/lib/channels/telegram/i18n.js

@@ -0,0 +1,18 @@
+const zh = {
+    tokenMissing: "connect-telegram: 未配置 botToken（Telegram BotFather 提供的 token），无法连接。",
+    pollFailed: (error) => `connect-telegram: 长轮询失败，稍后重试 — ${error}`,
+    choiceExpired: "此操作已失效（可能已被处理或已过期）。",
+    choiceDone: "✅ 已选择",
+    menuExpired: "菜单已过期",
+};
+const en = {
+    tokenMissing: "connect-telegram: botToken is not configured (the token BotFather gives you) — cannot connect.",
+    pollFailed: (error) => `connect-telegram: long-poll failed, retrying — ${error}`,
+    choiceExpired: "This action is no longer active (already handled or expired).",
+    choiceDone: "✅ Selected",
+    menuExpired: "Menu expired",
+};
+export function telegramMessages(lang) {
+    return lang === "en" ? en : zh;
+}
+//# sourceMappingURL=i18n.js.map

package/lib/channels/telegram/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../../../src/channels/telegram/i18n.ts"],"names":[],"mappings":"AAcA,MAAM,EAAE,GAAqB;IAC3B,YAAY,EAAE,oEAAoE;IAClF,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,kCAAkC,KAAK,EAAE;IAChE,aAAa,EAAE,qBAAqB;IACpC,UAAU,EAAE,OAAO;IACnB,WAAW,EAAE,OAAO;CACrB,CAAC;AAEF,MAAM,EAAE,GAAqB;IAC3B,YAAY,EAAE,gGAAgG;IAC9G,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,kDAAkD,KAAK,EAAE;IAChF,aAAa,EAAE,+DAA+D;IAC9E,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,cAAc;CAC5B,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,IAAc;IAC7C,OAAO,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACjC,CAAC"}

package/lib/channels/telegram/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Telegram channel adapter: getUpdates long-polling intake, normalized message
+ * routing into `dsh-connect`, and replies back to Telegram (text / markdown /
+ * streaming edits / inline-keyboard choice prompts).
+ *
+ * @module dsh-connect/telegram
+ */
+import type { Context } from "@deepseek-ai/cordis";
+import z from "@deepseek-ai/schemastery";
+import { type TelegramConfig } from "./adapter.js";
+export { TelegramAdapter } from "./adapter.js";
+export type { TelegramConfig } from "./adapter.js";
+export { TelegramClient } from "./client.js";
+export type { TelegramClientConfig, TelegramMessage, TelegramUpdate } from "./client.js";
+export { markdownToTelegramHtml, escapeHtml, buildInlineKeyboard, encodeMessageRef, decodeMessageRef, isBotMentioned } from "./adapter.js";
+/** Plugin config; secrets may come from config or the TELEGRAM_BOT_TOKEN environment. */
+export declare const Config: z<Schemastery.ObjectS<{
+    botToken: z<string, string>;
+    language: z<"zh" | "en", "zh" | "en">;
+    requireMention: z<boolean, boolean>;
+    pollingTimeoutSeconds: z<number, number>;
+    baseUrl: z<string, string>;
+}>, Schemastery.ObjectT<{
+    botToken: z<string, string>;
+    language: z<"zh" | "en", "zh" | "en">;
+    requireMention: z<boolean, boolean>;
+    pollingTimeoutSeconds: z<number, number>;
+    baseUrl: z<string, string>;
+}>>;
+interface ConnectLike {
+    registerAdapter(adapter: unknown): void;
+}
+/**
+ * Register and start the Telegram adapter. `connect` is the already-constructed
+ * `ConnectService` instance (passed from the merged entry, not resolved via
+ * `ctx.get` — that returns undefined during the same plugin's `apply`).
+ */
+export declare function register(connect: ConnectLike, config: (TelegramConfig | null) | undefined, ctx: Context): void;
+/**
+ * Compatibility shell for the old split-plugin registration path (when `connect`
+ * is an already-active, separate plugin). The merged entry calls `register`
+ * directly instead, because `ctx.get("connect")` returns undefined inside this
+ * plugin's own `apply`.
+ */
+export declare function apply(ctx: Context, config?: TelegramConfig | null): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/channels/telegram/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/channels/telegram/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,CAAC,MAAM,0BAA0B,CAAC;AACzC,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAEpE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,oBAAoB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACzF,OAAO,EAAE,sBAAsB,EAAE,UAAU,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE3I,yFAAyF;AACzF,eAAO,MAAM,MAAM;;;;;;;;;;;;GAMjB,CAAC;AAEH,UAAU,WAAW;IACnB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CACzC;AAcD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,GAAE,cAAc,GAAG,IAAI,aAAK,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CASrG;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,cAAc,GAAG,IAAS,GAAG,IAAI,CAM5E"}

package/lib/channels/telegram/index.js

@@ -0,0 +1,54 @@
+import z from "@deepseek-ai/schemastery";
+import { TelegramAdapter } from "./adapter.js";
+export { TelegramAdapter } from "./adapter.js";
+export { TelegramClient } from "./client.js";
+export { markdownToTelegramHtml, escapeHtml, buildInlineKeyboard, encodeMessageRef, decodeMessageRef, isBotMentioned } from "./adapter.js";
+/** Plugin config; secrets may come from config or the TELEGRAM_BOT_TOKEN environment. */
+export const Config = z.object({
+    botToken: z.string().role("secret"),
+    language: z.union([z.const("zh"), z.const("en")]),
+    requireMention: z.boolean(),
+    pollingTimeoutSeconds: z.number().min(1).max(60),
+    baseUrl: z.string(),
+});
+function start(connect, config, logger) {
+    try {
+        const adapter = new TelegramAdapter(config, logger);
+        connect.registerAdapter(adapter);
+        void adapter.start().catch((error) => {
+            logger?.warn?.(`connect-telegram: start failed: ${String(error)}`);
+        });
+    }
+    catch (error) {
+        logger?.warn?.(`connect-telegram: adapter init failed: ${String(error)}`);
+    }
+}
+/**
+ * Register and start the Telegram adapter. `connect` is the already-constructed
+ * `ConnectService` instance (passed from the merged entry, not resolved via
+ * `ctx.get` — that returns undefined during the same plugin's `apply`).
+ */
+export function register(connect, config = {}, ctx) {
+    // The DSH loader passes `null` for entries without an explicit config.
+    config = config ?? {};
+    const botToken = config.botToken ?? process.env.TELEGRAM_BOT_TOKEN;
+    if (botToken === undefined || botToken === "") {
+        ctx.logger?.warn?.("connect-telegram: botToken is not configured (config or TELEGRAM_BOT_TOKEN) — adapter disabled.");
+        return;
+    }
+    start(connect, { ...config, botToken }, ctx.logger);
+}
+/**
+ * Compatibility shell for the old split-plugin registration path (when `connect`
+ * is an already-active, separate plugin). The merged entry calls `register`
+ * directly instead, because `ctx.get("connect")` returns undefined inside this
+ * plugin's own `apply`.
+ */
+export function apply(ctx, config = {}) {
+    const connect = ctx.get("connect");
+    if (connect === undefined) {
+        throw new Error("connect-telegram: the dsh-connect service is not present; load it before this adapter");
+    }
+    register(connect, config, ctx);
+}
+//# sourceMappingURL=index.js.map

package/lib/channels/telegram/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/channels/telegram/index.ts"],"names":[],"mappings":"AAQA,OAAO,CAAC,MAAM,0BAA0B,CAAC;AACzC,OAAO,EAAE,eAAe,EAAuB,MAAM,cAAc,CAAC;AAEpE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAE,sBAAsB,EAAE,UAAU,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE3I,yFAAyF;AACzF,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC;IACnC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACjD,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE;IAC3B,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAChD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC;AAMH,SAAS,KAAK,CAAC,OAAoB,EAAE,MAAsB,EAAE,MAAgD;IAC3G,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACpD,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QACjC,KAAK,OAAO,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACnC,MAAM,EAAE,IAAI,EAAE,CAAC,mCAAmC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,EAAE,IAAI,EAAE,CAAC,0CAA0C,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC5E,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAoB,EAAE,SAAgC,EAAE,EAAE,GAAY;IAC7F,uEAAuE;IACvE,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;IACtB,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IACnE,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,EAAE,EAAE,CAAC;QAC9C,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,iGAAiG,CAAC,CAAC;QACtH,OAAO;IACT,CAAC;IACD,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;AACtD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,KAAK,CAAC,GAAY,EAAE,SAAgC,EAAE;IACpE,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,SAAS,CAA4B,CAAC;IAC9D,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,uFAAuF,CAAC,CAAC;IAC3G,CAAC;IACD,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;AACjC,CAAC"}

package/lib/channels/web/adapter.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Web channel adapter for dsh-connect: mirrors Feishu conversations to DSH Web GUI.
+ * This adapter monitors BindingStore for webMirrorSessionId changes and exposes
+ * those sessions to the Web GUI through the standard ChannelAdapter interface.
+ * @module dsh-connect/channels/web/adapter
+ */
+import type { ChannelAdapter, ChoicePrompt, ChoiceResult, InboundMessage, OutboundTarget, SummaryCard } from "../../types.js";
+import type { BindingStore } from "../../binding.js";
+/**
+ * WebAdapter provides a bridge between dsh-connect's mirror sessions and the
+ * DSH Web GUI. It monitors the BindingStore for chats that have been mirrored
+ * (have webMirrorSessionId set) so the GUI can open the shared session.
+ *
+ * Honest limitations (documented in README):
+ * - The Web GUI reads mirrored sessions directly from DSH's session store; it
+ *   never sends inbound messages through this adapter. The mirror "lock"
+ *   (lockOwner) is therefore enforced only on the Feishu side — the Web side
+ *   is write-always and cannot be fixed from this repository.
+ * - Outbound methods (sendText / sendCard / streamText / promptChoice /
+ *   closeMenu) are no-ops by design: the agent writes events into the shared
+ *   session store, and the GUI renders them. They exist only to satisfy the
+ *   ChannelAdapter contract.
+ */
+export declare class WebAdapter implements ChannelAdapter {
+    private readonly logger?;
+    readonly id = "web";
+    private handler?;
+    private readonly bindings;
+    private readonly pollIntervalMs;
+    private pollTimer?;
+    private unsubscribe?;
+    private readonly knownMirrors;
+    /**
+     * Create a WebAdapter instance.
+     * @param bindings - The BindingStore to monitor for mirror sessions
+     * @param options - Optional configuration
+     */
+    constructor(bindings: BindingStore, options?: {
+        pollIntervalMs?: number;
+    }, logger?: {
+        warn?: (...args: unknown[]) => void;
+    } | undefined);
+    onInbound(handler: (msg: InboundMessage) => void | Promise<void>): void;
+    /**
+     * Start monitoring for mirror sessions.
+     * Uses event-driven detection with fallback polling.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop monitoring and clean up resources.
+     */
+    stop(): Promise<void>;
+    /**
+     * Record a newly-detected mirror session. Mirror tracking is purely
+     * bookkeeping: the mirror is visible in DSH Web through the session store
+     * itself, and synthesizing an inbound "mirror created" message here would
+     * spin up a spurious web runner and burn a real agent turn — so we do NOT
+     * route anything through the handler.
+     */
+    private recordMirror;
+    /**
+     * Scan BindingStore for chats with webMirrorSessionId set and record any
+     * new mirrors.
+     */
+    private scanForMirrors;
+    /**
+     * Check if a session is mirrored and available for Web access.
+     * @param sessionId - The session ID to check
+     */
+    isSessionMirrored(sessionId: string): boolean;
+    /**
+     * Get the source chat key for a mirrored session.
+     * @param sessionId - The session ID
+     * @returns The original channel:chatKey or undefined if not mirrored
+     */
+    getMirrorSource(sessionId: string): string | undefined;
+    /**
+     * Send text message to Web GUI.
+     * No-op: the Web GUI pulls content from DSH session events, not from adapter
+     * calls. Kept only to satisfy the ChannelAdapter contract.
+     */
+    sendText(_target: OutboundTarget, _text: string): Promise<void>;
+    /**
+     * Send summary card to Web GUI. No-op — see {@link sendText}.
+     */
+    sendCard(_target: OutboundTarget, _card: SummaryCard): Promise<void>;
+    /**
+     * Stream text chunks to Web GUI.
+     * The agent already writes chunks into the session; consume the iterable so
+     * the producer never stalls on backpressure.
+     */
+    streamText(_target: OutboundTarget, chunks: AsyncIterable<string>): Promise<void>;
+    /**
+     * Present interactive choice prompt.
+     * No-op: the Web GUI renders choices through its own interaction system.
+     */
+    promptChoice(_target: OutboundTarget, _prompt: ChoicePrompt, updateMessageId?: string): Promise<ChoiceResult>;
+    /**
+     * Close a menu/card in Web GUI. No-op — see {@link sendText}.
+     */
+    closeMenu(_messageId: string, _summary: string): Promise<void>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/lib/channels/web/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/channels/web/adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,cAAc,EACd,WAAW,EACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAe,MAAM,kBAAkB,CAAC;AAElE;;;;;;;;;;;;;;GAcG;AACH,qBAAa,UAAW,YAAW,cAAc;IAkB7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAjB1B,QAAQ,CAAC,EAAE,SAAS;IAEpB,OAAO,CAAC,OAAO,CAAC,CAAgD;IAChE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,SAAS,CAAC,CAAiB;IACnC,OAAO,CAAC,WAAW,CAAC,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAE1D;;;;OAIG;gBAED,QAAQ,EAAE,YAAY,EACtB,OAAO,GAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAO,EACxB,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;KAAE,YAAA;IAMnE,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIvE;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3B;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IASpB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAatB;;;OAGG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAI7C;;;;OAIG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAItD;;;;OAIG;IACG,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrE;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1E;;;;OAIG;IACG,UAAU,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvF;;;OAGG;IACG,YAAY,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,YAAY,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAOnH;;OAEG;IACG,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGrE"}

package/lib/channels/web/adapter.js

@@ -0,0 +1,161 @@
+/**
+ * WebAdapter provides a bridge between dsh-connect's mirror sessions and the
+ * DSH Web GUI. It monitors the BindingStore for chats that have been mirrored
+ * (have webMirrorSessionId set) so the GUI can open the shared session.
+ *
+ * Honest limitations (documented in README):
+ * - The Web GUI reads mirrored sessions directly from DSH's session store; it
+ *   never sends inbound messages through this adapter. The mirror "lock"
+ *   (lockOwner) is therefore enforced only on the Feishu side — the Web side
+ *   is write-always and cannot be fixed from this repository.
+ * - Outbound methods (sendText / sendCard / streamText / promptChoice /
+ *   closeMenu) are no-ops by design: the agent writes events into the shared
+ *   session store, and the GUI renders them. They exist only to satisfy the
+ *   ChannelAdapter contract.
+ */
+export class WebAdapter {
+    logger;
+    id = "web";
+    handler;
+    bindings;
+    pollIntervalMs;
+    pollTimer;
+    unsubscribe;
+    knownMirrors = new Map(); // sessionId -> chatKey
+    /**
+     * Create a WebAdapter instance.
+     * @param bindings - The BindingStore to monitor for mirror sessions
+     * @param options - Optional configuration
+     */
+    constructor(bindings, options = {}, logger) {
+        this.logger = logger;
+        this.bindings = bindings;
+        this.pollIntervalMs = options.pollIntervalMs ?? 1000; // Default 1 second polling
+    }
+    onInbound(handler) {
+        this.handler = handler;
+    }
+    /**
+     * Start monitoring for mirror sessions.
+     * Uses event-driven detection with fallback polling.
+     */
+    async start() {
+        // Subscribe to binding changes for real-time detection
+        this.unsubscribe = this.bindings.onChange((binding, changeType) => {
+            if (binding.webMirrorSessionId !== undefined) {
+                this.recordMirror(binding);
+            }
+            else if (changeType === "delete") {
+                this.knownMirrors.delete(binding.sessionId);
+            }
+        });
+        // Initial scan for existing mirrors
+        this.scanForMirrors();
+        // Fallback polling in case events are missed
+        this.pollTimer = setInterval(() => {
+            this.scanForMirrors();
+        }, this.pollIntervalMs);
+    }
+    /**
+     * Stop monitoring and clean up resources.
+     */
+    async stop() {
+        if (this.unsubscribe !== undefined) {
+            this.unsubscribe();
+            this.unsubscribe = undefined;
+        }
+        if (this.pollTimer !== undefined) {
+            clearInterval(this.pollTimer);
+            this.pollTimer = undefined;
+        }
+    }
+    /**
+     * Record a newly-detected mirror session. Mirror tracking is purely
+     * bookkeeping: the mirror is visible in DSH Web through the session store
+     * itself, and synthesizing an inbound "mirror created" message here would
+     * spin up a spurious web runner and burn a real agent turn — so we do NOT
+     * route anything through the handler.
+     */
+    recordMirror(binding) {
+        const sessionId = binding.webMirrorSessionId;
+        if (sessionId === undefined)
+            return;
+        const chatKey = `${binding.channel}:${binding.chatKey}`;
+        if (!this.knownMirrors.has(sessionId)) {
+            this.knownMirrors.set(sessionId, chatKey);
+        }
+    }
+    /**
+     * Scan BindingStore for chats with webMirrorSessionId set and record any
+     * new mirrors.
+     */
+    scanForMirrors() {
+        try {
+            const bindings = this.bindings.list?.() ?? [];
+            for (const binding of bindings) {
+                if (binding.webMirrorSessionId !== undefined) {
+                    this.recordMirror(binding);
+                }
+            }
+        }
+        catch {
+            // BindingStore may not have list() in older versions — rely on events.
+        }
+    }
+    /**
+     * Check if a session is mirrored and available for Web access.
+     * @param sessionId - The session ID to check
+     */
+    isSessionMirrored(sessionId) {
+        return this.knownMirrors.has(sessionId);
+    }
+    /**
+     * Get the source chat key for a mirrored session.
+     * @param sessionId - The session ID
+     * @returns The original channel:chatKey or undefined if not mirrored
+     */
+    getMirrorSource(sessionId) {
+        return this.knownMirrors.get(sessionId);
+    }
+    /**
+     * Send text message to Web GUI.
+     * No-op: the Web GUI pulls content from DSH session events, not from adapter
+     * calls. Kept only to satisfy the ChannelAdapter contract.
+     */
+    async sendText(_target, _text) {
+        // The agent writes session events; the GUI renders them.
+    }
+    /**
+     * Send summary card to Web GUI. No-op — see {@link sendText}.
+     */
+    async sendCard(_target, _card) {
+        // No-op by design.
+    }
+    /**
+     * Stream text chunks to Web GUI.
+     * The agent already writes chunks into the session; consume the iterable so
+     * the producer never stalls on backpressure.
+     */
+    async streamText(_target, chunks) {
+        for await (const _chunk of chunks) {
+            // Already delivered via session events.
+        }
+    }
+    /**
+     * Present interactive choice prompt.
+     * No-op: the Web GUI renders choices through its own interaction system.
+     */
+    async promptChoice(_target, _prompt, updateMessageId) {
+        return {
+            choice: undefined,
+            messageId: updateMessageId ?? `web-${Date.now()}`,
+        };
+    }
+    /**
+     * Close a menu/card in Web GUI. No-op — see {@link sendText}.
+     */
+    async closeMenu(_messageId, _summary) {
+        // No-op by design.
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/lib/channels/web/adapter.js.map

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