pi-crew 0.1.45 → 0.1.46

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 (198) hide show
  1. package/README.md +5 -5
  2. package/agents/analyst.md +1 -1
  3. package/agents/critic.md +1 -1
  4. package/agents/executor.md +1 -1
  5. package/agents/explorer.md +1 -1
  6. package/agents/planner.md +1 -1
  7. package/agents/reviewer.md +1 -1
  8. package/agents/security-reviewer.md +1 -1
  9. package/agents/test-engineer.md +1 -1
  10. package/agents/verifier.md +1 -1
  11. package/agents/writer.md +1 -1
  12. package/docs/next-upgrade-roadmap.md +733 -0
  13. package/docs/refactor-tasks-phase3.md +394 -394
  14. package/docs/refactor-tasks-phase4.md +564 -564
  15. package/docs/refactor-tasks-phase5.md +402 -402
  16. package/docs/refactor-tasks-phase6.md +662 -662
  17. package/docs/research-awesome-agent-skills-distillation.md +100 -0
  18. package/docs/research-extension-examples.md +297 -297
  19. package/docs/research-extension-system.md +324 -324
  20. package/docs/research-oh-my-pi-distillation.md +322 -0
  21. package/docs/research-optimization-plan.md +548 -548
  22. package/docs/research-phase10-distillation.md +198 -198
  23. package/docs/research-phase11-distillation.md +201 -201
  24. package/docs/research-pi-coding-agent.md +357 -357
  25. package/docs/research-source-pi-crew-reference.md +174 -174
  26. package/docs/runtime-flow.md +148 -148
  27. package/docs/source-runtime-refactor-map.md +107 -83
  28. package/docs/usage.md +3 -3
  29. package/index.ts +6 -6
  30. package/install.mjs +52 -8
  31. package/package.json +1 -1
  32. package/schema.json +2 -1
  33. package/skills/async-worker-recovery/SKILL.md +42 -0
  34. package/skills/context-artifact-hygiene/SKILL.md +52 -0
  35. package/skills/delegation-patterns/SKILL.md +54 -0
  36. package/skills/mailbox-interactive/SKILL.md +40 -0
  37. package/skills/model-routing-context/SKILL.md +39 -0
  38. package/skills/multi-perspective-review/SKILL.md +58 -0
  39. package/skills/observability-reliability/SKILL.md +41 -0
  40. package/skills/ownership-session-security/SKILL.md +41 -0
  41. package/skills/pi-extension-lifecycle/SKILL.md +39 -0
  42. package/skills/requirements-to-task-packet/SKILL.md +63 -0
  43. package/skills/resource-discovery-config/SKILL.md +41 -0
  44. package/skills/runtime-state-reader/SKILL.md +44 -0
  45. package/skills/secure-agent-orchestration-review/SKILL.md +45 -0
  46. package/skills/state-mutation-locking/SKILL.md +42 -0
  47. package/skills/systematic-debugging/SKILL.md +67 -0
  48. package/skills/ui-render-performance/SKILL.md +39 -0
  49. package/skills/verification-before-done/SKILL.md +57 -0
  50. package/skills/worktree-isolation/SKILL.md +39 -0
  51. package/src/agents/agent-serializer.ts +34 -34
  52. package/src/agents/discover-agents.ts +12 -11
  53. package/src/config/config.ts +48 -24
  54. package/src/config/defaults.ts +14 -0
  55. package/src/extension/cross-extension-rpc.ts +82 -82
  56. package/src/extension/project-init.ts +62 -2
  57. package/src/extension/register.ts +11 -9
  58. package/src/extension/registration/commands.ts +32 -25
  59. package/src/extension/registration/compaction-guard.ts +125 -125
  60. package/src/extension/registration/subagent-helpers.ts +8 -0
  61. package/src/extension/registration/subagent-tools.ts +149 -148
  62. package/src/extension/registration/team-tool.ts +8 -6
  63. package/src/extension/run-bundle-schema.ts +89 -89
  64. package/src/extension/run-index.ts +13 -5
  65. package/src/extension/run-maintenance.ts +62 -43
  66. package/src/extension/team-tool/api.ts +25 -8
  67. package/src/extension/team-tool/cancel.ts +33 -4
  68. package/src/extension/team-tool/context.ts +5 -0
  69. package/src/extension/team-tool/handle-settings.ts +188 -188
  70. package/src/extension/team-tool/inspect.ts +41 -41
  71. package/src/extension/team-tool/lifecycle-actions.ts +91 -79
  72. package/src/extension/team-tool/plan.ts +19 -19
  73. package/src/extension/team-tool/respond.ts +37 -17
  74. package/src/extension/team-tool/run.ts +52 -10
  75. package/src/extension/team-tool/status.ts +12 -1
  76. package/src/extension/team-tool-types.ts +2 -0
  77. package/src/extension/team-tool.ts +32 -11
  78. package/src/i18n.ts +184 -184
  79. package/src/observability/event-to-metric.ts +8 -1
  80. package/src/observability/exporters/otlp-exporter.ts +77 -77
  81. package/src/prompt/prompt-runtime.ts +72 -72
  82. package/src/runtime/agent-control.ts +63 -63
  83. package/src/runtime/agent-memory.ts +72 -72
  84. package/src/runtime/agent-observability.ts +114 -114
  85. package/src/runtime/async-marker.ts +26 -26
  86. package/src/runtime/attention-events.ts +28 -28
  87. package/src/runtime/background-runner.ts +59 -53
  88. package/src/runtime/cancellation.ts +51 -0
  89. package/src/runtime/child-pi.ts +457 -444
  90. package/src/runtime/completion-guard.ts +190 -190
  91. package/src/runtime/crash-recovery.ts +1 -0
  92. package/src/runtime/crew-agent-records.ts +38 -6
  93. package/src/runtime/deadletter.ts +1 -0
  94. package/src/runtime/delivery-coordinator.ts +46 -25
  95. package/src/runtime/direct-run.ts +35 -35
  96. package/src/runtime/effectiveness.ts +76 -0
  97. package/src/runtime/foreground-control.ts +82 -82
  98. package/src/runtime/green-contract.ts +46 -46
  99. package/src/runtime/group-join.ts +106 -106
  100. package/src/runtime/heartbeat-gradient.ts +28 -28
  101. package/src/runtime/heartbeat-watcher.ts +124 -124
  102. package/src/runtime/live-agent-control.ts +88 -87
  103. package/src/runtime/live-agent-manager.ts +103 -85
  104. package/src/runtime/live-control-realtime.ts +36 -36
  105. package/src/runtime/live-session-runtime.ts +309 -305
  106. package/src/runtime/manifest-cache.ts +17 -2
  107. package/src/runtime/model-fallback.ts +6 -4
  108. package/src/runtime/parallel-research.ts +44 -44
  109. package/src/runtime/pi-args.ts +18 -3
  110. package/src/runtime/pi-json-output.ts +111 -111
  111. package/src/runtime/policy-engine.ts +79 -79
  112. package/src/runtime/process-status.ts +5 -1
  113. package/src/runtime/progress-event-coalescer.ts +43 -43
  114. package/src/runtime/recovery-recipes.ts +74 -74
  115. package/src/runtime/retry-executor.ts +81 -64
  116. package/src/runtime/role-permission.ts +39 -39
  117. package/src/runtime/runtime-resolver.ts +22 -6
  118. package/src/runtime/session-resources.ts +25 -25
  119. package/src/runtime/session-snapshot.ts +59 -59
  120. package/src/runtime/session-usage.ts +79 -79
  121. package/src/runtime/sidechain-output.ts +29 -29
  122. package/src/runtime/skill-instructions.ts +222 -0
  123. package/src/runtime/stale-reconciler.ts +4 -14
  124. package/src/runtime/subagent-manager.ts +3 -0
  125. package/src/runtime/supervisor-contact.ts +59 -59
  126. package/src/runtime/task-display.ts +38 -38
  127. package/src/runtime/task-output-context.ts +127 -127
  128. package/src/runtime/task-runner/capabilities.ts +78 -0
  129. package/src/runtime/task-runner/live-executor.ts +105 -101
  130. package/src/runtime/task-runner/progress.ts +119 -119
  131. package/src/runtime/task-runner/prompt-builder.ts +3 -1
  132. package/src/runtime/task-runner/prompt-pipeline.ts +64 -0
  133. package/src/runtime/task-runner/result-utils.ts +14 -14
  134. package/src/runtime/task-runner/state-helpers.ts +22 -22
  135. package/src/runtime/task-runner.ts +44 -5
  136. package/src/runtime/team-runner.ts +78 -15
  137. package/src/runtime/worker-heartbeat.ts +21 -21
  138. package/src/runtime/worker-startup.ts +57 -57
  139. package/src/schema/config-schema.ts +1 -0
  140. package/src/schema/team-tool-schema.ts +3 -3
  141. package/src/state/active-run-registry.ts +165 -0
  142. package/src/state/contracts.ts +1 -1
  143. package/src/state/mailbox.ts +44 -4
  144. package/src/state/state-store.ts +8 -1
  145. package/src/state/task-claims.ts +44 -44
  146. package/src/state/types.ts +44 -2
  147. package/src/state/usage.ts +29 -29
  148. package/src/subagents/async-entry.ts +1 -1
  149. package/src/subagents/index.ts +3 -3
  150. package/src/subagents/live/control.ts +1 -1
  151. package/src/subagents/live/manager.ts +1 -1
  152. package/src/subagents/live/realtime.ts +1 -1
  153. package/src/subagents/live/session-runtime.ts +1 -1
  154. package/src/subagents/manager.ts +1 -1
  155. package/src/subagents/spawn.ts +1 -1
  156. package/src/teams/team-config.ts +1 -0
  157. package/src/teams/team-serializer.ts +38 -38
  158. package/src/types/diff.d.ts +18 -18
  159. package/src/ui/crew-footer.ts +101 -101
  160. package/src/ui/crew-select-list.ts +111 -111
  161. package/src/ui/crew-widget.ts +4 -3
  162. package/src/ui/dashboard-panes/metrics-pane.ts +34 -34
  163. package/src/ui/dashboard-panes/progress-pane.ts +2 -0
  164. package/src/ui/dynamic-border.ts +25 -25
  165. package/src/ui/layout-primitives.ts +106 -106
  166. package/src/ui/loaders.ts +158 -158
  167. package/src/ui/render-diff.ts +119 -119
  168. package/src/ui/render-scheduler.ts +143 -143
  169. package/src/ui/run-snapshot-cache.ts +10 -2
  170. package/src/ui/snapshot-types.ts +2 -0
  171. package/src/ui/spinner.ts +17 -17
  172. package/src/ui/status-colors.ts +58 -58
  173. package/src/ui/syntax-highlight.ts +116 -116
  174. package/src/utils/atomic-write.ts +33 -33
  175. package/src/utils/completion-dedupe.ts +63 -63
  176. package/src/utils/frontmatter.ts +68 -68
  177. package/src/utils/git.ts +262 -262
  178. package/src/utils/ids.ts +12 -12
  179. package/src/utils/names.ts +27 -27
  180. package/src/utils/paths.ts +4 -2
  181. package/src/utils/redaction.ts +44 -44
  182. package/src/utils/safe-paths.ts +47 -47
  183. package/src/utils/sleep.ts +32 -32
  184. package/src/workflows/validate-workflow.ts +40 -40
  185. package/src/workflows/workflow-config.ts +1 -0
  186. package/src/worktree/branch-freshness.ts +45 -45
  187. package/teams/default.team.md +12 -12
  188. package/teams/fast-fix.team.md +11 -11
  189. package/teams/implementation.team.md +18 -18
  190. package/teams/parallel-research.team.md +14 -14
  191. package/teams/research.team.md +11 -11
  192. package/teams/review.team.md +12 -12
  193. package/workflows/default.workflow.md +29 -29
  194. package/workflows/fast-fix.workflow.md +22 -22
  195. package/workflows/implementation.workflow.md +38 -38
  196. package/workflows/parallel-research.workflow.md +46 -46
  197. package/workflows/research.workflow.md +22 -22
  198. package/workflows/review.workflow.md +30 -30
