agents 0.26.0 → 0.27.0

package/dist/daemon-core-Buubj-y1.js

@@ -0,0 +1,481 @@
+import { i as _classPrivateFieldInitSpec, n as _classPrivateFieldSet2, r as _assertClassBrand, t as _classPrivateFieldGet2 } from "./classPrivateFieldGet2-DZBYAB34.js";
+import { t as _classPrivateMethodInitSpec } from "./classPrivateMethodInitSpec-qMjJ6sHQ.js";
+import { f as parseHostMessage, l as chunkEntries, t as CLOSE_REPLACED, u as inputText } from "./protocol-cOklVBBD.js";
+//#region src/harness/container/daemon-core.ts
+/**
+* The harness daemon's core: everything about running an agent inside a
+* container that does not depend on which agent it is.
+*
+* A daemon serves any number of sessions. For each one it keeps a queue of
+* operations, runs them one at a time through an adapter, numbers every
+* frame it produces, and keeps frames until the Durable Object acknowledges
+* them, so a reconnecting object replays exactly what it missed. The
+* adapter is the only agent-specific part: it opens a session (resuming it
+* from state it persisted earlier, possibly in another container), runs one
+* turn at a time, and reports what happens as `ContainerEvent`s.
+*
+* Nothing here touches Node, a socket library or a model SDK. The transport
+* hands the daemon a `DaemonSocket` per connection and feeds it messages;
+* `./runtime` does that over HTTP in a container, and the tests do it over
+* a `WebSocketPair` in Workers.
+*
+* Modelled on the AI SDK's harness bridge (`runBridge`): the runtime owns
+* the transport, sequencing and replay, and an adapter owns only the agent.
+*
+* @experimental The API may change before it stabilizes.
+*/
+/** Settled operations remembered per session, for `hello`. */
+const SETTLED_KEPT = 1e3;
+var _adapter = /* @__PURE__ */ new WeakMap();
+var _runtimeId = /* @__PURE__ */ new WeakMap();
+var _maxKeptFrames = /* @__PURE__ */ new WeakMap();
+var _sessions = /* @__PURE__ */ new WeakMap();
+/**
+* The daemon core. One per container process.
+*
+* @experimental The API may change before it stabilizes.
+*/
+var ContainerDaemon = class {
+	/**
+	* @param options - The adapter and this container's id.
+	*/
+	constructor(options) {
+		_classPrivateFieldInitSpec(this, _adapter, void 0);
+		_classPrivateFieldInitSpec(this, _runtimeId, void 0);
+		_classPrivateFieldInitSpec(this, _maxKeptFrames, void 0);
+		_classPrivateFieldInitSpec(this, _sessions, /* @__PURE__ */ new Map());
+		_classPrivateFieldSet2(_adapter, this, options.adapter);
+		_classPrivateFieldSet2(_runtimeId, this, options.runtimeId);
+		_classPrivateFieldSet2(_maxKeptFrames, this, options.maxKeptFrames ?? 1e4);
+	}
+	/**
+	* Attach a connection for a session. A newer connection replaces an older
+	* one, which is closed with `CLOSE_REPLACED`. The daemon sends `hello`
+	* at once.
+	*
+	* @param session - The harness session id.
+	* @param socket - The send side.
+	* @returns The receive side, for the transport to drive.
+	*/
+	connect(session, socket) {
+		let state = _classPrivateFieldGet2(_sessions, this).get(session);
+		if (!state) {
+			state = new DaemonSession(session, _classPrivateFieldGet2(_adapter, this), _classPrivateFieldGet2(_runtimeId, this), _classPrivateFieldGet2(_maxKeptFrames, this));
+			_classPrivateFieldGet2(_sessions, this).set(session, state);
+		}
+		return state.attach(socket);
+	}
+	/** Close every adapter session, as the container shuts down. */
+	async close() {
+		await Promise.all([..._classPrivateFieldGet2(_sessions, this).values()].map((s) => s.shutdown()));
+	}
+};
+var _id = /* @__PURE__ */ new WeakMap();
+var _adapter2 = /* @__PURE__ */ new WeakMap();
+var _runtimeId2 = /* @__PURE__ */ new WeakMap();
+var _maxKeptFrames2 = /* @__PURE__ */ new WeakMap();
+var _seq = /* @__PURE__ */ new WeakMap();
+var _kept = /* @__PURE__ */ new WeakMap();
+var _operations = /* @__PURE__ */ new WeakMap();
+var _queue = /* @__PURE__ */ new WeakMap();
+var _running = /* @__PURE__ */ new WeakMap();
+var _opened = /* @__PURE__ */ new WeakMap();
+var _restoring = /* @__PURE__ */ new WeakMap();
+var _socket = /* @__PURE__ */ new WeakMap();
+var _live = /* @__PURE__ */ new WeakMap();
+var _inbox = /* @__PURE__ */ new WeakMap();
+var _DaemonSession_brand = /* @__PURE__ */ new WeakSet();
+var DaemonSession = class {
+	constructor(id, adapter, runtimeId, maxKeptFrames) {
+		_classPrivateMethodInitSpec(this, _DaemonSession_brand);
+		_classPrivateFieldInitSpec(this, _id, void 0);
+		_classPrivateFieldInitSpec(this, _adapter2, void 0);
+		_classPrivateFieldInitSpec(this, _runtimeId2, void 0);
+		_classPrivateFieldInitSpec(this, _maxKeptFrames2, void 0);
+		_classPrivateFieldInitSpec(this, _seq, 0);
+		_classPrivateFieldInitSpec(this, _kept, []);
+		_classPrivateFieldInitSpec(this, _operations, /* @__PURE__ */ new Map());
+		_classPrivateFieldInitSpec(this, _queue, []);
+		_classPrivateFieldInitSpec(this, _running, void 0);
+		_classPrivateFieldInitSpec(this, _opened, void 0);
+		_classPrivateFieldInitSpec(this, _restoring, void 0);
+		_classPrivateFieldInitSpec(this, _socket, void 0);
+		_classPrivateFieldInitSpec(this, _live, false);
+		_classPrivateFieldInitSpec(this, _inbox, Promise.resolve());
+		_classPrivateFieldSet2(_id, this, id);
+		_classPrivateFieldSet2(_adapter2, this, adapter);
+		_classPrivateFieldSet2(_runtimeId2, this, runtimeId);
+		_classPrivateFieldSet2(_maxKeptFrames2, this, maxKeptFrames);
+	}
+	attach(socket) {
+		const previous = _classPrivateFieldGet2(_socket, this);
+		_classPrivateFieldSet2(_socket, this, socket);
+		_classPrivateFieldSet2(_live, this, false);
+		previous?.close(CLOSE_REPLACED, "replaced by a newer connection");
+		_assertClassBrand(_DaemonSession_brand, this, _send).call(this, socket, _assertClassBrand(_DaemonSession_brand, this, _hello).call(this));
+		return {
+			receive: (text) => {
+				if (_classPrivateFieldGet2(_socket, this) !== socket) return;
+				const message = parseHostMessage(text);
+				if (!message) {
+					_assertClassBrand(_DaemonSession_brand, this, _send).call(this, socket, {
+						type: "error",
+						message: "unparseable message"
+					});
+					return;
+				}
+				_classPrivateFieldSet2(_inbox, this, _classPrivateFieldGet2(_inbox, this).then(() => _assertClassBrand(_DaemonSession_brand, this, _handle).call(this, message)).catch((error) => {
+					_assertClassBrand(_DaemonSession_brand, this, _send).call(this, socket, {
+						type: "error",
+						message: errorText(error)
+					});
+				}));
+			},
+			closed: () => {
+				if (_classPrivateFieldGet2(_socket, this) !== socket) return;
+				_classPrivateFieldSet2(_socket, this, void 0);
+				_classPrivateFieldSet2(_live, this, false);
+			}
+		};
+	}
+	async shutdown() {
+		_classPrivateFieldGet2(_running, this)?.controller.abort();
+		const opened = _classPrivateFieldGet2(_opened, this);
+		_classPrivateFieldSet2(_opened, this, void 0);
+		await opened?.session.close().catch(() => void 0);
+	}
+};
+function _hello() {
+	const operations = [];
+	for (const operation of _classPrivateFieldGet2(_operations, this).values()) {
+		const state = operation.state;
+		operations.push(state.tag === "settled" ? {
+			operationId: operation.id,
+			status: "settled",
+			outcome: state.outcome
+		} : {
+			operationId: operation.id,
+			status: state.tag
+		});
+	}
+	return {
+		type: "hello",
+		protocol: 1,
+		runtimeId: _classPrivateFieldGet2(_runtimeId2, this),
+		session: _classPrivateFieldGet2(_id, this),
+		adapter: {
+			id: _classPrivateFieldGet2(_adapter2, this).id,
+			version: _classPrivateFieldGet2(_adapter2, this).version,
+			capabilities: [..._classPrivateFieldGet2(_adapter2, this).capabilities ?? []]
+		},
+		open: _classPrivateFieldGet2(_opened, this)?.generation ?? null,
+		lastSeq: _classPrivateFieldGet2(_seq, this),
+		operations
+	};
+}
+async function _handle(message) {
+	switch (message.type) {
+		case "restore":
+			if (_classPrivateFieldGet2(_restoring, this)?.generation !== message.generation) _classPrivateFieldSet2(_restoring, this, {
+				generation: message.generation,
+				entries: []
+			});
+			_classPrivateFieldGet2(_restoring, this).entries.push(...message.entries);
+			return;
+		case "open":
+			await _assertClassBrand(_DaemonSession_brand, this, _open).call(this, message);
+			return;
+		case "replay":
+			_assertClassBrand(_DaemonSession_brand, this, _replay).call(this, message.after);
+			return;
+		case "prompt":
+			await _assertClassBrand(_DaemonSession_brand, this, _prompt).call(this, message.operationId, message.input, message.whenBusy);
+			return;
+		case "abort":
+			_assertClassBrand(_DaemonSession_brand, this, _abort).call(this, message.operationId);
+			return;
+		case "configure":
+			await _classPrivateFieldGet2(_opened, this)?.session.configure?.(message.settings);
+			return;
+		case "ack":
+			_classPrivateFieldSet2(_kept, this, _classPrivateFieldGet2(_kept, this).filter((kept) => kept.seq > message.seq));
+			return;
+	}
+}
+async function _open(message) {
+	const restoring = _classPrivateFieldGet2(_restoring, this);
+	_classPrivateFieldSet2(_restoring, this, void 0);
+	if (_classPrivateFieldGet2(_opened, this)?.generation === message.generation) return;
+	const restore = restoring?.generation === message.generation ? [...restoring.entries, ...message.restore] : message.restore;
+	if (_classPrivateFieldGet2(_opened, this)) {
+		_classPrivateFieldGet2(_running, this)?.controller.abort();
+		await _classPrivateFieldGet2(_opened, this).session.close().catch(() => void 0);
+		_classPrivateFieldSet2(_opened, this, void 0);
+	}
+	const session = await _classPrivateFieldGet2(_adapter2, this).open({
+		session: _classPrivateFieldGet2(_id, this),
+		settings: message.settings,
+		restore,
+		emit: (event) => _assertClassBrand(_DaemonSession_brand, this, _emit).call(this, {
+			kind: "event",
+			operationId: _classPrivateFieldGet2(_running, this)?.id ?? null,
+			event
+		}),
+		persist: (entries) => {
+			for (const group of chunkEntries(entries)) _assertClassBrand(_DaemonSession_brand, this, _emit).call(this, {
+				kind: "persist",
+				entries: group
+			});
+		},
+		log: (level, text) => _assertClassBrand(_DaemonSession_brand, this, _emit).call(this, {
+			kind: "event",
+			operationId: _classPrivateFieldGet2(_running, this)?.id ?? null,
+			event: {
+				type: "log",
+				level,
+				message: text
+			}
+		})
+	});
+	_classPrivateFieldSet2(_opened, this, {
+		generation: message.generation,
+		session
+	});
+	_assertClassBrand(_DaemonSession_brand, this, _pump).call(this);
+}
+function _replay(after) {
+	const socket = _classPrivateFieldGet2(_socket, this);
+	if (!socket) return;
+	for (const kept of _classPrivateFieldGet2(_kept, this)) if (kept.seq > after) _assertClassBrand(_DaemonSession_brand, this, _send).call(this, socket, {
+		type: "frame",
+		seq: kept.seq,
+		frame: kept.frame
+	});
+	_assertClassBrand(_DaemonSession_brand, this, _send).call(this, socket, {
+		type: "caught-up",
+		lastSeq: _classPrivateFieldGet2(_seq, this)
+	});
+	_classPrivateFieldSet2(_live, this, true);
+}
+async function _prompt(id, input, whenBusy) {
+	if (_classPrivateFieldGet2(_operations, this).has(id)) return;
+	const operation = {
+		id,
+		input,
+		whenBusy,
+		state: { tag: "queued" }
+	};
+	_classPrivateFieldGet2(_operations, this).set(id, operation);
+	_assertClassBrand(_DaemonSession_brand, this, _forgetOldSettled).call(this);
+	const running = _classPrivateFieldGet2(_running, this);
+	const steer = _classPrivateFieldGet2(_opened, this)?.session.steer;
+	if (whenBusy === "steer" && running && steer) {
+		if (await steer.call(_classPrivateFieldGet2(_opened, this)?.session, input) && _classPrivateFieldGet2(_running, this) === running) {
+			operation.state = { tag: "running" };
+			running.folded.push(id);
+			_assertClassBrand(_DaemonSession_brand, this, _emit).call(this, {
+				kind: "start",
+				operationId: id
+			});
+			return;
+		}
+	}
+	_classPrivateFieldGet2(_queue, this).push(id);
+	_assertClassBrand(_DaemonSession_brand, this, _pump).call(this);
+}
+function _abort(id) {
+	const ids = id === void 0 ? [..._classPrivateFieldGet2(_operations, this).keys()] : _classPrivateFieldGet2(_operations, this).has(id) ? [id] : [];
+	for (const each of ids) {
+		const operation = _classPrivateFieldGet2(_operations, this).get(each);
+		if (!operation) continue;
+		if (operation.state.tag === "queued") {
+			const at = _classPrivateFieldGet2(_queue, this).indexOf(each);
+			if (at >= 0) _classPrivateFieldGet2(_queue, this).splice(at, 1);
+			_assertClassBrand(_DaemonSession_brand, this, _settle).call(this, operation, {
+				status: "unanswered",
+				reason: "aborted"
+			});
+		} else if (operation.state.tag === "running") _classPrivateFieldGet2(_running, this)?.controller.abort();
+	}
+}
+/** Start the next queued operation, if the session is open and idle. */
+function _pump() {
+	const opened = _classPrivateFieldGet2(_opened, this);
+	if (_classPrivateFieldGet2(_running, this) || !opened) return;
+	const id = _classPrivateFieldGet2(_queue, this).shift();
+	if (id === void 0) return;
+	const operation = _classPrivateFieldGet2(_operations, this).get(id);
+	if (!operation || operation.state.tag !== "queued") {
+		_assertClassBrand(_DaemonSession_brand, this, _pump).call(this);
+		return;
+	}
+	const running = {
+		id,
+		folded: [],
+		controller: new AbortController()
+	};
+	_classPrivateFieldSet2(_running, this, running);
+	operation.state = { tag: "running" };
+	_assertClassBrand(_DaemonSession_brand, this, _emit).call(this, {
+		kind: "start",
+		operationId: id
+	});
+	_assertClassBrand(_DaemonSession_brand, this, _run).call(this, opened, operation, running);
+}
+async function _run(opened, operation, running) {
+	let outcome;
+	try {
+		outcome = await opened.session.run({
+			operationId: operation.id,
+			input: operation.input,
+			signal: running.controller.signal
+		});
+		if (running.controller.signal.aborted && outcome.status === "done") outcome = {
+			status: "unanswered",
+			reason: "aborted"
+		};
+	} catch (error) {
+		outcome = {
+			status: "unanswered",
+			reason: running.controller.signal.aborted ? "aborted" : errorText(error)
+		};
+	}
+	if (_classPrivateFieldGet2(_running, this) === running) _classPrivateFieldSet2(_running, this, void 0);
+	_assertClassBrand(_DaemonSession_brand, this, _settle).call(this, operation, outcome);
+	for (const folded of running.folded) {
+		const each = _classPrivateFieldGet2(_operations, this).get(folded);
+		if (each) _assertClassBrand(_DaemonSession_brand, this, _settle).call(this, each, outcome);
+	}
+	_assertClassBrand(_DaemonSession_brand, this, _pump).call(this);
+}
+function _settle(operation, outcome) {
+	if (operation.state.tag === "settled") return;
+	operation.state = {
+		tag: "settled",
+		outcome
+	};
+	_assertClassBrand(_DaemonSession_brand, this, _emit).call(this, {
+		kind: "settle",
+		operationId: operation.id,
+		outcome
+	});
+}
+function _emit(frame) {
+	_classPrivateFieldSet2(_seq, this, _classPrivateFieldGet2(_seq, this) + 1);
+	const seq = _classPrivateFieldGet2(_seq, this);
+	_classPrivateFieldGet2(_kept, this).push({
+		seq,
+		frame
+	});
+	if (_classPrivateFieldGet2(_kept, this).length > _classPrivateFieldGet2(_maxKeptFrames2, this)) _classPrivateFieldGet2(_kept, this).splice(0, _classPrivateFieldGet2(_kept, this).length - _classPrivateFieldGet2(_maxKeptFrames2, this));
+	const socket = _classPrivateFieldGet2(_socket, this);
+	if (socket && _classPrivateFieldGet2(_live, this)) _assertClassBrand(_DaemonSession_brand, this, _send).call(this, socket, {
+		type: "frame",
+		seq,
+		frame
+	});
+}
+function _send(socket, message) {
+	try {
+		socket.send(JSON.stringify(message));
+	} catch {}
+}
+function _forgetOldSettled() {
+	if (_classPrivateFieldGet2(_operations, this).size <= SETTLED_KEPT) return;
+	for (const [id, operation] of _classPrivateFieldGet2(_operations, this)) {
+		if (_classPrivateFieldGet2(_operations, this).size <= SETTLED_KEPT) return;
+		if (operation.state.tag === "settled") _classPrivateFieldGet2(_operations, this).delete(id);
+	}
+}
+function errorText(error) {
+	return error instanceof Error ? error.message : String(error);
+}
+/**
+* A reference adapter that answers `echo: <text>` and needs no model or
+* credentials. Use it for keyless smoke deploys of the whole path and in
+* tests. It persists one entry per turn and counts them back after a
+* restore, so a resumed session visibly remembers its history:
+*
+* - `slow <ms> <text>` waits `ms` before answering, and stops on abort.
+* - `fail <reason>` settles the operation unanswered with `reason`.
+* - anything else is echoed with the turn number: `echo: hi (turn 3)`.
+*
+* @experimental The API may change before it stabilizes.
+*/
+const echoAdapter = {
+	id: "echo",
+	version: "1",
+	capabilities: ["steer"],
+	open(context) {
+		let turns = context.restore.length;
+		const steered = [];
+		return {
+			async run(turn) {
+				const text = inputText(turn.input);
+				const slow = /^slow (\d+) ?(.*)$/s.exec(text);
+				if (slow) await sleep(Number(slow[1]), turn.signal);
+				const failure = /^fail ?(.*)$/s.exec(text);
+				if (failure) return {
+					status: "unanswered",
+					reason: failure[1] || "failed"
+				};
+				turns += 1;
+				const body = slow ? slow[2] ?? "" : text;
+				const answer = `echo: ${body}${steered.splice(0).map((s) => ` + ${s}`).join("")} (turn ${turns})`;
+				const messageId = `${turn.operationId}:assistant`;
+				context.emit({
+					type: "text-delta",
+					messageId,
+					delta: answer
+				});
+				context.emit({
+					type: "message",
+					message: {
+						id: messageId,
+						role: "assistant",
+						parts: [{
+							type: "text",
+							text: answer
+						}],
+						operationId: turn.operationId,
+						createdAt: Date.now()
+					}
+				});
+				context.persist([{
+					turn: turns,
+					text: body
+				}]);
+				return {
+					status: "done",
+					text: answer
+				};
+			},
+			steer(input) {
+				steered.push(inputText(input));
+				return true;
+			},
+			async close() {}
+		};
+	}
+};
+function sleep(ms, signal) {
+	return new Promise((resolve, reject) => {
+		if (signal.aborted) {
+			reject(/* @__PURE__ */ new Error("aborted"));
+			return;
+		}
+		const timer = setTimeout(() => {
+			signal.removeEventListener("abort", onAbort);
+			resolve();
+		}, ms);
+		const onAbort = () => {
+			clearTimeout(timer);
+			reject(/* @__PURE__ */ new Error("aborted"));
+		};
+		signal.addEventListener("abort", onAbort, { once: true });
+	});
+}
+//#endregion
+export { echoAdapter as n, ContainerDaemon as t };
+
+//# sourceMappingURL=daemon-core-Buubj-y1.js.map

