@linnlabs/linnkit 0.8.0

package/dist/runtime-kernel/events.js

@@ -0,0 +1,1475 @@
+import { z } from 'zod';
+
+// src/runtime-kernel/events/agentEvents.ts
+function isRecord(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function isMarkedAsSseDispatched(event) {
+  return isRecord(event) && event["__dispatched_via_sse__"] === true;
+}
+function readAgentEventAnswerId(event) {
+  if (!isRecord(event)) return void 0;
+  const snake = event["answer_id"];
+  if (typeof snake === "string" && snake.trim().length > 0) {
+    return snake.trim();
+  }
+  const camel = event["answerId"];
+  if (typeof camel === "string" && camel.trim().length > 0) {
+    return camel.trim();
+  }
+  return void 0;
+}
+function readAgentEventSeq(event) {
+  if (!isRecord(event)) return void 0;
+  const value = event["seq"];
+  return Number.isInteger(value) ? Number(value) : void 0;
+}
+var ProviderReasoningDetails = z.array(z.unknown());
+var ToolCallExtraContent = z.object({
+  google: z.object({
+    thought_signature: z.string().optional()
+  }).passthrough().optional()
+}).passthrough();
+var ToolCallWire = z.object({
+  id: z.string(),
+  type: z.literal("function"),
+  function: z.object({
+    name: z.string(),
+    arguments: z.string()
+  }),
+  extra_content: ToolCallExtraContent.optional()
+}).passthrough();
+z.object({
+  messageType: z.literal("summary"),
+  originalMessageCount: z.number().int().positive(),
+  compressionRatio: z.number().min(0).max(1).optional(),
+  includedOldSummary: z.boolean(),
+  replacedMessageIds: z.array(z.string()),
+  summarySeq: z.number().int().nonnegative()
+});
+z.object({
+  tool_calls: z.array(ToolCallWire),
+  reasoning_details: ProviderReasoningDetails.optional()
+});
+z.object({
+  tool_name: z.string(),
+  args: z.record(z.unknown()).optional(),
+  tool_call_id: z.string()
+});
+var ImageInfoMeta = z.object({
+  url: z.string().optional(),
+  width: z.number().int().positive().optional(),
+  height: z.number().int().positive().optional(),
+  format: z.string().optional(),
+  size: z.number().int().nonnegative().optional()
+});
+z.object({
+  taskType: z.string().optional(),
+  taskId: z.string().optional(),
+  taskStatus: z.enum(["requested", "in_progress", "completed", "failed"]).optional(),
+  taskTrackingInfo: z.object({
+    startTime: z.number().optional(),
+    endTime: z.number().optional(),
+    duration: z.number().optional(),
+    retryCount: z.number().int().nonnegative().optional(),
+    lastError: z.string().optional()
+  }).optional()
+});
+var PersistentMetadata = z.object({
+  messageType: z.literal("summary").optional(),
+  originalMessageCount: z.number().int().positive().optional(),
+  compressionRatio: z.number().min(0).max(1).optional(),
+  includedOldSummary: z.boolean().optional(),
+  replacedMessageIds: z.array(z.string()).optional(),
+  summarySeq: z.number().int().nonnegative().optional(),
+  tool_calls: z.array(ToolCallWire).optional(),
+  reasoning_details: ProviderReasoningDetails.optional(),
+  tool_name: z.string().optional(),
+  args: z.record(z.unknown()).optional(),
+  tool_call_id: z.string().optional(),
+  raw_output: z.string().optional(),
+  image_info: ImageInfoMeta.optional(),
+  taskType: z.string().optional(),
+  taskId: z.string().optional(),
+  taskStatus: z.enum(["requested", "in_progress", "completed", "failed"]).optional(),
+  taskTrackingInfo: z.object({
+    startTime: z.number().optional(),
+    endTime: z.number().optional(),
+    duration: z.number().optional(),
+    retryCount: z.number().int().nonnegative().optional(),
+    lastError: z.string().optional()
+  }).optional(),
+  fenceKind: z.string().optional(),
+  fenceAttrs: z.record(z.unknown()).optional(),
+  fencePlacement: z.string().optional()
+}).passthrough();
+var BaseMessage = z.object({
+  id: z.string(),
+  content: z.string(),
+  timestamp: z.number().int().nonnegative(),
+  metadata: PersistentMetadata.optional()
+});
+var SystemMessage = BaseMessage.extend({
+  role: z.literal("system"),
+  type: z.enum(["system_prompt", "history_summary", "context_injection"])
+});
+var UserMessage = BaseMessage.extend({
+  role: z.literal("user"),
+  type: z.enum([
+    "user_input",
+    "context_injection",
+    "context_before",
+    "context_after",
+    "document_fragment",
+    "task_request",
+    "image"
+  ])
+});
+var AssistantMessage = BaseMessage.extend({
+  role: z.literal("assistant"),
+  type: z.enum([
+    "thought",
+    "final_answer",
+    "tool_code",
+    "tool_calls",
+    "task_completion"
+  ])
+});
+var ToolMessage = BaseMessage.extend({
+  role: z.literal("tool"),
+  type: z.literal("tool_output")
+});
+z.discriminatedUnion("role", [
+  SystemMessage,
+  UserMessage,
+  AssistantMessage,
+  ToolMessage
+]);
+var SerializableJsonValueSchema = z.lazy(
+  () => z.union([
+    z.string(),
+    z.number(),
+    z.boolean(),
+    z.null(),
+    z.array(SerializableJsonValueSchema),
+    z.record(z.string(), SerializableJsonValueSchema)
+  ])
+);
+var SerializableJsonRecord = z.record(z.string(), SerializableJsonValueSchema);
+var AgentSpecMessageType = z.enum([
+  "system_prompt",
+  "history_summary",
+  "context_injection",
+  "user_input",
+  "context_before",
+  "context_after",
+  "document_fragment",
+  "task_request",
+  "image",
+  "thought",
+  "final_answer",
+  "tool_code",
+  "tool_calls",
+  "task_completion",
+  "tool_output"
+]);
+var AgentSpecBudgetPolicy = z.object({
+  maxTokens: z.number().int().positive().optional(),
+  reservedForResponse: z.number().int().nonnegative().optional(),
+  workingMemoryBudgetPercentage: z.number().min(0).max(1).optional()
+});
+var AgentSpecToolHistoryPolicy = z.object({
+  strategy: z.enum(["per-pair", "per-run", "none"]).optional(),
+  keepLatestToolPairs: z.number().int().nonnegative().optional(),
+  keepLatestRuns: z.number().int().nonnegative().optional(),
+  maxInteractionGroups: z.number().int().nonnegative().optional(),
+  overflowStrategy: z.enum(["keep-latest", "fail-fast"]).optional(),
+  maxPairTokens: z.number().int().nonnegative().optional(),
+  maxOutputSummaryTokens: z.number().int().nonnegative().optional()
+});
+var AgentSpecToolObservationGovernancePolicy = z.object({
+  enabled: z.boolean().optional(),
+  maxChars: z.number().int().positive().optional(),
+  maxLines: z.number().int().positive().optional()
+});
+var AgentSpecToolOutputPolicy = z.object({
+  observationGovernance: AgentSpecToolObservationGovernancePolicy.optional()
+});
+var AgentSpecProviderReplayPolicy = z.object({
+  provider: z.string().min(1).optional(),
+  requiresReasoningDetailsForToolReplay: z.boolean().optional(),
+  missingSidecarBehavior: z.enum(["allow", "degrade_to_text", "provider_empty_replay_field"]).optional()
+});
+var AgentSpecSummarizationPolicy = z.object({
+  triggerThreshold: z.number().min(0).max(1).optional(),
+  budgetPercentage: z.number().min(0).max(1).optional(),
+  oldestMessagesPercentage: z.number().min(0).max(1).optional(),
+  agentId: z.string().min(1).optional(),
+  failureBehavior: z.enum(["fail-fast", "continue-if-within-budget"]).optional()
+});
+var AgentSpecMustKeepTruncationRule = z.object({
+  fenceKind: z.string().min(1),
+  maxBudgetFraction: z.number().gt(0).max(1),
+  strategyName: z.string().min(1)
+});
+var AgentSpecMustKeepPolicy = z.object({
+  alwaysKeepTypes: z.array(AgentSpecMessageType).optional(),
+  alwaysKeepFenceKinds: z.array(z.string().min(1)).optional(),
+  truncationRules: z.array(AgentSpecMustKeepTruncationRule).optional()
+});
+var AgentSpecWorkingMemoryPolicy = z.object({
+  maxRecentToolInteractions: z.number().int().nonnegative().optional(),
+  minToolInteractionsToKeep: z.number().int().nonnegative().optional(),
+  toolPairingSearchRange: z.number().int().positive().optional()
+});
+var AgentSpecCheckpointPolicy = z.object({
+  keepPairsBefore: z.number().int().nonnegative().optional(),
+  triggerToolName: z.string().min(1).optional()
+});
+var AgentSpecReasoningRetentionPolicy = z.object({
+  keepLatestThoughts: z.number().int().nonnegative().optional()
+});
+var AgentSpecTokenEstimationPolicy = z.object({
+  encoding: z.string().min(1).optional(),
+  avgCharsPerToken: z.number().positive().optional(),
+  toolCallOverhead: z.number().int().nonnegative().optional()
+});
+var AgentSpecSystemReminderTrigger = z.object({
+  kind: z.string().min(1),
+  threshold: z.number().nonnegative().optional(),
+  value: z.union([z.string(), z.number(), z.boolean()]).optional(),
+  moduloStep: z.boolean().optional(),
+  toolName: z.string().min(1).optional(),
+  period: z.number().int().positive().optional(),
+  minStep: z.number().int().nonnegative().optional(),
+  ratio: z.number().min(0).max(1).optional(),
+  config: SerializableJsonRecord.optional()
+});
+var AgentSpecSystemReminderExtraRule = z.object({
+  id: z.string().min(1),
+  trigger: AgentSpecSystemReminderTrigger,
+  contentTemplate: z.string().min(1),
+  contentArgs: SerializableJsonRecord.optional()
+});
+var AgentSpecSystemReminderPolicy = z.object({
+  enabledRuleIds: z.array(z.string().min(1)).nullable().optional(),
+  disabledRuleIds: z.array(z.string().min(1)).optional(),
+  thresholds: z.object({
+    toolCallStreak: z.number().int().nonnegative().optional(),
+    taskstateReflectionPeriod: z.number().int().positive().optional(),
+    budgetWarningRatio: z.number().min(0).max(1).optional(),
+    lastStepsHintThreshold: z.number().int().nonnegative().optional()
+  }).optional(),
+  extraRules: z.array(AgentSpecSystemReminderExtraRule).optional()
+}).superRefine((value, ctx) => {
+  if (value.enabledRuleIds !== void 0 && value.enabledRuleIds !== null && value.disabledRuleIds?.length) {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      path: ["disabledRuleIds"],
+      message: "enabledRuleIds and disabledRuleIds cannot be configured at the same time"
+    });
+  }
+});
+var AgentSpecContextTracePolicy = z.object({
+  enabled: z.boolean().optional(),
+  includeMessageIds: z.boolean().optional(),
+  includeTokenBreakdown: z.boolean().optional(),
+  maxTraceEvents: z.number().int().positive().optional()
+});
+var AgentSpecContextPolicy = z.object({
+  profileId: z.string().min(1),
+  budget: AgentSpecBudgetPolicy.optional(),
+  toolHistory: AgentSpecToolHistoryPolicy.optional(),
+  toolOutput: AgentSpecToolOutputPolicy.optional(),
+  providerReplay: AgentSpecProviderReplayPolicy.optional(),
+  summarization: AgentSpecSummarizationPolicy.optional(),
+  mustKeep: AgentSpecMustKeepPolicy.optional(),
+  workingMemory: AgentSpecWorkingMemoryPolicy.optional(),
+  checkpoint: AgentSpecCheckpointPolicy.optional(),
+  reasoningRetention: AgentSpecReasoningRetentionPolicy.optional(),
+  tokenEstimation: AgentSpecTokenEstimationPolicy.optional(),
+  systemReminder: AgentSpecSystemReminderPolicy.optional(),
+  contextTrace: AgentSpecContextTracePolicy.optional()
+});
+var JsonRecord = z.record(z.string(), z.unknown());
+var ToolArgsSchemaSpec = JsonRecord.superRefine((value, ctx) => {
+  const parse = value["parse"];
+  const safeParse = value["safeParse"];
+  const definition = value["_def"];
+  if (typeof parse === "function" && typeof safeParse === "function" && definition !== void 0) {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      message: "argsSchema must be a serializable record, not a runtime zod schema"
+    });
+  }
+});
+var AgentCapability = z.string().min(1);
+var ToolBindingSpec = z.object({
+  toolId: z.string().min(1),
+  bindingId: z.string().min(1).optional(),
+  argsSchema: ToolArgsSchemaSpec.optional(),
+  config: JsonRecord.optional(),
+  metadata: JsonRecord.optional()
+});
+var AgentSpecModelHints = z.object({
+  preferredProviders: z.array(z.string().min(1)).optional(),
+  preferredModels: z.array(z.string().min(1)).optional(),
+  fallbackChain: z.array(z.string().min(1)).optional()
+});
+var AgentSpecAuditConfig = z.object({
+  redactionLevel: z.enum(["none", "standard", "strict"]).optional(),
+  pii: z.boolean().optional()
+});
+z.object({
+  id: z.string().min(1),
+  version: z.string().min(1),
+  role: z.string().optional(),
+  description: z.string().optional(),
+  capabilities: z.array(AgentCapability),
+  tools: z.array(ToolBindingSpec),
+  contextPolicy: AgentSpecContextPolicy,
+  modelHints: AgentSpecModelHints.optional(),
+  audit: AgentSpecAuditConfig.optional(),
+  metadata: JsonRecord.optional()
+});
+var JsonRecord2 = z.record(z.string(), z.unknown());
+var AUDIT_DECISION_OUTCOMES = [
+  "allowed",
+  "denied",
+  "fallback",
+  "retry",
+  "cancelled",
+  "paused",
+  "resumed",
+  "requested",
+  "recorded"
+];
+var AuditActor = z.object({
+  kind: z.enum(["system", "host", "agent", "model", "tool", "user"]),
+  id: z.string().min(1).optional(),
+  name: z.string().min(1).optional()
+});
+var AuditDecision = z.object({
+  outcome: z.enum(AUDIT_DECISION_OUTCOMES),
+  reason: z.string().optional(),
+  policy: z.string().optional(),
+  metadata: JsonRecord2.optional()
+});
+var AuditEvidence = z.object({
+  kind: z.string().min(1),
+  ref: z.string().min(1).optional(),
+  summary: z.string().optional(),
+  metadata: JsonRecord2.optional()
+});
+var AuditCostDelta = z.object({
+  tokensInput: z.number().int().nonnegative().optional(),
+  tokensOutput: z.number().int().nonnegative().optional(),
+  totalCostUsd: z.number().nonnegative().optional(),
+  latencyMs: z.number().nonnegative().optional()
+});
+var AuditScope = z.object({
+  conversationId: z.string().min(1).optional(),
+  runId: z.string().min(1).optional(),
+  parentRunId: z.string().min(1).optional(),
+  turnId: z.string().min(1).optional(),
+  traceId: z.string().min(1).optional(),
+  agentSpecId: z.string().min(1).optional(),
+  toolCallId: z.string().min(1).optional(),
+  toolName: z.string().min(1).optional(),
+  modelId: z.string().min(1).optional(),
+  nodeId: z.string().min(1).optional(),
+  metadata: JsonRecord2.optional()
+});
+var AuditEnvelope = z.object({
+  envelopeId: z.string().min(1),
+  runId: z.string().min(1),
+  parentRunId: z.string().min(1).optional(),
+  ts: z.number().int().nonnegative(),
+  actor: AuditActor,
+  action: z.string().min(1),
+  decision: AuditDecision.optional(),
+  evidence: z.array(AuditEvidence).optional(),
+  costDelta: AuditCostDelta.optional(),
+  scope: AuditScope.optional()
+});
+var BaseEvent = z.object({
+  id: z.string(),
+  conversation_id: z.string(),
+  timestamp: z.number(),
+  metadata: z.record(z.unknown()).optional(),
+  version: z.literal(1).default(1),
+  turn_id: z.string(),
+  ephemeral: z.boolean().optional()
+});
+var ToolCallPhase = z.enum(["start", "update", "complete", "error"]);
+var Status = z.enum(["loading", "success", "error"]);
+var AgentTodoStatus = z.enum(["pending", "in_progress", "completed", "cancelled"]);
+var AgentTodoItem = z.object({
+  id: z.string(),
+  content: z.string(),
+  status: AgentTodoStatus
+});
+var ProviderReasoningDetailsPayload = z.array(z.unknown());
+var ToolCallDecisionPayload = z.object({
+  args: z.record(z.any()).optional(),
+  tool_calls: z.array(z.unknown()).optional(),
+  /**
+   * 不透明 provider reasoning replay blocks。
+   *
+      * RuntimeEvent 层的标准位置是 assistant 产出事件携带 reasoning_details；
+      * context-manager 会把它回放到 AiMessage.metadata.reasoning_details。
+   */
+  reasoning_details: ProviderReasoningDetailsPayload.optional()
+}).passthrough();
+z.discriminatedUnion("type", [
+  BaseEvent.extend({
+    type: z.literal("user_input"),
+    content: z.string(),
+    raw_content: z.string().optional(),
+    source: z.enum(["user", "editor", "system"]).default("user")
+  }),
+  BaseEvent.extend({
+    type: z.literal("thought"),
+    content: z.string(),
+    thought_message_id: z.string().optional(),
+    delta: z.string().optional(),
+    is_complete: z.boolean().default(false)
+  }),
+  BaseEvent.extend({
+    type: z.literal("tool_call_decision"),
+    tool_name: z.string(),
+    tool_call_id: z.string(),
+    phase: ToolCallPhase,
+    status: Status,
+    args: z.record(z.any()).optional(),
+    payload: ToolCallDecisionPayload.optional(),
+    parent_tool_call_id: z.string().optional(),
+    meta: z.record(z.any()).optional()
+  }),
+  BaseEvent.extend({
+    type: z.literal("tool_process"),
+    tool_name: z.string(),
+    tool_call_id: z.string(),
+    phase: ToolCallPhase,
+    status: Status,
+    args: z.record(z.any()).optional(),
+    payload: z.record(z.any()).optional(),
+    parent_tool_call_id: z.string().optional(),
+    meta: z.record(z.any()).optional()
+  }),
+  BaseEvent.extend({
+    type: z.literal("tool_output"),
+    tool_name: z.string(),
+    tool_call_id: z.string(),
+    status: z.enum(["success", "error"]),
+    output: z.any().optional(),
+    payload: z.record(z.any()).optional(),
+    error: z.string().optional(),
+    duration_ms: z.number().optional()
+  }),
+  BaseEvent.extend({
+    type: z.literal("todo_updated"),
+    todo_list_id: z.string(),
+    todo_list_version: z.number().int().nonnegative(),
+    items: z.array(AgentTodoItem)
+  }),
+  BaseEvent.extend({
+    type: z.literal("subrun_trace"),
+    parent_tool_call_id: z.string(),
+    subrun_id: z.string(),
+    subrun_parent_id: z.string().optional(),
+    kind: z.enum([
+      "thought_delta",
+      "thought_complete",
+      "tool_call_decision",
+      "tool_process",
+      "tool_output",
+      "final_answer_chunk",
+      "final_answer"
+    ]),
+    delta: z.string().optional(),
+    content: z.string().optional(),
+    tool_name: z.string().optional(),
+    tool_call_id: z.string().optional(),
+    phase: ToolCallPhase.optional(),
+    status: Status.optional(),
+    args: z.unknown().optional(),
+    output: z.unknown().optional(),
+    duration_ms: z.number().optional(),
+    meta: z.record(z.unknown()).optional()
+  }),
+  BaseEvent.extend({
+    type: z.literal("requires_user_interaction"),
+    form: z.any().optional(),
+    interaction_type: z.string().optional(),
+    prompt: z.string().optional()
+  }),
+  BaseEvent.extend({
+    type: z.literal("audit_envelope"),
+    envelope: AuditEnvelope
+  }),
+  BaseEvent.extend({
+    type: z.literal("final_answer"),
+    answer_id: z.string(),
+    content: z.string(),
+    is_complete: z.boolean().default(true),
+    reasoning_details: ProviderReasoningDetailsPayload.optional(),
+    meta: z.record(z.any()).optional()
+  }),
+  BaseEvent.extend({
+    type: z.literal("final_answer_chunk"),
+    answer_id: z.string(),
+    seq: z.number().int().nonnegative(),
+    content: z.string(),
+    is_last: z.boolean().optional()
+  }),
+  BaseEvent.extend({
+    type: z.literal("history_summary"),
+    content: z.string(),
+    replaced_message_ids: z.array(z.string()),
+    summary_seq: z.number().int().nonnegative(),
+    original_message_count: z.number().int().nonnegative().optional(),
+    compression_ratio: z.number().min(0).max(1).optional(),
+    included_old_summary: z.boolean().optional()
+  }),
+  BaseEvent.extend({
+    type: z.literal("error"),
+    error: z.string(),
+    details: z.any().optional(),
+    error_code: z.string().optional(),
+    retryable: z.boolean().optional()
+  }),
+  BaseEvent.extend({
+    type: z.literal("control"),
+    op: z.enum(["truncate_after", "replace", "redo", "branch"]),
+    target_id: z.string().optional(),
+    reason: z.string().optional(),
+    meta: z.any().optional()
+  }),
+  BaseEvent.extend({
+    type: z.literal("stream_end"),
+    reason: z.enum(["complete", "error", "interrupted", "timeout"]).optional(),
+    reason_message: z.string().optional(),
+    stats: z.object({
+      total_events: z.number().optional(),
+      duration_ms: z.number().optional(),
+      error_count: z.number().optional()
+    }).optional()
+  })
+]);
+var createThoughtEvent = (id, conversationId, turnId, content, options = {}) => ({
+  type: "thought",
+  id,
+  conversation_id: conversationId,
+  turn_id: turnId,
+  timestamp: Date.now(),
+  version: 1,
+  content,
+  is_complete: false,
+  ...options
+});
+var createToolCallDecisionEvent = (id, conversationId, turnId, toolName, toolCallId, options = {}) => ({
+  type: "tool_call_decision",
+  id,
+  conversation_id: conversationId,
+  turn_id: turnId,
+  timestamp: Date.now(),
+  version: 1,
+  tool_name: toolName,
+  tool_call_id: toolCallId,
+  phase: "start",
+  status: "loading",
+  ...options
+});
+var createToolProcessEvent = (id, conversationId, turnId, toolName, toolCallId, options = {}) => ({
+  type: "tool_process",
+  id,
+  conversation_id: conversationId,
+  turn_id: turnId,
+  timestamp: Date.now(),
+  version: 1,
+  tool_name: toolName,
+  tool_call_id: toolCallId,
+  phase: "start",
+  status: "loading",
+  ...options
+});
+var createToolOutputEvent = (id, conversationId, turnId, toolName, toolCallId, output, status = "success", options = {}) => ({
+  type: "tool_output",
+  id,
+  conversation_id: conversationId,
+  turn_id: turnId,
+  timestamp: Date.now(),
+  version: 1,
+  tool_name: toolName,
+  tool_call_id: toolCallId,
+  status,
+  output,
+  ...options
+});
+var createFinalAnswerEvent = (id, conversationId, turnId, answerId, content, options = {}) => ({
+  type: "final_answer",
+  id,
+  conversation_id: conversationId,
+  turn_id: turnId,
+  timestamp: Date.now(),
+  version: 1,
+  answer_id: answerId,
+  content,
+  is_complete: true,
+  ...options
+});
+var createFinalAnswerChunkEvent = (id, conversationId, turnId, answerId, seq, content, options = {}) => ({
+  type: "final_answer_chunk",
+  id,
+  conversation_id: conversationId,
+  turn_id: turnId,
+  timestamp: Date.now(),
+  version: 1,
+  answer_id: answerId,
+  seq,
+  content,
+  ...options
+});
+var createErrorEvent = (id, conversationId, turnId, error, options = {}) => ({
+  type: "error",
+  id,
+  conversation_id: conversationId,
+  turn_id: turnId,
+  timestamp: Date.now(),
+  version: 1,
+  error,
+  ...options
+});
+var ExecutionTraceContext = z.object({
+  execution_id: z.string().describe("The unique identifier for a single, complete execution flow."),
+  trace_id: z.string().optional().describe("An optional trace ID for correlating logs in an APM system.")
+});
+z.object({
+  seq: z.number().int().nonnegative().describe("A monotonically increasing sequence number within a single execution."),
+  timestamp: z.number().describe("The high-precision timestamp of when the event occurred."),
+  trace: ExecutionTraceContext,
+  source: z.string().describe("The origin of the event, e.g., 'ai', 'tool:file_reader', 'system:summary'."),
+  payload: z.unknown(),
+  render_hint: z.object({
+    card: z.enum(["normal", "collapsible", "none", "image", "interactive"]).optional().describe("Hint for how the UI card should be rendered."),
+    content: z.enum(["markdown", "text", "json", "image_url", "code"]).default("text").describe("Hint for how the content itself should be interpreted.")
+  }).optional(),
+  run_location: z.enum(["frontend", "backend"]).optional().describe("Specifies where a tool action should be or was executed.")
+});
+var BaseSSEEvent = z.object({
+  id: z.string(),
+  timestamp: z.number(),
+  conversation_id: z.string(),
+  turn_id: z.string(),
+  metadata: z.record(z.unknown()).optional()
+});
+var SSEThoughtEvent = BaseSSEEvent.extend({
+  type: z.literal("thought"),
+  thought_message_id: z.string().optional(),
+  delta: z.string().optional(),
+  content: z.string().optional(),
+  is_complete: z.boolean().default(false)
+});
+var SSEFinalAnswerChunkEvent = BaseSSEEvent.extend({
+  type: z.literal("final_answer_chunk"),
+  answer_id: z.string(),
+  seq: z.number().int().nonnegative(),
+  chunk: z.string(),
+  is_last: z.boolean().optional()
+});
+var SSEFinalAnswerEvent = BaseSSEEvent.extend({
+  type: z.literal("final_answer"),
+  answer_id: z.string(),
+  content: z.string(),
+  meta: z.record(z.any()).optional()
+});
+var SSEMarkdownChunkEvent = BaseSSEEvent.extend({
+  type: z.literal("markdown_chunk"),
+  content_type: z.enum(["text", "code", "table", "image"]).default("text"),
+  text: z.string(),
+  seq: z.number().optional()
+});
+var BaseSSEToolLifecycleEvent = BaseSSEEvent.extend({
+  tool_name: z.string(),
+  tool_call_id: z.string(),
+  phase: z.enum(["start", "update", "complete", "error"]),
+  status: z.enum(["loading", "success", "error"]),
+  args: z.any().optional(),
+  payload: z.any().optional(),
+  meta: z.record(z.any()).optional()
+});
+var SSEToolCallDecisionEvent = BaseSSEToolLifecycleEvent.extend({
+  type: z.literal("tool_call_decision")
+});
+var SSEToolProcessEvent = BaseSSEToolLifecycleEvent.extend({
+  type: z.literal("tool_process")
+});
+var SSEToolOutputEvent = BaseSSEEvent.extend({
+  type: z.literal("tool_output"),
+  tool_name: z.string(),
+  tool_call_id: z.string(),
+  status: z.enum(["success", "error"]),
+  output: z.any().optional(),
+  payload: z.record(z.any()).optional(),
+  duration_ms: z.number().optional()
+});
+var SSETodoUpdatedEvent = BaseSSEEvent.extend({
+  type: z.literal("todo_updated"),
+  todo_list_id: z.string(),
+  todo_list_version: z.number().int().nonnegative(),
+  items: z.array(z.object({
+    id: z.string(),
+    content: z.string(),
+    status: z.enum(["pending", "in_progress", "completed", "cancelled"])
+  }))
+});
+var SSESubRunTraceEvent = BaseSSEEvent.extend({
+  type: z.literal("subrun_trace"),
+  parent_tool_call_id: z.string(),
+  subrun_id: z.string(),
+  subrun_parent_id: z.string().optional(),
+  kind: z.enum([
+    "thought_delta",
+    "thought_complete",
+    "tool_call_decision",
+    "tool_process",
+    "tool_output",
+    "final_answer_chunk",
+    "final_answer"
+  ]),
+  delta: z.string().optional(),
+  content: z.string().optional(),
+  tool_name: z.string().optional(),
+  tool_call_id: z.string().optional(),
+  phase: z.enum(["start", "update", "complete", "error"]).optional(),
+  status: z.enum(["loading", "success", "error"]).optional(),
+  args: z.unknown().optional(),
+  output: z.unknown().optional(),
+  duration_ms: z.number().optional(),
+  meta: z.record(z.unknown()).optional()
+});
+var SSERequiresUserInteractionEvent = BaseSSEEvent.extend({
+  type: z.literal("requires_user_interaction"),
+  form: z.any().optional(),
+  interaction_type: z.string().optional(),
+  prompt: z.string().optional()
+});
+var SSEErrorEvent = BaseSSEEvent.extend({
+  type: z.literal("error"),
+  error: z.string(),
+  details: z.any().optional(),
+  error_code: z.string().optional(),
+  retryable: z.boolean().optional()
+});
+var SSEStreamEndEvent = BaseSSEEvent.extend({
+  type: z.literal("stream_end"),
+  reason: z.enum(["complete", "error", "interrupted", "timeout"]).optional(),
+  reason_message: z.string().optional(),
+  stats: z.object({
+    total_events: z.number().optional(),
+    duration_ms: z.number().optional(),
+    error_count: z.number().optional(),
+    benchmark: z.record(z.unknown()).optional()
+  }).optional()
+});
+var SSEHistorySummaryEvent = BaseSSEEvent.extend({
+  type: z.literal("history_summary"),
+  summary_id: z.string(),
+  content: z.string(),
+  original_message_count: z.number().int().nonnegative(),
+  summary_seq: z.number().int().nonnegative()
+});
+var SSESummarizationStartEvent = BaseSSEEvent.extend({
+  type: z.literal("summarization_start"),
+  originalMessages: z.number().optional()
+});
+var SSESummarizationEndEvent = BaseSSEEvent.extend({
+  type: z.literal("summarization_end"),
+  originalMessages: z.number().optional(),
+  compressedMessages: z.number().optional(),
+  compressionRatio: z.string().optional(),
+  timeSaved: z.string().optional()
+});
+var SSESummarizationErrorEvent = BaseSSEEvent.extend({
+  type: z.literal("summarization_error"),
+  error: z.string()
+});
+z.discriminatedUnion("type", [
+  SSEThoughtEvent,
+  SSEFinalAnswerChunkEvent,
+  SSEFinalAnswerEvent,
+  SSEMarkdownChunkEvent,
+  SSEToolCallDecisionEvent,
+  SSEToolProcessEvent,
+  SSEToolOutputEvent,
+  SSETodoUpdatedEvent,
+  SSESubRunTraceEvent,
+  SSERequiresUserInteractionEvent,
+  SSEErrorEvent,
+  SSEStreamEndEvent,
+  SSEHistorySummaryEvent,
+  SSESummarizationStartEvent,
+  SSESummarizationEndEvent,
+  SSESummarizationErrorEvent
+]);
+var createSSEThoughtEvent = (id, conversationId, turnId, options = {}) => ({
+  type: "thought",
+  id,
+  timestamp: Date.now(),
+  conversation_id: conversationId,
+  turn_id: turnId,
+  is_complete: false,
+  ...options
+});
+var createSSEFinalAnswerChunkEvent = (id, conversationId, turnId, answerId, seq, chunk, options = {}) => ({
+  type: "final_answer_chunk",
+  id,
+  timestamp: Date.now(),
+  conversation_id: conversationId,
+  turn_id: turnId,
+  answer_id: answerId,
+  seq,
+  chunk,
+  ...options
+});
+var createSSEFinalAnswerEvent = (id, conversationId, turnId, answerId, content, options = {}) => ({
+  type: "final_answer",
+  id,
+  timestamp: Date.now(),
+  conversation_id: conversationId,
+  turn_id: turnId,
+  answer_id: answerId,
+  content,
+  ...options
+});
+var createSSEToolCallDecisionEvent = (id, conversationId, turnId, toolName, toolCallId, phase, status, options = {}) => ({
+  type: "tool_call_decision",
+  id,
+  timestamp: Date.now(),
+  conversation_id: conversationId,
+  turn_id: turnId,
+  tool_name: toolName,
+  tool_call_id: toolCallId,
+  phase,
+  status,
+  ...options
+});
+var createSSEToolProcessEvent = (id, conversationId, turnId, toolName, toolCallId, phase, status, options = {}) => ({
+  type: "tool_process",
+  id,
+  timestamp: Date.now(),
+  conversation_id: conversationId,
+  turn_id: turnId,
+  tool_name: toolName,
+  tool_call_id: toolCallId,
+  phase,
+  status,
+  ...options
+});
+var createSSEToolOutputEvent = (id, conversationId, turnId, toolName, toolCallId, status, output, options = {}) => ({
+  type: "tool_output",
+  id,
+  timestamp: Date.now(),
+  conversation_id: conversationId,
+  turn_id: turnId,
+  tool_name: toolName,
+  tool_call_id: toolCallId,
+  status,
+  output,
+  ...options
+});
+var createSSEErrorEvent = (id, conversationId, turnId, error, options = {}) => ({
+  type: "error",
+  id,
+  timestamp: Date.now(),
+  conversation_id: conversationId,
+  turn_id: turnId,
+  error,
+  ...options
+});
+
+// src/shared/ids.ts
+function isoRandomUUID() {
+  const c = globalThis.crypto;
+  if (c && typeof c.randomUUID === "function") {
+    return c.randomUUID();
+  }
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (ch) => {
+    const r = Math.random() * 16 | 0;
+    const v = ch === "x" ? r : r & 3 | 8;
+    return v.toString(16);
+  });
+}
+function shortRandomId(prefix) {
+  return `${prefix}-${isoRandomUUID().replace(/-/g, "").slice(0, 12)}`;
+}
+function generateMessageId() {
+  return shortRandomId("msg");
+}
+
+// src/runtime-kernel/events/provider-sidecar.ts
+var isRecord2 = (value) => !!value && typeof value === "object" && !Array.isArray(value);
+var isToolCallWire = (value) => {
+  if (!isRecord2(value)) return false;
+  if (typeof value.id !== "string") return false;
+  if (value.type !== "function") return false;
+  const fn = value.function;
+  return isRecord2(fn) && typeof fn.name === "string" && typeof fn.arguments === "string";
+};
+function resolveToolDisplayOptions(toolName, toolPresentationPort) {
+  return toolPresentationPort?.getDisplayOptions(toolName);
+}
+function readAnswerIdFromEvent(event) {
+  if (!isRecord2(event)) return void 0;
+  const value = event["answerId"];
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
+}
+function readMetaFromEvent(event) {
+  if (!isRecord2(event)) return void 0;
+  const value = event["meta"];
+  return isRecord2(value) ? value : void 0;
+}
+
+// src/runtime-kernel/events/agent-to-runtime.ts
+function agentEventToRuntime(agentEvent, context, options = {}) {
+  if (!agentEvent || typeof agentEvent !== "object") return null;
+  if (isRecord2(agentEvent) && agentEvent["type"] === "history_summary") {
+    const evt = agentEvent;
+    if (context.metadata) {
+      evt.metadata = { ...evt.metadata ?? {}, ...context.metadata };
+    }
+    return evt;
+  }
+  const typed = agentEvent;
+  const { conversationId, turnId } = context;
+  const timestamp = typed.timestamp ?? context.timestamp ?? Date.now();
+  const id = typed.id ?? generateMessageId();
+  const contextMeta = context.metadata;
+  switch (typed.type) {
+    case "thought":
+      return mapThoughtToRuntime(typed, context, options, id, timestamp);
+    case "tool_call_decision":
+    case "tool_process":
+      return mapToolProgressToRuntime(typed, context, options, id, timestamp);
+    case "observation": {
+      const observationEvent = typed;
+      const toolName = observationEvent.tool_name || "unknown_tool";
+      const toolCallId = observationEvent.tool_call_id || `call_${id}`;
+      const success = observationEvent.success ?? !/^错误[:：]/i.test(String(observationEvent.output ?? ""));
+      const payload = observationEvent.payload || {};
+      const event = createToolOutputEvent(
+        id,
+        conversationId,
+        turnId,
+        toolName,
+        toolCallId,
+        observationEvent.output,
+        success ? "success" : "error",
+        { timestamp, payload, duration_ms: payload.duration_ms }
+      );
+      event.ephemeral = false;
+      if (contextMeta) event.metadata = { ...event.metadata ?? {}, ...contextMeta };
+      return event;
+    }
+    case "final_answer": {
+      const finalAnswerEvent = typed;
+      const answerIdFromSnake = typeof finalAnswerEvent.answer_id === "string" && finalAnswerEvent.answer_id.trim().length > 0 ? finalAnswerEvent.answer_id.trim() : void 0;
+      return createFinalAnswerEvent(
+        id,
+        conversationId,
+        turnId,
+        answerIdFromSnake ?? readAnswerIdFromEvent(finalAnswerEvent) ?? `answer_${turnId}`,
+        finalAnswerEvent.answer ?? "",
+        {
+          timestamp,
+          reasoning_details: Array.isArray(finalAnswerEvent.reasoning_details) ? finalAnswerEvent.reasoning_details : void 0,
+          meta: readMetaFromEvent(finalAnswerEvent)
+        }
+      );
+    }
+    case "error": {
+      const errorEvent = typed;
+      return createErrorEvent(id, conversationId, turnId, errorEvent.error ?? "Unknown error", {
+        timestamp,
+        details: errorEvent.details
+      });
+    }
+    case "stream_chunk":
+      return mapStreamChunkToRuntime(typed, context, id, timestamp);
+    default:
+      return null;
+  }
+}
+function mapThoughtToRuntime(thoughtEvent, context, options, id, timestamp) {
+  const isComplete = "is_complete" in thoughtEvent ? Boolean(thoughtEvent.is_complete) : false;
+  if (options.skipIncomplete && !isComplete) return null;
+  const thoughtMessageId = typeof thoughtEvent.thought_message_id === "string" && thoughtEvent.thought_message_id.length > 0 ? thoughtEvent.thought_message_id : void 0;
+  const runtimeEvent = createThoughtEvent(id, context.conversationId, context.turnId, thoughtEvent.content ?? "", {
+    timestamp,
+    thought_message_id: thoughtMessageId,
+    delta: thoughtEvent.delta,
+    is_complete: isComplete
+  });
+  if (!isComplete) runtimeEvent.ephemeral = true;
+  const thoughtMeta = isRecord2(thoughtEvent.meta) ? thoughtEvent.meta : void 0;
+  if (context.metadata || thoughtMeta) {
+    runtimeEvent.metadata = { ...runtimeEvent.metadata ?? {}, ...context.metadata ?? {}, ...thoughtMeta ?? {} };
+  }
+  return runtimeEvent;
+}
+function mapToolProgressToRuntime(toolEvent, context, options, id, timestamp) {
+  const toolName = toolEvent.tool_name || "unknown_tool";
+  const toolCallId = toolEvent.tool_call_id || `call_${id}`;
+  const meta = toolEvent.meta && typeof toolEvent.meta === "object" ? { ...toolEvent.meta } : {};
+  const displayOptions = resolveToolDisplayOptions(toolName, options.toolPresentationPort);
+  if (displayOptions && !meta.displayOptions) meta.displayOptions = displayOptions;
+  const event = toolEvent.type === "tool_call_decision" ? createToolCallDecisionEvent(id, context.conversationId, context.turnId, toolName, toolCallId, {
+    timestamp,
+    phase: toolEvent.phase ?? "start",
+    status: toolEvent.status ?? "loading",
+    args: toolEvent.tool_args || {},
+    payload: toolEvent.payload || {},
+    meta
+  }) : createToolProcessEvent(id, context.conversationId, context.turnId, toolName, toolCallId, {
+    timestamp,
+    phase: toolEvent.phase ?? "start",
+    status: toolEvent.status ?? "loading",
+    args: toolEvent.tool_args || {},
+    payload: toolEvent.payload || {},
+    meta
+  });
+  event.ephemeral = meta.ephemeral === true;
+  if (context.metadata) event.metadata = { ...event.metadata ?? {}, ...context.metadata };
+  return event;
+}
+function mapStreamChunkToRuntime(streamEvent, context, id, timestamp) {
+  const text = streamEvent.content ?? "";
+  if (!text) return null;
+  const answerId = readAgentEventAnswerId(streamEvent) ?? `answer_${context.turnId}`;
+  const seq = readAgentEventSeq(streamEvent) ?? 0;
+  const isLast = Boolean(
+    "isLast" in streamEvent && streamEvent.isLast || "is_last" in streamEvent && streamEvent.is_last
+  );
+  const chunkEvent = createFinalAnswerChunkEvent(id, context.conversationId, context.turnId, answerId, seq, text, {
+    timestamp,
+    is_last: isLast
+  });
+  chunkEvent.ephemeral = true;
+  if (context.metadata) chunkEvent.metadata = { ...chunkEvent.metadata ?? {}, ...context.metadata };
+  return chunkEvent;
+}
+
+// src/runtime-kernel/events/runtime-to-ai-message.ts
+function applyRuntimeEventToMemory(event, memory) {
+  if (!event || !memory) return;
+  switch (event.type) {
+    case "user_input": {
+      const userEvent = event;
+      memory.addUserMessage(userEvent.content || "", userEvent.id);
+      break;
+    }
+    case "tool_call_decision":
+      applyToolCallDecision(event, memory);
+      break;
+    case "tool_output":
+      applyToolOutput(event, memory);
+      break;
+    case "final_answer": {
+      const answerEvent = event;
+      const answerContent = answerEvent.content || "";
+      if (answerContent.trim()) {
+        const metadata = Array.isArray(answerEvent.reasoning_details) ? { reasoning_details: answerEvent.reasoning_details } : void 0;
+        memory.addAssistantMessage(answerContent, "final_answer", metadata, answerEvent.id);
+      }
+      break;
+    }
+    case "thought": {
+      const thoughtEvent = event;
+      memory.addAssistantMessage(thoughtEvent.content || "", "thought", void 0, thoughtEvent.id);
+      break;
+    }
+    case "history_summary":
+      applyHistorySummary(event, memory);
+      break;
+  }
+}
+function applyToolCallDecision(event, memory) {
+  const payload = event.payload || {};
+  const toolCalls = Array.isArray(payload.tool_calls) ? payload.tool_calls.filter(isToolCallWire) : [];
+  const toolArgs = event.args || payload.args || {};
+  const toolCallId = event.tool_call_id || (toolCalls.length > 0 ? toolCalls[0].id : `call_${event.id || Date.now()}`);
+  const normalizedToolCalls = toolCalls.length > 0 ? toolCalls : [
+    {
+      id: toolCallId,
+      type: "function",
+      function: { name: event.tool_name, arguments: JSON.stringify(toolArgs || {}) }
+    }
+  ];
+  const reasoningDetails = Array.isArray(payload.reasoning_details) ? payload.reasoning_details : void 0;
+  memory.addAssistantMessage(
+    null,
+    "tool_calls",
+    {
+      tool_calls: normalizedToolCalls,
+      ...reasoningDetails ? { reasoning_details: reasoningDetails } : {}
+    },
+    event.id
+  );
+}
+function applyToolOutput(event, memory) {
+  if (!event.tool_call_id) return;
+  const payload = event.payload || {};
+  const outputValue = payload.result ?? payload.output ?? event.output;
+  let serializedOutput;
+  if (typeof outputValue === "string") {
+    serializedOutput = outputValue;
+  } else {
+    try {
+      serializedOutput = JSON.stringify(outputValue ?? "");
+    } catch {
+      serializedOutput = String(outputValue ?? "");
+    }
+  }
+  memory.addToolResponse(String(event.tool_call_id), serializedOutput, event.tool_name, event.id);
+}
+function applyHistorySummary(summaryEvent, memory) {
+  const summaryMetadata = {
+    messageType: "summary",
+    generatedBy: summaryEvent.generated_by || "AgentSummarizationProvider",
+    originalMessageCount: summaryEvent.original_message_count,
+    compressionRatio: summaryEvent.compression_ratio,
+    includedOldSummary: summaryEvent.included_old_summary,
+    replacesStartMessageId: summaryEvent.replaces_start_message_id,
+    replacesEndMessageId: summaryEvent.replaces_end_message_id,
+    replacedMessageIds: Array.isArray(summaryEvent.replaced_message_ids) ? summaryEvent.replaced_message_ids : [],
+    summarySeq: summaryEvent.summary_seq || 0
+  };
+  const summaryMessage = {
+    id: summaryEvent.id,
+    role: "system",
+    type: "history_summary",
+    content: summaryEvent.content || "",
+    timestamp: summaryEvent.timestamp,
+    metadata: summaryMetadata
+  };
+  memory.appendMessage(summaryMessage);
+}
+
+// src/runtime-kernel/events/sse-projection.ts
+function agentEventToSSE(agentEvent, context, options = {}) {
+  if (!agentEvent || typeof agentEvent !== "object") return null;
+  if (options.skipAlreadyDispatched && isMarkedAsSseDispatched(agentEvent)) return null;
+  const { conversationId, turnId } = context;
+  const timestamp = agentEvent.timestamp ?? context.timestamp ?? Date.now();
+  const id = agentEvent.id ?? generateMessageId();
+  const contextMeta = context.metadata;
+  switch (agentEvent.type) {
+    case "thought": {
+      const thoughtEvent = agentEvent;
+      const rawContent = "content" in thoughtEvent ? thoughtEvent.content : "";
+      const delta = "delta" in thoughtEvent ? thoughtEvent.delta : "";
+      const isComplete = "is_complete" in thoughtEvent ? Boolean(thoughtEvent.is_complete) : false;
+      const thoughtMessageId = typeof thoughtEvent.thought_message_id === "string" && thoughtEvent.thought_message_id.length > 0 ? thoughtEvent.thought_message_id : void 0;
+      const sse = createSSEThoughtEvent(id, conversationId, turnId, {
+        thought_message_id: thoughtMessageId,
+        content: isComplete ? rawContent ?? "" : void 0,
+        delta: !isComplete ? delta ?? rawContent : void 0,
+        is_complete: isComplete
+      });
+      sse.timestamp = timestamp;
+      const thoughtMeta = isRecord2(thoughtEvent.meta) ? thoughtEvent.meta : void 0;
+      if (contextMeta || thoughtMeta) {
+        sse.metadata = { ...contextMeta ?? {}, ...thoughtMeta ?? {} };
+      }
+      return sse;
+    }
+    case "tool_call_decision":
+    case "tool_process":
+      return mapToolProgressToSse(agentEvent, context, options, id, timestamp);
+    case "observation": {
+      const observationEvent = agentEvent;
+      const toolName = observationEvent.tool_name || "unknown_tool";
+      const toolCallId = observationEvent.tool_call_id || `call_${id}`;
+      const status = observationEvent.success === false ? "error" : "success";
+      const payload = observationEvent.payload || {};
+      const duration = payload.duration_ms;
+      const sse = createSSEToolOutputEvent(
+        id,
+        conversationId,
+        turnId,
+        toolName,
+        toolCallId,
+        status,
+        observationEvent.output,
+        { timestamp, payload, duration_ms: duration }
+      );
+      sse.timestamp = timestamp;
+      if (contextMeta) sse.metadata = contextMeta;
+      return sse;
+    }
+    case "stream_chunk": {
+      const streamEvent = agentEvent;
+      const text = streamEvent.content ?? "";
+      if (!text) return null;
+      const answerId = readAgentEventAnswerId(streamEvent) ?? `answer_${turnId}`;
+      const seq = readAgentEventSeq(streamEvent) ?? 0;
+      const isLast = Boolean(
+        "isLast" in streamEvent && streamEvent.isLast || "is_last" in streamEvent && streamEvent.is_last
+      );
+      const sse = createSSEFinalAnswerChunkEvent(id, conversationId, turnId, answerId, seq, text, {
+        is_last: isLast
+      });
+      sse.timestamp = timestamp;
+      if (contextMeta) sse.metadata = contextMeta;
+      return sse;
+    }
+    case "final_answer": {
+      const finalAnswerEvent = agentEvent;
+      const answer = finalAnswerEvent.answer ?? "";
+      const answerIdFromSnake = typeof finalAnswerEvent.answer_id === "string" && finalAnswerEvent.answer_id.trim().length > 0 ? finalAnswerEvent.answer_id.trim() : void 0;
+      const answerId = answerIdFromSnake ?? readAnswerIdFromEvent(finalAnswerEvent) ?? `answer_${turnId}`;
+      const sse = createSSEFinalAnswerEvent(id, conversationId, turnId, answerId, answer, {
+        meta: readMetaFromEvent(finalAnswerEvent)
+      });
+      sse.timestamp = timestamp;
+      if (contextMeta) sse.metadata = contextMeta;
+      return sse;
+    }
+    case "error": {
+      const errorEvent = agentEvent;
+      const sse = createSSEErrorEvent(id, conversationId, turnId, errorEvent.error ?? "Unknown error", {
+        details: errorEvent.details
+      });
+      sse.timestamp = timestamp;
+      if (contextMeta) sse.metadata = contextMeta;
+      return sse;
+    }
+    default:
+      return null;
+  }
+}
+function mapToolProgressToSse(agentEvent, context, options, id, timestamp) {
+  const toolName = agentEvent.tool_name || "unknown_tool";
+  const toolCallId = agentEvent.tool_call_id || `call_${id}`;
+  const phase = agentEvent.phase ?? "start";
+  const status = agentEvent.status ?? "loading";
+  const args = agentEvent.tool_args || {};
+  const payload = agentEvent.payload || {};
+  const meta = agentEvent.meta && typeof agentEvent.meta === "object" ? { ...agentEvent.meta } : {};
+  const displayOptions = resolveToolDisplayOptions(toolName, options.toolPresentationPort);
+  if (displayOptions && !meta.displayOptions) meta.displayOptions = displayOptions;
+  const sse = agentEvent.type === "tool_call_decision" ? createSSEToolCallDecisionEvent(id, context.conversationId, context.turnId, toolName, toolCallId, phase, status, {
+    timestamp,
+    args,
+    payload,
+    meta
+  }) : createSSEToolProcessEvent(id, context.conversationId, context.turnId, toolName, toolCallId, phase, status, {
+    timestamp,
+    args,
+    payload,
+    meta
+  });
+  sse.timestamp = timestamp;
+  if (context.metadata) sse.metadata = context.metadata;
+  return sse;
+}
+
+// src/runtime-kernel/events/eventMappers.ts
+var eventMapper = {
+  /**
+   * 将 AgentEvent 转换为 SSEEvent。
+   */
+  agentToSse: agentEventToSSE,
+  /**
+   * 将 AgentEvent 转换为 RuntimeEvent。
+   */
+  agentToRuntime: agentEventToRuntime,
+  /**
+   * 将 RuntimeEvent 应用到 ConversationMemoryPort。
+   */
+  applyToMemory: applyRuntimeEventToMemory,
+  /**
+   * 批量处理 AgentEvent → SSEEvent + RuntimeEvent。
+   */
+  agentToBoth: (agentEvent, context, options = {}) => {
+    const sseEvent = agentEventToSSE(agentEvent, context, options.sseOptions);
+    const runtimeEvent = agentEventToRuntime(agentEvent, context, options.runtimeOptions);
+    return { sseEvent, runtimeEvent };
+  },
+  /**
+   * 批量重建内存。
+   */
+  rebuildMemory: (events, memory) => {
+    for (const event of events) {
+      applyRuntimeEventToMemory(event, memory);
+    }
+  }
+};
+
+// src/runtime-kernel/events/eventGovernance.ts
+function isRecord3(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function isToolCallDecisionEvent(event) {
+  return event.type === "tool_call_decision";
+}
+function isToolProcessEvent(event) {
+  return event.type === "tool_process";
+}
+function isTodoUpdatedRuntimeEvent(event) {
+  return event.type === "todo_updated";
+}
+function isSubRunTraceRuntimeEvent(event) {
+  return event.type === "subrun_trace";
+}
+function isStreamEndRuntimeEvent(event) {
+  return event.type === "stream_end";
+}
+function isRequiresUserInteractionRuntimeEvent(event) {
+  return event.type === "requires_user_interaction";
+}
+function isAuditEnvelopeRuntimeEvent(event) {
+  return event.type === "audit_envelope";
+}
+function isControlRuntimeEvent(event) {
+  return event.type === "control";
+}
+function isHiddenUserInputEvent(event) {
+  if (event.type !== "user_input") {
+    return false;
+  }
+  const metadata = isRecord3(event.metadata) ? event.metadata : void 0;
+  const ui = metadata && isRecord3(metadata.ui) ? metadata.ui : void 0;
+  return ui?.presentation === "hidden";
+}
+function isEmptyTerminalAssistantRuntimeEvent(event) {
+  if (event.type !== "thought" && event.type !== "final_answer") {
+    return false;
+  }
+  return event.content.trim().length === 0;
+}
+function shouldPersistRuntimeEvent(event) {
+  return describeRuntimeEventLifecycle(event).persist;
+}
+function shouldReplayRuntimeEventToUi(event) {
+  return describeRuntimeEventLifecycle(event).replayToUi;
+}
+function shouldEnterAgentContext(event) {
+  return describeRuntimeEventLifecycle(event).enterAgentContext;
+}
+function isCheckpointHistorySummaryEvent(event) {
+  if (event.type !== "history_summary") {
+    return false;
+  }
+  const metadata = isRecord3(event.metadata) ? event.metadata : void 0;
+  return metadata?.summary_kind === "checkpoint";
+}
+function getRuntimeEventUiProjectionKind(event) {
+  if (isHiddenUserInputEvent(event)) {
+    return "hidden";
+  }
+  switch (event.type) {
+    case "user_input":
+      return "user_input";
+    case "thought":
+      return "thought";
+    case "final_answer":
+      return "final_answer";
+    case "final_answer_chunk":
+      return "final_answer_chunk";
+    case "tool_call_decision":
+      return "tool_call_decision";
+    case "tool_process":
+      return "tool_process";
+    case "tool_output":
+      return "tool_output";
+    case "requires_user_interaction":
+      return "requires_user_interaction";
+    case "audit_envelope":
+      return "audit_envelope";
+    case "todo_updated":
+      return "todo_updated";
+    case "subrun_trace":
+      return "subrun_trace";
+    case "error":
+      return "error";
+    case "stream_end":
+      return "stream_end";
+    case "history_summary":
+      return isCheckpointHistorySummaryEvent(event) ? "checkpoint_history_summary" : "history_summary";
+    default:
+      return "unsupported";
+  }
+}
+function describeRuntimeEventLifecycle(event) {
+  const uiProjectionKind = getRuntimeEventUiProjectionKind(event);
+  const persist = event.ephemeral !== true && !isToolProcessEvent(event);
+  const replayToUi = uiProjectionKind !== "hidden" && uiProjectionKind !== "audit_envelope" && uiProjectionKind !== "final_answer_chunk" && uiProjectionKind !== "unsupported";
+  const enterAgentContext = (() => {
+    if (isTodoUpdatedRuntimeEvent(event)) {
+      return false;
+    }
+    if (isSubRunTraceRuntimeEvent(event)) {
+      return false;
+    }
+    if (isStreamEndRuntimeEvent(event)) {
+      return false;
+    }
+    if (isRequiresUserInteractionRuntimeEvent(event)) {
+      return false;
+    }
+    if (isAuditEnvelopeRuntimeEvent(event)) {
+      return false;
+    }
+    if (isControlRuntimeEvent(event)) {
+      return false;
+    }
+    if (isHiddenUserInputEvent(event)) {
+      return false;
+    }
+    if (isToolProcessEvent(event)) {
+      return false;
+    }
+    if (event.type === "final_answer_chunk") {
+      return false;
+    }
+    if (isEmptyTerminalAssistantRuntimeEvent(event)) {
+      return false;
+    }
+    return true;
+  })();
+  const realtimeChannel = (() => {
+    switch (uiProjectionKind) {
+      case "thought":
+      case "final_answer":
+      case "final_answer_chunk":
+      case "tool_call_decision":
+      case "tool_process":
+      case "tool_output":
+      case "requires_user_interaction":
+      case "todo_updated":
+      case "subrun_trace":
+      case "error":
+        return "event_bus_sse";
+      case "audit_envelope":
+        return "none";
+      default:
+        return "none";
+    }
+  })();
+  return {
+    uiProjectionKind,
+    persist,
+    replayToUi,
+    enterAgentContext,
+    realtimeChannel
+  };
+}
+function shouldEmitRuntimeEventToSse(event) {
+  return describeRuntimeEventLifecycle(event).realtimeChannel === "event_bus_sse";
+}
+
+export { describeRuntimeEventLifecycle, eventMapper, getRuntimeEventUiProjectionKind, isCheckpointHistorySummaryEvent, isToolCallDecisionEvent, shouldEmitRuntimeEventToSse, shouldEnterAgentContext, shouldPersistRuntimeEvent, shouldReplayRuntimeEventToUi };
+//# sourceMappingURL=events.js.map
+//# sourceMappingURL=events.js.map