@xzzpig/pi-subagents 0.8.0 → 0.9.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 +443 -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 +151 -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 +5 -4
- 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 +370 -114
- package/src/agents/agent-refinements.ts +4 -4
- package/src/agents/agent-serializer.ts +12 -2
- package/src/agents/agents.ts +919 -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 +31 -20
- 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 +48 -18
- 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 +57 -21
- 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 +2 -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 +366 -128
- package/src/runs/background/async-job-tracker.ts +95 -15
- package/src/runs/background/async-resume.ts +45 -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 +189 -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 +676 -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 +468 -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 +1172 -400
- 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 +314 -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 +342 -0
- package/src/runs/shared/child-tool-plan.ts +540 -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 +142 -14
- package/src/runs/shared/mutation-evidence.ts +57 -3
- package/src/runs/shared/nested-events.ts +38 -48
- 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 +15 -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/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 +8 -1
- package/src/shared/pruned-fork.ts +450 -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 +524 -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
|
@@ -15,6 +15,7 @@ type AtomicJsonWriterOptions = {
|
|
|
15
15
|
mode?: number;
|
|
16
16
|
retryRenameErrors?: boolean;
|
|
17
17
|
retryDirectoryErrors?: boolean;
|
|
18
|
+
ignoreCleanupErrorAfterSuccess?: boolean;
|
|
18
19
|
retryDelaysMs?: readonly number[];
|
|
19
20
|
wait?: (delayMs: number) => void;
|
|
20
21
|
};
|
|
@@ -46,6 +47,7 @@ export function createAtomicJsonWriter(options: AtomicJsonWriterOptions = {}): (
|
|
|
46
47
|
const mode = options.mode;
|
|
47
48
|
const retryRenameErrors = options.retryRenameErrors ?? process.platform === "win32";
|
|
48
49
|
const retryDirectoryErrors = options.retryDirectoryErrors ?? retryRenameErrors;
|
|
50
|
+
const ignoreCleanupErrorAfterSuccess = options.ignoreCleanupErrorAfterSuccess ?? false;
|
|
49
51
|
const retryDelaysMs = options.retryDelaysMs ?? DEFAULT_FILE_SYSTEM_RETRY_DELAYS_MS;
|
|
50
52
|
const renameRetryDelaysMs = retryRenameErrors ? retryDelaysMs : [];
|
|
51
53
|
const directoryRetryDelaysMs = retryDirectoryErrors ? retryDelaysMs : [];
|
|
@@ -71,7 +73,7 @@ export function createAtomicJsonWriter(options: AtomicJsonWriterOptions = {}): (
|
|
|
71
73
|
} catch (cleanupError) {
|
|
72
74
|
// Preserve the write/rename failure: cleanup is best effort and must
|
|
73
75
|
// not hide the error callers need to classify or report.
|
|
74
|
-
if (writeError === undefined) throw cleanupError;
|
|
76
|
+
if (writeError === undefined && !ignoreCleanupErrorAfterSuccess) throw cleanupError;
|
|
75
77
|
}
|
|
76
78
|
}
|
|
77
79
|
};
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
import { previewDisplayText } from "./display-text.ts";
|
|
2
|
+
import { PROMPT_REDACTED } from "./utils.ts";
|
|
3
|
+
|
|
4
|
+
/**
|
|
5
|
+
* Human-readable display name for a child session, derived at launch time from
|
|
6
|
+
* the agent name and its task (or workflow node label). The parent computes it
|
|
7
|
+
* once and threads it two ways:
|
|
8
|
+
*
|
|
9
|
+
* 1. Into the child's runtime config as `sessionName`, where the prompt
|
|
10
|
+
* runtime calls `pi.setSessionName(...)` so the child's own session file
|
|
11
|
+
* is identifiable in `pi --resume` and host session browsers.
|
|
12
|
+
* 2. Into the `sessionName` field of result/progress payloads, so hosts
|
|
13
|
+
* rendering the parent stream can label each child row.
|
|
14
|
+
*
|
|
15
|
+
* The name is display-only metadata. When the intercom bridge is active the
|
|
16
|
+
* child keeps its machine intercom target as the session name instead — that
|
|
17
|
+
* name is a routing address and must win (see subagent-prompt-runtime).
|
|
18
|
+
*/
|
|
19
|
+
|
|
20
|
+
/** Longest task excerpt kept in the name; the full string is capped below. */
|
|
21
|
+
const TASK_EXCERPT_MAX_CHARS = 60;
|
|
22
|
+
/** Hard cap on the final name so host UI rows stay one line. */
|
|
23
|
+
export const CHILD_SESSION_NAME_MAX_CHARS = 80;
|
|
24
|
+
|
|
25
|
+
export function deriveChildSessionName(input: {
|
|
26
|
+
agent?: string;
|
|
27
|
+
task?: string;
|
|
28
|
+
/** Workflow node label; preferred over the task excerpt when present. */
|
|
29
|
+
label?: string;
|
|
30
|
+
}): string | undefined {
|
|
31
|
+
const agent = input.agent?.trim() ?? "";
|
|
32
|
+
const rawLabel = input.label?.trim() ?? "";
|
|
33
|
+
const rawTask = input.task?.trim() ?? "";
|
|
34
|
+
// Never build a name from redacted text — the excerpt would be meaningless
|
|
35
|
+
// and the redaction marker itself carries no information.
|
|
36
|
+
const excerptSource =
|
|
37
|
+
rawLabel && rawLabel !== PROMPT_REDACTED
|
|
38
|
+
? rawLabel
|
|
39
|
+
: rawTask && rawTask !== PROMPT_REDACTED
|
|
40
|
+
? rawTask
|
|
41
|
+
: "";
|
|
42
|
+
const excerpt = excerptSource ? previewDisplayText(excerptSource, TASK_EXCERPT_MAX_CHARS) : "";
|
|
43
|
+
const base = agent && excerpt ? `${agent}: ${excerpt}` : agent || excerpt;
|
|
44
|
+
if (!base) return undefined;
|
|
45
|
+
return previewDisplayText(base, CHILD_SESSION_NAME_MAX_CHARS);
|
|
46
|
+
}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
2
|
+
|
|
3
|
+
/** Pi exposes replaced extension contexts as ordinary Errors without a stable code. */
|
|
4
|
+
export function isStaleExtensionContextError(error: unknown): boolean {
|
|
5
|
+
return error instanceof Error
|
|
6
|
+
&& /extension ctx is stale|extension context no longer active|stale after session replacement or reload/i.test(error.message);
|
|
7
|
+
}
|
|
8
|
+
|
|
9
|
+
/** Run a synchronous operation against a cached UI context without leaking replacement errors. */
|
|
10
|
+
export function withCachedUiContext<T>(
|
|
11
|
+
ctx: ExtensionContext | null | undefined,
|
|
12
|
+
onStale: () => void,
|
|
13
|
+
run: (ctx: ExtensionContext) => T,
|
|
14
|
+
): T | undefined {
|
|
15
|
+
if (!ctx) return undefined;
|
|
16
|
+
try {
|
|
17
|
+
if (!ctx.hasUI) return undefined;
|
|
18
|
+
return run(ctx);
|
|
19
|
+
} catch (error) {
|
|
20
|
+
if (!isStaleExtensionContextError(error)) throw error;
|
|
21
|
+
onStale();
|
|
22
|
+
return undefined;
|
|
23
|
+
}
|
|
24
|
+
}
|
|
@@ -37,6 +37,8 @@ interface ForkableSessionManager {
|
|
|
37
37
|
|
|
38
38
|
interface ForkContextResolverOptions {
|
|
39
39
|
openSession?: (path: string, sessionDir?: string) => BranchSessionManager;
|
|
40
|
+
/** Rewrite a created fork before its path can be used to spawn a child. */
|
|
41
|
+
pruneSession?: (sessionFile: string) => Promise<void>;
|
|
40
42
|
/** Decide per child index whether a sanitized transcript must also disable the child's
|
|
41
43
|
* thinking. Defaults to true (the pre-existing conservative behavior) when omitted. */
|
|
42
44
|
forceThinkingOffForIndex?: (index: number) => boolean;
|
|
@@ -48,6 +50,7 @@ interface ForkContextResolution {
|
|
|
48
50
|
}
|
|
49
51
|
|
|
50
52
|
interface ForkContextResolver {
|
|
53
|
+
prepareSessionForIndex(index?: number): Promise<void>;
|
|
51
54
|
sessionFileForIndex(index?: number): string | undefined;
|
|
52
55
|
thinkingOverrideForIndex(index?: number): "off" | undefined;
|
|
53
56
|
}
|
|
@@ -171,18 +174,6 @@ function readSessionEntries(sessionFile: string): BranchSessionEntry[] {
|
|
|
171
174
|
});
|
|
172
175
|
}
|
|
173
176
|
|
|
174
|
-
/** Keep Pi from restoring a forked session into the parent's cwd instead of the child launch cwd. */
|
|
175
|
-
export function alignForkedSessionCwd(sessionFile: string, cwd: string): void {
|
|
176
|
-
const entries = readSessionEntries(sessionFile);
|
|
177
|
-
const header = entries[0];
|
|
178
|
-
if (header?.type !== "session") throw new Error(`Forked session ${sessionFile} does not start with a session header.`);
|
|
179
|
-
const resolvedCwd = path.resolve(cwd);
|
|
180
|
-
const effectiveCwd = fs.realpathSync.native(resolvedCwd);
|
|
181
|
-
if (header.cwd === effectiveCwd) return;
|
|
182
|
-
header.cwd = effectiveCwd;
|
|
183
|
-
fs.writeFileSync(sessionFile, `${entries.map((entry) => JSON.stringify(entry)).join("\n")}\n`, "utf-8");
|
|
184
|
-
}
|
|
185
|
-
|
|
186
177
|
export function createForkContextResolver(
|
|
187
178
|
sessionManager: ForkableSessionManager,
|
|
188
179
|
requestedContext: unknown,
|
|
@@ -190,6 +181,7 @@ export function createForkContextResolver(
|
|
|
190
181
|
): ForkContextResolver {
|
|
191
182
|
if (resolveSubagentContext(requestedContext) !== "fork") {
|
|
192
183
|
return {
|
|
184
|
+
prepareSessionForIndex: async () => {},
|
|
193
185
|
sessionFileForIndex: () => undefined,
|
|
194
186
|
thinkingOverrideForIndex: () => undefined,
|
|
195
187
|
};
|
|
@@ -226,6 +218,8 @@ export function createForkContextResolver(
|
|
|
226
218
|
"forks",
|
|
227
219
|
);
|
|
228
220
|
const cachedResolutions = new Map<number, ForkContextResolution>();
|
|
221
|
+
const preparedIndexes = new Set<number>();
|
|
222
|
+
const preparationPromises = new Map<number, Promise<void>>();
|
|
229
223
|
|
|
230
224
|
const resolveFork = (index = 0): ForkContextResolution => {
|
|
231
225
|
const cached = cachedResolutions.get(index);
|
|
@@ -274,7 +268,22 @@ export function createForkContextResolver(
|
|
|
274
268
|
};
|
|
275
269
|
|
|
276
270
|
return {
|
|
271
|
+
async prepareSessionForIndex(index = 0): Promise<void> {
|
|
272
|
+
const resolution = resolveFork(index);
|
|
273
|
+
if (!options.pruneSession || preparedIndexes.has(index)) return;
|
|
274
|
+
let preparation = preparationPromises.get(index);
|
|
275
|
+
if (!preparation) {
|
|
276
|
+
preparation = options.pruneSession(resolution.sessionFile).then(() => {
|
|
277
|
+
preparedIndexes.add(index);
|
|
278
|
+
});
|
|
279
|
+
preparationPromises.set(index, preparation);
|
|
280
|
+
}
|
|
281
|
+
await preparation;
|
|
282
|
+
},
|
|
277
283
|
sessionFileForIndex(index = 0): string | undefined {
|
|
284
|
+
if (options.pruneSession && !preparedIndexes.has(index)) {
|
|
285
|
+
throw new Error(`Pruned fork session ${index} was used before pruning completed.`);
|
|
286
|
+
}
|
|
278
287
|
return resolveFork(index).sessionFile;
|
|
279
288
|
},
|
|
280
289
|
thinkingOverrideForIndex(index = 0): "off" | undefined {
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import * as fs from "node:fs";
|
|
2
|
+
import * as path from "node:path";
|
|
3
|
+
|
|
4
|
+
interface SessionEntry {
|
|
5
|
+
type?: string;
|
|
6
|
+
cwd?: string;
|
|
7
|
+
[key: string]: unknown;
|
|
8
|
+
}
|
|
9
|
+
|
|
10
|
+
/** Keep Pi from restoring a forked session into the parent's cwd instead of the child launch cwd. */
|
|
11
|
+
export function alignForkedSessionCwd(sessionFile: string, cwd: string): void {
|
|
12
|
+
const lines = fs.readFileSync(sessionFile, "utf-8").split("\n").filter((line) => line.trim().length > 0);
|
|
13
|
+
const entries = lines.map((line, index) => {
|
|
14
|
+
try {
|
|
15
|
+
return JSON.parse(line) as SessionEntry;
|
|
16
|
+
} catch (error) {
|
|
17
|
+
const cause = error instanceof Error ? error : new Error(String(error));
|
|
18
|
+
throw new Error(`Unable to inspect forked session ${sessionFile}: invalid JSONL on line ${index + 1}: ${cause.message}`, { cause });
|
|
19
|
+
}
|
|
20
|
+
});
|
|
21
|
+
const header = entries[0];
|
|
22
|
+
if (header?.type !== "session") throw new Error(`Forked session ${sessionFile} does not start with a session header.`);
|
|
23
|
+
const effectiveCwd = fs.realpathSync.native(path.resolve(cwd));
|
|
24
|
+
if (header.cwd === effectiveCwd) return;
|
|
25
|
+
header.cwd = effectiveCwd;
|
|
26
|
+
fs.writeFileSync(sessionFile, `${entries.map((entry) => JSON.stringify(entry)).join("\n")}\n`, "utf-8");
|
|
27
|
+
}
|
package/src/shared/formatters.ts
CHANGED
|
@@ -4,17 +4,32 @@
|
|
|
4
4
|
|
|
5
5
|
import * as fs from "node:fs";
|
|
6
6
|
import * as path from "node:path";
|
|
7
|
-
import type { Usage, SingleResult } from "./types.ts";
|
|
7
|
+
import type { Usage, SingleResult, TokenUsage } from "./types.ts";
|
|
8
8
|
import type { ChainStep } from "./settings.ts";
|
|
9
9
|
import { isDynamicParallelStep, isParallelStep } from "./settings.ts";
|
|
10
10
|
import { previewDisplayText, sanitizeDisplayText } from "./display-text.ts";
|
|
11
11
|
import { splitKnownThinkingSuffix, THINKING_LEVELS } from "./model-info.ts";
|
|
12
12
|
|
|
13
13
|
/**
|
|
14
|
-
* Format token count
|
|
14
|
+
* Format token count for compact display.
|
|
15
15
|
*/
|
|
16
16
|
export function formatTokens(n: number): string {
|
|
17
|
-
|
|
17
|
+
if (n < 1000) return String(n);
|
|
18
|
+
if (n < 10000) return `${(n / 1000).toFixed(1)}k`;
|
|
19
|
+
if (n < 999_500) return `${Math.round(n / 1000)}k`;
|
|
20
|
+
return `${Number((n / 1_000_000).toFixed(1))}M`;
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
export function formatTokenUsage(usage: TokenUsage, legacyLabel = "tok"): string {
|
|
24
|
+
return usage.window !== undefined
|
|
25
|
+
? `${formatTokens(usage.window)} window · ${formatTokens(usage.total)} spent`
|
|
26
|
+
: `${formatTokens(usage.total)} ${legacyLabel}`;
|
|
27
|
+
}
|
|
28
|
+
export function formatContextUsage(usage: Pick<TokenUsage, "window" | "windowPeak">, contextLimit: number): string | undefined {
|
|
29
|
+
if (usage.window === undefined || !Number.isFinite(usage.window) || !Number.isFinite(contextLimit) || contextLimit <= 0) return undefined;
|
|
30
|
+
const peak = usage.windowPeak !== undefined && Number.isFinite(usage.windowPeak) ? usage.windowPeak : usage.window;
|
|
31
|
+
const used = Math.max(0, usage.window, peak);
|
|
32
|
+
return `ctx ${formatTokens(used)}/${formatTokens(contextLimit)} (${Math.round((used / contextLimit) * 100)}%)`;
|
|
18
33
|
}
|
|
19
34
|
|
|
20
35
|
export function formatModelThinking(model?: string, thinking?: string): string {
|
|
@@ -8,6 +8,7 @@ export interface DrainableSource {
|
|
|
8
8
|
export interface JsonlWriteStream {
|
|
9
9
|
write(chunk: string): boolean;
|
|
10
10
|
once(event: "drain", listener: () => void): JsonlWriteStream;
|
|
11
|
+
on?(event: "error", listener: (error: Error) => void): JsonlWriteStream;
|
|
11
12
|
end(callback?: () => void): void;
|
|
12
13
|
}
|
|
13
14
|
|
|
@@ -50,6 +51,16 @@ export function createJsonlWriter(
|
|
|
50
51
|
let closed = false;
|
|
51
52
|
let bytesWritten = 0;
|
|
52
53
|
const maxBytes = deps.maxBytes ?? DEFAULT_MAX_JSONL_BYTES;
|
|
54
|
+
// The mirror is best effort: a stream that cannot open or write (for example
|
|
55
|
+
// because its directory was removed) must not surface as an uncaught error.
|
|
56
|
+
stream.on?.("error", () => {
|
|
57
|
+
closed = true;
|
|
58
|
+
stream = undefined;
|
|
59
|
+
if (backpressured) {
|
|
60
|
+
backpressured = false;
|
|
61
|
+
source.resume();
|
|
62
|
+
}
|
|
63
|
+
});
|
|
53
64
|
|
|
54
65
|
return {
|
|
55
66
|
writeLine(line: string) {
|
|
@@ -43,6 +43,7 @@ export function projectAgentDefinition(agent: AgentConfig): Record<string, unkno
|
|
|
43
43
|
systemPrompt: agent.systemPrompt,
|
|
44
44
|
systemPromptMode: agent.systemPromptMode,
|
|
45
45
|
inheritProjectContext: agent.inheritProjectContext,
|
|
46
|
+
inheritGlobalContext: agent.inheritGlobalContext,
|
|
46
47
|
inheritSkills: agent.inheritSkills,
|
|
47
48
|
model: agent.model,
|
|
48
49
|
modelProvider: agent.modelProvider,
|
|
@@ -50,9 +51,12 @@ export function projectAgentDefinition(agent: AgentConfig): Record<string, unkno
|
|
|
50
51
|
fast: agent.fast,
|
|
51
52
|
thinking: agent.thinking,
|
|
52
53
|
tools: agent.tools,
|
|
54
|
+
excludeTools: agent.excludeTools,
|
|
55
|
+
allowNestedSubagents: agent.allowNestedSubagents,
|
|
53
56
|
mcpDirectTools: agent.mcpDirectTools,
|
|
54
57
|
extensions: agent.extensions,
|
|
55
58
|
subagentOnlyExtensions: agent.subagentOnlyExtensions,
|
|
59
|
+
mutationTools: agent.mutationTools,
|
|
56
60
|
skills: agent.skills,
|
|
57
61
|
skillPath: agent.skillPath,
|
|
58
62
|
output: agent.output,
|
|
@@ -61,7 +65,6 @@ export function projectAgentDefinition(agent: AgentConfig): Record<string, unkno
|
|
|
61
65
|
defaultContext: agent.defaultContext,
|
|
62
66
|
defaultAsync: agent.defaultAsync,
|
|
63
67
|
defaultTimeoutMs: agent.defaultTimeoutMs,
|
|
64
|
-
defaultTurnBudget: agent.defaultTurnBudget,
|
|
65
68
|
defaultAcceptance: agent.defaultAcceptance,
|
|
66
69
|
acceptanceRole: agent.acceptanceRole,
|
|
67
70
|
interactive: agent.interactive,
|
|
@@ -87,9 +90,11 @@ export interface LaunchBindingInput {
|
|
|
87
90
|
systemPrompt?: string | null;
|
|
88
91
|
systemPromptMode?: AgentConfig["systemPromptMode"];
|
|
89
92
|
inheritProjectContext: boolean;
|
|
93
|
+
inheritGlobalContext: boolean;
|
|
90
94
|
inheritSkills: boolean;
|
|
91
95
|
skills?: string[];
|
|
92
96
|
tools?: string[];
|
|
97
|
+
excludeTools?: string[];
|
|
93
98
|
extensions?: string[];
|
|
94
99
|
subagentOnlyExtensions?: string[];
|
|
95
100
|
mcpDirectTools?: string[];
|
|
@@ -113,9 +118,11 @@ export function projectLaunchBinding(input: LaunchBindingInput): Record<string,
|
|
|
113
118
|
systemPromptDigest: input.systemPrompt === undefined || input.systemPrompt === null ? undefined : stableJsonDigest(input.systemPrompt),
|
|
114
119
|
systemPromptMode: input.systemPromptMode,
|
|
115
120
|
inheritProjectContext: input.inheritProjectContext,
|
|
121
|
+
inheritGlobalContext: input.inheritGlobalContext,
|
|
116
122
|
inheritSkills: input.inheritSkills,
|
|
117
123
|
skills: input.skills,
|
|
118
124
|
tools: input.tools,
|
|
125
|
+
excludeTools: input.excludeTools,
|
|
119
126
|
extensions: input.extensions,
|
|
120
127
|
subagentOnlyExtensions: input.subagentOnlyExtensions,
|
|
121
128
|
mcpDirectTools: input.mcpDirectTools,
|