@a1hvdy/cc-openclaw 0.24.0 → 0.25.0

package/dist/src/channels/telegram-mirror/compose-buffer.js

@@ -0,0 +1,110 @@
+/**
+ * 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.
+ */
+const DEFAULT_COMPOSE_TIMEOUT_MS = 30 * 60_000;
+export class ComposeBuffer {
+    sessions = new Map();
+    now;
+    timeoutMs;
+    constructor(opts = {}) {
+        this.now = opts.now ?? Date.now;
+        this.timeoutMs = opts.timeoutMs ?? DEFAULT_COMPOSE_TIMEOUT_MS;
+    }
+    /**
+     * 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) {
+        this.sessions.set(chatId, { chatId, startedAt: this.now(), drafts: [] });
+    }
+    /**
+     * 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, text) {
+        const session = this.sessions.get(chatId);
+        if (!session)
+            return false;
+        if (this.isExpired(session)) {
+            this.sessions.delete(chatId);
+            return false;
+        }
+        session.drafts.push({ text, timestamp: this.now() });
+        return true;
+    }
+    /**
+     * 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, separator = '\n\n') {
+        const session = this.sessions.get(chatId);
+        if (!session)
+            return undefined;
+        if (this.isExpired(session)) {
+            this.sessions.delete(chatId);
+            return undefined;
+        }
+        const payload = session.drafts.map((d) => d.text).join(separator);
+        this.sessions.delete(chatId);
+        return payload;
+    }
+    /**
+     * Drop the compose session without committing. Returns true iff a
+     * session existed.
+     */
+    cancel(chatId) {
+        return this.sessions.delete(chatId);
+    }
+    /**
+     * Lazy-expiring isActive. Returns true only when a non-stale session
+     * exists; stale sessions are dropped on the call.
+     */
+    isActive(chatId) {
+        const session = this.sessions.get(chatId);
+        if (!session)
+            return false;
+        if (this.isExpired(session)) {
+            this.sessions.delete(chatId);
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Number of drafts buffered (without committing). Useful for /compose
+     * status surfaces.
+     */
+    draftCount(chatId) {
+        return this.sessions.get(chatId)?.drafts.length ?? 0;
+    }
+    /**
+     * Inspect drafts without committing — used for preview UX. Returns a
+     * copy so callers can't mutate internal state.
+     */
+    peek(chatId) {
+        return this.sessions.get(chatId)?.drafts.map((d) => d.text) ?? [];
+    }
+    isExpired(session) {
+        return this.now() - session.startedAt > this.timeoutMs;
+    }
+}
+//# sourceMappingURL=compose-buffer.js.map

package/dist/src/channels/telegram-mirror/compose-buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-buffer.js","sourceRoot":"","sources":["../../../../src/channels/telegram-mirror/compose-buffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,0BAA0B,GAAG,EAAE,GAAG,MAAM,CAAC;AAe/C,MAAM,OAAO,aAAa;IACP,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;IAC7C,GAAG,CAAe;IAClB,SAAS,CAAS;IAEnC,YAAY,OAA6B,EAAE;QACzC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,0BAA0B,CAAC;IAChE,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAc;QAClB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,MAAc,EAAE,IAAY;QACjC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAC3B,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC7B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,MAAc,EAAE,SAAS,GAAG,MAAM;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAC/B,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC7B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAClE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC7B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,MAAc;QACnB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,MAAc;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAC3B,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC7B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,UAAU,CAAC,MAAc;QACvB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;IACvD,CAAC;IAED;;;OAGG;IACH,IAAI,CAAC,MAAc;QACjB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACpE,CAAC;IAEO,SAAS,CAAC,OAAuB;QACvC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IACzD,CAAC;CACF"}

package/dist/src/channels/telegram-mirror/cost-views.d.ts

@@ -0,0 +1,58 @@
+/**
+ * src/channels/telegram-mirror/cost-views.ts — v0.25.0 M11.
+ *
+ * Renderers for the /cost detail / per-day inline-keyboard subviews +
+ * threshold-notification message builder.
+ *
+ * Decision refs:
+ *   • ADR-004 — callback_data for the 🛑 Pause-now button at the 95%
+ *     notification uses CallbackMap.
+ *   • PRP M11 — 95% notification gets the pause button; 70/90 are
+ *     advisory text-only.
+ *
+ * Pure functions; tests assert directly against the strings + actions
+ * they produce.
+ */
+import type { CallbackMap } from './callback-mapping.js';
+import type { TelegramAction } from './commands.js';
+import type { QuotaSnapshot } from './quota-reader.js';
+import { type QuotaSnapshot as StatusTeeQuotaSnapshot } from '../../lib/status-tee-reader.js';
+import type { QuotaReader } from './quota-reader.js';
+/**
+ * Render the rich /cost detail subview. Includes:
+ *   • Header line with Max 20x percent and weekly burn.
+ *   • Top sessions list (up to 5) ranked by tokens.
+ *   • Empty-state friendly message when no data.
+ */
+export declare function renderCostDetail(snap: QuotaSnapshot): string;
+/**
+ * Render the per-day rollup subview. Up to the last 7 days, newest first.
+ */
+export declare function renderCostPerDay(snap: QuotaSnapshot): string;
+/**
+ * Build a threshold-crossed notification message. The 95% variant ships
+ * a 🛑 Pause-now button; the lower thresholds are text-only.
+ */
+export declare function buildThresholdNotification(opts: {
+    chatId: string | number;
+    threshold: number;
+    callbackMap: CallbackMap;
+}): TelegramAction;
+/**
+ * Adapter that wires the mirror's QuotaReader contract to the existing
+ * status-tee-reader.ts on disk. Reads the latest JSON snapshot under
+ * ~/.openclaw/workspace/memory/status-tee-* and projects it into the
+ * mirror's summary shape.
+ *
+ * Limitations vs. mirror's full QuotaSnapshot:
+ *   • status-tee carries fiveHour + sevenDay windows; we project the
+ *     sevenDay percent into maxPercent (falling back to fiveHour when
+ *     missing).
+ *   • status-tee does not carry weeklyBurn USD, topSessions, or
+ *     perDayRollup. Those fields land at zero / empty until a future
+ *     PRP (likely v0.26.0) extends status-tee's emit format.
+ *
+ * Returns a stub-shaped snapshot when status-tee data is missing or
+ * stale, so callers always get a usable object.
+ */
+export declare function createStatusTeeQuotaReader(reader?: () => StatusTeeQuotaSnapshot | null): QuotaReader;

package/dist/src/channels/telegram-mirror/cost-views.js

@@ -0,0 +1,121 @@
+/**
+ * src/channels/telegram-mirror/cost-views.ts — v0.25.0 M11.
+ *
+ * Renderers for the /cost detail / per-day inline-keyboard subviews +
+ * threshold-notification message builder.
+ *
+ * Decision refs:
+ *   • ADR-004 — callback_data for the 🛑 Pause-now button at the 95%
+ *     notification uses CallbackMap.
+ *   • PRP M11 — 95% notification gets the pause button; 70/90 are
+ *     advisory text-only.
+ *
+ * Pure functions; tests assert directly against the strings + actions
+ * they produce.
+ */
+import { readQuotaSnapshot as readStatusTeeQuotaSnapshot, } from '../../lib/status-tee-reader.js';
+/**
+ * Render the rich /cost detail subview. Includes:
+ *   • Header line with Max 20x percent and weekly burn.
+ *   • Top sessions list (up to 5) ranked by tokens.
+ *   • Empty-state friendly message when no data.
+ */
+export function renderCostDetail(snap) {
+    const lines = [];
+    lines.push('📊 Cost detail');
+    lines.push(`Max 20x: ${snap.maxPercent.toFixed(1)}% used`);
+    lines.push(`Weekly burn: $${snap.weeklyBurn.toFixed(2)}`);
+    if (snap.topSessions.length === 0) {
+        lines.push('');
+        lines.push('No session-level data yet.');
+        return lines.join('\n');
+    }
+    lines.push('');
+    lines.push('Top sessions by tokens:');
+    for (const s of snap.topSessions.slice(0, 5)) {
+        lines.push(`  • ${s.slug} — ${formatTokens(s.tokens)}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Render the per-day rollup subview. Up to the last 7 days, newest first.
+ */
+export function renderCostPerDay(snap) {
+    const lines = ['📅 Per-day rollup'];
+    if (snap.perDayRollup.length === 0) {
+        lines.push('');
+        lines.push('No daily rollup data yet.');
+        return lines.join('\n');
+    }
+    const sparkChars = ['▁', '▂', '▃', '▄', '▅', '▆', '▇', '█'];
+    for (const day of snap.perDayRollup.slice(0, 7)) {
+        const idx = Math.min(sparkChars.length - 1, Math.max(0, Math.floor(day.percent / 100 * sparkChars.length)));
+        lines.push(`  ${day.date}  ${sparkChars[idx]}  ${day.percent.toFixed(1)}%`);
+    }
+    return lines.join('\n');
+}
+function formatTokens(tokens) {
+    if (tokens >= 1_000_000)
+        return `${(tokens / 1_000_000).toFixed(1)}M`;
+    if (tokens >= 1_000)
+        return `${(tokens / 1_000).toFixed(0)}k`;
+    return String(tokens);
+}
+/**
+ * Build a threshold-crossed notification message. The 95% variant ships
+ * a 🛑 Pause-now button; the lower thresholds are text-only.
+ */
+export function buildThresholdNotification(opts) {
+    const { chatId, threshold, callbackMap } = opts;
+    if (threshold >= 95) {
+        const pauseCb = callbackMap.create({ action: 'pause-now' });
+        return {
+            type: 'sendMessage',
+            chat_id: chatId,
+            text: `🛑 Max 20x at ${threshold}% — heading into the auto-pause zone.`,
+            reply_markup: {
+                inline_keyboard: [
+                    [{ text: '🛑 Pause now', callback_data: pauseCb }],
+                ],
+            },
+        };
+    }
+    const glyph = threshold >= 90 ? '🔴' : '🟡';
+    return {
+        type: 'sendMessage',
+        chat_id: chatId,
+        text: `${glyph} Max 20x at ${threshold}%.`,
+    };
+}
+/**
+ * Adapter that wires the mirror's QuotaReader contract to the existing
+ * status-tee-reader.ts on disk. Reads the latest JSON snapshot under
+ * ~/.openclaw/workspace/memory/status-tee-* and projects it into the
+ * mirror's summary shape.
+ *
+ * Limitations vs. mirror's full QuotaSnapshot:
+ *   • status-tee carries fiveHour + sevenDay windows; we project the
+ *     sevenDay percent into maxPercent (falling back to fiveHour when
+ *     missing).
+ *   • status-tee does not carry weeklyBurn USD, topSessions, or
+ *     perDayRollup. Those fields land at zero / empty until a future
+ *     PRP (likely v0.26.0) extends status-tee's emit format.
+ *
+ * Returns a stub-shaped snapshot when status-tee data is missing or
+ * stale, so callers always get a usable object.
+ */
+export function createStatusTeeQuotaReader(reader = readStatusTeeQuotaSnapshot) {
+    return {
+        read() {
+            const tee = reader();
+            const window = tee?.sevenDay ?? tee?.fiveHour;
+            return {
+                maxPercent: window?.usedPercent ?? 0,
+                weeklyBurn: 0,
+                topSessions: [],
+                perDayRollup: [],
+            };
+        },
+    };
+}
+//# sourceMappingURL=cost-views.js.map

package/dist/src/channels/telegram-mirror/cost-views.js.map

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

package/dist/src/channels/telegram-mirror/failure/callback-data-overflow.d.ts

@@ -0,0 +1,21 @@
+/**
+ * failure/callback-data-overflow.ts — v0.25.0 M12.
+ *
+ * Mode: callback-data-overflow. Defensive — should never fire because
+ * every callback_data slot routes through CallbackMap (ADR-004) and the
+ * 8-char base36 ids fit in 8 UTF-8 bytes. If a future regression bypasses
+ * the map and a literal payload > 64 bytes makes it to Telegram, the API
+ * rejects with 400 BUTTON_DATA_INVALID; this handler surfaces the
+ * recovery instruction. The PRP frames the response shape as
+ * "never present at UX layer" — when it does, the mode is broken,
+ * not the user's input.
+ */
+import type { FailureHandler, FailureModuleMeta } from './types.js';
+export declare const META: FailureModuleMeta;
+export interface CallbackDataOverflowInfo {
+    /** The offending button label, for diagnostics. */
+    buttonLabel?: string;
+    /** The byte length that exceeded the cap. */
+    payloadBytes?: number;
+}
+export declare const handle: FailureHandler<CallbackDataOverflowInfo>;

package/dist/src/channels/telegram-mirror/failure/callback-data-overflow.js

@@ -0,0 +1,30 @@
+/**
+ * failure/callback-data-overflow.ts — v0.25.0 M12.
+ *
+ * Mode: callback-data-overflow. Defensive — should never fire because
+ * every callback_data slot routes through CallbackMap (ADR-004) and the
+ * 8-char base36 ids fit in 8 UTF-8 bytes. If a future regression bypasses
+ * the map and a literal payload > 64 bytes makes it to Telegram, the API
+ * rejects with 400 BUTTON_DATA_INVALID; this handler surfaces the
+ * recovery instruction. The PRP frames the response shape as
+ * "never present at UX layer" — when it does, the mode is broken,
+ * not the user's input.
+ */
+export const META = {
+    mode: 'callback-data-overflow',
+    glyph: '❌',
+    severity: 'error',
+};
+export const handle = (ctx, info) => {
+    const label = info?.buttonLabel ? ` "${info.buttonLabel}"` : '';
+    const bytes = info?.payloadBytes ? ` (${info.payloadBytes}b > 64b)` : '';
+    return [
+        {
+            type: 'sendMessage',
+            chat_id: ctx.chatId,
+            text: `${META.glyph} Button${label} payload too large${bytes} — ` +
+                `please re-trigger via /sessions or /cost (regression report logged).`,
+        },
+    ];
+};
+//# sourceMappingURL=callback-data-overflow.js.map

package/dist/src/channels/telegram-mirror/failure/callback-data-overflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callback-data-overflow.js","sourceRoot":"","sources":["../../../../../src/channels/telegram-mirror/failure/callback-data-overflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,CAAC,MAAM,IAAI,GAAsB;IACrC,IAAI,EAAE,wBAAwB;IAC9B,KAAK,EAAE,GAAG;IACV,QAAQ,EAAE,OAAO;CAClB,CAAC;AASF,MAAM,CAAC,MAAM,MAAM,GAA6C,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;IAC5E,MAAM,KAAK,GAAG,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,MAAM,KAAK,GAAG,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,YAAY,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IACzE,OAAO;QACL;YACE,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,GAAG,CAAC,MAAM;YACnB,IAAI,EACF,GAAG,IAAI,CAAC,KAAK,UAAU,KAAK,qBAAqB,KAAK,KAAK;gBAC3D,sEAAsE;SACzE;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/src/channels/telegram-mirror/failure/gateway-down.d.ts

@@ -0,0 +1,15 @@
+/**
+ * failure/gateway-down.ts — v0.25.0 M12.
+ *
+ * Mode: gateway-down. Surfaces when the openclaw-gateway is unresponsive
+ * (heartbeat aged out OR explicit ping failure). Piggybacks on the
+ * existing `.openclaw/gateway-supervisor-restart-handoff.json` heartbeat
+ * mechanism per PRP M12 wiring.
+ */
+import type { FailureHandler, FailureModuleMeta } from './types.js';
+export declare const META: FailureModuleMeta;
+export interface GatewayDownInfo {
+    /** Seconds since the last heartbeat was observed. */
+    lastSeenAgoSec?: number;
+}
+export declare const handle: FailureHandler<GatewayDownInfo>;

package/dist/src/channels/telegram-mirror/failure/gateway-down.js

@@ -0,0 +1,27 @@
+/**
+ * failure/gateway-down.ts — v0.25.0 M12.
+ *
+ * Mode: gateway-down. Surfaces when the openclaw-gateway is unresponsive
+ * (heartbeat aged out OR explicit ping failure). Piggybacks on the
+ * existing `.openclaw/gateway-supervisor-restart-handoff.json` heartbeat
+ * mechanism per PRP M12 wiring.
+ */
+export const META = {
+    mode: 'gateway-down',
+    glyph: '🟥',
+    severity: 'error',
+};
+export const handle = (ctx, info) => {
+    const ago = info?.lastSeenAgoSec;
+    const agoStr = ago && Number.isFinite(ago) ? ` (last heartbeat ${ago}s ago)` : '';
+    const actions = [
+        {
+            type: 'sendMessage',
+            chat_id: ctx.chatId,
+            text: `${META.glyph} Gateway down${agoStr} — engine paused. ` +
+                `Re-checking on heartbeat; no manual action required.`,
+        },
+    ];
+    return actions;
+};
+//# sourceMappingURL=gateway-down.js.map

package/dist/src/channels/telegram-mirror/failure/gateway-down.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-down.js","sourceRoot":"","sources":["../../../../../src/channels/telegram-mirror/failure/gateway-down.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,MAAM,CAAC,MAAM,IAAI,GAAsB;IACrC,IAAI,EAAE,cAAc;IACpB,KAAK,EAAE,IAAI;IACX,QAAQ,EAAE,OAAO;CAClB,CAAC;AAOF,MAAM,CAAC,MAAM,MAAM,GAAoC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;IACnE,MAAM,GAAG,GAAG,IAAI,EAAE,cAAc,CAAC;IACjC,MAAM,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,oBAAoB,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IAClF,MAAM,OAAO,GAAqB;QAChC;YACE,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,GAAG,CAAC,MAAM;YACnB,IAAI,EACF,GAAG,IAAI,CAAC,KAAK,gBAAgB,MAAM,oBAAoB;gBACvD,sDAAsD;SACzD;KACF,CAAC;IACF,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC"}

package/dist/src/channels/telegram-mirror/failure/in-flight-conflict.d.ts

@@ -0,0 +1,15 @@
+/**
+ * failure/in-flight-conflict.ts — v0.25.0 M12.
+ *
+ * Mode: in-flight-conflict. User typed (or tapped) while a turn was
+ * already in progress for the chat. The mirror queues the message
+ * rather than dropping it; this surface lets the user know to expect
+ * a follow-up reply once the current turn completes.
+ */
+import type { FailureHandler, FailureModuleMeta } from './types.js';
+export declare const META: FailureModuleMeta;
+export interface InFlightConflictInfo {
+    /** Approximate position in the queue (1-indexed). */
+    queuePos?: number;
+}
+export declare const handle: FailureHandler<InFlightConflictInfo>;

package/dist/src/channels/telegram-mirror/failure/in-flight-conflict.js

@@ -0,0 +1,27 @@
+/**
+ * failure/in-flight-conflict.ts — v0.25.0 M12.
+ *
+ * Mode: in-flight-conflict. User typed (or tapped) while a turn was
+ * already in progress for the chat. The mirror queues the message
+ * rather than dropping it; this surface lets the user know to expect
+ * a follow-up reply once the current turn completes.
+ */
+export const META = {
+    mode: 'in-flight-conflict',
+    glyph: '⏳',
+    severity: 'info',
+};
+export const handle = (ctx, info) => {
+    const pos = info?.queuePos && Number.isFinite(info.queuePos)
+        ? ` (queue position ${info.queuePos})`
+        : '';
+    return [
+        {
+            type: 'sendMessage',
+            chat_id: ctx.chatId,
+            text: `${META.glyph} Previous turn still running${pos} — your message is queued ` +
+                `and will run as soon as the current turn finishes.`,
+        },
+    ];
+};
+//# sourceMappingURL=in-flight-conflict.js.map

package/dist/src/channels/telegram-mirror/failure/in-flight-conflict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-flight-conflict.js","sourceRoot":"","sources":["../../../../../src/channels/telegram-mirror/failure/in-flight-conflict.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,CAAC,MAAM,IAAI,GAAsB;IACrC,IAAI,EAAE,oBAAoB;IAC1B,KAAK,EAAE,GAAG;IACV,QAAQ,EAAE,MAAM;CACjB,CAAC;AAOF,MAAM,CAAC,MAAM,MAAM,GAAyC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;IACxE,MAAM,GAAG,GACP,IAAI,EAAE,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC;QAC9C,CAAC,CAAC,oBAAoB,IAAI,CAAC,QAAQ,GAAG;QACtC,CAAC,CAAC,EAAE,CAAC;IACT,OAAO;QACL;YACE,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,GAAG,CAAC,MAAM;YACnB,IAAI,EACF,GAAG,IAAI,CAAC,KAAK,+BAA+B,GAAG,4BAA4B;gBAC3E,oDAAoD;SACvD;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/src/channels/telegram-mirror/failure/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * src/channels/telegram-mirror/failure/index.ts — v0.25.0 M12 barrel.
+ *
+ * Exports every failure-mode handler + metadata so the dispatcher (and
+ * M13's chaos test) can iterate the canonical list. Keeping each mode
+ * in its own module per ADR-008; this barrel is the dispatch surface.
+ */
+import type { FailureHandler, FailureModuleMeta } from './types.js';
+export type { FailureContext, FailureHandler, FailureModuleMeta, Severity } from './types.js';
+export interface FailureModule {
+    META: FailureModuleMeta;
+    handle: FailureHandler<unknown>;
+}
+/**
+ * Canonical 8-mode list per PRP M12. ADR-008 mandates one row per mode;
+ * the order here mirrors that ordering in the PRP/brief tables.
+ */
+export declare const FAILURE_MODULES: ReadonlyArray<FailureModule>;
+/**
+ * Lookup map keyed by mode id. The dispatcher / chaos harness uses this
+ * to fire a handler by name.
+ */
+export declare const FAILURE_BY_MODE: Readonly<Record<string, FailureModule>>;

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

@@ -0,0 +1,35 @@
+/**
+ * src/channels/telegram-mirror/failure/index.ts — v0.25.0 M12 barrel.
+ *
+ * Exports every failure-mode handler + metadata so the dispatcher (and
+ * M13's chaos test) can iterate the canonical list. Keeping each mode
+ * in its own module per ADR-008; this barrel is the dispatch surface.
+ */
+import * as gatewayDown from './gateway-down.js';
+import * as rateLimit from './rate-limit.js';
+import * as model5xx from './model-5xx.js';
+import * as poolExhaustedFallback from './pool-exhausted-fallback.js';
+import * as callbackDataOverflow from './callback-data-overflow.js';
+import * as returningAfter24h from './returning-after-24h.js';
+import * as inFlightConflict from './in-flight-conflict.js';
+import * as networkBlip from './network-blip.js';
+/**
+ * Canonical 8-mode list per PRP M12. ADR-008 mandates one row per mode;
+ * the order here mirrors that ordering in the PRP/brief tables.
+ */
+export const FAILURE_MODULES = [
+    gatewayDown,
+    rateLimit,
+    model5xx,
+    poolExhaustedFallback,
+    callbackDataOverflow,
+    returningAfter24h,
+    inFlightConflict,
+    networkBlip,
+];
+/**
+ * Lookup map keyed by mode id. The dispatcher / chaos harness uses this
+ * to fire a handler by name.
+ */
+export const FAILURE_BY_MODE = Object.fromEntries(FAILURE_MODULES.map((m) => [m.META.mode, m]));
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/channels/telegram-mirror/failure/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,qBAAqB,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,oBAAoB,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,iBAAiB,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,gBAAgB,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AAUjD;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAiC;IAC3D,WAAuC;IACvC,SAAqC;IACrC,QAAoC;IACpC,qBAAiD;IACjD,oBAAgD;IAChD,iBAA6C;IAC7C,gBAA4C;IAC5C,WAAuC;CACxC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAA4C,MAAM,CAAC,WAAW,CACxF,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAC7C,CAAC"}

package/dist/src/channels/telegram-mirror/failure/model-5xx.d.ts

@@ -0,0 +1,16 @@
+/**
+ * failure/model-5xx.ts — v0.25.0 M12.
+ *
+ * Mode: model-5xx. Upstream model returned a 500-class HTTP status.
+ * Transient by definition — the surface is advisory, the retry is
+ * automatic at the engine layer.
+ */
+import type { FailureHandler, FailureModuleMeta } from './types.js';
+export declare const META: FailureModuleMeta;
+export interface Model5xxInfo {
+    /** The exact HTTP status (e.g. 502, 503, 504). */
+    status?: number;
+    /** Attempt number (1-indexed). */
+    attempt?: number;
+}
+export declare const handle: FailureHandler<Model5xxInfo>;

package/dist/src/channels/telegram-mirror/failure/model-5xx.js

@@ -0,0 +1,24 @@
+/**
+ * failure/model-5xx.ts — v0.25.0 M12.
+ *
+ * Mode: model-5xx. Upstream model returned a 500-class HTTP status.
+ * Transient by definition — the surface is advisory, the retry is
+ * automatic at the engine layer.
+ */
+export const META = {
+    mode: 'model-5xx',
+    glyph: '🟧',
+    severity: 'warn',
+};
+export const handle = (ctx, info) => {
+    const status = info?.status ?? '5xx';
+    const attempt = info?.attempt ? ` (attempt ${info.attempt})` : '';
+    return [
+        {
+            type: 'sendMessage',
+            chat_id: ctx.chatId,
+            text: `${META.glyph} Model returned ${status}${attempt} — retrying automatically.`,
+        },
+    ];
+};
+//# sourceMappingURL=model-5xx.js.map

package/dist/src/channels/telegram-mirror/failure/model-5xx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-5xx.js","sourceRoot":"","sources":["../../../../../src/channels/telegram-mirror/failure/model-5xx.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,CAAC,MAAM,IAAI,GAAsB;IACrC,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,IAAI;IACX,QAAQ,EAAE,MAAM;CACjB,CAAC;AASF,MAAM,CAAC,MAAM,MAAM,GAAiC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;IAChE,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,KAAK,CAAC;IACrC,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAClE,OAAO;QACL;YACE,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,GAAG,CAAC,MAAM;YACnB,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,mBAAmB,MAAM,GAAG,OAAO,4BAA4B;SACnF;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/src/channels/telegram-mirror/failure/network-blip.d.ts

@@ -0,0 +1,17 @@
+/**
+ * failure/network-blip.ts — v0.25.0 M12.
+ *
+ * Mode: network-blip. Transient network error (DNS, TCP reset, ETIMEDOUT)
+ * on an upstream call. Auto-retried at the transport layer; this surface
+ * is advisory only and fires on the first user-observable blip per turn
+ * so the chat doesn't drown in retry chatter.
+ */
+import type { FailureHandler, FailureModuleMeta } from './types.js';
+export declare const META: FailureModuleMeta;
+export interface NetworkBlipInfo {
+    /** Error code surfaced by the transport (e.g. "ETIMEDOUT", "ECONNRESET"). */
+    code?: string;
+    /** Endpoint that blipped (for diagnostics). */
+    endpoint?: string;
+}
+export declare const handle: FailureHandler<NetworkBlipInfo>;

package/dist/src/channels/telegram-mirror/failure/network-blip.js

@@ -0,0 +1,25 @@
+/**
+ * failure/network-blip.ts — v0.25.0 M12.
+ *
+ * Mode: network-blip. Transient network error (DNS, TCP reset, ETIMEDOUT)
+ * on an upstream call. Auto-retried at the transport layer; this surface
+ * is advisory only and fires on the first user-observable blip per turn
+ * so the chat doesn't drown in retry chatter.
+ */
+export const META = {
+    mode: 'network-blip',
+    glyph: '🌐',
+    severity: 'warn',
+};
+export const handle = (ctx, info) => {
+    const code = info?.code ? ` (${info.code})` : '';
+    const ep = info?.endpoint ? ` on ${info.endpoint}` : '';
+    return [
+        {
+            type: 'sendMessage',
+            chat_id: ctx.chatId,
+            text: `${META.glyph} Network blip${code}${ep} — auto-retrying.`,
+        },
+    ];
+};
+//# sourceMappingURL=network-blip.js.map

package/dist/src/channels/telegram-mirror/failure/network-blip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-blip.js","sourceRoot":"","sources":["../../../../../src/channels/telegram-mirror/failure/network-blip.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,CAAC,MAAM,IAAI,GAAsB;IACrC,IAAI,EAAE,cAAc;IACpB,KAAK,EAAE,IAAI;IACX,QAAQ,EAAE,MAAM;CACjB,CAAC;AASF,MAAM,CAAC,MAAM,MAAM,GAAoC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;IACnE,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACjD,MAAM,EAAE,GAAG,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACxD,OAAO;QACL;YACE,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,GAAG,CAAC,MAAM;YACnB,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,gBAAgB,IAAI,GAAG,EAAE,mBAAmB;SAChE;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/src/channels/telegram-mirror/failure/pool-exhausted-fallback.d.ts

@@ -0,0 +1,15 @@
+/**
+ * failure/pool-exhausted-fallback.ts — v0.25.0 M12.
+ *
+ * Mode: pool-exhausted-fallback. The SubprocessPool (v0.16+ / M1
+ * v0.24.0) is saturated — incoming turn falls back to direct CLI spawn.
+ * The user surface is informational only; the engine completes the turn
+ * regardless. Tracked so soak instrumentation can flag if it fires often.
+ */
+import type { FailureHandler, FailureModuleMeta } from './types.js';
+export declare const META: FailureModuleMeta;
+export interface PoolExhaustedInfo {
+    /** Number of in-flight pool slots at the time of fallback. */
+    poolSize?: number;
+}
+export declare const handle: FailureHandler<PoolExhaustedInfo>;