pi-crew 0.1.51 → 0.2.1

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 (240) hide show
  1. package/CHANGELOG.md +56 -1
  2. package/README.md +176 -781
  3. package/agents/analyst.md +11 -11
  4. package/agents/critic.md +11 -11
  5. package/agents/executor.md +11 -11
  6. package/agents/explorer.md +11 -11
  7. package/agents/planner.md +11 -11
  8. package/agents/reviewer.md +11 -11
  9. package/agents/security-reviewer.md +11 -11
  10. package/agents/test-engineer.md +11 -11
  11. package/agents/verifier.md +70 -11
  12. package/agents/writer.md +11 -11
  13. package/docs/actions-reference.md +595 -0
  14. package/docs/commands-reference.md +347 -0
  15. package/docs/runtime-flow.md +148 -148
  16. package/index.ts +6 -6
  17. package/package.json +99 -99
  18. package/skills/async-worker-recovery/SKILL.md +42 -42
  19. package/skills/context-artifact-hygiene/SKILL.md +52 -52
  20. package/skills/delegation-patterns/SKILL.md +54 -54
  21. package/skills/mailbox-interactive/SKILL.md +40 -40
  22. package/skills/model-routing-context/SKILL.md +39 -39
  23. package/skills/multi-perspective-review/SKILL.md +58 -58
  24. package/skills/observability-reliability/SKILL.md +41 -41
  25. package/skills/orchestration/SKILL.md +157 -157
  26. package/skills/ownership-session-security/SKILL.md +41 -41
  27. package/skills/pi-extension-lifecycle/SKILL.md +39 -39
  28. package/skills/requirements-to-task-packet/SKILL.md +63 -63
  29. package/skills/resource-discovery-config/SKILL.md +41 -41
  30. package/skills/runtime-state-reader/SKILL.md +44 -44
  31. package/skills/secure-agent-orchestration-review/SKILL.md +45 -45
  32. package/skills/state-mutation-locking/SKILL.md +42 -42
  33. package/skills/systematic-debugging/SKILL.md +67 -67
  34. package/skills/ui-render-performance/SKILL.md +39 -39
  35. package/skills/verification-before-done/SKILL.md +57 -57
  36. package/skills/worktree-isolation/SKILL.md +39 -39
  37. package/src/adapters/claude-adapter.ts +25 -0
  38. package/src/adapters/codex-adapter.ts +21 -0
  39. package/src/adapters/cursor-adapter.ts +17 -0
  40. package/src/adapters/export-util.ts +137 -0
  41. package/src/adapters/index.ts +15 -0
  42. package/src/adapters/registry.ts +18 -0
  43. package/src/adapters/types.ts +23 -0
  44. package/src/agents/agent-config.ts +2 -0
  45. package/src/agents/agent-search.ts +98 -98
  46. package/src/agents/discover-agents.ts +2 -1
  47. package/src/config/config.ts +13 -1
  48. package/src/config/drift-detector.ts +211 -0
  49. package/src/config/markers.ts +327 -0
  50. package/src/config/resilient-parser.ts +108 -0
  51. package/src/config/suggestions.ts +74 -0
  52. package/src/extension/cross-extension-rpc.ts +103 -94
  53. package/src/extension/project-init.ts +21 -1
  54. package/src/extension/register.ts +45 -14
  55. package/src/extension/registration/commands.ts +77 -8
  56. package/src/extension/registration/subagent-tools.ts +10 -1
  57. package/src/extension/registration/team-tool.ts +10 -1
  58. package/src/extension/registration/viewers.ts +48 -34
  59. package/src/extension/run-bundle-schema.ts +89 -89
  60. package/src/extension/run-import.ts +25 -1
  61. package/src/extension/run-index.ts +5 -1
  62. package/src/extension/run-maintenance.ts +142 -68
  63. package/src/extension/team-manager-command.ts +10 -1
  64. package/src/extension/team-tool/api.ts +441 -441
  65. package/src/extension/team-tool/doctor.ts +28 -3
  66. package/src/extension/team-tool/handle-settings.ts +195 -188
  67. package/src/extension/team-tool/inspect.ts +41 -41
  68. package/src/extension/team-tool/intent-policy.ts +42 -42
  69. package/src/extension/team-tool/lifecycle-actions.ts +27 -8
  70. package/src/extension/team-tool/plan.ts +19 -19
  71. package/src/extension/team-tool/run.ts +12 -1
  72. package/src/extension/team-tool.ts +332 -322
  73. package/src/i18n.ts +184 -184
  74. package/src/observability/exporters/otlp-exporter.ts +92 -77
  75. package/src/prompt/prompt-runtime.ts +72 -72
  76. package/src/runtime/agent-memory.ts +72 -72
  77. package/src/runtime/agent-observability.ts +114 -114
  78. package/src/runtime/async-marker.ts +26 -26
  79. package/src/runtime/attention-events.ts +28 -28
  80. package/src/runtime/auto-resume.ts +100 -0
  81. package/src/runtime/background-runner.ts +11 -1
  82. package/src/runtime/cancellation-token.ts +89 -89
  83. package/src/runtime/cancellation.ts +61 -61
  84. package/src/runtime/capability-inventory.ts +116 -116
  85. package/src/runtime/child-pi.ts +7 -2
  86. package/src/runtime/compaction-summary.ts +271 -0
  87. package/src/runtime/completion-guard.ts +190 -190
  88. package/src/runtime/crash-recovery.ts +33 -1
  89. package/src/runtime/delta-conflict.ts +360 -0
  90. package/src/runtime/direct-run.ts +35 -35
  91. package/src/runtime/foreground-control.ts +82 -82
  92. package/src/runtime/green-contract.ts +46 -46
  93. package/src/runtime/group-join.ts +106 -106
  94. package/src/runtime/heartbeat-gradient.ts +28 -28
  95. package/src/runtime/heartbeat-watcher.ts +124 -124
  96. package/src/runtime/iteration-hooks.ts +264 -0
  97. package/src/runtime/live-agent-control.ts +88 -88
  98. package/src/runtime/live-control-realtime.ts +36 -36
  99. package/src/runtime/live-extension-bridge.ts +150 -150
  100. package/src/runtime/live-irc.ts +92 -92
  101. package/src/runtime/live-session-health.ts +100 -100
  102. package/src/runtime/loop-gates.ts +129 -0
  103. package/src/runtime/metric-parser.ts +40 -0
  104. package/src/runtime/notebook-helpers.ts +90 -90
  105. package/src/runtime/orphan-sentinel.ts +7 -7
  106. package/src/runtime/parallel-research.ts +44 -44
  107. package/src/runtime/phase-progress.ts +217 -0
  108. package/src/runtime/pi-args.ts +38 -11
  109. package/src/runtime/pi-json-output.ts +111 -111
  110. package/src/runtime/pi-spawn.ts +57 -7
  111. package/src/runtime/policy-engine.ts +79 -79
  112. package/src/runtime/post-checks.ts +122 -0
  113. package/src/runtime/progress-event-coalescer.ts +43 -43
  114. package/src/runtime/prose-compressor.ts +164 -164
  115. package/src/runtime/recovery-recipes.ts +74 -74
  116. package/src/runtime/result-extractor.ts +121 -121
  117. package/src/runtime/role-permission.ts +39 -39
  118. package/src/runtime/sensitive-paths.ts +2 -2
  119. package/src/runtime/session-resources.ts +25 -25
  120. package/src/runtime/session-snapshot.ts +59 -59
  121. package/src/runtime/session-usage.ts +79 -79
  122. package/src/runtime/sidechain-output.ts +29 -29
  123. package/src/runtime/stream-preview.ts +177 -177
  124. package/src/runtime/supervisor-contact.ts +59 -59
  125. package/src/runtime/task-display.ts +38 -38
  126. package/src/runtime/task-graph.ts +207 -0
  127. package/src/runtime/task-quality.ts +207 -0
  128. package/src/runtime/task-runner/capabilities.ts +78 -78
  129. package/src/runtime/task-runner/live-executor.ts +7 -1
  130. package/src/runtime/task-runner/progress.ts +119 -119
  131. package/src/runtime/task-runner/prompt-pipeline.ts +64 -64
  132. package/src/runtime/task-runner/result-utils.ts +14 -14
  133. package/src/runtime/task-runner/run-projection.ts +103 -103
  134. package/src/runtime/task-runner/state-helpers.ts +22 -22
  135. package/src/runtime/team-runner.ts +117 -7
  136. package/src/runtime/worker-heartbeat.ts +21 -21
  137. package/src/runtime/worker-startup.ts +57 -57
  138. package/src/runtime/workflow-state.ts +187 -0
  139. package/src/runtime/workspace-tree.ts +298 -298
  140. package/src/schema/config-schema.ts +11 -0
  141. package/src/schema/validation-types.ts +148 -0
  142. package/src/skills/skill-templates.ts +374 -0
  143. package/src/state/active-run-registry.ts +35 -11
  144. package/src/state/atomic-write.ts +33 -26
  145. package/src/state/contracts.ts +1 -0
  146. package/src/state/event-reconstructor.ts +217 -0
  147. package/src/state/locks.ts +2 -13
  148. package/src/state/mailbox.ts +4 -3
  149. package/src/state/state-store.ts +16 -6
  150. package/src/state/task-claims.ts +44 -44
  151. package/src/state/types.ts +9 -0
  152. package/src/state/usage.ts +29 -29
  153. package/src/subagents/async-entry.ts +1 -1
  154. package/src/subagents/index.ts +3 -3
  155. package/src/subagents/live/control.ts +1 -1
  156. package/src/subagents/live/manager.ts +1 -1
  157. package/src/subagents/live/realtime.ts +1 -1
  158. package/src/subagents/live/session-runtime.ts +1 -1
  159. package/src/subagents/manager.ts +1 -1
  160. package/src/subagents/spawn.ts +1 -1
  161. package/src/teams/team-serializer.ts +38 -38
  162. package/src/types/diff.d.ts +18 -18
  163. package/src/ui/crew-footer.ts +101 -101
  164. package/src/ui/crew-select-list.ts +111 -111
  165. package/src/ui/crew-widget.ts +5 -2
  166. package/src/ui/dashboard-panes/cancellation-pane.ts +42 -42
  167. package/src/ui/dashboard-panes/capability-pane.ts +59 -59
  168. package/src/ui/dashboard-panes/mailbox-pane.ts +35 -35
  169. package/src/ui/dashboard-panes/metrics-pane.ts +34 -34
  170. package/src/ui/dashboard-panes/progress-pane.ts +11 -0
  171. package/src/ui/dynamic-border.ts +25 -25
  172. package/src/ui/layout-primitives.ts +106 -106
  173. package/src/ui/loaders.ts +158 -158
  174. package/src/ui/render-coalescer.ts +51 -51
  175. package/src/ui/render-diff.ts +119 -119
  176. package/src/ui/render-scheduler.ts +143 -143
  177. package/src/ui/run-action-dispatcher.ts +10 -1
  178. package/src/ui/spinner.ts +17 -17
  179. package/src/ui/status-colors.ts +58 -58
  180. package/src/ui/syntax-highlight.ts +116 -116
  181. package/src/ui/transcript-entries.ts +258 -258
  182. package/src/utils/completion-dedupe.ts +63 -63
  183. package/src/utils/frontmatter.ts +68 -68
  184. package/src/utils/git.ts +262 -262
  185. package/src/utils/ids.ts +17 -17
  186. package/src/utils/incremental-reader.ts +104 -104
  187. package/src/utils/names.ts +27 -27
  188. package/src/utils/redaction.ts +44 -44
  189. package/src/utils/safe-paths.ts +47 -47
  190. package/src/utils/scan-cache.ts +136 -136
  191. package/src/utils/sleep.ts +40 -26
  192. package/src/utils/task-name-generator.ts +337 -337
  193. package/src/workflows/validate-workflow.ts +40 -40
  194. package/src/worktree/branch-freshness.ts +45 -45
  195. package/teams/default.team.md +12 -12
  196. package/teams/fast-fix.team.md +11 -11
  197. package/teams/implementation.team.md +18 -18
  198. package/teams/parallel-research.team.md +14 -14
  199. package/teams/research.team.md +11 -11
  200. package/teams/review.team.md +12 -12
  201. package/workflows/default.workflow.md +30 -29
  202. package/workflows/fast-fix.workflow.md +23 -22
  203. package/workflows/implementation.workflow.md +43 -43
  204. package/workflows/parallel-research.workflow.md +46 -46
  205. package/workflows/research.workflow.md +22 -22
  206. package/workflows/review.workflow.md +30 -30
  207. package/docs/refactor-tasks-phase3.md +0 -394
  208. package/docs/refactor-tasks-phase4.md +0 -564
  209. package/docs/refactor-tasks-phase5.md +0 -402
  210. package/docs/refactor-tasks-phase6.md +0 -662
  211. package/docs/refactor-tasks.md +0 -1484
  212. package/docs/research/AGENT-EXECUTION-ARCHITECTURE.md +0 -261
  213. package/docs/research/AGENT-LIFECYCLE-COMPARISON.md +0 -111
  214. package/docs/research/AUDIT_OH_MY_PI.md +0 -261
  215. package/docs/research/AUDIT_PI_CREW.md +0 -457
  216. package/docs/research/CAVEMAN-DEEP-RESEARCH.md +0 -281
  217. package/docs/research/COMPARISON_OH_MY_PI_VS_PI_CREW.md +0 -264
  218. package/docs/research/DEEP-RESEARCH-PI-POWERBAR.md +0 -343
  219. package/docs/research/DEEP_RESEARCH_SUBAGENT_ARCHITECTURE.md +0 -480
  220. package/docs/research/GAP_CLOSURE_IMPLEMENTATION_PLAN.md +0 -354
  221. package/docs/research/IMPLEMENTATION_PLAN.md +0 -385
  222. package/docs/research/LIVE-SESSION-PRODUCTION-READY-PLAN.md +0 -502
  223. package/docs/research/OH-MY-PI-DEEP-RESEARCH-v14.7.6.md +0 -266
  224. package/docs/research/REMAINING-GAPS-PLAN.md +0 -363
  225. package/docs/research/SESSION-SUMMARY-2026-05-08.md +0 -146
  226. package/docs/research/UI-RESPONSIVENESS-AUDIT.md +0 -173
  227. package/docs/research-awesome-agent-skills-distillation.md +0 -100
  228. package/docs/research-extension-examples.md +0 -297
  229. package/docs/research-extension-system.md +0 -324
  230. package/docs/research-oh-my-pi-distillation.md +0 -369
  231. package/docs/research-optimization-plan.md +0 -548
  232. package/docs/research-phase10-distillation.md +0 -199
  233. package/docs/research-phase11-distillation.md +0 -201
  234. package/docs/research-phase8-operator-experience-plan.md +0 -819
  235. package/docs/research-phase9-observability-reliability-plan.md +0 -1190
  236. package/docs/research-pi-coding-agent.md +0 -357
  237. package/docs/research-source-pi-crew-reference.md +0 -174
  238. package/docs/research-ui-optimization-plan.md +0 -480
  239. package/docs/source-runtime-refactor-map.md +0 -107
  240. package/src/utils/atomic-write.ts +0 -33
