swarm-engine 1.0.0

package/dist/core/types.d.ts

@@ -0,0 +1,168 @@
+export type ModelTier = 'haiku' | 'sonnet' | 'opus';
+export type AgentStatus = 'registered' | 'spawning' | 'running' | 'idle' | 'shutdown' | 'timeout' | 'error';
+export interface AgentConfig {
+    name: string;
+    description: string;
+    prompt: string;
+    model: ModelTier;
+    backend?: string;
+    backendModel?: string;
+    permissionProfile?: string;
+    mcp?: string[];
+    worktree?: boolean;
+    tools?: string[];
+    disallowedTools?: string[];
+    maxTurns?: number;
+    maxConcurrent?: number;
+    timeout?: number;
+    costBudget?: number;
+    tags?: string[];
+    promptTier?: 'full' | 'lite' | 'minimal';
+    outputFormat?: 'free' | 'structured';
+}
+export interface AgentInstance {
+    id: string;
+    config: AgentConfig;
+    status: AgentStatus;
+    startedAt?: Date;
+    completedAt?: Date;
+    usage: UsageStats;
+    result?: AgentResult;
+    error?: string;
+}
+export interface AgentResult {
+    output: string;
+    confidence: 'high' | 'medium' | 'low';
+    blockers: string[];
+    filesTouched: string[];
+}
+export interface UsageStats {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    costUsd: number;
+    turns: number;
+    toolCalls: number;
+    durationMs: number;
+}
+export type PhaseStatus = 'pending' | 'blocked' | 'running' | 'completed' | 'failed' | 'skipped';
+export interface PhaseConfig {
+    name: string;
+    agents: AgentAssignment[];
+    parallel: boolean;
+    dependsOn?: string[];
+    requiresApproval?: boolean;
+    timeout?: number;
+    retryOnFailure?: boolean;
+    maxRetries?: number;
+    tokenBudget?: number;
+}
+export interface AgentAssignment {
+    name: string;
+    type: string;
+    model?: ModelTier;
+    prompt?: string;
+    worktree?: boolean;
+    backend?: string;
+    backendModel?: string;
+}
+export interface PhaseInstance {
+    config: PhaseConfig;
+    status: PhaseStatus;
+    agents: AgentInstance[];
+    startedAt?: Date;
+    completedAt?: Date;
+    usage: UsageStats;
+}
+export type OrchestrationStatus = 'planning' | 'pending' | 'running' | 'paused' | 'completed' | 'failed' | 'cancelled';
+export interface OrchestrationConfig {
+    id: string;
+    name: string;
+    description: string;
+    pattern: string;
+    phases: PhaseConfig[];
+    costBudget?: number;
+    timeout?: number;
+}
+export interface OrchestrationInstance {
+    config: OrchestrationConfig;
+    status: OrchestrationStatus;
+    phases: PhaseInstance[];
+    currentPhase: number;
+    startedAt?: Date;
+    completedAt?: Date;
+    usage: UsageStats;
+    checkpoint?: OrchestrationCheckpoint;
+}
+export interface OrchestrationCheckpoint {
+    phaseIndex: number;
+    phaseResults: Map<string, PhaseInstance>;
+    savedAt: Date;
+}
+export type EventType = 'orchestration:start' | 'orchestration:phase-start' | 'orchestration:phase-complete' | 'orchestration:complete' | 'orchestration:failed' | 'orchestration:paused' | 'orchestration:resumed' | 'agent:spawning' | 'agent:running' | 'agent:idle' | 'agent:shutdown' | 'agent:timeout' | 'agent:error' | 'agent:tool-use' | 'agent:finding' | 'agent:progress' | 'memory:store' | 'memory:query' | 'agent:doom-loop' | 'agent:snapshot-created' | 'agent:snapshot-rolled-back' | 'mcp:connected' | 'mcp:tool-called' | 'plugin:loaded' | 'worktree:created' | 'worktree:merged' | 'system:error' | 'system:warning';
+export interface SwarmEvent<T = unknown> {
+    id: string;
+    type: EventType;
+    timestamp: Date;
+    source: string;
+    data: T;
+}
+export interface PatternConfig {
+    name: string;
+    description: string;
+    phases: PhaseConfig[];
+    parameters?: Record<string, PatternParameter>;
+}
+export interface PatternParameter {
+    type: 'string' | 'number' | 'boolean' | 'model';
+    description: string;
+    default?: unknown;
+    required?: boolean;
+}
+export interface ExecutionPlan {
+    id: string;
+    name: string;
+    task: string;
+    pattern: string;
+    phases: PlannedPhase[];
+    costBudget?: number;
+    createdAt: string;
+    estimates?: {
+        totalTokens: number;
+        costUsd: number;
+        estimatedDurationMs: number;
+        qualityScore: number;
+    };
+    rewrites?: string[];
+    _alternatives?: Array<{
+        source: string;
+        costUsd: number;
+        quality: number;
+    }>;
+}
+export interface PlannedPhase {
+    name: string;
+    agents: PlannedAgent[];
+    parallel: boolean;
+    dependsOn?: string[];
+    requiresApproval?: boolean;
+    tokenBudget?: number;
+}
+export interface PlannedAgent {
+    name: string;
+    type: string;
+    model: string;
+    backend?: string;
+    prompt: string;
+    permissionProfile?: string;
+    worktree?: boolean;
+}
+export declare function emptyUsageStats(): UsageStats;
+/**
+ * Merge two UsageStats by summing all fields.
+ * Note: durationMs is summed (agent CPU time), not max (wall-clock).
+ * For parallel phases, the merged durationMs will exceed wall-clock time.
+ */
+export declare function mergeUsageStats(a: UsageStats, b: UsageStats): UsageStats;
+export declare function generateId(): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

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

