swarm-engine 1.0.0

package/dist/runtime/distiller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"distiller.js","sourceRoot":"","sources":["../../src/runtime/distiller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AASnD,MAAM,CAAC,MAAM,iBAAiB,GAAoB;IAChD,OAAO,EAAE,IAAI;IACb,cAAc,EAAE,IAAI,EAAQ,aAAa;IACzC,YAAY,EAAE,IAAI,EAAU,YAAY;IACxC,KAAK,EAAE,OAAO;CACf,CAAC;AAEF,MAAM,OAAO,gBAAgB;IACnB,MAAM,CAAkB;IAEhC,YAAY,MAAiC;QAC3C,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,iBAAiB,EAAE,GAAG,MAAM,EAAE,CAAC;IACpD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO,CAAC,YAAsB,EAAE,SAAiB;QACrD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAE3D,MAAM,QAAQ,GAAG,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAC1D,MAAM,WAAW,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;QAE7C,iCAAiC;QACjC,IAAI,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YAC9C,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,4EAA4E;QAC5E,IAAI,CAAC;YACH,MAAM,MAAM,GAAG;;;;;;;;;UASX,IAAI,CAAC,MAAM,CAAC,YAAY;;uBAEX,SAAS;;EAE9B,QAAQ,EAAE,CAAC;YAEP,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;YAC1C,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE;gBAC/C,IAAI,EAAE,MAAM;gBACZ,SAAS,EAAE,2BAA2B;gBACtC,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,GAAG,CAAC,CAAC;gBACpD,YAAY;aACb,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YAE1C,OAAO,mBAAmB,SAAS,MAAM,WAAW,cAAc,cAAc,CAAC,MAAM,CAAC,eAAe,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QACzH,CAAC;QAAC,MAAM,CAAC;YACP,kDAAkD;YAClD,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,GAAG,CAAC,CAAC;YACjD,IAAI,QAAQ,CAAC,MAAM,GAAG,WAAW,EAAE,CAAC;gBAClC,OAAO,mBAAmB,SAAS,QAAQ,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,KAAK,CAAC;YACjF,CAAC;YACD,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,OAAe;QAC3B,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,cAAc,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;IACrF,CAAC;CACF"}

package/dist/runtime/engine.d.ts

@@ -0,0 +1,123 @@
+import { OrchestrationConfig, OrchestrationInstance, ModelTier, ExecutionPlan } from '../core/types.js';
+import { AgentRegistry } from '../core/registry.js';
+import { EventBus } from '../core/event-bus.js';
+import { Logger } from '../utils/logger.js';
+import { PatternRegistry } from '../core/patterns.js';
+import type { PluginLoader } from './plugins.js';
+import type { PaneManager } from './panes.js';
+export interface EngineOptions {
+    registry: AgentRegistry;
+    bus: EventBus;
+    logger: Logger;
+    patterns?: PatternRegistry;
+    cwd?: string;
+    mock?: boolean;
+    nonInteractive?: boolean;
+    permissionMode?: 'default' | 'acceptEdits' | 'bypassPermissions';
+    defaultBackend?: string;
+    permissionProfile?: string;
+    snapshotsEnabled?: boolean;
+    doomLoopDetection?: boolean;
+    worktreeEnabled?: boolean;
+    compactionEnabled?: boolean;
+    distillation?: boolean;
+    paneManager?: PaneManager;
+    pluginLoader?: PluginLoader;
+}
+/**
+ * The Swarm Orchestration Engine.
+ *
+ * Manages the lifecycle of orchestrations — multi-phase workflows
+ * that dispatch parallel agents and manage dependencies between phases.
+ */
+export declare class SwarmEngine {
+    private registry;
+    private bus;
+    private executor;
+    private log;
+    private patterns;
+    private options;
+    private orchestrations;
+    private phaseOutputs;
+    private abortController;
+    private worktreeManager;
+    private compaction;
+    private distiller;
+    private verifier;
+    private costModel;
+    private replanner;
+    private reflectionEngine;
+    private reflections;
+    private traceStore;
+    private heuristicStore;
+    private stats;
+    private modelRouter;
+    private autonomyTracker;
+    private compounder;
+    private signalHandlers;
+    private sharedContextFiles;
+    private livingSpec;
+    constructor(options: EngineOptions);
+    /**
+     * Execute an orchestration from config.
+     */
+    execute(config: OrchestrationConfig): Promise<OrchestrationInstance>;
+    /**
+     * Execute a named pattern with a task description.
+     */
+    runPattern(patternName: string, task: string, options?: {
+        model?: ModelTier;
+        costBudget?: number;
+        params?: Record<string, unknown>;
+    }): Promise<OrchestrationInstance>;
+    /**
+     * Generate a serializable execution plan WITHOUT executing anything.
+     * Useful for previewing what an orchestration will do before running it.
+     */
+    plan(patternName: string, task: string, options?: {
+        model?: ModelTier;
+        costBudget?: number;
+        params?: Record<string, unknown>;
+    }): ExecutionPlan;
+    /**
+     * Execute a single phase.
+     */
+    private executePhase;
+    /**
+     * Execute a single agent within a phase.
+     */
+    private executeAgent;
+    private executeAgentWithRetry;
+    /**
+     * Resume an orchestration from a checkpoint.
+     */
+    resume(orchestrationId: string): Promise<OrchestrationInstance | null>;
+    private requestApproval;
+    /**
+     * Register signal handlers for graceful shutdown.
+     */
+    setupSignalHandlers(): void;
+    removeSignalHandlers(): void;
+    /** Close all resources (stats, traces, heuristics, model router, autonomy tracker). */
+    close(): void;
+    /**
+     * Get an orchestration by ID.
+     */
+    getOrchestration(id: string): OrchestrationInstance | undefined;
+    /**
+     * Get all orchestrations.
+     */
+    getAllOrchestrations(): OrchestrationInstance[];
+    /**
+     * Get active orchestrations.
+     */
+    getActiveOrchestrations(): OrchestrationInstance[];
+    get patternRegistry(): PatternRegistry;
+    /**
+     * Write shared context to a file for parallel agents to read,
+     * avoiding duplicating large context in each agent's prompt.
+     */
+    private writeSharedContext;
+    private createInstance;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/runtime/engine.d.ts.map

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