@asterxsk/kiln 0.1.0 → 0.2.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 (203) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +170 -170
  3. package/agent/AGENTS.md +67 -67
  4. package/agent/README.md +5 -5
  5. package/agent/extensions/AGENTS.md +68 -68
  6. package/agent/extensions/ask-user/index.ts +418 -418
  7. package/agent/extensions/ask-user/package-lock.json +769 -769
  8. package/agent/extensions/ask-user/package.json +19 -19
  9. package/agent/extensions/ask-user/prompt.ts +45 -45
  10. package/agent/extensions/ask-user/tsconfig.json +7 -7
  11. package/agent/extensions/background-terminals/docs/implementation-guide.md +942 -942
  12. package/agent/extensions/background-terminals/index.ts +627 -627
  13. package/agent/extensions/background-terminals/manager.test.ts +735 -735
  14. package/agent/extensions/background-terminals/output.test.ts +109 -109
  15. package/agent/extensions/background-terminals/package-lock.json +769 -769
  16. package/agent/extensions/background-terminals/package.json +17 -17
  17. package/agent/extensions/background-terminals/prompt.test.ts +125 -125
  18. package/agent/extensions/background-terminals/ps.test.ts +82 -82
  19. package/agent/extensions/background-terminals/result-delivery.test.ts +44 -44
  20. package/agent/extensions/background-terminals/src/domain.ts +87 -87
  21. package/agent/extensions/background-terminals/src/manager.ts +907 -907
  22. package/agent/extensions/background-terminals/src/output.ts +84 -84
  23. package/agent/extensions/background-terminals/src/prompt.ts +142 -142
  24. package/agent/extensions/background-terminals/src/result-delivery.ts +27 -27
  25. package/agent/extensions/background-terminals/src/runtime.ts +36 -36
  26. package/agent/extensions/background-terminals/src/ui/output-view.ts +79 -79
  27. package/agent/extensions/background-terminals/src/ui/ps.ts +621 -621
  28. package/agent/extensions/background-terminals/tsconfig.json +7 -7
  29. package/agent/extensions/file-search/index.spec.ts +443 -443
  30. package/agent/extensions/file-search/index.ts +459 -459
  31. package/agent/extensions/file-search/package-lock.json +2253 -2253
  32. package/agent/extensions/file-search/package.json +23 -23
  33. package/agent/extensions/file-search/src/args.ts +122 -122
  34. package/agent/extensions/file-search/src/binaries.ts +422 -422
  35. package/agent/extensions/file-search/src/output.ts +126 -126
  36. package/agent/extensions/file-search/src/process.ts +146 -146
  37. package/agent/extensions/file-search/src/prompt.ts +52 -52
  38. package/agent/extensions/file-search/tsconfig.json +7 -7
  39. package/agent/extensions/modelconf/PLAN.md +915 -915
  40. package/agent/extensions/modelconf/index.ts +296 -296
  41. package/agent/extensions/modelconf/src/ui/ModelConfView.ts +1101 -1101
  42. package/agent/extensions/pi-web-access/CHANGELOG.md +690 -690
  43. package/agent/extensions/pi-web-access/LICENSE +21 -21
  44. package/agent/extensions/pi-web-access/README.md +470 -470
  45. package/agent/extensions/pi-web-access/SECURITY.md +5 -5
  46. package/agent/extensions/pi-web-access/activity.ts +101 -101
  47. package/agent/extensions/pi-web-access/auth-fetch.ts +148 -148
  48. package/agent/extensions/pi-web-access/brightdata-unlocker.ts +272 -272
  49. package/agent/extensions/pi-web-access/chrome-cookies.ts +669 -669
  50. package/agent/extensions/pi-web-access/content-find.ts +139 -139
  51. package/agent/extensions/pi-web-access/credential-source.ts +191 -191
  52. package/agent/extensions/pi-web-access/data-uri-sanitize.ts +406 -406
  53. package/agent/extensions/pi-web-access/datalab-pdf-extract.ts +568 -568
  54. package/agent/extensions/pi-web-access/declared-web-links.ts +173 -173
  55. package/agent/extensions/pi-web-access/evidence/CONTRACT-EVIDENCE.md +496 -496
  56. package/agent/extensions/pi-web-access/evidence/contract-probe.mjs +140 -140
  57. package/agent/extensions/pi-web-access/exa.ts +526 -526
  58. package/agent/extensions/pi-web-access/extract.ts +1196 -1196
  59. package/agent/extensions/pi-web-access/feature-config.ts +29 -29
  60. package/agent/extensions/pi-web-access/fetch-params.ts +111 -111
  61. package/agent/extensions/pi-web-access/gemini-adc.ts +298 -298
  62. package/agent/extensions/pi-web-access/gemini-api.ts +353 -353
  63. package/agent/extensions/pi-web-access/gemini-pdf-extract.ts +108 -108
  64. package/agent/extensions/pi-web-access/gemini-url-context.ts +128 -128
  65. package/agent/extensions/pi-web-access/gemini-web-config.ts +101 -101
  66. package/agent/extensions/pi-web-access/gemini-web.ts +487 -487
  67. package/agent/extensions/pi-web-access/github-api.ts +197 -197
  68. package/agent/extensions/pi-web-access/github-extract.ts +746 -746
  69. package/agent/extensions/pi-web-access/github-issue-pr.ts +700 -700
  70. package/agent/extensions/pi-web-access/index.ts +1737 -1737
  71. package/agent/extensions/pi-web-access/package-lock.json +5808 -5808
  72. package/agent/extensions/pi-web-access/package.json +64 -64
  73. package/agent/extensions/pi-web-access/page-query.ts +96 -96
  74. package/agent/extensions/pi-web-access/pdf-extract.ts +409 -409
  75. package/agent/extensions/pi-web-access/promise-try.d.ts +7 -7
  76. package/agent/extensions/pi-web-access/query-rewrite.ts +51 -51
  77. package/agent/extensions/pi-web-access/render-search-error.ts +170 -170
  78. package/agent/extensions/pi-web-access/rsc-extract.ts +338 -338
  79. package/agent/extensions/pi-web-access/source-check.ts +282 -282
  80. package/agent/extensions/pi-web-access/ssrf-protection.ts +526 -526
  81. package/agent/extensions/pi-web-access/storage.ts +521 -521
  82. package/agent/extensions/pi-web-access/summary-model-scope.ts +125 -125
  83. package/agent/extensions/pi-web-access/test/auth-fetch.test.mjs +208 -208
  84. package/agent/extensions/pi-web-access/test/brightdata-unlocker.test.mjs +840 -840
  85. package/agent/extensions/pi-web-access/test/chrome-cookie-extraction.test.mjs +441 -441
  86. package/agent/extensions/pi-web-access/test/config-path.test.mjs +283 -283
  87. package/agent/extensions/pi-web-access/test/content-find.test.mjs +25 -25
  88. package/agent/extensions/pi-web-access/test/credential-source.test.mjs +118 -118
  89. package/agent/extensions/pi-web-access/test/data-uri-sanitize.test.mjs +210 -210
  90. package/agent/extensions/pi-web-access/test/datalab-pdf-extract.test.mjs +552 -552
  91. package/agent/extensions/pi-web-access/test/declared-web-links.test.mjs +212 -212
  92. package/agent/extensions/pi-web-access/test/fetch-answer-storage.test.mjs +40 -40
  93. package/agent/extensions/pi-web-access/test/fetch-cache-storage.test.mjs +334 -334
  94. package/agent/extensions/pi-web-access/test/fetch-content-domain-policy.test.mjs +95 -95
  95. package/agent/extensions/pi-web-access/test/fetch-modes.test.mjs +53 -53
  96. package/agent/extensions/pi-web-access/test/fetch-not-found-guidance.test.mjs +92 -92
  97. package/agent/extensions/pi-web-access/test/fetch-params.test.mjs +86 -86
  98. package/agent/extensions/pi-web-access/test/fetch-render-call.test.mjs +34 -34
  99. package/agent/extensions/pi-web-access/test/fetch-routing.test.mjs +173 -173
  100. package/agent/extensions/pi-web-access/test/gemini-adc-auth.test.mjs +257 -257
  101. package/agent/extensions/pi-web-access/test/gemini-api-transport.test.mjs +170 -170
  102. package/agent/extensions/pi-web-access/test/gemini-pdf-extract.test.mjs +133 -133
  103. package/agent/extensions/pi-web-access/test/gemini-web-cookie-opt-in.test.mjs +178 -178
  104. package/agent/extensions/pi-web-access/test/gemini-web-header-overflow.test.mjs +148 -148
  105. package/agent/extensions/pi-web-access/test/get-search-content.test.mjs +223 -223
  106. package/agent/extensions/pi-web-access/test/github-extract.test.mjs +378 -378
  107. package/agent/extensions/pi-web-access/test/github-issue-pr.test.mjs +565 -565
  108. package/agent/extensions/pi-web-access/test/inline-content-config.test.mjs +99 -99
  109. package/agent/extensions/pi-web-access/test/lazy-extract-load.test.mjs +118 -118
  110. package/agent/extensions/pi-web-access/test/local-video-oversize.test.mjs +52 -52
  111. package/agent/extensions/pi-web-access/test/package-typebox-dependency.test.mjs +50 -50
  112. package/agent/extensions/pi-web-access/test/page-query.test.mjs +51 -51
  113. package/agent/extensions/pi-web-access/test/pdf-config.test.mjs +140 -140
  114. package/agent/extensions/pi-web-access/test/pdf-extract.test.mjs +500 -500
  115. package/agent/extensions/pi-web-access/test/proxy-transport.test.mjs +286 -286
  116. package/agent/extensions/pi-web-access/test/query-rewrite.test.mjs +52 -52
  117. package/agent/extensions/pi-web-access/test/rsc-fallback.test.mjs +102 -102
  118. package/agent/extensions/pi-web-access/test/search-error-render.test.mjs +152 -152
  119. package/agent/extensions/pi-web-access/test/search-providers.test.mjs +274 -274
  120. package/agent/extensions/pi-web-access/test/source-check.test.mjs +179 -179
  121. package/agent/extensions/pi-web-access/test/ssrf-allow-ranges-config.test.mjs +205 -205
  122. package/agent/extensions/pi-web-access/test/ssrf-protection.test.mjs +456 -456
  123. package/agent/extensions/pi-web-access/test/tool-registration-config.test.mjs +182 -182
  124. package/agent/extensions/pi-web-access/test/youtube-extract-errors.test.mjs +64 -64
  125. package/agent/extensions/pi-web-access/tsconfig.json +11 -11
  126. package/agent/extensions/pi-web-access/utils.ts +451 -451
  127. package/agent/extensions/pi-web-access/video-extract.ts +392 -392
  128. package/agent/extensions/pi-web-access/youtube-extract.ts +328 -328
  129. package/agent/extensions/shared/activity-status.ts +31 -31
  130. package/agent/extensions/shared/child-session.test.ts +270 -270
  131. package/agent/extensions/shared/child-session.ts +148 -148
  132. package/agent/extensions/shared/context-utilization.test.ts +48 -48
  133. package/agent/extensions/shared/context-utilization.ts +47 -47
  134. package/agent/extensions/shared/dashboard-state.ts +99 -99
  135. package/agent/extensions/shared/tool-call-timeout.test.ts +117 -117
  136. package/agent/extensions/shared/tool-call-timeout.ts +104 -104
  137. package/agent/extensions/subagents/by-the-way.test.ts +29 -29
  138. package/agent/extensions/subagents/claude.test.ts +119 -119
  139. package/agent/extensions/subagents/codex.test.ts +102 -102
  140. package/agent/extensions/subagents/context-usage.test.ts +107 -107
  141. package/agent/extensions/subagents/docs/design-plan.md +568 -568
  142. package/agent/extensions/subagents/docs/effect-v4-extension-guide.md +354 -354
  143. package/agent/extensions/subagents/docs/effect-v4-notes.md +571 -571
  144. package/agent/extensions/subagents/index.ts +779 -779
  145. package/agent/extensions/subagents/manager.test.ts +276 -276
  146. package/agent/extensions/subagents/package-lock.json +2244 -2244
  147. package/agent/extensions/subagents/package.json +19 -19
  148. package/agent/extensions/subagents/result-delivery.test.ts +27 -27
  149. package/agent/extensions/subagents/src/backend.ts +73 -73
  150. package/agent/extensions/subagents/src/backends/claude.ts +701 -701
  151. package/agent/extensions/subagents/src/backends/codex.ts +1060 -1060
  152. package/agent/extensions/subagents/src/backends/pi.ts +575 -575
  153. package/agent/extensions/subagents/src/backends/stub.ts +300 -300
  154. package/agent/extensions/subagents/src/by-the-way.ts +21 -21
  155. package/agent/extensions/subagents/src/domain.ts +253 -253
  156. package/agent/extensions/subagents/src/format.ts +74 -74
  157. package/agent/extensions/subagents/src/manager.ts +736 -736
  158. package/agent/extensions/subagents/src/prompt.ts +92 -92
  159. package/agent/extensions/subagents/src/result-delivery.ts +20 -20
  160. package/agent/extensions/subagents/src/runtime.ts +53 -53
  161. package/agent/extensions/subagents/src/ui/takeover.ts +583 -583
  162. package/agent/extensions/subagents/src/ui/transcript.ts +201 -201
  163. package/agent/extensions/subagents/takeover.test.ts +29 -29
  164. package/agent/extensions/subagents/tsconfig.json +7 -7
  165. package/agent/extensions/todo/AGENTS.md +38 -38
  166. package/agent/extensions/todo/LICENSE +21 -21
  167. package/agent/extensions/todo/config.ts +55 -55
  168. package/agent/extensions/todo/index.ts +151 -151
  169. package/agent/extensions/todo/locales/de.json +17 -17
  170. package/agent/extensions/todo/locales/en.json +15 -15
  171. package/agent/extensions/todo/locales/es.json +17 -17
  172. package/agent/extensions/todo/locales/fr.json +17 -17
  173. package/agent/extensions/todo/locales/pt-BR.json +17 -17
  174. package/agent/extensions/todo/locales/pt.json +17 -17
  175. package/agent/extensions/todo/locales/ru.json +17 -17
  176. package/agent/extensions/todo/locales/uk.json +17 -17
  177. package/agent/extensions/todo/locales/zh.json +17 -17
  178. package/agent/extensions/todo/package-lock.json +3358 -3358
  179. package/agent/extensions/todo/package.json +67 -67
  180. package/agent/extensions/todo/state/i18n-bridge.ts +64 -64
  181. package/agent/extensions/todo/state/invariants.ts +20 -20
  182. package/agent/extensions/todo/state/replay.ts +38 -38
  183. package/agent/extensions/todo/state/selectors.ts +107 -107
  184. package/agent/extensions/todo/state/state-reducer.ts +326 -326
  185. package/agent/extensions/todo/state/state.ts +18 -18
  186. package/agent/extensions/todo/state/store.ts +82 -82
  187. package/agent/extensions/todo/state/task-graph.ts +57 -57
  188. package/agent/extensions/todo/todo-overlay.ts +200 -200
  189. package/agent/extensions/todo/todo.ts +155 -155
  190. package/agent/extensions/todo/tool/response-envelope.ts +109 -109
  191. package/agent/extensions/todo/tool/types.ts +206 -206
  192. package/agent/extensions/todo/view/format.ts +177 -177
  193. package/agent/install.ps1 +637 -527
  194. package/agent/install.sh +620 -511
  195. package/agent/keybindings.json +7 -7
  196. package/bin/kiln.js +124 -11
  197. package/package.json +8 -2
  198. package/agent/extensions/taste/index.ts +0 -443
  199. package/agent/extensions/taste/install.ps1 +0 -23
  200. package/agent/extensions/taste/install.sh +0 -21
  201. /package/agent/extensions/{status line → statusline}/index.ts +0 -0
  202. /package/agent/extensions/{status line → statusline}/install.ps1 +0 -0
  203. /package/agent/extensions/{status line → statusline}/install.sh +0 -0
