pi-crew 0.2.3 → 0.2.5

package/src/runtime/pi-args.ts

@@ -1,165 +1,165 @@
-import * as fs from "node:fs";
-import * as os from "node:os";
-import * as path from "node:path";
-import { fileURLToPath } from "node:url";
-import type { AgentConfig } from "../agents/agent-config.ts";
-
-const THINKING_LEVELS = ["off", "minimal", "low", "medium", "high", "xhigh"];
-const PROMPT_RUNTIME_EXTENSION_PATH = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "prompt", "prompt-runtime.ts");
-const TASK_ARG_LIMIT = 8000;
-const DEFAULT_MAX_CREW_DEPTH = 2;
-
-export interface BuildPiWorkerArgsInput {
-	task: string;
-	agent: AgentConfig;
-	model?: string;
-	sessionEnabled?: boolean;
-	maxDepth?: number;
-	skillPaths?: string[];
-	env?: NodeJS.ProcessEnv;
-}
-
-export interface BuildPiWorkerArgsResult {
-	args: string[];
-	env: Record<string, string | undefined>;
-	tempDir?: string;
-}
-
-function isValidThinkingLevel(value: string | undefined): value is string {
-	return value !== undefined && THINKING_LEVELS.includes(value);
-}
-
-export function applyThinkingSuffix(model: string | undefined, thinking: string | undefined): string | undefined {
-	if (!model || !thinking || thinking === "off") return model;
-	const colonIdx = model.lastIndexOf(":");
-	if (colonIdx !== -1 && isValidThinkingLevel(model.substring(colonIdx + 1))) return model;
-	// Invalid config values fall back to Pi's default thinking behavior.
-	if (!isValidThinkingLevel(thinking)) return model;
-	return `${model}:${thinking}`;
-}
-
-export function currentCrewDepth(env: NodeJS.ProcessEnv = process.env): number {
-	const raw = env.PI_CREW_DEPTH ?? env.PI_TEAMS_DEPTH ?? "0";
-	const parsed = Number(raw);
-	return Number.isInteger(parsed) && parsed >= 0 ? parsed : 0;
-}
-
-export function resolveCrewMaxDepth(inputMaxDepth?: number, env: NodeJS.ProcessEnv = process.env): number {
-	const raw = env.PI_CREW_MAX_DEPTH ?? env.PI_TEAMS_MAX_DEPTH;
-	const envDepth = raw !== undefined ? Number(raw) : NaN;
-	if (Number.isInteger(envDepth) && envDepth >= 0) return envDepth;
-	return Number.isInteger(inputMaxDepth) && inputMaxDepth !== undefined && inputMaxDepth >= 0 ? inputMaxDepth : DEFAULT_MAX_CREW_DEPTH;
-}
-
-export function checkCrewDepth(inputMaxDepth?: number, env: NodeJS.ProcessEnv = process.env): { blocked: boolean; depth: number; maxDepth: number } {
-	const depth = currentCrewDepth(env);
-	const maxDepth = resolveCrewMaxDepth(inputMaxDepth, env);
-	return { depth, maxDepth, blocked: depth >= maxDepth };
-}
-
-/**
- * Create a safe temp directory with symlink protection.
- * 1. mkdtempSync to create the directory
- * 2. lstatSync to verify it is not a symlink (TOCTOU safety)
- * 3. realpathSync to resolve the canonical path
- */
-function createSafeTempDir(base: string, prefix: string): string {
-	if (!fs.existsSync(base)) fs.mkdirSync(base, { recursive: true });
-	// Verify base dir is not a symlink (TOCTOU safety)
-	const baseStat = fs.lstatSync(base);
-	if (baseStat.isSymbolicLink()) throw new Error("Refusing to create temp dir in symlinked base: " + base);
-	// Resolve base to canonical path before joining
-	const resolvedBase = fs.realpathSync(base);
-	const rawTempDir = fs.mkdtempSync(path.join(resolvedBase, prefix));
-	try {
-		const stat = fs.lstatSync(rawTempDir);
-		if (stat.isSymbolicLink()) throw new Error("temp dir is a symlink");
-	} catch (e) {
-		if (e instanceof Error && e.message.includes("symlink")) {
-			fs.rmSync(rawTempDir, { recursive: true, force: true });
-			throw new Error("Refusing to use symlinked temp directory.");
-		}
-		throw e;
-	}
-	return fs.realpathSync(rawTempDir);
-}
-
-export function buildPiWorkerArgs(input: BuildPiWorkerArgsInput): BuildPiWorkerArgsResult {
-	const args = ["--mode", "json", "-p"];
-	if (input.sessionEnabled === false) args.push("--no-session");
-
-	const resolvedModel = input.model ?? input.agent.model;
-	if (resolvedModel) {
-		const modelWithThinking = applyThinkingSuffix(resolvedModel, input.agent.thinking);
-		if (modelWithThinking) args.push("--model", modelWithThinking);
-	}
-	// When no model resolved, pass thinking separately so Pi can apply it to the inherited parent model.
-	if (!resolvedModel && input.agent.thinking && input.agent.thinking !== "off" && isValidThinkingLevel(input.agent.thinking)) {
-		args.push("--thinking", input.agent.thinking);
-	}
-
-	if (input.agent.tools?.length) args.push("--tools", input.agent.tools.join(","));
-	if (input.agent.extensions !== undefined) {
-		args.push("--no-extensions");
-		for (const extension of [PROMPT_RUNTIME_EXTENSION_PATH, ...input.agent.extensions]) args.push("--extension", extension);
-	} else {
-		args.push("--extension", PROMPT_RUNTIME_EXTENSION_PATH);
-	}
-	if (!input.agent.inheritSkills) args.push("--no-skills");
-	for (const skillPath of input.skillPaths ?? []) args.push("--skill", skillPath);
-
-	let tempDir: string | undefined;
-	if (input.agent.systemPrompt) {
-		// On Windows, prefer a subdirectory within the user's profile over system temp
-		const tmpBase = process.platform === "win32" && os.homedir()
-			? path.join(os.homedir(), ".pi-crew", "tmp")
-			: os.tmpdir();
-		tempDir = createSafeTempDir(tmpBase, `pi-crew-${process.pid}-`);
-		const promptPath = path.join(tempDir, `${input.agent.name.replace(/[^\w.-]/g, "_")}.md`);
-		fs.writeFileSync(promptPath, input.agent.systemPrompt, { mode: 0o600 });
-		args.push(input.agent.systemPromptMode === "append" ? "--append-system-prompt" : "--system-prompt", promptPath);
-	}
-
-	if (input.task.length > TASK_ARG_LIMIT) {
-		if (!tempDir) {
-			const tmpBase = process.platform === "win32" && os.homedir()
-				? path.join(os.homedir(), ".pi-crew", "tmp")
-				: os.tmpdir();
-			tempDir = createSafeTempDir(tmpBase, `pi-crew-${process.pid}-`);
-		}
-		const taskPath = path.join(tempDir, "task.md");
-		fs.writeFileSync(taskPath, input.task, { mode: 0o600 });
-		args.push(`@${taskPath}`);
-	} else {
-		args.push(`Task: ${input.task}`);
-	}
-
-	const env = input.env ?? process.env;
-	const parentDepth = currentCrewDepth(env);
-	const maxDepth = resolveCrewMaxDepth(input.maxDepth, env);
-	return {
-		args,
-		env: {
-			PI_CREW_INHERIT_PROJECT_CONTEXT: input.agent.inheritProjectContext ? "1" : "0",
-			PI_CREW_INHERIT_SKILLS: input.agent.inheritSkills ? "1" : "0",
-			PI_CREW_DEPTH: String(parentDepth + 1),
-			PI_CREW_MAX_DEPTH: String(maxDepth),
-			PI_CREW_ROLE: input.agent.name,
-			PI_TEAMS_INHERIT_PROJECT_CONTEXT: input.agent.inheritProjectContext ? "1" : "0",
-			PI_TEAMS_INHERIT_SKILLS: input.agent.inheritSkills ? "1" : "0",
-			PI_TEAMS_DEPTH: String(parentDepth + 1),
-			PI_TEAMS_MAX_DEPTH: String(maxDepth),
-			PI_TEAMS_ROLE: input.agent.name,
-		},
-		tempDir,
-	};
-}
-
-export function cleanupTempDir(tempDir: string | undefined): void {
-	if (!tempDir) return;
-	try {
-		fs.rmSync(tempDir, { recursive: true, force: true });
-	} catch {
-		// Best effort.
-	}
-}
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+import type { AgentConfig } from "../agents/agent-config.ts";
+
+const THINKING_LEVELS = ["off", "minimal", "low", "medium", "high", "xhigh"];
+const PROMPT_RUNTIME_EXTENSION_PATH = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "prompt", "prompt-runtime.ts");
+const TASK_ARG_LIMIT = 8000;
+const DEFAULT_MAX_CREW_DEPTH = 2;
+
+export interface BuildPiWorkerArgsInput {
+	task: string;
+	agent: AgentConfig;
+	model?: string;
+	sessionEnabled?: boolean;
+	maxDepth?: number;
+	skillPaths?: string[];
+	env?: NodeJS.ProcessEnv;
+}
+
+export interface BuildPiWorkerArgsResult {
+	args: string[];
+	env: Record<string, string | undefined>;
+	tempDir?: string;
+}
+
+function isValidThinkingLevel(value: string | undefined): value is string {
+	return value !== undefined && THINKING_LEVELS.includes(value);
+}
+
+export function applyThinkingSuffix(model: string | undefined, thinking: string | undefined): string | undefined {
+	if (!model || !thinking || thinking === "off") return model;
+	const colonIdx = model.lastIndexOf(":");
+	if (colonIdx !== -1 && isValidThinkingLevel(model.substring(colonIdx + 1))) return model;
+	// Invalid config values fall back to Pi's default thinking behavior.
+	if (!isValidThinkingLevel(thinking)) return model;
+	return `${model}:${thinking}`;
+}
+
+export function currentCrewDepth(env: NodeJS.ProcessEnv = process.env): number {
+	const raw = env.PI_CREW_DEPTH ?? env.PI_TEAMS_DEPTH ?? "0";
+	const parsed = Number(raw);
+	return Number.isInteger(parsed) && parsed >= 0 ? parsed : 0;
+}
+
+export function resolveCrewMaxDepth(inputMaxDepth?: number, env: NodeJS.ProcessEnv = process.env): number {
+	const raw = env.PI_CREW_MAX_DEPTH ?? env.PI_TEAMS_MAX_DEPTH;
+	const envDepth = raw !== undefined ? Number(raw) : NaN;
+	if (Number.isInteger(envDepth) && envDepth >= 0) return envDepth;
+	return Number.isInteger(inputMaxDepth) && inputMaxDepth !== undefined && inputMaxDepth >= 0 ? inputMaxDepth : DEFAULT_MAX_CREW_DEPTH;
+}
+
+export function checkCrewDepth(inputMaxDepth?: number, env: NodeJS.ProcessEnv = process.env): { blocked: boolean; depth: number; maxDepth: number } {
+	const depth = currentCrewDepth(env);
+	const maxDepth = resolveCrewMaxDepth(inputMaxDepth, env);
+	return { depth, maxDepth, blocked: depth >= maxDepth };
+}
+
+/**
+ * Create a safe temp directory with symlink protection.
+ * 1. mkdtempSync to create the directory
+ * 2. lstatSync to verify it is not a symlink (TOCTOU safety)
+ * 3. realpathSync to resolve the canonical path
+ */
+function createSafeTempDir(base: string, prefix: string): string {
+	if (!fs.existsSync(base)) fs.mkdirSync(base, { recursive: true });
+	// Verify base dir is not a symlink (TOCTOU safety)
+	const baseStat = fs.lstatSync(base);
+	if (baseStat.isSymbolicLink()) throw new Error("Refusing to create temp dir in symlinked base: " + base);
+	// Resolve base to canonical path before joining
+	const resolvedBase = fs.realpathSync(base);
+	const rawTempDir = fs.mkdtempSync(path.join(resolvedBase, prefix));
+	try {
+		const stat = fs.lstatSync(rawTempDir);
+		if (stat.isSymbolicLink()) throw new Error("temp dir is a symlink");
+	} catch (e) {
+		if (e instanceof Error && e.message.includes("symlink")) {
+			fs.rmSync(rawTempDir, { recursive: true, force: true });
+			throw new Error("Refusing to use symlinked temp directory.");
+		}
+		throw e;
+	}
+	return fs.realpathSync(rawTempDir);
+}
+
+export function buildPiWorkerArgs(input: BuildPiWorkerArgsInput): BuildPiWorkerArgsResult {
+	const args = ["--mode", "json", "-p"];
+	if (input.sessionEnabled === false) args.push("--no-session");
+
+	const resolvedModel = input.model ?? input.agent.model;
+	if (resolvedModel) {
+		const modelWithThinking = applyThinkingSuffix(resolvedModel, input.agent.thinking);
+		if (modelWithThinking) args.push("--model", modelWithThinking);
+	}
+	// When no model resolved, pass thinking separately so Pi can apply it to the inherited parent model.
+	if (!resolvedModel && input.agent.thinking && input.agent.thinking !== "off" && isValidThinkingLevel(input.agent.thinking)) {
+		args.push("--thinking", input.agent.thinking);
+	}
+
+	if (input.agent.tools?.length) args.push("--tools", input.agent.tools.join(","));
+	if (input.agent.extensions !== undefined) {
+		args.push("--no-extensions");
+		for (const extension of [PROMPT_RUNTIME_EXTENSION_PATH, ...input.agent.extensions]) args.push("--extension", extension);
+	} else {
+		args.push("--extension", PROMPT_RUNTIME_EXTENSION_PATH);
+	}
+	if (!input.agent.inheritSkills) args.push("--no-skills");
+	for (const skillPath of input.skillPaths ?? []) args.push("--skill", skillPath);
+
+	let tempDir: string | undefined;
+	if (input.agent.systemPrompt) {
+		// On Windows, prefer a subdirectory within the user's profile over system temp
+		const tmpBase = process.platform === "win32" && os.homedir()
+			? path.join(os.homedir(), ".pi-crew", "tmp")
+			: os.tmpdir();
+		tempDir = createSafeTempDir(tmpBase, `pi-crew-${process.pid}-`);
+		const promptPath = path.join(tempDir, `${input.agent.name.replace(/[^\w.-]/g, "_")}.md`);
+		fs.writeFileSync(promptPath, input.agent.systemPrompt, { mode: 0o600 });
+		args.push(input.agent.systemPromptMode === "append" ? "--append-system-prompt" : "--system-prompt", promptPath);
+	}
+
+	if (input.task.length > TASK_ARG_LIMIT) {
+		if (!tempDir) {
+			const tmpBase = process.platform === "win32" && os.homedir()
+				? path.join(os.homedir(), ".pi-crew", "tmp")
+				: os.tmpdir();
+			tempDir = createSafeTempDir(tmpBase, `pi-crew-${process.pid}-`);
+		}
+		const taskPath = path.join(tempDir, "task.md");
+		fs.writeFileSync(taskPath, input.task, { mode: 0o600 });
+		args.push(`@${taskPath}`);
+	} else {
+		args.push(`Task: ${input.task}`);
+	}
+
+	const env = input.env ?? process.env;
+	const parentDepth = currentCrewDepth(env);
+	const maxDepth = resolveCrewMaxDepth(input.maxDepth, env);
+	return {
+		args,
+		env: {
+			PI_CREW_INHERIT_PROJECT_CONTEXT: input.agent.inheritProjectContext ? "1" : "0",
+			PI_CREW_INHERIT_SKILLS: input.agent.inheritSkills ? "1" : "0",
+			PI_CREW_DEPTH: String(parentDepth + 1),
+			PI_CREW_MAX_DEPTH: String(maxDepth),
+			PI_CREW_ROLE: input.agent.name,
+			PI_TEAMS_INHERIT_PROJECT_CONTEXT: input.agent.inheritProjectContext ? "1" : "0",
+			PI_TEAMS_INHERIT_SKILLS: input.agent.inheritSkills ? "1" : "0",
+			PI_TEAMS_DEPTH: String(parentDepth + 1),
+			PI_TEAMS_MAX_DEPTH: String(maxDepth),
+			PI_TEAMS_ROLE: input.agent.name,
+		},
+		tempDir,
+	};
+}
+
+export function cleanupTempDir(tempDir: string | undefined): void {
+	if (!tempDir) return;
+	try {
+		fs.rmSync(tempDir, { recursive: true, force: true });
+	} catch {
+		// Best effort.
+	}
+}

