agent-nuvira 1.14.0

package/dist/agents/orchestrator.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Orchestrator — The central coordinator of the multi-agent system.
+ *
+ * Responsibilities:
+ * 1. Accept a user goal and optionally a provider/model config
+ * 2. Create a ContextVault (shared context bus)
+ * 3. Build the project file tree and inject it for the Planner
+ * 4. Optionally retrieve memory context from past similar trajectories
+ * 5. Run the PlannerAgent to produce an execution plan
+ * 6. Execute tasks sequentially, respecting dependencies
+ * 7. Spawn the appropriate agent for each task
+ * 8. Apply file changes to disk
+ * 9. Execute runner commands and capture output
+ * 10. Optionally store the trajectory in memory
+ * 11. Synthesize and return the final result
+ *
+ * Called by the `agent-nuvira execute` CLI command.
+ */
+import { ConfigManager } from '../config/manager.js';
+import type { TaskStep } from './agent.js';
+/** Configuration for an orchestration session */
+export interface OrchestratorOptions {
+    /** Inference provider type (default: from configManager) */
+    provider?: string;
+    /** Model override (default: from provider config) */
+    model?: string;
+    /** Whether to write files to disk (false = dry-run) */
+    dryRun?: boolean;
+    /** Enable verbose logging */
+    verbose?: boolean;
+    /** Agent-specific model overrides */
+    agentModels?: Partial<Record<string, string>>;
+    /** Enable persistent memory (trajectory storage and retrieval) */
+    useMemory?: boolean;
+    /** Auto-create a review bundle instead of applying changes directly */
+    reviewMode?: boolean;
+    /** Auto-route each agent to its recommended model from the ModelRouter */
+    autoRouteModels?: boolean;
+    /** Pre-built task plan to use instead of calling the PlannerAgent (for workflow templates) */
+    prefillPlan?: TaskStep[];
+    /**
+     * Optional spinner reference from the CLI caller.
+     * When set, the orchestrator stops the spinner before showing interactive
+     * rate-limit prompts and restarts it after the user responds.
+     */
+    spinner?: {
+        stop(): void;
+        start(text?: string): void;
+    };
+}
+/** The final result of an orchestration session */
+export interface OrchestrationResult {
+    /** Overall success */
+    success: boolean;
+    /** The original user goal */
+    goal: string;
+    /** Summary of what was accomplished */
+    summary: string;
+    /** Number of tasks completed vs total */
+    tasksCompleted: number;
+    tasksTotal: number;
+    /** Detailed results from each agent */
+    agentResults: Array<{
+        agent: string;
+        success: boolean;
+        summary: string;
+    }>;
+    /** File change summary */
+    fileChanges: string;
+    /** Runner output (from executed commands) */
+    runOutput?: string;
+    /** Error message if failed */
+    error?: string;
+    /** Memory trajectory ID if stored */
+    trajectoryId?: string;
+    /** Review bundle ID if review mode was enabled */
+    reviewId?: string;
+}
+export declare class Orchestrator {
+    private configManager;
+    constructor(configManager?: ConfigManager);
+    /**
+     * Execute a multi-agent pipeline for the given goal.
+     */
+    execute(goal: string, options?: OrchestratorOptions): Promise<OrchestrationResult>;
+    private createLLMProvider;
+    private runAgent;
+    /**
+     * Create the onRateLimit callback that prompts the user.
+     * Returns undefined if we're in non-interactive mode (no TTY or dry-run).
+     */
+    private createRateLimitHandler;
+    private executeSingleTask;
+    private applyFileChanges;
+    private buildResult;
+}
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/agents/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/agents/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAOH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAOrD,OAAO,KAAK,EAA0B,QAAQ,EAAe,MAAM,YAAY,CAAC;AA8DhF,iDAAiD;AACjD,MAAM,WAAW,mBAAmB;IAClC,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qCAAqC;IACrC,WAAW,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9C,kEAAkE;IAClE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uEAAuE;IACvE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,0EAA0E;IAC1E,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,8FAA8F;IAC9F,WAAW,CAAC,EAAE,QAAQ,EAAE,CAAC;IACzB;;;;OAIG;IACH,OAAO,CAAC,EAAE;QACR,IAAI,IAAI,IAAI,CAAC;QACb,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC5B,CAAC;CACH;AAED,mDAAmD;AACnD,MAAM,WAAW,mBAAmB;IAClC,sBAAsB;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,YAAY,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1E,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAoDD,qBAAa,YAAY;IACvB,OAAO,CAAC,aAAa,CAAgB;gBAEzB,aAAa,CAAC,EAAE,aAAa;IAIzC;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAkU5F,OAAO,CAAC,iBAAiB;YA6BX,QAAQ;IActB;;;OAGG;IACH,OAAO,CAAC,sBAAsB;YAkGhB,iBAAiB;IAmJ/B,OAAO,CAAC,gBAAgB;IAqBxB,OAAO,CAAC,WAAW;CAuBpB"}