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,59 +1,59 @@
1
- import type { TeamRunManifest } from "../state/types.ts";
2
- import { appendEvent } from "../state/event-log.ts";
3
- import { logInternalError } from "../utils/internal-error.ts";
4
-
5
- export interface SupervisorContactPayload {
6
- runId: string;
7
- taskId: string;
8
- reason: "decision_needed" | "clarification" | "approval" | "error_escalation" | "custom";
9
- message: string;
10
- data?: Record<string, unknown>;
11
- timestamp: string;
12
- }
13
-
14
- /**
15
- * Record a supervisor contact event from a child task.
16
- * This represents a child→parent communication where the child needs
17
- * a decision, clarification, or approval to continue.
18
- */
19
- export function recordSupervisorContact(manifest: TeamRunManifest, payload: Omit<SupervisorContactPayload, "timestamp">): void {
20
- const fullPayload: SupervisorContactPayload = {
21
- ...payload,
22
- timestamp: new Date().toISOString(),
23
- };
24
- try {
25
- appendEvent(manifest.eventsPath, {
26
- type: "supervisor.contact",
27
- runId: manifest.runId,
28
- taskId: payload.taskId,
29
- data: fullPayload as unknown as Record<string, unknown>,
30
- });
31
- } catch (error) {
32
- logInternalError("supervisor-contact.record", error, `runId=${manifest.runId} taskId=${payload.taskId}`);
33
- }
34
- }
35
-
36
- /**
37
- * Parse a supervisor contact request from child Pi stdout.
38
- * Detects structured JSON lines with type "supervisor_contact".
39
- */
40
- export function parseSupervisorContactFromLine(line: string): Omit<SupervisorContactPayload, "timestamp" | "runId"> | undefined {
41
- if (!line.trim()) return undefined;
42
- let parsed: unknown;
43
- try {
44
- parsed = JSON.parse(line);
45
- } catch {
46
- return undefined;
47
- }
48
- if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return undefined;
49
- const record = parsed as Record<string, unknown>;
50
- if (record.type !== "supervisor_contact" && record.type !== "crew_supervisor_contact") return undefined;
51
- return {
52
- taskId: typeof record.taskId === "string" ? record.taskId : "",
53
- reason: typeof record.reason === "string" && ["decision_needed", "clarification", "approval", "error_escalation", "custom"].includes(record.reason)
54
- ? record.reason as SupervisorContactPayload["reason"]
55
- : "custom",
56
- message: typeof record.message === "string" ? record.message : String(record.message ?? ""),
57
- data: record.data && typeof record.data === "object" && !Array.isArray(record.data) ? record.data as Record<string, unknown> : undefined,
58
- };
59
- }
1
+ import type { TeamRunManifest } from "../state/types.ts";
2
+ import { appendEvent } from "../state/event-log.ts";
3
+ import { logInternalError } from "../utils/internal-error.ts";
4
+
5
+ export interface SupervisorContactPayload {
6
+ runId: string;
7
+ taskId: string;
8
+ reason: "decision_needed" | "clarification" | "approval" | "error_escalation" | "custom";
9
+ message: string;
10
+ data?: Record<string, unknown>;
11
+ timestamp: string;
12
+ }
13
+
14
+ /**
15
+ * Record a supervisor contact event from a child task.
16
+ * This represents a child→parent communication where the child needs
17
+ * a decision, clarification, or approval to continue.
18
+ */
19
+ export function recordSupervisorContact(manifest: TeamRunManifest, payload: Omit<SupervisorContactPayload, "timestamp">): void {
20
+ const fullPayload: SupervisorContactPayload = {
21
+ ...payload,
22
+ timestamp: new Date().toISOString(),
23
+ };
24
+ try {
25
+ appendEvent(manifest.eventsPath, {
26
+ type: "supervisor.contact",
27
+ runId: manifest.runId,
28
+ taskId: payload.taskId,
29
+ data: fullPayload as unknown as Record<string, unknown>,
30
+ });
31
+ } catch (error) {
32
+ logInternalError("supervisor-contact.record", error, `runId=${manifest.runId} taskId=${payload.taskId}`);
33
+ }
34
+ }
35
+
36
+ /**
37
+ * Parse a supervisor contact request from child Pi stdout.
38
+ * Detects structured JSON lines with type "supervisor_contact".
39
+ */
40
+ export function parseSupervisorContactFromLine(line: string): Omit<SupervisorContactPayload, "timestamp" | "runId"> | undefined {
41
+ if (!line.trim()) return undefined;
42
+ let parsed: unknown;
43
+ try {
44
+ parsed = JSON.parse(line);
45
+ } catch {
46
+ return undefined;
47
+ }
48
+ if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return undefined;
49
+ const record = parsed as Record<string, unknown>;
50
+ if (record.type !== "supervisor_contact" && record.type !== "crew_supervisor_contact") return undefined;
51
+ return {
52
+ taskId: typeof record.taskId === "string" ? record.taskId : "",
53
+ reason: typeof record.reason === "string" && ["decision_needed", "clarification", "approval", "error_escalation", "custom"].includes(record.reason)
54
+ ? record.reason as SupervisorContactPayload["reason"]
55
+ : "custom",
56
+ message: typeof record.message === "string" ? record.message : String(record.message ?? ""),
57
+ data: record.data && typeof record.data === "object" && !Array.isArray(record.data) ? record.data as Record<string, unknown> : undefined,
58
+ };
59
+ }
@@ -1,38 +1,38 @@
1
- import type { TeamTaskState } from "../state/types.ts";
2
- import type { CrewAgentRecord, CrewRuntimeKind } from "./crew-agent-runtime.ts";
3
- import { recordFromTask } from "./crew-agent-records.ts";
4
- import type { TeamRunManifest } from "../state/types.ts";
5
-
6
- export function shouldMaterializeAgent(task: TeamTaskState): boolean {
7
- return task.status !== "queued" && task.status !== "skipped";
8
- }
9
-
10
- export function recordsForMaterializedTasks(manifest: TeamRunManifest, tasks: TeamTaskState[], runtime: CrewRuntimeKind): CrewAgentRecord[] {
11
- return tasks.filter(shouldMaterializeAgent).map((task) => recordFromTask(manifest, task, runtime));
12
- }
13
-
14
- export function taskById(tasks: TeamTaskState[]): Map<string, TeamTaskState> {
15
- const map = new Map<string, TeamTaskState>();
16
- for (const task of tasks) {
17
- map.set(task.id, task);
18
- if (task.stepId) map.set(task.stepId, task);
19
- }
20
- return map;
21
- }
22
-
23
- export function waitingReason(task: TeamTaskState, tasks: TeamTaskState[]): string | undefined {
24
- if (task.status !== "queued") return undefined;
25
- const byId = taskById(tasks);
26
- const waiting = task.dependsOn.map((id) => byId.get(id)?.id ?? id).filter((id) => byId.get(id)?.status !== "completed");
27
- if (waiting.length === 0) return "ready";
28
- return `waiting for ${waiting.join(", ")}`;
29
- }
30
-
31
- export function formatTaskGraphLines(tasks: TeamTaskState[]): string[] {
32
- if (tasks.length === 0) return ["- (none)"];
33
- return tasks.map((task) => {
34
- const icon = task.status === "completed" ? "✓" : task.status === "running" ? "⠋" : task.status === "failed" ? "✗" : task.status === "cancelled" || task.status === "skipped" ? "■" : "◦";
35
- const wait = waitingReason(task, tasks);
36
- return `- ${icon} ${task.id} [${task.status}] ${task.role}->${task.agent}${wait && wait !== "ready" ? ` (${wait})` : ""}`;
37
- });
38
- }
1
+ import type { TeamTaskState } from "../state/types.ts";
2
+ import type { CrewAgentRecord, CrewRuntimeKind } from "./crew-agent-runtime.ts";
3
+ import { recordFromTask } from "./crew-agent-records.ts";
4
+ import type { TeamRunManifest } from "../state/types.ts";
5
+
6
+ export function shouldMaterializeAgent(task: TeamTaskState): boolean {
7
+ return task.status !== "queued" && task.status !== "skipped";
8
+ }
9
+
10
+ export function recordsForMaterializedTasks(manifest: TeamRunManifest, tasks: TeamTaskState[], runtime: CrewRuntimeKind): CrewAgentRecord[] {
11
+ return tasks.filter(shouldMaterializeAgent).map((task) => recordFromTask(manifest, task, runtime));
12
+ }
13
+
14
+ export function taskById(tasks: TeamTaskState[]): Map<string, TeamTaskState> {
15
+ const map = new Map<string, TeamTaskState>();
16
+ for (const task of tasks) {
17
+ map.set(task.id, task);
18
+ if (task.stepId) map.set(task.stepId, task);
19
+ }
20
+ return map;
21
+ }
22
+
23
+ export function waitingReason(task: TeamTaskState, tasks: TeamTaskState[]): string | undefined {
24
+ if (task.status !== "queued") return undefined;
25
+ const byId = taskById(tasks);
26
+ const waiting = task.dependsOn.map((id) => byId.get(id)?.id ?? id).filter((id) => byId.get(id)?.status !== "completed");
27
+ if (waiting.length === 0) return "ready";
28
+ return `waiting for ${waiting.join(", ")}`;
29
+ }
30
+
31
+ export function formatTaskGraphLines(tasks: TeamTaskState[]): string[] {
32
+ if (tasks.length === 0) return ["- (none)"];
33
+ return tasks.map((task) => {
34
+ const icon = task.status === "completed" ? "✓" : task.status === "running" ? "⠋" : task.status === "failed" ? "✗" : task.status === "cancelled" || task.status === "skipped" ? "■" : "◦";
35
+ const wait = waitingReason(task, tasks);
36
+ return `- ${icon} ${task.id} [${task.status}] ${task.role}->${task.agent}${wait && wait !== "ready" ? ` (${wait})` : ""}`;
37
+ });
38
+ }
@@ -1,127 +1,127 @@
1
- import * as fs from "node:fs";
2
- import * as path from "node:path";
3
- import type { ArtifactDescriptor, TeamRunManifest, TeamTaskState } from "../state/types.ts";
4
- import { writeArtifact } from "../state/artifact-store.ts";
5
- import { resolveRealContainedPath } from "../utils/safe-paths.ts";
6
- import type { WorkflowStep } from "../workflows/workflow-config.ts";
7
-
8
- export interface DependencyOutputContext {
9
- dependencies: Array<{ taskId: string; title: string; status: string; result?: string; resultPath?: string }>;
10
- sharedReads: Array<{ name: string; path: string; content: string }>;
11
- }
12
-
13
- function containedExists(filePath: string, baseDir?: string): boolean {
14
- try {
15
- const safePath = baseDir ? resolveRealContainedPath(baseDir, filePath) : filePath;
16
- return fs.existsSync(safePath);
17
- } catch {
18
- return false;
19
- }
20
- }
21
-
22
- function readIfSmall(filePath: string, maxBytes = 24_000, baseDir?: string): string | undefined {
23
- try {
24
- const safePath = baseDir ? resolveRealContainedPath(baseDir, filePath) : filePath;
25
- const stat = fs.statSync(safePath);
26
- if (stat.size > maxBytes) return `${fs.readFileSync(safePath, "utf-8").slice(0, maxBytes)}\n\n...(truncated ${stat.size - maxBytes} bytes)`;
27
- return fs.readFileSync(safePath, "utf-8");
28
- } catch {
29
- return undefined;
30
- }
31
- }
32
-
33
- function safeSharedName(name: string): string {
34
- const normalized = name.replaceAll("\\", "/").replace(/^\.\/+/, "");
35
- if (!normalized || normalized.split("/").some((segment) => segment === "..") || path.isAbsolute(normalized)) throw new Error(`Invalid shared artifact name: ${name}`);
36
- return normalized;
37
- }
38
-
39
- export function sharedPath(manifest: TeamRunManifest, name: string): string {
40
- const sharedRoot = path.resolve(manifest.artifactsRoot, "shared");
41
- const resolved = path.resolve(sharedRoot, safeSharedName(name));
42
- const relative = path.relative(sharedRoot, resolved);
43
- if (relative.startsWith("..") || path.isAbsolute(relative)) throw new Error(`Invalid shared artifact name: ${name}`);
44
- return resolved;
45
- }
46
-
47
- export function collectDependencyOutputContext(manifest: TeamRunManifest, tasks: TeamTaskState[], task: TeamTaskState, step: WorkflowStep): DependencyOutputContext {
48
- const byStep = new Map(tasks.map((item) => [item.stepId, item]).filter((entry): entry is [string, TeamTaskState] => Boolean(entry[0])));
49
- const byId = new Map(tasks.map((item) => [item.id, item]));
50
- const dependencies = task.dependsOn.map((dep) => byStep.get(dep) ?? byId.get(dep)).filter((item): item is TeamTaskState => Boolean(item)).map((item) => ({
51
- taskId: item.id,
52
- title: item.title,
53
- status: item.status,
54
- resultPath: item.resultArtifact?.path,
55
- result: item.resultArtifact ? readIfSmall(item.resultArtifact.path, 24_000, manifest.artifactsRoot) : undefined,
56
- }));
57
- const sharedReads = (step.reads === false ? [] : step.reads ?? []).map((name) => {
58
- const filePath = sharedPath(manifest, name);
59
- return { name, path: filePath, content: readIfSmall(filePath, 24_000, path.resolve(manifest.artifactsRoot, "shared")) ?? "" };
60
- }).filter((item) => item.content.trim().length > 0);
61
- return { dependencies, sharedReads };
62
- }
63
-
64
- export function renderDependencyOutputContext(context: DependencyOutputContext): string {
65
- const parts: string[] = [];
66
- if (context.dependencies.length) {
67
- parts.push("# Dependency Outputs", "");
68
- for (const dep of context.dependencies) {
69
- parts.push(`## ${dep.taskId} (${dep.title})`, `Status: ${dep.status}`, dep.resultPath ? `Result artifact: ${dep.resultPath}` : "", "", dep.result?.trim() || "(no result output)", "");
70
- }
71
- }
72
- if (context.sharedReads.length) {
73
- parts.push("# Shared Run Context Reads", "");
74
- for (const read of context.sharedReads) parts.push(`## shared/${read.name}`, `Path: ${read.path}`, "", read.content.trim(), "");
75
- }
76
- return parts.join("\n").trim();
77
- }
78
-
79
- export function writeTaskSharedOutput(manifest: TeamRunManifest, step: WorkflowStep, task: TeamTaskState): ArtifactDescriptor | undefined {
80
- if (step.output === false) return undefined;
81
- const name = safeSharedName(step.output || `${task.id}.md`);
82
- const source = task.resultArtifact ? readIfSmall(task.resultArtifact.path, 80_000, manifest.artifactsRoot) : undefined;
83
- if (!source) return undefined;
84
- return writeArtifact(manifest.artifactsRoot, {
85
- kind: "metadata",
86
- relativePath: `shared/${name}`,
87
- producer: task.id,
88
- content: source.endsWith("\n") ? source : `${source}\n`,
89
- });
90
- }
91
-
92
- export function writeTaskInputsArtifact(manifest: TeamRunManifest, task: TeamTaskState, context: DependencyOutputContext): ArtifactDescriptor {
93
- return writeArtifact(manifest.artifactsRoot, {
94
- kind: "metadata",
95
- relativePath: `metadata/${task.id}.inputs.json`,
96
- producer: task.id,
97
- content: `${JSON.stringify(context, null, 2)}\n`,
98
- });
99
- }
100
-
101
- export function aggregateTaskOutputs(tasks: TeamTaskState[], manifest?: TeamRunManifest): string {
102
- return tasks.map((task, index) => {
103
- const body = task.resultArtifact ? readIfSmall(task.resultArtifact.path, 40_000, manifest?.artifactsRoot) : undefined;
104
- const hasBody = Boolean(body?.trim());
105
- const expectedMissing = task.resultArtifact && !containedExists(task.resultArtifact.path, manifest?.artifactsRoot);
106
- const status = task.status === "skipped"
107
- ? "SKIPPED"
108
- : task.status === "failed"
109
- ? `FAILED${task.exitCode !== undefined ? ` (exit code ${task.exitCode ?? "null"})` : ""}${task.error ? `: ${task.error}` : ""}`
110
- : expectedMissing
111
- ? `EMPTY OUTPUT (expected result artifact missing: ${task.resultArtifact?.path})`
112
- : !hasBody
113
- ? "EMPTY OUTPUT (no textual response returned)"
114
- : task.status.toUpperCase();
115
- return [
116
- `=== Task ${index + 1}: ${task.id} (${task.agent}) ===`,
117
- `Status: ${status}`,
118
- task.role ? `Role: ${task.role}` : "",
119
- task.resultArtifact?.path ? `Result artifact: ${task.resultArtifact.path}` : "",
120
- task.logArtifact?.path ? `Log artifact: ${task.logArtifact.path}` : "",
121
- task.transcriptArtifact?.path ? `Transcript: ${task.transcriptArtifact.path}` : "",
122
- task.usage ? `Usage: ${JSON.stringify(task.usage)}` : "",
123
- "",
124
- hasBody ? body!.trim() : status,
125
- ].filter(Boolean).join("\n");
126
- }).join("\n\n");
127
- }
1
+ import * as fs from "node:fs";
2
+ import * as path from "node:path";
3
+ import type { ArtifactDescriptor, TeamRunManifest, TeamTaskState } from "../state/types.ts";
4
+ import { writeArtifact } from "../state/artifact-store.ts";
5
+ import { resolveRealContainedPath } from "../utils/safe-paths.ts";
6
+ import type { WorkflowStep } from "../workflows/workflow-config.ts";
7
+
8
+ export interface DependencyOutputContext {
9
+ dependencies: Array<{ taskId: string; title: string; status: string; result?: string; resultPath?: string }>;
10
+ sharedReads: Array<{ name: string; path: string; content: string }>;
11
+ }
12
+
13
+ function containedExists(filePath: string, baseDir?: string): boolean {
14
+ try {
15
+ const safePath = baseDir ? resolveRealContainedPath(baseDir, filePath) : filePath;
16
+ return fs.existsSync(safePath);
17
+ } catch {
18
+ return false;
19
+ }
20
+ }
21
+
22
+ function readIfSmall(filePath: string, maxBytes = 24_000, baseDir?: string): string | undefined {
23
+ try {
24
+ const safePath = baseDir ? resolveRealContainedPath(baseDir, filePath) : filePath;
25
+ const stat = fs.statSync(safePath);
26
+ if (stat.size > maxBytes) return `${fs.readFileSync(safePath, "utf-8").slice(0, maxBytes)}\n\n...(truncated ${stat.size - maxBytes} bytes)`;
27
+ return fs.readFileSync(safePath, "utf-8");
28
+ } catch {
29
+ return undefined;
30
+ }
31
+ }
32
+
33
+ function safeSharedName(name: string): string {
34
+ const normalized = name.replaceAll("\\", "/").replace(/^\.\/+/, "");
35
+ if (!normalized || normalized.split("/").some((segment) => segment === "..") || path.isAbsolute(normalized)) throw new Error(`Invalid shared artifact name: ${name}`);
36
+ return normalized;
37
+ }
38
+
39
+ export function sharedPath(manifest: TeamRunManifest, name: string): string {
40
+ const sharedRoot = path.resolve(manifest.artifactsRoot, "shared");
41
+ const resolved = path.resolve(sharedRoot, safeSharedName(name));
42
+ const relative = path.relative(sharedRoot, resolved);
43
+ if (relative.startsWith("..") || path.isAbsolute(relative)) throw new Error(`Invalid shared artifact name: ${name}`);
44
+ return resolved;
45
+ }
46
+
47
+ export function collectDependencyOutputContext(manifest: TeamRunManifest, tasks: TeamTaskState[], task: TeamTaskState, step: WorkflowStep): DependencyOutputContext {
48
+ const byStep = new Map(tasks.map((item) => [item.stepId, item]).filter((entry): entry is [string, TeamTaskState] => Boolean(entry[0])));
49
+ const byId = new Map(tasks.map((item) => [item.id, item]));
50
+ const dependencies = task.dependsOn.map((dep) => byStep.get(dep) ?? byId.get(dep)).filter((item): item is TeamTaskState => Boolean(item)).map((item) => ({
51
+ taskId: item.id,
52
+ title: item.title,
53
+ status: item.status,
54
+ resultPath: item.resultArtifact?.path,
55
+ result: item.resultArtifact ? readIfSmall(item.resultArtifact.path, 24_000, manifest.artifactsRoot) : undefined,
56
+ }));
57
+ const sharedReads = (step.reads === false ? [] : step.reads ?? []).map((name) => {
58
+ const filePath = sharedPath(manifest, name);
59
+ return { name, path: filePath, content: readIfSmall(filePath, 24_000, path.resolve(manifest.artifactsRoot, "shared")) ?? "" };
60
+ }).filter((item) => item.content.trim().length > 0);
61
+ return { dependencies, sharedReads };
62
+ }
63
+
64
+ export function renderDependencyOutputContext(context: DependencyOutputContext): string {
65
+ const parts: string[] = [];
66
+ if (context.dependencies.length) {
67
+ parts.push("# Dependency Outputs", "");
68
+ for (const dep of context.dependencies) {
69
+ parts.push(`## ${dep.taskId} (${dep.title})`, `Status: ${dep.status}`, dep.resultPath ? `Result artifact: ${dep.resultPath}` : "", "", dep.result?.trim() || "(no result output)", "");
70
+ }
71
+ }
72
+ if (context.sharedReads.length) {
73
+ parts.push("# Shared Run Context Reads", "");
74
+ for (const read of context.sharedReads) parts.push(`## shared/${read.name}`, `Path: ${read.path}`, "", read.content.trim(), "");
75
+ }
76
+ return parts.join("\n").trim();
77
+ }
78
+
79
+ export function writeTaskSharedOutput(manifest: TeamRunManifest, step: WorkflowStep, task: TeamTaskState): ArtifactDescriptor | undefined {
80
+ if (step.output === false) return undefined;
81
+ const name = safeSharedName(step.output || `${task.id}.md`);
82
+ const source = task.resultArtifact ? readIfSmall(task.resultArtifact.path, 80_000, manifest.artifactsRoot) : undefined;
83
+ if (!source) return undefined;
84
+ return writeArtifact(manifest.artifactsRoot, {
85
+ kind: "metadata",
86
+ relativePath: `shared/${name}`,
87
+ producer: task.id,
88
+ content: source.endsWith("\n") ? source : `${source}\n`,
89
+ });
90
+ }
91
+
92
+ export function writeTaskInputsArtifact(manifest: TeamRunManifest, task: TeamTaskState, context: DependencyOutputContext): ArtifactDescriptor {
93
+ return writeArtifact(manifest.artifactsRoot, {
94
+ kind: "metadata",
95
+ relativePath: `metadata/${task.id}.inputs.json`,
96
+ producer: task.id,
97
+ content: `${JSON.stringify(context, null, 2)}\n`,
98
+ });
99
+ }
100
+
101
+ export function aggregateTaskOutputs(tasks: TeamTaskState[], manifest?: TeamRunManifest): string {
102
+ return tasks.map((task, index) => {
103
+ const body = task.resultArtifact ? readIfSmall(task.resultArtifact.path, 40_000, manifest?.artifactsRoot) : undefined;
104
+ const hasBody = Boolean(body?.trim());
105
+ const expectedMissing = task.resultArtifact && !containedExists(task.resultArtifact.path, manifest?.artifactsRoot);
106
+ const status = task.status === "skipped"
107
+ ? "SKIPPED"
108
+ : task.status === "failed"
109
+ ? `FAILED${task.exitCode !== undefined ? ` (exit code ${task.exitCode ?? "null"})` : ""}${task.error ? `: ${task.error}` : ""}`
110
+ : expectedMissing
111
+ ? `EMPTY OUTPUT (expected result artifact missing: ${task.resultArtifact?.path})`
112
+ : !hasBody
113
+ ? "EMPTY OUTPUT (no textual response returned)"
114
+ : task.status.toUpperCase();
115
+ return [
116
+ `=== Task ${index + 1}: ${task.id} (${task.agent}) ===`,
117
+ `Status: ${status}`,
118
+ task.role ? `Role: ${task.role}` : "",
119
+ task.resultArtifact?.path ? `Result artifact: ${task.resultArtifact.path}` : "",
120
+ task.logArtifact?.path ? `Log artifact: ${task.logArtifact.path}` : "",
121
+ task.transcriptArtifact?.path ? `Transcript: ${task.transcriptArtifact.path}` : "",
122
+ task.usage ? `Usage: ${JSON.stringify(task.usage)}` : "",
123
+ "",
124
+ hasBody ? body!.trim() : status,
125
+ ].filter(Boolean).join("\n");
126
+ }).join("\n\n");
127
+ }
@@ -0,0 +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
+ }