@@ -1,119 +1,119 @@
1
- import * as Diff from "diff";
2
- import type { CrewTheme } from "./theme-adapter.ts";
3
- import { asCrewTheme } from "./theme-adapter.ts";
4
-
5
- interface ParsedDiffLine {
6
- prefix: string;
7
- lineNum: string; content: string;
8
- }
9
-
10
- interface DiffLineContent {
11
- lineNum: string;
12
- content: string;
13
- }
14
-
15
- function parseDiffLine(line: string): ParsedDiffLine | null {
16
- const match = line.match(/^([+-\s])(\s*\d*)\s(.*)$/);
17
- if (!match) return null;
18
- return { prefix: match[1], lineNum: match[2], content: match[3] };
19
- }
20
-
21
- function replaceTabs(text: string): string {
22
- return text.replace(/\t/g, " ");
23
- }
24
-
25
- function renderIntraLineDiff(theme: CrewTheme, oldContent: string, newContent: string): { removedLine: string; addedLine: string } {
26
- const wordDiff = Diff.diffWords(oldContent, newContent);
27
- let removedLine = "";
28
- let addedLine = "";
29
- let isFirstRemoved = true;
30
- let isFirstAdded = true;
31
-
32
- for (const part of wordDiff) {
33
- if (part.removed) {
34
- let value = part.value;
35
- if (isFirstRemoved) {
36
- const leadingWs = value.match(/^(\s*)/)?.[1] ?? "";
37
- value = value.slice(leadingWs.length);
38
- removedLine += leadingWs;
39
- isFirstRemoved = false;
40
- }
41
- if (value) removedLine += theme.inverse?.(value) ?? value;
42
- } else if (part.added) {
43
- let value = part.value;
44
- if (isFirstAdded) {
45
- const leadingWs = value.match(/^(\s*)/)?.[1] ?? "";
46
- value = value.slice(leadingWs.length);
47
- addedLine += leadingWs;
48
- isFirstAdded = false;
49
- }
50
- if (value) addedLine += theme.inverse?.(value) ?? value;
51
- } else {
52
- removedLine += part.value;
53
- addedLine += part.value;
54
- }
55
- }
56
-
57
- return { removedLine, addedLine };
58
- }
59
-
60
- export interface RenderDiffOptions {
61
- filePath?: string;
62
- theme?: unknown;
63
- }
64
-
65
- export function renderDiff(diffText: string, options: RenderDiffOptions = {}): string {
66
- const theme = asCrewTheme(options.theme);
67
- const lines = diffText.split("\n");
68
- const result: string[] = [];
69
- let i = 0;
70
-
71
- while (i < lines.length) {
72
- const line = lines[i] ?? "";
73
- const parsed = parseDiffLine(line);
74
- if (!parsed) {
75
- result.push(theme.fg("toolDiffContext", line));
76
- i++;
77
- continue;
78
- }
79
-
80
- if (parsed.prefix === "-") {
81
- const removedLines: DiffLineContent[] = [];
82
- while (i < lines.length) {
83
- const nextParsed = parseDiffLine(lines[i] ?? "");
84
- if (!nextParsed || nextParsed.prefix !== "-") break;
85
- removedLines.push({ lineNum: nextParsed.lineNum, content: nextParsed.content });
86
- i++;
87
- }
88
-
89
- const addedLines: DiffLineContent[] = [];
90
- while (i < lines.length) {
91
- const nextParsed = parseDiffLine(lines[i] ?? "");
92
- if (!nextParsed || nextParsed.prefix !== "+") break;
93
- addedLines.push({ lineNum: nextParsed.lineNum, content: nextParsed.content });
94
- i++;
95
- }
96
-
97
- if (removedLines.length === 1 && addedLines.length === 1) {
98
- const { removedLine, addedLine } = renderIntraLineDiff(theme, replaceTabs(removedLines[0]!.content), replaceTabs(addedLines[0]!.content));
99
- result.push(theme.fg("toolDiffRemoved", `-${removedLines[0]!.lineNum} ${removedLine}`));
100
- result.push(theme.fg("toolDiffAdded", `+${addedLines[0]!.lineNum} ${addedLine}`));
101
- } else {
102
- for (const removed of removedLines) {
103
- result.push(theme.fg("toolDiffRemoved", `-${removed.lineNum} ${replaceTabs(removed.content)}`));
104
- }
105
- for (const added of addedLines) {
106
- result.push(theme.fg("toolDiffAdded", `+${added.lineNum} ${replaceTabs(added.content)}`));
107
- }
108
- }
109
- } else if (parsed.prefix === "+") {
110
- result.push(theme.fg("toolDiffAdded", `+${parsed.lineNum} ${replaceTabs(parsed.content)}`));
111
- i++;
112
- } else {
113
- result.push(theme.fg("toolDiffContext", ` ${parsed.lineNum} ${replaceTabs(parsed.content)}`));
114
- i++;
115
- }
116
- }
117
-
118
- return result.join("\n");
119
- }
1
+ import * as Diff from "diff";
2
+ import type { CrewTheme } from "./theme-adapter.ts";
3
+ import { asCrewTheme } from "./theme-adapter.ts";
4
+
5
+ interface ParsedDiffLine {
6
+ prefix: string;
7
+ lineNum: string; content: string;
8
+ }
9
+
10
+ interface DiffLineContent {
11
+ lineNum: string;
12
+ content: string;
13
+ }
14
+
15
+ function parseDiffLine(line: string): ParsedDiffLine | null {
16
+ const match = line.match(/^([+-\s])(\s*\d*)\s(.*)$/);
17
+ if (!match) return null;
18
+ return { prefix: match[1], lineNum: match[2], content: match[3] };
19
+ }
20
+
21
+ function replaceTabs(text: string): string {
22
+ return text.replace(/\t/g, " ");
23
+ }
24
+
25
+ function renderIntraLineDiff(theme: CrewTheme, oldContent: string, newContent: string): { removedLine: string; addedLine: string } {
26
+ const wordDiff = Diff.diffWords(oldContent, newContent);
27
+ let removedLine = "";
28
+ let addedLine = "";
29
+ let isFirstRemoved = true;
30
+ let isFirstAdded = true;
31
+
32
+ for (const part of wordDiff) {
33
+ if (part.removed) {
34
+ let value = part.value;
35
+ if (isFirstRemoved) {
36
+ const leadingWs = value.match(/^(\s*)/)?.[1] ?? "";
37
+ value = value.slice(leadingWs.length);
38
+ removedLine += leadingWs;
39
+ isFirstRemoved = false;
40
+ }
41
+ if (value) removedLine += theme.inverse?.(value) ?? value;
42
+ } else if (part.added) {
43
+ let value = part.value;
44
+ if (isFirstAdded) {
45
+ const leadingWs = value.match(/^(\s*)/)?.[1] ?? "";
46
+ value = value.slice(leadingWs.length);
47
+ addedLine += leadingWs;
48
+ isFirstAdded = false;
49
+ }
50
+ if (value) addedLine += theme.inverse?.(value) ?? value;
51
+ } else {
52
+ removedLine += part.value;
53
+ addedLine += part.value;
54
+ }
55
+ }
56
+
57
+ return { removedLine, addedLine };
58
+ }
59
+
60
+ export interface RenderDiffOptions {
61
+ filePath?: string;
62
+ theme?: unknown;
63
+ }
64
+
65
+ export function renderDiff(diffText: string, options: RenderDiffOptions = {}): string {
66
+ const theme = asCrewTheme(options.theme);
67
+ const lines = diffText.split("\n");
68
+ const result: string[] = [];
69
+ let i = 0;
70
+
71
+ while (i < lines.length) {
72
+ const line = lines[i] ?? "";
73
+ const parsed = parseDiffLine(line);
74
+ if (!parsed) {
75
+ result.push(theme.fg("toolDiffContext", line));
76
+ i++;
77
+ continue;
78
+ }
79
+
80
+ if (parsed.prefix === "-") {
81
+ const removedLines: DiffLineContent[] = [];
82
+ while (i < lines.length) {
83
+ const nextParsed = parseDiffLine(lines[i] ?? "");
84
+ if (!nextParsed || nextParsed.prefix !== "-") break;
85
+ removedLines.push({ lineNum: nextParsed.lineNum, content: nextParsed.content });
86
+ i++;
87
+ }
88
+
89
+ const addedLines: DiffLineContent[] = [];
90
+ while (i < lines.length) {
91
+ const nextParsed = parseDiffLine(lines[i] ?? "");
92
+ if (!nextParsed || nextParsed.prefix !== "+") break;
93
+ addedLines.push({ lineNum: nextParsed.lineNum, content: nextParsed.content });
94
+ i++;
95
+ }
96
+
97
+ if (removedLines.length === 1 && addedLines.length === 1) {
98
+ const { removedLine, addedLine } = renderIntraLineDiff(theme, replaceTabs(removedLines[0]!.content), replaceTabs(addedLines[0]!.content));
99
+ result.push(theme.fg("toolDiffRemoved", `-${removedLines[0]!.lineNum} ${removedLine}`));
100
+ result.push(theme.fg("toolDiffAdded", `+${addedLines[0]!.lineNum} ${addedLine}`));
101
+ } else {
102
+ for (const removed of removedLines) {
103
+ result.push(theme.fg("toolDiffRemoved", `-${removed.lineNum} ${replaceTabs(removed.content)}`));
104
+ }
105
+ for (const added of addedLines) {
106
+ result.push(theme.fg("toolDiffAdded", `+${added.lineNum} ${replaceTabs(added.content)}`));
107
+ }
108
+ }
109
+ } else if (parsed.prefix === "+") {
110
+ result.push(theme.fg("toolDiffAdded", `+${parsed.lineNum} ${replaceTabs(parsed.content)}`));
111
+ i++;
112
+ } else {
113
+ result.push(theme.fg("toolDiffContext", ` ${parsed.lineNum} ${replaceTabs(parsed.content)}`));
114
+ i++;
115
+ }
116
+ }
117
+
118
+ return result.join("\n");
119
+ }
@@ -1,143 +1,143 @@
1
- import { logInternalError } from "../utils/internal-error.ts";
2
-
3
- export interface RenderSchedulerEventBus {
4
- on?: (event: string, handler: (payload: unknown) => void) => (() => void) | void;
5
- }
6
-
7
- export interface RenderSchedulerOptions {
8
- debounceMs?: number;
9
- fallbackMs?: number;
10
- events?: string[];
11
- onInvalidate?: (payload: unknown) => void;
12
- }
13
-
14
- const DEFAULT_EVENTS = [
15
- "crew.run.created",
16
- "crew.run.completed",
17
- "crew.run.failed",
18
- "crew.run.cancelled",
19
- "crew.subagent.completed",
20
- "crew.subagent.failed",
21
- "crew.mailbox.updated",
22
- "crew.mailbox.message",
23
- ];
24
-
25
- /**
26
- * Coordinates UI renders with debounce + fallback polling.
27
- *
28
- * Critical: uses recursive setTimeout instead of setInterval + a rendering
29
- * guard (`rendering` / `pendingRender`) so that when render() takes longer
30
- * than the fallback interval, callbacks do NOT pile up and storm the event
31
- * loop. Instead, overlapping schedules are collapsed into a single deferred
32
- * re-render.
33
- */
34
- export class RenderScheduler {
35
- private readonly render: () => void;
36
- private readonly onInvalidate?: (payload: unknown) => void;
37
- private readonly debounceMs: number;
38
- private readonly fallbackMs: number;
39
- private debounceTimer: ReturnType<typeof setTimeout> | undefined;
40
- private fallbackTimer: ReturnType<typeof setTimeout> | undefined;
41
- private disposed = false;
42
- private lastEventAt = 0;
43
- private rendering = false;
44
- private pendingRender = false;
45
- private readonly unsubs: Array<() => void> = [];
46
-
47
- constructor(events: RenderSchedulerEventBus | undefined, render: () => void, options: RenderSchedulerOptions = {}) {
48
- this.render = render;
49
- this.onInvalidate = options.onInvalidate;
50
- this.debounceMs = options.debounceMs ?? 75;
51
- this.fallbackMs = options.fallbackMs ?? 750;
52
- for (const event of options.events ?? DEFAULT_EVENTS) this.subscribe(events, event);
53
- this.fallbackTimer = setTimeout(() => this.fallbackLoop(), this.fallbackMs);
54
- this.fallbackTimer.unref();
55
- }
56
-
57
- private subscribe(events: RenderSchedulerEventBus | undefined, event: string): void {
58
- if (!events?.on) return;
59
- const handler = (payload: unknown): void => this.schedule(payload);
60
- try {
61
- const unsub = events.on(event, handler);
62
- if (typeof unsub === "function") this.unsubs.push(unsub);
63
- } catch (error) {
64
- logInternalError("render-scheduler.subscribe", error, event);
65
- }
66
- }
67
-
68
- /** Recursive setTimeout — avoids setInterval timer storms. */
69
- private fallbackLoop(): void {
70
- if (this.disposed) return;
71
- if (Date.now() - this.lastEventAt < this.fallbackMs) {
72
- if (this.disposed) return;
73
- this.fallbackTimer = setTimeout(() => this.fallbackLoop(), this.fallbackMs);
74
- this.fallbackTimer.unref();
75
- return;
76
- }
77
- this.schedule();
78
- if (this.disposed) return;
79
- this.fallbackTimer = setTimeout(() => this.fallbackLoop(), this.fallbackMs);
80
- this.fallbackTimer.unref();
81
- }
82
-
83
- schedule(payload?: unknown): void {
84
- if (this.disposed) return;
85
- this.lastEventAt = Date.now();
86
- try {
87
- this.onInvalidate?.(payload);
88
- } catch (error) {
89
- logInternalError("render-scheduler.invalidate", error);
90
- }
91
- if (this.debounceTimer) clearTimeout(this.debounceTimer);
92
- this.debounceTimer = setTimeout(() => {
93
- this.debounceTimer = undefined;
94
- this.flush();
95
- }, this.debounceMs);
96
- this.debounceTimer.unref();
97
- }
98
-
99
- /**
100
- * Flush a render. If a render is already in progress the request is
101
- * collapsed: `pendingRender` is set and the caller that holds
102
- * `rendering==true` will loop one more time after finishing.
103
- */
104
- flush(): void {
105
- if (this.disposed) return;
106
- if (this.rendering) {
107
- this.pendingRender = true;
108
- return;
109
- }
110
- this.rendering = true;
111
- this.pendingRender = false;
112
- let iterations = 0;
113
- try {
114
- do {
115
- this.pendingRender = false;
116
- this.render();
117
- iterations += 1;
118
- // Safety valve: 5 re-renders max per flush to prevent infinite loops
119
- // if render() itself calls flush() synchronously.
120
- } while (this.pendingRender && !this.disposed && iterations < 5);
121
- } catch (error) {
122
- logInternalError("render-scheduler.render", error);
123
- } finally {
124
- this.rendering = false;
125
- // If we hit the iteration cap, schedule one more render to drain.
126
- if (iterations >= 5 && this.pendingRender && !this.disposed) {
127
- this.schedule();
128
- }
129
- }
130
- }
131
-
132
- dispose(): void {
133
- if (this.disposed) return;
134
- this.disposed = true;
135
- if (this.debounceTimer) clearTimeout(this.debounceTimer);
136
- if (this.fallbackTimer) clearTimeout(this.fallbackTimer);
137
- this.debounceTimer = undefined;
138
- this.fallbackTimer = undefined;
139
- for (const unsub of this.unsubs.splice(0)) {
140
- try { unsub(); } catch (error) { logInternalError("render-scheduler.unsubscribe", error); }
141
- }
142
- }
143
- }
1
+ import { logInternalError } from "../utils/internal-error.ts";
2
+
3
+ export interface RenderSchedulerEventBus {
4
+ on?: (event: string, handler: (payload: unknown) => void) => (() => void) | void;
5
+ }
6
+
7
+ export interface RenderSchedulerOptions {
8
+ debounceMs?: number;
9
+ fallbackMs?: number;
10
+ events?: string[];
11
+ onInvalidate?: (payload: unknown) => void;
12
+ }
13
+
14
+ const DEFAULT_EVENTS = [
15
+ "crew.run.created",
16
+ "crew.run.completed",
17
+ "crew.run.failed",
18
+ "crew.run.cancelled",
19
+ "crew.subagent.completed",
20
+ "crew.subagent.failed",
21
+ "crew.mailbox.updated",
22
+ "crew.mailbox.message",
23
+ ];
24
+
25
+ /**
26
+ * Coordinates UI renders with debounce + fallback polling.
27
+ *
28
+ * Critical: uses recursive setTimeout instead of setInterval + a rendering
29
+ * guard (`rendering` / `pendingRender`) so that when render() takes longer
30
+ * than the fallback interval, callbacks do NOT pile up and storm the event
31
+ * loop. Instead, overlapping schedules are collapsed into a single deferred
32
+ * re-render.
33
+ */
34
+ export class RenderScheduler {
35
+ private readonly render: () => void;
36
+ private readonly onInvalidate?: (payload: unknown) => void;
37
+ private readonly debounceMs: number;
38
+ private readonly fallbackMs: number;
39
+ private debounceTimer: ReturnType<typeof setTimeout> | undefined;
40
+ private fallbackTimer: ReturnType<typeof setTimeout> | undefined;
41
+ private disposed = false;
42
+ private lastEventAt = 0;
43
+ private rendering = false;
44
+ private pendingRender = false;
45
+ private readonly unsubs: Array<() => void> = [];
46
+
47
+ constructor(events: RenderSchedulerEventBus | undefined, render: () => void, options: RenderSchedulerOptions = {}) {
48
+ this.render = render;
49
+ this.onInvalidate = options.onInvalidate;
50
+ this.debounceMs = options.debounceMs ?? 75;
51
+ this.fallbackMs = options.fallbackMs ?? 750;
52
+ for (const event of options.events ?? DEFAULT_EVENTS) this.subscribe(events, event);
53
+ this.fallbackTimer = setTimeout(() => this.fallbackLoop(), this.fallbackMs);
54
+ this.fallbackTimer.unref();
55
+ }
56
+
57
+ private subscribe(events: RenderSchedulerEventBus | undefined, event: string): void {
58
+ if (!events?.on) return;
59
+ const handler = (payload: unknown): void => this.schedule(payload);
60
+ try {
61
+ const unsub = events.on(event, handler);
62
+ if (typeof unsub === "function") this.unsubs.push(unsub);
63
+ } catch (error) {
64
+ logInternalError("render-scheduler.subscribe", error, event);
65
+ }
66
+ }
67
+
68
+ /** Recursive setTimeout — avoids setInterval timer storms. */
69
+ private fallbackLoop(): void {
70
+ if (this.disposed) return;
71
+ if (Date.now() - this.lastEventAt < this.fallbackMs) {
72
+ if (this.disposed) return;
73
+ this.fallbackTimer = setTimeout(() => this.fallbackLoop(), this.fallbackMs);
74
+ this.fallbackTimer.unref();
75
+ return;
76
+ }
77
+ this.schedule();
78
+ if (this.disposed) return;
79
+ this.fallbackTimer = setTimeout(() => this.fallbackLoop(), this.fallbackMs);
80
+ this.fallbackTimer.unref();
81
+ }
82
+
83
+ schedule(payload?: unknown): void {
84
+ if (this.disposed) return;
85
+ this.lastEventAt = Date.now();
86
+ try {
87
+ this.onInvalidate?.(payload);
88
+ } catch (error) {
89
+ logInternalError("render-scheduler.invalidate", error);
90
+ }
91
+ if (this.debounceTimer) clearTimeout(this.debounceTimer);
92
+ this.debounceTimer = setTimeout(() => {
93
+ this.debounceTimer = undefined;
94
+ this.flush();
95
+ }, this.debounceMs);
96
+ this.debounceTimer.unref();
97
+ }
98
+
99
+ /**
100
+ * Flush a render. If a render is already in progress the request is
101
+ * collapsed: `pendingRender` is set and the caller that holds
102
+ * `rendering==true` will loop one more time after finishing.
103
+ */
104
+ flush(): void {
105
+ if (this.disposed) return;
106
+ if (this.rendering) {
107
+ this.pendingRender = true;
108
+ return;
109
+ }
110
+ this.rendering = true;
111
+ this.pendingRender = false;
112
+ let iterations = 0;
113
+ try {
114
+ do {
115
+ this.pendingRender = false;
116
+ this.render();
117
+ iterations += 1;
118
+ // Safety valve: 5 re-renders max per flush to prevent infinite loops
119
+ // if render() itself calls flush() synchronously.
120
+ } while (this.pendingRender && !this.disposed && iterations < 5);
121
+ } catch (error) {
122
+ logInternalError("render-scheduler.render", error);
123
+ } finally {
124
+ this.rendering = false;
125
+ // If we hit the iteration cap, schedule one more render to drain.
126
+ if (iterations >= 5 && this.pendingRender && !this.disposed) {
127
+ this.schedule();
128
+ }
129
+ }
130
+ }
131
+
132
+ dispose(): void {
133
+ if (this.disposed) return;
134
+ this.disposed = true;
135
+ if (this.debounceTimer) clearTimeout(this.debounceTimer);
136
+ if (this.fallbackTimer) clearTimeout(this.fallbackTimer);
137
+ this.debounceTimer = undefined;
138
+ this.fallbackTimer = undefined;
139
+ for (const unsub of this.unsubs.splice(0)) {
140
+ try { unsub(); } catch (error) { logInternalError("render-scheduler.unsubscribe", error); }
141
+ }
142
+ }
143
+ }
@@ -478,6 +478,10 @@ async function mailboxFromAsync(manifest: TeamRunManifest, agents: CrewAgentReco
478
478
  return { inboxUnread: inbox.count, outboxPending: outbox.count, needsAttention: inbox.count + attentionAgents, approximate: inbox.approximate || outbox.approximate };
479
479
  }
