@jungjaehoon/mama-os 0.1.1

package/dist/concurrency/lane-manager.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Lane-based Concurrency Manager
+ *
+ * Implements a queue system for managing concurrent task execution.
+ * Based on OpenClaw's command-queue.js pump pattern.
+ *
+ * Key features:
+ * - Session lanes: Ensure same-session messages are processed in order
+ * - Global lane: Limit total concurrent API calls (rate limit protection)
+ * - 2-stage queueing: Session lane → Global lane
+ *
+ * @example
+ * ```typescript
+ * const manager = new LaneManager();
+ *
+ * // Simple enqueue
+ * const result = await manager.enqueue('session:user1', async () => {
+ *   return await callApi();
+ * });
+ *
+ * // 2-stage queueing (session → global)
+ * const result = await manager.enqueueWithSession('user1', async () => {
+ *   return await callApi();
+ * });
+ * ```
+ */
+import { type LaneManagerConfig, type EnqueueOptions } from './types.js';
+export declare class LaneManager {
+    private lanes;
+    private config;
+    constructor(config?: LaneManagerConfig);
+    /**
+     * Get or create lane state
+     */
+    private getLaneState;
+    /**
+     * Drain lane queue using pump pattern
+     * Executes tasks up to maxConcurrent limit
+     */
+    private drainLane;
+    /**
+     * Enqueue a task in a lane
+     *
+     * @param lane - Lane identifier
+     * @param task - Async task to execute
+     * @param options - Enqueue options
+     * @returns Promise that resolves with task result
+     */
+    enqueue<T>(lane: string, task: () => Promise<T>, options?: EnqueueOptions): Promise<T>;
+    /**
+     * Resolve session lane name from session key
+     * Ensures consistent naming: "user1" → "session:user1"
+     */
+    resolveSessionLane(sessionKey: string): string;
+    /**
+     * Resolve global lane name
+     * Returns "main" if not specified
+     */
+    resolveGlobalLane(lane?: string): string;
+    /**
+     * 2-stage queueing: Session lane → Global lane
+     *
+     * This ensures:
+     * 1. Same-session messages are processed in order (session lane)
+     * 2. Total API calls are rate-limited (global lane)
+     *
+     * @param sessionKey - Session identifier (will be prefixed with "session:")
+     * @param task - Async task to execute
+     * @param globalLane - Global lane name (default: "main")
+     */
+    enqueueWithSession<T>(sessionKey: string, task: () => Promise<T>, globalLane?: string): Promise<T>;
+    /**
+     * Set max concurrent tasks for a lane
+     */
+    setLaneMaxConcurrent(lane: string, maxConcurrent: number): void;
+    /**
+     * Get current queue size for a lane
+     * Includes both queued and active tasks
+     */
+    getQueueSize(lane: string): number;
+    /**
+     * Get total queue size across all lanes
+     */
+    getTotalQueueSize(): number;
+    /**
+     * Clear all pending tasks in a lane
+     * Active tasks continue to completion
+     *
+     * @returns Number of tasks removed
+     */
+    clearLane(lane: string): number;
+    /**
+     * Get all lane names
+     */
+    getLanes(): string[];
+    /**
+     * Get lane statistics
+     */
+    getStats(): Map<string, {
+        queued: number;
+        active: number;
+        maxConcurrent: number;
+    }>;
+}
+/**
+ * Get or create global LaneManager instance
+ */
+export declare function getGlobalLaneManager(config?: LaneManagerConfig): LaneManager;
+/**
+ * Reset global LaneManager (mainly for testing)
+ */
+export declare function resetGlobalLaneManager(): void;
+//# sourceMappingURL=lane-manager.d.ts.map

