chorus-codes 0.7.0 → 0.7.2

package/dist/daemon/tmux.js

@@ -0,0 +1,341 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TmuxManagerImpl = void 0;
+const child_process_1 = require("child_process");
+/**
+ * TmuxManagerImpl: Session manager for Chorus CLI integrations.
+ *
+ * Responsibilities:
+ * - Acquire sessions respecting share-session policy (across rounds, rarely across phases)
+ * - Spawn fresh tmux sessions via the agent shim's buildLaunchCommand
+ * - Provide tmux operations (sendKeys, pasteBuffer, capturePane)
+ * - Track sessions in memory + reconcile from `tmux ls` on startup
+ * - Reap orphans via reapOnce() called by index.ts every 5 min
+ *
+ * Hard rules:
+ * 1. %q-quote all user/template values at substitution time
+ * 2. Never reuse across chats (hard rule)
+ * 3. Tag every session with chorus-<chatId>-...
+ * 4. Per-session CODEX_HOME for codex (caller/shim handles env-var passing)
+ */
+class TmuxManagerImpl {
+    /** In-memory registry: "chatId:phaseId:role:agentName" → SessionHandle */
+    sessions = new Map();
+    constructor() {
+        // Reconcile existing chorus sessions on startup
+        this.reconcileExisting();
+    }
+    /**
+     * Scan `tmux ls` for existing chorus-* sessions and rebuild the registry.
+     * Recovers state after daemon restart.
+     */
+    reconcileExisting() {
+        try {
+            const result = (0, child_process_1.spawnSync)('tmux', ['list-sessions', '-F', '#{session_name}'], {
+                encoding: 'utf-8',
+            });
+            if (result.status === 0 && result.stdout) {
+                const lines = result.stdout.trim().split('\n').filter((line) => line.length > 0);
+                for (const sessionName of lines) {
+                    if (!sessionName.startsWith('chorus-'))
+                        continue;
+                    // Parse session name: chorus-<chatId>-<phaseId>-<role>-<agentName>
+                    const parts = sessionName.split('-');
+                    if (parts.length < 6)
+                        continue; // chorus + chatId + phaseId + role + agentName = 5 parts after split
+                    // Rebuild a minimal handle; agent lineage/name come from the parts
+                    const chatId = parts[1];
+                    const phaseId = parts[2];
+                    const role = parts[3] || 'doer';
+                    const agentName = parts.slice(4).join('-'); // Re-join in case agent name has hyphens
+                    const key = `${chatId}:${phaseId}:${role}:${agentName}`;
+                    // Avoid overwriting if we already have this session tracked
+                    if (this.sessions.has(key))
+                        continue;
+                    const handle = {
+                        name: sessionName,
+                        chatId,
+                        phaseId,
+                        role,
+                        lineage: 'anthropic', // Safe default; actual lineage is unknown from tmux metadata
+                        agentName,
+                        spawnedAt: Date.now(),
+                        lastActivityAt: Date.now(),
+                        state: 'active',
+                    };
+                    this.sessions.set(key, handle);
+                }
+            }
+        }
+        catch {
+            // Silent fail; tmux may not be available yet
+        }
+    }
+    /**
+     * Validate a string against the allowed charset for tmux session names.
+     * Tmux allows [a-zA-Z0-9_-].
+     */
+    validateNameComponent(value, field) {
+        if (!/^[a-zA-Z0-9_-]+$/.test(value)) {
+            throw new Error(`Invalid ${field}: ${value} contains forbidden characters`);
+        }
+        return value;
+    }
+    /**
+     * Build the session key used in our in-memory registry.
+     */
+    makeSessionKey(chatId, phaseId, role, agentName) {
+        return `${chatId}:${phaseId}:${role}:${agentName}`;
+    }
+    /**
+     * Build the tmux session name from components.
+     * Format: chorus-<chatId>-<phaseId>-<role>-<agentName>
+     */
+    makeSessionName(chatId, phaseId, role, agentName) {
+        return `chorus-${chatId}-${phaseId}-${role}-${agentName}`;
+    }
+    /**
+     * Acquire a session for a phase round, respecting share-session policy.
+     *
+     * Decision tree:
+     * 1. If shareSessionAcrossRounds && session exists for this chat+phase+role+agent → reuse
+     * 2. Else if shareSessionAcrossPhases && session exists for this chat+role+agent on ANY phase → reuse + rename
+     * 3. Else spawn fresh
+     */
+    async acquire(opts) {
+        const { chatId, phaseId, role, shareSessionAcrossRounds, shareSessionAcrossPhases, agentName, } = opts;
+        // Validate input charset
+        this.validateNameComponent(chatId, 'chatId');
+        this.validateNameComponent(phaseId, 'phaseId');
+        this.validateNameComponent(agentName, 'agentName');
+        const key = this.makeSessionKey(chatId, phaseId, role, agentName);
+        // Rule 1: Across rounds (round N → N+1) within THIS phase
+        if (shareSessionAcrossRounds) {
+            const existing = this.sessions.get(key);
+            if (existing) {
+                existing.lastActivityAt = Date.now();
+                return existing;
+            }
+        }
+        // Rule 2: Across phases (rare) — reuse from a previous phase
+        if (shareSessionAcrossPhases) {
+            for (const [registryKey, handle] of this.sessions) {
+                // Match on chat+role+agent, different phase
+                if (handle.chatId === chatId &&
+                    handle.role === role &&
+                    handle.agentName === agentName &&
+                    handle.phaseId !== phaseId) {
+                    // Found one on a previous phase — rename and reuse
+                    const newSessionName = this.makeSessionName(chatId, phaseId, role, agentName);
+                    try {
+                        (0, child_process_1.spawnSync)('tmux', ['rename-session', '-t', handle.name, newSessionName]);
+                    }
+                    catch {
+                        // If rename fails, fall through to spawn fresh
+                        this.sessions.delete(registryKey);
+                        break;
+                    }
+                    // Update the handle
+                    handle.phaseId = phaseId;
+                    handle.lastActivityAt = Date.now();
+                    this.sessions.delete(registryKey);
+                    this.sessions.set(key, handle);
+                    return handle;
+                }
+            }
+        }
+        // Rule 3: Spawn fresh
+        return this.spawnFresh(opts, key);
+    }
+    /**
+     * Spawn a fresh tmux session for the given phase round.
+     */
+    async spawnFresh(opts, key) {
+        const { chatId, phaseId, role, agentName, shim, spawnOpts } = opts;
+        const sessionName = this.makeSessionName(chatId, phaseId, role, agentName);
+        // Build launch command via the shim
+        const launchCommand = shim.buildLaunchCommand(spawnOpts);
+        // Spawn tmux session
+        try {
+            // Use child_process.spawnSync with args array for safety
+            const result = (0, child_process_1.spawnSync)('tmux', ['new-session', '-d', '-s', sessionName, launchCommand], {
+                encoding: 'utf-8',
+            });
+            if (result.status !== 0) {
+                throw new Error(`Tmux spawn failed: status=${result.status}, stderr=${result.stderr || 'unknown'}`);
+            }
+        }
+        catch (error) {
+            throw new Error(`TmuxSpawnError(code=tmux_unavailable): ${error instanceof Error ? error.message : String(error)}`);
+        }
+        // Cold-start poll: wait up to 8s for the session to be ready
+        const startTime = Date.now();
+        const timeout = 8000;
+        while (Date.now() - startTime < timeout) {
+            try {
+                const hasResult = (0, child_process_1.spawnSync)('tmux', ['has-session', '-t', sessionName], {
+                    encoding: 'utf-8',
+                });
+                if (hasResult.status === 0) {
+                    // Session is live
+                    const handle = {
+                        name: sessionName,
+                        chatId,
+                        phaseId,
+                        role,
+                        lineage: shim.lineage,
+                        agentName,
+                        spawnedAt: Date.now(),
+                        lastActivityAt: Date.now(),
+                        state: 'active',
+                    };
+                    this.sessions.set(key, handle);
+                    return handle;
+                }
+            }
+            catch {
+                // Still not ready
+            }
+            // Poll every 200ms
+            await new Promise((resolve) => setTimeout(resolve, 200));
+        }
+        // Cold-start timeout
+        throw new Error(`TmuxSpawnError(code=cold_start_timeout): Session ${sessionName} did not become ready within 8s`);
+    }
+    /**
+     * Send raw keys to a session (pre-nudge cleanup: Escape, Ctrl-C, /clear, etc.)
+     * Errors swallowed per spec.
+     */
+    sendKeys(sessionName, keys) {
+        try {
+            const args = ['send-keys', '-t', sessionName, ...keys];
+            (0, child_process_1.spawnSync)('tmux', args, { stdio: 'ignore' });
+        }
+        catch {
+            // Swallow errors — session may be dead or unresponsive
+        }
+    }
+    /**
+     * Send a prompt to a CLI's TUI input box.
+     *
+     * Originally implemented via `tmux load-buffer + paste-buffer`. That works
+     * for Claude/Codex/OpenCode/Kimi but Gemini's TUI silently drops paste-
+     * buffer events (likely due to its custom terminal-escape handling). The
+     * `send-keys -l` approach types each character literally and works
+     * universally across all the CLIs we ship — at the cost of slightly more
+     * shell argv pressure for very long prompts.
+     *
+     * Method name kept as `pasteBuffer` for caller compatibility, but the
+     * implementation no longer uses tmux's paste mechanism.
+     */
+    pasteBuffer(sessionName, content) {
+        try {
+            (0, child_process_1.spawnSync)('tmux', ['send-keys', '-l', '-t', sessionName, content], {
+                stdio: 'ignore',
+            });
+        }
+        catch {
+            // Silent fail — session may be dead or unresponsive
+        }
+    }
+    /**
+     * Capture the current pane content (last 200 lines).
+     * Used by the failure detector to match error patterns.
+     */
+    capturePane(sessionName) {
+        try {
+            const result = (0, child_process_1.spawnSync)('tmux', ['capture-pane', '-t', sessionName, '-p', '-S', '-200'], {
+                encoding: 'utf-8',
+            });
+            if (result.status === 0) {
+                return result.stdout || '';
+            }
+            return '';
+        }
+        catch {
+            return '';
+        }
+    }
+    /**
+     * List all chorus-* sessions currently tracked in memory.
+     */
+    list() {
+        return Array.from(this.sessions.values());
+    }
+    /**
+     * Force-kill a session by name. Idempotent.
+     */
+    kill(sessionName) {
+        try {
+            (0, child_process_1.spawnSync)('tmux', ['kill-session', '-t', sessionName], { stdio: 'ignore' });
+        }
+        catch {
+            // Session may not exist or be already dead
+        }
+        // Remove from registry
+        for (const [key, handle] of this.sessions) {
+            if (handle.name === sessionName) {
+                this.sessions.delete(key);
+                break;
+            }
+        }
+    }
+    /**
+     * Mark a session as terminal (eligible for reaping).
+     * Useful when a phase finishes but the tmux session hasn't been killed yet.
+     */
+    markTerminal(sessionName) {
+        for (const handle of this.sessions.values()) {
+            if (handle.name === sessionName) {
+                handle.state = 'terminal';
+                break;
+            }
+        }
+    }
+    /**
+     * Reaper sweep: identify and kill orphan / idle sessions.
+     *
+     * Kill criteria:
+     * 1. Session's chatId is NOT in activeChats
+     * 2. Chat status is terminal (merged, cancelled, errored, timed-out)
+     * 3. Session state is awaiting_user AND idle > idleDestroyMinutes
+     */
+    reapOnce(opts) {
+        const { activeChats, idleDestroyMinutes } = opts;
+        const killed = [];
+        const now = Date.now();
+        const idleThresholdMs = idleDestroyMinutes * 60 * 1000;
+        for (const handle of this.sessions.values()) {
+            let shouldKill = false;
+            let killReason = '';
+            // Criterion 1: Chat is not in activeChats map
+            if (!activeChats.has(handle.chatId)) {
+                shouldKill = true;
+                killReason = 'chat_not_active';
+            }
+            // Criterion 2: Chat status is terminal
+            const chatStatus = activeChats.get(handle.chatId);
+            if (chatStatus && ['merged', 'cancelled', 'errored', 'timed_out'].includes(chatStatus)) {
+                shouldKill = true;
+                killReason = `chat_${chatStatus}`;
+            }
+            // Criterion 3: Session state is terminal
+            if (handle.state === 'terminal') {
+                shouldKill = true;
+                killReason = 'session_terminal';
+            }
+            // Criterion 4: Session is awaiting_user and idle too long
+            if (handle.state === 'awaiting_user' && now - handle.lastActivityAt > idleThresholdMs) {
+                shouldKill = true;
+                killReason = `idle_${idleDestroyMinutes}m`;
+            }
+            if (shouldKill) {
+                this.kill(handle.name);
+                killed.push(`${handle.name}(${killReason})`);
+            }
+        }
+        return { killed };
+    }
+}
+exports.TmuxManagerImpl = TmuxManagerImpl;
+//# sourceMappingURL=tmux.js.map

