@yuaone/core 0.2.0 → 0.3.0

package/dist/cost-optimizer.d.ts.map

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

package/dist/cost-optimizer.js

@@ -0,0 +1,406 @@
+/**
+ * cost-optimizer.ts — LLM Cost Optimization Module for YUAN Coding Agent
+ *
+ * Selects optimal models per task, predicts token usage,
+ * tracks costs, and enforces budget constraints.
+ */
+// ─── Constants ───────────────────────────────────────────────────────
+const DEFAULT_MODELS = [
+    {
+        tier: "cheap",
+        name: "claude-haiku-4-5",
+        inputCostPer1M: 0.80,
+        outputCostPer1M: 4.00,
+        maxContext: 200_000,
+        capabilities: ["simple", "classify", "grep"],
+    },
+    {
+        tier: "cheap",
+        name: "gpt-4o-mini",
+        inputCostPer1M: 0.15,
+        outputCostPer1M: 0.60,
+        maxContext: 128_000,
+        capabilities: ["simple", "classify", "coding"],
+    },
+    {
+        tier: "standard",
+        name: "claude-sonnet-4-6",
+        inputCostPer1M: 3.00,
+        outputCostPer1M: 15.00,
+        maxContext: 200_000,
+        capabilities: ["coding", "review", "test", "planning"],
+    },
+    {
+        tier: "standard",
+        name: "gpt-4o",
+        inputCostPer1M: 2.50,
+        outputCostPer1M: 10.00,
+        maxContext: 128_000,
+        capabilities: ["coding", "review", "test"],
+    },
+    {
+        tier: "premium",
+        name: "claude-opus-4-6",
+        inputCostPer1M: 15.00,
+        outputCostPer1M: 75.00,
+        maxContext: 200_000,
+        capabilities: ["coding", "planning", "debate", "review", "complex_refactor"],
+    },
+    {
+        tier: "premium",
+        name: "o3",
+        inputCostPer1M: 10.00,
+        outputCostPer1M: 40.00,
+        maxContext: 200_000,
+        capabilities: ["coding", "planning", "debate", "complex_refactor"],
+    },
+];
+const DEFAULT_CONFIG = {
+    budgetUSD: 1.0,
+    defaultTier: "standard",
+    models: DEFAULT_MODELS,
+    enableAutoSelect: true,
+    costWarningThreshold: 0.8,
+};
+/**
+ * Maps a task type to its base model tier.
+ * Tasks not listed here default to "standard".
+ */
+const TASK_TIER_MAP = {
+    classify: "cheap",
+    grep: "cheap",
+    simple_edit: "cheap",
+    coding: "standard",
+    review: "standard",
+    test: "standard",
+    planning: "premium",
+    debate: "premium",
+    complex_refactor: "premium",
+};
+/**
+ * Output-to-input token ratio heuristics per task type.
+ * A ratio of 1.2 means the model is expected to produce
+ * 1.2x as many output tokens as input tokens.
+ */
+const TOKEN_OUTPUT_RATIO = {
+    classify: 0.3,
+    coding: 1.2,
+    planning: 2.0,
+    review: 0.8,
+    simple_edit: 0.5,
+    grep: 0.3,
+    test: 1.0,
+    debate: 1.5,
+    complex_refactor: 1.5,
+};
+const TIER_ORDER = ["cheap", "standard", "premium"];
+// ─── Helpers ─────────────────────────────────────────────────────────
+function tierIndex(tier) {
+    return TIER_ORDER.indexOf(tier);
+}
+function clampTier(index) {
+    const clamped = Math.max(0, Math.min(index, TIER_ORDER.length - 1));
+    return TIER_ORDER[clamped];
+}
+function computeCost(profile, inputTokens, outputTokens) {
+    return ((inputTokens / 1_000_000) * profile.inputCostPer1M +
+        (outputTokens / 1_000_000) * profile.outputCostPer1M);
+}
+function emptyTierBucket() {
+    return { cost: 0, tokens: 0, calls: 0 };
+}
+// ─── CostOptimizer ──────────────────────────────────────────────────
+export class CostOptimizer {
+    config;
+    records = [];
+    models = new Map();
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        // If caller provided models, use them; otherwise use defaults
+        if (config?.models) {
+            this.config.models = config.models;
+        }
+        for (const model of this.config.models) {
+            this.models.set(model.name, model);
+        }
+    }
+    // ── Model Selection ──────────────────────────────────────────────
+    /**
+     * Select the optimal model for a given task.
+     *
+     * Selection logic:
+     *  1. Determine base tier from taskType
+     *  2. Apply complexity modifier (trivial/simple → downgrade, complex/massive → upgrade)
+     *  3. Apply budget pressure (low budget → downgrade)
+     *  4. Pick the cheapest model in the resolved tier that has a matching capability
+     *  5. If auto-select is disabled, use defaultTier
+     */
+    selectModel(taskType, complexity, estimatedTokens) {
+        let tier = this.config.enableAutoSelect
+            ? this.resolveBaseTier(taskType)
+            : this.config.defaultTier;
+        // Complexity modifier
+        tier = this.applyComplexityModifier(tier, complexity);
+        // Budget pressure
+        tier = this.applyBudgetPressure(tier, taskType, estimatedTokens);
+        // Find best model in tier
+        return this.pickModelForTier(tier, taskType);
+    }
+    // ── Token Prediction ─────────────────────────────────────────────
+    /**
+     * Predict input and output token counts for a task.
+     *
+     * Input tokens are estimated as roughly `inputLength / 4` (avg chars per token).
+     * Output tokens use a task-specific multiplier on the input token count.
+     */
+    predictTokens(taskType, inputLength) {
+        const inputTokens = Math.ceil(inputLength / 4);
+        const ratio = TOKEN_OUTPUT_RATIO[taskType] ?? 1.0;
+        const outputTokens = Math.ceil(inputTokens * ratio);
+        return { input: inputTokens, output: outputTokens };
+    }
+    // ── Cost Estimation ──────────────────────────────────────────────
+    /**
+     * Estimate the cost of a task before execution.
+     * Combines token prediction with model selection to produce a USD estimate.
+     */
+    estimateCost(taskType, inputLength) {
+        const { input, output } = this.predictTokens(taskType, inputLength);
+        const model = this.selectModel(taskType, "normal", input);
+        const cost = computeCost(model, input, output);
+        return {
+            estimatedInputTokens: input,
+            estimatedOutputTokens: output,
+            estimatedCostUSD: Math.round(cost * 1_000_000) / 1_000_000,
+            model: model.name,
+            tier: model.tier,
+        };
+    }
+    // ── Usage Recording ──────────────────────────────────────────────
+    /**
+     * Record actual token usage after an LLM call completes.
+     * The cost is computed from the model's pricing profile.
+     * If the model is unknown, cost is recorded as 0.
+     */
+    recordUsage(model, inputTokens, outputTokens, taskType) {
+        const profile = this.models.get(model);
+        const tier = profile?.tier ?? this.config.defaultTier;
+        const costUSD = profile ? computeCost(profile, inputTokens, outputTokens) : 0;
+        this.records.push({
+            model,
+            tier,
+            inputTokens,
+            outputTokens,
+            costUSD,
+            taskType,
+            timestamp: Date.now(),
+        });
+    }
+    // ── Summary ──────────────────────────────────────────────────────
+    /**
+     * Produce a summary of all costs recorded in this session.
+     */
+    getSummary() {
+        const byModel = {};
+        const byTier = {
+            cheap: emptyTierBucket(),
+            standard: emptyTierBucket(),
+            premium: emptyTierBucket(),
+        };
+        let totalCostUSD = 0;
+        let totalInputTokens = 0;
+        let totalOutputTokens = 0;
+        for (const record of this.records) {
+            totalCostUSD += record.costUSD;
+            totalInputTokens += record.inputTokens;
+            totalOutputTokens += record.outputTokens;
+            // By model
+            if (!byModel[record.model]) {
+                byModel[record.model] = { cost: 0, tokens: 0, calls: 0 };
+            }
+            byModel[record.model].cost += record.costUSD;
+            byModel[record.model].tokens += record.inputTokens + record.outputTokens;
+            byModel[record.model].calls += 1;
+            // By tier
+            byTier[record.tier].cost += record.costUSD;
+            byTier[record.tier].tokens += record.inputTokens + record.outputTokens;
+            byTier[record.tier].calls += 1;
+        }
+        const budgetRemaining = Math.max(0, this.config.budgetUSD - totalCostUSD);
+        const budgetUsedPercent = this.config.budgetUSD > 0
+            ? Math.min(100, (totalCostUSD / this.config.budgetUSD) * 100)
+            : 100;
+        return {
+            totalCostUSD: Math.round(totalCostUSD * 1_000_000) / 1_000_000,
+            totalInputTokens,
+            totalOutputTokens,
+            byModel,
+            byTier,
+            budgetRemaining: Math.round(budgetRemaining * 1_000_000) / 1_000_000,
+            budgetUsedPercent: Math.round(budgetUsedPercent * 100) / 100,
+        };
+    }
+    // ── Budget ───────────────────────────────────────────────────────
+    /**
+     * Check whether the session is still within its budget.
+     * Optionally include an additional planned cost to see if it would exceed.
+     */
+    isWithinBudget(additionalCostUSD = 0) {
+        const spent = this.totalSpent();
+        return spent + additionalCostUSD <= this.config.budgetUSD;
+    }
+    /**
+     * Returns a warning string if budget usage has crossed the configured
+     * warning threshold. Returns null if usage is below the threshold.
+     */
+    getBudgetWarning() {
+        const spent = this.totalSpent();
+        const usedPercent = this.config.budgetUSD > 0
+            ? spent / this.config.budgetUSD
+            : 1;
+        if (usedPercent >= 1.0) {
+            return `Budget exhausted: $${spent.toFixed(4)} / $${this.config.budgetUSD.toFixed(2)} (${(usedPercent * 100).toFixed(1)}%)`;
+        }
+        if (usedPercent >= this.config.costWarningThreshold) {
+            return `Budget warning: $${spent.toFixed(4)} / $${this.config.budgetUSD.toFixed(2)} (${(usedPercent * 100).toFixed(1)}% used)`;
+        }
+        return null;
+    }
+    // ── Lifecycle ────────────────────────────────────────────────────
+    /**
+     * Reset all recorded usage for a new session.
+     * Model registrations and config are preserved.
+     */
+    reset() {
+        this.records = [];
+    }
+    // ── Model Management ─────────────────────────────────────────────
+    /**
+     * Return all registered model profiles.
+     */
+    getModels() {
+        return Array.from(this.models.values());
+    }
+    /**
+     * Register a new model or update an existing one.
+     */
+    registerModel(profile) {
+        this.models.set(profile.name, profile);
+        // Keep config.models in sync
+        const idx = this.config.models.findIndex((m) => m.name === profile.name);
+        if (idx >= 0) {
+            this.config.models[idx] = profile;
+        }
+        else {
+            this.config.models.push(profile);
+        }
+    }
+    // ── Private Helpers ──────────────────────────────────────────────
+    /**
+     * Resolve the base tier for a task type using the static mapping.
+     */
+    resolveBaseTier(taskType) {
+        return TASK_TIER_MAP[taskType] ?? this.config.defaultTier;
+    }
+    /**
+     * Shift tier up or down based on complexity label.
+     *
+     *  - "trivial" | "simple"  → downgrade one tier (min: cheap)
+     *  - "complex" | "massive" → upgrade one tier (max: premium)
+     *  - anything else         → no change
+     */
+    applyComplexityModifier(tier, complexity) {
+        const normalized = complexity.toLowerCase();
+        const idx = tierIndex(tier);
+        if (normalized === "trivial" || normalized === "simple") {
+            return clampTier(idx - 1);
+        }
+        if (normalized === "complex" || normalized === "massive") {
+            return clampTier(idx + 1);
+        }
+        return tier;
+    }
+    /**
+     * Downgrade tier when budget is under pressure.
+     *
+     *  - If remaining budget < estimated cost × 2 → downgrade one tier
+     *  - If remaining budget < 10% of total budget → force cheap
+     */
+    applyBudgetPressure(tier, taskType, estimatedTokens) {
+        const spent = this.totalSpent();
+        const remaining = this.config.budgetUSD - spent;
+        const budgetFraction = this.config.budgetUSD > 0
+            ? remaining / this.config.budgetUSD
+            : 0;
+        // Force cheap when nearly out of budget
+        if (budgetFraction < 0.10) {
+            return "cheap";
+        }
+        // Downgrade if the estimated cost is tight
+        if (estimatedTokens !== undefined && estimatedTokens > 0) {
+            const candidates = this.modelsForTier(tier);
+            if (candidates.length > 0) {
+                const cheapest = candidates[0]; // sorted cheapest-first
+                const ratio = TOKEN_OUTPUT_RATIO[taskType] ?? 1.0;
+                const outputEstimate = Math.ceil(estimatedTokens * ratio);
+                const estimatedCost = computeCost(cheapest, estimatedTokens, outputEstimate);
+                if (remaining < estimatedCost * 2) {
+                    return clampTier(tierIndex(tier) - 1);
+                }
+            }
+        }
+        return tier;
+    }
+    /**
+     * Pick the cheapest model in the given tier whose capabilities
+     * include the requested task type.  Falls back to cheapest in-tier
+     * if no capability match, then falls back to the cheapest model overall.
+     */
+    pickModelForTier(tier, taskType) {
+        const candidates = this.modelsForTier(tier);
+        // Prefer models whose capabilities include the task type
+        const capable = candidates.filter((m) => m.capabilities.includes(taskType));
+        if (capable.length > 0) {
+            return capable[0];
+        }
+        // Fallback: any model in the tier
+        if (candidates.length > 0) {
+            return candidates[0];
+        }
+        // Ultimate fallback: cheapest model overall
+        const all = this.allModelsSorted();
+        if (all.length > 0) {
+            return all[0];
+        }
+        // Should never happen if config has at least one model
+        throw new Error(`CostOptimizer: no models registered. Cannot select a model for tier="${tier}" task="${taskType}".`);
+    }
+    /**
+     * Return models for a given tier, sorted by total cost (cheapest first).
+     * Total cost heuristic: inputCostPer1M + outputCostPer1M.
+     */
+    modelsForTier(tier) {
+        return Array.from(this.models.values())
+            .filter((m) => m.tier === tier)
+            .sort((a, b) => a.inputCostPer1M + a.outputCostPer1M -
+            (b.inputCostPer1M + b.outputCostPer1M));
+    }
+    /**
+     * Return all models sorted by total cost (cheapest first).
+     */
+    allModelsSorted() {
+        return Array.from(this.models.values()).sort((a, b) => a.inputCostPer1M + a.outputCostPer1M -
+            (b.inputCostPer1M + b.outputCostPer1M));
+    }
+    /**
+     * Sum of all recorded costs so far.
+     */
+    totalSpent() {
+        let total = 0;
+        for (const r of this.records) {
+            total += r.costUSD;
+        }
+        return total;
+    }
+}
+//# sourceMappingURL=cost-optimizer.js.map

