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

package/dist/session/runtime-input.js

@@ -1,14 +1,15 @@
+import { normalizeAgentInput } from "./input-normalization.js";
 //#region src/session/runtime-input.ts
-function createRuntimeInputState() {
+function createRuntimeInputState(queue) {
 	return {
 		pending: Promise.resolve(),
-		queue: []
+		queue
 	};
 }
-function addRuntimeInput(runtimeInput, input) {
+function addSteeringInput(runtimeInput, input) {
 	const next = runtimeInput.pending.then(() => {
 		if (runtimeInput.closedReason) throw runtimeInputClosedError(runtimeInput.closedReason);
-		runtimeInput.queue.push({
+		queueRuntimeInput(runtimeInput, {
 			input: normalizeAgentInput(input),
 			placement: runtimeInput.steerPlacement ?? runtimeInput.placement ?? "step-end"
 		});
@@ -17,73 +18,34 @@ function addRuntimeInput(runtimeInput, input) {
 	return next;
 }
 function closeRuntimeInput(runtimeInput, reason = "the run reached a terminal state") {
-	if (!runtimeInput?.closedReason && runtimeInput) {
+	if (runtimeInput && !runtimeInput.closedReason) {
 		runtimeInput.closedReason = reason;
 		runtimeInput.placement = void 0;
 	}
 }
+async function withRuntimeInputWindow(runtimeInput, placement, callback) {
+	const previousSteerPlacement = runtimeInput.steerPlacement;
+	runtimeInput.placement = placement;
+	runtimeInput.steerPlacement = placement;
+	try {
+		return await callback();
+	} finally {
+		runtimeInput.placement = void 0;
+		runtimeInput.steerPlacement = previousSteerPlacement;
+	}
+}
 function shiftRuntimeInput(runtimeInput, placement) {
 	const index = runtimeInput.queue.findIndex((input) => input.placement === placement);
 	if (index === -1) return;
 	return runtimeInput.queue.splice(index, 1)[0];
 }
-function normalizeAgentInput(input) {
-	if (typeof input === "string") return {
-		type: "user-text",
-		text: input
-	};
-	if (isStringArrayInput(input)) return {
-		type: "user-text",
-		text: structuredClone(input)
-	};
-	if (isArrayInput(input)) {
-		assertUserMessageContent(input);
-		return {
-			type: "user-message",
-			content: structuredClone(input)
-		};
-	}
-	if (isUserMessage(input)) {
-		assertUserMessageContent(input.content);
-		assertUserMessageMetadata(input.metadata);
-	}
-	return structuredClone(input);
-}
-function isStringArrayInput(input) {
-	return isArrayInput(input) && input.every((part) => typeof part === "string");
-}
-function isArrayInput(input) {
-	return Array.isArray(input);
-}
-function isUserMessage(input) {
-	return input.type === "user-message";
-}
-function assertUserMessageContent(input) {
-	for (const part of input) if (!isUserMessageContentPart(part)) throw new TypeError("Agent input content parts must be { type: \"text\", text }, { type: \"image\", image }, or { type: \"file\", data, mediaType }.");
-}
-function assertUserMessageMetadata(metadata) {
-	if (metadata !== void 0 && (metadata === null || typeof metadata !== "object" || Array.isArray(metadata))) throw new TypeError("Agent input metadata must be an object when provided.");
-}
-function isUserMessageContentPart(part) {
-	if (part === null || typeof part !== "object" || !("type" in part)) return false;
-	if (part.type === "text") return "text" in part && typeof part.text === "string";
-	if (part.type === "image") return "image" in part && typeof part.image === "string" && (!("mediaType" in part) || typeof part.mediaType === "string");
-	if (part.type === "file") return "data" in part && isUserMessageFileData(part.data) && "mediaType" in part && typeof part.mediaType === "string" && (!("filename" in part) || typeof part.filename === "string");
-	return false;
-}
-function isUserMessageFileData(data) {
-	if (typeof data === "string") return true;
-	if (data === null || typeof data !== "object" || !("type" in data)) return false;
-	if (data.type === "data") return "data" in data && typeof data.data === "string";
-	if (data.type === "reference") return "reference" in data && data.reference !== null && typeof data.reference === "object" && Object.values(data.reference).every((value) => typeof value === "string");
-	if (data.type === "text") return "text" in data && typeof data.text === "string";
-	if (data.type === "url") return "url" in data && typeof data.url === "string";
-	return false;
+function queueRuntimeInput(runtimeInput, input) {
+	runtimeInput.queue.push(input);
 }
 function runtimeInputClosedError(reason) {
 	return /* @__PURE__ */ new Error(`session.steer() cannot be used after ${reason}`);
 }
 //#endregion
-export { addRuntimeInput, closeRuntimeInput, createRuntimeInputState, normalizeAgentInput, shiftRuntimeInput };
+export { addSteeringInput, closeRuntimeInput, createRuntimeInputState, queueRuntimeInput, shiftRuntimeInput, withRuntimeInputWindow };
 
 //# sourceMappingURL=runtime-input.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"runtime-input.js","names":[],"sources":["../../src/session/runtime-input.ts"],"sourcesContent":["import type {\n  RuntimeInput,\n  UserMessage,\n  UserMessageContentPart,\n} from \"./events\";\nimport type { AgentInput, UserInput } from \"./input\";\n\nexport type RuntimeInputPlacement = RuntimeInput[\"placement\"];\n\nexport interface QueuedRuntimeInput {\n  readonly input: UserInput;\n  readonly placement: RuntimeInputPlacement;\n}\n\nexport interface RuntimeInputState {\n  closedReason?: string;\n  pending: Promise<void>;\n  placement?: RuntimeInputPlacement;\n  readonly queue: QueuedRuntimeInput[];\n  steerPlacement?: RuntimeInputPlacement;\n}\n\nexport function createRuntimeInputState(): RuntimeInputState {\n  return {\n    pending: Promise.resolve(),\n    queue: [],\n  };\n}\n\nexport function addRuntimeInput(\n  runtimeInput: RuntimeInputState,\n  input: AgentInput\n): Promise<void> {\n  const next = runtimeInput.pending.then(() => {\n    if (runtimeInput.closedReason) {\n      throw runtimeInputClosedError(runtimeInput.closedReason);\n    }\n\n    runtimeInput.queue.push({\n      input: normalizeAgentInput(input),\n      placement:\n        runtimeInput.steerPlacement ?? runtimeInput.placement ?? \"step-end\",\n    });\n  });\n  runtimeInput.pending = next.catch(() => undefined);\n  return next;\n}\n\nexport function closeRuntimeInput(\n  runtimeInput: RuntimeInputState | undefined,\n  reason = \"the run reached a terminal state\"\n): void {\n  if (!runtimeInput?.closedReason && runtimeInput) {\n    runtimeInput.closedReason = reason;\n    runtimeInput.placement = undefined;\n  }\n}\n\nexport function shiftRuntimeInput(\n  runtimeInput: RuntimeInputState,\n  placement: RuntimeInputPlacement\n): QueuedRuntimeInput | undefined {\n  const index = runtimeInput.queue.findIndex(\n    (input) => input.placement === placement\n  );\n  if (index === -1) {\n    return;\n  }\n\n  return runtimeInput.queue.splice(index, 1)[0];\n}\n\nexport function normalizeAgentInput(input: AgentInput): UserInput {\n  if (typeof input === \"string\") {\n    return {\n      type: \"user-text\",\n      text: input,\n    };\n  }\n\n  if (isStringArrayInput(input)) {\n    return {\n      type: \"user-text\",\n      text: structuredClone(input) as readonly string[],\n    };\n  }\n\n  if (isArrayInput(input)) {\n    assertUserMessageContent(input);\n    return {\n      type: \"user-message\",\n      content: structuredClone(input) as readonly UserMessageContentPart[],\n    };\n  }\n\n  if (isUserMessage(input)) {\n    assertUserMessageContent(input.content);\n    assertUserMessageMetadata(input.metadata);\n  }\n\n  return structuredClone(input);\n}\n\nfunction isStringArrayInput(input: AgentInput): input is readonly string[] {\n  return isArrayInput(input) && input.every((part) => typeof part === \"string\");\n}\n\nfunction isArrayInput(\n  input: AgentInput\n): input is readonly string[] | readonly UserMessageContentPart[] {\n  return Array.isArray(input);\n}\n\nfunction isUserMessage(input: UserInput): input is UserMessage {\n  return input.type === \"user-message\";\n}\n\nfunction assertUserMessageContent(\n  input: readonly unknown[]\n): asserts input is readonly UserMessageContentPart[] {\n  for (const part of input) {\n    if (!isUserMessageContentPart(part)) {\n      throw new TypeError(\n        'Agent input content parts must be { type: \"text\", text }, { type: \"image\", image }, or { type: \"file\", data, mediaType }.'\n      );\n    }\n  }\n}\n\nfunction assertUserMessageMetadata(metadata: unknown): void {\n  if (\n    metadata !== undefined &&\n    (metadata === null ||\n      typeof metadata !== \"object\" ||\n      Array.isArray(metadata))\n  ) {\n    throw new TypeError(\n      \"Agent input metadata must be an object when provided.\"\n    );\n  }\n}\n\nfunction isUserMessageContentPart(\n  part: unknown\n): part is UserMessageContentPart {\n  if (part === null || typeof part !== \"object\" || !(\"type\" in part)) {\n    return false;\n  }\n\n  if (part.type === \"text\") {\n    return \"text\" in part && typeof part.text === \"string\";\n  }\n\n  if (part.type === \"image\") {\n    return (\n      \"image\" in part &&\n      typeof part.image === \"string\" &&\n      (!(\"mediaType\" in part) || typeof part.mediaType === \"string\")\n    );\n  }\n\n  if (part.type === \"file\") {\n    return (\n      \"data\" in part &&\n      isUserMessageFileData(part.data) &&\n      \"mediaType\" in part &&\n      typeof part.mediaType === \"string\" &&\n      (!(\"filename\" in part) || typeof part.filename === \"string\")\n    );\n  }\n\n  return false;\n}\n\nfunction isUserMessageFileData(data: unknown): boolean {\n  if (typeof data === \"string\") {\n    return true;\n  }\n\n  if (data === null || typeof data !== \"object\" || !(\"type\" in data)) {\n    return false;\n  }\n\n  if (data.type === \"data\") {\n    return \"data\" in data && typeof data.data === \"string\";\n  }\n\n  if (data.type === \"reference\") {\n    return (\n      \"reference\" in data &&\n      data.reference !== null &&\n      typeof data.reference === \"object\" &&\n      Object.values(data.reference).every((value) => typeof value === \"string\")\n    );\n  }\n\n  if (data.type === \"text\") {\n    return \"text\" in data && typeof data.text === \"string\";\n  }\n\n  if (data.type === \"url\") {\n    return \"url\" in data && typeof data.url === \"string\";\n  }\n\n  return false;\n}\n\nfunction runtimeInputClosedError(reason: string): Error {\n  return new Error(`session.steer() cannot be used after ${reason}`);\n}\n"],"mappings":";AAsBA,SAAgB,0BAA6C;CAC3D,OAAO;EACL,SAAS,QAAQ,QAAQ;EACzB,OAAO,CAAC;CACV;AACF;AAEA,SAAgB,gBACd,cACA,OACe;CACf,MAAM,OAAO,aAAa,QAAQ,WAAW;EAC3C,IAAI,aAAa,cACf,MAAM,wBAAwB,aAAa,YAAY;EAGzD,aAAa,MAAM,KAAK;GACtB,OAAO,oBAAoB,KAAK;GAChC,WACE,aAAa,kBAAkB,aAAa,aAAa;EAC7D,CAAC;CACH,CAAC;CACD,aAAa,UAAU,KAAK,YAAY,KAAA,CAAS;CACjD,OAAO;AACT;AAEA,SAAgB,kBACd,cACA,SAAS,oCACH;CACN,IAAI,CAAC,cAAc,gBAAgB,cAAc;EAC/C,aAAa,eAAe;EAC5B,aAAa,YAAY,KAAA;CAC3B;AACF;AAEA,SAAgB,kBACd,cACA,WACgC;CAChC,MAAM,QAAQ,aAAa,MAAM,WAC9B,UAAU,MAAM,cAAc,SACjC;CACA,IAAI,UAAU,IACZ;CAGF,OAAO,aAAa,MAAM,OAAO,OAAO,CAAC,EAAE;AAC7C;AAEA,SAAgB,oBAAoB,OAA8B;CAChE,IAAI,OAAO,UAAU,UACnB,OAAO;EACL,MAAM;EACN,MAAM;CACR;CAGF,IAAI,mBAAmB,KAAK,GAC1B,OAAO;EACL,MAAM;EACN,MAAM,gBAAgB,KAAK;CAC7B;CAGF,IAAI,aAAa,KAAK,GAAG;EACvB,yBAAyB,KAAK;EAC9B,OAAO;GACL,MAAM;GACN,SAAS,gBAAgB,KAAK;EAChC;CACF;CAEA,IAAI,cAAc,KAAK,GAAG;EACxB,yBAAyB,MAAM,OAAO;EACtC,0BAA0B,MAAM,QAAQ;CAC1C;CAEA,OAAO,gBAAgB,KAAK;AAC9B;AAEA,SAAS,mBAAmB,OAA+C;CACzE,OAAO,aAAa,KAAK,KAAK,MAAM,OAAO,SAAS,OAAO,SAAS,QAAQ;AAC9E;AAEA,SAAS,aACP,OACgE;CAChE,OAAO,MAAM,QAAQ,KAAK;AAC5B;AAEA,SAAS,cAAc,OAAwC;CAC7D,OAAO,MAAM,SAAS;AACxB;AAEA,SAAS,yBACP,OACoD;CACpD,KAAK,MAAM,QAAQ,OACjB,IAAI,CAAC,yBAAyB,IAAI,GAChC,MAAM,IAAI,UACR,iIACF;AAGN;AAEA,SAAS,0BAA0B,UAAyB;CAC1D,IACE,aAAa,KAAA,MACZ,aAAa,QACZ,OAAO,aAAa,YACpB,MAAM,QAAQ,QAAQ,IAExB,MAAM,IAAI,UACR,uDACF;AAEJ;AAEA,SAAS,yBACP,MACgC;CAChC,IAAI,SAAS,QAAQ,OAAO,SAAS,YAAY,EAAE,UAAU,OAC3D,OAAO;CAGT,IAAI,KAAK,SAAS,QAChB,OAAO,UAAU,QAAQ,OAAO,KAAK,SAAS;CAGhD,IAAI,KAAK,SAAS,SAChB,OACE,WAAW,QACX,OAAO,KAAK,UAAU,aACrB,EAAE,eAAe,SAAS,OAAO,KAAK,cAAc;CAIzD,IAAI,KAAK,SAAS,QAChB,OACE,UAAU,QACV,sBAAsB,KAAK,IAAI,KAC/B,eAAe,QACf,OAAO,KAAK,cAAc,aACzB,EAAE,cAAc,SAAS,OAAO,KAAK,aAAa;CAIvD,OAAO;AACT;AAEA,SAAS,sBAAsB,MAAwB;CACrD,IAAI,OAAO,SAAS,UAClB,OAAO;CAGT,IAAI,SAAS,QAAQ,OAAO,SAAS,YAAY,EAAE,UAAU,OAC3D,OAAO;CAGT,IAAI,KAAK,SAAS,QAChB,OAAO,UAAU,QAAQ,OAAO,KAAK,SAAS;CAGhD,IAAI,KAAK,SAAS,aAChB,OACE,eAAe,QACf,KAAK,cAAc,QACnB,OAAO,KAAK,cAAc,YAC1B,OAAO,OAAO,KAAK,SAAS,EAAE,OAAO,UAAU,OAAO,UAAU,QAAQ;CAI5E,IAAI,KAAK,SAAS,QAChB,OAAO,UAAU,QAAQ,OAAO,KAAK,SAAS;CAGhD,IAAI,KAAK,SAAS,OAChB,OAAO,SAAS,QAAQ,OAAO,KAAK,QAAQ;CAG9C,OAAO;AACT;AAEA,SAAS,wBAAwB,QAAuB;CACtD,uBAAO,IAAI,MAAM,wCAAwC,QAAQ;AACnE"}
+{"version":3,"file":"runtime-input.js","names":[],"sources":["../../src/session/runtime-input.ts"],"sourcesContent":["import type { AgentEvent, RuntimeInput } from \"./events\";\nimport type { AgentInput, UserInput } from \"./input\";\nimport { normalizeAgentInput } from \"./input-normalization\";\nimport type { BufferedAgentRun } from \"./run\";\n\nexport type RuntimeInputPlacement = RuntimeInput[\"placement\"];\n\nexport interface QueuedRuntimeInput {\n  readonly input: UserInput;\n  readonly placement: RuntimeInputPlacement;\n}\n\nexport interface RuntimeInputState {\n  closedReason?: string;\n  pending: Promise<void>;\n  placement?: RuntimeInputPlacement;\n  readonly queue: QueuedRuntimeInput[];\n  steerPlacement?: RuntimeInputPlacement;\n}\n\nexport interface QueuedInput {\n  readonly initialEvents: AgentEvent[];\n  readonly input?: UserInput;\n  readonly preUserRuntimeInputs: QueuedRuntimeInput[];\n  readonly run: BufferedAgentRun;\n  readonly runtimeInput: RuntimeInputState;\n}\n\nexport function createRuntimeInputState(\n  queue: QueuedRuntimeInput[]\n): RuntimeInputState {\n  return {\n    pending: Promise.resolve(),\n    queue,\n  };\n}\n\nexport function addSteeringInput(\n  runtimeInput: RuntimeInputState,\n  input: AgentInput\n): Promise<void> {\n  const next = runtimeInput.pending.then(() => {\n    if (runtimeInput.closedReason) {\n      throw runtimeInputClosedError(runtimeInput.closedReason);\n    }\n\n    queueRuntimeInput(runtimeInput, {\n      input: normalizeAgentInput(input),\n      placement:\n        runtimeInput.steerPlacement ?? runtimeInput.placement ?? \"step-end\",\n    });\n  });\n  runtimeInput.pending = next.catch(() => undefined);\n  return next;\n}\n\nexport function closeRuntimeInput(\n  runtimeInput: RuntimeInputState | undefined,\n  reason = \"the run reached a terminal state\"\n): void {\n  if (runtimeInput && !runtimeInput.closedReason) {\n    runtimeInput.closedReason = reason;\n    runtimeInput.placement = undefined;\n  }\n}\n\nexport async function withRuntimeInputWindow<T>(\n  runtimeInput: RuntimeInputState,\n  placement: RuntimeInputPlacement,\n  callback: () => Promise<T>\n): Promise<T> {\n  const previousSteerPlacement = runtimeInput.steerPlacement;\n  runtimeInput.placement = placement;\n  runtimeInput.steerPlacement = placement;\n  try {\n    return await callback();\n  } finally {\n    runtimeInput.placement = undefined;\n    runtimeInput.steerPlacement = previousSteerPlacement;\n  }\n}\n\nexport async function withSteeringPlacement<T>(\n  runtimeInput: RuntimeInputState,\n  placement: RuntimeInputPlacement,\n  callback: () => Promise<T>\n): Promise<T> {\n  const previousSteerPlacement = runtimeInput.steerPlacement;\n  runtimeInput.steerPlacement = placement;\n  try {\n    return await callback();\n  } finally {\n    runtimeInput.steerPlacement = previousSteerPlacement;\n  }\n}\n\nexport function shiftRuntimeInput(\n  runtimeInput: RuntimeInputState,\n  placement: RuntimeInputPlacement\n): QueuedRuntimeInput | undefined {\n  const index = runtimeInput.queue.findIndex(\n    (input) => input.placement === placement\n  );\n  if (index === -1) {\n    return;\n  }\n\n  return runtimeInput.queue.splice(index, 1)[0];\n}\n\nexport function queueRuntimeInput(\n  runtimeInput: RuntimeInputState,\n  input: QueuedRuntimeInput\n): void {\n  runtimeInput.queue.push(input);\n}\n\nfunction runtimeInputClosedError(reason: string): Error {\n  return new Error(`session.steer() cannot be used after ${reason}`);\n}\n"],"mappings":";;AA4BA,SAAgB,wBACd,OACmB;CACnB,OAAO;EACL,SAAS,QAAQ,QAAQ;EACzB;CACF;AACF;AAEA,SAAgB,iBACd,cACA,OACe;CACf,MAAM,OAAO,aAAa,QAAQ,WAAW;EAC3C,IAAI,aAAa,cACf,MAAM,wBAAwB,aAAa,YAAY;EAGzD,kBAAkB,cAAc;GAC9B,OAAO,oBAAoB,KAAK;GAChC,WACE,aAAa,kBAAkB,aAAa,aAAa;EAC7D,CAAC;CACH,CAAC;CACD,aAAa,UAAU,KAAK,YAAY,KAAA,CAAS;CACjD,OAAO;AACT;AAEA,SAAgB,kBACd,cACA,SAAS,oCACH;CACN,IAAI,gBAAgB,CAAC,aAAa,cAAc;EAC9C,aAAa,eAAe;EAC5B,aAAa,YAAY,KAAA;CAC3B;AACF;AAEA,eAAsB,uBACpB,cACA,WACA,UACY;CACZ,MAAM,yBAAyB,aAAa;CAC5C,aAAa,YAAY;CACzB,aAAa,iBAAiB;CAC9B,IAAI;EACF,OAAO,MAAM,SAAS;CACxB,UAAU;EACR,aAAa,YAAY,KAAA;EACzB,aAAa,iBAAiB;CAChC;AACF;AAgBA,SAAgB,kBACd,cACA,WACgC;CAChC,MAAM,QAAQ,aAAa,MAAM,WAC9B,UAAU,MAAM,cAAc,SACjC;CACA,IAAI,UAAU,IACZ;CAGF,OAAO,aAAa,MAAM,OAAO,OAAO,CAAC,EAAE;AAC7C;AAEA,SAAgB,kBACd,cACA,OACM;CACN,aAAa,MAAM,KAAK,KAAK;AAC/B;AAEA,SAAS,wBAAwB,QAAuB;CACtD,uBAAO,IAAI,MAAM,wCAAwC,QAAQ;AACnE"}

package/dist/session/session-errors.js

@@ -0,0 +1,18 @@
+//#region src/session/session-errors.ts
+function errorMessage(error) {
+	if (error instanceof Error) return error.message;
+	return String(error);
+}
+function sessionKilledError() {
+	return /* @__PURE__ */ new Error("Session killed");
+}
+function sessionDeleteInProgressError() {
+	return /* @__PURE__ */ new Error("Session delete in progress");
+}
+function sessionTerminalError(killed) {
+	return killed ? sessionKilledError() : sessionDeleteInProgressError();
+}
+//#endregion
+export { errorMessage, sessionKilledError, sessionTerminalError };
+
+//# sourceMappingURL=session-errors.js.map

package/dist/session/session-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-errors.js","names":[],"sources":["../../src/session/session-errors.ts"],"sourcesContent":["export function errorMessage(error: unknown): string {\n  if (error instanceof Error) {\n    return error.message;\n  }\n\n  return String(error);\n}\n\nexport function sessionKilledError(): Error {\n  return new Error(\"Session killed\");\n}\n\nexport function sessionDeleteInProgressError(): Error {\n  return new Error(\"Session delete in progress\");\n}\n\nexport function sessionTerminalError(killed: boolean): Error {\n  return killed ? sessionKilledError() : sessionDeleteInProgressError();\n}\n"],"mappings":";AAAA,SAAgB,aAAa,OAAwB;CACnD,IAAI,iBAAiB,OACnB,OAAO,MAAM;CAGf,OAAO,OAAO,KAAK;AACrB;AAEA,SAAgB,qBAA4B;CAC1C,uBAAO,IAAI,MAAM,gBAAgB;AACnC;AAEA,SAAgB,+BAAsC;CACpD,uBAAO,IAAI,MAAM,4BAA4B;AAC/C;AAEA,SAAgB,qBAAqB,QAAwB;CAC3D,OAAO,SAAS,mBAAmB,IAAI,6BAA6B;AACtE"}

package/dist/session/session-events.js

@@ -0,0 +1,59 @@
+import { runEventPlugins } from "../plugins.js";
+//#region src/session/session-events.ts
+var SessionEventDispatcher = class {
+	#history;
+	#observerEventBuffer;
+	#plugins;
+	#signal;
+	constructor(options) {
+		this.#history = options.history;
+		this.#plugins = options.plugins;
+		this.#signal = options.signal;
+	}
+	async captureObserverEvents(run, callback) {
+		const previousBuffer = this.#observerEventBuffer;
+		const buffer = [];
+		this.#observerEventBuffer = buffer;
+		try {
+			return {
+				events: buffer,
+				release: () => {
+					if (this.#observerEventBuffer === buffer) this.#observerEventBuffer = previousBuffer;
+				},
+				value: await callback()
+			};
+		} catch (error) {
+			for (const event of buffer.splice(0)) await this.emitRunEvent(run, event);
+			this.#observerEventBuffer = previousBuffer;
+			throw error;
+		}
+	}
+	emitObserverEvent(activeRun, event) {
+		const observerEventBuffer = this.#observerEventBuffer;
+		if (observerEventBuffer) {
+			observerEventBuffer.push(structuredClone(event));
+			return Promise.resolve();
+		}
+		if (!activeRun) return Promise.resolve();
+		return this.emitRunEvent(activeRun, event);
+	}
+	async emitRunBoundaryEvent(run, event) {
+		await this.#runPlugins(event);
+		await run.emitBoundary(event);
+	}
+	async emitRunEvent(run, event) {
+		await this.#runPlugins(event);
+		run.emit(event);
+	}
+	#runPlugins(event) {
+		return runEventPlugins(this.#plugins, {
+			event,
+			history: this.#history(),
+			signal: this.#signal()
+		});
+	}
+};
+//#endregion
+export { SessionEventDispatcher };
+
+//# sourceMappingURL=session-events.js.map

package/dist/session/session-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-events.js","names":["#history","#plugins","#signal","#observerEventBuffer","#runPlugins"],"sources":["../../src/session/session-events.ts"],"sourcesContent":["import type { RuntimeLlmContext } from \"../llm\";\nimport { type AgentPlugin, runEventPlugins } from \"../plugins\";\nimport type { AgentEvent } from \"./events\";\nimport type { BufferedAgentRun } from \"./run\";\n\ninterface SessionEventDispatcherOptions {\n  readonly history: () => RuntimeLlmContext[\"history\"];\n  readonly plugins: readonly AgentPlugin[];\n  readonly signal: () => AbortSignal | undefined;\n}\n\nexport class SessionEventDispatcher {\n  readonly #history: () => RuntimeLlmContext[\"history\"];\n  #observerEventBuffer?: AgentEvent[];\n  readonly #plugins: readonly AgentPlugin[];\n  readonly #signal: () => AbortSignal | undefined;\n\n  constructor(options: SessionEventDispatcherOptions) {\n    this.#history = options.history;\n    this.#plugins = options.plugins;\n    this.#signal = options.signal;\n  }\n\n  async captureObserverEvents<T>(\n    run: BufferedAgentRun,\n    callback: () => Promise<T>\n  ): Promise<{\n    readonly events: AgentEvent[];\n    readonly release: () => void;\n    readonly value: T;\n  }> {\n    const previousBuffer = this.#observerEventBuffer;\n    const buffer: AgentEvent[] = [];\n    this.#observerEventBuffer = buffer;\n    try {\n      const value = await callback();\n      return {\n        events: buffer,\n        release: () => {\n          if (this.#observerEventBuffer === buffer) {\n            this.#observerEventBuffer = previousBuffer;\n          }\n        },\n        value,\n      };\n    } catch (error) {\n      for (const event of buffer.splice(0)) {\n        await this.emitRunEvent(run, event);\n      }\n      this.#observerEventBuffer = previousBuffer;\n      throw error;\n    }\n  }\n\n  emitObserverEvent(\n    activeRun: BufferedAgentRun | undefined,\n    event: AgentEvent\n  ): Promise<void> {\n    const observerEventBuffer = this.#observerEventBuffer;\n    if (observerEventBuffer) {\n      observerEventBuffer.push(structuredClone(event));\n      return Promise.resolve();\n    }\n\n    if (!activeRun) {\n      return Promise.resolve();\n    }\n\n    return this.emitRunEvent(activeRun, event);\n  }\n\n  async emitRunBoundaryEvent(\n    run: BufferedAgentRun,\n    event: AgentEvent\n  ): Promise<void> {\n    await this.#runPlugins(event);\n    await run.emitBoundary(event);\n  }\n\n  async emitRunEvent(run: BufferedAgentRun, event: AgentEvent): Promise<void> {\n    await this.#runPlugins(event);\n    run.emit(event);\n  }\n\n  #runPlugins(event: AgentEvent): Promise<void> {\n    return runEventPlugins(this.#plugins, {\n      event,\n      history: this.#history(),\n      signal: this.#signal(),\n    });\n  }\n}\n"],"mappings":";;AAWA,IAAa,yBAAb,MAAoC;CAClC;CACA;CACA;CACA;CAEA,YAAY,SAAwC;EAClD,KAAKA,WAAW,QAAQ;EACxB,KAAKC,WAAW,QAAQ;EACxB,KAAKC,UAAU,QAAQ;CACzB;CAEA,MAAM,sBACJ,KACA,UAKC;EACD,MAAM,iBAAiB,KAAKC;EAC5B,MAAM,SAAuB,CAAC;EAC9B,KAAKA,uBAAuB;EAC5B,IAAI;GAEF,OAAO;IACL,QAAQ;IACR,eAAe;KACb,IAAI,KAAKA,yBAAyB,QAChC,KAAKA,uBAAuB;IAEhC;IACA,OAAA,MARkB,SAAS;GAS7B;EACF,SAAS,OAAO;GACd,KAAK,MAAM,SAAS,OAAO,OAAO,CAAC,GACjC,MAAM,KAAK,aAAa,KAAK,KAAK;GAEpC,KAAKA,uBAAuB;GAC5B,MAAM;EACR;CACF;CAEA,kBACE,WACA,OACe;EACf,MAAM,sBAAsB,KAAKA;EACjC,IAAI,qBAAqB;GACvB,oBAAoB,KAAK,gBAAgB,KAAK,CAAC;GAC/C,OAAO,QAAQ,QAAQ;EACzB;EAEA,IAAI,CAAC,WACH,OAAO,QAAQ,QAAQ;EAGzB,OAAO,KAAK,aAAa,WAAW,KAAK;CAC3C;CAEA,MAAM,qBACJ,KACA,OACe;EACf,MAAM,KAAKC,YAAY,KAAK;EAC5B,MAAM,IAAI,aAAa,KAAK;CAC9B;CAEA,MAAM,aAAa,KAAuB,OAAkC;EAC1E,MAAM,KAAKA,YAAY,KAAK;EAC5B,IAAI,KAAK,KAAK;CAChB;CAEA,YAAY,OAAkC;EAC5C,OAAO,gBAAgB,KAAKH,UAAU;GACpC;GACA,SAAS,KAAKD,SAAS;GACvB,QAAQ,KAAKE,QAAQ;EACvB,CAAC;CACH;AACF"}

package/dist/session/session-execution.js

@@ -0,0 +1,88 @@
+import { persistedToolExecutionCheckpoint } from "../llm-tool-execution.js";
+//#region src/session/session-execution.ts
+const maxCheckpointWriteAttempts = 5;
+var SessionExecutionCheckpointError = class extends Error {
+	constructor(runId, expectedVersion, currentVersion) {
+		super(`Session execution run ${runId} checkpoint conflict: expected ${expectedVersion}, got ${currentVersion}`);
+		this.name = "SessionExecutionCheckpointError";
+	}
+};
+async function startSessionExecutionRun({ executionHost, sessionKey, state, turnId }) {
+	if (!executionHost) return;
+	const runId = `turn:${sessionKey}:${turnId}`;
+	const run = {
+		checkpointVersion: 0,
+		dedupeKey: runId,
+		kind: "user-turn",
+		rootRunId: runId,
+		runId,
+		sessionKey,
+		status: "running"
+	};
+	await executionHost.store.runs.create(run);
+	return {
+		complete: (status) => completeSessionExecutionRun({
+			executionHost,
+			runId,
+			status
+		}),
+		runId,
+		toolExecution: {
+			attempt: 1,
+			afterTool: (checkpoint) => appendToolExecutionCheckpoint({
+				executionHost,
+				phase: "after-tool",
+				runId,
+				state,
+				toolCall: checkpoint
+			}),
+			beforeTool: async (checkpoint) => {
+				await appendToolExecutionCheckpoint({
+					executionHost,
+					phase: "before-tool",
+					runId,
+					state,
+					toolCall: checkpoint
+				});
+			},
+			runId
+		}
+	};
+}
+async function appendToolExecutionCheckpoint({ executionHost, phase, runId, state, toolCall }) {
+	let lastConflict;
+	for (let attempt = 0; attempt < maxCheckpointWriteAttempts; attempt += 1) {
+		const run = await executionHost.store.runs.get(runId);
+		if (!run) throw new Error(`Session execution run ${runId} is missing.`);
+		const result = await executionHost.store.checkpoints.append({
+			checkpointId: crypto.randomUUID(),
+			pendingToolCall: persistedToolExecutionCheckpoint(toolCall),
+			phase,
+			runId,
+			runtimeState: {
+				toolCallId: toolCall.toolCallId,
+				toolName: toolCall.toolName
+			},
+			sessionSnapshot: { history: state.modelSnapshot() },
+			version: run.checkpointVersion + 1
+		}, { expectedVersion: run.checkpointVersion });
+		if (result.ok) return;
+		lastConflict = {
+			current: result.currentVersion,
+			expected: run.checkpointVersion
+		};
+	}
+	throw new SessionExecutionCheckpointError(runId, lastConflict?.expected ?? 0, lastConflict?.current ?? 0);
+}
+async function completeSessionExecutionRun({ executionHost, runId, status }) {
+	const run = await executionHost.store.runs.get(runId);
+	if (!run) return;
+	await executionHost.store.runs.update({
+		...run,
+		status
+	});
+}
+//#endregion
+export { startSessionExecutionRun };
+
+//# sourceMappingURL=session-execution.js.map

package/dist/session/session-execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-execution.js","names":[],"sources":["../../src/session/session-execution.ts"],"sourcesContent":["import type {\n  CheckpointPhase,\n  ExecutionHost,\n  RunRecord,\n  RunStatus,\n} from \"../execution/types\";\nimport type {\n  RuntimeToolExecutionCheckpoint,\n  RuntimeToolExecutionContext,\n} from \"../llm\";\nimport { persistedToolExecutionCheckpoint } from \"../llm-tool-execution\";\nimport type { SessionState } from \"./session-state\";\n\nconst maxCheckpointWriteAttempts = 5;\n\nexport interface SessionExecutionOptions {\n  readonly executionHost?: ExecutionHost;\n}\n\nexport interface SessionExecutionRun {\n  complete(status: SessionExecutionTerminalStatus): Promise<void>;\n  readonly runId: string;\n  readonly toolExecution: RuntimeToolExecutionContext;\n}\n\nexport type SessionExecutionTerminalStatus = Extract<\n  RunStatus,\n  \"cancelled\" | \"completed\" | \"error\" | \"needs-recovery\"\n>;\n\nexport class SessionExecutionCheckpointError extends Error {\n  constructor(runId: string, expectedVersion: number, currentVersion: number) {\n    super(\n      `Session execution run ${runId} checkpoint conflict: expected ${expectedVersion}, got ${currentVersion}`\n    );\n    this.name = \"SessionExecutionCheckpointError\";\n  }\n}\n\nexport async function startSessionExecutionRun({\n  executionHost,\n  sessionKey,\n  state,\n  turnId,\n}: {\n  readonly executionHost?: ExecutionHost;\n  readonly sessionKey: string;\n  readonly state: SessionState;\n  readonly turnId: string;\n}): Promise<SessionExecutionRun | undefined> {\n  if (!executionHost) {\n    return;\n  }\n\n  const runId = `turn:${sessionKey}:${turnId}`;\n  const run: RunRecord = {\n    checkpointVersion: 0,\n    dedupeKey: runId,\n    kind: \"user-turn\",\n    rootRunId: runId,\n    runId,\n    sessionKey,\n    status: \"running\",\n  };\n  await executionHost.store.runs.create(run);\n\n  return {\n    complete: (status) =>\n      completeSessionExecutionRun({ executionHost, runId, status }),\n    runId,\n    toolExecution: {\n      attempt: 1,\n      afterTool: (checkpoint) =>\n        appendToolExecutionCheckpoint({\n          executionHost,\n          phase: \"after-tool\",\n          runId,\n          state,\n          toolCall: checkpoint,\n        }),\n      beforeTool: async (checkpoint) => {\n        await appendToolExecutionCheckpoint({\n          executionHost,\n          phase: \"before-tool\",\n          runId,\n          state,\n          toolCall: checkpoint,\n        });\n        return;\n      },\n      runId,\n    },\n  };\n}\n\nasync function appendToolExecutionCheckpoint({\n  executionHost,\n  phase,\n  runId,\n  state,\n  toolCall,\n}: {\n  readonly executionHost: ExecutionHost;\n  readonly phase: Extract<CheckpointPhase, \"after-tool\" | \"before-tool\">;\n  readonly runId: string;\n  readonly state: SessionState;\n  readonly toolCall: RuntimeToolExecutionCheckpoint & {\n    readonly output?: unknown;\n  };\n}): Promise<void> {\n  let lastConflict:\n    | { readonly current: number; readonly expected: number }\n    | undefined;\n  for (let attempt = 0; attempt < maxCheckpointWriteAttempts; attempt += 1) {\n    const run = await executionHost.store.runs.get(runId);\n    if (!run) {\n      throw new Error(`Session execution run ${runId} is missing.`);\n    }\n\n    const result = await executionHost.store.checkpoints.append(\n      {\n        checkpointId: crypto.randomUUID(),\n        pendingToolCall: persistedToolExecutionCheckpoint(toolCall),\n        phase,\n        runId,\n        runtimeState: {\n          toolCallId: toolCall.toolCallId,\n          toolName: toolCall.toolName,\n        },\n        sessionSnapshot: { history: state.modelSnapshot() },\n        version: run.checkpointVersion + 1,\n      },\n      { expectedVersion: run.checkpointVersion }\n    );\n\n    if (result.ok) {\n      return;\n    }\n\n    lastConflict = {\n      current: result.currentVersion,\n      expected: run.checkpointVersion,\n    };\n  }\n\n  throw new SessionExecutionCheckpointError(\n    runId,\n    lastConflict?.expected ?? 0,\n    lastConflict?.current ?? 0\n  );\n}\n\nasync function completeSessionExecutionRun({\n  executionHost,\n  runId,\n  status,\n}: {\n  readonly executionHost: ExecutionHost;\n  readonly runId: string;\n  readonly status: SessionExecutionTerminalStatus;\n}): Promise<void> {\n  const run = await executionHost.store.runs.get(runId);\n  if (!run) {\n    return;\n  }\n\n  await executionHost.store.runs.update({ ...run, status });\n}\n"],"mappings":";;AAaA,MAAM,6BAA6B;AAiBnC,IAAa,kCAAb,cAAqD,MAAM;CACzD,YAAY,OAAe,iBAAyB,gBAAwB;EAC1E,MACE,yBAAyB,MAAM,iCAAiC,gBAAgB,QAAQ,gBAC1F;EACA,KAAK,OAAO;CACd;AACF;AAEA,eAAsB,yBAAyB,EAC7C,eACA,YACA,OACA,UAM2C;CAC3C,IAAI,CAAC,eACH;CAGF,MAAM,QAAQ,QAAQ,WAAW,GAAG;CACpC,MAAM,MAAiB;EACrB,mBAAmB;EACnB,WAAW;EACX,MAAM;EACN,WAAW;EACX;EACA;EACA,QAAQ;CACV;CACA,MAAM,cAAc,MAAM,KAAK,OAAO,GAAG;CAEzC,OAAO;EACL,WAAW,WACT,4BAA4B;GAAE;GAAe;GAAO;EAAO,CAAC;EAC9D;EACA,eAAe;GACb,SAAS;GACT,YAAY,eACV,8BAA8B;IAC5B;IACA,OAAO;IACP;IACA;IACA,UAAU;GACZ,CAAC;GACH,YAAY,OAAO,eAAe;IAChC,MAAM,8BAA8B;KAClC;KACA,OAAO;KACP;KACA;KACA,UAAU;IACZ,CAAC;GAEH;GACA;EACF;CACF;AACF;AAEA,eAAe,8BAA8B,EAC3C,eACA,OACA,OACA,OACA,YASgB;CAChB,IAAI;CAGJ,KAAK,IAAI,UAAU,GAAG,UAAU,4BAA4B,WAAW,GAAG;EACxE,MAAM,MAAM,MAAM,cAAc,MAAM,KAAK,IAAI,KAAK;EACpD,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,yBAAyB,MAAM,aAAa;EAG9D,MAAM,SAAS,MAAM,cAAc,MAAM,YAAY,OACnD;GACE,cAAc,OAAO,WAAW;GAChC,iBAAiB,iCAAiC,QAAQ;GAC1D;GACA;GACA,cAAc;IACZ,YAAY,SAAS;IACrB,UAAU,SAAS;GACrB;GACA,iBAAiB,EAAE,SAAS,MAAM,cAAc,EAAE;GAClD,SAAS,IAAI,oBAAoB;EACnC,GACA,EAAE,iBAAiB,IAAI,kBAAkB,CAC3C;EAEA,IAAI,OAAO,IACT;EAGF,eAAe;GACb,SAAS,OAAO;GAChB,UAAU,IAAI;EAChB;CACF;CAEA,MAAM,IAAI,gCACR,OACA,cAAc,YAAY,GAC1B,cAAc,WAAW,CAC3B;AACF;AAEA,eAAe,4BAA4B,EACzC,eACA,OACA,UAKgB;CAChB,MAAM,MAAM,MAAM,cAAc,MAAM,KAAK,IAAI,KAAK;CACpD,IAAI,CAAC,KACH;CAGF,MAAM,cAAc,MAAM,KAAK,OAAO;EAAE,GAAG;EAAK;CAAO,CAAC;AAC1D"}

package/dist/session/session-kill.js

@@ -0,0 +1,23 @@
+import { closeRuntimeInput } from "./runtime-input.js";
+//#region src/session/session-kill.ts
+function closeKilledRuntimeInputs({ activeRuntimeInput, inputQueue, message, runToClose }) {
+	closeRuntimeInput(activeRuntimeInput, message);
+	runToClose?.emit({
+		type: "turn-error",
+		message
+	});
+	runToClose?.close(void 0, message);
+	while (inputQueue.length > 0) {
+		const item = inputQueue.shift();
+		closeRuntimeInput(item?.runtimeInput, message);
+		item?.run.emit({
+			type: "turn-error",
+			message
+		});
+		item?.run.close(void 0, message);
+	}
+}
+//#endregion
+export { closeKilledRuntimeInputs };
+
+//# sourceMappingURL=session-kill.js.map

package/dist/session/session-kill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-kill.js","names":[],"sources":["../../src/session/session-kill.ts"],"sourcesContent":["import type { BufferedAgentRun } from \"./run\";\nimport {\n  closeRuntimeInput,\n  type QueuedInput,\n  type RuntimeInputState,\n} from \"./runtime-input\";\n\ninterface CloseKilledRuntimeInputsOptions {\n  readonly activeRuntimeInput: RuntimeInputState | undefined;\n  readonly inputQueue: QueuedInput[];\n  readonly message: string;\n  readonly runToClose: BufferedAgentRun | undefined;\n}\n\nexport function closeKilledRuntimeInputs({\n  activeRuntimeInput,\n  inputQueue,\n  message,\n  runToClose,\n}: CloseKilledRuntimeInputsOptions): void {\n  closeRuntimeInput(activeRuntimeInput, message);\n  runToClose?.emit({ type: \"turn-error\", message });\n  runToClose?.close(undefined, message);\n\n  while (inputQueue.length > 0) {\n    const item = inputQueue.shift();\n    closeRuntimeInput(item?.runtimeInput, message);\n    item?.run.emit({ type: \"turn-error\", message });\n    item?.run.close(undefined, message);\n  }\n}\n"],"mappings":";;AAcA,SAAgB,yBAAyB,EACvC,oBACA,YACA,SACA,cACwC;CACxC,kBAAkB,oBAAoB,OAAO;CAC7C,YAAY,KAAK;EAAE,MAAM;EAAc;CAAQ,CAAC;CAChD,YAAY,MAAM,KAAA,GAAW,OAAO;CAEpC,OAAO,WAAW,SAAS,GAAG;EAC5B,MAAM,OAAO,WAAW,MAAM;EAC9B,kBAAkB,MAAM,cAAc,OAAO;EAC7C,MAAM,IAAI,KAAK;GAAE,MAAM;GAAc;EAAQ,CAAC;EAC9C,MAAM,IAAI,MAAM,KAAA,GAAW,OAAO;CACpC;AACF"}

package/dist/session/session-notification.js

@@ -0,0 +1,58 @@
+import { BufferedAgentRun } from "./run.js";
+import { normalizeAgentInput } from "./input-normalization.js";
+import { createRuntimeInputState, queueRuntimeInput } from "./runtime-input.js";
+import { errorMessage } from "./session-errors.js";
+//#region src/session/session-notification.ts
+function queueSessionNotification(input, options, state) {
+	const queuedRuntimeInput = {
+		input: normalizeAgentInput(input),
+		placement: "turn-start"
+	};
+	const observerEvents = cloneObserverEvents(options.observerEvents ?? []);
+	const queuedTurn = state.inputQueue[0];
+	if (queuedTurn) {
+		queuedTurn.initialEvents.push(...observerEvents);
+		queuedTurn.preUserRuntimeInputs.push(queuedRuntimeInput);
+		return queuedTurn.run;
+	}
+	const activeRun = state.activeRun;
+	const runtimeInput = state.activeRuntimeInput;
+	if (runtimeInput && activeRun && !runtimeInput.closedReason) {
+		queueRuntimeInput(runtimeInput, {
+			input: structuredClone(queuedRuntimeInput.input),
+			placement: "step-end"
+		});
+		return activeRun;
+	}
+	if (options.deferWhenUnobserved === true) {
+		state.pendingRuntimeInputs.push(queuedRuntimeInput);
+		const deferredRun = new BufferedAgentRun();
+		deferredRun.close();
+		return deferredRun;
+	}
+	const run = new BufferedAgentRun();
+	state.inputQueue.push({
+		initialEvents: observerEvents,
+		preUserRuntimeInputs: [],
+		run,
+		runtimeInput: createRuntimeInputState([queuedRuntimeInput])
+	});
+	startSessionQueueDrain(run, state.drain);
+	return run;
+}
+function startSessionQueueDrain(run, drain) {
+	drain().catch((error) => {
+		run.emit({
+			type: "turn-error",
+			message: errorMessage(error)
+		});
+		run.close();
+	});
+}
+function cloneObserverEvents(events) {
+	return events.map((event) => structuredClone(event));
+}
+//#endregion
+export { queueSessionNotification, startSessionQueueDrain };
+
+//# sourceMappingURL=session-notification.js.map

package/dist/session/session-notification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-notification.js","names":[],"sources":["../../src/session/session-notification.ts"],"sourcesContent":["import type { AgentEvent } from \"./events\";\nimport type { AgentInput } from \"./input\";\nimport { normalizeAgentInput } from \"./input-normalization\";\nimport { type AgentRun, BufferedAgentRun } from \"./run\";\nimport {\n  createRuntimeInputState,\n  type QueuedInput,\n  type QueuedRuntimeInput,\n  queueRuntimeInput,\n  type RuntimeInputState,\n} from \"./runtime-input\";\nimport { errorMessage } from \"./session-errors\";\n\nexport interface NotifyOptions {\n  readonly deferWhenUnobserved?: boolean;\n  readonly observerEvents?: readonly AgentEvent[];\n}\n\ninterface QueueSessionNotificationOptions {\n  readonly activeRun: BufferedAgentRun | undefined;\n  readonly activeRuntimeInput: RuntimeInputState | undefined;\n  readonly drain: () => Promise<void>;\n  readonly inputQueue: QueuedInput[];\n  readonly pendingRuntimeInputs: QueuedRuntimeInput[];\n}\n\nexport function queueSessionNotification(\n  input: AgentInput,\n  options: NotifyOptions,\n  state: QueueSessionNotificationOptions\n): AgentRun {\n  const queuedRuntimeInput: QueuedRuntimeInput = {\n    input: normalizeAgentInput(input),\n    placement: \"turn-start\",\n  };\n  const observerEvents = cloneObserverEvents(options.observerEvents ?? []);\n  const queuedTurn = state.inputQueue[0];\n  if (queuedTurn) {\n    queuedTurn.initialEvents.push(...observerEvents);\n    queuedTurn.preUserRuntimeInputs.push(queuedRuntimeInput);\n    return queuedTurn.run;\n  }\n\n  const activeRun = state.activeRun;\n  const runtimeInput = state.activeRuntimeInput;\n  if (runtimeInput && activeRun && !runtimeInput.closedReason) {\n    queueRuntimeInput(runtimeInput, {\n      input: structuredClone(queuedRuntimeInput.input),\n      placement: \"step-end\",\n    });\n    return activeRun;\n  }\n\n  if (options.deferWhenUnobserved === true) {\n    state.pendingRuntimeInputs.push(queuedRuntimeInput);\n    const deferredRun = new BufferedAgentRun();\n    deferredRun.close();\n    return deferredRun;\n  }\n\n  const run = new BufferedAgentRun();\n  state.inputQueue.push({\n    initialEvents: observerEvents,\n    preUserRuntimeInputs: [],\n    run,\n    runtimeInput: createRuntimeInputState([queuedRuntimeInput]),\n  });\n  startSessionQueueDrain(run, state.drain);\n  return run;\n}\n\nexport function startSessionQueueDrain(\n  run: BufferedAgentRun,\n  drain: () => Promise<void>\n): void {\n  drain().catch((error: unknown) => {\n    run.emit({ type: \"turn-error\", message: errorMessage(error) });\n    run.close();\n  });\n}\n\nfunction cloneObserverEvents(events: readonly AgentEvent[]): AgentEvent[] {\n  return events.map((event) => structuredClone(event));\n}\n"],"mappings":";;;;;AA0BA,SAAgB,yBACd,OACA,SACA,OACU;CACV,MAAM,qBAAyC;EAC7C,OAAO,oBAAoB,KAAK;EAChC,WAAW;CACb;CACA,MAAM,iBAAiB,oBAAoB,QAAQ,kBAAkB,CAAC,CAAC;CACvE,MAAM,aAAa,MAAM,WAAW;CACpC,IAAI,YAAY;EACd,WAAW,cAAc,KAAK,GAAG,cAAc;EAC/C,WAAW,qBAAqB,KAAK,kBAAkB;EACvD,OAAO,WAAW;CACpB;CAEA,MAAM,YAAY,MAAM;CACxB,MAAM,eAAe,MAAM;CAC3B,IAAI,gBAAgB,aAAa,CAAC,aAAa,cAAc;EAC3D,kBAAkB,cAAc;GAC9B,OAAO,gBAAgB,mBAAmB,KAAK;GAC/C,WAAW;EACb,CAAC;EACD,OAAO;CACT;CAEA,IAAI,QAAQ,wBAAwB,MAAM;EACxC,MAAM,qBAAqB,KAAK,kBAAkB;EAClD,MAAM,cAAc,IAAI,iBAAiB;EACzC,YAAY,MAAM;EAClB,OAAO;CACT;CAEA,MAAM,MAAM,IAAI,iBAAiB;CACjC,MAAM,WAAW,KAAK;EACpB,eAAe;EACf,sBAAsB,CAAC;EACvB;EACA,cAAc,wBAAwB,CAAC,kBAAkB,CAAC;CAC5D,CAAC;CACD,uBAAuB,KAAK,MAAM,KAAK;CACvC,OAAO;AACT;AAEA,SAAgB,uBACd,KACA,OACM;CACN,MAAM,EAAE,OAAO,UAAmB;EAChC,IAAI,KAAK;GAAE,MAAM;GAAc,SAAS,aAAa,KAAK;EAAE,CAAC;EAC7D,IAAI,MAAM;CACZ,CAAC;AACH;AAEA,SAAS,oBAAoB,QAA6C;CACxE,OAAO,OAAO,KAAK,UAAU,gBAAgB,KAAK,CAAC;AACrD"}

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

@@ -0,0 +1,22 @@
+import { shiftRuntimeInput } from "./runtime-input.js";
+//#region src/session/session-runtime-drain.ts
+async function drainRuntimeInput({ emit, placement, runtimeInput, state }) {
+	let added = false;
+	let next = shiftRuntimeInput(runtimeInput, placement);
+	while (next) {
+		added = true;
+		await emit({
+			type: "runtime-input",
+			input: next.input,
+			placement
+		});
+		state.appendUserInput(next.input);
+		await state.commit();
+		next = shiftRuntimeInput(runtimeInput, placement);
+	}
+	return added;
+}
+//#endregion
+export { drainRuntimeInput };
+
+//# sourceMappingURL=session-runtime-drain.js.map

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

@@ -0,0 +1 @@
+{"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-state.js

@@ -0,0 +1,102 @@
+import { ModelMessageHistory } from "./history.js";
+import { decodeStoredSessionSnapshot, encodeSessionSnapshot } from "./snapshot.js";
+//#region src/session/session-state.ts
+var SessionCommitConflictError = class extends Error {
+	constructor(key) {
+		super(`Session ${JSON.stringify(key)} commit conflict`);
+	}
+};
+var SessionState = class {
+	#persistence;
+	#deleteRequested = false;
+	#history = new ModelMessageHistory();
+	#deleted = false;
+	#loadPromise;
+	#loaded = false;
+	#storeVersion;
+	#writeQueue = Promise.resolve();
+	constructor(persistence) {
+		this.#persistence = persistence;
+	}
+	get history() {
+		return this.#history;
+	}
+	async ensureLoaded() {
+		if (this.#deleteRequested || this.#deleted) return;
+		if (this.#loaded) return;
+		this.#loadPromise ??= this.#loadSessionState();
+		try {
+			await this.#loadPromise;
+		} catch (error) {
+			this.#loadPromise = void 0;
+			throw error;
+		}
+	}
+	modelSnapshot() {
+		return this.#history.modelSnapshot();
+	}
+	appendUserInput(input) {
+		this.#history.appendUserInput(input);
+	}
+	rollback(snapshot) {
+		this.#history.rollback(snapshot);
+	}
+	async commit() {
+		if (this.#deleteRequested || this.#deleted) return;
+		const snapshot = this.#history.modelSnapshot();
+		await this.#enqueueWrite(async () => {
+			if (this.#deleteRequested || this.#deleted) return;
+			const result = await this.#persistence.store.commit(this.#persistence.key, { state: encodeSessionSnapshot(snapshot) }, { expectedVersion: this.#storeVersion ?? null });
+			if (!result.ok) {
+				await this.#replaceWithStoredSession();
+				throw new SessionCommitConflictError(this.#persistence.key);
+			}
+			this.#storeVersion = result.version;
+		});
+	}
+	async delete() {
+		if (this.#deleted) return;
+		const previous = {
+			history: this.#history.modelSnapshot(),
+			loaded: this.#loaded,
+			storeVersion: this.#storeVersion
+		};
+		this.#deleteRequested = true;
+		this.#loadPromise = void 0;
+		await this.#enqueueWrite(async () => {
+			try {
+				await this.#persistence.store.delete(this.#persistence.key);
+			} catch (error) {
+				this.#deleteRequested = false;
+				this.#loaded = previous.loaded;
+				this.#storeVersion = previous.storeVersion;
+				this.#history = new ModelMessageHistory(previous.history);
+				throw error;
+			}
+			this.#deleted = true;
+			this.#loadPromise = void 0;
+			this.#loaded = true;
+			this.#storeVersion = void 0;
+			this.#history = new ModelMessageHistory();
+		});
+	}
+	#enqueueWrite(operation) {
+		const next = this.#writeQueue.then(operation, operation);
+		this.#writeQueue = next.catch(() => void 0);
+		return next;
+	}
+	async #loadSessionState() {
+		if (this.#loaded) return;
+		await this.#replaceWithStoredSession();
+		this.#loaded = true;
+	}
+	async #replaceWithStoredSession() {
+		const stored = await this.#persistence.store.load(this.#persistence.key);
+		this.#storeVersion = stored?.version;
+		this.#history = new ModelMessageHistory(decodeStoredSessionSnapshot(stored));
+	}
+};
+//#endregion
+export { SessionCommitConflictError, SessionState };
+
+//# sourceMappingURL=session-state.js.map

package/dist/session/session-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-state.js","names":["#persistence","#history","#deleteRequested","#deleted","#loaded","#loadPromise","#loadSessionState","#enqueueWrite","#storeVersion","#replaceWithStoredSession","#writeQueue"],"sources":["../../src/session/session-state.ts"],"sourcesContent":["import type { ModelMessage } from \"ai\";\nimport { ModelMessageHistory } from \"./history\";\nimport { decodeStoredSessionSnapshot, encodeSessionSnapshot } from \"./snapshot\";\nimport type { SessionStore } from \"./store/types\";\n\nexport interface SessionPersistenceOptions {\n  readonly key: string;\n  readonly store: SessionStore;\n}\n\nexport class SessionCommitConflictError extends Error {\n  constructor(key: string) {\n    super(`Session ${JSON.stringify(key)} commit conflict`);\n  }\n}\n\nexport class SessionState {\n  readonly #persistence: SessionPersistenceOptions;\n  #deleteRequested = false;\n  #history = new ModelMessageHistory();\n  #deleted = false;\n  #loadPromise?: Promise<void>;\n  #loaded = false;\n  #storeVersion: string | undefined;\n  #writeQueue: Promise<void> = Promise.resolve();\n\n  constructor(persistence: SessionPersistenceOptions) {\n    this.#persistence = persistence;\n  }\n\n  get history(): ModelMessageHistory {\n    return this.#history;\n  }\n\n  async ensureLoaded(): Promise<void> {\n    if (this.#deleteRequested || this.#deleted) {\n      return;\n    }\n\n    if (this.#loaded) {\n      return;\n    }\n\n    this.#loadPromise ??= this.#loadSessionState();\n    try {\n      await this.#loadPromise;\n    } catch (error) {\n      this.#loadPromise = undefined;\n      throw error;\n    }\n  }\n\n  modelSnapshot(): ModelMessage[] {\n    return this.#history.modelSnapshot();\n  }\n\n  appendUserInput(\n    input: Parameters<ModelMessageHistory[\"appendUserInput\"]>[0]\n  ) {\n    this.#history.appendUserInput(input);\n  }\n\n  rollback(snapshot: ModelMessage[]): void {\n    this.#history.rollback(snapshot);\n  }\n\n  async commit(): Promise<void> {\n    if (this.#deleteRequested || this.#deleted) {\n      return;\n    }\n\n    const snapshot = this.#history.modelSnapshot();\n    await this.#enqueueWrite(async () => {\n      if (this.#deleteRequested || this.#deleted) {\n        return;\n      }\n\n      const result = await this.#persistence.store.commit(\n        this.#persistence.key,\n        { state: encodeSessionSnapshot(snapshot) },\n        { expectedVersion: this.#storeVersion ?? null }\n      );\n\n      if (!result.ok) {\n        await this.#replaceWithStoredSession();\n        throw new SessionCommitConflictError(this.#persistence.key);\n      }\n\n      this.#storeVersion = result.version;\n    });\n  }\n\n  async delete(): Promise<void> {\n    if (this.#deleted) {\n      return;\n    }\n\n    const previous = {\n      history: this.#history.modelSnapshot(),\n      loaded: this.#loaded,\n      storeVersion: this.#storeVersion,\n    };\n    this.#deleteRequested = true;\n    this.#loadPromise = undefined;\n\n    await this.#enqueueWrite(async () => {\n      try {\n        await this.#persistence.store.delete(this.#persistence.key);\n      } catch (error) {\n        this.#deleteRequested = false;\n        this.#loaded = previous.loaded;\n        this.#storeVersion = previous.storeVersion;\n        this.#history = new ModelMessageHistory(previous.history);\n        throw error;\n      }\n\n      this.#deleted = true;\n      this.#loadPromise = undefined;\n      this.#loaded = true;\n      this.#storeVersion = undefined;\n      this.#history = new ModelMessageHistory();\n    });\n  }\n\n  #enqueueWrite(operation: () => Promise<void>): Promise<void> {\n    const next = this.#writeQueue.then(operation, operation);\n    this.#writeQueue = next.catch(() => undefined);\n    return next;\n  }\n\n  async #loadSessionState(): Promise<void> {\n    if (this.#loaded) {\n      return;\n    }\n\n    await this.#replaceWithStoredSession();\n    this.#loaded = true;\n  }\n\n  async #replaceWithStoredSession(): Promise<void> {\n    const stored = await this.#persistence.store.load(this.#persistence.key);\n    this.#storeVersion = stored?.version;\n    this.#history = new ModelMessageHistory(\n      decodeStoredSessionSnapshot(stored)\n    );\n  }\n}\n"],"mappings":";;;AAUA,IAAa,6BAAb,cAAgD,MAAM;CACpD,YAAY,KAAa;EACvB,MAAM,WAAW,KAAK,UAAU,GAAG,EAAE,iBAAiB;CACxD;AACF;AAEA,IAAa,eAAb,MAA0B;CACxB;CACA,mBAAmB;CACnB,WAAW,IAAI,oBAAoB;CACnC,WAAW;CACX;CACA,UAAU;CACV;CACA,cAA6B,QAAQ,QAAQ;CAE7C,YAAY,aAAwC;EAClD,KAAKA,eAAe;CACtB;CAEA,IAAI,UAA+B;EACjC,OAAO,KAAKC;CACd;CAEA,MAAM,eAA8B;EAClC,IAAI,KAAKC,oBAAoB,KAAKC,UAChC;EAGF,IAAI,KAAKC,SACP;EAGF,KAAKC,iBAAiB,KAAKC,kBAAkB;EAC7C,IAAI;GACF,MAAM,KAAKD;EACb,SAAS,OAAO;GACd,KAAKA,eAAe,KAAA;GACpB,MAAM;EACR;CACF;CAEA,gBAAgC;EAC9B,OAAO,KAAKJ,SAAS,cAAc;CACrC;CAEA,gBACE,OACA;EACA,KAAKA,SAAS,gBAAgB,KAAK;CACrC;CAEA,SAAS,UAAgC;EACvC,KAAKA,SAAS,SAAS,QAAQ;CACjC;CAEA,MAAM,SAAwB;EAC5B,IAAI,KAAKC,oBAAoB,KAAKC,UAChC;EAGF,MAAM,WAAW,KAAKF,SAAS,cAAc;EAC7C,MAAM,KAAKM,cAAc,YAAY;GACnC,IAAI,KAAKL,oBAAoB,KAAKC,UAChC;GAGF,MAAM,SAAS,MAAM,KAAKH,aAAa,MAAM,OAC3C,KAAKA,aAAa,KAClB,EAAE,OAAO,sBAAsB,QAAQ,EAAE,GACzC,EAAE,iBAAiB,KAAKQ,iBAAiB,KAAK,CAChD;GAEA,IAAI,CAAC,OAAO,IAAI;IACd,MAAM,KAAKC,0BAA0B;IACrC,MAAM,IAAI,2BAA2B,KAAKT,aAAa,GAAG;GAC5D;GAEA,KAAKQ,gBAAgB,OAAO;EAC9B,CAAC;CACH;CAEA,MAAM,SAAwB;EAC5B,IAAI,KAAKL,UACP;EAGF,MAAM,WAAW;GACf,SAAS,KAAKF,SAAS,cAAc;GACrC,QAAQ,KAAKG;GACb,cAAc,KAAKI;EACrB;EACA,KAAKN,mBAAmB;EACxB,KAAKG,eAAe,KAAA;EAEpB,MAAM,KAAKE,cAAc,YAAY;GACnC,IAAI;IACF,MAAM,KAAKP,aAAa,MAAM,OAAO,KAAKA,aAAa,GAAG;GAC5D,SAAS,OAAO;IACd,KAAKE,mBAAmB;IACxB,KAAKE,UAAU,SAAS;IACxB,KAAKI,gBAAgB,SAAS;IAC9B,KAAKP,WAAW,IAAI,oBAAoB,SAAS,OAAO;IACxD,MAAM;GACR;GAEA,KAAKE,WAAW;GAChB,KAAKE,eAAe,KAAA;GACpB,KAAKD,UAAU;GACf,KAAKI,gBAAgB,KAAA;GACrB,KAAKP,WAAW,IAAI,oBAAoB;EAC1C,CAAC;CACH;CAEA,cAAc,WAA+C;EAC3D,MAAM,OAAO,KAAKS,YAAY,KAAK,WAAW,SAAS;EACvD,KAAKA,cAAc,KAAK,YAAY,KAAA,CAAS;EAC7C,OAAO;CACT;CAEA,MAAMJ,oBAAmC;EACvC,IAAI,KAAKF,SACP;EAGF,MAAM,KAAKK,0BAA0B;EACrC,KAAKL,UAAU;CACjB;CAEA,MAAMK,4BAA2C;EAC/C,MAAM,SAAS,MAAM,KAAKT,aAAa,MAAM,KAAK,KAAKA,aAAa,GAAG;EACvE,KAAKQ,gBAAgB,QAAQ;EAC7B,KAAKP,WAAW,IAAI,oBAClB,4BAA4B,MAAM,CACpC;CACF;AACF"}

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

@@ -0,0 +1,35 @@
+import { closeRuntimeInput } from "./runtime-input.js";
+import { errorMessage } from "./session-errors.js";
+import { SessionCommitConflictError } from "./session-state.js";
+//#region src/session/session-turn-error.ts
+async function emitTurnErrorAfterRecovery({ error, historySnapshot, run, runtimeInput, state }) {
+	if (error instanceof SessionCommitConflictError) {
+		run.emit({
+			type: "turn-error",
+			message: error.message
+		});
+		closeRuntimeInput(runtimeInput, "a session commit conflict");
+		return;
+	}
+	state.rollback(historySnapshot);
+	try {
+		await state.commit();
+	} catch (rollbackError) {
+		const rollbackMessage = rollbackError instanceof Error ? rollbackError.message : String(rollbackError);
+		run.emit({
+			type: "turn-error",
+			message: `${errorMessage(error)}; history rollback persistence failed: ${rollbackMessage}`
+		});
+		closeRuntimeInput(runtimeInput, "turn-error");
+		return;
+	}
+	run.emit({
+		type: "turn-error",
+		message: errorMessage(error)
+	});
+	closeRuntimeInput(runtimeInput, "turn-error");
+}
+//#endregion
+export { emitTurnErrorAfterRecovery };
+
+//# sourceMappingURL=session-turn-error.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-turn-error.js","names":[],"sources":["../../src/session/session-turn-error.ts"],"sourcesContent":["import type { ModelMessage } from \"ai\";\nimport type { BufferedAgentRun } from \"./run\";\nimport { closeRuntimeInput, type RuntimeInputState } from \"./runtime-input\";\nimport { errorMessage } from \"./session-errors\";\nimport { SessionCommitConflictError, type SessionState } from \"./session-state\";\n\nexport async function emitTurnErrorAfterRecovery({\n  error,\n  historySnapshot,\n  run,\n  runtimeInput,\n  state,\n}: {\n  readonly error: unknown;\n  readonly historySnapshot: ModelMessage[];\n  readonly run: BufferedAgentRun;\n  readonly runtimeInput: RuntimeInputState;\n  readonly state: SessionState;\n}): Promise<void> {\n  if (error instanceof SessionCommitConflictError) {\n    run.emit({ type: \"turn-error\", message: error.message });\n    closeRuntimeInput(runtimeInput, \"a session commit conflict\");\n    return;\n  }\n\n  state.rollback(historySnapshot);\n  try {\n    await state.commit();\n  } catch (rollbackError) {\n    const rollbackMessage =\n      rollbackError instanceof Error\n        ? rollbackError.message\n        : String(rollbackError);\n    run.emit({\n      type: \"turn-error\",\n      message: `${errorMessage(error)}; history rollback persistence failed: ${rollbackMessage}`,\n    });\n    closeRuntimeInput(runtimeInput, \"turn-error\");\n    return;\n  }\n\n  run.emit({ type: \"turn-error\", message: errorMessage(error) });\n  closeRuntimeInput(runtimeInput, \"turn-error\");\n}\n"],"mappings":";;;;AAMA,eAAsB,2BAA2B,EAC/C,OACA,iBACA,KACA,cACA,SAOgB;CAChB,IAAI,iBAAiB,4BAA4B;EAC/C,IAAI,KAAK;GAAE,MAAM;GAAc,SAAS,MAAM;EAAQ,CAAC;EACvD,kBAAkB,cAAc,2BAA2B;EAC3D;CACF;CAEA,MAAM,SAAS,eAAe;CAC9B,IAAI;EACF,MAAM,MAAM,OAAO;CACrB,SAAS,eAAe;EACtB,MAAM,kBACJ,yBAAyB,QACrB,cAAc,UACd,OAAO,aAAa;EAC1B,IAAI,KAAK;GACP,MAAM;GACN,SAAS,GAAG,aAAa,KAAK,EAAE,yCAAyC;EAC3E,CAAC;EACD,kBAAkB,cAAc,YAAY;EAC5C;CACF;CAEA,IAAI,KAAK;EAAE,MAAM;EAAc,SAAS,aAAa,KAAK;CAAE,CAAC;CAC7D,kBAAkB,cAAc,YAAY;AAC9C"}