@yuaone/core 0.9.43 → 1.0.1

package/dist/prompt-builder.js

@@ -0,0 +1,93 @@
+/**
+ * @module prompt-builder
+ * @description YUAN PromptBuilder -- dumb renderer.
+ *
+ * Rules:
+ * 1. PromptEnvelope -> string conversion only
+ * 2. No policy decisions (mode, budget, role interpretation forbidden)
+ * 3. Section order: core -> policy -> role -> context -> ephemeral -> reinforce
+ * 4. When token budget exceeded, droppable sections are removed first
+ *
+ * YUA reference: prompt-builder.ts (1436 lines) -- YUAN is much thinner
+ */
+/** Rough token estimation (1 token ~ 3.5 chars for mixed Korean/English) */
+function estimateTokens(text) {
+    return Math.ceil(text.length / 3.5);
+}
+/** Section separator used between prompt sections */
+const SECTION_SEP = "\n\n---\n\n";
+function sortGroup(sections) {
+    return [...sections].sort((a, b) => a.priority - b.priority);
+}
+function orderedGroups(envelope) {
+    return [
+        sortGroup(envelope.systemCoreSections),
+        sortGroup(envelope.runtimePolicySections),
+        sortGroup(envelope.roleSections),
+        sortGroup(envelope.taskContextSections),
+        sortGroup(envelope.ephemeralSections),
+        sortGroup(envelope.reinforceSections),
+    ];
+}
+function appendSection(current, next) {
+    if (!current.trim())
+        return next.trim();
+    return `${current}${SECTION_SEP}${next.trim()}`.trim();
+}
+/**
+ * PromptEnvelope -> final system prompt string.
+ * No decisions. Just concatenation.
+ *
+ * @param envelope - The compiled prompt envelope from PromptRuntime
+ * @param maxTokens - Optional token budget. If set, droppable sections are
+ *                    removed (lowest priority first) until budget is met.
+ *                    Required sections (droppable=false) are never removed.
+ * @returns Final system prompt string ready for LLM consumption
+ */
+export function buildPrompt(envelope, maxTokens) {
+    // envelope.maxTokens가 있으면 우선 사용 (PromptRuntime이 예산 계산)
+    const effectiveMaxTokens = maxTokens ?? envelope.maxTokens;
+    const groups = orderedGroups(envelope);
+    const allSections = groups.flat();
+    // No token budget -> include everything
+    if (!effectiveMaxTokens) {
+        return joinSections(allSections);
+    }
+    // Preserve canonical zone order:
+    // core -> policy -> role -> context -> ephemeral -> reinforce
+    // Required sections are always kept; droppable sections are appended in-group
+    // until budget is exhausted.
+    let result = "";
+    let usedTokens = 0;
+    for (const group of groups) {
+        for (const s of group) {
+            if (!s.content.length || s.droppable)
+                continue;
+            const next = appendSection(result, s.content);
+            result = next;
+            usedTokens = estimateTokens(result);
+        }
+    }
+    for (const group of groups) {
+        for (const s of group) {
+            if (!s.content.length || !s.droppable)
+                continue;
+            const candidate = appendSection(result, s.content);
+            const candidateTokens = estimateTokens(candidate);
+            if (candidateTokens <= effectiveMaxTokens) {
+                result = candidate;
+                usedTokens = candidateTokens;
+            }
+        }
+    }
+    return result.trim();
+}
+/** Join non-empty sections with separator */
+function joinSections(sections) {
+    return sections
+        .filter(s => s.content.length > 0)
+        .map(s => s.content)
+        .join(SECTION_SEP)
+        .trim();
+}
+//# sourceMappingURL=prompt-builder.js.map

package/dist/prompt-builder.js.map

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

