@nex-ai/nex 0.1.21 → 0.1.23

package/dist/tui/router.js

@@ -0,0 +1,87 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * View stack router for the TUI.
+ * Renders the top-of-stack view and provides push/pop via context.
+ */
+import React, { createContext, useContext, useCallback } from "react";
+import { Box, Text } from "ink";
+import { useTheme } from "./theme.js";
+const RouterContext = createContext({
+    push: () => { },
+    pop: () => { },
+    currentView: undefined,
+    viewStack: [],
+});
+export function useRouter() {
+    return useContext(RouterContext);
+}
+const viewRegistry = new Map();
+/**
+ * Register a view component for a given name.
+ * Call this from the component layer (Agent 2) to wire up real views.
+ */
+export function registerView(name, component) {
+    viewRegistry.set(name, component);
+}
+// ── Placeholder component ──────────────────────────────────────────
+function PlaceholderView({ name }) {
+    const t = useTheme();
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsx(Text, { color: t.colors.primary, bold: true, children: name }), _jsx(Text, { color: t.colors.muted, children: "View not yet implemented. Press Escape to go back." })] }));
+}
+// ── Supported view names ───────────────────────────────────────────
+const SUPPORTED_VIEWS = new Set([
+    "home",
+    "help",
+    "record-list",
+    "record-detail",
+    "ask-chat",
+    "agent-list",
+    "chat",
+    "calendar",
+    "orchestration",
+    "generative",
+    "task-board",
+    "timeline",
+    "insights",
+]);
+// ── Breadcrumb ─────────────────────────────────────────────────────
+function Breadcrumb({ stack }) {
+    const t = useTheme();
+    if (stack.length <= 1)
+        return null;
+    return (_jsx(Box, { marginBottom: 1, children: stack.map((entry, i) => {
+            const isLast = i === stack.length - 1;
+            return (_jsxs(React.Fragment, { children: [_jsx(Text, { color: isLast ? t.breadcrumb.activeColor : t.breadcrumb.color, bold: isLast, children: entry.name }), !isLast && (_jsx(Text, { color: t.breadcrumb.color, children: t.breadcrumb.separator }))] }, `${entry.name}-${i}`));
+        }) }));
+}
+export function Router({ viewStack, dispatch, children }) {
+    const push = useCallback((view) => dispatch({ type: "PUSH_VIEW", view }), [dispatch]);
+    const pop = useCallback(() => dispatch({ type: "POP_VIEW" }), [dispatch]);
+    const currentView = viewStack[viewStack.length - 1];
+    const contextValue = {
+        push,
+        pop,
+        currentView,
+        viewStack,
+    };
+    // Resolve the component for the current view
+    let ViewContent;
+    if (currentView) {
+        const registered = viewRegistry.get(currentView.name);
+        if (registered) {
+            const Component = registered;
+            ViewContent = _jsx(Component, { props: currentView.props });
+        }
+        else if (SUPPORTED_VIEWS.has(currentView.name)) {
+            ViewContent = _jsx(PlaceholderView, { name: currentView.name });
+        }
+        else {
+            ViewContent = _jsx(PlaceholderView, { name: `unknown: ${currentView.name}` });
+        }
+    }
+    else {
+        ViewContent = _jsx(PlaceholderView, { name: "home" });
+    }
+    return (_jsx(RouterContext.Provider, { value: contextValue, children: _jsxs(Box, { flexDirection: "column", children: [_jsx(Breadcrumb, { stack: viewStack }), ViewContent, children] }) }));
+}
+//# sourceMappingURL=router.js.map

package/dist/tui/router.js.map

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

