@blockrun/clawrouter 0.12.95 → 0.12.97

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 (282) hide show
  1. package/dist/auth.d.ts +82 -0
  2. package/dist/auth.d.ts.map +1 -0
  3. package/dist/auth.js +388 -0
  4. package/dist/auth.js.map +1 -0
  5. package/dist/balance.d.ts +97 -0
  6. package/dist/balance.d.ts.map +1 -0
  7. package/dist/balance.js +157 -0
  8. package/dist/balance.js.map +1 -0
  9. package/dist/cli.d.ts +15 -0
  10. package/dist/cli.d.ts.map +1 -0
  11. package/dist/cli.js +256 -54994
  12. package/dist/cli.js.map +1 -1
  13. package/dist/compression/codebook.d.ts +24 -0
  14. package/dist/compression/codebook.d.ts.map +1 -0
  15. package/dist/compression/codebook.js +119 -0
  16. package/dist/compression/codebook.js.map +1 -0
  17. package/dist/compression/index.d.ts +33 -0
  18. package/dist/compression/index.d.ts.map +1 -0
  19. package/dist/compression/index.js +246 -0
  20. package/dist/compression/index.js.map +1 -0
  21. package/dist/compression/layers/deduplication.d.ts +28 -0
  22. package/dist/compression/layers/deduplication.d.ts.map +1 -0
  23. package/dist/compression/layers/deduplication.js +101 -0
  24. package/dist/compression/layers/deduplication.js.map +1 -0
  25. package/dist/compression/layers/dictionary.d.ts +21 -0
  26. package/dist/compression/layers/dictionary.d.ts.map +1 -0
  27. package/dist/compression/layers/dictionary.js +73 -0
  28. package/dist/compression/layers/dictionary.js.map +1 -0
  29. package/dist/compression/layers/dynamic-codebook.d.ts +26 -0
  30. package/dist/compression/layers/dynamic-codebook.d.ts.map +1 -0
  31. package/dist/compression/layers/dynamic-codebook.js +149 -0
  32. package/dist/compression/layers/dynamic-codebook.js.map +1 -0
  33. package/dist/compression/layers/json-compact.d.ts +23 -0
  34. package/dist/compression/layers/json-compact.d.ts.map +1 -0
  35. package/dist/compression/layers/json-compact.js +79 -0
  36. package/dist/compression/layers/json-compact.js.map +1 -0
  37. package/dist/compression/layers/observation.d.ts +21 -0
  38. package/dist/compression/layers/observation.d.ts.map +1 -0
  39. package/dist/compression/layers/observation.js +130 -0
  40. package/dist/compression/layers/observation.js.map +1 -0
  41. package/dist/compression/layers/paths.d.ts +24 -0
  42. package/dist/compression/layers/paths.d.ts.map +1 -0
  43. package/dist/compression/layers/paths.js +110 -0
  44. package/dist/compression/layers/paths.js.map +1 -0
  45. package/dist/compression/layers/whitespace.d.ts +27 -0
  46. package/dist/compression/layers/whitespace.d.ts.map +1 -0
  47. package/dist/compression/layers/whitespace.js +60 -0
  48. package/dist/compression/layers/whitespace.js.map +1 -0
  49. package/dist/compression/types.d.ts +84 -0
  50. package/dist/compression/types.d.ts.map +1 -0
  51. package/dist/compression/types.js +27 -0
  52. package/dist/compression/types.js.map +1 -0
  53. package/dist/config.d.ts +12 -0
  54. package/dist/config.d.ts.map +1 -0
  55. package/dist/config.js +22 -0
  56. package/dist/config.js.map +1 -0
  57. package/dist/dedup.d.ts +34 -0
  58. package/dist/dedup.d.ts.map +1 -0
  59. package/dist/dedup.js +150 -0
  60. package/dist/dedup.js.map +1 -0
  61. package/dist/doctor.d.ts +8 -0
  62. package/dist/doctor.d.ts.map +1 -0
  63. package/dist/doctor.js +375 -0
  64. package/dist/doctor.js.map +1 -0
  65. package/dist/error-classification.test.d.ts +2 -0
  66. package/dist/error-classification.test.d.ts.map +1 -0
  67. package/dist/error-classification.test.js +59 -0
  68. package/dist/error-classification.test.js.map +1 -0
  69. package/dist/errors.d.ts +54 -0
  70. package/dist/errors.d.ts.map +1 -0
  71. package/dist/errors.js +85 -0
  72. package/dist/errors.js.map +1 -0
  73. package/dist/exclude-models.d.ts +28 -0
  74. package/dist/exclude-models.d.ts.map +1 -0
  75. package/dist/exclude-models.integration.test.d.ts +2 -0
  76. package/dist/exclude-models.integration.test.d.ts.map +1 -0
  77. package/dist/exclude-models.integration.test.js +46 -0
  78. package/dist/exclude-models.integration.test.js.map +1 -0
  79. package/dist/exclude-models.js +70 -0
  80. package/dist/exclude-models.js.map +1 -0
  81. package/dist/exclude-models.test.d.ts +5 -0
  82. package/dist/exclude-models.test.d.ts.map +1 -0
  83. package/dist/exclude-models.test.js +95 -0
  84. package/dist/exclude-models.test.js.map +1 -0
  85. package/dist/fs-read.d.ts +11 -0
  86. package/dist/fs-read.d.ts.map +1 -0
  87. package/dist/fs-read.js +47 -0
  88. package/dist/fs-read.js.map +1 -0
  89. package/dist/index.d.ts +34 -1368
  90. package/dist/index.d.ts.map +1 -0
  91. package/dist/index.js +1071 -56194
  92. package/dist/index.js.map +1 -1
  93. package/dist/journal.d.ts +67 -0
  94. package/dist/journal.d.ts.map +1 -0
  95. package/dist/journal.js +184 -0
  96. package/dist/journal.js.map +1 -0
  97. package/dist/journal.test.d.ts +2 -0
  98. package/dist/journal.test.d.ts.map +1 -0
  99. package/dist/journal.test.js +201 -0
  100. package/dist/journal.test.js.map +1 -0
  101. package/dist/logger.d.ts +33 -0
  102. package/dist/logger.d.ts.map +1 -0
  103. package/dist/logger.js +35 -0
  104. package/dist/logger.js.map +1 -0
  105. package/dist/models.d.ts +107 -0
  106. package/dist/models.d.ts.map +1 -0
  107. package/dist/models.js +941 -0
  108. package/dist/models.js.map +1 -0
  109. package/dist/models.test.d.ts +2 -0
  110. package/dist/models.test.d.ts.map +1 -0
  111. package/dist/models.test.js +38 -0
  112. package/dist/models.test.js.map +1 -0
  113. package/dist/partners/index.d.ts +8 -0
  114. package/dist/partners/index.d.ts.map +1 -0
  115. package/dist/partners/index.js +6 -0
  116. package/dist/partners/index.js.map +1 -0
  117. package/dist/partners/registry.d.ts +51 -0
  118. package/dist/partners/registry.d.ts.map +1 -0
  119. package/dist/partners/registry.js +256 -0
  120. package/dist/partners/registry.js.map +1 -0
  121. package/dist/partners/tools.d.ts +24 -0
  122. package/dist/partners/tools.d.ts.map +1 -0
  123. package/dist/partners/tools.js +97 -0
  124. package/dist/partners/tools.js.map +1 -0
  125. package/dist/payment-preauth.d.ts +17 -0
  126. package/dist/payment-preauth.d.ts.map +1 -0
  127. package/dist/payment-preauth.js +102 -0
  128. package/dist/payment-preauth.js.map +1 -0
  129. package/dist/provider.d.ts +19 -0
  130. package/dist/provider.d.ts.map +1 -0
  131. package/dist/provider.js +45 -0
  132. package/dist/provider.js.map +1 -0
  133. package/dist/proxy.d.ts +210 -0
  134. package/dist/proxy.d.ts.map +1 -0
  135. package/dist/proxy.debrand.test.d.ts +2 -0
  136. package/dist/proxy.debrand.test.d.ts.map +1 -0
  137. package/dist/proxy.debrand.test.js +101 -0
  138. package/dist/proxy.debrand.test.js.map +1 -0
  139. package/dist/proxy.degraded-response.test.d.ts +2 -0
  140. package/dist/proxy.degraded-response.test.d.ts.map +1 -0
  141. package/dist/proxy.degraded-response.test.js +105 -0
  142. package/dist/proxy.degraded-response.test.js.map +1 -0
  143. package/dist/proxy.image-download.test.d.ts +2 -0
  144. package/dist/proxy.image-download.test.d.ts.map +1 -0
  145. package/dist/proxy.image-download.test.js +92 -0
  146. package/dist/proxy.image-download.test.js.map +1 -0
  147. package/dist/proxy.js +3810 -0
  148. package/dist/proxy.js.map +1 -0
  149. package/dist/proxy.models-endpoint.test.d.ts +2 -0
  150. package/dist/proxy.models-endpoint.test.d.ts.map +1 -0
  151. package/dist/proxy.models-endpoint.test.js +19 -0
  152. package/dist/proxy.models-endpoint.test.js.map +1 -0
  153. package/dist/proxy.multiturn-thinking.test.d.ts +2 -0
  154. package/dist/proxy.multiturn-thinking.test.d.ts.map +1 -0
  155. package/dist/proxy.multiturn-thinking.test.js +82 -0
  156. package/dist/proxy.multiturn-thinking.test.js.map +1 -0
  157. package/dist/proxy.payment-chain-reuse.test.d.ts +2 -0
  158. package/dist/proxy.payment-chain-reuse.test.d.ts.map +1 -0
  159. package/dist/proxy.payment-chain-reuse.test.js +30 -0
  160. package/dist/proxy.payment-chain-reuse.test.js.map +1 -0
  161. package/dist/proxy.solana-resilience.test.d.ts +12 -0
  162. package/dist/proxy.solana-resilience.test.d.ts.map +1 -0
  163. package/dist/proxy.solana-resilience.test.js +39 -0
  164. package/dist/proxy.solana-resilience.test.js.map +1 -0
  165. package/dist/report.d.ts +6 -0
  166. package/dist/report.d.ts.map +1 -0
  167. package/dist/report.js +44 -0
  168. package/dist/report.js.map +1 -0
  169. package/dist/response-cache.advanced.test.d.ts +2 -0
  170. package/dist/response-cache.advanced.test.d.ts.map +1 -0
  171. package/dist/response-cache.advanced.test.js +566 -0
  172. package/dist/response-cache.advanced.test.js.map +1 -0
  173. package/dist/response-cache.d.ts +85 -0
  174. package/dist/response-cache.d.ts.map +1 -0
  175. package/dist/response-cache.edge-cases.test.d.ts +2 -0
  176. package/dist/response-cache.edge-cases.test.d.ts.map +1 -0
  177. package/dist/response-cache.edge-cases.test.js +488 -0
  178. package/dist/response-cache.edge-cases.test.js.map +1 -0
  179. package/dist/response-cache.extreme.test.d.ts +2 -0
  180. package/dist/response-cache.extreme.test.d.ts.map +1 -0
  181. package/dist/response-cache.extreme.test.js +561 -0
  182. package/dist/response-cache.extreme.test.js.map +1 -0
  183. package/dist/response-cache.js +240 -0
  184. package/dist/response-cache.js.map +1 -0
  185. package/dist/response-cache.test.d.ts +2 -0
  186. package/dist/response-cache.test.d.ts.map +1 -0
  187. package/dist/response-cache.test.js +242 -0
  188. package/dist/response-cache.test.js.map +1 -0
  189. package/dist/retry.d.ts +42 -0
  190. package/dist/retry.d.ts.map +1 -0
  191. package/dist/retry.js +99 -0
  192. package/dist/retry.js.map +1 -0
  193. package/dist/router/config.d.ts +11 -0
  194. package/dist/router/config.d.ts.map +1 -0
  195. package/dist/router/config.js +1215 -0
  196. package/dist/router/config.js.map +1 -0
  197. package/dist/router/index.d.ts +18 -0
  198. package/dist/router/index.d.ts.map +1 -0
  199. package/dist/router/index.js +19 -0
  200. package/dist/router/index.js.map +1 -0
  201. package/dist/router/llm-classifier.d.ts +29 -0
  202. package/dist/router/llm-classifier.d.ts.map +1 -0
  203. package/dist/router/llm-classifier.js +99 -0
  204. package/dist/router/llm-classifier.js.map +1 -0
  205. package/dist/router/rules.d.ts +12 -0
  206. package/dist/router/rules.d.ts.map +1 -0
  207. package/dist/router/rules.js +202 -0
  208. package/dist/router/rules.js.map +1 -0
  209. package/dist/router/selector.d.ts +58 -0
  210. package/dist/router/selector.d.ts.map +1 -0
  211. package/dist/router/selector.js +165 -0
  212. package/dist/router/selector.js.map +1 -0
  213. package/dist/router/selector.test.d.ts +2 -0
  214. package/dist/router/selector.test.d.ts.map +1 -0
  215. package/dist/router/selector.test.js +67 -0
  216. package/dist/router/selector.test.js.map +1 -0
  217. package/dist/router/strategy.d.ts +19 -0
  218. package/dist/router/strategy.d.ts.map +1 -0
  219. package/dist/router/strategy.js +138 -0
  220. package/dist/router/strategy.js.map +1 -0
  221. package/dist/router/strategy.test.d.ts +2 -0
  222. package/dist/router/strategy.test.d.ts.map +1 -0
  223. package/dist/router/strategy.test.js +131 -0
  224. package/dist/router/strategy.test.js.map +1 -0
  225. package/dist/router/types.d.ts +127 -0
  226. package/dist/router/types.d.ts.map +1 -0
  227. package/dist/router/types.js +11 -0
  228. package/dist/router/types.js.map +1 -0
  229. package/dist/session.d.ts +124 -0
  230. package/dist/session.d.ts.map +1 -0
  231. package/dist/session.js +256 -0
  232. package/dist/session.js.map +1 -0
  233. package/dist/session.test.d.ts +2 -0
  234. package/dist/session.test.d.ts.map +1 -0
  235. package/dist/session.test.js +163 -0
  236. package/dist/session.test.js.map +1 -0
  237. package/dist/solana-balance.d.ts +48 -0
  238. package/dist/solana-balance.d.ts.map +1 -0
  239. package/dist/solana-balance.js +142 -0
  240. package/dist/solana-balance.js.map +1 -0
  241. package/dist/spend-control.d.ts +112 -0
  242. package/dist/spend-control.d.ts.map +1 -0
  243. package/dist/spend-control.js +278 -0
  244. package/dist/spend-control.js.map +1 -0
  245. package/dist/spend-control.test.d.ts +5 -0
  246. package/dist/spend-control.test.d.ts.map +1 -0
  247. package/dist/spend-control.test.js +210 -0
  248. package/dist/spend-control.test.js.map +1 -0
  249. package/dist/stats.d.ts +64 -0
  250. package/dist/stats.d.ts.map +1 -0
  251. package/dist/stats.js +295 -0
  252. package/dist/stats.js.map +1 -0
  253. package/dist/types.d.ts +150 -0
  254. package/dist/types.d.ts.map +1 -0
  255. package/dist/types.js +9 -0
  256. package/dist/types.js.map +1 -0
  257. package/dist/update-hint.test.d.ts +9 -0
  258. package/dist/update-hint.test.d.ts.map +1 -0
  259. package/dist/update-hint.test.js +156 -0
  260. package/dist/update-hint.test.js.map +1 -0
  261. package/dist/updater.d.ts +10 -0
  262. package/dist/updater.d.ts.map +1 -0
  263. package/dist/updater.js +55 -0
  264. package/dist/updater.js.map +1 -0
  265. package/dist/version.d.ts +3 -0
  266. package/dist/version.d.ts.map +1 -0
  267. package/dist/version.js +16 -0
  268. package/dist/version.js.map +1 -0
  269. package/dist/wallet.d.ts +52 -0
  270. package/dist/wallet.d.ts.map +1 -0
  271. package/dist/wallet.js +93 -0
  272. package/dist/wallet.js.map +1 -0
  273. package/dist/wallet.test.d.ts +6 -0
  274. package/dist/wallet.test.d.ts.map +1 -0
  275. package/dist/wallet.test.js +117 -0
  276. package/dist/wallet.test.js.map +1 -0
  277. package/dist/x402-sdk.test.d.ts +6 -0
  278. package/dist/x402-sdk.test.d.ts.map +1 -0
  279. package/dist/x402-sdk.test.js +161 -0
  280. package/dist/x402-sdk.test.js.map +1 -0
  281. package/package.json +1 -1
  282. package/scripts/e2e-multiturn.mjs +4 -1