package/dist/prompt-envelope.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @module prompt-envelope
+ * @description PromptRuntime → PromptBuilder 전달 계약.
+ * PromptBuilder는 이 타입만 받아서 string으로 렌더링.
+ * 정책 판단 불가, 필드 해석 불가 — 문자열 합치기만.
+ */
+/** 프롬프트 섹션 하나 */
+export interface PromptSection {
+    /** 섹션 이름 (디버그/로깅용) */
+    name: string;
+    /** 섹션 내용 */
+    content: string;
+    /** 우선순위 (낮을수록 먼저, 같으면 삽입 순서) */
+    priority: number;
+    /** 토큰 예산 초과 시 삭제 가능 여부 */
+    droppable: boolean;
+}
+/** PromptRuntime이 생성, PromptBuilder가 소비 */
+export interface PromptEnvelope {
+    /** 불변 헌법 (정체성, safety, core rules) — 항상 첫 번째 */
+    systemCoreSections: PromptSection[];
+    /** Decision 기반 정책 (mode, role, budget hints, veto hints) */
+    runtimePolicySections: PromptSection[];
+    /** 역할 섹션 (planner/coder/verifier — Decision에서 결정) */
+    roleSections: PromptSection[];
+    /** 태스크 컨텍스트 (worldState, memory, skills, project) */
+    taskContextSections: PromptSection[];
+    /** 이번 iteration 전용 (반복당 힌트: QA, reflection, budget warning) */
+    ephemeralSections: PromptSection[];
+    /** 강화 섹션 (U-curve 두 번째 피크 — 마지막에 배치) */
+    reinforceSections: PromptSection[];
+    /** system prompt 토큰 예산 (PromptBuilder가 이 한도 내에서 droppable 관리) */
+    maxTokens?: number;
+}
+/** section 생성 헬퍼 */
+export declare function section(name: string, content: string, opts?: {
+    priority?: number;
+    droppable?: boolean;
+}): PromptSection;
+//# sourceMappingURL=prompt-envelope.d.ts.map

package/dist/prompt-envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-envelope.d.ts","sourceRoot":"","sources":["../src/prompt-envelope.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,iBAAiB;AACjB,MAAM,WAAW,aAAa;IAC5B,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,2CAA2C;AAC3C,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,kBAAkB,EAAE,aAAa,EAAE,CAAC;IACpC,4DAA4D;IAC5D,qBAAqB,EAAE,aAAa,EAAE,CAAC;IACvC,qDAAqD;IACrD,YAAY,EAAE,aAAa,EAAE,CAAC;IAC9B,qDAAqD;IACrD,mBAAmB,EAAE,aAAa,EAAE,CAAC;IACrC,+DAA+D;IAC/D,iBAAiB,EAAE,aAAa,EAAE,CAAC;IACnC,wCAAwC;IACxC,iBAAiB,EAAE,aAAa,EAAE,CAAC;IACnC,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,oBAAoB;AACpB,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,GAAG,aAAa,CAOhB"}

package/dist/prompt-envelope.js

@@ -0,0 +1,16 @@
+/**
+ * @module prompt-envelope
+ * @description PromptRuntime → PromptBuilder 전달 계약.
+ * PromptBuilder는 이 타입만 받아서 string으로 렌더링.
+ * 정책 판단 불가, 필드 해석 불가 — 문자열 합치기만.
+ */
+/** section 생성 헬퍼 */
+export function section(name, content, opts) {
+    return {
+        name,
+        content,
+        priority: opts?.priority ?? 50,
+        droppable: opts?.droppable ?? false,
+    };
+}
+//# sourceMappingURL=prompt-envelope.js.map

package/dist/prompt-envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-envelope.js","sourceRoot":"","sources":["../src/prompt-envelope.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgCH,oBAAoB;AACpB,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,OAAe,EAAE,IAGtD;IACC,OAAO;QACL,IAAI;QACJ,OAAO;QACP,QAAQ,EAAE,IAAI,EAAE,QAAQ,IAAI,EAAE;QAC9B,SAAS,EAAE,IAAI,EAAE,SAAS,IAAI,KAAK;KACpC,CAAC;AACJ,CAAC"}