package/dist/core/types.js

@@ -0,0 +1,33 @@
+import { randomUUID } from 'crypto';
+// ─── Utility ───────────────────────────────────────────────────────
+export function emptyUsageStats() {
+    return {
+        inputTokens: 0,
+        outputTokens: 0,
+        totalTokens: 0,
+        costUsd: 0,
+        turns: 0,
+        toolCalls: 0,
+        durationMs: 0,
+    };
+}
+/**
+ * Merge two UsageStats by summing all fields.
+ * Note: durationMs is summed (agent CPU time), not max (wall-clock).
+ * For parallel phases, the merged durationMs will exceed wall-clock time.
+ */
+export function mergeUsageStats(a, b) {
+    return {
+        inputTokens: a.inputTokens + b.inputTokens,
+        outputTokens: a.outputTokens + b.outputTokens,
+        totalTokens: a.totalTokens + b.totalTokens,
+        costUsd: a.costUsd + b.costUsd,
+        turns: a.turns + b.turns,
+        toolCalls: a.toolCalls + b.toolCalls,
+        durationMs: a.durationMs + b.durationMs,
+    };
+}
+export function generateId() {
+    return randomUUID();
+}
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AA8OpC,sEAAsE;AAEtE,MAAM,UAAU,eAAe;IAC7B,OAAO;QACL,WAAW,EAAE,CAAC;QACd,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,CAAC;QACd,OAAO,EAAE,CAAC;QACV,KAAK,EAAE,CAAC;QACR,SAAS,EAAE,CAAC;QACZ,UAAU,EAAE,CAAC;KACd,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,CAAa,EAAE,CAAa;IAC1D,OAAO;QACL,WAAW,EAAE,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW;QAC1C,YAAY,EAAE,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY;QAC7C,WAAW,EAAE,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW;QAC1C,OAAO,EAAE,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO;QAC9B,KAAK,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK;QACxB,SAAS,EAAE,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS;QACpC,UAAU,EAAE,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU;KACxC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,UAAU,EAAE,CAAC;AACtB,CAAC"}

package/dist/hooks/cli.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * Claude Code hook handler — reads JSON from stdin, handles agent lifecycle.
+ * Replaces swarm-hook-start.sh and swarm-hook-stop.sh.
+ *
+ * Usage in hooks config:
+ *   "command": "node <swarm-engine-dir>/dist/hooks/cli.js start"
+ *   "command": "node <swarm-engine-dir>/dist/hooks/cli.js stop"
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/hooks/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/hooks/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG"}

