@minpeter/pss-runtime 0.1.0-next.1 → 0.1.0-next.2

package/dist/session/session-runtime-drain.js

@@ -1,11 +1,11 @@
 import { shiftRuntimeInput } from "./runtime-input.js";
 //#region src/session/session-runtime-drain.ts
-async function drainRuntimeInput({ placement, run, runtimeInput, state }) {
+async function drainRuntimeInput({ emit, placement, runtimeInput, state }) {
 	let added = false;
 	let next = shiftRuntimeInput(runtimeInput, placement);
 	while (next) {
 		added = true;
-		run.emit({
+		await emit({
 			type: "runtime-input",
 			input: next.input,
 			placement

package/dist/session/session-runtime-drain.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-runtime-drain.js","names":[],"sources":["../../src/session/session-runtime-drain.ts"],"sourcesContent":["import type { BufferedAgentRun } from \"./run\";\nimport {\n  type RuntimeInputPlacement,\n  type RuntimeInputState,\n  shiftRuntimeInput,\n} from \"./runtime-input\";\nimport type { SessionState } from \"./session-state\";\n\nexport async function drainRuntimeInput({\n  placement,\n  run,\n  runtimeInput,\n  state,\n}: {\n  readonly placement: RuntimeInputPlacement;\n  readonly run: BufferedAgentRun;\n  readonly runtimeInput: RuntimeInputState;\n  readonly state: SessionState;\n}): Promise<boolean> {\n  let added = false;\n  let next = shiftRuntimeInput(runtimeInput, placement);\n  while (next) {\n    added = true;\n    run.emit({ type: \"runtime-input\", input: next.input, placement });\n    state.appendUserInput(next.input);\n    await state.commit();\n    next = shiftRuntimeInput(runtimeInput, placement);\n  }\n\n  return added;\n}\n"],"mappings":";;AAQA,eAAsB,kBAAkB,EACtC,WACA,KACA,cACA,SAMmB;CACnB,IAAI,QAAQ;CACZ,IAAI,OAAO,kBAAkB,cAAc,SAAS;CACpD,OAAO,MAAM;EACX,QAAQ;EACR,IAAI,KAAK;GAAE,MAAM;GAAiB,OAAO,KAAK;GAAO;EAAU,CAAC;EAChE,MAAM,gBAAgB,KAAK,KAAK;EAChC,MAAM,MAAM,OAAO;EACnB,OAAO,kBAAkB,cAAc,SAAS;CAClD;CAEA,OAAO;AACT"}
+{"version":3,"file":"session-runtime-drain.js","names":[],"sources":["../../src/session/session-runtime-drain.ts"],"sourcesContent":["import type { RuntimeInput } from \"./events\";\nimport {\n  type RuntimeInputPlacement,\n  type RuntimeInputState,\n  shiftRuntimeInput,\n} from \"./runtime-input\";\nimport type { SessionState } from \"./session-state\";\n\nexport async function drainRuntimeInput({\n  emit,\n  placement,\n  runtimeInput,\n  state,\n}: {\n  readonly emit: (event: RuntimeInput) => Promise<void>;\n  readonly placement: RuntimeInputPlacement;\n  readonly runtimeInput: RuntimeInputState;\n  readonly state: SessionState;\n}): Promise<boolean> {\n  let added = false;\n  let next = shiftRuntimeInput(runtimeInput, placement);\n  while (next) {\n    added = true;\n    await emit({ type: \"runtime-input\", input: next.input, placement });\n    state.appendUserInput(next.input);\n    await state.commit();\n    next = shiftRuntimeInput(runtimeInput, placement);\n  }\n\n  return added;\n}\n"],"mappings":";;AAQA,eAAsB,kBAAkB,EACtC,MACA,WACA,cACA,SAMmB;CACnB,IAAI,QAAQ;CACZ,IAAI,OAAO,kBAAkB,cAAc,SAAS;CACpD,OAAO,MAAM;EACX,QAAQ;EACR,MAAM,KAAK;GAAE,MAAM;GAAiB,OAAO,KAAK;GAAO;EAAU,CAAC;EAClE,MAAM,gBAAgB,KAAK,KAAK;EAChC,MAAM,MAAM,OAAO;EACnB,OAAO,kBAAkB,cAAc,SAAS;CAClD;CAEA,OAAO;AACT"}

package/dist/session/session-turn-processor.js

@@ -0,0 +1,135 @@
+import { ToolExecutionNeedsRecoveryError } from "../llm-tool-execution.js";
+import { closeRuntimeInput, withRuntimeInputWindow } from "./runtime-input.js";
+import { errorMessage } from "./session-errors.js";
+import { runAgentLoop } from "../agent-loop.js";
+import { startSessionExecutionRun } from "./session-execution.js";
+import { drainRuntimeInput } from "./session-runtime-drain.js";
+import { emitTurnErrorAfterRecovery } from "./session-turn-error.js";
+//#region src/session/session-turn-processor.ts
+async function processQueuedInput({ activate, deactivateRun, events, execution, item, llm, release, sessionKey, state }) {
+	const activeAbort = new AbortController();
+	const { initialEvents, input, preUserRuntimeInputs, run, runtimeInput } = item;
+	const turnId = crypto.randomUUID();
+	activate({
+		abort: activeAbort,
+		run,
+		runtimeInput,
+		turnId
+	});
+	const historySnapshot = state.modelSnapshot();
+	let executionRun;
+	try {
+		executionRun = await startSessionExecutionRun({
+			executionHost: execution.executionHost,
+			sessionKey,
+			state,
+			turnId
+		});
+		for (const event of initialEvents) await events.emitRunEvent(run, event);
+		await appendRuntimeInputsToHistory(state, preUserRuntimeInputs);
+		if (input) {
+			state.appendUserInput(input);
+			await state.commit();
+		}
+		await withRuntimeInputWindow(runtimeInput, "turn-start", async () => {
+			await events.emitRunBoundaryEvent(run, { type: "turn-start" });
+		});
+		await emitPreUserRuntimeInputs(events, run, preUserRuntimeInputs);
+		await drainRuntimeInput({
+			emit: (event) => events.emitRunEvent(run, event),
+			placement: "turn-start",
+			runtimeInput,
+			state
+		});
+		const result = await runAgentLoop({
+			emit: async (event) => emitTurnEvent({
+				event,
+				events,
+				run,
+				runtimeInput,
+				state
+			}),
+			history: state.history,
+			llm,
+			captureObserverEvents: (callback) => events.captureObserverEvents(run, callback),
+			signal: activeAbort.signal,
+			toolExecution: executionRun?.toolExecution
+		});
+		await state.commit();
+		await executionRun?.complete(executionStatusForResult(result));
+		await closeSuccessfulTurn({
+			deactivateRun,
+			events,
+			result,
+			run,
+			runtimeInput
+		});
+	} catch (error) {
+		const turnError = error instanceof Error ? error : new Error(String(error));
+		await executionRun?.complete(executionStatusForError(turnError));
+		await emitTurnErrorAfterRecovery({
+			error: turnError,
+			historySnapshot,
+			run,
+			runtimeInput,
+			state
+		});
+	} finally {
+		closeRuntimeInput(runtimeInput);
+		release();
+		run.close(void 0, runtimeInput.closedReason);
+	}
+}
+function executionStatusForResult(result) {
+	return result === "aborted" ? "cancelled" : "completed";
+}
+function executionStatusForError(error) {
+	return error instanceof ToolExecutionNeedsRecoveryError ? "needs-recovery" : "error";
+}
+async function appendRuntimeInputsToHistory(state, runtimeInputs) {
+	for (const runtimeInput of runtimeInputs) {
+		state.appendUserInput(runtimeInput.input);
+		await state.commit();
+	}
+}
+async function closeSuccessfulTurn({ deactivateRun, events, result, run, runtimeInput }) {
+	const terminalEvent = result === "aborted" ? "turn-abort" : "turn-end";
+	closeRuntimeInput(runtimeInput, terminalEvent);
+	deactivateRun();
+	try {
+		await events.emitRunEvent(run, { type: terminalEvent });
+	} catch (terminalError) {
+		run.emit({
+			type: "turn-error",
+			message: errorMessage(terminalError)
+		});
+		closeRuntimeInput(runtimeInput, "turn-error");
+	}
+}
+async function emitPreUserRuntimeInputs(events, run, runtimeInputs) {
+	for (const runtimeInput of runtimeInputs) await events.emitRunEvent(run, {
+		input: runtimeInput.input,
+		placement: runtimeInput.placement,
+		type: "runtime-input"
+	});
+}
+async function emitTurnEvent({ event, events, run, runtimeInput, state }) {
+	if (event.type !== "step-start" && event.type !== "step-end") {
+		await events.emitRunEvent(run, event);
+		return;
+	}
+	await withRuntimeInputWindow(runtimeInput, event.type, async () => {
+		await events.emitRunBoundaryEvent(run, event);
+	});
+	const runtimeInputAdded = await drainRuntimeInput({
+		emit: (runtimeInputEvent) => events.emitRunEvent(run, runtimeInputEvent),
+		placement: event.type,
+		runtimeInput,
+		state
+	});
+	return event.type === "step-end" ? { runtimeInputAdded } : void 0;
+}
+//#endregion
+export { processQueuedInput };
+
+//# sourceMappingURL=session-turn-processor.js.map

package/dist/session/session-turn-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-turn-processor.js","names":[],"sources":["../../src/session/session-turn-processor.ts"],"sourcesContent":["import { runAgentLoop } from \"../agent-loop\";\nimport type { RuntimeLlm } from \"../llm\";\nimport { ToolExecutionNeedsRecoveryError } from \"../llm-tool-execution\";\nimport type { AgentEvent } from \"./events\";\nimport type { BufferedAgentRun } from \"./run\";\nimport {\n  closeRuntimeInput,\n  type QueuedInput,\n  type QueuedRuntimeInput,\n  type RuntimeInputState,\n  withRuntimeInputWindow,\n} from \"./runtime-input\";\nimport { errorMessage } from \"./session-errors\";\nimport type { SessionEventDispatcher } from \"./session-events\";\nimport {\n  type SessionExecutionOptions,\n  type SessionExecutionRun,\n  type SessionExecutionTerminalStatus,\n  startSessionExecutionRun,\n} from \"./session-execution\";\nimport { drainRuntimeInput } from \"./session-runtime-drain\";\nimport type { SessionState } from \"./session-state\";\nimport { emitTurnErrorAfterRecovery } from \"./session-turn-error\";\n\ninterface ActiveTurn {\n  readonly abort: AbortController;\n  readonly run: BufferedAgentRun;\n  readonly runtimeInput: RuntimeInputState;\n  readonly turnId: string;\n}\n\ninterface ProcessQueuedInputOptions {\n  readonly activate: (turn: ActiveTurn) => void;\n  readonly deactivateRun: () => void;\n  readonly events: SessionEventDispatcher;\n  readonly execution: SessionExecutionOptions;\n  readonly item: QueuedInput;\n  readonly llm: RuntimeLlm;\n  readonly release: () => void;\n  readonly sessionKey: string;\n  readonly state: SessionState;\n}\n\nexport async function processQueuedInput({\n  activate,\n  deactivateRun,\n  events,\n  execution,\n  item,\n  llm,\n  release,\n  sessionKey,\n  state,\n}: ProcessQueuedInputOptions): Promise<void> {\n  const activeAbort = new AbortController();\n  const { initialEvents, input, preUserRuntimeInputs, run, runtimeInput } =\n    item;\n  const turnId = crypto.randomUUID();\n  activate({\n    abort: activeAbort,\n    run,\n    runtimeInput,\n    turnId,\n  });\n  const historySnapshot = state.modelSnapshot();\n  let executionRun: SessionExecutionRun | undefined;\n\n  try {\n    executionRun = await startSessionExecutionRun({\n      executionHost: execution.executionHost,\n      sessionKey,\n      state,\n      turnId,\n    });\n    for (const event of initialEvents) {\n      await events.emitRunEvent(run, event);\n    }\n    await appendRuntimeInputsToHistory(state, preUserRuntimeInputs);\n    if (input) {\n      state.appendUserInput(input);\n      await state.commit();\n    }\n    await withRuntimeInputWindow(runtimeInput, \"turn-start\", async () => {\n      await events.emitRunBoundaryEvent(run, { type: \"turn-start\" });\n    });\n    await emitPreUserRuntimeInputs(events, run, preUserRuntimeInputs);\n    await drainRuntimeInput({\n      emit: (event) => events.emitRunEvent(run, event),\n      placement: \"turn-start\",\n      runtimeInput,\n      state,\n    });\n\n    const result = await runAgentLoop({\n      emit: async (event) =>\n        emitTurnEvent({\n          event,\n          events,\n          run,\n          runtimeInput,\n          state,\n        }),\n      history: state.history,\n      llm,\n      captureObserverEvents: (callback) =>\n        events.captureObserverEvents(run, callback),\n      signal: activeAbort.signal,\n      toolExecution: executionRun?.toolExecution,\n    });\n\n    await state.commit();\n    await executionRun?.complete(executionStatusForResult(result));\n    await closeSuccessfulTurn({\n      deactivateRun,\n      events,\n      result,\n      run,\n      runtimeInput,\n    });\n  } catch (error) {\n    const turnError = error instanceof Error ? error : new Error(String(error));\n    await executionRun?.complete(executionStatusForError(turnError));\n    await emitTurnErrorAfterRecovery({\n      error: turnError,\n      historySnapshot,\n      run,\n      runtimeInput,\n      state,\n    });\n  } finally {\n    closeRuntimeInput(runtimeInput);\n    release();\n    run.close(undefined, runtimeInput.closedReason);\n  }\n}\n\nfunction executionStatusForResult(\n  result: \"aborted\" | \"completed\"\n): SessionExecutionTerminalStatus {\n  return result === \"aborted\" ? \"cancelled\" : \"completed\";\n}\n\nfunction executionStatusForError(error: Error): SessionExecutionTerminalStatus {\n  return error instanceof ToolExecutionNeedsRecoveryError\n    ? \"needs-recovery\"\n    : \"error\";\n}\n\nasync function appendRuntimeInputsToHistory(\n  state: SessionState,\n  runtimeInputs: readonly QueuedRuntimeInput[]\n): Promise<void> {\n  for (const runtimeInput of runtimeInputs) {\n    state.appendUserInput(runtimeInput.input);\n    await state.commit();\n  }\n}\n\nasync function closeSuccessfulTurn({\n  deactivateRun,\n  events,\n  result,\n  run,\n  runtimeInput,\n}: {\n  readonly deactivateRun: () => void;\n  readonly events: SessionEventDispatcher;\n  readonly result: \"aborted\" | \"completed\";\n  readonly run: BufferedAgentRun;\n  readonly runtimeInput: RuntimeInputState;\n}): Promise<void> {\n  const terminalEvent = result === \"aborted\" ? \"turn-abort\" : \"turn-end\";\n  closeRuntimeInput(runtimeInput, terminalEvent);\n  deactivateRun();\n  try {\n    await events.emitRunEvent(run, { type: terminalEvent });\n  } catch (terminalError) {\n    run.emit({ type: \"turn-error\", message: errorMessage(terminalError) });\n    closeRuntimeInput(runtimeInput, \"turn-error\");\n  }\n}\n\nasync function emitPreUserRuntimeInputs(\n  events: SessionEventDispatcher,\n  run: BufferedAgentRun,\n  runtimeInputs: readonly QueuedRuntimeInput[]\n): Promise<void> {\n  for (const runtimeInput of runtimeInputs) {\n    await events.emitRunEvent(run, {\n      input: runtimeInput.input,\n      placement: runtimeInput.placement,\n      type: \"runtime-input\",\n    });\n  }\n}\n\nasync function emitTurnEvent({\n  event,\n  events,\n  run,\n  runtimeInput,\n  state,\n}: {\n  readonly event: AgentEvent;\n  readonly events: SessionEventDispatcher;\n  readonly run: BufferedAgentRun;\n  readonly runtimeInput: RuntimeInputState;\n  readonly state: SessionState;\n}): Promise<{ readonly runtimeInputAdded: boolean } | undefined> {\n  if (event.type !== \"step-start\" && event.type !== \"step-end\") {\n    await events.emitRunEvent(run, event);\n    return;\n  }\n\n  await withRuntimeInputWindow(runtimeInput, event.type, async () => {\n    await events.emitRunBoundaryEvent(run, event);\n  });\n  const runtimeInputAdded = await drainRuntimeInput({\n    emit: (runtimeInputEvent) => events.emitRunEvent(run, runtimeInputEvent),\n    placement: event.type,\n    runtimeInput,\n    state,\n  });\n  return event.type === \"step-end\" ? { runtimeInputAdded } : undefined;\n}\n"],"mappings":";;;;;;;;AA2CA,eAAsB,mBAAmB,EACvC,UACA,eACA,QACA,WACA,MACA,KACA,SACA,YACA,SAC2C;CAC3C,MAAM,cAAc,IAAI,gBAAgB;CACxC,MAAM,EAAE,eAAe,OAAO,sBAAsB,KAAK,iBACvD;CACF,MAAM,SAAS,OAAO,WAAW;CACjC,SAAS;EACP,OAAO;EACP;EACA;EACA;CACF,CAAC;CACD,MAAM,kBAAkB,MAAM,cAAc;CAC5C,IAAI;CAEJ,IAAI;EACF,eAAe,MAAM,yBAAyB;GAC5C,eAAe,UAAU;GACzB;GACA;GACA;EACF,CAAC;EACD,KAAK,MAAM,SAAS,eAClB,MAAM,OAAO,aAAa,KAAK,KAAK;EAEtC,MAAM,6BAA6B,OAAO,oBAAoB;EAC9D,IAAI,OAAO;GACT,MAAM,gBAAgB,KAAK;GAC3B,MAAM,MAAM,OAAO;EACrB;EACA,MAAM,uBAAuB,cAAc,cAAc,YAAY;GACnE,MAAM,OAAO,qBAAqB,KAAK,EAAE,MAAM,aAAa,CAAC;EAC/D,CAAC;EACD,MAAM,yBAAyB,QAAQ,KAAK,oBAAoB;EAChE,MAAM,kBAAkB;GACtB,OAAO,UAAU,OAAO,aAAa,KAAK,KAAK;GAC/C,WAAW;GACX;GACA;EACF,CAAC;EAED,MAAM,SAAS,MAAM,aAAa;GAChC,MAAM,OAAO,UACX,cAAc;IACZ;IACA;IACA;IACA;IACA;GACF,CAAC;GACH,SAAS,MAAM;GACf;GACA,wBAAwB,aACtB,OAAO,sBAAsB,KAAK,QAAQ;GAC5C,QAAQ,YAAY;GACpB,eAAe,cAAc;EAC/B,CAAC;EAED,MAAM,MAAM,OAAO;EACnB,MAAM,cAAc,SAAS,yBAAyB,MAAM,CAAC;EAC7D,MAAM,oBAAoB;GACxB;GACA;GACA;GACA;GACA;EACF,CAAC;CACH,SAAS,OAAO;EACd,MAAM,YAAY,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;EAC1E,MAAM,cAAc,SAAS,wBAAwB,SAAS,CAAC;EAC/D,MAAM,2BAA2B;GAC/B,OAAO;GACP;GACA;GACA;GACA;EACF,CAAC;CACH,UAAU;EACR,kBAAkB,YAAY;EAC9B,QAAQ;EACR,IAAI,MAAM,KAAA,GAAW,aAAa,YAAY;CAChD;AACF;AAEA,SAAS,yBACP,QACgC;CAChC,OAAO,WAAW,YAAY,cAAc;AAC9C;AAEA,SAAS,wBAAwB,OAA8C;CAC7E,OAAO,iBAAiB,kCACpB,mBACA;AACN;AAEA,eAAe,6BACb,OACA,eACe;CACf,KAAK,MAAM,gBAAgB,eAAe;EACxC,MAAM,gBAAgB,aAAa,KAAK;EACxC,MAAM,MAAM,OAAO;CACrB;AACF;AAEA,eAAe,oBAAoB,EACjC,eACA,QACA,QACA,KACA,gBAOgB;CAChB,MAAM,gBAAgB,WAAW,YAAY,eAAe;CAC5D,kBAAkB,cAAc,aAAa;CAC7C,cAAc;CACd,IAAI;EACF,MAAM,OAAO,aAAa,KAAK,EAAE,MAAM,cAAc,CAAC;CACxD,SAAS,eAAe;EACtB,IAAI,KAAK;GAAE,MAAM;GAAc,SAAS,aAAa,aAAa;EAAE,CAAC;EACrE,kBAAkB,cAAc,YAAY;CAC9C;AACF;AAEA,eAAe,yBACb,QACA,KACA,eACe;CACf,KAAK,MAAM,gBAAgB,eACzB,MAAM,OAAO,aAAa,KAAK;EAC7B,OAAO,aAAa;EACpB,WAAW,aAAa;EACxB,MAAM;CACR,CAAC;AAEL;AAEA,eAAe,cAAc,EAC3B,OACA,QACA,KACA,cACA,SAO+D;CAC/D,IAAI,MAAM,SAAS,gBAAgB,MAAM,SAAS,YAAY;EAC5D,MAAM,OAAO,aAAa,KAAK,KAAK;EACpC;CACF;CAEA,MAAM,uBAAuB,cAAc,MAAM,MAAM,YAAY;EACjE,MAAM,OAAO,qBAAqB,KAAK,KAAK;CAC9C,CAAC;CACD,MAAM,oBAAoB,MAAM,kBAAkB;EAChD,OAAO,sBAAsB,OAAO,aAAa,KAAK,iBAAiB;EACvE,WAAW,MAAM;EACjB;EACA;CACF,CAAC;CACD,OAAO,MAAM,SAAS,aAAa,EAAE,kBAAkB,IAAI,KAAA;AAC7D"}

package/dist/session/session.js

@@ -1,30 +1,39 @@
-import { runAgentLoop } from "../agent-loop.js";
-import { normalizeAgentInput } from "./input-normalization.js";
 import { BufferedAgentRun } from "./run.js";
-import { addSteeringInput, closeRuntimeInput, createRuntimeInputState, hooksForRuntimeInput, withRuntimeInputWindow, withSteeringPlacement } from "./runtime-input.js";
-import { errorMessage, runAfterTurnHook, sessionKilledError, sessionTerminalError } from "./session-errors.js";
+import { normalizeAgentInput } from "./input-normalization.js";
+import { addSteeringInput, createRuntimeInputState, queueRuntimeInput } from "./runtime-input.js";
+import { sessionKilledError, sessionTerminalError } from "./session-errors.js";
+import { SessionEventDispatcher } from "./session-events.js";
 import { closeKilledRuntimeInputs } from "./session-kill.js";
-import { drainRuntimeInput } from "./session-runtime-drain.js";
+import { queueSessionNotification, startSessionQueueDrain } from "./session-notification.js";
 import { SessionState } from "./session-state.js";
-import { emitTurnErrorAfterRecovery } from "./session-turn-error.js";
+import { processQueuedInput } from "./session-turn-processor.js";
 //#region src/session/session.ts
 var AgentSession = class {
-	#hooks;
+	#events;
+	#execution;
 	#inputQueue = [];
 	#llm;
 	#pendingRuntimeInputs = [];
+	#sessionKey;
 	#state;
 	#activeAbort;
 	#activeRun;
 	#activeRuntimeInput;
+	#activeTurnId;
 	#deletePromise;
 	#killed = false;
 	#running = false;
 	#runToCloseOnKill;
-	constructor(llm, persistence, hooks) {
-		this.#hooks = hooks;
+	constructor(llm, persistence, plugins = [], execution = {}) {
 		this.#llm = llm;
+		this.#execution = execution;
+		this.#sessionKey = persistence.key;
 		this.#state = new SessionState(persistence);
+		this.#events = new SessionEventDispatcher({
+			history: () => this.#state.modelSnapshot(),
+			plugins,
+			signal: () => this.#activeAbort?.signal
+		});
 	}
 	async send(input) {
 		if (this.#killed || this.#deletePromise) throw sessionTerminalError(this.#killed);
@@ -33,21 +42,29 @@ var AgentSession = class {
 		const runtimeInput = createRuntimeInputState(this.#pendingRuntimeInputs.splice(0));
 		const acceptedInput = normalizeAgentInput(input);
 		const run = new BufferedAgentRun();
-		run.emit(acceptedInput);
+		await this.#events.emitRunEvent(run, acceptedInput);
 		this.#inputQueue.push({
+			initialEvents: [],
 			input: structuredClone(acceptedInput),
+			preUserRuntimeInputs: [],
 			run,
 			runtimeInput
 		});
-		this.#drainInputQueue().catch((error) => {
-			run.emit({
-				type: "turn-error",
-				message: errorMessage(error)
-			});
-			run.close();
-		});
+		startSessionQueueDrain(run, () => this.#drainInputQueue());
 		return run;
 	}
+	async notify(input, options = {}) {
+		if (this.#killed || this.#deletePromise) throw sessionTerminalError(this.#killed);
+		await this.#state.ensureLoaded();
+		if (this.#killed || this.#deletePromise) throw sessionTerminalError(this.#killed);
+		return queueSessionNotification(input, options, {
+			activeRun: this.#activeRun,
+			activeRuntimeInput: this.#activeRuntimeInput,
+			drain: () => this.#drainInputQueue(),
+			inputQueue: this.#inputQueue,
+			pendingRuntimeInputs: this.#pendingRuntimeInputs
+		});
+	}
 	async steer(input) {
 		if (this.#killed || this.#deletePromise) throw sessionTerminalError(this.#killed);
 		const runtimeInput = this.#activeRuntimeInput;
@@ -59,11 +76,17 @@ var AgentSession = class {
 	interrupt() {
 		this.#activeAbort?.abort();
 	}
+	currentTurnId() {
+		return this.#activeTurnId;
+	}
 	delete() {
-		this.#deletePromise ??= this.#state.delete().then(() => this.kill(), (error) => {
-			this.#deletePromise = void 0;
-			throw error;
-		});
+		if (!this.#deletePromise) {
+			this.kill();
+			this.#deletePromise = this.#state.delete().catch((error) => {
+				this.#deletePromise = void 0;
+				throw error;
+			});
+		}
 		return this.#deletePromise;
 	}
 	enqueueRuntimeInput(input, placement = "turn-start") {
@@ -77,7 +100,7 @@ var AgentSession = class {
 				});
 				return;
 			}
-			runtimeInput.queue.push({
+			queueRuntimeInput(runtimeInput, {
 				input,
 				placement
 			});
@@ -89,12 +112,12 @@ var AgentSession = class {
 		});
 	}
 	emitObserverEvent(event) {
-		this.#activeRun?.emit(event);
+		return this.#events.emitObserverEvent(this.#activeRun, event);
 	}
 	#enqueuePendingRuntimeInput(input) {
 		const queuedTurn = this.#inputQueue[0];
 		if (input.placement === "turn-start" && queuedTurn) {
-			queuedTurn.runtimeInput.queue.push(input);
+			queueRuntimeInput(queuedTurn.runtimeInput, input);
 			return;
 		}
 		this.#pendingRuntimeInputs.push(input);
@@ -118,88 +141,37 @@ var AgentSession = class {
 		try {
 			while (!this.#killed && this.#inputQueue.length > 0) {
 				const item = this.#inputQueue.shift();
-				if (item) await this.#processQueuedInput(item);
+				if (item) await processQueuedInput({
+					activate: ({ abort, run, runtimeInput, turnId }) => {
+						this.#activeAbort = abort;
+						this.#activeRun = run;
+						this.#activeRuntimeInput = runtimeInput;
+						this.#activeTurnId = turnId;
+						this.#runToCloseOnKill = run;
+					},
+					deactivateRun: () => {
+						this.#activeRun = void 0;
+						this.#activeRuntimeInput = void 0;
+					},
+					events: this.#events,
+					execution: this.#execution,
+					item,
+					llm: this.#llm,
+					release: () => {
+						this.#activeAbort = void 0;
+						this.#activeRun = void 0;
+						this.#activeRuntimeInput = void 0;
+						this.#activeTurnId = void 0;
+						this.#runToCloseOnKill = void 0;
+					},
+					sessionKey: this.#sessionKey,
+					state: this.#state
+				});
 			}
 		} finally {
 			this.#running = false;
 		}
 	}
-	async #processQueuedInput({ input, run, runtimeInput }) {
-		const activeAbort = new AbortController();
-		this.#activeAbort = activeAbort;
-		this.#activeRun = run;
-		this.#activeRuntimeInput = runtimeInput;
-		this.#runToCloseOnKill = run;
-		const historySnapshot = this.#state.modelSnapshot();
-		try {
-			await withSteeringPlacement(runtimeInput, "turn-start", async () => {
-				await this.#hooks?.beforeTurn?.({
-					history: this.#state.modelSnapshot(),
-					input,
-					signal: activeAbort.signal
-				});
-			});
-			await withRuntimeInputWindow(runtimeInput, "turn-start", async () => {
-				await run.emitBoundary({ type: "turn-start" });
-			});
-			this.#state.appendUserInput(input);
-			await this.#state.commit();
-			await drainRuntimeInput({
-				placement: "turn-start",
-				run,
-				runtimeInput,
-				state: this.#state
-			});
-			const result = await runAgentLoop({
-				emit: async (event) => {
-					if (event.type === "step-start" || event.type === "step-end") {
-						await withRuntimeInputWindow(runtimeInput, event.type, async () => {
-							await run.emitBoundary(event);
-						});
-						const runtimeInputAdded = await drainRuntimeInput({
-							placement: event.type,
-							run,
-							runtimeInput,
-							state: this.#state
-						});
-						return event.type === "step-end" ? { runtimeInputAdded } : void 0;
-					}
-					run.emit(event);
-				},
-				history: this.#state.history,
-				hooks: hooksForRuntimeInput(this.#hooks, runtimeInput),
-				llm: this.#llm,
-				signal: activeAbort.signal
-			});
-			await this.#state.commit();
-			const terminalEvent = result === "aborted" ? "turn-abort" : "turn-end";
-			closeRuntimeInput(runtimeInput, terminalEvent);
-			this.#activeRuntimeInput = void 0;
-			this.#activeRun = void 0;
-			await runAfterTurnHook(this.#hooks, {
-				history: this.#state.modelSnapshot(),
-				input,
-				result,
-				signal: activeAbort.signal
-			});
-			run.emit({ type: terminalEvent });
-		} catch (error) {
-			await emitTurnErrorAfterRecovery({
-				error: error instanceof Error ? error : new Error(String(error)),
-				historySnapshot,
-				run,
-				runtimeInput,
-				state: this.#state
-			});
-		} finally {
-			closeRuntimeInput(runtimeInput);
-			this.#activeAbort = void 0;
-			this.#activeRun = void 0;
-			this.#activeRuntimeInput = void 0;
-			this.#runToCloseOnKill = void 0;
-			run.close(void 0, runtimeInput.closedReason);
-		}
-	}
 };
 //#endregion
 export { AgentSession };

