@nex-ai/nex 0.1.21 → 0.1.23

package/dist/calendar/scheduler.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Cron parser and scheduling engine.
+ * Supports: standard 5-field cron, "daily", "hourly", "Nh" shorthand.
+ * No external dependencies.
+ */
+import type { CalendarStore } from './store.js';
+import type { ScheduledTask } from './types.js';
+/**
+ * Parse human-friendly cron expressions to standard 5-field cron.
+ * Supports:
+ *   "daily"   -> "0 0 * * *"
+ *   "hourly"  -> "0 * * * *"
+ *   "6h"      -> "0 *​/6 * * *"  (every N hours)
+ *   "30m"     -> "*​/30 * * * *" (every N minutes)
+ *   Standard 5-field cron passed through as-is.
+ */
+export declare function parseCron(expression: string): string;
+/**
+ * Calculate the next run time for a cron expression after the given date.
+ * Brute-forces by advancing minute-by-minute (bounded to 400 days).
+ */
+export declare function nextRun(cronExpression: string, after?: Date): Date;
+export declare class Scheduler {
+    private store;
+    constructor(store: CalendarStore);
+    parseCron(expression: string): string;
+    nextRun(cronExpression: string, after?: Date): Date;
+    getMissed(): ScheduledTask[];
+    schedule(task: Omit<ScheduledTask, 'id' | 'nextRun' | 'missed'>): ScheduledTask;
+    getUpcoming(from: Date, to: Date): ScheduledTask[];
+    markCompleted(taskId: string): void;
+}

package/dist/calendar/scheduler.js