package/dist/hooks/cli.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+/**
+ * Claude Code hook handler — reads JSON from stdin, handles agent lifecycle.
+ * Replaces swarm-hook-start.sh and swarm-hook-stop.sh.
+ *
+ * Usage in hooks config:
+ *   "command": "node <swarm-engine-dir>/dist/hooks/cli.js start"
+ *   "command": "node <swarm-engine-dir>/dist/hooks/cli.js stop"
+ */
+import { onAgentStart, onAgentStop, parseHookInput } from './index.js';
+async function main() {
+    const mode = process.argv[2] ?? 'start';
+    // Read JSON from stdin
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(chunk);
+    }
+    const input = parseHookInput(Buffer.concat(chunks).toString('utf-8'));
+    if (mode === 'start') {
+        onAgentStart(input);
+    }
+    else if (mode === 'stop') {
+        onAgentStop(input);
+    }
+    // Return empty JSON (hook success)
+    console.log('{}');
+}
+main().catch(() => {
+    console.log('{}');
+    process.exit(0); // Don't block Claude Code on hook errors
+});
+//# sourceMappingURL=cli.js.map

package/dist/hooks/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/hooks/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEvE,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC;IAExC,uBAAuB;IACvB,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,KAAe,CAAC,CAAC;IAC/B,CAAC;IACD,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAEtE,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;SAAM,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QAC3B,WAAW,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IAED,mCAAmC;IACnC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACpB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;IAChB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,yCAAyC;AAC5D,CAAC,CAAC,CAAC"}

package/dist/hooks/index.d.ts

@@ -0,0 +1,23 @@
+export interface HookInput {
+    agent_name?: string;
+    agent_type?: string;
+    agent_id?: string;
+    team_name?: string;
+    hook_event_name?: string;
+    tool_name?: string;
+    [key: string]: unknown;
+}
+/**
+ * Handle SubagentStart event.
+ * Terminal-agnostic: uses standard ANSI codes that work everywhere.
+ */
+export declare function onAgentStart(input: HookInput): void;
+/**
+ * Handle SubagentStop event.
+ */
+export declare function onAgentStop(input: HookInput): void;
+/**
+ * Parse hook input from stdin JSON.
+ */
+export declare function parseHookInput(jsonStr: string): HookInput;
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,SAAS;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAoCnD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAGlD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAMzD"}

package/dist/hooks/index.js