package/dist/concurrency/lane-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lane-manager.d.ts","sourceRoot":"","sources":["../../src/concurrency/lane-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EAGpB,MAAM,YAAY,CAAC;AAEpB,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,MAAM,CAAuE;gBAEzE,MAAM,CAAC,EAAE,iBAAiB;IAQtC;;OAEG;IACH,OAAO,CAAC,YAAY;IAepB;;;OAGG;IACH,OAAO,CAAC,SAAS;IAiDjB;;;;;;;OAOG;IACH,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAqBtF;;;OAGG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAK9C;;;OAGG;IACH,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;IAKxC;;;;;;;;;;OAUG;IACH,kBAAkB,CAAC,CAAC,EAClB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACtB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,CAAC,CAAC;IAQb;;OAEG;IACH,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI;IAO/D;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAMlC;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAQ3B;;;;;OAKG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAe/B;;OAEG;IACH,QAAQ,IAAI,MAAM,EAAE;IAIpB;;OAEG;IACH,QAAQ,IAAI,GAAG,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;CAWnF;AAKD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,WAAW,CAK5E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}

package/dist/concurrency/lane-manager.js

@@ -0,0 +1,245 @@
+"use strict";
+/**
+ * Lane-based Concurrency Manager
+ *
+ * Implements a queue system for managing concurrent task execution.
+ * Based on OpenClaw's command-queue.js pump pattern.
+ *
+ * Key features:
+ * - Session lanes: Ensure same-session messages are processed in order
+ * - Global lane: Limit total concurrent API calls (rate limit protection)
+ * - 2-stage queueing: Session lane → Global lane
+ *
+ * @example
+ * ```typescript
+ * const manager = new LaneManager();
+ *
+ * // Simple enqueue
+ * const result = await manager.enqueue('session:user1', async () => {
+ *   return await callApi();
+ * });
+ *
+ * // 2-stage queueing (session → global)
+ * const result = await manager.enqueueWithSession('user1', async () => {
+ *   return await callApi();
+ * });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LaneManager = void 0;
+exports.getGlobalLaneManager = getGlobalLaneManager;
+exports.resetGlobalLaneManager = resetGlobalLaneManager;
+const types_js_1 = require("./types.js");
+class LaneManager {
+    lanes = new Map();
+    config;
+    constructor(config) {
+        this.config = {
+            defaultMaxConcurrent: config?.defaultMaxConcurrent ?? 1,
+            warnAfterMs: config?.warnAfterMs ?? 2000,
+            logger: config?.logger ?? types_js_1.defaultLogger,
+        };
+    }
+    /**
+     * Get or create lane state
+     */
+    getLaneState(lane) {
+        let state = this.lanes.get(lane);
+        if (!state) {
+            state = {
+                lane,
+                queue: [],
+                active: 0,
+                maxConcurrent: this.config.defaultMaxConcurrent,
+                draining: false,
+            };
+            this.lanes.set(lane, state);
+        }
+        return state;
+    }
+    /**
+     * Drain lane queue using pump pattern
+     * Executes tasks up to maxConcurrent limit
+     */
+    drainLane(lane) {
+        const state = this.getLaneState(lane);
+        if (state.draining)
+            return;
+        state.draining = true;
+        const pump = () => {
+            // Execute tasks up to concurrent limit
+            while (state.active < state.maxConcurrent && state.queue.length > 0) {
+                const entry = state.queue.shift();
+                const waitedMs = Date.now() - entry.enqueuedAt;
+                // Warn if waited too long
+                if (waitedMs >= entry.warnAfterMs) {
+                    entry.onWait?.(waitedMs, state.queue.length);
+                    this.config.logger.warn(`Long wait: lane=${lane} waited=${waitedMs}ms queue=${state.queue.length}`);
+                }
+                state.active += 1;
+                // Execute task asynchronously
+                (async () => {
+                    const startTime = Date.now();
+                    try {
+                        const result = await entry.task();
+                        state.active -= 1;
+                        this.config.logger.debug(`Task done: lane=${lane} duration=${Date.now() - startTime}ms active=${state.active} queued=${state.queue.length}`);
+                        pump(); // Continue processing
+                        entry.resolve(result);
+                    }
+                    catch (err) {
+                        state.active -= 1;
+                        this.config.logger.debug(`Task error: lane=${lane} duration=${Date.now() - startTime}ms error="${err}"`);
+                        pump(); // Continue processing even on error
+                        entry.reject(err);
+                    }
+                })();
+            }
+            state.draining = false;
+        };
+        pump();
+    }
+    /**
+     * Enqueue a task in a lane
+     *
+     * @param lane - Lane identifier
+     * @param task - Async task to execute
+     * @param options - Enqueue options
+     * @returns Promise that resolves with task result
+     */
+    enqueue(lane, task, options) {
+        const state = this.getLaneState(lane);
+        return new Promise((resolve, reject) => {
+            const entry = {
+                task,
+                resolve: resolve,
+                reject,
+                enqueuedAt: Date.now(),
+                warnAfterMs: options?.warnAfterMs ?? this.config.warnAfterMs,
+                onWait: options?.onWait,
+            };
+            state.queue.push(entry);
+            this.config.logger.debug(`Enqueued: lane=${lane} queueSize=${state.queue.length + state.active}`);
+            this.drainLane(lane);
+        });
+    }
+    /**
+     * Resolve session lane name from session key
+     * Ensures consistent naming: "user1" → "session:user1"
+     */
+    resolveSessionLane(sessionKey) {
+        const cleaned = sessionKey.trim() || 'main';
+        return cleaned.startsWith('session:') ? cleaned : `session:${cleaned}`;
+    }
+    /**
+     * Resolve global lane name
+     * Returns "main" if not specified
+     */
+    resolveGlobalLane(lane) {
+        const cleaned = lane?.trim();
+        return cleaned || 'main';
+    }
+    /**
+     * 2-stage queueing: Session lane → Global lane
+     *
+     * This ensures:
+     * 1. Same-session messages are processed in order (session lane)
+     * 2. Total API calls are rate-limited (global lane)
+     *
+     * @param sessionKey - Session identifier (will be prefixed with "session:")
+     * @param task - Async task to execute
+     * @param globalLane - Global lane name (default: "main")
+     */
+    enqueueWithSession(sessionKey, task, globalLane) {
+        const sessionLaneName = this.resolveSessionLane(sessionKey);
+        const globalLaneName = this.resolveGlobalLane(globalLane);
+        // Nested queueing: session → global
+        return this.enqueue(sessionLaneName, () => this.enqueue(globalLaneName, task));
+    }
+    /**
+     * Set max concurrent tasks for a lane
+     */
+    setLaneMaxConcurrent(lane, maxConcurrent) {
+        const state = this.getLaneState(lane);
+        state.maxConcurrent = Math.max(1, Math.floor(maxConcurrent));
+        // Trigger drain in case we increased the limit
+        this.drainLane(lane);
+    }
+    /**
+     * Get current queue size for a lane
+     * Includes both queued and active tasks
+     */
+    getQueueSize(lane) {
+        const state = this.lanes.get(lane);
+        if (!state)
+            return 0;
+        return state.queue.length + state.active;
+    }
+    /**
+     * Get total queue size across all lanes
+     */
+    getTotalQueueSize() {
+        let total = 0;
+        for (const state of this.lanes.values()) {
+            total += state.queue.length + state.active;
+        }
+        return total;
+    }
+    /**
+     * Clear all pending tasks in a lane
+     * Active tasks continue to completion
+     *
+     * @returns Number of tasks removed
+     */
+    clearLane(lane) {
+        const state = this.lanes.get(lane);
+        if (!state)
+            return 0;
+        const removed = state.queue.length;
+        // Reject all pending tasks
+        for (const entry of state.queue) {
+            entry.reject(new Error('Lane cleared'));
+        }
+        state.queue.length = 0;
+        return removed;
+    }
+    /**
+     * Get all lane names
+     */
+    getLanes() {
+        return Array.from(this.lanes.keys());
+    }
+    /**
+     * Get lane statistics
+     */
+    getStats() {
+        const stats = new Map();
+        for (const [lane, state] of this.lanes) {
+            stats.set(lane, {
+                queued: state.queue.length,
+                active: state.active,
+                maxConcurrent: state.maxConcurrent,
+            });
+        }
+        return stats;
+    }
+}
+exports.LaneManager = LaneManager;
+// Singleton instance for global use
+let globalLaneManager = null;
+/**
+ * Get or create global LaneManager instance
+ */
+function getGlobalLaneManager(config) {
+    if (!globalLaneManager) {
+        globalLaneManager = new LaneManager(config);
+    }
+    return globalLaneManager;
+}
+/**
+ * Reset global LaneManager (mainly for testing)
+ */
+function resetGlobalLaneManager() {
+    globalLaneManager = null;
+}
+//# sourceMappingURL=lane-manager.js.map