@@ -1,258 +1,258 @@
1
- import { truncate } from "../utils/visual.ts";
2
-
3
- export interface TranscriptEntry {
4
- id: number;
5
- type: "message" | "tool_call" | "tool_result" | "system";
6
- role?: string;
7
- toolName?: string;
8
- summary: string;
9
- content: string;
10
- expanded: boolean;
11
- timestamp?: number;
12
- }
13
-
14
- /** Extract plain text from Pi-style content (string or array of content parts). */
15
- function textFromContent(content: unknown): string {
16
- if (typeof content === "string") return content;
17
- if (!Array.isArray(content)) return "";
18
- return content
19
- .map((part: unknown) => {
20
- if (!part || typeof part !== "object" || Array.isArray(part)) return "";
21
- const obj = part as Record<string, unknown>;
22
- if (typeof obj.text === "string") return obj.text;
23
- if (typeof obj.content === "string") return obj.content;
24
- if (typeof obj.name === "string") return `[tool:${obj.name}]`;
25
- return "";
26
- })
27
- .filter(Boolean)
28
- .join("\n");
29
- }
30
-
31
- /** Safely cast unknown to a record for property access. */
32
- function asRecord(value: unknown): Record<string, unknown> | undefined {
33
- return value && typeof value === "object" && !Array.isArray(value)
34
- ? (value as Record<string, unknown>)
35
- : undefined;
36
- }
37
-
38
- /** Detect if an event type is a tool invocation (call/use/start). */
39
- function isToolCallType(type: string): boolean {
40
- return type === "tool_call" || type === "tool_use" || type === "toolCall" || type === "tool_execution_start";
41
- }
42
-
43
- /** Detect if an event type is a tool response (result/end). */
44
- function isToolResultType(type: string): boolean {
45
- return type === "tool_result" || type === "toolCallEnd" || type === "tool_result_end";
46
- }
47
-
48
- /** Extract tool name from various event shapes. */
49
- function extractToolName(obj: Record<string, unknown>): string | undefined {
50
- const name =
51
- typeof obj.toolName === "string" ? obj.toolName :
52
- typeof obj.name === "string" ? obj.name :
53
- typeof obj.tool === "string" ? obj.tool :
54
- undefined;
55
- return name;
56
- }
57
-
58
- /** Create a single-line summary from text, truncating if needed. */
59
- function summarize(text: string, maxLength: number): string {
60
- const oneLine = text.replace(/\r?\n/g, " ").trim();
61
- if (oneLine.length <= maxLength) return oneLine;
62
- return oneLine.slice(0, maxLength - 1) + "…";
63
- }
64
-
65
- const SUMMARY_MAX = 120;
66
-
67
- /** Parse raw JSONL lines into TranscriptEntry[].
68
- *
69
- * Grouping rules:
70
- * - tool_call events are grouped with their subsequent tool_result into one entry.
71
- * - message events (message_end, etc.) become their own entry.
72
- * - Everything else becomes a system entry.
73
- */
74
- export function parseTranscriptEntries(lines: string[]): TranscriptEntry[] {
75
- const entries: TranscriptEntry[] = [];
76
- let id = 0;
77
-
78
- // Pre-parse valid JSON lines
79
- const parsed: Array<{ raw: string; obj: Record<string, unknown> }> = [];
80
- for (const line of lines) {
81
- const trimmed = line.trim();
82
- if (!trimmed) continue;
83
- try {
84
- const json: unknown = JSON.parse(trimmed);
85
- const obj = asRecord(json);
86
- if (obj) parsed.push({ raw: trimmed, obj });
87
- } catch {
88
- // Non-JSON line → treat as a system entry
89
- entries.push({
90
- id: id++,
91
- type: "system",
92
- summary: summarize(trimmed, SUMMARY_MAX),
93
- content: trimmed,
94
- expanded: false,
95
- });
96
- }
97
- }
98
-
99
- let i = 0;
100
- while (i < parsed.length) {
101
- const { obj } = parsed[i]!;
102
- const type = typeof obj.type === "string" ? obj.type : "";
103
- const timestamp = typeof obj.timestamp === "number" ? obj.timestamp : undefined;
104
-
105
- if (isToolCallType(type)) {
106
- // Look ahead for matching tool_result
107
- const toolName = extractToolName(obj) ?? "unknown";
108
- const inputText =
109
- typeof obj.input === "string" ? obj.input :
110
- obj.input !== undefined ? JSON.stringify(obj.input) : "";
111
- let resultText = "";
112
- let isError = false;
113
- let resultTimestamp = timestamp;
114
-
115
- // Consume consecutive tool_result lines
116
- let j = i + 1;
117
- while (j < parsed.length) {
118
- const nextTypeVal = parsed[j]!.obj.type;
119
- const nextType = typeof nextTypeVal === "string" ? nextTypeVal : "";
120
- if (isToolResultType(nextType) || /tool/i.test(nextType)) {
121
- const robj = parsed[j]!.obj;
122
- const rt =
123
- typeof robj.text === "string" ? robj.text :
124
- typeof robj.result === "string" ? robj.result :
125
- robj.result !== undefined ? JSON.stringify(robj.result) : "";
126
- resultText = rt;
127
- isError = robj.isError === true;
128
- resultTimestamp = typeof robj.timestamp === "number" ? robj.timestamp : resultTimestamp;
129
- j++;
130
- break;
131
- }
132
- if (isToolCallType(nextType)) break; // next tool call, stop looking
133
- j++;
134
- }
135
-
136
- const callSummary = summarize(`🔧 ${toolName}${inputText ? ": " + summarize(inputText, 60) : ""}`, SUMMARY_MAX);
137
- const callContent = [
138
- `[Tool Call: ${toolName}]`,
139
- inputText || "(no input)",
140
- `[Result${isError ? " ✗" : " ✓"}]`,
141
- resultText || "(no output)",
142
- ].join("\n");
143
-
144
- entries.push({
145
- id: id++,
146
- type: "tool_call",
147
- toolName,
148
- summary: callSummary,
149
- content: callContent,
150
- expanded: false,
151
- timestamp: resultTimestamp ?? timestamp,
152
- });
153
- i = j;
154
- continue;
155
- }
156
-
157
- if (isToolResultType(type) || /tool/i.test(type)) {
158
- // Standalone tool result (no preceding tool_call consumed it)
159
- const toolName = extractToolName(obj) ?? "unknown";
160
- const isError = obj.isError === true;
161
- const text =
162
- typeof obj.text === "string" ? obj.text :
163
- typeof obj.result === "string" ? obj.result :
164
- obj.result !== undefined ? JSON.stringify(obj.result) : "";
165
-
166
- const summary = summarize(`${isError ? "✗" : "✓"} ${toolName}${text ? ": " + summarize(text, 60) : ""}`, SUMMARY_MAX);
167
- const content = [
168
- `[Tool Result: ${toolName}${isError ? " (error)" : ""}]`,
169
- text || "(no output)",
170
- ].join("\n");
171
-
172
- entries.push({
173
- id: id++,
174
- type: "tool_result",
175
- toolName,
176
- summary,
177
- content,
178
- expanded: false,
179
- timestamp,
180
- });
181
- i++;
182
- continue;
183
- }
184
-
185
- // Message events (message_end, message_start, etc.)
186
- const message = asRecord(obj.message);
187
- if (message || type.startsWith("message")) {
188
- const msg = message ?? obj;
189
- const role = typeof msg.role === "string" ? msg.role : "unknown";
190
- const text = textFromContent(msg.content);
191
-
192
- const label = role === "assistant" ? "🤖" : role === "user" ? "👤" : "💬";
193
- const summary = summarize(`${label} ${role}${text ? ": " + summarize(text, 80) : ""}`, SUMMARY_MAX);
194
- const content = `[${role.charAt(0).toUpperCase()}${role.slice(1)}]:\n${text || "(empty)"}`;
195
-
196
- entries.push({
197
- id: id++,
198
- type: "message",
199
- role,
200
- summary,
201
- content,
202
- expanded: false,
203
- timestamp,
204
- });
205
- i++;
206
- continue;
207
- }
208
-
209
- // Everything else → system entry
210
- const text = textFromContent(obj.content) || (typeof obj.text === "string" ? obj.text : "");
211
- const displayText = text || type || JSON.stringify(obj);
212
- entries.push({
213
- id: id++,
214
- type: "system",
215
- summary: summarize(`⚙ ${type ? `[${type}]` : ""} ${summarize(displayText, 80)}`, SUMMARY_MAX),
216
- content: displayText,
217
- expanded: false,
218
- timestamp,
219
- });
220
- i++;
221
- }
222
-
223
- return entries;
224
- }
225
-
226
- /** Toggle expand/collapse for an entry by index. Returns a new array. */
227
- export function toggleEntry(entries: TranscriptEntry[], index: number): TranscriptEntry[] {
228
- return entries.map((entry, i) =>
229
- i === index ? { ...entry, expanded: !entry.expanded } : entry,
230
- );
231
- }
232
-
233
- /** Render entries into display lines, respecting expand/collapse.
234
- * Collapsed entries produce 1 line (summary). Expanded entries produce multi-line content.
235
- * Every line is truncated to maxWidth.
236
- */
237
- export function renderEntries(entries: TranscriptEntry[], maxWidth: number): string[] {
238
- const effectiveWidth = Math.max(1, maxWidth);
239
- const lines: string[] = [];
240
-
241
- for (const entry of entries) {
242
- if (entry.expanded) {
243
- const contentLines = entry.content.split(/\r?\n/);
244
- if (contentLines.length === 0 || (contentLines.length === 1 && contentLines[0] === "")) {
245
- lines.push(truncate(`▸ ${entry.summary}`, effectiveWidth));
246
- } else {
247
- lines.push(truncate(`▾ ${entry.summary}`, effectiveWidth));
248
- for (const line of contentLines) {
249
- lines.push(truncate(` ${line}`, effectiveWidth));
250
- }
251
- }
252
- } else {
253
- lines.push(truncate(`▸ ${entry.summary}`, effectiveWidth));
254
- }
255
- }
256
-
257
- return lines;
258
- }
1
+ import { truncate } from "../utils/visual.ts";
2
+
3
+ export interface TranscriptEntry {
4
+ id: number;
5
+ type: "message" | "tool_call" | "tool_result" | "system";
6
+ role?: string;
7
+ toolName?: string;
8
+ summary: string;
9
+ content: string;
10
+ expanded: boolean;
11
+ timestamp?: number;
12
+ }
13
+
14
+ /** Extract plain text from Pi-style content (string or array of content parts). */
15
+ function textFromContent(content: unknown): string {
16
+ if (typeof content === "string") return content;
17
+ if (!Array.isArray(content)) return "";
18
+ return content
19
+ .map((part: unknown) => {
20
+ if (!part || typeof part !== "object" || Array.isArray(part)) return "";
21
+ const obj = part as Record<string, unknown>;
22
+ if (typeof obj.text === "string") return obj.text;
23
+ if (typeof obj.content === "string") return obj.content;
24
+ if (typeof obj.name === "string") return `[tool:${obj.name}]`;
25
+ return "";
26
+ })
27
+ .filter(Boolean)
28
+ .join("\n");
29
+ }
30
+
31
+ /** Safely cast unknown to a record for property access. */
32
+ function asRecord(value: unknown): Record<string, unknown> | undefined {
33
+ return value && typeof value === "object" && !Array.isArray(value)
34
+ ? (value as Record<string, unknown>)
35
+ : undefined;
36
+ }
37
+
38
+ /** Detect if an event type is a tool invocation (call/use/start). */
39
+ function isToolCallType(type: string): boolean {
40
+ return type === "tool_call" || type === "tool_use" || type === "toolCall" || type === "tool_execution_start";
41
+ }
42
+
43
+ /** Detect if an event type is a tool response (result/end). */
44
+ function isToolResultType(type: string): boolean {
45
+ return type === "tool_result" || type === "toolCallEnd" || type === "tool_result_end";
46
+ }
47
+
48
+ /** Extract tool name from various event shapes. */
49
+ function extractToolName(obj: Record<string, unknown>): string | undefined {
50
+ const name =
51
+ typeof obj.toolName === "string" ? obj.toolName :
52
+ typeof obj.name === "string" ? obj.name :
53
+ typeof obj.tool === "string" ? obj.tool :
54
+ undefined;
55
+ return name;
56
+ }
57
+
58
+ /** Create a single-line summary from text, truncating if needed. */
59
+ function summarize(text: string, maxLength: number): string {
60
+ const oneLine = text.replace(/\r?\n/g, " ").trim();
61
+ if (oneLine.length <= maxLength) return oneLine;
62
+ return oneLine.slice(0, maxLength - 1) + "…";
63
+ }
64
+
65
+ const SUMMARY_MAX = 120;
66
+
67
+ /** Parse raw JSONL lines into TranscriptEntry[].
68
+ *
69
+ * Grouping rules:
70
+ * - tool_call events are grouped with their subsequent tool_result into one entry.
71
+ * - message events (message_end, etc.) become their own entry.
72
+ * - Everything else becomes a system entry.
73
+ */
74
+ export function parseTranscriptEntries(lines: string[]): TranscriptEntry[] {
75
+ const entries: TranscriptEntry[] = [];
76
+ let id = 0;
77
+
78
+ // Pre-parse valid JSON lines
79
+ const parsed: Array<{ raw: string; obj: Record<string, unknown> }> = [];
80
+ for (const line of lines) {
81
+ const trimmed = line.trim();
82
+ if (!trimmed) continue;
83
+ try {
84
+ const json: unknown = JSON.parse(trimmed);
85
+ const obj = asRecord(json);
86
+ if (obj) parsed.push({ raw: trimmed, obj });
87
+ } catch {
88
+ // Non-JSON line → treat as a system entry
89
+ entries.push({
90
+ id: id++,
91
+ type: "system",
92
+ summary: summarize(trimmed, SUMMARY_MAX),
93
+ content: trimmed,
94
+ expanded: false,
95
+ });
96
+ }
97
+ }
98
+
99
+ let i = 0;
100
+ while (i < parsed.length) {
101
+ const { obj } = parsed[i]!;
102
+ const type = typeof obj.type === "string" ? obj.type : "";
103
+ const timestamp = typeof obj.timestamp === "number" ? obj.timestamp : undefined;
104
+
105
+ if (isToolCallType(type)) {
106
+ // Look ahead for matching tool_result
107
+ const toolName = extractToolName(obj) ?? "unknown";
108
+ const inputText =
109
+ typeof obj.input === "string" ? obj.input :
110
+ obj.input !== undefined ? JSON.stringify(obj.input) : "";
111
+ let resultText = "";
112
+ let isError = false;
113
+ let resultTimestamp = timestamp;
114
+
115
+ // Consume consecutive tool_result lines
116
+ let j = i + 1;
117
+ while (j < parsed.length) {
118
+ const nextTypeVal = parsed[j]!.obj.type;
119
+ const nextType = typeof nextTypeVal === "string" ? nextTypeVal : "";
120
+ if (isToolResultType(nextType) || /tool/i.test(nextType)) {
121
+ const robj = parsed[j]!.obj;
122
+ const rt =
123
+ typeof robj.text === "string" ? robj.text :
124
+ typeof robj.result === "string" ? robj.result :
125
+ robj.result !== undefined ? JSON.stringify(robj.result) : "";
126
+ resultText = rt;
127
+ isError = robj.isError === true;
128
+ resultTimestamp = typeof robj.timestamp === "number" ? robj.timestamp : resultTimestamp;
129
+ j++;
130
+ break;
131
+ }
132
+ if (isToolCallType(nextType)) break; // next tool call, stop looking
133
+ j++;
134
+ }
135
+
136
+ const callSummary = summarize(`🔧 ${toolName}${inputText ? ": " + summarize(inputText, 60) : ""}`, SUMMARY_MAX);
137
+ const callContent = [
138
+ `[Tool Call: ${toolName}]`,
139
+ inputText || "(no input)",
140
+ `[Result${isError ? " ✗" : " ✓"}]`,
141
+ resultText || "(no output)",
142
+ ].join("\n");
143
+
144
+ entries.push({
145
+ id: id++,
146
+ type: "tool_call",
147
+ toolName,
148
+ summary: callSummary,
149
+ content: callContent,
150
+ expanded: false,
151
+ timestamp: resultTimestamp ?? timestamp,
152
+ });
153
+ i = j;
154
+ continue;
155
+ }
156
+
157
+ if (isToolResultType(type) || /tool/i.test(type)) {
158
+ // Standalone tool result (no preceding tool_call consumed it)
159
+ const toolName = extractToolName(obj) ?? "unknown";
160
+ const isError = obj.isError === true;
161
+ const text =
162
+ typeof obj.text === "string" ? obj.text :
163
+ typeof obj.result === "string" ? obj.result :
164
+ obj.result !== undefined ? JSON.stringify(obj.result) : "";
165
+
166
+ const summary = summarize(`${isError ? "✗" : "✓"} ${toolName}${text ? ": " + summarize(text, 60) : ""}`, SUMMARY_MAX);
167
+ const content = [
168
+ `[Tool Result: ${toolName}${isError ? " (error)" : ""}]`,
169
+ text || "(no output)",
170
+ ].join("\n");
171
+
172
+ entries.push({
173
+ id: id++,
174
+ type: "tool_result",
175
+ toolName,
176
+ summary,
177
+ content,
178
+ expanded: false,
179
+ timestamp,
180
+ });
181
+ i++;
182
+ continue;
183
+ }
184
+
185
+ // Message events (message_end, message_start, etc.)
186
+ const message = asRecord(obj.message);
187
+ if (message || type.startsWith("message")) {
188
+ const msg = message ?? obj;
189
+ const role = typeof msg.role === "string" ? msg.role : "unknown";
190
+ const text = textFromContent(msg.content);
191
+
192
+ const label = role === "assistant" ? "🤖" : role === "user" ? "👤" : "💬";
193
+ const summary = summarize(`${label} ${role}${text ? ": " + summarize(text, 80) : ""}`, SUMMARY_MAX);
194
+ const content = `[${role.charAt(0).toUpperCase()}${role.slice(1)}]:\n${text || "(empty)"}`;
195
+
196
+ entries.push({
197
+ id: id++,
198
+ type: "message",
199
+ role,
200
+ summary,
201
+ content,
202
+ expanded: false,
203
+ timestamp,
204
+ });
205
+ i++;
206
+ continue;
207
+ }
208
+
209
+ // Everything else → system entry
210
+ const text = textFromContent(obj.content) || (typeof obj.text === "string" ? obj.text : "");
211
+ const displayText = text || type || JSON.stringify(obj);
212
+ entries.push({
213
+ id: id++,
214
+ type: "system",
215
+ summary: summarize(`⚙ ${type ? `[${type}]` : ""} ${summarize(displayText, 80)}`, SUMMARY_MAX),
216
+ content: displayText,
217
+ expanded: false,
218
+ timestamp,
219
+ });
220
+ i++;
221
+ }
222
+
223
+ return entries;
224
+ }
225
+
226
+ /** Toggle expand/collapse for an entry by index. Returns a new array. */
227
+ export function toggleEntry(entries: TranscriptEntry[], index: number): TranscriptEntry[] {
228
+ return entries.map((entry, i) =>
229
+ i === index ? { ...entry, expanded: !entry.expanded } : entry,
230
+ );
231
+ }
232
+
233
+ /** Render entries into display lines, respecting expand/collapse.
234
+ * Collapsed entries produce 1 line (summary). Expanded entries produce multi-line content.
235
+ * Every line is truncated to maxWidth.
236
+ */
237
+ export function renderEntries(entries: TranscriptEntry[], maxWidth: number): string[] {
238
+ const effectiveWidth = Math.max(1, maxWidth);
239
+ const lines: string[] = [];
240
+
241
+ for (const entry of entries) {
242
+ if (entry.expanded) {
243
+ const contentLines = entry.content.split(/\r?\n/);
244
+ if (contentLines.length === 0 || (contentLines.length === 1 && contentLines[0] === "")) {
245
+ lines.push(truncate(`▸ ${entry.summary}`, effectiveWidth));
246
+ } else {
247
+ lines.push(truncate(`▾ ${entry.summary}`, effectiveWidth));
248
+ for (const line of contentLines) {
249
+ lines.push(truncate(` ${line}`, effectiveWidth));
250
+ }
251
+ }
252
+ } else {
253
+ lines.push(truncate(`▸ ${entry.summary}`, effectiveWidth));
254
+ }
255
+ }
256
+
257
+ return lines;
258
+ }
@@ -1,63 +1,63 @@
1
- interface CompletionDataLike {
2
- id?: unknown;
3
- agent?: unknown;
4
- timestamp?: unknown;
5
- sessionId?: unknown;
6
- taskIndex?: unknown;
7
- totalTasks?: unknown;
8
- success?: unknown;
9
- }
10
-
11
- function asNonEmptyString(value: unknown): string | undefined {
12
- if (typeof value !== "string") return undefined;
13
- const trimmed = value.trim();
14
- return trimmed.length > 0 ? trimmed : undefined;
15
- }
16
-
17
- function asFiniteNumber(value: unknown): number | undefined {
18
- if (typeof value !== "number") return undefined;
19
- return Number.isFinite(value) ? value : undefined;
20
- }
21
-
22
- export function buildCompletionKey(data: CompletionDataLike, fallback: string): string {
23
- const id = asNonEmptyString(data.id);
24
- if (id) return `id:${id}`;
25
- const sessionId = asNonEmptyString(data.sessionId) ?? "no-session";
26
- const agent = asNonEmptyString(data.agent) ?? "unknown";
27
- const timestamp = asFiniteNumber(data.timestamp);
28
- const taskIndex = asFiniteNumber(data.taskIndex);
29
- const totalTasks = asFiniteNumber(data.totalTasks);
30
- const success = typeof data.success === "boolean" ? (data.success ? "1" : "0") : "?";
31
- return [
32
- "meta",
33
- sessionId,
34
- agent,
35
- timestamp !== undefined ? String(timestamp) : "no-ts",
36
- taskIndex !== undefined ? String(taskIndex) : "-",
37
- totalTasks !== undefined ? String(totalTasks) : "-",
38
- success,
39
- fallback,
40
- ].join(":");
41
- }
42
-
43
- export function pruneSeenMap(seen: Map<string, number>, now: number, ttlMs: number): void {
44
- for (const [key, ts] of seen.entries()) {
45
- if (now - ts > ttlMs) seen.delete(key);
46
- }
47
- }
48
-
49
- export function markSeenWithTtl(seen: Map<string, number>, key: string, now: number, ttlMs: number): boolean {
50
- pruneSeenMap(seen, now, ttlMs);
51
- if (seen.has(key)) return true;
52
- seen.set(key, now);
53
- return false;
54
- }
55
-
56
- export function getGlobalSeenMap(storeKey: string): Map<string, number> {
57
- const globalStore = globalThis as Record<string, unknown>;
58
- const existing = globalStore[storeKey];
59
- if (existing instanceof Map) return existing as Map<string, number>;
60
- const map = new Map<string, number>();
61
- globalStore[storeKey] = map;
62
- return map;
63
- }
1
+ interface CompletionDataLike {
2
+ id?: unknown;
3
+ agent?: unknown;
4
+ timestamp?: unknown;
5
+ sessionId?: unknown;
6
+ taskIndex?: unknown;
7
+ totalTasks?: unknown;
8
+ success?: unknown;
9
+ }
10
+
11
+ function asNonEmptyString(value: unknown): string | undefined {
12
+ if (typeof value !== "string") return undefined;
13
+ const trimmed = value.trim();
14
+ return trimmed.length > 0 ? trimmed : undefined;
15
+ }
16
+
17
+ function asFiniteNumber(value: unknown): number | undefined {
18
+ if (typeof value !== "number") return undefined;
19
+ return Number.isFinite(value) ? value : undefined;
20
+ }
21
+
22
+ export function buildCompletionKey(data: CompletionDataLike, fallback: string): string {
23
+ const id = asNonEmptyString(data.id);
24
+ if (id) return `id:${id}`;
25
+ const sessionId = asNonEmptyString(data.sessionId) ?? "no-session";
26
+ const agent = asNonEmptyString(data.agent) ?? "unknown";
27
+ const timestamp = asFiniteNumber(data.timestamp);
28
+ const taskIndex = asFiniteNumber(data.taskIndex);
29
+ const totalTasks = asFiniteNumber(data.totalTasks);
30
+ const success = typeof data.success === "boolean" ? (data.success ? "1" : "0") : "?";
31
+ return [
32
+ "meta",
33
+ sessionId,
34
+ agent,
35
+ timestamp !== undefined ? String(timestamp) : "no-ts",
36
+ taskIndex !== undefined ? String(taskIndex) : "-",
37
+ totalTasks !== undefined ? String(totalTasks) : "-",
38
+ success,
39
+ fallback,
40
+ ].join(":");
41
+ }
42
+
43
+ export function pruneSeenMap(seen: Map<string, number>, now: number, ttlMs: number): void {
44
+ for (const [key, ts] of seen.entries()) {
45
+ if (now - ts > ttlMs) seen.delete(key);
46
+ }
47
+ }
48
+
49
+ export function markSeenWithTtl(seen: Map<string, number>, key: string, now: number, ttlMs: number): boolean {
50
+ pruneSeenMap(seen, now, ttlMs);
51
+ if (seen.has(key)) return true;
52
+ seen.set(key, now);
53
+ return false;
54
+ }
55
+
56
+ export function getGlobalSeenMap(storeKey: string): Map<string, number> {
57
+ const globalStore = globalThis as Record<string, unknown>;
58
+ const existing = globalStore[storeKey];
59
+ if (existing instanceof Map) return existing as Map<string, number>;
60
+ const map = new Map<string, number>();
61
+ globalStore[storeKey] = map;
62
+ return map;
63
+ }