pi-crew 0.1.51 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (239) hide show
  1. package/CHANGELOG.md +56 -1
  2. package/README.md +176 -781
  3. package/agents/analyst.md +11 -11
  4. package/agents/critic.md +11 -11
  5. package/agents/executor.md +11 -11
  6. package/agents/explorer.md +11 -11
  7. package/agents/planner.md +11 -11
  8. package/agents/reviewer.md +11 -11
  9. package/agents/security-reviewer.md +11 -11
  10. package/agents/test-engineer.md +11 -11
  11. package/agents/verifier.md +70 -11
  12. package/agents/writer.md +11 -11
  13. package/docs/actions-reference.md +595 -0
  14. package/docs/commands-reference.md +347 -0
  15. package/docs/runtime-flow.md +148 -148
  16. package/index.ts +6 -6
  17. package/package.json +99 -99
  18. package/skills/async-worker-recovery/SKILL.md +42 -42
  19. package/skills/context-artifact-hygiene/SKILL.md +52 -52
  20. package/skills/delegation-patterns/SKILL.md +54 -54
  21. package/skills/mailbox-interactive/SKILL.md +40 -40
  22. package/skills/model-routing-context/SKILL.md +39 -39
  23. package/skills/multi-perspective-review/SKILL.md +58 -58
  24. package/skills/observability-reliability/SKILL.md +41 -41
  25. package/skills/orchestration/SKILL.md +157 -157
  26. package/skills/ownership-session-security/SKILL.md +41 -41
  27. package/skills/pi-extension-lifecycle/SKILL.md +39 -39
  28. package/skills/requirements-to-task-packet/SKILL.md +63 -63
  29. package/skills/resource-discovery-config/SKILL.md +41 -41
  30. package/skills/runtime-state-reader/SKILL.md +44 -44
  31. package/skills/secure-agent-orchestration-review/SKILL.md +45 -45
  32. package/skills/state-mutation-locking/SKILL.md +42 -42
  33. package/skills/systematic-debugging/SKILL.md +67 -67
  34. package/skills/ui-render-performance/SKILL.md +39 -39
  35. package/skills/verification-before-done/SKILL.md +57 -57
  36. package/skills/worktree-isolation/SKILL.md +39 -39
  37. package/src/adapters/claude-adapter.ts +25 -0
  38. package/src/adapters/codex-adapter.ts +21 -0
  39. package/src/adapters/cursor-adapter.ts +17 -0
  40. package/src/adapters/export-util.ts +137 -0
  41. package/src/adapters/index.ts +15 -0
  42. package/src/adapters/registry.ts +18 -0
  43. package/src/adapters/types.ts +23 -0
  44. package/src/agents/agent-config.ts +2 -0
  45. package/src/agents/agent-search.ts +98 -98
  46. package/src/agents/discover-agents.ts +2 -1
  47. package/src/config/config.ts +13 -1
  48. package/src/config/drift-detector.ts +211 -0
  49. package/src/config/markers.ts +327 -0
  50. package/src/config/resilient-parser.ts +108 -0
  51. package/src/config/suggestions.ts +74 -0
  52. package/src/extension/cross-extension-rpc.ts +103 -94
  53. package/src/extension/project-init.ts +21 -1
  54. package/src/extension/register.ts +45 -14
  55. package/src/extension/registration/commands.ts +77 -8
  56. package/src/extension/registration/subagent-tools.ts +10 -1
  57. package/src/extension/registration/team-tool.ts +10 -1
  58. package/src/extension/registration/viewers.ts +48 -34
  59. package/src/extension/run-bundle-schema.ts +89 -89
  60. package/src/extension/run-import.ts +25 -1
  61. package/src/extension/run-index.ts +5 -1
  62. package/src/extension/run-maintenance.ts +142 -68
  63. package/src/extension/team-manager-command.ts +10 -1
  64. package/src/extension/team-tool/doctor.ts +28 -3
  65. package/src/extension/team-tool/handle-settings.ts +195 -188
  66. package/src/extension/team-tool/inspect.ts +41 -41
  67. package/src/extension/team-tool/intent-policy.ts +42 -42
  68. package/src/extension/team-tool/lifecycle-actions.ts +27 -8
  69. package/src/extension/team-tool/plan.ts +19 -19
  70. package/src/extension/team-tool/run.ts +12 -1
  71. package/src/extension/team-tool.ts +11 -1
  72. package/src/i18n.ts +184 -184
  73. package/src/observability/exporters/otlp-exporter.ts +92 -77
  74. package/src/prompt/prompt-runtime.ts +72 -72
  75. package/src/runtime/agent-memory.ts +72 -72
  76. package/src/runtime/agent-observability.ts +114 -114
  77. package/src/runtime/async-marker.ts +26 -26
  78. package/src/runtime/attention-events.ts +28 -28
  79. package/src/runtime/auto-resume.ts +100 -0
  80. package/src/runtime/background-runner.ts +11 -1
  81. package/src/runtime/cancellation-token.ts +89 -89
  82. package/src/runtime/cancellation.ts +61 -61
  83. package/src/runtime/capability-inventory.ts +116 -116
  84. package/src/runtime/child-pi.ts +7 -2
  85. package/src/runtime/compaction-summary.ts +271 -0
  86. package/src/runtime/completion-guard.ts +190 -190
  87. package/src/runtime/crash-recovery.ts +33 -0
  88. package/src/runtime/delta-conflict.ts +360 -0
  89. package/src/runtime/direct-run.ts +35 -35
  90. package/src/runtime/foreground-control.ts +82 -82
  91. package/src/runtime/green-contract.ts +46 -46
  92. package/src/runtime/group-join.ts +106 -106
  93. package/src/runtime/heartbeat-gradient.ts +28 -28
  94. package/src/runtime/heartbeat-watcher.ts +124 -124
  95. package/src/runtime/iteration-hooks.ts +262 -0
  96. package/src/runtime/live-agent-control.ts +88 -88
  97. package/src/runtime/live-control-realtime.ts +36 -36
  98. package/src/runtime/live-extension-bridge.ts +150 -150
  99. package/src/runtime/live-irc.ts +92 -92
  100. package/src/runtime/live-session-health.ts +100 -100
  101. package/src/runtime/loop-gates.ts +129 -0
  102. package/src/runtime/metric-parser.ts +40 -0
  103. package/src/runtime/notebook-helpers.ts +90 -90
  104. package/src/runtime/orphan-sentinel.ts +7 -7
  105. package/src/runtime/parallel-research.ts +44 -44
  106. package/src/runtime/phase-progress.ts +217 -0
  107. package/src/runtime/pi-args.ts +38 -11
  108. package/src/runtime/pi-json-output.ts +111 -111
  109. package/src/runtime/pi-spawn.ts +57 -7
  110. package/src/runtime/policy-engine.ts +79 -79
  111. package/src/runtime/post-checks.ts +122 -0
  112. package/src/runtime/progress-event-coalescer.ts +43 -43
  113. package/src/runtime/prose-compressor.ts +164 -164
  114. package/src/runtime/recovery-recipes.ts +74 -74
  115. package/src/runtime/result-extractor.ts +121 -121
  116. package/src/runtime/role-permission.ts +39 -39
  117. package/src/runtime/sensitive-paths.ts +2 -2
  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/stream-preview.ts +177 -177
  123. package/src/runtime/supervisor-contact.ts +59 -59
  124. package/src/runtime/task-display.ts +38 -38
  125. package/src/runtime/task-graph.ts +207 -0
  126. package/src/runtime/task-quality.ts +207 -0
  127. package/src/runtime/task-runner/capabilities.ts +78 -78
  128. package/src/runtime/task-runner/live-executor.ts +7 -1
  129. package/src/runtime/task-runner/progress.ts +119 -119
  130. package/src/runtime/task-runner/prompt-pipeline.ts +64 -64
  131. package/src/runtime/task-runner/result-utils.ts +14 -14
  132. package/src/runtime/task-runner/run-projection.ts +103 -103
  133. package/src/runtime/task-runner/state-helpers.ts +22 -22
  134. package/src/runtime/team-runner.ts +117 -7
  135. package/src/runtime/worker-heartbeat.ts +21 -21
  136. package/src/runtime/worker-startup.ts +57 -57
  137. package/src/runtime/workflow-state.ts +187 -0
  138. package/src/runtime/workspace-tree.ts +298 -298
  139. package/src/schema/config-schema.ts +11 -0
  140. package/src/schema/validation-types.ts +148 -0
  141. package/src/skills/skill-templates.ts +374 -0
  142. package/src/state/active-run-registry.ts +35 -11
  143. package/src/state/atomic-write.ts +33 -26
  144. package/src/state/contracts.ts +1 -0
  145. package/src/state/event-reconstructor.ts +217 -0
  146. package/src/state/locks.ts +2 -13
  147. package/src/state/mailbox.ts +4 -3
  148. package/src/state/state-store.ts +32 -14
  149. package/src/state/task-claims.ts +44 -44
  150. package/src/state/types.ts +9 -0
  151. package/src/state/usage.ts +29 -29
  152. package/src/subagents/async-entry.ts +1 -1
  153. package/src/subagents/index.ts +3 -3
  154. package/src/subagents/live/control.ts +1 -1
  155. package/src/subagents/live/manager.ts +1 -1
  156. package/src/subagents/live/realtime.ts +1 -1
  157. package/src/subagents/live/session-runtime.ts +1 -1
  158. package/src/subagents/manager.ts +1 -1
  159. package/src/subagents/spawn.ts +1 -1
  160. package/src/teams/team-serializer.ts +38 -38
  161. package/src/types/diff.d.ts +18 -18
  162. package/src/ui/crew-footer.ts +101 -101
  163. package/src/ui/crew-select-list.ts +111 -111
  164. package/src/ui/crew-widget.ts +5 -2
  165. package/src/ui/dashboard-panes/cancellation-pane.ts +42 -42
  166. package/src/ui/dashboard-panes/capability-pane.ts +59 -59
  167. package/src/ui/dashboard-panes/mailbox-pane.ts +35 -35
  168. package/src/ui/dashboard-panes/metrics-pane.ts +34 -34
  169. package/src/ui/dashboard-panes/progress-pane.ts +11 -0
  170. package/src/ui/dynamic-border.ts +25 -25
  171. package/src/ui/layout-primitives.ts +106 -106
  172. package/src/ui/loaders.ts +158 -158
  173. package/src/ui/render-coalescer.ts +51 -51
  174. package/src/ui/render-diff.ts +119 -119
  175. package/src/ui/render-scheduler.ts +143 -143
  176. package/src/ui/run-action-dispatcher.ts +10 -1
  177. package/src/ui/spinner.ts +17 -17
  178. package/src/ui/status-colors.ts +58 -58
  179. package/src/ui/syntax-highlight.ts +116 -116
  180. package/src/ui/transcript-entries.ts +258 -258
  181. package/src/utils/completion-dedupe.ts +63 -63
  182. package/src/utils/frontmatter.ts +68 -68
  183. package/src/utils/git.ts +262 -262
  184. package/src/utils/ids.ts +17 -17
  185. package/src/utils/incremental-reader.ts +104 -104
  186. package/src/utils/names.ts +27 -27
  187. package/src/utils/redaction.ts +44 -44
  188. package/src/utils/safe-paths.ts +47 -47
  189. package/src/utils/scan-cache.ts +136 -136
  190. package/src/utils/sleep.ts +40 -26
  191. package/src/utils/task-name-generator.ts +337 -337
  192. package/src/workflows/validate-workflow.ts +40 -40
  193. package/src/worktree/branch-freshness.ts +45 -45
  194. package/teams/default.team.md +12 -12
  195. package/teams/fast-fix.team.md +11 -11
  196. package/teams/implementation.team.md +18 -18
  197. package/teams/parallel-research.team.md +14 -14
  198. package/teams/research.team.md +11 -11
  199. package/teams/review.team.md +12 -12
  200. package/workflows/default.workflow.md +30 -29
  201. package/workflows/fast-fix.workflow.md +23 -22
  202. package/workflows/implementation.workflow.md +43 -43
  203. package/workflows/parallel-research.workflow.md +46 -46
  204. package/workflows/research.workflow.md +22 -22
  205. package/workflows/review.workflow.md +30 -30
  206. package/docs/refactor-tasks-phase3.md +0 -394
  207. package/docs/refactor-tasks-phase4.md +0 -564
  208. package/docs/refactor-tasks-phase5.md +0 -402
  209. package/docs/refactor-tasks-phase6.md +0 -662
  210. package/docs/refactor-tasks.md +0 -1484
  211. package/docs/research/AGENT-EXECUTION-ARCHITECTURE.md +0 -261
  212. package/docs/research/AGENT-LIFECYCLE-COMPARISON.md +0 -111
  213. package/docs/research/AUDIT_OH_MY_PI.md +0 -261
  214. package/docs/research/AUDIT_PI_CREW.md +0 -457
  215. package/docs/research/CAVEMAN-DEEP-RESEARCH.md +0 -281
  216. package/docs/research/COMPARISON_OH_MY_PI_VS_PI_CREW.md +0 -264
  217. package/docs/research/DEEP-RESEARCH-PI-POWERBAR.md +0 -343
  218. package/docs/research/DEEP_RESEARCH_SUBAGENT_ARCHITECTURE.md +0 -480
  219. package/docs/research/GAP_CLOSURE_IMPLEMENTATION_PLAN.md +0 -354
  220. package/docs/research/IMPLEMENTATION_PLAN.md +0 -385
  221. package/docs/research/LIVE-SESSION-PRODUCTION-READY-PLAN.md +0 -502
  222. package/docs/research/OH-MY-PI-DEEP-RESEARCH-v14.7.6.md +0 -266
  223. package/docs/research/REMAINING-GAPS-PLAN.md +0 -363
  224. package/docs/research/SESSION-SUMMARY-2026-05-08.md +0 -146
  225. package/docs/research/UI-RESPONSIVENESS-AUDIT.md +0 -173
  226. package/docs/research-awesome-agent-skills-distillation.md +0 -100
  227. package/docs/research-extension-examples.md +0 -297
  228. package/docs/research-extension-system.md +0 -324
  229. package/docs/research-oh-my-pi-distillation.md +0 -369
  230. package/docs/research-optimization-plan.md +0 -548
  231. package/docs/research-phase10-distillation.md +0 -199
  232. package/docs/research-phase11-distillation.md +0 -201
  233. package/docs/research-phase8-operator-experience-plan.md +0 -819
  234. package/docs/research-phase9-observability-reliability-plan.md +0 -1190
  235. package/docs/research-pi-coding-agent.md +0 -357
  236. package/docs/research-source-pi-crew-reference.md +0 -174
  237. package/docs/research-ui-optimization-plan.md +0 -480
  238. package/docs/source-runtime-refactor-map.md +0 -107
  239. package/src/utils/atomic-write.ts +0 -33