package/dist/concurrency/lane-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lane-manager.js","sourceRoot":"","sources":["../../src/concurrency/lane-manager.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;;;AAqPH,oDAKC;AAKD,wDAEC;AA/PD,yCAOoB;AAEpB,MAAa,WAAW;IACd,KAAK,GAA2B,IAAI,GAAG,EAAE,CAAC;IAC1C,MAAM,CAAuE;IAErF,YAAY,MAA0B;QACpC,IAAI,CAAC,MAAM,GAAG;YACZ,oBAAoB,EAAE,MAAM,EAAE,oBAAoB,IAAI,CAAC;YACvD,WAAW,EAAE,MAAM,EAAE,WAAW,IAAI,IAAI;YACxC,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,wBAAa;SACxC,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,IAAY;QAC/B,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG;gBACN,IAAI;gBACJ,KAAK,EAAE,EAAE;gBACT,MAAM,EAAE,CAAC;gBACT,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,oBAAoB;gBAC/C,QAAQ,EAAE,KAAK;aAChB,CAAC;YACF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC9B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;OAGG;IACK,SAAS,CAAC,IAAY;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,KAAK,CAAC,QAAQ;YAAE,OAAO;QAC3B,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;QAEtB,MAAM,IAAI,GAAG,GAAG,EAAE;YAChB,uCAAuC;YACvC,OAAO,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpE,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,EAAG,CAAC;gBACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC;gBAE/C,0BAA0B;gBAC1B,IAAI,QAAQ,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;oBAClC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;oBAC7C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CACrB,mBAAmB,IAAI,WAAW,QAAQ,YAAY,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAC3E,CAAC;gBACJ,CAAC;gBAED,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;gBAElB,8BAA8B;gBAC9B,CAAC,KAAK,IAAI,EAAE;oBACV,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;oBAC7B,IAAI,CAAC;wBACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;wBAClC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;wBAClB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CACtB,mBAAmB,IAAI,aAAa,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,aAAa,KAAK,CAAC,MAAM,WAAW,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CACnH,CAAC;wBACF,IAAI,EAAE,CAAC,CAAC,sBAAsB;wBAC9B,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;oBACxB,CAAC;oBAAC,OAAO,GAAG,EAAE,CAAC;wBACb,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;wBAClB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CACtB,oBAAoB,IAAI,aAAa,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,aAAa,GAAG,GAAG,CAC/E,CAAC;wBACF,IAAI,EAAE,CAAC,CAAC,oCAAoC;wBAC5C,KAAK,CAAC,MAAM,CAAC,GAAY,CAAC,CAAC;oBAC7B,CAAC;gBACH,CAAC,CAAC,EAAE,CAAC;YACP,CAAC;YAED,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC;QACzB,CAAC,CAAC;QAEF,IAAI,EAAE,CAAC;IACT,CAAC;IAED;;;;;;;OAOG;IACH,OAAO,CAAI,IAAY,EAAE,IAAsB,EAAE,OAAwB;QACvE,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAEtC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,KAAK,GAAkB;gBAC3B,IAAI;gBACJ,OAAO,EAAE,OAAmC;gBAC5C,MAAM;gBACN,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;gBACtB,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW;gBAC5D,MAAM,EAAE,OAAO,EAAE,MAAM;aACxB,CAAC;YAEF,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAA4B,CAAC,CAAC;YAC/C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CACtB,kBAAkB,IAAI,cAAc,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,CACxE,CAAC;YACF,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,kBAAkB,CAAC,UAAkB;QACnC,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,MAAM,CAAC;QAC5C,OAAO,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,OAAO,EAAE,CAAC;IACzE,CAAC;IAED;;;OAGG;IACH,iBAAiB,CAAC,IAAa;QAC7B,MAAM,OAAO,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC;QAC7B,OAAO,OAAO,IAAI,MAAM,CAAC;IAC3B,CAAC;IAED;;;;;;;;;;OAUG;IACH,kBAAkB,CAChB,UAAkB,EAClB,IAAsB,EACtB,UAAmB;QAEnB,MAAM,eAAe,GAAG,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;QAC5D,MAAM,cAAc,GAAG,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAE1D,oCAAoC;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC,CAAC;IACjF,CAAC;IAED;;OAEG;IACH,oBAAoB,CAAC,IAAY,EAAE,aAAqB;QACtD,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACtC,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;QAC7D,+CAA+C;QAC/C,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,IAAY;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK;YAAE,OAAO,CAAC,CAAC;QACrB,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACxC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC7C,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,IAAY;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK;YAAE,OAAO,CAAC,CAAC;QAErB,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC;QAEnC,2BAA2B;QAC3B,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChC,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC;QAC1C,CAAC;QAED,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QACvB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,MAAM,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;QACxB,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACvC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE;gBACd,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM;gBAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,aAAa,EAAE,KAAK,CAAC,aAAa;aACnC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAlOD,kCAkOC;AAED,oCAAoC;AACpC,IAAI,iBAAiB,GAAuB,IAAI,CAAC;AAEjD;;GAEG;AACH,SAAgB,oBAAoB,CAAC,MAA0B;IAC7D,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,iBAAiB,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,SAAgB,sBAAsB;IACpC,iBAAiB,GAAG,IAAI,CAAC;AAC3B,CAAC"}

