npm - @yuaone/core - Versions diffs - 0.4.9 → 0.6.1 - Mend

@yuaone/core 0.4.9 → 0.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (18) hide show

package/README.md CHANGED Viewed

@@ -1,15 +1,59 @@
-# @yuan/core
+# @yuaone/core
 Agent runtime for YUAN coding agent.
-Part of [YUAN](../../README.md).
+```bash
+npm install @yuaone/core
+```
-## Install
+## Usage
-```bash
-npm install @yuan/core
+```typescript
+import { AgentLoop, createAgentLoop } from "@yuaone/core";
+const loop = createAgentLoop({
+  provider: "anthropic",
+  apiKey: process.env.ANTHROPIC_API_KEY,
+  model: "claude-sonnet-4-6",
+  workDir: process.cwd(),
+});
+for await (const event of loop.run("refactor auth.ts to async/await")) {
+  if (event.kind === "agent:token") process.stdout.write(event.content);
+  if (event.kind === "agent:completed") break;
+}
+```
+## Architecture
+| Module | Description |
+|--------|-------------|
+| `AgentLoop` | Core tool-use loop — LLM ↔ tools ↔ approval |
+| `HierarchicalPlanner` | Task decomposition with dependency ordering |
+| `ExecutionPolicyEngine` | Token/cost budget per iteration |
+| `ContinuationEngine` | Checkpoint every 3 iters, recovery on error |
+| `ReflexionEngine` | Per-iteration self-reflection & insight injection |
+| `WorldStateCollector` | Tracks file changes across iterations |
+| `QAPipeline` | Quick + thorough quality checks post-execution |
+| `Governor` | Safety/security scanning before tool execution |
+| `AutoFix` | Automatic lint/type error repair |
+| `ContextManager` | Token budget management & compaction |
+## Events
+```typescript
+type AgentEvent =
+  | { kind: "agent:thinking"; content: string }
+  | { kind: "agent:token"; content: string }
+  | { kind: "agent:tool_call"; toolName: string; arguments: unknown }
+  | { kind: "agent:tool_result"; toolName: string; result: string; durationMs: number }
+  | { kind: "agent:approval_needed"; action: { tool: string; input: unknown } }
+  | { kind: "agent:completed"; message: string }
+  | { kind: "agent:error"; message: string; retryable: boolean }
+  | { kind: "agent:token_usage"; input: number; output: number }
+  | { kind: "agent:qa_result"; stage: "quick" | "thorough"; passed: boolean; issues: string[] }
 ```
 ## License
-AGPL-3.0
+AGPL-3.0 — part of [YUAN](https://github.com/yuaone/yuan).

package/dist/agent-loop.d.ts CHANGED Viewed

@@ -75,33 +75,6 @@ export interface AgentLoopOptions {
     /** Enable background agents (persistent monitors, default false — opt-in) */
     enableBackgroundAgents?: boolean;
 }
-/**
- * AgentLoop — YUAN 에이전트의 핵심 실행 루프.
- *
- * 동작 흐름:
- * 1. 사용자 메시지 수신
- * 2. 시스템 프롬프트 + 히스토리로 LLM 호출
- * 3. LLM 응답에서 tool_call 파싱
- * 4. Governor가 안전성 검증
- * 5. 도구 실행 → 결과를 히스토리에 추가
- * 6. LLM에 결과 피드백 → 2번으로 반복
- * 7. 종료 조건 충족 시 결과 반환
- *
- * @example
- * ```typescript
- * const loop = new AgentLoop({
- *   config: agentConfig,
- *   toolExecutor: executor,
- *   governorConfig: { planTier: "PRO" },
- * });
- *
- * loop.on("event", (event: AgentEvent) => {
- *   // SSE 스트리밍
- * });
- *
- * const result = await loop.run("모든 console.log를 제거해줘");
- * ```
- */
 export declare class AgentLoop extends EventEmitter {
     private readonly abortSignal?;
     private readonly llmClient;
@@ -419,6 +392,11 @@ export declare class AgentLoop extends EventEmitter {
     private handleSoftContextOverflow;
     /** MCP 클라이언트 정리 (세션 종료 시 호출) */
     dispose(): Promise<void>;
+    /**
+     * Builds a Map<filePath, toolOutput> for all changed files from write/edit tool results.
+     * Used by selfReflection deepVerify and quickVerify.
+     */
+    private buildChangedFilesMap;
     private emitEvent;
     private emitReasoning;
     private emitSubagent;

package/dist/agent-loop.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"agent-loop.d.ts","sourceRoot":"","sources":["../src/agent-loop.ts"],"names":[],"mappings":"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~~AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH~~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~~IAySzD~~;;;;OAIG;YACW,oBAAoB;IAuGlC;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAcxC;;;OAGG;IACH,mBAAmB,IAAI,gBAAgB;IAIvC;;OAEG;IACH,aAAa,IAAI,QAAQ,CAAC,UAAU,CAAC;IAIrC,sDAAsD;IACtD,iBAAiB,IAAI,cAAc;IAInC,qEAAqE;IACrE,qBAAqB,IAAI,kBAAkB;IAI3C,2CAA2C;IAC3C,eAAe,IAAI,YAAY,GAAG,IAAI;IAItC,mCAAmC;IACnC,YAAY,IAAI,kBAAkB,GAAG,IAAI;IAIzC,mCAAmC;IACnC,yBAAyB,IAAI,sBAAsB,GAAG,IAAI;IAI1D;;;OAGG;IACH,gBAAgB,IAAI,kBAAkB;IAkCtC;;;OAGG;IACH,uBAAuB,IAAI,oBAAoB,GAAG,IAAI;IAItD;;OAEG;IACH,UAAU,IAAI,OAAO,EAAE;IAIvB;;;OAGG;IACH,kBAAkB,IAAI,eAAe;IAIrC;;;OAGG;IACH,cAAc,IAAI,WAAW;IAI7B;;;OAGG;IACH,qBAAqB,IAAI,kBAAkB;IAM3C;;;;;;;OAOG;YACW,eAAe;IAsD7B;;;OAGG;IACH;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IA+BzB,OAAO,CAAC,gBAAgB;IAuDxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA4C5B;;;OAGG;YACW,aAAa;IAiE3B;;OAEG;IACH,aAAa,IAAI,gBAAgB,GAAG,IAAI;YAM1B,WAAW;~~IA23BzB~~;;;OAGG;YACW,gBAAgB;IA2I9B;;;;;;;OAOG;IACH;;OAEG;YACW,iBAAiB;~~YA2OjB~~,YAAY;IAgI1B;;;OAGG;YACW,cAAc;IAiB5B;;;OAGG;YACW,qBAAqB;IA8BnC;;;OAGG;YACW,mBAAmB;IAuDjC;;OAEG;IACH,OAAO,CAAC,aAAa;IAmBrB;;;OAGG;YACW,kBAAkB;IAuChC;;OAEG;IACH,OAAO,CAAC,eAAe;IAiBvB;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IAwBjC;;;OAGG;IACH,qBAAqB,IAAI,kBAAkB,GAAG,IAAI;IAIlD;;OAEG;IACH,kBAAkB,IAAI,eAAe;IAIrC;;OAEG;IACH,eAAe,IAAI,qBAAqB,GAAG,IAAI;IAI/C;;OAEG;IACH,aAAa,IAAI,kBAAkB,GAAG,IAAI;IAM1C;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;IAe/B;;;OAGG;IACH,OAAO,CAAC,aAAa;IA2BrB;;;OAGG;YACW,iBAAiB;IAsB/B;;;OAGG;YACW,8BAA8B;IAmD5C;;;OAGG;YACW,uBAAuB;IAuCrC;;OAEG;IACH,gBAAgB,IAAI,aAAa;IAIjC;;OAEG;IACH,iBAAiB,IAAI,cAAc,GAAG,IAAI;IAM1C,kBAAkB;IAClB,OAAO,CAAC,SAAS;IAIjB,oCAAoC;YACtB,cAAc;IAI5B;;;;OAIG;YACW,yBAAyB;IAevC,gCAAgC;IAC1B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAY9B,OAAO,CAAC,SAAS;IAGjB,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,gBAAgB;CAazB"}
1	+ {"version":3,"file":"agent-loop.d.ts","sourceRoot":"","sources":["../src/agent-loop.ts"],"names":[],"mappings":"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"}

package/dist/agent-loop.js CHANGED Viewed

@@ -77,6 +77,8 @@ import { QAPipeline } from "./qa-pipeline.js";
  * const result = await loop.run("모든 console.log를 제거해줘");
  * ```
  */