package/dist/cost-optimizer.js.map

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

package/dist/execution-policy-engine.d.ts

@@ -0,0 +1,133 @@
+/**
+ * @module execution-policy-engine
+ * @description 실행 정책 엔진 — `.yuan/policy.json` 또는 YUAN.md에서 정책을 로드하여
+ * 에이전트의 모든 모듈을 단일 소스에서 구성.
+ *
+ * 로드 순서: DEFAULT_POLICY → .yuan/policy.json → YUAN.md 오버라이드
+ */
+export interface ExecutionPolicy {
+    planning: {
+        enabled: boolean;
+        threshold: "simple" | "moderate" | "complex";
+        maxDepth: number;
+        autoReplan: boolean;
+    };
+    speculation: {
+        enabled: boolean;
+        maxApproaches: number;
+        minComplexity: "moderate" | "complex" | "massive";
+    };
+    debate: {
+        enabled: boolean;
+        rounds: number;
+        roles: string[];
+        minComplexity: "moderate" | "complex" | "massive";
+    };
+    verification: {
+        depth: "shallow" | "standard" | "deep";
+        strictness: number;
+        autoTest: boolean;
+        autoBuild: boolean;
+        autoLint: boolean;
+    };
+    cost: {
+        maxTokensPerSession: number;
+        maxTokensPerIteration: number;
+        budgetPerRole: Record<string, number>;
+        preferredModel: string;
+    };
+    safety: {
+        sandboxTier: number;
+        approvalLevel: "none" | "dangerous" | "all";
+        blockedCommands: string[];
+        blockedPaths: string[];
+        secretDetection: boolean;
+    };
+    recovery: {
+        maxRetries: number;
+        maxStrategySwitches: number;
+        enableRollback: boolean;
+        enableScopeReduce: boolean;
+        escalateThreshold: number;
+    };
+    memory: {
+        enabled: boolean;
+        autoSavelearnings: boolean;
+        checkpointThreshold: number;
+        maxCheckpoints: number;
+    };
+    mcp: {
+        enabled: boolean;
+        servers: Array<{
+            name: string;
+            command: string;
+            args?: string[];
+            env?: Record<string, string>;
+        }>;
+    };
+}
+export interface PolicySource {
+    type: "file" | "yuanmd" | "default";
+    path?: string;
+    loadedAt: string;
+}
+export declare const DEFAULT_POLICY: ExecutionPolicy;
+export declare class ExecutionPolicyEngine {
+    private policy;
+    private source;
+    private readonly projectPath;
+    constructor(projectPath: string);
+    /**
+     * Load policy: DEFAULT → .yuan/policy.json → YUAN.md overrides.
+     */
+    load(): Promise<ExecutionPolicy>;
+    /** Get the full current policy. */
+    getPolicy(): ExecutionPolicy;
+    /** Get a specific policy section. */
+    get<K extends keyof ExecutionPolicy>(section: K): ExecutionPolicy[K];
+    /** Override a section at runtime (in-memory only, call save() to persist). */
+    override<K extends keyof ExecutionPolicy>(section: K, values: Partial<ExecutionPolicy[K]>): void;
+    /** Save current policy to .yuan/policy.json (atomic write via tmp + rename). */
+    save(): Promise<void>;
+    /** Get info about where the policy was loaded from. */
+    getSource(): PolicySource;
+    /** Merge a partial policy with defaults. */
+    static mergeWithDefaults(partial: Partial<ExecutionPolicy>): ExecutionPolicy;
+    /** Validate policy values (ranges, enums). Returns all errors, not just the first. */
+    static validate(policy: ExecutionPolicy): {
+        valid: boolean;
+        errors: string[];
+    };
+    /** Convert policy → GovernorConfig shape. */
+    toGovernorConfig(): {
+        planTier: string;
+        customLimits: Record<string, number>;
+    };
+    /** Convert policy → AutoFixConfig shape. */
+    toAutoFixConfig(): {
+        maxRetries: number;
+        autoLint: boolean;
+        autoTest: boolean;
+        autoBuild: boolean;
+    };
+    /** Convert policy → failure recovery config. */
+    toFailureRecoveryConfig(): {
+        maxStrategySwitches: number;
+        enableRollback: boolean;
+        enableScopeReduce: boolean;
+        escalateThreshold: number;
+    };
+    /** Convert policy → ContextManagerConfig shape. */
+    toContextManagerConfig(): {
+        maxContextTokens: number;
+    };
+    /** Convert policy → ExecutionEngineConfig shape (general-purpose). */
+    toExecutionEngineConfig(): Record<string, unknown>;
+    /**
+     * Parse YUAN.md for policy overrides.
+     * Looks for a `## Policy` or `## Configuration` section, then extracts
+     * lines matching `- dotted.key: value`.
+     */
+    private parseYuanMd;
+}
+//# sourceMappingURL=execution-policy-engine.d.ts.map

package/dist/execution-policy-engine.d.ts.map

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