package/dist/prompt-runtime.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @module prompt-runtime
+ * @description YUAN PromptRuntime -- Decision policy compiler.
+ *
+ * Rules:
+ * 1. Consumes DecisionContext ONLY (no new decisions)
+ * 2. Produces PromptEnvelope -> delegates to PromptBuilder
+ * 3. agent-loop calls this instead of directly injecting system messages
+ *
+ * YUA reference: prompt-runtime.ts (876 lines)
+ * YUAN difference: coding agent specialized (tool budget hints, veto hints, plan context)
+ */
+import type { PromptEnvelope } from "./prompt-envelope.js";
+import type { AgentDecisionContext } from "./agent-decision-types.js";
+import type { SystemPromptOptions } from "./system-prompt.js";
+/** PromptRuntime input -- provided by agent-loop */
+/** Context window 토큰 예산 배분 */
+export interface PromptTokenBudget {
+    /** 모델 전체 컨텍스트 윈도우 (토큰) */
+    contextWindow: number;
+    /** system prompt 최대 비율 (0~1, 기본 0.25) */
+    systemPromptRatio: number;
+    /** conversation 비율 (0~1, 기본 0.40) */
+    conversationRatio: number;
+    /** tool results 비율 (0~1, 기본 0.20) */
+    toolResultsRatio: number;
+    /** LLM 출력 여유 비율 (0~1, 기본 0.15) */
+    outputReserveRatio: number;
+}
+/** 모델별 기본 예산 */
+export declare const DEFAULT_TOKEN_BUDGETS: Record<string, PromptTokenBudget>;
+/** system prompt에 쓸 수 있는 최대 토큰 계산 */
+export declare function getSystemPromptMaxTokens(budget: PromptTokenBudget): number;
+export interface PromptRuntimeInput {
+    /** Decision Engine result (null = legacy fallback) */
+    decision: AgentDecisionContext | null;
+    /** Existing buildSystemPrompt options (backward compat) */
+    promptOptions: SystemPromptOptions;
+    /** Per-run context (memory, persona, reflexion, etc.) */
+    runContext?: {
+        memoryContext?: string;
+        personaSection?: string;
+        reflexionGuidance?: string;
+        taskMemory?: string;
+        ragContext?: string;
+        playbookHint?: string;
+        continuationPrompt?: string;
+        worldStateSection?: string;
+        weaknessContext?: string;
+        learnedSkills?: string;
+        pluginSkills?: string;
+    };
+    /** Per-iteration ephemeral hints (QA, reflection, budget, etc.) */
+    ephemeralHints?: string[];
+    /** 토큰 예산 (없으면 default 사용) */
+    tokenBudget?: PromptTokenBudget;
+}
+/**
+ * Decision + Context -> PromptEnvelope.
+ * This function is the SOLE place that decides "what goes into the prompt".
+ *
+ * PromptRuntime does NOT make new decisions -- only reads DecisionContext.
+ * PromptRuntime does NOT produce prompt strings -- only produces PromptEnvelope.
+ */
+export declare function compilePromptEnvelope(input: PromptRuntimeInput): PromptEnvelope;
+//# sourceMappingURL=prompt-runtime.d.ts.map

package/dist/prompt-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-runtime.d.ts","sourceRoot":"","sources":["../src/prompt-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,sBAAsB,CAAC;AAG1E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAI9D,oDAAoD;AACpD,8BAA8B;AAC9B,MAAM,WAAW,iBAAiB;IAChC,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qCAAqC;IACrC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qCAAqC;IACrC,gBAAgB,EAAE,MAAM,CAAC;IACzB,kCAAkC;IAClC,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,gBAAgB;AAChB,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CA6BnE,CAAC;AAEF,qCAAqC;AACrC,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAE1E;AAED,MAAM,WAAW,kBAAkB;IACjC,sDAAsD;IACtD,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAEtC,2DAA2D;IAC3D,aAAa,EAAE,mBAAmB,CAAC;IAEnC,yDAAyD;IACzD,UAAU,CAAC,EAAE;QACX,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IAEF,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B,6BAA6B;IAC7B,WAAW,CAAC,EAAE,iBAAiB,CAAC;CACjC;AAID;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,kBAAkB,GAAG,cAAc,CAkC/E"}