+/** Minimum confidence for classification-based hints/routing to activate */
+const CLASSIFICATION_CONFIDENCE_THRESHOLD = 0.6;
 export class AgentLoop extends EventEmitter {
     abortSignal;
     llmClient;
@@ -481,7 +483,7 @@ export class AgentLoop extends EventEmitter {
             const learnedSkills = this.skillLearner.getAllSkills();
             if (learnedSkills.length > 0) {
                 const skillNames = learnedSkills
-                    .filter((s) => s.confidence >= 0.3)
+                    .filter((s) => s.confidence >= CLASSIFICATION_CONFIDENCE_THRESHOLD)
                     .map((s) => s.id);
                 if (skillNames.length > 0) {
                     this.contextManager.addMessage({
@@ -615,7 +617,7 @@ export class AgentLoop extends EventEmitter {
     buildMemoryContext(memory) {
         const parts = [];
         // 높은 confidence 학습만 포함
-        const highConfLearnings = memory.learnings.filter((l) => l.confidence >= 0.3);
+        const highConfLearnings = memory.learnings.filter((l) => l.confidence >= CLASSIFICATION_CONFIDENCE_THRESHOLD);
         if (highConfLearnings.length > 0) {
             parts.push("## Things I've Learned About This Project");
             for (const l of highConfLearnings.slice(0, 20)) {
@@ -648,6 +650,8 @@ export class AgentLoop extends EventEmitter {
         this.aborted = false;
         this.reasoningAggregator.reset();
         this.reasoningTree.reset();
+        // Capture before reset so session snapshot gets accurate file list
+        const prevChangedFiles = [...this.changedFiles];
         if (!this.resumedFromSession) {
             this.changedFiles = [];
             this.allToolResults = [];
@@ -698,7 +702,7 @@ export class AgentLoop extends EventEmitter {
                 snapshot,
                 messages: this.contextManager.getMessages(),
                 plan: this.activePlan,
-                changedFiles: this.changedFiles,
+                changedFiles: prevChangedFiles,
             });
         }
         // 사용자 입력 검증 (prompt injection 방어)
@@ -738,7 +742,7 @@ export class AgentLoop extends EventEmitter {
             }
             // Task 분류 → 시스템 프롬프트에 tool sequence hint 주입
             const classification = this.taskClassifier.classify(userMessage);
-            if (classification.confidence >= 0.3) {
+            if (classification.confidence >= CLASSIFICATION_CONFIDENCE_THRESHOLD) {
                 const classificationHint = this.taskClassifier.formatForSystemPrompt(classification);
                 this.contextManager.addMessage({
                     role: "system",
@@ -748,7 +752,7 @@ export class AgentLoop extends EventEmitter {
             // Specialist routing: 태스크 타입에 맞는 전문 에이전트 설정 주입
             if (classification.specialistDomain) {
                 const specialistMatch = this.specialistRegistry.findSpecialist(classification.specialistDomain);
-                if (specialistMatch && specialistMatch.confidence >= 0.5) {
+                if (specialistMatch && specialistMatch.confidence >= CLASSIFICATION_CONFIDENCE_THRESHOLD) {
                     this.contextManager.addMessage({
                         role: "system",
                         content: `[Specialist: ${specialistMatch.specialist.name}] ${specialistMatch.specialist.systemPrompt.slice(0, 500)}`,
@@ -756,13 +760,13 @@ export class AgentLoop extends EventEmitter {
                 }
             }
             // Tool Planning: 태스크 타입에 맞는 도구 실행 계획 힌트 주입
-            if (this.enableToolPlanning && classification.confidence >= 0.3) {
+            if (this.enableToolPlanning && classification.confidence >= CLASSIFICATION_CONFIDENCE_THRESHOLD) {
                 const planContext = {
                     userMessage,
                 };
                 this.currentToolPlan = this.toolPlanner.planForTask(classification.type, planContext);
                 this.executedToolNames = [];
-                if (this.currentToolPlan.confidence >= 0.5) {
+                if (this.currentToolPlan.confidence >= CLASSIFICATION_CONFIDENCE_THRESHOLD) {
                     const planHint = this.toolPlanner.formatPlanHint(this.currentToolPlan);
                     this.contextManager.addMessage({
                         role: "system",
@@ -903,6 +907,18 @@ export class AgentLoop extends EventEmitter {
             return result;
         }
         catch (err) {
+            // Attempt recovery from last checkpoint via ContinuationEngine
+            if (this.continuationEngine) {
+                try {
+                    const recovered = await this.continuationEngine.findLatestCheckpoint();
+                    if (recovered) {
+                        this.emitReasoning(`recovered from checkpoint at iteration ${recovered.iterationsCompleted ?? "unknown"}`);
+                    }
+                }
+                catch {
+                    // Recovery failure is non-fatal
+                }
+            }
             return this.handleFatalError(err);
         }
     }
@@ -1409,7 +1425,21 @@ export class AgentLoop extends EventEmitter {
             this.iterationCount = iteration;
             const iterationStart = Date.now();
             this.emitReasoning(`iteration ${iteration}: preparing context`);
-            this.iterationSystemMsgCount = 0; // Reset per-iteration system message counter
+            this.iterationSystemMsgCount = 0; // Reset per-iteration (prevents accumulation across iterations)
+            // Policy validation — check cost limits from ExecutionPolicyEngine
+            if (this.policyEngine) {
+                try {
+                    const costPolicy = this.policyEngine.get("cost");
+                    const iterationTokensUsed = this.tokenUsage.input + this.tokenUsage.output;
+                    if (costPolicy.maxTokensPerIteration > 0 && iterationTokensUsed > costPolicy.maxTokensPerIteration) {
+                        this.emitReasoning(`policy blocked iteration ${iteration}: token usage ${iterationTokensUsed} exceeds maxTokensPerIteration ${costPolicy.maxTokensPerIteration}`);
+                        return { reason: "BUDGET_EXHAUSTED", tokensUsed: iterationTokensUsed };
+                    }
+                }
+                catch {
+                    // Policy engine failure is non-fatal
+                }
+            }
             // Soft context rollover:
             // checkpoint first, then let ContextManager compact instead of aborting/throwing.
             const contextUsageRatio = this.contextManager.getUsageRatio();
@@ -1576,15 +1606,7 @@ export class AgentLoop extends EventEmitter {
                 // Level 2: Deep verification before declaring completion
                 if (this.selfReflection && this.changedFiles.length > 0) {
                     try {
-                        const changedFilesMap = new Map();
-                        for (const filePath of this.changedFiles) {
-                            const lastWrite = this.allToolResults
-                                .filter((r) => r.name === "file_write" || r.name === "file_edit")
-                                .find((r) => r.output.includes(filePath));
-                            if (lastWrite) {
-                                changedFilesMap.set(filePath, lastWrite.output);
-                            }
-                        }
+                        const changedFilesMap = this.buildChangedFilesMap();
                         const verifyFn = async (prompt) => {
                             const verifyResponse = await this.llmClient.chat([
                                 { role: "system", content: "You are a meticulous code reviewer." },
@@ -1698,9 +1720,15 @@ export class AgentLoop extends EventEmitter {
                         const thoroughFailures = thoroughResult.stages
                             .flatMap((s) => s.checks)
                             .filter((c) => c.status === "fail");
+                        const thoroughIssues = thoroughFailures
+                            .slice(0, 10)
+                            .map((c) => `[${c.severity}] ${c.name}: ${c.message}`);
+                        // Emit structured qa_result event for TUI display
                         this.emitEvent({
-                            kind: "agent:thinking",
-                            content: `QA thorough check at completion: ${thoroughResult.overall} (${thoroughFailures.length} failure(s) across ${this.changedFiles.length} file(s)).`,
+                            kind: "agent:qa_result",
+                            stage: "thorough",
+                            passed: thoroughFailures.length === 0,
+                            issues: thoroughIssues,
                         });
                         this.lastQAResult = thoroughResult;
                     }
@@ -1791,6 +1819,16 @@ export class AgentLoop extends EventEmitter {
                     const failedChecks = qaResult.stages
                         .flatMap((s) => s.checks)
                         .filter((c) => c.status === "fail" || c.status === "warn");
+                    const qaIssues = failedChecks
+                        .slice(0, 10)
+                        .map((c) => `[${c.severity}] ${c.name}: ${c.message}`);
+                    // Emit structured qa_result event for TUI display
+                    this.emitEvent({
+                        kind: "agent:qa_result",
+                        stage: "quick",
+                        passed: failedChecks.length === 0,
+                        issues: qaIssues,
+                    });
                     if (failedChecks.length > 0 && this.iterationSystemMsgCount < 5) {
                         const checkSummary = failedChecks
                             .slice(0, 5)
@@ -1801,16 +1839,6 @@ export class AgentLoop extends EventEmitter {
                             content: `[QA Quick Check] ${failedChecks.length} issue(s) detected in modified files:\n${checkSummary}`,
                         });
                         this.iterationSystemMsgCount++;
-                        this.emitEvent({
-                            kind: "agent:thinking",
-                            content: `QA quick check: ${failedChecks.length} issue(s) in ${this.iterationWriteToolPaths.length} file(s).`,
-                        });
-                    }
-                    else if (failedChecks.length === 0) {
-                        this.emitEvent({
-                            kind: "agent:thinking",
-                            content: `QA quick check passed for ${this.iterationWriteToolPaths.length} file(s).`,
-                        });
                     }
                 }
                 catch {
@@ -1890,20 +1918,41 @@ export class AgentLoop extends EventEmitter {
                 };
                 await this.sessionPersistence.checkpoint(this.sessionId, checkpoint);
             }
+            // ReflexionEngine: reflect on this iteration's tool results
+            if (this.reflexionEngine && toolResults.length > 0) {
+                try {
+                    const iterReflection = this.reflexionEngine.reflect({
+                        goal: "",
+                        runId: `iter-${iteration}-${randomUUID()}`,
+                        termination: { reason: "USER_CANCELLED" },
+                        toolResults,
+                        messages: this.contextManager.getMessages(),
+                        tokensUsed: this.tokenUsage.total,
+                        durationMs: Date.now() - iterationStart,
+                        changedFiles: this.changedFiles,
+                    });
+                    // Build insight from available reflection fields
+                    const insight = iterReflection.reflection.alternativeApproach ??
+                        (iterReflection.reflection.whatFailed.length > 0
+                            ? iterReflection.reflection.whatFailed.slice(0, 2).join("; ")
+                            : null);
+                    if (insight && insight.length > 10 && this.iterationSystemMsgCount < 5) {
+                        this.contextManager.addMessage({
+                            role: "system",
+                            content: `[Reflection] ${insight}`,
+                        });
+                        this.iterationSystemMsgCount++;
+                    }
+                }
+                catch {
+                    // Reflection failure is non-fatal
+                }
+            }
             // Level 1: Quick verification after every 3rd iteration
             if (this.selfReflection && iteration % 3 === 0) {
                 try {
                     this.emitSubagent("verifier", "start", "running quick verification");
-                    const changedFilesMap = new Map();
-                    for (const filePath of this.changedFiles) {
-                        // Collect changed file contents from tool results
-                        const lastWrite = this.allToolResults
-                            .filter((r) => r.name === "file_write" || r.name === "file_edit")
-                            .find((r) => r.output.includes(filePath));
-                        if (lastWrite) {
-                            changedFilesMap.set(filePath, lastWrite.output);
-                        }
-                    }
+                    const changedFilesMap = this.buildChangedFilesMap();
                     const quickResult = await this.selfReflection.quickVerify(changedFilesMap, async (prompt) => {
                         const verifyResponse = await this.llmClient.chat([
                             { role: "system", content: "You are a code verification assistant." },
@@ -2105,6 +2154,28 @@ export class AgentLoop extends EventEmitter {
                 await this.saveAutoCheckpoint(iteration);
                 this.checkpointSaved = true;
             }
+            // ContinuationEngine: checkpoint current state after each iteration (every 3 iterations, non-fatal)
+            if (this.continuationEngine && iteration > 0 && iteration % 3 === 0 && !this.checkpointSaved) {
+                try {
+                    const progress = this.extractProgress();
+                    await this.continuationEngine.saveCheckpoint({
+                        sessionId: this.sessionId ?? `session-${Date.now()}`,
+                        goal: this.contextManager.getMessages().find((m) => m.role === "user")?.content ?? "",
+                        progress,
+                        changedFiles: [...this.changedFiles].map((p) => ({ path: p, diff: "" })),
+                        workingMemory: this.buildWorkingMemorySummary(),
+                        yuanMdUpdates: [],
+                        errors: [],
+                        contextUsageAtSave: this.config.loop.totalTokenBudget > 0 ? this.tokenUsage.total / this.config.loop.totalTokenBudget : 0,
+                        totalTokensUsed: this.tokenUsage.total,
+                        iterationsCompleted: iteration,
+                        createdAt: new Date(),
+                    });
+                }
+                catch {
+                    // Checkpoint failure is non-fatal
+                }
+            }
             // ContinuousReflection: 매 5 iteration마다 비상 체크포인트 트리거
             // (정기 타이머 외에 iteration 기반 추가 안전망)
             if (this.continuousReflection?.isRunning() &&
@@ -2432,8 +2503,22 @@ export class AgentLoop extends EventEmitter {
                     this.iterationTsFilesModified.push(filePathStr);
                 }
                 this.emitEvent({ kind: "agent:file_change", path: filePathStr, diff: result.output });
+                // Update world state after file modification
+                if (this.config.loop.projectPath) {
+                    const wsProjectPath = this.config.loop.projectPath;
+                    new WorldStateCollector({ projectPath: wsProjectPath, skipTest: true })
+                        .collect()
+                        .then((snapshot) => { this.worldState = snapshot; })
+                        .catch(() => {
+                        // Non-fatal: world state update failure should not interrupt tool execution
+                    });
+                }
                 if (this.impactAnalyzer) {
-                    this.analyzeFileImpact(filePathStr).catch(() => { });
+                    this.analyzeFileImpact(filePathStr).catch((err) => {
+                        // Non-fatal: impact analysis failure should not interrupt tool execution
+                        const msg = err instanceof Error ? err.message : String(err);
+                        console.warn(`[AgentLoop] impact analysis skipped for ${filePathStr}: ${msg}`);
+                    });
                 }
             }
             const fixPrompt = await this.validateAndFeedback(toolCall.name, result);
@@ -3022,6 +3107,22 @@ export class AgentLoop extends EventEmitter {
         }
     }
     // ─── Helpers ───
+    /**
+     * Builds a Map<filePath, toolOutput> for all changed files from write/edit tool results.
+     * Used by selfReflection deepVerify and quickVerify.
+     */
+    buildChangedFilesMap() {
+        const map = new Map();
+        for (const filePath of this.changedFiles) {
+            const lastWrite = this.allToolResults
+                .filter((r) => r.name === "file_write" || r.name === "file_edit")
+                .find((r) => r.output.includes(filePath));
+            if (lastWrite) {
+                map.set(filePath, lastWrite.output);
+            }
+        }
+        return map;
+    }
     emitEvent(event) {
         this.emit("event", event);
     }