@@ -0,0 +1,58 @@
+import { Logger } from '../utils/logger.js';
+const logger = new Logger('hooks', 'info');
+/**
+ * Handle SubagentStart event.
+ * Terminal-agnostic: uses standard ANSI codes that work everywhere.
+ */
+export function onAgentStart(input) {
+    // Sanitize inputs — strip control characters to prevent escape sequence injection
+    const sanitize = (s) => s.replace(/[\x00-\x1f\x7f]/g, '');
+    const name = sanitize(String(input.agent_name ?? input.agent_id ?? 'agent'));
+    const type = sanitize(String(input.agent_type ?? 'unknown'));
+    // Set terminal title (works in most terminals via ANSI)
+    process.stdout.write(`\x1b]0;${name} [${type}]\x07`);
+    // Print banner using standard ANSI (no iTerm2-specific codes)
+    const colors = {
+        researcher: '\x1b[34m', // blue
+        implementer: '\x1b[32m', // green
+        reviewer: '\x1b[33m', // yellow
+        tester: '\x1b[35m', // magenta
+        debugger: '\x1b[31m', // red
+        planner: '\x1b[36m', // cyan
+        'devils-advocate': '\x1b[31m', // red
+        documenter: '\x1b[37m', // white
+        grounding: '\x1b[36m', // cyan
+        sentinel: '\x1b[34m', // blue
+        guardian: '\x1b[32m', // green
+        librarian: '\x1b[35m', // magenta
+        integrator: '\x1b[35m', // magenta
+        refactorer: '\x1b[32m', // green
+        orchestrator: '\x1b[33m', // yellow
+    };
+    const color = colors[type] ?? '\x1b[37m';
+    const reset = '\x1b[0m';
+    const bold = '\x1b[1m';
+    console.log();
+    console.log(`${color}${bold}  ${type.toUpperCase()}${reset}`);
+    console.log(`${color}  ${name}${reset}`);
+    console.log();
+}
+/**
+ * Handle SubagentStop event.
+ */
+export function onAgentStop(input) {
+    // Reset terminal title
+    process.stdout.write(`\x1b]0;\x07`);
+}
+/**
+ * Parse hook input from stdin JSON.
+ */
+export function parseHookInput(jsonStr) {
+    try {
+        return JSON.parse(jsonStr);
+    }
+    catch {
+        return {};
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAY3C;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,KAAgB;IAC3C,kFAAkF;IAClF,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;IAClE,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC;IAC7E,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,IAAI,SAAS,CAAC,CAAC,CAAC;IAE7D,wDAAwD;IACxD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,IAAI,KAAK,IAAI,OAAO,CAAC,CAAC;IAErD,8DAA8D;IAC9D,MAAM,MAAM,GAA2B;QACrC,UAAU,EAAE,UAAU,EAAK,OAAO;QAClC,WAAW,EAAE,UAAU,EAAI,QAAQ;QACnC,QAAQ,EAAE,UAAU,EAAO,SAAS;QACpC,MAAM,EAAE,UAAU,EAAS,UAAU;QACrC,QAAQ,EAAE,UAAU,EAAO,MAAM;QACjC,OAAO,EAAE,UAAU,EAAQ,OAAO;QAClC,iBAAiB,EAAE,UAAU,EAAE,MAAM;QACrC,UAAU,EAAE,UAAU,EAAK,QAAQ;QACnC,SAAS,EAAE,UAAU,EAAM,OAAO;QAClC,QAAQ,EAAE,UAAU,EAAO,OAAO;QAClC,QAAQ,EAAE,UAAU,EAAO,QAAQ;QACnC,SAAS,EAAE,UAAU,EAAK,UAAU;QACpC,UAAU,EAAE,UAAU,EAAI,UAAU;QACpC,UAAU,EAAE,UAAU,EAAI,QAAQ;QAClC,YAAY,EAAE,UAAU,EAAE,SAAS;KACpC,CAAC;IAEF,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC;IACzC,MAAM,KAAK,GAAG,SAAS,CAAC;IACxB,MAAM,IAAI,GAAG,SAAS,CAAC;IAEvB,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,GAAG,IAAI,KAAK,IAAI,CAAC,WAAW,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IAC9D,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,EAAE,CAAC,CAAC;IACzC,OAAO,CAAC,GAAG,EAAE,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAgB;IAC1C,uBAAuB;IACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAc,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,82 @@
+export { SwarmEngine } from './runtime/engine.js';
+export { AgentRegistry } from './core/registry.js';
+export { EventBus } from './core/event-bus.js';
+export { PatternRegistry } from './core/patterns.js';
+export { saveCheckpoint, loadCheckpoint, listCheckpoints } from './core/checkpoint.js';
+export * from './core/types.js';
+export { generatePlugin } from './plugin/index.js';
+export { onAgentStart, onAgentStop, parseHookInput } from './hooks/index.js';
+export { BackendRegistry } from './runtime/backends/index.js';
+export type { ExecutionBackend, BackendName, BackendOptions, BackendResult } from './runtime/backends/types.js';
+export { detectTerminal, setTitle, notify, supportsColor, isCI } from './utils/terminal.js';
+export { PermissionChecker, DoomLoopDetector, DEFAULT_PROFILES } from './core/permissions.js';
+export type { PermissionProfile, PermissionRule, PermissionAction } from './core/permissions.js';
+export { SnapshotManager } from './core/snapshots.js';
+export type { Snapshot } from './core/snapshots.js';
+export { CompactionManager, DEFAULT_COMPACTION } from './runtime/compaction.js';
+export type { CompactionConfig } from './runtime/compaction.js';
+export { ContextDistiller, DEFAULT_DISTILLER } from './runtime/distiller.js';
+export type { DistillerConfig } from './runtime/distiller.js';
+export { generateReport } from './runtime/sharing.js';
+export type { ReportFormat, ReportOptions, ShareResult } from './runtime/sharing.js';
+export { PluginLoader } from './runtime/plugins.js';
+export type { SwarmPlugin, PluginTool, PluginManifest, PluginHooks } from './runtime/plugins.js';
+export { WorktreeManager } from './runtime/worktree.js';
+export type { WorktreeInfo } from './runtime/worktree.js';
+export { PaneManager } from './runtime/panes.js';
+export type { PaneInfo } from './runtime/panes.js';
+export { MCPClient } from './runtime/mcp.js';
+export type { MCPServerConfig, MCPTool } from './runtime/mcp.js';
+export { LSPClient } from './runtime/lsp.js';
+export type { LSPServerConfig, Diagnostic, HoverInfo, Definition } from './runtime/lsp.js';
+export { ACPServer } from './runtime/acp.js';
+export { Dashboard } from './tui/dashboard.js';
+export { ProgressRenderer } from './tui/progress.js';
+export type { ACPServerOptions, ACPSession, ACPMessage } from './runtime/acp.js';
+export { VercelAIBackend } from './runtime/backends/vercel-ai.js';
+export { loadProjectConfig, getProjectName } from './utils/project-config.js';
+export type { ProjectConfig } from './utils/project-config.js';
+export { estimateTokens } from './utils/tokens.js';
+export { StatsCollector } from './runtime/stats.js';
+export type { AgentStats } from './runtime/stats.js';
+export { ModelRouter } from './runtime/model-router.js';
+export type { ModelScore } from './runtime/model-router.js';
+export { AutonomyTracker } from './runtime/autonomy.js';
+export type { AutonomyLevel, AutonomyProfile } from './runtime/autonomy.js';
+export { Verifier, ContinuousVerifier } from './runtime/verifier.js';
+export type { VerificationResult, VerifierConfig, VerificationCommand } from './runtime/verifier.js';
+export { rewritePlan } from './runtime/rewriter.js';
+export type { RewriteResult } from './runtime/rewriter.js';
+export { CostModel } from './runtime/cost-model.js';
+export type { PlanCost } from './runtime/cost-model.js';
+export { PlanSearcher } from './runtime/plan-search.js';
+export type { PlanCandidate, SearchConfig } from './runtime/plan-search.js';
+export { AdaptiveReplanner } from './runtime/adaptive.js';
+export type { PlanAdaptation, DropoutDecision } from './runtime/adaptive.js';
+export { toCompact, fromCompact, estimateSavings as estimateCompactSavings } from './utils/compact-format.js';
+export type { StructuredResult } from './utils/compact-format.js';
+export { ReflectionEngine } from './runtime/reflexion.js';
+export type { Reflection } from './runtime/reflexion.js';
+export { TraceStore, traceToMemoryEntries } from './runtime/traces.js';
+export type { ExecutionTrace, TracePhase } from './runtime/traces.js';
+export { HeuristicStore } from './runtime/heuristics.js';
+export type { Heuristic } from './runtime/heuristics.js';
+export { KnowledgeCompounder, PROBLEM_CATEGORIES } from './runtime/compounder.js';
+export type { SolutionDoc, ProblemCategory } from './runtime/compounder.js';
+export { TemplateRegistry, validateParameters, resolveTemplate, extractTemplateFromTrace, saveTemplate } from './runtime/templates.js';
+export type { TemplateConfig, TemplateParameter, TemplateAgentOverride, TemplateVerification, ValidationResult } from './runtime/templates.js';
+export { optimizeForCache, estimateCacheSavings } from './runtime/cache-optimizer.js';
+export type { CacheOptimizedPrompt } from './runtime/cache-optimizer.js';
+export { classifyTaskComplexity, selectStartingTier, getNextTier, shouldEscalate, DEFAULT_CASCADE } from './runtime/cascade.js';
+export type { CascadeConfig } from './runtime/cascade.js';
+export { createLivingSpec, updateSpecFromPhase, formatLivingSpec } from './runtime/living-spec.js';
+export type { LivingSpec } from './runtime/living-spec.js';
+export { CodeChunker } from './runtime/chunker.js';
+export type { CodeChunk } from './runtime/chunker.js';
+export { AgentFrontmatterSchema, TemplateConfigSchema } from './utils/schemas.js';
+export { formatError, didYouMean } from './utils/errors.js';
+export type { SmartError } from './utils/errors.js';
+export { setOutputMode, isJsonMode, isQuietMode, print, printJson, printDim } from './utils/output.js';
+export { parseReviewOutput, applyConfidenceGate, evaluateGate, summarizeFindings, formatFindings, DEFAULT_GATE_CONFIG } from './runtime/review-schema.js';
+export type { ReviewFinding, ReviewReport, ReviewSummary, ReviewGateConfig, Severity, AutofixClass } from './runtime/review-schema.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,49 @@
+export { SwarmEngine } from './runtime/engine.js';
+export { AgentRegistry } from './core/registry.js';
+export { EventBus } from './core/event-bus.js';
+export { PatternRegistry } from './core/patterns.js';
+export { saveCheckpoint, loadCheckpoint, listCheckpoints } from './core/checkpoint.js';
+export * from './core/types.js';
+export { generatePlugin } from './plugin/index.js';
+export { onAgentStart, onAgentStop, parseHookInput } from './hooks/index.js';
+export { BackendRegistry } from './runtime/backends/index.js';
+export { detectTerminal, setTitle, notify, supportsColor, isCI } from './utils/terminal.js';
+export { PermissionChecker, DoomLoopDetector, DEFAULT_PROFILES } from './core/permissions.js';
+export { SnapshotManager } from './core/snapshots.js';
+export { CompactionManager, DEFAULT_COMPACTION } from './runtime/compaction.js';
+export { ContextDistiller, DEFAULT_DISTILLER } from './runtime/distiller.js';
+export { generateReport } from './runtime/sharing.js';
+export { PluginLoader } from './runtime/plugins.js';
+export { WorktreeManager } from './runtime/worktree.js';
+export { PaneManager } from './runtime/panes.js';
+export { MCPClient } from './runtime/mcp.js';
+export { LSPClient } from './runtime/lsp.js';
+export { ACPServer } from './runtime/acp.js';
+export { Dashboard } from './tui/dashboard.js';
+export { ProgressRenderer } from './tui/progress.js';
+export { VercelAIBackend } from './runtime/backends/vercel-ai.js';
+export { loadProjectConfig, getProjectName } from './utils/project-config.js';
+export { estimateTokens } from './utils/tokens.js';
+export { StatsCollector } from './runtime/stats.js';
+export { ModelRouter } from './runtime/model-router.js';
+export { AutonomyTracker } from './runtime/autonomy.js';
+export { Verifier, ContinuousVerifier } from './runtime/verifier.js';
+export { rewritePlan } from './runtime/rewriter.js';
+export { CostModel } from './runtime/cost-model.js';
+export { PlanSearcher } from './runtime/plan-search.js';
+export { AdaptiveReplanner } from './runtime/adaptive.js';
+export { toCompact, fromCompact, estimateSavings as estimateCompactSavings } from './utils/compact-format.js';
+export { ReflectionEngine } from './runtime/reflexion.js';
+export { TraceStore, traceToMemoryEntries } from './runtime/traces.js';
+export { HeuristicStore } from './runtime/heuristics.js';
+export { KnowledgeCompounder, PROBLEM_CATEGORIES } from './runtime/compounder.js';
+export { TemplateRegistry, validateParameters, resolveTemplate, extractTemplateFromTrace, saveTemplate } from './runtime/templates.js';
+export { optimizeForCache, estimateCacheSavings } from './runtime/cache-optimizer.js';
+export { classifyTaskComplexity, selectStartingTier, getNextTier, shouldEscalate, DEFAULT_CASCADE } from './runtime/cascade.js';
+export { createLivingSpec, updateSpecFromPhase, formatLivingSpec } from './runtime/living-spec.js';
+export { CodeChunker } from './runtime/chunker.js';
+export { AgentFrontmatterSchema, TemplateConfigSchema } from './utils/schemas.js';
+export { formatError, didYouMean } from './utils/errors.js';
+export { setOutputMode, isJsonMode, isQuietMode, print, printJson, printDim } from './utils/output.js';
+export { parseReviewOutput, applyConfidenceGate, evaluateGate, summarizeFindings, formatFindings, DEFAULT_GATE_CONFIG } from './runtime/review-schema.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/memory/index.d.ts

@@ -0,0 +1,105 @@
+export interface MemoryEntry {
+    id?: number;
+    type: 'decision' | 'pattern' | 'learning' | 'context' | 'outcome';
+    title: string;
+    content: string;
+    tags?: string[];
+    repo?: string;
+    source?: string;
+}
+export interface SearchResult {
+    id: number;
+    type: string;
+    title: string;
+    content: string;
+    tags: string[];
+    repo: string | null;
+    rank: number;
+    snippet: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface Relation {
+    fromId: number;
+    toId: number;
+    type: string;
+}
+/**
+ * Swarm Memory — queryable knowledge base backed by SQLite.
+ *
+ * Replaces the flat markdown vault with:
+ * - Full-text search (FTS5)
+ * - Typed entries (decisions, patterns, learnings, context, outcomes)
+ * - Graph relations between entries
+ * - Per-repo filtering
+ */
+export declare class SwarmMemory {
+    private db;
+    private vaultDir;
+    constructor(dbPath?: string, vaultDir?: string);
+    /**
+     * Store a new knowledge entry.
+     */
+    store(entry: MemoryEntry): number;
+    /**
+     * Update an existing entry.
+     */
+    update(id: number, updates: Partial<MemoryEntry>): void;
+    /**
+     * Delete an entry.
+     */
+    delete(id: number): void;
+    /**
+     * Write-through to Obsidian vault. Every entry stored in SQLite is also
+     * written as a markdown file to ~/swarm-vault/ for:
+     * - Cross-machine sync via Obsidian Sync
+     * - Human browsing in Obsidian
+     * - Backward compatibility with vault scripts
+     */
+    private syncToVault;
+    private slugify;
+    /**
+     * Full-text search across all entries.
+     */
+    search(query: string, options?: {
+        type?: string;
+        repo?: string;
+        limit?: number;
+    }): SearchResult[];
+    /**
+     * Get an entry by ID.
+     */
+    get(id: number): MemoryEntry | null;
+    /**
+     * List entries by type and/or repo.
+     */
+    list(options?: {
+        type?: string;
+        repo?: string;
+        limit?: number;
+    }): MemoryEntry[];
+    /**
+     * Add a relation between two entries.
+     */
+    relate(fromId: number, toId: number, type: string): void;
+    /**
+     * Get related entries.
+     */
+    getRelated(id: number, type?: string): Array<{
+        entry: MemoryEntry;
+        relation: string;
+    }>;
+    /**
+     * Get memory statistics.
+     */
+    stats(): {
+        total: number;
+        byType: Record<string, number>;
+        byRepo: Record<string, number>;
+    };
+    /**
+     * Close the database.
+     */
+    close(): void;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;GAQG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,QAAQ,CAAgB;gBAEpB,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;IAiB9C;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM;IAuBjC;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;IAiBvD;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAMxB;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;IAoDnB,OAAO,CAAC,OAAO;IAUf;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,YAAY,EAAE;IAkDjG;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAenC;;OAEG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,WAAW,EAAE;IAwB/E;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAMxD;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,KAAK,EAAE,WAAW,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IA2BtF;;OAEG;IACH,KAAK,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE;IAkB1F;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}