@a1hvdy/cc-openclaw 0.24.0 → 0.25.1

package/dist/src/channels/telegram-mirror/commands.d.ts

@@ -0,0 +1,142 @@
+/**
+ * src/channels/telegram-mirror/commands.ts — v0.25.0 M4.
+ *
+ * Top-7 phone-tier slash commands per PRP §5 M4:
+ *   /sessions /new <slug> /stop /status /compact /cost /rewind
+ *
+ * Each handler is a pure function returning a CommandResult — a list of
+ * Telegram API actions the dispatch layer consumes. No I/O happens here
+ * beyond reading session-registry (which itself isolates I/O behind an
+ * env-overridable path for tests).
+ *
+ * G-2 resolution (2026-05-19): per-message inline keyboards + typed-form
+ * — no persistent ReplyKeyboardMarkup. /sessions and /cost have an
+ * inline-keyboard form; the rest are text-only.
+ *
+ * Decision refs:
+ *   • ADR-003 — slug registry is the canonical source for /sessions, /new,
+ *     /stop, /status.
+ *   • ADR-004 — callback_data slots come from the per-handler CallbackMap.
+ *   • ADR-008 — failure handlers (M12) consume CommandResult.actions[].
+ *
+ * Out of scope for M4 (per "no premature resolution"):
+ *   • Actually spawning / killing claude subprocesses (M5+ wiring).
+ *   • Real quota numbers in /cost — uses QuotaReader stub (M11 wires real).
+ *   • Threshold notifications / 95% pause button (M11).
+ *   • Plan attachment via sendDocument (M9).
+ */
+import { CallbackMap } from './callback-mapping.js';
+import { type SessionState, type InlineButton } from './sessions-keyboard.js';
+import { type QuotaReader } from './quota-reader.js';
+import type { ComposeBuffer } from './compose-buffer.js';
+/**
+ * Discriminated union of Telegram API actions a command may emit.
+ * Maps 1:1 to the test mock layer at tests/.../__mocks__/telegram-api.ts.
+ */
+export type TelegramAction = {
+    type: 'sendMessage';
+    chat_id: string | number;
+    text: string;
+    reply_markup?: {
+        inline_keyboard: InlineButton[][];
+    };
+    parse_mode?: 'MarkdownV2';
+} | {
+    type: 'editMessageText';
+    chat_id: string | number;
+    message_id: number;
+    text: string;
+    reply_markup?: {
+        inline_keyboard: InlineButton[][];
+    };
+    parse_mode?: 'MarkdownV2';
+} | {
+    type: 'sendDocument';
+    chat_id: string | number;
+    filename: string;
+    content: string;
+    caption?: string;
+    reply_markup?: {
+        inline_keyboard: InlineButton[][];
+    };
+};
+export interface CommandContext {
+    chatId: string | number;
+    args: string[];
+    callbackMap: CallbackMap;
+    /** Optional state lookup for status-rich rows; defaults all entries to 'idle'. */
+    stateLookup?: (slug: string) => SessionState;
+    /** Optional quota reader for /cost; defaults to stubQuotaReader. */
+    quotaReader?: QuotaReader;
+    /** Optional clock for deterministic last-activity tests. */
+    now?: number;
+    /** Required for /compose and /send (M7); other handlers ignore. */
+    composeBuffer?: ComposeBuffer;
+}
+export interface CommandResult {
+    actions: TelegramAction[];
+    /**
+     * When the command produces user-message content destined for the
+     * engine (currently only /send after /compose), the concatenated
+     * payload appears here. M5+ engine bridging consumes this field to
+     * feed openai-compat as a single user message. Absent when the command
+     * is purely a UI surface (most handlers).
+     */
+    delivery?: {
+        payload: string;
+    };
+}
+/**
+ * Tiny parser. Telegram slash messages look like "/cmd arg1 arg2" — split
+ * on whitespace, drop the leading '/', strip any "@botname" suffix.
+ * Returns undefined for non-slash input.
+ */
+export interface ParsedSlash {
+    cmd: string;
+    args: string[];
+}
+export declare function parseSlash(text: string): ParsedSlash | undefined;
+export declare function handleSessions(ctx: CommandContext): CommandResult;
+export declare function handleNew(ctx: CommandContext): CommandResult;
+export declare function handleStop(ctx: CommandContext): CommandResult;
+export declare function handleStatus(ctx: CommandContext): CommandResult;
+export declare function handleCompact(ctx: CommandContext): CommandResult;
+export declare function handleCost(ctx: CommandContext): CommandResult;
+export declare function handleRewind(ctx: CommandContext): CommandResult;
+/**
+ * Open a compose session for the chat. M7 — drafts append until /send.
+ * Returns a force_reply prompt so Telegram nudges the user into reply mode.
+ */
+export declare function handleCompose(ctx: CommandContext): CommandResult;
+/**
+ * Commit the active compose buffer. Returns the concatenated payload via
+ * CommandResult.delivery for the engine bridge to consume. If no session
+ * is active, returns a friendly error message.
+ */
+export declare function handleSend(ctx: CommandContext): CommandResult;
+/**
+ * Cancel the active compose buffer without sending. Useful when the user
+ * starts composing then changes their mind.
+ */
+export declare function handleCancel(ctx: CommandContext): CommandResult;
+/**
+ * Surface a Y/N inline keyboard so A1 records opened-laptop-today for
+ * the soak instrumentation. Idempotency is enforced by SoakLogger
+ * downstream — handler always emits the keyboard and lets the callback
+ * resolver call recordLaptopCheck().
+ */
+export declare function handleSoakCheck(ctx: CommandContext): CommandResult;
+export type CommandHandler = (ctx: CommandContext) => CommandResult;
+export declare const COMMAND_HANDLERS: Record<string, CommandHandler>;
+/**
+ * Telegram bot commands list — declarative source for M5's setMyCommands sync.
+ */
+export declare const TOP_7_COMMANDS: ReadonlyArray<{
+    command: string;
+    description: string;
+}>;
+/**
+ * Route a parsed slash command to its handler. Returns undefined for
+ * unknown commands so the caller can fall back to "unknown command" UX.
+ */
+export declare function dispatchCommand(parsed: ParsedSlash, ctxBase: Omit<CommandContext, 'args'>): CommandResult | undefined;

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