package/dist/tui/services/agent-service.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Singleton service that manages agent instances and exposes state for the TUI.
+ * Bridges the agent runtime (loop, tools, queues, sessions) to the view layer.
+ */
+import { AgentLoop } from "../../agent/loop.js";
+import { ToolRegistry } from "../../agent/tools.js";
+import { AgentSessionStore } from "../../agent/session-store.js";
+import { MessageQueues } from "../../agent/queues.js";
+import type { AgentConfig, AgentState } from "../../agent/types.js";
+export interface ManagedAgent {
+    config: AgentConfig;
+    state: AgentState;
+    loop: AgentLoop;
+}
+export declare class AgentService {
+    private agents;
+    private toolRegistry;
+    private sessionStore;
+    private queues;
+    private listeners;
+    constructor(toolRegistry?: ToolRegistry, sessionStore?: AgentSessionStore, queues?: MessageQueues);
+    /** Create an agent from a full config. */
+    create(config: AgentConfig): ManagedAgent;
+    /** Create an agent from a pre-built template. */
+    createFromTemplate(slug: string, templateName: string): ManagedAgent;
+    /** Start the agent loop (sets phase to idle if done/error). */
+    start(slug: string): Promise<void>;
+    /** Stop the agent loop. */
+    stop(slug: string): void;
+    /** Send a high-priority steer message to interrupt the agent. */
+    steer(slug: string, message: string): void;
+    /** Queue a follow-up message for the agent's next turn. */
+    followUp(slug: string, message: string): void;
+    /** Get a managed agent by slug. */
+    get(slug: string): ManagedAgent | undefined;
+    /** List all managed agents. */
+    list(): ManagedAgent[];
+    /** Get the current state snapshot for an agent. */
+    getState(slug: string): AgentState | undefined;
+    /**
+     * Subscribe to state changes. Returns an unsubscribe function.
+     * The listener fires whenever any agent's state changes (create, start, stop, phase change).
+     */
+    subscribe(listener: () => void): () => void;
+    /** Get available template names. */
+    getTemplateNames(): string[];
+    /** Get a template config (without slug). */
+    getTemplate(name: string): Omit<AgentConfig, "slug"> | undefined;
+    private notify;
+    /** Remove an agent. Stops its loop first. */
+    remove(slug: string): void;
+    /** Update mutable fields of an agent's config. */
+    updateConfig(slug: string, updates: Partial<Pick<AgentConfig, "name" | "expertise" | "heartbeatCron">>): void;
+    private requireAgent;
+}
+export declare function getAgentService(): AgentService;
+/** Reset the singleton (for testing). */
+export declare function resetAgentService(): void;

package/dist/tui/services/agent-service.js