package/dist/concurrency/session-key.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Session Key Utilities
+ *
+ * Provides consistent session key generation for lane-based concurrency.
+ */
+import type { MessageSource } from '../gateways/types.js';
+/**
+ * Build a session key from message source, channel, and user
+ *
+ * @param source - Message source (discord, slack, chatwork, etc.)
+ * @param channelId - Channel/room identifier
+ * @param userId - User identifier
+ * @returns Session key in format "{source}:{channelId}:{userId}"
+ *
+ * @example
+ * ```typescript
+ * buildSessionKey('discord', '123456789', '987654321')
+ * // → 'discord:123456789:987654321'
+ * ```
+ */
+export declare function buildSessionKey(source: MessageSource | string, channelId: string, userId: string): string;
+/**
+ * Build a channel-level session key (shared by all users in a channel)
+ *
+ * @param source - Message source
+ * @param channelId - Channel/room identifier
+ * @returns Session key in format "{source}:{channelId}"
+ */
+export declare function buildChannelSessionKey(source: MessageSource | string, channelId: string): string;
+/**
+ * Parse a session key into its components
+ *
+ * @param sessionKey - Session key to parse
+ * @returns Parsed components or null if invalid
+ */
+export declare function parseSessionKey(sessionKey: string): {
+    source: string;
+    channelId: string;
+    userId?: string;
+} | null;
+//# sourceMappingURL=session-key.d.ts.map