@@ -0,0 +1,73 @@
1
+ /**
2
+ * Layer 3: Dictionary Encoding
3
+ *
4
+ * Replaces frequently repeated long phrases with short codes.
5
+ * Uses a static codebook of common patterns from production logs.
6
+ *
7
+ * Safe for LLM: Reversible substitution with codebook header.
8
+ * Expected savings: 4-8%
9
+ */
10
+ import { getInverseCodebook } from "../codebook.js";
11
+ /**
12
+ * Apply dictionary encoding to a string.
13
+ * Returns the encoded string and stats.
14
+ */
15
+ function encodeContent(content, inverseCodebook) {
16
+ // Defensive type check - content might be array/object for multimodal messages
17
+ if (!content || typeof content !== "string") {
18
+ return { encoded: content, substitutions: 0, codes: new Set(), charsSaved: 0 };
19
+ }
20
+ let encoded = content;
21
+ let substitutions = 0;
22
+ let charsSaved = 0;
23
+ const codes = new Set();
24
+ // Sort phrases by length (longest first) to avoid partial matches
25
+ const phrases = Object.keys(inverseCodebook).sort((a, b) => b.length - a.length);
26
+ for (const phrase of phrases) {
27
+ const code = inverseCodebook[phrase];
28
+ const regex = new RegExp(escapeRegex(phrase), "g");
29
+ const matches = encoded.match(regex);
30
+ if (matches && matches.length > 0) {
31
+ encoded = encoded.replace(regex, code);
32
+ substitutions += matches.length;
33
+ charsSaved += matches.length * (phrase.length - code.length);
34
+ codes.add(code);
35
+ }
36
+ }
37
+ return { encoded, substitutions, codes, charsSaved };
38
+ }
39
+ /**
40
+ * Escape special regex characters in a string.
41
+ */
42
+ function escapeRegex(str) {
43
+ return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
44
+ }
45
+ /**
46
+ * Apply dictionary encoding to all messages.
47
+ */
48
+ export function encodeMessages(messages) {
49
+ const inverseCodebook = getInverseCodebook();
50
+ let totalSubstitutions = 0;
51
+ let totalCharsSaved = 0;
52
+ const allUsedCodes = new Set();
53
+ const result = messages.map((message) => {
54
+ // Only process string content (skip arrays for multimodal messages)
55
+ if (!message.content || typeof message.content !== "string")
56
+ return message;
57
+ const { encoded, substitutions, codes, charsSaved } = encodeContent(message.content, inverseCodebook);
58
+ totalSubstitutions += substitutions;
59
+ totalCharsSaved += charsSaved;
60
+ codes.forEach((code) => allUsedCodes.add(code));
61
+ return {
62
+ ...message,
63
+ content: encoded,
64
+ };
65
+ });
66
+ return {
67
+ messages: result,
68
+ substitutionCount: totalSubstitutions,
69
+ usedCodes: allUsedCodes,
70
+ charsSaved: totalCharsSaved,
71
+ };
72
+ }
73
+ //# sourceMappingURL=dictionary.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dictionary.js","sourceRoot":"","sources":["../../../src/compression/layers/dictionary.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,26 @@
1
+ /**
2
+ * L7: Dynamic Codebook Builder
3
+ *
4
+ * Inspired by claw-compactor's frequency-based codebook.
5
+ * Builds codebook from actual content being compressed,
6
+ * rather than relying on static patterns.
7
+ *
8
+ * Finds phrases that appear 3+ times and replaces with short codes.
9
+ */
10
+ import { NormalizedMessage } from "../types.js";
11
+ interface DynamicCodebookResult {
12
+ messages: NormalizedMessage[];
13
+ charsSaved: number;
14
+ dynamicCodes: Record<string, string>;
15
+ substitutions: number;
16
+ }
17
+ /**
18
+ * Apply dynamic codebook to messages.
19
+ */
20
+ export declare function applyDynamicCodebook(messages: NormalizedMessage[]): DynamicCodebookResult;
21
+ /**
22
+ * Generate header for dynamic codes (to include in system message).
23
+ */
24
+ export declare function generateDynamicCodebookHeader(codebook: Record<string, string>): string;
25
+ export {};
26
+ //# sourceMappingURL=dynamic-codebook.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dynamic-codebook.d.ts","sourceRoot":"","sources":["../../../src/compression/layers/dynamic-codebook.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,UAAU,qBAAqB;IAC7B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,aAAa,EAAE,MAAM,CAAC;CACvB;AAyFD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,qBAAqB,CAmDzF;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAatF"}
@@ -0,0 +1,149 @@
1
+ /**
2
+ * L7: Dynamic Codebook Builder
3
+ *
4
+ * Inspired by claw-compactor's frequency-based codebook.
5
+ * Builds codebook from actual content being compressed,
6
+ * rather than relying on static patterns.
7
+ *
8
+ * Finds phrases that appear 3+ times and replaces with short codes.
9
+ */
10
+ // Config
11
+ const MIN_PHRASE_LENGTH = 20;
12
+ const MAX_PHRASE_LENGTH = 200;
13
+ const MIN_FREQUENCY = 3;
14
+ const MAX_ENTRIES = 100;
15
+ const CODE_PREFIX = "$D"; // Dynamic codes: $D01, $D02, etc.
16
+ /**
17
+ * Find repeated phrases in content.
18
+ */
19
+ function findRepeatedPhrases(allContent) {
20
+ const phrases = new Map();
21
+ // Split by sentence-like boundaries
22
+ const segments = allContent.split(/(?<=[.!?\n])\s+/);
23
+ for (const segment of segments) {
24
+ const trimmed = segment.trim();
25
+ if (trimmed.length >= MIN_PHRASE_LENGTH && trimmed.length <= MAX_PHRASE_LENGTH) {
26
+ phrases.set(trimmed, (phrases.get(trimmed) || 0) + 1);
27
+ }
28
+ }
29
+ // Also find repeated lines
30
+ const lines = allContent.split("\n");
31
+ for (const line of lines) {
32
+ const trimmed = line.trim();
33
+ if (trimmed.length >= MIN_PHRASE_LENGTH && trimmed.length <= MAX_PHRASE_LENGTH) {
34
+ phrases.set(trimmed, (phrases.get(trimmed) || 0) + 1);
35
+ }
36
+ }
37
+ return phrases;
38
+ }
39
+ /**
40
+ * Build dynamic codebook from message content.
41
+ */
42
+ function buildDynamicCodebook(messages) {
43
+ // Combine all content
44
+ let allContent = "";
45
+ for (const msg of messages) {
46
+ // Only process string content (skip arrays for multimodal messages)
47
+ if (msg.content && typeof msg.content === "string") {
48
+ allContent += msg.content + "\n";
49
+ }
50
+ }
51
+ // Find repeated phrases
52
+ const phrases = findRepeatedPhrases(allContent);
53
+ // Filter by frequency and sort by savings potential
54
+ const candidates = [];
55
+ for (const [phrase, count] of phrases.entries()) {
56
+ if (count >= MIN_FREQUENCY) {
57
+ // Savings = (phrase length - code length) * occurrences
58
+ const codeLength = 4; // e.g., "$D01"
59
+ const savings = (phrase.length - codeLength) * count;
60
+ if (savings > 50) {
61
+ candidates.push({ phrase, count, savings });
62
+ }
63
+ }
64
+ }
65
+ // Sort by savings (descending) and take top entries
66
+ candidates.sort((a, b) => b.savings - a.savings);
67
+ const topCandidates = candidates.slice(0, MAX_ENTRIES);
68
+ // Build codebook
69
+ const codebook = {};
70
+ topCandidates.forEach((c, i) => {
71
+ const code = `${CODE_PREFIX}${String(i + 1).padStart(2, "0")}`;
72
+ codebook[code] = c.phrase;
73
+ });
74
+ return codebook;
75
+ }
76
+ /**
77
+ * Escape special regex characters.
78
+ */
79
+ function escapeRegex(str) {
80
+ // Defensive type check
81
+ if (!str || typeof str !== "string")
82
+ return "";
83
+ return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
84
+ }
85
+ /**
86
+ * Apply dynamic codebook to messages.
87
+ */
88
+ export function applyDynamicCodebook(messages) {
89
+ // Build codebook from content
90
+ const codebook = buildDynamicCodebook(messages);
91
+ if (Object.keys(codebook).length === 0) {
92
+ return {
93
+ messages,
94
+ charsSaved: 0,
95
+ dynamicCodes: {},
96
+ substitutions: 0,
97
+ };
98
+ }
99
+ // Create inverse map for replacement
100
+ const phraseToCode = {};
101
+ for (const [code, phrase] of Object.entries(codebook)) {
102
+ phraseToCode[phrase] = code;
103
+ }
104
+ // Sort phrases by length (longest first) to avoid partial replacements
105
+ const sortedPhrases = Object.keys(phraseToCode).sort((a, b) => b.length - a.length);
106
+ let charsSaved = 0;
107
+ let substitutions = 0;
108
+ // Apply replacements
109
+ const result = messages.map((msg) => {
110
+ // Only process string content (skip arrays for multimodal messages)
111
+ if (!msg.content || typeof msg.content !== "string")
112
+ return msg;
113
+ let content = msg.content;
114
+ for (const phrase of sortedPhrases) {
115
+ const code = phraseToCode[phrase];
116
+ const regex = new RegExp(escapeRegex(phrase), "g");
117
+ const matches = content.match(regex);
118
+ if (matches) {
119
+ content = content.replace(regex, code);
120
+ charsSaved += (phrase.length - code.length) * matches.length;
121
+ substitutions += matches.length;
122
+ }
123
+ }
124
+ return { ...msg, content };
125
+ });
126
+ return {
127
+ messages: result,
128
+ charsSaved,
129
+ dynamicCodes: codebook,
130
+ substitutions,
131
+ };
132
+ }
133
+ /**
134
+ * Generate header for dynamic codes (to include in system message).
135
+ */
136
+ export function generateDynamicCodebookHeader(codebook) {
137
+ if (Object.keys(codebook).length === 0)
138
+ return "";
139
+ const entries = Object.entries(codebook)
140
+ .slice(0, 20) // Limit header size
141
+ .map(([code, phrase]) => {
142
+ // Truncate long phrases in header
143
+ const displayPhrase = phrase.length > 40 ? phrase.slice(0, 37) + "..." : phrase;
144
+ return `${code}=${displayPhrase}`;
145
+ })
146
+ .join(", ");
147
+ return `[DynDict: ${entries}]`;
148
+ }
149
+ //# sourceMappingURL=dynamic-codebook.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dynamic-codebook.js","sourceRoot":"","sources":["../../../src/compression/layers/dynamic-codebook.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,23 @@
1
+ /**
2
+ * Layer 5: JSON Compaction
3
+ *
4
+ * Minifies JSON in tool_call arguments and tool results.
5
+ * Removes pretty-print whitespace from JSON strings.
6
+ *
7
+ * Safe for LLM: JSON semantics unchanged.
8
+ * Expected savings: 2-4%
9
+ */
10
+ import { NormalizedMessage } from "../types.js";
11
+ export interface JsonCompactResult {
12
+ messages: NormalizedMessage[];
13
+ charsSaved: number;
14
+ }
15
+ /**
16
+ * Apply JSON compaction to all messages.
17
+ *
18
+ * Targets:
19
+ * - tool_call arguments (in assistant messages)
20
+ * - tool message content (often JSON)
21
+ */
22
+ export declare function compactMessagesJson(messages: NormalizedMessage[]): JsonCompactResult;
23
+ //# sourceMappingURL=json-compact.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"json-compact.d.ts","sourceRoot":"","sources":["../../../src/compression/layers/json-compact.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,iBAAiB,EAAY,MAAM,aAAa,CAAC;AAE1D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;CACpB;AAuCD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,CAmCpF"}
@@ -0,0 +1,79 @@
1
+ /**
2
+ * Layer 5: JSON Compaction
3
+ *
4
+ * Minifies JSON in tool_call arguments and tool results.
5
+ * Removes pretty-print whitespace from JSON strings.
6
+ *
7
+ * Safe for LLM: JSON semantics unchanged.
8
+ * Expected savings: 2-4%
9
+ */
10
+ /**
11
+ * Compact a JSON string by parsing and re-stringifying without formatting.
12
+ */
13
+ function compactJson(jsonString) {
14
+ try {
15
+ const parsed = JSON.parse(jsonString);
16
+ return JSON.stringify(parsed);
17
+ }
18
+ catch {
19
+ // Not valid JSON, return as-is
20
+ return jsonString;
21
+ }
22
+ }
23
+ /**
24
+ * Check if a string looks like JSON (starts with { or [).
25
+ */
26
+ function looksLikeJson(str) {
27
+ const trimmed = str.trim();
28
+ return ((trimmed.startsWith("{") && trimmed.endsWith("}")) ||
29
+ (trimmed.startsWith("[") && trimmed.endsWith("]")));
30
+ }
31
+ /**
32
+ * Compact tool_call arguments in a message.
33
+ */
34
+ function compactToolCalls(toolCalls) {
35
+ return toolCalls.map((tc) => ({
36
+ ...tc,
37
+ function: {
38
+ ...tc.function,
39
+ arguments: compactJson(tc.function.arguments),
40
+ },
41
+ }));
42
+ }
43
+ /**
44
+ * Apply JSON compaction to all messages.
45
+ *
46
+ * Targets:
47
+ * - tool_call arguments (in assistant messages)
48
+ * - tool message content (often JSON)
49
+ */
50
+ export function compactMessagesJson(messages) {
51
+ let charsSaved = 0;
52
+ const result = messages.map((message) => {
53
+ const newMessage = { ...message };
54
+ // Compact tool_calls arguments
55
+ if (message.tool_calls && message.tool_calls.length > 0) {
56
+ const originalLength = JSON.stringify(message.tool_calls).length;
57
+ newMessage.tool_calls = compactToolCalls(message.tool_calls);
58
+ const newLength = JSON.stringify(newMessage.tool_calls).length;
59
+ charsSaved += originalLength - newLength;
60
+ }
61
+ // Compact tool message content if it looks like JSON
62
+ // Only process string content (skip arrays for multimodal messages)
63
+ if (message.role === "tool" &&
64
+ message.content &&
65
+ typeof message.content === "string" &&
66
+ looksLikeJson(message.content)) {
67
+ const originalLength = message.content.length;
68
+ const compacted = compactJson(message.content);
69
+ charsSaved += originalLength - compacted.length;
70
+ newMessage.content = compacted;
71
+ }
72
+ return newMessage;
73
+ });
74
+ return {
75
+ messages: result,
76
+ charsSaved,
77
+ };
78
+ }
79
+ //# sourceMappingURL=json-compact.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"json-compact.js","sourceRoot":"","sources":["../../../src/compression/layers/json-compact.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH;;GAEG;AACH,SAAS,WAAW,CAAC,UAAkB;IACrC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,+BAA+B;QAC/B,OAAO,UAAU,CAAC;IACpB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,GAAW;IAChC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,OAAO,CACL,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAClD,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CACnD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,SAAqB;IAC7C,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAC5B,GAAG,EAAE;QACL,QAAQ,EAAE;YACR,GAAG,EAAE,CAAC,QAAQ;YACd,SAAS,EAAE,WAAW,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC;SAC9C;KACF,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAA6B;IAC/D,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QACtC,MAAM,UAAU,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;QAElC,+BAA+B;QAC/B,IAAI,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxD,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC;YACjE,UAAU,CAAC,UAAU,GAAG,gBAAgB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAC7D,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC;YAC/D,UAAU,IAAI,cAAc,GAAG,SAAS,CAAC;QAC3C,CAAC;QAED,qDAAqD;QACrD,oEAAoE;QACpE,IACE,OAAO,CAAC,IAAI,KAAK,MAAM;YACvB,OAAO,CAAC,OAAO;YACf,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ;YACnC,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,EAC9B,CAAC;YACD,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;YAC9C,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC/C,UAAU,IAAI,cAAc,GAAG,SAAS,CAAC,MAAM,CAAC;YAChD,UAAU,CAAC,OAAO,GAAG,SAAS,CAAC;QACjC,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,QAAQ,EAAE,MAAM;QAChB,UAAU;KACX,CAAC;AACJ,CAAC"}
@@ -0,0 +1,21 @@
1
+ /**
2
+ * L6: Observation Compression (AGGRESSIVE)
3
+ *
4
+ * Inspired by claw-compactor's 97% compression on tool results.
5
+ * Tool call results (especially large ones) are summarized to key info only.
6
+ *
7
+ * This is the biggest compression win - tool outputs can be 10KB+ but
8
+ * only ~200 chars of actual useful information.
9
+ */
10
+ import { NormalizedMessage } from "../types.js";
11
+ interface ObservationResult {
12
+ messages: NormalizedMessage[];
13
+ charsSaved: number;
14
+ observationsCompressed: number;
15
+ }
16
+ /**
17
+ * Compress tool results in messages.
18
+ */
19
+ export declare function compressObservations(messages: NormalizedMessage[]): ObservationResult;
20
+ export {};
21
+ //# sourceMappingURL=observation.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"observation.d.ts","sourceRoot":"","sources":["../../../src/compression/layers/observation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,UAAU,iBAAiB;IACzB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAoHD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,CAuCrF"}
@@ -0,0 +1,130 @@
1
+ /**
2
+ * L6: Observation Compression (AGGRESSIVE)
3
+ *
4
+ * Inspired by claw-compactor's 97% compression on tool results.
5
+ * Tool call results (especially large ones) are summarized to key info only.
6
+ *
7
+ * This is the biggest compression win - tool outputs can be 10KB+ but
8
+ * only ~200 chars of actual useful information.
9
+ */
10
+ // Max length for tool results before compression kicks in
11
+ const TOOL_RESULT_THRESHOLD = 500;
12
+ // Max length to compress tool results down to
13
+ const COMPRESSED_RESULT_MAX = 300;
14
+ /**
15
+ * Extract key information from tool result.
16
+ * Keeps: errors, key values, status, first/last important lines.
17
+ */
18
+ function compressToolResult(content) {
19
+ if (!content || content.length <= TOOL_RESULT_THRESHOLD) {
20
+ return content;
21
+ }
22
+ const lines = content
23
+ .split("\n")
24
+ .map((l) => l.trim())
25
+ .filter(Boolean);
26
+ // Priority 1: Error messages (always keep)
27
+ const errorLines = lines.filter((l) => /error|exception|failed|denied|refused|timeout|invalid/i.test(l) && l.length < 200);
28
+ // Priority 2: Status/result lines
29
+ const statusLines = lines.filter((l) => /success|complete|created|updated|found|result|status|total|count/i.test(l) && l.length < 150);
30
+ // Priority 3: Key JSON fields (extract important values)
31
+ const jsonMatches = [];
32
+ const jsonPattern = /"(id|name|status|error|message|count|total|url|path)":\s*"?([^",}\n]+)"?/gi;
33
+ let match;
34
+ while ((match = jsonPattern.exec(content)) !== null) {
35
+ jsonMatches.push(`${match[1]}: ${match[2].slice(0, 50)}`);
36
+ }
37
+ // Priority 4: First and last meaningful lines
38
+ const firstLine = lines[0]?.slice(0, 100);
39
+ const lastLine = lines.length > 1 ? lines[lines.length - 1]?.slice(0, 100) : "";
40
+ // Build compressed observation
41
+ const parts = [];
42
+ if (errorLines.length > 0) {
43
+ parts.push("[ERR] " + errorLines.slice(0, 3).join(" | "));
44
+ }
45
+ if (statusLines.length > 0) {
46
+ parts.push(statusLines.slice(0, 3).join(" | "));
47
+ }
48
+ if (jsonMatches.length > 0) {
49
+ parts.push(jsonMatches.slice(0, 5).join(", "));
50
+ }
51
+ if (parts.length === 0) {
52
+ // Fallback: keep first/last lines with truncation marker
53
+ parts.push(firstLine || "");
54
+ if (lines.length > 2) {
55
+ parts.push(`[...${lines.length - 2} lines...]`);
56
+ }
57
+ if (lastLine && lastLine !== firstLine) {
58
+ parts.push(lastLine);
59
+ }
60
+ }
61
+ let result = parts.join("\n");
62
+ // Final length cap
63
+ if (result.length > COMPRESSED_RESULT_MAX) {
64
+ result = result.slice(0, COMPRESSED_RESULT_MAX - 20) + "\n[...truncated]";
65
+ }
66
+ return result;
67
+ }
68
+ /**
69
+ * Compress large repeated content blocks.
70
+ * Detects when same large block appears multiple times.
71
+ */
72
+ function deduplicateLargeBlocks(messages) {
73
+ const blockHashes = new Map(); // hash -> first occurrence index
74
+ let charsSaved = 0;
75
+ const result = messages.map((msg, idx) => {
76
+ // Only process string content (skip arrays for multimodal messages)
77
+ if (!msg.content || typeof msg.content !== "string" || msg.content.length < 500) {
78
+ return msg;
79
+ }
80
+ // Hash first 200 chars as block identifier
81
+ const blockKey = msg.content.slice(0, 200);
82
+ if (blockHashes.has(blockKey)) {
83
+ const firstIdx = blockHashes.get(blockKey);
84
+ const original = msg.content;
85
+ const compressed = `[See message #${firstIdx + 1} - same content]`;
86
+ charsSaved += original.length - compressed.length;
87
+ return { ...msg, content: compressed };
88
+ }
89
+ blockHashes.set(blockKey, idx);
90
+ return msg;
91
+ });
92
+ return { messages: result, charsSaved };
93
+ }
94
+ /**
95
+ * Compress tool results in messages.
96
+ */
97
+ export function compressObservations(messages) {
98
+ let charsSaved = 0;
99
+ let observationsCompressed = 0;
100
+ // First pass: compress individual tool results
101
+ let result = messages.map((msg) => {
102
+ // Only compress tool role messages (these are tool call results)
103
+ // Only process string content (skip arrays for multimodal messages)
104
+ if (msg.role !== "tool" || !msg.content || typeof msg.content !== "string") {
105
+ return msg;
106
+ }
107
+ const original = msg.content;
108
+ if (original.length <= TOOL_RESULT_THRESHOLD) {
109
+ return msg;
110
+ }
111
+ const compressed = compressToolResult(original);
112
+ const saved = original.length - compressed.length;
113
+ if (saved > 50) {
114
+ charsSaved += saved;
115
+ observationsCompressed++;
116
+ return { ...msg, content: compressed };
117
+ }
118
+ return msg;
119
+ });
120
+ // Second pass: deduplicate large repeated blocks
121
+ const dedupResult = deduplicateLargeBlocks(result);
122
+ result = dedupResult.messages;
123
+ charsSaved += dedupResult.charsSaved;
124
+ return {
125
+ messages: result,
126
+ charsSaved,
127
+ observationsCompressed,
128
+ };
129
+ }
130
+ //# sourceMappingURL=observation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"observation.js","sourceRoot":"","sources":["../../../src/compression/layers/observation.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,24 @@
1
+ /**
2
+ * Layer 4: Path Shortening
3
+ *
4
+ * Detects common filesystem path prefixes and replaces them with short codes.
5
+ * Common in coding assistant contexts with repeated file paths.
6
+ *
7
+ * Safe for LLM: Lossless abbreviation with path map header.
8
+ * Expected savings: 1-3%
9
+ */
10
+ import { NormalizedMessage } from "../types.js";
11
+ export interface PathShorteningResult {
12
+ messages: NormalizedMessage[];
13
+ pathMap: Record<string, string>;
14
+ charsSaved: number;
15
+ }
16
+ /**
17
+ * Apply path shortening to all messages.
18
+ */
19
+ export declare function shortenPaths(messages: NormalizedMessage[]): PathShorteningResult;
20
+ /**
21
+ * Generate the path map header for the codebook.
22
+ */
23
+ export declare function generatePathMapHeader(pathMap: Record<string, string>): string;
24
+ //# sourceMappingURL=paths.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/compression/layers/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;CACpB;AAgDD;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,oBAAoB,CAwDhF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAQ7E"}