package/dist/daemon-core-Buubj-y1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-core-Buubj-y1.js","names":[],"sources":["../src/harness/container/daemon-core.ts"],"sourcesContent":["/**\n * The harness daemon's core: everything about running an agent inside a\n * container that does not depend on which agent it is.\n *\n * A daemon serves any number of sessions. For each one it keeps a queue of\n * operations, runs them one at a time through an adapter, numbers every\n * frame it produces, and keeps frames until the Durable Object acknowledges\n * them, so a reconnecting object replays exactly what it missed. The\n * adapter is the only agent-specific part: it opens a session (resuming it\n * from state it persisted earlier, possibly in another container), runs one\n * turn at a time, and reports what happens as `ContainerEvent`s.\n *\n * Nothing here touches Node, a socket library or a model SDK. The transport\n * hands the daemon a `DaemonSocket` per connection and feeds it messages;\n * `./runtime` does that over HTTP in a container, and the tests do it over\n * a `WebSocketPair` in Workers.\n *\n * Modelled on the AI SDK's harness bridge (`runBridge`): the runtime owns\n * the transport, sequencing and replay, and an adapter owns only the agent.\n *\n * @experimental The API may change before it stabilizes.\n */\n\nimport {\n  chunkEntries,\n  CLOSE_REPLACED,\n  CONTAINER_PROTOCOL_VERSION,\n  inputText,\n  parseHostMessage,\n  type ContainerEvent,\n  type ContainerInput,\n  type ContainerOutcome,\n  type ContainerSettings,\n  type ContainerWhenBusy,\n  type DaemonFrame,\n  type DaemonMessage,\n  type DaemonOperation,\n  type HostMessage,\n  type JsonValue\n} from \"./protocol\";\n\n/** What an adapter is told when its session opens. */\nexport type AdapterContext = {\n  /** The harness session id. */\n  readonly session: string;\n  readonly settings: ContainerSettings;\n  /**\n   * Everything this adapter `persist`ed for the session before, possibly in\n   * another container, oldest first. Empty for a new session.\n   */\n  readonly restore: readonly JsonValue[];\n  /** Report an event. It belongs to the operation that is running, if any. */\n  emit(event: ContainerEvent): void;\n  /**\n   * Keep resume state. The Durable Object stores the entries and passes all\n   * of them back as `restore` when the session opens in a new container.\n   */\n  persist(entries: readonly JsonValue[]): void;\n  /** A diagnostic line, reported as a `log` event. */\n  log(level: \"info\" | \"warn\" | \"error\", message: string): void;\n};\n\n/** One turn an adapter runs. */\nexport type AdapterTurn = {\n  readonly operationId: string;\n  readonly input: ContainerInput;\n  /** Aborted when the operation is aborted. Wind down promptly. */\n  readonly signal: AbortSignal;\n};\n\n/** An open adapter session. Turns are never run concurrently. */\nexport type AdapterSession = {\n  /**\n   * Run one turn to completion. A rejection settles the operation\n   * `unanswered` with the error's message.\n   */\n  run(turn: AdapterTurn): Promise<ContainerOutcome>;\n  /**\n   * Fold input into the running turn. Return false to have it queued as a\n   * follow-up instead. Absent when the agent cannot be steered.\n   */\n  steer?(input: ContainerInput): boolean | Promise<boolean>;\n  /** Apply new settings to the open session. */\n  configure?(settings: ContainerSettings): void | Promise<void>;\n  /** Release the session's resources. */\n  close(): Promise<void>;\n};\n\n/** An agent, as the daemon runs it. */\nexport type ContainerAdapter = {\n  /** Reported in `hello`, such as `\"claude-code\"`. */\n  readonly id: string;\n  readonly version: string;\n  /** Free-form capability names, reported in `hello`. */\n  readonly capabilities?: readonly string[];\n  /** Open (or resume) one session. */\n  open(context: AdapterContext): AdapterSession | Promise<AdapterSession>;\n};\n\n/** The send side of one connection, supplied by the transport. */\nexport type DaemonSocket = {\n  send(text: string): void;\n  close(code: number, reason: string): void;\n};\n\n/** The receive side of one connection, driven by the transport. */\nexport type DaemonConnection = {\n  /** A message arrived. */\n  receive(text: string): void;\n  /** The connection closed. */\n  closed(): void;\n};\n\n/** `ContainerDaemon`'s options. */\nexport type ContainerDaemonOptions = {\n  readonly adapter: ContainerAdapter;\n  /** This container's id, from `CONTAINER_ENV.runtimeId`. */\n  readonly runtimeId: string;\n  /**\n   * Most unacknowledged frames kept per session. Older ones are dropped and\n   * the object reconciles from `hello` instead. Default 10_000.\n   */\n  readonly maxKeptFrames?: number;\n};\n\n/** Settled operations remembered per session, for `hello`. */\nconst SETTLED_KEPT = 1_000;\n\ntype Operation = {\n  readonly id: string;\n  readonly input: ContainerInput;\n  readonly whenBusy: ContainerWhenBusy;\n  state:\n    | { readonly tag: \"queued\" }\n    | { readonly tag: \"running\" }\n    | { readonly tag: \"settled\"; readonly outcome: ContainerOutcome };\n};\n\ntype Running = {\n  readonly id: string;\n  /** Operations steered into this turn; they settle with it. */\n  readonly folded: string[];\n  readonly controller: AbortController;\n};\n\ntype Opened = {\n  readonly generation: number;\n  readonly session: AdapterSession;\n};\n\n/**\n * The daemon core. One per container process.\n *\n * @experimental The API may change before it stabilizes.\n */\nexport class ContainerDaemon {\n  readonly #adapter: ContainerAdapter;\n  readonly #runtimeId: string;\n  readonly #maxKeptFrames: number;\n  readonly #sessions = new Map<string, DaemonSession>();\n\n  /**\n   * @param options - The adapter and this container's id.\n   */\n  constructor(options: ContainerDaemonOptions) {\n    this.#adapter = options.adapter;\n    this.#runtimeId = options.runtimeId;\n    this.#maxKeptFrames = options.maxKeptFrames ?? 10_000;\n  }\n\n  /**\n   * Attach a connection for a session. A newer connection replaces an older\n   * one, which is closed with `CLOSE_REPLACED`. The daemon sends `hello`\n   * at once.\n   *\n   * @param session - The harness session id.\n   * @param socket - The send side.\n   * @returns The receive side, for the transport to drive.\n   */\n  connect(session: string, socket: DaemonSocket): DaemonConnection {\n    let state = this.#sessions.get(session);\n    if (!state) {\n      state = new DaemonSession(\n        session,\n        this.#adapter,\n        this.#runtimeId,\n        this.#maxKeptFrames\n      );\n      this.#sessions.set(session, state);\n    }\n    return state.attach(socket);\n  }\n\n  /** Close every adapter session, as the container shuts down. */\n  async close(): Promise<void> {\n    await Promise.all([...this.#sessions.values()].map((s) => s.shutdown()));\n  }\n}\n\nclass DaemonSession {\n  readonly #id: string;\n  readonly #adapter: ContainerAdapter;\n  readonly #runtimeId: string;\n  readonly #maxKeptFrames: number;\n  #seq = 0;\n  #kept: { readonly seq: number; readonly frame: DaemonFrame }[] = [];\n  readonly #operations = new Map<string, Operation>();\n  readonly #queue: string[] = [];\n  #running: Running | undefined;\n  #opened: Opened | undefined;\n  /** Resume state received for an `open` that has not arrived yet. */\n  #restoring: { generation: number; entries: JsonValue[] } | undefined;\n  #socket: DaemonSocket | undefined;\n  #live = false;\n  /** Host messages are handled one at a time, in order. */\n  #inbox: Promise<void> = Promise.resolve();\n\n  constructor(\n    id: string,\n    adapter: ContainerAdapter,\n    runtimeId: string,\n    maxKeptFrames: number\n  ) {\n    this.#id = id;\n    this.#adapter = adapter;\n    this.#runtimeId = runtimeId;\n    this.#maxKeptFrames = maxKeptFrames;\n  }\n\n  attach(socket: DaemonSocket): DaemonConnection {\n    const previous = this.#socket;\n    this.#socket = socket;\n    this.#live = false;\n    previous?.close(CLOSE_REPLACED, \"replaced by a newer connection\");\n    this.#send(socket, this.#hello());\n    return {\n      receive: (text) => {\n        if (this.#socket !== socket) return;\n        const message = parseHostMessage(text);\n        if (!message) {\n          this.#send(socket, { type: \"error\", message: \"unparseable message\" });\n          return;\n        }\n        this.#inbox = this.#inbox\n          .then(() => this.#handle(message))\n          .catch((error: unknown) => {\n            this.#send(socket, { type: \"error\", message: errorText(error) });\n          });\n      },\n      closed: () => {\n        if (this.#socket !== socket) return;\n        this.#socket = undefined;\n        this.#live = false;\n      }\n    };\n  }\n\n  async shutdown(): Promise<void> {\n    this.#running?.controller.abort();\n    const opened = this.#opened;\n    this.#opened = undefined;\n    await opened?.session.close().catch(() => undefined);\n  }\n\n  #hello(): DaemonMessage {\n    const operations: DaemonOperation[] = [];\n    for (const operation of this.#operations.values()) {\n      const state = operation.state;\n      operations.push(\n        state.tag === \"settled\"\n          ? {\n              operationId: operation.id,\n              status: \"settled\",\n              outcome: state.outcome\n            }\n          : { operationId: operation.id, status: state.tag }\n      );\n    }\n    return {\n      type: \"hello\",\n      protocol: CONTAINER_PROTOCOL_VERSION,\n      runtimeId: this.#runtimeId,\n      session: this.#id,\n      adapter: {\n        id: this.#adapter.id,\n        version: this.#adapter.version,\n        capabilities: [...(this.#adapter.capabilities ?? [])]\n      },\n      open: this.#opened?.generation ?? null,\n      lastSeq: this.#seq,\n      operations\n    };\n  }\n\n  async #handle(message: HostMessage): Promise<void> {\n    switch (message.type) {\n      case \"restore\":\n        if (this.#restoring?.generation !== message.generation) {\n          this.#restoring = { generation: message.generation, entries: [] };\n        }\n        this.#restoring.entries.push(...message.entries);\n        return;\n      case \"open\":\n        await this.#open(message);\n        return;\n      case \"replay\":\n        this.#replay(message.after);\n        return;\n      case \"prompt\":\n        await this.#prompt(\n          message.operationId,\n          message.input,\n          message.whenBusy\n        );\n        return;\n      case \"abort\":\n        this.#abort(message.operationId);\n        return;\n      case \"configure\":\n        await this.#opened?.session.configure?.(message.settings);\n        return;\n      case \"ack\":\n        this.#kept = this.#kept.filter((kept) => kept.seq > message.seq);\n        return;\n    }\n  }\n\n  async #open(message: Extract<HostMessage, { type: \"open\" }>): Promise<void> {\n    const restoring = this.#restoring;\n    this.#restoring = undefined;\n    if (this.#opened?.generation === message.generation) return;\n    const restore =\n      restoring?.generation === message.generation\n        ? [...restoring.entries, ...message.restore]\n        : message.restore;\n    if (this.#opened) {\n      // A new generation (a reset) replaces the\n      // open session. The turn running in it cannot continue.\n      this.#running?.controller.abort();\n      await this.#opened.session.close().catch(() => undefined);\n      this.#opened = undefined;\n    }\n    const session = await this.#adapter.open({\n      session: this.#id,\n      settings: message.settings,\n      restore,\n      emit: (event) =>\n        this.#emit({\n          kind: \"event\",\n          operationId: this.#running?.id ?? null,\n          event\n        }),\n      persist: (entries) => {\n        for (const group of chunkEntries(entries)) {\n          this.#emit({ kind: \"persist\", entries: group });\n        }\n      },\n      log: (level, text) =>\n        this.#emit({\n          kind: \"event\",\n          operationId: this.#running?.id ?? null,\n          event: { type: \"log\", level, message: text }\n        })\n    });\n    this.#opened = { generation: message.generation, session };\n    this.#pump();\n  }\n\n  #replay(after: number): void {\n    const socket = this.#socket;\n    if (!socket) return;\n    for (const kept of this.#kept) {\n      if (kept.seq > after) {\n        this.#send(socket, { type: \"frame\", seq: kept.seq, frame: kept.frame });\n      }\n    }\n    this.#send(socket, { type: \"caught-up\", lastSeq: this.#seq });\n    this.#live = true;\n  }\n\n  async #prompt(\n    id: string,\n    input: ContainerInput,\n    whenBusy: ContainerWhenBusy\n  ): Promise<void> {\n    if (this.#operations.has(id)) return;\n    const operation: Operation = {\n      id,\n      input,\n      whenBusy,\n      state: { tag: \"queued\" }\n    };\n    this.#operations.set(id, operation);\n    this.#forgetOldSettled();\n    const running = this.#running;\n    const steer = this.#opened?.session.steer;\n    if (whenBusy === \"steer\" && running && steer) {\n      const folded = await steer.call(this.#opened?.session, input);\n      if (folded && this.#running === running) {\n        operation.state = { tag: \"running\" };\n        running.folded.push(id);\n        this.#emit({ kind: \"start\", operationId: id });\n        return;\n      }\n    }\n    this.#queue.push(id);\n    this.#pump();\n  }\n\n  #abort(id: string | undefined): void {\n    const ids =\n      id === undefined\n        ? [...this.#operations.keys()]\n        : this.#operations.has(id)\n          ? [id]\n          : [];\n    for (const each of ids) {\n      const operation = this.#operations.get(each);\n      if (!operation) continue;\n      if (operation.state.tag === \"queued\") {\n        const at = this.#queue.indexOf(each);\n        if (at >= 0) this.#queue.splice(at, 1);\n        this.#settle(operation, { status: \"unanswered\", reason: \"aborted\" });\n      } else if (operation.state.tag === \"running\") {\n        // A steered operation shares its turn: aborting it aborts the turn.\n        this.#running?.controller.abort();\n      }\n    }\n  }\n\n  /** Start the next queued operation, if the session is open and idle. */\n  #pump(): void {\n    const opened = this.#opened;\n    if (this.#running || !opened) return;\n    const id = this.#queue.shift();\n    if (id === undefined) return;\n    const operation = this.#operations.get(id);\n    if (!operation || operation.state.tag !== \"queued\") {\n      this.#pump();\n      return;\n    }\n    const running: Running = {\n      id,\n      folded: [],\n      controller: new AbortController()\n    };\n    this.#running = running;\n    operation.state = { tag: \"running\" };\n    this.#emit({ kind: \"start\", operationId: id });\n    void this.#run(opened, operation, running);\n  }\n\n  async #run(\n    opened: Opened,\n    operation: Operation,\n    running: Running\n  ): Promise<void> {\n    let outcome: ContainerOutcome;\n    try {\n      outcome = await opened.session.run({\n        operationId: operation.id,\n        input: operation.input,\n        signal: running.controller.signal\n      });\n      if (running.controller.signal.aborted && outcome.status === \"done\") {\n        outcome = { status: \"unanswered\", reason: \"aborted\" };\n      }\n    } catch (error) {\n      outcome = {\n        status: \"unanswered\",\n        reason: running.controller.signal.aborted ? \"aborted\" : errorText(error)\n      };\n    }\n    if (this.#running === running) this.#running = undefined;\n    this.#settle(operation, outcome);\n    for (const folded of running.folded) {\n      const each = this.#operations.get(folded);\n      if (each) this.#settle(each, outcome);\n    }\n    this.#pump();\n  }\n\n  #settle(operation: Operation, outcome: ContainerOutcome): void {\n    if (operation.state.tag === \"settled\") return;\n    operation.state = { tag: \"settled\", outcome };\n    this.#emit({ kind: \"settle\", operationId: operation.id, outcome });\n  }\n\n  #emit(frame: DaemonFrame): void {\n    this.#seq += 1;\n    const seq = this.#seq;\n    this.#kept.push({ seq, frame });\n    if (this.#kept.length > this.#maxKeptFrames) {\n      this.#kept.splice(0, this.#kept.length - this.#maxKeptFrames);\n    }\n    const socket = this.#socket;\n    if (socket && this.#live) this.#send(socket, { type: \"frame\", seq, frame });\n  }\n\n  #send(socket: DaemonSocket, message: DaemonMessage): void {\n    try {\n      socket.send(JSON.stringify(message));\n    } catch {\n      // The socket closed under us. The frame is kept and replayed.\n    }\n  }\n\n  #forgetOldSettled(): void {\n    if (this.#operations.size <= SETTLED_KEPT) return;\n    for (const [id, operation] of this.#operations) {\n      if (this.#operations.size <= SETTLED_KEPT) return;\n      if (operation.state.tag === \"settled\") this.#operations.delete(id);\n    }\n  }\n}\n\nfunction errorText(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\n/**\n * A reference adapter that answers `echo: <text>` and needs no model or\n * credentials. Use it for keyless smoke deploys of the whole path and in\n * tests. It persists one entry per turn and counts them back after a\n * restore, so a resumed session visibly remembers its history:\n *\n * - `slow <ms> <text>` waits `ms` before answering, and stops on abort.\n * - `fail <reason>` settles the operation unanswered with `reason`.\n * - anything else is echoed with the turn number: `echo: hi (turn 3)`.\n *\n * @experimental The API may change before it stabilizes.\n */\nexport const echoAdapter: ContainerAdapter = {\n  id: \"echo\",\n  version: \"1\",\n  capabilities: [\"steer\"],\n  open(context) {\n    let turns = context.restore.length;\n    const steered: string[] = [];\n    return {\n      async run(turn) {\n        const text = inputText(turn.input);\n        const slow = /^slow (\\d+) ?(.*)$/s.exec(text);\n        if (slow) {\n          await sleep(Number(slow[1]), turn.signal);\n        }\n        const failure = /^fail ?(.*)$/s.exec(text);\n        if (failure) {\n          return { status: \"unanswered\", reason: failure[1] || \"failed\" };\n        }\n        turns += 1;\n        const body = slow ? (slow[2] ?? \"\") : text;\n        const extra = steered\n          .splice(0)\n          .map((s) => ` + ${s}`)\n          .join(\"\");\n        const answer = `echo: ${body}${extra} (turn ${turns})`;\n        const messageId = `${turn.operationId}:assistant`;\n        context.emit({ type: \"text-delta\", messageId, delta: answer });\n        context.emit({\n          type: \"message\",\n          message: {\n            id: messageId,\n            role: \"assistant\",\n            parts: [{ type: \"text\", text: answer }],\n            operationId: turn.operationId,\n            createdAt: Date.now()\n          }\n        });\n        context.persist([{ turn: turns, text: body }]);\n        return { status: \"done\", text: answer };\n      },\n      steer(input) {\n        steered.push(inputText(input));\n        return true;\n      },\n      async close() {}\n    };\n  }\n};\n\nfunction sleep(ms: number, signal: AbortSignal): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (signal.aborted) {\n      reject(new Error(\"aborted\"));\n      return;\n    }\n    const timer = setTimeout(() => {\n      signal.removeEventListener(\"abort\", onAbort);\n      resolve();\n    }, ms);\n    const onAbort = () => {\n      clearTimeout(timer);\n      reject(new Error(\"aborted\"));\n    };\n    signal.addEventListener(\"abort\", onAbort, { once: true });\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA8HA,MAAM,eAAe;;;;;;;;;;AA6BrB,IAAa,kBAAb,MAA6B;;;;CAS3B,YAAY,SAAiC;;;;8DALxB,IAAI,IAA2B,CAAA;EAMlD,uBAAA,UAAA,MAAgB,QAAQ,OAAA;EACxB,uBAAA,YAAA,MAAkB,QAAQ,SAAA;EAC1B,uBAAA,gBAAA,MAAsB,QAAQ,iBAAiB,GAAA;CACjD;;;;;;;;;;CAWA,QAAQ,SAAiB,QAAwC;EAC/D,IAAI,QAAA,uBAAA,WAAQ,IAAA,CAAA,CAAe,IAAI,OAAO;EACtC,IAAI,CAAC,OAAO;GACV,QAAQ,IAAI,cACV,SAAA,uBAAA,UACA,IAAA,GAAA,uBAAA,YACA,IAAA,GAAA,uBAAA,gBACA,IAAA,CACF;GACA,uBAAA,WAAA,IAAA,CAAA,CAAe,IAAI,SAAS,KAAK;EACnC;EACA,OAAO,MAAM,OAAO,MAAM;CAC5B;;CAGA,MAAM,QAAuB;EAC3B,MAAM,QAAQ,IAAI,CAAC,GAAA,uBAAA,WAAG,IAAA,CAAA,CAAe,OAAO,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,SAAS,CAAC,CAAC;CACzE;AACF;;;;;;;;;;;;;;;;AAEA,IAAM,gBAAN,MAAoB;CAkBlB,YACE,IACA,SACA,WACA,eACA;;;;;;yCAlBK,CAAA;0CAC0D,CAAC,CAAA;gEAC3C,IAAI,IAAuB,CAAA;2CACtB,CAAC,CAAA;;;;;0CAMrB,KAAA;2CAEgB,QAAQ,QAAQ,CAAA;EAQtC,uBAAA,KAAA,MAAW,EAAA;EACX,uBAAA,WAAA,MAAgB,OAAA;EAChB,uBAAA,aAAA,MAAkB,SAAA;EAClB,uBAAA,iBAAA,MAAsB,aAAA;CACxB;CAEA,OAAO,QAAwC;EAC7C,MAAM,WAAA,uBAAA,SAAW,IAAA;EACjB,uBAAA,SAAA,MAAe,MAAA;EACf,uBAAA,OAAA,MAAa,KAAA;EACb,UAAU,MAAM,gBAAgB,gCAAgC;EAChE,kBAAA,sBAAA,MAAA,KAAA,CAAA,CAAA,KAAA,MAAW,QAAA,kBAAA,sBAAQ,MAAA,MAAA,CAAA,CAAA,KAAA,IAAY,CAAC;EAChC,OAAO;GACL,UAAU,SAAS;IACjB,IAAA,uBAAA,SAAI,IAAA,MAAiB,QAAQ;IAC7B,MAAM,UAAU,iBAAiB,IAAI;IACrC,IAAI,CAAC,SAAS;KACZ,kBAAA,sBAAA,MAAA,KAAA,CAAA,CAAA,KAAA,MAAW,QAAQ;MAAE,MAAM;MAAS,SAAS;KAAsB,CAAC;KACpE;IACF;IACA,uBAAA,QAAA,MAAA,uBAAA,QAAc,IAAA,CAAA,CACX,WAAA,kBAAA,sBAAW,MAAA,OAAA,CAAA,CAAA,KAAA,MAAa,OAAO,CAAC,CAAC,CACjC,OAAO,UAAmB;KACzB,kBAAA,sBAAA,MAAA,KAAA,CAAA,CAAA,KAAA,MAAW,QAAQ;MAAE,MAAM;MAAS,SAAS,UAAU,KAAK;KAAE,CAAC;IACjE,CAAC,CAAA;GACL;GACA,cAAc;IACZ,IAAA,uBAAA,SAAI,IAAA,MAAiB,QAAQ;IAC7B,uBAAA,SAAA,MAAe,KAAA,CAAA;IACf,uBAAA,OAAA,MAAa,KAAA;GACf;EACF;CACF;CAEA,MAAM,WAA0B;EAC9B,uBAAA,UAAA,IAAA,CAAA,EAAe,WAAW,MAAM;EAChC,MAAM,SAAA,uBAAA,SAAS,IAAA;EACf,uBAAA,SAAA,MAAe,KAAA,CAAA;EACf,MAAM,QAAQ,QAAQ,MAAM,CAAC,CAAC,YAAY,KAAA,CAAS;CACrD;AA4PF;AA1PE,SAAA,SAAwB;CACtB,MAAM,aAAgC,CAAC;CACvC,KAAK,MAAM,aAAA,uBAAA,aAAa,IAAA,CAAA,CAAiB,OAAO,GAAG;EACjD,MAAM,QAAQ,UAAU;EACxB,WAAW,KACT,MAAM,QAAQ,YACV;GACE,aAAa,UAAU;GACvB,QAAQ;GACR,SAAS,MAAM;EACjB,IACA;GAAE,aAAa,UAAU;GAAI,QAAQ,MAAM;EAAI,CACrD;CACF;CACA,OAAO;EACL,MAAM;EACN,UAAA;EACA,WAAA,uBAAA,aAAW,IAAA;EACX,SAAA,uBAAA,KAAS,IAAA;EACT,SAAS;GACP,IAAA,uBAAA,WAAI,IAAA,CAAA,CAAc;GAClB,SAAA,uBAAA,WAAS,IAAA,CAAA,CAAc;GACvB,cAAc,CAAC,GAAA,uBAAA,WAAI,IAAA,CAAA,CAAc,gBAAgB,CAAC,CAAE;EACtD;EACA,MAAA,uBAAA,SAAM,IAAA,CAAA,EAAc,cAAc;EAClC,SAAA,uBAAA,MAAS,IAAA;EACT;CACF;AACF;AAEA,eAAA,QAAc,SAAqC;CACjD,QAAQ,QAAQ,MAAhB;EACE,KAAK;GACH,IAAA,uBAAA,YAAI,IAAA,CAAA,EAAiB,eAAe,QAAQ,YAC1C,uBAAA,YAAA,MAAkB;IAAE,YAAY,QAAQ;IAAY,SAAS,CAAC;GAAE,CAAA;GAElE,uBAAA,YAAA,IAAA,CAAA,CAAgB,QAAQ,KAAK,GAAG,QAAQ,OAAO;GAC/C;EACF,KAAK;GACH,MAAA,kBAAA,sBAAM,MAAA,KAAA,CAAA,CAAA,KAAA,MAAW,OAAO;GACxB;EACF,KAAK;GACH,kBAAA,sBAAA,MAAA,OAAA,CAAA,CAAA,KAAA,MAAa,QAAQ,KAAK;GAC1B;EACF,KAAK;GACH,MAAA,kBAAA,sBAAM,MAAA,OAAA,CAAA,CAAA,KAAA,MACJ,QAAQ,aACR,QAAQ,OACR,QAAQ,QACV;GACA;EACF,KAAK;GACH,kBAAA,sBAAA,MAAA,MAAA,CAAA,CAAA,KAAA,MAAY,QAAQ,WAAW;GAC/B;EACF,KAAK;GACH,MAAA,uBAAA,SAAM,IAAA,CAAA,EAAc,QAAQ,YAAY,QAAQ,QAAQ;GACxD;EACF,KAAK;GACH,uBAAA,OAAA,MAAA,uBAAA,OAAa,IAAA,CAAA,CAAW,QAAQ,SAAS,KAAK,MAAM,QAAQ,GAAG,CAAA;GAC/D;CACJ;AACF;AAEA,eAAA,MAAY,SAAgE;CAC1E,MAAM,YAAA,uBAAA,YAAY,IAAA;CAClB,uBAAA,YAAA,MAAkB,KAAA,CAAA;CAClB,IAAA,uBAAA,SAAI,IAAA,CAAA,EAAc,eAAe,QAAQ,YAAY;CACrD,MAAM,UACJ,WAAW,eAAe,QAAQ,aAC9B,CAAC,GAAG,UAAU,SAAS,GAAG,QAAQ,OAAO,IACzC,QAAQ;CACd,IAAA,uBAAA,SAAI,IAAA,GAAc;EAGhB,uBAAA,UAAA,IAAA,CAAA,EAAe,WAAW,MAAM;EAChC,MAAA,uBAAA,SAAM,IAAA,CAAA,CAAa,QAAQ,MAAM,CAAC,CAAC,YAAY,KAAA,CAAS;EACxD,uBAAA,SAAA,MAAe,KAAA,CAAA;CACjB;CACA,MAAM,UAAU,MAAA,uBAAA,WAAM,IAAA,CAAA,CAAc,KAAK;EACvC,SAAA,uBAAA,KAAS,IAAA;EACT,UAAU,QAAQ;EAClB;EACA,OAAO,UAAA,kBAAA,sBACL,MAAA,KAAA,CAAA,CAAA,KAAA,MAAW;GACT,MAAM;GACN,aAAA,uBAAA,UAAa,IAAA,CAAA,EAAe,MAAM;GAClC;EACF,CAAC;EACH,UAAU,YAAY;GACpB,KAAK,MAAM,SAAS,aAAa,OAAO,GACtC,kBAAA,sBAAA,MAAA,KAAA,CAAA,CAAA,KAAA,MAAW;IAAE,MAAM;IAAW,SAAS;GAAM,CAAC;EAElD;EACA,MAAM,OAAO,SAAA,kBAAA,sBACX,MAAA,KAAA,CAAA,CAAA,KAAA,MAAW;GACT,MAAM;GACN,aAAA,uBAAA,UAAa,IAAA,CAAA,EAAe,MAAM;GAClC,OAAO;IAAE,MAAM;IAAO;IAAO,SAAS;GAAK;EAC7C,CAAC;CACL,CAAC;CACD,uBAAA,SAAA,MAAe;EAAE,YAAY,QAAQ;EAAY;CAAQ,CAAA;CACzD,kBAAA,sBAAA,MAAA,KAAA,CAAA,CAAA,KAAA,IAAW;AACb;AAEA,SAAA,QAAQ,OAAqB;CAC3B,MAAM,SAAA,uBAAA,SAAS,IAAA;CACf,IAAI,CAAC,QAAQ;CACb,KAAK,MAAM,QAAA,uBAAA,OAAQ,IAAA,GACjB,IAAI,KAAK,MAAM,OACb,kBAAA,sBAAA,MAAA,KAAA,CAAA,CAAA,KAAA,MAAW,QAAQ;EAAE,MAAM;EAAS,KAAK,KAAK;EAAK,OAAO,KAAK;CAAM,CAAC;CAG1E,kBAAA,sBAAA,MAAA,KAAA,CAAA,CAAA,KAAA,MAAW,QAAQ;EAAE,MAAM;EAAa,SAAA,uBAAA,MAAS,IAAA;CAAU,CAAC;CAC5D,uBAAA,OAAA,MAAa,IAAA;AACf;AAEA,eAAA,QACE,IACA,OACA,UACe;CACf,IAAA,uBAAA,aAAI,IAAA,CAAA,CAAiB,IAAI,EAAE,GAAG;CAC9B,MAAM,YAAuB;EAC3B;EACA;EACA;EACA,OAAO,EAAE,KAAK,SAAS;CACzB;CACA,uBAAA,aAAA,IAAA,CAAA,CAAiB,IAAI,IAAI,SAAS;CAClC,kBAAA,sBAAA,MAAA,iBAAA,CAAA,CAAA,KAAA,IAAuB;CACvB,MAAM,UAAA,uBAAA,UAAU,IAAA;CAChB,MAAM,QAAA,uBAAA,SAAQ,IAAA,CAAA,EAAc,QAAQ;CACpC,IAAI,aAAa,WAAW,WAAW;MAEjC,MADiB,MAAM,KAAA,uBAAA,SAAK,IAAA,CAAA,EAAc,SAAS,KAAK,KAAA,uBAAA,UAC9C,IAAA,MAAkB,SAAS;GACvC,UAAU,QAAQ,EAAE,KAAK,UAAU;GACnC,QAAQ,OAAO,KAAK,EAAE;GACtB,kBAAA,sBAAA,MAAA,KAAA,CAAA,CAAA,KAAA,MAAW;IAAE,MAAM;IAAS,aAAa;GAAG,CAAC;GAC7C;EACF;;CAEF,uBAAA,QAAA,IAAA,CAAA,CAAY,KAAK,EAAE;CACnB,kBAAA,sBAAA,MAAA,KAAA,CAAA,CAAA,KAAA,IAAW;AACb;AAEA,SAAA,OAAO,IAA8B;CACnC,MAAM,MACJ,OAAO,KAAA,IACH,CAAC,GAAA,uBAAA,aAAG,IAAA,CAAA,CAAiB,KAAK,CAAC,IAAA,uBAAA,aAC3B,IAAA,CAAA,CAAiB,IAAI,EAAE,IACrB,CAAC,EAAE,IACH,CAAC;CACT,KAAK,MAAM,QAAQ,KAAK;EACtB,MAAM,YAAA,uBAAA,aAAY,IAAA,CAAA,CAAiB,IAAI,IAAI;EAC3C,IAAI,CAAC,WAAW;EAChB,IAAI,UAAU,MAAM,QAAQ,UAAU;GACpC,MAAM,KAAA,uBAAA,QAAK,IAAA,CAAA,CAAY,QAAQ,IAAI;GACnC,IAAI,MAAM,GAAG,uBAAA,QAAA,IAAA,CAAA,CAAY,OAAO,IAAI,CAAC;GACrC,kBAAA,sBAAA,MAAA,OAAA,CAAA,CAAA,KAAA,MAAa,WAAW;IAAE,QAAQ;IAAc,QAAQ;GAAU,CAAC;EACrE,OAAO,IAAI,UAAU,MAAM,QAAQ,WAEjC,uBAAA,UAAA,IAAA,CAAA,EAAe,WAAW,MAAM;CAEpC;AACF;;AAGA,SAAA,QAAc;CACZ,MAAM,SAAA,uBAAA,SAAS,IAAA;CACf,IAAA,uBAAA,UAAI,IAAA,KAAiB,CAAC,QAAQ;CAC9B,MAAM,KAAA,uBAAA,QAAK,IAAA,CAAA,CAAY,MAAM;CAC7B,IAAI,OAAO,KAAA,GAAW;CACtB,MAAM,YAAA,uBAAA,aAAY,IAAA,CAAA,CAAiB,IAAI,EAAE;CACzC,IAAI,CAAC,aAAa,UAAU,MAAM,QAAQ,UAAU;EAClD,kBAAA,sBAAA,MAAA,KAAA,CAAA,CAAA,KAAA,IAAW;EACX;CACF;CACA,MAAM,UAAmB;EACvB;EACA,QAAQ,CAAC;EACT,YAAY,IAAI,gBAAgB;CAClC;CACA,uBAAA,UAAA,MAAgB,OAAA;CAChB,UAAU,QAAQ,EAAE,KAAK,UAAU;CACnC,kBAAA,sBAAA,MAAA,KAAA,CAAA,CAAA,KAAA,MAAW;EAAE,MAAM;EAAS,aAAa;CAAG,CAAC;CAC7C,kBAAA,sBAAK,MAAA,IAAA,CAAA,CAAA,KAAA,MAAU,QAAQ,WAAW,OAAO;AAC3C;AAEA,eAAA,KACE,QACA,WACA,SACe;CACf,IAAI;CACJ,IAAI;EACF,UAAU,MAAM,OAAO,QAAQ,IAAI;GACjC,aAAa,UAAU;GACvB,OAAO,UAAU;GACjB,QAAQ,QAAQ,WAAW;EAC7B,CAAC;EACD,IAAI,QAAQ,WAAW,OAAO,WAAW,QAAQ,WAAW,QAC1D,UAAU;GAAE,QAAQ;GAAc,QAAQ;EAAU;CAExD,SAAS,OAAO;EACd,UAAU;GACR,QAAQ;GACR,QAAQ,QAAQ,WAAW,OAAO,UAAU,YAAY,UAAU,KAAK;EACzE;CACF;CACA,IAAA,uBAAA,UAAI,IAAA,MAAkB,SAAS,uBAAA,UAAA,MAAgB,KAAA,CAAA;CAC/C,kBAAA,sBAAA,MAAA,OAAA,CAAA,CAAA,KAAA,MAAa,WAAW,OAAO;CAC/B,KAAK,MAAM,UAAU,QAAQ,QAAQ;EACnC,MAAM,OAAA,uBAAA,aAAO,IAAA,CAAA,CAAiB,IAAI,MAAM;EACxC,IAAI,MAAM,kBAAA,sBAAA,MAAA,OAAA,CAAA,CAAA,KAAA,MAAa,MAAM,OAAO;CACtC;CACA,kBAAA,sBAAA,MAAA,KAAA,CAAA,CAAA,KAAA,IAAW;AACb;AAEA,SAAA,QAAQ,WAAsB,SAAiC;CAC7D,IAAI,UAAU,MAAM,QAAQ,WAAW;CACvC,UAAU,QAAQ;EAAE,KAAK;EAAW;CAAQ;CAC5C,kBAAA,sBAAA,MAAA,KAAA,CAAA,CAAA,KAAA,MAAW;EAAE,MAAM;EAAU,aAAa,UAAU;EAAI;CAAQ,CAAC;AACnE;AAEA,SAAA,MAAM,OAA0B;CAC9B,uBAAA,MAAA,MAAA,uBAAA,MAAA,IAAA,IAAa,CAAA;CACb,MAAM,MAAA,uBAAA,MAAM,IAAA;CACZ,uBAAA,OAAA,IAAA,CAAA,CAAW,KAAK;EAAE;EAAK;CAAM,CAAC;CAC9B,IAAA,uBAAA,OAAI,IAAA,CAAA,CAAW,SAAA,uBAAA,iBAAS,IAAA,GACtB,uBAAA,OAAA,IAAA,CAAA,CAAW,OAAO,GAAA,uBAAA,OAAG,IAAA,CAAA,CAAW,SAAA,uBAAA,iBAAS,IAAA,CAAmB;CAE9D,MAAM,SAAA,uBAAA,SAAS,IAAA;CACf,IAAI,UAAA,uBAAA,OAAU,IAAA,GAAY,kBAAA,sBAAA,MAAA,KAAA,CAAA,CAAA,KAAA,MAAW,QAAQ;EAAE,MAAM;EAAS;EAAK;CAAM,CAAC;AAC5E;AAEA,SAAA,MAAM,QAAsB,SAA8B;CACxD,IAAI;EACF,OAAO,KAAK,KAAK,UAAU,OAAO,CAAC;CACrC,QAAQ,CAER;AACF;AAEA,SAAA,oBAA0B;CACxB,IAAA,uBAAA,aAAI,IAAA,CAAA,CAAiB,QAAQ,cAAc;CAC3C,KAAK,MAAM,CAAC,IAAI,cAAA,uBAAA,aAAc,IAAA,GAAkB;EAC9C,IAAA,uBAAA,aAAI,IAAA,CAAA,CAAiB,QAAQ,cAAc;EAC3C,IAAI,UAAU,MAAM,QAAQ,WAAW,uBAAA,aAAA,IAAA,CAAA,CAAiB,OAAO,EAAE;CACnE;AACF;AAGF,SAAS,UAAU,OAAwB;CACzC,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAC9D;;;;;;;;;;;;;AAcA,MAAa,cAAgC;CAC3C,IAAI;CACJ,SAAS;CACT,cAAc,CAAC,OAAO;CACtB,KAAK,SAAS;EACZ,IAAI,QAAQ,QAAQ,QAAQ;EAC5B,MAAM,UAAoB,CAAC;EAC3B,OAAO;GACL,MAAM,IAAI,MAAM;IACd,MAAM,OAAO,UAAU,KAAK,KAAK;IACjC,MAAM,OAAO,sBAAsB,KAAK,IAAI;IAC5C,IAAI,MACF,MAAM,MAAM,OAAO,KAAK,EAAE,GAAG,KAAK,MAAM;IAE1C,MAAM,UAAU,gBAAgB,KAAK,IAAI;IACzC,IAAI,SACF,OAAO;KAAE,QAAQ;KAAc,QAAQ,QAAQ,MAAM;IAAS;IAEhE,SAAS;IACT,MAAM,OAAO,OAAQ,KAAK,MAAM,KAAM;IAKtC,MAAM,SAAS,SAAS,OAJV,QACX,OAAO,CAAC,CAAC,CACT,KAAK,MAAM,MAAM,GAAG,CAAC,CACrB,KAAK,EAC2B,EAAE,SAAS,MAAM;IACpD,MAAM,YAAY,GAAG,KAAK,YAAY;IACtC,QAAQ,KAAK;KAAE,MAAM;KAAc;KAAW,OAAO;IAAO,CAAC;IAC7D,QAAQ,KAAK;KACX,MAAM;KACN,SAAS;MACP,IAAI;MACJ,MAAM;MACN,OAAO,CAAC;OAAE,MAAM;OAAQ,MAAM;MAAO,CAAC;MACtC,aAAa,KAAK;MAClB,WAAW,KAAK,IAAI;KACtB;IACF,CAAC;IACD,QAAQ,QAAQ,CAAC;KAAE,MAAM;KAAO,MAAM;IAAK,CAAC,CAAC;IAC7C,OAAO;KAAE,QAAQ;KAAQ,MAAM;IAAO;GACxC;GACA,MAAM,OAAO;IACX,QAAQ,KAAK,UAAU,KAAK,CAAC;IAC7B,OAAO;GACT;GACA,MAAM,QAAQ,CAAC;EACjB;CACF;AACF;AAEA,SAAS,MAAM,IAAY,QAAoC;CAC7D,OAAO,IAAI,SAAS,SAAS,WAAW;EACtC,IAAI,OAAO,SAAS;GAClB,uBAAO,IAAI,MAAM,SAAS,CAAC;GAC3B;EACF;EACA,MAAM,QAAQ,iBAAiB;GAC7B,OAAO,oBAAoB,SAAS,OAAO;GAC3C,QAAQ;EACV,GAAG,EAAE;EACL,MAAM,gBAAgB;GACpB,aAAa,KAAK;GAClB,uBAAO,IAAI,MAAM,SAAS,CAAC;EAC7B;EACA,OAAO,iBAAiB,SAAS,SAAS,EAAE,MAAM,KAAK,CAAC;CAC1D,CAAC;AACH"}