package/dist/session/session.js.map

@@ -1 +1 @@
-{"version":3,"file":"session.js","names":["#hooks","#inputQueue","#llm","#pendingRuntimeInputs","#state","#killed","#deletePromise","#drainInputQueue","#activeRuntimeInput","#activeRun","#activeAbort","#enqueuePendingRuntimeInput","#runToCloseOnKill","#running","#processQueuedInput"],"sources":["../../src/session/session.ts"],"sourcesContent":["import { runAgentLoop } from \"../agent-loop\";\nimport type { AgentHooks } from \"../hooks\";\nimport type { Llm } from \"../llm\";\nimport type { AgentEvent } from \"./events\";\nimport type { AgentInput, UserInput } from \"./input\";\nimport { normalizeAgentInput } from \"./input-normalization\";\nimport { type AgentRun, BufferedAgentRun } from \"./run\";\nimport {\n  addSteeringInput,\n  closeRuntimeInput,\n  createRuntimeInputState,\n  hooksForRuntimeInput,\n  type QueuedInput,\n  type QueuedRuntimeInput,\n  type RuntimeInputPlacement,\n  type RuntimeInputState,\n  withRuntimeInputWindow,\n  withSteeringPlacement,\n} from \"./runtime-input\";\nimport {\n  errorMessage,\n  runAfterTurnHook,\n  sessionKilledError,\n  sessionTerminalError,\n} from \"./session-errors\";\nimport { closeKilledRuntimeInputs } from \"./session-kill\";\nimport { drainRuntimeInput } from \"./session-runtime-drain\";\nimport { type SessionPersistenceOptions, SessionState } from \"./session-state\";\nimport { emitTurnErrorAfterRecovery } from \"./session-turn-error\";\n\nexport type { AgentInput, SessionInput, UserInput } from \"./input\";\nexport type { AgentRun } from \"./run\";\n\nexport class AgentSession {\n  readonly #hooks?: AgentHooks;\n  readonly #inputQueue: QueuedInput[] = [];\n  readonly #llm: Llm;\n  readonly #pendingRuntimeInputs: QueuedRuntimeInput[] = [];\n  readonly #state: SessionState;\n  #activeAbort?: AbortController;\n  #activeRun?: BufferedAgentRun;\n  #activeRuntimeInput?: RuntimeInputState;\n  #deletePromise?: Promise<void>;\n  #killed = false;\n  #running = false;\n  #runToCloseOnKill?: BufferedAgentRun;\n\n  constructor(\n    llm: Llm,\n    persistence: SessionPersistenceOptions,\n    hooks?: AgentHooks\n  ) {\n    this.#hooks = hooks;\n    this.#llm = llm;\n    this.#state = new SessionState(persistence);\n  }\n\n  async send(input: AgentInput): Promise<AgentRun> {\n    if (this.#killed || this.#deletePromise) {\n      throw sessionTerminalError(this.#killed);\n    }\n\n    await this.#state.ensureLoaded();\n\n    if (this.#killed || this.#deletePromise) {\n      throw sessionTerminalError(this.#killed);\n    }\n\n    const runtimeInput = createRuntimeInputState(\n      this.#pendingRuntimeInputs.splice(0)\n    );\n    const acceptedInput = normalizeAgentInput(input);\n    const run = new BufferedAgentRun();\n    run.emit(acceptedInput);\n    this.#inputQueue.push({\n      input: structuredClone(acceptedInput),\n      run,\n      runtimeInput,\n    });\n    this.#drainInputQueue().catch((error: unknown) => {\n      run.emit({ type: \"turn-error\", message: errorMessage(error) });\n      run.close();\n    });\n    return run;\n  }\n\n  async steer(input: AgentInput): Promise<AgentRun> {\n    if (this.#killed || this.#deletePromise) {\n      throw sessionTerminalError(this.#killed);\n    }\n\n    const runtimeInput = this.#activeRuntimeInput;\n    const run = this.#activeRun;\n    if (!(runtimeInput && run)) {\n      return this.send(input);\n    }\n\n    await addSteeringInput(runtimeInput, input);\n    return run;\n  }\n\n  interrupt(): void {\n    this.#activeAbort?.abort();\n  }\n\n  delete(): Promise<void> {\n    this.#deletePromise ??= this.#state.delete().then(\n      () => this.kill(),\n      (error: unknown) => {\n        this.#deletePromise = undefined;\n        throw error;\n      }\n    );\n    return this.#deletePromise;\n  }\n\n  enqueueRuntimeInput(\n    input: UserInput,\n    placement: RuntimeInputPlacement = \"turn-start\"\n  ): void {\n    if (this.#killed) {\n      return;\n    }\n\n    const runtimeInput = this.#activeRuntimeInput;\n    if (runtimeInput && !runtimeInput.closedReason) {\n      if (placement === \"turn-start\" && runtimeInput.placement !== placement) {\n        this.#enqueuePendingRuntimeInput({ input, placement });\n        return;\n      }\n\n      runtimeInput.queue.push({ input, placement });\n      return;\n    }\n\n    this.#enqueuePendingRuntimeInput({ input, placement });\n  }\n\n  emitObserverEvent(event: AgentEvent): void {\n    this.#activeRun?.emit(event);\n  }\n\n  #enqueuePendingRuntimeInput(input: QueuedRuntimeInput): void {\n    const queuedTurn = this.#inputQueue[0];\n    if (input.placement === \"turn-start\" && queuedTurn) {\n      queuedTurn.runtimeInput.queue.push(input);\n      return;\n    }\n\n    this.#pendingRuntimeInputs.push(input);\n  }\n\n  kill(): void {\n    if (this.#killed) {\n      return;\n    }\n\n    this.#killed = true;\n    const killedError = sessionKilledError();\n    this.#pendingRuntimeInputs.length = 0;\n    this.#activeAbort?.abort();\n    closeKilledRuntimeInputs({\n      activeRuntimeInput: this.#activeRuntimeInput,\n      inputQueue: this.#inputQueue,\n      message: killedError.message,\n      runToClose: this.#runToCloseOnKill ?? this.#activeRun,\n    });\n  }\n\n  async #drainInputQueue(): Promise<void> {\n    if (this.#running) {\n      return;\n    }\n\n    this.#running = true;\n    try {\n      while (!this.#killed && this.#inputQueue.length > 0) {\n        const item = this.#inputQueue.shift();\n        if (item) {\n          await this.#processQueuedInput(item);\n        }\n      }\n    } finally {\n      this.#running = false;\n    }\n  }\n\n  async #processQueuedInput({\n    input,\n    run,\n    runtimeInput,\n  }: QueuedInput): Promise<void> {\n    const activeAbort = new AbortController();\n    this.#activeAbort = activeAbort;\n    this.#activeRun = run;\n    this.#activeRuntimeInput = runtimeInput;\n    this.#runToCloseOnKill = run;\n    const historySnapshot = this.#state.modelSnapshot();\n\n    try {\n      await withSteeringPlacement(runtimeInput, \"turn-start\", async () => {\n        await this.#hooks?.beforeTurn?.({\n          history: this.#state.modelSnapshot(),\n          input,\n          signal: activeAbort.signal,\n        });\n      });\n      await withRuntimeInputWindow(runtimeInput, \"turn-start\", async () => {\n        await run.emitBoundary({ type: \"turn-start\" });\n      });\n      this.#state.appendUserInput(input);\n      await this.#state.commit();\n      await drainRuntimeInput({\n        placement: \"turn-start\",\n        run,\n        runtimeInput,\n        state: this.#state,\n      });\n\n      const result = await runAgentLoop({\n        emit: async (event) => {\n          if (event.type === \"step-start\" || event.type === \"step-end\") {\n            await withRuntimeInputWindow(runtimeInput, event.type, async () => {\n              await run.emitBoundary(event);\n            });\n            const runtimeInputAdded = await drainRuntimeInput({\n              placement: event.type,\n              run,\n              runtimeInput,\n              state: this.#state,\n            });\n\n            return event.type === \"step-end\"\n              ? { runtimeInputAdded }\n              : undefined;\n          }\n\n          run.emit(event);\n        },\n        history: this.#state.history,\n        hooks: hooksForRuntimeInput(this.#hooks, runtimeInput),\n        llm: this.#llm,\n        signal: activeAbort.signal,\n      });\n\n      await this.#state.commit();\n      const terminalEvent = result === \"aborted\" ? \"turn-abort\" : \"turn-end\";\n      closeRuntimeInput(runtimeInput, terminalEvent);\n      this.#activeRuntimeInput = undefined;\n      this.#activeRun = undefined;\n      await runAfterTurnHook(this.#hooks, {\n        history: this.#state.modelSnapshot(),\n        input,\n        result,\n        signal: activeAbort.signal,\n      });\n      run.emit({ type: terminalEvent });\n    } catch (error) {\n      const turnError =\n        error instanceof Error ? error : new Error(String(error));\n      await emitTurnErrorAfterRecovery({\n        error: turnError,\n        historySnapshot,\n        run,\n        runtimeInput,\n        state: this.#state,\n      });\n    } finally {\n      closeRuntimeInput(runtimeInput);\n      this.#activeAbort = undefined;\n      this.#activeRun = undefined;\n      this.#activeRuntimeInput = undefined;\n      this.#runToCloseOnKill = undefined;\n      run.close(undefined, runtimeInput.closedReason);\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"session.js","names":["#events","#execution","#inputQueue","#llm","#pendingRuntimeInputs","#sessionKey","#state","#activeAbort","#killed","#deletePromise","#drainInputQueue","#activeRun","#activeRuntimeInput","#activeTurnId","#enqueuePendingRuntimeInput","#runToCloseOnKill","#running"],"sources":["../../src/session/session.ts"],"sourcesContent":["import type { RuntimeLlm } from \"../llm\";\nimport type { AgentPlugin } from \"../plugins\";\nimport type { AgentEvent } from \"./events\";\nimport type { AgentInput, UserInput } from \"./input\";\nimport { normalizeAgentInput } from \"./input-normalization\";\nimport { type AgentRun, BufferedAgentRun } from \"./run\";\nimport {\n  addSteeringInput,\n  createRuntimeInputState,\n  type QueuedInput,\n  type QueuedRuntimeInput,\n  queueRuntimeInput,\n  type RuntimeInputPlacement,\n  type RuntimeInputState,\n} from \"./runtime-input\";\nimport { sessionKilledError, sessionTerminalError } from \"./session-errors\";\nimport { SessionEventDispatcher } from \"./session-events\";\nimport type { SessionExecutionOptions } from \"./session-execution\";\nimport { closeKilledRuntimeInputs } from \"./session-kill\";\nimport {\n  type NotifyOptions,\n  queueSessionNotification,\n  startSessionQueueDrain,\n} from \"./session-notification\";\nimport { type SessionPersistenceOptions, SessionState } from \"./session-state\";\nimport { processQueuedInput } from \"./session-turn-processor\";\n\nexport type { AgentInput, SessionInput, UserInput } from \"./input\";\nexport type { AgentRun } from \"./run\";\nexport type { NotifyOptions } from \"./session-notification\";\n\nexport class AgentSession {\n  readonly #events: SessionEventDispatcher;\n  readonly #execution: SessionExecutionOptions;\n  readonly #inputQueue: QueuedInput[] = [];\n  readonly #llm: RuntimeLlm;\n  readonly #pendingRuntimeInputs: QueuedRuntimeInput[] = [];\n  readonly #sessionKey: string;\n  readonly #state: SessionState;\n  #activeAbort?: AbortController;\n  #activeRun?: BufferedAgentRun;\n  #activeRuntimeInput?: RuntimeInputState;\n  #activeTurnId?: string;\n  #deletePromise?: Promise<void>;\n  #killed = false;\n  #running = false;\n  #runToCloseOnKill?: BufferedAgentRun;\n\n  constructor(\n    llm: RuntimeLlm,\n    persistence: SessionPersistenceOptions,\n    plugins: readonly AgentPlugin[] = [],\n    execution: SessionExecutionOptions = {}\n  ) {\n    this.#llm = llm;\n    this.#execution = execution;\n    this.#sessionKey = persistence.key;\n    this.#state = new SessionState(persistence);\n    this.#events = new SessionEventDispatcher({\n      history: () => this.#state.modelSnapshot(),\n      plugins,\n      signal: () => this.#activeAbort?.signal,\n    });\n  }\n\n  async send(input: AgentInput): Promise<AgentRun> {\n    if (this.#killed || this.#deletePromise) {\n      throw sessionTerminalError(this.#killed);\n    }\n\n    await this.#state.ensureLoaded();\n\n    if (this.#killed || this.#deletePromise) {\n      throw sessionTerminalError(this.#killed);\n    }\n\n    const runtimeInput = createRuntimeInputState(\n      this.#pendingRuntimeInputs.splice(0)\n    );\n    const acceptedInput = normalizeAgentInput(input);\n    const run = new BufferedAgentRun();\n    await this.#events.emitRunEvent(run, acceptedInput);\n    this.#inputQueue.push({\n      initialEvents: [],\n      input: structuredClone(acceptedInput),\n      preUserRuntimeInputs: [],\n      run,\n      runtimeInput,\n    });\n    startSessionQueueDrain(run, () => this.#drainInputQueue());\n    return run;\n  }\n\n  async notify(\n    input: AgentInput,\n    options: NotifyOptions = {}\n  ): Promise<AgentRun> {\n    if (this.#killed || this.#deletePromise) {\n      throw sessionTerminalError(this.#killed);\n    }\n\n    await this.#state.ensureLoaded();\n\n    if (this.#killed || this.#deletePromise) {\n      throw sessionTerminalError(this.#killed);\n    }\n\n    return queueSessionNotification(input, options, {\n      activeRun: this.#activeRun,\n      activeRuntimeInput: this.#activeRuntimeInput,\n      drain: () => this.#drainInputQueue(),\n      inputQueue: this.#inputQueue,\n      pendingRuntimeInputs: this.#pendingRuntimeInputs,\n    });\n  }\n\n  async steer(input: AgentInput): Promise<AgentRun> {\n    if (this.#killed || this.#deletePromise) {\n      throw sessionTerminalError(this.#killed);\n    }\n\n    const runtimeInput = this.#activeRuntimeInput;\n    const run = this.#activeRun;\n    if (!(runtimeInput && run)) {\n      return this.send(input);\n    }\n\n    await addSteeringInput(runtimeInput, input);\n    return run;\n  }\n\n  interrupt(): void {\n    this.#activeAbort?.abort();\n  }\n\n  currentTurnId(): string | undefined {\n    return this.#activeTurnId;\n  }\n\n  delete(): Promise<void> {\n    if (!this.#deletePromise) {\n      this.kill();\n      this.#deletePromise = this.#state.delete().catch((error: unknown) => {\n        this.#deletePromise = undefined;\n        throw error;\n      });\n    }\n    return this.#deletePromise;\n  }\n\n  enqueueRuntimeInput(\n    input: UserInput,\n    placement: RuntimeInputPlacement = \"turn-start\"\n  ): void {\n    if (this.#killed) {\n      return;\n    }\n\n    const runtimeInput = this.#activeRuntimeInput;\n    if (runtimeInput && !runtimeInput.closedReason) {\n      if (placement === \"turn-start\" && runtimeInput.placement !== placement) {\n        this.#enqueuePendingRuntimeInput({ input, placement });\n        return;\n      }\n\n      queueRuntimeInput(runtimeInput, { input, placement });\n      return;\n    }\n\n    this.#enqueuePendingRuntimeInput({ input, placement });\n  }\n\n  emitObserverEvent(event: AgentEvent): Promise<void> {\n    return this.#events.emitObserverEvent(this.#activeRun, event);\n  }\n\n  #enqueuePendingRuntimeInput(input: QueuedRuntimeInput): void {\n    const queuedTurn = this.#inputQueue[0];\n    if (input.placement === \"turn-start\" && queuedTurn) {\n      queueRuntimeInput(queuedTurn.runtimeInput, input);\n      return;\n    }\n\n    this.#pendingRuntimeInputs.push(input);\n  }\n\n  kill(): void {\n    if (this.#killed) {\n      return;\n    }\n\n    this.#killed = true;\n    const killedError = sessionKilledError();\n    this.#pendingRuntimeInputs.length = 0;\n    this.#activeAbort?.abort();\n    closeKilledRuntimeInputs({\n      activeRuntimeInput: this.#activeRuntimeInput,\n      inputQueue: this.#inputQueue,\n      message: killedError.message,\n      runToClose: this.#runToCloseOnKill ?? this.#activeRun,\n    });\n  }\n\n  async #drainInputQueue(): Promise<void> {\n    if (this.#running) {\n      return;\n    }\n\n    this.#running = true;\n    try {\n      while (!this.#killed && this.#inputQueue.length > 0) {\n        const item = this.#inputQueue.shift();\n        if (item) {\n          await processQueuedInput({\n            activate: ({ abort, run, runtimeInput, turnId }) => {\n              this.#activeAbort = abort;\n              this.#activeRun = run;\n              this.#activeRuntimeInput = runtimeInput;\n              this.#activeTurnId = turnId;\n              this.#runToCloseOnKill = run;\n            },\n            deactivateRun: () => {\n              this.#activeRun = undefined;\n              this.#activeRuntimeInput = undefined;\n            },\n            events: this.#events,\n            execution: this.#execution,\n            item,\n            llm: this.#llm,\n            release: () => {\n              this.#activeAbort = undefined;\n              this.#activeRun = undefined;\n              this.#activeRuntimeInput = undefined;\n              this.#activeTurnId = undefined;\n              this.#runToCloseOnKill = undefined;\n            },\n            sessionKey: this.#sessionKey,\n            state: this.#state,\n          });\n        }\n      }\n    } finally {\n      this.#running = false;\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/session/snapshot.js.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot.js","names":[],"sources":["../../src/session/snapshot.ts"],"sourcesContent":["import type { ModelMessage } from \"ai\";\nimport type { StoredSession } from \"./store/types\";\n\nexport interface AgentSessionSnapshotV1 {\n  readonly history: ModelMessage[];\n  readonly schemaVersion: 1;\n}\n\nexport type AgentSessionSnapshot = AgentSessionSnapshotV1;\n\nexport function encodeSessionSnapshot(\n  history: ModelMessage[]\n): AgentSessionSnapshot {\n  return { schemaVersion: 1, history: structuredClone(history) };\n}\n\nexport function decodeStoredSessionSnapshot(\n  stored: StoredSession | null\n): ModelMessage[] {\n  if (!stored) {\n    return [];\n  }\n\n  const snapshot = stored.state;\n  if (isSessionSnapshotV1(snapshot)) {\n    return structuredClone(snapshot.history);\n  }\n\n  throw new Error(\"Unsupported stored session state\");\n}\n\nfunction isSessionSnapshotV1(value: unknown): value is AgentSessionSnapshotV1 {\n  return (\n    value !== null &&\n    typeof value === \"object\" &&\n    \"schemaVersion\" in value &&\n    value.schemaVersion === 1 &&\n    \"history\" in value &&\n    Array.isArray(value.history)\n  );\n}\n"],"mappings":";AAUA,SAAgB,sBACd,SACsB;CACtB,OAAO;EAAE,eAAe;EAAG,SAAS,gBAAgB,OAAO;CAAE;AAC/D;AAEA,SAAgB,4BACd,QACgB;CAChB,IAAI,CAAC,QACH,OAAO,CAAC;CAGV,MAAM,WAAW,OAAO;CACxB,IAAI,oBAAoB,QAAQ,GAC9B,OAAO,gBAAgB,SAAS,OAAO;CAGzC,MAAM,IAAI,MAAM,kCAAkC;AACpD;AAEA,SAAS,oBAAoB,OAAiD;CAC5E,OACE,UAAU,QACV,OAAO,UAAU,YACjB,mBAAmB,SACnB,MAAM,kBAAkB,KACxB,aAAa,SACb,MAAM,QAAQ,MAAM,OAAO;AAE/B"}
+{"version":3,"file":"snapshot.js","names":[],"sources":["../../src/session/snapshot.ts"],"sourcesContent":["import type { ModelMessage } from \"ai\";\nimport type { StoredSession } from \"./store/types\";\n\nexport interface AgentSessionSnapshotV1 {\n  readonly history: ModelMessage[];\n  readonly schemaVersion: 1;\n}\n\nexport function encodeSessionSnapshot(\n  history: ModelMessage[]\n): AgentSessionSnapshotV1 {\n  return { schemaVersion: 1, history: structuredClone(history) };\n}\n\nexport function decodeStoredSessionSnapshot(\n  stored: StoredSession | null\n): ModelMessage[] {\n  if (!stored) {\n    return [];\n  }\n\n  const snapshot = stored.state;\n  if (isSessionSnapshotV1(snapshot)) {\n    return structuredClone(snapshot.history);\n  }\n\n  throw new Error(\"Unsupported stored session state\");\n}\n\nfunction isSessionSnapshotV1(value: unknown): value is AgentSessionSnapshotV1 {\n  return (\n    value !== null &&\n    typeof value === \"object\" &&\n    \"schemaVersion\" in value &&\n    value.schemaVersion === 1 &&\n    \"history\" in value &&\n    Array.isArray(value.history)\n  );\n}\n"],"mappings":";AAQA,SAAgB,sBACd,SACwB;CACxB,OAAO;EAAE,eAAe;EAAG,SAAS,gBAAgB,OAAO;CAAE;AAC/D;AAEA,SAAgB,4BACd,QACgB;CAChB,IAAI,CAAC,QACH,OAAO,CAAC;CAGV,MAAM,WAAW,OAAO;CACxB,IAAI,oBAAoB,QAAQ,GAC9B,OAAO,gBAAgB,SAAS,OAAO;CAGzC,MAAM,IAAI,MAAM,kCAAkC;AACpD;AAEA,SAAS,oBAAoB,OAAiD;CAC5E,OACE,UAAU,QACV,OAAO,UAAU,YACjB,mBAAmB,SACnB,MAAM,kBAAkB,KACxB,aAAa,SACb,MAAM,QAAQ,MAAM,OAAO;AAE/B"}

package/dist/subagent-background-child-run-state.js

@@ -0,0 +1,51 @@
+//#region src/subagent-background-child-run-state.ts
+function durableBackgroundChildRunState({ delegateToolCallId, description, groupId, parentSessionKey, prompt, subagent }) {
+	return {
+		...delegateToolCallId ? { delegateToolCallId } : {},
+		...description ? { description } : {},
+		...groupId ? { groupId } : {},
+		kind: "background-subagent",
+		...parentSessionKey ? { parentSessionKey } : {},
+		prompt: structuredClone(prompt),
+		subagent: subagent ?? "subagent"
+	};
+}
+function readDurableBackgroundChildRunState(checkpoint) {
+	const state = checkpoint?.runtimeState;
+	if (!isRecord(state) || state.kind !== "background-subagent") return null;
+	if (!isAgentInput(state.prompt) || typeof state.subagent !== "string") return null;
+	return {
+		...typeof state.delegateToolCallId === "string" ? { delegateToolCallId: state.delegateToolCallId } : {},
+		...typeof state.description === "string" ? { description: state.description } : {},
+		...typeof state.groupId === "string" ? { groupId: state.groupId } : {},
+		kind: "background-subagent",
+		...typeof state.parentSessionKey === "string" ? { parentSessionKey: state.parentSessionKey } : {},
+		prompt: state.prompt,
+		subagent: state.subagent
+	};
+}
+function isAgentInput(value) {
+	return typeof value === "string" || isStringArray(value) || isUserInput(value) || isMessageContent(value);
+}
+function isUserInput(value) {
+	if (!isRecord(value)) return false;
+	if (value.type === "user-text") return typeof value.text === "string" || isStringArray(value.text);
+	return value.type === "user-message" && isMessageContent(value.content);
+}
+function isMessageContent(value) {
+	return Array.isArray(value) && value.every(isMessageContentPart);
+}
+function isMessageContentPart(value) {
+	if (!isRecord(value) || typeof value.type !== "string") return false;
+	return value.type === "text" || value.type === "image" || value.type === "file";
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null;
+}
+function isStringArray(value) {
+	return Array.isArray(value) && value.every((item) => typeof item === "string");
+}
+//#endregion
+export { durableBackgroundChildRunState, readDurableBackgroundChildRunState };
+
+//# sourceMappingURL=subagent-background-child-run-state.js.map

package/dist/subagent-background-child-run-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-background-child-run-state.js","names":[],"sources":["../src/subagent-background-child-run-state.ts"],"sourcesContent":["import type { RunCheckpoint } from \"./execution/types\";\nimport type { AgentInput } from \"./session/input\";\n\nexport interface DurableBackgroundChildRunState {\n  readonly delegateToolCallId?: string;\n  readonly description?: string;\n  readonly groupId?: string;\n  readonly kind: \"background-subagent\";\n  readonly parentSessionKey?: string;\n  readonly prompt: AgentInput;\n  readonly subagent: string;\n}\n\nexport function durableBackgroundChildRunState({\n  delegateToolCallId,\n  description,\n  groupId,\n  parentSessionKey,\n  prompt,\n  subagent,\n}: {\n  readonly delegateToolCallId?: string;\n  readonly description?: string;\n  readonly groupId?: string;\n  readonly parentSessionKey?: string;\n  readonly prompt: AgentInput;\n  readonly subagent?: string;\n}): DurableBackgroundChildRunState {\n  return {\n    ...(delegateToolCallId ? { delegateToolCallId } : {}),\n    ...(description ? { description } : {}),\n    ...(groupId ? { groupId } : {}),\n    kind: \"background-subagent\",\n    ...(parentSessionKey ? { parentSessionKey } : {}),\n    prompt: structuredClone(prompt),\n    subagent: subagent ?? \"subagent\",\n  };\n}\n\nexport function readDurableBackgroundChildRunState(\n  checkpoint: RunCheckpoint | null\n): DurableBackgroundChildRunState | null {\n  const state = checkpoint?.runtimeState;\n  if (!isRecord(state) || state.kind !== \"background-subagent\") {\n    return null;\n  }\n\n  if (!isAgentInput(state.prompt) || typeof state.subagent !== \"string\") {\n    return null;\n  }\n\n  return {\n    ...(typeof state.delegateToolCallId === \"string\"\n      ? { delegateToolCallId: state.delegateToolCallId }\n      : {}),\n    ...(typeof state.description === \"string\"\n      ? { description: state.description }\n      : {}),\n    ...(typeof state.groupId === \"string\" ? { groupId: state.groupId } : {}),\n    kind: \"background-subagent\",\n    ...(typeof state.parentSessionKey === \"string\"\n      ? { parentSessionKey: state.parentSessionKey }\n      : {}),\n    prompt: state.prompt,\n    subagent: state.subagent,\n  };\n}\n\nfunction isAgentInput(value: unknown): value is AgentInput {\n  return (\n    typeof value === \"string\" ||\n    isStringArray(value) ||\n    isUserInput(value) ||\n    isMessageContent(value)\n  );\n}\n\nfunction isUserInput(value: unknown): boolean {\n  if (!isRecord(value)) {\n    return false;\n  }\n\n  if (value.type === \"user-text\") {\n    return typeof value.text === \"string\" || isStringArray(value.text);\n  }\n\n  return value.type === \"user-message\" && isMessageContent(value.content);\n}\n\nfunction isMessageContent(value: unknown): boolean {\n  return Array.isArray(value) && value.every(isMessageContentPart);\n}\n\nfunction isMessageContentPart(value: unknown): boolean {\n  if (!isRecord(value) || typeof value.type !== \"string\") {\n    return false;\n  }\n\n  return (\n    value.type === \"text\" || value.type === \"image\" || value.type === \"file\"\n  );\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction isStringArray(value: unknown): value is readonly string[] {\n  return (\n    Array.isArray(value) && value.every((item) => typeof item === \"string\")\n  );\n}\n"],"mappings":";AAaA,SAAgB,+BAA+B,EAC7C,oBACA,aACA,SACA,kBACA,QACA,YAQiC;CACjC,OAAO;EACL,GAAI,qBAAqB,EAAE,mBAAmB,IAAI,CAAC;EACnD,GAAI,cAAc,EAAE,YAAY,IAAI,CAAC;EACrC,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;EAC7B,MAAM;EACN,GAAI,mBAAmB,EAAE,iBAAiB,IAAI,CAAC;EAC/C,QAAQ,gBAAgB,MAAM;EAC9B,UAAU,YAAY;CACxB;AACF;AAEA,SAAgB,mCACd,YACuC;CACvC,MAAM,QAAQ,YAAY;CAC1B,IAAI,CAAC,SAAS,KAAK,KAAK,MAAM,SAAS,uBACrC,OAAO;CAGT,IAAI,CAAC,aAAa,MAAM,MAAM,KAAK,OAAO,MAAM,aAAa,UAC3D,OAAO;CAGT,OAAO;EACL,GAAI,OAAO,MAAM,uBAAuB,WACpC,EAAE,oBAAoB,MAAM,mBAAmB,IAC/C,CAAC;EACL,GAAI,OAAO,MAAM,gBAAgB,WAC7B,EAAE,aAAa,MAAM,YAAY,IACjC,CAAC;EACL,GAAI,OAAO,MAAM,YAAY,WAAW,EAAE,SAAS,MAAM,QAAQ,IAAI,CAAC;EACtE,MAAM;EACN,GAAI,OAAO,MAAM,qBAAqB,WAClC,EAAE,kBAAkB,MAAM,iBAAiB,IAC3C,CAAC;EACL,QAAQ,MAAM;EACd,UAAU,MAAM;CAClB;AACF;AAEA,SAAS,aAAa,OAAqC;CACzD,OACE,OAAO,UAAU,YACjB,cAAc,KAAK,KACnB,YAAY,KAAK,KACjB,iBAAiB,KAAK;AAE1B;AAEA,SAAS,YAAY,OAAyB;CAC5C,IAAI,CAAC,SAAS,KAAK,GACjB,OAAO;CAGT,IAAI,MAAM,SAAS,aACjB,OAAO,OAAO,MAAM,SAAS,YAAY,cAAc,MAAM,IAAI;CAGnE,OAAO,MAAM,SAAS,kBAAkB,iBAAiB,MAAM,OAAO;AACxE;AAEA,SAAS,iBAAiB,OAAyB;CACjD,OAAO,MAAM,QAAQ,KAAK,KAAK,MAAM,MAAM,oBAAoB;AACjE;AAEA,SAAS,qBAAqB,OAAyB;CACrD,IAAI,CAAC,SAAS,KAAK,KAAK,OAAO,MAAM,SAAS,UAC5C,OAAO;CAGT,OACE,MAAM,SAAS,UAAU,MAAM,SAAS,WAAW,MAAM,SAAS;AAEtE;AAEA,SAAS,SAAS,OAAkD;CAClE,OAAO,OAAO,UAAU,YAAY,UAAU;AAChD;AAEA,SAAS,cAAc,OAA4C;CACjE,OACE,MAAM,QAAQ,KAAK,KAAK,MAAM,OAAO,SAAS,OAAO,SAAS,QAAQ;AAE1E"}

