tg-claude 0.1.0

package/dist/router/BoundedQueue.js

@@ -0,0 +1,86 @@
+/**
+ * Generic bounded queue with configurable overflow behavior.
+ * Drops oldest items when capacity exceeded (matches OutputBuffer pattern).
+ */
+export class BoundedQueue {
+    items = [];
+    maxSize;
+    droppedCount = 0;
+    /**
+     * Create a new BoundedQueue
+     * @param maxSize - Maximum number of items the queue can hold (must be >= 1)
+     * @throws Error if maxSize is less than 1
+     */
+    constructor(maxSize) {
+        if (maxSize < 1) {
+            throw new Error('maxSize must be at least 1');
+        }
+        this.maxSize = maxSize;
+    }
+    /**
+     * Add item to queue. If full, drops oldest item.
+     * @param item - Item to add to the queue
+     * @returns true if item was added without dropping, false if overflow occurred
+     */
+    push(item) {
+        const overflow = this.items.length >= this.maxSize;
+        if (overflow) {
+            this.items.shift();
+            this.droppedCount++;
+        }
+        this.items.push(item);
+        return !overflow;
+    }
+    /**
+     * Remove and return oldest item, or undefined if empty.
+     * @returns The oldest item in the queue, or undefined if queue is empty
+     */
+    shift() {
+        return this.items.shift();
+    }
+    /**
+     * Peek at oldest item without removing.
+     * @returns The oldest item in the queue, or undefined if queue is empty
+     */
+    peek() {
+        return this.items[0];
+    }
+    /**
+     * Current number of items in queue.
+     */
+    get size() {
+        return this.items.length;
+    }
+    /**
+     * Whether queue is at capacity.
+     */
+    get isFull() {
+        return this.items.length >= this.maxSize;
+    }
+    /**
+     * Whether queue is empty.
+     */
+    get isEmpty() {
+        return this.items.length === 0;
+    }
+    /**
+     * Total items dropped due to overflow since creation.
+     */
+    get totalDropped() {
+        return this.droppedCount;
+    }
+    /**
+     * Clear all items from queue.
+     */
+    clear() {
+        this.items = [];
+    }
+    /**
+     * Get all items as array (for debugging).
+     * @returns A copy of the internal items array
+     */
+    toArray() {
+        return [...this.items];
+    }
+}
+//# sourceMappingURL=BoundedQueue.js.map

package/dist/router/BoundedQueue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoundedQueue.js","sourceRoot":"","sources":["../../src/router/BoundedQueue.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,YAAY;IACf,KAAK,GAAQ,EAAE,CAAC;IACP,OAAO,CAAS;IACzB,YAAY,GAAG,CAAC,CAAC;IAEzB;;;;OAIG;IACH,YAAY,OAAe;QACzB,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACH,IAAI,CAAC,IAAO;QACV,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC;QACnD,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACnB,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,OAAO,CAAC,QAAQ,CAAC;IACnB,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED;;;OAGG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IAClB,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;CACF"}

package/dist/router/EventRouter.d.ts

