@yuaone/core 0.1.3 → 0.2.0

package/dist/agent-loop.d.ts

@@ -14,6 +14,11 @@ import { ApprovalManager, type ApprovalHandler, type AutoApprovalConfig } from "
 import { AutoFixLoop, type AutoFixConfig } from "./auto-fix.js";
 import { InterruptManager } from "./interrupt-manager.js";
 import type { InterruptSignal } from "./types.js";
+import { type EnvironmentInfo } from "./system-prompt.js";
+import { type HierarchicalPlan } from "./hierarchical-planner.js";
+import { TokenBudgetManager } from "./token-budget.js";
+import { ContinuationEngine } from "./continuation-engine.js";
+import { type MCPServerConfig } from "./mcp-client.js";
 /** AgentLoop 설정 */
 export interface AgentLoopOptions {
     /** 에이전트 설정 */
@@ -32,6 +37,16 @@ export interface AgentLoopOptions {
     autoFixConfig?: Partial<AutoFixConfig>;
     /** 인터럽트 매니저 (외부에서 주입, 미지정 시 내부 생성) */
     interruptManager?: InterruptManager;
+    /** Memory 자동 로드/저장 활성화 (기본 true) */
+    enableMemory?: boolean;
+    /** 환경 정보 (시스템 프롬프트에 포함) */
+    environment?: EnvironmentInfo;
+    /** 자동 플래닝 활성화 (복잡한 태스크 감지 시 계획 수립, 기본 true) */
+    enablePlanning?: boolean;
+    /** 플래닝이 필요한 최소 복잡도 (기본 "moderate") */
+    planningThreshold?: "simple" | "moderate" | "complex";
+    /** MCP 서버 설정 (외부 도구 연동) */
+    mcpServerConfigs?: MCPServerConfig[];
 }
 /**
  * AgentLoop — YUAN 에이전트의 핵심 실행 루프.
@@ -69,15 +84,55 @@ export declare class AgentLoop extends EventEmitter {
     private readonly approvalManager;
     private readonly autoFixLoop;
     private readonly interruptManager;
+    private readonly enableMemory;
+    private readonly enablePlanning;
+    private readonly planningThreshold;
+    private readonly environment?;
+    private yuanMemory;
+    private memoryManager;
+    private planner;
+    private activePlan;
+    private taskClassifier;
+    private promptDefense;
+    private reflexionEngine;
+    private tokenBudgetManager;
+    private allToolResults;
+    private currentTaskIndex;
+    private changedFiles;
     private aborted;
+    private initialized;
+    private continuationEngine;
+    private mcpClient;
+    private mcpToolDefinitions;
+    private readonly mcpServerConfigs;
+    private memoryUpdater;
+    private checkpointSaved;
+    private iterationCount;
     private tokenUsage;
     constructor(options: AgentLoopOptions);
+    /**
+     * Memory와 프로젝트 컨텍스트를 로드하여 시스템 프롬프트를 갱신.
+     * run() 호출 전에 한 번 호출하면 메모리가 자동으로 주입된다.
+     * 이미 초기화되었으면 스킵.
+     */
+    init(): Promise<void>;
+    /**
+     * MemoryManager의 학습/실패 기록을 시스템 메시지로 변환.
+     */
+    private buildMemoryContext;
     /**
      * 에이전트 루프를 실행.
+     * 첫 호출 시 자동으로 Memory와 프로젝트 컨텍스트를 로드한다.
      * @param userMessage 사용자의 요청 메시지
      * @returns 종료 사유 및 결과
      */
     run(userMessage: string): Promise<AgentTermination>;
+    /**
+     * 에이전트 실행 완료 후 메모리를 자동 업데이트한다.
+     * - 변경된 파일 목록 기록
+     * - 성공/실패 패턴 학습
+     */
+    private updateMemoryAfterRun;
     /**
      * 실행 중인 루프를 중단.
      */
@@ -112,6 +167,38 @@ export declare class AgentLoop extends EventEmitter {
      * 수정 시도 기록 등을 조회할 때 사용.
      */
     getAutoFixLoop(): AutoFixLoop;
+    /**
+     * TokenBudgetManager 인스턴스를 반환.
+     * 역할별 토큰 사용량 조회/리밸런싱에 사용.
+     */
+    getTokenBudgetManager(): TokenBudgetManager;
+    /**
+     * 사용자 메시지의 복잡도를 감지하고, 복잡한 태스크이면 계획을 수립하여 컨텍스트에 주입.
+     *
+     * 복잡도 판단 기준:
+     * - 메시지 길이, 파일/작업 수 언급, 키워드 패턴
+     * - "trivial"/"simple" → 플래닝 스킵 (LLM이 직접 처리)
+     * - "moderate" 이상 → HierarchicalPlanner로 L1+L2 계획 수립
+     */
+    private maybeCreatePlan;
+    /**
+     * 사용자 메시지에서 태스크 복잡도를 휴리스틱으로 추정.
+     * LLM 호출 없이 빠르게 결정 (토큰 절약).
+     */
+    private detectComplexity;
+    /**
+     * HierarchicalPlan을 LLM이 따라갈 수 있는 컨텍스트 메시지로 포맷.
+     */
+    private formatPlanForContext;
+    /**
+     * 실행 중 에러 발생 시 리플래닝을 시도한다.
+     * @returns 리플래닝 성공 시 true (계속 진행), 실패 시 false
+     */
+    private attemptReplan;
+    /**
+     * 현재 활성 플랜을 반환 (외부에서 진행 상황 조회용).
+     */
+    getActivePlan(): HierarchicalPlan | null;
     private executeLoop;
     /**
      * LLM을 스트리밍 모드로 호출하여 text delta를 실시간 emit.
@@ -146,6 +233,25 @@ export declare class AgentLoop extends EventEmitter {
      * 도구 인자를 파싱하는 헬퍼.
      */
     private parseToolArgs;
+    /**
+     * 토큰 예산 소진 임박 시 자동 체크포인트를 저장한다.
+     * 현재 진행 상태, 변경 파일, 에러 등을 직렬화.
+     */
+    private saveAutoCheckpoint;
+    /**
+     * 현재 plan에서 진행 상황을 추출한다.
+     */
+    private extractProgress;
+    /**
+     * 현재 작업 메모리 요약을 생성한다.
+     * 최근 도구 결과와 LLM 응답의 핵심만 추출.
+     */
+    private buildWorkingMemorySummary;
+    /**
+     * ContinuationEngine 인스턴스를 반환한다.
+     * 외부에서 체크포인트 조회/관리에 사용.
+     */
+    getContinuationEngine(): ContinuationEngine | null;
     /**
      * InterruptManager 이벤트를 AgentLoop에 연결한다.
      * - soft interrupt: 피드백을 user 메시지로 주입
@@ -157,6 +263,12 @@ export declare class AgentLoop extends EventEmitter {
      * resume 또는 hard interrupt가 올 때까지 블로킹.
      */
     private waitForResume;
+    /** MCP 도구인지 확인 */
+    private isMCPTool;
+    /** MCP 도구 실행 (callToolAsYuan 활용) */
+    private executeMCPTool;
+    /** MCP 클라이언트 정리 (세션 종료 시 호출) */
+    dispose(): Promise<void>;
     private emitEvent;
     private handleFatalError;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"agent-loop.d.ts","sourceRoot":"","sources":["../src/agent-loop.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EACV,WAAW,EAEX,gBAAgB,EAChB,OAAO,EAGP,YAAY,EACZ,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAkB,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAQjF,OAAO,EACL,eAAe,EACf,KAAK,eAAe,EAEpB,KAAK,kBAAkB,EACxB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,WAAW,EACX,KAAK,aAAa,EAEnB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,mBAAmB;AACnB,MAAM,WAAW,gBAAgB;IAC/B,cAAc;IACd,MAAM,EAAE,WAAW,CAAC;IACpB,aAAa;IACb,YAAY,EAAE,YAAY,CAAC;IAC3B,+BAA+B;IAC/B,cAAc,EAAE,cAAc,CAAC;IAC/B,wBAAwB;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC9C,gBAAgB;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC7C,2BAA2B;IAC3B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,kBAAkB;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACvC,sCAAsC;IACtC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,SAAU,SAAQ,YAAY;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAa;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAKhB;gBAEU,OAAO,EAAE,gBAAgB;IA0CrC;;;;OAIG;IACG,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAkBzD;;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;;OAEG;IACH,UAAU,IAAI,OAAO,EAAE;IAIvB;;;OAGG;IACH,kBAAkB,IAAI,eAAe;IAIrC;;;OAGG;IACH,cAAc,IAAI,WAAW;YAMf,WAAW;IAyIzB;;;OAGG;YACW,gBAAgB;IAoD9B;;;;;;;OAOG;YACW,YAAY;IA+H1B;;;OAGG;YACW,cAAc;IAiB5B;;;OAGG;YACW,qBAAqB;IA8BnC;;;OAGG;YACW,mBAAmB;IA0DjC;;OAEG;IACH,OAAO,CAAC,aAAa;IAerB;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;IAe/B;;;OAGG;IACH,OAAO,CAAC,aAAa;IA2BrB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,gBAAgB;CAWzB"}
+{"version":3,"file":"agent-loop.d.ts","sourceRoot":"","sources":["../src/agent-loop.ts"],"names":[],"mappings":"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"}