@jungjaehoon/mama-os 0.53.1 → 0.58.0

package/dist/cli/utils/pid-manager.js

@@ -1,141 +0,0 @@
-"use strict";
-/**
- * PID Manager for MAMA Standalone
- *
- * Manages PID file for daemon process tracking
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.expandPath = void 0;
-exports.getPidPath = getPidPath;
-exports.writePid = writePid;
-exports.readPid = readPid;
-exports.deletePid = deletePid;
-exports.isProcessRunning = isProcessRunning;
-exports.isDaemonRunning = isDaemonRunning;
-exports.getUptime = getUptime;
-const promises_1 = require("node:fs/promises");
-const node_fs_1 = require("node:fs");
-const node_path_1 = require("node:path");
-const types_js_1 = require("../config/types.js");
-const config_manager_js_1 = require("../config/config-manager.js");
-/**
- * Get the full path to PID file
- */
-function getPidPath() {
-    return (0, config_manager_js_1.expandPath)(types_js_1.MAMA_PATHS.PID);
-}
-/**
- * Write PID file with process information
- *
- * @param pid - Process ID to write
- */
-async function writePid(pid) {
-    const pidPath = getPidPath();
-    const pidDir = (0, node_path_1.dirname)(pidPath);
-    // Ensure directory exists
-    if (!(0, node_fs_1.existsSync)(pidDir)) {
-        await (0, promises_1.mkdir)(pidDir, { recursive: true });
-    }
-    const info = {
-        pid,
-        startedAt: Date.now(),
-    };
-    await (0, promises_1.writeFile)(pidPath, JSON.stringify(info, null, 2), 'utf-8');
-}
-/**
- * Read process information from PID file
- *
- * @returns Process info or null if file doesn't exist
- */
-async function readPid() {
-    const pidPath = getPidPath();
-    if (!(0, node_fs_1.existsSync)(pidPath)) {
-        return null;
-    }
-    try {
-        const content = await (0, promises_1.readFile)(pidPath, 'utf-8');
-        const info = JSON.parse(content);
-        // Validate structure
-        if (typeof info.pid !== 'number' || typeof info.startedAt !== 'number') {
-            // Legacy format: just PID number
-            const pid = parseInt(content.trim(), 10);
-            if (!isNaN(pid)) {
-                return { pid, startedAt: Date.now() };
-            }
-            return null;
-        }
-        return info;
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Delete PID file
- */
-async function deletePid() {
-    const pidPath = getPidPath();
-    if ((0, node_fs_1.existsSync)(pidPath)) {
-        await (0, promises_1.unlink)(pidPath);
-    }
-}
-/**
- * Check if a process with given PID is running
- *
- * @param pid - Process ID to check
- * @returns true if process is running
- */
-function isProcessRunning(pid) {
-    try {
-        // Sending signal 0 checks if process exists without actually sending a signal
-        process.kill(pid, 0);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Check if MAMA daemon is currently running
- *
- * @returns Process info if running, null otherwise
- */
-async function isDaemonRunning() {
-    const info = await readPid();
-    if (!info) {
-        return null;
-    }
-    if (isProcessRunning(info.pid)) {
-        return info;
-    }
-    // Process not running, clean up stale PID file
-    await deletePid();
-    return null;
-}
-/**
- * Get uptime in human-readable format
- *
- * @param startedAt - Start timestamp
- * @returns Human-readable uptime string
- */
-function getUptime(startedAt) {
-    const uptimeMs = Date.now() - startedAt;
-    const seconds = Math.floor(uptimeMs / 1000);
-    const minutes = Math.floor(seconds / 60);
-    const hours = Math.floor(minutes / 60);
-    const days = Math.floor(hours / 24);
-    if (days > 0) {
-        return `${days}d ${hours % 24}h`;
-    }
-    if (hours > 0) {
-        return `${hours}h ${minutes % 60}m`;
-    }
-    if (minutes > 0) {
-        return `${minutes}m ${seconds % 60}s`;
-    }
-    return `${seconds}s`;
-}
-// Re-export expandPath for convenience
-var config_manager_js_2 = require("../config/config-manager.js");
-Object.defineProperty(exports, "expandPath", { enumerable: true, get: function () { return config_manager_js_2.expandPath; } });
-//# sourceMappingURL=pid-manager.js.map

package/dist/cli/utils/pid-manager.js.map

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

package/dist/concurrency/index.d.ts

@@ -1,13 +0,0 @@
-/**
- * Lane-based Concurrency System
- *
- * Provides queue-based concurrent task execution with:
- * - 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
- */
-export { LaneManager, getGlobalLaneManager, resetGlobalLaneManager } from './lane-manager.js';
-export { buildSessionKey, buildChannelSessionKey, parseSessionKey } from './session-key.js';
-export type { LaneState, QueueEntry, LaneManagerConfig, EnqueueOptions, LaneLogger, } from './types.js';
-export { defaultLogger } from './types.js';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/concurrency/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAE9F,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAE5F,YAAY,EACV,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/concurrency/index.js

@@ -1,22 +0,0 @@
-"use strict";
-/**
- * Lane-based Concurrency System
- *
- * Provides queue-based concurrent task execution with:
- * - 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
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.defaultLogger = exports.parseSessionKey = exports.buildChannelSessionKey = exports.buildSessionKey = exports.resetGlobalLaneManager = exports.getGlobalLaneManager = exports.LaneManager = void 0;
-var lane_manager_js_1 = require("./lane-manager.js");
-Object.defineProperty(exports, "LaneManager", { enumerable: true, get: function () { return lane_manager_js_1.LaneManager; } });
-Object.defineProperty(exports, "getGlobalLaneManager", { enumerable: true, get: function () { return lane_manager_js_1.getGlobalLaneManager; } });
-Object.defineProperty(exports, "resetGlobalLaneManager", { enumerable: true, get: function () { return lane_manager_js_1.resetGlobalLaneManager; } });
-var session_key_js_1 = require("./session-key.js");
-Object.defineProperty(exports, "buildSessionKey", { enumerable: true, get: function () { return session_key_js_1.buildSessionKey; } });
-Object.defineProperty(exports, "buildChannelSessionKey", { enumerable: true, get: function () { return session_key_js_1.buildChannelSessionKey; } });
-Object.defineProperty(exports, "parseSessionKey", { enumerable: true, get: function () { return session_key_js_1.parseSessionKey; } });
-var types_js_1 = require("./types.js");
-Object.defineProperty(exports, "defaultLogger", { enumerable: true, get: function () { return types_js_1.defaultLogger; } });
-//# sourceMappingURL=index.js.map

package/dist/concurrency/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/concurrency/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,qDAA8F;AAArF,8GAAA,WAAW,OAAA;AAAE,uHAAA,oBAAoB,OAAA;AAAE,yHAAA,sBAAsB,OAAA;AAElE,mDAA4F;AAAnF,iHAAA,eAAe,OAAA;AAAE,wHAAA,sBAAsB,OAAA;AAAE,iHAAA,eAAe,OAAA;AAUjE,uCAA2C;AAAlC,yGAAA,aAAa,OAAA"}

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

@@ -1,113 +0,0 @@
-/**
- * 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, options?: EnqueueOptions): 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

@@ -1 +0,0 @@
-{"version":3,"file":"lane-manager.d.ts","sourceRoot":"","sources":["../../src/concurrency/lane-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH,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;IAuBtF;;;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,EACnB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC;IAYb;;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

@@ -1,248 +0,0 @@
-"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 node_async_hooks_1 = require("node:async_hooks");
-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: node_async_hooks_1.AsyncResource.bind(task),
-                resolve: resolve,
-                reject,
-                enqueuedAt: Date.now(),
-                warnAfterMs: options?.warnAfterMs ?? this.config.warnAfterMs,
-                priority: options?.priority ?? 0,
-                onWait: options?.onWait,
-            };
-            state.queue.push(entry);
-            state.queue.sort((left, right) => right.priority - left.priority);
-            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, options) {
-        const sessionLaneName = this.resolveSessionLane(sessionKey);
-        const globalLaneName = this.resolveGlobalLane(globalLane);
-        // Nested queueing: session → global
-        return this.enqueue(sessionLaneName, () => this.enqueue(globalLaneName, task, options), options);
-    }
-    /**
-     * 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

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

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

@@ -1,41 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,61 +0,0 @@
-"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