package/dist/daemon-core-CbohVPAu.d.ts

@@ -0,0 +1,132 @@
+import {
+  h as ContainerSettings,
+  l as ContainerEvent,
+  p as ContainerOutcome,
+  u as ContainerInput,
+  x as JsonValue
+} from "./protocol-BEgrJYC5.js";
+
+//#region src/harness/container/daemon-core.d.ts
+/** What an adapter is told when its session opens. */
+type AdapterContext = {
+  /** The harness session id. */ readonly session: string;
+  readonly settings: ContainerSettings;
+  /**
+   * Everything this adapter `persist`ed for the session before, possibly in
+   * another container, oldest first. Empty for a new session.
+   */
+  readonly restore: readonly JsonValue[] /** Report an event. It belongs to the operation that is running, if any. */;
+  emit(event: ContainerEvent): void;
+  /**
+   * Keep resume state. The Durable Object stores the entries and passes all
+   * of them back as `restore` when the session opens in a new container.
+   */
+  persist(
+    entries: readonly JsonValue[]
+  ): void /** A diagnostic line, reported as a `log` event. */;
+  log(level: "info" | "warn" | "error", message: string): void;
+};
+/** One turn an adapter runs. */
+type AdapterTurn = {
+  readonly operationId: string;
+  readonly input: ContainerInput /** Aborted when the operation is aborted. Wind down promptly. */;
+  readonly signal: AbortSignal;
+};
+/** An open adapter session. Turns are never run concurrently. */
+type AdapterSession = {
+  /**
+   * Run one turn to completion. A rejection settles the operation
+   * `unanswered` with the error's message.
+   */
+  run(turn: AdapterTurn): Promise<ContainerOutcome>;
+  /**
+   * Fold input into the running turn. Return false to have it queued as a
+   * follow-up instead. Absent when the agent cannot be steered.
+   */
+  steer?(
+    input: ContainerInput
+  ): boolean | Promise<boolean> /** Apply new settings to the open session. */;
+  configure?(
+    settings: ContainerSettings
+  ): void | Promise<void> /** Release the session's resources. */;
+  close(): Promise<void>;
+};
+/** An agent, as the daemon runs it. */
+type ContainerAdapter = {
+  /** Reported in `hello`, such as `"claude-code"`. */ readonly id: string;
+  readonly version: string /** Free-form capability names, reported in `hello`. */;
+  readonly capabilities?: readonly string[] /** Open (or resume) one session. */;
+  open(context: AdapterContext): AdapterSession | Promise<AdapterSession>;
+};
+/** The send side of one connection, supplied by the transport. */
+type DaemonSocket = {
+  send(text: string): void;
+  close(code: number, reason: string): void;
+};
+/** The receive side of one connection, driven by the transport. */
+type DaemonConnection = {
+  /** A message arrived. */ receive(
+    text: string
+  ): void /** The connection closed. */;
+  closed(): void;
+};
+/** `ContainerDaemon`'s options. */
+type ContainerDaemonOptions = {
+  readonly adapter: ContainerAdapter /** This container's id, from `CONTAINER_ENV.runtimeId`. */;
+  readonly runtimeId: string;
+  /**
+   * Most unacknowledged frames kept per session. Older ones are dropped and
+   * the object reconciles from `hello` instead. Default 10_000.
+   */
+  readonly maxKeptFrames?: number;
+};
+/**
+ * The daemon core. One per container process.
+ *
+ * @experimental The API may change before it stabilizes.
+ */
+declare class ContainerDaemon {
+  #private;
+  /**
+   * @param options - The adapter and this container's id.
+   */
+  constructor(options: ContainerDaemonOptions);
+  /**
+   * Attach a connection for a session. A newer connection replaces an older
+   * one, which is closed with `CLOSE_REPLACED`. The daemon sends `hello`
+   * at once.
+   *
+   * @param session - The harness session id.
+   * @param socket - The send side.
+   * @returns The receive side, for the transport to drive.
+   */
+  connect(session: string, socket: DaemonSocket): DaemonConnection;
+  /** Close every adapter session, as the container shuts down. */
+  close(): Promise<void>;
+}
+/**
+ * A reference adapter that answers `echo: <text>` and needs no model or
+ * credentials. Use it for keyless smoke deploys of the whole path and in
+ * tests. It persists one entry per turn and counts them back after a
+ * restore, so a resumed session visibly remembers its history:
+ *
+ * - `slow <ms> <text>` waits `ms` before answering, and stops on abort.
+ * - `fail <reason>` settles the operation unanswered with `reason`.
+ * - anything else is echoed with the turn number: `echo: hi (turn 3)`.
+ *
+ * @experimental The API may change before it stabilizes.
+ */
+declare const echoAdapter: ContainerAdapter;
+//#endregion
+export {
+  ContainerDaemon as a,
+  DaemonSocket as c,
+  ContainerAdapter as i,
+  echoAdapter as l,
+  AdapterSession as n,
+  ContainerDaemonOptions as o,
+  AdapterTurn as r,
+  DaemonConnection as s,
+  AdapterContext as t
+};
+//# sourceMappingURL=daemon-core-CbohVPAu.d.ts.map