package/dist/daemon/tmux.js.map

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

package/dist/lib/atomic-write.js

@@ -0,0 +1,55 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.atomicWriteJsonSync = atomicWriteJsonSync;
+/**
+ * Atomic JSON write — writes to a temp file in the same dir, then renames
+ * over the destination. fs.renameSync is atomic on POSIX (single inode swap),
+ * so a reader concurrently opening the destination either sees the previous
+ * complete file or the new complete file — never a half-written one.
+ *
+ * Why this matters: the cockpit polls _meta.json sidecars and chat-level
+ * meta.json to render run cards. A daemon crash mid-write (or even a slow
+ * write under load) could leave a 0-byte or truncated file that JSON.parse
+ * rejects, and the cockpit silently swallows the error and the card never
+ * renders. Atomic-rename eliminates that window.
+ *
+ * The temp file uses a `.tmp.<pid>.<rand>` suffix so concurrent writers in
+ * the same dir (multiple participants in a phase) don't collide on the
+ * temp path. Rename is the synchronisation point; the OS guarantees only
+ * one of N concurrent renames "wins" the destination at any instant.
+ *
+ * Caller note: we deliberately use sync APIs because the existing call
+ * sites are sync (writeTransportMeta in kimi.ts, runner setup). An async
+ * variant can be added later if a hot path needs it.
+ */
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+function atomicWriteJsonSync(targetPath, value) {
+    const dir = node_path_1.default.dirname(targetPath);
+    const base = node_path_1.default.basename(targetPath);
+    // pid + 8 hex chars from Date.now() is sufficient; same-process collision
+    // is impossible (sequential calls), cross-process needs the pid + nonce.
+    const nonce = Math.floor(Math.random() * 0xffffffff).toString(16).padStart(8, '0');
+    const tmpPath = node_path_1.default.join(dir, `.${base}.tmp.${process.pid}.${nonce}`);
+    // Stringify FIRST so a JSON serialization error doesn't leave an empty
+    // tmp file on disk (otherwise the catch-and-cleanup below has more to do).
+    const body = JSON.stringify(value, null, 2);
+    try {
+        node_fs_1.default.writeFileSync(tmpPath, body, 'utf-8');
+        node_fs_1.default.renameSync(tmpPath, targetPath);
+    }
+    catch (err) {
+        // Best-effort cleanup of the temp file if rename failed (e.g. EXDEV
+        // on a cross-device tmpdir, EACCES on perms). Re-throw so callers can
+        // decide whether to swallow (informational sidecars) or escalate.
+        try {
+            node_fs_1.default.unlinkSync(tmpPath);
+        }
+        catch { /* tmp may not exist */ }
+        throw err;
+    }
+}
+//# sourceMappingURL=atomic-write.js.map

