@nex-ai/nex 0.1.28 → 0.1.30

package/README.md

@@ -4,7 +4,7 @@
 [![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)
 
-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.
+Turn all your AI agent conversations into a unified knowledge graph with proactive context surfacing. 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>
 
@@ -16,7 +16,7 @@ Talk to the team, share feedback, and connect with other developers building AI
 
 ```bash
 # Install globally
-bun install -g @nex-ai/nex
+npm install -g @nex-ai/nex
 
 # Or run directly (no install)
 npx @nex-ai/nex ask "who is Maria?"
@@ -102,9 +102,9 @@ nex graph                          # Open the workspace graph in your browser
 - Installs the full 6-layer hierarchy for each detected platform: hooks → plugins → agents → workflows → rules → MCP
 - Scans current directory and ingests new/changed files into Nex
 - Creates `.nex.toml` project config with commented defaults
-- Syncs API key to `~/.nex-mcp.json` (shared config)
+- Stores config in `~/.nex/config.json`
 
-**Single install**: `bun install -g @nex-ai/nex` bundles everything — hooks, adapters, platform plugins, slash commands, rules, and MCP server. No separate packages needed.
+**Single install**: `npm 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.
 
@@ -120,8 +120,8 @@ Per-project settings file created by `nex setup`. All fields are optional.
 # enabled = true              # Master kill switch for all hooks
 
 [hooks.recall]
-# enabled = true              # Auto-recall context on each prompt
-# debounce_ms = 30000
+# enabled = true              # Proactive context on every prompt
+# debounce_ms = 10000
 
 [hooks.capture]
 # enabled = true              # Auto-capture on conversation stop
@@ -135,7 +135,7 @@ Per-project settings file created by `nex setup`. All fields are optional.
 # enabled = true
 # extensions = [".md", ".txt", ".csv", ".json", ".yaml", ".yml"]
 # ignore_dirs = ["node_modules", ".git", "dist", "build", "__pycache__"]
-# max_files = 5
+# max_files = 1000
 # max_file_size = 100000
 # depth = 2
 
@@ -208,7 +208,14 @@ nex list-job create "enterprise contacts in EMEA"
 
 ### File Scanning
 
-On session start, Nex automatically scans project files and ingests changed content.
+On session start, Nex automatically scans project files and ingests changed content using concurrent workers (5 parallel requests). After ingestion, compounding intelligence jobs are triggered automatically to generate patterns and playbook rules.
+
+```bash
+nex scan                    # Scan current directory (up to 1000 files)
+nex scan --max-files 500    # Limit files per scan
+nex scan --force            # Re-scan all files (ignore manifest)
+nex scan --dry-run          # Preview what would be scanned
+```
 
 **Default text-based extensions:** `.md`, `.txt`, `.csv`, `.json`, `.yaml`, `.yml`
 
@@ -216,6 +223,16 @@ On session start, Nex automatically scans project files and ingests changed cont
 
 Configure via `.nex.toml` `[scan]` section or environment variables (`NEX_SCAN_ENABLED`, `NEX_SCAN_EXTENSIONS`, etc.).
 
+### Proactive Context
+
+Nex surfaces relevant knowledge graph context on every prompt — not just questions. When you say "fix the migration script" or "deploy to staging", the system automatically injects entity insights, knowledge insights, and playbook patterns from your knowledge graph.
+
+Context is injected as `<nex-context>` blocks that AI agents use naturally without explicitly referencing the source. Only trivial inputs (yes/ok/lgtm) are skipped.
+
+### Transcript Capture
+
+At session end, the full conversation transcript is automatically ingested into the knowledge graph. This captures complete decision trails, code discussions, and debugging sessions — not just the last message.
+
 ### Config & Sessions
 
 ```bash

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/queues.d.ts

@@ -13,4 +13,5 @@ export declare class MessageQueues {
     drainFollowUp(agentSlug: string): string | undefined;
     hasSteer(agentSlug: string): boolean;
     hasFollowUp(agentSlug: string): boolean;
+    hasMessages(agentSlug: string): boolean;
 }

package/dist/agent/queues.js

@@ -40,5 +40,8 @@ export class MessageQueues {
         const q = this.followUpQueues.get(agentSlug);
         return q !== undefined && q.length > 0;
     }
+    hasMessages(agentSlug) {
+        return this.hasSteer(agentSlug) || this.hasFollowUp(agentSlug);
+    }
 }
 //# sourceMappingURL=queues.js.map

package/dist/agent/queues.js.map

@@ -1 +1 @@
-{"version":3,"file":"queues.js","sourceRoot":"","sources":["../../src/agent/queues.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,OAAO,aAAa;IAChB,WAAW,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC1C,cAAc,GAAG,IAAI,GAAG,EAAoB,CAAC;IAE7C,QAAQ,CAAC,GAA0B,EAAE,SAAiB;QAC5D,IAAI,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC3B,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,CAAC,GAAG,EAAE,CAAC;YACP,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QACxB,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,KAAK,CAAC,SAAiB,EAAE,OAAe;QACtC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3D,CAAC;IAED,QAAQ,CAAC,SAAiB,EAAE,OAAe;QACzC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9D,CAAC;IAED,UAAU,CAAC,SAAiB;QAC1B,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAC3C,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC;IAED,aAAa,CAAC,SAAiB;QAC7B,MAAM,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAC3C,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC;IAED,QAAQ,CAAC,SAAiB;QACxB,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC1C,OAAO,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IACzC,CAAC;IAED,WAAW,CAAC,SAAiB;QAC3B,MAAM,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,OAAO,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IACzC,CAAC;CACF"}
+{"version":3,"file":"queues.js","sourceRoot":"","sources":["../../src/agent/queues.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,OAAO,aAAa;IAChB,WAAW,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC1C,cAAc,GAAG,IAAI,GAAG,EAAoB,CAAC;IAE7C,QAAQ,CAAC,GAA0B,EAAE,SAAiB;QAC5D,IAAI,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC3B,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,CAAC,GAAG,EAAE,CAAC;YACP,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QACxB,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,KAAK,CAAC,SAAiB,EAAE,OAAe;QACtC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3D,CAAC;IAED,QAAQ,CAAC,SAAiB,EAAE,OAAe;QACzC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9D,CAAC;IAED,UAAU,CAAC,SAAiB;QAC1B,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAC3C,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC;IAED,aAAa,CAAC,SAAiB;QAC7B,MAAM,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAC3C,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC;IAED,QAAQ,CAAC,SAAiB;QACxB,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC1C,OAAO,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IACzC,CAAC;IAED,WAAW,CAAC,SAAiB;QAC3B,MAAM,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,OAAO,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IACzC,CAAC;IAED,WAAW,CAAC,SAAiB;QAC3B,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IACjE,CAAC;CACF"}

package/dist/agent/templates.js

@@ -37,10 +37,17 @@ 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'],
-        personality: 'Versatile and proactive. Your first AI team member — handles everything from research to outreach until specialized agents are added.',
+        name: 'Team Lead',
+        expertise: ['general', 'research', 'analysis', 'communication', 'planning', 'orchestration'],
+        personality: 'Versatile and proactive. Your first AI team member — handles everything from research to outreach until specialized agents are added. Delegates to specialists when they exist.',
         heartbeatCron: 'daily',
         tools: ['nex_search', 'nex_ask', 'nex_remember', 'nex_record_list', 'nex_record_get', 'nex_record_create', 'nex_record_update'],
     },

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,WAAW;QACjB,SAAS,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,eAAe,CAAC;QAC5F,WAAW,EAAE,iLAAiL;QAC9L,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. */