@a1hvdy/cc-openclaw 0.25.0 → 0.25.1

package/dist/src/channels/telegram-mirror/inbound-handler.d.ts

@@ -0,0 +1,52 @@
+/**
+ * src/channels/telegram-mirror/inbound-handler.ts — v0.25.1 wire-up.
+ *
+ * The piece that was missing from v0.25.0: subscribes to OpenClaw's
+ * `before_dispatch` event, identifies mirror slash commands, routes
+ * through `dispatchCommand` (from commands.ts), and forwards the
+ * resulting TelegramAction list out via `telegram-bot-api`'s sendTg.
+ *
+ * Returns `{ handled: true }` on dispatch so OpenClaw's default model
+ * route (or any built-in command handler) doesn't ALSO respond — the
+ * legacy event-reducer's `/quota` / `/sessions` handlers used the same
+ * claim shape.
+ *
+ * Out-of-scope for v0.25.1 (deferred to v0.25.2+):
+ *   • Tool/text/turn stream-event subscription → mirror-card render.
+ *   • callback_query handling for inline-keyboard taps.
+ *   • Burst-accumulator + compose-buffer engine injection (the
+ *     ComposeBuffer + BurstAccumulator capture user text but the
+ *     concatenated payload from /send still needs to reach the engine
+ *     as a synthetic user message — that's a separate dispatch path).
+ *
+ * Single shared CallbackMap + ComposeBuffer per process so callback
+ * resolution and compose state survive across handler invocations.
+ */
+import { CallbackMap } from './callback-mapping.js';
+import { ComposeBuffer } from './compose-buffer.js';
+export interface InboundHandlerApi {
+    on(event: string, handler: (...args: unknown[]) => unknown | Promise<unknown>): void;
+    logger?: {
+        info: (msg: string) => void;
+        warn: (msg: string) => void;
+    };
+}
+/**
+ * Internal handler state — exported only for tests so they can inspect
+ * compose-buffer state + callback-map without going through Telegram.
+ */
+export interface HandlerState {
+    callbackMap: CallbackMap;
+    composeBuffer: ComposeBuffer;
+}
+export declare function createHandlerState(): HandlerState;
+/**
+ * Register the inbound dispatcher. Called by mirror's register() at boot.
+ *
+ * Hooked to `before_dispatch` — OpenClaw's name for the inbound-message
+ * event surface. We return `{ handled: true }` to claim the message when
+ * it's a known mirror slash command; `undefined` lets the event proceed
+ * to OpenClaw's default routing (which is what we want for non-slash
+ * user text destined for the model).
+ */
+export declare function registerInboundHandler(api: InboundHandlerApi, state?: HandlerState): HandlerState;

package/dist/src/channels/telegram-mirror/inbound-handler.js

