@tangle-network/agent-runtime 0.301.0 → 0.306.2

package/dist/index.js

@@ -1,15 +1,15 @@
-import { $i as executableAgentProfileSnapshot, $r as sanitizeAgentRuntimeEvent, Br as buildLoopOtelSpans, Hr as buildRuntimeEventOtelSpans, Jr as padSpanId, Kr as generateSpanId, Mi as prepareJsonlAppend, Ni as readCommittedJsonLines, Pi as writeAllBytes, Qr as createRuntimeStreamEventCollector, Rr as defaultRedactorIdentityMaterial, Ur as createOpenInferenceFileExporter, Vr as buildLoopSpanNodes, Wa as providerMessageText, Wr as createOtelExporter, Xr as toOtelAttributes, Yr as padTraceId, Zr as createRuntimeEventCollector, ei as sanitizeKnowledgeReadinessReport, qr as loopEventToOtelSpan, ti as sanitizeRuntimeStreamEvent, zr as resolveRedactor } from "./supervisor-DA_nvF-h.js";
+import { Ar as buildRuntimeEventOtelSpans, Br as createRuntimeStreamEventCollector, Dr as resolveRedactor, Er as defaultRedactorIdentityMaterial, Fr as loopEventToOtelSpan, Hr as sanitizeKnowledgeReadinessReport, Ir as padSpanId, Li as executableAgentProfileSnapshot, Lr as padTraceId, Mr as createOtelExporter, Or as buildLoopOtelSpans, Pr as generateSpanId, Rr as toOtelAttributes, Ur as sanitizeRuntimeStreamEvent, Vr as sanitizeAgentRuntimeEvent, jr as createOpenInferenceFileExporter, kr as buildLoopSpanNodes, oa as providerMessageText, zr as createRuntimeEventCollector } from "./supervisor-DYKPbcZa.js";
 import { a as JudgeError, c as RetainedInteractiveAdmissionError, d as RetainedRunDispatchBindingError, f as RuntimeRunStateError, i as ConfigError, l as RetainedInteractiveBindingError, m as ValidationError, o as NotFoundError, r as BackendTransportError, s as PlannerError, t as AgentEvalError, u as RetainedRunAdmissionError } from "./errors-DodWX-cb.js";
-import { A as parseRolloutPolicy, C as privateValuePaths, D as ROLLOUT_POLICY_EXTENSION, M as structuralRolloutPolicyFromProfile, O as applyRolloutPolicyToProfile, S as parseExecutionRef, _t as startOrResumeRuntimeSession, a as SearchEnvironmentFault, b as assertCandidateValidator, ct as strategyAuthorMethod, d as sharedBoxLane, dt as createIterableBackend, f as subscriptionLane, ft as createSandboxPromptBackend, gt as nowIso, ht as newRuntimeSession, i as searchMethod, j as serializeRolloutPolicy, k as normalizeRolloutPolicy, l as routerLane, mt as InMemoryRuntimeSessionStore, o as dedicatedLane, pt as normalizeBackendStreamEvent, s as isSearchEnvironmentFault, st as optimizerMethod, ut as streamAgentTurn, vt as touchSession } from "./search-method-wTTS7mGG.js";
+import { $ as createIterableBackend, Q as streamAgentTurn, X as strategyAuthorMethod, Y as optimizerMethod, at as startOrResumeRuntimeSession, et as createSandboxPromptBackend, i as isSearchEnvironmentFault, it as nowIso, l as sharedBoxLane, nt as InMemoryRuntimeSessionStore, o as routerLane, ot as touchSession, r as dedicatedLane, rt as newRuntimeSession, t as SearchEnvironmentFault, tt as normalizeBackendStreamEvent, u as subscriptionLane, y as decideSearchImprovement } from "./search-executor-D3AT8_hb.js";
+import { A as canonicalCandidateBytes$1, F as immutableCandidateValue, I as omitTopLevelDigest, P as embeddedCandidateArtifact, d as persistCandidateOutputArtifact, j as canonicalCandidateDigest$1, s as captureAgentCandidateWorkspace } from "./workspace-streams-DaQceg2p.js";
 import { t as assertExecutableAgentProfile } from "./model-policy-DydyWTQg.js";
-import { a as createRuntimeUsageTotals, i as addRuntimeUsage, o as isUsageAmount, t as createAgentImprovementActivationResult } from "./activation-V6aaOlZV.js";
-import { M as embeddedCandidateArtifact, N as immutableCandidateValue, O as canonicalCandidateBytes$1, P as omitTopLevelDigest, a as captureAgentCandidateWorkspace, k as canonicalCandidateDigest$1, l as persistCandidateOutputArtifact } from "./workspace-streams-D5gHJdTb.js";
-import { Jt as connectStdioMcp, qt as McpSpawnFault } from "./runtime-6VPSJVeg.js";
+import { a as createRuntimeUsageTotals, i as addRuntimeUsage, o as isUsageAmount, t as createAgentImprovementActivationResult } from "./activation-kaJzXM7Y.js";
+import { Ht as McpSpawnFault, Ut as connectStdioMcp } from "./runtime-D452tieK.js";
 import { i as notifyRuntimeHookEvent, n as defineRuntimeHooks, r as notifyRuntimeDecisionPoint, t as composeRuntimeHooks } from "./runtime-hooks-tXpAarhW.js";