@@ -1,78 +1,78 @@
1
- import type { AgentConfig } from "../../agents/agent-config.ts";
2
- import type { CrewRuntimeKind } from "../crew-agent-runtime.ts";
3
-
4
- export interface WorkerCapabilityInventory {
5
- schemaVersion: 1;
6
- taskId: string;
7
- role: string;
8
- agent: string;
9
- runtime: CrewRuntimeKind;
10
- permissionMode: string;
11
- tools: string[];
12
- extensions: string[];
13
- skills: {
14
- names: string[];
15
- paths: string[];
16
- disabled: boolean;
17
- };
18
- model: {
19
- requested?: string;
20
- agentDefault?: string;
21
- fallbacks: string[];
22
- teamRole?: string;
23
- step?: string;
24
- };
25
- inheritance: {
26
- projectContext: boolean;
27
- skills: boolean;
28
- systemPromptMode: "replace" | "append";
29
- };
30
- }
31
-
32
- export interface BuildWorkerCapabilityInventoryInput {
33
- taskId: string;
34
- role: string;
35
- agent: AgentConfig;
36
- runtime: CrewRuntimeKind;
37
- permissionMode: string;
38
- skillNames?: string[];
39
- skillPaths?: string[];
40
- skillsDisabled: boolean;
41
- modelOverride?: string;
42
- teamRoleModel?: string;
43
- stepModel?: string;
44
- }
45
-
46
- function uniqueSorted(values: readonly string[] | undefined): string[] {
47
- return [...new Set((values ?? []).map((value) => value.trim()).filter(Boolean))].sort((a, b) => a.localeCompare(b));
48
- }
49
-
50
- export function buildWorkerCapabilityInventory(input: BuildWorkerCapabilityInventoryInput): WorkerCapabilityInventory {
51
- return {
52
- schemaVersion: 1,
53
- taskId: input.taskId,
54
- role: input.role,
55
- agent: input.agent.name,
56
- runtime: input.runtime,
57
- permissionMode: input.permissionMode,
58
- tools: uniqueSorted(input.agent.tools),
59
- extensions: uniqueSorted(input.agent.extensions),
60
- skills: {
61
- names: uniqueSorted(input.skillNames),
62
- paths: uniqueSorted(input.skillPaths),
63
- disabled: input.skillsDisabled,
64
- },
65
- model: {
66
- requested: input.modelOverride,
67
- agentDefault: input.agent.model,
68
- fallbacks: uniqueSorted(input.agent.fallbackModels),
69
- teamRole: input.teamRoleModel,
70
- step: input.stepModel,
71
- },
72
- inheritance: {
73
- projectContext: input.agent.inheritProjectContext === true,
74
- skills: input.agent.inheritSkills === true,
75
- systemPromptMode: input.agent.systemPromptMode ?? "replace",
76
- },
77
- };
78
- }
1
+ import type { AgentConfig } from "../../agents/agent-config.ts";
2
+ import type { CrewRuntimeKind } from "../crew-agent-runtime.ts";
3
+
4
+ export interface WorkerCapabilityInventory {
5
+ schemaVersion: 1;
6
+ taskId: string;
7
+ role: string;
8
+ agent: string;
9
+ runtime: CrewRuntimeKind;
10
+ permissionMode: string;
11
+ tools: string[];
12
+ extensions: string[];
13
+ skills: {
14
+ names: string[];
15
+ paths: string[];
16
+ disabled: boolean;
17
+ };
18
+ model: {
19
+ requested?: string;
20
+ agentDefault?: string;
21
+ fallbacks: string[];
22
+ teamRole?: string;
23
+ step?: string;
24
+ };
25
+ inheritance: {
26
+ projectContext: boolean;
27
+ skills: boolean;
28
+ systemPromptMode: "replace" | "append";
29
+ };
30
+ }
31
+
32
+ export interface BuildWorkerCapabilityInventoryInput {
33
+ taskId: string;
34
+ role: string;
35
+ agent: AgentConfig;
36
+ runtime: CrewRuntimeKind;
37
+ permissionMode: string;
38
+ skillNames?: string[];
39
+ skillPaths?: string[];
40
+ skillsDisabled: boolean;
41
+ modelOverride?: string;
42
+ teamRoleModel?: string;
43
+ stepModel?: string;
44
+ }
45
+
46
+ function uniqueSorted(values: readonly string[] | undefined): string[] {
47
+ return [...new Set((values ?? []).map((value) => value.trim()).filter(Boolean))].sort((a, b) => a.localeCompare(b));
48
+ }
49
+
50
+ export function buildWorkerCapabilityInventory(input: BuildWorkerCapabilityInventoryInput): WorkerCapabilityInventory {
51
+ return {
52
+ schemaVersion: 1,
53
+ taskId: input.taskId,
54
+ role: input.role,
55
+ agent: input.agent.name,
56
+ runtime: input.runtime,
57
+ permissionMode: input.permissionMode,
58
+ tools: uniqueSorted(input.agent.tools),
59
+ extensions: uniqueSorted(input.agent.extensions),
60
+ skills: {
61
+ names: uniqueSorted(input.skillNames),
62
+ paths: uniqueSorted(input.skillPaths),
63
+ disabled: input.skillsDisabled,
64
+ },
65
+ model: {
66
+ requested: input.modelOverride,
67
+ agentDefault: input.agent.model,
68
+ fallbacks: uniqueSorted(input.agent.fallbackModels),
69
+ teamRole: input.teamRoleModel,
70
+ step: input.stepModel,
71
+ },
72
+ inheritance: {
73
+ projectContext: input.agent.inheritProjectContext === true,
74
+ skills: input.agent.inheritSkills === true,
75
+ systemPromptMode: input.agent.systemPromptMode ?? "replace",
76
+ },
77
+ };
78
+ }
@@ -69,6 +69,12 @@ export async function runLiveTask(input: RunLiveTaskInput): Promise<RunLiveTaskO
69
69
  };