@@ -0,0 +1,197 @@
+/**
+ * Singleton service that manages agent instances and exposes state for the TUI.
+ * Bridges the agent runtime (loop, tools, queues, sessions) to the view layer.
+ */
+import { AgentLoop } from "../../agent/loop.js";
+import { ToolRegistry, createBuiltinTools } from "../../agent/tools.js";
+import { AgentSessionStore } from "../../agent/session-store.js";
+import { MessageQueues } from "../../agent/queues.js";
+import { NexClient } from "../../lib/client.js";
+import { resolveApiKey } from "../../lib/config.js";
+import { templates } from "../../agent/templates.js";
+import { getChatService } from "./chat-service.js";
+export class AgentService {
+    agents = new Map();
+    toolRegistry;
+    sessionStore;
+    queues;
+    listeners = [];
+    constructor(toolRegistry, sessionStore, queues) {
+        if (toolRegistry) {
+            this.toolRegistry = toolRegistry;
+        }
+        else {
+            const client = new NexClient(resolveApiKey());
+            this.toolRegistry = new ToolRegistry();
+            for (const tool of createBuiltinTools(client)) {
+                this.toolRegistry.register(tool);
+            }
+        }
+        this.sessionStore = sessionStore ?? new AgentSessionStore();
+        this.queues = queues ?? new MessageQueues();
+    }
+    /** Create an agent from a full config. */
+    create(config) {
+        if (this.agents.has(config.slug)) {
+            throw new Error(`Agent "${config.slug}" already exists.`);
+        }
+        const loop = new AgentLoop(config, this.toolRegistry, this.sessionStore, this.queues);
+        // Wire phase_change events to notify TUI listeners
+        loop.on("phase_change", () => {
+            const managed = this.agents.get(config.slug);
+            if (managed) {
+                managed.state = loop.getState();
+                this.notify();
+            }
+        });
+        // Wire agent message output back to the DM channel in chat service
+        loop.on("message", (content) => {
+            if (typeof content !== "string" || !content.trim())
+                return;
+            try {
+                const chatService = getChatService();
+                // Ensure DM channel exists (creates if needed) then send reply
+                const dmChannel = chatService.ensureChannel(`dm-${config.slug}`);
+                chatService.send(dmChannel.id, content, config.name);
+            }
+            catch {
+                // Chat service not available — ignore
+            }
+        });
+        // Ensure DM channel exists in chat service immediately so it shows in sidebar
+        try {
+            getChatService().ensureChannel(`dm-${config.slug}`);
+        }
+        catch {
+            // Chat service may not be ready yet — the message event handler will create it on first reply
+        }
+        const managed = {
+            config,
+            state: loop.getState(),
+            loop,
+        };
+        this.agents.set(config.slug, managed);
+        this.notify();
+        return managed;
+    }
+    /** Create an agent from a pre-built template. */
+    createFromTemplate(slug, templateName) {
+        const tmpl = templates[templateName];
+        if (!tmpl) {
+            throw new Error(`Unknown template: "${templateName}". Available: ${Object.keys(templates).join(", ")}`);
+        }
+        const config = { slug, ...tmpl };
+        return this.create(config);
+    }
+    /** Start the agent loop (sets phase to idle if done/error). */
+    async start(slug) {
+        const managed = this.requireAgent(slug);
+        managed.loop.start();
+        managed.state = managed.loop.getState();
+        this.notify();
+        // Run one tick to kick off the cycle
+        await managed.loop.tick();
+        managed.state = managed.loop.getState();
+        this.notify();
+    }
+    /** Stop the agent loop. */
+    stop(slug) {
+        const managed = this.requireAgent(slug);
+        managed.loop.stop();
+        managed.state = managed.loop.getState();
+        this.notify();
+    }
+    /** Send a high-priority steer message to interrupt the agent. */
+    steer(slug, message) {
+        this.requireAgent(slug);
+        this.queues.steer(slug, message);
+    }
+    /** Queue a follow-up message for the agent's next turn. */
+    followUp(slug, message) {
+        this.requireAgent(slug);
+        this.queues.followUp(slug, message);
+    }
+    /** Get a managed agent by slug. */
+    get(slug) {
+        return this.agents.get(slug);
+    }
+    /** List all managed agents. */
+    list() {
+        return Array.from(this.agents.values());
+    }
+    /** Get the current state snapshot for an agent. */
+    getState(slug) {
+        return this.agents.get(slug)?.state;
+    }
+    /**
+     * Subscribe to state changes. Returns an unsubscribe function.
+     * The listener fires whenever any agent's state changes (create, start, stop, phase change).
+     */
+    subscribe(listener) {
+        this.listeners.push(listener);
+        return () => {
+            const idx = this.listeners.indexOf(listener);
+            if (idx >= 0)
+                this.listeners.splice(idx, 1);
+        };
+    }
+    /** Get available template names. */
+    getTemplateNames() {
+        return Object.keys(templates);
+    }
+    /** Get a template config (without slug). */
+    getTemplate(name) {
+        return templates[name];
+    }
+    notify() {
+        for (const listener of this.listeners) {
+            try {
+                listener();
+            }
+            catch {
+                // swallow listener errors
+            }
+        }
+    }
+    /** Remove an agent. Stops its loop first. */
+    remove(slug) {
+        const managed = this.requireAgent(slug);
+        try {
+            managed.loop.stop();
+        }
+        catch { /* already stopped */ }
+        this.agents.delete(slug);
+        this.notify();
+    }
+    /** Update mutable fields of an agent's config. */
+    updateConfig(slug, updates) {
+        const managed = this.requireAgent(slug);
+        if (updates.name !== undefined)
+            managed.config.name = updates.name;
+        if (updates.expertise !== undefined)
+            managed.config.expertise = updates.expertise;
+        if (updates.heartbeatCron !== undefined)
+            managed.config.heartbeatCron = updates.heartbeatCron;
+        this.notify();
+    }
+    requireAgent(slug) {
+        const managed = this.agents.get(slug);
+        if (!managed) {
+            throw new Error(`Agent "${slug}" not found.`);
+        }
+        return managed;
+    }
+}
+// ── Singleton ──
+let instance;
+export function getAgentService() {
+    if (!instance) {
+        instance = new AgentService();
+    }
+    return instance;
+}
+/** Reset the singleton (for testing). */
+export function resetAgentService() {
+    instance = undefined;
+}
+//# sourceMappingURL=agent-service.js.map

package/dist/tui/services/agent-service.js.map

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

package/dist/tui/services/calendar-service.d.ts

@@ -0,0 +1,31 @@
+/**
+ * TUI service layer for the calendar/scheduling system.
+ * Wraps Scheduler and CalendarStore into a single facade
+ * that the calendar view can consume without touching backend internals.
+ */
+import type { ScheduledTask } from '../../calendar/types.js';
+export declare class CalendarService {
+    private scheduler;
+    private store;
+    private listeners;
+    constructor(calendarFilePath?: string);
+    /**
+     * Returns events formatted for the calendar grid view.
+     * Maps scheduled tasks to day/hour slots for the given week.
+     */
+    getWeekEvents(weekOffset?: number): Array<{
+        id: string;
+        agentName: string;
+        day: number;
+        hour: number;
+        label: string;
+    }>;
+    scheduleHeartbeat(agentSlug: string, agentName: string, cronExpression: string): void;
+    removeSchedule(agentSlug: string): void;
+    getUpcoming(hours?: number): ScheduledTask[];
+    getMissed(): ScheduledTask[];
+    subscribe(listener: () => void): () => void;
+    private notify;
+    private getWeekRange;
+}
+export declare function getCalendarService(): CalendarService;

