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

package/dist/session/input.d.ts

@@ -1,6 +1,9 @@
+import { InputEventMeta } from "./input-meta-types.js";
+
 //#region src/session/input.d.ts
 type UserTextContent = string | readonly string[];
 interface UserText {
+  meta?: InputEventMeta;
   text: UserTextContent;
   type: "user-text";
 }
@@ -36,6 +39,7 @@ type UserMessageContentPart = UserMessageFilePart | UserMessageImagePart | UserM
 type UserMessageContent = readonly UserMessageContentPart[];
 interface UserMessage {
   content: UserMessageContent;
+  meta?: InputEventMeta;
   type: "user-message";
 }
 type UserInput = UserMessage | UserText;

package/dist/session/mapping.js

@@ -1,7 +1,9 @@
+import { stripInputMeta } from "./input-meta.js";
 //#region src/session/mapping.ts
 function userInputToModelMessage(input) {
-	if (input.type === "user-message") return userMessageToModelMessage(input);
-	return userTextToModelMessage(input);
+	const stripped = stripInputMeta(input);
+	if (stripped.type === "user-message") return userMessageToModelMessage(stripped);
+	return userTextToModelMessage(stripped);
 }
 function userTextToModelMessage(input) {
 	return {

package/dist/session/mapping.js.map

@@ -1 +1 @@
-{"version":3,"file":"mapping.js","names":[],"sources":["../../src/session/mapping.ts"],"sourcesContent":["import type {\n  AssistantContent,\n  AssistantModelMessage,\n  ModelMessage,\n  ToolModelMessage,\n  UserModelMessage,\n} from \"ai\";\nimport type {\n  AssistantReasoning,\n  AssistantText,\n  ToolCall,\n  ToolResult,\n  UserMessage,\n  UserMessageContent,\n  UserMessageContentPart,\n  UserMessageFileData,\n  UserText,\n  UserTextContent,\n} from \"./events\";\nimport type { UserInput } from \"./input\";\n\ntype AssistantContentPart = Exclude<AssistantContent, string>[number];\ntype ToolContentPart = ToolModelMessage[\"content\"][number];\ntype ModelEvent = AssistantReasoning | AssistantText | ToolCall | ToolResult;\n\n// UserInput -> AI SDK UserModelMessage\nexport function userInputToModelMessage(input: UserInput): UserModelMessage {\n  if (input.type === \"user-message\") {\n    return userMessageToModelMessage(input);\n  }\n\n  return userTextToModelMessage(input);\n}\n\nexport function userTextToModelMessage(input: UserText): UserModelMessage {\n  return { role: \"user\", content: userTextContentToUserContent(input.text) };\n}\n\nfunction userTextContentToUserContent(\n  text: UserTextContent\n): UserModelMessage[\"content\"] {\n  if (typeof text === \"string\") {\n    return text;\n  }\n\n  return text.map((part) => ({ type: \"text\", text: part }));\n}\n\nexport function userMessageToModelMessage(\n  input: UserMessage\n): UserModelMessage {\n  return {\n    role: \"user\",\n    content: userMessageContentToUserContent(input.content),\n  };\n}\n\nfunction userMessageContentToUserContent(\n  content: UserMessageContent\n): Exclude<UserModelMessage[\"content\"], string> {\n  return content.map(userMessageContentPartToUserContentPart);\n}\n\nfunction userMessageContentPartToUserContentPart(\n  part: UserMessageContentPart\n): Exclude<UserModelMessage[\"content\"], string>[number] {\n  if (part.type === \"text\") {\n    return { type: \"text\", text: part.text };\n  }\n\n  if (part.type === \"image\") {\n    return {\n      type: \"file\",\n      data: part.image,\n      mediaType: part.mediaType ?? \"image\",\n    };\n  }\n\n  return {\n    type: \"file\",\n    data: userMessageFileDataToFileData(part.data),\n    mediaType: part.mediaType,\n    ...(part.filename === undefined ? {} : { filename: part.filename }),\n  };\n}\n\nfunction userMessageFileDataToFileData(\n  data: UserMessageFileData\n): Extract<\n  Exclude<UserModelMessage[\"content\"], string>[number],\n  { type: \"file\" }\n>[\"data\"] {\n  if (typeof data === \"string\") {\n    return data;\n  }\n\n  if (data.type === \"url\") {\n    return data.url;\n  }\n\n  if (data.type === \"data\") {\n    return { type: \"data\", data: data.data };\n  }\n\n  if (data.type === \"reference\") {\n    return { type: \"reference\", reference: { ...data.reference } };\n  }\n\n  return { type: \"text\", text: data.text };\n}\n\n// AI SDK ModelMessage -> public agent events\nexport function modelMessageToAgentEvents(message: ModelMessage): ModelEvent[] {\n  if (message.role === \"assistant\") {\n    return assistantReasoningFirstParts(assistantContentParts(message)).flatMap(\n      assistantContentPartToEvents\n    );\n  }\n\n  if (message.role === \"tool\") {\n    return message.content.flatMap(toolContentPartToEvents);\n  }\n\n  return [];\n}\n\nfunction assistantContentParts(\n  message: AssistantModelMessage\n): AssistantContentPart[] {\n  return typeof message.content === \"string\"\n    ? [{ type: \"text\", text: message.content }]\n    : message.content;\n}\n\nfunction assistantReasoningFirstParts(\n  parts: AssistantContentPart[]\n): AssistantContentPart[] {\n  return [\n    ...parts.filter((part) => part.type === \"reasoning\"),\n    ...parts.filter((part) => part.type !== \"reasoning\"),\n  ];\n}\n\nfunction assistantContentPartToEvents(\n  part: AssistantContentPart\n): ModelEvent[] {\n  if (part.type === \"text\") {\n    return part.text ? [{ type: \"assistant-text\", text: part.text }] : [];\n  }\n\n  if (part.type === \"reasoning\") {\n    return part.text ? [{ type: \"assistant-reasoning\", text: part.text }] : [];\n  }\n\n  if (part.type === \"tool-call\") {\n    return [\n      {\n        type: \"tool-call\",\n        input: part.input,\n        toolCallId: part.toolCallId,\n        toolName: part.toolName,\n      },\n    ];\n  }\n\n  return [];\n}\n\nfunction toolContentPartToEvents(part: ToolContentPart): ModelEvent[] {\n  if (part.type === \"tool-result\") {\n    return toolResultPartToEvents(part);\n  }\n\n  return [];\n}\n\nfunction toolResultPartToEvents(part: {\n  output: unknown;\n  toolCallId: string;\n  toolName: string;\n  type: \"tool-result\";\n}): ModelEvent[] {\n  return [\n    {\n      type: \"tool-result\",\n      output: part.output,\n      toolCallId: part.toolCallId,\n      toolName: part.toolName,\n    },\n  ];\n}\n"],"mappings":";AA0BA,SAAgB,wBAAwB,OAAoC;CAC1E,IAAI,MAAM,SAAS,gBACjB,OAAO,0BAA0B,KAAK;CAGxC,OAAO,uBAAuB,KAAK;AACrC;AAEA,SAAgB,uBAAuB,OAAmC;CACxE,OAAO;EAAE,MAAM;EAAQ,SAAS,6BAA6B,MAAM,IAAI;CAAE;AAC3E;AAEA,SAAS,6BACP,MAC6B;CAC7B,IAAI,OAAO,SAAS,UAClB,OAAO;CAGT,OAAO,KAAK,KAAK,UAAU;EAAE,MAAM;EAAQ,MAAM;CAAK,EAAE;AAC1D;AAEA,SAAgB,0BACd,OACkB;CAClB,OAAO;EACL,MAAM;EACN,SAAS,gCAAgC,MAAM,OAAO;CACxD;AACF;AAEA,SAAS,gCACP,SAC8C;CAC9C,OAAO,QAAQ,IAAI,uCAAuC;AAC5D;AAEA,SAAS,wCACP,MACsD;CACtD,IAAI,KAAK,SAAS,QAChB,OAAO;EAAE,MAAM;EAAQ,MAAM,KAAK;CAAK;CAGzC,IAAI,KAAK,SAAS,SAChB,OAAO;EACL,MAAM;EACN,MAAM,KAAK;EACX,WAAW,KAAK,aAAa;CAC/B;CAGF,OAAO;EACL,MAAM;EACN,MAAM,8BAA8B,KAAK,IAAI;EAC7C,WAAW,KAAK;EAChB,GAAI,KAAK,aAAa,KAAA,IAAY,CAAC,IAAI,EAAE,UAAU,KAAK,SAAS;CACnE;AACF;AAEA,SAAS,8BACP,MAIQ;CACR,IAAI,OAAO,SAAS,UAClB,OAAO;CAGT,IAAI,KAAK,SAAS,OAChB,OAAO,KAAK;CAGd,IAAI,KAAK,SAAS,QAChB,OAAO;EAAE,MAAM;EAAQ,MAAM,KAAK;CAAK;CAGzC,IAAI,KAAK,SAAS,aAChB,OAAO;EAAE,MAAM;EAAa,WAAW,EAAE,GAAG,KAAK,UAAU;CAAE;CAG/D,OAAO;EAAE,MAAM;EAAQ,MAAM,KAAK;CAAK;AACzC;AAGA,SAAgB,0BAA0B,SAAqC;CAC7E,IAAI,QAAQ,SAAS,aACnB,OAAO,6BAA6B,sBAAsB,OAAO,CAAC,EAAE,QAClE,4BACF;CAGF,IAAI,QAAQ,SAAS,QACnB,OAAO,QAAQ,QAAQ,QAAQ,uBAAuB;CAGxD,OAAO,CAAC;AACV;AAEA,SAAS,sBACP,SACwB;CACxB,OAAO,OAAO,QAAQ,YAAY,WAC9B,CAAC;EAAE,MAAM;EAAQ,MAAM,QAAQ;CAAQ,CAAC,IACxC,QAAQ;AACd;AAEA,SAAS,6BACP,OACwB;CACxB,OAAO,CACL,GAAG,MAAM,QAAQ,SAAS,KAAK,SAAS,WAAW,GACnD,GAAG,MAAM,QAAQ,SAAS,KAAK,SAAS,WAAW,CACrD;AACF;AAEA,SAAS,6BACP,MACc;CACd,IAAI,KAAK,SAAS,QAChB,OAAO,KAAK,OAAO,CAAC;EAAE,MAAM;EAAkB,MAAM,KAAK;CAAK,CAAC,IAAI,CAAC;CAGtE,IAAI,KAAK,SAAS,aAChB,OAAO,KAAK,OAAO,CAAC;EAAE,MAAM;EAAuB,MAAM,KAAK;CAAK,CAAC,IAAI,CAAC;CAG3E,IAAI,KAAK,SAAS,aAChB,OAAO,CACL;EACE,MAAM;EACN,OAAO,KAAK;EACZ,YAAY,KAAK;EACjB,UAAU,KAAK;CACjB,CACF;CAGF,OAAO,CAAC;AACV;AAEA,SAAS,wBAAwB,MAAqC;CACpE,IAAI,KAAK,SAAS,eAChB,OAAO,uBAAuB,IAAI;CAGpC,OAAO,CAAC;AACV;AAEA,SAAS,uBAAuB,MAKf;CACf,OAAO,CACL;EACE,MAAM;EACN,QAAQ,KAAK;EACb,YAAY,KAAK;EACjB,UAAU,KAAK;CACjB,CACF;AACF"}
+{"version":3,"file":"mapping.js","names":[],"sources":["../../src/session/mapping.ts"],"sourcesContent":["import type {\n  AssistantContent,\n  AssistantModelMessage,\n  ModelMessage,\n  ToolModelMessage,\n  UserModelMessage,\n} from \"ai\";\nimport type {\n  AssistantReasoning,\n  AssistantText,\n  ToolCall,\n  ToolResult,\n  UserMessage,\n  UserMessageContent,\n  UserMessageContentPart,\n  UserMessageFileData,\n  UserText,\n  UserTextContent,\n} from \"./events\";\nimport type { UserInput } from \"./input\";\nimport { stripInputMeta } from \"./input-meta\";\n\ntype AssistantContentPart = Exclude<AssistantContent, string>[number];\ntype ToolContentPart = ToolModelMessage[\"content\"][number];\ntype ModelEvent = AssistantReasoning | AssistantText | ToolCall | ToolResult;\n\n// UserInput -> AI SDK UserModelMessage\nexport function userInputToModelMessage(input: UserInput): UserModelMessage {\n  const stripped = stripInputMeta(input);\n  if (stripped.type === \"user-message\") {\n    return userMessageToModelMessage(stripped);\n  }\n\n  return userTextToModelMessage(stripped);\n}\n\nexport function userTextToModelMessage(input: UserText): UserModelMessage {\n  return { role: \"user\", content: userTextContentToUserContent(input.text) };\n}\n\nfunction userTextContentToUserContent(\n  text: UserTextContent\n): UserModelMessage[\"content\"] {\n  if (typeof text === \"string\") {\n    return text;\n  }\n\n  return text.map((part) => ({ type: \"text\", text: part }));\n}\n\nexport function userMessageToModelMessage(\n  input: UserMessage\n): UserModelMessage {\n  return {\n    role: \"user\",\n    content: userMessageContentToUserContent(input.content),\n  };\n}\n\nfunction userMessageContentToUserContent(\n  content: UserMessageContent\n): Exclude<UserModelMessage[\"content\"], string> {\n  return content.map(userMessageContentPartToUserContentPart);\n}\n\nfunction userMessageContentPartToUserContentPart(\n  part: UserMessageContentPart\n): Exclude<UserModelMessage[\"content\"], string>[number] {\n  if (part.type === \"text\") {\n    return { type: \"text\", text: part.text };\n  }\n\n  if (part.type === \"image\") {\n    return {\n      type: \"file\",\n      data: part.image,\n      mediaType: part.mediaType ?? \"image\",\n    };\n  }\n\n  return {\n    type: \"file\",\n    data: userMessageFileDataToFileData(part.data),\n    mediaType: part.mediaType,\n    ...(part.filename === undefined ? {} : { filename: part.filename }),\n  };\n}\n\nfunction userMessageFileDataToFileData(\n  data: UserMessageFileData\n): Extract<\n  Exclude<UserModelMessage[\"content\"], string>[number],\n  { type: \"file\" }\n>[\"data\"] {\n  if (typeof data === \"string\") {\n    return data;\n  }\n\n  if (data.type === \"url\") {\n    return data.url;\n  }\n\n  if (data.type === \"data\") {\n    return { type: \"data\", data: data.data };\n  }\n\n  if (data.type === \"reference\") {\n    return { type: \"reference\", reference: { ...data.reference } };\n  }\n\n  return { type: \"text\", text: data.text };\n}\n\n// AI SDK ModelMessage -> public agent events\nexport function modelMessageToAgentEvents(message: ModelMessage): ModelEvent[] {\n  if (message.role === \"assistant\") {\n    return assistantReasoningFirstParts(assistantContentParts(message)).flatMap(\n      assistantContentPartToEvents\n    );\n  }\n\n  if (message.role === \"tool\") {\n    return message.content.flatMap(toolContentPartToEvents);\n  }\n\n  return [];\n}\n\nfunction assistantContentParts(\n  message: AssistantModelMessage\n): AssistantContentPart[] {\n  return typeof message.content === \"string\"\n    ? [{ type: \"text\", text: message.content }]\n    : message.content;\n}\n\nfunction assistantReasoningFirstParts(\n  parts: AssistantContentPart[]\n): AssistantContentPart[] {\n  return [\n    ...parts.filter((part) => part.type === \"reasoning\"),\n    ...parts.filter((part) => part.type !== \"reasoning\"),\n  ];\n}\n\nfunction assistantContentPartToEvents(\n  part: AssistantContentPart\n): ModelEvent[] {\n  if (part.type === \"text\") {\n    return part.text ? [{ type: \"assistant-text\", text: part.text }] : [];\n  }\n\n  if (part.type === \"reasoning\") {\n    return part.text ? [{ type: \"assistant-reasoning\", text: part.text }] : [];\n  }\n\n  if (part.type === \"tool-call\") {\n    return [\n      {\n        type: \"tool-call\",\n        input: part.input,\n        toolCallId: part.toolCallId,\n        toolName: part.toolName,\n      },\n    ];\n  }\n\n  return [];\n}\n\nfunction toolContentPartToEvents(part: ToolContentPart): ModelEvent[] {\n  if (part.type === \"tool-result\") {\n    return toolResultPartToEvents(part);\n  }\n\n  return [];\n}\n\nfunction toolResultPartToEvents(part: {\n  output: unknown;\n  toolCallId: string;\n  toolName: string;\n  type: \"tool-result\";\n}): ModelEvent[] {\n  return [\n    {\n      type: \"tool-result\",\n      output: part.output,\n      toolCallId: part.toolCallId,\n      toolName: part.toolName,\n    },\n  ];\n}\n"],"mappings":";;AA2BA,SAAgB,wBAAwB,OAAoC;CAC1E,MAAM,WAAW,eAAe,KAAK;CACrC,IAAI,SAAS,SAAS,gBACpB,OAAO,0BAA0B,QAAQ;CAG3C,OAAO,uBAAuB,QAAQ;AACxC;AAEA,SAAgB,uBAAuB,OAAmC;CACxE,OAAO;EAAE,MAAM;EAAQ,SAAS,6BAA6B,MAAM,IAAI;CAAE;AAC3E;AAEA,SAAS,6BACP,MAC6B;CAC7B,IAAI,OAAO,SAAS,UAClB,OAAO;CAGT,OAAO,KAAK,KAAK,UAAU;EAAE,MAAM;EAAQ,MAAM;CAAK,EAAE;AAC1D;AAEA,SAAgB,0BACd,OACkB;CAClB,OAAO;EACL,MAAM;EACN,SAAS,gCAAgC,MAAM,OAAO;CACxD;AACF;AAEA,SAAS,gCACP,SAC8C;CAC9C,OAAO,QAAQ,IAAI,uCAAuC;AAC5D;AAEA,SAAS,wCACP,MACsD;CACtD,IAAI,KAAK,SAAS,QAChB,OAAO;EAAE,MAAM;EAAQ,MAAM,KAAK;CAAK;CAGzC,IAAI,KAAK,SAAS,SAChB,OAAO;EACL,MAAM;EACN,MAAM,KAAK;EACX,WAAW,KAAK,aAAa;CAC/B;CAGF,OAAO;EACL,MAAM;EACN,MAAM,8BAA8B,KAAK,IAAI;EAC7C,WAAW,KAAK;EAChB,GAAI,KAAK,aAAa,KAAA,IAAY,CAAC,IAAI,EAAE,UAAU,KAAK,SAAS;CACnE;AACF;AAEA,SAAS,8BACP,MAIQ;CACR,IAAI,OAAO,SAAS,UAClB,OAAO;CAGT,IAAI,KAAK,SAAS,OAChB,OAAO,KAAK;CAGd,IAAI,KAAK,SAAS,QAChB,OAAO;EAAE,MAAM;EAAQ,MAAM,KAAK;CAAK;CAGzC,IAAI,KAAK,SAAS,aAChB,OAAO;EAAE,MAAM;EAAa,WAAW,EAAE,GAAG,KAAK,UAAU;CAAE;CAG/D,OAAO;EAAE,MAAM;EAAQ,MAAM,KAAK;CAAK;AACzC;AAGA,SAAgB,0BAA0B,SAAqC;CAC7E,IAAI,QAAQ,SAAS,aACnB,OAAO,6BAA6B,sBAAsB,OAAO,CAAC,EAAE,QAClE,4BACF;CAGF,IAAI,QAAQ,SAAS,QACnB,OAAO,QAAQ,QAAQ,QAAQ,uBAAuB;CAGxD,OAAO,CAAC;AACV;AAEA,SAAS,sBACP,SACwB;CACxB,OAAO,OAAO,QAAQ,YAAY,WAC9B,CAAC;EAAE,MAAM;EAAQ,MAAM,QAAQ;CAAQ,CAAC,IACxC,QAAQ;AACd;AAEA,SAAS,6BACP,OACwB;CACxB,OAAO,CACL,GAAG,MAAM,QAAQ,SAAS,KAAK,SAAS,WAAW,GACnD,GAAG,MAAM,QAAQ,SAAS,KAAK,SAAS,WAAW,CACrD;AACF;AAEA,SAAS,6BACP,MACc;CACd,IAAI,KAAK,SAAS,QAChB,OAAO,KAAK,OAAO,CAAC;EAAE,MAAM;EAAkB,MAAM,KAAK;CAAK,CAAC,IAAI,CAAC;CAGtE,IAAI,KAAK,SAAS,aAChB,OAAO,KAAK,OAAO,CAAC;EAAE,MAAM;EAAuB,MAAM,KAAK;CAAK,CAAC,IAAI,CAAC;CAG3E,IAAI,KAAK,SAAS,aAChB,OAAO,CACL;EACE,MAAM;EACN,OAAO,KAAK;EACZ,YAAY,KAAK;EACjB,UAAU,KAAK;CACjB,CACF;CAGF,OAAO,CAAC;AACV;AAEA,SAAS,wBAAwB,MAAqC;CACpE,IAAI,KAAK,SAAS,eAChB,OAAO,uBAAuB,IAAI;CAGpC,OAAO,CAAC;AACV;AAEA,SAAS,uBAAuB,MAKf;CACf,OAAO,CACL;EACE,MAAM;EACN,QAAQ,KAAK;EACb,YAAY,KAAK;EACjB,UAAU,KAAK;CACjB,CACF;AACF"}

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

@@ -0,0 +1,41 @@
+import { stripInputMeta } from "./input-meta.js";
+//#region src/session/runtime-input-emit.ts
+function runtimeInputEventFromQueued(queued) {
+	return {
+		input: queued.input,
+		meta: queued.input.meta,
+		placement: queued.placement,
+		type: "runtime-input"
+	};
+}
+async function commitPreUserRuntimeInputs(events, state, runtimeInputs) {
+	const committed = [];
+	for (const queued of runtimeInputs) {
+		const processed = await events.interceptEvent(runtimeInputEventFromQueued(queued));
+		if (processed === "handled") continue;
+		committed.push(processed);
+		const input = runtimeInputHistoryFromEvent(processed, queued);
+		state.appendUserInput(input);
+		await state.commit();
+	}
+	return committed;
+}
+function emitCommittedRuntimeInputs(events, run, committed) {
+	for (const event of committed) events.emitProcessedEvent(run, event);
+}
+async function emitRuntimeInputEvent(events, run, state, queued) {
+	const processed = await events.interceptEvent(runtimeInputEventFromQueued(queued));
+	if (processed === "handled") return false;
+	events.emitProcessedEvent(run, processed);
+	state.appendUserInput(runtimeInputHistoryFromEvent(processed, queued));
+	await state.commit();
+	return true;
+}
+function runtimeInputHistoryFromEvent(processed, queued) {
+	if (processed.type === "runtime-input") return stripInputMeta(processed.input);
+	return stripInputMeta(queued.input);
+}
+//#endregion
+export { commitPreUserRuntimeInputs, emitCommittedRuntimeInputs, emitRuntimeInputEvent };
+
+//# sourceMappingURL=runtime-input-emit.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-input-emit.js","names":[],"sources":["../../src/session/runtime-input-emit.ts"],"sourcesContent":["import type { AgentEvent, RuntimeInput } from \"./events\";\nimport type { UserInput } from \"./input\";\nimport { stripInputMeta } from \"./input-meta\";\nimport type { BufferedAgentRun } from \"./run\";\nimport type { QueuedRuntimeInput } from \"./runtime-input\";\nimport type { SessionEventDispatcher } from \"./session-events\";\nimport type { SessionState } from \"./session-state\";\n\nexport function runtimeInputEventFromQueued(\n  queued: QueuedRuntimeInput\n): RuntimeInput {\n  return {\n    input: queued.input,\n    meta: queued.input.meta,\n    placement: queued.placement,\n    type: \"runtime-input\",\n  };\n}\n\nexport async function commitPreUserRuntimeInputs(\n  events: SessionEventDispatcher,\n  state: SessionState,\n  runtimeInputs: readonly QueuedRuntimeInput[]\n): Promise<readonly AgentEvent[]> {\n  const committed: AgentEvent[] = [];\n  for (const queued of runtimeInputs) {\n    const processed = await events.interceptEvent(\n      runtimeInputEventFromQueued(queued)\n    );\n    if (processed === \"handled\") {\n      continue;\n    }\n\n    committed.push(processed);\n    const input = runtimeInputHistoryFromEvent(processed, queued);\n    state.appendUserInput(input);\n    await state.commit();\n  }\n\n  return committed;\n}\n\nexport function emitCommittedRuntimeInputs(\n  events: SessionEventDispatcher,\n  run: BufferedAgentRun,\n  committed: readonly AgentEvent[]\n): void {\n  for (const event of committed) {\n    events.emitProcessedEvent(run, event);\n  }\n}\n\nexport async function emitRuntimeInputEvent(\n  events: SessionEventDispatcher,\n  run: BufferedAgentRun,\n  state: SessionState,\n  queued: QueuedRuntimeInput\n): Promise<boolean> {\n  const processed = await events.interceptEvent(\n    runtimeInputEventFromQueued(queued)\n  );\n  if (processed === \"handled\") {\n    return false;\n  }\n\n  events.emitProcessedEvent(run, processed);\n  state.appendUserInput(runtimeInputHistoryFromEvent(processed, queued));\n  await state.commit();\n  return true;\n}\n\nfunction runtimeInputHistoryFromEvent(\n  processed: AgentEvent,\n  queued: QueuedRuntimeInput\n): UserInput {\n  if (processed.type === \"runtime-input\") {\n    return stripInputMeta(processed.input);\n  }\n\n  return stripInputMeta(queued.input);\n}\n"],"mappings":";;AAQA,SAAgB,4BACd,QACc;CACd,OAAO;EACL,OAAO,OAAO;EACd,MAAM,OAAO,MAAM;EACnB,WAAW,OAAO;EAClB,MAAM;CACR;AACF;AAEA,eAAsB,2BACpB,QACA,OACA,eACgC;CAChC,MAAM,YAA0B,CAAC;CACjC,KAAK,MAAM,UAAU,eAAe;EAClC,MAAM,YAAY,MAAM,OAAO,eAC7B,4BAA4B,MAAM,CACpC;EACA,IAAI,cAAc,WAChB;EAGF,UAAU,KAAK,SAAS;EACxB,MAAM,QAAQ,6BAA6B,WAAW,MAAM;EAC5D,MAAM,gBAAgB,KAAK;EAC3B,MAAM,MAAM,OAAO;CACrB;CAEA,OAAO;AACT;AAEA,SAAgB,2BACd,QACA,KACA,WACM;CACN,KAAK,MAAM,SAAS,WAClB,OAAO,mBAAmB,KAAK,KAAK;AAExC;AAEA,eAAsB,sBACpB,QACA,KACA,OACA,QACkB;CAClB,MAAM,YAAY,MAAM,OAAO,eAC7B,4BAA4B,MAAM,CACpC;CACA,IAAI,cAAc,WAChB,OAAO;CAGT,OAAO,mBAAmB,KAAK,SAAS;CACxC,MAAM,gBAAgB,6BAA6B,WAAW,MAAM,CAAC;CACrE,MAAM,MAAM,OAAO;CACnB,OAAO;AACT;AAEA,SAAS,6BACP,WACA,QACW;CACX,IAAI,UAAU,SAAS,iBACrB,OAAO,eAAe,UAAU,KAAK;CAGvC,OAAO,eAAe,OAAO,KAAK;AACpC"}

package/dist/session/runtime-input.js

@@ -1,3 +1,4 @@
+import { attachInputMeta } from "./input-meta.js";
 import { normalizeAgentInput } from "./input-normalization.js";
 //#region src/session/runtime-input.ts
 function createRuntimeInputState(queue) {
@@ -9,8 +10,11 @@ function createRuntimeInputState(queue) {
 function addSteeringInput(runtimeInput, input) {
 	const next = runtimeInput.pending.then(() => {
 		if (runtimeInput.closedReason) throw runtimeInputClosedError(runtimeInput.closedReason);
-		runtimeInput.queue.push({
-			input: normalizeAgentInput(input),
+		queueRuntimeInput(runtimeInput, {
+			input: attachInputMeta(normalizeAgentInput(input), {
+				source: "steer",
+				streaming: "steer"
+			}),
 			placement: runtimeInput.steerPlacement ?? runtimeInput.placement ?? "step-end"
 		});
 	});
@@ -34,36 +38,18 @@ async function withRuntimeInputWindow(runtimeInput, placement, callback) {
 		runtimeInput.steerPlacement = previousSteerPlacement;
 	}
 }
-async function withSteeringPlacement(runtimeInput, placement, callback) {
-	const previousSteerPlacement = runtimeInput.steerPlacement;
-	runtimeInput.steerPlacement = placement;
-	try {
-		return await callback();
-	} finally {
-		runtimeInput.steerPlacement = previousSteerPlacement;
-	}
-}
-function hooksForRuntimeInput(hooks, runtimeInput) {
-	if (!hooks) return;
-	return {
-		...hooks,
-		afterStep: (context) => withSteeringPlacement(runtimeInput, "step-end", async () => {
-			await hooks.afterStep?.(context);
-		}),
-		beforeStep: (context) => withSteeringPlacement(runtimeInput, "step-start", async () => {
-			await hooks.beforeStep?.(context);
-		})
-	};
-}
 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 queueRuntimeInput(runtimeInput, input) {
+	runtimeInput.queue.push(input);
+}
 function runtimeInputClosedError(reason) {
 	return /* @__PURE__ */ new Error(`session.steer() cannot be used after ${reason}`);
 }
 //#endregion
-export { addSteeringInput, closeRuntimeInput, createRuntimeInputState, hooksForRuntimeInput, shiftRuntimeInput, withRuntimeInputWindow, withSteeringPlacement };
+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 { AgentHooks } from \"../hooks\";\nimport type { 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 input: UserInput;\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    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 && !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 hooksForRuntimeInput(\n  hooks: AgentHooks | undefined,\n  runtimeInput: RuntimeInputState\n): AgentHooks | undefined {\n  if (!hooks) {\n    return;\n  }\n\n  return {\n    ...hooks,\n    afterStep: (context) =>\n      withSteeringPlacement(runtimeInput, \"step-end\", async () => {\n        await hooks.afterStep?.(context);\n      }),\n    beforeStep: (context) =>\n      withSteeringPlacement(runtimeInput, \"step-start\", async () => {\n        await hooks.beforeStep?.(context);\n      }),\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\nfunction runtimeInputClosedError(reason: string): Error {\n  return new Error(`session.steer() cannot be used after ${reason}`);\n}\n"],"mappings":";;AA2BA,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,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,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;AAEA,eAAsB,sBACpB,cACA,WACA,UACY;CACZ,MAAM,yBAAyB,aAAa;CAC5C,aAAa,iBAAiB;CAC9B,IAAI;EACF,OAAO,MAAM,SAAS;CACxB,UAAU;EACR,aAAa,iBAAiB;CAChC;AACF;AAEA,SAAgB,qBACd,OACA,cACwB;CACxB,IAAI,CAAC,OACH;CAGF,OAAO;EACL,GAAG;EACH,YAAY,YACV,sBAAsB,cAAc,YAAY,YAAY;GAC1D,MAAM,MAAM,YAAY,OAAO;EACjC,CAAC;EACH,aAAa,YACX,sBAAsB,cAAc,cAAc,YAAY;GAC5D,MAAM,MAAM,aAAa,OAAO;EAClC,CAAC;CACL;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,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 { attachInputMeta } from \"./input-meta\";\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: attachInputMeta(normalizeAgentInput(input), {\n        source: \"steer\",\n        streaming: \"steer\",\n      }),\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":";;;AA6BA,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,gBAAgB,oBAAoB,KAAK,GAAG;IACjD,QAAQ;IACR,WAAW;GACb,CAAC;GACD,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

@@ -1,9 +1,4 @@
 //#region src/session/session-errors.ts
-async function runAfterTurnHook(hooks, context) {
-	const hook = hooks?.afterTurn;
-	if (!hook) return;
-	await Promise.allSettled([Promise.resolve().then(() => hook(context))]);
-}
 function errorMessage(error) {
 	if (error instanceof Error) return error.message;
 	return String(error);
@@ -18,6 +13,6 @@ function sessionTerminalError(killed) {
 	return killed ? sessionKilledError() : sessionDeleteInProgressError();
 }
 //#endregion
-export { errorMessage, runAfterTurnHook, sessionKilledError, sessionTerminalError };
+export { errorMessage, sessionKilledError, sessionTerminalError };
 
 //# sourceMappingURL=session-errors.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"session-errors.js","names":[],"sources":["../../src/session/session-errors.ts"],"sourcesContent":["import type { AgentHooks } from \"../hooks\";\n\nexport async function runAfterTurnHook(\n  hooks: AgentHooks | undefined,\n  context: Parameters<NonNullable<AgentHooks[\"afterTurn\"]>>[0]\n): Promise<void> {\n  const hook = hooks?.afterTurn;\n  if (!hook) {\n    return;\n  }\n\n  await Promise.allSettled([Promise.resolve().then(() => hook(context))]);\n}\n\nexport 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":";AAEA,eAAsB,iBACpB,OACA,SACe;CACf,MAAM,OAAO,OAAO;CACpB,IAAI,CAAC,MACH;CAGF,MAAM,QAAQ,WAAW,CAAC,QAAQ,QAAQ,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC;AACxE;AAEA,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"}
+{"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,73 @@
+import { runPluginsForEvent } 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).then(() => void 0);
+	}
+	async emitRunBoundaryEvent(run, event) {
+		await runPluginsForEvent(this.#plugins, {
+			event,
+			history: this.#history(),
+			signal: this.#signal()
+		}, { observeOnly: true });
+		await run.emitBoundary(event);
+	}
+	async emitRunEvent(run, event) {
+		const processed = await this.interceptEvent(event);
+		if (processed === "handled") return "handled";
+		run.emit(processed);
+		return processed;
+	}
+	async interceptEvent(event) {
+		const pipeline = await this.#runInterceptPipeline(event);
+		if (pipeline.kind === "handled") return "handled";
+		return pipeline.event;
+	}
+	emitProcessedEvent(run, event) {
+		run.emit(event);
+	}
+	#runInterceptPipeline(event) {
+		return runPluginsForEvent(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","#runInterceptPipeline"],"sources":["../../src/session/session-events.ts"],"sourcesContent":["import type { RuntimeLlmContext } from \"../llm\";\nimport {\n  type AgentPlugin,\n  type PluginPipelineResult,\n  runPluginsForEvent,\n} 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).then(() => undefined);\n  }\n\n  async emitRunBoundaryEvent(\n    run: BufferedAgentRun,\n    event: AgentEvent\n  ): Promise<void> {\n    await runPluginsForEvent(\n      this.#plugins,\n      {\n        event,\n        history: this.#history(),\n        signal: this.#signal(),\n      },\n      { observeOnly: true }\n    );\n    await run.emitBoundary(event);\n  }\n\n  async emitRunEvent(\n    run: BufferedAgentRun,\n    event: AgentEvent\n  ): Promise<AgentEvent | \"handled\"> {\n    const processed = await this.interceptEvent(event);\n    if (processed === \"handled\") {\n      return \"handled\";\n    }\n\n    run.emit(processed);\n    return processed;\n  }\n\n  async interceptEvent(event: AgentEvent): Promise<AgentEvent | \"handled\"> {\n    const pipeline = await this.#runInterceptPipeline(event);\n    if (pipeline.kind === \"handled\") {\n      return \"handled\";\n    }\n\n    return pipeline.event;\n  }\n\n  emitProcessedEvent(run: BufferedAgentRun, event: AgentEvent): void {\n    run.emit(event);\n  }\n\n  #runInterceptPipeline(event: AgentEvent): Promise<PluginPipelineResult> {\n    return runPluginsForEvent(this.#plugins, {\n      event,\n      history: this.#history(),\n      signal: this.#signal(),\n    });\n  }\n}\n"],"mappings":";;AAeA,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,EAAE,WAAW,KAAA,CAAS;CACjE;CAEA,MAAM,qBACJ,KACA,OACe;EACf,MAAM,mBACJ,KAAKF,UACL;GACE;GACA,SAAS,KAAKD,SAAS;GACvB,QAAQ,KAAKE,QAAQ;EACvB,GACA,EAAE,aAAa,KAAK,CACtB;EACA,MAAM,IAAI,aAAa,KAAK;CAC9B;CAEA,MAAM,aACJ,KACA,OACiC;EACjC,MAAM,YAAY,MAAM,KAAK,eAAe,KAAK;EACjD,IAAI,cAAc,WAChB,OAAO;EAGT,IAAI,KAAK,SAAS;EAClB,OAAO;CACT;CAEA,MAAM,eAAe,OAAoD;EACvE,MAAM,WAAW,MAAM,KAAKE,sBAAsB,KAAK;EACvD,IAAI,SAAS,SAAS,WACpB,OAAO;EAGT,OAAO,SAAS;CAClB;CAEA,mBAAmB,KAAuB,OAAyB;EACjE,IAAI,KAAK,KAAK;CAChB;CAEA,sBAAsB,OAAkD;EACtE,OAAO,mBAAmB,KAAKH,UAAU;GACvC;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-notification.js

@@ -0,0 +1,59 @@
+import { attachInputMeta } from "./input-meta.js";
+import { normalizeAgentInput } from "./input-normalization.js";
+import { BufferedAgentRun } from "./run.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: attachInputMeta(normalizeAgentInput(input), { source: "notify" }),
+		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 { attachInputMeta } from \"./input-meta\";\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: attachInputMeta(normalizeAgentInput(input), { source: \"notify\" }),\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":";;;;;;AA2BA,SAAgB,yBACd,OACA,SACA,OACU;CACV,MAAM,qBAAyC;EAC7C,OAAO,gBAAgB,oBAAoB,KAAK,GAAG,EAAE,QAAQ,SAAS,CAAC;EACvE,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

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

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 { BufferedAgentRun } from \"./run\";\nimport {\n  type RuntimeInputPlacement,\n  type RuntimeInputState,\n  shiftRuntimeInput,\n} from \"./runtime-input\";\nimport { emitRuntimeInputEvent } from \"./runtime-input-emit\";\nimport type { SessionEventDispatcher } from \"./session-events\";\nimport type { SessionState } from \"./session-state\";\n\nexport async function drainRuntimeInput({\n  events,\n  placement,\n  run,\n  runtimeInput,\n  state,\n}: {\n  readonly events: SessionEventDispatcher;\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    if (await emitRuntimeInputEvent(events, run, state, next)) {\n      added = true;\n    }\n    next = shiftRuntimeInput(runtimeInput, placement);\n  }\n\n  return added;\n}\n"],"mappings":";;;AAUA,eAAsB,kBAAkB,EACtC,QACA,WACA,KACA,cACA,SAOmB;CACnB,IAAI,QAAQ;CACZ,IAAI,OAAO,kBAAkB,cAAc,SAAS;CACpD,OAAO,MAAM;EACX,IAAI,MAAM,sBAAsB,QAAQ,KAAK,OAAO,IAAI,GACtD,QAAQ;EAEV,OAAO,kBAAkB,cAAc,SAAS;CAClD;CAEA,OAAO;AACT"}

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

@@ -0,0 +1,125 @@
+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 { commitPreUserRuntimeInputs, emitCommittedRuntimeInputs } from "./runtime-input-emit.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);
+		const committedPreUser = await commitPreUserRuntimeInputs(events, state, preUserRuntimeInputs);
+		if (input) {
+			state.appendUserInput(input);
+			await state.commit();
+		}
+		await withRuntimeInputWindow(runtimeInput, "turn-start", async () => {
+			await events.emitRunBoundaryEvent(run, { type: "turn-start" });
+		});
+		await emitCommittedRuntimeInputs(events, run, committedPreUser);
+		await drainRuntimeInput({
+			events,
+			placement: "turn-start",
+			run,
+			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 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 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({
+		events,
+		placement: event.type,
+		run,
+		runtimeInput,
+		state
+	});
+	return event.type === "step-end" ? { runtimeInputAdded } : void 0;
+}
+//#endregion
+export { processQueuedInput };
+
+//# sourceMappingURL=session-turn-processor.js.map