package/dist/lib/atomic-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-write.js","sourceRoot":"","sources":["../../src/lib/atomic-write.ts"],"names":[],"mappings":";;;;;AAwBA,kDAsBC;AA9CD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,sDAAyB;AACzB,0DAA6B;AAE7B,SAAgB,mBAAmB,CAAC,UAAkB,EAAE,KAAc;IACpE,MAAM,GAAG,GAAG,mBAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,mBAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IACvC,0EAA0E;IAC1E,yEAAyE;IACzE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACnF,MAAM,OAAO,GAAG,mBAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,QAAQ,OAAO,CAAC,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC;IAEvE,uEAAuE;IACvE,2EAA2E;IAC3E,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAE5C,IAAI,CAAC;QACH,iBAAE,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QACzC,iBAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,oEAAoE;QACpE,sEAAsE;QACtE,kEAAkE;QAClE,IAAI,CAAC;YAAC,iBAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,uBAAuB,CAAC,CAAC;QACjE,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/lib/chat-events-bus.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * Process-local event bus for chat list mutations.
+ *
+ * The cockpit sidebar (and any other surface that renders a list of
+ * chats) needs to react when a chat is created/updated/deleted from
+ * ANY source — REST POST, MCP tool call, runner status change. The
+ * daemon polled every 12s before, which is fine for status drift but
+ * looks broken when a freshly-fired MCP chat takes 12s to appear.
+ *
+ * We chose a process-local EventEmitter over a DB-NOTIFY broadcast
+ * because chorus is single-daemon today; if we ever shard the daemon,
+ * this becomes a libsql LISTEN. Subscribers are SSE handlers in
+ * `routes/chats-events.ts`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.chatEventsBus = void 0;
+const node_events_1 = require("node:events");
+class ChatEventsBus extends node_events_1.EventEmitter {
+    emitChange(chatId, kind) {
+        const ev = { chatId, kind, ts: Date.now() };
+        this.emit('change', ev);
+    }
+}
+exports.chatEventsBus = new ChatEventsBus();
+exports.chatEventsBus.setMaxListeners(50);
+//# sourceMappingURL=chat-events-bus.js.map