package/dist/tui/services/calendar-service.js

@@ -0,0 +1,133 @@
+/**
+ * TUI service layer for the calendar/scheduling system.
+ * Wraps Scheduler and CalendarStore into a single facade
+ * that the calendar view can consume without touching backend internals.
+ */
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { Scheduler } from '../../calendar/scheduler.js';
+import { CalendarStore } from '../../calendar/store.js';
+export class CalendarService {
+    scheduler;
+    store;
+    listeners = [];
+    constructor(calendarFilePath) {
+        const filePath = calendarFilePath ?? join(homedir(), '.nex-cli', 'calendar.json');
+        this.store = new CalendarStore(filePath);
+        this.scheduler = new Scheduler(this.store);
+    }
+    // ── View data ──
+    /**
+     * Returns events formatted for the calendar grid view.
+     * Maps scheduled tasks to day/hour slots for the given week.
+     */
+    getWeekEvents(weekOffset = 0) {
+        const { start, end } = this.getWeekRange(weekOffset);
+        const tasks = this.scheduler.getUpcoming(start, end);
+        const allTasks = this.store.load().filter(t => t.enabled);
+        // For recurring tasks, generate occurrences within the week window
+        const events = [];
+        // Include tasks whose nextRun falls within the week
+        for (const task of tasks) {
+            const runDate = new Date(task.nextRun);
+            events.push({
+                id: task.id,
+                agentName: task.agentSlug,
+                day: runDate.getDay(),
+                hour: runDate.getHours(),
+                label: `${task.agentSlug} ${task.type}`,
+            });
+        }
+        // Also scan all enabled tasks and project their cron into the week
+        for (const task of allTasks) {
+            // Skip tasks already captured via getUpcoming
+            if (tasks.some(t => t.id === task.id))
+                continue;
+            try {
+                let cursor = new Date(start.getTime());
+                // Walk through the week generating occurrences
+                while (cursor.getTime() <= end.getTime()) {
+                    const next = this.scheduler.nextRun(task.cronExpression, cursor);
+                    if (next.getTime() > end.getTime())
+                        break;
+                    if (next.getTime() >= start.getTime()) {
+                        events.push({
+                            id: task.id,
+                            agentName: task.agentSlug,
+                            day: next.getDay(),
+                            hour: next.getHours(),
+                            label: `${task.agentSlug} ${task.type}`,
+                        });
+                    }
+                    // Advance cursor past this occurrence
+                    cursor = new Date(next.getTime());
+                }
+            }
+            catch {
+                // Skip tasks with unparseable cron
+            }
+        }
+        return events;
+    }
+    // ── Scheduling ──
+    scheduleHeartbeat(agentSlug, agentName, cronExpression) {
+        this.scheduler.schedule({
+            agentSlug,
+            type: 'heartbeat',
+            cronExpression,
+            enabled: true,
+        });
+        this.notify();
+    }
+    removeSchedule(agentSlug) {
+        const agentTasks = this.store.getByAgent(agentSlug);
+        for (const task of agentTasks) {
+            this.store.remove(task.id);
+        }
+        this.notify();
+    }
+    // ── Queries ──
+    getUpcoming(hours = 24) {
+        const now = new Date();
+        const to = new Date(now.getTime() + hours * 60 * 60 * 1000);
+        return this.scheduler.getUpcoming(now, to);
+    }
+    getMissed() {
+        return this.scheduler.getMissed();
+    }
+    // ── Subscription for TUI re-renders ──
+    subscribe(listener) {
+        this.listeners.push(listener);
+        return () => {
+            const idx = this.listeners.indexOf(listener);
+            if (idx >= 0)
+                this.listeners.splice(idx, 1);
+        };
+    }
+    notify() {
+        for (const listener of this.listeners) {
+            listener();
+        }
+    }
+    // ── Internal helpers ──
+    getWeekRange(offset) {
+        const now = new Date();
+        const dayOfWeek = now.getDay();
+        const start = new Date(now);
+        start.setDate(now.getDate() - dayOfWeek + offset * 7);
+        start.setHours(0, 0, 0, 0);
+        const end = new Date(start);
+        end.setDate(start.getDate() + 6);
+        end.setHours(23, 59, 59, 999);
+        return { start, end };
+    }
+}
+// ── Singleton accessor ──
+let instance;
+export function getCalendarService() {
+    if (!instance) {
+        instance = new CalendarService();
+    }
+    return instance;
+}
+//# sourceMappingURL=calendar-service.js.map

