@lobu/gateway 2.8.0

package/dist/infrastructure/queue/queue-producer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-producer.js","sourceRoot":"","sources":["../../../src/infrastructure/queue/queue-producer.ts"],"names":[],"mappings":";;;;AAEA,qCAKoB;AAGpB,MAAM,MAAM,GAAG,IAAA,mBAAY,EAAC,gBAAgB,CAAC,CAAC;AAuD9C;;;GAGG;AACH,MAAa,aAAa;IAIxB,YAAY,KAAoB;QAFxB,kBAAa,GAAG,KAAK,CAAC;QAG5B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,CAAC;YACH,gDAAgD;YAChD,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;YACzC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;YAC1B,MAAM,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,sCAAsC,EAAE,KAAK,CAAC,CAAC;YAC5D,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;QAC3B,MAAM,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACzC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,cAAc,CAClB,OAAuB,EACvB,OAKC;QAED,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;QAED,IAAI,CAAC;YACH,iDAAiD;YACjD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE;gBACvD,QAAQ,EAAE,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,QAAQ,KAAI,CAAC;gBAChC,UAAU,EAAE,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,UAAU,KAAI,CAAC;gBACpC,UAAU,EAAE,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,UAAU,KAAI,EAAE;gBACrC,eAAe,EAAE,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,eAAe,KAAI,GAAG,EAAE,0BAA0B;gBAC5E,YAAY,EAAE,WAAW,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,cAAc,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,4DAA4D;aACvN,CAAC,CAAC;YAEH,MAAM,CAAC,IAAI,CACT,wBAAwB,KAAK,aAAa,OAAO,CAAC,MAAM,kBAAkB,OAAO,CAAC,cAAc,EAAE,CACnG,CAAC;YACF,OAAO,KAAK,IAAI,UAAU,CAAC;QAC7B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CACV,sCAAsC,OAAO,CAAC,MAAM,GAAG,EACvD,KAAK,CACN,CAAC;YACF,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;IACtD,CAAC;CACF;AA9ED,sCA8EC"}

package/dist/infrastructure/queue/redis-queue.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Redis-based message queue implementation using BullMQ
+ */
+import type { IMessageQueue, JobHandler, QueueOptions, QueueStats } from "./types";
+export interface RedisQueueConfig {
+    host: string;
+    port: number;
+    password?: string;
+    db?: number;
+    maxRetriesPerRequest?: number;
+}
+export declare class RedisQueue implements IMessageQueue {
+    private config;
+    private queues;
+    private workers;
+    private pendingWorkers;
+    private queueEvents;
+    private isConnected;
+    private redisClient?;
+    constructor(config: RedisQueueConfig);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    createQueue(queueName: string): Promise<void>;
+    send<T>(queueName: string, data: T, options?: QueueOptions): Promise<string>;
+    work<T>(queueName: string, handler: JobHandler<T>, options?: {
+        startPaused?: boolean;
+    }): Promise<void>;
+    /**
+     * Move a failed job to the dead letter queue for later investigation/reprocessing
+     */
+    private moveToDeadLetterQueue;
+    pauseWorker(queueName: string): Promise<void>;
+    resumeWorker(queueName: string): Promise<void>;
+    /**
+     * Get detailed queue statistics
+     */
+    getQueueStats(queueName: string): Promise<QueueStats>;
+    isHealthy(): boolean;
+    /**
+     * Get underlying Redis client for general-purpose Redis operations
+     * Returns the shared IORedis client used by all queues and workers
+     */
+    getRedisClient(): any;
+}
+//# sourceMappingURL=redis-queue.d.ts.map

package/dist/infrastructure/queue/redis-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-queue.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/queue/redis-queue.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EAEV,YAAY,EACZ,UAAU,EACX,MAAM,SAAS,CAAC;AAIjB,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,qBAAa,UAAW,YAAW,aAAa;IAC9C,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,WAAW,CAAuC;IAC1D,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAC,CAAQ;gBAEhB,MAAM,EAAE,gBAAgB;IAI9B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IActB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA+CrB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB7C,IAAI,CAAC,CAAC,EACV,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,CAAC,EACP,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,MAAM,CAAC;IAqDZ,IAAI,CAAC,CAAC,EACV,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,EACtB,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAClC,OAAO,CAAC,IAAI,CAAC;IAqEhB;;OAEG;YACW,qBAAqB;IA8B7B,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB7C,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BpD;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAqB3D,SAAS,IAAI,OAAO;IAIpB;;;OAGG;IACH,cAAc,IAAI,GAAG;CAMtB"}

