@namzu/sdk 42.0.0 → 42.0.2

package/src/runtime/query/cancelled-before-start.ts

@@ -0,0 +1,189 @@
+import type { RunPersistence } from '../../manager/run/persistence.js'
+import { GENAI, NAMZU, agentRunSpanName, parentContext } from '../../telemetry/attributes.js'
+import { getTracer } from '../../telemetry/runtime-accessors.js'
+import { createSystemMessage } from '../../types/message/index.js'
+import type { FencingToken } from '../../types/run/checkpoint-store.js'
+import type { RunEventCursor, RunEventReplay } from '../../types/run/event-cursor.js'
+import { resolveRunEventReplay } from '../../types/run/event-cursor.js'
+import type { Run, RunEvent } from '../../types/run/index.js'
+import { toErrorMessage } from '../../utils/error.js'
+import type { QueryParams } from './index.js'
+import type { PreparedRun } from './prepare-run.js'
+import { ResultAssembler } from './result.js'
+
+/**
+ * The run that was cancelled before it started.
+ *
+ * Attachment materialization happens before `RunContext` exists, and a
+ * cancellation observed there still belongs to a run: it must be recorded,
+ * classified and reported like any other, without any of the authority-bearing
+ * work — prompt contributions, host callbacks, tools, plugins, sandbox,
+ * guardrails, advisors, providers — that a run which is allowed to proceed
+ * would do next.
+ *
+ * An `async function*` rather than a plain async function, and reached with
+ * `yield*`, because this path still emits and drains: the events it produces
+ * must occupy exactly the positions in the stream they occupied when the code
+ * lived inline, and only delegation preserves every yield point.
+ */
+export async function* settlePreStartCancellation(
+	params: QueryParams,
+	prepared: PreparedRun,
+): AsyncGenerator<RunEvent, Run> {
+	const {
+		ctx,
+		runConfig,
+		eventTranslator,
+		executeUserInterruptHooks,
+		selectedResumeState,
+		queuedForThisRun,
+		initialMessages,
+	} = prepared
+
+	// Attachment materialization happens before RunContext exists. Once it
+	// observes cancellation, do only the work required to leave an honest
+	// durable run: initialize the record, retain the unresolved references,
+	// and settle through the ordinary cancellation classifier. Prompt
+	// contributions/cache, host callbacks, tools, plugins, sandbox, guardrails,
+	// advisors, and providers are all authority-bearing work and stay out.
+	// The dedicated root interrupt notification is the sole plugin exception:
+	// it runs after cancellation under its own deadline and cannot regain model
+	// or tool authority.
+	if (params.resumeFromCheckpoint && !selectedResumeState) {
+		// The canonical resume surface hands query the checkpoint state it
+		// already selected. A raw resume query has no such snapshot; after
+		// cancellation, reading the store again could hang without a signal,
+		// while persisting without it would erase the existing transcript.
+		// Refuse before binding/persisting rather than choose either failure.
+		ctx.abortController.signal.throwIfAborted()
+	}
+
+	const cancelledPrompt = params.systemPrompt ?? ''
+	const cancelledAssembler = new ResultAssembler({
+		runMgr: ctx.runMgr,
+		planManager: ctx.planManager,
+		activityStore: ctx.activityStore,
+		log: ctx.log,
+		emitEvent: eventTranslator.emitEvent,
+		drainPending: () => eventTranslator.drainPending(),
+		signal: ctx.abortController.signal,
+	})
+	const rootSpan = getTracer().startSpan(
+		agentRunSpanName(params.agentName),
+		{},
+		parentContext(params.parentSpan ?? selectedResumeState?.traceContext),
+	)
+	rootSpan.setAttributes({
+		[NAMZU.RUN_ID]: ctx.runMgr.id,
+		[GENAI.AGENT_NAME]: params.agentName,
+		[GENAI.AGENT_ID]: params.agentId,
+		[GENAI.REQUEST_MODEL]: runConfig.model,
+		[GENAI.SYSTEM]: params.provider.id,
+	})
+
+	try {
+		await ctx.runMgr.init()
+		if (selectedResumeState) {
+			ctx.runMgr.restoreUsage(
+				selectedResumeState.tokenUsage,
+				selectedResumeState.costInfo,
+				selectedResumeState.currentIteration,
+			)
+			for (const message of selectedResumeState.messages) ctx.runMgr.pushMessage(message)
+			for (const queued of queuedForThisRun) ctx.runMgr.pushMessage(queued)
+		} else if (params.continuationMode) {
+			for (const message of initialMessages) ctx.runMgr.pushMessage(message)
+		} else {
+			ctx.runMgr.pushMessage(createSystemMessage(cancelledPrompt, 'cache'))
+			for (const message of initialMessages) ctx.runMgr.pushMessage(message)
+		}
+		if (params.eventCursor) {
+			yield* catchUpFromCursor(
+				ctx.runMgr,
+				params.eventCursor,
+				params.onEventReplay,
+				params.claimFence,
+				(error) => {
+					ctx.log.warn('Replay observer failed after attachment cancellation', {
+						'exception.message': toErrorMessage(error),
+					})
+				},
+			)
+		}
+		if (selectedResumeState) {
+			await eventTranslator.emitEvent({
+				type: 'run_resuming',
+				runId: ctx.runId,
+				fromCheckpointId: selectedResumeState.checkpointId,
+			})
+			yield* eventTranslator.drainPending()
+		}
+		ctx.runMgr.markRunning()
+		await eventTranslator.emitEvent({
+			type: 'run_started',
+			runId: ctx.runId,
+			systemPrompt: cancelledPrompt,
+		})
+		yield* eventTranslator.drainPending()
+		ctx.abortController.signal.throwIfAborted()
+	} catch (error) {
+		// Attachment resolution has already observed the caller's abort. A
+		// reconnect callback can still throw while replay is being reported,
+		// but it cannot replace that terminal cause or turn a cancelled run
+		// into an unpersisted rejection.
+		const terminalError = ctx.abortController.signal.aborted
+			? ctx.abortController.signal.reason
+			: error
+		await executeUserInterruptHooks(terminalError)
+		yield* eventTranslator.drainPending()
+		yield* cancelledAssembler.handleError(terminalError, rootSpan)
+	} finally {
+		rootSpan.end()
+	}
+
+	return await cancelledAssembler.finalize()
+}
+
+/**
+ * Hand a returning consumer what it missed, or tell it why it cannot have it.
+ *
+ * Yields NOTHING on a refusal. A partial catch-up is the failure this exists to
+ * prevent: a consumer that receives some of the gap folds it into its state and
+ * cannot tell the state is wrong, where one that receives an explicit
+ * `unavailable` re-derives from the transcript and is right. The run continues
+ * either way — a stale cursor belongs to the client, and must not be able to
+ * stop the work.
+ */
+export async function* catchUpFromCursor(
+	runMgr: RunPersistence,
+	cursor: RunEventCursor,
+	onEventReplay: ((replay: RunEventReplay) => void) | undefined,
+	generation: FencingToken | undefined,
+	onReplayObserverError: (error: unknown) => void,
+): AsyncGenerator<RunEvent, void> {
+	const missed = await runMgr.getRunStore().readEvents({ sinceSeq: cursor.sinceSeq })
+	const replay = resolveRunEventReplay(
+		cursor,
+		{
+			lastSeq: runMgr.lastEventSeq,
+			...(generation !== undefined ? { generation } : {}),
+		},
+		missed,
+	)
+
+	if (onEventReplay) {
+		try {
+			// A callback typed `void` may still be implemented with `async` in
+			// TypeScript. Observe that runtime Promise so a late rejection cannot
+			// become process-wide, but never await host code here: replay delivery
+			// and an already-cancelled run must not inherit observer liveness.
+			const settlement = onEventReplay(replay)
+			void Promise.resolve(settlement).catch(onReplayObserverError)
+		} catch (error) {
+			onReplayObserverError(error)
+		}
+	}
+
+	if (replay.status !== 'replayed') return
+	for (const event of replay.events) yield event
+}