package/dist/concurrency/session-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-key.d.ts","sourceRoot":"","sources":["../../src/concurrency/session-key.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,aAAa,GAAG,MAAM,EAC9B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEhG;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,IAAI,CAmBP"}

package/dist/concurrency/session-key.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * Session Key Utilities
+ *
+ * Provides consistent session key generation for lane-based concurrency.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSessionKey = buildSessionKey;
+exports.buildChannelSessionKey = buildChannelSessionKey;
+exports.parseSessionKey = parseSessionKey;
+/**
+ * Build a session key from message source, channel, and user
+ *
+ * @param source - Message source (discord, slack, chatwork, etc.)
+ * @param channelId - Channel/room identifier
+ * @param userId - User identifier
+ * @returns Session key in format "{source}:{channelId}:{userId}"
+ *
+ * @example
+ * ```typescript
+ * buildSessionKey('discord', '123456789', '987654321')
+ * // → 'discord:123456789:987654321'
+ * ```
+ */
+function buildSessionKey(source, channelId, userId) {
+    return `${source}:${channelId}:${userId}`;
+}
+/**
+ * Build a channel-level session key (shared by all users in a channel)
+ *
+ * @param source - Message source
+ * @param channelId - Channel/room identifier
+ * @returns Session key in format "{source}:{channelId}"
+ */
+function buildChannelSessionKey(source, channelId) {
+    return `${source}:${channelId}`;
+}
+/**
+ * Parse a session key into its components
+ *
+ * @param sessionKey - Session key to parse
+ * @returns Parsed components or null if invalid
+ */
+function parseSessionKey(sessionKey) {
+    const parts = sessionKey.split(':');
+    if (parts.length < 2) {
+        return null;
+    }
+    if (parts.length === 2) {
+        return {
+            source: parts[0],
+            channelId: parts[1],
+        };
+    }
+    return {
+        source: parts[0],
+        channelId: parts[1],
+        userId: parts.slice(2).join(':'), // Handle userIds with colons
+    };
+}
+//# sourceMappingURL=session-key.js.map