package/dist/infrastructure/queue/redis-queue.js

@@ -0,0 +1,273 @@
+"use strict";
+/**
+ * Redis-based message queue implementation using BullMQ
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisQueue = void 0;
+const core_1 = require("@lobu/core");
+const bullmq_1 = require("bullmq");
+const ioredis_1 = __importDefault(require("ioredis"));
+const logger = (0, core_1.createLogger)("redis-queue");
+class RedisQueue {
+    constructor(config) {
+        this.queues = new Map();
+        this.workers = new Map();
+        this.pendingWorkers = new Set(); // Workers created with autorun:false, not yet started
+        this.queueEvents = new Map();
+        this.isConnected = false;
+        this.config = config;
+    }
+    async start() {
+        // Create shared Redis client for all queues and workers
+        this.redisClient = new ioredis_1.default({
+            host: this.config.host,
+            port: this.config.port,
+            password: this.config.password,
+            db: this.config.db,
+            maxRetriesPerRequest: null, // Required by BullMQ
+        });
+        this.isConnected = true;
+        logger.debug("Redis queue started");
+    }
+    async stop() {
+        this.isConnected = false;
+        // Close all workers first
+        for (const [name, worker] of this.workers.entries()) {
+            try {
+                worker.removeAllListeners();
+                await worker.close();
+                logger.debug(`Closed worker for queue: ${name}`);
+            }
+            catch (error) {
+                logger.error(`Error closing worker ${name}:`, error);
+            }
+        }
+        // Close all queue events
+        for (const [name, events] of this.queueEvents.entries()) {
+            try {
+                await events.close();
+                logger.debug(`Closed events for queue: ${name}`);
+            }
+            catch (error) {
+                logger.error(`Error closing events ${name}:`, error);
+            }
+        }
+        // Close all queues
+        for (const [name, queue] of this.queues.entries()) {
+            try {
+                await queue.close();
+                logger.debug(`Closed queue: ${name}`);
+            }
+            catch (error) {
+                logger.error(`Error closing queue ${name}:`, error);
+            }
+        }
+        this.workers.clear();
+        this.queueEvents.clear();
+        this.queues.clear();
+        // Close the shared Redis client
+        if (this.redisClient) {
+            await this.redisClient.quit();
+            this.redisClient = undefined;
+        }
+        logger.debug("Redis queue stopped");
+    }
+    async createQueue(queueName) {
+        if (!this.queues.has(queueName)) {
+            if (!this.redisClient) {
+                throw new Error("Redis client not initialized. Call start() first.");
+            }
+            // Pass the shared Redis client to BullMQ
+            const queue = new bullmq_1.Queue(queueName, {
+                connection: this.redisClient,
+            });
+            this.queues.set(queueName, queue);
+            logger.debug(`Created queue: ${queueName}`);
+        }
+    }
+    async send(queueName, data, options) {
+        var _a;
+        if (!this.isConnected) {
+            throw new Error("Queue is not connected");
+        }
+        // Ensure queue exists
+        await this.createQueue(queueName);
+        const queue = this.queues.get(queueName);
+        if (!queue) {
+            throw new Error(`Queue ${queueName} not found`);
+        }
+        // Convert options to BullMQ format
+        const jobOptions = {
+            priority: options === null || options === void 0 ? void 0 : options.priority,
+            attempts: (_a = options === null || options === void 0 ? void 0 : options.retryLimit) !== null && _a !== void 0 ? _a : 3,
+            backoff: (options === null || options === void 0 ? void 0 : options.retryDelay)
+                ? {
+                    type: "fixed",
+                    delay: options.retryDelay * 1000, // Convert to milliseconds
+                }
+                : undefined,
+            removeOnComplete: {
+                age: 3600, // 1 hour
+                count: 1000,
+            },
+            removeOnFail: {
+                age: 24 * 3600, // 24 hours
+                count: 5000,
+            },
+            delay: options === null || options === void 0 ? void 0 : options.delayMs,
+        };
+        // Handle expiration
+        if (options === null || options === void 0 ? void 0 : options.expireInSeconds) {
+            jobOptions.removeOnComplete = {
+                age: options.expireInSeconds,
+                count: 1000,
+            };
+        }
+        // Handle singleton (deduplication)
+        if (options === null || options === void 0 ? void 0 : options.singletonKey) {
+            jobOptions.jobId = options.singletonKey;
+        }
+        const job = await queue.add(queueName, data, jobOptions);
+        logger.debug(`Enqueued job ${job.id} to queue ${queueName}`);
+        return job.id || "unknown";
+    }
+    async work(queueName, handler, options) {
+        var _a;
+        if (!this.isConnected) {
+            throw new Error("Queue is not connected");
+        }
+        // Ensure queue exists
+        await this.createQueue(queueName);
+        // Close existing worker if one already exists for this queue
+        const existingWorker = this.workers.get(queueName);
+        if (existingWorker) {
+            existingWorker.removeAllListeners();
+            await existingWorker.close();
+            this.workers.delete(queueName);
+            this.pendingWorkers.delete(queueName);
+            logger.debug(`Closed existing worker for queue: ${queueName}`);
+        }
+        if (!this.redisClient) {
+            throw new Error("Redis client not initialized. Call start() first.");
+        }
+        const startPaused = (_a = options === null || options === void 0 ? void 0 : options.startPaused) !== null && _a !== void 0 ? _a : false;
+        const worker = new bullmq_1.Worker(queueName, async (job) => {
+            logger.debug(`Processing job ${job.id} from queue ${queueName}`);
+            const queueJob = {
+                id: job.id || "unknown",
+                data: job.data,
+                name: job.name,
+            };
+            await handler(queueJob);
+        }, Object.assign({ connection: this.redisClient, concurrency: 1 }, (startPaused ? { autorun: false } : {})));
+        // Add event listeners for worker
+        worker.on("completed", (job) => {
+            logger.debug(`Job ${job.id} completed in queue ${queueName}`);
+        });
+        worker.on("failed", (job, err) => {
+            var _a, _b;
+            logger.error(`Job ${job === null || job === void 0 ? void 0 : job.id} failed in queue ${queueName}:`, err);
+            // Move to dead letter queue after all retries exhausted
+            if (job && job.attemptsMade >= ((_b = (_a = job.opts) === null || _a === void 0 ? void 0 : _a.attempts) !== null && _b !== void 0 ? _b : 3)) {
+                this.moveToDeadLetterQueue(queueName, job).catch((dlqErr) => {
+                    logger.error(`Failed to move job ${job.id} to DLQ:`, dlqErr);
+                });
+            }
+        });
+        this.workers.set(queueName, worker);
+        if (startPaused) {
+            this.pendingWorkers.add(queueName);
+        }
+        logger.debug(`Created worker for queue: ${queueName}${startPaused ? " (paused)" : ""}`);
+    }
+    /**
+     * Move a failed job to the dead letter queue for later investigation/reprocessing
+     */
+    async moveToDeadLetterQueue(sourceQueue, job) {
+        const dlqName = `${sourceQueue}:dlq`;
+        await this.createQueue(dlqName);
+        const dlq = this.queues.get(dlqName);
+        if (!dlq)
+            return;
+        await dlq.add(dlqName, {
+            originalQueue: sourceQueue,
+            originalJobId: job.id,
+            data: job.data,
+            failedReason: job.failedReason,
+            attemptsMade: job.attemptsMade,
+            movedAt: new Date().toISOString(),
+        }, {
+            removeOnComplete: { age: 7 * 24 * 3600, count: 10000 }, // Keep DLQ jobs for 7 days
+            removeOnFail: false, // Never auto-remove DLQ failures
+        });
+        logger.info(`Moved failed job ${job.id} from ${sourceQueue} to DLQ ${dlqName}`);
+    }
+    async pauseWorker(queueName) {
+        const worker = this.workers.get(queueName);
+        if (!worker) {
+            logger.warn(`Cannot pause worker for queue ${queueName} - worker not found`);
+            return;
+        }
+        if (worker.isPaused()) {
+            logger.debug(`Worker for queue ${queueName} is already paused`);
+            return;
+        }
+        await worker.pause();
+        logger.debug(`Paused worker for queue ${queueName}`);
+    }
+    async resumeWorker(queueName) {
+        const worker = this.workers.get(queueName);
+        if (!worker) {
+            logger.warn(`Cannot resume worker for queue ${queueName} - worker not found`);
+            return;
+        }
+        // First-time start: worker was created with autorun:false and never started
+        if (this.pendingWorkers.has(queueName)) {
+            this.pendingWorkers.delete(queueName);
+            worker.run();
+            logger.debug(`Started worker for queue ${queueName} (first run)`);
+            return;
+        }
+        if (!worker.isPaused()) {
+            logger.debug(`Worker for queue ${queueName} is already running`);
+            return;
+        }
+        worker.resume();
+        logger.debug(`Resumed worker for queue ${queueName}`);
+    }
+    /**
+     * Get detailed queue statistics
+     */
+    async getQueueStats(queueName) {
+        var _a, _b, _c, _d;
+        const queue = this.queues.get(queueName);
+        if (!queue) {
+            return { waiting: 0, active: 0, completed: 0, failed: 0 };
+        }
+        const counts = await queue.getJobCounts("waiting", "active", "completed", "failed");
+        return {
+            waiting: (_a = counts.waiting) !== null && _a !== void 0 ? _a : 0,
+            active: (_b = counts.active) !== null && _b !== void 0 ? _b : 0,
+            completed: (_c = counts.completed) !== null && _c !== void 0 ? _c : 0,
+            failed: (_d = counts.failed) !== null && _d !== void 0 ? _d : 0,
+        };
+    }
+    isHealthy() {
+        return this.isConnected;
+    }
+    /**
+     * Get underlying Redis client for general-purpose Redis operations
+     * Returns the shared IORedis client used by all queues and workers
+     */
+    getRedisClient() {
+        if (!this.redisClient) {
+            throw new Error("Redis client not initialized. Call start() first.");
+        }
+        return this.redisClient;
+    }
+}
+exports.RedisQueue = RedisQueue;
+//# sourceMappingURL=redis-queue.js.map

