attocode 0.2.0 → 0.2.2

package/dist/src/integrations/complexity-classifier.js

@@ -0,0 +1,233 @@
+/**
+ * Complexity Classifier
+ *
+ * Heuristic-based task complexity assessment that determines
+ * the appropriate execution strategy (agent count, tool budget,
+ * swarm mode) without requiring an LLM call.
+ *
+ * Inspired by Anthropic's multi-agent research system's approach
+ * to scaling effort based on task complexity.
+ */
+// =============================================================================
+// CONSTANTS
+// =============================================================================
+/** Keywords that indicate higher complexity */
+const COMPLEX_KEYWORDS = [
+    // Multi-file operations
+    'refactor', 'migrate', 'redesign', 'rewrite', 'overhaul',
+    'restructure', 'reorganize', 'rearchitect',
+    // Broad scope
+    'all files', 'entire', 'codebase', 'every', 'across',
+    'comprehensive', 'full audit', 'system-wide',
+    // Multi-step
+    'first', 'then', 'after that', 'finally', 'step by step',
+    'and then', 'once done', 'followed by',
+    // Research-heavy
+    'investigate', 'analyze', 'audit', 'security review',
+    'performance analysis', 'benchmark', 'compare',
+];
+/** Keywords that indicate simplicity */
+const SIMPLE_KEYWORDS = [
+    'fix typo', 'rename', 'update version', 'add comment',
+    'change color', 'fix import', 'remove unused',
+    'what is', 'how does', 'where is', 'explain',
+];
+/** Dependency indicators (suggest sequential steps) */
+const DEPENDENCY_PATTERNS = [
+    /first\s.*then/i,
+    /after\s.*(?:do|make|create|implement)/i,
+    /before\s.*(?:need|must|should)/i,
+    /depends?\s+on/i,
+    /step\s+\d/i,
+    /phase\s+\d/i,
+];
+/** Tier -> execution recommendation mapping */
+const TIER_RECOMMENDATIONS = {
+    simple: {
+        agentCount: { min: 1, max: 1 },
+        toolCallsPerAgent: { min: 3, max: 10 },
+        useSwarmMode: false,
+        suggestedAgents: [],
+        budgetMultiplier: 0.5,
+        useExtendedThinking: false,
+    },
+    medium: {
+        agentCount: { min: 1, max: 4 },
+        toolCallsPerAgent: { min: 10, max: 20 },
+        useSwarmMode: false,
+        suggestedAgents: ['researcher', 'coder'],
+        budgetMultiplier: 1.0,
+        useExtendedThinking: false,
+    },
+    complex: {
+        agentCount: { min: 3, max: 8 },
+        toolCallsPerAgent: { min: 15, max: 30 },
+        useSwarmMode: true,
+        suggestedAgents: ['researcher', 'coder', 'reviewer'],
+        budgetMultiplier: 2.0,
+        useExtendedThinking: true,
+    },
+    deep_research: {
+        agentCount: { min: 5, max: 15 },
+        toolCallsPerAgent: { min: 20, max: 50 },
+        useSwarmMode: true,
+        suggestedAgents: ['researcher', 'coder', 'reviewer', 'architect'],
+        budgetMultiplier: 3.0,
+        useExtendedThinking: true,
+    },
+};
+// =============================================================================
+// CLASSIFIER
+// =============================================================================
+/**
+ * Classify task complexity using heuristic signals.
+ * No LLM call needed — fast and deterministic.
+ */
+export function classifyComplexity(task, context) {
+    const signals = [];
+    const taskLower = task.toLowerCase();
+    // Signal 1: Task length (proxy for detail/scope)
+    const wordCount = task.split(/\s+/).length;
+    const lengthScore = wordCount < 10 ? 0 : wordCount < 30 ? 1 : wordCount < 80 ? 2 : 3;
+    signals.push({
+        name: 'task_length',
+        value: lengthScore,
+        weight: 0.15,
+        description: `${wordCount} words (${lengthScore > 1 ? 'detailed' : 'brief'})`,
+    });
+    // Signal 2: Complex keyword matches
+    const complexMatches = COMPLEX_KEYWORDS.filter(kw => taskLower.includes(kw));
+    const complexScore = Math.min(complexMatches.length * 1.5, 4);
+    signals.push({
+        name: 'complex_keywords',
+        value: complexScore,
+        weight: 0.25,
+        description: complexMatches.length > 0
+            ? `Matches: ${complexMatches.slice(0, 3).join(', ')}`
+            : 'No complex keywords',
+    });
+    // Signal 3: Simple keyword matches (reduces score)
+    const simpleMatches = SIMPLE_KEYWORDS.filter(kw => taskLower.includes(kw));
+    const simpleScore = simpleMatches.length > 0 ? -2 : 0;
+    signals.push({
+        name: 'simple_keywords',
+        value: simpleScore,
+        weight: 0.2,
+        description: simpleMatches.length > 0
+            ? `Simple: ${simpleMatches.slice(0, 2).join(', ')}`
+            : 'No simplicity signals',
+    });
+    // Signal 4: Dependency patterns (suggest multi-step)
+    const depMatches = DEPENDENCY_PATTERNS.filter(p => p.test(task));
+    const depScore = depMatches.length * 2;
+    signals.push({
+        name: 'dependency_patterns',
+        value: depScore,
+        weight: 0.2,
+        description: depMatches.length > 0
+            ? `${depMatches.length} sequential dependencies detected`
+            : 'No dependency chains',
+    });
+    // Signal 5: Question vs action
+    const isQuestion = /^(what|how|where|when|why|which|can|does|is|are)\b/i.test(task.trim());
+    const actionScore = isQuestion ? -1 : 1;
+    signals.push({
+        name: 'question_vs_action',
+        value: actionScore,
+        weight: 0.1,
+        description: isQuestion ? 'Question (likely simpler)' : 'Action request',
+    });
+    // Signal 6: Multiple file/component references
+    const fileRefs = (task.match(/\b\w+\.(ts|tsx|js|jsx|py|rs|go|java|cpp|c|h)\b/g) || []).length;
+    const dirRefs = (task.match(/\b(?:src|lib|test|docs|config)\//g) || []).length;
+    const scopeScore = Math.min((fileRefs + dirRefs) * 0.5, 3);
+    signals.push({
+        name: 'scope_indicators',
+        value: scopeScore,
+        weight: 0.1,
+        description: `${fileRefs} file refs, ${dirRefs} dir refs`,
+    });
+    // Calculate weighted score
+    const totalScore = signals.reduce((sum, s) => sum + s.value * s.weight, 0);
+    // Determine tier
+    let tier;
+    if (totalScore < 0.5) {
+        tier = 'simple';
+    }
+    else if (totalScore < 1.5) {
+        tier = 'medium';
+    }
+    else if (totalScore < 2.5) {
+        tier = 'complex';
+    }
+    else {
+        tier = 'deep_research';
+    }
+    // Calculate confidence (higher when signals agree)
+    const signalVariance = signals.reduce((sum, s) => {
+        const normalized = s.value / 4; // Normalize to ~0-1 range
+        return sum + Math.abs(normalized - totalScore / 3);
+    }, 0) / signals.length;
+    const confidence = Math.max(0.3, Math.min(1.0, 1.0 - signalVariance));
+    // Build reasoning
+    const topSignals = [...signals]
+        .sort((a, b) => Math.abs(b.value * b.weight) - Math.abs(a.value * a.weight))
+        .slice(0, 3);
+    const reasoning = `Classified as ${tier} (score: ${totalScore.toFixed(2)}). ` +
+        `Top factors: ${topSignals.map(s => s.description).join('; ')}`;
+    return {
+        tier,
+        confidence,
+        reasoning,
+        recommendation: TIER_RECOMMENDATIONS[tier],
+        signals,
+    };
+}
+/**
+ * Generate scaling guidance for injection into the agent's system prompt.
+ * This follows Anthropic's pattern of embedding scaling rules directly in prompts.
+ */
+export function getScalingGuidance(assessment) {
+    const { tier, recommendation } = assessment;
+    const guidelines = {
+        simple: `## Effort Scaling: SIMPLE TASK
+- Handle directly, no subagents needed
+- ${recommendation.toolCallsPerAgent.min}-${recommendation.toolCallsPerAgent.max} tool calls maximum
+- Respond quickly and concisely
+- Do not over-explore the codebase`,
+        medium: `## Effort Scaling: MEDIUM TASK
+- Consider spawning ${recommendation.agentCount.min}-${recommendation.agentCount.max} subagents for independent subtasks
+- Each agent: ${recommendation.toolCallsPerAgent.min}-${recommendation.toolCallsPerAgent.max} tool calls
+- Coordinate via blackboard for shared findings
+- Balance speed with thoroughness`,
+        complex: `## Effort Scaling: COMPLEX TASK
+- Spawn ${recommendation.agentCount.min}-${recommendation.agentCount.max} subagents with clear delegation specs
+- Use parallel execution where possible
+- Quality gate each result before synthesis
+- Consider a researcher agent to scope the work first
+- Extended thinking recommended for planning`,
+        deep_research: `## Effort Scaling: DEEP RESEARCH TASK
+- Consider swarm mode for ${recommendation.agentCount.min}+ parallel agents
+- Budget for extended exploration and multiple passes
+- Use researcher agents to scope before implementation
+- Multiple review waves for quality assurance
+- Extended thinking strongly recommended`,
+    };
+    return guidelines[tier];
+}
+/**
+ * Create a complexity classifier with custom thresholds.
+ */
+export function createComplexityClassifier(config) {
+    const thresholds = {
+        simple: config?.simpleThreshold ?? 0.5,
+        medium: config?.mediumThreshold ?? 1.5,
+        complex: config?.complexThreshold ?? 2.5,
+    };
+    return {
+        classify: (task, context) => classifyComplexity(task, context),
+        getScalingGuidance,
+        thresholds,
+    };
+}
+//# sourceMappingURL=complexity-classifier.js.map

package/dist/src/integrations/complexity-classifier.js.map

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

package/dist/src/integrations/delegation-protocol.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Structured Delegation Protocol
+ *
+ * Provides a structured interface for delegating tasks to subagents,
+ * inspired by Anthropic's multi-agent research system.
+ *
+ * Instead of passing freeform task strings, the orchestrator creates
+ * a DelegationSpec that explicitly communicates:
+ * - Clear objective and success criteria
+ * - Expected output format
+ * - Tool guidance (what to use, what to avoid)
+ * - Task boundaries (in-scope vs out-of-scope)
+ * - Sibling context (what other agents are doing)
+ */
+/**
+ * Structured delegation spec for subagent tasks.
+ * Every field is intentionally explicit to prevent vague delegations.
+ */
+export interface DelegationSpec {
+    /** One-sentence objective: what the subagent must accomplish */
+    objective: string;
+    /** Detailed context: why this task matters, how it fits the bigger picture */
+    context: string;
+    /** Expected output format */
+    outputFormat: OutputFormatSpec;
+    /** Tools and sources guidance */
+    toolGuidance: ToolGuidance;
+    /** Explicit task boundaries */
+    boundaries: TaskBoundaries;
+    /** How to know when done */
+    successCriteria: string[];
+    /** What other agents are doing (prevents duplicate work) */
+    siblingContext?: SiblingContext;
+}
+export interface OutputFormatSpec {
+    /** Format type */
+    type: 'structured_json' | 'markdown_report' | 'code_changes' | 'free_text';
+    /** Schema or template for expected output */
+    schema?: string;
+    /** Example of good output */
+    example?: string;
+}
+export interface ToolGuidance {
+    /** Tools the agent should use */
+    recommended: string[];
+    /** Tools the agent should avoid (with reason) */
+    avoid?: Array<{
+        tool: string;
+        reason: string;
+    }>;
+    /** Specific sources/files to consult */
+    sources?: string[];
+}
+export interface TaskBoundaries {
+    /** What to include in scope */
+    inScope: string[];
+    /** What to explicitly exclude */
+    outOfScope: string[];
+    /** Maximum depth of exploration */
+    maxExplorationDepth?: 'shallow' | 'moderate' | 'deep';
+}
+export interface SiblingContext {
+    /** Brief description of what other agents are working on */
+    siblingTasks: Array<{
+        agent: string;
+        task: string;
+    }>;
+    /** Files claimed by other agents (do not modify) */
+    claimedFiles?: string[];
+}
+/**
+ * Convert a DelegationSpec into a structured prompt for a subagent.
+ * The output is injected into the subagent's system prompt or task description.
+ */
+export declare function buildDelegationPrompt(spec: DelegationSpec): string;
+/**
+ * Create a minimal DelegationSpec from a task string.
+ * Used as a fallback when the orchestrator doesn't provide a full spec.
+ */
+export declare function createMinimalDelegationSpec(task: string, agentType?: string): DelegationSpec;
+/**
+ * Delegation protocol instructions for the orchestrator's system prompt.
+ * Teaches the lead agent HOW to delegate effectively.
+ */
+export declare const DELEGATION_INSTRUCTIONS = "\n## Delegation Protocol\n\nWhen using spawn_agent, provide structured delegation:\n\n1. **OBJECTIVE**: One clear sentence of what the agent must accomplish\n2. **CONTEXT**: Why this matters and how it fits the bigger picture\n3. **OUTPUT FORMAT**: What the result should look like (JSON/markdown/code)\n4. **TOOLS**: Which tools to use and which to avoid\n5. **BOUNDARIES**: What is in-scope vs out-of-scope\n6. **SUCCESS CRITERIA**: How to know when done\n\nInclude a delegationSpec in the spawn_agent call for best results.\nWhen spawning multiple agents, describe what siblings are working on\nto prevent duplicate effort.\n";
+//# sourceMappingURL=delegation-protocol.d.ts.map

package/dist/src/integrations/delegation-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegation-protocol.d.ts","sourceRoot":"","sources":["../../../src/integrations/delegation-protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAElB,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAEhB,6BAA6B;IAC7B,YAAY,EAAE,gBAAgB,CAAC;IAE/B,iCAAiC;IACjC,YAAY,EAAE,YAAY,CAAC;IAE3B,+BAA+B;IAC/B,UAAU,EAAE,cAAc,CAAC;IAE3B,4BAA4B;IAC5B,eAAe,EAAE,MAAM,EAAE,CAAC;IAE1B,4DAA4D;IAC5D,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB;IAClB,IAAI,EAAE,iBAAiB,GAAG,iBAAiB,GAAG,cAAc,GAAG,WAAW,CAAC;IAC3E,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,iDAAiD;IACjD,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,iCAAiC;IACjC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,mCAAmC;IACnC,mBAAmB,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;CACvD;AAED,MAAM,WAAW,cAAc;IAC7B,4DAA4D;IAC5D,YAAY,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAMD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAsDlE;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,MAAM,GACjB,cAAc,CAchB;AAsBD;;;GAGG;AACH,eAAO,MAAM,uBAAuB,ynBAenC,CAAC"}

package/dist/src/integrations/delegation-protocol.js

@@ -0,0 +1,127 @@
+/**
+ * Structured Delegation Protocol
+ *
+ * Provides a structured interface for delegating tasks to subagents,
+ * inspired by Anthropic's multi-agent research system.
+ *
+ * Instead of passing freeform task strings, the orchestrator creates
+ * a DelegationSpec that explicitly communicates:
+ * - Clear objective and success criteria
+ * - Expected output format
+ * - Tool guidance (what to use, what to avoid)
+ * - Task boundaries (in-scope vs out-of-scope)
+ * - Sibling context (what other agents are doing)
+ */
+// =============================================================================
+// BUILDER
+// =============================================================================
+/**
+ * Convert a DelegationSpec into a structured prompt for a subagent.
+ * The output is injected into the subagent's system prompt or task description.
+ */
+export function buildDelegationPrompt(spec) {
+    const sections = [];
+    // Objective
+    sections.push(`## OBJECTIVE\n${spec.objective}`);
+    // Context
+    if (spec.context) {
+        sections.push(`## CONTEXT\n${spec.context}`);
+    }
+    // Output Format
+    sections.push(`## EXPECTED OUTPUT\nFormat: ${spec.outputFormat.type}`);
+    if (spec.outputFormat.schema) {
+        sections.push(`Schema:\n\`\`\`\n${spec.outputFormat.schema}\n\`\`\``);
+    }
+    if (spec.outputFormat.example) {
+        sections.push(`Example:\n\`\`\`\n${spec.outputFormat.example}\n\`\`\``);
+    }
+    // Tool Guidance
+    if (spec.toolGuidance.recommended.length > 0) {
+        sections.push(`## RECOMMENDED TOOLS\n${spec.toolGuidance.recommended.map(t => `- ${t}`).join('\n')}`);
+    }
+    if (spec.toolGuidance.avoid && spec.toolGuidance.avoid.length > 0) {
+        sections.push(`## TOOLS TO AVOID\n${spec.toolGuidance.avoid.map(a => `- ${a.tool}: ${a.reason}`).join('\n')}`);
+    }
+    if (spec.toolGuidance.sources && spec.toolGuidance.sources.length > 0) {
+        sections.push(`## KEY SOURCES\n${spec.toolGuidance.sources.map(s => `- ${s}`).join('\n')}`);
+    }
+    // Boundaries
+    sections.push(`## SCOPE`);
+    sections.push(`In scope:\n${spec.boundaries.inScope.map(s => `- ${s}`).join('\n')}`);
+    sections.push(`Out of scope:\n${spec.boundaries.outOfScope.map(s => `- ${s}`).join('\n')}`);
+    if (spec.boundaries.maxExplorationDepth) {
+        sections.push(`Exploration depth: ${spec.boundaries.maxExplorationDepth}`);
+    }
+    // Success Criteria
+    sections.push(`## SUCCESS CRITERIA\n${spec.successCriteria.map((c, i) => `${i + 1}. ${c}`).join('\n')}`);
+    // Sibling Context
+    if (spec.siblingContext) {
+        sections.push(`## SIBLING AGENTS (avoid duplicate work)`);
+        for (const sibling of spec.siblingContext.siblingTasks) {
+            sections.push(`- ${sibling.agent}: ${sibling.task}`);
+        }
+        if (spec.siblingContext.claimedFiles && spec.siblingContext.claimedFiles.length > 0) {
+            sections.push(`\nClaimed files (DO NOT modify):\n${spec.siblingContext.claimedFiles.map(f => `- ${f}`).join('\n')}`);
+        }
+    }
+    return sections.join('\n\n');
+}
+/**
+ * Create a minimal DelegationSpec from a task string.
+ * Used as a fallback when the orchestrator doesn't provide a full spec.
+ */
+export function createMinimalDelegationSpec(task, agentType) {
+    return {
+        objective: task,
+        context: '',
+        outputFormat: { type: 'free_text' },
+        toolGuidance: {
+            recommended: getDefaultToolsForAgent(agentType),
+        },
+        boundaries: {
+            inScope: [task],
+            outOfScope: ['Changes outside the immediate task scope'],
+        },
+        successCriteria: ['Task objective is fully addressed'],
+    };
+}
+/**
+ * Get default recommended tools based on agent type.
+ */
+function getDefaultToolsForAgent(agentType) {
+    switch (agentType) {
+        case 'researcher':
+            return ['read_file', 'glob', 'grep', 'list_files'];
+        case 'coder':
+            return ['read_file', 'write_file', 'edit_file', 'bash', 'glob', 'grep'];
+        case 'reviewer':
+            return ['read_file', 'glob', 'grep'];
+        case 'architect':
+            return ['read_file', 'glob', 'grep', 'list_files'];
+        case 'debugger':
+            return ['read_file', 'bash', 'glob', 'grep', 'edit_file'];
+        default:
+            return ['read_file', 'glob', 'grep'];
+    }
+}
+/**
+ * Delegation protocol instructions for the orchestrator's system prompt.
+ * Teaches the lead agent HOW to delegate effectively.
+ */
+export const DELEGATION_INSTRUCTIONS = `
+## Delegation Protocol
+
+When using spawn_agent, provide structured delegation:
+
+1. **OBJECTIVE**: One clear sentence of what the agent must accomplish
+2. **CONTEXT**: Why this matters and how it fits the bigger picture
+3. **OUTPUT FORMAT**: What the result should look like (JSON/markdown/code)
+4. **TOOLS**: Which tools to use and which to avoid
+5. **BOUNDARIES**: What is in-scope vs out-of-scope
+6. **SUCCESS CRITERIA**: How to know when done
+
+Include a delegationSpec in the spawn_agent call for best results.
+When spawning multiple agents, describe what siblings are working on
+to prevent duplicate effort.
+`;
+//# sourceMappingURL=delegation-protocol.js.map

package/dist/src/integrations/delegation-protocol.js.map

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

package/dist/src/integrations/dynamic-budget.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Dynamic Budget Rebalancing
+ *
+ * Extends SharedBudgetPool with dynamic rebalancing that prevents
+ * starvation when spawning subagents sequentially.
+ *
+ * Key features:
+ * - setExpectedChildren(count) for upfront capacity planning
+ * - Sequential spawn cap: never take >60% of remaining budget
+ * - Rebalance on child completion (return unused budget to pool)
+ * - Priority-based allocation (critical children get more)
+ */
+import { SharedBudgetPool, type BudgetPoolConfig, type BudgetAllocation, type BudgetPoolStats } from './budget-pool.js';
+export interface DynamicBudgetConfig extends BudgetPoolConfig {
+    /** Maximum percentage of remaining budget for any single child (default: 0.6) */
+    maxRemainingRatio: number;
+    /** Minimum tokens to reserve for each expected child (default: 10000) */
+    minPerExpectedChild: number;
+    /** Enable automatic rebalancing on release (default: true) */
+    autoRebalance: boolean;
+}
+export interface ChildPriority {
+    /** Child ID */
+    childId: string;
+    /** Priority level (higher = more budget) */
+    priority: 'low' | 'normal' | 'high' | 'critical';
+    /** Expected token usage (optional hint) */
+    expectedTokens?: number;
+}
+export interface RebalanceResult {
+    /** Children that had their allocations adjusted */
+    adjusted: Array<{
+        childId: string;
+        oldBudget: number;
+        newBudget: number;
+    }>;
+    /** Tokens freed by rebalancing */
+    tokensFreed: number;
+}
+export declare class DynamicBudgetPool extends SharedBudgetPool {
+    private dynamicConfig;
+    private expectedChildren;
+    private spawnedCount;
+    private completedCount;
+    private childPriorities;
+    constructor(config: BudgetPoolConfig & Partial<DynamicBudgetConfig>);
+    /**
+     * Set the expected number of children for capacity planning.
+     * This adjusts maxPerChild to ensure fair distribution.
+     */
+    setExpectedChildren(count: number): void;
+    /**
+     * Set priority for a child agent.
+     */
+    setChildPriority(priority: ChildPriority): void;
+    /**
+     * Reserve with dynamic capacity planning.
+     * Respects expected children and remaining ratio cap.
+     */
+    reserveDynamic(childId: string, priority?: ChildPriority['priority']): BudgetAllocation | null;
+    /**
+     * Release with optional auto-rebalancing.
+     */
+    releaseDynamic(childId: string): void;
+    /**
+     * Get enhanced stats including dynamic info.
+     */
+    getDynamicStats(): BudgetPoolStats & {
+        expectedChildren: number;
+        spawnedCount: number;
+        completedCount: number;
+        pendingCount: number;
+        avgPerChild: number;
+    };
+    private updateMaxPerChild;
+}
+/**
+ * Create a dynamic budget pool from a parent's budget.
+ */
+export declare function createDynamicBudgetPool(parentBudgetTokens: number, parentReserveRatio?: number, config?: Partial<DynamicBudgetConfig>): DynamicBudgetPool;
+//# sourceMappingURL=dynamic-budget.d.ts.map

package/dist/src/integrations/dynamic-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-budget.d.ts","sourceRoot":"","sources":["../../../src/integrations/dynamic-budget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAMxH,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D,iFAAiF;IACjF,iBAAiB,EAAE,MAAM,CAAC;IAC1B,yEAAyE;IACzE,mBAAmB,EAAE,MAAM,CAAC;IAC5B,8DAA8D;IAC9D,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,eAAe;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IACjD,2CAA2C;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,QAAQ,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3E,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;CACrB;AAuBD,qBAAa,iBAAkB,SAAQ,gBAAgB;IACrD,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,eAAe,CAAyC;gBAEpD,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAUnE;;;OAGG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKxC;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAI/C;;;OAGG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,gBAAgB,GAAG,IAAI;IAwC9F;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMrC;;OAEG;IACH,eAAe,IAAI,eAAe,GAAG;QACnC,gBAAgB,EAAE,MAAM,CAAC;QACzB,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;KACrB;IAmBD,OAAO,CAAC,iBAAiB;CAa1B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,kBAAkB,EAAE,MAAM,EAC1B,kBAAkB,GAAE,MAAa,EACjC,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GACpC,iBAAiB,CAanB"}