@@ -1,201 +1,201 @@
1
- /**
2
- * Transcript rendering for the takeover view: turns a SubagentSnapshot's
3
- * normalized transcript + live state into plain wrapped lines. Ported from
4
- * v1, with the session-poking replaced by snapshot reads.
5
- */
6
-
7
- import type { Theme } from "@earendil-works/pi-coding-agent";
8
- import {
9
- truncateToWidth,
10
- visibleWidth,
11
- wrapTextWithAnsi,
12
- } from "@earendil-works/pi-tui";
13
- import type { SubagentSnapshot, TranscriptItem } from "../domain.ts";
14
-
15
- const ANSI_PATTERN =
16
- // eslint-disable-next-line no-control-regex
17
- /[\u001B\u009B][[\]()#;?]*(?:(?:(?:[a-zA-Z\d]*(?:;[a-zA-Z\d]*)*)?\u0007)|(?:(?:\d{1,4}(?:;\d{0,4})*)?[\dA-PR-TZcf-nq-uy=><~]))/g;
18
-
19
- /**
20
- * Strip raw ANSI codes, expand tabs, and drop control chars. Terminal-expanded
21
- * tabs (and stray escapes) make lines wider than the width we declare to the
22
- * TUI, which desyncs the renderer and smears the overlay.
23
- */
24
- export function sanitizeText(text: string): string {
25
- return text
26
- .replace(ANSI_PATTERN, "")
27
- .replaceAll("\t", " ")
28
- .replace(/[\u0000-\u0008\u000b-\u001f\u007f]/g, "");
29
- }
30
-
31
- function renderUserText(
32
- theme: Theme,
33
- text: string,
34
- width: number,
35
- out: string[],
36
- ) {
37
- const clean = sanitizeText(text).trim();
38
- if (!clean) return;
39
- const wrapped = wrapTextWithAnsi(clean, Math.max(10, width - 2));
40
- for (let i = 0; i < wrapped.length; i++) {
41
- const prefix = i === 0 ? theme.fg("accent", "> ") : " ";
42
- out.push(
43
- truncateToWidth(prefix + theme.fg("userMessageText", wrapped[i]), width),
44
- );
45
- }
46
- }
47
-
48
- function renderThinking(
49
- theme: Theme,
50
- text: string,
51
- width: number,
52
- out: string[],
53
- ) {
54
- const reasoning = sanitizeText(text).trim();
55
- if (!reasoning) return;
56
- const prefix = theme.fg("dim", "~ ");
57
- // Preserve paragraph breaks so multi-paragraph reasoning doesn't collapse
58
- // into one wall of text; each paragraph gets its own `~` continuation.
59
- const wrapped = wrapTextWithAnsi(reasoning, Math.max(10, width - 2));
60
- for (let i = 0; i < wrapped.length; i++) {
61
- const line = wrapped[i];
62
- if (line.trim() === "" && i > 0) {
63
- out.push("");
64
- continue;
65
- }
66
- out.push(
67
- truncateToWidth(
68
- (i === 0 ? prefix : " ") + theme.fg("muted", theme.italic(line)),
69
- width,
70
- ),
71
- );
72
- }
73
- }
74
-
75
- function renderAssistantItem(
76
- theme: Theme,
77
- item: Extract<TranscriptItem, { kind: "assistant" }>,
78
- width: number,
79
- out: string[],
80
- ) {
81
- // A rendered reasoning block is followed by a blank line so the thinking
82
- // doesn't run into the answer/tool call that comes next.
83
- let pendingGap = false;
84
- for (const part of item.parts) {
85
- if (part.type === "text") {
86
- const text = sanitizeText(part.text).trim();
87
- if (!text) continue;
88
- if (pendingGap) out.push("");
89
- out.push(...wrapTextWithAnsi(text, width));
90
- pendingGap = false;
91
- } else if (part.type === "thinking") {
92
- const before = out.length;
93
- renderThinking(
94
- theme,
95
- part.redacted ? "[redacted reasoning]" : part.text,
96
- width,
97
- out,
98
- );
99
- pendingGap = out.length > before;
100
- } else if (part.type === "toolCall") {
101
- if (pendingGap) out.push("");
102
- const preview = part.argsPreview ? sanitizeText(part.argsPreview) : "";
103
- const line =
104
- theme.fg("muted", "→ ") +
105
- theme.fg("toolTitle", part.name) +
106
- (preview && preview !== "{}" ? theme.fg("dim", ` ${preview}`) : "");
107
- out.push(truncateToWidth(line, width));
108
- pendingGap = false;
109
- }
110
- }
111
- }
112
-
113
- function renderToolResultItem(
114
- theme: Theme,
115
- item: Extract<TranscriptItem, { kind: "toolResult" }>,
116
- width: number,
117
- out: string[],
118
- ) {
119
- const firstLine =
120
- sanitizeText(item.outputPreview ?? "")
121
- .split("\n")
122
- .find((line) => line.trim()) ?? "";
123
- const label = item.isError
124
- ? theme.fg("error", " error: ")
125
- : theme.fg("dim", " output: ");
126
- out.push(
127
- truncateToWidth(label + theme.fg("dim", firstLine || "(no output)"), width),
128
- );
129
- }
130
-
131
- /** Render a subagent's conversation as plain lines, wrapped to `width`. */
132
- export function buildTranscriptLines(
133
- snap: SubagentSnapshot,
134
- width: number,
135
- theme: Theme,
136
- ): string[] {
137
- const out: string[] = [];
138
-
139
- for (const item of snap.transcript) {
140
- const before = out.length;
141
- if (item.kind === "user") {
142
- renderUserText(theme, item.text, width, out);
143
- } else if (item.kind === "assistant") {
144
- renderAssistantItem(theme, item, width, out);
145
- } else {
146
- renderToolResultItem(theme, item, width, out);
147
- }
148
- if (out.length > before) out.push("");
149
- }
150
- while (out.length > 0 && out[out.length - 1] === "") out.pop();
151
-
152
- // Live streaming assistant buffers (cleared when the finalized message lands).
153
- if (snap.liveAssistant) {
154
- const { thinking, text } = snap.liveAssistant;
155
- const before = out.length;
156
- if (out.length > 0) out.push("");
157
- if (thinking.trim()) renderThinking(theme, thinking, width, out);
158
- if (text.trim()) {
159
- // Separate the streamed answer from the reasoning block above it.
160
- if (thinking.trim()) out.push("");
161
- out.push(...wrapTextWithAnsi(sanitizeText(text).trim(), width));
162
- }
163
- if (out.length === before + 1) out.pop();
164
- }
165
-
166
- // Live tool executions (present until the ToolEnd lands in the transcript).
167
- for (const tool of snap.liveTools) {
168
- if (out.length > 0) out.push("");
169
- const marker = tool.done
170
- ? tool.isError
171
- ? theme.fg("error", "error")
172
- : theme.fg("success", "done")
173
- : theme.fg("warning", "running");
174
- let line = `${theme.fg("toolTitle", tool.name)} · ${marker}`;
175
- const preview = tool.outputPreview && sanitizeText(tool.outputPreview);
176
- if (preview) line += theme.fg("dim", ` · ${preview}`);
177
- out.push(truncateToWidth(line, width));
178
- }
179
-
180
- // Queued steering/follow-up messages: show them immediately so Enter
181
- // visibly acknowledges the user's input instead of appearing to do nothing.
182
- for (const message of snap.queued) {
183
- if (out.length > 0) out.push("");
184
- const prefix = theme.fg("warning", `> [queued ${message.kind}] `);
185
- const wrapped = wrapTextWithAnsi(
186
- sanitizeText(message.text),
187
- Math.max(10, width - visibleWidth(prefix)),
188
- );
189
- for (let i = 0; i < wrapped.length; i++) {
190
- out.push(
191
- truncateToWidth(
192
- (i === 0 ? prefix : " ".repeat(visibleWidth(prefix))) +
193
- theme.fg("muted", wrapped[i]),
194
- width,
195
- ),
196
- );
197
- }
198
- }
199
-
200
- return out;
201
- }
1
+ /**
2
+ * Transcript rendering for the takeover view: turns a SubagentSnapshot's
3
+ * normalized transcript + live state into plain wrapped lines. Ported from
4
+ * v1, with the session-poking replaced by snapshot reads.
5
+ */
6
+
7
+ import type { Theme } from "@earendil-works/pi-coding-agent";
8
+ import {
9
+ truncateToWidth,
10
+ visibleWidth,
11
+ wrapTextWithAnsi,
12
+ } from "@earendil-works/pi-tui";
13
+ import type { SubagentSnapshot, TranscriptItem } from "../domain.ts";
14
+
15
+ const ANSI_PATTERN =
16
+ // eslint-disable-next-line no-control-regex
17
+ /[\u001B\u009B][[\]()#;?]*(?:(?:(?:[a-zA-Z\d]*(?:;[a-zA-Z\d]*)*)?\u0007)|(?:(?:\d{1,4}(?:;\d{0,4})*)?[\dA-PR-TZcf-nq-uy=><~]))/g;
18
+
19
+ /**
20
+ * Strip raw ANSI codes, expand tabs, and drop control chars. Terminal-expanded
21
+ * tabs (and stray escapes) make lines wider than the width we declare to the
22
+ * TUI, which desyncs the renderer and smears the overlay.
23
+ */
24
+ export function sanitizeText(text: string): string {
25
+ return text
26
+ .replace(ANSI_PATTERN, "")
27
+ .replaceAll("\t", " ")
28
+ .replace(/[\u0000-\u0008\u000b-\u001f\u007f]/g, "");
29
+ }
30
+
31
+ function renderUserText(
32
+ theme: Theme,
33
+ text: string,
34
+ width: number,
35
+ out: string[],
36
+ ) {
37
+ const clean = sanitizeText(text).trim();
38
+ if (!clean) return;
39
+ const wrapped = wrapTextWithAnsi(clean, Math.max(10, width - 2));
40
+ for (let i = 0; i < wrapped.length; i++) {
41
+ const prefix = i === 0 ? theme.fg("accent", "> ") : " ";
42
+ out.push(
43
+ truncateToWidth(prefix + theme.fg("userMessageText", wrapped[i]), width),
44
+ );
45
+ }
46
+ }
47
+
48
+ function renderThinking(
49
+ theme: Theme,
50
+ text: string,
51
+ width: number,
52
+ out: string[],
53
+ ) {
54
+ const reasoning = sanitizeText(text).trim();
55
+ if (!reasoning) return;
56
+ const prefix = theme.fg("dim", "~ ");
57
+ // Preserve paragraph breaks so multi-paragraph reasoning doesn't collapse
58
+ // into one wall of text; each paragraph gets its own `~` continuation.
59
+ const wrapped = wrapTextWithAnsi(reasoning, Math.max(10, width - 2));
60
+ for (let i = 0; i < wrapped.length; i++) {
61
+ const line = wrapped[i];
62
+ if (line.trim() === "" && i > 0) {
63
+ out.push("");
64
+ continue;
65
+ }
66
+ out.push(
67
+ truncateToWidth(
68
+ (i === 0 ? prefix : " ") + theme.fg("muted", theme.italic(line)),
69
+ width,
70
+ ),
71
+ );
72
+ }
73
+ }
74
+
75
+ function renderAssistantItem(
76
+ theme: Theme,
77
+ item: Extract<TranscriptItem, { kind: "assistant" }>,
78
+ width: number,
79
+ out: string[],
80
+ ) {
81
+ // A rendered reasoning block is followed by a blank line so the thinking
82
+ // doesn't run into the answer/tool call that comes next.
83
+ let pendingGap = false;
84
+ for (const part of item.parts) {
85
+ if (part.type === "text") {
86
+ const text = sanitizeText(part.text).trim();
87
+ if (!text) continue;
88
+ if (pendingGap) out.push("");
89
+ out.push(...wrapTextWithAnsi(text, width));
90
+ pendingGap = false;
91
+ } else if (part.type === "thinking") {
92
+ const before = out.length;
93
+ renderThinking(
94
+ theme,
95
+ part.redacted ? "[redacted reasoning]" : part.text,
96
+ width,
97
+ out,
98
+ );
99
+ pendingGap = out.length > before;
100
+ } else if (part.type === "toolCall") {
101
+ if (pendingGap) out.push("");
102
+ const preview = part.argsPreview ? sanitizeText(part.argsPreview) : "";
103
+ const line =
104
+ theme.fg("muted", "→ ") +
105
+ theme.fg("toolTitle", part.name) +
106
+ (preview && preview !== "{}" ? theme.fg("dim", ` ${preview}`) : "");
107
+ out.push(truncateToWidth(line, width));
108
+ pendingGap = false;
109
+ }
110
+ }
111
+ }
112
+
113
+ function renderToolResultItem(
114
+ theme: Theme,
115
+ item: Extract<TranscriptItem, { kind: "toolResult" }>,
116
+ width: number,
117
+ out: string[],
118
+ ) {
119
+ const firstLine =
120
+ sanitizeText(item.outputPreview ?? "")
121
+ .split("\n")
122
+ .find((line) => line.trim()) ?? "";
123
+ const label = item.isError
124
+ ? theme.fg("error", " error: ")
125
+ : theme.fg("dim", " output: ");
126
+ out.push(
127
+ truncateToWidth(label + theme.fg("dim", firstLine || "(no output)"), width),
128
+ );
129
+ }
130
+
131
+ /** Render a subagent's conversation as plain lines, wrapped to `width`. */
132
+ export function buildTranscriptLines(
133
+ snap: SubagentSnapshot,
134
+ width: number,
135
+ theme: Theme,
136
+ ): string[] {
137
+ const out: string[] = [];
138
+
139
+ for (const item of snap.transcript) {
140
+ const before = out.length;
141
+ if (item.kind === "user") {
142
+ renderUserText(theme, item.text, width, out);
143
+ } else if (item.kind === "assistant") {
144
+ renderAssistantItem(theme, item, width, out);
145
+ } else {
146
+ renderToolResultItem(theme, item, width, out);
147
+ }
148
+ if (out.length > before) out.push("");
149
+ }
150
+ while (out.length > 0 && out[out.length - 1] === "") out.pop();
151
+
152
+ // Live streaming assistant buffers (cleared when the finalized message lands).
153
+ if (snap.liveAssistant) {
154
+ const { thinking, text } = snap.liveAssistant;
155
+ const before = out.length;
156
+ if (out.length > 0) out.push("");
157
+ if (thinking.trim()) renderThinking(theme, thinking, width, out);
158
+ if (text.trim()) {
159
+ // Separate the streamed answer from the reasoning block above it.
160
+ if (thinking.trim()) out.push("");
161
+ out.push(...wrapTextWithAnsi(sanitizeText(text).trim(), width));
162
+ }
163
+ if (out.length === before + 1) out.pop();
164
+ }
165
+
166
+ // Live tool executions (present until the ToolEnd lands in the transcript).
167
+ for (const tool of snap.liveTools) {
168
+ if (out.length > 0) out.push("");
169
+ const marker = tool.done
170
+ ? tool.isError
171
+ ? theme.fg("error", "error")
172
+ : theme.fg("success", "done")
173
+ : theme.fg("warning", "running");
174
+ let line = `${theme.fg("toolTitle", tool.name)} · ${marker}`;
175
+ const preview = tool.outputPreview && sanitizeText(tool.outputPreview);
176
+ if (preview) line += theme.fg("dim", ` · ${preview}`);
177
+ out.push(truncateToWidth(line, width));
178
+ }
179
+
180
+ // Queued steering/follow-up messages: show them immediately so Enter
181
+ // visibly acknowledges the user's input instead of appearing to do nothing.
182
+ for (const message of snap.queued) {
183
+ if (out.length > 0) out.push("");
184
+ const prefix = theme.fg("warning", `> [queued ${message.kind}] `);
185
+ const wrapped = wrapTextWithAnsi(
186
+ sanitizeText(message.text),
187
+ Math.max(10, width - visibleWidth(prefix)),
188
+ );
189
+ for (let i = 0; i < wrapped.length; i++) {
190
+ out.push(
191
+ truncateToWidth(
192
+ (i === 0 ? prefix : " ".repeat(visibleWidth(prefix))) +
193
+ theme.fg("muted", wrapped[i]),
194
+ width,
195
+ ),
196
+ );
197
+ }
198
+ }
199
+
200
+ return out;
201
+ }
@@ -1,29 +1,29 @@
1
- import assert from "node:assert/strict";
2
- import test from "node:test";
3
- import {
4
- reconcileDashboardSelection,
5
- type DashboardSelection,
6
- } from "./src/ui/takeover.ts";
7
-
8
- test("dashboard selection follows its subagent id and falls back by row", () => {
9
- const selection: DashboardSelection = { id: "sa-7", index: 6 };
10
-
11
- reconcileDashboardSelection(selection, [
12
- { id: "sa-new" },
13
- ...Array.from({ length: 8 }, (_, index) => ({ id: `sa-${index + 1}` })),
14
- ]);
15
- assert.deepEqual(selection, { id: "sa-7", index: 7 });
16
-
17
- reconcileDashboardSelection(selection, [
18
- ...Array.from({ length: 6 }, (_, index) => ({ id: `sa-${index + 1}` })),
19
- { id: "sa-8" },
20
- { id: "sa-9" },
21
- ]);
22
- assert.deepEqual(selection, { id: "sa-9", index: 7 });
23
-
24
- reconcileDashboardSelection(selection, [{ id: "sa-1" }, { id: "sa-2" }]);
25
- assert.deepEqual(selection, { id: "sa-2", index: 1 });
26
-
27
- reconcileDashboardSelection(selection, []);
28
- assert.deepEqual(selection, { id: undefined, index: 0 });
29
- });
1
+ import assert from "node:assert/strict";
2
+ import test from "node:test";
3
+ import {
4
+ reconcileDashboardSelection,
5
+ type DashboardSelection,
6
+ } from "./src/ui/takeover.ts";
7
+
8
+ test("dashboard selection follows its subagent id and falls back by row", () => {
9
+ const selection: DashboardSelection = { id: "sa-7", index: 6 };
10
+
11
+ reconcileDashboardSelection(selection, [
12
+ { id: "sa-new" },
13
+ ...Array.from({ length: 8 }, (_, index) => ({ id: `sa-${index + 1}` })),
14
+ ]);
15
+ assert.deepEqual(selection, { id: "sa-7", index: 7 });
16
+
17
+ reconcileDashboardSelection(selection, [
18
+ ...Array.from({ length: 6 }, (_, index) => ({ id: `sa-${index + 1}` })),
19
+ { id: "sa-8" },
20
+ { id: "sa-9" },
21
+ ]);
22
+ assert.deepEqual(selection, { id: "sa-9", index: 7 });
23
+
24
+ reconcileDashboardSelection(selection, [{ id: "sa-1" }, { id: "sa-2" }]);
25
+ assert.deepEqual(selection, { id: "sa-2", index: 1 });
26
+
27
+ reconcileDashboardSelection(selection, []);
28
+ assert.deepEqual(selection, { id: undefined, index: 0 });
29
+ });
@@ -1,7 +1,7 @@
1
- {
2
- "extends": "../../tsconfig.json",
3
- "compilerOptions": {
4
- "plugins": [{ "name": "@effect/language-service" }]
5
- },
6
- "include": ["index.ts", "src/**/*.ts", "*.test.ts"]
7
- }
1
+ {
2
+ "extends": "../../tsconfig.json",
3
+ "compilerOptions": {
4
+ "plugins": [{ "name": "@effect/language-service" }]
5
+ },
6
+ "include": ["index.ts", "src/**/*.ts", "*.test.ts"]
7
+ }
@@ -1,38 +1,38 @@
1
- # Todo Extension
2
-
3
- ## Purpose
4
- Provides a persistent todo list with overlay widget, slash command, and LLM-callable tool. Todos are tracked across sessions and displayed in a dedicated UI overlay. Supports i18n via optional `@juicesharp/rpiv-i18n` SDK.
5
-
6
- ## Ownership
7
- - `index.ts` — extension entry, event handlers, overlay lifecycle
8
- - `todo.ts` — todo tool and command registration
9
- - `todo-overlay.ts` — TUI overlay widget for todo display
10
- - `state/` — state management, replay, i18n bridge
11
-
12
- ## Local Contracts
13
- - Registers tool: `todo` (tool name preserved for session history compatibility)
14
- - Registers command: `/todos`
15
- - Widget key: `rpiv-todos` (preserved for compatibility)
16
- - State replayed from branch on `session_start`, `session_compact`, `session_tree`
17
- - `replaceState(sessionId, state)` and `replayFromBranch()` from state modules — the store is keyed by `ctx.sessionManager.getSessionId()` so each session (main or in-process subagent) has an independent todo cell; `dropState(sessionId)` on `session_shutdown` prunes ended sessions
18
- - Handles stale ctx errors during auto-compaction gracefully
19
- - Batch items support `as` labels (on create) and `refs` (on subsequent items) for creating and referencing tasks in one call
20
-
21
- ## Work Guidance
22
- - Todo state is session-branch-based and replayed on session events
23
- - Overlay constructed lazily at first `session_start` with UI
24
- - `hideCompletedTasksFromPreviousTurn()` called on `agent_start`
25
- - i18n strings registered once at module init (soft optional peer dependency)
26
- - Auto-clear: when no active tasks remain (all completed, deleted, or empty), the state resets to empty automatically at `agent_end` and after replay on `session_start`/`session_compact`/`session_tree`. This prevents stale completed tasks from persisting across turns. The clear is in-memory only — session lifecycle handlers re-apply it after branch replay so the empty state survives compaction and session transitions.
27
- - Tool execution triggers overlay update via `tool_execution_end` event
28
- - Overlay indentation: task prefix is `" └ "` (first line, └ at col 3) and `" "` (continuation, text at col 5), and the overflow summary line also starts with `" └"`. This aligns the `└` tree glyph one column after the first letter of the spinner phrase (the spinner occupies 2 columns, e.g. `"✻ "`), so the todo overlay sits under the phrase rather than under the spinner animation character
29
-
30
- ## Verification
31
- - Add todo: use `/todos` command or `todo` tool
32
- - Verify overlay: check widget displays in TUI
33
- - Test session persistence: `/new` then verify todos still shown
34
- - Test compaction: trigger compact, verify todos replay correctly
35
- - Trigger the agent spinner with at least one todo visible; confirm the `└` glyph in each todo line (and the `+N more` summary line) sits ONE COLUMN AFTER the first letter of the spinner phrase — not under the spinner animation character itself
36
-
37
- ## Child DOX Index
38
- None
1
+ # Todo Extension
2
+
3
+ ## Purpose
4
+ Provides a persistent todo list with overlay widget, slash command, and LLM-callable tool. Todos are tracked across sessions and displayed in a dedicated UI overlay. Supports i18n via optional `@juicesharp/rpiv-i18n` SDK.
5
+
6
+ ## Ownership
7
+ - `index.ts` — extension entry, event handlers, overlay lifecycle
8
+ - `todo.ts` — todo tool and command registration
9
+ - `todo-overlay.ts` — TUI overlay widget for todo display
10
+ - `state/` — state management, replay, i18n bridge
11
+
12
+ ## Local Contracts
13
+ - Registers tool: `todo` (tool name preserved for session history compatibility)
14
+ - Registers command: `/todos`
15
+ - Widget key: `rpiv-todos` (preserved for compatibility)
16
+ - State replayed from branch on `session_start`, `session_compact`, `session_tree`
17
+ - `replaceState(sessionId, state)` and `replayFromBranch()` from state modules — the store is keyed by `ctx.sessionManager.getSessionId()` so each session (main or in-process subagent) has an independent todo cell; `dropState(sessionId)` on `session_shutdown` prunes ended sessions
18
+ - Handles stale ctx errors during auto-compaction gracefully
19
+ - Batch items support `as` labels (on create) and `refs` (on subsequent items) for creating and referencing tasks in one call
20
+
21
+ ## Work Guidance
22
+ - Todo state is session-branch-based and replayed on session events
23
+ - Overlay constructed lazily at first `session_start` with UI
24
+ - `hideCompletedTasksFromPreviousTurn()` called on `agent_start`
25
+ - i18n strings registered once at module init (soft optional peer dependency)
26
+ - Auto-clear: when no active tasks remain (all completed, deleted, or empty), the state resets to empty automatically at `agent_end` and after replay on `session_start`/`session_compact`/`session_tree`. This prevents stale completed tasks from persisting across turns. The clear is in-memory only — session lifecycle handlers re-apply it after branch replay so the empty state survives compaction and session transitions.
27
+ - Tool execution triggers overlay update via `tool_execution_end` event
28
+ - Overlay indentation: task prefix is `" └ "` (first line, └ at col 3) and `" "` (continuation, text at col 5), and the overflow summary line also starts with `" └"`. This aligns the `└` tree glyph one column after the first letter of the spinner phrase (the spinner occupies 2 columns, e.g. `"✻ "`), so the todo overlay sits under the phrase rather than under the spinner animation character
29
+
30
+ ## Verification
31
+ - Add todo: use `/todos` command or `todo` tool
32
+ - Verify overlay: check widget displays in TUI
33
+ - Test session persistence: `/new` then verify todos still shown
34
+ - Test compaction: trigger compact, verify todos replay correctly
35
+ - Trigger the agent spinner with at least one todo visible; confirm the `└` glyph in each todo line (and the `+N more` summary line) sits ONE COLUMN AFTER the first letter of the spinner phrase — not under the spinner animation character itself
36
+
37
+ ## Child DOX Index
38
+ None
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) 2026 juicesharp
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
1
+ MIT License
2
+
3
+ Copyright (c) 2026 juicesharp
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.