@yuaone/core 0.1.0

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 (235) hide show
  1. package/LICENSE +663 -0
  2. package/README.md +15 -0
  3. package/dist/__tests__/context-manager.test.d.ts +6 -0
  4. package/dist/__tests__/context-manager.test.d.ts.map +1 -0
  5. package/dist/__tests__/context-manager.test.js +220 -0
  6. package/dist/__tests__/context-manager.test.js.map +1 -0
  7. package/dist/__tests__/governor.test.d.ts +6 -0
  8. package/dist/__tests__/governor.test.d.ts.map +1 -0
  9. package/dist/__tests__/governor.test.js +210 -0
  10. package/dist/__tests__/governor.test.js.map +1 -0
  11. package/dist/__tests__/model-router.test.d.ts +6 -0
  12. package/dist/__tests__/model-router.test.d.ts.map +1 -0
  13. package/dist/__tests__/model-router.test.js +329 -0
  14. package/dist/__tests__/model-router.test.js.map +1 -0
  15. package/dist/agent-logger.d.ts +384 -0
  16. package/dist/agent-logger.d.ts.map +1 -0
  17. package/dist/agent-logger.js +820 -0
  18. package/dist/agent-logger.js.map +1 -0
  19. package/dist/agent-loop.d.ts +163 -0
  20. package/dist/agent-loop.d.ts.map +1 -0
  21. package/dist/agent-loop.js +609 -0
  22. package/dist/agent-loop.js.map +1 -0
  23. package/dist/agent-modes.d.ts +85 -0
  24. package/dist/agent-modes.d.ts.map +1 -0
  25. package/dist/agent-modes.js +418 -0
  26. package/dist/agent-modes.js.map +1 -0
  27. package/dist/approval.d.ts +137 -0
  28. package/dist/approval.d.ts.map +1 -0
  29. package/dist/approval.js +299 -0
  30. package/dist/approval.js.map +1 -0
  31. package/dist/async-completion-queue.d.ts +56 -0
  32. package/dist/async-completion-queue.d.ts.map +1 -0
  33. package/dist/async-completion-queue.js +77 -0
  34. package/dist/async-completion-queue.js.map +1 -0
  35. package/dist/auto-fix.d.ts +174 -0
  36. package/dist/auto-fix.d.ts.map +1 -0
  37. package/dist/auto-fix.js +319 -0
  38. package/dist/auto-fix.js.map +1 -0
  39. package/dist/codebase-context.d.ts +396 -0
  40. package/dist/codebase-context.d.ts.map +1 -0
  41. package/dist/codebase-context.js +1260 -0
  42. package/dist/codebase-context.js.map +1 -0
  43. package/dist/conflict-resolver.d.ts +191 -0
  44. package/dist/conflict-resolver.d.ts.map +1 -0
  45. package/dist/conflict-resolver.js +524 -0
  46. package/dist/conflict-resolver.js.map +1 -0
  47. package/dist/constants.d.ts +52 -0
  48. package/dist/constants.d.ts.map +1 -0
  49. package/dist/constants.js +141 -0
  50. package/dist/constants.js.map +1 -0
  51. package/dist/context-budget.d.ts +435 -0
  52. package/dist/context-budget.d.ts.map +1 -0
  53. package/dist/context-budget.js +903 -0
  54. package/dist/context-budget.js.map +1 -0
  55. package/dist/context-compressor.d.ts +143 -0
  56. package/dist/context-compressor.d.ts.map +1 -0
  57. package/dist/context-compressor.js +511 -0
  58. package/dist/context-compressor.js.map +1 -0
  59. package/dist/context-manager.d.ts +112 -0
  60. package/dist/context-manager.d.ts.map +1 -0
  61. package/dist/context-manager.js +247 -0
  62. package/dist/context-manager.js.map +1 -0
  63. package/dist/continuous-reflection.d.ts +267 -0
  64. package/dist/continuous-reflection.d.ts.map +1 -0
  65. package/dist/continuous-reflection.js +338 -0
  66. package/dist/continuous-reflection.js.map +1 -0
  67. package/dist/cross-file-refactor.d.ts +352 -0
  68. package/dist/cross-file-refactor.d.ts.map +1 -0
  69. package/dist/cross-file-refactor.js +1544 -0
  70. package/dist/cross-file-refactor.js.map +1 -0
  71. package/dist/dag-orchestrator.d.ts +138 -0
  72. package/dist/dag-orchestrator.d.ts.map +1 -0
  73. package/dist/dag-orchestrator.js +379 -0
  74. package/dist/dag-orchestrator.js.map +1 -0
  75. package/dist/debate-orchestrator.d.ts +301 -0
  76. package/dist/debate-orchestrator.d.ts.map +1 -0
  77. package/dist/debate-orchestrator.js +719 -0
  78. package/dist/debate-orchestrator.js.map +1 -0
  79. package/dist/dependency-analyzer.d.ts +113 -0
  80. package/dist/dependency-analyzer.d.ts.map +1 -0
  81. package/dist/dependency-analyzer.js +444 -0
  82. package/dist/dependency-analyzer.js.map +1 -0
  83. package/dist/design-loop.d.ts +59 -0
  84. package/dist/design-loop.d.ts.map +1 -0
  85. package/dist/design-loop.js +344 -0
  86. package/dist/design-loop.js.map +1 -0
  87. package/dist/doc-intelligence.d.ts +383 -0
  88. package/dist/doc-intelligence.d.ts.map +1 -0
  89. package/dist/doc-intelligence.js +1307 -0
  90. package/dist/doc-intelligence.js.map +1 -0
  91. package/dist/dynamic-role-generator.d.ts +76 -0
  92. package/dist/dynamic-role-generator.d.ts.map +1 -0
  93. package/dist/dynamic-role-generator.js +194 -0
  94. package/dist/dynamic-role-generator.js.map +1 -0
  95. package/dist/errors.d.ts +69 -0
  96. package/dist/errors.d.ts.map +1 -0
  97. package/dist/errors.js +102 -0
  98. package/dist/errors.js.map +1 -0
  99. package/dist/event-bus.d.ts +159 -0
  100. package/dist/event-bus.d.ts.map +1 -0
  101. package/dist/event-bus.js +305 -0
  102. package/dist/event-bus.js.map +1 -0
  103. package/dist/execution-engine.d.ts +425 -0
  104. package/dist/execution-engine.d.ts.map +1 -0
  105. package/dist/execution-engine.js +1555 -0
  106. package/dist/execution-engine.js.map +1 -0
  107. package/dist/git-intelligence.d.ts +306 -0
  108. package/dist/git-intelligence.d.ts.map +1 -0
  109. package/dist/git-intelligence.js +1099 -0
  110. package/dist/git-intelligence.js.map +1 -0
  111. package/dist/governor.d.ts +77 -0
  112. package/dist/governor.d.ts.map +1 -0
  113. package/dist/governor.js +161 -0
  114. package/dist/governor.js.map +1 -0
  115. package/dist/hierarchical-planner.d.ts +313 -0
  116. package/dist/hierarchical-planner.d.ts.map +1 -0
  117. package/dist/hierarchical-planner.js +981 -0
  118. package/dist/hierarchical-planner.js.map +1 -0
  119. package/dist/index.d.ts +121 -0
  120. package/dist/index.d.ts.map +1 -0
  121. package/dist/index.js +123 -0
  122. package/dist/index.js.map +1 -0
  123. package/dist/intent-inference.d.ts +103 -0
  124. package/dist/intent-inference.d.ts.map +1 -0
  125. package/dist/intent-inference.js +605 -0
  126. package/dist/intent-inference.js.map +1 -0
  127. package/dist/interrupt-manager.d.ts +143 -0
  128. package/dist/interrupt-manager.d.ts.map +1 -0
  129. package/dist/interrupt-manager.js +196 -0
  130. package/dist/interrupt-manager.js.map +1 -0
  131. package/dist/kernel.d.ts +564 -0
  132. package/dist/kernel.d.ts.map +1 -0
  133. package/dist/kernel.js +1419 -0
  134. package/dist/kernel.js.map +1 -0
  135. package/dist/language-support.d.ts +232 -0
  136. package/dist/language-support.d.ts.map +1 -0
  137. package/dist/language-support.js +1134 -0
  138. package/dist/language-support.js.map +1 -0
  139. package/dist/llm-client.d.ts +82 -0
  140. package/dist/llm-client.d.ts.map +1 -0
  141. package/dist/llm-client.js +475 -0
  142. package/dist/llm-client.js.map +1 -0
  143. package/dist/mcp-client.d.ts +232 -0
  144. package/dist/mcp-client.d.ts.map +1 -0
  145. package/dist/mcp-client.js +718 -0
  146. package/dist/mcp-client.js.map +1 -0
  147. package/dist/memory-manager.d.ts +200 -0
  148. package/dist/memory-manager.d.ts.map +1 -0
  149. package/dist/memory-manager.js +568 -0
  150. package/dist/memory-manager.js.map +1 -0
  151. package/dist/memory.d.ts +87 -0
  152. package/dist/memory.d.ts.map +1 -0
  153. package/dist/memory.js +341 -0
  154. package/dist/memory.js.map +1 -0
  155. package/dist/model-router.d.ts +245 -0
  156. package/dist/model-router.d.ts.map +1 -0
  157. package/dist/model-router.js +632 -0
  158. package/dist/model-router.js.map +1 -0
  159. package/dist/parallel-executor.d.ts +125 -0
  160. package/dist/parallel-executor.d.ts.map +1 -0
  161. package/dist/parallel-executor.js +201 -0
  162. package/dist/parallel-executor.js.map +1 -0
  163. package/dist/perf-optimizer.d.ts +212 -0
  164. package/dist/perf-optimizer.d.ts.map +1 -0
  165. package/dist/perf-optimizer.js +721 -0
  166. package/dist/perf-optimizer.js.map +1 -0
  167. package/dist/persona.d.ts +305 -0
  168. package/dist/persona.d.ts.map +1 -0
  169. package/dist/persona.js +887 -0
  170. package/dist/persona.js.map +1 -0
  171. package/dist/planner.d.ts +70 -0
  172. package/dist/planner.d.ts.map +1 -0
  173. package/dist/planner.js +264 -0
  174. package/dist/planner.js.map +1 -0
  175. package/dist/qa-pipeline.d.ts +365 -0
  176. package/dist/qa-pipeline.d.ts.map +1 -0
  177. package/dist/qa-pipeline.js +1352 -0
  178. package/dist/qa-pipeline.js.map +1 -0
  179. package/dist/reasoning-adapter.d.ts +116 -0
  180. package/dist/reasoning-adapter.d.ts.map +1 -0
  181. package/dist/reasoning-adapter.js +187 -0
  182. package/dist/reasoning-adapter.js.map +1 -0
  183. package/dist/role-registry.d.ts +55 -0
  184. package/dist/role-registry.d.ts.map +1 -0
  185. package/dist/role-registry.js +192 -0
  186. package/dist/role-registry.js.map +1 -0
  187. package/dist/sandbox-tiers.d.ts +327 -0
  188. package/dist/sandbox-tiers.d.ts.map +1 -0
  189. package/dist/sandbox-tiers.js +928 -0
  190. package/dist/sandbox-tiers.js.map +1 -0
  191. package/dist/security-scanner.d.ts +222 -0
  192. package/dist/security-scanner.d.ts.map +1 -0
  193. package/dist/security-scanner.js +1129 -0
  194. package/dist/security-scanner.js.map +1 -0
  195. package/dist/security.d.ts +93 -0
  196. package/dist/security.d.ts.map +1 -0
  197. package/dist/security.js +393 -0
  198. package/dist/security.js.map +1 -0
  199. package/dist/self-reflection.d.ts +397 -0
  200. package/dist/self-reflection.d.ts.map +1 -0
  201. package/dist/self-reflection.js +908 -0
  202. package/dist/self-reflection.js.map +1 -0
  203. package/dist/session-persistence.d.ts +191 -0
  204. package/dist/session-persistence.d.ts.map +1 -0
  205. package/dist/session-persistence.js +395 -0
  206. package/dist/session-persistence.js.map +1 -0
  207. package/dist/speculative-executor.d.ts +210 -0
  208. package/dist/speculative-executor.d.ts.map +1 -0
  209. package/dist/speculative-executor.js +618 -0
  210. package/dist/speculative-executor.js.map +1 -0
  211. package/dist/state-machine.d.ts +289 -0
  212. package/dist/state-machine.d.ts.map +1 -0
  213. package/dist/state-machine.js +695 -0
  214. package/dist/state-machine.js.map +1 -0
  215. package/dist/sub-agent.d.ts +177 -0
  216. package/dist/sub-agent.d.ts.map +1 -0
  217. package/dist/sub-agent.js +303 -0
  218. package/dist/sub-agent.js.map +1 -0
  219. package/dist/system-prompt.d.ts +26 -0
  220. package/dist/system-prompt.d.ts.map +1 -0
  221. package/dist/system-prompt.js +84 -0
  222. package/dist/system-prompt.js.map +1 -0
  223. package/dist/test-intelligence.d.ts +439 -0
  224. package/dist/test-intelligence.d.ts.map +1 -0
  225. package/dist/test-intelligence.js +1165 -0
  226. package/dist/test-intelligence.js.map +1 -0
  227. package/dist/types.d.ts +632 -0
  228. package/dist/types.d.ts.map +1 -0
  229. package/dist/types.js +6 -0
  230. package/dist/types.js.map +1 -0
  231. package/dist/vector-index.d.ts +314 -0
  232. package/dist/vector-index.d.ts.map +1 -0
  233. package/dist/vector-index.js +618 -0
  234. package/dist/vector-index.js.map +1 -0
  235. package/package.json +41 -0