@@ -0,0 +1,103 @@
+import type { EventRouterEvents, OutboundEvent, InboundEvent } from './types.js';
+export interface EventRouterOptions {
+    /** Max outbound events per session (default: 100) */
+    outboundQueueSize?: number;
+    /** Max inbound events per session (default: 50) */
+    inboundQueueSize?: number;
+}
+/**
+ * Central router for bidirectional event flow between PTY/Parser and Telegram layers.
+ * Maintains per-session bounded queues for decoupled communication.
+ *
+ * @emits outbound - When outbound event is published
+ * @emits inbound - When inbound event is published
+ * @emits sessionCreated - When a new session is registered
+ * @emits sessionDestroyed - When a session is unregistered
+ * @emits queueOverflow - When a queue drops an event due to size limit
+ */
+export declare class EventRouter {
+    private readonly emitter;
+    private readonly options;
+    private readonly outboundQueues;
+    private readonly inboundQueues;
+    constructor(options?: EventRouterOptions);
+    /**
+     * Subscribe to router events.
+     */
+    on<K extends keyof EventRouterEvents>(event: K, listener: EventRouterEvents[K]): this;
+    /**
+     * Subscribe to router events (once).
+     */
+    once<K extends keyof EventRouterEvents>(event: K, listener: EventRouterEvents[K]): this;
+    /**
+     * Unsubscribe from router events.
+     */
+    off<K extends keyof EventRouterEvents>(event: K, listener: EventRouterEvents[K]): this;
+    /**
+     * Remove all listeners for an event.
+     */
+    removeAllListeners<K extends keyof EventRouterEvents>(event?: K): this;
+    /**
+     * Register a new session with dedicated queues.
+     * @throws Error if session already registered
+     */
+    registerSession(sessionId: string): void;
+    /**
+     * Unregister a session and remove its queues.
+     * Safe to call if session doesn't exist.
+     */
+    unregisterSession(sessionId: string): void;
+    /**
+     * Check if a session is registered.
+     */
+    hasSession(sessionId: string): boolean;
+    /**
+     * Get all registered session IDs.
+     */
+    getSessions(): string[];
+    /**
+     * Publish an outbound event (PTY/Parser -> Telegram direction).
+     * @returns false if session not found, true otherwise
+     */
+    publishOutbound(event: OutboundEvent): boolean;
+    /**
+     * Publish an inbound event (Telegram -> PTY direction).
+     * @returns false if session not found, true otherwise
+     */
+    publishInbound(event: InboundEvent): boolean;
+    /**
+     * Consume (dequeue) the oldest outbound event for a session.
+     * @returns The event or undefined if queue empty or session not found
+     */
+    consumeOutbound(sessionId: string): OutboundEvent | undefined;
+    /**
+     * Consume (dequeue) the oldest inbound event for a session.
+     * @returns The event or undefined if queue empty or session not found
+     */
+    consumeInbound(sessionId: string): InboundEvent | undefined;
+    /**
+     * Peek at the oldest outbound event without consuming.
+     */
+    peekOutbound(sessionId: string): OutboundEvent | undefined;
+    /**
+     * Peek at the oldest inbound event without consuming.
+     */
+    peekInbound(sessionId: string): InboundEvent | undefined;
+    /**
+     * Get outbound queue size for a session.
+     */
+    getOutboundQueueSize(sessionId: string): number;
+    /**
+     * Get inbound queue size for a session.
+     */
+    getInboundQueueSize(sessionId: string): number;
+    /**
+     * Get total dropped events for outbound queue.
+     */
+    getOutboundDropped(sessionId: string): number;
+    /**
+     * Get total dropped events for inbound queue.
+     */
+    getInboundDropped(sessionId: string): number;
+}
+//# sourceMappingURL=EventRouter.d.ts.map

package/dist/router/EventRouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventRouter.d.ts","sourceRoot":"","sources":["../../src/router/EventRouter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGjF,MAAM,WAAW,kBAAkB;IACjC,qDAAqD;IACrD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mDAAmD;IACnD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAWD;;;;;;;;;GASG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAC1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IACvD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAkD;IACjF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiD;gBAEnE,OAAO,GAAE,kBAAuB;IAQ5C;;OAEG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,iBAAiB,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI;IAKrF;;OAEG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,iBAAiB,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI;IAKvF;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,iBAAiB,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI;IAKtF;;OAEG;IACH,kBAAkB,CAAC,CAAC,SAAS,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI;IAKtE;;;OAGG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IASxC;;;OAGG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAO1C;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAItC;;OAEG;IACH,WAAW,IAAI,MAAM,EAAE;IAIvB;;;OAGG;IACH,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAY9C;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO;IAY5C;;;OAGG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI7D;;;OAGG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAI3D;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI1D;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIxD;;OAEG;IACH,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAI/C;;OAEG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAI9C;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAI7C;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;CAG7C"}

package/dist/router/EventRouter.js