package/src/runtime/query/checkpoint.ts

@@ -584,6 +584,27 @@ export class CheckpointManager {
 		return checkpoints.map(toCheckpointListEntry)
 	}
 
+	/**
+	 * Collect old checkpoints until `keepLast` newer ones remain.
+	 *
+	 * Growth control, and growth control stops at a park. A checkpoint with
+	 * an unresolved `pending` is the durable fact that a human was asked
+	 * something: it is what `findPendingCheckpoint` serves to an approval
+	 * queue and what `listExpiredParks` enumerates for a sweep. Collecting
+	 * one deletes the only record of a question somebody may be in the middle
+	 * of answering, and their answer then lands nowhere — the store refuses
+	 * the unpark and the run it belonged to resumes without it.
+	 *
+	 * So the candidates are still the oldest `all.length - keepLast`, which
+	 * is what keeps the newest `keepLast` — the run's resume point — out of
+	 * reach, and a park among them is skipped rather than counted. Pruning
+	 * therefore holds a few more rows while a park is outstanding. That is
+	 * the right side to err on: parks resolve, and the next prune collects
+	 * them. Expired ones are skipped too — the host's sweep is
+	 * {@link expire}, which resolves the park by running out of time rather
+	 * than by deleting the evidence, and `prune` racing it would take the
+	 * question away before it was read.
+	 */
 	async prune(keepLast: number): Promise<void> {
 		const all = await this.list()
 		if (all.length <= keepLast) return
@@ -591,6 +612,7 @@ export class CheckpointManager {
 		const toDelete = all.sort((a, b) => a.createdAt - b.createdAt).slice(0, all.length - keepLast)
 
 		for (const cp of toDelete) {
+			if (cp.pending && cp.pending.resolvedAt === undefined) continue
 			await this.store.deleteCheckpoint(this.scope, cp.id)
 		}
 	}

package/src/runtime/query/executor/tool-call-admission.ts

@@ -0,0 +1,473 @@
+import { GENAI, NAMZU } from '../../../constants/telemetry/index.js'
+import { renderToolSchema } from '../../../registry/tool/schema.js'
+import type { ToolCall } from '../../../types/message/index.js'
+import type { PluginHookResult } from '../../../types/plugin/index.js'
+import type { ToolCallRepair, ToolCallRepairReason } from '../../../types/tool/repair.js'
+import { toErrorMessage } from '../../../utils/error.js'
+import type { Logger } from '../../../utils/logger.js'
+import type {
+	EmitEvent,
+	PreToolHookOutcome,
+	PreparedDirectCall,
+	ToolExecutorConfig,
+} from '../executor.js'
+import { skippedToolResultText } from '../plugin-hooks.js'
+
+/**
+ * One provider tool call, from raw to admitted.
+ *
+ * The executor's job is to run tools; this is the gate every call passes
+ * before one runs. A call arrives as the model streamed it — possibly not
+ * valid JSON, possibly cut off mid-argument, possibly naming a tool that does
+ * not exist — and leaves as a prepared, plugin-approved, authorized call, or
+ * as a synthetic failure that answers the model with what was wrong. Nothing
+ * here dispatches a tool, and nothing here writes a result: that is the
+ * executor's half.
+ *
+ * The family reads exactly three things off the executor it serves, and they
+ * arrive as one value rather than as a captured reference: the tool registry
+ * config, the event sink and the logger. `config` in particular is read
+ * per call and never held — `ToolExecutor.setSandbox` REPLACES it, so a host
+ * captured once would hand the next admission a stale sandbox.
+ */
+export interface ToolAdmissionHost {
+	readonly config: ToolExecutorConfig
+	readonly emitEvent: EmitEvent
+	readonly log: Logger
+}
+
+export async function runPreToolHook(
+	host: ToolAdmissionHost,
+	toolName: string,
+	input: unknown,
+	signal: AbortSignal = host.config.abortSignal,
+): Promise<PreToolHookOutcome> {
+	if (!host.config.pluginManager) return { kind: 'continue', input, modified: false }
+	const results = await host.config.pluginManager.executeHooks(
+		'pre_tool_use',
+		{
+			runId: host.config.runId,
+			toolName,
+			toolInput: input,
+			signal,
+		},
+		host.emitEvent,
+	)
+	return interpretPreToolResults(toolName, input, results)
+}
+
+export async function prepareDirectCall(
+	host: ToolAdmissionHost,
+	toolCall: ToolCall,
+): Promise<PreparedDirectCall> {
+	let toolName = toolCall.function.name
+	const truncationRepair =
+		toolCall.metadata?.inputTruncated === true
+			? await repairTruncatedCall(host, toolCall, toolName)
+			: null
+	if (toolCall.metadata?.inputTruncated === true && !truncationRepair) {
+		return {
+			kind: 'synthetic',
+			toolCall,
+			toolName,
+			input: {},
+			message: truncatedToolInputMessage(toolName),
+			isError: true,
+		}
+	}
+
+	const prepare = host.config.tools.prepareExecution
+	const executePrepared = host.config.tools.executePrepared
+	if (typeof prepare !== 'function' || typeof executePrepared !== 'function') {
+		const resolved = await resolveCall(
+			host,
+			truncationRepair
+				? {
+						...toolCall,
+						function: {
+							...toolCall.function,
+							name: truncationRepair.toolName ?? toolName,
+							arguments: truncationRepair.arguments,
+						},
+						metadata: {},
+					}
+				: toolCall,
+		)
+		toolName = resolved.toolName
+		if (!resolved.ok) {
+			return {
+				kind: 'synthetic',
+				toolCall,
+				toolName,
+				input: {},
+				message: resolved.message,
+				isError: true,
+			}
+		}
+		const preOutcome = await runPreToolHook(host, toolName, resolved.input)
+		if (preOutcome.kind === 'skip' || preOutcome.kind === 'error') {
+			return {
+				kind: 'synthetic',
+				toolCall,
+				toolName,
+				input: preOutcome.input,
+				message: preOutcome.output,
+				isError: preOutcome.kind === 'error',
+			}
+		}
+		if (!host.config.authorizationGate) {
+			return {
+				kind: 'legacy',
+				toolCall,
+				toolName,
+				input: preOutcome.input,
+			}
+		}
+		return {
+			kind: 'synthetic',
+			toolCall,
+			toolName,
+			input: preOutcome.input,
+			message: `Tool "${toolName}" was not executed because its registry cannot bind authorization to one prepared input.`,
+			isError: true,
+		}
+	}
+
+	let raw = truncationRepair?.arguments ?? toolCall.function.arguments
+	toolName = truncationRepair?.toolName ?? toolName
+	let repairUsed = truncationRepair !== null
+	let preparation: ReturnType<typeof prepare>
+	for (;;) {
+		let parsed: unknown
+		try {
+			parsed = parseArguments(raw)
+		} catch {
+			const message = `Error: Invalid JSON in tool arguments for "${toolName}"`
+			const repair =
+				!repairUsed && host.config.repairToolCall
+					? await requestRepair(host, toolCall, toolName, {
+							reason: 'invalid_json',
+							message,
+						})
+					: null
+			if (repair) {
+				repairUsed = true
+				toolName = repair.toolName ?? toolName
+				raw = repair.arguments
+				continue
+			}
+			return { kind: 'synthetic', toolCall, toolName, input: {}, message, isError: true }
+		}
+
+		try {
+			preparation = prepare.call(host.config.tools, toolName, parsed)
+		} catch (err) {
+			const message = `Error: Unknown or unavailable tool "${toolName}": ${toErrorMessage(err)}`
+			const repair =
+				!repairUsed && host.config.repairToolCall
+					? await requestRepair(host, toolCall, toolName, {
+							reason: 'unknown_tool',
+							message,
+						})
+					: null
+			if (repair) {
+				repairUsed = true
+				toolName = repair.toolName ?? toolName
+				raw = repair.arguments
+				continue
+			}
+			return { kind: 'synthetic', toolCall, toolName, input: parsed, message, isError: true }
+		}
+
+		if (preparation.success) break
+		const message = formatFailedToolOutput(preparation.result.output, preparation.result.error)
+		const repair =
+			!repairUsed && host.config.repairToolCall
+				? await requestRepair(host, toolCall, toolName, {
+						reason: 'schema_validation',
+						message,
+					})
+				: null
+		if (repair) {
+			repairUsed = true
+			toolName = repair.toolName ?? toolName
+			raw = repair.arguments
+			continue
+		}
+		return {
+			kind: 'synthetic',
+			toolCall,
+			toolName,
+			input: parsed,
+			message,
+			isError: true,
+		}
+	}
+
+	const preOutcome = await runPreToolHook(host, toolName, preparation.prepared.input)
+	if (preOutcome.kind === 'skip' || preOutcome.kind === 'error') {
+		return {
+			kind: 'synthetic',
+			toolCall,
+			toolName,
+			input: preOutcome.input,
+			message: preOutcome.output,
+			isError: preOutcome.kind === 'error',
+		}
+	}
+
+	if (preOutcome.modified) {
+		const modified = prepare.call(host.config.tools, toolName, preOutcome.input)
+		if (!modified.success) {
+			return {
+				kind: 'synthetic',
+				toolCall,
+				toolName,
+				input: preOutcome.input,
+				message: formatFailedToolOutput(modified.result.output, modified.result.error),
+				isError: true,
+			}
+		}
+		preparation = modified
+	}
+
+	return {
+		kind: 'ready',
+		toolCall,
+		toolName,
+		input: preparation.prepared.input,
+		prepared: preparation.prepared,
+	}
+}
+
+function interpretPreToolResults(
+	toolName: string,
+	initialInput: unknown,
+	results: readonly PluginHookResult[],
+): PreToolHookOutcome {
+	let currentInput = initialInput
+	let modified = false
+	for (const result of results) {
+		switch (result.action) {
+			case 'continue':
+				continue
+			case 'modify':
+				currentInput = result.input
+				modified = true
+				continue
+			case 'skip':
+				return {
+					kind: 'skip',
+					input: currentInput,
+					output: skippedToolResultText(toolName, result.reason),
+				}
+			case 'error':
+				return {
+					kind: 'error',
+					input: currentInput,
+					output: `Error: ${result.message}`,
+				}
+			case 'retry':
+			case 'annotate':
+			// There is no result to replace yet. Rejecting loudly beats
+			// silently ignoring it: a hook author who returned this here
+			// meant to redact something and would otherwise watch the secret
+			// go through.
+			case 'replace':
+				throw new Error(
+					`Plugin hook pre_tool_use returned unsupported action '${result.action}' for tool ${toolName}`,
+				)
+			default: {
+				const _exhaustive: never = result
+				throw new Error(`Unknown PluginHookResult: ${JSON.stringify(_exhaustive)}`)
+			}
+		}
+	}
+	return { kind: 'continue', input: currentInput, modified }
+}
+
+/**
+ * Turn the call the model issued into a name and a parsed input, giving
+ * a configured repairer one chance to fix it first.
+ *
+ * Exactly one chance: a repairer that produces a call which is still
+ * broken will not do better on a second look, and an unbounded loop
+ * here is a hang rather than a degradation.
+ *
+ * `invalid_json` is the ONLY failure that stops the call here, and it
+ * stopped it before this function existed too. `unknown_tool` and
+ * `schema_validation` merely OFFER the repair and otherwise fall
+ * through to the registry, which reports both with better messages —
+ * its schema error already ships a "Required: <field>: <type>" hint the
+ * model can self-correct from. So with no repairer configured this is
+ * behaviorally identical to the bare `JSON.parse` it replaced.
+ */
+export async function resolveCall(
+	host: ToolAdmissionHost,
+	toolCall: ToolCall,
+): Promise<
+	{ ok: true; toolName: string; input: unknown } | { ok: false; toolName: string; message: string }
+> {
+	let toolName = toolCall.function.name
+	let raw = toolCall.function.arguments
+
+	for (let attempt = 0; ; attempt++) {
+		const failure = inspectCall(host, toolName, raw)
+		if (!failure) return { ok: true, toolName, input: parseArguments(raw) }
+
+		const repair =
+			attempt === 0 && host.config.repairToolCall
+				? await requestRepair(host, toolCall, toolName, failure)
+				: null
+
+		if (!repair) {
+			if (failure.reason === 'invalid_json') {
+				return { ok: false, toolName, message: failure.message }
+			}
+			return { ok: true, toolName, input: parseArguments(raw) }
+		}
+
+		host.log.info('Repaired a malformed tool call', {
+			[NAMZU.RUN_ID]: host.config.runId,
+			[GENAI.TOOL_NAME]: toolName,
+			'namzu.runtime.reason': failure.reason,
+			...(repair.toolName && repair.toolName !== toolName
+				? { 'namzu.runtime.repaired_to': repair.toolName }
+				: {}),
+		})
+		toolName = repair.toolName ?? toolName
+		raw = repair.arguments
+	}
+}
+
+export async function repairTruncatedCall(
+	host: ToolAdmissionHost,
+	toolCall: ToolCall,
+	toolName: string,
+): Promise<ToolCallRepair | null> {
+	if (!host.config.repairToolCall) return null
+
+	// Present the PARTIAL buffer, not the normalized `"{}"` — a repairer
+	// handed an empty object has nothing to work from.
+	const partial = toolCall.metadata?.partialArguments ?? ''
+	const repair = await requestRepair(
+		host,
+		{ ...toolCall, function: { ...toolCall.function, arguments: partial } },
+		toolName,
+		{ reason: 'invalid_json', message: truncatedToolInputMessage(toolName) },
+	)
+	if (repair) {
+		host.log.info('Repaired a tool call whose input stream was truncated', {
+			[NAMZU.RUN_ID]: host.config.runId,
+			[GENAI.TOOL_NAME]: toolName,
+			'namzu.runtime.partial_length': partial.length,
+		})
+	}
+	return repair
+}
+
+/**
+ * What is wrong with this call, or `null` if nothing is.
+ *
+ * JSON is checked before the tool is looked up: an unparseable argument
+ * string is broken regardless of which tool it was aimed at, and it is
+ * the one problem the executor itself has to answer.
+ */
+function inspectCall(
+	host: ToolAdmissionHost,
+	toolName: string,
+	raw: string,
+): { reason: ToolCallRepairReason; message: string } | null {
+	let parsed: unknown
+	try {
+		parsed = parseArguments(raw)
+	} catch {
+		return {
+			reason: 'invalid_json',
+			message: `Error: Invalid JSON in tool arguments for "${toolName}"`,
+		}
+	}
+
+	const tool = host.config.tools.get?.(toolName)
+	if (!tool) {
+		// Either the model named a tool that does not exist, or this
+		// registry does not implement `get`. Both are the registry's to
+		// answer; a repairer still gets offered the `unknown_tool` case.
+		return {
+			reason: 'unknown_tool',
+			message: `Error: Unknown tool "${toolName}"`,
+		}
+	}
+
+	// A registry that hands back a tool with no schema has nothing to
+	// validate against; that is not a repairable condition, just an
+	// unvalidatable one.
+	const validation = tool.inputSchema?.safeParse(parsed)
+	if (validation && !validation.success) {
+		return {
+			reason: 'schema_validation',
+			message: `Error: Invalid arguments for "${toolName}": ${validation.error.issues
+				.map((issue) => `${issue.path.join('.') || '(root)'}: ${issue.message}`)
+				.join('; ')}`,
+		}
+	}
+
+	return null
+}
+
+async function requestRepair(
+	host: ToolAdmissionHost,
+	toolCall: ToolCall,
+	toolName: string,
+	failure: { reason: ToolCallRepairReason; message: string },
+): Promise<ToolCallRepair | null> {
+	const repairToolCall = host.config.repairToolCall
+	if (!repairToolCall) return null
+
+	const tool = host.config.tools.get(toolName)
+	try {
+		return await repairToolCall({
+			toolCall,
+			reason: failure.reason,
+			message: failure.message,
+			...(tool
+				? {
+						tool,
+						jsonSchema: tool.modelInputSchema ?? renderToolSchema(tool.inputSchema),
+					}
+				: {}),
+			availableTools: host.config.tools.listNames(),
+		})
+	} catch (err) {
+		// A broken repairer must not turn a recoverable tool error into a
+		// failed run: the original error is still a perfectly good answer
+		// to give the model.
+		host.log.error('repairToolCall threw — falling back to the original error', {
+			[NAMZU.RUN_ID]: host.config.runId,
+			[GENAI.TOOL_NAME]: toolName,
+			'exception.message': toErrorMessage(err),
+		})
+		return null
+	}
+}
+
+/**
+ * An empty arguments string means "no arguments", not "malformed" — the
+ * shape a no-parameter tool arrives in.
+ */
+function parseArguments(raw: string): unknown {
+	return JSON.parse(raw || '{}')
+}
+
+export function formatFailedToolOutput(
+	output: string | undefined,
+	error: string | undefined,
+): string {
+	const errorText = `Error: ${error ?? 'Tool execution failed'}`
+	if (!output || output.trim().length === 0) return errorText
+	return `${output}\n\n${errorText}`
+}
+
+export function truncatedToolInputMessage(toolName: string): string {
+	return `Error: Tool "${toolName}" call was cut off while the model was streaming JSON arguments. The tool was NOT executed. Retry with a much shorter input. Self-budget content/new_string under 12000 characters before calling file tools. For long files, create a short opening with write and a deterministic marker, then advance that marker with bounded exact edit calls; for delegated work, pass a shared workspace filename/reference instead of embedding the content in the tool call.`
+}