480
480
 
481
+ function cancellationReasonFromEvents(events: TeamEvent[]): string | undefined {
482
+ return [...events].reverse().find((event) => event.type === "run.cancelled" && typeof event.data?.reason === "string")?.data?.reason as string | undefined;
483
+ }
484
+
481
485
  function signatureFor(input: Omit<RunUiSnapshot, "signature" | "fetchedAt">, stamps: SnapshotStamps): string {
482
486
  try {
483
487
  const digest = createHash("sha256");
@@ -489,7 +493,8 @@ function signatureFor(input: Omit<RunUiSnapshot, "signature" | "fetchedAt">, sta
489
493
  usage: input.usage,
490
494
  mailbox: input.mailbox,
491
495
  groupJoins: input.groupJoins,
492
- events: input.recentEvents.map((event) => [event.metadata?.seq, event.time, event.type, event.taskId, event.message]),
496
+ events: input.recentEvents.map((event) => [event.metadata?.seq, event.time, event.type, event.taskId, event.message, event.data?.reason]),
497
+ cancellationReason: input.cancellationReason,
493
498
  output: input.recentOutputLines,
494
499
  stamps,
495
500
  }));
@@ -571,6 +576,7 @@ export function createRunSnapshotCache(cwd: string, options: RunSnapshotCacheOpt
571
576
  }