@@ -0,0 +1,169 @@
+import { EventEmitter } from 'node:events';
+import { BoundedQueue } from './BoundedQueue.js';
+/**
+ * Central router for bidirectional event flow between PTY/Parser and Telegram layers.
+ * Maintains per-session bounded queues for decoupled communication.
+ *
+ * @emits outbound - When outbound event is published
+ * @emits inbound - When inbound event is published
+ * @emits sessionCreated - When a new session is registered
+ * @emits sessionDestroyed - When a session is unregistered
+ * @emits queueOverflow - When a queue drops an event due to size limit
+ */
+export class EventRouter {
+    emitter;
+    options;
+    outboundQueues = new Map();
+    inboundQueues = new Map();
+    constructor(options = {}) {
+        this.emitter = new EventEmitter();
+        this.options = {
+            outboundQueueSize: options.outboundQueueSize ?? 100,
+            inboundQueueSize: options.inboundQueueSize ?? 50,
+        };
+    }
+    /**
+     * Subscribe to router events.
+     */
+    on(event, listener) {
+        this.emitter.on(event, listener);
+        return this;
+    }
+    /**
+     * Subscribe to router events (once).
+     */
+    once(event, listener) {
+        this.emitter.once(event, listener);
+        return this;
+    }
+    /**
+     * Unsubscribe from router events.
+     */
+    off(event, listener) {
+        this.emitter.off(event, listener);
+        return this;
+    }
+    /**
+     * Remove all listeners for an event.
+     */
+    removeAllListeners(event) {
+        this.emitter.removeAllListeners(event);
+        return this;
+    }
+    /**
+     * Register a new session with dedicated queues.
+     * @throws Error if session already registered
+     */
+    registerSession(sessionId) {
+        if (this.outboundQueues.has(sessionId)) {
+            throw new Error(`Session ${sessionId} already registered`);
+        }
+        this.outboundQueues.set(sessionId, new BoundedQueue(this.options.outboundQueueSize));
+        this.inboundQueues.set(sessionId, new BoundedQueue(this.options.inboundQueueSize));
+        this.emitter.emit('sessionCreated', sessionId);
+    }
+    /**
+     * Unregister a session and remove its queues.
+     * Safe to call if session doesn't exist.
+     */
+    unregisterSession(sessionId) {
+        if (!this.outboundQueues.has(sessionId))
+            return;
+        this.outboundQueues.delete(sessionId);
+        this.inboundQueues.delete(sessionId);
+        this.emitter.emit('sessionDestroyed', sessionId);
+    }
+    /**
+     * Check if a session is registered.
+     */
+    hasSession(sessionId) {
+        return this.outboundQueues.has(sessionId);
+    }
+    /**
+     * Get all registered session IDs.
+     */
+    getSessions() {
+        return Array.from(this.outboundQueues.keys());
+    }
+    /**
+     * Publish an outbound event (PTY/Parser -> Telegram direction).
+     * @returns false if session not found, true otherwise
+     */
+    publishOutbound(event) {
+        const queue = this.outboundQueues.get(event.sessionId);
+        if (!queue)
+            return false;
+        const added = queue.push(event);
+        if (!added) {
+            this.emitter.emit('queueOverflow', event.sessionId, 'outbound');
+        }
+        this.emitter.emit('outbound', event);
+        return true;
+    }
+    /**
+     * Publish an inbound event (Telegram -> PTY direction).
+     * @returns false if session not found, true otherwise
+     */
+    publishInbound(event) {
+        const queue = this.inboundQueues.get(event.sessionId);
+        if (!queue)
+            return false;
+        const added = queue.push(event);
+        if (!added) {
+            this.emitter.emit('queueOverflow', event.sessionId, 'inbound');
+        }
+        this.emitter.emit('inbound', event);
+        return true;
+    }
+    /**
+     * Consume (dequeue) the oldest outbound event for a session.
+     * @returns The event or undefined if queue empty or session not found
+     */
+    consumeOutbound(sessionId) {
+        return this.outboundQueues.get(sessionId)?.shift();
+    }
+    /**
+     * Consume (dequeue) the oldest inbound event for a session.
+     * @returns The event or undefined if queue empty or session not found
+     */
+    consumeInbound(sessionId) {
+        return this.inboundQueues.get(sessionId)?.shift();
+    }
+    /**
+     * Peek at the oldest outbound event without consuming.
+     */
+    peekOutbound(sessionId) {
+        return this.outboundQueues.get(sessionId)?.peek();
+    }
+    /**
+     * Peek at the oldest inbound event without consuming.
+     */
+    peekInbound(sessionId) {
+        return this.inboundQueues.get(sessionId)?.peek();
+    }
+    /**
+     * Get outbound queue size for a session.
+     */
+    getOutboundQueueSize(sessionId) {
+        return this.outboundQueues.get(sessionId)?.size ?? 0;
+    }
+    /**
+     * Get inbound queue size for a session.
+     */
+    getInboundQueueSize(sessionId) {
+        return this.inboundQueues.get(sessionId)?.size ?? 0;
+    }
+    /**
+     * Get total dropped events for outbound queue.
+     */
+    getOutboundDropped(sessionId) {
+        return this.outboundQueues.get(sessionId)?.totalDropped ?? 0;
+    }
+    /**
+     * Get total dropped events for inbound queue.
+     */
+    getInboundDropped(sessionId) {
+        return this.inboundQueues.get(sessionId)?.totalDropped ?? 0;
+    }
+}
+//# sourceMappingURL=EventRouter.js.map

