@xzzpig/pi-subagents 0.8.0 → 0.10.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 +477 -0
- package/README.md +2 -2
- package/agents/claude-code-writer.md +15 -0
- package/agents/claude-code.md +15 -0
- package/agents/codex-exec-writer.md +15 -0
- package/agents/codex-exec.md +15 -0
- package/agents/cursor-agent-writer.md +14 -0
- package/agents/cursor-agent.md +14 -0
- package/agents/reviewer.md +1 -1
- package/agents/scout.md +1 -1
- package/docs/agents.md +195 -39
- package/docs/configuration.md +81 -22
- package/docs/extension-api.md +69 -14
- package/docs/missions.md +2 -0
- package/docs/models.md +32 -9
- package/docs/observability.md +22 -20
- package/docs/tool-reference.md +123 -14
- package/docs/watchdog.md +92 -114
- package/docs/workflows.md +142 -4
- package/install.mjs +1 -1
- package/package.json +7 -6
- package/prompts/review-loop.md +2 -2
- package/skills/council-mode/SKILL.md +48 -243
- package/skills/council-mode/references/pass-contracts.md +150 -0
- package/skills/pi-subagents/SKILL.md +89 -35
- package/skills/pi-subagents/references/constraints-and-recipes.md +30 -234
- package/skills/pi-subagents/references/execution-controls.md +91 -15
- package/skills/pi-subagents/references/management-authoring-rpc.md +5 -5
- package/skills/pi-subagents/references/multi-lane-orchestration.md +13 -1
- package/skills/pi-subagents/references/prompting-and-roles.md +59 -31
- package/skills/pi-subagents/references/review-and-validation.md +73 -0
- package/src/agents/agent-management.ts +384 -115
- package/src/agents/agent-refinements.ts +4 -4
- package/src/agents/agent-serializer.ts +14 -2
- package/src/agents/agents.ts +935 -372
- package/src/agents/builtin-names.ts +6 -0
- package/src/agents/runtime-agent-events.ts +70 -0
- package/src/agents/runtime-agent-registry.ts +42 -21
- package/src/api/agents.ts +10 -5
- package/src/api/background-work.ts +12 -3
- package/src/api/capability-ceiling.ts +0 -1
- package/src/api/{pi-args.ts → child-tool-plan.ts} +1 -1
- package/src/api/delegation.ts +0 -7
- package/src/api/external-runs.ts +67 -4
- package/src/api/preflight.ts +77 -21
- package/src/api/shared-types.ts +6 -0
- package/src/extension/config.ts +90 -0
- package/src/extension/doctor.ts +5 -13
- package/src/extension/fanout-child.ts +14 -14
- package/src/extension/index.ts +115 -37
- package/src/extension/public-execution.ts +103 -15
- package/src/extension/rpc.ts +120 -25
- package/src/extension/schemas.ts +65 -29
- package/src/extension/tool-description.ts +48 -26
- package/src/inspectors/herdr/actions.ts +2 -1
- package/src/inspectors/herdr/inspector-runner.ts +21 -23
- package/src/inspectors/herdr/session-roots-codec.ts +42 -0
- package/src/integrations/herdr-status.ts +51 -3
- package/src/intercom/native-supervisor-channel.ts +138 -60
- package/src/intercom/result-intercom.ts +7 -0
- package/src/intercom/supervisor-ui.ts +243 -0
- package/src/profiles/profiles.ts +5 -6
- package/src/runs/background/active-async-capacity.ts +103 -18
- package/src/runs/background/async-execution.ts +417 -133
- package/src/runs/background/async-job-tracker.ts +95 -15
- package/src/runs/background/async-resume.ts +60 -28
- package/src/runs/background/async-retention.ts +20 -3
- package/src/runs/background/async-status-snapshot.ts +23 -261
- package/src/runs/background/async-status.ts +204 -14
- package/src/runs/background/auto-drain.ts +1 -1
- package/src/runs/background/chain-append.ts +8 -3
- package/src/runs/background/chain-root-attachment.ts +74 -8
- package/src/runs/background/control-channel.ts +4 -205
- package/src/runs/background/fleet-view.ts +38 -22
- package/src/runs/background/inspect-rpc.ts +8 -8
- package/src/runs/background/notify.ts +238 -12
- package/src/runs/background/process-terminal.ts +16 -0
- package/src/runs/background/result-delivery-ownership.ts +45 -0
- package/src/runs/background/result-files.ts +28 -14
- package/src/runs/background/result-watcher.ts +39 -16
- package/src/runs/background/resume-guidance.ts +2 -2
- package/src/runs/background/retained-children.ts +1 -1
- package/src/runs/background/run-child-session.ts +613 -0
- package/src/runs/background/run-status.ts +84 -17
- package/src/runs/background/runner-aliases.ts +125 -0
- package/src/runs/background/runner-child-sessions.ts +31 -0
- package/src/runs/background/scheduled-runs.ts +174 -18
- package/src/runs/background/stale-run-reconciler.ts +10 -4
- package/src/runs/background/steering.ts +8 -15
- package/src/runs/background/subagent-runner.ts +718 -1161
- package/src/runs/background/subagent-wait.ts +86 -31
- package/src/runs/background/terminal-run-index.ts +1 -1
- package/src/runs/background/wait-completions.ts +43 -2
- package/src/runs/background/wait-config.ts +23 -9
- package/src/runs/background/wait-tool.ts +26 -19
- package/src/runs/foreground/async-steering-action.ts +3 -19
- package/src/runs/foreground/execution.ts +489 -499
- package/src/runs/foreground/foreground-control.ts +13 -0
- package/src/runs/foreground/foreground-history.ts +23 -1
- package/src/runs/foreground/subagent-executor.ts +1223 -402
- package/src/runs/foreground/workflow-detach-reconcile.ts +140 -115
- package/src/runs/foreground/workflow-foreground-steering.ts +24 -98
- package/src/runs/shared/abort-recovery.ts +119 -0
- package/src/runs/shared/acceptance.ts +138 -36
- package/src/runs/shared/async-status-projection.ts +565 -0
- package/src/runs/shared/background-process-options.ts +9 -0
- package/src/runs/shared/capability-ceiling.ts +2 -2
- package/src/runs/shared/child-hooks.ts +25 -0
- package/src/runs/shared/child-identity.ts +32 -6
- package/src/runs/shared/child-launch-plan.ts +151 -0
- package/src/runs/shared/child-launch.ts +364 -0
- package/src/runs/shared/child-lifecycle.ts +25 -0
- package/src/runs/shared/child-runtime-config.ts +126 -0
- package/src/runs/shared/child-session.ts +366 -0
- package/src/runs/shared/child-tool-plan.ts +632 -0
- package/src/runs/shared/claude-code-adapter.ts +133 -0
- package/src/runs/shared/codex-exec-adapter.ts +129 -0
- package/src/runs/shared/completion-evidence.ts +89 -0
- package/src/runs/shared/completion-guard.ts +6 -5
- package/src/runs/shared/cursor-agent-adapter.ts +114 -0
- package/src/runs/shared/dynamic-fanout.ts +3 -3
- package/src/runs/shared/external-cli-contract.ts +167 -0
- package/src/runs/shared/external-cli-preflight.ts +138 -0
- package/src/runs/shared/external-cli-runner.ts +348 -55
- package/src/runs/shared/fast-mode-extension.ts +5 -5
- package/src/runs/shared/host-step-status.ts +231 -0
- package/src/runs/shared/lane-metadata.ts +126 -0
- package/src/runs/shared/launch-cwd.ts +16 -0
- package/src/runs/shared/long-running-guard.ts +2 -1
- package/src/runs/shared/mcp-config-sources.ts +422 -0
- package/src/runs/shared/mcp-direct-tool-allowlist.ts +222 -158
- package/src/runs/shared/mcp-direct-tool-grant.ts +194 -0
- package/src/runs/shared/model-exclusions.ts +139 -9
- package/src/runs/shared/model-fallback.ts +146 -14
- package/src/runs/shared/mutation-evidence.ts +57 -3
- package/src/runs/shared/nested-events.ts +99 -77
- package/src/runs/shared/nested-path.ts +0 -14
- package/src/runs/shared/nested-render.ts +9 -5
- package/src/runs/shared/orca-progress-tabs.ts +12 -7
- package/src/runs/shared/parallel-handoff.ts +423 -7
- package/src/runs/shared/parallel-utils.ts +20 -7
- package/src/runs/shared/permissions.ts +1 -14
- package/src/runs/shared/pi-spawn.ts +69 -35
- package/src/runs/shared/process-signal.ts +16 -0
- package/src/runs/shared/run-fanout-budget.ts +0 -13
- package/src/runs/shared/run-history.ts +21 -1
- package/src/runs/shared/runtime-acknowledged-extensions.ts +0 -27
- package/src/runs/shared/sandbox-profile-guard.ts +85 -0
- package/src/runs/shared/sandbox-startup-diagnostics.ts +54 -0
- package/src/runs/shared/single-output.ts +89 -22
- package/src/runs/shared/structured-output.ts +49 -9
- package/src/runs/shared/subagent-control.ts +6 -2
- package/src/runs/shared/subagent-prompt-runtime.ts +188 -365
- package/src/runs/shared/task-intent.ts +21 -7
- package/src/runs/shared/tool-availability.ts +18 -62
- package/src/runs/shared/tool-budget.ts +0 -14
- package/src/runs/shared/tool-timeout.ts +1 -1
- package/src/runs/shared/workflow-graph.ts +16 -0
- package/src/runs/shared/worktree-cleanup-plan.ts +866 -0
- package/src/runs/shared/worktree.ts +571 -62
- package/src/shared/atomic-json.ts +3 -1
- package/src/shared/child-session-name.ts +46 -0
- package/src/shared/extension-context.ts +24 -0
- package/src/shared/fork-context.ts +21 -12
- package/src/shared/fork-session-cwd.ts +27 -0
- package/src/shared/formatters.ts +18 -3
- package/src/shared/jsonl-writer.ts +11 -0
- package/src/shared/launch-contract.ts +11 -1
- package/src/shared/pruned-fork.ts +450 -0
- package/src/shared/sandbox-profile.ts +23 -0
- package/src/shared/session-file-trust.ts +19 -0
- package/src/shared/session-tokens.ts +14 -3
- package/src/shared/settings.ts +19 -105
- package/src/shared/shortcuts.ts +17 -0
- package/src/shared/thinking-ceiling.ts +0 -6
- package/src/shared/types.ts +545 -70
- package/src/shared/utils.ts +60 -93
- package/src/shared/workflow-child-permit.ts +207 -0
- package/src/slash/delegation-adapters.ts +1 -9
- package/src/slash/delegation-request.ts +0 -4
- package/src/slash/prompt-template-bridge.ts +37 -1
- package/src/slash/slash-bridge.ts +1 -2
- package/src/slash/slash-commands.ts +383 -116
- package/src/slash/slash-live-state.ts +22 -11
- package/src/slash/subagents-admin.ts +29 -12
- package/src/tui/fleet-native-transcript.ts +4 -0
- package/src/tui/fleet-status.ts +217 -82
- package/src/tui/fleet-transcript.ts +11 -5
- package/src/tui/fleet.ts +54 -28
- package/src/tui/render-helpers.ts +31 -0
- package/src/tui/render.ts +1429 -163
- package/src/watchdog/change-signature.ts +40 -1
- package/src/watchdog/child-status.ts +54 -34
- package/src/watchdog/diff-tool.ts +77 -0
- package/src/watchdog/emission-guard.ts +5 -3
- package/src/watchdog/guidance.ts +20 -0
- package/src/watchdog/register-child.ts +28 -25
- package/src/watchdog/register-main.ts +10 -9
- package/src/watchdog/render.ts +4 -5
- package/src/watchdog/review.ts +15 -4
- package/src/watchdog/rules.ts +70 -0
- package/src/watchdog/runtime.ts +75 -92
- package/src/watchdog/scope.ts +0 -11
- package/src/watchdog/settings.ts +48 -104
- package/src/watchdog/turn-delta.ts +1 -1
- package/src/watchdog/types.ts +18 -32
- package/src/watchdog/warning-format.ts +0 -1
- package/src/workflows/chat-progress.ts +7 -3
- package/src/workflows/host-command.ts +235 -0
- package/src/workflows/scripted-workflow.ts +988 -59
- package/src/workflows/workflow-checklist.ts +439 -0
- package/src/workflows/workflow-child-summary.ts +121 -0
- package/src/workflows/workflow-preflight.ts +297 -0
- package/src/workflows/workflow-receipt.ts +232 -6
- package/src/workflows/workflow-resources.ts +150 -0
- package/src/workflows/workflow-settlement.ts +246 -0
- package/src/runs/shared/child-protocol.ts +0 -401
- package/src/runs/shared/pi-args.ts +0 -935
- package/src/runs/shared/subagent-startup-retry.ts +0 -116
- package/src/runs/shared/turn-budget.ts +0 -98
- package/src/shared/post-exit-stdio-guard.ts +0 -85
|
@@ -1,116 +0,0 @@
|
|
|
1
|
-
import type { Usage } from "../../shared/types.ts";
|
|
2
|
-
import { formatProcessSignalError } from "./process-signal.ts";
|
|
3
|
-
|
|
4
|
-
/**
|
|
5
|
-
* Retry delays for child processes that exit before any model or tool activity.
|
|
6
|
-
* The schedule is intentionally short and bounded to avoid amplifying persistent
|
|
7
|
-
* launch failures while allowing concurrent Pi startup locks to clear.
|
|
8
|
-
*/
|
|
9
|
-
export const SUBAGENT_STARTUP_RETRY_DELAYS_MS = [250, 750, 1500] as const;
|
|
10
|
-
|
|
11
|
-
/** A genuine startup race should fail well before a model request can complete. */
|
|
12
|
-
export const MAX_SUBAGENT_STARTUP_FAILURE_DURATION_MS = 2000;
|
|
13
|
-
|
|
14
|
-
const SIGKILL_PROCESS_SIGNAL_ERROR = formatProcessSignalError("SIGKILL");
|
|
15
|
-
const EXTENSION_REGISTRATION_CONFLICT_PATTERN = /Failed to load extension\b[^\n]*:\s*(?:Tool|Flag)\s+"[^"]+"\s+conflicts with\b/i;
|
|
16
|
-
|
|
17
|
-
export interface SubagentStartupFailureEvidence {
|
|
18
|
-
exitCode: number | null | undefined;
|
|
19
|
-
error?: string;
|
|
20
|
-
finalOutput?: string;
|
|
21
|
-
messageCount: number;
|
|
22
|
-
toolCount: number;
|
|
23
|
-
usage: Usage;
|
|
24
|
-
durationMs: number;
|
|
25
|
-
protocolError?: unknown;
|
|
26
|
-
processSignal?: string | null;
|
|
27
|
-
observedMutationAttempt?: boolean;
|
|
28
|
-
detached?: boolean;
|
|
29
|
-
interrupted?: boolean;
|
|
30
|
-
timedOut?: boolean;
|
|
31
|
-
stopped?: boolean;
|
|
32
|
-
turnBudgetExceeded?: boolean;
|
|
33
|
-
}
|
|
34
|
-
|
|
35
|
-
export function formatSubagentExtensionConflictError(
|
|
36
|
-
error: string | undefined,
|
|
37
|
-
input: { agent: string; ambientExtensionsEnabled: boolean },
|
|
38
|
-
): string | undefined {
|
|
39
|
-
if (!error || !input.ambientExtensionsEnabled || !EXTENSION_REGISTRATION_CONFLICT_PATTERN.test(error)) return error;
|
|
40
|
-
const settings = JSON.stringify({
|
|
41
|
-
subagents: { agentOverrides: { [input.agent]: { extensions: [] } } },
|
|
42
|
-
});
|
|
43
|
-
return `${error}\n\nSubagent startup loaded conflicting ambient Pi extensions. Retry this run after disabling ambient extension discovery for agent ${JSON.stringify(input.agent)} in project .pi/settings.json: ${settings}. Replace the empty array with only the required extension entry paths when this agent needs extension tools.`;
|
|
44
|
-
}
|
|
45
|
-
|
|
46
|
-
function hasUsage(usage: Usage): boolean {
|
|
47
|
-
return usage.input !== 0
|
|
48
|
-
|| usage.output !== 0
|
|
49
|
-
|| usage.cacheRead !== 0
|
|
50
|
-
|| usage.cacheWrite !== 0
|
|
51
|
-
|| usage.cost !== 0
|
|
52
|
-
|| usage.turns !== 0;
|
|
53
|
-
}
|
|
54
|
-
|
|
55
|
-
/**
|
|
56
|
-
* Classify only unexplained, zero-activity child exits as startup failures.
|
|
57
|
-
* This intentionally fails closed: any model output, tool activity, usage,
|
|
58
|
-
* mutation evidence, diagnostic, or lifecycle interruption prevents a retry.
|
|
59
|
-
*/
|
|
60
|
-
export function isRetryableSubagentStartupFailure(evidence: SubagentStartupFailureEvidence): boolean {
|
|
61
|
-
return evidence.exitCode !== undefined
|
|
62
|
-
&& evidence.exitCode !== null
|
|
63
|
-
&& evidence.exitCode !== 0
|
|
64
|
-
&& (!evidence.error?.trim() || evidence.error === SIGKILL_PROCESS_SIGNAL_ERROR)
|
|
65
|
-
&& !evidence.finalOutput?.trim()
|
|
66
|
-
&& evidence.messageCount === 0
|
|
67
|
-
&& evidence.toolCount === 0
|
|
68
|
-
&& !hasUsage(evidence.usage)
|
|
69
|
-
&& evidence.durationMs >= 0
|
|
70
|
-
&& evidence.durationMs <= MAX_SUBAGENT_STARTUP_FAILURE_DURATION_MS
|
|
71
|
-
&& evidence.protocolError === undefined
|
|
72
|
-
&& (evidence.processSignal === undefined || evidence.processSignal === null || evidence.processSignal === "SIGKILL")
|
|
73
|
-
&& evidence.observedMutationAttempt !== true
|
|
74
|
-
&& evidence.detached !== true
|
|
75
|
-
&& evidence.interrupted !== true
|
|
76
|
-
&& evidence.timedOut !== true
|
|
77
|
-
&& evidence.stopped !== true
|
|
78
|
-
&& evidence.turnBudgetExceeded !== true;
|
|
79
|
-
}
|
|
80
|
-
|
|
81
|
-
export function formatSubagentStartupRetryNote(input: {
|
|
82
|
-
model: string;
|
|
83
|
-
attempt: number;
|
|
84
|
-
maxAttempts: number;
|
|
85
|
-
delayMs: number;
|
|
86
|
-
}): string {
|
|
87
|
-
return `[startup-retry] ${input.model} exited before model or tool activity (attempt ${input.attempt}/${input.maxAttempts}). Retrying the same model in ${input.delayMs}ms.`;
|
|
88
|
-
}
|
|
89
|
-
|
|
90
|
-
export function formatSubagentStartupRetryExhaustedError(input: {
|
|
91
|
-
model: string;
|
|
92
|
-
attempts: number;
|
|
93
|
-
}): string {
|
|
94
|
-
return `Subagent failed to start after ${input.attempts} attempts on ${input.model}; no model, tool, output, usage, or diagnostic activity was observed. This may be a concurrent Pi startup race. Retry the run or temporarily lower subagent concurrency.`;
|
|
95
|
-
}
|
|
96
|
-
|
|
97
|
-
/** Wait for a retry delay, returning false when any lifecycle signal aborts it. */
|
|
98
|
-
export async function waitForSubagentStartupRetry(delayMs: number, signals: Array<AbortSignal | undefined>): Promise<boolean> {
|
|
99
|
-
const activeSignals = signals.filter((signal): signal is AbortSignal => Boolean(signal));
|
|
100
|
-
if (activeSignals.some((signal) => signal.aborted)) return false;
|
|
101
|
-
if (delayMs <= 0) return true;
|
|
102
|
-
|
|
103
|
-
return await new Promise<boolean>((resolve) => {
|
|
104
|
-
let settled = false;
|
|
105
|
-
const finish = (shouldRetry: boolean): void => {
|
|
106
|
-
if (settled) return;
|
|
107
|
-
settled = true;
|
|
108
|
-
clearTimeout(timer);
|
|
109
|
-
for (const signal of activeSignals) signal.removeEventListener("abort", abort);
|
|
110
|
-
resolve(shouldRetry);
|
|
111
|
-
};
|
|
112
|
-
const abort = (): void => finish(false);
|
|
113
|
-
const timer = setTimeout(() => finish(true), delayMs);
|
|
114
|
-
for (const signal of activeSignals) signal.addEventListener("abort", abort, { once: true });
|
|
115
|
-
});
|
|
116
|
-
}
|
|
@@ -1,98 +0,0 @@
|
|
|
1
|
-
import type { ResolvedTurnBudget, TurnBudgetState } from "../../shared/types.ts";
|
|
2
|
-
|
|
3
|
-
export const DEFAULT_TURN_BUDGET_GRACE_TURNS = 1;
|
|
4
|
-
|
|
5
|
-
export function resolveTurnBudgetConfig(
|
|
6
|
-
raw: unknown,
|
|
7
|
-
label = "turnBudget",
|
|
8
|
-
): { turnBudget?: ResolvedTurnBudget; error?: string } {
|
|
9
|
-
if (raw === undefined) return {};
|
|
10
|
-
if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
|
|
11
|
-
return { error: `${label} must be an object with maxTurns and optional graceTurns.` };
|
|
12
|
-
}
|
|
13
|
-
const unknownField = Object.keys(raw).find((key) => key !== "maxTurns" && key !== "graceTurns");
|
|
14
|
-
if (unknownField) return { error: `${label}.${unknownField} is not supported.` };
|
|
15
|
-
const budget = raw as { maxTurns?: unknown; graceTurns?: unknown };
|
|
16
|
-
if (typeof budget.maxTurns !== "number" || !Number.isInteger(budget.maxTurns) || budget.maxTurns < 1) {
|
|
17
|
-
return { error: `${label}.maxTurns must be an integer >= 1.` };
|
|
18
|
-
}
|
|
19
|
-
const graceTurns = budget.graceTurns ?? DEFAULT_TURN_BUDGET_GRACE_TURNS;
|
|
20
|
-
if (typeof graceTurns !== "number" || !Number.isInteger(graceTurns) || graceTurns < 0) {
|
|
21
|
-
return { error: `${label}.graceTurns must be an integer >= 0.` };
|
|
22
|
-
}
|
|
23
|
-
return { turnBudget: { maxTurns: budget.maxTurns, graceTurns } };
|
|
24
|
-
}
|
|
25
|
-
|
|
26
|
-
export function appendTurnBudgetSystemPrompt(systemPrompt: string, budget: { maxTurns: number; graceTurns?: number } | undefined): string {
|
|
27
|
-
if (!budget) return systemPrompt;
|
|
28
|
-
const graceTurns = budget.graceTurns ?? DEFAULT_TURN_BUDGET_GRACE_TURNS;
|
|
29
|
-
const grace = graceTurns === 1 ? "1 additional assistant turn" : `${graceTurns} additional assistant turns`;
|
|
30
|
-
const block = [
|
|
31
|
-
"## Turn budget",
|
|
32
|
-
`This child run has a soft budget of ${budget.maxTurns} assistant turn${budget.maxTurns === 1 ? "" : "s"}.`,
|
|
33
|
-
`After that, ${grace} may be allowed only for a final wrap-up.`,
|
|
34
|
-
"When you approach or reach the soft budget, stop starting new tool work and return the final answer immediately.",
|
|
35
|
-
"This runner uses process-mode execution, so live steering after launch may be unavailable; treat this instruction as the wrap-up request.",
|
|
36
|
-
"If you continue past the soft budget plus grace turns, the supervisor may abort the process and return only partial output.",
|
|
37
|
-
].join("\n");
|
|
38
|
-
return systemPrompt.trim() ? `${systemPrompt.trim()}\n\n${block}` : block;
|
|
39
|
-
}
|
|
40
|
-
|
|
41
|
-
export function turnBudgetSoftNote(budget: ResolvedTurnBudget, turnCount: number): string {
|
|
42
|
-
return `Turn budget wrap-up was requested after ${turnCount} assistant turn${turnCount === 1 ? "" : "s"} (soft limit ${budget.maxTurns}, grace ${budget.graceTurns}). Process-mode live steering is unavailable, so the child was warned at launch to wrap up by this budget. Output may be partial.`;
|
|
43
|
-
}
|
|
44
|
-
|
|
45
|
-
export function turnBudgetExceededMessage(budget: ResolvedTurnBudget, turnCount: number): string {
|
|
46
|
-
return `Subagent exceeded turn budget after ${turnCount} assistant turn${turnCount === 1 ? "" : "s"} (soft limit ${budget.maxTurns} + grace ${budget.graceTurns}).`;
|
|
47
|
-
}
|
|
48
|
-
|
|
49
|
-
export function turnBudgetDeferredNote(budget: ResolvedTurnBudget, turnCount: number): string {
|
|
50
|
-
return `Turn-budget termination was deferred at ${turnCount} assistant turn${turnCount === 1 ? "" : "s"} (soft limit ${budget.maxTurns} + grace ${budget.graceTurns}) because the assistant started tool work. The run ended before another safe assistant boundary; output may be partial.`;
|
|
51
|
-
}
|
|
52
|
-
|
|
53
|
-
export function formatTurnBudgetOutput(message: string, output: string): string {
|
|
54
|
-
return output.trim()
|
|
55
|
-
? `${message}\n\nPartial output before turn-budget abort:\n${output}`
|
|
56
|
-
: message;
|
|
57
|
-
}
|
|
58
|
-
|
|
59
|
-
export function initialTurnBudgetState(budget: { maxTurns: number; graceTurns?: number }): TurnBudgetState {
|
|
60
|
-
return { maxTurns: budget.maxTurns, graceTurns: budget.graceTurns ?? DEFAULT_TURN_BUDGET_GRACE_TURNS, outcome: "within-budget", turnCount: 0 };
|
|
61
|
-
}
|
|
62
|
-
|
|
63
|
-
export function turnBudgetState(budget: ResolvedTurnBudget, turnCount: number, exceeded: boolean): TurnBudgetState {
|
|
64
|
-
return {
|
|
65
|
-
...budget,
|
|
66
|
-
turnCount,
|
|
67
|
-
outcome: exceeded ? "exceeded" : "wrap-up-requested",
|
|
68
|
-
wrapUpRequestedAtTurn: budget.maxTurns,
|
|
69
|
-
...(exceeded ? { exceededAtTurn: turnCount } : {}),
|
|
70
|
-
};
|
|
71
|
-
}
|
|
72
|
-
|
|
73
|
-
export function turnBudgetDeferredState(
|
|
74
|
-
budget: ResolvedTurnBudget,
|
|
75
|
-
turnCount: number,
|
|
76
|
-
terminationDeferredAtTurn = turnCount,
|
|
77
|
-
): TurnBudgetState {
|
|
78
|
-
return {
|
|
79
|
-
...budget,
|
|
80
|
-
turnCount,
|
|
81
|
-
outcome: "termination-deferred",
|
|
82
|
-
wrapUpRequestedAtTurn: budget.maxTurns,
|
|
83
|
-
terminationDeferredAtTurn,
|
|
84
|
-
};
|
|
85
|
-
}
|
|
86
|
-
|
|
87
|
-
export function turnBudgetDecision(
|
|
88
|
-
budget: ResolvedTurnBudget,
|
|
89
|
-
turnCount: number,
|
|
90
|
-
terminalAssistantStop: boolean,
|
|
91
|
-
toolWorkActiveOrStarting: boolean,
|
|
92
|
-
enforceHardLimit = false,
|
|
93
|
-
): "continue" | "defer" | "abort" {
|
|
94
|
-
const hardLimit = budget.maxTurns + budget.graceTurns;
|
|
95
|
-
if (terminalAssistantStop || turnCount < hardLimit) return "continue";
|
|
96
|
-
if (toolWorkActiveOrStarting && !enforceHardLimit) return "defer";
|
|
97
|
-
return "abort";
|
|
98
|
-
}
|
|
@@ -1,85 +0,0 @@
|
|
|
1
|
-
import type { ChildProcess } from "node:child_process";
|
|
2
|
-
|
|
3
|
-
interface PostExitStdioGuardOptions {
|
|
4
|
-
idleMs: number;
|
|
5
|
-
hardMs: number;
|
|
6
|
-
}
|
|
7
|
-
|
|
8
|
-
interface ChildWithPipedStdio {
|
|
9
|
-
stdout: ChildProcess["stdout"];
|
|
10
|
-
stderr: ChildProcess["stderr"];
|
|
11
|
-
on: ChildProcess["on"];
|
|
12
|
-
}
|
|
13
|
-
|
|
14
|
-
interface ChildWithKill {
|
|
15
|
-
kill(signal?: NodeJS.Signals | number): boolean;
|
|
16
|
-
}
|
|
17
|
-
|
|
18
|
-
export function trySignalChild(child: ChildWithKill, signal: NodeJS.Signals): boolean {
|
|
19
|
-
try {
|
|
20
|
-
return child.kill(signal);
|
|
21
|
-
} catch {
|
|
22
|
-
return false;
|
|
23
|
-
}
|
|
24
|
-
}
|
|
25
|
-
|
|
26
|
-
export function attachPostExitStdioGuard(
|
|
27
|
-
child: ChildWithPipedStdio,
|
|
28
|
-
options: PostExitStdioGuardOptions,
|
|
29
|
-
): () => void {
|
|
30
|
-
const { idleMs, hardMs } = options;
|
|
31
|
-
let exited = false;
|
|
32
|
-
let stdoutEnded = false;
|
|
33
|
-
let stderrEnded = false;
|
|
34
|
-
let idleTimer: NodeJS.Timeout | undefined;
|
|
35
|
-
let hardTimer: NodeJS.Timeout | undefined;
|
|
36
|
-
|
|
37
|
-
const destroyUnendedStdio = () => {
|
|
38
|
-
if (!stdoutEnded) {
|
|
39
|
-
try { child.stdout?.destroy(); } catch {}
|
|
40
|
-
}
|
|
41
|
-
if (!stderrEnded) {
|
|
42
|
-
try { child.stderr?.destroy(); } catch {}
|
|
43
|
-
}
|
|
44
|
-
};
|
|
45
|
-
|
|
46
|
-
const clearTimers = () => {
|
|
47
|
-
if (idleTimer) {
|
|
48
|
-
clearTimeout(idleTimer);
|
|
49
|
-
idleTimer = undefined;
|
|
50
|
-
}
|
|
51
|
-
if (hardTimer) {
|
|
52
|
-
clearTimeout(hardTimer);
|
|
53
|
-
hardTimer = undefined;
|
|
54
|
-
}
|
|
55
|
-
};
|
|
56
|
-
|
|
57
|
-
const armIdleTimer = () => {
|
|
58
|
-
if (!exited) return;
|
|
59
|
-
if (idleTimer) clearTimeout(idleTimer);
|
|
60
|
-
idleTimer = setTimeout(destroyUnendedStdio, idleMs);
|
|
61
|
-
idleTimer.unref?.();
|
|
62
|
-
};
|
|
63
|
-
|
|
64
|
-
child.stdout?.on("data", armIdleTimer);
|
|
65
|
-
child.stderr?.on("data", armIdleTimer);
|
|
66
|
-
child.stdout?.on("end", () => {
|
|
67
|
-
stdoutEnded = true;
|
|
68
|
-
if (stdoutEnded && stderrEnded) clearTimers();
|
|
69
|
-
});
|
|
70
|
-
child.stderr?.on("end", () => {
|
|
71
|
-
stderrEnded = true;
|
|
72
|
-
if (stdoutEnded && stderrEnded) clearTimers();
|
|
73
|
-
});
|
|
74
|
-
child.on("exit", () => {
|
|
75
|
-
exited = true;
|
|
76
|
-
armIdleTimer();
|
|
77
|
-
if (hardTimer) return;
|
|
78
|
-
hardTimer = setTimeout(destroyUnendedStdio, hardMs);
|
|
79
|
-
hardTimer.unref?.();
|
|
80
|
-
});
|
|
81
|
-
child.on("close", clearTimers);
|
|
82
|
-
child.on("error", clearTimers);
|
|
83
|
-
|
|
84
|
-
return clearTimers;
|
|
85
|
-
}
|