@@ -0,0 +1,115 @@
+/**
+ * src/channels/telegram-mirror/inbound-handler.ts — v0.25.1 wire-up.
+ *
+ * The piece that was missing from v0.25.0: subscribes to OpenClaw's
+ * `before_dispatch` event, identifies mirror slash commands, routes
+ * through `dispatchCommand` (from commands.ts), and forwards the
+ * resulting TelegramAction list out via `telegram-bot-api`'s sendTg.
+ *
+ * Returns `{ handled: true }` on dispatch so OpenClaw's default model
+ * route (or any built-in command handler) doesn't ALSO respond — the
+ * legacy event-reducer's `/quota` / `/sessions` handlers used the same
+ * claim shape.
+ *
+ * Out-of-scope for v0.25.1 (deferred to v0.25.2+):
+ *   • Tool/text/turn stream-event subscription → mirror-card render.
+ *   • callback_query handling for inline-keyboard taps.
+ *   • Burst-accumulator + compose-buffer engine injection (the
+ *     ComposeBuffer + BurstAccumulator capture user text but the
+ *     concatenated payload from /send still needs to reach the engine
+ *     as a synthetic user message — that's a separate dispatch path).
+ *
+ * Single shared CallbackMap + ComposeBuffer per process so callback
+ * resolution and compose state survive across handler invocations.
+ */
+import { dispatchCommand, parseSlash, COMMAND_HANDLERS } from './commands.js';
+import { sendTg, editTg } from '../../lib/telegram-bot-api.js';
+import { CallbackMap } from './callback-mapping.js';
+import { ComposeBuffer } from './compose-buffer.js';
+const PLUGIN_TAG = '[cc-openclaw/telegram-mirror/inbound]';
+export function createHandlerState() {
+    return {
+        callbackMap: new CallbackMap(),
+        composeBuffer: new ComposeBuffer(),
+    };
+}
+/**
+ * The set of slash commands the mirror claims. Names match what
+ * dispatchCommand recognises (commands.ts COMMAND_HANDLERS keys).
+ */
+const MIRROR_COMMANDS = new Set(Object.keys(COMMAND_HANDLERS));
+/**
+ * Forward a single TelegramAction to the actual Telegram API. Returns
+ * the API response (or {ok:false} on failure). Pure I/O — no state
+ * mutation.
+ *
+ * editMessageText and sendDocument variants land in v0.25.2 when the
+ * render pipeline and plan-attachment dispatch wire up.
+ */
+async function forwardAction(action, threadId, logger) {
+    try {
+        if (action.type === 'sendMessage') {
+            await sendTg(String(action.chat_id), action.text, threadId !== undefined ? String(threadId) : undefined, action.reply_markup);
+            return;
+        }
+        if (action.type === 'editMessageText') {
+            await editTg(String(action.chat_id), action.message_id, action.text, action.reply_markup);
+            return;
+        }
+        // sendDocument: v0.25.2 — plan-mode attachment wire-up.
+        logger.warn(`${PLUGIN_TAG} action type "${action.type}" not yet forwarded (deferred to v0.25.2)`);
+    }
+    catch (err) {
+        logger.warn(`${PLUGIN_TAG} forwardAction failed: ${err.message}`);
+    }
+}
+/**
+ * Register the inbound dispatcher. Called by mirror's register() at boot.
+ *
+ * Hooked to `before_dispatch` — OpenClaw's name for the inbound-message
+ * event surface. We return `{ handled: true }` to claim the message when
+ * it's a known mirror slash command; `undefined` lets the event proceed
+ * to OpenClaw's default routing (which is what we want for non-slash
+ * user text destined for the model).
+ */
+export function registerInboundHandler(api, state = createHandlerState()) {
+    const logger = (api.logger ?? console);
+    api.on('before_dispatch', async (...args) => {
+        const event = args[0];
+        if (!event)
+            return undefined;
+        if (event.channel !== 'telegram')
+            return undefined;
+        // callback_query rides on `before_dispatch` too — deferred to v0.25.2.
+        if (event.raw?.callback_query)
+            return undefined;
+        const text = event.raw?.message?.text;
+        if (typeof text !== 'string')
+            return undefined;
+        const parsed = parseSlash(text);
+        if (!parsed)
+            return undefined;
+        if (!MIRROR_COMMANDS.has(parsed.cmd))
+            return undefined;
+        const chatRaw = event.raw?.message?.chat?.id;
+        const chatId = chatRaw !== undefined && chatRaw !== null ? String(chatRaw) : '';
+        if (!chatId)
+            return undefined;
+        const threadId = event.raw?.message?.message_thread_id;
+        const result = dispatchCommand(parsed, {
+            chatId,
+            callbackMap: state.callbackMap,
+            composeBuffer: state.composeBuffer,
+        });
+        if (!result)
+            return undefined;
+        for (const action of result.actions) {
+            await forwardAction(action, threadId, logger);
+        }
+        logger.info(`${PLUGIN_TAG} dispatched /${parsed.cmd}${parsed.args.length ? ' ' + parsed.args.join(' ') : ''} (chat=${chatId}, actions=${result.actions.length})`);
+        return { handled: true };
+    });
+    logger.info(`${PLUGIN_TAG} subscribed to before_dispatch — ${MIRROR_COMMANDS.size} commands armed.`);
+    return state;
+}
+//# sourceMappingURL=inbound-handler.js.map

