@nex-ai/nex 0.1.21 → 0.1.23

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

@@ -0,0 +1,42 @@
+/**
+ * TUI service layer for multi-agent orchestration.
+ * Wraps BudgetTracker, TaskRouter, OrchestratorExecutor, and workflow
+ * templates into a single facade the orchestration view can consume.
+ */
+import type { GoalDefinition, TaskDefinition, OrchestratorConfig, BudgetSnapshot, SkillDeclaration } from '../../orchestration/types.js';
+export declare class OrchestrationService {
+    private executor;
+    private budget;
+    private router;
+    private goals;
+    private tasks;
+    private listeners;
+    constructor(config?: Partial<OrchestratorConfig>);
+    createGoal(title: string, description: string): GoalDefinition;
+    getGoals(): GoalDefinition[];
+    createTask(task: Omit<TaskDefinition, 'id' | 'createdAt' | 'status'>): TaskDefinition;
+    getTasks(goalId?: string): TaskDefinition[];
+    getActiveTasks(): TaskDefinition[];
+    instantiateWorkflow(templateName: string): {
+        goal: GoalDefinition;
+        tasks: TaskDefinition[];
+    };
+    getTemplateNames(): string[];
+    registerAgentSkills(agentSlug: string, skills: SkillDeclaration[]): void;
+    findBestAgentForTask(taskId: string): {
+        agentSlug: string;
+        score: number;
+    } | null;
+    getBudgetSnapshots(): BudgetSnapshot[];
+    getGlobalBudget(): {
+        tokens: number;
+        cost: number;
+        percentTokens: number;
+        percentCost: number;
+    };
+    submitTask(taskId: string): Promise<void>;
+    stopAll(): Promise<void>;
+    subscribe(listener: () => void): () => void;
+    private notify;
+}
+export declare function getOrchestrationService(): OrchestrationService;

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

@@ -0,0 +1,153 @@
+/**
+ * TUI service layer for multi-agent orchestration.
+ * Wraps BudgetTracker, TaskRouter, OrchestratorExecutor, and workflow
+ * templates into a single facade the orchestration view can consume.
+ */
+import { randomUUID } from 'node:crypto';
+import { BudgetTracker } from '../../orchestration/budget.js';
+import { TaskRouter } from '../../orchestration/router.js';
+import { OrchestratorExecutor } from '../../orchestration/executor.js';
+import { workflows } from '../../orchestration/templates.js';
+const DEFAULT_CONFIG = {
+    maxConcurrentAgents: 3,
+    globalBudget: { maxTokens: 100_000, maxCostUsd: 0.5 },
+    taskTimeout: 5 * 60 * 1000, // 5 minutes
+    autoRetry: true,
+    maxRetries: 2,
+};
+export class OrchestrationService {
+    executor;
+    budget;
+    router;
+    goals = new Map();
+    tasks = new Map();
+    listeners = [];
+    constructor(config) {
+        const merged = { ...DEFAULT_CONFIG, ...config };
+        this.executor = new OrchestratorExecutor(merged);
+        this.budget = new BudgetTracker(merged.globalBudget);
+        this.router = new TaskRouter();
+    }
+    // ── Goal management ──
+    createGoal(title, description) {
+        const goal = {
+            id: randomUUID(),
+            title,
+            description,
+            tasks: [],
+            status: 'active',
+            createdAt: Date.now(),
+        };
+        this.goals.set(goal.id, goal);
+        this.notify();
+        return goal;
+    }
+    getGoals() {
+        return [...this.goals.values()];
+    }
+    // ── Task management ──
+    createTask(task) {
+        const full = {
+            ...task,
+            id: randomUUID(),
+            status: 'pending',
+            createdAt: Date.now(),
+        };
+        this.tasks.set(full.id, full);
+        // Link to parent goal if specified
+        if (full.parentGoalId) {
+            const goal = this.goals.get(full.parentGoalId);
+            if (goal) {
+                goal.tasks.push(full.id);
+            }
+        }
+        this.notify();
+        return full;
+    }
+    getTasks(goalId) {
+        const all = [...this.tasks.values()];
+        if (goalId) {
+            const goal = this.goals.get(goalId);
+            if (!goal)
+                return [];
+            const taskIdSet = new Set(goal.tasks);
+            return all.filter((t) => taskIdSet.has(t.id));
+        }
+        return all;
+    }
+    getActiveTasks() {
+        return [...this.tasks.values()].filter((t) => t.status === 'in_progress' || t.status === 'locked');
+    }
+    // ── Workflow templates ──
+    instantiateWorkflow(templateName) {
+        const template = workflows[templateName];
+        if (!template) {
+            throw new Error(`Unknown workflow template: ${templateName}`);
+        }
+        // Create goal from first template goal (templates define one)
+        const goalDef = template.goals[0];
+        const goal = this.createGoal(goalDef.title, goalDef.description);
+        // Create tasks linked to the goal
+        const tasks = template.tasks.map((t) => this.createTask({
+            ...t,
+            parentGoalId: goal.id,
+        }));
+        return { goal, tasks };
+    }
+    getTemplateNames() {
+        return Object.keys(workflows);
+    }
+    // ── Agent routing ──
+    registerAgentSkills(agentSlug, skills) {
+        this.router.registerAgent(agentSlug, skills);
+        this.notify();
+    }
+    findBestAgentForTask(taskId) {
+        const task = this.tasks.get(taskId);
+        if (!task)
+            return null;
+        return this.router.findBestAgent(task);
+    }
+    // ── Budget ──
+    getBudgetSnapshots() {
+        return this.budget.getAllSnapshots();
+    }
+    getGlobalBudget() {
+        return this.budget.getGlobalUsage();
+    }
+    // ── Execution ──
+    async submitTask(taskId) {
+        const task = this.tasks.get(taskId);
+        if (!task)
+            throw new Error(`Task not found: ${taskId}`);
+        await this.executor.submit(task);
+        this.notify();
+    }
+    async stopAll() {
+        await this.executor.stopAll();
+        this.notify();
+    }
+    // ── Subscribe 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 getOrchestrationService() {
+    if (!instance) {
+        instance = new OrchestrationService();
+    }
+    return instance;
+}
+//# sourceMappingURL=orchestration-service.js.map

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

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