70
70
  const attemptStartedAt = new Date();
71
71
  const isCurrent = input.isCurrent ?? (() => input.signal?.aborted !== true);
72
+ // Apply agent-level maxTurns override if specified (only positive integers)
73
+ const agentMax = agent.maxTurns;
74
+ const effectiveRuntimeConfig = (agentMax != null && agentMax > 0 &&
75
+ (!input.runtimeConfig?.maxTurns || agentMax < input.runtimeConfig.maxTurns))
76
+ ? { ...input.runtimeConfig, maxTurns: agentMax }
77
+ : input.runtimeConfig;
72
78
  const liveResult = await runLiveSessionTask({
73
79
  manifest,
74
80
  task,
@@ -77,7 +83,7 @@ export async function runLiveTask(input: RunLiveTaskInput): Promise<RunLiveTaskO
77
83
  prompt,
78
84
  signal: input.signal,
79
85
  transcriptPath,
80
- runtimeConfig: input.runtimeConfig,
86
+ runtimeConfig: effectiveRuntimeConfig,
81
87
  parentContext: input.parentContext,
82
88
  parentModel: input.parentModel,
83
89
  modelRegistry: input.modelRegistry,
@@ -1,119 +1,119 @@
1
- import type { UsageState } from "../../state/types.ts";
2
- import type { CrewAgentProgress } from "../crew-agent-runtime.ts";
3
- import { emptyCrewAgentProgress } from "../crew-agent-records.ts";
4
- import type { ProgressEventSummary } from "../progress-event-coalescer.ts";
5
- import type { TeamTaskState } from "../../state/types.ts";
6
-
7
- function asRecord(value: unknown): Record<string, unknown> | undefined {
8
- return value && typeof value === "object" && !Array.isArray(value) ? value as Record<string, unknown> : undefined;
9
- }
10
-
11
- function safeNum(v: number | undefined): number {
12
- return Number.isFinite(v) ? v! : 0;
13
- }
14
-
15
- function textFromContent(content: unknown): string[] {
16
- if (typeof content === "string") return [content];
17
- if (!Array.isArray(content)) return [];
18
- const text: string[] = [];
19
- for (const part of content) {
20
- const obj = asRecord(part);
21
- if (!obj) continue;
22
- if (obj.type === "text" && typeof obj.text === "string") text.push(obj.text);
23
- else if (typeof obj.content === "string") text.push(obj.content);
24
- }
25
- return text;
26
- }
27
-
28
- function eventText(event: unknown): string[] {
29
- const obj = asRecord(event);
30
- if (!obj) return [];
31
- const text: string[] = [];
32
- if (typeof obj.text === "string") text.push(obj.text);
33
- if (typeof obj.output === "string") text.push(obj.output);
34
- text.push(...textFromContent(obj.content));
35
- const message = asRecord(obj.message);
36
- if (message) text.push(...textFromContent(message.content));
37
- return text.filter((entry) => entry.trim());
38
- }
39
-
40
- function numberField(obj: Record<string, unknown>, keys: string[]): number | undefined {
41
- for (const key of keys) {
42
- const value = obj[key];
43
- if (typeof value === "number" && Number.isFinite(value)) return value;
44
- }
45
- return undefined;
46
- }
47
-
48
- function eventUsage(event: unknown): { input?: number; output?: number; turns?: number } | undefined {
49
- const obj = asRecord(event);
50
- if (!obj) return undefined;
51
- const direct = { input: numberField(obj, ["input", "inputTokens", "input_tokens"]), output: numberField(obj, ["output", "outputTokens", "output_tokens"]), turns: numberField(obj, ["turns", "turnCount", "turn_count"]) };
52
- if (Object.values(direct).some((value) => value !== undefined)) return direct;
53
- for (const key of ["usage", "tokenUsage", "tokens", "stats"]) {
54
- const nested = eventUsage(obj[key]);
55
- if (nested) return nested;
56
- }
57
- const message = asRecord(obj.message);
58
- return message ? eventUsage(message.usage) : undefined;
59
- }
60
-
61
- function previewArgs(args: unknown): string | undefined {
62
- if (!args) return undefined;
63
- try {
64
- const text = typeof args === "string" ? args : JSON.stringify(args);
65
- return text.length > 240 ? `${text.slice(0, 240)}…` : text;
66
- } catch {
67
- return undefined;
68
- }
69
- }
70
-
71
- export function applyUsageToProgress(progress: CrewAgentProgress | undefined, usage: UsageState | undefined): CrewAgentProgress | undefined {
72
- if (!usage) return progress;
73
- const base = progress ?? emptyCrewAgentProgress();
74
- const tokens = safeNum(usage.input) + safeNum(usage.output) + safeNum(usage.cacheRead) + safeNum(usage.cacheWrite);
75
- return { ...base, tokens, turns: usage.turns ?? base.turns };
76
- }
77
-
78
- export function shouldFlushProgressEvent(event: unknown): boolean {
79
- const type = asRecord(event)?.type;
80
- return type === "tool_execution_start" || type === "tool_execution_end" || type === "message_end" || type === "tool_result_end";
81
- }
82
-
83
- export function progressEventSummary(task: TeamTaskState, event: unknown): ProgressEventSummary {
84
- const type = asRecord(event)?.type;
85
- return { eventType: typeof type === "string" ? type : "event", currentTool: task.agentProgress?.currentTool, toolCount: task.agentProgress?.toolCount, tokens: task.agentProgress?.tokens, turns: task.agentProgress?.turns, activityState: task.agentProgress?.activityState, lastActivityAt: task.agentProgress?.lastActivityAt };
86
- }
87
-
88
- export function applyAgentProgressEvent(progress: CrewAgentProgress, event: unknown, startedAt: string | undefined): CrewAgentProgress {
89
- const obj = asRecord(event);
90
- const now = new Date().toISOString();
91
- const next: CrewAgentProgress = { ...progress, recentTools: [...progress.recentTools], recentOutput: [...progress.recentOutput], lastActivityAt: now, activityState: "active" };
92
- if (startedAt) {
93
- const startMs = new Date(startedAt).getTime();
94
- next.durationMs = Number.isFinite(startMs) ? Date.now() - startMs : undefined;
95
- }
96
- if (obj?.type === "tool_execution_start") {
97
- next.toolCount += 1;
98
- next.currentTool = typeof obj.toolName === "string" ? obj.toolName : typeof obj.name === "string" ? obj.name : "tool";
99
- next.currentToolArgs = previewArgs(obj.args);
100
- next.currentToolStartedAt = now;
101
- }
102
- if (obj?.type === "tool_execution_end") {
103
- if (next.currentTool) next.recentTools.push({ tool: next.currentTool, args: next.currentToolArgs, endedAt: now });
104
- next.currentTool = undefined;
105
- next.currentToolArgs = undefined;
106
- next.currentToolStartedAt = undefined;
107
- }
108
- if ((obj?.type === "tool_execution_error" || obj?.type === "tool_execution_failed") && next.currentTool) next.failedTool = next.currentTool;
109
- const usage = eventUsage(event);
110
- if (usage) {
111
- next.tokens = safeNum(usage.input) + safeNum(usage.output);
112
- next.turns = usage.turns ?? next.turns;
113
- }
114
- const text = eventText(event);
115
- if (text.length > 0) next.recentOutput.push(...text.flatMap((entry) => entry.split(/\r?\n/)).filter(Boolean).slice(-10));
116
- if (next.recentTools.length > 25) next.recentTools.splice(0, next.recentTools.length - 25);
117
- if (next.recentOutput.length > 50) next.recentOutput.splice(0, next.recentOutput.length - 50);
118
- return next;
119
- }
1
+ import type { UsageState } from "../../state/types.ts";
2
+ import type { CrewAgentProgress } from "../crew-agent-runtime.ts";
3
+ import { emptyCrewAgentProgress } from "../crew-agent-records.ts";
4
+ import type { ProgressEventSummary } from "../progress-event-coalescer.ts";
5
+ import type { TeamTaskState } from "../../state/types.ts";
6
+
7
+ function asRecord(value: unknown): Record<string, unknown> | undefined {
8
+ return value && typeof value === "object" && !Array.isArray(value) ? value as Record<string, unknown> : undefined;
9
+ }
10
+
11
+ function safeNum(v: number | undefined): number {
12
+ return Number.isFinite(v) ? v! : 0;
13
+ }
14
+
15
+ function textFromContent(content: unknown): string[] {
16
+ if (typeof content === "string") return [content];
17
+ if (!Array.isArray(content)) return [];
18
+ const text: string[] = [];
19
+ for (const part of content) {
20
+ const obj = asRecord(part);
21
+ if (!obj) continue;
22
+ if (obj.type === "text" && typeof obj.text === "string") text.push(obj.text);
23
+ else if (typeof obj.content === "string") text.push(obj.content);
24
+ }
25
+ return text;
26
+ }
27
+
28
+ function eventText(event: unknown): string[] {
29
+ const obj = asRecord(event);
30
+ if (!obj) return [];
31
+ const text: string[] = [];
32
+ if (typeof obj.text === "string") text.push(obj.text);
33
+ if (typeof obj.output === "string") text.push(obj.output);
34
+ text.push(...textFromContent(obj.content));
35
+ const message = asRecord(obj.message);
36
+ if (message) text.push(...textFromContent(message.content));
37
+ return text.filter((entry) => entry.trim());
38
+ }
39
+
40
+ function numberField(obj: Record<string, unknown>, keys: string[]): number | undefined {
41
+ for (const key of keys) {
42
+ const value = obj[key];
43
+ if (typeof value === "number" && Number.isFinite(value)) return value;
44
+ }
45
+ return undefined;
46
+ }
47
+
48
+ function eventUsage(event: unknown): { input?: number; output?: number; turns?: number } | undefined {
49
+ const obj = asRecord(event);
50
+ if (!obj) return undefined;
51
+ const direct = { input: numberField(obj, ["input", "inputTokens", "input_tokens"]), output: numberField(obj, ["output", "outputTokens", "output_tokens"]), turns: numberField(obj, ["turns", "turnCount", "turn_count"]) };
52
+ if (Object.values(direct).some((value) => value !== undefined)) return direct;
53
+ for (const key of ["usage", "tokenUsage", "tokens", "stats"]) {
54
+ const nested = eventUsage(obj[key]);
55
+ if (nested) return nested;
56
+ }
57
+ const message = asRecord(obj.message);
58
+ return message ? eventUsage(message.usage) : undefined;
59
+ }
60
+
61
+ function previewArgs(args: unknown): string | undefined {
62
+ if (!args) return undefined;
63
+ try {
64
+ const text = typeof args === "string" ? args : JSON.stringify(args);
65
+ return text.length > 240 ? `${text.slice(0, 240)}…` : text;
66
+ } catch {
67
+ return undefined;
68
+ }
69
+ }
70
+
71
+ export function applyUsageToProgress(progress: CrewAgentProgress | undefined, usage: UsageState | undefined): CrewAgentProgress | undefined {
72
+ if (!usage) return progress;
73
+ const base = progress ?? emptyCrewAgentProgress();
74
+ const tokens = safeNum(usage.input) + safeNum(usage.output) + safeNum(usage.cacheRead) + safeNum(usage.cacheWrite);
75
+ return { ...base, tokens, turns: usage.turns ?? base.turns };
76
+ }
77
+
78
+ export function shouldFlushProgressEvent(event: unknown): boolean {
79
+ const type = asRecord(event)?.type;
80
+ return type === "tool_execution_start" || type === "tool_execution_end" || type === "message_end" || type === "tool_result_end";
81
+ }
82
+
83
+ export function progressEventSummary(task: TeamTaskState, event: unknown): ProgressEventSummary {
84
+ const type = asRecord(event)?.type;
85
+ return { eventType: typeof type === "string" ? type : "event", currentTool: task.agentProgress?.currentTool, toolCount: task.agentProgress?.toolCount, tokens: task.agentProgress?.tokens, turns: task.agentProgress?.turns, activityState: task.agentProgress?.activityState, lastActivityAt: task.agentProgress?.lastActivityAt };
86
+ }
87
+
88
+ export function applyAgentProgressEvent(progress: CrewAgentProgress, event: unknown, startedAt: string | undefined): CrewAgentProgress {
89
+ const obj = asRecord(event);
90
+ const now = new Date().toISOString();
91
+ const next: CrewAgentProgress = { ...progress, recentTools: [...progress.recentTools], recentOutput: [...progress.recentOutput], lastActivityAt: now, activityState: "active" };
92
+ if (startedAt) {
93
+ const startMs = new Date(startedAt).getTime();
94
+ next.durationMs = Number.isFinite(startMs) ? Date.now() - startMs : undefined;
95
+ }
96
+ if (obj?.type === "tool_execution_start") {
97
+ next.toolCount += 1;
98
+ next.currentTool = typeof obj.toolName === "string" ? obj.toolName : typeof obj.name === "string" ? obj.name : "tool";
99
+ next.currentToolArgs = previewArgs(obj.args);
100
+ next.currentToolStartedAt = now;
101
+ }
102
+ if (obj?.type === "tool_execution_end") {
103
+ if (next.currentTool) next.recentTools.push({ tool: next.currentTool, args: next.currentToolArgs, endedAt: now });
104
+ next.currentTool = undefined;
105
+ next.currentToolArgs = undefined;
106
+ next.currentToolStartedAt = undefined;
107
+ }
108
+ if ((obj?.type === "tool_execution_error" || obj?.type === "tool_execution_failed") && next.currentTool) next.failedTool = next.currentTool;
109
+ const usage = eventUsage(event);
110
+ if (usage) {
111
+ next.tokens = safeNum(usage.input) + safeNum(usage.output);
112
+ next.turns = usage.turns ?? next.turns;
113
+ }
114
+ const text = eventText(event);
115
+ if (text.length > 0) next.recentOutput.push(...text.flatMap((entry) => entry.split(/\r?\n/)).filter(Boolean).slice(-10));
116
+ if (next.recentTools.length > 25) next.recentTools.splice(0, next.recentTools.length - 25);
117
+ if (next.recentOutput.length > 50) next.recentOutput.splice(0, next.recentOutput.length - 50);
118
+ return next;
119
+ }
@@ -1,64 +1,64 @@
1
- import * as path from "node:path";
2
- import type { ArtifactDescriptor } from "../../state/types.ts";
3
-
4
- export type WorkerPromptPipelineStageName =
5
- | "task-packet-built"
6
- | "dependency-context-collected"
7
- | "skills-rendered-or-disabled"
8
- | "capability-inventory-recorded"
9
- | "coordination-bridge-attached"
10
- | "prompt-rendered"
11
- | "prompt-artifact-written";
12
-
13
- export interface WorkerPromptPipelineStage {
14
- name: WorkerPromptPipelineStageName;
15
- references: string[];
16
- details?: Record<string, string | number | boolean>;
17
- }
18
-
19
- export interface WorkerPromptPipelineArtifact {
20
- schemaVersion: 1;
21
- taskId: string;
22
- stages: WorkerPromptPipelineStage[];
23
- }
24
-
25
- function artifactReference(artifactsRoot: string, artifact?: ArtifactDescriptor): string | undefined {
26
- if (!artifact) return undefined;
27
- const root = path.resolve(artifactsRoot);
28
- const target = path.resolve(artifact.path);
29
- const relative = path.relative(root, target);
30
- if (!relative || relative.startsWith("..") || path.isAbsolute(relative)) return undefined;
31
- return relative.replaceAll("\\", "/");
32
- }
33
-
34
- export interface BuildWorkerPromptPipelineInput {
35
- artifactsRoot: string;
36
- taskId: string;
37
- promptArtifact: ArtifactDescriptor;
38
- inputsArtifact: ArtifactDescriptor;
39
- skillArtifact?: ArtifactDescriptor;
40
- capabilityArtifact: ArtifactDescriptor;
41
- coordinationArtifact: ArtifactDescriptor;
42
- skillInstructionCount: number;
43
- skillsDisabled: boolean;
44
- }
45
-
46
- export function buildWorkerPromptPipeline(input: BuildWorkerPromptPipelineInput): WorkerPromptPipelineArtifact {
47
- return {
48
- schemaVersion: 1,
49
- taskId: input.taskId,
50
- stages: [
51
- { name: "task-packet-built", references: [`metadata/${input.taskId}.task-packet.json`] },
52
- { name: "dependency-context-collected", references: [artifactReference(input.artifactsRoot, input.inputsArtifact) ?? `metadata/${input.taskId}.inputs.json`] },
53
- {
54
- name: "skills-rendered-or-disabled",
55
- references: input.skillArtifact ? [artifactReference(input.artifactsRoot, input.skillArtifact) ?? `metadata/${input.taskId}.skills.md`] : [],
56
- details: { disabled: input.skillsDisabled, skillInstructionCount: input.skillInstructionCount },
57
- },
58
- { name: "capability-inventory-recorded", references: [artifactReference(input.artifactsRoot, input.capabilityArtifact) ?? `metadata/${input.taskId}.capabilities.json`] },
59
- { name: "coordination-bridge-attached", references: [artifactReference(input.artifactsRoot, input.coordinationArtifact) ?? `metadata/${input.taskId}.coordination-bridge.md`] },
60
- { name: "prompt-rendered", references: [] },
61
- { name: "prompt-artifact-written", references: [artifactReference(input.artifactsRoot, input.promptArtifact) ?? `prompts/${input.taskId}.md`] },
62
- ],
63
- };
64
- }
1
+ import * as path from "node:path";
2
+ import type { ArtifactDescriptor } from "../../state/types.ts";
3
+
4
+ export type WorkerPromptPipelineStageName =
5
+ | "task-packet-built"
6
+ | "dependency-context-collected"
7
+ | "skills-rendered-or-disabled"
8
+ | "capability-inventory-recorded"
9
+ | "coordination-bridge-attached"
10
+ | "prompt-rendered"
11
+ | "prompt-artifact-written";
12
+
13
+ export interface WorkerPromptPipelineStage {
14
+ name: WorkerPromptPipelineStageName;
15
+ references: string[];
16
+ details?: Record<string, string | number | boolean>;
17
+ }
18
+
19
+ export interface WorkerPromptPipelineArtifact {
20
+ schemaVersion: 1;
21
+ taskId: string;
22
+ stages: WorkerPromptPipelineStage[];
23
+ }
24
+
25
+ function artifactReference(artifactsRoot: string, artifact?: ArtifactDescriptor): string | undefined {
26
+ if (!artifact) return undefined;
27
+ const root = path.resolve(artifactsRoot);
28
+ const target = path.resolve(artifact.path);
29
+ const relative = path.relative(root, target);
30
+ if (!relative || relative.startsWith("..") || path.isAbsolute(relative)) return undefined;
31
+ return relative.replaceAll("\\", "/");
32
+ }
33
+
34
+ export interface BuildWorkerPromptPipelineInput {
35
+ artifactsRoot: string;
36
+ taskId: string;
37
+ promptArtifact: ArtifactDescriptor;
38
+ inputsArtifact: ArtifactDescriptor;
39
+ skillArtifact?: ArtifactDescriptor;
40
+ capabilityArtifact: ArtifactDescriptor;
41
+ coordinationArtifact: ArtifactDescriptor;
42
+ skillInstructionCount: number;
43
+ skillsDisabled: boolean;
44
+ }
45
+
46
+ export function buildWorkerPromptPipeline(input: BuildWorkerPromptPipelineInput): WorkerPromptPipelineArtifact {
47
+ return {
48
+ schemaVersion: 1,
49
+ taskId: input.taskId,
50
+ stages: [
51
+ { name: "task-packet-built", references: [`metadata/${input.taskId}.task-packet.json`] },
52
+ { name: "dependency-context-collected", references: [artifactReference(input.artifactsRoot, input.inputsArtifact) ?? `metadata/${input.taskId}.inputs.json`] },
53
+ {
54
+ name: "skills-rendered-or-disabled",
55
+ references: input.skillArtifact ? [artifactReference(input.artifactsRoot, input.skillArtifact) ?? `metadata/${input.taskId}.skills.md`] : [],
56
+ details: { disabled: input.skillsDisabled, skillInstructionCount: input.skillInstructionCount },
57
+ },
58
+ { name: "capability-inventory-recorded", references: [artifactReference(input.artifactsRoot, input.capabilityArtifact) ?? `metadata/${input.taskId}.capabilities.json`] },
59
+ { name: "coordination-bridge-attached", references: [artifactReference(input.artifactsRoot, input.coordinationArtifact) ?? `metadata/${input.taskId}.coordination-bridge.md`] },
60
+ { name: "prompt-rendered", references: [] },
61
+ { name: "prompt-artifact-written", references: [artifactReference(input.artifactsRoot, input.promptArtifact) ?? `prompts/${input.taskId}.md`] },
62
+ ],
63
+ };
64
+ }
@@ -1,14 +1,14 @@
1
- export function cleanResultText(text: string | undefined): string | undefined {
2
- const trimmed = text?.trim();
3
- if (!trimmed) return undefined;
4
- const doneIndex = trimmed.lastIndexOf("\nDONE\n");
5
- if (doneIndex >= 0) return trimmed.slice(doneIndex + 1).trim();
6
- if (trimmed === "DONE" || trimmed.startsWith("DONE\n")) return trimmed;
7
- const fencedPromptIndex = trimmed.lastIndexOf("</file>");
8
- if (fencedPromptIndex >= 0 && fencedPromptIndex < trimmed.length - 7) return trimmed.slice(fencedPromptIndex + 7).trim() || trimmed;
9
- return trimmed;
10
- }
11
-
12
- export function isFinalChildEvent(event: unknown): boolean {
13
- return Boolean(event && typeof event === "object" && !Array.isArray(event) && (event as Record<string, unknown>).type === "message_end");
14
- }
1
+ export function cleanResultText(text: string | undefined): string | undefined {
2
+ const trimmed = text?.trim();
3
+ if (!trimmed) return undefined;
4
+ const doneIndex = trimmed.lastIndexOf("\nDONE\n");
5
+ if (doneIndex >= 0) return trimmed.slice(doneIndex + 1).trim();
6
+ if (trimmed === "DONE" || trimmed.startsWith("DONE\n")) return trimmed;
7
+ const fencedPromptIndex = trimmed.lastIndexOf("</file>");
8
+ if (fencedPromptIndex >= 0 && fencedPromptIndex < trimmed.length - 7) return trimmed.slice(fencedPromptIndex + 7).trim() || trimmed;
9
+ return trimmed;
10
+ }
11
+
12
+ export function isFinalChildEvent(event: unknown): boolean {
13
+ return Boolean(event && typeof event === "object" && !Array.isArray(event) && (event as Record<string, unknown>).type === "message_end");
14
+ }