package/dist/src/channels/telegram-mirror/inbound-handler.js.map

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

package/dist/src/channels/telegram-mirror/index.js

@@ -18,6 +18,7 @@
  */
 import { defaultRegisterGuard } from '../../lib/register-guard.js';
 import { initBotTokenFromConfig } from '../../lib/telegram-bot-api.js';
+import { registerInboundHandler } from './inbound-handler.js';
 /**
  * Mirror channel register — idempotent via defaultRegisterGuard.
  *
@@ -28,14 +29,21 @@ import { initBotTokenFromConfig } from '../../lib/telegram-bot-api.js';
 export function register(api) {
     defaultRegisterGuard.guard('cc-openclaw/telegram-mirror', api, () => {
         const logger = api.logger || console;
-        logger.info('[cc-openclaw/telegram-mirror] M0 skeleton loaded — no handlers wired yet (CC_OPENCLAW_TERMINAL_MIRROR=1).');
-        // v0.25.0 M16 — initialise Telegram bot token (token sourcing migrated
+        logger.info('[cc-openclaw/telegram-mirror] register() — wiring inbound dispatcher (v0.25.1).');
+        // v0.25.0 M16 — initialise Telegram bot token (sourcing migrated
         // out of the legacy live-card module into src/lib/telegram-bot-api).
         // Same precedence as before: api.config first, then ~/.openclaw/openclaw.json.
         initBotTokenFromConfig({
             config: api.config,
             logger: logger,
         });
+        // v0.25.1 — subscribe before_dispatch and route mirror slash commands
+        // through dispatchCommand → telegram-bot-api. Without this, v0.25.0's
+        // handlers were unreachable from the live Telegram path.
+        registerInboundHandler({
+            on: api.on.bind(api),
+            logger: logger,
+        });
     });
 }
 //# sourceMappingURL=index.js.map

package/dist/src/channels/telegram-mirror/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/channels/telegram-mirror/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAOvE;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAc;IACrC,oBAAoB,CAAC,KAAK,CAAC,6BAA6B,EAAE,GAAG,EAAE,GAAG,EAAE;QAClE,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,OAAO,CAAC;QACrC,MAAM,CAAC,IAAI,CACT,2GAA2G,CAC5G,CAAC;QACF,uEAAuE;QACvE,qEAAqE;QACrE,+EAA+E;QAC/E,sBAAsB,CAAC;YACrB,MAAM,EAAG,GAAuD,CAAC,MAAM;YACvE,MAAM,EAAE,MAAiF;SAC1F,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/channels/telegram-mirror/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAO9D;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAc;IACrC,oBAAoB,CAAC,KAAK,CAAC,6BAA6B,EAAE,GAAG,EAAE,GAAG,EAAE;QAClE,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,OAAO,CAAC;QACrC,MAAM,CAAC,IAAI,CACT,iFAAiF,CAClF,CAAC;QACF,iEAAiE;QACjE,qEAAqE;QACrE,+EAA+E;QAC/E,sBAAsB,CAAC;YACrB,MAAM,EAAG,GAAuD,CAAC,MAAM;YACvE,MAAM,EAAE,MAAiF;SAC1F,CAAC,CAAC;QACH,sEAAsE;QACtE,sEAAsE;QACtE,yDAAyD;QACzD,sBAAsB,CAAC;YACrB,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC;YACpB,MAAM,EAAE,MAAiF;SAC1F,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a1hvdy/cc-openclaw",
-  "version": "0.25.0",
+  "version": "0.25.1",
   "description": "A1xAI's Anthropic CLI bridge plugin for OpenClaw",
   "author": "@a1cy",
   "license": "MIT",