@@ -0,0 +1,389 @@
+/**
+ * src/channels/telegram-mirror/commands.ts — v0.25.0 M4.
+ *
+ * Top-7 phone-tier slash commands per PRP §5 M4:
+ *   /sessions /new <slug> /stop /status /compact /cost /rewind
+ *
+ * Each handler is a pure function returning a CommandResult — a list of
+ * Telegram API actions the dispatch layer consumes. No I/O happens here
+ * beyond reading session-registry (which itself isolates I/O behind an
+ * env-overridable path for tests).
+ *
+ * G-2 resolution (2026-05-19): per-message inline keyboards + typed-form
+ * — no persistent ReplyKeyboardMarkup. /sessions and /cost have an
+ * inline-keyboard form; the rest are text-only.
+ *
+ * Decision refs:
+ *   • ADR-003 — slug registry is the canonical source for /sessions, /new,
+ *     /stop, /status.
+ *   • ADR-004 — callback_data slots come from the per-handler CallbackMap.
+ *   • ADR-008 — failure handlers (M12) consume CommandResult.actions[].
+ *
+ * Out of scope for M4 (per "no premature resolution"):
+ *   • Actually spawning / killing claude subprocesses (M5+ wiring).
+ *   • Real quota numbers in /cost — uses QuotaReader stub (M11 wires real).
+ *   • Threshold notifications / 95% pause button (M11).
+ *   • Plan attachment via sendDocument (M9).
+ */
+import { register, unregister, list, getBySlug, } from '../../lib/session-registry.js';
+import { buildSessionsKeyboard, formatLastActivity, } from './sessions-keyboard.js';
+import { stubQuotaReader } from './quota-reader.js';
+export function parseSlash(text) {
+    const trimmed = text.trim();
+    if (!trimmed.startsWith('/'))
+        return undefined;
+    const tokens = trimmed.slice(1).split(/\s+/).filter((t) => t.length > 0);
+    if (tokens.length === 0)
+        return undefined;
+    const head = tokens[0];
+    const cmd = head.includes('@') ? head.split('@')[0] : head;
+    return { cmd: cmd.toLowerCase(), args: tokens.slice(1) };
+}
+// ── /sessions ────────────────────────────────────────────────────────────
+function enrichRows(entries, stateLookup) {
+    return entries.map((e) => ({
+        slug: e.slug,
+        sessionName: e.sessionName,
+        state: stateLookup(e.slug),
+        lastUsedAt: e.lastUsedAt,
+    }));
+}
+export function handleSessions(ctx) {
+    const entries = list();
+    const stateLookup = ctx.stateLookup ?? (() => 'idle');
+    const rows = enrichRows(entries, stateLookup);
+    const kb = buildSessionsKeyboard({
+        rows,
+        callbackMap: ctx.callbackMap,
+        now: ctx.now,
+    });
+    const header = entries.length === 0
+        ? 'No sessions registered yet. Tap ➕ New to create one.'
+        : `Sessions (${entries.length})${kb.pageCount > 1 ? ` · page ${kb.page + 1}/${kb.pageCount}` : ''}`;
+    return {
+        actions: [
+            {
+                type: 'sendMessage',
+                chat_id: ctx.chatId,
+                text: header,
+                reply_markup: { inline_keyboard: kb.inline_keyboard },
+            },
+        ],
+    };
+}
+// ── /new <slug> ──────────────────────────────────────────────────────────
+const SLUG_PATTERN = /^[a-z0-9][a-z0-9-_]{0,39}$/i;
+export function handleNew(ctx) {
+    const slug = ctx.args[0];
+    if (!slug) {
+        return {
+            actions: [
+                {
+                    type: 'sendMessage',
+                    chat_id: ctx.chatId,
+                    text: 'Usage: /new <slug>\nExample: /new cc-openclaw',
+                },
+            ],
+        };
+    }
+    if (!SLUG_PATTERN.test(slug)) {
+        return {
+            actions: [
+                {
+                    type: 'sendMessage',
+                    chat_id: ctx.chatId,
+                    text: `Invalid slug "${slug}". Use [a-z0-9-_], max 40 chars, starting with [a-z0-9].`,
+                },
+            ],
+        };
+    }
+    const existing = getBySlug(slug);
+    // Session-name comes from the engine; M4 stores a placeholder that M5+ overwrites.
+    const sessionName = existing?.sessionName ?? `pending-${slug}-${Date.now()}`;
+    register(slug, sessionName);
+    return {
+        actions: [
+            {
+                type: 'sendMessage',
+                chat_id: ctx.chatId,
+                text: existing
+                    ? `Session "${slug}" already registered — fronted.`
+                    : `Session "${slug}" registered. Engine wire-up lands in M5.`,
+            },
+        ],
+    };
+}
+// ── /stop ────────────────────────────────────────────────────────────────
+export function handleStop(ctx) {
+    const slug = ctx.args[0];
+    if (!slug) {
+        return {
+            actions: [
+                {
+                    type: 'sendMessage',
+                    chat_id: ctx.chatId,
+                    text: 'Usage: /stop <slug>',
+                },
+            ],
+        };
+    }
+    const removed = unregister(slug);
+    return {
+        actions: [
+            {
+                type: 'sendMessage',
+                chat_id: ctx.chatId,
+                text: removed
+                    ? `Session "${slug}" stopped.`
+                    : `No registered session named "${slug}".`,
+            },
+        ],
+    };
+}
+// ── /status ──────────────────────────────────────────────────────────────
+export function handleStatus(ctx) {
+    const entries = list();
+    const stateLookup = ctx.stateLookup ?? (() => 'idle');
+    const now = ctx.now ?? Date.now();
+    if (entries.length === 0) {
+        return {
+            actions: [
+                {
+                    type: 'sendMessage',
+                    chat_id: ctx.chatId,
+                    text: 'No sessions registered.',
+                },
+            ],
+        };
+    }
+    const lines = [`Active sessions: ${entries.length}`];
+    for (const e of entries) {
+        lines.push(`• ${e.slug} (${stateLookup(e.slug)}, ${formatLastActivity(e.lastUsedAt, now)})`);
+    }
+    return {
+        actions: [{ type: 'sendMessage', chat_id: ctx.chatId, text: lines.join('\n') }],
+    };
+}
+// ── /compact ─────────────────────────────────────────────────────────────
+export function handleCompact(ctx) {
+    // M4: surface the intent. Actual context-compaction wiring runs through
+    // the cc-handler module (existing /cc compact path) — bridging the
+    // mirror to that handler lands in M5 alongside the rest of the engine
+    // integration. Without the bridge, the user sees a clear "queued" state.
+    return {
+        actions: [
+            {
+                type: 'sendMessage',
+                chat_id: ctx.chatId,
+                text: '⏳ Compact queued — engine wire-up lands in M5.',
+            },
+        ],
+    };
+}
+// ── /cost ────────────────────────────────────────────────────────────────
+function formatQuotaSummary(snap) {
+    const pct = snap.maxPercent.toFixed(1);
+    const burn = snap.weeklyBurn.toFixed(2);
+    return `Max 20x: ${pct}% used · Weekly burn: $${burn}`;
+}
+export function handleCost(ctx) {
+    const reader = ctx.quotaReader ?? stubQuotaReader;
+    const snap = reader.read();
+    const summaryText = formatQuotaSummary(snap);
+    // Inline detail button — payload tells the callback handler (M11+) which
+    // subview to expand: per-day rollup, top sessions, or weekly burn breakdown.
+    const detailCb = ctx.callbackMap.create({ action: 'cost-detail' });
+    const dailyCb = ctx.callbackMap.create({ action: 'cost-daily' });
+    return {
+        actions: [
+            {
+                type: 'sendMessage',
+                chat_id: ctx.chatId,
+                text: summaryText,
+                reply_markup: {
+                    inline_keyboard: [
+                        [{ text: '📊 Detail', callback_data: detailCb }],
+                        [{ text: '📅 Per-day', callback_data: dailyCb }],
+                    ],
+                },
+            },
+        ],
+    };
+}
+// ── /rewind ──────────────────────────────────────────────────────────────
+export function handleRewind(ctx) {
+    // M4: queued — actual rewind walks the cc-handler resume path (deferred
+    // to M5 with the rest of engine bridging).
+    return {
+        actions: [
+            {
+                type: 'sendMessage',
+                chat_id: ctx.chatId,
+                text: '⏪ Rewind queued — engine wire-up lands in M5.',
+            },
+        ],
+    };
+}
+// ── /compose ─────────────────────────────────────────────────────────────
+/**
+ * Open a compose session for the chat. M7 — drafts append until /send.
+ * Returns a force_reply prompt so Telegram nudges the user into reply mode.
+ */
+export function handleCompose(ctx) {
+    if (!ctx.composeBuffer) {
+        return {
+            actions: [
+                {
+                    type: 'sendMessage',
+                    chat_id: ctx.chatId,
+                    text: '⚠️ /compose unavailable — buffer not wired in this context.',
+                },
+            ],
+        };
+    }
+    ctx.composeBuffer.start(String(ctx.chatId));
+    return {
+        actions: [
+            {
+                type: 'sendMessage',
+                chat_id: ctx.chatId,
+                text: '✍️ Compose mode opened. Send messages; finish with /send (or /cancel to abort).',
+            },
+        ],
+    };
+}
+/**
+ * Commit the active compose buffer. Returns the concatenated payload via
+ * CommandResult.delivery for the engine bridge to consume. If no session
+ * is active, returns a friendly error message.
+ */
+export function handleSend(ctx) {
+    if (!ctx.composeBuffer) {
+        return {
+            actions: [
+                {
+                    type: 'sendMessage',
+                    chat_id: ctx.chatId,
+                    text: '⚠️ /send unavailable — buffer not wired in this context.',
+                },
+            ],
+        };
+    }
+    const payload = ctx.composeBuffer.commit(String(ctx.chatId));
+    if (payload === undefined) {
+        return {
+            actions: [
+                {
+                    type: 'sendMessage',
+                    chat_id: ctx.chatId,
+                    text: 'No compose session active. Start one with /compose.',
+                },
+            ],
+        };
+    }
+    // Confirmation surfaces a short preview (≤ 120 chars) so the user sees
+    // what was sent. The full payload travels via CommandResult.delivery
+    // for M5+ engine bridging.
+    const preview = payload.length > 120 ? payload.slice(0, 117) + '...' : payload;
+    return {
+        actions: [
+            {
+                type: 'sendMessage',
+                chat_id: ctx.chatId,
+                text: `📤 Sent (${payload.length} chars): ${preview}`,
+            },
+        ],
+        delivery: { payload },
+    };
+}
+/**
+ * Cancel the active compose buffer without sending. Useful when the user
+ * starts composing then changes their mind.
+ */
+export function handleCancel(ctx) {
+    if (!ctx.composeBuffer) {
+        return {
+            actions: [
+                {
+                    type: 'sendMessage',
+                    chat_id: ctx.chatId,
+                    text: '⚠️ /cancel unavailable — buffer not wired in this context.',
+                },
+            ],
+        };
+    }
+    const had = ctx.composeBuffer.cancel(String(ctx.chatId));
+    return {
+        actions: [
+            {
+                type: 'sendMessage',
+                chat_id: ctx.chatId,
+                text: had ? '🚫 Compose cancelled.' : 'No compose session was active.',
+            },
+        ],
+    };
+}
+// ── /soak-check (M14) ────────────────────────────────────────────────────
+/**
+ * Surface a Y/N inline keyboard so A1 records opened-laptop-today for
+ * the soak instrumentation. Idempotency is enforced by SoakLogger
+ * downstream — handler always emits the keyboard and lets the callback
+ * resolver call recordLaptopCheck().
+ */
+export function handleSoakCheck(ctx) {
+    const yesCb = ctx.callbackMap.create({ action: 'soak-check', openedLaptop: true });
+    const noCb = ctx.callbackMap.create({ action: 'soak-check', openedLaptop: false });
+    return {
+        actions: [
+            {
+                type: 'sendMessage',
+                chat_id: ctx.chatId,
+                text: 'Opened the laptop today? (one tap per day for v0.25.0 soak)',
+                reply_markup: {
+                    inline_keyboard: [
+                        [
+                            { text: '✅ Yes', callback_data: yesCb },
+                            { text: '❌ No', callback_data: noCb },
+                        ],
+                    ],
+                },
+            },
+        ],
+    };
+}
+export const COMMAND_HANDLERS = {
+    sessions: handleSessions,
+    new: handleNew,
+    stop: handleStop,
+    status: handleStatus,
+    compact: handleCompact,
+    cost: handleCost,
+    rewind: handleRewind,
+    compose: handleCompose,
+    send: handleSend,
+    cancel: handleCancel,
+    'soak-check': handleSoakCheck,
+};
+/**
+ * Telegram bot commands list — declarative source for M5's setMyCommands sync.
+ */
+export const TOP_7_COMMANDS = [
+    { command: 'sessions', description: 'List + switch fronted Claude session' },
+    { command: 'new', description: 'Register a new session slug — /new <slug>' },
+    { command: 'stop', description: 'Stop a registered session — /stop <slug>' },
+    { command: 'status', description: 'Show active sessions and their state' },
+    { command: 'compact', description: 'Compact context on the fronted session' },
+    { command: 'cost', description: 'Show Max 20x usage + weekly burn' },
+    { command: 'rewind', description: 'Rewind the fronted session by one user message' },
+];
+/**
+ * Route a parsed slash command to its handler. Returns undefined for
+ * unknown commands so the caller can fall back to "unknown command" UX.
+ */
+export function dispatchCommand(parsed, ctxBase) {
+    const handler = COMMAND_HANDLERS[parsed.cmd];
+    if (!handler)
+        return undefined;
+    return handler({ ...ctxBase, args: parsed.args });
+}
+//# sourceMappingURL=commands.js.map

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

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