@@ -0,0 +1,511 @@
1
+ /**
2
+ * @module context-compressor
3
+ * @description 컨텍스트 윈도우 압축 전략.
4
+ * 단순 truncate 대신 우선순위 기반 메시지 관리.
5
+ *
6
+ * ContextManager의 기본 compactHistory보다 정교한 압축을 제공한다:
7
+ * - 메시지 유형별 우선순위 부여
8
+ * - 도구 결과 유형별 맞춤 요약
9
+ * - 오래된 메시지 자동 요약
10
+ *
11
+ * @example
12
+ * ```typescript
13
+ * const compressor = new ContextCompressor({
14
+ * maxTokens: 128_000,
15
+ * reserveTokens: 8_000,
16
+ * });
17
+ *
18
+ * const result = compressor.compress(messages, currentTokenEstimate);
19
+ * // result.messages — 압축된 메시지 배열
20
+ * // result.evicted — 제거된 메시지 수
21
+ * // result.summarized — 요약된 메시지 수
22
+ * ```
23
+ */
24
+ // ─── Default Strategy ───
25
+ const DEFAULT_PRIORITIES = {
26
+ system: 10,
27
+ userGoal: 9,
28
+ recentToolResult: 8,
29
+ recentAssistant: 7,
30
+ approval: 6,
31
+ olderToolResult: 4,
32
+ olderAssistant: 3,
33
+ thinking: 1,
34
+ };
35
+ const DEFAULT_STRATEGY = {
36
+ priorities: DEFAULT_PRIORITIES,
37
+ recentToolResultCount: 3,
38
+ recentAssistantCount: 2,
39
+ };
40
+ const TOOL_COMPRESSION_RULES = {
41
+ file_read: { maxLines: 70, headLines: 50, tailLines: 20, errorsOnly: false },
42
+ grep: { maxLines: 20, headLines: 20, tailLines: 0, errorsOnly: false },
43
+ glob: { maxLines: 30, headLines: 30, tailLines: 0, errorsOnly: false },
44
+ code_search: { maxLines: 20, headLines: 20, tailLines: 0, errorsOnly: false },
45
+ shell_exec: { maxLines: 30, headLines: 0, tailLines: 30, errorsOnly: false },
46
+ // Build-like outputs: extract errors
47
+ file_write: { maxLines: 40, headLines: 10, tailLines: 10, errorsOnly: true },
48
+ file_edit: { maxLines: 40, headLines: 10, tailLines: 10, errorsOnly: true },
49
+ };
50
+ const DEFAULT_TOOL_RULE = {
51
+ maxLines: 40,
52
+ headLines: 15,
53
+ tailLines: 15,
54
+ errorsOnly: false,
55
+ };
56
+ // ─── ContextCompressor ───
57
+ /**
58
+ * ContextCompressor — 우선순위 기반 컨텍스트 압축.
59
+ *
60
+ * ContextManager의 단순 truncation을 대체하여,
61
+ * 메시지 유형별 중요도에 따라 정교하게 컨텍스트를 관리한다.
62
+ */
63
+ export class ContextCompressor {
64
+ maxTokens;
65
+ reserveTokens;
66
+ strategy;
67
+ constructor(config) {
68
+ this.maxTokens = config.maxTokens;
69
+ this.reserveTokens = config.reserveTokens;
70
+ this.strategy = {
71
+ ...DEFAULT_STRATEGY,
72
+ ...config.strategy,
73
+ priorities: {
74
+ ...DEFAULT_PRIORITIES,
75
+ ...config.strategy?.priorities,
76
+ },
77
+ };
78
+ }
79
+ /**
80
+ * 메시지 배열을 토큰 예산 내에 맞도록 압축한다.
81
+ *
82
+ * 압축 단계:
83
+ * 1. 각 메시지에 우선순위 부여
84
+ * 2. 토큰 예산 초과 시 낮은 우선순위 메시지부터 제거/요약
85
+ * 3. 제거할 수 없는 메시지(system, userGoal)는 항상 유지
86
+ *
87
+ * @param messages 원본 메시지 배열
88
+ * @param currentTokens 현재 토큰 추정치 (0이면 자동 계산)
89
+ * @returns 압축 결과
90
+ */
91
+ compress(messages, currentTokens) {
92
+ const budget = this.maxTokens - this.reserveTokens;
93
+ const estimated = currentTokens > 0 ? currentTokens : this.estimateTokensForMessages(messages);
94
+ // 예산 내이면 압축 불필요
95
+ if (estimated <= budget) {
96
+ return {
97
+ messages: [...messages],
98
+ evicted: 0,
99
+ summarized: 0,
100
+ finalTokenEstimate: estimated,
101
+ };
102
+ }
103
+ // 1. 우선순위 부여
104
+ const prioritized = this.assignPriorities(messages);
105
+ // 2. 오래된 도구 결과 요약 (우선 시도)
106
+ let summarizedCount = 0;
107
+ const afterSummary = this.summarizeOlderToolResults(prioritized);
108
+ summarizedCount = afterSummary.summarizedCount;
109
+ let currentEstimate = this.estimateTokensForPrioritized(afterSummary.items);
110
+ if (currentEstimate <= budget) {
111
+ return {
112
+ messages: afterSummary.items.map((p) => p.message),
113
+ evicted: 0,
114
+ summarized: summarizedCount,
115
+ finalTokenEstimate: currentEstimate,
116
+ };
117
+ }
118
+ // 3. 오래된 메시지를 하나의 요약으로 축약
119
+ const afterCollapse = this.collapseOldMessages(afterSummary.items, budget);
120
+ currentEstimate = this.estimateTokensForPrioritized(afterCollapse.items);
121
+ summarizedCount += afterCollapse.summarizedCount;
122
+ if (currentEstimate <= budget) {
123
+ return {
124
+ messages: afterCollapse.items.map((p) => p.message),
125
+ evicted: afterCollapse.evictedCount,
126
+ summarized: summarizedCount,
127
+ finalTokenEstimate: currentEstimate,
128
+ };
129
+ }
130
+ // 4. 최후의 수단: 가장 낮은 우선순위부터 제거
131
+ const afterEviction = this.evictByPriority(afterCollapse.items, budget);
132
+ currentEstimate = this.estimateTokensForPrioritized(afterEviction.items);
133
+ return {
134
+ messages: afterEviction.items.map((p) => p.message),
135
+ evicted: afterCollapse.evictedCount + afterEviction.evictedCount,
136
+ summarized: summarizedCount,
137
+ finalTokenEstimate: currentEstimate,
138
+ };
139
+ }
140
+ /**
141
+ * 도구 결과를 도구 유형에 맞게 요약한다.
142
+ *
143
+ * - 빌드 출력 → 에러 + 마지막 10줄만 유지
144
+ * - 파일 읽기 → 처음 50줄 + 마지막 20줄
145
+ * - Grep → 처음 20개 매치만 유지
146
+ * - Shell 출력 → 종료 코드 + 마지막 30줄
147
+ *
148
+ * @param toolName 도구 이름
149
+ * @param output 원본 출력
150
+ * @param maxLength 최대 문자 수 (0이면 도구별 기본값)
151
+ * @returns 요약된 출력
152
+ */
153
+ summarizeToolResult(toolName, output, maxLength = 0) {
154
+ const lines = output.split("\n");
155
+ const rule = TOOL_COMPRESSION_RULES[toolName] ?? DEFAULT_TOOL_RULE;
156
+ const limit = maxLength > 0 ? Math.ceil(maxLength / 40) : rule.maxLines;
157
+ if (lines.length <= limit) {
158
+ return output;
159
+ }
160
+ // 에러 추출 모드
161
+ if (rule.errorsOnly) {
162
+ return this.extractErrorsFromOutput(lines, limit);
163
+ }
164
+ // head + tail 모드
165
+ const resultLines = [];
166
+ if (rule.headLines > 0) {
167
+ const head = Math.min(rule.headLines, limit);
168
+ resultLines.push(...lines.slice(0, head));
169
+ }
170
+ const omitted = lines.length - (rule.headLines + rule.tailLines);
171
+ if (omitted > 0) {
172
+ resultLines.push(`\n... (${omitted} lines omitted) ...\n`);
173
+ }
174
+ if (rule.tailLines > 0) {
175
+ const tail = Math.min(rule.tailLines, limit - resultLines.length);
176
+ if (tail > 0) {
177
+ resultLines.push(...lines.slice(-tail));
178
+ }
179
+ }
180
+ return resultLines.join("\n");
181
+ }
182
+ /**
183
+ * 오래된 메시지 그룹을 하나의 요약 메시지로 축약한다.
184
+ *
185
+ * @param messages 요약할 메시지 배열
186
+ * @returns 요약 메시지 (role: "system")
187
+ */
188
+ summarizeOldMessages(messages) {
189
+ const actions = [];
190
+ let toolCallCount = 0;
191
+ let fileReads = 0;
192
+ let fileWrites = 0;
193
+ let shellExecs = 0;
194
+ const filesRead = [];
195
+ const filesWritten = [];
196
+ for (const msg of messages) {
197
+ if (msg.role === "assistant" && msg.tool_calls) {
198
+ for (const tc of msg.tool_calls) {
199
+ toolCallCount++;
200
+ const args = this.parseToolArgs(tc.arguments);
201
+ switch (tc.name) {
202
+ case "file_read":
203
+ fileReads++;
204
+ if (args.path)
205
+ filesRead.push(String(args.path));
206
+ break;
207
+ case "file_write":
208
+ case "file_edit":
209
+ fileWrites++;
210
+ if (args.path)
211
+ filesWritten.push(String(args.path));
212
+ break;
213
+ case "shell_exec":
214
+ shellExecs++;
215
+ if (args.command) {
216
+ actions.push(`Ran: ${String(args.command).slice(0, 80)}`);
217
+ }
218
+ break;
219
+ default:
220
+ actions.push(`${tc.name}`);
221
+ }
222
+ }
223
+ }
224
+ else if (msg.role === "user" && msg.content) {
225
+ const preview = msg.content.slice(0, 120);
226
+ actions.push(`User: ${preview}${msg.content.length > 120 ? "..." : ""}`);
227
+ }
228
+ }
229
+ const summary = [
230
+ `[Summary of ${messages.length} earlier messages]`,
231
+ `- ${toolCallCount} tool calls (${fileReads} reads, ${fileWrites} writes, ${shellExecs} shell)`,
232
+ ];
233
+ if (filesRead.length > 0) {
234
+ const uniqueReads = [...new Set(filesRead)];
235
+ summary.push(`- Files read: ${uniqueReads.slice(0, 10).join(", ")}${uniqueReads.length > 10 ? ` (+${uniqueReads.length - 10} more)` : ""}`);
236
+ }
237
+ if (filesWritten.length > 0) {
238
+ const uniqueWrites = [...new Set(filesWritten)];
239
+ summary.push(`- Files modified: ${uniqueWrites.join(", ")}`);
240
+ }
241
+ if (actions.length > 0) {
242
+ summary.push(`- Actions: ${actions.slice(0, 5).join("; ")}${actions.length > 5 ? ` (+${actions.length - 5} more)` : ""}`);
243
+ }
244
+ return {
245
+ role: "system",
246
+ content: summary.join("\n"),
247
+ };
248
+ }
249
+ // ─── Private: Priority Assignment ───
250
+ assignPriorities(messages) {
251
+ const { priorities, recentToolResultCount, recentAssistantCount } = this.strategy;
252
+ // 최근 tool result / assistant 메시지의 인덱스를 역순으로 추적
253
+ let toolResultSeen = 0;
254
+ let assistantSeen = 0;
255
+ const isFirstUserMessage = new Set();
256
+ // 첫 번째 user 메시지 찾기 (사용자의 최초 목표)
257
+ for (let i = 0; i < messages.length; i++) {
258
+ if (messages[i].role === "user") {
259
+ isFirstUserMessage.add(i);
260
+ break;
261
+ }
262
+ }
263
+ // 역순으로 최근 메시지 카운팅
264
+ const recentToolResultIndices = new Set();
265
+ const recentAssistantIndices = new Set();
266
+ for (let i = messages.length - 1; i >= 0; i--) {
267
+ const msg = messages[i];
268
+ if (msg.role === "tool" && toolResultSeen < recentToolResultCount) {
269
+ recentToolResultIndices.add(i);
270
+ toolResultSeen++;
271
+ }
272
+ if (msg.role === "assistant" && assistantSeen < recentAssistantCount) {
273
+ recentAssistantIndices.add(i);
274
+ assistantSeen++;
275
+ }
276
+ }
277
+ return messages.map((message, index) => {
278
+ let priority;
279
+ if (message.role === "system") {
280
+ priority = priorities.system;
281
+ }
282
+ else if (isFirstUserMessage.has(index)) {
283
+ priority = priorities.userGoal;
284
+ }
285
+ else if (message.role === "tool" && recentToolResultIndices.has(index)) {
286
+ priority = priorities.recentToolResult;
287
+ }
288
+ else if (message.role === "assistant" && recentAssistantIndices.has(index)) {
289
+ priority = priorities.recentAssistant;
290
+ }
291
+ else if (message.role === "tool") {
292
+ priority = priorities.olderToolResult;
293
+ }
294
+ else if (message.role === "assistant") {
295
+ // 승인 관련 메시지는 높은 우선순위
296
+ if (message.content?.includes("[APPROVED]") || message.content?.includes("[REJECTED]")) {
297
+ priority = priorities.approval;
298
+ }
299
+ else {
300
+ priority = priorities.olderAssistant;
301
+ }
302
+ }
303
+ else {
304
+ // user messages (not first) — moderate priority
305
+ priority = priorities.olderAssistant + 1;
306
+ }
307
+ return {
308
+ message,
309
+ priority,
310
+ index,
311
+ tokenEstimate: this.estimateMessageTokens(message),
312
+ };
313
+ });
314
+ }
315
+ // ─── Private: Compression Stages ───
316
+ summarizeOlderToolResults(items) {
317
+ const { priorities } = this.strategy;
318
+ let summarizedCount = 0;
319
+ const result = items.map((item) => {
320
+ // 오래된 도구 결과만 요약
321
+ if (item.priority !== priorities.olderToolResult) {
322
+ return item;
323
+ }
324
+ const content = item.message.content;
325
+ if (!content || content.length < 500) {
326
+ return item;
327
+ }
328
+ // 도구 이름을 추적하기 위해 tool_call_id로 찾기 (best-effort)
329
+ const toolName = this.guessToolNameFromContent(content);
330
+ const summarized = this.summarizeToolResult(toolName, content);
331
+ if (summarized.length < content.length) {
332
+ summarizedCount++;
333
+ return {
334
+ ...item,
335
+ message: { ...item.message, content: summarized },
336
+ tokenEstimate: this.estimateStringTokens(summarized) + 4,
337
+ };
338
+ }
339
+ return item;
340
+ });
341
+ return { items: result, summarizedCount };
342
+ }
343
+ collapseOldMessages(items, budget) {
344
+ const { priorities } = this.strategy;
345
+ const threshold = priorities.approval; // 6 — priority 6 이하는 요약 대상
346
+ // 요약 대상: priority < threshold이고, system/userGoal이 아닌 것
347
+ const toCollapse = [];
348
+ const toKeep = [];
349
+ for (const item of items) {
350
+ if (item.priority < threshold &&
351
+ item.priority !== priorities.system &&
352
+ item.priority !== priorities.userGoal) {
353
+ toCollapse.push(item);
354
+ }
355
+ else {
356
+ toKeep.push(item);
357
+ }
358
+ }
359
+ if (toCollapse.length === 0) {
360
+ return { items, summarizedCount: 0, evictedCount: 0 };
361
+ }
362
+ // 축약 대상 메시지를 하나의 요약으로 축약
363
+ const summaryMessage = this.summarizeOldMessages(toCollapse.map((p) => p.message));
364
+ const summaryItem = {
365
+ message: summaryMessage,
366
+ priority: priorities.olderAssistant + 0.5, // 요약은 중간 우선순위
367
+ index: toCollapse[0].index, // 원래 위치 유지
368
+ tokenEstimate: this.estimateMessageTokens(summaryMessage),
369
+ };
370
+ // system 메시지 다음, 나머지 앞에 삽입
371
+ const result = [];
372
+ let summaryInserted = false;
373
+ for (const item of toKeep) {
374
+ if (!summaryInserted && item.priority < priorities.system) {
375
+ result.push(summaryItem);
376
+ summaryInserted = true;
377
+ }
378
+ result.push(item);
379
+ }
380
+ if (!summaryInserted) {
381
+ // system 뒤에 삽입
382
+ const systemEnd = result.findIndex((p) => p.priority !== priorities.system);
383
+ if (systemEnd === -1) {
384
+ result.push(summaryItem);
385
+ }
386
+ else {
387
+ result.splice(systemEnd, 0, summaryItem);
388
+ }
389
+ }
390
+ // 원래 인덱스 순으로 정렬
391
+ result.sort((a, b) => a.index - b.index);
392
+ return {
393
+ items: result,
394
+ summarizedCount: toCollapse.length,
395
+ evictedCount: 0,
396
+ };
397
+ }
398
+ evictByPriority(items, budget) {
399
+ const { priorities } = this.strategy;
400
+ // priority 순 정렬 (낮은 것 먼저 제거)
401
+ const sorted = [...items].sort((a, b) => a.priority - b.priority);
402
+ let currentTokens = this.estimateTokensForPrioritized(items);
403
+ const evictIndices = new Set();
404
+ for (const item of sorted) {
405
+ if (currentTokens <= budget)
406
+ break;
407
+ // 절대 제거 불가: system, userGoal
408
+ if (item.priority >= priorities.userGoal) {
409
+ continue;
410
+ }
411
+ evictIndices.add(item.index);
412
+ currentTokens -= item.tokenEstimate;
413
+ }
414
+ const result = items.filter((item) => !evictIndices.has(item.index));
415
+ return {
416
+ items: result,
417
+ evictedCount: evictIndices.size,
418
+ };
419
+ }
420
+ // ─── Private: Token Estimation ───
421
+ /**
422
+ * 문자열의 대략적인 토큰 수를 추정 (~4 chars/token).
423
+ * ContextManager.estimateStringTokens와 동일한 근사치.
424
+ */
425
+ estimateStringTokens(str) {
426
+ const cjkCount = (str.match(/[\u3000-\u9fff\uac00-\ud7af]/g) ?? []).length;
427
+ const nonCjkCount = str.length - cjkCount;
428
+ return Math.ceil(nonCjkCount / 4 + cjkCount / 2);
429
+ }
430
+ estimateMessageTokens(message) {
431
+ let total = 4; // message overhead
432
+ if (message.content) {
433
+ total += this.estimateStringTokens(message.content);
434
+ }
435
+ if (message.tool_calls) {
436
+ for (const tc of message.tool_calls) {
437
+ total += this.estimateStringTokens(tc.name) + 4;
438
+ const argsStr = typeof tc.arguments === "string"
439
+ ? tc.arguments
440
+ : JSON.stringify(tc.arguments);
441
+ total += this.estimateStringTokens(argsStr);
442
+ }
443
+ }
444
+ return total;
445
+ }
446
+ estimateTokensForMessages(messages) {
447
+ return messages.reduce((sum, msg) => sum + this.estimateMessageTokens(msg), 0);
448
+ }
449
+ estimateTokensForPrioritized(items) {
450
+ return items.reduce((sum, item) => sum + item.tokenEstimate, 0);
451
+ }
452
+ // ─── Private: Helpers ───
453
+ /**
454
+ * 빌드/쉘 출력에서 에러 줄만 추출한다.
455
+ */
456
+ extractErrorsFromOutput(lines, maxLines) {
457
+ const errorPatterns = /\b(error|Error|ERROR|fail|FAIL|Failed|fatal|FATAL|exception|Exception)\b/;
458
+ const errorLines = [];
459
+ const contextLines = 2;
460
+ for (let i = 0; i < lines.length; i++) {
461
+ if (errorPatterns.test(lines[i])) {
462
+ // 에러 줄 + 주변 컨텍스트
463
+ const start = Math.max(0, i - contextLines);
464
+ const end = Math.min(lines.length, i + contextLines + 1);
465
+ for (let j = start; j < end; j++) {
466
+ if (!errorLines.includes(lines[j])) {
467
+ errorLines.push(lines[j]);
468
+ }
469
+ }
470
+ }
471
+ }
472
+ if (errorLines.length === 0) {
473
+ // 에러를 못 찾으면 마지막 줄들 반환
474
+ const tail = lines.slice(-maxLines);
475
+ return `[No explicit errors found. Last ${tail.length} lines:]\n${tail.join("\n")}`;
476
+ }
477
+ const result = errorLines.slice(0, maxLines);
478
+ const omitted = errorLines.length - result.length;
479
+ const suffix = omitted > 0 ? `\n... (${omitted} more error lines)` : "";
480
+ return `[Extracted ${result.length} error-related lines:]\n${result.join("\n")}${suffix}`;
481
+ }
482
+ /**
483
+ * 도구 결과 내용에서 도구 이름을 추측한다 (best-effort).
484
+ */
485
+ guessToolNameFromContent(content) {
486
+ if (content.startsWith("File:") || content.includes("lines total"))
487
+ return "file_read";
488
+ if (content.includes("matches found") || content.includes("Match:"))
489
+ return "grep";
490
+ if (content.includes("files found") || content.includes("Found:"))
491
+ return "glob";
492
+ if (content.includes("exit code") || content.includes("Exit code"))
493
+ return "shell_exec";
494
+ return "unknown";
495
+ }
496
+ /**
497
+ * 도구 인자를 파싱하는 헬퍼.
498
+ */
499
+ parseToolArgs(args) {
500
+ if (typeof args === "string") {
501
+ try {
502
+ return JSON.parse(args);
503
+ }
504
+ catch {
505
+ return { raw: args };
506
+ }
507
+ }
508
+ return args;
509
+ }
510
+ }
511
+ //# sourceMappingURL=context-compressor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"context-compressor.js","sourceRoot":"","sources":["../src/context-compressor.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,112 @@
1
+ /**
2
+ * @module context-manager
3
+ * @description 컨텍스트 윈도우 관리.
4
+ * 메시지 히스토리 관리, 토큰 카운팅 (근사), 컨텍스트 압축.
5
+ */
6
+ import type { Message } from "./types.js";
7
+ /** ContextManager 설정 */
8
+ export interface ContextManagerConfig {
9
+ /** 최대 컨텍스트 토큰 수 */
10
+ maxContextTokens: number;
11
+ /** 출력 예약 토큰 (LLM 응답용) */
12
+ outputReserveTokens?: number;
13
+ /** 히스토리 압축 설정 */
14
+ compaction?: {
15
+ recentWindow?: number;
16
+ summaryWindow?: number;
17
+ };
18
+ }
19
+ /**
20
+ * ContextManager — 컨텍스트 윈도우 크기를 관리.
21
+ *
22
+ * 역할:
23
+ * - 메시지 히스토리를 관리하고 토큰 수를 추적
24
+ * - 도구 결과가 너무 크면 자동 압축
25
+ * - 오래된 메시지를 요약으로 교체하여 컨텍스트 내에 유지
26
+ */
27
+ export declare class ContextManager {
28
+ private messages;
29
+ private readonly maxTokens;
30
+ private readonly outputReserve;
31
+ private readonly recentWindow;
32
+ private readonly summaryWindow;
33
+ constructor(config: ContextManagerConfig);
34
+ /**
35
+ * 메시지를 히스토리에 추가.
36
+ * @param message 추가할 메시지
37
+ */
38
+ addMessage(message: Message): void;
39
+ /**
40
+ * 여러 메시지를 한 번에 추가.
41
+ * @param messages 추가할 메시지 목록
42
+ */
43
+ addMessages(messages: Message[]): void;
44
+ /**
45
+ * 현재 메시지 히스토리 반환.
46
+ * 컨텍스트 윈도우 내에 맞도록 자동 압축.
47
+ */
48
+ getMessages(): Message[];
49
+ /**
50
+ * LLM에 보낼 메시지를 준비.
51
+ * 필요 시 압축하여 컨텍스트 윈도우 내에 맞춤.
52
+ */
53
+ prepareForLLM(): Message[];
54
+ /**
55
+ * 메시지 목록의 대략적인 토큰 수를 추정.
56
+ * tiktoken 없이 근사치 사용 (영어 ~4자/토큰, 한국어 ~2자/토큰).
57
+ * @param messages 토큰 수를 추정할 메시지 목록
58
+ */
59
+ estimateTokens(messages: Message[]): number;
60
+ /**
61
+ * 도구 결과를 크기 제한에 맞게 압축.
62
+ * @param toolName 도구 이름
63
+ * @param result 도구 결과 문자열
64
+ * @returns 압축된 결과 (제한 내이면 원본 반환)
65
+ */
66
+ compressToolResult(toolName: string, result: string): string;
67
+ /**
68
+ * 현재 총 토큰 수 추정치를 반환.
69
+ */
70
+ getCurrentTokenCount(): number;
71
+ /**
72
+ * 히스토리를 초기화.
73
+ */
74
+ clear(): void;
75
+ /**
76
+ * 히스토리 메시지 수를 반환.
77
+ */
78
+ get messageCount(): number;
79
+ /**
80
+ * 히스토리를 압축하여 토큰 예산 내에 맞춤.
81
+ *
82
+ * 전략:
83
+ * 1. system 메시지는 항상 유지
84
+ * 2. 최근 recentWindow개 메시지는 원본 유지
85
+ * 3. summaryWindow 범위: 도구 결과만 요약으로 교체
86
+ * 4. 그 이전: 전체를 1줄 요약으로 압축
87
+ */
88
+ private compactHistory;
89
+ private summarizeMessages;
90
+ private truncateToolResult;
91
+ /**
92
+ * 문자열의 대략적인 토큰 수를 추정 (근사치).
93
+ *
94
+ * **추정 방식:**
95
+ * - 영어/ASCII 텍스트: ~4 characters per token
96
+ * - CJK/한국어 텍스트 (U+3000–U+9FFF, U+AC00–U+D7AF): ~2 characters per token
97
+ * - 혼합 텍스트는 각 범위의 문자 수를 분리하여 합산
98
+ *
99
+ * **오차 범위:**
100
+ * - 영어: 실제 토큰 대비 ~±20% 오차 (서브워드 분할 특성상 변동)
101
+ * - CJK/한국어: ~±20% 이상 오차 가능 (모델별 토크나이저 차이가 큼)
102
+ * - 코드, 특수문자, 긴 단어 등에서 오차가 더 커질 수 있음
103
+ *
104
+ * **의도적 설계:**
105
+ * BYOK 환경에서는 사용자가 다양한 모델(Claude, GPT, Gemini 등)을
106
+ * 자유롭게 선택하므로 모델별 토크나이저에 접근할 수 없다.
107
+ * 따라서 정확한 토큰 카운팅 대신 범용 근사치를 사용하며,
108
+ * 컨텍스트 오버플로우는 outputReserve 마진으로 방어한다.
109
+ */
110
+ private estimateStringTokens;
111
+ }
112
+ //# sourceMappingURL=context-manager.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"context-manager.d.ts","sourceRoot":"","sources":["../src/context-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAI1C,wBAAwB;AACxB,MAAM,WAAW,oBAAoB;IACnC,mBAAmB;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,yBAAyB;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB;IACjB,UAAU,CAAC,EAAE;QACX,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED;;;;;;;GAOG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAE3B,MAAM,EAAE,oBAAoB;IASxC;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIlC;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI;IAItC;;;OAGG;IACH,WAAW,IAAI,OAAO,EAAE;IAIxB;;;OAGG;IACH,aAAa,IAAI,OAAO,EAAE;IAmB1B;;;;OAIG;IACH,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM;IAsB3C;;;;;OAKG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAe5D;;OAEG;IACH,oBAAoB,IAAI,MAAM;IAI9B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAID;;;;;;;;OAQG;IACH,OAAO,CAAC,cAAc;IA8DtB,OAAO,CAAC,iBAAiB;IA+BzB,OAAO,CAAC,kBAAkB;IAM1B;;;;;;;;;;;;;;;;;;OAkBG;IACH,OAAO,CAAC,oBAAoB;CAM7B"}