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.
- package/README.md +5 -5
- package/agents/analyst.md +1 -1
- package/agents/critic.md +1 -1
- package/agents/executor.md +1 -1
- package/agents/explorer.md +1 -1
- package/agents/planner.md +1 -1
- package/agents/reviewer.md +1 -1
- package/agents/security-reviewer.md +1 -1
- package/agents/test-engineer.md +1 -1
- package/agents/verifier.md +1 -1
- package/agents/writer.md +1 -1
- package/docs/next-upgrade-roadmap.md +733 -0
- package/docs/refactor-tasks-phase3.md +394 -394
- package/docs/refactor-tasks-phase4.md +564 -564
- package/docs/refactor-tasks-phase5.md +402 -402
- package/docs/refactor-tasks-phase6.md +662 -662
- package/docs/research-awesome-agent-skills-distillation.md +100 -0
- package/docs/research-extension-examples.md +297 -297
- package/docs/research-extension-system.md +324 -324
- package/docs/research-oh-my-pi-distillation.md +322 -0
- package/docs/research-optimization-plan.md +548 -548
- package/docs/research-phase10-distillation.md +198 -198
- package/docs/research-phase11-distillation.md +201 -201
- package/docs/research-pi-coding-agent.md +357 -357
- package/docs/research-source-pi-crew-reference.md +174 -174
- package/docs/runtime-flow.md +148 -148
- package/docs/source-runtime-refactor-map.md +107 -83
- package/docs/usage.md +3 -3
- package/index.ts +6 -6
- package/install.mjs +52 -8
- package/package.json +1 -1
- package/schema.json +2 -1
- package/skills/async-worker-recovery/SKILL.md +42 -0
- package/skills/context-artifact-hygiene/SKILL.md +52 -0
- package/skills/delegation-patterns/SKILL.md +54 -0
- package/skills/mailbox-interactive/SKILL.md +40 -0
- package/skills/model-routing-context/SKILL.md +39 -0
- package/skills/multi-perspective-review/SKILL.md +58 -0
- package/skills/observability-reliability/SKILL.md +41 -0
- package/skills/ownership-session-security/SKILL.md +41 -0
- package/skills/pi-extension-lifecycle/SKILL.md +39 -0
- package/skills/requirements-to-task-packet/SKILL.md +63 -0
- package/skills/resource-discovery-config/SKILL.md +41 -0
- package/skills/runtime-state-reader/SKILL.md +44 -0
- package/skills/secure-agent-orchestration-review/SKILL.md +45 -0
- package/skills/state-mutation-locking/SKILL.md +42 -0
- package/skills/systematic-debugging/SKILL.md +67 -0
- package/skills/ui-render-performance/SKILL.md +39 -0
- package/skills/verification-before-done/SKILL.md +57 -0
- package/skills/worktree-isolation/SKILL.md +39 -0
- package/src/agents/agent-serializer.ts +34 -34
- package/src/agents/discover-agents.ts +12 -11
- package/src/config/config.ts +48 -24
- package/src/config/defaults.ts +14 -0
- package/src/extension/cross-extension-rpc.ts +82 -82
- package/src/extension/project-init.ts +62 -2
- package/src/extension/register.ts +11 -9
- package/src/extension/registration/commands.ts +32 -25
- package/src/extension/registration/compaction-guard.ts +125 -125
- package/src/extension/registration/subagent-helpers.ts +8 -0
- package/src/extension/registration/subagent-tools.ts +149 -148
- package/src/extension/registration/team-tool.ts +8 -6
- package/src/extension/run-bundle-schema.ts +89 -89
- package/src/extension/run-index.ts +13 -5
- package/src/extension/run-maintenance.ts +62 -43
- package/src/extension/team-tool/api.ts +25 -8
- package/src/extension/team-tool/cancel.ts +33 -4
- package/src/extension/team-tool/context.ts +5 -0
- package/src/extension/team-tool/handle-settings.ts +188 -188
- package/src/extension/team-tool/inspect.ts +41 -41
- package/src/extension/team-tool/lifecycle-actions.ts +91 -79
- package/src/extension/team-tool/plan.ts +19 -19
- package/src/extension/team-tool/respond.ts +37 -17
- package/src/extension/team-tool/run.ts +52 -10
- package/src/extension/team-tool/status.ts +12 -1
- package/src/extension/team-tool-types.ts +2 -0
- package/src/extension/team-tool.ts +32 -11
- package/src/i18n.ts +184 -184
- package/src/observability/event-to-metric.ts +8 -1
- package/src/observability/exporters/otlp-exporter.ts +77 -77
- package/src/prompt/prompt-runtime.ts +72 -72
- package/src/runtime/agent-control.ts +63 -63
- package/src/runtime/agent-memory.ts +72 -72
- package/src/runtime/agent-observability.ts +114 -114
- package/src/runtime/async-marker.ts +26 -26
- package/src/runtime/attention-events.ts +28 -28
- package/src/runtime/background-runner.ts +59 -53
- package/src/runtime/cancellation.ts +51 -0
- package/src/runtime/child-pi.ts +457 -444
- package/src/runtime/completion-guard.ts +190 -190
- package/src/runtime/crash-recovery.ts +1 -0
- package/src/runtime/crew-agent-records.ts +38 -6
- package/src/runtime/deadletter.ts +1 -0
- package/src/runtime/delivery-coordinator.ts +46 -25
- package/src/runtime/direct-run.ts +35 -35
- package/src/runtime/effectiveness.ts +76 -0
- package/src/runtime/foreground-control.ts +82 -82
- package/src/runtime/green-contract.ts +46 -46
- package/src/runtime/group-join.ts +106 -106
- package/src/runtime/heartbeat-gradient.ts +28 -28
- package/src/runtime/heartbeat-watcher.ts +124 -124
- package/src/runtime/live-agent-control.ts +88 -87
- package/src/runtime/live-agent-manager.ts +103 -85
- package/src/runtime/live-control-realtime.ts +36 -36
- package/src/runtime/live-session-runtime.ts +309 -305
- package/src/runtime/manifest-cache.ts +17 -2
- package/src/runtime/model-fallback.ts +6 -4
- package/src/runtime/parallel-research.ts +44 -44
- package/src/runtime/pi-args.ts +18 -3
- package/src/runtime/pi-json-output.ts +111 -111
- package/src/runtime/policy-engine.ts +79 -79
- package/src/runtime/process-status.ts +5 -1
- package/src/runtime/progress-event-coalescer.ts +43 -43
- package/src/runtime/recovery-recipes.ts +74 -74
- package/src/runtime/retry-executor.ts +81 -64
- package/src/runtime/role-permission.ts +39 -39
- package/src/runtime/runtime-resolver.ts +22 -6
- package/src/runtime/session-resources.ts +25 -25
- package/src/runtime/session-snapshot.ts +59 -59
- package/src/runtime/session-usage.ts +79 -79
- package/src/runtime/sidechain-output.ts +29 -29
- package/src/runtime/skill-instructions.ts +222 -0
- package/src/runtime/stale-reconciler.ts +4 -14
- package/src/runtime/subagent-manager.ts +3 -0
- package/src/runtime/supervisor-contact.ts +59 -59
- package/src/runtime/task-display.ts +38 -38
- package/src/runtime/task-output-context.ts +127 -127
- package/src/runtime/task-runner/capabilities.ts +78 -0
- package/src/runtime/task-runner/live-executor.ts +105 -101
- package/src/runtime/task-runner/progress.ts +119 -119
- package/src/runtime/task-runner/prompt-builder.ts +3 -1
- package/src/runtime/task-runner/prompt-pipeline.ts +64 -0
- package/src/runtime/task-runner/result-utils.ts +14 -14
- package/src/runtime/task-runner/state-helpers.ts +22 -22
- package/src/runtime/task-runner.ts +44 -5
- package/src/runtime/team-runner.ts +78 -15
- package/src/runtime/worker-heartbeat.ts +21 -21
- package/src/runtime/worker-startup.ts +57 -57
- package/src/schema/config-schema.ts +1 -0
- package/src/schema/team-tool-schema.ts +3 -3
- package/src/state/active-run-registry.ts +165 -0
- package/src/state/contracts.ts +1 -1
- package/src/state/mailbox.ts +44 -4
- package/src/state/state-store.ts +8 -1
- package/src/state/task-claims.ts +44 -44
- package/src/state/types.ts +44 -2
- package/src/state/usage.ts +29 -29
- package/src/subagents/async-entry.ts +1 -1
- package/src/subagents/index.ts +3 -3
- package/src/subagents/live/control.ts +1 -1
- package/src/subagents/live/manager.ts +1 -1
- package/src/subagents/live/realtime.ts +1 -1
- package/src/subagents/live/session-runtime.ts +1 -1
- package/src/subagents/manager.ts +1 -1
- package/src/subagents/spawn.ts +1 -1
- package/src/teams/team-config.ts +1 -0
- package/src/teams/team-serializer.ts +38 -38
- package/src/types/diff.d.ts +18 -18
- package/src/ui/crew-footer.ts +101 -101
- package/src/ui/crew-select-list.ts +111 -111
- package/src/ui/crew-widget.ts +4 -3
- package/src/ui/dashboard-panes/metrics-pane.ts +34 -34
- package/src/ui/dashboard-panes/progress-pane.ts +2 -0
- package/src/ui/dynamic-border.ts +25 -25
- package/src/ui/layout-primitives.ts +106 -106
- package/src/ui/loaders.ts +158 -158
- package/src/ui/render-diff.ts +119 -119
- package/src/ui/render-scheduler.ts +143 -143
- package/src/ui/run-snapshot-cache.ts +10 -2
- package/src/ui/snapshot-types.ts +2 -0
- package/src/ui/spinner.ts +17 -17
- package/src/ui/status-colors.ts +58 -58
- package/src/ui/syntax-highlight.ts +116 -116
- package/src/utils/atomic-write.ts +33 -33
- package/src/utils/completion-dedupe.ts +63 -63
- package/src/utils/frontmatter.ts +68 -68
- package/src/utils/git.ts +262 -262
- package/src/utils/ids.ts +12 -12
- package/src/utils/names.ts +27 -27
- package/src/utils/paths.ts +4 -2
- package/src/utils/redaction.ts +44 -44
- package/src/utils/safe-paths.ts +47 -47
- package/src/utils/sleep.ts +32 -32
- package/src/workflows/validate-workflow.ts +40 -40
- package/src/workflows/workflow-config.ts +1 -0
- package/src/worktree/branch-freshness.ts +45 -45
- package/teams/default.team.md +12 -12
- package/teams/fast-fix.team.md +11 -11
- package/teams/implementation.team.md +18 -18
- package/teams/parallel-research.team.md +14 -14
- package/teams/research.team.md +11 -11
- package/teams/review.team.md +12 -12
- package/workflows/default.workflow.md +29 -29
- package/workflows/fast-fix.workflow.md +22 -22
- package/workflows/implementation.workflow.md +38 -38
- package/workflows/parallel-research.workflow.md +46 -46
- package/workflows/research.workflow.md +22 -22
- package/workflows/review.workflow.md +30 -30
package/src/ui/render-diff.ts
CHANGED
|
@@ -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
|
-
|
|
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
|
};
|
package/src/ui/snapshot-types.ts
CHANGED
|
@@ -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
|
+
}
|