package/dist/lib/chat-events-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-events-bus.js","sourceRoot":"","sources":["../../src/lib/chat-events-bus.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAEH,6CAA2C;AAU3C,MAAM,aAAc,SAAQ,0BAAY;IACtC,UAAU,CAAC,MAAc,EAAE,IAAoB;QAC7C,MAAM,EAAE,GAAoB,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QAC7D,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC1B,CAAC;CACF;AAEY,QAAA,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;AACjD,qBAAa,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC"}

package/dist/lib/chat-slug.js

@@ -0,0 +1,105 @@
+"use strict";
+/**
+ * Chat slug generation.
+ *
+ * The cockpit URL for a chat is `/runs/<slug>` instead of `/runs/<ULID>`.
+ * Bookmarks and shared links should be human-readable: `/runs/review-pr-9`
+ * beats `/runs/019DE881853DC50566D8DFCE083F75F0`.
+ *
+ * Strategy:
+ *   1. Slugify the `work` field (truncated, ASCII-folded, lowercase,
+ *      hyphen-separated).
+ *   2. Fall back to the template_id when work is empty/non-Latin/all
+ *      whitespace.
+ *   3. On collision, append `-2`, `-3`, ... until unique.
+ *
+ * Pure module: takes an `existsFn(slug)` callback so the DB layer (or a
+ * test) decides what "exists" means. No I/O here, fully unit-testable.
+ *
+ * Slug grammar (regex): `[a-z0-9]+(-[a-z0-9]+)*` — same shape GitHub
+ * uses for issue/repo URLs. Leading/trailing/duplicate hyphens are
+ * collapsed. Max length 60 characters; collision suffix always fits in
+ * the trailing 8 chars even after truncation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.slugifyText = slugifyText;
+exports.generateChatSlug = generateChatSlug;
+exports.looksLikeSlug = looksLikeSlug;
+const MAX_BASE_LEN = 60;
+/** Generic stand-in when slugify produces empty string (all-emoji input, etc.). */
+const FALLBACK_BASE = 'chat';
+/** Defensive ceiling on the dedup loop — way above realistic collision counts. */
+const MAX_DEDUP_ATTEMPTS = 10_000;
+/**
+ * Convert arbitrary text to a URL-safe slug component. Pure, deterministic.
+ * - Folds Unicode → ASCII via NFKD (so "café" → "cafe").
+ * - Replaces every non-[a-z0-9] run with a single hyphen.
+ * - Strips leading/trailing hyphens.
+ * - Truncates to MAX_BASE_LEN.
+ * - Returns "" when input has no extractable slug characters; callers
+ *   are expected to substitute a fallback.
+ */
+function slugifyText(input) {
+    if (!input)
+        return '';
+    // NFKD splits accented chars into base + combining mark, then strip
+    // the marks. Falls back to the original if the runtime doesn't
+    // implement Intl normalisation.
+    let s;
+    try {
+        s = input.normalize('NFKD').replace(/[̀-ͯ]/g, '');
+    }
+    catch {
+        s = input;
+    }
+    s = s.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
+    if (s.length === 0)
+        return '';
+    if (s.length > MAX_BASE_LEN) {
+        s = s.slice(0, MAX_BASE_LEN).replace(/-+$/g, '');
+        // Edge: truncating mid-token can leave us with a stray trailing
+        // hyphen even after the regex trim above (when the truncated tail
+        // ends with `-something`). The replace above handles it.
+    }
+    return s;
+}
+/**
+ * Build a slug for a chat with the given `work` text and `template_id`,
+ * unique among `existsFn(slug) === true` rows. Pure function — caller
+ * supplies the existence check.
+ *
+ * Collision suffix uses simple `-2`, `-3`, … rather than ULID prefixes
+ * because the URL stays short and predictable. Real-world collision rate
+ * is near zero (every chat starts with a different brief), so the loop
+ * almost always exits on the first iteration.
+ */
+async function generateChatSlug(args) {
+    let base = slugifyText(args.work);
+    if (!base)
+        base = slugifyText(args.templateId);
+    if (!base)
+        base = FALLBACK_BASE;
+    // Try the base first, then -2, -3, … until we find a free one.
+    for (let i = 0; i < MAX_DEDUP_ATTEMPTS; i++) {
+        const candidate = i === 0 ? base : `${base}-${i + 1}`;
+        if (!(await args.existsFn(candidate)))
+            return candidate;
+    }
+    // Vanishingly unlikely — every realistic workload exits in <5 iterations.
+    // Fall through to a timestamp-suffixed slug rather than throw.
+    return `${base}-${Date.now()}`;
+}
+/**
+ * Lightweight check: does this string look like a slug rather than a
+ * ULID? Used by routes that accept either.
+ *
+ * ULIDs are 26 uppercase Crockford-base32 chars; the codebase emits
+ * 32-char uppercase hex, but either way they're [0-9A-Z]+ with no
+ * hyphens. Slugs are lowercase + hyphens by construction. Test for the
+ * presence of a lowercase letter or hyphen — both are absent in ULIDs
+ * but always present in our slugs.
+ */
+function looksLikeSlug(s) {
+    return /[a-z]/.test(s) || s.includes('-');
+}
+//# sourceMappingURL=chat-slug.js.map

