pi-crew 0.1.51 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (240) hide show
  1. package/CHANGELOG.md +56 -1
  2. package/README.md +176 -781
  3. package/agents/analyst.md +11 -11
  4. package/agents/critic.md +11 -11
  5. package/agents/executor.md +11 -11
  6. package/agents/explorer.md +11 -11
  7. package/agents/planner.md +11 -11
  8. package/agents/reviewer.md +11 -11
  9. package/agents/security-reviewer.md +11 -11
  10. package/agents/test-engineer.md +11 -11
  11. package/agents/verifier.md +70 -11
  12. package/agents/writer.md +11 -11
  13. package/docs/actions-reference.md +595 -0
  14. package/docs/commands-reference.md +347 -0
  15. package/docs/runtime-flow.md +148 -148
  16. package/index.ts +6 -6
  17. package/package.json +99 -99
  18. package/skills/async-worker-recovery/SKILL.md +42 -42
  19. package/skills/context-artifact-hygiene/SKILL.md +52 -52
  20. package/skills/delegation-patterns/SKILL.md +54 -54
  21. package/skills/mailbox-interactive/SKILL.md +40 -40
  22. package/skills/model-routing-context/SKILL.md +39 -39
  23. package/skills/multi-perspective-review/SKILL.md +58 -58
  24. package/skills/observability-reliability/SKILL.md +41 -41
  25. package/skills/orchestration/SKILL.md +157 -157
  26. package/skills/ownership-session-security/SKILL.md +41 -41
  27. package/skills/pi-extension-lifecycle/SKILL.md +39 -39
  28. package/skills/requirements-to-task-packet/SKILL.md +63 -63
  29. package/skills/resource-discovery-config/SKILL.md +41 -41
  30. package/skills/runtime-state-reader/SKILL.md +44 -44
  31. package/skills/secure-agent-orchestration-review/SKILL.md +45 -45
  32. package/skills/state-mutation-locking/SKILL.md +42 -42
  33. package/skills/systematic-debugging/SKILL.md +67 -67
  34. package/skills/ui-render-performance/SKILL.md +39 -39
  35. package/skills/verification-before-done/SKILL.md +57 -57
  36. package/skills/worktree-isolation/SKILL.md +39 -39
  37. package/src/adapters/claude-adapter.ts +25 -0
  38. package/src/adapters/codex-adapter.ts +21 -0
  39. package/src/adapters/cursor-adapter.ts +17 -0
  40. package/src/adapters/export-util.ts +137 -0
  41. package/src/adapters/index.ts +15 -0
  42. package/src/adapters/registry.ts +18 -0
  43. package/src/adapters/types.ts +23 -0
  44. package/src/agents/agent-config.ts +2 -0
  45. package/src/agents/agent-search.ts +98 -98
  46. package/src/agents/discover-agents.ts +2 -1
  47. package/src/config/config.ts +13 -1
  48. package/src/config/drift-detector.ts +211 -0
  49. package/src/config/markers.ts +327 -0
  50. package/src/config/resilient-parser.ts +108 -0
  51. package/src/config/suggestions.ts +74 -0
  52. package/src/extension/cross-extension-rpc.ts +103 -94
  53. package/src/extension/project-init.ts +21 -1
  54. package/src/extension/register.ts +45 -14
  55. package/src/extension/registration/commands.ts +77 -8
  56. package/src/extension/registration/subagent-tools.ts +10 -1
  57. package/src/extension/registration/team-tool.ts +10 -1
  58. package/src/extension/registration/viewers.ts +48 -34
  59. package/src/extension/run-bundle-schema.ts +89 -89
  60. package/src/extension/run-import.ts +25 -1
  61. package/src/extension/run-index.ts +5 -1
  62. package/src/extension/run-maintenance.ts +142 -68
  63. package/src/extension/team-manager-command.ts +10 -1
  64. package/src/extension/team-tool/api.ts +441 -441
  65. package/src/extension/team-tool/doctor.ts +28 -3
  66. package/src/extension/team-tool/handle-settings.ts +195 -188
  67. package/src/extension/team-tool/inspect.ts +41 -41
  68. package/src/extension/team-tool/intent-policy.ts +42 -42
  69. package/src/extension/team-tool/lifecycle-actions.ts +27 -8
  70. package/src/extension/team-tool/plan.ts +19 -19
  71. package/src/extension/team-tool/run.ts +12 -1
  72. package/src/extension/team-tool.ts +332 -322
  73. package/src/i18n.ts +184 -184
  74. package/src/observability/exporters/otlp-exporter.ts +92 -77
  75. package/src/prompt/prompt-runtime.ts +72 -72
  76. package/src/runtime/agent-memory.ts +72 -72
  77. package/src/runtime/agent-observability.ts +114 -114
  78. package/src/runtime/async-marker.ts +26 -26
  79. package/src/runtime/attention-events.ts +28 -28
  80. package/src/runtime/auto-resume.ts +100 -0
  81. package/src/runtime/background-runner.ts +11 -1
  82. package/src/runtime/cancellation-token.ts +89 -89
  83. package/src/runtime/cancellation.ts +61 -61
  84. package/src/runtime/capability-inventory.ts +116 -116
  85. package/src/runtime/child-pi.ts +7 -2
  86. package/src/runtime/compaction-summary.ts +271 -0
  87. package/src/runtime/completion-guard.ts +190 -190
  88. package/src/runtime/crash-recovery.ts +33 -1
  89. package/src/runtime/delta-conflict.ts +360 -0
  90. package/src/runtime/direct-run.ts +35 -35
  91. package/src/runtime/foreground-control.ts +82 -82
  92. package/src/runtime/green-contract.ts +46 -46
  93. package/src/runtime/group-join.ts +106 -106
  94. package/src/runtime/heartbeat-gradient.ts +28 -28
  95. package/src/runtime/heartbeat-watcher.ts +124 -124
  96. package/src/runtime/iteration-hooks.ts +264 -0
  97. package/src/runtime/live-agent-control.ts +88 -88
  98. package/src/runtime/live-control-realtime.ts +36 -36
  99. package/src/runtime/live-extension-bridge.ts +150 -150
  100. package/src/runtime/live-irc.ts +92 -92
  101. package/src/runtime/live-session-health.ts +100 -100
  102. package/src/runtime/loop-gates.ts +129 -0
  103. package/src/runtime/metric-parser.ts +40 -0
  104. package/src/runtime/notebook-helpers.ts +90 -90
  105. package/src/runtime/orphan-sentinel.ts +7 -7
  106. package/src/runtime/parallel-research.ts +44 -44
  107. package/src/runtime/phase-progress.ts +217 -0
  108. package/src/runtime/pi-args.ts +38 -11
  109. package/src/runtime/pi-json-output.ts +111 -111
  110. package/src/runtime/pi-spawn.ts +57 -7
  111. package/src/runtime/policy-engine.ts +79 -79
  112. package/src/runtime/post-checks.ts +122 -0
  113. package/src/runtime/progress-event-coalescer.ts +43 -43
  114. package/src/runtime/prose-compressor.ts +164 -164
  115. package/src/runtime/recovery-recipes.ts +74 -74
  116. package/src/runtime/result-extractor.ts +121 -121
  117. package/src/runtime/role-permission.ts +39 -39
  118. package/src/runtime/sensitive-paths.ts +2 -2
  119. package/src/runtime/session-resources.ts +25 -25
  120. package/src/runtime/session-snapshot.ts +59 -59
  121. package/src/runtime/session-usage.ts +79 -79
  122. package/src/runtime/sidechain-output.ts +29 -29
  123. package/src/runtime/stream-preview.ts +177 -177
  124. package/src/runtime/supervisor-contact.ts +59 -59
  125. package/src/runtime/task-display.ts +38 -38
  126. package/src/runtime/task-graph.ts +207 -0
  127. package/src/runtime/task-quality.ts +207 -0
  128. package/src/runtime/task-runner/capabilities.ts +78 -78
  129. package/src/runtime/task-runner/live-executor.ts +7 -1
  130. package/src/runtime/task-runner/progress.ts +119 -119
  131. package/src/runtime/task-runner/prompt-pipeline.ts +64 -64
  132. package/src/runtime/task-runner/result-utils.ts +14 -14
  133. package/src/runtime/task-runner/run-projection.ts +103 -103
  134. package/src/runtime/task-runner/state-helpers.ts +22 -22
  135. package/src/runtime/team-runner.ts +117 -7
  136. package/src/runtime/worker-heartbeat.ts +21 -21
  137. package/src/runtime/worker-startup.ts +57 -57
  138. package/src/runtime/workflow-state.ts +187 -0
  139. package/src/runtime/workspace-tree.ts +298 -298
  140. package/src/schema/config-schema.ts +11 -0
  141. package/src/schema/validation-types.ts +148 -0
  142. package/src/skills/skill-templates.ts +374 -0
  143. package/src/state/active-run-registry.ts +35 -11
  144. package/src/state/atomic-write.ts +33 -26
  145. package/src/state/contracts.ts +1 -0
  146. package/src/state/event-reconstructor.ts +217 -0
  147. package/src/state/locks.ts +2 -13
  148. package/src/state/mailbox.ts +4 -3
  149. package/src/state/state-store.ts +16 -6
  150. package/src/state/task-claims.ts +44 -44
  151. package/src/state/types.ts +9 -0
  152. package/src/state/usage.ts +29 -29
  153. package/src/subagents/async-entry.ts +1 -1
  154. package/src/subagents/index.ts +3 -3
  155. package/src/subagents/live/control.ts +1 -1
  156. package/src/subagents/live/manager.ts +1 -1
  157. package/src/subagents/live/realtime.ts +1 -1
  158. package/src/subagents/live/session-runtime.ts +1 -1
  159. package/src/subagents/manager.ts +1 -1
  160. package/src/subagents/spawn.ts +1 -1
  161. package/src/teams/team-serializer.ts +38 -38
  162. package/src/types/diff.d.ts +18 -18
  163. package/src/ui/crew-footer.ts +101 -101
  164. package/src/ui/crew-select-list.ts +111 -111
  165. package/src/ui/crew-widget.ts +5 -2
  166. package/src/ui/dashboard-panes/cancellation-pane.ts +42 -42
  167. package/src/ui/dashboard-panes/capability-pane.ts +59 -59
  168. package/src/ui/dashboard-panes/mailbox-pane.ts +35 -35
  169. package/src/ui/dashboard-panes/metrics-pane.ts +34 -34
  170. package/src/ui/dashboard-panes/progress-pane.ts +11 -0
  171. package/src/ui/dynamic-border.ts +25 -25
  172. package/src/ui/layout-primitives.ts +106 -106
  173. package/src/ui/loaders.ts +158 -158
  174. package/src/ui/render-coalescer.ts +51 -51
  175. package/src/ui/render-diff.ts +119 -119
  176. package/src/ui/render-scheduler.ts +143 -143
  177. package/src/ui/run-action-dispatcher.ts +10 -1
  178. package/src/ui/spinner.ts +17 -17
  179. package/src/ui/status-colors.ts +58 -58
  180. package/src/ui/syntax-highlight.ts +116 -116
  181. package/src/ui/transcript-entries.ts +258 -258
  182. package/src/utils/completion-dedupe.ts +63 -63
  183. package/src/utils/frontmatter.ts +68 -68
  184. package/src/utils/git.ts +262 -262
  185. package/src/utils/ids.ts +17 -17
  186. package/src/utils/incremental-reader.ts +104 -104
  187. package/src/utils/names.ts +27 -27
  188. package/src/utils/redaction.ts +44 -44
  189. package/src/utils/safe-paths.ts +47 -47
  190. package/src/utils/scan-cache.ts +136 -136
  191. package/src/utils/sleep.ts +40 -26
  192. package/src/utils/task-name-generator.ts +337 -337
  193. package/src/workflows/validate-workflow.ts +40 -40
  194. package/src/worktree/branch-freshness.ts +45 -45
  195. package/teams/default.team.md +12 -12
  196. package/teams/fast-fix.team.md +11 -11
  197. package/teams/implementation.team.md +18 -18
  198. package/teams/parallel-research.team.md +14 -14
  199. package/teams/research.team.md +11 -11
  200. package/teams/review.team.md +12 -12
  201. package/workflows/default.workflow.md +30 -29
  202. package/workflows/fast-fix.workflow.md +23 -22
  203. package/workflows/implementation.workflow.md +43 -43
  204. package/workflows/parallel-research.workflow.md +46 -46
  205. package/workflows/research.workflow.md +22 -22
  206. package/workflows/review.workflow.md +30 -30
  207. package/docs/refactor-tasks-phase3.md +0 -394
  208. package/docs/refactor-tasks-phase4.md +0 -564
  209. package/docs/refactor-tasks-phase5.md +0 -402
  210. package/docs/refactor-tasks-phase6.md +0 -662
  211. package/docs/refactor-tasks.md +0 -1484
  212. package/docs/research/AGENT-EXECUTION-ARCHITECTURE.md +0 -261
  213. package/docs/research/AGENT-LIFECYCLE-COMPARISON.md +0 -111
  214. package/docs/research/AUDIT_OH_MY_PI.md +0 -261
  215. package/docs/research/AUDIT_PI_CREW.md +0 -457
  216. package/docs/research/CAVEMAN-DEEP-RESEARCH.md +0 -281
  217. package/docs/research/COMPARISON_OH_MY_PI_VS_PI_CREW.md +0 -264
  218. package/docs/research/DEEP-RESEARCH-PI-POWERBAR.md +0 -343
  219. package/docs/research/DEEP_RESEARCH_SUBAGENT_ARCHITECTURE.md +0 -480
  220. package/docs/research/GAP_CLOSURE_IMPLEMENTATION_PLAN.md +0 -354
  221. package/docs/research/IMPLEMENTATION_PLAN.md +0 -385
  222. package/docs/research/LIVE-SESSION-PRODUCTION-READY-PLAN.md +0 -502
  223. package/docs/research/OH-MY-PI-DEEP-RESEARCH-v14.7.6.md +0 -266
  224. package/docs/research/REMAINING-GAPS-PLAN.md +0 -363
  225. package/docs/research/SESSION-SUMMARY-2026-05-08.md +0 -146
  226. package/docs/research/UI-RESPONSIVENESS-AUDIT.md +0 -173
  227. package/docs/research-awesome-agent-skills-distillation.md +0 -100
  228. package/docs/research-extension-examples.md +0 -297
  229. package/docs/research-extension-system.md +0 -324
  230. package/docs/research-oh-my-pi-distillation.md +0 -369
  231. package/docs/research-optimization-plan.md +0 -548
  232. package/docs/research-phase10-distillation.md +0 -199
  233. package/docs/research-phase11-distillation.md +0 -201
  234. package/docs/research-phase8-operator-experience-plan.md +0 -819
  235. package/docs/research-phase9-observability-reliability-plan.md +0 -1190
  236. package/docs/research-pi-coding-agent.md +0 -357
  237. package/docs/research-source-pi-crew-reference.md +0 -174
  238. package/docs/research-ui-optimization-plan.md +0 -480
  239. package/docs/source-runtime-refactor-map.md +0 -107
  240. package/src/utils/atomic-write.ts +0 -33
@@ -1,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
+ }