572
577
  const mailbox = mailboxFrom(loaded.manifest, agents);
573
578
  const groupJoins = groupJoinsFrom(loaded.manifest);
579
+ const recentEvents = safeRecentEvents(loaded.manifest.eventsPath, recentEventsLimit);
574
580
  const base = {
575
581
  runId: loaded.manifest.runId,
576
582
  cwd: loaded.manifest.cwd,
@@ -581,7 +587,8 @@ export function createRunSnapshotCache(cwd: string, options: RunSnapshotCacheOpt
581
587
  usage: usageFrom(tasks, agents),
582
588
  mailbox,
583
589
  groupJoins,
584
- recentEvents: safeRecentEvents(loaded.manifest.eventsPath, recentEventsLimit),
590
+ cancellationReason: cancellationReasonFromEvents(recentEvents),
591
+ recentEvents,
585
592
  recentOutputLines: recentOutputLines(loaded.manifest, agents, recentOutputLimit),
586
593
  };
587
594
  const stamps = stampsFor(loaded.manifest, agents);
@@ -626,6 +633,7 @@ export function createRunSnapshotCache(cwd: string, options: RunSnapshotCacheOpt
626
633
  usage: usageFrom(tasks, agents),
627
634
  mailbox,
628
635
  groupJoins,
636
+ cancellationReason: cancellationReasonFromEvents(recentEvents),
629
637
  recentEvents,
630
638
  recentOutputLines: recentOutput,
631
639
  };
@@ -46,6 +46,8 @@ export interface RunUiSnapshot {
46
46
  usage: RunUiUsage;
47
47
  mailbox: RunUiMailbox;
48
48
  groupJoins?: RunUiGroupJoin[];
49
+ /** Structured cancellation reason from run.cancelled event data, when available. */
50
+ cancellationReason?: string;
49
51
  recentEvents: TeamEvent[];
50
52
  recentOutputLines: string[];
51
53
  }
package/src/ui/spinner.ts CHANGED
@@ -1,17 +1,17 @@
1
- export const SUBAGENT_SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"] as const;
2
- export const SUBAGENT_SPINNER_FRAME_MS = 160;
3
-
4
- export function spinnerBucket(now = Date.now(), frameMs = SUBAGENT_SPINNER_FRAME_MS): number {
5
- return Math.floor(now / Math.max(1, frameMs));
6
- }
7
-
8
- function hashKey(key: string): number {
9
- let hash = 0;
10
- for (let index = 0; index < key.length; index += 1) hash = (hash * 31 + key.charCodeAt(index)) >>> 0;
11
- return hash;
12
- }
13
-
14
- export function spinnerFrame(key = "", now = Date.now()): string {
15
- const offset = key ? hashKey(key) % SUBAGENT_SPINNER_FRAMES.length : 0;
16
- return SUBAGENT_SPINNER_FRAMES[(spinnerBucket(now) + offset) % SUBAGENT_SPINNER_FRAMES.length] ?? SUBAGENT_SPINNER_FRAMES[0];
17
- }
1
+ export const SUBAGENT_SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"] as const;
2
+ export const SUBAGENT_SPINNER_FRAME_MS = 160;
3
+
4
+ export function spinnerBucket(now = Date.now(), frameMs = SUBAGENT_SPINNER_FRAME_MS): number {
5
+ return Math.floor(now / Math.max(1, frameMs));
6
+ }
7
+
8
+ function hashKey(key: string): number {
9
+ let hash = 0;
10
+ for (let index = 0; index < key.length; index += 1) hash = (hash * 31 + key.charCodeAt(index)) >>> 0;
11
+ return hash;
12
+ }
13
+
14
+ export function spinnerFrame(key = "", now = Date.now()): string {
15
+ const offset = key ? hashKey(key) % SUBAGENT_SPINNER_FRAMES.length : 0;
16
+ return SUBAGENT_SPINNER_FRAMES[(spinnerBucket(now) + offset) % SUBAGENT_SPINNER_FRAMES.length] ?? SUBAGENT_SPINNER_FRAMES[0];
17
+ }