package/dist/subagent-background-child-run.js

@@ -0,0 +1,103 @@
+import { durableBackgroundChildRunState } from "./subagent-background-child-run-state.js";
+//#region src/subagent-background-child-run.ts
+function createBackgroundTaskId() {
+	return `bg_${crypto.randomUUID().replaceAll("-", "")}`;
+}
+async function createDurableBackgroundTaskId({ delegateToolCallId, prompt, sessionKey }) {
+	const digestInput = backgroundSubagentDedupeKey({
+		delegateToolCallId,
+		prompt,
+		sessionKey
+	});
+	const digest = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(digestInput));
+	return `bg_${[...new Uint8Array(digest.slice(0, 16))].map((byte) => byte.toString(16).padStart(2, "0")).join("")}`;
+}
+async function getBackgroundChildRun({ delegateToolCallId, executionHost, prompt, sessionKey }) {
+	if (!executionHost) return;
+	const dedupeKey = backgroundSubagentDedupeKey({
+		delegateToolCallId,
+		prompt,
+		sessionKey
+	});
+	return await executionHost.store.runs.getByDedupeKey(dedupeKey) ?? void 0;
+}
+async function getOrCreateBackgroundChildRun(input) {
+	if (!input.executionHost) return;
+	const id = input.publicTaskId ?? createBackgroundTaskId();
+	const dedupeKey = backgroundSubagentDedupeKey(input);
+	return await input.executionHost.store.transaction(async (tx) => {
+		const existing = await tx.runs.getByDedupeKey(dedupeKey);
+		if (existing) return existing;
+		const parentRunId = input.parentRunId ?? input.parentSessionKey ?? input.sessionKey;
+		const runtimeState = durableBackgroundChildRunState(input);
+		const run = {
+			checkpointVersion: 0,
+			dedupeKey,
+			kind: "background-subagent",
+			...input.ownerNamespace ? { ownerNamespace: input.ownerNamespace } : {},
+			parentRunId,
+			publicTaskId: id,
+			rootRunId: parentRunId,
+			runId: `background:${id}`,
+			sessionKey: `${input.sessionKey}:task:${id}`,
+			status: "queued"
+		};
+		await tx.runs.create(run);
+		await tx.checkpoints.append({
+			checkpointId: crypto.randomUUID(),
+			phase: "before-child-run",
+			runId: run.runId,
+			runtimeState,
+			sessionSnapshot: {},
+			version: 1
+		}, { expectedVersion: 0 });
+		await tx.checkpoints.append({
+			checkpointId: crypto.randomUUID(),
+			childRunId: run.runId,
+			phase: "child-linked",
+			runId: run.runId,
+			runtimeState,
+			sessionSnapshot: {},
+			version: 2
+		}, { expectedVersion: 1 });
+		return await tx.runs.get(run.runId) ?? run;
+	});
+}
+async function updateBackgroundRunStatus(job, status) {
+	if (!(job.executionHost && job.childRunId)) return true;
+	return await job.executionHost.store.transaction(async (tx) => {
+		const run = await tx.runs.get(job.childRunId ?? "");
+		if (!run || isTerminalBackgroundRunStatus(run.status)) return false;
+		if (job.childRunLeaseId && run.lease?.leaseId !== job.childRunLeaseId) return false;
+		await tx.runs.update({
+			...run,
+			output: job.result ?? run.output,
+			status
+		});
+		return true;
+	});
+}
+async function cancelBackgroundChildRun({ executionHost, runId }) {
+	return await executionHost.store.transaction(async (tx) => {
+		const run = await tx.runs.get(runId);
+		if (!run || isTerminalBackgroundRunStatus(run.status)) return run;
+		return await tx.runs.update({
+			...run,
+			status: "cancelled"
+		});
+	});
+}
+function childRunStatus(result) {
+	if (result === "aborted") return "cancelled";
+	return result;
+}
+function backgroundSubagentDedupeKey({ delegateToolCallId, prompt, sessionKey }) {
+	return `background-subagent:${sessionKey}:${delegateToolCallId ?? "unknown"}:${JSON.stringify(prompt)}`;
+}
+function isTerminalBackgroundRunStatus(status) {
+	return status === "cancelled" || status === "completed" || status === "error";
+}
+//#endregion
+export { cancelBackgroundChildRun, childRunStatus, createBackgroundTaskId, createDurableBackgroundTaskId, getBackgroundChildRun, getOrCreateBackgroundChildRun, updateBackgroundRunStatus };
+
+//# sourceMappingURL=subagent-background-child-run.js.map