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,38 +1,38 @@
1
- import type { TeamConfig, TeamRole } from "./team-config.ts";
2
-
3
- function line(key: string, value: string | string[] | undefined): string | undefined {
4
- if (value === undefined) return undefined;
5
- if (Array.isArray(value)) return `${key}: ${value.join(", ")}`;
6
- return `${key}: ${value}`;
7
- }
8
-
9
- function serializeRole(role: TeamRole): string {
10
- const parts = [`agent=${role.agent}`];
11
- if (role.model) parts.push(`model=${role.model}`);
12
- if (role.skills === false) parts.push("skills=false");
13
- else if (role.skills?.length) parts.push(`skills=${role.skills.join(",")}`);
14
- if (role.maxConcurrency !== undefined) parts.push(`maxConcurrency=${role.maxConcurrency}`);
15
- if (role.description) parts.push(role.description);
16
- return `- ${role.name}: ${parts.join(" ")}`;
17
- }
18
-
19
- export function serializeTeam(team: TeamConfig): string {
20
- const lines = [
21
- "---",
22
- `name: ${team.name}`,
23
- `description: ${team.description}`,
24
- team.defaultWorkflow ? `defaultWorkflow: ${team.defaultWorkflow}` : undefined,
25
- team.workspaceMode ? `workspaceMode: ${team.workspaceMode}` : undefined,
26
- team.maxConcurrency !== undefined ? `maxConcurrency: ${team.maxConcurrency}` : undefined,
27
- line("triggers", team.routing?.triggers),
28
- line("useWhen", team.routing?.useWhen),
29
- line("avoidWhen", team.routing?.avoidWhen),
30
- line("cost", team.routing?.cost),
31
- line("category", team.routing?.category),
32
- "---",
33
- "",
34
- ...team.roles.map(serializeRole),
35
- "",
36
- ].filter((entry): entry is string => entry !== undefined);
37
- return lines.join("\n");
38
- }
1
+ import type { TeamConfig, TeamRole } from "./team-config.ts";
2
+
3
+ function line(key: string, value: string | string[] | undefined): string | undefined {
4
+ if (value === undefined) return undefined;
5
+ if (Array.isArray(value)) return `${key}: ${value.join(", ")}`;
6
+ return `${key}: ${value}`;
7
+ }
8
+
9
+ function serializeRole(role: TeamRole): string {
10
+ const parts = [`agent=${role.agent}`];
11
+ if (role.model) parts.push(`model=${role.model}`);
12
+ if (role.skills === false) parts.push("skills=false");
13
+ else if (role.skills?.length) parts.push(`skills=${role.skills.join(",")}`);
14
+ if (role.maxConcurrency !== undefined) parts.push(`maxConcurrency=${role.maxConcurrency}`);
15
+ if (role.description) parts.push(role.description);
16
+ return `- ${role.name}: ${parts.join(" ")}`;
17
+ }
18
+
19
+ export function serializeTeam(team: TeamConfig): string {
20
+ const lines = [
21
+ "---",
22
+ `name: ${team.name}`,
23
+ `description: ${team.description}`,
24
+ team.defaultWorkflow ? `defaultWorkflow: ${team.defaultWorkflow}` : undefined,
25
+ team.workspaceMode ? `workspaceMode: ${team.workspaceMode}` : undefined,
26
+ team.maxConcurrency !== undefined ? `maxConcurrency: ${team.maxConcurrency}` : undefined,
27
+ line("triggers", team.routing?.triggers),
28
+ line("useWhen", team.routing?.useWhen),
29
+ line("avoidWhen", team.routing?.avoidWhen),
30
+ line("cost", team.routing?.cost),
31
+ line("category", team.routing?.category),
32
+ "---",
33
+ "",
34
+ ...team.roles.map(serializeRole),
35
+ "",
36
+ ].filter((entry): entry is string => entry !== undefined);
37
+ return lines.join("\n");
38
+ }
@@ -1,18 +1,18 @@
1
- declare module "diff" {
2
- export interface Change {
3
- value: string;
4
- count?: number;
5
- added?: boolean;
6
- removed?: boolean;
7
- }
8
-
9
- export interface DiffOptions {
10
- ignoreCase?: boolean;
11
- newlineIsToken?: boolean;
12
- ignoreWhitespace?: boolean;
13
- stripTrailingCr?: boolean;
14
- oneChangePerToken?: boolean;
15
- }
16
-
17
- export function diffWords(oldStr: string, newStr: string, options?: DiffOptions): Change[];
18
- }
1
+ declare module "diff" {
2
+ export interface Change {
3
+ value: string;
4
+ count?: number;
5
+ added?: boolean;
6
+ removed?: boolean;
7
+ }
8
+
9
+ export interface DiffOptions {
10
+ ignoreCase?: boolean;
11
+ newlineIsToken?: boolean;
12
+ ignoreWhitespace?: boolean;
13
+ stripTrailingCr?: boolean;
14
+ oneChangePerToken?: boolean;
15
+ }
16
+
17
+ export function diffWords(oldStr: string, newStr: string, options?: DiffOptions): Change[];
18
+ }
@@ -1,101 +1,101 @@
1
- import type { UsageState } from "../state/types.ts";
2
- import { pad, truncate } from "../utils/visual.ts";
3
- import type { RunStatus } from "./status-colors.ts";
4
- import type { CrewTheme } from "./theme-adapter.ts";
5
-
6
- export interface CrewFooterData {
7
- pwd: string;
8
- branch?: string;
9
- runId?: string;
10
- status?: RunStatus;
11
- usage?: UsageState;
12
- contextWindow?: number;
13
- contextPercent?: number;
14
- badges?: string[];
15
- }
16
-
17
- function formatCount(value: number | undefined): string {
18
- if (value === undefined || !Number.isFinite(value)) return "?";
19
- if (Math.abs(value) >= 1000) return `${(value / 1000).toFixed(Math.abs(value) >= 10_000 ? 0 : 1)}k`;
20
- return `${value}`;
21
- }
22
-
23
- function formatCost(value: number | undefined): string {
24
- return value === undefined || !Number.isFinite(value) ? "$0.0000" : `$${value.toFixed(4)}`;
25
- }
26
-
27
- function displayPwd(pwd: string): string {
28
- const home = process.env.HOME || process.env.USERPROFILE;
29
- if (home && pwd.startsWith(home)) return `~${pwd.slice(home.length) || "/"}`;
30
- return pwd || ".";
31
- }
32
-
33
- function contextText(data: CrewFooterData): string {
34
- const windowText = data.contextWindow && Number.isFinite(data.contextWindow) ? formatCount(data.contextWindow) : "window";
35
- const percent = data.contextPercent;
36
- if (percent === undefined || !Number.isFinite(percent)) return `?/${windowText}`;
37
- return `${percent.toFixed(1)}%/${windowText}`;
38
- }
39
-
40
- export class CrewFooter {
41
- private data: CrewFooterData;
42
- private readonly theme: CrewTheme;
43
- private cacheKey = "";
44
- private cacheWidth = 0;
45
- private cacheLines: string[] = [];
46
-
47
- constructor(data: CrewFooterData, theme: CrewTheme) {
48
- this.data = data;
49
- this.theme = theme;
50
- }
51
-
52
- setData(data: CrewFooterData): void {
53
- this.data = data;
54
- this.invalidate();
55
- }
56
-
57
- invalidate(): void {
58
- this.cacheKey = "";
59
- this.cacheLines = [];
60
- }
61
-
62
- render(width: number): string[] {
63
- const key = JSON.stringify(this.data);
64
- if (this.cacheKey === key && this.cacheWidth === width && this.cacheLines.length) return this.cacheLines;
65
- const lineWidth = Math.max(1, width);
66
- const firstParts = [
67
- displayPwd(this.data.pwd),
68
- this.data.branch ? `(${this.data.branch})` : undefined,
69
- this.data.runId,
70
- this.data.status,
71
- ].filter((part): part is string => Boolean(part));
72
- const usage = this.data.usage;
73
- const context = contextText(this.data);
74
- const contextPercent = this.data.contextPercent;
75
- const contextColor = contextPercent !== undefined && Number.isFinite(contextPercent)
76
- ? contextPercent > 90
77
- ? "error"
78
- : contextPercent > 70
79
- ? "warning"
80
- : undefined
81
- : undefined;
82
- const contextRendered = contextColor ? this.theme.fg(contextColor, context) : context;
83
- const usageLine = [
84
- `↑${formatCount(usage?.input)}`,
85
- `↓${formatCount(usage?.output)}`,
86
- `R ${formatCount(usage?.cacheRead)} cache`,
87
- `W ${formatCount(usage?.cacheWrite)} cache`,
88
- formatCost(usage?.cost),
89
- contextRendered,
90
- ].join(" • ");
91
- const badges = this.data.badges?.length ? this.data.badges.map((badge) => `[${badge}]`).join(" ") : "";
92
- this.cacheLines = [
93
- this.theme.fg("dim", pad(truncate(firstParts.join(" • "), lineWidth, "..."), lineWidth)),
94
- this.theme.fg("dim", pad(truncate(usageLine, lineWidth, "..."), lineWidth)),
95
- this.theme.fg("dim", pad(truncate(badges, lineWidth, "..."), lineWidth)),
96
- ];
97
- this.cacheKey = key;
98
- this.cacheWidth = width;
99
- return this.cacheLines;
100
- }
101
- }
1
+ import type { UsageState } from "../state/types.ts";
2
+ import { pad, truncate } from "../utils/visual.ts";
3
+ import type { RunStatus } from "./status-colors.ts";
4
+ import type { CrewTheme } from "./theme-adapter.ts";
5
+
6
+ export interface CrewFooterData {
7
+ pwd: string;
8
+ branch?: string;
9
+ runId?: string;
10
+ status?: RunStatus;
11
+ usage?: UsageState;
12
+ contextWindow?: number;
13
+ contextPercent?: number;
14
+ badges?: string[];
15
+ }
16
+
17
+ function formatCount(value: number | undefined): string {
18
+ if (value === undefined || !Number.isFinite(value)) return "?";
19
+ if (Math.abs(value) >= 1000) return `${(value / 1000).toFixed(Math.abs(value) >= 10_000 ? 0 : 1)}k`;
20
+ return `${value}`;
21
+ }
22
+
23
+ function formatCost(value: number | undefined): string {
24
+ return value === undefined || !Number.isFinite(value) ? "$0.0000" : `$${value.toFixed(4)}`;
25
+ }
26
+
27
+ function displayPwd(pwd: string): string {
28
+ const home = process.env.HOME || process.env.USERPROFILE;
29
+ if (home && pwd.startsWith(home)) return `~${pwd.slice(home.length) || "/"}`;
30
+ return pwd || ".";
31
+ }
32
+
33
+ function contextText(data: CrewFooterData): string {
34
+ const windowText = data.contextWindow && Number.isFinite(data.contextWindow) ? formatCount(data.contextWindow) : "window";
35
+ const percent = data.contextPercent;
36
+ if (percent === undefined || !Number.isFinite(percent)) return `?/${windowText}`;
37
+ return `${percent.toFixed(1)}%/${windowText}`;
38
+ }
39
+
40
+ export class CrewFooter {
41
+ private data: CrewFooterData;
42
+ private readonly theme: CrewTheme;
43
+ private cacheKey = "";
44
+ private cacheWidth = 0;
45
+ private cacheLines: string[] = [];
46
+
47
+ constructor(data: CrewFooterData, theme: CrewTheme) {
48
+ this.data = data;
49
+ this.theme = theme;
50
+ }
51
+
52
+ setData(data: CrewFooterData): void {
53
+ this.data = data;
54
+ this.invalidate();
55
+ }
56
+
57
+ invalidate(): void {
58
+ this.cacheKey = "";
59
+ this.cacheLines = [];
60
+ }
61
+
62
+ render(width: number): string[] {
63
+ const key = JSON.stringify(this.data);
64
+ if (this.cacheKey === key && this.cacheWidth === width && this.cacheLines.length) return this.cacheLines;
65
+ const lineWidth = Math.max(1, width);
66
+ const firstParts = [
67
+ displayPwd(this.data.pwd),
68
+ this.data.branch ? `(${this.data.branch})` : undefined,
69
+ this.data.runId,
70
+ this.data.status,
71
+ ].filter((part): part is string => Boolean(part));
72
+ const usage = this.data.usage;
73
+ const context = contextText(this.data);
74
+ const contextPercent = this.data.contextPercent;
75
+ const contextColor = contextPercent !== undefined && Number.isFinite(contextPercent)
76
+ ? contextPercent > 90
77
+ ? "error"
78
+ : contextPercent > 70
79
+ ? "warning"
80
+ : undefined
81
+ : undefined;
82
+ const contextRendered = contextColor ? this.theme.fg(contextColor, context) : context;
83
+ const usageLine = [
84
+ `↑${formatCount(usage?.input)}`,
85
+ `↓${formatCount(usage?.output)}`,
86
+ `R ${formatCount(usage?.cacheRead)} cache`,
87
+ `W ${formatCount(usage?.cacheWrite)} cache`,
88
+ formatCost(usage?.cost),
89
+ contextRendered,
90
+ ].join(" • ");
91
+ const badges = this.data.badges?.length ? this.data.badges.map((badge) => `[${badge}]`).join(" ") : "";
92
+ this.cacheLines = [
93
+ this.theme.fg("dim", pad(truncate(firstParts.join(" • "), lineWidth, "..."), lineWidth)),
94
+ this.theme.fg("dim", pad(truncate(usageLine, lineWidth, "..."), lineWidth)),
95
+ this.theme.fg("dim", pad(truncate(badges, lineWidth, "..."), lineWidth)),
96
+ ];
97
+ this.cacheKey = key;
98
+ this.cacheWidth = width;
99
+ return this.cacheLines;
100
+ }
101
+ }
@@ -1,111 +1,111 @@
1
- import { pad, truncate } from "../utils/visual.ts";
2
- import type { CrewTheme } from "./theme-adapter.ts";
3
-
4
- export interface CrewSelectItem<T = string> {
5
- value: T;
6
- label: string;
7
- description?: string;
8
- }
9
-
10
- export interface CrewSelectListOptions<T = string> {
11
- onSelect: (item: CrewSelectItem<T>) => void;
12
- onCancel: () => void;
13
- onPreview?: (item: CrewSelectItem<T>) => void;
14
- maxHeight?: number;
15
- }
16
-
17
- export class CrewSelectList<T = string> {
18
- private readonly items: CrewSelectItem<T>[];
19
- private readonly theme: CrewTheme;
20
- private readonly options: CrewSelectListOptions<T>;
21
- private selectedIndex = 0;
22
- private scrollOffset = 0;
23
-
24
- constructor(items: CrewSelectItem<T>[], theme: CrewTheme, options: CrewSelectListOptions<T>) {
25
- this.items = [...items];
26
- this.theme = theme;
27
- this.options = options;
28
- this.selectedIndex = this.items.length ? 0 : -1;
29
- }
30
-
31
- invalidate(): void {}
32
-
33
- getSelected(): CrewSelectItem<T> | undefined {
34
- return this.selectedIndex >= 0 ? this.items[this.selectedIndex] : undefined;
35
- }
36
-
37
- setSelectedIndex(index: number): void {
38
- if (!this.items.length) {
39
- this.selectedIndex = -1;
40
- this.scrollOffset = 0;
41
- return;
42
- }
43
- const next = Math.min(this.items.length - 1, Math.max(0, index));
44
- const changed = next !== this.selectedIndex;
45
- this.selectedIndex = next;
46
- this.ensureVisible();
47
- if (changed) {
48
- const selected = this.getSelected();
49
- if (selected) this.options.onPreview?.(selected);
50
- }
51
- }
52
-
53
- handleInput(data: string): void {
54
- if (data === "q" || data === "\u001b") {
55
- this.options.onCancel();
56
- return;
57
- }
58
- if (data === "j" || data === "\u001b[B") {
59
- this.setSelectedIndex(this.selectedIndex + 1);
60
- return;
61
- }
62
- if (data === "k" || data === "\u001b[A") {
63
- this.setSelectedIndex(this.selectedIndex - 1);
64
- return;
65
- }
66
- if (data === "\r" || data === "\n") {
67
- const selected = this.getSelected();
68
- if (selected) this.options.onSelect(selected);
69
- }
70
- }
71
-
72
- render(width: number): string[] {
73
- if (!this.items.length) return [this.theme.fg("muted", "(no items)")];
74
- const maxHeight = Math.max(1, Math.floor(this.options.maxHeight ?? this.items.length));
75
- this.ensureVisible();
76
- const hasTop = this.scrollOffset > 0;
77
- const availableWithoutBottom = Math.max(1, maxHeight - (hasTop ? 1 : 0));
78
- const hasBottom = this.scrollOffset + availableWithoutBottom < this.items.length;
79
- const slots = this.visibleItemSlots(maxHeight, hasTop, hasBottom);
80
- const visibleItems = this.items.slice(this.scrollOffset, this.scrollOffset + slots);
81
- const lines: string[] = [];
82
- if (hasTop) lines.push(this.theme.fg("muted", `↑ ${this.scrollOffset} more`));
83
- for (const [offset, item] of visibleItems.entries()) {
84
- const index = this.scrollOffset + offset;
85
- const prefix = index === this.selectedIndex ? " → " : " ";
86
- const suffix = item.description ? this.theme.fg("dim", ` — ${item.description}`) : "";
87
- const raw = `${prefix}${item.label}${suffix}`;
88
- const line = index === this.selectedIndex ? this.theme.inverse?.(raw) ?? raw : raw;
89
- lines.push(pad(truncate(line, width, "..."), Math.max(1, width)));
90
- }
91
- if (hasBottom) lines.push(this.theme.fg("muted", `↓ ${this.items.length - (this.scrollOffset + slots)} more`));
92
- return lines.slice(0, maxHeight);
93
- }
94
-
95
- private visibleItemSlots(maxHeight: number, hasTop: boolean, hasBottom: boolean): number {
96
- return Math.max(1, maxHeight - (hasTop ? 1 : 0) - (hasBottom ? 1 : 0));
97
- }
98
-
99
- private ensureVisible(): void {
100
- if (this.selectedIndex < 0) return;
101
- const maxHeight = Math.max(1, Math.floor(this.options.maxHeight ?? this.items.length));
102
- const reservedTop = this.scrollOffset > 0 ? 1 : 0;
103
- const visibleSlots = Math.max(1, maxHeight - reservedTop - 1);
104
- if (this.selectedIndex < this.scrollOffset) {
105
- this.scrollOffset = this.selectedIndex;
106
- } else if (this.selectedIndex >= this.scrollOffset + visibleSlots) {
107
- this.scrollOffset = Math.max(0, this.selectedIndex - visibleSlots + 1);
108
- }
109
- this.scrollOffset = Math.min(this.scrollOffset, Math.max(0, this.items.length - 1));
110
- }
111
- }
1
+ import { pad, truncate } from "../utils/visual.ts";
2
+ import type { CrewTheme } from "./theme-adapter.ts";
3
+
4
+ export interface CrewSelectItem<T = string> {
5
+ value: T;
6
+ label: string;
7
+ description?: string;
8
+ }
9
+
10
+ export interface CrewSelectListOptions<T = string> {
11
+ onSelect: (item: CrewSelectItem<T>) => void;
12
+ onCancel: () => void;
13
+ onPreview?: (item: CrewSelectItem<T>) => void;
14
+ maxHeight?: number;
15
+ }
16
+
17
+ export class CrewSelectList<T = string> {
18
+ private readonly items: CrewSelectItem<T>[];
19
+ private readonly theme: CrewTheme;
20
+ private readonly options: CrewSelectListOptions<T>;
21
+ private selectedIndex = 0;
22
+ private scrollOffset = 0;
23
+
24
+ constructor(items: CrewSelectItem<T>[], theme: CrewTheme, options: CrewSelectListOptions<T>) {
25
+ this.items = [...items];
26
+ this.theme = theme;
27
+ this.options = options;
28
+ this.selectedIndex = this.items.length ? 0 : -1;
29
+ }
30
+
31
+ invalidate(): void {}
32
+
33
+ getSelected(): CrewSelectItem<T> | undefined {
34
+ return this.selectedIndex >= 0 ? this.items[this.selectedIndex] : undefined;
35
+ }
36
+
37
+ setSelectedIndex(index: number): void {
38
+ if (!this.items.length) {
39
+ this.selectedIndex = -1;
40
+ this.scrollOffset = 0;
41
+ return;
42
+ }
43
+ const next = Math.min(this.items.length - 1, Math.max(0, index));
44
+ const changed = next !== this.selectedIndex;
45
+ this.selectedIndex = next;
46
+ this.ensureVisible();
47
+ if (changed) {
48
+ const selected = this.getSelected();
49
+ if (selected) this.options.onPreview?.(selected);
50
+ }
51
+ }
52
+
53
+ handleInput(data: string): void {
54
+ if (data === "q" || data === "\u001b") {
55
+ this.options.onCancel();
56
+ return;
57
+ }
58
+ if (data === "j" || data === "\u001b[B") {
59
+ this.setSelectedIndex(this.selectedIndex + 1);
60
+ return;
61
+ }
62
+ if (data === "k" || data === "\u001b[A") {
63
+ this.setSelectedIndex(this.selectedIndex - 1);
64
+ return;
65
+ }
66
+ if (data === "\r" || data === "\n") {
67
+ const selected = this.getSelected();
68
+ if (selected) this.options.onSelect(selected);
69
+ }
70
+ }
71
+
72
+ render(width: number): string[] {
73
+ if (!this.items.length) return [this.theme.fg("muted", "(no items)")];
74
+ const maxHeight = Math.max(1, Math.floor(this.options.maxHeight ?? this.items.length));
75
+ this.ensureVisible();
76
+ const hasTop = this.scrollOffset > 0;
77
+ const availableWithoutBottom = Math.max(1, maxHeight - (hasTop ? 1 : 0));
78
+ const hasBottom = this.scrollOffset + availableWithoutBottom < this.items.length;
79
+ const slots = this.visibleItemSlots(maxHeight, hasTop, hasBottom);
80
+ const visibleItems = this.items.slice(this.scrollOffset, this.scrollOffset + slots);
81
+ const lines: string[] = [];
82
+ if (hasTop) lines.push(this.theme.fg("muted", `↑ ${this.scrollOffset} more`));
83
+ for (const [offset, item] of visibleItems.entries()) {
84
+ const index = this.scrollOffset + offset;
85
+ const prefix = index === this.selectedIndex ? " → " : " ";
86
+ const suffix = item.description ? this.theme.fg("dim", ` — ${item.description}`) : "";
87
+ const raw = `${prefix}${item.label}${suffix}`;
88
+ const line = index === this.selectedIndex ? this.theme.inverse?.(raw) ?? raw : raw;
89
+ lines.push(pad(truncate(line, width, "..."), Math.max(1, width)));
90
+ }
91
+ if (hasBottom) lines.push(this.theme.fg("muted", `↓ ${this.items.length - (this.scrollOffset + slots)} more`));
92
+ return lines.slice(0, maxHeight);
93
+ }
94
+
95
+ private visibleItemSlots(maxHeight: number, hasTop: boolean, hasBottom: boolean): number {
96
+ return Math.max(1, maxHeight - (hasTop ? 1 : 0) - (hasBottom ? 1 : 0));
97
+ }
98
+
99
+ private ensureVisible(): void {
100
+ if (this.selectedIndex < 0) return;
101
+ const maxHeight = Math.max(1, Math.floor(this.options.maxHeight ?? this.items.length));
102
+ const reservedTop = this.scrollOffset > 0 ? 1 : 0;
103
+ const visibleSlots = Math.max(1, maxHeight - reservedTop - 1);
104
+ if (this.selectedIndex < this.scrollOffset) {
105
+ this.scrollOffset = this.selectedIndex;
106
+ } else if (this.selectedIndex >= this.scrollOffset + visibleSlots) {
107
+ this.scrollOffset = Math.max(0, this.selectedIndex - visibleSlots + 1);
108
+ }
109
+ this.scrollOffset = Math.min(this.scrollOffset, Math.max(0, this.items.length - 1));
110
+ }
111
+ }
@@ -13,6 +13,7 @@ import { asCrewTheme, subscribeThemeChange } from "./theme-adapter.ts";
13
13
  import { Box, Text } from "./layout-primitives.ts";
