@anvia/studio 0.8.1 → 1.0.0-rc.2

package/dist/index.js

@@ -1,5 +1,5 @@
 // src/runtime/studio.ts
-import { Agent as Agent2 } from "@anvia/core/internal/agent";
+import { Agent, getAgentToolState as getAgentToolState3 } from "@anvia/core/internal/agent";
 import { Pipeline } from "@anvia/core/pipeline";
 import { serve } from "@hono/node-server";
 import { Hono as HonoApp } from "hono";
@@ -178,7 +178,12 @@ var StudioRunTraceObserver = class {
   async end(args) {
     await this.save("success", {
       endedAt: /* @__PURE__ */ new Date(),
-      output: args.output,
+      output: args.status === "completed" ? traceOutput(args.output) : args.text,
+      result: {
+        status: args.status,
+        text: args.text,
+        ...args.status === "completed" ? { output: toJsonValue(args.output) } : { stage: args.stage }
+      },
       usage: args.usage,
       messages: toJsonValue(args.messages)
     });
@@ -198,11 +203,13 @@ var StudioRunTraceObserver = class {
       return;
     }
     const metadata = traceMetadata(this.props.args, result.messages);
+    if (result.result !== void 0) metadata.result = result.result;
     const trace = {
       id: this.props.id,
+      runId: this.props.args.runId,
       sessionId,
       status,
-      trace: this.trace,
+      trace: { observer: "studio", ...this.trace },
       startedAt: this.startedAt.toISOString(),
       endedAt: result.endedAt.toISOString(),
       durationMs: durationMs(this.startedAt, result.endedAt),
@@ -281,15 +288,14 @@ var ChildAgentToolTraceAccumulator = class {
     }
     if (child.type === "tool_call" && isRecord(child.toolCall)) {
       const toolCall = child.toolCall;
-      const toolCallFunction = isRecord(toolCall.function) ? toolCall.function : void 0;
-      const toolName = typeof toolCallFunction?.name === "string" ? toolCallFunction.name : "tool";
-      const callId = typeof toolCall.callId === "string" ? toolCall.callId : typeof toolCall.id === "string" ? toolCall.id : void 0;
+      const toolName = typeof toolCall.toolName === "string" ? toolCall.toolName : "tool";
+      const callId = typeof toolCall.toolCallId === "string" ? toolCall.toolCallId : typeof toolCall.callId === "string" ? toolCall.callId : void 0;
       const start = {
         startedAt: /* @__PURE__ */ new Date(),
         agentId,
         childTurn,
         toolName,
-        input: toJsonValue(toolCallFunction?.arguments ?? {}),
+        input: toJsonValue("input" in toolCall ? toolCall.input : {}),
         completed: false
       };
       if (agentName !== void 0) start.agentName = agentName;
@@ -427,6 +433,7 @@ function traceObservation(props) {
 }
 function traceMetadata(args, messages) {
   return compactJsonObject({
+    runId: args.runId,
     agentName: args.agentName,
     agentDescription: args.agentDescription,
     maxTurns: args.maxTurns,
@@ -441,14 +448,12 @@ function generationMetadata(args, endArgs) {
   const request = args.request;
   const response = endArgs?.response;
   const rawResponse = isRecord(response?.rawResponse) ? response.rawResponse : void 0;
-  const effectiveModel = request.model ?? stringValue(rawResponse?.model) ?? args.modelInfo?.defaultModel ?? "default";
+  const modelId = args.modelInfo?.modelId ?? stringValue(rawResponse?.model) ?? "unknown";
   const providerResponse = providerResponseSummary(rawResponse);
   const usage = response?.usage;
   return compactJsonObject({
     provider: args.modelInfo?.provider,
-    model: effectiveModel,
-    requestedModel: request.model,
-    defaultModel: args.modelInfo?.defaultModel,
+    modelId,
     messageId: response?.messageId,
     usage,
     toolCount: request.tools.length,
@@ -458,15 +463,13 @@ function generationMetadata(args, endArgs) {
     temperature: request.temperature,
     maxTokens: request.maxTokens,
     toolChoice: request.toolChoice,
-    additionalParamKeys: isRecord(request.additionalParams) ? Object.keys(request.additionalParams).sort() : void 0,
+    providerOptionKeys: isRecord(request.providerOptions) ? Object.keys(request.providerOptions).sort() : void 0,
     hasOutputSchema: request.outputSchema !== void 0,
     firstDeltaMs: endArgs?.firstDeltaMs,
     providerResponse,
     modelInfo: compactJsonObject({
       provider: args.modelInfo?.provider,
-      model: effectiveModel,
-      requestedModel: request.model,
-      defaultModel: args.modelInfo?.defaultModel,
+      modelId,
       capabilities: args.modelInfo?.capabilities
     }),
     modelCall: compactJsonObject({
@@ -492,7 +495,6 @@ function generationMetadata(args, endArgs) {
 }
 function completionRequestSummary(request) {
   return compactJsonObject({
-    model: request.model,
     instructions: request.instructions === void 0 ? void 0 : { present: true },
     messageCount: request.chatHistory.length,
     documentCount: request.documents.length,
@@ -502,7 +504,7 @@ function completionRequestSummary(request) {
     temperature: request.temperature,
     maxTokens: request.maxTokens,
     toolChoice: request.toolChoice,
-    additionalParamKeys: isRecord(request.additionalParams) ? Object.keys(request.additionalParams).sort() : void 0,
+    providerOptionKeys: isRecord(request.providerOptions) ? Object.keys(request.providerOptions).sort() : void 0,
     hasOutputSchema: request.outputSchema !== void 0
   });
 }
@@ -539,7 +541,6 @@ function toolMetadata(args, skipped, result) {
     argumentBytes: byteLength(args.args),
     resultBytes: result === void 0 ? void 0 : byteLength(result),
     hasCallSignature: args.toolCall.signature !== void 0,
-    hasAdditionalParams: args.toolCall.additionalParams !== void 0,
     toolDescription: args.toolDefinition?.description,
     parameterKeys: Object.keys(properties).sort(),
     requiredParameterKeys: required,
@@ -557,8 +558,7 @@ function toolMetadata(args, skipped, result) {
       mcpServerName: args.toolMetadata?.mcpServerName,
       argumentBytes: byteLength(args.args),
       resultBytes: result === void 0 ? void 0 : byteLength(result),
-      hasCallSignature: args.toolCall.signature !== void 0,
-      hasAdditionalParams: args.toolCall.additionalParams !== void 0
+      hasCallSignature: args.toolCall.signature !== void 0
     })
   });
 }
@@ -575,6 +575,16 @@ function parseOrString(value) {
     return value;
   }
 }
+function traceOutput(value) {
+  if (typeof value === "string") {
+    return value;
+  }
+  try {
+    return JSON.stringify(toJsonValue(value));
+  } catch {
+    return String(value);
+  }
+}
 function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -874,70 +884,31 @@ function escapeHtml(value) {
   return value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
 }
 
+// src/runtime/agent-context.ts
+import { isVectorContext } from "@anvia/core/agent";
+function staticContextDocuments(agent) {
+  return agent.context.filter((input) => !isVectorContext(input));
+}
+function vectorContexts(agent) {
+  return agent.context.filter(isVectorContext);
+}
+
 // src/runtime/agent-runs.ts
-import { Message } from "@anvia/core/completion";
+import {
+  withInternalAgentRunOptions
+} from "@anvia/core/internal/agent";
 
 // src/runtime/agent-utils.ts
 import {
-  createHook
-} from "@anvia/core/hooks";
-import { Agent } from "@anvia/core/internal/agent";
+  createResolvedAgent,
+  getResolvedAgentOptions
+} from "@anvia/core/internal/agent";
 function cloneAgent(agent, overrides = {}) {
-  return new Agent({
-    id: agent.id,
-    name: agent.name,
-    description: agent.description,
-    model: agent.model,
-    instructions: agent.instructions,
-    staticContext: agent.staticContext,
-    temperature: agent.temperature,
-    maxTokens: agent.maxTokens,
-    additionalParams: agent.additionalParams,
-    toolSet: agent.toolSet,
-    toolChoice: agent.toolChoice,
-    defaultMaxTurns: agent.defaultMaxTurns,
-    hook: agent.hook,
-    outputSchema: agent.outputSchema,
-    observers: agent.observers,
-    approvals: agent.approvals,
-    dynamicContexts: agent.dynamicContexts,
-    dynamicTools: agent.dynamicTools,
-    middlewares: agent.middlewares,
-    memory: agent.memory,
-    eventStore: agent.eventStore,
+  return createResolvedAgent({
+    ...getResolvedAgentOptions(agent),
     ...overrides
   });
 }
-function composeHooks(first, second) {
-  if (first === void 0) {
-    return second;
-  }
-  if (second === void 0) {
-    return first;
-  }
-  return createHook({
-    async onCompletionCall(args) {
-      const firstAction = await first.onCompletionCall?.(args);
-      return firstAction?.type === "terminate" ? firstAction : await second.onCompletionCall?.(args) ?? void 0;
-    },
-    async onCompletionResponse(args) {
-      const firstAction = await first.onCompletionResponse?.(args);
-      return firstAction?.type === "terminate" ? firstAction : await second.onCompletionResponse?.(args) ?? void 0;
-    },
-    async onToolCall(args) {
-      const firstAction = await first.onToolCall?.(args);
-      if (firstAction?.type === "skip" || firstAction?.type === "terminate" || firstAction?.type === "approval_request") {
-        return firstAction;
-      }
-      const secondAction = await second.onToolCall?.(args);
-      return secondAction ?? firstAction ?? void 0;
-    },
-    async onToolResult(args) {
-      const firstAction = await first.onToolResult?.(args);
-      return firstAction?.type === "terminate" ? firstAction : await second.onToolResult?.(args) ?? void 0;
-    }
-  });
-}
 
 // src/runtime/errors.ts
 function serializeError(error) {
@@ -952,7 +923,8 @@ function serializeError(error) {
 
 // src/runtime/type-guards.ts
 import {
-  isJsonValue as isCoreJsonValue
+  isJsonValue as isCoreJsonValue,
+  isMessage
 } from "@anvia/core/completion";
 function isObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -963,26 +935,16 @@ function isJsonObject(value) {
 function isJsonValue(value) {
   return isCoreJsonValue(value);
 }
-function isMessageInput(value) {
-  return typeof value === "string" || isMessage(value);
-}
-function isMessage(value) {
-  if (!isObject(value) || typeof value.role !== "string") {
-    return false;
-  }
-  if (value.role === "system") {
-    return typeof value.content === "string";
-  }
-  if (value.role === "user" || value.role === "assistant" || value.role === "tool") {
-    return Array.isArray(value.content);
-  }
-  return false;
-}
 function isAgentTraceOptions(value) {
   if (!isObject(value)) {
     return false;
   }
-  return optionalString(value.name) && optionalString(value.userId) && optionalString(value.sessionId) && optionalString(value.version) && optionalString(value.traceId) && optionalBoolean(value.failOnObserverError) && optionalStringArray(value.tags) && optionalObject(value.metadata);
+  if (!Object.keys(value).every(
+    (key) => ["name", "userId", "sessionId", "metadata", "tags", "version", "traceId"].includes(key)
+  )) {
+    return false;
+  }
+  return optionalString(value.name) && optionalString(value.userId) && optionalString(value.sessionId) && optionalString(value.version) && optionalString(value.traceId) && optionalStringArray(value.tags) && (value.metadata === void 0 || isJsonObject(value.metadata));
 }
 function isNonNegativeInteger(value) {
   return Number.isInteger(value) && typeof value === "number" && value >= 0;
@@ -993,15 +955,9 @@ function isPositiveInteger(value) {
 function optionalString(value) {
   return value === void 0 || typeof value === "string";
 }
-function optionalBoolean(value) {
-  return value === void 0 || typeof value === "boolean";
-}
 function optionalStringArray(value) {
   return value === void 0 || Array.isArray(value) && value.every((item) => typeof item === "string");
 }
-function optionalObject(value) {
-  return value === void 0 || isObject(value);
-}
 
 // src/runtime/http.ts
 function errorResponse(c, status, code, message, details) {
@@ -1051,8 +1007,8 @@ function createStudioModelRegistry(config) {
       id,
       staticModels
     };
-    if (provider.defaultModel !== void 0) {
-      runtimeProvider.defaultModel = normalizeModelId(provider.defaultModel);
+    if (provider.defaultModelId !== void 0) {
+      runtimeProvider.defaultModelId = normalizeModelId(provider.defaultModelId);
     }
     providers.set(id, runtimeProvider);
   }
@@ -1061,8 +1017,10 @@ function createStudioModelRegistry(config) {
     agentPolicies: normalizeAgentPolicies(config.agents ?? {}),
     modelCache: /* @__PURE__ */ new Map()
   };
-  if (config.default !== void 0) {
-    Object.assign(registry, { defaultModel: normalizeModelRef(config.default) });
+  if (config.defaultModelRef !== void 0) {
+    Object.assign(registry, {
+      defaultModelRef: normalizeModelRef(config.defaultModelRef)
+    });
   }
   return registry;
 }
@@ -1079,7 +1037,7 @@ function studioModelsConfig(registry, agents) {
       models
     };
     if (provider.name !== void 0) config2.name = provider.name;
-    if (provider.defaultModel !== void 0) config2.defaultModel = provider.defaultModel;
+    if (provider.defaultModelId !== void 0) config2.defaultModelId = provider.defaultModelId;
     if (provider.metadata !== void 0) config2.metadata = provider.metadata;
     return config2;
   });
@@ -1091,7 +1049,7 @@ function studioModelsConfig(registry, agents) {
     providers,
     agents: agentsConfig
   };
-  if (registry.defaultModel !== void 0) config.default = registry.defaultModel;
+  if (registry.defaultModelRef !== void 0) config.defaultModelRef = registry.defaultModelRef;
   return config;
 }
 function registerModelRoutes(app, props) {
@@ -1105,8 +1063,8 @@ function registerModelRoutes(app, props) {
     const response = {
       providers
     };
-    if (props.registry.defaultModel !== void 0) {
-      response.defaultModel = props.registry.defaultModel;
+    if (props.registry.defaultModelRef !== void 0) {
+      response.defaultModelRef = props.registry.defaultModelRef;
     }
     return c.json(response);
   });
@@ -1139,7 +1097,7 @@ function resolveStudioModel(registry, input) {
   if (registry === void 0) {
     return { warnings: [] };
   }
-  const selectedRef = normalizeOptionalModelRef(input.request.model) ?? sessionModelRef(input.sessionMetadata) ?? registry.agentPolicies.get(input.agent.id)?.default ?? registry.defaultModel;
+  const selectedRef = normalizeOptionalModelRef(input.request.model) ?? sessionModelRef(input.sessionMetadata) ?? registry.agentPolicies.get(input.agent.id)?.defaultModelRef ?? registry.defaultModelRef;
   if (selectedRef === void 0) {
     return { warnings: [] };
   }
@@ -1151,7 +1109,7 @@ function resolveStudioModel(registry, input) {
   }
   let model = registry.modelCache.get(selectedRef);
   if (model === void 0) {
-    model = provider.createCompletionModel(modelId);
+    model = provider.createCompletionModel({ modelId });
     registry.modelCache.set(selectedRef, model);
   }
   const metadata = provider.staticModels.get(modelId);
@@ -1169,12 +1127,7 @@ function normalizeOptionalModelRef(ref) {
   return ref === void 0 ? void 0 : normalizeModelRef(ref);
 }
 function normalizeModelRef(ref) {
-  if (typeof ref === "string") {
-    const trimmed = ref.trim();
-    const parsed = parseModelRef(trimmed);
-    return `${parsed.providerId}:${parsed.modelId}`;
-  }
-  return `${normalizeProviderId(ref.provider)}:${normalizeModelId(ref.model)}`;
+  return `${normalizeProviderId(ref.providerId)}:${normalizeModelId(ref.modelId)}`;
 }
 function parseModelRef(ref) {
   const index = ref.indexOf(":");
@@ -1217,12 +1170,12 @@ async function agentModelsCatalog(registry, agent) {
       return [];
     }
   });
-  const defaultModel = policy?.default ?? registry.defaultModel;
+  const defaultModelRef = policy?.defaultModelRef ?? registry.defaultModelRef;
   const summary = {
     agentId: agent.id,
     models: [...models, ...exactPolicyModels]
   };
-  if (defaultModel !== void 0) summary.defaultModel = defaultModel;
+  if (defaultModelRef !== void 0) summary.defaultModelRef = defaultModelRef;
   if (warnings.length > 0) summary.warnings = warnings;
   return summary;
 }
@@ -1260,7 +1213,7 @@ async function providerCatalog(provider) {
     models: [...models.values()].sort((left, right) => left.ref.localeCompare(right.ref))
   };
   if (provider.name !== void 0) catalog.name = provider.name;
-  if (provider.defaultModel !== void 0) catalog.defaultModel = provider.defaultModel;
+  if (provider.defaultModelId !== void 0) catalog.defaultModelId = provider.defaultModelId;
   if (provider.metadata !== void 0) catalog.metadata = provider.metadata;
   if (warning !== void 0) catalog.warning = warning;
   return catalog;
@@ -1294,19 +1247,33 @@ function normalizeAgentPolicies(policies) {
   return new Map(
     Object.entries(policies).map(([agentId, policy]) => {
       const normalized = {};
-      if (policy.default !== void 0) normalized.default = normalizeModelRef(policy.default);
+      if (policy.defaultModelRef !== void 0) {
+        normalized.defaultModelRef = normalizeModelRef(policy.defaultModelRef);
+      }
       if (policy.allowed !== void 0) {
-        normalized.allowed = policy.allowed.map(
-          (entry) => typeof entry === "string" && entry.trim().endsWith(":*") ? `${normalizeProviderId(entry.trim().slice(0, -2))}:*` : normalizeModelRef(entry)
-        );
+        normalized.allowed = policy.allowed.map((entry) => {
+          if (typeof entry === "string") {
+            return normalizeWildcardModelRef(entry);
+          }
+          return normalizeModelRef(entry);
+        });
       }
       return [agentId.trim(), normalized];
     })
   );
 }
+function normalizeWildcardModelRef(ref) {
+  const normalized = ref.trim();
+  if (!normalized.endsWith(":*")) {
+    throw new ModelSelectionError(`Invalid wildcard model reference: ${ref}`);
+  }
+  return `${normalizeProviderId(normalized.slice(0, -2))}:*`;
+}
 function publicPolicy(policy) {
   const config = {};
-  if (policy.default !== void 0) config.default = policy.default;
+  if (policy.defaultModelRef !== void 0) {
+    config.defaultModelRef = policy.defaultModelRef;
+  }
   if (policy.allowed !== void 0) config.allowed = policy.allowed;
   return config;
 }
@@ -1337,15 +1304,13 @@ function modelWarnings(ref, model, request) {
 function requestModalities(request) {
   const modalities = /* @__PURE__ */ new Set(["text"]);
   for (const message of requestMessages(request)) {
-    if (typeof message === "string") {
-      continue;
-    }
     if (message.role === "user" || message.role === "assistant") {
+      if (typeof message.content === "string") continue;
       for (const content of message.content) {
         if (content.type === "image") {
           modalities.add("image");
         }
-        if (content.type === "document") {
+        if (content.type === "file") {
           modalities.add("document");
         }
       }
@@ -1354,7 +1319,7 @@ function requestModalities(request) {
   return modalities;
 }
 function requestMessages(request) {
-  return [...request.history ?? [], request.message];
+  return request.messages;
 }
 function normalizeProviderId(id) {
   const trimmed = id.trim();
@@ -1372,7 +1337,7 @@ function normalizeModelId(id) {
 }
 
 // src/runtime/streams.ts
-import { createEventStream } from "@anvia/server";
+import { createClientStreamResponse, createEventStreamResponse } from "@anvia/server";
 var studioJsonlHeaders = {
   "cache-control": "no-cache, no-transform",
   connection: "keep-alive",
@@ -1381,7 +1346,15 @@ var studioJsonlHeaders = {
   "x-accel-buffering": "no"
 };
 function streamStudioJsonl(events) {
-  return createEventStream(withStudioStreamErrors(events), {
+  return createEventStreamResponse({
+    events: withStudioStreamErrors(events),
+    format: "jsonl",
+    headers: studioJsonlHeaders
+  });
+}
+function streamStudioClient(options) {
+  return createClientStreamResponse({
+    events: options.events,
     format: "jsonl",
     headers: studioJsonlHeaders
   });
@@ -1400,8 +1373,9 @@ function withStudioStreamErrors(events) {
             const next = await iterator.next();
             if (next.done === true) {
               done = true;
+              return next;
             }
-            return next;
+            return { done: false, value: serializeStreamError(next.value) };
           } catch (error) {
             done = true;
             return {
@@ -1419,6 +1393,12 @@ function withStudioStreamErrors(events) {
     }
   };
 }
+function serializeStreamError(event) {
+  if (typeof event !== "object" || event === null || !("type" in event) || event.type !== "error" || !("error" in event)) {
+    return event;
+  }
+  return { ...event, error: serializeError(event.error) };
+}
 function studioStreamError(error) {
   return {
     type: "error",
@@ -1435,6 +1415,7 @@ function traceSummary(trace) {
     startedAt: trace.startedAt,
     observationCount: trace.observations.length
   };
+  if (trace.runId !== void 0) summary.runId = trace.runId;
   if (trace.name !== void 0) summary.name = trace.name;
   if (trace.endedAt !== void 0) summary.endedAt = trace.endedAt;
   if (trace.durationMs !== void 0) summary.durationMs = trace.durationMs;
@@ -1626,6 +1607,15 @@ function isEventType(value) {
   return value === "session_log" || value === "pipeline_log" || value === "trace";
 }
 
+// src/runtime/runs.ts
+import {
+  customAgentEventsToClientStream
+} from "@anvia/client";
+import {
+  isJsonValue as isJsonValue2,
+  parseMessages
+} from "@anvia/core/completion";
+
 // src/runtime/transcript.ts
 function renumberTranscript(entries) {
   return entries.map((entry, entryId) => ({ ...entry, entryId }));
@@ -1639,7 +1629,8 @@ function transcriptFromMessages(messages) {
     if (message.role === "user") {
       const attachments = attachmentsFromMessage(message);
       let textEntryAdded = false;
-      for (const content of message.content) {
+      const contents2 = typeof message.content === "string" ? [{ type: "text", text: message.content }] : message.content;
+      for (const content of contents2) {
         if (content.type === "text") {
           const entry = {
             entryId: transcript.length,
@@ -1668,17 +1659,16 @@ function transcriptFromMessages(messages) {
         transcript.push({
           entryId: transcript.length,
           kind: "tool",
-          toolName: "tool_result",
-          callId: content.callId ?? content.id,
-          result: content.content.map(
-            (item) => "text" in item ? item.text : `[image:${item.mediaType ?? "image/png"}]`
-          ).join("\n"),
-          structuredResult: content.content
+          toolName: content.toolName,
+          callId: content.callId ?? content.toolCallId,
+          result: toolResultText(content.output),
+          ...content.output.type === "content" ? { structuredResult: content.output.value } : {}
         });
       }
       continue;
     }
-    for (const content of message.content) {
+    const contents = typeof message.content === "string" ? [{ type: "text", text: message.content }] : message.content;
+    for (const content of contents) {
       if (content.type === "text") {
         appendAssistantTranscriptText(transcript, content.text);
       } else if (content.type === "reasoning") {
@@ -1689,13 +1679,13 @@ function transcriptFromMessages(messages) {
         };
         if (content.id !== void 0) entry.reasoningId = content.id;
         transcript.push(entry);
-      } else if (content.type === "tool_call") {
+      } else if (content.type === "tool-call") {
         transcript.push({
           entryId: transcript.length,
           kind: "tool",
-          toolName: content.function.name,
-          callId: content.callId ?? content.id,
-          args: formatJson(content.function.arguments)
+          toolName: content.toolName,
+          callId: content.callId ?? content.toolCallId,
+          args: formatJson(content.input)
         });
       }
     }
@@ -1706,28 +1696,37 @@ function attachmentsFromMessage(message) {
   if (message.role !== "user" && message.role !== "assistant") {
     return [];
   }
+  if (typeof message.content === "string") return [];
   return message.content.flatMap((content) => {
     if (content.type === "image") {
       const attachment = { kind: "image" };
-      if (content.source.type === "base64") {
-        attachment.data = content.source.data;
-        attachment.mediaType = content.source.mediaType;
+      if (content.image.type === "data") {
+        attachment.data = content.image.data;
+        if (content.mediaType !== void 0) attachment.mediaType = content.mediaType;
       } else {
-        attachment.url = content.source.url;
+        attachment.url = content.image.url;
       }
       return [attachment];
     }
-    if (content.type === "document") {
+    if (content.type === "file") {
       const attachment = { kind: "document" };
-      if (content.source.filename !== void 0) attachment.name = content.source.filename;
-      if (content.source.mediaType !== void 0) attachment.mediaType = content.source.mediaType;
-      if (content.source.type === "base64") attachment.data = content.source.data;
-      if (content.source.type === "url") attachment.url = content.source.url;
+      if (content.filename !== void 0) attachment.name = content.filename;
+      attachment.mediaType = content.mediaType;
+      if (content.data.type === "data") attachment.data = content.data.data;
+      if (content.data.type === "url") attachment.url = content.data.url;
       return [attachment];
     }
     return [];
   });
 }
+function toolResultText(output) {
+  if (output.type === "text" || output.type === "error-text") return output.value;
+  if (output.type === "json" || output.type === "error-json") return formatJson(output.value);
+  if (output.type === "execution-denied") return output.reason ?? "Execution denied";
+  return output.value.map(
+    (part) => part.type === "text" ? part.text : `[file:${part.mediaType}${part.filename === void 0 ? "" : `:${part.filename}`}]`
+  ).join("\n");
+}
 function appendAssistantTranscriptText(transcript, text) {
   const last = transcript.at(-1);
   if (last?.kind === "message" && last.role === "assistant") {
@@ -1815,8 +1814,97 @@ async function* mergeRunAndApprovalEvents(runEvents, approvalEvents) {
     approvalEvents.close();
   }
 }
-function streamAgentRunEvents(_c, events, options = {}) {
-  return streamStudioJsonl(withAgentRunCancellation(events, options.onCancel));
+function streamAgentRunEvents(_c, events, options) {
+  return streamStudioClient({
+    events: customAgentEventsToClientStream({
+      events: withAgentRunCancellation(events, options.onCancel),
+      runId: options.runId,
+      mapCustomEvent: studioEventToClientEvent
+    })
+  });
+}
+function studioEventToClientEvent(event, context) {
+  if (event.type === "tool_approval_request" || event.type === "tool_approval_result") {
+    return {
+      type: "tool_approval",
+      runId: context.runId,
+      ...context.turn === void 0 ? {} : { turn: context.turn },
+      ...context.scope === void 0 ? {} : { scope: context.scope },
+      approval: {
+        id: event.approval.id,
+        runId: event.approval.runId,
+        agentId: event.approval.agentId,
+        ...event.approval.sessionId === void 0 ? {} : { sessionId: event.approval.sessionId },
+        toolName: event.approval.toolName,
+        ...event.approval.callId === void 0 ? {} : { callId: event.approval.callId },
+        internalCallId: event.approval.internalCallId,
+        input: parseJsonOrString(event.approval.args),
+        status: event.approval.status,
+        requestedAt: event.approval.requestedAt,
+        ...event.approval.resolvedAt === void 0 ? {} : { resolvedAt: event.approval.resolvedAt },
+        ...event.approval.reason === void 0 ? {} : { reason: event.approval.reason }
+      }
+    };
+  }
+  if (event.type === "tool_question_request" || event.type === "tool_question_result") {
+    return {
+      type: "tool_question",
+      runId: context.runId,
+      ...context.turn === void 0 ? {} : { turn: context.turn },
+      ...context.scope === void 0 ? {} : { scope: context.scope },
+      question: {
+        id: event.question.id,
+        runId: event.question.runId,
+        agentId: event.question.agentId,
+        ...event.question.sessionId === void 0 ? {} : { sessionId: event.question.sessionId },
+        toolName: event.question.toolName,
+        ...event.question.callId === void 0 ? {} : { callId: event.question.callId },
+        internalCallId: event.question.internalCallId,
+        input: parseJsonOrString(event.question.args),
+        questions: event.question.questions,
+        status: event.question.status,
+        requestedAt: event.question.requestedAt,
+        ...event.question.answeredAt === void 0 ? {} : { answeredAt: event.question.answeredAt },
+        ...event.question.cancelledAt === void 0 ? {} : { cancelledAt: event.question.cancelledAt },
+        ...event.question.answers === void 0 ? {} : { answers: event.question.answers }
+      }
+    };
+  }
+  if (event.type === "session_log" && isJsonValue2(event.log)) {
+    return {
+      type: "data",
+      runId: context.runId,
+      name: "studio.session_log",
+      data: event.log,
+      transient: true
+    };
+  }
+  if (event.type === "pipeline_log" && isJsonValue2(event.log)) {
+    return {
+      type: "data",
+      runId: context.runId,
+      name: "studio.pipeline_log",
+      data: event.log,
+      transient: true
+    };
+  }
+  if (event.type === "pipeline_final" && isJsonValue2(event.output)) {
+    return {
+      type: "data",
+      runId: context.runId,
+      name: "studio.pipeline_final",
+      data: event.output
+    };
+  }
+  return void 0;
+}
+function parseJsonOrString(value) {
+  try {
+    const parsed = JSON.parse(value);
+    return isJsonValue2(parsed) ? parsed : value;
+  } catch {
+    return value;
+  }
 }
 function withAgentRunCancellation(events, onCancel) {
   const iterator = events[Symbol.asyncIterator]();
@@ -1936,10 +2024,10 @@ function createPersistedStreamingSessionTranscript(props) {
         };
         if (event.type === "error") saveInput.error = serializeError(event.error);
         await saveTranscript(saveInput);
-        const generatedMessages = event.type === "final" ? event.messages.slice(1) : [];
+        const generatedMessages = event.type === "final" ? event.result.messages.slice(1) : [];
         if (props.persistGeneratedMessages === true && generatedMessages.length > 0) {
           await props.store.append({
-            context: { sessionId: props.session.id },
+            scope: { sessionId: props.session.id },
             runId: props.runId,
             turn: 1,
             messages: generatedMessages
@@ -2041,9 +2129,9 @@ function acceptTranscriptStreamEvent(transcript, event) {
     transcript.push({
       entryId: transcript.length,
       kind: "tool",
-      toolName: event.toolCall.function.name,
-      callId: event.toolCall.callId ?? event.toolCall.id,
-      args: formatJson(event.toolCall.function.arguments)
+      toolName: event.toolCall.toolName,
+      callId: event.toolCall.callId ?? event.toolCall.toolCallId,
+      args: formatJson(event.toolCall.input)
     });
   }
   if (event.type === "tool_result") {
@@ -2151,8 +2239,8 @@ function acceptTranscriptStreamEvent(transcript, event) {
       matched.question = question;
     }
   }
-  if (event.type === "final" && event.trace?.traceId !== void 0) {
-    assignTranscriptTraceId(transcript, event.trace.traceId);
+  if (event.type === "final" && event.result.trace?.traceId !== void 0) {
+    assignTranscriptTraceId(transcript, event.result.trace.traceId);
   }
   if (event.type === "error") {
     appendTranscriptAssistantError(transcript, errorText(event.error));
@@ -2224,9 +2312,9 @@ function childAgentTranscriptEvent(event) {
     const entry = {
       kind: "tool",
       agentId: event.agentId,
-      toolName: child.toolCall.function.name,
-      callId: child.toolCall.callId ?? child.toolCall.id,
-      args: formatJson(child.toolCall.function.arguments)
+      toolName: child.toolCall.toolName,
+      callId: child.toolCall.callId ?? child.toolCall.toolCallId,
+      args: formatJson(child.toolCall.input)
     };
     if (event.agentName !== void 0) entry.agentName = event.agentName;
     return entry;
@@ -2363,17 +2451,18 @@ function extractMessageText(message) {
   if (message.role === "system") {
     return message.content;
   }
+  if (typeof message.content === "string") {
+    return message.content;
+  }
   return message.content.flatMap((item) => {
     if (item.type === "text" || item.type === "reasoning") {
       return [item.text];
     }
-    if (item.type === "tool_call") {
-      return [`${item.function.name}(${formatJson(item.function.arguments)})`];
+    if (item.type === "tool-call") {
+      return [`${item.toolName}(${formatJson(item.input)})`];
     }
-    if (item.type === "tool_result") {
-      return item.content.map(
-        (result) => "text" in result ? result.text : `[image:${result.mediaType ?? "image/png"}]`
-      );
+    if (item.type === "tool-result") {
+      return [toolResultOutputText(item.output)];
     }
     return [];
   }).join("\n");
@@ -2382,23 +2471,26 @@ function optionalTranscriptAttachments(message) {
   if (typeof message === "string" || message.role !== "user") {
     return {};
   }
+  if (typeof message.content === "string") {
+    return {};
+  }
   const attachments = message.content.flatMap((content) => {
     if (content.type === "image") {
       const attachment = { kind: "image" };
-      if (content.source.type === "base64") {
-        attachment.data = content.source.data;
-        attachment.mediaType = content.source.mediaType;
+      if (content.image.type === "data") {
+        attachment.data = content.image.data;
+        if (content.mediaType !== void 0) attachment.mediaType = content.mediaType;
       } else {
-        attachment.url = content.source.url;
+        attachment.url = content.image.url;
       }
       return [attachment];
     }
-    if (content.type === "document") {
+    if (content.type === "file") {
       const attachment = { kind: "document" };
-      if (content.source.filename !== void 0) attachment.name = content.source.filename;
-      if (content.source.mediaType !== void 0) attachment.mediaType = content.source.mediaType;
-      if (content.source.type === "base64") attachment.data = content.source.data;
-      if (content.source.type === "url") attachment.url = content.source.url;
+      if (content.filename !== void 0) attachment.name = content.filename;
+      attachment.mediaType = content.mediaType;
+      if (content.data.type === "data") attachment.data = content.data.data;
+      if (content.data.type === "url") attachment.url = content.data.url;
       return [attachment];
     }
     return [];
@@ -2415,32 +2507,27 @@ async function parseRunRequest(c) {
   if (!isObject(body)) {
     return { error: errorResponse(c, 400, "bad_request", "Request body must be an object") };
   }
-  const request = "message" in body ? parseLegacyRunRequestBody(c, body) : parseUiRunRequestBody(c, body);
-  if ("error" in request) {
-    return request;
-  }
-  return parseRunRequestOptions(c, body, request);
-}
-function parseLegacyRunRequestBody(c, body) {
-  if (!isMessageInput(body.message)) {
+  if ("message" in body || "history" in body) {
     return {
-      error: errorResponse(c, 400, "bad_request", "Request body requires a string or Message")
+      error: errorResponse(
+        c,
+        400,
+        "bad_request",
+        "Legacy message/history requests are not supported; use messages"
+      )
     };
   }
-  const request = {
-    message: typeof body.message === "string" ? body.message : body.message
-  };
-  if ("history" in body) {
-    if (!Array.isArray(body.history) || !body.history.every(isMessage)) {
-      return { error: errorResponse(c, 400, "bad_request", "history must be a Message array") };
-    }
-    request.history = body.history;
+  const request = parseRunRequestBody(c, body);
+  if ("error" in request) {
+    return request;
   }
-  return request;
+  return parseRunRequestOptions(c, body, request);
 }
-function parseUiRunRequestBody(c, body) {
-  const messages = body.messages;
-  if (!Array.isArray(messages) || !messages.every(isMessage)) {
+function parseRunRequestBody(c, body) {
+  let messages;
+  try {
+    messages = parseMessages(body.messages);
+  } catch {
     return {
       error: errorResponse(c, 400, "bad_request", "messages must be a non-empty Message array")
     };
@@ -2456,19 +2543,21 @@ function parseUiRunRequestBody(c, body) {
       error: errorResponse(c, 400, "bad_request", "messages must be a non-empty Message array")
     };
   }
-  const history = messages.slice(0, -1);
-  const request = { message };
-  if (history.length > 0) request.history = history;
-  return request;
+  if (message.role !== "user") {
+    return {
+      error: errorResponse(c, 400, "bad_request", "The final message must be user-authored")
+    };
+  }
+  return { messages };
 }
 function parseRunRequestOptions(c, body, request) {
   if ("sessionId" in body) {
     if (typeof body.sessionId !== "string" || body.sessionId.trim().length === 0) {
       return { error: errorResponse(c, 400, "bad_request", "sessionId must be a string") };
     }
-    if (request.history !== void 0) {
+    if (request.messages.length !== 1 || request.messages[0]?.role !== "user") {
       return {
-        error: errorResponse(c, 400, "bad_request", "sessionId cannot be combined with history")
+        error: errorResponse(c, 400, "bad_request", "sessionId requires exactly one user message")
       };
     }
     request.sessionId = body.sessionId;
@@ -2496,12 +2585,10 @@ function parseRunRequestOptions(c, body, request) {
     request.toolConcurrency = body.toolConcurrency;
   }
   if ("model" in body) {
-    if (typeof body.model === "string") {
-      request.model = body.model;
-    } else if (isObject(body.model) && typeof body.model.provider === "string" && typeof body.model.model === "string") {
+    if (isObject(body.model) && typeof body.model.providerId === "string" && typeof body.model.modelId === "string") {
       request.model = {
-        provider: body.model.provider,
-        model: body.model.model
+        providerId: body.model.providerId,
+        modelId: body.model.modelId
       };
     } else {
       return {
@@ -2509,7 +2596,7 @@ function parseRunRequestOptions(c, body, request) {
           c,
           400,
           "bad_request",
-          "model must be a provider:model string or { provider, model } object"
+          "model must be a { providerId, modelId } object"
         )
       };
     }
@@ -2530,6 +2617,14 @@ function parseRunRequestOptions(c, body, request) {
   }
   return request;
 }
+function toolResultOutputText(output) {
+  if (output.type === "text" || output.type === "error-text") return output.value;
+  if (output.type === "json" || output.type === "error-json") return formatJson(output.value);
+  if (output.type === "execution-denied") return output.reason ?? "Execution denied";
+  return output.value.map(
+    (part) => part.type === "text" ? part.text : `[file:${part.mediaType}${part.filename === void 0 ? "" : `:${part.filename}`}]`
+  ).join("\n");
+}
 
 // src/runtime/session-logs.ts
 async function appendSessionLog(store, input) {
@@ -2664,6 +2759,25 @@ function memorySavedLog(props) {
     metadata
   };
 }
+function memoryCompactedLog(props) {
+  const metadata = {
+    originalMessageCount: props.originalMessageCount,
+    compactedMessageCount: props.compactedMessageCount,
+    retainedMessageCount: props.retainedMessageCount,
+    attempts: props.attempts
+  };
+  const usage = usageSummary(props.usage);
+  if (usage !== void 0) metadata.usage = usage;
+  return {
+    sessionId: props.sessionId,
+    runId: props.runId,
+    level: "info",
+    category: "memory",
+    event: "memory.compacted",
+    message: "Session memory compacted",
+    metadata
+  };
+}
 function runFailedLog(sessionId, runId, error, startedAt) {
   return {
     sessionId,
@@ -2680,6 +2794,9 @@ function runFailedLog(sessionId, runId, error, startedAt) {
 }
 function logsFromStreamEvent(props) {
   const { event, sessionId, runId } = props;
+  if (event.type === "memory_compaction") {
+    return [memoryCompactedLog({ sessionId, runId, ...event })];
+  }
   if (event.type === "turn_start") {
     return [
       {
@@ -2705,12 +2822,12 @@ function logsFromStreamEvent(props) {
         level: "info",
         category: "tool",
         event: "tool.called",
-        message: `Tool ${event.toolCall.function.name} called`,
+        message: `Tool ${event.toolCall.toolName} called`,
         metadata: {
           turn: event.turn,
-          toolName: event.toolCall.function.name,
-          callId: event.toolCall.callId ?? event.toolCall.id,
-          argumentBytes: byteLength2(formatUnknown(event.toolCall.function.arguments))
+          toolName: event.toolCall.toolName,
+          callId: event.toolCall.callId ?? event.toolCall.toolCallId,
+          argumentBytes: byteLength2(formatUnknown(event.toolCall.input))
         }
       }
     ];
@@ -2759,16 +2876,17 @@ function logsFromStreamEvent(props) {
     ];
   }
   if (event.type === "final") {
+    const result = event.result;
     return [
       runCompletedLog({
         sessionId,
         runId,
         durationMs: Date.now() - props.startedAt,
-        usage: event.usage,
-        output: event.output,
-        messageCount: event.messages.length
+        usage: result.usage,
+        output: result.text,
+        messageCount: result.messages.length
       }),
-      memorySavedLog({ sessionId, runId, messageCount: event.messages.length })
+      memorySavedLog({ sessionId, runId, messageCount: result.messages.length })
     ];
   }
   if (event.type === "error") {
@@ -2880,16 +2998,16 @@ function childAgentLog(event, sessionId, runId) {
         level: "debug",
         category: "tool",
         event: "child_tool.called",
-        message: `Child agent ${event.agentName ?? event.agentId} called ${child.toolCall.function.name}`,
+        message: `Child agent ${event.agentName ?? event.agentId} called ${child.toolCall.toolName}`,
         metadata: {
           parentToolName: event.toolName,
           agentId: event.agentId,
           hasAgentName: event.agentName !== void 0,
           turn: event.turn,
           childTurn: child.turn,
-          toolName: child.toolCall.function.name,
-          callId: child.toolCall.callId ?? child.toolCall.id,
-          argumentBytes: byteLength2(formatUnknown(child.toolCall.function.arguments))
+          toolName: child.toolCall.toolName,
+          callId: child.toolCall.callId ?? child.toolCall.toolCallId,
+          argumentBytes: byteLength2(formatUnknown(child.toolCall.input))
         }
       }
     ];
@@ -2940,14 +3058,16 @@ function childAgentLog(event, sessionId, runId) {
     ];
   }
   if (child.type === "final") {
+    const result = child.result;
     const metadata = {
       parentToolName: event.toolName,
       agentId: event.agentId,
       hasAgentName: event.agentName !== void 0,
-      outputBytes: byteLength2(child.output),
-      messageCount: child.messages.length
+      outputBytes: byteLength2(result.text),
+      messageCount: result.messages.length,
+      status: result.status
     };
-    const usage = usageSummary(child.usage);
+    const usage = usageSummary(result.usage);
     if (usage !== void 0) metadata.usage = usage;
     return [
       {
@@ -3073,18 +3193,18 @@ async function prepareAgentRun(c, props) {
     store: props.stores.sessions
   });
   const memoryMetadata = runMemoryMetadata(agentId, body, selectedModel, runId);
-  const promptMessage = normalizePromptMessage(body.message);
+  const promptMessage = body.messages.at(-1);
   const sessionStore = props.stores.sessions;
   const shouldPersistSessionMessages = session !== void 0 && sessionStore !== void 0 && !usesStoreAsAgentMemory(runAgent, sessionStore);
   if (shouldPersistSessionMessages) {
     await sessionStore.append({
-      context: { sessionId: session.id, metadata: memoryMetadata },
+      scope: { sessionId: session.id, metadata: memoryMetadata },
       runId,
       turn: 1,
       messages: [promptMessage]
     });
   }
-  const request = createRunRequest({
+  const execution = createRunExecution({
     agentId,
     body,
     memoryMetadata,
@@ -3097,7 +3217,10 @@ async function prepareAgentRun(c, props) {
     agent,
     body,
     memoryMetadata,
-    request,
+    execution,
+    failureMessages: void 0,
+    memoryCompactionLogged: false,
+    options: createRunOptions(body, agentId, session, c.req.raw.signal),
     runAgent,
     runId,
     runStartedAt,
@@ -3142,7 +3265,7 @@ async function recordRunReceived(props) {
     sessionId: props.session.id,
     runId: props.runId,
     agentId: props.agentId,
-    message: props.body.message,
+    message: props.body.messages.at(-1),
     stream: props.body.stream === true,
     hasTrace: props.body.trace !== void 0
   };
@@ -3189,23 +3312,38 @@ function runMemoryMetadata(agentId, body, selectedModel, runId) {
   metadata.studioRunId = runId;
   return metadata;
 }
-function createRunRequest(props) {
-  const request = props.session !== void 0 ? props.runAgent.memory === void 0 ? props.runAgent.prompt([...props.session.messages, props.promptMessage]) : props.runAgent.session(props.session.id, { metadata: props.memoryMetadata }).prompt(props.body.message) : props.runAgent.prompt(
-    props.body.history !== void 0 ? [...props.body.history, props.promptMessage] : props.body.message
-  );
-  request.withCompletionRetries();
-  if (props.body.maxTurns !== void 0) {
-    request.maxTurns(props.body.maxTurns);
-  }
-  if (props.body.toolConcurrency !== void 0) {
-    request.withToolConcurrency(props.body.toolConcurrency);
+function createRunExecution(props) {
+  const session = props.session;
+  if (session !== void 0 && props.runAgent.memory !== void 0) {
+    return {
+      generate: (options) => props.runAgent.generate({
+        prompt: props.promptMessage,
+        session: { sessionId: session.id, metadata: props.memoryMetadata },
+        ...options
+      }),
+      stream: (options) => props.runAgent.stream({
+        prompt: props.promptMessage,
+        session: { sessionId: session.id, metadata: props.memoryMetadata },
+        ...options
+      })
+    };
   }
-  if (props.body.trace !== void 0) {
-    request.withTrace(traceForRun(props.body.trace, props.agentId, props.session));
-  } else if (props.session !== void 0) {
-    request.withTrace(traceForRun(void 0, props.agentId, props.session));
+  const transcript = session !== void 0 ? [...session.messages, props.promptMessage] : props.body.messages;
+  return {
+    generate: (options) => props.runAgent.generate({ messages: transcript, ...options }),
+    stream: (options) => props.runAgent.stream({ messages: transcript, ...options })
+  };
+}
+function createRunOptions(body, agentId, session, abortSignal) {
+  const options = { abortSignal };
+  if (body.maxTurns !== void 0) options.maxTurns = body.maxTurns;
+  if (body.toolConcurrency !== void 0) options.toolConcurrency = body.toolConcurrency;
+  if (body.trace !== void 0) {
+    options.trace = traceForRun(body.trace, agentId, session);
+  } else if (session !== void 0) {
+    options.trace = traceForRun(void 0, agentId, session);
   }
-  return request;
+  return options;
 }
 function handleStreamingAgentRun(c, run, props) {
   const runtimeEvents = new AsyncEventQueue();
@@ -3216,7 +3354,6 @@ function handleStreamingAgentRun(c, run, props) {
   };
   if (run.session !== void 0) approvalContext.sessionId = run.session.id;
   if (run.body.metadata !== void 0) approvalContext.metadata = run.body.metadata;
-  run.request.approvals(props.approvalRuntime.createApprovals(approvalContext));
   const questionContext = {
     runId: run.runId,
     agentId: run.agentId,
@@ -3224,14 +3361,20 @@ function handleStreamingAgentRun(c, run, props) {
   };
   if (run.session !== void 0) questionContext.sessionId = run.session.id;
   if (run.body.metadata !== void 0) questionContext.metadata = run.body.metadata;
-  const effectiveHook = composeHooks(
-    run.runAgent.hook,
-    props.questionRuntime.createHook(questionContext)
+  const effectiveHook = props.questionRuntime.createHook(questionContext);
+  const streamOptions = withInternalAgentRunOptions(
+    { ...run.options },
+    { hook: effectiveHook, runId: run.runId }
+  );
+  const runStream = mergeRunAndApprovalEvents(
+    resumeStreamingApprovals(
+      run.runAgent,
+      run.execution.stream(streamOptions),
+      props.approvalRuntime,
+      approvalContext
+    ),
+    runtimeEvents
   );
-  if (effectiveHook !== void 0) {
-    run.request.withHook(effectiveHook);
-  }
-  const runStream = mergeRunAndApprovalEvents(run.request.stream(), runtimeEvents);
   let stream = runStream;
   let persistedRun;
   if (run.session !== void 0 && run.sessionStore !== void 0) {
@@ -3245,7 +3388,7 @@ function handleStreamingAgentRun(c, run, props) {
       }),
       store: run.sessionStore,
       session: run.session,
-      message: run.body.message,
+      message: run.body.messages.at(-1),
       runId: run.runId,
       startedAt: run.runStartedAt,
       persistGeneratedMessages: run.shouldPersistSessionMessages
@@ -3253,6 +3396,7 @@ function handleStreamingAgentRun(c, run, props) {
     stream = persistedRun.events;
   }
   return streamAgentRunEvents(c, stream, {
+    runId: run.runId,
     onCancel: async () => {
       props.approvalRuntime.cancelRun(run.runId);
       props.questionRuntime.cancelRun(run.runId);
@@ -3274,8 +3418,14 @@ function handleStreamingAgentRun(c, run, props) {
 }
 async function handleBufferedAgentRun(c, run, props) {
   try {
-    await startBufferedSessionRun(run, props);
-    const response = await run.request.send();
+    const runtimeOptions = await startBufferedSessionRun(run, props);
+    let result = await run.execution.generate(runtimeOptions);
+    const approvalContext = createApprovalContext(run);
+    while (result.status === "approval_required") {
+      const decision = await props.approvalRuntime.request(approvalContext, result.approval);
+      result = await run.runAgent.resume(result, decision);
+    }
+    const response = result;
     await completeBufferedSessionRun(run, response);
     return c.json(response);
   } catch (error) {
@@ -3294,19 +3444,55 @@ async function startBufferedSessionRun(run, props) {
   };
   if (run.session !== void 0) questionContext.sessionId = run.session.id;
   if (run.body.metadata !== void 0) questionContext.metadata = run.body.metadata;
-  const effectiveHook = composeHooks(
-    run.runAgent.hook,
-    props.questionRuntime.createHook(questionContext)
-  );
-  const approvalContext = {
+  const effectiveHook = props.questionRuntime.createHook(questionContext);
+  const internalOptions = {
+    hook: effectiveHook,
+    onFailure: ({ messages }) => {
+      run.failureMessages = structuredClone(messages);
+    },
+    runId: run.runId
+  };
+  if (run.session !== void 0 && run.sessionStore !== void 0) {
+    const sessionId = run.session.id;
+    const sessionStore = run.sessionStore;
+    internalOptions.onMemoryCompaction = async (compaction) => {
+      await appendSessionLog(
+        sessionStore,
+        memoryCompactedLog({
+          sessionId,
+          runId: run.runId,
+          ...compaction
+        })
+      );
+      run.memoryCompactionLogged = true;
+    };
+  }
+  return withInternalAgentRunOptions({ ...run.options }, internalOptions);
+}
+function createApprovalContext(run, emit) {
+  const context = {
     runId: run.runId,
     agentId: run.agentId
   };
-  if (run.session !== void 0) approvalContext.sessionId = run.session.id;
-  if (run.body.metadata !== void 0) approvalContext.metadata = run.body.metadata;
-  run.request.approvals(props.approvalRuntime.createApprovals(approvalContext));
-  if (effectiveHook !== void 0) {
-    run.request.withHook(effectiveHook);
+  if (run.session !== void 0) context.sessionId = run.session.id;
+  if (run.body.metadata !== void 0) context.metadata = run.body.metadata;
+  if (emit !== void 0) context.emit = emit;
+  return context;
+}
+async function* resumeStreamingApprovals(agent, initialStream, approvalRuntime, context) {
+  let stream = initialStream;
+  while (true) {
+    let pending;
+    for await (const event of stream) {
+      if (event.type === "approval_required") {
+        pending = event;
+        break;
+      }
+      yield event;
+    }
+    if (pending === void 0) return;
+    const decision = await approvalRuntime.request(context, pending.approval);
+    stream = agent.resume(pending, decision);
   }
 }
 async function completeBufferedSessionRun(run, response) {
@@ -3317,7 +3503,7 @@ async function completeBufferedSessionRun(run, response) {
     const generatedMessages = response.messages.slice(1);
     if (generatedMessages.length > 0) {
       await run.sessionStore.append({
-        context: { sessionId: run.session.id, metadata: run.memoryMetadata },
+        scope: { sessionId: run.session.id, metadata: run.memoryMetadata },
         runId: run.runId,
         turn: 1,
         messages: generatedMessages
@@ -3330,10 +3516,21 @@ async function completeBufferedSessionRun(run, response) {
   await run.sessionStore.saveSessionRunTranscript({
     id: run.session.id,
     runId: run.runId,
-    ...optionalTitle(run.body.message),
+    ...optionalTitle(run.body.messages.at(-1)),
     transcript,
     status: "success"
   });
+  if (response.memoryCompaction !== void 0 && !run.memoryCompactionLogged) {
+    await appendSessionLog(
+      run.sessionStore,
+      memoryCompactedLog({
+        sessionId: run.session.id,
+        runId: run.runId,
+        ...response.memoryCompaction
+      })
+    );
+    run.memoryCompactionLogged = true;
+  }
   await appendSessionLog(
     run.sessionStore,
     runCompletedLog({
@@ -3341,7 +3538,7 @@ async function completeBufferedSessionRun(run, response) {
       runId: run.runId,
       durationMs: durationMs2,
       usage: response.usage,
-      output: response.output,
+      output: response.text,
       messageCount: response.messages.length
     })
   );
@@ -3358,17 +3555,14 @@ async function failBufferedSessionRun(run, error) {
   if (run.session === void 0 || run.sessionStore === void 0) {
     return;
   }
-  const messages = await run.sessionStore.load({
-    sessionId: run.session.id,
-    metadata: run.memoryMetadata
-  });
   const durationMs2 = Date.now() - run.runStartedAt;
-  const transcript = transcriptFromMessages(messages.slice(run.session.messageCount));
+  const messages = run.failureMessages ?? [run.body.messages.at(-1)];
+  const transcript = transcriptFromMessages([...messages]);
   assignTranscriptRunDuration(transcript, durationMs2);
   await run.sessionStore.saveSessionRunTranscript({
     id: run.session.id,
     runId: run.runId,
-    ...optionalTitle(run.body.message),
+    ...optionalTitle(run.body.messages.at(-1)),
     transcript,
     status: "error",
     error: serializeError(error)
@@ -3378,14 +3572,14 @@ async function failBufferedSessionRun(run, error) {
     runFailedLog(run.session.id, run.runId, error, run.runStartedAt)
   );
 }
-function normalizePromptMessage(message) {
-  return typeof message === "string" ? Message.user(message) : message;
-}
 function usesStoreAsAgentMemory(agent, store) {
   const memoryStore = agent.memory?.store;
   return memoryStore !== void 0 && rawObservedStore(memoryStore) === rawObservedStore(store);
 }
 
+// src/runtime/approvals.ts
+import { getAgentApprovalRequestDetails } from "@anvia/core/internal/agent";
+
 // src/runtime/query.ts
 function optionalQueryString(value) {
   const trimmed = value?.trim();
@@ -3491,22 +3685,11 @@ function createApprovalRuntime() {
   const approvals = /* @__PURE__ */ new Map();
   return {
     approvals,
-    createApprovals(context) {
-      return {
-        async handler(request) {
-          const approvalRequest = {
-            toolName: request.toolName,
-            internalCallId: request.internalCallId,
-            args: request.rawArgs
-          };
-          if (request.toolCallId !== void 0) approvalRequest.toolCallId = request.toolCallId;
-          if (request.reason !== void 0) approvalRequest.reason = request.reason;
-          if (request.rejectMessage !== void 0) {
-            approvalRequest.rejectMessage = request.rejectMessage;
-          }
-          const decision = await requestApproval(approvals, context, approvalRequest);
-          return approvalDecision(decision.approved, decision.reason);
-        }
+    async request(context, approval) {
+      const decision = await requestApproval(approvals, context, approval);
+      return decision.approved ? { approved: true, ...decision.reason === void 0 ? {} : { reason: decision.reason } } : {
+        approved: false,
+        ...decision.reason === void 0 ? {} : { reason: decision.reason }
       };
     },
     list(options) {
@@ -3567,14 +3750,15 @@ function createApprovalRuntime() {
   };
 }
 async function requestApproval(approvals, context, request) {
-  const id = globalThis.crypto.randomUUID();
+  const id = request.id;
+  const details = getAgentApprovalRequestDetails(request);
   const approval = {
     id,
     runId: context.runId,
     agentId: context.agentId,
     toolName: request.toolName,
-    internalCallId: request.internalCallId,
-    args: request.args,
+    internalCallId: details?.internalCallId ?? request.id,
+    args: details?.rawArgs ?? JSON.stringify(request.input) ?? "null",
     status: "pending",
     requestedAt: (/* @__PURE__ */ new Date()).toISOString(),
     resolve: () => {
@@ -3583,7 +3767,7 @@ async function requestApproval(approvals, context, request) {
   if (context.sessionId !== void 0) approval.sessionId = context.sessionId;
   if (request.toolCallId !== void 0) approval.callId = request.toolCallId;
   if (request.reason !== void 0) approval.reason = request.reason;
-  if (request.rejectMessage !== void 0) approval.rejectMessage = request.rejectMessage;
+  if (details?.rejectMessage !== void 0) approval.rejectMessage = details.rejectMessage;
   if (context.emit !== void 0) approval.emit = context.emit;
   const decision = new Promise((resolve2) => {
     approval.resolve = (decision2) => {
@@ -3594,7 +3778,7 @@ async function requestApproval(approvals, context, request) {
         }
         return;
       }
-      const reason = decision2.approved ? decision2.reason : decision2.reason ?? request.rejectMessage ?? "Rejected in Anvia Studio.";
+      const reason = decision2.approved ? decision2.reason : decision2.reason ?? details?.rejectMessage ?? "Rejected in Anvia Studio.";
       const resolved = resolveApproval(
         current,
         decision2.approved ? "approved" : "rejected",
@@ -3712,242 +3896,8 @@ function isRecord2(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
 
-// src/runtime/tool-metadata.ts
-import { ToolSet } from "@anvia/core/tool";
-var MCP_TOOL_METADATA_KEY = /* @__PURE__ */ Symbol.for("anvia.mcp.tool.metadata");
-function agentToolItems(agent) {
-  return [
-    ...agent.agent.toolSet.values().map((tool) => ({ tool, source: "static" })),
-    ...agent.agent.dynamicTools.flatMap((registration) => {
-      const maybeToolSet = registration.index.toolSet;
-      if (!(maybeToolSet instanceof ToolSet)) {
-        return [];
-      }
-      return maybeToolSet.values().map((tool) => ({ tool, source: "dynamic" }));
-    })
-  ];
-}
-function approvalMetadata(tool) {
-  const approval = tool.approval;
-  if (approval === void 0 || typeof approval !== "object" || approval === null) {
-    return { required: false };
-  }
-  const policy = approval;
-  const metadata = { required: true };
-  if (typeof policy.reason === "string") metadata.reason = policy.reason;
-  if (typeof policy.rejectMessage === "string") metadata.rejectMessage = policy.rejectMessage;
-  return metadata;
-}
-function mcpServerName(tool) {
-  const metadata = tool[MCP_TOOL_METADATA_KEY];
-  if (typeof metadata !== "object" || metadata === null) {
-    return void 0;
-  }
-  const serverName = metadata.serverName;
-  return typeof serverName === "string" && serverName.length > 0 ? serverName : void 0;
-}
-function agentHasMcpTools(agent) {
-  return agentToolItems(agent).some(({ tool }) => mcpServerName(tool) !== void 0);
-}
-
-// src/runtime/config.ts
-function runnerId(options) {
-  return options.id ?? "anvia-studio";
-}
-function agentConfig(agent) {
-  const name = agent.name ?? agent.agent.name;
-  const description = agent.description ?? agent.agent.description;
-  const config = {
-    id: agent.id,
-    quickPrompts: agent.quickPrompts ?? []
-  };
-  if (name !== void 0) config.name = name;
-  if (description !== void 0) config.description = description;
-  if (agent.metadata !== void 0) config.metadata = agent.metadata;
-  return config;
-}
-function agentRuntimeSummary(agent) {
-  const tools = agentToolItems(agent);
-  const name = agent.name ?? agent.agent.name;
-  const description = agent.description ?? agent.agent.description;
-  const summary = {
-    id: agent.id,
-    model: toJsonValue2(agent.agent.model),
-    toolCount: tools.length,
-    staticToolCount: tools.filter((item) => item.source === "static").length,
-    dynamicToolCount: tools.filter((item) => item.source === "dynamic").length,
-    approvalToolCount: tools.filter((item) => item.tool.approval !== void 0).length,
-    mcpToolCount: tools.filter((item) => mcpServerName(item.tool) !== void 0).length,
-    staticContextCount: agent.agent.staticContext.length,
-    dynamicContextCount: agent.agent.dynamicContexts.length,
-    observerCount: agent.agent.observers.length,
-    hasMemory: agent.agent.memory !== void 0,
-    hasHook: agent.agent.hook !== void 0,
-    hasOutputSchema: agent.agent.outputSchema !== void 0
-  };
-  if (name !== void 0) summary.name = name;
-  if (description !== void 0) summary.description = description;
-  if (agent.agent.defaultMaxTurns !== void 0) {
-    summary.defaultMaxTurns = agent.agent.defaultMaxTurns;
-  }
-  if (agent.metadata !== void 0) summary.metadata = agent.metadata;
-  return summary;
-}
-function pipelineConfig(pipeline) {
-  const graph = pipeline.pipeline.graph();
-  const stageNodes = graph.nodes.filter((node) => node.kind !== "input" && node.kind !== "output");
-  const config = {
-    id: pipeline.id,
-    stageCount: stageNodes.length,
-    edgeCount: graph.edges.length,
-    hasParallelStages: graph.nodes.some((node) => node.kind === "parallel"),
-    agentCount: graph.nodes.filter((node) => node.kind === "agent").length,
-    extractorCount: graph.nodes.filter((node) => node.kind === "extractor").length
-  };
-  if (pipeline.name !== void 0) config.name = pipeline.name;
-  if (pipeline.description !== void 0) config.description = pipeline.description;
-  if (pipeline.metadata !== void 0) config.metadata = pipeline.metadata;
-  return config;
-}
-function buildConfig(options, agents, pipelines, stores, sandboxCount = 0) {
-  const models = options.models === void 0 ? void 0 : studioModelsConfig(createStudioModelRegistry(options.models), agents);
-  const config = {
-    id: runnerId(options),
-    agents: agents.map(agentConfig),
-    pipelines: pipelines.map(pipelineConfig),
-    evals: options.evals.map(evalConfig),
-    chat: {
-      quickPrompts: Object.fromEntries(agents.map((agent) => [agent.id, agent.quickPrompts ?? []]))
-    },
-    capabilities: capabilityConfig(options, agents, pipelines, stores, sandboxCount),
-    unsupportedCapabilities: unsupportedCapabilities(stores)
-  };
-  if (options.name !== void 0) config.name = options.name;
-  if (options.description !== void 0) config.description = options.description;
-  if (options.version !== void 0) config.version = options.version;
-  if (models !== void 0) config.models = models;
-  return config;
-}
-function capabilityConfig(_options, agents, pipelines, stores, sandboxCount = 0) {
-  const capabilities = {
-    agents: { enabled: true },
-    observability: { enabled: true },
-    status: { enabled: true }
-  };
-  if (stores.sessions !== void 0) {
-    capabilities.sessions = { enabled: true };
-  }
-  if (stores.sessions !== void 0 || agents.some((agent) => agent.agent.memory !== void 0)) {
-    capabilities.memory = { enabled: true };
-  }
-  if (stores.traces !== void 0) {
-    capabilities.traces = { enabled: true };
-  }
-  if (pipelines.length > 0) {
-    capabilities.pipelines = { enabled: true };
-  }
-  if (_options.evals.length > 0) {
-    capabilities.evals = { enabled: true };
-  }
-  if (agents.some(
-    (agent) => agent.agent.toolSet.values().length > 0 || agent.agent.dynamicTools.length > 0
-  )) {
-    capabilities.tools = { enabled: true };
-  }
-  if (agents.some(agentHasMcpTools)) {
-    capabilities.mcps = { enabled: true };
-  }
-  if (sandboxCount > 0) {
-    capabilities.sandboxes = { enabled: true };
-  }
-  if (agents.some(
-    (agent) => agent.agent.hook !== void 0 || agent.agent.toolSet.values().some((tool) => tool.approval)
-  )) {
-    capabilities.approvals = { enabled: true };
-  }
-  if (agents.some(
-    (agent) => agent.agent.staticContext.length > 0 || agent.agent.dynamicContexts.length > 0 || agent.agent.dynamicTools.length > 0
-  )) {
-    capabilities.knowledge = { enabled: true };
-  }
-  return capabilities;
-}
-function unsupportedCapabilities(stores) {
-  const capabilities = [];
-  if (stores.sessions === void 0) capabilities.push("sessions");
-  if (stores.traces === void 0) capabilities.push("traces");
-  return capabilities;
-}
-function toJsonValue2(value) {
-  return serializeUnknown(value);
-}
-
-// src/runtime/evals.ts
-import { runEvalSuite } from "@anvia/core/evals";
-function registerEvalRoutes(app, props) {
-  app.get(
-    "/evals",
-    (c) => c.json({
-      evals: props.evals.map(evalConfig)
-    })
-  );
-  app.get("/evals/:evalId", (c) => {
-    const suite = props.evalMap.get(c.req.param("evalId"));
-    if (suite === void 0) {
-      return errorResponse(c, 404, "not_found", "Eval suite not found");
-    }
-    return c.json(evalConfig(suite));
-  });
-  app.post("/evals/:evalId/runs", async (c) => {
-    const suite = props.evalMap.get(c.req.param("evalId"));
-    if (suite === void 0) {
-      return errorResponse(c, 404, "not_found", "Eval suite not found");
-    }
-    const body = await parseEvalRunRequest(c);
-    if ("error" in body) {
-      return body.error;
-    }
-    const runId = globalThis.crypto.randomUUID();
-    const startedAt = Date.now();
-    const runOptions = { ...suite };
-    if (body.concurrency !== void 0) runOptions.concurrency = body.concurrency;
-    const result = await runEvalSuite(runOptions);
-    const endedAt = Date.now();
-    const jsonResult = toJsonValue(result);
-    const response = {
-      runId,
-      suiteId: suite.id ?? suite.name,
-      startedAt: new Date(startedAt).toISOString(),
-      endedAt: new Date(endedAt).toISOString(),
-      durationMs: endedAt - startedAt,
-      result: isJsonObject(jsonResult) ? jsonResult : { value: jsonResult }
-    };
-    return c.json(response);
-  });
-}
-async function parseEvalRunRequest(c) {
-  let body = {};
-  try {
-    body = await c.req.json();
-  } catch {
-    body = {};
-  }
-  if (!isObject(body)) {
-    return { error: errorResponse(c, 400, "bad_request", "Request body must be an object") };
-  }
-  const request = {};
-  if ("concurrency" in body) {
-    if (!isPositiveInteger(body.concurrency)) {
-      return {
-        error: errorResponse(c, 400, "bad_request", "concurrency must be a positive integer")
-      };
-    }
-    request.concurrency = body.concurrency;
-  }
-  return request;
-}
-
 // src/runtime/knowledge.ts
+import { getAgentToolState } from "@anvia/core/internal/agent";
 function registerKnowledgeRoutes(app, props) {
   app.get("/knowledge", async (c) => {
     const limit = parseLimit(c.req.query("limit"));
@@ -3984,12 +3934,17 @@ function registerKnowledgeRoutes(app, props) {
     return c.json(page);
   });
 }
+function agentHasKnowledge(agent) {
+  const toolIndexes = getAgentToolState(agent.agent).toolIndexes;
+  return agent.agent.context.length > 0 || toolIndexes.length > 0;
+}
 async function agentKnowledgeConfig(agent) {
   const agentName = agent.name ?? agent.agent.name;
+  const staticContext = staticContextDocuments(agent.agent);
   const config = {
     agentId: agent.id,
     sources: await knowledgeSources(agent),
-    staticContext: agent.agent.staticContext.map((document) => {
+    staticContext: staticContext.map((document) => {
       const item = { id: document.id, text: document.text };
       if (document.additionalProps !== void 0) {
         item.additionalProps = jsonObjectFromRecord(document.additionalProps);
@@ -4001,51 +3956,54 @@ async function agentKnowledgeConfig(agent) {
   return config;
 }
 async function knowledgeSources(agent) {
+  const toolIndexes = getAgentToolState(agent.agent).toolIndexes;
+  const staticContext = staticContextDocuments(agent.agent);
+  const indexedContext = vectorContexts(agent.agent);
   const sources = [
     {
       sourceId: staticSourceId(),
       kind: "static_context",
       label: "Static context",
-      count: agent.agent.staticContext.length,
+      count: staticContext.length,
       inspectable: true,
-      itemCount: agent.agent.staticContext.length
+      itemCount: staticContext.length
     }
   ];
   const dynamicContextSources = await Promise.all(
-    agent.agent.dynamicContexts.map(async (registration, index) => {
-      const inspect = inspectFn(registration.index);
-      const count = await inspectableCount(inspect, registration.options.filter);
+    indexedContext.map(async (vectorContext, index) => {
+      const inspect = inspectFn(vectorContext.store);
+      const count = await inspectableCount(inspect, vectorContext.filter);
       const source = {
         sourceId: dynamicContextSourceId(index),
         kind: "dynamic_context",
         label: `Dynamic context ${index + 1}`,
         count: 1,
         registrationIndex: index,
-        topK: registration.options.topK,
+        topK: vectorContext.topK,
         inspectable: inspect !== void 0
       };
-      if (registration.options.threshold !== void 0) {
-        source.threshold = registration.options.threshold;
+      if (vectorContext.minScore !== void 0) {
+        source.minScore = vectorContext.minScore;
       }
       if (count !== void 0) source.itemCount = count;
       return source;
     })
   );
   const dynamicToolSources = await Promise.all(
-    agent.agent.dynamicTools.map(async (registration, index) => {
-      const inspect = inspectFn(registration.index);
-      const count = await inspectableCount(inspect, registration.options.filter);
+    toolIndexes.map(async (toolIndex, index) => {
+      const inspect = inspectFn(toolIndex);
+      const count = await inspectableCount(inspect, toolIndex.filter);
       const source = {
         sourceId: dynamicToolsSourceId(index),
         kind: "dynamic_tools",
         label: `Dynamic tools ${index + 1}`,
         count: 1,
         registrationIndex: index,
-        topK: registration.options.topK,
+        topK: toolIndex.topK,
         inspectable: inspect !== void 0
       };
-      if (registration.options.threshold !== void 0) {
-        source.threshold = registration.options.threshold;
+      if (toolIndex.minScore !== void 0) {
+        source.minScore = toolIndex.minScore;
       }
       if (count !== void 0) source.itemCount = count;
       return source;
@@ -4064,20 +4022,20 @@ async function knowledgeItemsPage(agent, sourceId, request) {
   if (sourceId === staticSourceId()) {
     return staticKnowledgeItemsPage(agent, request);
   }
-  const dynamicContextIndex = dynamicSourceIndex(sourceId, "dynamic_context");
-  if (dynamicContextIndex !== void 0) {
-    const registration = agent.agent.dynamicContexts[dynamicContextIndex];
-    if (registration === void 0) {
+  const vectorContextIndex = dynamicSourceIndex(sourceId, "dynamic_context");
+  if (vectorContextIndex !== void 0) {
+    const vectorContext = vectorContexts(agent.agent)[vectorContextIndex];
+    if (vectorContext === void 0) {
       return void 0;
     }
-    const inspect = inspectFn(registration.index);
+    const inspect = inspectFn(vectorContext.store);
     if (inspect === void 0) {
       return nonInspectablePage(agent.id, sourceId, "dynamic_context");
     }
     const page = await inspect({
       limit: request.limit,
       cursor: request.cursor,
-      filter: registration.options.filter
+      filter: vectorContext.filter
     });
     const result = {
       agentId: agent.id,
@@ -4092,18 +4050,18 @@ async function knowledgeItemsPage(agent, sourceId, request) {
   }
   const dynamicToolsIndex = dynamicSourceIndex(sourceId, "dynamic_tools");
   if (dynamicToolsIndex !== void 0) {
-    const registration = agent.agent.dynamicTools[dynamicToolsIndex];
-    if (registration === void 0) {
+    const toolIndex = getAgentToolState(agent.agent).toolIndexes[dynamicToolsIndex];
+    if (toolIndex === void 0) {
       return void 0;
     }
-    const inspect = inspectFn(registration.index);
+    const inspect = inspectFn(toolIndex);
     if (inspect === void 0) {
       return nonInspectablePage(agent.id, sourceId, "dynamic_tools");
     }
     const page = await inspect({
       limit: request.limit,
       cursor: request.cursor,
-      filter: registration.options.filter
+      filter: toolIndex.filter
     });
     const result = {
       agentId: agent.id,
@@ -4118,16 +4076,17 @@ async function knowledgeItemsPage(agent, sourceId, request) {
   }
   return void 0;
 }
-function inspectFn(index) {
-  if (!isRecord3(index) || typeof index.inspect !== "function") {
+function inspectFn(store) {
+  if (!isRecord3(store) || typeof store.inspect !== "function") {
     return void 0;
   }
-  const inspect = index.inspect;
-  return (request) => inspect.call(index, request);
+  const inspect = store.inspect;
+  return (request) => inspect.call(store, request);
 }
 function staticKnowledgeItemsPage(agent, request) {
+  const staticContext = staticContextDocuments(agent.agent);
   const start = Math.max(0, Math.trunc(Number(request.cursor ?? "0")));
-  const page = agent.agent.staticContext.slice(start, start + request.limit);
+  const page = staticContext.slice(start, start + request.limit);
   const nextOffset = start + page.length;
   const result = {
     agentId: agent.id,
@@ -4145,9 +4104,9 @@ function staticKnowledgeItemsPage(agent, request) {
       }
       return item;
     }),
-    totalCount: agent.agent.staticContext.length
+    totalCount: staticContext.length
   };
-  if (nextOffset < agent.agent.staticContext.length) result.nextCursor = String(nextOffset);
+  if (nextOffset < staticContext.length) result.nextCursor = String(nextOffset);
   return result;
 }
 function nonInspectablePage(agentId, sourceId, kind) {
@@ -4275,65 +4234,299 @@ function queryFromGenerationInput(value) {
       }
     }
   }
-  return void 0;
+  return void 0;
+}
+function messageText(value) {
+  if (typeof value === "string") {
+    return value.trim();
+  }
+  if (!isRecord3(value)) {
+    return "";
+  }
+  if (typeof value.text === "string") {
+    return value.text.trim();
+  }
+  if (typeof value.content === "string") {
+    return value.content.trim();
+  }
+  if (Array.isArray(value.content)) {
+    return value.content.map(contentText).filter(Boolean).join("\n").trim();
+  }
+  return "";
+}
+function contentText(value) {
+  if (typeof value === "string") {
+    return value.trim();
+  }
+  if (!isRecord3(value)) {
+    return "";
+  }
+  if (typeof value.text === "string") {
+    return value.text.trim();
+  }
+  return "";
+}
+function evidenceDocument(value) {
+  if (!isRecord3(value)) {
+    return [];
+  }
+  const id = typeof value.id === "string" ? value.id : void 0;
+  const text = typeof value.text === "string" ? value.text : void 0;
+  const additionalProps = isRecord3(value.additionalProps) ? jsonObjectFromRecord(value.additionalProps) : void 0;
+  if (id === void 0 && text === void 0 && additionalProps === void 0) {
+    return [];
+  }
+  const document = {};
+  if (id !== void 0) document.id = id;
+  if (text !== void 0) document.text = text;
+  if (additionalProps !== void 0) document.additionalProps = additionalProps;
+  return [document];
+}
+function evidenceToolName(value) {
+  if (!isRecord3(value) || typeof value.name !== "string") {
+    return [];
+  }
+  return [value.name];
+}
+function jsonObjectFromRecord(value) {
+  return compactJsonObject(value);
+}
+function isRecord3(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+// src/runtime/tool-metadata.ts
+import { getAgentToolState as getAgentToolState2 } from "@anvia/core/internal/agent";
+import { isMcpTool } from "@anvia/core/mcp";
+function agentToolItems(agent) {
+  const state = getAgentToolState2(agent.agent);
+  const items = state.staticTools.map((tool) => ({ tool, source: "static" }));
+  const names = new Set(items.map(({ tool }) => tool.name));
+  for (const index of state.toolIndexes) {
+    for (const tool of index.tools) {
+      if (!names.has(tool.name)) {
+        names.add(tool.name);
+        items.push({ tool, source: "dynamic" });
+      }
+    }
+  }
+  return items;
+}
+function approvalMetadata(tool) {
+  const approval = tool.requiresApproval;
+  if (approval === void 0 || approval === false) {
+    return { required: false };
+  }
+  if (typeof approval !== "object" || approval === null) {
+    return { required: true };
+  }
+  const policy = approval;
+  const metadata = { required: true };
+  if (typeof policy.reason === "string") metadata.reason = policy.reason;
+  return metadata;
+}
+function toolRequiresApproval(tool) {
+  const approval = tool.requiresApproval;
+  return approval !== void 0 && approval !== false;
+}
+function mcpServerName(tool) {
+  return isMcpTool(tool) ? tool.mcp.serverName : void 0;
+}
+function agentHasMcpServers(agent) {
+  return agent.agent.mcpServers.length > 0;
+}
+
+// src/runtime/config.ts
+function runnerId(options) {
+  return options.id ?? "anvia-studio";
+}
+function agentConfig(agent) {
+  const name = agent.name ?? agent.agent.name;
+  const description = agent.description ?? agent.agent.description;
+  const config = {
+    id: agent.id,
+    quickPrompts: agent.quickPrompts ?? []
+  };
+  if (name !== void 0) config.name = name;
+  if (description !== void 0) config.description = description;
+  if (agent.metadata !== void 0) config.metadata = agent.metadata;
+  return config;
+}
+function agentRuntimeSummary(agent) {
+  const tools = agentToolItems(agent);
+  const staticContext = staticContextDocuments(agent.agent);
+  const indexedContext = vectorContexts(agent.agent);
+  const name = agent.name ?? agent.agent.name;
+  const description = agent.description ?? agent.agent.description;
+  const summary = {
+    id: agent.id,
+    model: toJsonValue2(agent.agent.model),
+    toolCount: tools.length,
+    staticToolCount: tools.filter((item) => item.source === "static").length,
+    dynamicToolCount: tools.filter((item) => item.source === "dynamic").length,
+    approvalToolCount: tools.filter((item) => toolRequiresApproval(item.tool)).length,
+    mcpToolCount: tools.filter((item) => mcpServerName(item.tool) !== void 0).length,
+    staticContextCount: staticContext.length,
+    dynamicContextCount: indexedContext.length,
+    observerCount: Object.keys(agent.agent.observability?.observers ?? {}).length,
+    hasMemory: agent.agent.memory !== void 0,
+    hasLifecycle: agent.agent.lifecycle !== void 0,
+    hasOutputSchema: agent.agent.outputSchema !== void 0
+  };
+  if (name !== void 0) summary.name = name;
+  if (description !== void 0) summary.description = description;
+  if (agent.agent.defaultMaxTurns !== void 0) {
+    summary.defaultMaxTurns = agent.agent.defaultMaxTurns;
+  }
+  if (agent.metadata !== void 0) summary.metadata = agent.metadata;
+  return summary;
 }
-function messageText(value) {
-  if (typeof value === "string") {
-    return value.trim();
+function pipelineConfig(pipeline) {
+  const graph = pipeline.pipeline.graph();
+  const stageNodes = graph.nodes.filter((node) => node.kind !== "input" && node.kind !== "output");
+  const config = {
+    id: pipeline.id,
+    stageCount: stageNodes.length,
+    edgeCount: graph.edges.length,
+    hasParallelStages: graph.nodes.some((node) => node.kind === "parallel"),
+    agentCount: graph.nodes.filter((node) => node.kind === "agent").length,
+    extractorCount: graph.nodes.filter((node) => node.kind === "extractor").length
+  };
+  if (pipeline.name !== void 0) config.name = pipeline.name;
+  if (pipeline.description !== void 0) config.description = pipeline.description;
+  if (pipeline.metadata !== void 0) config.metadata = pipeline.metadata;
+  return config;
+}
+function buildConfig(options, agents, pipelines, stores, sandboxCount = 0) {
+  const models = options.models === void 0 ? void 0 : studioModelsConfig(createStudioModelRegistry(options.models), agents);
+  const config = {
+    id: runnerId(options),
+    agents: agents.map(agentConfig),
+    pipelines: pipelines.map(pipelineConfig),
+    evals: options.evals.map(evalConfig),
+    chat: {
+      quickPrompts: Object.fromEntries(agents.map((agent) => [agent.id, agent.quickPrompts ?? []]))
+    },
+    capabilities: capabilityConfig(options, agents, pipelines, stores, sandboxCount),
+    unsupportedCapabilities: unsupportedCapabilities(stores)
+  };
+  if (options.name !== void 0) config.name = options.name;
+  if (options.description !== void 0) config.description = options.description;
+  if (options.version !== void 0) config.version = options.version;
+  if (models !== void 0) config.models = models;
+  return config;
+}
+function capabilityConfig(_options, agents, pipelines, stores, sandboxCount = 0) {
+  const capabilities = {
+    agents: { enabled: true },
+    observability: { enabled: true },
+    status: { enabled: true }
+  };
+  if (stores.sessions !== void 0) {
+    capabilities.sessions = { enabled: true };
   }
-  if (!isRecord3(value)) {
-    return "";
+  if (stores.sessions !== void 0 || agents.some((agent) => agent.agent.memory !== void 0)) {
+    capabilities.memory = { enabled: true };
   }
-  if (typeof value.text === "string") {
-    return value.text.trim();
+  if (stores.traces !== void 0) {
+    capabilities.traces = { enabled: true };
   }
-  if (typeof value.content === "string") {
-    return value.content.trim();
+  if (pipelines.length > 0) {
+    capabilities.pipelines = { enabled: true };
   }
-  if (Array.isArray(value.content)) {
-    return value.content.map(contentText).filter(Boolean).join("\n").trim();
+  if (_options.evals.length > 0) {
+    capabilities.evals = { enabled: true };
   }
-  return "";
-}
-function contentText(value) {
-  if (typeof value === "string") {
-    return value.trim();
+  if (agents.some((agent) => agent.agent.tools.length > 0)) {
+    capabilities.tools = { enabled: true };
   }
-  if (!isRecord3(value)) {
-    return "";
+  if (agents.some(agentHasMcpServers)) {
+    capabilities.mcps = { enabled: true };
   }
-  if (typeof value.text === "string") {
-    return value.text.trim();
+  if (sandboxCount > 0) {
+    capabilities.sandboxes = { enabled: true };
   }
-  return "";
-}
-function evidenceDocument(value) {
-  if (!isRecord3(value)) {
-    return [];
+  if (agents.some((agent) => agent.agent.tools.some(toolRequiresApproval))) {
+    capabilities.approvals = { enabled: true };
   }
-  const id = typeof value.id === "string" ? value.id : void 0;
-  const text = typeof value.text === "string" ? value.text : void 0;
-  const additionalProps = isRecord3(value.additionalProps) ? jsonObjectFromRecord(value.additionalProps) : void 0;
-  if (id === void 0 && text === void 0 && additionalProps === void 0) {
-    return [];
+  if (agents.some(agentHasKnowledge)) {
+    capabilities.knowledge = { enabled: true };
   }
-  const document = {};
-  if (id !== void 0) document.id = id;
-  if (text !== void 0) document.text = text;
-  if (additionalProps !== void 0) document.additionalProps = additionalProps;
-  return [document];
+  return capabilities;
 }
-function evidenceToolName(value) {
-  if (!isRecord3(value) || typeof value.name !== "string") {
-    return [];
-  }
-  return [value.name];
+function unsupportedCapabilities(stores) {
+  const capabilities = [];
+  if (stores.sessions === void 0) capabilities.push("sessions");
+  if (stores.traces === void 0) capabilities.push("traces");
+  return capabilities;
 }
-function jsonObjectFromRecord(value) {
-  return compactJsonObject(value);
+function toJsonValue2(value) {
+  return serializeUnknown(value);
 }
-function isRecord3(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
+
+// src/runtime/evals.ts
+import { runEvalSuite } from "@anvia/core/evals";
+function registerEvalRoutes(app, props) {
+  app.get(
+    "/evals",
+    (c) => c.json({
+      evals: props.evals.map(evalConfig)
+    })
+  );
+  app.get("/evals/:evalId", (c) => {
+    const suite = props.evalMap.get(c.req.param("evalId"));
+    if (suite === void 0) {
+      return errorResponse(c, 404, "not_found", "Eval suite not found");
+    }
+    return c.json(evalConfig(suite));
+  });
+  app.post("/evals/:evalId/runs", async (c) => {
+    const suite = props.evalMap.get(c.req.param("evalId"));
+    if (suite === void 0) {
+      return errorResponse(c, 404, "not_found", "Eval suite not found");
+    }
+    const body = await parseEvalRunRequest(c);
+    if ("error" in body) {
+      return body.error;
+    }
+    const runId = globalThis.crypto.randomUUID();
+    const startedAt = Date.now();
+    const runOptions = { ...suite };
+    if (body.concurrency !== void 0) runOptions.concurrency = body.concurrency;
+    const result = await runEvalSuite(runOptions);
+    const endedAt = Date.now();
+    const jsonResult = toJsonValue(result);
+    const response = {
+      runId,
+      suiteId: suite.id ?? suite.name,
+      startedAt: new Date(startedAt).toISOString(),
+      endedAt: new Date(endedAt).toISOString(),
+      durationMs: endedAt - startedAt,
+      result: isJsonObject(jsonResult) ? jsonResult : { value: jsonResult }
+    };
+    return c.json(response);
+  });
+}
+async function parseEvalRunRequest(c) {
+  let body = {};
+  try {
+    body = await c.req.json();
+  } catch {
+    body = {};
+  }
+  if (!isObject(body)) {
+    return { error: errorResponse(c, 400, "bad_request", "Request body must be an object") };
+  }
+  const request = {};
+  if ("concurrency" in body) {
+    if (!isPositiveInteger(body.concurrency)) {
+      return {
+        error: errorResponse(c, 400, "bad_request", "concurrency must be a positive integer")
+      };
+    }
+    request.concurrency = body.concurrency;
+  }
+  return request;
 }
 
 // src/runtime/mcps.ts
@@ -4351,43 +4544,29 @@ function registerMcpRoutes(app, props) {
   });
 }
 async function agentMcpMetadata(agent) {
-  const servers = /* @__PURE__ */ new Map();
-  const seen = /* @__PURE__ */ new Set();
-  for (const { tool, source } of agentToolItems(agent)) {
-    const serverName = mcpServerName(tool);
-    if (serverName === void 0) {
-      continue;
-    }
-    const definition = await tool.definition("");
-    const key = `${serverName}:${source}:${definition.name}`;
-    if (seen.has(key)) {
-      continue;
-    }
-    seen.add(key);
-    const tools = servers.get(serverName) ?? [];
-    tools.push({
-      name: definition.name,
-      description: definition.description,
-      parameters: definition.parameters,
-      source,
-      approval: approvalMetadata(tool)
-    });
-    servers.set(serverName, tools);
-  }
-  return [...servers.entries()].map(([name, tools]) => {
-    const sortedTools = tools.sort((left, right) => {
-      if (left.source !== right.source) {
-        return left.source === "static" ? -1 : 1;
-      }
-      return left.name.localeCompare(right.name);
-    });
-    return {
-      agentId: agent.id,
-      name,
-      toolCount: sortedTools.length,
-      tools: sortedTools
-    };
-  }).sort((left, right) => left.name.localeCompare(right.name));
+  return Promise.all(
+    agent.agent.mcpServers.map(async (server) => {
+      const tools = await Promise.all(
+        server.tools.map(async (tool) => {
+          const definition = await tool.definition("");
+          return {
+            name: definition.name,
+            description: definition.description,
+            parameters: definition.parameters,
+            source: "static",
+            approval: approvalMetadata(tool)
+          };
+        })
+      );
+      const sortedTools = tools.sort((left, right) => left.name.localeCompare(right.name));
+      return {
+        agentId: agent.id,
+        name: server.name,
+        toolCount: sortedTools.length,
+        tools: sortedTools
+      };
+    })
+  ).then((servers) => servers.sort((left, right) => left.name.localeCompare(right.name)));
 }
 
 // src/runtime/memory.ts
@@ -4609,7 +4788,7 @@ function agentMemorySource(ref, label, agentId, storeKindValue, inspector) {
       ).slice(0, options.limit);
     },
     async getConversation(conversationRef) {
-      const conversation = await inspector.getConversation(conversationRef);
+      const conversation = await inspector.getConversation({ ref: conversationRef });
       return conversation === void 0 ? void 0 : inspectorConversationDetail(conversation, summary.agentIds);
     }
   };
@@ -4832,12 +5011,12 @@ function pipelineRunFailedLog(pipelineId, runId, error, startedAt) {
     }
   };
 }
-function pipelineStageLog(pipelineId, runId, event) {
+function pipelineStageLog(event, studioPipelineId = event.pipelineId) {
   const category = stageCategory(event.node);
   if (event.type === "stage_started") {
     return {
-      pipelineId,
-      runId,
+      pipelineId: studioPipelineId,
+      runId: event.runId,
       level: "debug",
       category,
       event: `${event.node.kind}.started`,
@@ -4847,8 +5026,8 @@ function pipelineStageLog(pipelineId, runId, event) {
   }
   if (event.type === "stage_completed") {
     return {
-      pipelineId,
-      runId,
+      pipelineId: studioPipelineId,
+      runId: event.runId,
       level: "debug",
       category,
       event: `${event.node.kind}.completed`,
@@ -4860,8 +5039,8 @@ function pipelineStageLog(pipelineId, runId, event) {
     };
   }
   return {
-    pipelineId,
-    runId,
+    pipelineId: studioPipelineId,
+    runId: event.runId,
     level: "error",
     category,
     event: `${event.node.kind}.failed`,
@@ -4888,6 +5067,7 @@ function stageCategory(node) {
 function nodeMetadata(node) {
   const metadata = {
     nodeId: node.id,
+    nodePath: [...node.path],
     kind: node.kind,
     label: node.label
   };
@@ -5049,17 +5229,24 @@ async function executePipelineRun(c, props, pipeline, body) {
     if (body.metadata !== void 0) streamOptions.metadata = body.metadata;
     if (props.logStore !== void 0) streamOptions.logStore = props.logStore;
     if (props.runStore !== void 0) streamOptions.runStore = props.runStore;
+    streamOptions.abortSignal = c.req.raw.signal;
     return streamPipelineRun(c, streamOptions);
   }
   try {
     await appendPipelineLog(props.logStore, pipelineRunStartedLog(pipeline, runId));
-    const output = await pipeline.pipeline.run(body.input, {
+    const result = await pipeline.pipeline.run({
+      input: body.input,
+      runId,
+      metadata: body.metadata,
+      abortSignal: c.req.raw.signal,
       observer: {
         async onEvent(event) {
-          await appendPipelineLog(props.logStore, pipelineStageLog(pipeline.id, runId, event));
+          await appendPipelineLog(props.logStore, pipelineStageLog(event, pipeline.id));
         }
-      }
+      },
+      failOnObserverError: true
     });
+    const output = result.output;
     const jsonOutput = toJsonValue(output);
     const endedAt = Date.now();
     const successRecord = {
@@ -5124,19 +5311,24 @@ function streamPipelineRun(_c, props) {
 async function* pipelineRunEvents(props) {
   yield* emitPipelineLog(props.logStore, pipelineRunStartedLog(props.pipeline, props.runId));
   const events = new AsyncEventQueue();
-  const run = props.pipeline.pipeline.run(props.input, {
+  const run = props.pipeline.pipeline.run({
+    input: props.input,
+    runId: props.runId,
+    metadata: props.metadata,
+    abortSignal: props.abortSignal,
     observer: {
       async onEvent(event) {
         const log = await appendPipelineLog(
           props.logStore,
-          pipelineStageLog(props.pipeline.id, props.runId, event)
+          pipelineStageLog(event, props.pipeline.id)
         );
         if (log !== void 0) {
           events.push({ type: "pipeline_log", log });
         }
       }
-    }
-  }).then(async (output) => {
+    },
+    failOnObserverError: true
+  }).then(async ({ output }) => {
     const jsonOutput = toJsonValue(output);
     const endedAt = Date.now();
     const successRecord = {
@@ -5290,7 +5482,7 @@ function parsePipelineLogAfter(value) {
 }
 
 // src/runtime/questions.ts
-import { createHook as createHook2 } from "@anvia/core/hooks";
+import { createHook } from "@anvia/core/internal/agent";
 import { parseToolArgs } from "@anvia/core/tool";
 function registerQuestionRoutes(app, questions) {
   app.get("/questions", (c) => {
@@ -5383,7 +5575,7 @@ function createQuestionRuntime() {
   return {
     questions,
     createHook(context) {
-      return createHook2({
+      return createHook({
         async onToolCall({ toolName, toolCallId, internalCallId, args, tool: control }) {
           if (toolName !== "ask_question") {
             return control.run();
@@ -6140,6 +6332,16 @@ function createInMemoryStudioStore() {
 }
 var InMemoryStudioStore = class {
   kind = "memory";
+  compaction = {
+    snapshot: ({ scope }) => {
+      const messages = this.sessions.get(scope.sessionId)?.messages ?? [];
+      return Promise.resolve({
+        revision: memoryRevision(messages),
+        messages: cloneMessages(messages)
+      });
+    },
+    replacePrefix: (options) => this.replaceCompactionPrefix(options)
+  };
   sessions = /* @__PURE__ */ new Map();
   traces = /* @__PURE__ */ new Map();
   pipelineLogs = /* @__PURE__ */ new Map();
@@ -6181,20 +6383,20 @@ var InMemoryStudioStore = class {
     session.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
     return materializeSession(session);
   }
-  load(context) {
-    return Promise.resolve(this.sessions.get(context.sessionId)?.messages ?? []);
+  load({ scope }) {
+    return Promise.resolve(cloneMessages(this.sessions.get(scope.sessionId)?.messages ?? []));
   }
   append(input) {
-    const session = this.sessions.get(input.context.sessionId);
+    const session = this.sessions.get(input.scope.sessionId);
     if (session !== void 0) {
-      session.messages.push(...input.messages);
+      session.messages.push(...cloneMessages(input.messages));
       session.messageCount = session.messages.length;
       session.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
     }
     return Promise.resolve();
   }
-  clear(context) {
-    const session = this.sessions.get(context.sessionId);
+  clear({ scope }) {
+    const session = this.sessions.get(scope.sessionId);
     if (session !== void 0) {
       session.messages = [];
       session.runs = [];
@@ -6205,13 +6407,26 @@ var InMemoryStudioStore = class {
   }
   async recordError(input) {
     await this.saveSessionRunTranscript({
-      id: input.context.sessionId,
-      runId: studioRunId(input.context) ?? input.runId,
+      id: input.scope.sessionId,
+      runId: studioRunId(input.scope) ?? input.runId,
       transcript: transcriptFromMessages(input.messages),
       status: "error",
       error: serializeJsonError(input.error)
     });
   }
+  replaceCompactionPrefix(input) {
+    if (!Number.isSafeInteger(input.messageCount) || input.messageCount < 1) {
+      throw new RangeError("messageCount must be a positive integer.");
+    }
+    const session = this.sessions.get(input.scope.sessionId);
+    if (session === void 0 || memoryRevision(session.messages) !== input.revision || input.messageCount > session.messages.length) {
+      return Promise.resolve({ status: "conflict" });
+    }
+    session.messages.splice(0, input.messageCount, structuredClone(input.replacement));
+    session.messageCount = session.messages.length;
+    session.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+    return Promise.resolve({ status: "committed" });
+  }
   saveSessionRunTranscript(input) {
     const session = this.sessions.get(input.id);
     if (session === void 0) {
@@ -6337,18 +6552,24 @@ function sessionSummary(session) {
 function materializeSession(session) {
   return {
     ...sessionSummary(session),
-    messages: [...session.messages],
+    messages: cloneMessages(session.messages),
     transcript: renumberTranscript(session.runs.flatMap((run) => run.transcript))
   };
 }
+function cloneMessages(messages) {
+  return structuredClone([...messages]);
+}
 function traceAgentId(trace) {
   const nestedMetadata = trace.metadata?.metadata;
   return isJsonObject(nestedMetadata) && typeof nestedMetadata.agentId === "string" ? nestedMetadata.agentId : void 0;
 }
-function studioRunId(context) {
-  const value = context.metadata?.studioRunId;
+function studioRunId(scope) {
+  const value = scope.metadata?.studioRunId;
   return typeof value === "string" && value.length > 0 ? value : void 0;
 }
+function memoryRevision(messages) {
+  return JSON.stringify(messages);
+}
 function serializeJsonError(error) {
   if (error instanceof Error) {
     return {
@@ -6820,7 +7041,7 @@ function waitForShutdown(signal) {
   });
 }
 function studioOptionsFromTargets(targets, options) {
-  const agents = targets.filter((target) => target instanceof Agent2);
+  const agents = targets.filter((target) => target instanceof Agent);
   const pipelines = targets.filter(
     // biome-ignore lint/suspicious/noExplicitAny: Studio accepts heterogeneous user pipelines.
     (target) => target instanceof Pipeline
@@ -6873,13 +7094,13 @@ function uniqueAgentId(baseId, ids) {
 }
 function agentMetadata(agent) {
   const metadata = {
-    staticContextCount: agent.staticContext.length,
-    dynamicContextCount: agent.dynamicContexts.length,
-    dynamicToolCount: agent.dynamicTools.length,
+    staticContextCount: staticContextDocuments(agent).length,
+    dynamicContextCount: vectorContexts(agent).length,
+    dynamicToolCount: getAgentToolState3(agent).toolIndexes.length,
+    hasLifecycle: agent.lifecycle !== void 0,
     hasOutputSchema: agent.outputSchema !== void 0,
-    hasHook: agent.hook !== void 0,
-    observerCount: agent.observers.length,
-    approvalToolCount: agent.toolSet.values().filter((tool) => tool.approval !== void 0).length
+    observerCount: Object.keys(agent.observability?.observers ?? {}).length,
+    approvalToolCount: agent.tools.filter(toolRequiresApproval).length
   };
   if (agent.defaultMaxTurns !== void 0) metadata.defaultMaxTurns = agent.defaultMaxTurns;
   return metadata;
@@ -7009,30 +7230,37 @@ function createStudioApp(options) {
   return studio;
 }
 function withStudioTraceObserver(studioAgent, traceStore) {
-  if (traceStore === void 0 || hasStudioTraceObserver(studioAgent.agent)) {
-    return studioAgent;
+  if (traceStore === void 0) return studioAgent;
+  const existing = studioAgent.agent.observability;
+  const studioObserver = existing?.observers.studio;
+  if (studioObserver !== void 0 && !(studioObserver instanceof StudioTraceObserver)) {
+    throw new TypeError('Studio reserves the observer name "studio" for local trace persistence.');
+  }
+  for (const [name, observer] of Object.entries(existing?.observers ?? {})) {
+    if (observer instanceof StudioTraceObserver && name !== "studio") {
+      throw new TypeError('StudioTraceObserver must be registered with the name "studio".');
+    }
   }
   return {
     ...studioAgent,
     agent: cloneAgent(studioAgent.agent, {
-      observers: [
-        ...studioAgent.agent.observers,
-        { observer: new StudioTraceObserver({ store: traceStore }) }
-      ]
+      observability: {
+        observers: {
+          ...existing?.observers ?? {},
+          studio: studioObserver ?? new StudioTraceObserver({ store: traceStore })
+        },
+        primaryTrace: "studio",
+        errorPolicy: existing?.errorPolicy ?? "ignore"
+      }
     })
   };
 }
-function hasStudioTraceObserver(agent) {
-  return agent.observers.some(
-    (registration) => registration.observer instanceof StudioTraceObserver
-  );
-}
 
 // src/storage/sqlite-store.ts
 import { mkdirSync } from "fs";
 import { createRequire } from "module";
 import { dirname, resolve } from "path";
-import { isJsonValue as isJsonValue2 } from "@anvia/core/completion";
+import { isJsonValue as isJsonValue3 } from "@anvia/core/completion";
 var DatabaseSync;
 function createSqliteSessionStore(options = {}) {
   return new SqliteSessionStore(options.path ?? ":memory:");
@@ -7043,6 +7271,13 @@ var SqliteSessionStore = class {
   }
   path;
   kind = "sqlite";
+  compaction = {
+    snapshot: ({ scope }) => {
+      const messages = this.listSessionMessages(scope.sessionId);
+      return Promise.resolve({ revision: memoryRevision2(messages), messages });
+    },
+    replacePrefix: (options) => this.replaceCompactionPrefix(options)
+  };
   db;
   listSessions(options) {
     const db = this.database();
@@ -7114,8 +7349,8 @@ var SqliteSessionStore = class {
     }
     return this.getSession(id);
   }
-  load(context) {
-    const session = this.getSession(context.sessionId);
+  load({ scope }) {
+    const session = this.getSession(scope.sessionId);
     return Promise.resolve(session?.messages ?? []);
   }
   append(input) {
@@ -7126,20 +7361,20 @@ var SqliteSessionStore = class {
         `SELECT id, agent_id, title, metadata_json, created_at, updated_at
            FROM anvia_studio_sessions
            WHERE id = $id`
-      ).get({ $id: input.context.sessionId });
+      ).get({ $id: input.scope.sessionId });
       if (row === void 0) {
         db.exec("ROLLBACK");
         return Promise.resolve();
       }
       const updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-      const nextIndex = this.nextMessageIndex(input.context.sessionId);
-      this.insertMessages(input.context.sessionId, input.messages, nextIndex, updatedAt);
+      const nextIndex = this.nextMessageIndex(input.scope.sessionId);
+      this.insertMessages(input.scope.sessionId, input.messages, nextIndex, updatedAt);
       db.prepare(
         `UPDATE anvia_studio_sessions
          SET updated_at = $updatedAt
          WHERE id = $id`
       ).run({
-        $id: input.context.sessionId,
+        $id: input.scope.sessionId,
         $updatedAt: updatedAt
       });
       db.exec("COMMIT");
@@ -7151,7 +7386,7 @@ var SqliteSessionStore = class {
       throw error;
     }
   }
-  clear(context) {
+  clear({ scope }) {
     const db = this.database();
     const updatedAt = (/* @__PURE__ */ new Date()).toISOString();
     try {
@@ -7161,14 +7396,14 @@ var SqliteSessionStore = class {
          SET updated_at = $updatedAt
          WHERE id = $id`
       ).run({
-        $id: context.sessionId,
+        $id: scope.sessionId,
         $updatedAt: updatedAt
       });
       db.prepare("DELETE FROM anvia_studio_session_messages WHERE session_id = $id").run({
-        $id: context.sessionId
+        $id: scope.sessionId
       });
       db.prepare("DELETE FROM anvia_studio_session_runs WHERE session_id = $id").run({
-        $id: context.sessionId
+        $id: scope.sessionId
       });
       db.exec("COMMIT");
       return Promise.resolve();
@@ -7180,17 +7415,51 @@ var SqliteSessionStore = class {
     }
   }
   async recordError(input) {
-    const runId = studioRunId2(input.context) ?? input.runId;
-    const existing = this.getSessionRun(input.context.sessionId, runId);
+    const runId = studioRunId2(input.scope) ?? input.runId;
+    const existing = this.getSessionRun(input.scope.sessionId, runId);
     const transcript = existing === void 0 || parseJsonArray(existing.transcript_json).length === 0 ? transcriptFromMessages(input.messages) : parseJsonArray(existing.transcript_json);
     await this.saveSessionRunTranscript({
-      id: input.context.sessionId,
+      id: input.scope.sessionId,
       runId,
       transcript,
       status: "error",
       error: serializeJsonError2(input.error)
     });
   }
+  replaceCompactionPrefix(input) {
+    if (!Number.isSafeInteger(input.messageCount) || input.messageCount < 1) {
+      throw new RangeError("messageCount must be a positive integer.");
+    }
+    const db = this.database();
+    try {
+      db.exec("BEGIN IMMEDIATE");
+      const messages = this.listSessionMessages(input.scope.sessionId);
+      if (memoryRevision2(messages) !== input.revision || input.messageCount > messages.length || this.getSessionRow(input.scope.sessionId) === void 0) {
+        db.exec("ROLLBACK");
+        return Promise.resolve({ status: "conflict" });
+      }
+      db.prepare("DELETE FROM anvia_studio_session_messages WHERE session_id = $id").run({
+        $id: input.scope.sessionId
+      });
+      const updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+      this.insertMessages(
+        input.scope.sessionId,
+        [input.replacement, ...messages.slice(input.messageCount)],
+        0,
+        updatedAt
+      );
+      db.prepare(
+        `UPDATE anvia_studio_sessions
+         SET updated_at = $updatedAt
+         WHERE id = $id`
+      ).run({ $id: input.scope.sessionId, $updatedAt: updatedAt });
+      db.exec("COMMIT");
+      return Promise.resolve({ status: "committed" });
+    } catch (error) {
+      if (db.isTransaction) db.exec("ROLLBACK");
+      throw error;
+    }
+  }
   saveSessionRunTranscript(input) {
     const db = this.database();
     const now = (/* @__PURE__ */ new Date()).toISOString();
@@ -7886,7 +8155,7 @@ var SqliteSessionStore = class {
     );
     messages.forEach((message, messageOffset) => {
       const messageIndex = startIndex + messageOffset;
-      if (message.metadata !== void 0 && !isJsonValue2(message.metadata)) {
+      if (message.metadata !== void 0 && !isJsonValue3(message.metadata)) {
         throw new TypeError("Studio message metadata must be a strict JSON value.");
       }
       insertMessage.run({
@@ -7987,6 +8256,9 @@ function messageParts(message) {
   if (message.role === "system") {
     return [{ type: "text", value: { type: "text", text: message.content } }];
   }
+  if (typeof message.content === "string") {
+    return [{ type: "text", value: { type: "text", text: message.content } }];
+  }
   return message.content.map((content) => ({
     type: content.type,
     value: content
@@ -7995,40 +8267,40 @@ function messageParts(message) {
 function messageFromRows(row, partRows) {
   const parts = partRows.map((partRow) => JSON.parse(partRow.part_json));
   const metadata = parseJsonValue(row.metadata_json);
-  if (metadata !== void 0 && !isJsonValue2(metadata)) {
-    throw new TypeError("Stored Studio message metadata is not a strict JSON value.");
+  if (metadata !== void 0 && (!isJsonValue3(metadata) || typeof metadata !== "object" || metadata === null || Array.isArray(metadata))) {
+    throw new TypeError("Stored Studio message metadata is not a strict JSON object.");
   }
   if (row.role === "system") {
     const message = {
       role: "system",
-      content: systemContentFromParts(parts)
+      content: systemContentFromParts(parts),
+      ...metadata === void 0 ? {} : { metadata }
     };
-    if (metadata !== void 0) message.metadata = metadata;
     return message;
   }
   if (row.role === "user") {
     const message = {
       role: "user",
-      content: parts
+      content: parts,
+      ...metadata === void 0 ? {} : { metadata }
     };
-    if (metadata !== void 0) message.metadata = metadata;
     return message;
   }
   if (row.role === "assistant") {
     const message = {
       role: "assistant",
-      content: parts
+      content: parts,
+      ...row.message_id === null ? {} : { id: row.message_id },
+      ...metadata === void 0 ? {} : { metadata }
     };
-    if (row.message_id !== null) message.id = row.message_id;
-    if (metadata !== void 0) message.metadata = metadata;
     return message;
   }
   if (row.role === "tool") {
     const message = {
       role: "tool",
-      content: parts
+      content: parts,
+      ...metadata === void 0 ? {} : { metadata }
     };
-    if (metadata !== void 0) message.metadata = metadata;
     return message;
   }
   throw new Error(`Unsupported stored message role: ${row.role}`);
@@ -8100,6 +8372,7 @@ function toTraceSummary(row) {
   if (error !== void 0) summary.error = error;
   if (usage !== void 0) summary.usage = usage;
   if (metadata !== void 0) summary.metadata = metadata;
+  if (typeof metadata?.runId === "string") summary.runId = metadata.runId;
   return summary;
 }
 function parseJsonArray(value) {
@@ -8112,10 +8385,13 @@ function parseJsonValue(value) {
   }
   return JSON.parse(value);
 }
-function studioRunId2(context) {
-  const value = context.metadata?.studioRunId;
+function studioRunId2(scope) {
+  const value = scope.metadata?.studioRunId;
   return typeof value === "string" && value.length > 0 ? value : void 0;
 }
+function memoryRevision2(messages) {
+  return JSON.stringify(messages);
+}
 function serializeJsonError2(error) {
   if (error instanceof Error) {
     return {