package/src/runtime/pi-json-output.ts

@@ -1,111 +1,111 @@
-export interface ParsedPiUsage {
-	input?: number;
-	output?: number;
-	cacheRead?: number;
-	cacheWrite?: number;
-	cost?: number;
-	turns?: number;
-}
-
-export interface ParsedPiJsonOutput {
-	jsonEvents: number;
-	textEvents: string[];
-	finalText?: string;
-	usage?: ParsedPiUsage;
-}
-
-function asRecord(value: unknown): Record<string, unknown> | undefined {
-	return value && typeof value === "object" && !Array.isArray(value) ? value as Record<string, unknown> : undefined;
-}
-
-function numberField(obj: Record<string, unknown>, keys: string[]): number | undefined {
-	for (const key of keys) {
-		const value = obj[key];
-		if (typeof value === "number" && Number.isFinite(value)) return value;
-	}
-	return undefined;
-}
-
-function mergeUsage(target: ParsedPiUsage, source: ParsedPiUsage): ParsedPiUsage {
-	return {
-		input: source.input ?? target.input,
-		output: source.output ?? target.output,
-		cacheRead: source.cacheRead ?? target.cacheRead,
-		cacheWrite: source.cacheWrite ?? target.cacheWrite,
-		cost: source.cost ?? target.cost,
-		turns: source.turns ?? target.turns,
-	};
-}
-
-function extractUsage(value: unknown): ParsedPiUsage | undefined {
-	const obj = asRecord(value);
-	if (!obj) return undefined;
-	const direct: ParsedPiUsage = {
-		input: numberField(obj, ["input", "inputTokens", "input_tokens"]),
-		output: numberField(obj, ["output", "outputTokens", "output_tokens"]),
-		cacheRead: numberField(obj, ["cacheRead", "cache_read", "cacheReadTokens", "cache_read_tokens"]),
-		cacheWrite: numberField(obj, ["cacheWrite", "cache_write", "cacheWriteTokens", "cache_write_tokens"]),
-		cost: numberField(obj, ["cost", "costUsd", "cost_usd"]),
-		turns: numberField(obj, ["turns", "turnCount", "turn_count"]),
-	};
-	if (Object.values(direct).some((entry) => entry !== undefined)) return direct;
-	for (const key of ["usage", "tokenUsage", "tokens", "stats"]) {
-		const nested = extractUsage(obj[key]);
-		if (nested) return nested;
-	}
-	return undefined;
-}
-
-function textFromContent(content: unknown): string[] {
-	if (typeof content === "string") return [content];
-	if (!Array.isArray(content)) return [];
-	const text: string[] = [];
-	for (const part of content) {
-		const obj = asRecord(part);
-		if (!obj) continue;
-		if (obj.type === "text" && typeof obj.text === "string") text.push(obj.text);
-		else if (typeof obj.content === "string") text.push(obj.content);
-	}
-	return text;
-}
-
-function extractText(value: unknown): string[] {
-	const obj = asRecord(value);
-	if (!obj) return [];
-	const message = asRecord(obj.message);
-	if (message?.role !== undefined && message.role !== "assistant") return [];
-	const text: string[] = [];
-	if (typeof obj.text === "string") text.push(obj.text);
-	if (typeof obj.output === "string") text.push(obj.output);
-	if (typeof obj.finalOutput === "string") text.push(obj.finalOutput);
-	if (typeof obj.final_output === "string") text.push(obj.final_output);
-	if (!message) text.push(...textFromContent(obj.content));
-	if (message) text.push(...textFromContent(message.content));
-	return text.filter((entry) => entry.trim().length > 0);
-}
-
-export function parsePiJsonOutput(stdout: string): ParsedPiJsonOutput {
-	let jsonEvents = 0;
-	const textEvents: string[] = [];
-	let usage: ParsedPiUsage | undefined;
-	for (const line of stdout.split("\n")) {
-		const trimmed = line.trim();
-		if (!trimmed) continue;
-		let event: unknown;
-		try {
-			event = JSON.parse(trimmed) as unknown;
-		} catch {
-			continue;
-		}
-		jsonEvents++;
-		textEvents.push(...extractText(event));
-		const eventUsage = extractUsage(event);
-		if (eventUsage) usage = mergeUsage(usage ?? {}, eventUsage);
-	}
-	return {
-		jsonEvents,
-		textEvents,
-		finalText: textEvents.length > 0 ? textEvents[textEvents.length - 1] : undefined,
-		usage,
-	};
-}
+export interface ParsedPiUsage {
+	input?: number;
+	output?: number;
+	cacheRead?: number;
+	cacheWrite?: number;
+	cost?: number;
+	turns?: number;
+}
+
+export interface ParsedPiJsonOutput {
+	jsonEvents: number;
+	textEvents: string[];
+	finalText?: string;
+	usage?: ParsedPiUsage;
+}
+
+function asRecord(value: unknown): Record<string, unknown> | undefined {
+	return value && typeof value === "object" && !Array.isArray(value) ? value as Record<string, unknown> : undefined;
+}
+
+function numberField(obj: Record<string, unknown>, keys: string[]): number | undefined {
+	for (const key of keys) {
+		const value = obj[key];
+		if (typeof value === "number" && Number.isFinite(value)) return value;
+	}
+	return undefined;
+}
+
+function mergeUsage(target: ParsedPiUsage, source: ParsedPiUsage): ParsedPiUsage {
+	return {
+		input: source.input ?? target.input,
+		output: source.output ?? target.output,
+		cacheRead: source.cacheRead ?? target.cacheRead,
+		cacheWrite: source.cacheWrite ?? target.cacheWrite,
+		cost: source.cost ?? target.cost,
+		turns: source.turns ?? target.turns,
+	};
+}
+
+function extractUsage(value: unknown): ParsedPiUsage | undefined {
+	const obj = asRecord(value);
+	if (!obj) return undefined;
+	const direct: ParsedPiUsage = {
+		input: numberField(obj, ["input", "inputTokens", "input_tokens"]),
+		output: numberField(obj, ["output", "outputTokens", "output_tokens"]),
+		cacheRead: numberField(obj, ["cacheRead", "cache_read", "cacheReadTokens", "cache_read_tokens"]),
+		cacheWrite: numberField(obj, ["cacheWrite", "cache_write", "cacheWriteTokens", "cache_write_tokens"]),
+		cost: numberField(obj, ["cost", "costUsd", "cost_usd"]),
+		turns: numberField(obj, ["turns", "turnCount", "turn_count"]),
+	};
+	if (Object.values(direct).some((entry) => entry !== undefined)) return direct;
+	for (const key of ["usage", "tokenUsage", "tokens", "stats"]) {
+		const nested = extractUsage(obj[key]);
+		if (nested) return nested;
+	}
+	return undefined;
+}
+
+function textFromContent(content: unknown): string[] {
+	if (typeof content === "string") return [content];
+	if (!Array.isArray(content)) return [];
+	const text: string[] = [];
+	for (const part of content) {
+		const obj = asRecord(part);
+		if (!obj) continue;
+		if (obj.type === "text" && typeof obj.text === "string") text.push(obj.text);
+		else if (typeof obj.content === "string") text.push(obj.content);
+	}
+	return text;
+}
+
+function extractText(value: unknown): string[] {
+	const obj = asRecord(value);
+	if (!obj) return [];
+	const message = asRecord(obj.message);
+	if (message?.role !== undefined && message.role !== "assistant") return [];
+	const text: string[] = [];
+	if (typeof obj.text === "string") text.push(obj.text);
+	if (typeof obj.output === "string") text.push(obj.output);
+	if (typeof obj.finalOutput === "string") text.push(obj.finalOutput);
+	if (typeof obj.final_output === "string") text.push(obj.final_output);
+	if (!message) text.push(...textFromContent(obj.content));
+	if (message) text.push(...textFromContent(message.content));
+	return text.filter((entry) => entry.trim().length > 0);
+}
+
+export function parsePiJsonOutput(stdout: string): ParsedPiJsonOutput {
+	let jsonEvents = 0;
+	const textEvents: string[] = [];
+	let usage: ParsedPiUsage | undefined;
+	for (const line of stdout.split("\n")) {
+		const trimmed = line.trim();
+		if (!trimmed) continue;
+		let event: unknown;
+		try {
+			event = JSON.parse(trimmed) as unknown;
+		} catch {
+			continue;
+		}
+		jsonEvents++;
+		textEvents.push(...extractText(event));
+		const eventUsage = extractUsage(event);
+		if (eventUsage) usage = mergeUsage(usage ?? {}, eventUsage);
+	}
+	return {
+		jsonEvents,
+		textEvents,
+		finalText: textEvents.length > 0 ? textEvents[textEvents.length - 1] : undefined,
+		usage,
+	};
+}