package/dist/src/channels/telegram-mirror/compose-buffer.d.ts

@@ -0,0 +1,71 @@
+/**
+ * src/channels/telegram-mirror/compose-buffer.ts — v0.25.0 M7.
+ *
+ * Per-chat buffer of draft messages between /compose and /send. The
+ * dispatch layer feeds non-slash inbound messages here when a chat is in
+ * compose mode; /send commits the buffer to one concatenated payload that
+ * M5+ engine bridging delivers to openai-compat as a single user message.
+ *
+ * Decision: ADR-007 — the 5-second rapid-burst window (M8) is a SEPARATE
+ * concatenation path. /compose is the explicit, user-controlled buffer
+ * with no time limit (within reason); rapid-burst is the implicit window
+ * for accidental double-taps. M7's compose buffer takes priority over
+ * the M8 burst handler when a compose session is active.
+ *
+ * Timeout exists purely as a safety valve — a compose session that's
+ * been idle for > timeoutMs is considered abandoned and silently cleared
+ * on the next interaction. Default 30 minutes; tests inject shorter.
+ */
+export interface ComposeBufferOptions {
+    /** Injectable clock for tests; defaults to Date.now. */
+    now?: () => number;
+    /** Idle-session timeout in milliseconds (default 30 minutes). */
+    timeoutMs?: number;
+}
+export declare class ComposeBuffer {
+    private readonly sessions;
+    private readonly now;
+    private readonly timeoutMs;
+    constructor(opts?: ComposeBufferOptions);
+    /**
+     * Open a compose session for the chat. If a session is already open it
+     * is replaced — the user is restarting the buffer intentionally.
+     */
+    start(chatId: string): void;
+    /**
+     * Append a draft message to the active compose session. Returns true
+     * when the message was buffered, false when no session was open (or the
+     * session timed out and was discarded). Callers use the return to
+     * decide whether to route the message through the regular inbound path
+     * instead.
+     */
+    append(chatId: string, text: string): boolean;
+    /**
+     * Commit the active compose session. Returns the concatenated payload
+     * (drafts joined by `separator`) and clears the session, or undefined
+     * when no session was open / the session timed out. Default separator
+     * is "\n\n" — produces natural paragraph breaks between drafts.
+     */
+    commit(chatId: string, separator?: string): string | undefined;
+    /**
+     * Drop the compose session without committing. Returns true iff a
+     * session existed.
+     */
+    cancel(chatId: string): boolean;
+    /**
+     * Lazy-expiring isActive. Returns true only when a non-stale session
+     * exists; stale sessions are dropped on the call.
+     */
+    isActive(chatId: string): boolean;
+    /**
+     * Number of drafts buffered (without committing). Useful for /compose
+     * status surfaces.
+     */
+    draftCount(chatId: string): number;
+    /**
+     * Inspect drafts without committing — used for preview UX. Returns a
+     * copy so callers can't mutate internal state.
+     */
+    peek(chatId: string): string[];
+    private isExpired;
+}