swarm-engine 1.0.0

package/dist/runtime/backends/vercel-ai.js

@@ -0,0 +1,137 @@
+const TIER_DEFAULTS = {
+    openai: { opus: 'gpt-4o', sonnet: 'gpt-4o-mini', haiku: 'gpt-4o-mini' },
+    anthropic: { opus: 'claude-opus-4-6', sonnet: 'claude-sonnet-4-6', haiku: 'claude-haiku-4-5-20251001' },
+    google: { opus: 'gemini-2.5-pro', sonnet: 'gemini-2.5-flash', haiku: 'gemini-2.5-flash' },
+    mistral: { opus: 'mistral-large-latest', sonnet: 'mistral-medium-latest', haiku: 'mistral-small-latest' },
+    groq: { opus: 'llama-3.3-70b-versatile', sonnet: 'llama-3.1-8b-instant', haiku: 'llama-3.1-8b-instant' },
+    xai: { opus: 'grok-3', sonnet: 'grok-3-mini', haiku: 'grok-3-mini' },
+};
+export class VercelAIBackend {
+    name = 'vercel-ai';
+    description = 'Vercel AI SDK — 20+ LLM providers';
+    providerCache = new Map();
+    async dynamicImport(pkg) {
+        return new Function('pkg', 'return import(pkg)')(pkg);
+    }
+    async isAvailable() {
+        try {
+            await this.dynamicImport('ai');
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async execute(config, task, options) {
+        const { provider: pName, model: mId } = this.resolveModel(config);
+        let generateText;
+        try {
+            const aiModule = await this.dynamicImport('ai');
+            generateText = aiModule.generateText;
+        }
+        catch {
+            throw new Error('Vercel AI SDK not installed. Run: npm install ai');
+        }
+        const provider = await this.getProvider(pName);
+        if (!provider)
+            throw new Error(`Provider "${pName}" not available. Install: npm install @ai-sdk/${pName}`);
+        const fullPrompt = config.prompt ? `${config.prompt}\n\n## Task:\n${task}` : task;
+        const startTime = Date.now();
+        // Build tool definitions if agent has allowed tools
+        const toolDefs = {};
+        if (config.tools && config.tools.length > 0) {
+            const toolSchemas = {
+                'read_file': {
+                    description: 'Read a file from disk',
+                    parameters: { type: 'object', properties: { path: { type: 'string', description: 'File path to read' } }, required: ['path'] },
+                },
+                'write_file': {
+                    description: 'Write content to a file',
+                    parameters: { type: 'object', properties: { path: { type: 'string', description: 'File path' }, content: { type: 'string', description: 'File content' } }, required: ['path', 'content'] },
+                },
+                'run_command': {
+                    description: 'Run a shell command',
+                    parameters: { type: 'object', properties: { command: { type: 'string', description: 'Command to run' } }, required: ['command'] },
+                },
+            };
+            try {
+                const { tool } = await this.dynamicImport('ai');
+                const { z } = await this.dynamicImport('zod');
+                for (const [name, schema] of Object.entries(toolSchemas)) {
+                    if (config.tools.includes('*') || config.tools.some(t => t.toLowerCase().includes(name.split('_')[0]))) {
+                        toolDefs[name] = tool({
+                            description: schema.description,
+                            parameters: z.object(Object.fromEntries(Object.entries(schema.parameters.properties).map(([k, v]) => [k, z.string().describe(v.description)]))),
+                        });
+                    }
+                }
+            }
+            catch {
+                // zod or tool() not available — proceed without tools
+            }
+        }
+        const generateOptions = {
+            model: provider(mId),
+            prompt: fullPrompt,
+            maxTokens: 8192,
+            temperature: 0.1,
+        };
+        // Add tools if we have them
+        if (Object.keys(toolDefs).length > 0) {
+            generateOptions.tools = toolDefs;
+            generateOptions.maxSteps = 10; // Allow multi-turn tool use
+        }
+        const result = await generateText(generateOptions);
+        const durationMs = Date.now() - startTime;
+        const inputTokens = result.usage?.promptTokens ?? 0;
+        const outputTokens = result.usage?.completionTokens ?? 0;
+        const output = result.text ?? '';
+        const toolCalls = result.steps?.reduce((n, s) => n + (s.toolCalls?.length ?? 0), 0) ?? 0;
+        const usage = {
+            inputTokens,
+            outputTokens,
+            totalTokens: inputTokens + outputTokens,
+            costUsd: 0,
+            turns: result.steps?.length ?? 1,
+            toolCalls,
+            durationMs,
+        };
+        return {
+            output,
+            usage,
+            result: { output, confidence: 'medium', blockers: [], filesTouched: [] },
+        };
+    }
+    resolveModel(config) {
+        const bm = config.backendModel;
+        if (bm?.includes('/')) {
+            const [p, ...m] = bm.split('/');
+            return { provider: p, model: m.join('/') };
+        }
+        const pn = bm ?? 'openai';
+        const td = TIER_DEFAULTS[pn];
+        return { provider: pn, model: String(td?.[config.model] ?? td?.sonnet ?? config.model) };
+    }
+    static KNOWN_PROVIDERS = ['openai', 'anthropic', 'google', 'mistral', 'groq', 'xai', 'deepseek', 'cohere', 'together', 'perplexity', 'deepinfra', 'cerebras', 'openrouter'];
+    async getProvider(name) {
+        if (!VercelAIBackend.KNOWN_PROVIDERS.includes(name))
+            return null; // Block unknown provider imports
+        if (this.providerCache.has(name))
+            return this.providerCache.get(name);
+        for (const pkg of [`@ai-sdk/${name}`, `@ai-sdk/${name}-chat`]) {
+            try {
+                const mod = await this.dynamicImport(pkg);
+                const p = mod[name] ?? mod.default ?? mod;
+                if (typeof p === 'function') {
+                    this.providerCache.set(name, p);
+                    return p;
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=vercel-ai.js.map

package/dist/runtime/backends/vercel-ai.js.map

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

package/dist/runtime/cache-optimizer.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Optimizes prompt structure for API cache hits.
+ *
+ * Anthropic: exact prefix match → 90% input cost savings
+ * OpenAI: automatic caching for prompts ≥1024 tokens → 50% savings
+ * Google: explicit context caching API
+ *
+ * Strategy: order prompt sections so shared content comes first (cacheable)
+ * and agent-specific content comes last (not cached).
+ */
+export interface CacheOptimizedPrompt {
+    /** Static prefix shared across agents in same orchestration (cacheable) */
+    sharedPrefix: string;
+    /** Agent-specific suffix (not cached) */
+    agentSuffix: string;
+    /** Combined prompt for execution */
+    full: string;
+}
+/**
+ * Structure a prompt for optimal cache utilization.
+ *
+ * Order: Orchestration context → Shared phase context → Agent definition → Task
+ *
+ * The orchestration context and shared phase context are identical across
+ * parallel agents, so they form the cacheable prefix.
+ */
+export declare function optimizeForCache(orchestrationContext: string, sharedPhaseContext: string, agentDefinition: string, task: string): CacheOptimizedPrompt;
+/**
+ * Estimate cache savings for a set of agents sharing context.
+ */
+export declare function estimateCacheSavings(sharedPrefixTokens: number, agentCount: number, inputPricePerMillion: number): {
+    withoutCache: number;
+    withCache: number;
+    savings: number;
+    savingsPercent: number;
+};
+//# sourceMappingURL=cache-optimizer.d.ts.map

package/dist/runtime/cache-optimizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-optimizer.d.ts","sourceRoot":"","sources":["../../src/runtime/cache-optimizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,oBAAoB;IACnC,2EAA2E;IAC3E,YAAY,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,oBAAoB,EAAE,MAAM,EAC5B,kBAAkB,EAAE,MAAM,EAC1B,eAAe,EAAE,MAAM,EACvB,IAAI,EAAE,MAAM,GACX,oBAAoB,CAkBtB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,kBAAkB,EAAE,MAAM,EAC1B,UAAU,EAAE,MAAM,EAClB,oBAAoB,EAAE,MAAM,GAC3B;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CActF"}

package/dist/runtime/cache-optimizer.js

@@ -0,0 +1,54 @@
+/**
+ * Optimizes prompt structure for API cache hits.
+ *
+ * Anthropic: exact prefix match → 90% input cost savings
+ * OpenAI: automatic caching for prompts ≥1024 tokens → 50% savings
+ * Google: explicit context caching API
+ *
+ * Strategy: order prompt sections so shared content comes first (cacheable)
+ * and agent-specific content comes last (not cached).
+ */
+/**
+ * Structure a prompt for optimal cache utilization.
+ *
+ * Order: Orchestration context → Shared phase context → Agent definition → Task
+ *
+ * The orchestration context and shared phase context are identical across
+ * parallel agents, so they form the cacheable prefix.
+ */
+export function optimizeForCache(orchestrationContext, sharedPhaseContext, agentDefinition, task) {
+    // Shared prefix: identical across all agents in this phase
+    const sharedPrefix = [
+        orchestrationContext,
+        sharedPhaseContext,
+    ].filter(Boolean).join('\n\n');
+    // Agent-specific: varies per agent
+    const agentSuffix = [
+        agentDefinition,
+        task,
+    ].filter(Boolean).join('\n\n');
+    return {
+        sharedPrefix,
+        agentSuffix,
+        full: [sharedPrefix, agentSuffix].filter(Boolean).join('\n\n'),
+    };
+}
+/**
+ * Estimate cache savings for a set of agents sharing context.
+ */
+export function estimateCacheSavings(sharedPrefixTokens, agentCount, inputPricePerMillion) {
+    if (sharedPrefixTokens === 0 || agentCount === 0) {
+        return { withoutCache: 0, withCache: 0, savings: 0, savingsPercent: 0 };
+    }
+    const withoutCache = sharedPrefixTokens * agentCount * (inputPricePerMillion / 1_000_000);
+    // First agent pays full price, subsequent agents get 90% discount (Anthropic)
+    const withCache = sharedPrefixTokens * (inputPricePerMillion / 1_000_000) +
+        sharedPrefixTokens * (agentCount - 1) * (inputPricePerMillion * 0.1 / 1_000_000);
+    return {
+        withoutCache,
+        withCache,
+        savings: withoutCache - withCache,
+        savingsPercent: agentCount > 1 ? Math.round((1 - withCache / withoutCache) * 100) : 0,
+    };
+}
+//# sourceMappingURL=cache-optimizer.js.map

package/dist/runtime/cache-optimizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-optimizer.js","sourceRoot":"","sources":["../../src/runtime/cache-optimizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAWH;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,oBAA4B,EAC5B,kBAA0B,EAC1B,eAAuB,EACvB,IAAY;IAEZ,2DAA2D;IAC3D,MAAM,YAAY,GAAG;QACnB,oBAAoB;QACpB,kBAAkB;KACnB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAE/B,mCAAmC;IACnC,MAAM,WAAW,GAAG;QAClB,eAAe;QACf,IAAI;KACL,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAE/B,OAAO;QACL,YAAY;QACZ,WAAW;QACX,IAAI,EAAE,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;KAC/D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,kBAA0B,EAC1B,UAAkB,EAClB,oBAA4B;IAE5B,IAAI,kBAAkB,KAAK,CAAC,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;QACjD,OAAO,EAAE,YAAY,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;IAC1E,CAAC;IACD,MAAM,YAAY,GAAG,kBAAkB,GAAG,UAAU,GAAG,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAAC;IAC1F,8EAA8E;IAC9E,MAAM,SAAS,GAAG,kBAAkB,GAAG,CAAC,oBAAoB,GAAG,SAAS,CAAC;QACvE,kBAAkB,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,CAAC,oBAAoB,GAAG,GAAG,GAAG,SAAS,CAAC,CAAC;IACnF,OAAO;QACL,YAAY;QACZ,SAAS;QACT,OAAO,EAAE,YAAY,GAAG,SAAS;QACjC,cAAc,EAAE,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,YAAY,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;KACtF,CAAC;AACJ,CAAC"}

package/dist/runtime/cascade.d.ts

@@ -0,0 +1,26 @@
+import type { ModelTier } from '../core/types.js';
+export interface CascadeConfig {
+    enabled: boolean;
+    tiers: ModelTier[];
+    confidenceThreshold: number;
+    maxEscalations: number;
+}
+export declare const DEFAULT_CASCADE: CascadeConfig;
+/**
+ * Determine the starting model tier for a task.
+ * Simple tasks start at haiku, complex tasks start higher.
+ */
+export declare function selectStartingTier(taskComplexity: 'simple' | 'medium' | 'complex', config?: CascadeConfig): ModelTier;
+/**
+ * Classify task complexity from task description.
+ */
+export declare function classifyTaskComplexity(task: string): 'simple' | 'medium' | 'complex';
+/**
+ * Get the next tier to escalate to.
+ */
+export declare function getNextTier(current: ModelTier, config?: CascadeConfig): ModelTier | null;
+/**
+ * Check if an agent result warrants escalation.
+ */
+export declare function shouldEscalate(confidence: string, outputLength: number, hasBlockers: boolean, threshold?: number): boolean;
+//# sourceMappingURL=cascade.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cascade.d.ts","sourceRoot":"","sources":["../../src/runtime/cascade.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,eAAe,EAAE,aAK7B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,EAAE,MAAM,GAAE,aAA+B,GAAG,SAAS,CAMtI;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAYpF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,GAAE,aAA+B,GAAG,SAAS,GAAG,IAAI,CAIzG;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,OAAO,EACpB,SAAS,GAAE,MAA4C,GACtD,OAAO,CAKT"}

package/dist/runtime/cascade.js

@@ -0,0 +1,54 @@
+export const DEFAULT_CASCADE = {
+    enabled: true,
+    tiers: ['haiku', 'sonnet', 'opus'],
+    confidenceThreshold: 0.7,
+    maxEscalations: 1,
+};
+/**
+ * Determine the starting model tier for a task.
+ * Simple tasks start at haiku, complex tasks start higher.
+ */
+export function selectStartingTier(taskComplexity, config = DEFAULT_CASCADE) {
+    switch (taskComplexity) {
+        case 'simple': return config.tiers[0] ?? 'haiku';
+        case 'medium': return config.tiers[1] ?? 'sonnet';
+        case 'complex': return config.tiers[2] ?? 'opus';
+    }
+}
+/**
+ * Classify task complexity from task description.
+ */
+export function classifyTaskComplexity(task) {
+    const lower = task.toLowerCase();
+    // Simple indicators
+    const simple = ['list', 'show', 'print', 'log', 'rename', 'typo', 'comment', 'format', 'lint', 'move', 'copy', 'delete'];
+    if (simple.some(s => lower.includes(s)) && task.length < 100)
+        return 'simple';
+    // Complex indicators
+    const complex = ['refactor', 'architect', 'migration', 'security audit', 'redesign', 'rewrite', 'optimize performance', 'distributed', 'concurrent', 'multi-service'];
+    if (complex.some(c => lower.includes(c)))
+        return 'complex';
+    return 'medium';
+}
+/**
+ * Get the next tier to escalate to.
+ */
+export function getNextTier(current, config = DEFAULT_CASCADE) {
+    const idx = config.tiers.indexOf(current);
+    if (idx < 0 || idx >= config.tiers.length - 1)
+        return null;
+    return config.tiers[idx + 1] ?? null;
+}
+/**
+ * Check if an agent result warrants escalation.
+ */
+export function shouldEscalate(confidence, outputLength, hasBlockers, threshold = DEFAULT_CASCADE.confidenceThreshold) {
+    if (hasBlockers)
+        return true;
+    if (confidence === 'low')
+        return true;
+    if (confidence === 'medium' && outputLength < 200)
+        return true; // Suspiciously short
+    return false;
+}
+//# sourceMappingURL=cascade.js.map

package/dist/runtime/cascade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cascade.js","sourceRoot":"","sources":["../../src/runtime/cascade.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,eAAe,GAAkB;IAC5C,OAAO,EAAE,IAAI;IACb,KAAK,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC;IAClC,mBAAmB,EAAE,GAAG;IACxB,cAAc,EAAE,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,cAA+C,EAAE,SAAwB,eAAe;IACzH,QAAQ,cAAc,EAAE,CAAC;QACvB,KAAK,QAAQ,CAAC,CAAC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC;QACjD,KAAK,QAAQ,CAAC,CAAC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC;QAClD,KAAK,SAAS,CAAC,CAAC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;IACnD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAEjC,oBAAoB;IACpB,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACzH,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG;QAAE,OAAO,QAAQ,CAAC;IAE9E,qBAAqB;IACrB,MAAM,OAAO,GAAG,CAAC,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,SAAS,EAAE,sBAAsB,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC;IACtK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAE3D,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAkB,EAAE,SAAwB,eAAe;IACrF,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3D,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,UAAkB,EAClB,YAAoB,EACpB,WAAoB,EACpB,YAAoB,eAAe,CAAC,mBAAmB;IAEvD,IAAI,WAAW;QAAE,OAAO,IAAI,CAAC;IAC7B,IAAI,UAAU,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IACtC,IAAI,UAAU,KAAK,QAAQ,IAAI,YAAY,GAAG,GAAG;QAAE,OAAO,IAAI,CAAC,CAAC,qBAAqB;IACrF,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/runtime/chunker.d.ts

@@ -0,0 +1,36 @@
+export interface CodeChunk {
+    file: string;
+    startLine: number;
+    endLine: number;
+    symbol: string;
+    kind: string;
+    content: string;
+    tokens: number;
+}
+/**
+ * Extract relevant code chunks from files based on task keywords.
+ * Uses simple regex-based parsing (no tree-sitter dependency).
+ */
+export declare class CodeChunker {
+    private cwd;
+    constructor(cwd: string);
+    /**
+     * Extract symbols (functions, classes, interfaces) from a file.
+     */
+    extractSymbols(filePath: string): CodeChunk[];
+    /**
+     * Find chunks relevant to a task description.
+     */
+    findRelevant(filePaths: string[], task: string, maxTokens?: number): CodeChunk[];
+    /**
+     * Format chunks as context for agent injection.
+     */
+    formatChunks(chunks: CodeChunk[]): string;
+    private extractTSSymbols;
+    private extractPythonSymbols;
+    private findBlockEnd;
+    private findPythonBlockEnd;
+    private extractKeywords;
+    private relevanceScore;
+}
+//# sourceMappingURL=chunker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chunker.d.ts","sourceRoot":"","sources":["../../src/runtime/chunker.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,GAAG,CAAS;gBAER,GAAG,EAAE,MAAM;IAIvB;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE;IAmC7C;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,MAAa,GAAG,SAAS,EAAE;IA4BtF;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM;IAezC,OAAO,CAAC,gBAAgB;IAmCxB,OAAO,CAAC,oBAAoB;IAsC5B,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,cAAc;CASvB"}

package/dist/runtime/chunker.js

@@ -0,0 +1,210 @@
+import { readFileSync, existsSync } from 'fs';
+import { extname, resolve } from 'path';
+/**
+ * Extract relevant code chunks from files based on task keywords.
+ * Uses simple regex-based parsing (no tree-sitter dependency).
+ */
+export class CodeChunker {
+    cwd;
+    constructor(cwd) {
+        this.cwd = cwd;
+    }
+    /**
+     * Extract symbols (functions, classes, interfaces) from a file.
+     */
+    extractSymbols(filePath) {
+        const absPath = resolve(this.cwd, filePath);
+        // Prevent path traversal
+        if (!absPath.startsWith(resolve(this.cwd)))
+            return [];
+        if (!existsSync(absPath))
+            return [];
+        const content = readFileSync(absPath, 'utf-8');
+        const lines = content.split('\n');
+        const chunks = [];
+        const ext = extname(filePath);
+        // TypeScript/JavaScript patterns
+        if (['.ts', '.js', '.tsx', '.jsx'].includes(ext)) {
+            chunks.push(...this.extractTSSymbols(filePath, lines));
+        }
+        // Python patterns
+        else if (['.py'].includes(ext)) {
+            chunks.push(...this.extractPythonSymbols(filePath, lines));
+        }
+        // For other languages, return the whole file as one chunk
+        else {
+            chunks.push({
+                file: filePath,
+                startLine: 1,
+                endLine: lines.length,
+                symbol: filePath,
+                kind: 'file',
+                content: content.slice(0, 5000),
+                tokens: Math.ceil(content.length / 4),
+            });
+        }
+        return chunks;
+    }
+    /**
+     * Find chunks relevant to a task description.
+     */
+    findRelevant(filePaths, task, maxTokens = 8000) {
+        const keywords = this.extractKeywords(task);
+        const allChunks = [];
+        for (const file of filePaths) {
+            const chunks = this.extractSymbols(file);
+            for (const chunk of chunks) {
+                const score = this.relevanceScore(chunk, keywords);
+                if (score > 0) {
+                    allChunks.push({ ...chunk, score });
+                }
+            }
+        }
+        // Sort by relevance, take until token budget
+        allChunks.sort((a, b) => b.score - a.score);
+        const selected = [];
+        let totalTokens = 0;
+        for (const chunk of allChunks) {
+            if (totalTokens + chunk.tokens > maxTokens)
+                break;
+            selected.push(chunk);
+            totalTokens += chunk.tokens;
+        }
+        return selected;
+    }
+    /**
+     * Format chunks as context for agent injection.
+     */
+    formatChunks(chunks) {
+        if (chunks.length === 0)
+            return '';
+        const lines = ['## Relevant Code Context', ''];
+        for (const chunk of chunks) {
+            lines.push(`### ${chunk.file}:${chunk.startLine} (${chunk.kind}: ${chunk.symbol})`);
+            lines.push('```');
+            lines.push(chunk.content);
+            lines.push('```');
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+    // --- TypeScript/JavaScript extraction ---
+    extractTSSymbols(file, lines) {
+        const chunks = [];
+        const patterns = [
+            { regex: /^(?:export\s+)?(?:async\s+)?function\s+(\w+)/m, kind: 'function' },
+            { regex: /^(?:export\s+)?class\s+(\w+)/m, kind: 'class' },
+            { regex: /^(?:export\s+)?interface\s+(\w+)/m, kind: 'interface' },
+            { regex: /^(?:export\s+)?(?:const|let)\s+(\w+)\s*=\s*(?:async\s+)?\(/m, kind: 'function' },
+            { regex: /^(?:export\s+)?type\s+(\w+)/m, kind: 'type' },
+        ];
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            for (const { regex, kind } of patterns) {
+                const match = line.match(regex);
+                if (match && match[1]) {
+                    const endLine = this.findBlockEnd(lines, i);
+                    const content = lines.slice(i, endLine + 1).join('\n');
+                    chunks.push({
+                        file,
+                        startLine: i + 1,
+                        endLine: endLine + 1,
+                        symbol: match[1],
+                        kind,
+                        content: content.slice(0, 2000),
+                        tokens: Math.ceil(content.length / 4),
+                    });
+                }
+            }
+        }
+        return chunks;
+    }
+    // --- Python extraction ---
+    extractPythonSymbols(file, lines) {
+        const chunks = [];
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            // Functions
+            const funcMatch = line.match(/^(?:async\s+)?def\s+(\w+)/);
+            if (funcMatch && funcMatch[1]) {
+                const endLine = this.findPythonBlockEnd(lines, i);
+                const content = lines.slice(i, endLine + 1).join('\n');
+                chunks.push({
+                    file, startLine: i + 1, endLine: endLine + 1,
+                    symbol: funcMatch[1], kind: 'function',
+                    content: content.slice(0, 2000),
+                    tokens: Math.ceil(content.length / 4),
+                });
+            }
+            // Classes
+            const classMatch = line.match(/^class\s+(\w+)/);
+            if (classMatch && classMatch[1]) {
+                const endLine = this.findPythonBlockEnd(lines, i);
+                const content = lines.slice(i, endLine + 1).join('\n');
+                chunks.push({
+                    file, startLine: i + 1, endLine: endLine + 1,
+                    symbol: classMatch[1], kind: 'class',
+                    content: content.slice(0, 3000),
+                    tokens: Math.ceil(content.length / 4),
+                });
+            }
+        }
+        return chunks;
+    }
+    // --- Helpers ---
+    findBlockEnd(lines, startLine) {
+        let depth = 0;
+        let foundOpen = false;
+        for (let i = startLine; i < lines.length; i++) {
+            const line = lines[i];
+            for (const ch of line) {
+                if (ch === '{') {
+                    depth++;
+                    foundOpen = true;
+                }
+                if (ch === '}') {
+                    depth--;
+                }
+            }
+            if (foundOpen && depth <= 0)
+                return i;
+            if (i - startLine > 200)
+                return i; // Safety limit
+        }
+        return Math.min(startLine + 50, lines.length - 1);
+    }
+    findPythonBlockEnd(lines, startLine) {
+        const startIndent = lines[startLine].search(/\S/);
+        for (let i = startLine + 1; i < lines.length; i++) {
+            const line = lines[i];
+            if (line.trim() === '')
+                continue;
+            const indent = line.search(/\S/);
+            if (indent <= startIndent)
+                return i - 1;
+            if (i - startLine > 200)
+                return i;
+        }
+        return lines.length - 1;
+    }
+    extractKeywords(task) {
+        return task
+            .toLowerCase()
+            .replace(/[^a-z0-9\s]/g, ' ')
+            .split(/\s+/)
+            .filter(w => w.length > 2)
+            .filter(w => !['the', 'and', 'for', 'with', 'this', 'that', 'from', 'add', 'make'].includes(w));
+    }
+    relevanceScore(chunk, keywords) {
+        const text = `${chunk.symbol} ${chunk.content}`.toLowerCase();
+        let score = 0;
+        for (const kw of keywords) {
+            if (text.includes(kw))
+                score++;
+            if (chunk.symbol.toLowerCase().includes(kw))
+                score += 3; // Symbol match is more relevant
+        }
+        return score;
+    }
+}
+//# sourceMappingURL=chunker.js.map

package/dist/runtime/chunker.js.map

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

package/dist/runtime/compaction.d.ts

@@ -0,0 +1,22 @@
+export interface CompactionConfig {
+    enabled: boolean;
+    maxContextTokens: number;
+    targetTokens: number;
+    preserveRecentTurns: number;
+    strategy: 'summarize' | 'prune' | 'sliding-window';
+}
+export declare const DEFAULT_COMPACTION: CompactionConfig;
+export interface CompactionResult {
+    originalTokens: number;
+    compactedTokens: number;
+    removedTurns: number;
+    summary?: string;
+}
+export declare class CompactionManager {
+    private config;
+    constructor(config?: Partial<CompactionConfig>);
+    needsCompaction(tokens: number): boolean;
+    generateCompactionInstruction(): string;
+    buildContextPrefix(phaseOutputs: Map<string, string[]>, maxTokens?: number): string;
+}
+//# sourceMappingURL=compaction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../src/runtime/compaction.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,WAAW,GAAG,OAAO,GAAG,gBAAgB,CAAC;CACpD;AAED,eAAO,MAAM,kBAAkB,EAAE,gBAMhC,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAmB;gBAErB,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC;IAI9C,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIxC,6BAA6B,IAAI,MAAM;IAIvC,kBAAkB,CAAC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM;CAmBpF"}