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

package/dist/plugins.d.ts

@@ -1,9 +1,21 @@
 import { RuntimeLlmContext } from "./llm.js";
-import { AgentEvent } from "./session/events.js";
+import { InputEventMeta, InputSource } from "./session/input-meta-types.js";
+import { UserMessage, UserText } from "./session/input.js";
+import { AgentEvent, RuntimeInput } from "./session/events.js";
 
 //#region src/plugins.d.ts
 type MaybePromise<T> = PromiseLike<T> | T;
 type AgentEventHistory = RuntimeLlmContext["history"];
+type InterceptableAgentEvent = RuntimeInput | UserMessage | UserText;
+type AgentPluginInterceptResult = {
+  readonly action: "continue";
+} | {
+  readonly action: "handled";
+} | {
+  readonly action: "transform";
+  readonly event: InterceptableAgentEvent;
+};
+type AgentPluginResult = AgentPluginInterceptResult | undefined;
 interface AgentEventContext {
   readonly event: AgentEvent;
   readonly history: AgentEventHistory;
@@ -11,10 +23,20 @@ interface AgentEventContext {
 }
 interface AgentPlugin {
   readonly events?: {
-    readonly on?: (context: AgentEventContext) => MaybePromise<void>;
+    /** @deprecated Use top-level `on`. */readonly on?: (context: AgentEventContext) => MaybePromise<void>;
   };
   readonly name?: string;
+  readonly on?: (context: AgentEventContext) => MaybePromise<AgentPluginResult>;
 }
+type PluginPipelineResult = {
+  readonly event: AgentEvent;
+  readonly kind: "emit";
+} | {
+  readonly kind: "handled";
+};
+declare function runPluginsForEvent(plugins: readonly AgentPlugin[], context: AgentEventContext, options?: {
+  readonly observeOnly?: boolean;
+}): Promise<PluginPipelineResult>;
 //#endregion
-export { AgentEventContext, AgentPlugin };
+export { AgentEventContext, AgentPlugin, AgentPluginInterceptResult, AgentPluginResult, InterceptableAgentEvent, PluginPipelineResult, runPluginsForEvent };
 //# sourceMappingURL=plugins.d.ts.map

package/dist/plugins.js

@@ -1,14 +1,43 @@
 //#region src/plugins.ts
-function runEventPlugins(plugins, context) {
-	return runPluginHandlers(plugins, (plugin) => plugin.events?.on, context);
+function runPluginsForEvent(plugins, context, options = {}) {
+	return runPluginPipeline(plugins, context, options.observeOnly === true);
 }
-async function runPluginHandlers(plugins, handlerFor, context) {
+function isInterceptableEvent(event) {
+	return event.type === "user-text" || event.type === "user-message" || event.type === "runtime-input";
+}
+function resolvePluginHandler(plugin) {
+	if (plugin.on) return plugin.on;
+	const legacyHandler = plugin.events?.on;
+	if (!legacyHandler) return;
+	return (legacyContext) => Promise.resolve(legacyHandler(legacyContext)).then(() => void 0);
+}
+function normalizeInterceptResult(result) {
+	if (result === void 0) return;
+	if (result.action === "continue") return result;
+	if (result.action === "handled") return result;
+	if (result.action === "transform") return result;
+}
+async function runPluginPipeline(plugins, context, observeOnly) {
+	let currentEvent = context.event;
 	for (const plugin of plugins) {
-		const handler = handlerFor(plugin);
-		if (handler) await handler(context);
+		const handler = resolvePluginHandler(plugin);
+		if (!handler) continue;
+		const result = await handler({
+			...context,
+			event: currentEvent
+		});
+		if (observeOnly || !isInterceptableEvent(currentEvent)) continue;
+		const intercept = normalizeInterceptResult(result);
+		if (!intercept || intercept.action === "continue") continue;
+		if (intercept.action === "handled") return { kind: "handled" };
+		currentEvent = intercept.event;
 	}
+	return {
+		kind: "emit",
+		event: currentEvent
+	};
 }
 //#endregion
-export { runEventPlugins };
+export { runPluginsForEvent };
 
 //# sourceMappingURL=plugins.js.map

package/dist/plugins.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugins.js","names":[],"sources":["../src/plugins.ts"],"sourcesContent":["import type { RuntimeLlmContext } from \"./llm\";\nimport type { AgentEvent } from \"./session/events\";\n\ntype MaybePromise<T> = PromiseLike<T> | T;\ntype AgentEventHistory = RuntimeLlmContext[\"history\"];\n\nexport interface AgentEventContext {\n  readonly event: AgentEvent;\n  readonly history: AgentEventHistory;\n  readonly signal?: AbortSignal;\n}\n\nexport interface AgentPlugin {\n  readonly events?: {\n    readonly on?: (context: AgentEventContext) => MaybePromise<void>;\n  };\n  readonly name?: string;\n}\n\nexport function runEventPlugins(\n  plugins: readonly AgentPlugin[],\n  context: AgentEventContext\n): Promise<void> {\n  return runPluginHandlers(plugins, (plugin) => plugin.events?.on, context);\n}\n\nasync function runPluginHandlers<Context>(\n  plugins: readonly AgentPlugin[],\n  handlerFor: (\n    plugin: AgentPlugin\n  ) => ((context: Context) => MaybePromise<void>) | undefined,\n  context: Context\n): Promise<void> {\n  for (const plugin of plugins) {\n    const handler = handlerFor(plugin);\n    if (handler) {\n      await handler(context);\n    }\n  }\n}\n"],"mappings":";AAmBA,SAAgB,gBACd,SACA,SACe;CACf,OAAO,kBAAkB,UAAU,WAAW,OAAO,QAAQ,IAAI,OAAO;AAC1E;AAEA,eAAe,kBACb,SACA,YAGA,SACe;CACf,KAAK,MAAM,UAAU,SAAS;EAC5B,MAAM,UAAU,WAAW,MAAM;EACjC,IAAI,SACF,MAAM,QAAQ,OAAO;CAEzB;AACF"}
+{"version":3,"file":"plugins.js","names":[],"sources":["../src/plugins.ts"],"sourcesContent":["import type { RuntimeLlmContext } from \"./llm\";\nimport type {\n  AgentEvent,\n  RuntimeInput,\n  UserMessage,\n  UserText,\n} from \"./session/events\";\n\nexport type { InputEventMeta, InputSource } from \"./session/input-meta-types\";\n\ntype MaybePromise<T> = PromiseLike<T> | T;\ntype AgentEventHistory = RuntimeLlmContext[\"history\"];\n\nexport type InterceptableAgentEvent = RuntimeInput | UserMessage | UserText;\n\nexport type AgentPluginInterceptResult =\n  | { readonly action: \"continue\" }\n  | { readonly action: \"handled\" }\n  | { readonly action: \"transform\"; readonly event: InterceptableAgentEvent };\n\nexport type AgentPluginResult = AgentPluginInterceptResult | undefined;\n\nexport interface AgentEventContext {\n  readonly event: AgentEvent;\n  readonly history: AgentEventHistory;\n  readonly signal?: AbortSignal;\n}\n\nexport interface AgentPlugin {\n  readonly events?: {\n    /** @deprecated Use top-level `on`. */\n    readonly on?: (context: AgentEventContext) => MaybePromise<void>;\n  };\n  readonly name?: string;\n  readonly on?: (context: AgentEventContext) => MaybePromise<AgentPluginResult>;\n}\n\nexport type PluginPipelineResult =\n  | { readonly event: AgentEvent; readonly kind: \"emit\" }\n  | { readonly kind: \"handled\" };\n\nexport function runEventPlugins(\n  plugins: readonly AgentPlugin[],\n  context: AgentEventContext\n): Promise<void> {\n  return runPluginsForEvent(plugins, context, { observeOnly: true }).then(\n    () => undefined\n  );\n}\n\nexport function runPluginsForEvent(\n  plugins: readonly AgentPlugin[],\n  context: AgentEventContext,\n  options: { readonly observeOnly?: boolean } = {}\n): Promise<PluginPipelineResult> {\n  return runPluginPipeline(plugins, context, options.observeOnly === true);\n}\n\nfunction isInterceptableEvent(\n  event: AgentEvent\n): event is InterceptableAgentEvent {\n  return (\n    event.type === \"user-text\" ||\n    event.type === \"user-message\" ||\n    event.type === \"runtime-input\"\n  );\n}\n\nfunction resolvePluginHandler(\n  plugin: AgentPlugin\n):\n  | ((context: AgentEventContext) => MaybePromise<AgentPluginResult>)\n  | undefined {\n  if (plugin.on) {\n    return plugin.on;\n  }\n\n  const legacyHandler = plugin.events?.on;\n  if (!legacyHandler) {\n    return;\n  }\n\n  return (legacyContext) =>\n    Promise.resolve(legacyHandler(legacyContext)).then(() => undefined);\n}\n\nfunction normalizeInterceptResult(\n  result: AgentPluginResult | undefined\n): AgentPluginInterceptResult | undefined {\n  if (result === undefined) {\n    return;\n  }\n\n  if (result.action === \"continue\") {\n    return result;\n  }\n\n  if (result.action === \"handled\") {\n    return result;\n  }\n\n  if (result.action === \"transform\") {\n    return result;\n  }\n\n  return;\n}\n\nasync function runPluginPipeline(\n  plugins: readonly AgentPlugin[],\n  context: AgentEventContext,\n  observeOnly: boolean\n): Promise<PluginPipelineResult> {\n  let currentEvent = context.event;\n\n  for (const plugin of plugins) {\n    const handler = resolvePluginHandler(plugin);\n    if (!handler) {\n      continue;\n    }\n\n    const result = await handler({ ...context, event: currentEvent });\n    if (observeOnly || !isInterceptableEvent(currentEvent)) {\n      continue;\n    }\n\n    const intercept = normalizeInterceptResult(result);\n    if (!intercept || intercept.action === \"continue\") {\n      continue;\n    }\n\n    if (intercept.action === \"handled\") {\n      return { kind: \"handled\" };\n    }\n\n    currentEvent = intercept.event;\n  }\n\n  return { kind: \"emit\", event: currentEvent };\n}\n"],"mappings":";AAkDA,SAAgB,mBACd,SACA,SACA,UAA8C,CAAC,GAChB;CAC/B,OAAO,kBAAkB,SAAS,SAAS,QAAQ,gBAAgB,IAAI;AACzE;AAEA,SAAS,qBACP,OACkC;CAClC,OACE,MAAM,SAAS,eACf,MAAM,SAAS,kBACf,MAAM,SAAS;AAEnB;AAEA,SAAS,qBACP,QAGY;CACZ,IAAI,OAAO,IACT,OAAO,OAAO;CAGhB,MAAM,gBAAgB,OAAO,QAAQ;CACrC,IAAI,CAAC,eACH;CAGF,QAAQ,kBACN,QAAQ,QAAQ,cAAc,aAAa,CAAC,EAAE,WAAW,KAAA,CAAS;AACtE;AAEA,SAAS,yBACP,QACwC;CACxC,IAAI,WAAW,KAAA,GACb;CAGF,IAAI,OAAO,WAAW,YACpB,OAAO;CAGT,IAAI,OAAO,WAAW,WACpB,OAAO;CAGT,IAAI,OAAO,WAAW,aACpB,OAAO;AAIX;AAEA,eAAe,kBACb,SACA,SACA,aAC+B;CAC/B,IAAI,eAAe,QAAQ;CAE3B,KAAK,MAAM,UAAU,SAAS;EAC5B,MAAM,UAAU,qBAAqB,MAAM;EAC3C,IAAI,CAAC,SACH;EAGF,MAAM,SAAS,MAAM,QAAQ;GAAE,GAAG;GAAS,OAAO;EAAa,CAAC;EAChE,IAAI,eAAe,CAAC,qBAAqB,YAAY,GACnD;EAGF,MAAM,YAAY,yBAAyB,MAAM;EACjD,IAAI,CAAC,aAAa,UAAU,WAAW,YACrC;EAGF,IAAI,UAAU,WAAW,WACvB,OAAO,EAAE,MAAM,UAAU;EAG3B,eAAe,UAAU;CAC3B;CAEA,OAAO;EAAE,MAAM;EAAQ,OAAO;CAAa;AAC7C"}

package/dist/session/delegate-input.d.ts

@@ -0,0 +1,9 @@
+import { UserInput } from "./input.js";
+
+//#region src/session/delegate-input.d.ts
+declare function delegateUserInput(prompt: unknown, options?: {
+  readonly delegateToolName?: string;
+}): UserInput;
+//#endregion
+export { delegateUserInput };
+//# sourceMappingURL=delegate-input.d.ts.map

package/dist/session/delegate-input.js

@@ -0,0 +1,16 @@
+import { attachInputMeta } from "./input-meta.js";
+//#region src/session/delegate-input.ts
+function delegateUserInput(prompt, options = {}) {
+	if (typeof prompt !== "string") throw new TypeError("Delegate prompt must be a plain string.");
+	return attachInputMeta({
+		type: "user-text",
+		text: prompt
+	}, {
+		delegateToolName: options.delegateToolName,
+		source: "delegate"
+	});
+}
+//#endregion
+export { delegateUserInput };
+
+//# sourceMappingURL=delegate-input.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delegate-input.js","names":[],"sources":["../../src/session/delegate-input.ts"],"sourcesContent":["import type { UserInput } from \"./input\";\nimport { attachInputMeta } from \"./input-meta\";\n\nexport function delegateUserInput(\n  prompt: unknown,\n  options: { readonly delegateToolName?: string } = {}\n): UserInput {\n  if (typeof prompt !== \"string\") {\n    throw new TypeError(\"Delegate prompt must be a plain string.\");\n  }\n\n  return attachInputMeta(\n    {\n      type: \"user-text\",\n      text: prompt,\n    },\n    {\n      delegateToolName: options.delegateToolName,\n      source: \"delegate\",\n    }\n  );\n}\n"],"mappings":";;AAGA,SAAgB,kBACd,QACA,UAAkD,CAAC,GACxC;CACX,IAAI,OAAO,WAAW,UACpB,MAAM,IAAI,UAAU,yCAAyC;CAG/D,OAAO,gBACL;EACE,MAAM;EACN,MAAM;CACR,GACA;EACE,kBAAkB,QAAQ;EAC1B,QAAQ;CACV,CACF;AACF"}

package/dist/session/events.d.ts

@@ -1,3 +1,4 @@
+import { InputEventMeta, InputSource } from "./input-meta-types.js";
 import { UserInput, UserMessage, UserMessageContent, UserMessageContentPart, UserMessageFileData, UserMessageFilePart, UserMessageImagePart, UserMessageTextPart, UserText, UserTextContent } from "./input.js";
 
 //#region src/session/events.d.ts
@@ -7,6 +8,7 @@ interface RuntimeInput {
    * This is distinct from human-originated user-text and user-message input.
    */
   input: UserInput;
+  meta?: InputEventMeta;
   placement: "turn-start" | "step-start" | "step-end";
   type: "runtime-input";
 }
@@ -30,7 +32,6 @@ interface ToolResult {
   toolName: string;
   type: "tool-result";
 }
-type SubagentJobStatus = "aborted" | "cancelled" | "completed" | "error" | "pending" | "running";
 type AgentEvent = /** User input was accepted into the session queue. */UserText /** User multipart input was accepted into the session queue. */ | UserMessage /** Runtime/API-originated input inserted into the current turn, not human input. */ | RuntimeInput /** A queued user input started running as a turn. */ | {
   type: "turn-start";
 } /** The active turn was interrupted before normal completion. */ | {
@@ -42,32 +43,49 @@ type AgentEvent = /** User input was accepted into the session queue. */UserText
   type: "turn-end";
 } /** One model/tool-loop iteration started within the active turn. */ | {
   type: "step-start";
-} /** The model produced reasoning content. */ | AssistantReasoning /** The model produced visible assistant text. */ | AssistantText /** The model requested a tool call. */ | ToolCall /** A tool call returned a result. */ | ToolResult | {
-  description?: string;
-  delegateToolCallId?: string;
-  run_in_background: boolean;
-  subagent: string;
-  task_id?: string;
-  type: "subagent-job-start";
-} | {
-  eventType?: AgentEvent["type"];
-  delegateToolCallId?: string;
-  status: SubagentJobStatus;
-  subagent: string;
-  task_id: string;
-  type: "subagent-job-update";
-} | {
-  error?: string;
-  eventCount: number;
-  delegateToolCallId?: string;
-  status: Exclude<SubagentJobStatus, "pending" | "running">;
-  subagent: string;
-  task_id?: string;
-  type: "subagent-job-end";
-} /** One model/tool-loop iteration finished within the active turn. */ | {
+} /** The model produced reasoning content. */ | AssistantReasoning /** The model produced visible assistant text. */ | AssistantText /** The model requested a tool call. */ | ToolCall /** A tool call returned a result. */ | ToolResult /** One model/tool-loop iteration finished within the active turn. */ | {
   type: "step-end";
 };
 type AgentEventListener = (event: AgentEvent) => void;
+declare const visibleAgentEventTypes: {
+  "assistant-text": true;
+  "user-message": true;
+  "user-text": true;
+};
+declare const lifecycleAgentEventTypes: {
+  "step-end": true;
+  "step-start": true;
+  "turn-abort": true;
+  "turn-end": true;
+  "turn-error": true;
+  "turn-start": true;
+};
+declare const toolAgentEventTypes: {
+  "tool-call": true;
+  "tool-result": true;
+};
+declare const telemetryAgentEventTypes: {
+  "assistant-reasoning": true;
+  "runtime-input": true;
+};
+type VisibleAgentEvent = Extract<AgentEvent, {
+  type: keyof typeof visibleAgentEventTypes;
+}>;
+type LifecycleAgentEvent = Extract<AgentEvent, {
+  type: keyof typeof lifecycleAgentEventTypes;
+}>;
+type ToolAgentEvent = Extract<AgentEvent, {
+  type: keyof typeof toolAgentEventTypes;
+}>;
+type TelemetryAgentEvent = Extract<AgentEvent, {
+  type: keyof typeof telemetryAgentEventTypes;
+}>;
+type ControlAgentEvent = Exclude<AgentEvent, VisibleAgentEvent>;
+declare function isVisibleAgentEvent(event: AgentEvent): event is VisibleAgentEvent;
+declare function isLifecycleAgentEvent(event: AgentEvent): event is LifecycleAgentEvent;
+declare function isToolAgentEvent(event: AgentEvent): event is ToolAgentEvent;
+declare function isTelemetryAgentEvent(event: AgentEvent): event is TelemetryAgentEvent;
+declare function isControlAgentEvent(event: AgentEvent): event is ControlAgentEvent;
 //#endregion
-export { AgentEvent, AgentEventListener, AssistantReasoning, AssistantText, RuntimeInput, ToolCall, ToolResult };
+export { AgentEvent, AgentEventListener, AssistantReasoning, AssistantText, ControlAgentEvent, LifecycleAgentEvent, RuntimeInput, TelemetryAgentEvent, ToolAgentEvent, ToolCall, ToolResult, VisibleAgentEvent, isControlAgentEvent, isLifecycleAgentEvent, isTelemetryAgentEvent, isToolAgentEvent, isVisibleAgentEvent };
 //# sourceMappingURL=events.d.ts.map

package/dist/session/events.js

@@ -0,0 +1,41 @@
+//#region src/session/events.ts
+const visibleAgentEventTypes = {
+	"assistant-text": true,
+	"user-message": true,
+	"user-text": true
+};
+const lifecycleAgentEventTypes = {
+	"step-end": true,
+	"step-start": true,
+	"turn-abort": true,
+	"turn-end": true,
+	"turn-error": true,
+	"turn-start": true
+};
+const toolAgentEventTypes = {
+	"tool-call": true,
+	"tool-result": true
+};
+const telemetryAgentEventTypes = {
+	"assistant-reasoning": true,
+	"runtime-input": true
+};
+function isVisibleAgentEvent(event) {
+	return event.type in visibleAgentEventTypes;
+}
+function isLifecycleAgentEvent(event) {
+	return event.type in lifecycleAgentEventTypes;
+}
+function isToolAgentEvent(event) {
+	return event.type in toolAgentEventTypes;
+}
+function isTelemetryAgentEvent(event) {
+	return event.type in telemetryAgentEventTypes;
+}
+function isControlAgentEvent(event) {
+	return !isVisibleAgentEvent(event);
+}
+//#endregion
+export { isControlAgentEvent, isLifecycleAgentEvent, isTelemetryAgentEvent, isToolAgentEvent, isVisibleAgentEvent };
+
+//# sourceMappingURL=events.js.map

package/dist/session/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","names":[],"sources":["../../src/session/events.ts"],"sourcesContent":["import type { UserInput, UserMessage, UserText } from \"./input\";\nimport type { InputEventMeta } from \"./input-meta-types\";\n\nexport type {\n  UserInput,\n  UserMessage,\n  UserMessageContent,\n  UserMessageContentPart,\n  UserMessageFileData,\n  UserMessageFilePart,\n  UserMessageImagePart,\n  UserMessageTextPart,\n  UserText,\n  UserTextContent,\n} from \"./input\";\nexport type { InputEventMeta, InputSource } from \"./input-meta-types\";\n\nexport interface RuntimeInput {\n  /**\n   * Runtime/API-originated model input inserted into the current turn.\n   * This is distinct from human-originated user-text and user-message input.\n   */\n  input: UserInput;\n  meta?: InputEventMeta;\n  placement: \"turn-start\" | \"step-start\" | \"step-end\";\n  type: \"runtime-input\";\n}\n\nexport interface AssistantText {\n  text: string;\n  type: \"assistant-text\";\n}\nexport interface AssistantReasoning {\n  text: string;\n  type: \"assistant-reasoning\";\n}\nexport interface ToolCall {\n  input: unknown;\n  toolCallId: string;\n  toolName: string;\n  type: \"tool-call\";\n}\nexport interface ToolResult {\n  output: unknown;\n  toolCallId: string;\n  toolName: string;\n  type: \"tool-result\";\n}\n\nexport type AgentEvent =\n  /** User input was accepted into the session queue. */\n  | UserText\n  /** User multipart input was accepted into the session queue. */\n  | UserMessage\n  /** Runtime/API-originated input inserted into the current turn, not human input. */\n  | RuntimeInput\n  /** A queued user input started running as a turn. */\n  | { type: \"turn-start\" }\n  /** The active turn was interrupted before normal completion. */\n  | { type: \"turn-abort\" }\n  /** The active turn hit an unrecoverable runtime failure. */\n  | { type: \"turn-error\"; message: string }\n  /** The active turn completed normally. */\n  | { type: \"turn-end\" }\n  /** One model/tool-loop iteration started within the active turn. */\n  | { type: \"step-start\" }\n  /** The model produced reasoning content. */\n  | AssistantReasoning\n  /** The model produced visible assistant text. */\n  | AssistantText\n  /** The model requested a tool call. */\n  | ToolCall\n  /** A tool call returned a result. */\n  | ToolResult\n  /** One model/tool-loop iteration finished within the active turn. */\n  | { type: \"step-end\" };\n\nexport type AgentEventListener = (event: AgentEvent) => void;\n\nconst visibleAgentEventTypes = {\n  \"assistant-text\": true,\n  \"user-message\": true,\n  \"user-text\": true,\n} satisfies Partial<Record<AgentEvent[\"type\"], true>>;\n\nconst lifecycleAgentEventTypes = {\n  \"step-end\": true,\n  \"step-start\": true,\n  \"turn-abort\": true,\n  \"turn-end\": true,\n  \"turn-error\": true,\n  \"turn-start\": true,\n} satisfies Partial<Record<AgentEvent[\"type\"], true>>;\n\nconst toolAgentEventTypes = {\n  \"tool-call\": true,\n  \"tool-result\": true,\n} satisfies Partial<Record<AgentEvent[\"type\"], true>>;\n\nconst telemetryAgentEventTypes = {\n  \"assistant-reasoning\": true,\n  \"runtime-input\": true,\n} satisfies Partial<Record<AgentEvent[\"type\"], true>>;\n\nexport type VisibleAgentEvent = Extract<\n  AgentEvent,\n  { type: keyof typeof visibleAgentEventTypes }\n>;\nexport type LifecycleAgentEvent = Extract<\n  AgentEvent,\n  { type: keyof typeof lifecycleAgentEventTypes }\n>;\nexport type ToolAgentEvent = Extract<\n  AgentEvent,\n  { type: keyof typeof toolAgentEventTypes }\n>;\nexport type TelemetryAgentEvent = Extract<\n  AgentEvent,\n  { type: keyof typeof telemetryAgentEventTypes }\n>;\nexport type ControlAgentEvent = Exclude<AgentEvent, VisibleAgentEvent>;\n\nexport function isVisibleAgentEvent(\n  event: AgentEvent\n): event is VisibleAgentEvent {\n  return event.type in visibleAgentEventTypes;\n}\n\nexport function isLifecycleAgentEvent(\n  event: AgentEvent\n): event is LifecycleAgentEvent {\n  return event.type in lifecycleAgentEventTypes;\n}\n\nexport function isToolAgentEvent(event: AgentEvent): event is ToolAgentEvent {\n  return event.type in toolAgentEventTypes;\n}\n\nexport function isTelemetryAgentEvent(\n  event: AgentEvent\n): event is TelemetryAgentEvent {\n  return event.type in telemetryAgentEventTypes;\n}\n\nexport function isControlAgentEvent(\n  event: AgentEvent\n): event is ControlAgentEvent {\n  return !isVisibleAgentEvent(event);\n}\n"],"mappings":";AA+EA,MAAM,yBAAyB;CAC7B,kBAAkB;CAClB,gBAAgB;CAChB,aAAa;AACf;AAEA,MAAM,2BAA2B;CAC/B,YAAY;CACZ,cAAc;CACd,cAAc;CACd,YAAY;CACZ,cAAc;CACd,cAAc;AAChB;AAEA,MAAM,sBAAsB;CAC1B,aAAa;CACb,eAAe;AACjB;AAEA,MAAM,2BAA2B;CAC/B,uBAAuB;CACvB,iBAAiB;AACnB;AAoBA,SAAgB,oBACd,OAC4B;CAC5B,OAAO,MAAM,QAAQ;AACvB;AAEA,SAAgB,sBACd,OAC8B;CAC9B,OAAO,MAAM,QAAQ;AACvB;AAEA,SAAgB,iBAAiB,OAA4C;CAC3E,OAAO,MAAM,QAAQ;AACvB;AAEA,SAAgB,sBACd,OAC8B;CAC9B,OAAO,MAAM,QAAQ;AACvB;AAEA,SAAgB,oBACd,OAC4B;CAC5B,OAAO,CAAC,oBAAoB,KAAK;AACnC"}