-import { B as rawTraceDistiller, H as commandVerifier, L as improve, R as createCommandProfileTrainer, U as defaultBuildPrompt, V as agenticGenerator, z as withMethodRuntimeControls } from "./improvement-cycle-Cf37Kexd.js";
-import { t as sealAgentCandidateBundle } from "./bundle-C9v5TH_H.js";
-import { r as supervise } from "./supervise-BJrEC2Mh.js";
-import { a as isDelegatedLoopMode, c as worktreeLoopRunner, i as auditLoopRunner, n as runLoopRunnerCli, o as researchLoopRunner, r as DELEGATED_LOOP_MODES, s as runDelegatedLoop, t as parseLoopRunnerArgv } from "./loop-runner-bin-C8MI8N1A.js";
+import { $ as commandVerifier, B as assertCandidateValidator, G as rawTraceDistiller, H as parseExecutionRef, J as normalizeRolloutPolicy, K as ROLLOUT_POLICY_EXTENSION, L as improve, Q as agenticGenerator, R as createCommandProfileTrainer, U as privateValuePaths, W as withMethodRuntimeControls, X as serializeRolloutPolicy, Y as parseRolloutPolicy, Z as structuralRolloutPolicyFromProfile, et as defaultBuildPrompt, q as applyRolloutPolicyToProfile, z as searchMethod } from "./improvement-cycle-DuIGusyA.js";
+import { t as sealAgentCandidateBundle } from "./bundle-E6mbRX2P.js";
+import { r as supervise } from "./supervise-CtewGpxh.js";
+import { a as isDelegatedLoopMode, c as worktreeLoopRunner, i as auditLoopRunner, n as runLoopRunnerCli, o as researchLoopRunner, r as DELEGATED_LOOP_MODES, s as runDelegatedLoop, t as parseLoopRunnerArgv } from "./loop-runner-bin-Dp1V3P2W.js";
 import { n as mcpToolsForRuntimeMcpSubset, t as mcpToolsForRuntimeMcp } from "./openai-tools-DoQ32vpe.js";
 import { agentCandidateKnowledgeSchema, agentCandidateWorkspaceManifestMaterialSchema, agentProfileSchema, canonicalAgentProfileDigest, canonicalCandidateDigest, sha256DigestSchema } from "@tangle-network/agent-interface";
 import { FAILURE_CLASSES, acquisitionPlansForKnowledgeGaps, blockingKnowledgeEval, canonicalJson, runAgentControlLoop, scoreKnowledgeReadiness, userQuestionsForKnowledgeGaps } from "@tangle-network/agent-eval";
@@ -340,66 +340,22 @@ async function* runConversationStream(conversation, options) {
 		const cfg = participant.callPolicy?.circuitBreaker ?? conversation.policy.defaultCallPolicy?.circuitBreaker;
 		breakers.set(participant.name, new CircuitBreakerState(cfg));
 	}
-	let transcript = [];
+	const transcript = [];
 	let spentCreditsCents = 0;
-	let startedAt = nowIso();
-	let resumed = false;
+	const startedAt = nowIso();
 	const sessionStore = options.sessionStore ?? new InMemoryRuntimeSessionStore();
-	if (options.journal) {
-		const prior = await options.journal.loadRun(runId);
-		if (prior) {
-			if (prior.halted) {
-				const replayResult = {
-					runId,
-					transcript: prior.turns,
-					turns: prior.turns.length,
-					spentCreditsCents: prior.turns.reduce((sum, t) => sum + centsFromUsd(t.usage?.costUsd ?? 0), 0),
-					halted: prior.halted,
-					durationMs: 0,
-					startedAt: prior.startedAt,
-					endedAt: prior.endedAt ?? prior.startedAt
-				};
-				yield {
-					type: "conversation_resumed",
-					runId,
-					participants: conversation.participants.map((p) => p.name),
-					transcript: prior.turns,
-					timestamp: nowIso()
-				};
-				yield {
-					type: "conversation_end",
-					runId,
-					result: replayResult,
-					timestamp: nowIso()
-				};
-				return;
-			}
-			transcript = [...prior.turns];
-			spentCreditsCents = transcript.reduce((sum, t) => sum + centsFromUsd(t.usage?.costUsd ?? 0), 0);
-			startedAt = prior.startedAt;
-			resumed = true;
-		} else await options.journal.beginRun(runId, startedAt);
-	}
 	const startedAtMs = Date.now();