14
14
  import { requestRender, setExtensionWidget } from "./pi-ui-compat.ts";
15
15
  import type { RunSnapshotCache, RunUiSnapshot } from "./snapshot-types.ts";
16
+ import { DEFAULT_UI } from "../config/defaults.ts";
16
17
 
17
18
  const SPINNER = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
18
19
  const TOOL_LABELS: Record<string, string> = {
@@ -28,7 +29,7 @@ const LEGACY_WIDGET_KEY = "pi-crew";
28
29
  const WIDGET_KEY = "pi-crew-active";
29
30
  const STATUS_KEY = "pi-crew";
30
31
 
31
- const MAX_LINES_DEFAULT = 10;
32
+ const MAX_LINES_DEFAULT = DEFAULT_UI.widgetMaxLines;
32
33
  const MAX_AGENTS_DISPLAY = 3;
33
34
 
34
35
  type WidgetComponent = { render(width: number): string[]; invalidate(): void };
@@ -290,7 +291,7 @@ export function updateCrewWidget(
290
291
  const maxLines = config?.widgetMaxLines ?? MAX_LINES_DEFAULT;
291
292
  const runs = activeWidgetRuns(ctx.cwd, manifestCache, snapshotCache, preloadedManifests);
292
293
  const lines = buildCrewWidgetLines(ctx.cwd, state.frame, maxLines, runs, state.notificationCount ?? 0);
293
- const placement = config?.widgetPlacement ?? "aboveEditor";
294
+ const placement = config?.widgetPlacement ?? DEFAULT_UI.widgetPlacement;
294
295
  ctx.ui.setStatus(STATUS_KEY, lines.length ? statusSummary(runs) : undefined);
295
296
  const shouldClearLegacy = state.legacyCleared !== true || state.lastPlacement !== placement;
296
297
  if (shouldClearLegacy) {
@@ -341,7 +342,7 @@ export function stopCrewWidget(ctx: Pick<ExtensionContext, "hasUI" | "ui"> | und
341
342
  if (state.interval) clearInterval(state.interval);
342
343
  state.interval = undefined;
343
344
  if (ctx?.hasUI) {
344
- const placement = config?.widgetPlacement ?? "aboveEditor";
345
+ const placement = config?.widgetPlacement ?? DEFAULT_UI.widgetPlacement;
345
346
  ctx.ui.setStatus(STATUS_KEY, undefined);
346
347
  setExtensionWidget(ctx, LEGACY_WIDGET_KEY, undefined, { placement });
347
348
  setExtensionWidget(ctx, WIDGET_KEY, undefined, { placement });
@@ -1,34 +1,34 @@
1
- import type { MetricRegistry } from "../../observability/metric-registry.ts";
2
- import type { HistogramPoint, MetricLabels, MetricPoint } from "../../observability/metrics-primitives.ts";
3
- import type { RunUiSnapshot } from "../snapshot-types.ts";
4
-
5
- export interface MetricsPaneOptions {
6
- registry?: MetricRegistry;
7
- maxCounters?: number;
8
- }
9
-
10
- function labelsText(labels: MetricLabels): string {
11
- const entries = Object.entries(labels);
12
- return entries.length ? `{${entries.map(([key, value]) => `${key}=${value}`).join(",")}}` : "";
13
- }
14
-
15
- function isHistogramPoint(point: MetricPoint | HistogramPoint): point is HistogramPoint {
16
- return "quantiles" in point;
17
- }
18
-
19
- export function renderMetricsPane(_snapshot: RunUiSnapshot | undefined, opts: MetricsPaneOptions = {}): string[] {
20
- if (!opts.registry) return ["Metrics pane: registry unavailable"];
21
- const snapshots = opts.registry.snapshot();
22
- if (!snapshots.length) return ["Metrics pane: no metrics recorded"];
23
- const lines = ["Metrics pane: top metrics"];
24
- for (const snapshot of snapshots.slice(0, opts.maxCounters ?? 10)) {
25
- const first = snapshot.values[0];
26
- if (!first) {
27
- lines.push(`${snapshot.name}: empty`);
28
- continue;
29
- }
30
- if (isHistogramPoint(first)) lines.push(`${snapshot.name}${labelsText(first.labels)} count=${first.count} p95=${Number.isFinite(first.quantiles.p95) ? Math.round(first.quantiles.p95) : "n/a"}`);
31
- else lines.push(`${snapshot.name}${labelsText(first.labels)} ${first.value}`);
32
- }
33
- return lines;
34
- }
1
+ import type { MetricRegistry } from "../../observability/metric-registry.ts";
2
+ import type { HistogramPoint, MetricLabels, MetricPoint } from "../../observability/metrics-primitives.ts";
3
+ import type { RunUiSnapshot } from "../snapshot-types.ts";
4
+
5
+ export interface MetricsPaneOptions {
6
+ registry?: MetricRegistry;
7
+ maxCounters?: number;
8
+ }
9
+
10
+ function labelsText(labels: MetricLabels): string {
11
+ const entries = Object.entries(labels);
12
+ return entries.length ? `{${entries.map(([key, value]) => `${key}=${value}`).join(",")}}` : "";
13
+ }
14
+
15
+ function isHistogramPoint(point: MetricPoint | HistogramPoint): point is HistogramPoint {
16
+ return "quantiles" in point;
17
+ }
18
+
19
+ export function renderMetricsPane(_snapshot: RunUiSnapshot | undefined, opts: MetricsPaneOptions = {}): string[] {
20
+ if (!opts.registry) return ["Metrics pane: registry unavailable"];
21
+ const snapshots = opts.registry.snapshot();
22
+ if (!snapshots.length) return ["Metrics pane: no metrics recorded"];
23
+ const lines = ["Metrics pane: top metrics"];
24
+ for (const snapshot of snapshots.slice(0, opts.maxCounters ?? 10)) {
25
+ const first = snapshot.values[0];
26
+ if (!first) {
27
+ lines.push(`${snapshot.name}: empty`);
28
+ continue;
29
+ }
30
+ if (isHistogramPoint(first)) lines.push(`${snapshot.name}${labelsText(first.labels)} count=${first.count} p95=${Number.isFinite(first.quantiles.p95) ? Math.round(first.quantiles.p95) : "n/a"}`);
31
+ else lines.push(`${snapshot.name}${labelsText(first.labels)} ${first.value}`);
32
+ }
33
+ return lines;
34
+ }
@@ -5,8 +5,10 @@ export function renderProgressPane(snapshot: RunUiSnapshot | undefined): string[
5
5
  const progress = snapshot.progress;
6
6
  const groupJoins = snapshot.groupJoins ?? [];
7
7
  const groupJoinLines = groupJoins.length ? groupJoins.map((item) => `group join ${item.partial ? "partial" : "completed"}: ${item.requestId} ack=${item.ack}`) : ["group joins: none"];
8
+ const cancellationLine = snapshot.cancellationReason ? [`cancelled: reason=${snapshot.cancellationReason}`] : [];
8
9
  return [
9
10
  `Progress pane: ${progress.completed}/${progress.total} completed · running=${progress.running} queued=${progress.queued} failed=${progress.failed}`,
11
+ ...cancellationLine,
10
12
  ...groupJoinLines,
11
13
  ...snapshot.recentEvents.slice(-10).map((event) => {
12
14
  const seq = event.metadata?.seq !== undefined ? `#${event.metadata.seq}` : "#?";