@xzzpig/pi-subagents 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +1621 -0
- package/LICENSE +21 -0
- package/README.md +118 -0
- package/agents/delegate.md +14 -0
- package/agents/oracle.md +74 -0
- package/agents/researcher.md +52 -0
- package/agents/reviewer.md +79 -0
- package/agents/scout.md +50 -0
- package/agents/worker.md +58 -0
- package/index.ts +1 -0
- package/inspector-runner.mjs +11 -0
- package/install.mjs +93 -0
- package/package.json +105 -0
- package/prompts/gather-context-and-clarify.md +13 -0
- package/prompts/parallel-cleanup.md +59 -0
- package/prompts/parallel-research.md +50 -0
- package/prompts/parallel-review.md +54 -0
- package/prompts/review-loop.md +43 -0
- package/skills/pi-subagents/SKILL.md +41 -0
- package/skills/pi-subagents/references/constraints-and-recipes.md +251 -0
- package/skills/pi-subagents/references/execution-controls.md +428 -0
- package/skills/pi-subagents/references/management-authoring-rpc.md +161 -0
- package/skills/pi-subagents/references/prompting-and-roles.md +242 -0
- package/src/agents/agent-management.ts +1256 -0
- package/src/agents/agent-memory.ts +254 -0
- package/src/agents/agent-refinements.ts +624 -0
- package/src/agents/agent-scope.ts +6 -0
- package/src/agents/agent-selection.ts +25 -0
- package/src/agents/agent-serializer.ts +163 -0
- package/src/agents/agents.ts +1889 -0
- package/src/agents/chain-serializer.ts +280 -0
- package/src/agents/frontmatter.ts +149 -0
- package/src/agents/identity.ts +30 -0
- package/src/agents/proactive-skills.ts +194 -0
- package/src/agents/skills.ts +761 -0
- package/src/api/background-work.ts +197 -0
- package/src/api/capability-ceiling.ts +17 -0
- package/src/api/control-channel.ts +4 -0
- package/src/api/delegation.ts +119 -0
- package/src/api/external-runs.ts +129 -0
- package/src/api/intercom-bridge.ts +3 -0
- package/src/api/pi-args.ts +5 -0
- package/src/api/preflight.ts +403 -0
- package/src/api/shared-types.ts +19 -0
- package/src/extension/config.ts +76 -0
- package/src/extension/control-notices.ts +58 -0
- package/src/extension/doctor.ts +230 -0
- package/src/extension/fanout-child.ts +201 -0
- package/src/extension/index.ts +805 -0
- package/src/extension/public-execution.ts +71 -0
- package/src/extension/rpc.ts +653 -0
- package/src/extension/schemas.ts +375 -0
- package/src/extension/steering-notices.ts +35 -0
- package/src/extension/tool-description.ts +164 -0
- package/src/inspectors/herdr/actions.ts +229 -0
- package/src/inspectors/herdr/client.ts +130 -0
- package/src/inspectors/herdr/inspector-runner.ts +141 -0
- package/src/inspectors/herdr/project-panes.ts +154 -0
- package/src/integrations/herdr-status.ts +330 -0
- package/src/intercom/intercom-bridge.ts +187 -0
- package/src/intercom/native-supervisor-channel.ts +715 -0
- package/src/intercom/result-intercom.ts +421 -0
- package/src/missions/actions.ts +410 -0
- package/src/missions/goal-driver.ts +162 -0
- package/src/missions/lifecycle.ts +346 -0
- package/src/missions/store.ts +507 -0
- package/src/missions/types.ts +157 -0
- package/src/missions/workflow-state.ts +250 -0
- package/src/policy/authority.ts +46 -0
- package/src/profiles/profiles.ts +661 -0
- package/src/runs/background/async-execution.ts +1574 -0
- package/src/runs/background/async-job-tracker.ts +511 -0
- package/src/runs/background/async-resume.ts +539 -0
- package/src/runs/background/async-status.ts +542 -0
- package/src/runs/background/auto-drain.ts +67 -0
- package/src/runs/background/chain-append.ts +328 -0
- package/src/runs/background/chain-root-attachment.ts +199 -0
- package/src/runs/background/completion-batcher.ts +168 -0
- package/src/runs/background/completion-dedupe.ts +54 -0
- package/src/runs/background/control-channel.ts +692 -0
- package/src/runs/background/fleet-view.ts +540 -0
- package/src/runs/background/notify.ts +332 -0
- package/src/runs/background/parallel-groups.ts +45 -0
- package/src/runs/background/process-terminal.ts +280 -0
- package/src/runs/background/result-watcher.ts +414 -0
- package/src/runs/background/retained-children.ts +68 -0
- package/src/runs/background/run-id-resolver.ts +167 -0
- package/src/runs/background/run-status.ts +504 -0
- package/src/runs/background/scheduled-runs.ts +753 -0
- package/src/runs/background/stale-run-reconciler.ts +396 -0
- package/src/runs/background/steering.ts +239 -0
- package/src/runs/background/subagent-runner.ts +4718 -0
- package/src/runs/background/subagent-wait.ts +661 -0
- package/src/runs/background/top-level-async.ts +14 -0
- package/src/runs/background/wait-completions.ts +112 -0
- package/src/runs/background/wait-config.ts +36 -0
- package/src/runs/background/wait-subscriptions.ts +253 -0
- package/src/runs/background/wait-tool.ts +34 -0
- package/src/runs/foreground/async-steering-action.ts +256 -0
- package/src/runs/foreground/async-stop-action.ts +65 -0
- package/src/runs/foreground/chain-clarify.ts +1354 -0
- package/src/runs/foreground/chain-execution.ts +1527 -0
- package/src/runs/foreground/execution.ts +1868 -0
- package/src/runs/foreground/foreground-control.ts +132 -0
- package/src/runs/foreground/subagent-executor.ts +5532 -0
- package/src/runs/shared/acceptance.ts +1365 -0
- package/src/runs/shared/agent-contract.ts +38 -0
- package/src/runs/shared/capability-ceiling.ts +209 -0
- package/src/runs/shared/chain-outputs.ts +118 -0
- package/src/runs/shared/child-protocol.ts +401 -0
- package/src/runs/shared/completion-guard.ts +95 -0
- package/src/runs/shared/context-mode.ts +44 -0
- package/src/runs/shared/dynamic-fanout.ts +297 -0
- package/src/runs/shared/external-cli-runner.ts +130 -0
- package/src/runs/shared/long-running-guard.ts +220 -0
- package/src/runs/shared/mcp-direct-tool-allowlist.ts +406 -0
- package/src/runs/shared/model-fallback.ts +336 -0
- package/src/runs/shared/model-scope.ts +128 -0
- package/src/runs/shared/nested-events.ts +1076 -0
- package/src/runs/shared/nested-path.ts +52 -0
- package/src/runs/shared/nested-render.ts +123 -0
- package/src/runs/shared/parallel-handoff.ts +238 -0
- package/src/runs/shared/parallel-utils.ts +256 -0
- package/src/runs/shared/permissions.ts +95 -0
- package/src/runs/shared/pi-args.ts +808 -0
- package/src/runs/shared/pi-spawn.ts +163 -0
- package/src/runs/shared/process-signal.ts +19 -0
- package/src/runs/shared/run-history.ts +181 -0
- package/src/runs/shared/runtime-acknowledged-extensions.ts +71 -0
- package/src/runs/shared/session-lease.ts +299 -0
- package/src/runs/shared/single-output.ts +235 -0
- package/src/runs/shared/spawn-budget.ts +128 -0
- package/src/runs/shared/structured-output.ts +182 -0
- package/src/runs/shared/subagent-control.ts +231 -0
- package/src/runs/shared/subagent-prompt-runtime.ts +588 -0
- package/src/runs/shared/subagent-startup-retry.ts +104 -0
- package/src/runs/shared/task-intent.ts +181 -0
- package/src/runs/shared/tool-availability.ts +83 -0
- package/src/runs/shared/tool-budget.ts +80 -0
- package/src/runs/shared/turn-budget.ts +98 -0
- package/src/runs/shared/usage-budget.ts +65 -0
- package/src/runs/shared/workflow-graph.ts +231 -0
- package/src/runs/shared/worktree.ts +759 -0
- package/src/shared/accessible-dir.ts +47 -0
- package/src/shared/artifacts.ts +285 -0
- package/src/shared/atomic-json.ts +61 -0
- package/src/shared/child-transcript.ts +264 -0
- package/src/shared/file-coalescer.ts +40 -0
- package/src/shared/file-system-retry.ts +47 -0
- package/src/shared/fork-context.ts +213 -0
- package/src/shared/formatters.ts +133 -0
- package/src/shared/jsonl-writer.ts +81 -0
- package/src/shared/launch-contract.ts +124 -0
- package/src/shared/model-info.ts +81 -0
- package/src/shared/post-exit-stdio-guard.ts +85 -0
- package/src/shared/session-identity.ts +10 -0
- package/src/shared/session-tokens.ts +44 -0
- package/src/shared/settings.ts +501 -0
- package/src/shared/status-format.ts +55 -0
- package/src/shared/types.ts +2069 -0
- package/src/shared/utils.ts +613 -0
- package/src/slash/delegation-adapters.ts +434 -0
- package/src/slash/delegation-json.ts +108 -0
- package/src/slash/delegation-request.ts +166 -0
- package/src/slash/prompt-template-bridge.ts +383 -0
- package/src/slash/prompt-workflows.ts +300 -0
- package/src/slash/selector.ts +147 -0
- package/src/slash/slash-bridge.ts +192 -0
- package/src/slash/slash-commands.ts +994 -0
- package/src/slash/slash-live-state.ts +296 -0
- package/src/slash/subagents-admin.ts +432 -0
- package/src/tui/fleet-status.ts +564 -0
- package/src/tui/fleet-transcript.ts +577 -0
- package/src/tui/fleet.ts +879 -0
- package/src/tui/render-helpers.ts +80 -0
- package/src/tui/render.ts +2029 -0
- package/src/types/pi-runtime-compat.d.ts +8 -0
- package/src/watchdog/change-signature.ts +220 -0
- package/src/watchdog/child-status.ts +205 -0
- package/src/watchdog/emission-guard.ts +123 -0
- package/src/watchdog/lsp-diagnostics.ts +537 -0
- package/src/watchdog/model-selection.ts +167 -0
- package/src/watchdog/permission-arbiter.ts +145 -0
- package/src/watchdog/register-child.ts +117 -0
- package/src/watchdog/register-main.ts +440 -0
- package/src/watchdog/render.ts +54 -0
- package/src/watchdog/review.ts +302 -0
- package/src/watchdog/runtime.ts +868 -0
- package/src/watchdog/scope.ts +62 -0
- package/src/watchdog/settings.ts +568 -0
- package/src/watchdog/tool-actions.ts +155 -0
- package/src/watchdog/turn-delta.ts +161 -0
- package/src/watchdog/types.ts +198 -0
- package/src/watchdog/warning-format.ts +73 -0
- package/src/workflows/chat-progress.ts +140 -0
- package/src/workflows/scripted-workflow.ts +506 -0
|
@@ -0,0 +1,132 @@
|
|
|
1
|
+
import type { AgentProgress, ForegroundChildControl, ForegroundRunControl } from "../../shared/types.ts";
|
|
2
|
+
|
|
3
|
+
interface BeginForegroundChildInput {
|
|
4
|
+
index: number;
|
|
5
|
+
agent: string;
|
|
6
|
+
description?: string;
|
|
7
|
+
model?: string;
|
|
8
|
+
thinking?: string;
|
|
9
|
+
interrupt: () => boolean;
|
|
10
|
+
detach?: () => boolean;
|
|
11
|
+
}
|
|
12
|
+
|
|
13
|
+
function copyProgress(target: ForegroundChildControl, progress: AgentProgress | undefined): void {
|
|
14
|
+
if (!progress) return;
|
|
15
|
+
target.currentActivityState = progress.activityState;
|
|
16
|
+
target.lastActivityAt = progress.lastActivityAt;
|
|
17
|
+
target.currentTool = progress.currentTool;
|
|
18
|
+
target.currentToolStartedAt = progress.currentToolStartedAt;
|
|
19
|
+
target.currentPath = progress.currentPath;
|
|
20
|
+
target.turnCount = progress.turnCount;
|
|
21
|
+
target.tokens = progress.tokens;
|
|
22
|
+
target.inputTokens = progress.inputTokens;
|
|
23
|
+
target.outputTokens = progress.outputTokens;
|
|
24
|
+
target.model = progress.model;
|
|
25
|
+
target.thinking = progress.thinking;
|
|
26
|
+
target.toolCount = progress.toolCount;
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
function syncCurrentChild(control: ForegroundRunControl, child: ForegroundChildControl): void {
|
|
30
|
+
control.currentAgent = child.agent;
|
|
31
|
+
control.currentIndex = child.index;
|
|
32
|
+
control.description = child.description;
|
|
33
|
+
control.currentActivityState = child.currentActivityState;
|
|
34
|
+
control.lastActivityAt = child.lastActivityAt;
|
|
35
|
+
control.currentTool = child.currentTool;
|
|
36
|
+
control.currentToolStartedAt = child.currentToolStartedAt;
|
|
37
|
+
control.currentPath = child.currentPath;
|
|
38
|
+
control.turnCount = child.turnCount;
|
|
39
|
+
control.tokens = child.tokens;
|
|
40
|
+
control.inputTokens = child.inputTokens;
|
|
41
|
+
control.outputTokens = child.outputTokens;
|
|
42
|
+
control.model = child.model;
|
|
43
|
+
control.thinking = child.thinking;
|
|
44
|
+
control.toolCount = child.toolCount;
|
|
45
|
+
control.interrupt = child.interrupt;
|
|
46
|
+
control.detach = child.detach;
|
|
47
|
+
control.updatedAt = child.updatedAt;
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
function clearCurrentChild(control: ForegroundRunControl): void {
|
|
51
|
+
control.currentAgent = undefined;
|
|
52
|
+
control.currentIndex = undefined;
|
|
53
|
+
control.currentActivityState = undefined;
|
|
54
|
+
control.lastActivityAt = undefined;
|
|
55
|
+
control.currentTool = undefined;
|
|
56
|
+
control.currentToolStartedAt = undefined;
|
|
57
|
+
control.currentPath = undefined;
|
|
58
|
+
control.turnCount = undefined;
|
|
59
|
+
control.tokens = undefined;
|
|
60
|
+
control.inputTokens = undefined;
|
|
61
|
+
control.outputTokens = undefined;
|
|
62
|
+
control.model = undefined;
|
|
63
|
+
control.thinking = undefined;
|
|
64
|
+
control.toolCount = undefined;
|
|
65
|
+
control.interrupt = undefined;
|
|
66
|
+
control.detach = undefined;
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
export function retainForegroundSchedulingOwner(control: ForegroundRunControl): void {
|
|
70
|
+
control.schedulingOwners = (control.schedulingOwners ?? 0) + 1;
|
|
71
|
+
control.updatedAt = Date.now();
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
export function settleForegroundSchedulingOwner(control: ForegroundRunControl): void {
|
|
75
|
+
control.schedulingOwners = Math.max(0, (control.schedulingOwners ?? 0) - 1);
|
|
76
|
+
control.updatedAt = Date.now();
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
export function foregroundSchedulingSettled(control: ForegroundRunControl): boolean {
|
|
80
|
+
return (control.schedulingOwners ?? 0) === 0;
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
export function beginForegroundChild(control: ForegroundRunControl, input: BeginForegroundChildInput): void {
|
|
84
|
+
const now = Date.now();
|
|
85
|
+
const child: ForegroundChildControl = {
|
|
86
|
+
index: input.index,
|
|
87
|
+
agent: input.agent,
|
|
88
|
+
...(input.description ? { description: input.description } : {}),
|
|
89
|
+
startedAt: now,
|
|
90
|
+
updatedAt: now,
|
|
91
|
+
...(input.model ? { model: input.model } : {}),
|
|
92
|
+
...(input.thinking ? { thinking: input.thinking } : {}),
|
|
93
|
+
};
|
|
94
|
+
child.interrupt = () => {
|
|
95
|
+
if (!input.interrupt()) return false;
|
|
96
|
+
child.currentActivityState = undefined;
|
|
97
|
+
child.updatedAt = Date.now();
|
|
98
|
+
syncCurrentChild(control, child);
|
|
99
|
+
return true;
|
|
100
|
+
};
|
|
101
|
+
if (input.detach) {
|
|
102
|
+
child.detach = () => {
|
|
103
|
+
if (!input.detach?.()) return false;
|
|
104
|
+
child.currentActivityState = undefined;
|
|
105
|
+
child.updatedAt = Date.now();
|
|
106
|
+
syncCurrentChild(control, child);
|
|
107
|
+
return true;
|
|
108
|
+
};
|
|
109
|
+
}
|
|
110
|
+
control.activeChildren ??= new Map();
|
|
111
|
+
control.activeChildren.set(input.index, child);
|
|
112
|
+
syncCurrentChild(control, child);
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
export function updateForegroundChild(control: ForegroundRunControl, index: number, progress: AgentProgress | undefined): void {
|
|
116
|
+
const child = control.activeChildren?.get(index);
|
|
117
|
+
if (!child) return;
|
|
118
|
+
copyProgress(child, progress);
|
|
119
|
+
child.updatedAt = Date.now();
|
|
120
|
+
syncCurrentChild(control, child);
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
export function finishForegroundChild(control: ForegroundRunControl, index: number): void {
|
|
124
|
+
control.activeChildren?.delete(index);
|
|
125
|
+
if (control.currentIndex === index) {
|
|
126
|
+
const next = [...(control.activeChildren?.values() ?? [])]
|
|
127
|
+
.sort((left, right) => right.updatedAt - left.updatedAt || left.index - right.index)[0];
|
|
128
|
+
if (next) syncCurrentChild(control, next);
|
|
129
|
+
else clearCurrentChild(control);
|
|
130
|
+
}
|
|
131
|
+
control.updatedAt = Date.now();
|
|
132
|
+
}
|