package/dist/session/input-meta-types.d.ts

@@ -0,0 +1,10 @@
+//#region src/session/input-meta-types.d.ts
+type InputSource = "delegate" | "notify" | "send" | "steer";
+interface InputEventMeta {
+  readonly delegateToolName?: string;
+  readonly source: InputSource;
+  readonly streaming?: "follow-up" | "steer";
+}
+//#endregion
+export { InputEventMeta, InputSource };
+//# sourceMappingURL=input-meta-types.d.ts.map

package/dist/session/input-meta.d.ts

@@ -0,0 +1,13 @@
+import { InputEventMeta, InputSource } from "./input-meta-types.js";
+import { UserInput, UserMessage, UserText } from "./input.js";
+import { AgentEvent, RuntimeInput } from "./events.js";
+
+//#region src/session/input-meta.d.ts
+declare function attachInputMeta(input: UserInput, meta: InputEventMeta): UserText | UserMessage;
+declare function attachRuntimeInputMeta(input: UserInput, placement: RuntimeInput["placement"], meta: InputEventMeta): RuntimeInput;
+declare function stripInputMeta(input: UserInput): UserInput;
+declare function stripEventMeta(event: AgentEvent): AgentEvent;
+declare function userInputFromEvent(event: UserText | UserMessage): UserInput;
+//#endregion
+export { attachInputMeta, attachRuntimeInputMeta, stripEventMeta, stripInputMeta, userInputFromEvent };
+//# sourceMappingURL=input-meta.d.ts.map

