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