package/dist/router/EventRouter.js.map

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

package/dist/router/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Event Router module - bidirectional event routing between PTY/Parser and Telegram layers.
+ *
+ * Exports:
+ * - Event types for outbound (PTY->Telegram) and inbound (Telegram->PTY) directions
+ * - BoundedQueue utility for memory-safe event buffering
+ * - EventRouter class for session-based event routing
+ */
+export * from './types.js';
+export { BoundedQueue } from './BoundedQueue.js';
+export { EventRouter } from './EventRouter.js';
+export type { EventRouterOptions } from './EventRouter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/router/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/router/index.js

@@ -0,0 +1,12 @@
+/**
+ * Event Router module - bidirectional event routing between PTY/Parser and Telegram layers.
+ *
+ * Exports:
+ * - Event types for outbound (PTY->Telegram) and inbound (Telegram->PTY) directions
+ * - BoundedQueue utility for memory-safe event buffering
+ * - EventRouter class for session-based event routing
+ */
+export * from './types.js';
+export { BoundedQueue } from './BoundedQueue.js';
+export { EventRouter } from './EventRouter.js';
+//# sourceMappingURL=index.js.map

package/dist/router/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/router/types.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Event types for bidirectional routing between PTY/Parser and Telegram layers.
+ * Outbound events flow from PTY to Telegram; Inbound events flow from Telegram to PTY.
+ */
+import type { PromptEvent } from '../parser/types.js';
+/**
+ * Payload for streaming output chunks
+ */
+export interface OutputPayload {
+    /** Cleaned text with ANSI codes stripped */
+    text: string;
+    /** Original raw output including ANSI codes */
+    raw: string;
+}
+/**
+ * Payload for process exit events
+ */
+export interface ExitPayload {
+    /** Exit code from the process */
+    exitCode: number;
+    /** Signal number if terminated by signal */
+    signal?: number;
+}
+/**
+ * Payload for task completion events
+ */
+export interface CompletionPayload {
+    /** Summary of final output */
+    summary: string;
+    /** Duration from work start to completion (ms) */
+    duration?: number;
+}
+/**
+ * Event flowing from PTY/Parser layer to Telegram layer.
+ * Discriminated union based on 'type' field.
+ */
+export interface OutboundEvent {
+    /** Session identifier for routing */
+    sessionId: string;
+    /** Event category */
+    type: 'prompt' | 'output' | 'exit' | 'completion';
+    /** Event payload, discriminated by type */
+    payload: PromptEvent | OutputPayload | ExitPayload | CompletionPayload;
+    /** Timestamp when event occurred (ms since epoch) */
+    timestamp: number;
+}
+/**
+ * Payload for user response to a prompt
+ */
+export interface ResponsePayload {
+    /** User's response text */
+    text: string;
+    /** Index of selected option (if user chose from options) */
+    optionIndex?: number;
+}
+/**
+ * Payload for cancellation request
+ */
+export interface CancelPayload {
+    /** Optional reason for cancellation */
+    reason?: string;
+}
+/**
+ * Payload for terminal resize request
+ */
+export interface ResizePayload {
+    /** Number of columns */
+    cols: number;
+    /** Number of rows */
+    rows: number;
+}
+/**
+ * Event flowing from Telegram layer to PTY layer.
+ * Discriminated union based on 'type' field.
+ */
+export interface InboundEvent {
+    /** Session identifier for routing */
+    sessionId: string;
+    /** Event category */
+    type: 'response' | 'cancel' | 'resize';
+    /** Event payload, discriminated by type */
+    payload: ResponsePayload | CancelPayload | ResizePayload;
+    /** Timestamp when event was created (ms since epoch) */
+    timestamp: number;
+    /** Source interface that generated this event (for echo prevention) */
+    source?: 'terminal' | 'telegram';
+}
+/**
+ * Event map for typed EventEmitter.
+ * Defines all events the EventRouter can emit.
+ */
+export interface EventRouterEvents {
+    /** Emitted when an outbound event is published */
+    outbound: (event: OutboundEvent) => void;
+    /** Emitted when an inbound event is published */
+    inbound: (event: InboundEvent) => void;
+    /** Emitted when a new session is registered */
+    sessionCreated: (sessionId: string) => void;
+    /** Emitted when a session is unregistered */
+    sessionDestroyed: (sessionId: string) => void;
+    /** Emitted when a queue overflows (drops oldest) */
+    queueOverflow: (sessionId: string, direction: 'inbound' | 'outbound') => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/router/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/router/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAMtD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,YAAY,CAAC;IAClD,2CAA2C;IAC3C,OAAO,EAAE,WAAW,GAAG,aAAa,GAAG,WAAW,GAAG,iBAAiB,CAAC;IACvE,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,IAAI,EAAE,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACvC,2CAA2C;IAC3C,OAAO,EAAE,eAAe,GAAG,aAAa,GAAG,aAAa,CAAC;IACzD,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,MAAM,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;CAClC;AAMD;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,kDAAkD;IAClD,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IACzC,iDAAiD;IACjD,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACvC,+CAA+C;IAC/C,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,6CAA6C;IAC7C,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,oDAAoD;IACpD,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,UAAU,KAAK,IAAI,CAAC;CAC/E"}

package/dist/router/types.js

@@ -0,0 +1,6 @@
+/**
+ * Event types for bidirectional routing between PTY/Parser and Telegram layers.
+ * Outbound events flow from PTY to Telegram; Inbound events flow from Telegram to PTY.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/router/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/router/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/telegram/TelegramBot.d.ts

@@ -0,0 +1,151 @@
+/**
+ * TelegramBot class wrapping grammY Bot with composition pattern.
+ * Implements AUTH-01 whitelist authentication for single-user access.
+ */
+import type { NotificationPayload } from './types.js';
+import type { TelegramConfig } from './types.js';
+/**
+ * Handler for inline button callback responses.
+ * @param sessionId - The session that receives the response
+ * @param optionIndex - The selected option index (1-based)
+ */
+export type CallbackHandler = (sessionId: string, optionIndex: number) => void;
+/**
+ * Handler for freeform text message responses.
+ * @param sessionId - The session that receives the response
+ * @param text - The user's text input
+ */
+export type TextMessageHandler = (sessionId: string, text: string) => void;
+/**
+ * Options for TelegramBot initialization.
+ * Extends TelegramConfig to allow future options.
+ */
+export interface TelegramBotOptions extends TelegramConfig {
+}
+/**
+ * TelegramBot wraps grammY Bot with composition pattern.
+ * Provides single-user authentication and graceful lifecycle management.
+ *
+ * @example
+ * ```typescript
+ * const bot = new TelegramBot({
+ *   token: process.env.TELEGRAM_BOT_TOKEN,
+ *   allowedUserId: Number(process.env.TELEGRAM_USER_ID),
+ * });
+ * await bot.start();
+ * ```
+ */
+export declare class TelegramBot {
+    private readonly bot;
+    private readonly allowedUserId;
+    private started;
+    private readonly sessionChatMap;
+    onCallback: CallbackHandler | null;
+    onTextMessage: TextMessageHandler | null;
+    private awaitingSession;
+    private readonly multiSelectState;
+    constructor(options: TelegramBotOptions);
+    /**
+     * Set up bot middleware and command handlers.
+     */
+    private setupMiddleware;
+    /**
+     * Set up error handler for Telegram API and network errors.
+     */
+    private setupErrorHandler;
+    /**
+     * Handle single-select button click (existing behavior, refactored)
+     */
+    private handleSingleSelect;
+    /**
+     * Handle multi-select toggle button click
+     */
+    private handleToggle;
+    /**
+     * Handle multi-select submit button click
+     */
+    private handleSubmit;
+    /**
+     * Build multi-select keyboard with checkmarks for selected options
+     */
+    private buildMultiSelectKeyboard;
+    /**
+     * Start the bot with long polling.
+     * Safe to call multiple times (idempotent).
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the bot gracefully.
+     * Safe to call multiple times (idempotent).
+     */
+    stop(): void;
+    /**
+     * Check if the bot is currently running.
+     */
+    get isStarted(): boolean;
+    /**
+     * Get the chat ID for the single whitelisted user.
+     * For private chats, chat_id equals user_id.
+     */
+    get chatId(): number;
+    /**
+     * Expose bot.api for proactive messaging.
+     * Used by higher layers to send notifications.
+     */
+    get api(): import("grammy").Api<import("grammy").RawApi>;
+    /**
+     * Register a session for notifications.
+     * Maps session to the whitelisted user's chat.
+     */
+    registerSession(sessionId: string): void;
+    /**
+     * Unregister a session.
+     */
+    unregisterSession(sessionId: string): void;
+    /**
+     * Check if a session is registered.
+     */
+    hasSession(sessionId: string): boolean;
+    /**
+     * Send a prompt notification to Telegram with inline keyboard.
+     * @param payload - The notification payload with question and options
+     * @returns Message ID if sent, undefined if session not registered
+     */
+    sendNotification(payload: NotificationPayload): Promise<number | undefined>;
+    /**
+     * Truncate button text for Telegram inline keyboards.
+     * Extracts label (before " - ") and truncates to max length.
+     * Telegram buttons have ~40-50 char visible width.
+     */
+    private truncateButtonText;
+    /**
+     * Escape HTML special characters for Telegram HTML parse mode.
+     */
+    private escapeHtml;
+    /**
+     * Send a completion notification to Telegram.
+     * Handles long messages by splitting into multiple messages.
+     * @param payload - The completion payload with summary
+     * @returns Message ID of last message if sent, undefined if session not registered
+     */
+    sendCompletionNotification(payload: {
+        sessionId: string;
+        summary: string;
+        duration?: number;
+    }): Promise<number | undefined>;
+    /**
+     * Split a long message into chunks at natural break points.
+     */
+    private splitMessage;
+    /**
+     * Mark a session as awaiting user input.
+     * Called when a prompt notification is sent.
+     */
+    setAwaitingInput(sessionId: string): void;
+    /**
+     * Clear the awaiting input state.
+     * Called when response is received or session ends.
+     */
+    clearAwaitingInput(): void;
+}
+//# sourceMappingURL=TelegramBot.d.ts.map