package/dist/concurrency/session-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-key.js","sourceRoot":"","sources":["../../src/concurrency/session-key.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAkBH,0CAMC;AASD,wDAEC;AAQD,0CAuBC;AA9DD;;;;;;;;;;;;;GAaG;AACH,SAAgB,eAAe,CAC7B,MAA8B,EAC9B,SAAiB,EACjB,MAAc;IAEd,OAAO,GAAG,MAAM,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;AAC5C,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,sBAAsB,CAAC,MAA8B,EAAE,SAAiB;IACtF,OAAO,GAAG,MAAM,IAAI,SAAS,EAAE,CAAC;AAClC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,UAAkB;IAKhD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAEpC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;YAChB,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;SACpB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;QAChB,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;QACnB,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,6BAA6B;KAChE,CAAC;AACJ,CAAC"}

package/dist/concurrency/types.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Lane-based Concurrency System Types
+ * Based on OpenClaw's command-queue.js architecture
+ */
+/**
+ * State of a single lane (queue)
+ */
+export interface LaneState {
+    /** Lane identifier (e.g., "session:user1", "main") */
+    lane: string;
+    /** Pending tasks in queue */
+    queue: QueueEntry<unknown>[];
+    /** Number of currently executing tasks */
+    active: number;
+    /** Maximum concurrent tasks allowed */
+    maxConcurrent: number;
+    /** Whether the lane is currently draining */
+    draining: boolean;
+}
+/**
+ * Entry in the task queue
+ */
+export interface QueueEntry<T> {
+    /** Async task to execute */
+    task: () => Promise<T>;
+    /** Resolve callback for the promise */
+    resolve: (value: T) => void;
+    /** Reject callback for the promise */
+    reject: (error: Error) => void;
+    /** Timestamp when task was enqueued */
+    enqueuedAt: number;
+    /** Threshold for warning about long wait times */
+    warnAfterMs: number;
+    /** Optional callback when wait time exceeds threshold */
+    onWait?: (waitedMs: number, queueLength: number) => void;
+}
+/**
+ * Configuration for LaneManager
+ */
+export interface LaneManagerConfig {
+    /** Default max concurrent tasks per lane (default: 1) */
+    defaultMaxConcurrent?: number;
+    /** Warn after this many ms of waiting (default: 2000) */
+    warnAfterMs?: number;
+    /** Logger function for warnings */
+    logger?: LaneLogger;
+}
+/**
+ * Options for enqueuing a task
+ */
+export interface EnqueueOptions {
+    /** Override warn threshold for this task */
+    warnAfterMs?: number;
+    /** Callback when wait exceeds threshold */
+    onWait?: (waitedMs: number, queueLength: number) => void;
+}
+/**
+ * Logger interface for lane events
+ */
+export interface LaneLogger {
+    debug: (message: string) => void;
+    warn: (message: string) => void;
+    error: (message: string) => void;
+}
+/**
+ * Default console logger
+ */
+export declare const defaultLogger: LaneLogger;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/concurrency/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;IAC7B,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,4BAA4B;IAC5B,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;IACvB,uCAAuC;IACvC,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC5B,sCAAsC;IACtC,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAC/B,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1D;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1D;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,UAI3B,CAAC"}