package/dist/infrastructure/queue/redis-queue.js.map

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

package/dist/infrastructure/queue/types.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Message queue interface and payload types for lobu
+ * Supports multiple queue backends (currently Redis via BullMQ)
+ */
+export interface QueueJob<T = any> {
+    id: string;
+    data: T;
+    name?: string;
+}
+export interface QueueOptions {
+    priority?: number;
+    retryLimit?: number;
+    retryDelay?: number;
+    expireInSeconds?: number;
+    singletonKey?: string;
+    /** Delay in milliseconds before the job is processed */
+    delayMs?: number;
+}
+export interface QueueStats {
+    waiting: number;
+    active: number;
+    completed: number;
+    failed: number;
+}
+export type JobHandler<T = any> = (job: QueueJob<T>) => Promise<void>;
+/**
+ * Abstract message queue interface
+ * Implementations: RedisQueue (BullMQ)
+ */
+export interface IMessageQueue {
+    /**
+     * Start the queue (connect to backend)
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the queue (disconnect from backend)
+     */
+    stop(): Promise<void>;
+    /**
+     * Create a queue if it doesn't exist
+     */
+    createQueue(queueName: string): Promise<void>;
+    /**
+     * Send a message to a queue
+     */
+    send<T>(queueName: string, data: T, options?: QueueOptions): Promise<string>;
+    /**
+     * Subscribe to a queue and process jobs.
+     * @param startPaused - If true, worker is created but won't process jobs until resumeWorker() is called.
+     */
+    work<T>(queueName: string, handler: JobHandler<T>, options?: {
+        startPaused?: boolean;
+    }): Promise<void>;
+    /**
+     * Pause a queue worker (stops processing jobs)
+     */
+    pauseWorker(queueName: string): Promise<void>;
+    /**
+     * Resume a queue worker (starts processing jobs)
+     */
+    resumeWorker(queueName: string): Promise<void>;
+    /**
+     * Get detailed queue statistics
+     */
+    getQueueStats(queueName: string): Promise<QueueStats>;
+    /**
+     * Check if queue is healthy/connected
+     */
+    isHealthy(): boolean;
+    /**
+     * Get underlying Redis client for general-purpose Redis operations
+     * Used for application state storage (sessions, cache, etc.)
+     */
+    getRedisClient(): any;
+}
+/**
+ * Shared payload contract for worker → platform thread responses.
+ * Ensures gateway consumers and workers stay type-aligned.
+ */
+export interface ThreadResponsePayload {
+    messageId: string;
+    channelId: string;
+    conversationId: string;
+    userId: string;
+    teamId: string;
+    platform?: string;
+    content?: string;
+    delta?: string;
+    isFullReplacement?: boolean;
+    processedMessageIds?: string[];
+    error?: string;
+    errorCode?: string;
+    timestamp: number;
+    originalMessageId?: string;
+    moduleData?: Record<string, unknown>;
+    botResponseId?: string;
+    ephemeral?: boolean;
+    statusUpdate?: {
+        elapsedSeconds: number;
+        state: string;
+    };
+    platformMetadata?: Record<string, unknown>;
+    execId?: string;
+    execStream?: "stdout" | "stderr";
+    execExitCode?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/infrastructure/queue/types.d.ts.map

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

package/dist/infrastructure/queue/types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Message queue interface and payload types for lobu
+ * Supports multiple queue backends (currently Redis via BullMQ)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/infrastructure/queue/types.js.map

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

package/dist/infrastructure/redis/system-message-limiter.d.ts

@@ -0,0 +1,35 @@
+import type Redis from "ioredis";
+export interface SendOnceOptions {
+    /**
+     * How long to remember that this message was successfully sent.
+     * This is the main debounce window.
+     */
+    sentTtlSeconds: number;
+    /**
+     * How long to hold an in-flight lock to prevent concurrent duplicate sends.
+     * Keep short (10-60s) to bound crash edge cases.
+     */
+    lockTtlSeconds?: number;
+    /**
+     * If Redis is unavailable, allow the send to proceed (fail-open) or suppress it (fail-closed).
+     * For spammy system prompts, fail-closed is usually safer.
+     */
+    failOpen?: boolean;
+}
+/**
+ * Generic idempotency gate for outbound "system" messages (auth/setup prompts, warnings, etc.).
+ *
+ * Pattern:
+ * - `sentKey` is written only after a successful send.
+ * - `lockKey` prevents concurrent callers from sending duplicates while the first send is in-flight.
+ *
+ * This is intentionally small and Redis-only (no in-memory fallback) so behavior is consistent
+ * across replicas.
+ */
+export declare class SystemMessageLimiter {
+    private redis;
+    private namespace;
+    constructor(redis: Redis, namespace?: string);
+    sendOnce(dedupeKey: string, sendFn: () => Promise<void>, options: SendOnceOptions): Promise<boolean>;
+}
+//# sourceMappingURL=system-message-limiter.d.ts.map

package/dist/infrastructure/redis/system-message-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-message-limiter.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/redis/system-message-limiter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AAIjC,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,SAAS;gBADT,KAAK,EAAE,KAAK,EACZ,SAAS,GAAE,MAAiB;IAGhC,QAAQ,CACZ,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAC3B,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,OAAO,CAAC;CAkDpB"}

package/dist/infrastructure/redis/system-message-limiter.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SystemMessageLimiter = void 0;
+const core_1 = require("@lobu/core");
+const logger = (0, core_1.createLogger)("system-message-limiter");
+/**
+ * Generic idempotency gate for outbound "system" messages (auth/setup prompts, warnings, etc.).
+ *
+ * Pattern:
+ * - `sentKey` is written only after a successful send.
+ * - `lockKey` prevents concurrent callers from sending duplicates while the first send is in-flight.
+ *
+ * This is intentionally small and Redis-only (no in-memory fallback) so behavior is consistent
+ * across replicas.
+ */
+class SystemMessageLimiter {
+    constructor(redis, namespace = "sysmsg") {
+        this.redis = redis;
+        this.namespace = namespace;
+    }
+    async sendOnce(dedupeKey, sendFn, options) {
+        var _a, _b;
+        const sentTtlSeconds = Math.max(1, options.sentTtlSeconds);
+        const lockTtlSeconds = Math.max(1, (_a = options.lockTtlSeconds) !== null && _a !== void 0 ? _a : 30);
+        const failOpen = (_b = options.failOpen) !== null && _b !== void 0 ? _b : false;
+        const sentKey = `${this.namespace}:sent:${dedupeKey}`;
+        const lockKey = `${this.namespace}:lock:${dedupeKey}`;
+        try {
+            const alreadySent = (await this.redis.exists(sentKey)) === 1;
+            if (alreadySent) {
+                return false;
+            }
+            // Use a lock so concurrent callers (or retries) don't double-send before sentKey is written.
+            const lockResult = await this.redis.set(lockKey, "1", "EX", lockTtlSeconds, "NX");
+            if (lockResult !== "OK") {
+                return false;
+            }
+        }
+        catch (error) {
+            logger.warn({ error: String(error), sentKey, lockKey, failOpen }, "Redis unavailable while gating system message");
+            return failOpen;
+        }
+        try {
+            await sendFn();
+            // Mark as sent only after successful delivery attempt.
+            await this.redis.set(sentKey, "1", "EX", sentTtlSeconds);
+            return true;
+        }
+        finally {
+            // Best-effort lock cleanup; key also expires automatically.
+            try {
+                await this.redis.del(lockKey);
+            }
+            catch (error) {
+                logger.debug({ error: String(error), lockKey }, "Failed to release system-message lock");
+            }
+        }
+    }
+}
+exports.SystemMessageLimiter = SystemMessageLimiter;
+//# sourceMappingURL=system-message-limiter.js.map

package/dist/infrastructure/redis/system-message-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-message-limiter.js","sourceRoot":"","sources":["../../../src/infrastructure/redis/system-message-limiter.ts"],"names":[],"mappings":";;;AAAA,qCAA0C;AAG1C,MAAM,MAAM,GAAG,IAAA,mBAAY,EAAC,wBAAwB,CAAC,CAAC;AAoBtD;;;;;;;;;GASG;AACH,MAAa,oBAAoB;IAC/B,YACU,KAAY,EACZ,YAAoB,QAAQ;QAD5B,UAAK,GAAL,KAAK,CAAO;QACZ,cAAS,GAAT,SAAS,CAAmB;IACnC,CAAC;IAEJ,KAAK,CAAC,QAAQ,CACZ,SAAiB,EACjB,MAA2B,EAC3B,OAAwB;;QAExB,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;QAC3D,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAA,OAAO,CAAC,cAAc,mCAAI,EAAE,CAAC,CAAC;QACjE,MAAM,QAAQ,GAAG,MAAA,OAAO,CAAC,QAAQ,mCAAI,KAAK,CAAC;QAE3C,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,SAAS,SAAS,SAAS,EAAE,CAAC;QACtD,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,SAAS,SAAS,SAAS,EAAE,CAAC;QAEtD,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC;YAC7D,IAAI,WAAW,EAAE,CAAC;gBAChB,OAAO,KAAK,CAAC;YACf,CAAC;YAED,6FAA6F;YAC7F,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CACrC,OAAO,EACP,GAAG,EACH,IAAI,EACJ,cAAc,EACd,IAAI,CACL,CAAC;YACF,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;gBACxB,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CACT,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,EACpD,+CAA+C,CAChD,CAAC;YACF,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,EAAE,CAAC;YACf,uDAAuD;YACvD,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;YACzD,OAAO,IAAI,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,4DAA4D;YAC5D,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAChC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CACV,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,EACjC,uCAAuC,CACxC,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;CACF;AA5DD,oDA4DC"}

package/dist/interactions/config-request-store.d.ts

@@ -0,0 +1,41 @@
+import type Redis from "ioredis";
+import type { AgentSettingsStore } from "../auth/settings/agent-settings-store";
+import type { GrantStore } from "../permissions/grant-store";
+export interface PendingConfigSkill {
+    repo: string;
+    name?: string;
+    description?: string;
+    mcpServers?: Array<{
+        id: string;
+        name?: string;
+        url?: string;
+        type?: string;
+        command?: string;
+        args?: string[];
+    }>;
+    nixPackages?: string[];
+    permissions?: string[];
+    providers?: string[];
+}
+export interface PendingConfigRequest {
+    agentId: string;
+    reason: string;
+    message?: string;
+    skills?: PendingConfigSkill[];
+    mcpServers?: Array<{
+        id: string;
+        name?: string;
+        url?: string;
+        type?: string;
+        command?: string;
+        args?: string[];
+    }>;
+    nixPackages?: string[];
+    grants?: string[];
+    providers?: string[];
+}
+export declare function getPendingConfigRequest(redis: Redis, requestId: string): Promise<PendingConfigRequest | null>;
+export declare function deletePendingConfigRequest(redis: Redis, requestId: string): Promise<void>;
+export declare function buildConfigRequestText(request: PendingConfigRequest): string;
+export declare function applyPendingConfigRequest(agentSettingsStore: AgentSettingsStore, grantStore: GrantStore | undefined, request: PendingConfigRequest): Promise<void>;
+//# sourceMappingURL=config-request-store.d.ts.map

package/dist/interactions/config-request-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-request-store.d.ts","sourceRoot":"","sources":["../../src/interactions/config-request-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAI7D,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC,CAAC;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC9B,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC,CAAC;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAQtC;AAED,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAgC5E;AAuDD,wBAAsB,yBAAyB,CAC7C,kBAAkB,EAAE,kBAAkB,EACtC,UAAU,EAAE,UAAU,GAAG,SAAS,EAClC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CA4Cf"}