package/dist/lib/chat-slug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-slug.js","sourceRoot":"","sources":["../../src/lib/chat-slug.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;AAiBH,kCAoBC;AAYD,4CAkBC;AAYD,sCAEC;AA/ED,MAAM,YAAY,GAAG,EAAE,CAAC;AACxB,mFAAmF;AACnF,MAAM,aAAa,GAAG,MAAM,CAAC;AAC7B,kFAAkF;AAClF,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC;;;;;;;;GAQG;AACH,SAAgB,WAAW,CAAC,KAAa;IACvC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,oEAAoE;IACpE,+DAA+D;IAC/D,gCAAgC;IAChC,IAAI,CAAS,CAAC;IACd,IAAI,CAAC;QACH,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,CAAC,GAAG,KAAK,CAAC;IACZ,CAAC;IACD,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACxE,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC9B,IAAI,CAAC,CAAC,MAAM,GAAG,YAAY,EAAE,CAAC;QAC5B,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACjD,gEAAgE;QAChE,kEAAkE;QAClE,yDAAyD;IAC3D,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;;;;;;;GASG;AACI,KAAK,UAAU,gBAAgB,CAAC,IAKtC;IACC,IAAI,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC,IAAI;QAAE,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC/C,IAAI,CAAC,IAAI;QAAE,IAAI,GAAG,aAAa,CAAC;IAEhC,+DAA+D;IAC/D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,kBAAkB,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5C,MAAM,SAAS,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACtD,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YAAE,OAAO,SAAS,CAAC;IAC1D,CAAC;IACD,0EAA0E;IAC1E,+DAA+D;IAC/D,OAAO,GAAG,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;AACjC,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,aAAa,CAAC,CAAS;IACrC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AAC5C,CAAC"}