package/dist/tui/services/calendar-service.js.map

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

package/dist/tui/services/chat-service.d.ts

@@ -0,0 +1,28 @@
+/**
+ * TUI service layer for the chat system.
+ * Wraps ChannelManager, MessageStore, and ChatRouter into a single facade
+ * that the chat view can consume without touching backend internals.
+ */
+import type { Channel, ChatMessage } from '../../chat/types.js';
+export declare class ChatService {
+    private channelManager;
+    private messageStore;
+    private chatRouter;
+    private listeners;
+    constructor(baseDir?: string);
+    getChannels(): Array<{
+        id: string;
+        name: string;
+        unread: number;
+    }>;
+    createChannel(name: string, type?: 'public' | 'private'): Channel;
+    /** Get existing channel by name, or create it if it doesn't exist. */
+    ensureChannel(name: string, type?: 'public' | 'private'): Channel;
+    getMessages(channelId: string, limit?: number): ChatMessage[];
+    send(channelId: string, content: string, sender?: string): ChatMessage;
+    route(channelId: string, sender: string, content: string): ChatMessage;
+    getPendingMentions(): ChatMessage[];
+    subscribe(listener: () => void): () => void;
+    private notify;
+}
+export declare function getChatService(): ChatService;

package/dist/tui/services/chat-service.js

@@ -0,0 +1,91 @@
+/**
+ * TUI service layer for the chat system.
+ * Wraps ChannelManager, MessageStore, and ChatRouter into a single facade
+ * that the chat view can consume without touching backend internals.
+ */
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { ChannelManager } from '../../chat/channel.js';
+import { MessageStore } from '../../chat/message-store.js';
+import { ChatRouter } from '../../chat/router.js';
+export class ChatService {
+    channelManager;
+    messageStore;
+    chatRouter;
+    listeners = [];
+    constructor(baseDir) {
+        const dir = baseDir ?? join(process.env.NEX_CLI_DATA_DIR ?? join(homedir(), '.nex-cli'), 'chat');
+        this.channelManager = new ChannelManager(dir);
+        this.messageStore = new MessageStore(join(dir, 'messages'));
+        this.chatRouter = new ChatRouter(this.channelManager, this.messageStore);
+        // Ensure a #general channel always exists
+        this.channelManager.ensureDefaults();
+    }
+    // ── Channel operations ──
+    getChannels() {
+        const channels = this.channelManager.list();
+        return channels.map(ch => ({
+            id: ch.id,
+            name: ch.name,
+            unread: this.messageStore.getUnread('human', 0)
+                .filter(m => m.channelId === ch.id).length,
+        }));
+    }
+    createChannel(name, type = 'public') {
+        const channel = this.channelManager.create({
+            name,
+            type,
+            members: ['human'],
+        });
+        this.notify();
+        return channel;
+    }
+    /** Get existing channel by name, or create it if it doesn't exist. */
+    ensureChannel(name, type = 'public') {
+        const existing = this.channelManager.list().find((ch) => ch.name === name);
+        if (existing)
+            return existing;
+        return this.createChannel(name, type);
+    }
+    // ── Message operations ──
+    getMessages(channelId, limit) {
+        return this.messageStore.getMessages(channelId, { limit });
+    }
+    send(channelId, content, sender = 'human') {
+        const message = this.chatRouter.route(channelId, sender, content);
+        this.notify();
+        return message;
+    }
+    // ── Routing ──
+    route(channelId, sender, content) {
+        const message = this.chatRouter.route(channelId, sender, content);
+        this.notify();
+        return message;
+    }
+    getPendingMentions() {
+        return this.chatRouter.hasPendingMentions();
+    }
+    // ── Subscription for TUI re-renders ──
+    subscribe(listener) {
+        this.listeners.push(listener);
+        return () => {
+            const idx = this.listeners.indexOf(listener);
+            if (idx >= 0)
+                this.listeners.splice(idx, 1);
+        };
+    }
+    notify() {
+        for (const listener of this.listeners) {
+            listener();
+        }
+    }
+}
+// ── Singleton accessor ──
+let instance;
+export function getChatService() {
+    if (!instance) {
+        instance = new ChatService();
+    }
+    return instance;
+}
+//# sourceMappingURL=chat-service.js.map

package/dist/tui/services/chat-service.js.map

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