pi-agent-flow 2.0.2 → 2.0.6

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 (192) hide show
  1. package/README.md +1 -1
  2. package/agents/audit.md +24 -17
  3. package/agents/build.md +1 -1
  4. package/agents/craft.md +1 -1
  5. package/agents/debug.md +1 -1
  6. package/agents/ideas.md +1 -1
  7. package/agents/scout.md +8 -8
  8. package/agents/trace.md +23 -0
  9. package/dist/batch/batch-bash.d.ts +10 -0
  10. package/dist/batch/batch-bash.d.ts.map +1 -1
  11. package/dist/batch/batch-bash.js +35 -2
  12. package/dist/batch/batch-bash.js.map +1 -1
  13. package/dist/batch/constants.d.ts +6 -3
  14. package/dist/batch/constants.d.ts.map +1 -1
  15. package/dist/batch/execute.js +2 -2
  16. package/dist/batch/execute.js.map +1 -1
  17. package/dist/batch/index.d.ts +9 -11
  18. package/dist/batch/index.d.ts.map +1 -1
  19. package/dist/batch/index.js +88 -58
  20. package/dist/batch/index.js.map +1 -1
  21. package/dist/batch/render.d.ts +22 -5
  22. package/dist/batch/render.d.ts.map +1 -1
  23. package/dist/batch/render.js +332 -17
  24. package/dist/batch/render.js.map +1 -1
  25. package/dist/batch/summary.d.ts.map +1 -1
  26. package/dist/batch/summary.js +22 -4
  27. package/dist/batch/summary.js.map +1 -1
  28. package/dist/config/config.d.ts +5 -4
  29. package/dist/config/config.d.ts.map +1 -1
  30. package/dist/config/config.js +15 -5
  31. package/dist/config/config.js.map +1 -1
  32. package/dist/config/models.d.ts.map +1 -1
  33. package/dist/config/models.js +7 -1
  34. package/dist/config/models.js.map +1 -1
  35. package/dist/config/settings-resolver.d.ts +5 -4
  36. package/dist/config/settings-resolver.d.ts.map +1 -1
  37. package/dist/config/settings-resolver.js +50 -21
  38. package/dist/config/settings-resolver.js.map +1 -1
  39. package/dist/core2/snapshot.d.ts +21 -0
  40. package/dist/core2/snapshot.d.ts.map +1 -0
  41. package/dist/core2/snapshot.js +214 -0
  42. package/dist/core2/snapshot.js.map +1 -0
  43. package/dist/{core → flow}/agents.d.ts.map +1 -1
  44. package/dist/{core → flow}/agents.js +5 -2
  45. package/dist/{core → flow}/agents.js.map +1 -1
  46. package/dist/flow/command.d.ts +1 -1
  47. package/dist/flow/command.d.ts.map +1 -1
  48. package/dist/flow/complexity.d.ts +20 -0
  49. package/dist/flow/complexity.d.ts.map +1 -0
  50. package/dist/flow/complexity.js +34 -0
  51. package/dist/flow/complexity.js.map +1 -0
  52. package/dist/flow/continuation.d.ts +1 -1
  53. package/dist/flow/continuation.d.ts.map +1 -1
  54. package/dist/flow/continuation.js +2 -1
  55. package/dist/flow/continuation.js.map +1 -1
  56. package/dist/{core → flow}/depth.d.ts +1 -1
  57. package/dist/{core → flow}/depth.d.ts.map +1 -1
  58. package/dist/{core → flow}/depth.js.map +1 -1
  59. package/dist/{core → flow}/executor.d.ts +39 -19
  60. package/dist/flow/executor.d.ts.map +1 -0
  61. package/dist/flow/executor.js +727 -0
  62. package/dist/flow/executor.js.map +1 -0
  63. package/dist/flow/index.d.ts +2 -2
  64. package/dist/flow/index.d.ts.map +1 -1
  65. package/dist/flow/index.js +1 -1
  66. package/dist/flow/index.js.map +1 -1
  67. package/dist/flow/loop-command.d.ts +1 -1
  68. package/dist/flow/loop-command.d.ts.map +1 -1
  69. package/dist/{core/flow.d.ts → flow/runner.d.ts} +10 -13
  70. package/dist/flow/runner.d.ts.map +1 -0
  71. package/dist/{core/flow.js → flow/runner.js} +35 -34
  72. package/dist/flow/runner.js.map +1 -0
  73. package/dist/{core → flow}/session-registry.d.ts.map +1 -1
  74. package/dist/{core → flow}/session-registry.js.map +1 -1
  75. package/dist/flow/settings-command.d.ts +3 -3
  76. package/dist/flow/settings-command.d.ts.map +1 -1
  77. package/dist/flow/settings-command.js +39 -21
  78. package/dist/flow/settings-command.js.map +1 -1
  79. package/dist/{core → flow}/transition.d.ts.map +1 -1
  80. package/dist/{core → flow}/transition.js.map +1 -1
  81. package/dist/flow/types.d.ts +4 -0
  82. package/dist/flow/types.d.ts.map +1 -1
  83. package/dist/flow/warp.d.ts +1 -1
  84. package/dist/flow/warp.d.ts.map +1 -1
  85. package/dist/index.d.ts +1 -2
  86. package/dist/index.d.ts.map +1 -1
  87. package/dist/index.js +190 -189
  88. package/dist/index.js.map +1 -1
  89. package/dist/notify/notify.d.ts +1 -1
  90. package/dist/notify/notify.d.ts.map +1 -1
  91. package/dist/notify/notify.js +1 -1
  92. package/dist/snapshot/cli-args.d.ts +2 -2
  93. package/dist/snapshot/cli-args.d.ts.map +1 -1
  94. package/dist/snapshot/cli-args.js +21 -5
  95. package/dist/snapshot/cli-args.js.map +1 -1
  96. package/dist/snapshot/runner-events.d.ts +2 -2
  97. package/dist/snapshot/runner-events.d.ts.map +1 -1
  98. package/dist/snapshot/runner-events.js +48 -4
  99. package/dist/snapshot/runner-events.js.map +1 -1
  100. package/dist/snapshot/structured-output.d.ts +1 -1
  101. package/dist/snapshot/structured-output.d.ts.map +1 -1
  102. package/dist/snapshot/structured-output.js +20 -2
  103. package/dist/snapshot/structured-output.js.map +1 -1
  104. package/dist/steering/flow-prompt.d.ts +1 -3
  105. package/dist/steering/flow-prompt.d.ts.map +1 -1
  106. package/dist/steering/flow-prompt.js +7 -63
  107. package/dist/steering/flow-prompt.js.map +1 -1
  108. package/dist/steering/sliding-prompt.js +10 -10
  109. package/dist/steering/sliding-prompt.js.map +1 -1
  110. package/dist/tools/ask-user.d.ts +2 -2
  111. package/dist/tools/ask-user.d.ts.map +1 -1
  112. package/dist/tools/ask-user.js +1 -1
  113. package/dist/tools/ask-user.js.map +1 -1
  114. package/dist/tools/timed-bash.js +1 -1
  115. package/dist/tools/timed-bash.js.map +1 -1
  116. package/dist/tools/trace.d.ts +34 -0
  117. package/dist/tools/trace.d.ts.map +1 -0
  118. package/dist/tools/trace.js +180 -0
  119. package/dist/tools/trace.js.map +1 -0
  120. package/dist/tools/web-ops.d.ts +85 -0
  121. package/dist/tools/web-ops.d.ts.map +1 -0
  122. package/dist/tools/{web-tool.js → web-ops.js} +51 -125
  123. package/dist/tools/web-ops.js.map +1 -0
  124. package/dist/tui/flow-colors.d.ts +1 -0
  125. package/dist/tui/flow-colors.d.ts.map +1 -1
  126. package/dist/tui/flow-colors.js +2 -2
  127. package/dist/tui/flow-colors.js.map +1 -1
  128. package/dist/tui/render-utils.js +1 -1
  129. package/dist/tui/render-utils.js.map +1 -1
  130. package/dist/tui/render.d.ts +32 -1
  131. package/dist/tui/render.d.ts.map +1 -1
  132. package/dist/tui/render.js +666 -170
  133. package/dist/tui/render.js.map +1 -1
  134. package/dist/tui/scramble/algorithm.d.ts +4 -2
  135. package/dist/tui/scramble/algorithm.d.ts.map +1 -1
  136. package/dist/tui/scramble/algorithm.js +44 -12
  137. package/dist/tui/scramble/algorithm.js.map +1 -1
  138. package/dist/tui/scramble/constants.d.ts +3 -0
  139. package/dist/tui/scramble/constants.d.ts.map +1 -1
  140. package/dist/tui/scramble/constants.js +4 -1
  141. package/dist/tui/scramble/constants.js.map +1 -1
  142. package/dist/tui/scramble/index.d.ts +2 -1
  143. package/dist/tui/scramble/index.d.ts.map +1 -1
  144. package/dist/tui/scramble/index.js +1 -1
  145. package/dist/tui/scramble/index.js.map +1 -1
  146. package/dist/tui/scramble/manager.d.ts +1 -1
  147. package/dist/tui/scramble/manager.d.ts.map +1 -1
  148. package/dist/tui/scramble/manager.js +24 -19
  149. package/dist/tui/scramble/manager.js.map +1 -1
  150. package/dist/types/flow.d.ts +17 -1
  151. package/dist/types/flow.d.ts.map +1 -1
  152. package/dist/types/flow.js.map +1 -1
  153. package/dist/types/output.d.ts +11 -36
  154. package/dist/types/output.d.ts.map +1 -1
  155. package/dist/types/output.js +1 -1
  156. package/dist/types/ui.d.ts +1 -1
  157. package/dist/types/ui.d.ts.map +1 -1
  158. package/package.json +9 -9
  159. package/dist/core/executor.d.ts.map +0 -1
  160. package/dist/core/executor.js +0 -378
  161. package/dist/core/executor.js.map +0 -1
  162. package/dist/core/flow.d.ts.map +0 -1
  163. package/dist/core/flow.js.map +0 -1
  164. package/dist/core/session-mode.d.ts +0 -11
  165. package/dist/core/session-mode.d.ts.map +0 -1
  166. package/dist/core/session-mode.js +0 -26
  167. package/dist/core/session-mode.js.map +0 -1
  168. package/dist/core/transitions.d.ts +0 -39
  169. package/dist/core/transitions.d.ts.map +0 -1
  170. package/dist/core/transitions.js +0 -59
  171. package/dist/core/transitions.js.map +0 -1
  172. package/dist/snapshot/index.d.ts +0 -2
  173. package/dist/snapshot/index.d.ts.map +0 -1
  174. package/dist/snapshot/index.js +0 -2
  175. package/dist/snapshot/index.js.map +0 -1
  176. package/dist/snapshot/reasoning-strip.d.ts +0 -22
  177. package/dist/snapshot/reasoning-strip.d.ts.map +0 -1
  178. package/dist/snapshot/reasoning-strip.js +0 -58
  179. package/dist/snapshot/reasoning-strip.js.map +0 -1
  180. package/dist/snapshot/snapshot.d.ts +0 -77
  181. package/dist/snapshot/snapshot.d.ts.map +0 -1
  182. package/dist/snapshot/snapshot.js +0 -1824
  183. package/dist/snapshot/snapshot.js.map +0 -1
  184. package/dist/tools/web-tool.d.ts +0 -46
  185. package/dist/tools/web-tool.d.ts.map +0 -1
  186. package/dist/tools/web-tool.js.map +0 -1
  187. /package/dist/{core → flow}/agents.d.ts +0 -0
  188. /package/dist/{core → flow}/depth.js +0 -0
  189. /package/dist/{core → flow}/session-registry.d.ts +0 -0
  190. /package/dist/{core → flow}/session-registry.js +0 -0
  191. /package/dist/{core → flow}/transition.d.ts +0 -0
  192. /package/dist/{core → flow}/transition.js +0 -0