package/dist/tui/slash-commands.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Slash command registry for the conversation-first TUI.
+ *
+ * Slash commands (/help, /agents, etc.) are the explicit navigation model.
+ * Natural language input goes to the Pi agent via dispatch("ask ...").
+ */
+import type { ViewEntry } from "./store.js";
+import type { CommandResult } from "../commands/dispatch.js";
+import type { SelectOption } from "./components/inline-select.js";
+export interface SlashCommand {
+    name: string;
+    description: string;
+    usage?: string;
+    execute: (args: string, context: SlashCommandContext) => Promise<SlashCommandResult>;
+}
+export interface SlashCommandContext {
+    push: (view: ViewEntry) => void;
+    dispatch: (input: string) => Promise<CommandResult>;
+    addMessage: (msg: ConversationMessage) => void;
+    setLoading: (loading: boolean, hint?: string) => void;
+    /** Show an arrow-key navigable inline select picker. */
+    showPicker: (title: string, options: SelectOption[], onSelect: (value: string) => void) => void;
+    /** Clear the current picker. */
+    clearPicker: () => void;
+    /** Show an inline y/n confirm prompt. */
+    showConfirm: (question: string, onConfirm: (confirmed: boolean) => void) => void;
+    /** Clear the current confirm prompt. */
+    clearConfirm: () => void;
+}
+export interface SlashCommandResult {
+    output?: string;
+    silent?: boolean;
+}
+export type ConversationMessage = {
+    id: string;
+    role: "user" | "assistant" | "system" | "tool";
+    content: string;
+    timestamp: number;
+    toolName?: string;
+    isError?: boolean;
+    /** When true, MessageBubble shows a trailing cursor block ▌ */
+    isStreaming?: boolean;
+};
+export declare function registerSlashCommand(cmd: SlashCommand): void;
+export declare function getSlashCommand(name: string): SlashCommand | undefined;
+export declare function listSlashCommands(): SlashCommand[];
+/**
+ * Parse raw input to determine if it is a slash command.
+ * Returns `{ isSlash: true, command, args }` for "/foo bar baz",
+ * or `{ isSlash: false }` for everything else.
+ */
+export declare function parseSlashInput(input: string): {
+    isSlash: boolean;
+    command?: string;
+    args?: string;
+};
+export type InitState = {
+    phase: "idle";
+} | {
+    phase: "awaiting_email";
+    loginOnly?: boolean;
+} | {
+    phase: "awaiting_new_email";
+    loginOnly?: boolean;
+} | {
+    phase: "awaiting_agent_prompt";
+};
+export declare function getInitState(): InitState;
+export declare function resetInitState(): void;
+/**
+ * Handle user input when the init flow is awaiting a text response.
+ * Called by the home adapter when `getInitState().phase !== 'idle'`.
+ *
+ * Picker-based choices (regen, agent, template) are now handled via
+ * showPicker callbacks -- only text-input phases remain here.
+ */
+export declare function handleInitInput(input: string, context: SlashCommandContext): Promise<void>;
+export type AgentWizardState = {
+    phase: "idle";
+} | {
+    phase: "agent_create_name";
+} | {
+    phase: "agent_create_expertise";
+    slug: string;
+    name: string;
+} | {
+    phase: "agent_create_describe";
+} | {
+    phase: "agent_edit_name";
+    slug: string;
+} | {
+    phase: "agent_edit_expertise";
+    slug: string;
+};
+export declare function getAgentWizardState(): AgentWizardState;
+export declare function resetAgentWizardState(): void;
+/**
+ * Main entry point for the /agents interactive manager.
+ * Exported so SlackHome can call it from the sidebar `[a]` shortcut.
+ */
+export declare function openAgentsManager(ctx: SlashCommandContext): Promise<void>;
+/**
+ * Handle text input when the agent wizard is awaiting user input.
+ * Called by SlackHome's handleSend when agentWizardState.phase !== "idle".
+ */
+export declare function handleAgentWizardInput(input: string, ctx: SlashCommandContext): Promise<void>;