@@ -0,0 +1,178 @@
+/**
+ * Cron parser and scheduling engine.
+ * Supports: standard 5-field cron, "daily", "hourly", "Nh" shorthand.
+ * No external dependencies.
+ */
+import { randomUUID } from 'node:crypto';
+/**
+ * Parse human-friendly cron expressions to standard 5-field cron.
+ * Supports:
+ *   "daily"   -> "0 0 * * *"
+ *   "hourly"  -> "0 * * * *"
+ *   "6h"      -> "0 *​/6 * * *"  (every N hours)
+ *   "30m"     -> "*​/30 * * * *" (every N minutes)
+ *   Standard 5-field cron passed through as-is.
+ */
+export function parseCron(expression) {
+    const trimmed = expression.trim().toLowerCase();
+    if (trimmed === 'daily')
+        return '0 0 * * *';
+    if (trimmed === 'hourly')
+        return '0 * * * *';
+    if (trimmed === 'weekly')
+        return '0 0 * * 0';
+    // Nh pattern (e.g. "6h", "12h")
+    const hourMatch = trimmed.match(/^(\d+)h$/);
+    if (hourMatch) {
+        const n = parseInt(hourMatch[1], 10);
+        if (n > 0 && n <= 23)
+            return `0 */${n} * * *`;
+    }
+    // Nm pattern (e.g. "30m", "15m")
+    const minMatch = trimmed.match(/^(\d+)m$/);
+    if (minMatch) {
+        const n = parseInt(minMatch[1], 10);
+        if (n > 0 && n <= 59)
+            return `*/${n} * * * *`;
+    }
+    // Standard 5-field cron: validate it has 5 space-separated fields with valid chars
+    const fields = expression.trim().split(/\s+/);
+    const cronFieldRe = /^(\*|\d+)([/-]\d+)?([,](\*|\d+)([/-]\d+)?)*$/;
+    if (fields.length === 5 && fields.every(f => cronFieldRe.test(f))) {
+        return expression.trim();
+    }
+    throw new Error(`Invalid cron expression: ${expression}`);
+}
+/**
+ * Parse a single cron field and return the set of matching values.
+ * Supports: *, N, N-M, *​/N, N-M/S, comma-separated lists.
+ */
+function parseCronField(field, min, max) {
+    const values = new Set();
+    for (const part of field.split(',')) {
+        const trimmed = part.trim();
+        // */N
+        const stepWild = trimmed.match(/^\*\/(\d+)$/);
+        if (stepWild) {
+            const step = parseInt(stepWild[1], 10);
+            for (let i = min; i <= max; i += step)
+                values.add(i);
+            continue;
+        }
+        // N-M/S
+        const rangeStep = trimmed.match(/^(\d+)-(\d+)\/(\d+)$/);
+        if (rangeStep) {
+            const start = parseInt(rangeStep[1], 10);
+            const end = parseInt(rangeStep[2], 10);
+            const step = parseInt(rangeStep[3], 10);
+            for (let i = start; i <= end; i += step)
+                values.add(i);
+            continue;
+        }
+        // N-M
+        const range = trimmed.match(/^(\d+)-(\d+)$/);
+        if (range) {
+            const start = parseInt(range[1], 10);
+            const end = parseInt(range[2], 10);
+            for (let i = start; i <= end; i++)
+                values.add(i);
+            continue;
+        }
+        // *
+        if (trimmed === '*') {
+            for (let i = min; i <= max; i++)
+                values.add(i);
+            continue;
+        }
+        // Single number
+        const n = parseInt(trimmed, 10);
+        if (!isNaN(n) && n >= min && n <= max) {
+            values.add(n);
+        }
+    }
+    return Array.from(values).sort((a, b) => a - b);
+}
+/**
+ * Calculate the next run time for a cron expression after the given date.
+ * Brute-forces by advancing minute-by-minute (bounded to 400 days).
+ */
+export function nextRun(cronExpression, after) {
+    const cron = parseCron(cronExpression);
+    const fields = cron.split(/\s+/);
+    if (fields.length !== 5)
+        throw new Error(`Invalid cron: ${cronExpression}`);
+    const minutes = parseCronField(fields[0], 0, 59);
+    const hours = parseCronField(fields[1], 0, 23);
+    const daysOfMonth = parseCronField(fields[2], 1, 31);
+    const months = parseCronField(fields[3], 1, 12);
+    const daysOfWeek = parseCronField(fields[4], 0, 6);
+    const start = after ? new Date(after.getTime()) : new Date();
+    // Advance to next minute (UTC)
+    start.setUTCSeconds(0, 0);
+    start.setUTCMinutes(start.getUTCMinutes() + 1);
+    const maxIterations = 400 * 24 * 60; // ~400 days in minutes
+    const candidate = new Date(start.getTime());
+    for (let i = 0; i < maxIterations; i++) {
+        const m = candidate.getUTCMinutes();
+        const h = candidate.getUTCHours();
+        const dom = candidate.getUTCDate();
+        const mon = candidate.getUTCMonth() + 1; // 0-indexed -> 1-indexed
+        const dow = candidate.getUTCDay();
+        if (minutes.includes(m) &&
+            hours.includes(h) &&
+            daysOfMonth.includes(dom) &&
+            months.includes(mon) &&
+            daysOfWeek.includes(dow)) {
+            return candidate;
+        }
+        candidate.setUTCMinutes(candidate.getUTCMinutes() + 1);
+    }
+    // Fallback: return 24h from now if no match found
+    return new Date(Date.now() + 24 * 60 * 60 * 1000);
+}
+export class Scheduler {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    parseCron(expression) {
+        return parseCron(expression);
+    }
+    nextRun(cronExpression, after) {
+        return nextRun(cronExpression, after);
+    }
+    getMissed() {
+        const now = Date.now();
+        const tasks = this.store.load();
+        return tasks.filter(t => t.enabled && t.nextRun < now && !t.missed);
+    }
+    schedule(task) {
+        const nextRunTime = nextRun(task.cronExpression);
+        const full = {
+            ...task,
+            id: randomUUID(),
+            nextRun: nextRunTime.getTime(),
+            missed: false,
+        };
+        this.store.add(full);
+        return full;
+    }
+    getUpcoming(from, to) {
+        const fromMs = from.getTime();
+        const toMs = to.getTime();
+        return this.store.load().filter(t => t.enabled && t.nextRun >= fromMs && t.nextRun <= toMs);
+    }
+    markCompleted(taskId) {
+        const tasks = this.store.load();
+        const task = tasks.find(t => t.id === taskId);
+        if (!task)
+            return;
+        const nextRunTime = nextRun(task.cronExpression);
+        this.store.update(taskId, {
+            lastRun: Date.now(),
+            nextRun: nextRunTime.getTime(),
+            missed: false,
+        });
+    }
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/calendar/scheduler.js.map

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

package/dist/calendar/store.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Calendar persistence layer.
+ * Stores scheduled tasks in a JSON file at ~/.nex-cli/calendar.json
+ */
+import type { ScheduledTask } from './types.js';
+export declare class CalendarStore {
+    private filePath;
+    constructor(filePath?: string);
+    load(): ScheduledTask[];
+    save(tasks: ScheduledTask[]): void;
+    add(task: ScheduledTask): void;
+    remove(taskId: string): void;
+    update(taskId: string, updates: Partial<ScheduledTask>): void;
+    getByAgent(agentSlug: string): ScheduledTask[];
+}

package/dist/calendar/store.js

@@ -0,0 +1,50 @@
+/**
+ * Calendar persistence layer.
+ * Stores scheduled tasks in a JSON file at ~/.nex-cli/calendar.json
+ */
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { homedir } from 'node:os';
+export class CalendarStore {
+    filePath;
+    constructor(filePath) {
+        this.filePath = filePath ?? join(homedir(), '.nex-cli', 'calendar.json');
+    }
+    load() {
+        try {
+            if (!existsSync(this.filePath))
+                return [];
+            const raw = readFileSync(this.filePath, 'utf-8');
+            const data = JSON.parse(raw);
+            return Array.isArray(data) ? data : [];
+        }
+        catch {
+            return [];
+        }
+    }
+    save(tasks) {
+        mkdirSync(dirname(this.filePath), { recursive: true });
+        writeFileSync(this.filePath, JSON.stringify(tasks, null, 2) + '\n', 'utf-8');
+    }
+    add(task) {
+        const tasks = this.load();
+        tasks.push(task);
+        this.save(tasks);
+    }
+    remove(taskId) {
+        const tasks = this.load().filter(t => t.id !== taskId);
+        this.save(tasks);
+    }
+    update(taskId, updates) {
+        const tasks = this.load();
+        const idx = tasks.findIndex(t => t.id === taskId);
+        if (idx >= 0) {
+            tasks[idx] = { ...tasks[idx], ...updates };
+            this.save(tasks);
+        }
+    }
+    getByAgent(agentSlug) {
+        return this.load().filter(t => t.agentSlug === agentSlug);
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/calendar/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/calendar/store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAGlC,MAAM,OAAO,aAAa;IAChB,QAAQ,CAAS;IAEzB,YAAY,QAAiB;QAC3B,IAAI,CAAC,QAAQ,GAAG,QAAQ,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC;IAC3E,CAAC;IAED,IAAI;QACF,IAAI,CAAC;YACH,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC;gBAAE,OAAO,EAAE,CAAC;YAC1C,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACjD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC7B,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAuB,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,IAAI,CAAC,KAAsB;QACzB,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IAC/E,CAAC;IAED,GAAG,CAAC,IAAmB;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,MAAc;QACnB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;QACvD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,MAAc,EAAE,OAA+B;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;QAClD,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;YACb,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC;YAC3C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IAED,UAAU,CAAC,SAAiB;QAC1B,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC;IAC5D,CAAC;CACF"}

package/dist/calendar/types.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Type definitions for the agent calendar/scheduling system.
+ */
+export interface ScheduledTask {
+    id: string;
+    agentSlug: string;
+    type: 'heartbeat' | 'task' | 'review';
+    cronExpression: string;
+    nextRun: number;
+    lastRun?: number;
+    missed: boolean;
+    enabled: boolean;
+}
+export interface CalendarEntry {
+    date: string;
+    tasks: ScheduledTask[];
+}

package/dist/calendar/types.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for the agent calendar/scheduling system.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/calendar/types.js.map

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

package/dist/chat/channel.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Channel management for the Slack-style chat system.
+ * Channels are persisted to ~/.nex-cli/chat/channels.json
+ */
+import type { Channel } from './types.js';
+export declare class ChannelManager {
+    private baseDir;
+    private filePath;
+    private channels;
+    constructor(baseDir?: string);
+    private load;
+    private save;
+    create(channel: Omit<Channel, 'id' | 'createdAt'>): Channel;
+    get(channelId: string): Channel | undefined;
+    list(): Channel[];
+    join(channelId: string, member: string): void;
+    leave(channelId: string, member: string): void;
+    getMembers(channelId: string): string[];
+    ensureDefaults(): void;
+}

package/dist/chat/channel.js

@@ -0,0 +1,84 @@
+/**
+ * Channel management for the Slack-style chat system.
+ * Channels are persisted to ~/.nex-cli/chat/channels.json
+ */
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { randomUUID } from 'node:crypto';
+export class ChannelManager {
+    baseDir;
+    filePath;
+    channels;
+    constructor(baseDir) {
+        this.baseDir = baseDir ?? join(homedir(), '.nex-cli', 'chat');
+        this.filePath = join(this.baseDir, 'channels.json');
+        this.channels = this.load();
+    }
+    load() {
+        try {
+            if (!existsSync(this.filePath))
+                return [];
+            const raw = readFileSync(this.filePath, 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return [];
+        }
+    }
+    save() {
+        mkdirSync(this.baseDir, { recursive: true });
+        writeFileSync(this.filePath, JSON.stringify(this.channels, null, 2) + '\n', 'utf-8');
+    }
+    create(channel) {
+        const full = {
+            ...channel,
+            id: randomUUID(),
+            createdAt: Date.now(),
+        };
+        this.channels.push(full);
+        this.save();
+        return full;
+    }
+    get(channelId) {
+        return this.channels.find(c => c.id === channelId);
+    }
+    list() {
+        return [...this.channels];
+    }
+    join(channelId, member) {
+        const channel = this.channels.find(c => c.id === channelId);
+        if (!channel)
+            return;
+        if (!channel.members.includes(member)) {
+            channel.members.push(member);
+            this.save();
+        }
+    }
+    leave(channelId, member) {
+        const channel = this.channels.find(c => c.id === channelId);
+        if (!channel)
+            return;
+        const idx = channel.members.indexOf(member);
+        if (idx >= 0) {
+            channel.members.splice(idx, 1);
+            this.save();
+        }
+    }
+    getMembers(channelId) {
+        const channel = this.channels.find(c => c.id === channelId);
+        return channel ? [...channel.members] : [];
+    }
+    ensureDefaults() {
+        const hasGeneral = this.channels.some(c => c.name === '#general');
+        if (!hasGeneral) {
+            this.create({
+                name: '#general',
+                type: 'public',
+                members: ['human'],
+                topic: 'General discussion',
+            });
+        }
+    }
+}
+//# sourceMappingURL=channel.js.map

package/dist/chat/channel.js.map

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

package/dist/chat/message-store.d.ts

@@ -0,0 +1,18 @@
+/**
+ * JSONL-based message persistence for chat channels.
+ * Messages are stored per channel at ~/.nex-cli/chat/messages/<channelId>.jsonl
+ */
+import type { ChatMessage } from './types.js';
+export declare class MessageStore {
+    private baseDir;
+    constructor(baseDir?: string);
+    private channelPath;
+    send(message: Omit<ChatMessage, 'id' | 'timestamp'>): ChatMessage;
+    getMessages(channelId: string, options?: {
+        limit?: number;
+        before?: number;
+    }): ChatMessage[];
+    getThread(messageId: string): ChatMessage[];
+    getUnread(member: string, since: number): ChatMessage[];
+    private getAllMessages;
+}

package/dist/chat/message-store.js

@@ -0,0 +1,82 @@
+/**
+ * JSONL-based message persistence for chat channels.
+ * Messages are stored per channel at ~/.nex-cli/chat/messages/<channelId>.jsonl
+ */
+import { readFileSync, readdirSync, appendFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { randomUUID } from 'node:crypto';
+export class MessageStore {
+    baseDir;
+    constructor(baseDir) {
+        this.baseDir = baseDir ?? join(homedir(), '.nex-cli', 'chat', 'messages');
+    }
+    channelPath(channelId) {
+        return join(this.baseDir, `${channelId}.jsonl`);
+    }
+    send(message) {
+        const full = {
+            ...message,
+            id: randomUUID(),
+            timestamp: Date.now(),
+        };
+        mkdirSync(this.baseDir, { recursive: true });
+        const filePath = this.channelPath(full.channelId);
+        if (!existsSync(filePath)) {
+            writeFileSync(filePath, '', 'utf-8');
+        }
+        appendFileSync(filePath, JSON.stringify(full) + '\n', 'utf-8');
+        return full;
+    }
+    getMessages(channelId, options) {
+        const filePath = this.channelPath(channelId);
+        if (!existsSync(filePath))
+            return [];
+        const raw = readFileSync(filePath, 'utf-8').trim();
+        if (!raw)
+            return [];
+        let messages = raw
+            .split('\n')
+            .filter(line => line.trim())
+            .map(line => JSON.parse(line));
+        if (options?.before) {
+            messages = messages.filter(m => m.timestamp < options.before);
+        }
+        if (options?.limit && options.limit > 0) {
+            messages = messages.slice(-options.limit);
+        }
+        return messages;
+    }
+    getThread(messageId) {
+        // Search across all channels for the thread
+        // A thread is: the root message + all messages with replyTo === messageId
+        const allMessages = this.getAllMessages();
+        const root = allMessages.find(m => m.id === messageId);
+        if (!root)
+            return [];
+        const replies = allMessages.filter(m => m.replyTo === messageId);
+        return [root, ...replies].sort((a, b) => a.timestamp - b.timestamp);
+    }
+    getUnread(member, since) {
+        const allMessages = this.getAllMessages();
+        return allMessages.filter(m => m.timestamp > since && m.sender !== member && m.mentions.includes(member));
+    }
+    getAllMessages() {
+        if (!existsSync(this.baseDir))
+            return [];
+        const files = readdirSync(this.baseDir).filter((f) => f.endsWith('.jsonl'));
+        const messages = [];
+        for (const file of files) {
+            const filePath = join(this.baseDir, file);
+            const raw = readFileSync(filePath, 'utf-8').trim();
+            if (!raw)
+                continue;
+            const lines = raw.split('\n').filter((l) => l.trim());
+            for (const line of lines) {
+                messages.push(JSON.parse(line));
+            }
+        }
+        return messages;
+    }
+}
+//# sourceMappingURL=message-store.js.map

package/dist/chat/message-store.js.map

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

package/dist/chat/router.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Message routing for the chat system.
+ * Parses @mentions, delivers to correct channels, and tracks pending mentions.
+ */
+import type { ChannelManager } from './channel.js';
+import type { MessageStore } from './message-store.js';
+import type { ChatMessage } from './types.js';
+export declare class ChatRouter {
+    private channels;
+    private messages;
+    private lastRead;
+    constructor(channels: ChannelManager, messages: MessageStore);
+    route(channelId: string, sender: string, content: string): ChatMessage;
+    parseMentions(content: string): string[];
+    hasPendingMentions(): ChatMessage[];
+    checkAutoDecide(agentSlug: string, timeout: number): boolean;
+}

package/dist/chat/router.js

@@ -0,0 +1,65 @@
+/**
+ * Message routing for the chat system.
+ * Parses @mentions, delivers to correct channels, and tracks pending mentions.
+ */
+const MENTION_RE = /@([a-zA-Z0-9_-]+)/g;
+export class ChatRouter {
+    channels;
+    messages;
+    lastRead = new Map();
+    constructor(channels, messages) {
+        this.channels = channels;
+        this.messages = messages;
+    }
+    route(channelId, sender, content) {
+        const mentions = this.parseMentions(content);
+        const channel = this.channels.get(channelId);
+        const senderType = sender === 'human' ? 'human' : 'agent';
+        const message = this.messages.send({
+            channelId,
+            sender,
+            senderType,
+            content,
+            mentions,
+        });
+        // Auto-join sender to channel if not already a member
+        if (channel && !channel.members.includes(sender)) {
+            this.channels.join(channelId, sender);
+        }
+        // Auto-join mentioned agents to channel
+        for (const mention of mentions) {
+            if (channel && !channel.members.includes(mention)) {
+                this.channels.join(channelId, mention);
+            }
+        }
+        // Update last read for sender
+        this.lastRead.set(sender, Date.now());
+        return message;
+    }
+    parseMentions(content) {
+        const mentions = [];
+        let match;
+        const re = new RegExp(MENTION_RE.source, MENTION_RE.flags);
+        while ((match = re.exec(content)) !== null) {
+            const mention = match[1];
+            if (!mentions.includes(mention)) {
+                mentions.push(mention);
+            }
+        }
+        return mentions;
+    }
+    hasPendingMentions() {
+        const humanLastRead = this.lastRead.get('human') ?? 0;
+        return this.messages.getUnread('human', humanLastRead);
+    }
+    checkAutoDecide(agentSlug, timeout) {
+        const pending = this.hasPendingMentions();
+        const agentPending = pending.filter(m => m.mentions.includes(agentSlug));
+        if (agentPending.length === 0)
+            return false;
+        // Check if the oldest pending mention has exceeded the timeout
+        const oldest = agentPending.reduce((min, m) => (m.timestamp < min ? m.timestamp : min), Infinity);
+        return Date.now() - oldest > timeout;
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/chat/router.js.map

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

package/dist/chat/suggested-responses.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Suggested response generation for human @mentions.
+ * Simple heuristic-based suggestions: accept, customize, defer.
+ */
+import type { ChatMessage, SuggestedResponse } from './types.js';
+export declare function generateSuggestions(message: ChatMessage, context?: string): SuggestedResponse[];