package/dist/concurrency/types.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * Lane-based Concurrency System Types
+ * Based on OpenClaw's command-queue.js architecture
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultLogger = void 0;
+/**
+ * Default console logger
+ */
+exports.defaultLogger = {
+    debug: (msg) => console.debug(`[Lane] ${msg}`),
+    warn: (msg) => console.warn(`[Lane] ${msg}`),
+    error: (msg) => console.error(`[Lane] ${msg}`),
+};
+//# sourceMappingURL=types.js.map

package/dist/concurrency/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/concurrency/types.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAmEH;;GAEG;AACU,QAAA,aAAa,GAAe;IACvC,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,EAAE,CAAC;IAC9C,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;IAC5C,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,EAAE,CAAC;CAC/C,CAAC"}

package/dist/gateways/channel-history.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Channel History Manager
+ *
+ * In-memory storage of recent messages per channel, similar to OpenClaw's
+ * guildHistories map. Stores message history with attachments for context
+ * injection and skill matching.
+ *
+ * Features:
+ * - FIFO ring buffer with configurable limit
+ * - Attachment references preserved
+ * - History formatting for Claude context
+ * - Automatic cleanup of old entries
+ */
+import type { MessageAttachment } from './types.js';
+/**
+ * Single history entry
+ */
+export interface HistoryEntry {
+    /** Message ID */
+    messageId: string;
+    /** Author username */
+    sender: string;
+    /** Author user ID */
+    userId: string;
+    /** Message text content */
+    body: string;
+    /** Timestamp */
+    timestamp: number;
+    /** Attached files */
+    attachments?: MessageAttachment[];
+    /** Whether this is a bot message */
+    isBot?: boolean;
+}
+/**
+ * Channel history configuration
+ */
+export interface ChannelHistoryConfig {
+    /** Maximum messages to keep per channel (default: 20) */
+    limit?: number;
+    /** Maximum age in ms before auto-cleanup (default: 10 minutes) */
+    maxAgeMs?: number;
+}
+/**
+ * Channel History Manager
+ *
+ * Manages per-channel message history in memory.
+ */
+export declare class ChannelHistory {
+    private histories;
+    private config;
+    constructor(config?: ChannelHistoryConfig);
+    /**
+     * Record a message to channel history
+     */
+    record(channelId: string, entry: HistoryEntry): void;
+    /**
+     * Get history for a channel
+     */
+    getHistory(channelId: string): HistoryEntry[];
+    /**
+     * Get recent history excluding the current message
+     */
+    getRecentHistory(channelId: string, excludeMessageId?: string): HistoryEntry[];
+    /**
+     * Get recent attachments from history (for skill matching)
+     */
+    getRecentAttachments(channelId: string, userId?: string): MessageAttachment[];
+    /**
+     * Format history for Claude context injection
+     * Similar to OpenClaw's "[Chat messages since your last reply - for context]"
+     */
+    formatForContext(channelId: string, excludeMessageId?: string): string;
+    /**
+     * Clear history for a channel (after bot reply, like OpenClaw)
+     */
+    clear(channelId: string): void;
+    /**
+     * Clear attachments from history while keeping text for conversation context
+     */
+    clearAttachments(channelId: string): void;
+    /**
+     * Clear all histories
+     */
+    clearAll(): void;
+    /**
+     * Get all channel IDs with history
+     */
+    getChannelIds(): string[];
+    /**
+     * Cleanup old entries across all channels
+     */
+    cleanup(): number;
+}
+/**
+ * Get global channel history instance
+ */
+export declare function getChannelHistory(): ChannelHistory;
+/**
+ * Set global channel history instance (for testing)
+ */
+export declare function setChannelHistory(history: ChannelHistory): void;
+//# sourceMappingURL=channel-history.d.ts.map