@nex-ai/nex 0.1.27 → 0.1.29

package/README.md

@@ -1,9 +1,14 @@
-# @nex-ai/nex
+# Nex: Compounding Intelligence for AI agents
 
 [![npm version](https://img.shields.io/npm/v/@nex-ai/nex)](https://www.npmjs.com/package/@nex-ai/nex)
 [![GitHub](https://img.shields.io/badge/github-nex--crm%2Fnex--as--a--skill-blue)](https://github.com/nex-crm/nex-as-a-skill)
+[![Discord](https://img.shields.io/badge/Discord-Join%20Community-5865F2?logo=discord&logoColor=white)](https://discord.gg/gjSySC3PzV)
 
-Nex CLI provides organizational context & memory to AI agents across 12 platforms.
+Turn all your AI agent conversations into a unified knowledge graph. Supports Claude Code, Codex, OpenClaw, Cursor, OpenCode, etc. Adds additional context from Email, Meetings, Slack, HubSpot, Salesforce.
+
+<a href="https://discord.gg/gjSySC3PzV"><img src="https://img.shields.io/badge/Join%20our%20Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Join our Discord" /></a>
+
+Talk to the team, share feedback, and connect with other developers building AI agents with Nex.
 
 **GitHub**: [github.com/nex-crm/nex-as-a-skill](https://github.com/nex-crm/nex-as-a-skill)
 
@@ -11,7 +16,7 @@ Nex CLI provides organizational context & memory to AI agents across 12 platform
 
 ```bash
 # Install globally
-npm install -g @nex-ai/nex
+bun install -g @nex-ai/nex
 
 # Or run directly (no install)
 npx @nex-ai/nex ask "who is Maria?"
@@ -99,7 +104,7 @@ nex graph                          # Open the workspace graph in your browser
 - Creates `.nex.toml` project config with commented defaults
 - Syncs API key to `~/.nex-mcp.json` (shared config)
 
-**Single install**: `npm install -g @nex-ai/nex` bundles everything — hooks, adapters, platform plugins, slash commands, rules, and MCP server. No separate packages needed.
+**Single install**: `bun install -g @nex-ai/nex` bundles everything — hooks, adapters, platform plugins, slash commands, rules, and MCP server. No separate packages needed.
 
 **Integration hierarchy** (per platform): Hooks > Custom plugins > Custom agents/modes > Workflows > Rules > MCP. Each platform gets every layer it supports.
 
@@ -252,9 +257,9 @@ git diff | nex capture
 ## Development
 
 ```bash
-npm install
-npm run build     # TypeScript → dist/
-npm run dev       # Run with tsx (no build)
-npm test          # Unit tests
+bun install
+bun run build     # TypeScript → dist/
+bun run dev       # Run TS directly (no build)
+bun test          # Unit + integration tests
 NEX_DEV_URL=http://localhost:30000 nex ask "test"  # Local API
 ```

package/dist/agent/message-router.d.ts

@@ -0,0 +1,26 @@
+/**
+ * MessageRouter: routes incoming messages to the best-fit agent
+ * using TaskRouter for skill scoring and thread-detection heuristics
+ * for follow-up messages.
+ */
+export interface RoutingResult {
+    primary: string;
+    collaborators: string[];
+    isFollowUp: boolean;
+    teamLeadAware: boolean;
+}
+export declare class MessageRouter {
+    private router;
+    private recentThreads;
+    private FOLLOWUP_WINDOW_MS;
+    registerAgent(slug: string, expertise: string[]): void;
+    unregisterAgent(slug: string): void;
+    recordAgentActivity(agentSlug: string): void;
+    route(message: string, availableAgents: Array<{
+        slug: string;
+        expertise: string[];
+    }>): RoutingResult;
+    private detectFollowUp;
+    /** Extract skill keywords from a message using pattern matching. */
+    extractSkills(message: string): string[];
+}

package/dist/agent/message-router.js

@@ -0,0 +1,114 @@
+/**
+ * MessageRouter: routes incoming messages to the best-fit agent
+ * using TaskRouter for skill scoring and thread-detection heuristics
+ * for follow-up messages.
+ */
+import { TaskRouter } from '../orchestration/router.js';
+export class MessageRouter {
+    router = new TaskRouter();
+    recentThreads = new Map();
+    FOLLOWUP_WINDOW_MS = 30_000;
+    registerAgent(slug, expertise) {
+        this.router.registerAgent(slug, expertise.map((e) => ({ name: e, description: e, proficiency: 0.8 })));
+    }
+    unregisterAgent(slug) {
+        this.router.unregisterAgent(slug);
+    }
+    recordAgentActivity(agentSlug) {
+        this.recentThreads.set(agentSlug, { agentSlug, lastActivity: Date.now() });
+    }
+    route(message, availableAgents) {
+        // Step 1: Thread detection
+        const followUp = this.detectFollowUp(message);
+        if (followUp) {
+            return { primary: followUp, collaborators: [], isFollowUp: true, teamLeadAware: false };
+        }
+        // Step 2: Extract skills from message using keyword patterns
+        const requiredSkills = this.extractSkills(message);
+        // No recognized skills → route to team-lead for triage
+        if (requiredSkills.length === 0) {
+            return { primary: 'team-lead', collaborators: [], isFollowUp: false, teamLeadAware: false };
+        }
+        // Step 3: Register agents (ensure current state) and score
+        for (const agent of availableAgents) {
+            this.registerAgent(agent.slug, agent.expertise);
+        }
+        const task = {
+            id: `route-${Date.now()}`,
+            title: message,
+            description: message,
+            requiredSkills,
+            priority: 'medium',
+            status: 'pending',
+            createdAt: Date.now(),
+        };
+        const capable = this.router.findCapableAgents(task);
+        if (capable.length === 0) {
+            return { primary: 'team-lead', collaborators: [], isFollowUp: false, teamLeadAware: false };
+        }
+        const primary = capable[0].agentSlug;
+        const collaborators = capable
+            .slice(1)
+            .filter((c) => c.score > 0.5)
+            .map((c) => c.agentSlug);
+        return {
+            primary,
+            collaborators,
+            isFollowUp: false,
+            teamLeadAware: primary !== 'team-lead',
+        };
+    }
+    detectFollowUp(message) {
+        const now = Date.now();
+        const followUpPatterns = /^(also|and |too |that |it |the results|those |these |this |what about|how about|can you also)/i;
+        if (!followUpPatterns.test(message.trim()))
+            return null;
+        // Find most recent active thread within window
+        let mostRecent = null;
+        for (const [, ctx] of this.recentThreads) {
+            if (now - ctx.lastActivity <= this.FOLLOWUP_WINDOW_MS) {
+                if (!mostRecent || ctx.lastActivity > mostRecent.lastActivity) {
+                    mostRecent = ctx;
+                }
+            }
+        }
+        return mostRecent?.agentSlug ?? null;
+    }
+    /** Extract skill keywords from a message using pattern matching. */
+    extractSkills(message) {
+        const skillPatterns = [
+            {
+                pattern: /\b(research|investigate|analyze|analysis|competitor)\b/i,
+                skills: ['market-research', 'competitive-analysis'],
+            },
+            {
+                pattern: /\b(leads?|prospect|outreach|prospecting|pipeline)\b/i,
+                skills: ['prospecting', 'outreach'],
+            },
+            {
+                pattern: /\b(enrich|validate|data quality|fill in|complete)\b/i,
+                skills: ['data-enrichment', 'validation'],
+            },
+            {
+                pattern: /\b(seo|keyword|search visibility|ranking|content)\b/i,
+                skills: ['seo', 'content-analysis'],
+            },
+            {
+                pattern: /\b(customer|success|health|renewal|churn|retention)\b/i,
+                skills: ['relationship-management', 'health-scoring'],
+            },
+            {
+                pattern: /\b(code|bug|fix|implement|build|deploy|test)\b/i,
+                skills: ['general', 'planning'],
+            },
+        ];
+        const skills = [];
+        for (const { pattern, skills: matchedSkills } of skillPatterns) {
+            if (pattern.test(message)) {
+                skills.push(...matchedSkills);
+            }
+        }
+        return [...new Set(skills)];
+    }
+}
+//# sourceMappingURL=message-router.js.map

package/dist/agent/message-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-router.js","sourceRoot":"","sources":["../../src/agent/message-router.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAexD,MAAM,OAAO,aAAa;IAChB,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;IAC1B,aAAa,GAAG,IAAI,GAAG,EAAyB,CAAC;IACjD,kBAAkB,GAAG,MAAM,CAAC;IAEpC,aAAa,CAAC,IAAY,EAAE,SAAmB;QAC7C,IAAI,CAAC,MAAM,CAAC,aAAa,CACvB,IAAI,EACJ,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,CACtE,CAAC;IACJ,CAAC;IAED,eAAe,CAAC,IAAY;QAC1B,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,mBAAmB,CAAC,SAAiB;QACnC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,KAAK,CACH,OAAe,EACf,eAA6D;QAE7D,2BAA2B;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;QAC1F,CAAC;QAED,6DAA6D;QAC7D,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAEnD,uDAAuD;QACvD,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;QAC9F,CAAC;QAED,2DAA2D;QAC3D,KAAK,MAAM,KAAK,IAAI,eAAe,EAAE,CAAC;YACpC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QAClD,CAAC;QAED,MAAM,IAAI,GAAmB;YAC3B,EAAE,EAAE,SAAS,IAAI,CAAC,GAAG,EAAE,EAAE;YACzB,KAAK,EAAE,OAAO;YACd,WAAW,EAAE,OAAO;YACpB,cAAc;YACd,QAAQ,EAAE,QAAQ;YAClB,MAAM,EAAE,SAAS;YACjB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;QAEF,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAEpD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;QAC9F,CAAC;QAED,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACrC,MAAM,aAAa,GAAG,OAAO;aAC1B,KAAK,CAAC,CAAC,CAAC;aACR,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC;aAC5B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAE3B,OAAO;YACL,OAAO;YACP,aAAa;YACb,UAAU,EAAE,KAAK;YACjB,aAAa,EAAE,OAAO,KAAK,WAAW;SACvC,CAAC;IACJ,CAAC;IAEO,cAAc,CAAC,OAAe;QACpC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,gBAAgB,GACpB,gGAAgG,CAAC;QAEnG,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAAE,OAAO,IAAI,CAAC;QAExD,+CAA+C;QAC/C,IAAI,UAAU,GAAyB,IAAI,CAAC;QAC5C,KAAK,MAAM,CAAC,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACzC,IAAI,GAAG,GAAG,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;gBACtD,IAAI,CAAC,UAAU,IAAI,GAAG,CAAC,YAAY,GAAG,UAAU,CAAC,YAAY,EAAE,CAAC;oBAC9D,UAAU,GAAG,GAAG,CAAC;gBACnB,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,UAAU,EAAE,SAAS,IAAI,IAAI,CAAC;IACvC,CAAC;IAED,oEAAoE;IACpE,aAAa,CAAC,OAAe;QAC3B,MAAM,aAAa,GAAiD;YAClE;gBACE,OAAO,EAAE,yDAAyD;gBAClE,MAAM,EAAE,CAAC,iBAAiB,EAAE,sBAAsB,CAAC;aACpD;YACD;gBACE,OAAO,EAAE,sDAAsD;gBAC/D,MAAM,EAAE,CAAC,aAAa,EAAE,UAAU,CAAC;aACpC;YACD;gBACE,OAAO,EAAE,sDAAsD;gBAC/D,MAAM,EAAE,CAAC,iBAAiB,EAAE,YAAY,CAAC;aAC1C;YACD;gBACE,OAAO,EAAE,sDAAsD;gBAC/D,MAAM,EAAE,CAAC,KAAK,EAAE,kBAAkB,CAAC;aACpC;YACD;gBACE,OAAO,EAAE,wDAAwD;gBACjE,MAAM,EAAE,CAAC,yBAAyB,EAAE,gBAAgB,CAAC;aACtD;YACD;gBACE,OAAO,EAAE,iDAAiD;gBAC1D,MAAM,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC;aAChC;SACF,CAAC;QAEF,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,KAAK,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,aAAa,EAAE,CAAC;YAC/D,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC1B,MAAM,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QACD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9B,CAAC;CACF"}

package/dist/agent/orchestrate.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Objective-first delegation: Team-Lead decomposes objectives
+ * and routes sub-tasks to specialist agents via steer messages.
+ *
+ * Uses the orchestration TaskRouter for skill matching and
+ * MessageQueues for non-blocking delegation.
+ */
+import type { AgentConfig } from './types.js';
+import type { MessageQueues } from './queues.js';
+/** Extract actionable sub-tasks from the Team-Lead's response text. */
+export declare function extractSubTasks(response: string): Array<{
+    action: string;
+    skills: string[];
+}>;
+export interface Specialist {
+    config: AgentConfig;
+}
+/**
+ * Delegate sub-tasks to specialist agents.
+ * Non-blocking: sends steer messages to matching specialists
+ * so they pick up work on their next tick.
+ */
+export declare function delegateToSpecialists(response: string, specialists: Specialist[], queues: MessageQueues): Array<{
+    agentSlug: string;
+    task: string;
+}>;

package/dist/agent/orchestrate.js

@@ -0,0 +1,87 @@
+/**
+ * Objective-first delegation: Team-Lead decomposes objectives
+ * and routes sub-tasks to specialist agents via steer messages.
+ *
+ * Uses the orchestration TaskRouter for skill matching and
+ * MessageQueues for non-blocking delegation.
+ */
+import { TaskRouter } from '../orchestration/router.js';
+import { getAgentService } from '../tui/services/agent-service.js';
+/** Map agent expertise strings to SkillDeclarations for the router. */
+function expertiseToSkills(expertise) {
+    return expertise.map(e => ({
+        name: e,
+        description: e,
+        proficiency: 0.8,
+    }));
+}
+/** Extract actionable sub-tasks from the Team-Lead's response text. */
+export function extractSubTasks(response) {
+    const subTasks = [];
+    // Skill keyword mapping — matches action words to required expertise
+    const skillPatterns = [
+        { pattern: /\b(research|investigate|analyze|analysis)\b/i, skills: ['research', 'market-research', 'competitive-analysis'] },
+        { pattern: /\b(find leads|generate leads|prospect|outreach|prospecting)\b/i, skills: ['prospecting', 'enrichment', 'outreach'] },
+        { pattern: /\b(enrich|validate|fill in|complete data|data quality)\b/i, skills: ['data-enrichment', 'research', 'validation'] },
+        { pattern: /\b(seo|keyword|search visibility|content.?analysis|ranking)\b/i, skills: ['seo', 'content-analysis', 'keyword-research'] },
+        { pattern: /\b(customer success|health score|renewal|churn|retention)\b/i, skills: ['relationship-management', 'health-scoring', 'renewal-tracking'] },
+    ];
+    // Split response into sentences and look for action-oriented ones
+    const sentences = response.split(/[.!?\n]+/).map(s => s.trim()).filter(Boolean);
+    for (const sentence of sentences) {
+        for (const { pattern, skills } of skillPatterns) {
+            if (pattern.test(sentence)) {
+                // Avoid duplicates
+                if (!subTasks.some(t => t.action === sentence)) {
+                    subTasks.push({ action: sentence, skills });
+                }
+            }
+        }
+    }
+    return subTasks;
+}
+/**
+ * Delegate sub-tasks to specialist agents.
+ * Non-blocking: sends steer messages to matching specialists
+ * so they pick up work on their next tick.
+ */
+export function delegateToSpecialists(response, specialists, queues) {
+    if (specialists.length === 0)
+        return [];
+    const subTasks = extractSubTasks(response);
+    if (subTasks.length === 0)
+        return [];
+    // Build a router with registered specialists
+    const router = new TaskRouter();
+    for (const spec of specialists) {
+        router.registerAgent(spec.config.slug, expertiseToSkills(spec.config.expertise));
+    }
+    const delegated = [];
+    for (const subTask of subTasks) {
+        const taskDef = {
+            id: `delegate-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+            title: subTask.action,
+            description: subTask.action,
+            requiredSkills: subTask.skills,
+            priority: 'medium',
+            status: 'pending',
+            createdAt: Date.now(),
+        };
+        const best = router.findBestAgent(taskDef);
+        if (best && best.score > 0.1) {
+            // Steer the specialist with the sub-task
+            queues.steer(best.agentSlug, `[TEAM-LEAD DELEGATION] ${subTask.action}`);
+            delegated.push({ agentSlug: best.agentSlug, task: subTask.action });
+            // Ensure specialist agent tick loop is running
+            try {
+                const agentService = getAgentService();
+                agentService.ensureRunning(best.agentSlug);
+            }
+            catch {
+                // AgentService may not be initialized yet — delegation still succeeds via queue
+            }
+        }
+    }
+    return delegated;
+}
+//# sourceMappingURL=orchestrate.js.map

package/dist/agent/orchestrate.js.map

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

package/dist/agent/providers/types.d.ts

@@ -0,0 +1,5 @@
+export type LLMProvider = 'gemini' | 'claude-code';
+export interface ProviderConfig {
+    provider: LLMProvider;
+    geminiApiKey?: string;
+}

package/dist/agent/providers/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/agent/providers/types.js.map

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

package/dist/agent/templates.js

@@ -37,6 +37,13 @@ export const templates = {
         heartbeatCron: '0 */8 * * *',
         tools: ['nex_search', 'nex_ask', 'nex_record_list', 'nex_record_get', 'nex_remember'],
     },
+    'team-lead': {
+        name: 'Team Lead',
+        expertise: ['general', 'research', 'analysis', 'communication', 'planning', 'orchestration'],
+        personality: 'You are the Team Lead — the primary interface between the human and the specialist agents. You understand objectives, break them into tasks, delegate to the right specialists, and synthesize results. When the user says what they want, you figure out the path to get there using the context graph and available agents. You always respond first, then coordinate behind the scenes.',
+        heartbeatCron: 'manual',
+        tools: ['nex_search', 'nex_ask', 'nex_remember', 'nex_record_list', 'nex_record_get', 'nex_record_create', 'nex_record_update'],
+    },
     'founding-agent': {
         name: 'Founding Agent',
         expertise: ['general', 'research', 'analysis', 'communication', 'planning'],

package/dist/agent/templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/agent/templates.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,CAAC,MAAM,SAAS,GAA8C;IAClE,WAAW,EAAE;QACX,IAAI,EAAE,aAAa;QACnB,SAAS,EAAE,CAAC,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,CAAC;QAC1D,WAAW,EAAE,2DAA2D;QACxE,aAAa,EAAE,OAAO;QACtB,KAAK,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,iBAAiB,CAAC;KACpE;IACD,UAAU,EAAE;QACV,IAAI,EAAE,gBAAgB;QACtB,SAAS,EAAE,CAAC,aAAa,EAAE,YAAY,EAAE,UAAU,CAAC;QACpD,WAAW,EAAE,mDAAmD;QAChE,aAAa,EAAE,aAAa;QAC5B,KAAK,EAAE,CAAC,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,cAAc,CAAC;KAC9E;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,eAAe;QACrB,SAAS,EAAE,CAAC,iBAAiB,EAAE,UAAU,EAAE,YAAY,CAAC;QACxD,WAAW,EAAE,6CAA6C;QAC1D,aAAa,EAAE,aAAa;QAC5B,KAAK,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,cAAc,CAAC;KACxF;IACD,UAAU,EAAE;QACV,IAAI,EAAE,kBAAkB;QACxB,SAAS,EAAE,CAAC,iBAAiB,EAAE,sBAAsB,EAAE,gBAAgB,CAAC;QACxE,WAAW,EAAE,oDAAoD;QACjE,aAAa,EAAE,OAAO;QACtB,KAAK,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,cAAc,CAAC;KACjD;IACD,kBAAkB,EAAE;QAClB,IAAI,EAAE,kBAAkB;QACxB,SAAS,EAAE,CAAC,yBAAyB,EAAE,gBAAgB,EAAE,kBAAkB,CAAC;QAC5E,WAAW,EAAE,uDAAuD;QACpE,aAAa,EAAE,aAAa;QAC5B,KAAK,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,cAAc,CAAC;KACtF;IACD,gBAAgB,EAAE;QAChB,IAAI,EAAE,gBAAgB;QACtB,SAAS,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,CAAC;QAC3E,WAAW,EAAE,uIAAuI;QACpJ,aAAa,EAAE,OAAO;QACtB,KAAK,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,mBAAmB,CAAC;KAChI;CACF,CAAC"}
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/agent/templates.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,CAAC,MAAM,SAAS,GAA8C;IAClE,WAAW,EAAE;QACX,IAAI,EAAE,aAAa;QACnB,SAAS,EAAE,CAAC,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,CAAC;QAC1D,WAAW,EAAE,2DAA2D;QACxE,aAAa,EAAE,OAAO;QACtB,KAAK,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,iBAAiB,CAAC;KACpE;IACD,UAAU,EAAE;QACV,IAAI,EAAE,gBAAgB;QACtB,SAAS,EAAE,CAAC,aAAa,EAAE,YAAY,EAAE,UAAU,CAAC;QACpD,WAAW,EAAE,mDAAmD;QAChE,aAAa,EAAE,aAAa;QAC5B,KAAK,EAAE,CAAC,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,cAAc,CAAC;KAC9E;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,eAAe;QACrB,SAAS,EAAE,CAAC,iBAAiB,EAAE,UAAU,EAAE,YAAY,CAAC;QACxD,WAAW,EAAE,6CAA6C;QAC1D,aAAa,EAAE,aAAa;QAC5B,KAAK,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,cAAc,CAAC;KACxF;IACD,UAAU,EAAE;QACV,IAAI,EAAE,kBAAkB;QACxB,SAAS,EAAE,CAAC,iBAAiB,EAAE,sBAAsB,EAAE,gBAAgB,CAAC;QACxE,WAAW,EAAE,oDAAoD;QACjE,aAAa,EAAE,OAAO;QACtB,KAAK,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,cAAc,CAAC;KACjD;IACD,kBAAkB,EAAE;QAClB,IAAI,EAAE,kBAAkB;QACxB,SAAS,EAAE,CAAC,yBAAyB,EAAE,gBAAgB,EAAE,kBAAkB,CAAC;QAC5E,WAAW,EAAE,uDAAuD;QACpE,aAAa,EAAE,aAAa;QAC5B,KAAK,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,cAAc,CAAC;KACtF;IACD,WAAW,EAAE;QACX,IAAI,EAAE,WAAW;QACjB,SAAS,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,eAAe,CAAC;QAC5F,WAAW,EAAE,4XAA4X;QACzY,aAAa,EAAE,QAAQ;QACvB,KAAK,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,mBAAmB,CAAC;KAChI;IACD,gBAAgB,EAAE;QAChB,IAAI,EAAE,gBAAgB;QACtB,SAAS,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,CAAC;QAC3E,WAAW,EAAE,uIAAuI;QACpJ,aAAa,EAAE,OAAO;QACtB,KAAK,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,mBAAmB,CAAC;KAChI;CACF,CAAC"}

package/dist/agent/tick-manager.d.ts

@@ -0,0 +1,20 @@
+/**
+ * TickManager: drives agent loops on a fixed interval.
+ * Each agent gets its own setInterval; ticks are skipped
+ * when the agent is idle with no queued work.
+ */
+export declare class TickManager {
+    private intervals;
+    private tickRateMs;
+    constructor(tickRateMs?: number);
+    startLoop(slug: string, loop: {
+        getState(): {
+            phase: string;
+        };
+        start(): void;
+        tick(): Promise<void>;
+    }, hasWork: () => boolean): void;
+    stopLoop(slug: string): void;
+    isRunning(slug: string): boolean;
+    stopAll(): void;
+}

package/dist/agent/tick-manager.js

@@ -0,0 +1,50 @@
+/**
+ * TickManager: drives agent loops on a fixed interval.
+ * Each agent gets its own setInterval; ticks are skipped
+ * when the agent is idle with no queued work.
+ */
+export class TickManager {
+    intervals = new Map();
+    tickRateMs;
+    constructor(tickRateMs = 500) {
+        this.tickRateMs = tickRateMs;
+    }
+    startLoop(slug, loop, hasWork) {
+        if (this.intervals.has(slug))
+            return; // idempotent
+        const interval = setInterval(async () => {
+            const state = loop.getState();
+            // Only tick if there's pending work
+            if ((state.phase === 'done' || state.phase === 'error' || state.phase === 'idle') &&
+                !hasWork()) {
+                return; // idle skip
+            }
+            if (state.phase === 'done' || state.phase === 'error') {
+                loop.start(); // reset to idle
+            }
+            try {
+                await loop.tick();
+            }
+            catch {
+                /* swallow tick errors */
+            }
+        }, this.tickRateMs);
+        this.intervals.set(slug, interval);
+    }
+    stopLoop(slug) {
+        const interval = this.intervals.get(slug);
+        if (interval) {
+            clearInterval(interval);
+            this.intervals.delete(slug);
+        }
+    }
+    isRunning(slug) {
+        return this.intervals.has(slug);
+    }
+    stopAll() {
+        for (const [slug] of this.intervals) {
+            this.stopLoop(slug);
+        }
+    }
+}
+//# sourceMappingURL=tick-manager.js.map

package/dist/agent/tick-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tick-manager.js","sourceRoot":"","sources":["../../src/agent/tick-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,OAAO,WAAW;IACd,SAAS,GAAG,IAAI,GAAG,EAA0C,CAAC;IAC9D,UAAU,CAAS;IAE3B,YAAY,UAAU,GAAG,GAAG;QAC1B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,SAAS,CACP,IAAY,EACZ,IAA6E,EAC7E,OAAsB;QAEtB,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,aAAa;QAEnD,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;YACtC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC9B,oCAAoC;YACpC,IACE,CAAC,KAAK,CAAC,KAAK,KAAK,MAAM,IAAI,KAAK,CAAC,KAAK,KAAK,OAAO,IAAI,KAAK,CAAC,KAAK,KAAK,MAAM,CAAC;gBAC7E,CAAC,OAAO,EAAE,EACV,CAAC;gBACD,OAAO,CAAC,YAAY;YACtB,CAAC;YACD,IAAI,KAAK,CAAC,KAAK,KAAK,MAAM,IAAI,KAAK,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;gBACtD,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,gBAAgB;YAChC,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YACpB,CAAC;YAAC,MAAM,CAAC;gBACP,yBAAyB;YAC3B,CAAC;QACH,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAEpB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED,QAAQ,CAAC,IAAY;QACnB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,QAAQ,EAAE,CAAC;YACb,aAAa,CAAC,QAAQ,CAAC,CAAC;YACxB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,SAAS,CAAC,IAAY;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,OAAO;QACL,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACpC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;CACF"}

package/dist/commands/dispatch.d.ts

@@ -28,6 +28,11 @@ export interface CommandContext {
  * The TUI and CLI can both call this to execute commands without stdout side effects.
  */
 export declare function dispatch(input: string, ctx?: CommandContext): Promise<CommandResult>;
+/**
+ * Dispatch from pre-tokenized args (e.g. process.argv).
+ * Use this when the shell has already handled quoting/splitting.
+ */
+export declare function dispatchTokens(tokens: string[], ctx?: CommandContext): Promise<CommandResult>;
 /** All registered command names, for autocomplete. */
 export declare const commandNames: string[];
 /** Help entries for each command, with category and description. */

package/dist/commands/dispatch.js

@@ -1217,6 +1217,106 @@ register("agent stop", { execute: executeAgentStop, description: "Stop an agent
 register("agent steer", { execute: executeAgentSteer, description: "Send a steer message to an agent", category: "agent", usage: "agent steer <slug> <message>" });
 register("agent inspect", { execute: executeAgentInspect, description: "Inspect agent config and state", category: "agent", usage: "agent inspect <slug>" });
 register("agent templates", { execute: executeAgentTemplates, description: "List available agent templates", category: "agent", usage: "agent templates" });
+// -- Scan --
+async function executeScan(args, ctx) {
+    const { positional, opts } = extractOpts(args);
+    const dir = positional[0] || ".";
+    const maxFiles = typeof opts["max-files"] === "string" ? parseInt(opts["max-files"], 10) : undefined;
+    if (maxFiles !== undefined && (!Number.isInteger(maxFiles) || maxFiles <= 0)) {
+        return fail("Invalid --max-files. Expected a positive integer.");
+    }
+    const depth = typeof opts.depth === "string" ? parseInt(opts.depth, 10) : undefined;
+    if (depth !== undefined && (!Number.isInteger(depth) || depth < 0)) {
+        return fail("Invalid --depth. Expected a non-negative integer.");
+    }
+    const extensions = typeof opts.extensions === "string" ? opts.extensions : undefined;
+    const force = opts.force === true;
+    const dryRun = opts["dry-run"] === true;
+    try {
+        const { scanFiles, loadScanConfig } = await import("../lib/file-scanner.js");
+        const scanOpts = loadScanConfig({
+            extensions: extensions?.split(",").map((e) => e.trim()),
+            maxFiles,
+            depth,
+            force,
+            dryRun,
+        });
+        const client = makeClient(ctx);
+        const result = await scanFiles(dir, scanOpts, async (content, context) => {
+            return client.post("/v1/context/text", { content, context });
+        });
+        return ok({ scanned: result.scanned, skipped: result.skipped, errors: result.errors }, ctx);
+    }
+    catch (err) {
+        return wrapError(err);
+    }
+}
+register("scan", { execute: executeScan, description: "Scan directory and ingest files", category: "config", usage: "scan [dir] [--max-files <n>] [--force] [--dry-run]" });
+// -- Register --
+async function executeRegister(args, ctx) {
+    const { opts } = extractOpts(args);
+    const email = typeof opts.email === "string" ? opts.email : undefined;
+    if (!email)
+        return fail("Usage: register --email <email>");
+    try {
+        const { persistRegistration } = await import("../lib/config.js");
+        const client = new NexClient(undefined, ctx.timeout ?? resolveTimeout());
+        const data = await client.register(email, typeof opts.name === "string" ? opts.name : undefined, typeof opts.company === "string" ? opts.company : undefined);
+        persistRegistration(data);
+        return ok(data, ctx);
+    }
+    catch (err) {
+        return wrapError(err);
+    }
+}
+register("register", { execute: executeRegister, description: "Register a new Nex workspace", category: "config", usage: "register --email <email> [--name <name>] [--company <company>]" });
+// -- Session --
+async function executeSessionList(_args, ctx) {
+    try {
+        const { SessionStore } = await import("../lib/session-store.js");
+        const store = new SessionStore();
+        return ok(store.list(), ctx);
+    }
+    catch (err) {
+        return wrapError(err);
+    }
+}
+async function executeSessionClear(_args, ctx) {
+    try {
+        const { SessionStore } = await import("../lib/session-store.js");
+        const store = new SessionStore();
+        store.clear();
+        return ok({ message: "All sessions cleared." }, ctx);
+    }
+    catch (err) {
+        return wrapError(err);
+    }
+}
+register("session list", { execute: executeSessionList, description: "List stored session mappings", category: "config" });
+register("session clear", { execute: executeSessionClear, description: "Clear all session mappings", category: "config" });
+// -- List member operations --
+function makeListRecordCommand(method, usage, pathFn, bodyFn) {
+    return async (args, ctx) => {
+        const { positional, opts } = extractOpts(args);
+        const [listId, recordId] = positional;
+        if (!listId || !recordId)
+            return fail(`Usage: ${usage}`);
+        try {
+            const client = makeClient(ctx);
+            const path = pathFn(encodeURIComponent(listId), encodeURIComponent(recordId));
+            const body = bodyFn?.(recordId, opts);
+            const data = method === "delete" ? await client.delete(path) : await client[method](path, body);
+            return ok(data, ctx);
+        }
+        catch (err) {
+            return wrapError(err);
+        }
+    };
+}
+register("list add-member", { execute: makeListRecordCommand("post", "list add-member <list-id> <record-id>", (lid) => `/v1/lists/${lid}/records`, (rid) => ({ record_id: rid })), description: "Add a record to a list", category: "write", usage: "list add-member <list-id> <record-id>" });
+register("list upsert-member", { execute: makeListRecordCommand("put", "list upsert-member <list-id> <record-id>", (lid, rid) => `/v1/lists/${lid}/records/${rid}`, (_rid, opts) => opts), description: "Upsert a record in a list", category: "write", usage: "list upsert-member <list-id> <record-id>" });
+register("list update-record", { execute: makeListRecordCommand("patch", "list update-record <list-id> <record-id>", (lid, rid) => `/v1/lists/${lid}/records/${rid}`, (_rid, opts) => opts), description: "Update a list record", category: "write", usage: "list update-record <list-id> <record-id>" });
+register("list remove-record", { execute: makeListRecordCommand("delete", "list remove-record <list-id> <record-id>", (lid, rid) => `/v1/lists/${lid}/records/${rid}`), description: "Remove a record from a list", category: "write", usage: "list remove-record <list-id> <record-id>" });
 // -- TUI view hints (so aliases resolve and dispatch does not return "unknown command") --
 register("chat", {
     execute: async () => ({ output: "Use the 'c' keybinding to open the chat view.", exitCode: 0 }),
@@ -1241,6 +1341,7 @@ const COMMAND_ALIASES = {
     objects: "object list",
     orch: "orchestration",
     setup: "init",
+    sessions: "session list",
 };
 /**
  * Resolve alias tokens into their canonical form.
@@ -1285,6 +1386,13 @@ function resolveCommand(tokens) {
  */
 export async function dispatch(input, ctx) {
     const tokens = parseInput(input);
+    return dispatchTokens(tokens, ctx);
+}
+/**
+ * Dispatch from pre-tokenized args (e.g. process.argv).
+ * Use this when the shell has already handled quoting/splitting.
+ */
+export async function dispatchTokens(tokens, ctx) {
     if (tokens.length === 0) {
         return fail("No command provided.");
     }