package/dist/session/input-meta.js

@@ -0,0 +1,45 @@
+//#region src/session/input-meta.ts
+function attachInputMeta(input, meta) {
+	if (input.type === "user-text") return {
+		...input,
+		meta
+	};
+	return {
+		...input,
+		meta
+	};
+}
+function attachRuntimeInputMeta(input, placement, meta) {
+	return {
+		input: attachInputMeta(input, meta),
+		meta,
+		placement,
+		type: "runtime-input"
+	};
+}
+function stripInputMeta(input) {
+	if (input.type === "user-text") {
+		const { meta: _meta, ...rest } = input;
+		return rest;
+	}
+	const { meta: _meta, ...rest } = input;
+	return rest;
+}
+function stripEventMeta(event) {
+	if (event.type === "user-text" || event.type === "user-message") return stripInputMeta(event);
+	if (event.type === "runtime-input") {
+		const { meta: _meta, ...rest } = event;
+		return {
+			...rest,
+			input: stripInputMeta(event.input)
+		};
+	}
+	return event;
+}
+function userInputFromEvent(event) {
+	return stripInputMeta(event);
+}
+//#endregion
+export { attachInputMeta, attachRuntimeInputMeta, stripEventMeta, stripInputMeta, userInputFromEvent };
+
+//# sourceMappingURL=input-meta.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"input-meta.js","names":[],"sources":["../../src/session/input-meta.ts"],"sourcesContent":["import type { AgentEvent, RuntimeInput } from \"./events\";\nimport type { UserInput, UserMessage, UserText } from \"./input\";\nimport type { InputEventMeta } from \"./input-meta-types\";\n\nexport type { InputEventMeta, InputSource } from \"./input-meta-types\";\n\nexport function attachInputMeta(\n  input: UserInput,\n  meta: InputEventMeta\n): UserText | UserMessage {\n  if (input.type === \"user-text\") {\n    return { ...input, meta };\n  }\n\n  return { ...input, meta };\n}\n\nexport function attachRuntimeInputMeta(\n  input: UserInput,\n  placement: RuntimeInput[\"placement\"],\n  meta: InputEventMeta\n): RuntimeInput {\n  return {\n    input: attachInputMeta(input, meta),\n    meta,\n    placement,\n    type: \"runtime-input\",\n  };\n}\n\nexport function stripInputMeta(input: UserInput): UserInput {\n  if (input.type === \"user-text\") {\n    const { meta: _meta, ...rest } = input;\n    return rest;\n  }\n\n  const { meta: _meta, ...rest } = input;\n  return rest;\n}\n\nexport function stripEventMeta(event: AgentEvent): AgentEvent {\n  if (event.type === \"user-text\" || event.type === \"user-message\") {\n    return stripInputMeta(event);\n  }\n\n  if (event.type === \"runtime-input\") {\n    const { meta: _meta, ...rest } = event;\n    return {\n      ...rest,\n      input: stripInputMeta(event.input),\n    };\n  }\n\n  return event;\n}\n\nexport function userInputFromEvent(event: UserText | UserMessage): UserInput {\n  return stripInputMeta(event);\n}\n"],"mappings":";AAMA,SAAgB,gBACd,OACA,MACwB;CACxB,IAAI,MAAM,SAAS,aACjB,OAAO;EAAE,GAAG;EAAO;CAAK;CAG1B,OAAO;EAAE,GAAG;EAAO;CAAK;AAC1B;AAEA,SAAgB,uBACd,OACA,WACA,MACc;CACd,OAAO;EACL,OAAO,gBAAgB,OAAO,IAAI;EAClC;EACA;EACA,MAAM;CACR;AACF;AAEA,SAAgB,eAAe,OAA6B;CAC1D,IAAI,MAAM,SAAS,aAAa;EAC9B,MAAM,EAAE,MAAM,OAAO,GAAG,SAAS;EACjC,OAAO;CACT;CAEA,MAAM,EAAE,MAAM,OAAO,GAAG,SAAS;CACjC,OAAO;AACT;AAEA,SAAgB,eAAe,OAA+B;CAC5D,IAAI,MAAM,SAAS,eAAe,MAAM,SAAS,gBAC/C,OAAO,eAAe,KAAK;CAG7B,IAAI,MAAM,SAAS,iBAAiB;EAClC,MAAM,EAAE,MAAM,OAAO,GAAG,SAAS;EACjC,OAAO;GACL,GAAG;GACH,OAAO,eAAe,MAAM,KAAK;EACnC;CACF;CAEA,OAAO;AACT;AAEA,SAAgB,mBAAmB,OAA0C;CAC3E,OAAO,eAAe,KAAK;AAC7B"}

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) {
@@ -10,7 +11,10 @@ function addSteeringInput(runtimeInput, input) {
 	const next = runtimeInput.pending.then(() => {
 		if (runtimeInput.closedReason) throw runtimeInputClosedError(runtimeInput.closedReason);
 		queueRuntimeInput(runtimeInput, {
-			input: normalizeAgentInput(input),
+			input: attachInputMeta(normalizeAgentInput(input), {
+				source: "steer",
+				streaming: "steer"
+			}),
 			placement: runtimeInput.steerPlacement ?? runtimeInput.placement ?? "step-end"
 		});
 	});

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 { 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"}
+{"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-events.js

@@ -1,4 +1,4 @@
-import { runEventPlugins } from "../plugins.js";
+import { runPluginsForEvent } from "../plugins.js";
 //#region src/session/session-events.ts
 var SessionEventDispatcher = class {
 	#history;
@@ -35,18 +35,32 @@ var SessionEventDispatcher = class {
 			return Promise.resolve();
 		}
 		if (!activeRun) return Promise.resolve();
-		return this.emitRunEvent(activeRun, event);
+		return this.emitRunEvent(activeRun, event).then(() => void 0);
 	}
 	async emitRunBoundaryEvent(run, event) {
-		await this.#runPlugins(event);
+		await runPluginsForEvent(this.#plugins, {
+			event,
+			history: this.#history(),
+			signal: this.#signal()
+		}, { observeOnly: true });
 		await run.emitBoundary(event);
 	}
 	async emitRunEvent(run, event) {
-		await this.#runPlugins(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);
 	}
-	#runPlugins(event) {
-		return runEventPlugins(this.#plugins, {
+	#runInterceptPipeline(event) {
+		return runPluginsForEvent(this.#plugins, {
 			event,
 			history: this.#history(),
 			signal: this.#signal()

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

@@ -1 +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"}
+{"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-notification.js

@@ -1,11 +1,12 @@
-import { BufferedAgentRun } from "./run.js";
+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: normalizeAgentInput(input),
+		input: attachInputMeta(normalizeAgentInput(input), { source: "notify" }),
 		placement: "turn-start"
 	};
 	const observerEvents = cloneObserverEvents(options.observerEvents ?? []);