@@ -1 +0,0 @@
1
- {"version":3,"file":"transitions.js","sourceRoot":"","sources":["../../src/core/transitions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAiBjD,8EAA8E;AAC9E,4BAA4B;AAC5B,8EAA8E;AAE9E,MAAM,CAAC,MAAM,mBAAmB,GAAqB;IACpD,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,6GAA6G,EAAE;IACpK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,4EAA4E,EAAE;IACnI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,2FAA2F,EAAE;IAClJ,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,oGAAoG,EAAE;IAC3J,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,oGAAoG,EAAE;IAC3J,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,8EAA8E,EAAE;IACrI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,kGAAkG,EAAE;IACzJ,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,kEAAkE,EAAE;IACzH,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,sEAAsE,EAAE;IAC7H,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,2GAA2G,EAAE;CAClK,CAAC;AAEF,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAClC,MAA+C,EAC/C,OAAmH,EACnH,cAAgC,mBAAmB;IAEnD,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IACxE,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QAC7C,MAAM,SAAS,GAAG,aAAa,CAAC,MAAiD,CAAC,CAAC;QAEnF,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;YAC7B,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,UAAU;gBAAE,SAAS;YAElD,0BAA0B;YAC1B,IAAI,CAAC,CAAC,EAAE,KAAK,SAAS,IAAI,CAAC,SAAS;gBAAE,SAAS;YAC/C,IAAI,CAAC,CAAC,EAAE,KAAK,SAAS,IAAI,SAAS;gBAAE,SAAS;YAE9C,0CAA0C;YAC1C,IAAI,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC;gBAAE,SAAS;YAErD,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACzB,CAAC;IACF,CAAC;IAED,OAAO,QAAQ,CAAC;AACjB,CAAC"}
@@ -1,2 +0,0 @@
1
- export { extractStructuredOutput, generateCommandsFromHistory } from "./structured-output.js";
2
- //# sourceMappingURL=index.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/snapshot/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC"}
@@ -1,2 +0,0 @@
1
- export { extractStructuredOutput, generateCommandsFromHistory } from "./structured-output.js";
2
- //# sourceMappingURL=index.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/snapshot/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC"}
@@ -1,22 +0,0 @@
1
- /**
2
- * Canonical reasoning/thinking stripping for assistant messages.
3
- *
4
- * Shared between index.ts (session snapshot sanitization) and
5
- * runner-events.ts (inbound message cleaning).
6
- */
7
- /**
8
- * Strip thinking/reasoning content from an assistant message.
9
- *
10
- * Removes top-level reasoning fields and filters reasoning parts
11
- * from the content array. Returns the (possibly new) message and
12
- * a boolean indicating whether anything was changed.
13
- *
14
- * This is the canonical implementation used by both index.ts
15
- * (for session snapshot sanitization) and runner-events.ts
16
- * (for inbound message cleaning).
17
- */
18
- export declare function stripReasoningFromAssistantMessage(message: any): {
19
- message: any;
20
- changed: boolean;
21
- };
22
- //# sourceMappingURL=reasoning-strip.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"reasoning-strip.d.ts","sourceRoot":"","sources":["../../src/snapshot/reasoning-strip.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAsBH;;;;;;;;;;GAUG;AACH,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,GAAG,GAAG;IACjE,OAAO,EAAE,GAAG,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CACjB,CAwBA"}
@@ -1,58 +0,0 @@
1
- /**
2
- * Canonical reasoning/thinking stripping for assistant messages.
3
- *
4
- * Shared between index.ts (session snapshot sanitization) and
5
- * runner-events.ts (inbound message cleaning).
6
- */
7
- /** Message part types that represent reasoning/thinking content. */
8
- const REASONING_PART_TYPES = new Set([
9
- "thinking",
10
- "reasoning",
11
- "reasoning_content",
12
- "reasoningContent",
13
- ]);
14
- /** Top-level fields on assistant messages that carry reasoning data. */
15
- const REASONING_FIELDS = [
16
- "thinking",
17
- "thinkingSignature",
18
- "thinking_signature",
19
- "reasoning",
20
- "reasoningContent",
21
- "reasoning_content",
22
- "reasoningSignature",
23
- "reasoning_signature",
24
- ];
25
- /**
26
- * Strip thinking/reasoning content from an assistant message.
27
- *
28
- * Removes top-level reasoning fields and filters reasoning parts
29
- * from the content array. Returns the (possibly new) message and
30
- * a boolean indicating whether anything was changed.
31
- *
32
- * This is the canonical implementation used by both index.ts
33
- * (for session snapshot sanitization) and runner-events.ts
34
- * (for inbound message cleaning).
35
- */
36
- export function stripReasoningFromAssistantMessage(message) {
37
- let next = message;
38
- let changed = false;
39
- for (const field of REASONING_FIELDS) {
40
- if (field in next) {
41
- if (next === message)
42
- next = { ...message };
43
- delete next[field];
44
- changed = true;
45
- }
46
- }
47
- if (Array.isArray(message.content)) {
48
- const filteredContent = message.content.filter((part) => !REASONING_PART_TYPES.has(part?.type));
49
- if (filteredContent.length !== message.content.length) {
50
- if (next === message)
51
- next = { ...message };
52
- next.content = filteredContent;
53
- changed = true;
54
- }
55
- }
56
- return { message: next, changed };
57
- }
58
- //# sourceMappingURL=reasoning-strip.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"reasoning-strip.js","sourceRoot":"","sources":["../../src/snapshot/reasoning-strip.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,oEAAoE;AACpE,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACpC,UAAU;IACV,WAAW;IACX,mBAAmB;IACnB,kBAAkB;CAClB,CAAC,CAAC;AAEH,wEAAwE;AACxE,MAAM,gBAAgB,GAAG;IACxB,UAAU;IACV,mBAAmB;IACnB,oBAAoB;IACpB,WAAW;IACX,kBAAkB;IAClB,mBAAmB;IACnB,oBAAoB;IACpB,qBAAqB;CACrB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kCAAkC,CAAC,OAAY;IAI9D,IAAI,IAAI,GAAG,OAAO,CAAC;IACnB,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,KAAK,MAAM,KAAK,IAAI,gBAAgB,EAAE,CAAC;QACtC,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;YACnB,IAAI,IAAI,KAAK,OAAO;gBAAE,IAAI,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;YAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;YACnB,OAAO,GAAG,IAAI,CAAC;QAChB,CAAC;IACF,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACpC,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAC7C,CAAC,IAAS,EAAE,EAAE,CAAC,CAAC,oBAAoB,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CACpD,CAAC;QACF,IAAI,eAAe,CAAC,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACvD,IAAI,IAAI,KAAK,OAAO;gBAAE,IAAI,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;YAC5C,IAAI,CAAC,OAAO,GAAG,eAAe,CAAC;YAC/B,OAAO,GAAG,IAAI,CAAC;QAChB,CAAC;IACF,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AACnC,CAAC"}
@@ -1,77 +0,0 @@
1
- /**
2
- * Two JSONL protocols are used in this codebase:
3
- *
4
- * 1. Fork Snapshot Protocol (snapshot.ts):
5
- * Types: session, model_change, thinking_level_change, message
6
- * Purpose: Serialized session state passed to child flows via --session.
7
- * Emitted by buildForkSessionSnapshotJsonl() and consumed by
8
- * sanitizeForkSnapshot() before forking.
9
- *
10
- * 2. Streaming Stdout Protocol (runner-events.ts):
11
- * Types: session, agent_start, turn_start, message_start, message_end,
12
- * message_update
13
- * Sub-events under message_update: thinking_start, thinking_delta, text_delta
14
- * Purpose: Real-time events emitted by the pi process stdout during flow
15
- * execution. Parsed by processFlowJsonLine().
16
- */
17
- /**
18
- * Session snapshot building, sanitization, and tool result compression.
19
- *
20
- * Extracted from index.ts for single-responsibility and testability.
21
- */
22
- import type { CompressedFlowResult, DepthPolicy } from "../types/output.js";
23
- export interface SessionSnapshotSource {
24
- getHeader: () => unknown;
25
- getBranch: () => unknown[];
26
- }
27
- export declare function buildForkSessionSnapshotJsonl(sessionManager: SessionSnapshotSource): string | null;
28
- /**
29
- * Render a compressed flow result as compact text for child context.
30
- */
31
- export declare function renderCompressedFlowResult(r: CompressedFlowResult): string | undefined;
32
- /** Compress a single bash block into the X1 compact format. */
33
- /** Convert legacy depth number to DepthPolicy. */
34
- export declare function depthToPolicy(depth: number): DepthPolicy;
35
- /**
36
- * Compress tool results in a sanitized session snapshot.
37
- *
38
- * Handles two tool types:
39
- * - `flow` results: replaced with compact CompressedFlowResult output from cache.
40
- * - `batch_read` results: replaced with compact metadata (paths + op count)
41
- * since children have `batch` and can re-read files themselves.
42
- */
43
- export declare function compressToolResults(snapshot: string, cache: Map<string, CompressedFlowResult[]>, depthPolicy?: DepthPolicy): string;
44
- export declare function stripBatchReadToolCalls(snapshot: string): string;
45
- /**
46
- * Compress verbose `flow` tool call arguments in assistant messages.
47
- *
48
- * The child flow already receives its own `-p` activation prompt, so the full
49
- * mission text inside the JSONL assistant message is pure duplication.
50
- * Replaces the arguments with a compact summary `{type, aim, steps}`.
51
- */
52
- export declare function compressFlowToolCallArgs(snapshot: string): string;
53
- /**
54
- * Sanitize a fork session snapshot JSONL to remove non-inheritable
55
- * artifacts before passing parent context to child flows:
56
- * sliding system prompts, assistant reasoning/thinking,
57
- * batch_read tool calls, and compress flow/batch_read tool results.
58
- */
59
- export interface SanitizeForkSnapshotOptions {
60
- forkedFrom?: string;
61
- forkedAt?: string;
62
- parentFlow?: string;
63
- depth?: number;
64
- }
65
- export interface SanitizeForkSnapshotResult {
66
- result: string | null;
67
- passesApplied: string[];
68
- stats: {
69
- preBytes: number;
70
- postBytes: number;
71
- reductionPercent: number;
72
- passesApplied: string[];
73
- passDeltas?: Record<string, number>;
74
- } | null;
75
- }
76
- export declare function sanitizeForkSnapshot(snapshot: string | null, cache?: Map<string, CompressedFlowResult[]>, options?: SanitizeForkSnapshotOptions): SanitizeForkSnapshotResult;
77
- //# sourceMappingURL=snapshot.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/snapshot/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;;;GAIG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAe5E,MAAM,WAAW,qBAAqB;IACrC,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,SAAS,EAAE,MAAM,OAAO,EAAE,CAAC;CAC3B;AAgID,wBAAgB,6BAA6B,CAC5C,cAAc,EAAE,qBAAqB,GACnC,MAAM,GAAG,IAAI,CA4Cf;AAMD;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,EAAE,oBAAoB,GAAG,MAAM,GAAG,SAAS,CA0DtF;AAgCD,+DAA+D;AAC/D,kDAAkD;AAClD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAGxD;AAo1BD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,EAAE,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,MAAM,CAwQnI;AA4ED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAwEhE;AAMD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA6DjE;AAyED;;;;;GAKG;AACH,MAAM,WAAW,2BAA2B;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,0BAA0B;IAC1C,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;CAC9I;AAED,wBAAgB,oBAAoB,CACnC,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,KAAK,GAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,EAAE,CAAa,EACtD,OAAO,CAAC,EAAE,2BAA2B,GACnC,0BAA0B,CAkV5B"}