-	const participantSessions = sessionIdsFrom(transcript);
-	if (resumed) yield {
-		type: "conversation_resumed",
-		runId,
-		participants: conversation.participants.map((p) => p.name),
-		transcript: [...transcript],
-		timestamp: nowIso()
-	};
-	else yield {
+	const participantSessions = /* @__PURE__ */ new Map();
+	yield {
 		type: "conversation_start",
 		runId,
 		participants: conversation.participants.map((p) => p.name),
 		seed: options.seed,
 		timestamp: startedAt
 	};
-	let currentInput = transcript.length === 0 ? options.seed : transcript[transcript.length - 1]?.text ?? options.seed;
+	let currentInput = options.seed;
 	let halt;
-	const initialOffset = transcript.length;
-	for (let turnIndex = initialOffset; turnIndex < conversation.policy.maxTurns; turnIndex++) {
+	for (let turnIndex = 0; turnIndex < conversation.policy.maxTurns; turnIndex++) {
 		if (options.signal?.aborted) {
 			halt = { kind: "abort" };
 			break;
@@ -526,7 +482,6 @@ async function* runConversationStream(conversation, options) {
 		if (turn.sessionId) bindParticipantSession(participantSessions, turn.speaker, turn.sessionId);
 		transcript.push(turn);
 		spentCreditsCents += centsFromUsd(turn.usage?.costUsd ?? 0);
-		if (options.journal) await options.journal.appendTurn(runId, turn);
 		yield {
 			type: "turn_end",
 			runId,
@@ -563,21 +518,19 @@ async function* runConversationStream(conversation, options) {
 		turns: transcript.length
 	};
 	const endedAt = nowIso();
-	const result = {
-		runId,
-		transcript,
-		turns: transcript.length,
-		spentCreditsCents,
-		halted: halt,
-		durationMs: Date.now() - startedAtMs,
-		startedAt,
-		endedAt
-	};
-	if (options.journal) await options.journal.recordHalt(runId, halt, endedAt);
 	yield {
 		type: "conversation_end",
 		runId,
-		result,
+		result: {
+			runId,
+			transcript,
+			turns: transcript.length,
+			spentCreditsCents,
+			halted: halt,
+			durationMs: Date.now() - startedAtMs,
+			startedAt,
+			endedAt
+		},
 		timestamp: endedAt
 	};
 }
@@ -747,11 +700,6 @@ function continuedConversationInput(task, speakerName, transcript) {
 		}]
 	};
 }
-function sessionIdsFrom(transcript) {
-	const sessions = /* @__PURE__ */ new Map();
-	for (const turn of transcript) if (turn.sessionId) bindParticipantSession(sessions, turn.speaker, turn.sessionId);
-	return sessions;
-}
 function bindParticipantSession(sessions, speakerName, sessionId) {
 	assertParticipantSessionAvailable(sessions, speakerName, sessionId);
 	sessions.set(speakerName, sessionId);
@@ -976,248 +924,6 @@ function normalizePolicy(policy, participantCount) {
 	};
 }
 //#endregion
-//#region src/conversation/journal.ts
-/**
-*
-* Durable conversation transcript — survives a driver process crash mid-run.
-* The runner journals every committed turn before yielding `turn_end`, so a
-* resumed run replays the same `runId` against the same journal and picks up
-* from the first un-recorded turn. Combined with the deterministic
-* `turnId(runId, index, speaker)`, a retried turn collides with the prior
-* attempt's id and any caching gateway can dedupe.
-*
-* The interface is small enough that a Cloudflare D1 / R2 / postgres adapter
-* is ~30 lines. The in-memory adapter is the default for tests and scratch.
-* The file adapter (JSONL on disk) is the default-durable choice when no
-* upstream store is wired.
-*
-* @stable
-*/
-/** In-memory `ConversationJournal` — suitable for testing and single-process runs. */
-var InMemoryConversationJournal = class {
-	entries = /* @__PURE__ */ new Map();
-	async loadRun(runId) {
-		const entry = this.entries.get(runId);
-		if (!entry) return void 0;
-		return {
-			runId: entry.runId,
-			startedAt: entry.startedAt,
-			halted: entry.halted,
-			endedAt: entry.endedAt,
-			turns: [...entry.turns]
-		};
-	}
-	async beginRun(runId, startedAt) {
-		const existing = this.entries.get(runId);
-		if (existing) {
-			if (existing.startedAt !== startedAt) throw new Error(`runId '${runId}' already exists with startedAt=${existing.startedAt}; refusing to overwrite with ${startedAt}`);
-			return;
-		}
-		this.entries.set(runId, {
-			runId,
-			startedAt,
-			turns: []
-		});
-	}
-	async appendTurn(runId, turn) {
-		const entry = this.entries.get(runId);
-		if (!entry) throw new Error(`appendTurn called for unknown runId '${runId}'; call beginRun first or use the runner which handles it`);
-		if (entry.halted) throw new Error(`cannot append turn to halted run '${runId}' (halt reason: ${JSON.stringify(entry.halted)})`);
-		entry.turns.push(turn);
-	}
-	async recordHalt(runId, halt, endedAt) {
-		const entry = this.entries.get(runId);
-		if (!entry) throw new Error(`recordHalt called for unknown runId '${runId}'`);
-		entry.halted = halt;
-		entry.endedAt = endedAt;
-	}
-};
-/**
-* JSONL on disk. One line per record; first line is the `begin`, subsequent
-* lines are `turn` records, terminal line is `halt`. Replays the whole file
-* on `loadRun` — cheap for the conversation sizes this is designed for
-* (thousands of turns, not millions). For huge runs, plug in a real DB
-* adapter; the interface is small.
-*
-* Reads and appends over the shared append-only spine (`durable/jsonl-file`): each
-* `appendTurn` / `recordHalt` finishes a short write and calls `fsync`, so a process
-* crash between writes never loses an acknowledged turn, and a crash DURING one leaves
-* an uncommitted final line that the next read skips and the next append truncates.
-*/
-var FileConversationJournal = class {
-	path;
-	constructor(path) {
-		this.path = path;
-	}
-	async loadRun(runId) {
-		let entry;
-		for await (const record of readCommittedJsonLines(this.path, { allowMissing: true })) {
-			if (record.runId !== runId) continue;
-			if (record.kind === "begin") entry = {
-				runId,
-				startedAt: record.startedAt,
-				turns: []
-			};
-			else if (record.kind === "turn") {
-				if (!entry) throw new Error(`journal corrupted: turn record for runId '${runId}' precedes its begin record`);
-				entry.turns.push(record.turn);
-			} else if (record.kind === "halt") {
-				if (!entry) throw new Error(`journal corrupted: halt record for runId '${runId}' precedes its begin record`);
-				entry.halted = record.halted;
-				entry.endedAt = record.endedAt;
-			}
-		}
-		return entry;
-	}
-	async beginRun(runId, startedAt) {
-		const existing = await this.loadRun(runId);
-		if (existing) {
-			if (existing.startedAt !== startedAt) throw new Error(`runId '${runId}' already exists in ${this.path} with startedAt=${existing.startedAt}; refusing to overwrite with ${startedAt}`);
-			return;
-		}
-		await this.appendRecord({
-			kind: "begin",
-			runId,
-			startedAt
-		});
-	}
-	async appendTurn(runId, turn) {
-		await this.appendRecord({
-			kind: "turn",
-			runId,
-			turn
-		});
-	}
-	async recordHalt(runId, halt, endedAt) {
-		await this.appendRecord({
-			kind: "halt",
-			runId,
-			halted: halt,
-			endedAt
-		});
-	}
-	async appendRecord(record) {
-		const fs = await import("node:fs/promises");
-		const path = await import("node:path");
-		await fs.mkdir(path.dirname(this.path), { recursive: true });
-		const needsSeparator = await prepareJsonlAppend(this.path);
-		const fh = await fs.open(this.path, "a");
-		try {
-			await writeAllBytes(fh, `${needsSeparator ? "\n" : ""}${JSON.stringify(record)}\n`);
-			await fh.sync();
-		} finally {
-			await fh.close();
-		}
-	}
-};
-//#endregion
-//#region src/conversation/journal-sql.ts
-/**
-* Adapt a Cloudflare D1 binding to the SqlAdapter shape. Lives here so D1
-* consumers don't have to write the wrapper themselves; the runtime never
-* imports `@cloudflare/workers-types` directly (peer-style typing).
-*/
-function d1ToSqlAdapter(db) {
-	return {
-		async exec(sql, params = []) {
-			const stmt = db.prepare(sql);
-			const meta = (await (params.length > 0 ? stmt.bind(...params) : stmt).run()).meta;
-			return { rowsAffected: meta?.rows_written ?? meta?.changes ?? 0 };
-		},
-		async query(sql, params = []) {
-			const stmt = db.prepare(sql);
-			return (await (params.length > 0 ? stmt.bind(...params) : stmt).all()).results ?? [];
-		}
-	};
-}
-const RUNS_TABLE_DDL = (table) => `
-  CREATE TABLE IF NOT EXISTS ${table}_runs (
-    run_id TEXT PRIMARY KEY,
-    started_at TEXT NOT NULL,
-    halted_kind TEXT,
-    halted_payload TEXT,
-    ended_at TEXT
-  )
-`;
-const TURNS_TABLE_DDL = (table) => `
-  CREATE TABLE IF NOT EXISTS ${table}_turns (
-    run_id TEXT NOT NULL,
-    turn_index INTEGER NOT NULL,
-    payload TEXT NOT NULL,
-    PRIMARY KEY (run_id, turn_index)
-  )
-`;
-const TURNS_INDEX_DDL = (table) => `
-  CREATE INDEX IF NOT EXISTS idx_${table}_turns_run ON ${table}_turns (run_id, turn_index)
-`;
-/**
-* SQL-backed ConversationJournal. Two tables — runs (one row per runId, holds
-* start/halt timestamps + halt reason) and turns (one row per committed turn,
-* payload is the ConversationTurn JSON). Replays the turns table on
-* `loadRun` and writes append-only per `appendTurn`.
-*/
-var SqlConversationJournal = class {
-	db;
-	table;
-	/**
-	* @param db    SQL adapter (D1, postgres, sqlite, libSQL — all work)
-	* @param table Table-name prefix; the journal creates `${table}_runs` and
-	*              `${table}_turns`. Lets multiple journals share a database
-	*              without colliding (e.g. one per product surface).
-	*/
-	constructor(db, table = "agent_runtime_journal") {
-		this.db = db;
-		this.table = table;
-	}
-	/**
-	* Create the journal's tables if absent. Idempotent. Call once at deploy
-	* (or at app boot) — running on every request is harmless but adds latency.
-	*/
-	async migrate() {
-		await this.db.exec(RUNS_TABLE_DDL(this.table));
-		await this.db.exec(TURNS_TABLE_DDL(this.table));
-		await this.db.exec(TURNS_INDEX_DDL(this.table));
-	}
-	async loadRun(runId) {
-		const row = (await this.db.query(`SELECT run_id, started_at, halted_kind, halted_payload, ended_at FROM ${this.table}_runs WHERE run_id = ?`, [runId]))[0];
-		if (!row) return void 0;
-		const turns = await this.db.query(`SELECT payload, turn_index FROM ${this.table}_turns WHERE run_id = ? ORDER BY turn_index ASC`, [runId]);
-		return {
-			runId: row.run_id,
-			startedAt: row.started_at,
-			halted: row.halted_payload ? JSON.parse(row.halted_payload) : void 0,
-			endedAt: row.ended_at ?? void 0,
-			turns: turns.map((t) => JSON.parse(t.payload))
-		};
-	}
-	async beginRun(runId, startedAt) {
-		const existing = await this.db.query(`SELECT started_at FROM ${this.table}_runs WHERE run_id = ?`, [runId]);
-		if (existing.length > 0) {
-			if (existing[0]?.started_at !== startedAt) throw new Error(`runId '${runId}' already exists with startedAt=${existing[0]?.started_at}; refusing to overwrite with ${startedAt}`);
-			return;
-		}
-		await this.db.exec(`INSERT INTO ${this.table}_runs (run_id, started_at) VALUES (?, ?)`, [runId, startedAt]);
-	}
-	async appendTurn(runId, turn) {
-		const halted = await this.db.query(`SELECT halted_kind FROM ${this.table}_runs WHERE run_id = ?`, [runId]);
-		if (halted.length === 0) throw new Error(`appendTurn called for unknown runId '${runId}'; call beginRun first or use the runner which handles it`);
-		if (halted[0]?.halted_kind) throw new Error(`cannot append turn to halted run '${runId}' (halt kind: ${halted[0]?.halted_kind})`);
-		await this.db.exec(`INSERT INTO ${this.table}_turns (run_id, turn_index, payload) VALUES (?, ?, ?)`, [
-			runId,
-			turn.index,
-			JSON.stringify(turn)
-		]);
-	}
-	async recordHalt(runId, halt, endedAt) {
-		if ((await this.db.exec(`UPDATE ${this.table}_runs SET halted_kind = ?, halted_payload = ?, ended_at = ? WHERE run_id = ?`, [
-			halt.kind,
-			JSON.stringify(halt),
-			endedAt,
-			runId
-		])).rowsAffected === 0) throw new Error(`recordHalt called for unknown runId '${runId}'`);
-	}
-};
-//#endregion
 //#region src/conversation/run-persona.ts
 /** Adapt one exact profile + Runtime executor into the conversation stream protocol. */
 function profileRuntimeBackend(profile, factory, counter) {
@@ -1347,6 +1053,26 @@ function runPersonaDispatch(config) {
 	};
 }
 //#endregion
+//#region src/durable/sql-adapter.ts
+/**
+* Adapt a Cloudflare D1 binding to the SqlAdapter shape. Lives here so D1
+* consumers don't have to write the wrapper themselves; the runtime never
+* imports `@cloudflare/workers-types` directly (peer-style typing).
+*/
+function d1ToSqlAdapter(db) {
+	return {
+		async exec(sql, params = []) {
+			const stmt = db.prepare(sql);
+			const meta = (await (params.length > 0 ? stmt.bind(...params) : stmt).run()).meta;
+			return { rowsAffected: meta?.rows_written ?? meta?.changes ?? 0 };
+		},
+		async query(sql, params = []) {
+			const stmt = db.prepare(sql);
+			return (await (params.length > 0 ? stmt.bind(...params) : stmt).all()).results ?? [];
+		}
+	};
+}
+//#endregion
 //#region src/improvement/build-prompts.ts
 /** Render findings as the ranked-evidence block every build prompt ends with. */
 function findingLines(findings) {
@@ -1943,6 +1669,183 @@ function applyPatches(edits, cwd) {
 	if (result.status !== 0) throw new Error(`reflectiveGenerator: patch batch failed: ${result.stderr.trim()}`);
 }
 //#endregion
+//#region src/improvement/reflective-profile-proposer.ts
+const OPERATOR = {
+	draft: "OPERATOR: draft. Write a substantially different approach from the parent below, not an edit of it.",
+	improve: "OPERATOR: improve. Edit the parent below to fix its dominant failure mode; keep what already works.",
+	debug: "OPERATOR: debug. The parent below failed as a defect (crashes, no answer, a broken format). Fix the cause.",
+	merge: "OPERATOR: merge. Combine the strengths of the parents below into one surface."
+};
+/** Build the maintained reflective proposer for a profile text surface. */
+function reflectiveProfileProposer(options) {
+	const kind = options.kind ?? "reflective-profile";
+	const maxOutputTokens = options.maxOutputTokens ?? 16e3;
+	const maxSurfaceChars = options.maxSurfaceChars ?? 12e3;
+	if (!kind.trim() || kind.trim() !== kind) throw new ConfigError("reflectiveProfileProposer(): kind must be a trimmed non-empty string");
+	if (!options.model?.trim()) throw new ConfigError("reflectiveProfileProposer(): model is required");
+	if (typeof options.chat !== "function") throw new ConfigError("reflectiveProfileProposer(): chat must be a function");
+	if (!options.frame?.trim()) throw new ConfigError("reflectiveProfileProposer(): frame is required");
+	for (const [name, value] of [["maxOutputTokens", maxOutputTokens], ["maxSurfaceChars", maxSurfaceChars]]) if (!Number.isSafeInteger(value) || value < 1) throw new ConfigError(`reflectiveProfileProposer(): ${name} must be a positive integer`);
+	const evidenceOf = options.evidence ?? defaultEvidence;
+	return {
+		kind,
+		async propose(ctx) {
+			if (!ctx.costLedger) throw new ConfigError("reflectiveProfileProposer(): the proposal has no cost ledger; run it through improve() with searchMethod");
+			const parents = (ctx.parents ?? [{
+				nodeId: null,
+				artifact: ctx.currentSurface
+			}]).map((parent) => ({
+				nodeId: parent.nodeId,
+				surface: parent.artifact,
+				trainCells: parent.nodeId && ctx.train ? [...ctx.train.scoredCells(parent.nodeId)] : []
+			}));
+			const shape = surfaceShape(ctx.currentSurface);
+			const sections = [];
+			for (const [index, parent] of parents.entries()) {
+				const evidence = await evidenceOf(parent);
+				sections.push([
+					`## Parent ${index + 1}${parent.nodeId ? ` (${parent.nodeId})` : ""}: its current surface`,
+					renderSurface(parent.surface),
+					`## Parent ${index + 1}: its train results (${parent.trainCells.length} scored cells)`,
+					...evidence
+				].join("\n"));
+			}
+			const system = [
+				optimizerMethod,
+				"",
+				options.frame.trim(),
+				"",
+				outputContract(shape, maxSurfaceChars)
+			].join("\n");
+			const user = [
+				OPERATOR[ctx.operator ?? "improve"],
+				"",
+				...sections,
+				"",
+				"## The search so far (train split only)",
+				ctx.summary?.trim() || "(nothing measured yet)"
+			].join("\n");
+			const messages = [{
+				role: "system",
+				content: system
+			}, {
+				role: "user",
+				content: user
+			}];
+			const inputTokens = messages.reduce((total, message) => total + Buffer.byteLength(message.content, "utf8"), 0) + 16 * messages.length;
+			const paid = await ctx.costLedger.runPaidCall({
+				channel: "proposer",
+				phase: ctx.costPhase ?? "proposal",
+				actor: kind,
+				model: options.model,
+				signal: ctx.signal,
+				maximumCharge: {
+					customTokenPricing: options.pricing,
+					inputTokens,
+					outputTokens: maxOutputTokens
+				},
+				execute: (signal, callId) => options.chat({
+					messages,
+					maxOutputTokens,
+					callId,
+					signal
+				}),
+				receipt: (reply) => reply.usage === null ? {
+					model: reply.model ?? options.model,
+					inputTokens: 0,
+					outputTokens: 0,
+					costUnknown: true,
+					usageUnknown: true
+				} : {
+					model: reply.model ?? options.model,
+					inputTokens: reply.usage.inputTokens,
+					outputTokens: reply.usage.outputTokens,
+					...reply.usage.reasoningTokens === void 0 ? {} : { reasoningTokens: reply.usage.reasoningTokens },
+					...reply.usage.cachedTokens === void 0 ? {} : { cachedTokens: reply.usage.cachedTokens },
+					customTokenPricing: options.pricing
+				}
+			});
+			if (!paid.succeeded) throw paid.error;
+			const proposal = parseProposal(paid.value.content, shape, maxSurfaceChars);
+			return proposal === null ? [] : [proposal];
+		}
+	};
+}
+function surfaceShape(surface) {
+	if (typeof surface === "string") return { kind: "text" };
+	if (surface.kind === "components") return {
+		kind: "components",
+		names: Object.keys(surface.components).sort()
+	};
+	throw new ConfigError("reflectiveProfileProposer(): a code surface is improved through worktrees, not a text proposer");
+}
+function renderSurface(surface) {
+	if (typeof surface === "string") return [
+		"\"\"\"",
+		surface,
+		"\"\"\""
+	].join("\n");
+	if (surface.kind !== "components") return "(a code surface)";
+	return Object.keys(surface.components).sort().map((name) => [
+		`### Component ${name}`,
+		"\"\"\"",
+		surface.components[name],
+		"\"\"\""
+	].join("\n")).join("\n");
+}
+function outputContract(shape, maxChars) {
+	return [
+		"OUTPUT. Reply with one JSON object and nothing else:",
+		`{"label": "<at most 8 words naming the change>", "hypothesis": "<the dominant failure mode, the mechanism, and the predicted effect on the score>", ${shape.kind === "text" ? "\"surface\": \"<the complete new text>\"" : `"surface": { ${shape.names.map((name) => `"${name}": "<its complete new text>"`).join(", ")} }`}}`,
+		shape.kind === "text" ? `The surface must stand alone, at most ${maxChars} characters: the agent sees nothing else from you.` : `Return every component, each complete, at most ${maxChars} characters in all: the agent sees nothing else from you.`
+	].join("\n");
+}
+/** The proposal in a reply: the whole reply as JSON, else its outermost {...} span. */
+function parseProposal(content, shape, maxChars) {
+	const start = content.indexOf("{");
+	const end = content.lastIndexOf("}");
+	for (const text of [content, start >= 0 && end > start ? content.slice(start, end + 1) : ""]) {
+		let value;
+		try {
+			value = JSON.parse(text);
+		} catch {
+			continue;
+		}
+		if (typeof value !== "object" || value === null) continue;
+		const { label, hypothesis, surface } = value;
+		const parsed = surfaceOf(surface, shape, maxChars);
+		if (parsed === null) continue;
+		return {
+			surface: parsed,
+			label: String(label ?? "").slice(0, 80),
+			rationale: String(hypothesis ?? "").slice(0, 4e3)
+		};
+	}
+	return null;
+}
+function surfaceOf(value, shape, maxChars) {
+	if (shape.kind === "text") return typeof value === "string" && value.trim() && value.length <= maxChars ? value : null;
+	if (typeof value !== "object" || value === null) return null;
+	const record = value;
+	const names = Object.keys(record).sort();
+	if (names.join("\n") !== shape.names.join("\n")) return null;
+	let total = 0;
+	const components = {};
+	for (const name of names) {
+		const text = record[name];
+		if (typeof text !== "string" || !text.trim()) return null;
+		total += text.length;
+		components[name] = text;
+	}
+	return total <= maxChars ? {
+		kind: "components",
+		components
+	} : null;
+}
+function defaultEvidence(parent) {
+	return parent.trainCells.map((cell) => `- train unit ${cell.unitId}: score ${cell.score}`);
+}
+//#endregion
 //#region src/knowledge/activation.ts
 /** Apply or restore one local knowledge candidate through the shared activation contract. */
 function createKnowledgeImprovementActivationExecutor(options) {
@@ -3183,6 +3086,6 @@ function stripNewlines(value) {
 	return value.replace(/[\r\n]/g, " ");
 }
 //#endregion
-export { AgentEvalError, BackendTransportError, ConfigError, DEFAULT_ROUTER_BASE_URL, DELEGATED_LOOP_MODES, FileConversationJournal, InMemoryConversationJournal, InMemoryRuntimeSessionStore, JudgeError, NotFoundError, OfficialOptimizerUnavailableError, PROMPT_INSTRUCTION_COMPONENT_PREFIX, PlannerError, RESEARCH_SUPERVISOR_SYSTEM_PROMPT, ROLLOUT_POLICY_EXTENSION, RetainedInteractiveAdmissionError, RetainedInteractiveBindingError, RetainedRunAdmissionError, RetainedRunDispatchBindingError, RuntimeRunStateError, SearchEnvironmentFault, SqlConversationJournal, ValidationError, agenticGenerator, applyRolloutPolicyToProfile, applyRunRecordDefaults, auditLoopRunner, buildKnowledgeImprovementExperimentBundles, buildLoopOtelSpans, buildLoopSpanNodes, buildRuntimeEventOtelSpans, cleanModelId, commandVerifier, composeRuntimeHooks, createAgentKnowledgeReadinessCheck, createCommandProfileTrainer, createConversationBackend, createIterableBackend, createKnowledgeImprovementActivationExecutor, createOpenInferenceFileExporter, createOtelExporter, createProfileExecutionBackend, createProfileImprovementHarness, createRuntimeEventCollector, createRuntimeStreamEventCollector, createSandboxPromptBackend, createSupervisedKnowledgeUpdater, d1ToSqlAdapter, decideKnowledgeReadiness, dedicatedLane, defaultBuildPrompt, defineConversation, defineRuntimeHooks, findingLines, formatSupervisedKnowledgeTask, generateSpanId, getModels, improve, isDelegatedLoopMode, isSearchEnvironmentFault, isolatedCheckBoxEvidenceSchema, isolatedCheckResultSchema, knowledgeReadinessDeliverable, loopEventToOtelSpan, mcpBuildPrompt, mcpServeVerifier, mcpToolsForRuntimeMcp, mcpToolsForRuntimeMcpSubset, normalizeRolloutPolicy, notifyRuntimeDecisionPoint, notifyRuntimeHookEvent, officialGepa, officialSkillOpt, optimizerMethod, padSpanId, padTraceId, parseLoopRunnerArgv, parseRolloutPolicy, promptInstructionsProfileComponents, rawTraceDistiller, readinessServerSentEvent, reflectiveGenerator, researchLoopRunner, resolveChatModel, resolveRouterBaseUrl, routerLane, runAgentTask, runAgentTaskStream, runConversation, runConversationStream, runDelegatedLoop, runKnowledgeImprovementJob, runLoopRunnerCli, runPersonaConversation, runPersonaDispatch, runSupervisedKnowledgeUpdate, runtimeStreamServerSentEvent, sanitizeAgentRuntimeEvent, sanitizeKnowledgeReadinessReport, sanitizeRuntimeStreamEvent, searchMethod, serializeRolloutPolicy, sharedBoxLane, startRuntimeRun, strategyAuthorMethod, structuralRolloutPolicyFromProfile, subscriptionLane, toOtelAttributes, toolBuildPrompt, validateChatModelId, worktreeLoopRunner };
+export { AgentEvalError, BackendTransportError, ConfigError, DEFAULT_ROUTER_BASE_URL, DELEGATED_LOOP_MODES, InMemoryRuntimeSessionStore, JudgeError, NotFoundError, OfficialOptimizerUnavailableError, PROMPT_INSTRUCTION_COMPONENT_PREFIX, PlannerError, RESEARCH_SUPERVISOR_SYSTEM_PROMPT, ROLLOUT_POLICY_EXTENSION, RetainedInteractiveAdmissionError, RetainedInteractiveBindingError, RetainedRunAdmissionError, RetainedRunDispatchBindingError, RuntimeRunStateError, SearchEnvironmentFault, ValidationError, agenticGenerator, applyRolloutPolicyToProfile, applyRunRecordDefaults, auditLoopRunner, buildKnowledgeImprovementExperimentBundles, buildLoopOtelSpans, buildLoopSpanNodes, buildRuntimeEventOtelSpans, cleanModelId, commandVerifier, composeRuntimeHooks, createAgentKnowledgeReadinessCheck, createCommandProfileTrainer, createConversationBackend, createIterableBackend, createKnowledgeImprovementActivationExecutor, createOpenInferenceFileExporter, createOtelExporter, createProfileExecutionBackend, createProfileImprovementHarness, createRuntimeEventCollector, createRuntimeStreamEventCollector, createSandboxPromptBackend, createSupervisedKnowledgeUpdater, d1ToSqlAdapter, decideKnowledgeReadiness, decideSearchImprovement, dedicatedLane, defaultBuildPrompt, defineConversation, defineRuntimeHooks, findingLines, formatSupervisedKnowledgeTask, generateSpanId, getModels, improve, isDelegatedLoopMode, isSearchEnvironmentFault, isolatedCheckBoxEvidenceSchema, isolatedCheckResultSchema, knowledgeReadinessDeliverable, loopEventToOtelSpan, mcpBuildPrompt, mcpServeVerifier, mcpToolsForRuntimeMcp, mcpToolsForRuntimeMcpSubset, normalizeRolloutPolicy, notifyRuntimeDecisionPoint, notifyRuntimeHookEvent, officialGepa, officialSkillOpt, optimizerMethod, padSpanId, padTraceId, parseLoopRunnerArgv, parseRolloutPolicy, promptInstructionsProfileComponents, rawTraceDistiller, readinessServerSentEvent, reflectiveGenerator, reflectiveProfileProposer, researchLoopRunner, resolveChatModel, resolveRouterBaseUrl, routerLane, runAgentTask, runAgentTaskStream, runConversation, runConversationStream, runDelegatedLoop, runKnowledgeImprovementJob, runLoopRunnerCli, runPersonaConversation, runPersonaDispatch, runSupervisedKnowledgeUpdate, runtimeStreamServerSentEvent, sanitizeAgentRuntimeEvent, sanitizeKnowledgeReadinessReport, sanitizeRuntimeStreamEvent, searchMethod, serializeRolloutPolicy, sharedBoxLane, startRuntimeRun, strategyAuthorMethod, structuralRolloutPolicyFromProfile, subscriptionLane, toOtelAttributes, toolBuildPrompt, validateChatModelId, worktreeLoopRunner };
 
 //# sourceMappingURL=index.js.map