@anvia/studio 0.2.1 → 0.2.3

package/README.md

@@ -1,8 +1,8 @@
 # @anvia/studio
 
-Studio UI and HTTP runtime for Anvia agents.
+Studio UI and HTTP runtime for Anvia agents, pipelines, tools, MCPs, and knowledge inspection.
 
-Use this package to serve local agents over HTTP, inspect sessions and traces in the browser UI, and exercise tool approval workflows during development.
+Use this package to serve local agents and pipelines over HTTP, inspect sessions, traces, tools, MCPs, and Knowledge in the browser UI, and exercise tool approval workflows during development.
 
 ## Installation
 
@@ -44,9 +44,19 @@ Then open:
 http://localhost:4021/playground
 ```
 
+## Browser UI
+
+Studio exposes:
+
+- Chat playground and persisted sessions
+- Trace browser and session logs
+- Pipeline graph, logs, and run history
+- Agent, static tool, dynamic tool, and MCP inspectors
+- Knowledge tabs for static context, dynamic context, dynamic tools, and retrieval log
+
 ## Session Storage
 
-Studio uses a local SQLite store by default so sessions and traces can persist across process restarts. If you omit the port, Studio uses `RUNNER_PORT` and then falls back to `4021`.
+Studio uses a local SQLite store by default so sessions, traces, and pipeline run history can persist across process restarts. If you omit the port, Studio uses `RUNNER_PORT` and then falls back to `4021`.
 
 Set `ANVIA_STUDIO_DB` to control the database path:
 
@@ -58,7 +68,7 @@ ANVIA_STUDIO_DB=.anvia/studio.sqlite node ./dist/server.js
 
 - `Studio`
 - `createSqliteSessionStore`
-- Studio session, trace, approval, and runtime types
+- Studio session, trace, approval, pipeline, knowledge, tool, MCP, and runtime types
 
 ## Development
 

package/dist/index.d.ts

@@ -260,8 +260,15 @@ type StudioTraceStore = {
 };
 type StudioKnowledgeSourceKind = "static_context" | "dynamic_context" | "dynamic_tools";
 type StudioKnowledgeSourceSummary = {
+    sourceId?: string;
     kind: StudioKnowledgeSourceKind;
+    label?: string;
     count: number;
+    registrationIndex?: number;
+    topK?: number;
+    threshold?: number;
+    inspectable?: boolean;
+    itemCount?: number;
 };
 type StudioStaticKnowledgeDocument = {
     id: string;
@@ -292,6 +299,27 @@ type StudioAgentKnowledgeConfig = {
     sources: StudioKnowledgeSourceSummary[];
     staticContext: StudioStaticKnowledgeDocument[];
 };
+type StudioKnowledgeItemKind = "static_context" | "dynamic_context" | "dynamic_tool";
+type StudioKnowledgeItem = {
+    id: string;
+    kind: StudioKnowledgeItemKind;
+    text?: string;
+    document?: JsonValue;
+    toolName?: string;
+    description?: string;
+    parameterKeys?: string[];
+    metadata?: JsonObject;
+};
+type StudioKnowledgeItemsPage = {
+    agentId: string;
+    sourceId: string;
+    kind: StudioKnowledgeSourceKind;
+    inspectable: boolean;
+    items: StudioKnowledgeItem[];
+    nextCursor?: string;
+    totalCount?: number;
+    message?: string;
+};
 type StudioKnowledgeSummary = {
     agents: StudioAgentKnowledgeConfig[];
     evidence: StudioKnowledgeEvidence[];
@@ -544,4 +572,4 @@ type SqliteSessionStoreOptions = {
 };
 declare function createSqliteSessionStore(options?: SqliteSessionStoreOptions): StudioSessionStore & StudioTraceStore & StudioPipelineLogStore & StudioPipelineRunStore;
 
-export { type AgentRunRequest, type AgentRunResponse, type AgentRunStreamEvent, type AnviaStudio, type SqliteSessionStoreOptions, Studio, type StudioAgent, type StudioAgentConfig, type StudioAgentKnowledgeConfig, type StudioAgentMcpServerMetadata, type StudioAgentMcpToolMetadata, type StudioAgentMcpsSummary, type StudioAgentToolApprovalMetadata, type StudioAgentToolMetadata, type StudioAgentToolSource, type StudioAgentToolsSummary, type StudioCapability, type StudioCapabilityConfig, type StudioConfig, type StudioErrorCode, type StudioErrorResponse, type StudioKnowledgeEvidence, type StudioKnowledgeEvidenceDocument, type StudioKnowledgeSourceKind, type StudioKnowledgeSourceSummary, type StudioKnowledgeSummary, type StudioOptions, type StudioPipeline, type StudioPipelineConfig, type StudioPipelineDetail, type StudioPipelineFinalEvent, type StudioPipelineLogAppendInput, type StudioPipelineLogCategory, type StudioPipelineLogEntry, type StudioPipelineLogEvent, type StudioPipelineLogLevel, type StudioPipelineLogListOptions, type StudioPipelineLogStore, type StudioPipelineRunListOptions, type StudioPipelineRunRecord, type StudioPipelineRunRequest, type StudioPipelineRunResponse, type StudioPipelineRunSaveInput, type StudioPipelineRunStatus, type StudioPipelineRunStore, type StudioServeOptions, type StudioSession, type StudioSessionCreateInput, type StudioSessionListOptions, type StudioSessionLogAppendInput, type StudioSessionLogCategory, type StudioSessionLogEntry, type StudioSessionLogEvent, type StudioSessionLogLevel, type StudioSessionLogListOptions, type StudioSessionRunStatus, type StudioSessionRunTranscriptInput, type StudioSessionStore, type StudioSessionSummary, type StudioSessionTraceListOptions, type StudioStaticKnowledgeDocument, type StudioStores, type StudioTarget, type StudioToolApproval, type StudioToolApprovalDecision, type StudioToolApprovalRequestEvent, type StudioToolApprovalResultEvent, type StudioToolApprovalStatus, type StudioToolApprovalTranscript, type StudioToolQuestion, type StudioToolQuestionAnswer, type StudioToolQuestionChoice, type StudioToolQuestionPrompt, type StudioToolQuestionRequestEvent, type StudioToolQuestionResultEvent, type StudioToolQuestionStatus, type StudioToolQuestionTranscript, type StudioTrace, type StudioTraceListOptions, type StudioTraceObservation, type StudioTraceObservationKind, StudioTraceObserver, type StudioTraceObserverOptions, type StudioTraceStatus, type StudioTraceStore, type StudioTraceSummary, type StudioTranscriptChatEntry, type StudioTranscriptChildAgentEvent, type StudioTranscriptEntry, type StudioTranscriptReasoningEntry, type StudioTranscriptToolEntry, type StudioUiOptions, createSqliteSessionStore };
+export { type AgentRunRequest, type AgentRunResponse, type AgentRunStreamEvent, type AnviaStudio, type SqliteSessionStoreOptions, Studio, type StudioAgent, type StudioAgentConfig, type StudioAgentKnowledgeConfig, type StudioAgentMcpServerMetadata, type StudioAgentMcpToolMetadata, type StudioAgentMcpsSummary, type StudioAgentToolApprovalMetadata, type StudioAgentToolMetadata, type StudioAgentToolSource, type StudioAgentToolsSummary, type StudioCapability, type StudioCapabilityConfig, type StudioConfig, type StudioErrorCode, type StudioErrorResponse, type StudioKnowledgeEvidence, type StudioKnowledgeEvidenceDocument, type StudioKnowledgeItem, type StudioKnowledgeItemKind, type StudioKnowledgeItemsPage, type StudioKnowledgeSourceKind, type StudioKnowledgeSourceSummary, type StudioKnowledgeSummary, type StudioOptions, type StudioPipeline, type StudioPipelineConfig, type StudioPipelineDetail, type StudioPipelineFinalEvent, type StudioPipelineLogAppendInput, type StudioPipelineLogCategory, type StudioPipelineLogEntry, type StudioPipelineLogEvent, type StudioPipelineLogLevel, type StudioPipelineLogListOptions, type StudioPipelineLogStore, type StudioPipelineRunListOptions, type StudioPipelineRunRecord, type StudioPipelineRunRequest, type StudioPipelineRunResponse, type StudioPipelineRunSaveInput, type StudioPipelineRunStatus, type StudioPipelineRunStore, type StudioServeOptions, type StudioSession, type StudioSessionCreateInput, type StudioSessionListOptions, type StudioSessionLogAppendInput, type StudioSessionLogCategory, type StudioSessionLogEntry, type StudioSessionLogEvent, type StudioSessionLogLevel, type StudioSessionLogListOptions, type StudioSessionRunStatus, type StudioSessionRunTranscriptInput, type StudioSessionStore, type StudioSessionSummary, type StudioSessionTraceListOptions, type StudioStaticKnowledgeDocument, type StudioStores, type StudioTarget, type StudioToolApproval, type StudioToolApprovalDecision, type StudioToolApprovalRequestEvent, type StudioToolApprovalResultEvent, type StudioToolApprovalStatus, type StudioToolApprovalTranscript, type StudioToolQuestion, type StudioToolQuestionAnswer, type StudioToolQuestionChoice, type StudioToolQuestionPrompt, type StudioToolQuestionRequestEvent, type StudioToolQuestionResultEvent, type StudioToolQuestionStatus, type StudioToolQuestionTranscript, type StudioTrace, type StudioTraceListOptions, type StudioTraceObservation, type StudioTraceObservationKind, StudioTraceObserver, type StudioTraceObserverOptions, type StudioTraceStatus, type StudioTraceStore, type StudioTraceSummary, type StudioTranscriptChatEntry, type StudioTranscriptChildAgentEvent, type StudioTranscriptEntry, type StudioTranscriptReasoningEntry, type StudioTranscriptToolEntry, type StudioUiOptions, createSqliteSessionStore };

package/dist/index.js

@@ -51,11 +51,7 @@ var StudioRunTraceObserver = class {
             startedAt,
             input: toJsonValue(args.request),
             output: toJsonValue(endArgs.response),
-            metadata: {
-              model: args.request.model ?? "default",
-              toolCount: args.request.tools.length,
-              ...endArgs.firstDeltaMs === void 0 ? {} : { firstDeltaMs: endArgs.firstDeltaMs }
-            }
+            metadata: generationMetadata(args, endArgs)
           })
         );
       },
@@ -69,10 +65,7 @@ var StudioRunTraceObserver = class {
             startedAt,
             input: toJsonValue(args.request),
             error: serializeError(errorArgs.error),
-            metadata: {
-              model: args.request.model ?? "default",
-              toolCount: args.request.tools.length
-            }
+            metadata: generationMetadata(args)
           })
         );
       }
@@ -94,7 +87,7 @@ var StudioRunTraceObserver = class {
           startedAt,
           input: parseOrString(args.args),
           output: parseOrString(endArgs.result),
-          metadata: toolMetadata(args, endArgs.skipped)
+          metadata: toolMetadata(args, endArgs.skipped, endArgs.result)
         });
         this.observations.push(parentObservation);
         this.observations.push(...childTrace.observations(parentObservation.id));
@@ -372,13 +365,134 @@ function traceMetadata(args, messages) {
     messages
   });
 }
-function toolMetadata(args, skipped) {
+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 providerResponse = providerResponseSummary(rawResponse);
+  const usage = response?.usage;
+  return compactJsonObject({
+    provider: args.modelInfo?.provider,
+    model: effectiveModel,
+    requestedModel: request.model,
+    defaultModel: args.modelInfo?.defaultModel,
+    messageId: response?.messageId,
+    usage,
+    toolCount: request.tools.length,
+    toolNames: request.tools.map((tool) => tool.name),
+    documentCount: request.documents.length,
+    historyCount: request.chatHistory.length,
+    temperature: request.temperature,
+    maxTokens: request.maxTokens,
+    toolChoice: request.toolChoice,
+    additionalParamKeys: isRecord(request.additionalParams) ? Object.keys(request.additionalParams).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,
+      capabilities: args.modelInfo?.capabilities
+    }),
+    modelCall: compactJsonObject({
+      request: completionRequestSummary(request),
+      providerRequest: args.providerRequest
+    }),
+    response: compactJsonObject({
+      messageId: response?.messageId,
+      usage,
+      contentTypes: response?.choice.map((item) => item.type),
+      providerResponse
+    }),
+    tools: compactJsonObject({
+      count: request.tools.length,
+      names: request.tools.map((tool) => tool.name),
+      toolChoice: request.toolChoice,
+      hasOutputSchema: request.outputSchema !== void 0
+    }),
+    timing: compactJsonObject({
+      firstDeltaMs: endArgs?.firstDeltaMs
+    })
+  });
+}
+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,
+    documentIds: request.documents.map((document) => document.id),
+    toolCount: request.tools.length,
+    toolNames: request.tools.map((tool) => tool.name),
+    temperature: request.temperature,
+    maxTokens: request.maxTokens,
+    toolChoice: request.toolChoice,
+    additionalParamKeys: isRecord(request.additionalParams) ? Object.keys(request.additionalParams).sort() : void 0,
+    hasOutputSchema: request.outputSchema !== void 0
+  });
+}
+function providerResponseSummary(rawResponse) {
+  if (rawResponse === void 0) {
+    return void 0;
+  }
+  const reasoning = isRecord(rawResponse.reasoning) ? rawResponse.reasoning : void 0;
+  const text = isRecord(rawResponse.text) ? rawResponse.text : void 0;
+  const toolUsage = isRecord(rawResponse.tool_usage) ? rawResponse.tool_usage : void 0;
+  const webSearch = isRecord(toolUsage?.web_search) ? toolUsage.web_search : void 0;
+  const summary = compactJsonObject({
+    id: rawResponse.id,
+    status: rawResponse.status,
+    serviceTier: rawResponse.service_tier,
+    store: rawResponse.store,
+    parallelToolCalls: rawResponse.parallel_tool_calls,
+    promptCacheKey: rawResponse.prompt_cache_key,
+    promptCacheRetention: rawResponse.prompt_cache_retention,
+    reasoningEffort: reasoning?.effort,
+    textVerbosity: text?.verbosity,
+    webSearchRequestCount: webSearch?.num_requests
+  });
+  return Object.keys(summary).length === 0 ? void 0 : summary;
+}
+function toolMetadata(args, skipped, result) {
+  const schema = isRecord(args.toolDefinition?.parameters) ? args.toolDefinition.parameters : {};
+  const properties = isRecord(schema.properties) ? schema.properties : {};
+  const required = Array.isArray(schema.required) ? schema.required.filter((item) => typeof item === "string") : [];
   return compactJsonObject({
     internalCallId: args.internalCallId,
     toolCallId: args.toolCallId,
-    skipped
+    skipped,
+    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,
+    approvalRequired: args.toolMetadata?.approvalRequired,
+    mcpServerName: args.toolMetadata?.mcpServerName,
+    tools: compactJsonObject({
+      name: args.toolName,
+      internalCallId: args.internalCallId,
+      toolCallId: args.toolCallId,
+      skipped,
+      description: args.toolDefinition?.description,
+      parameterKeys: Object.keys(properties).sort(),
+      requiredParameterKeys: required,
+      approvalRequired: args.toolMetadata?.approvalRequired,
+      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
+    })
   });
 }
+function byteLength(value) {
+  return new TextEncoder().encode(value).length;
+}
 function compactJsonObject(values) {
   const entries = Object.entries(values).flatMap(
     ([key, value]) => value === void 0 ? [] : [[key, toJsonValue(value)]]
@@ -473,6 +587,8 @@ function registerStudioUi(app, options) {
   app.get(`${options.path}/sessions`, async (c) => c.html(await renderShell()));
   app.get(`${options.path}/agents`, async (c) => c.html(await renderShell()));
   app.get(`${options.path}/knowledge`, async (c) => c.html(await renderShell()));
+  app.get(`${options.path}/knowledge/:tab`, async (c) => c.html(await renderShell()));
+  app.get(`${options.path}/knowledge/*`, async (c) => c.html(await renderShell()));
   if (options.rootRoutes) {
     app.get("/playground", async (c) => c.html(await renderRootShell()));
     app.get("/playground/:sessionId", async (c) => c.html(await renderRootShell()));
@@ -2382,22 +2498,41 @@ function registerKnowledgeRoutes(app, props) {
       return errorResponse(c, 400, "bad_request", "Invalid limit");
     }
     const summary = {
-      agents: props.agents.map(agentKnowledgeConfig),
+      agents: await Promise.all(props.agents.map(agentKnowledgeConfig)),
       evidence: await recentKnowledgeEvidence(props.traceStore, limit)
     };
     return c.json(summary);
   });
+  app.get("/knowledge/items", async (c) => {
+    const limit = parseLimit(c.req.query("limit"));
+    if (limit === void 0) {
+      return errorResponse(c, 400, "bad_request", "Invalid limit");
+    }
+    const agentId = optionalQueryString(c.req.query("agentId"));
+    const sourceId = optionalQueryString(c.req.query("sourceId"));
+    if (agentId === void 0 || sourceId === void 0) {
+      return errorResponse(c, 400, "bad_request", "agentId and sourceId are required");
+    }
+    const agent = props.agents.find((item) => item.id === agentId);
+    if (agent === void 0) {
+      return errorResponse(c, 404, "not_found", "Agent not found");
+    }
+    const page = await knowledgeItemsPage(agent, sourceId, {
+      limit,
+      cursor: optionalQueryString(c.req.query("cursor"))
+    });
+    if (page === void 0) {
+      return errorResponse(c, 404, "not_found", "Knowledge source not found");
+    }
+    return c.json(page);
+  });
 }
-function agentKnowledgeConfig(agent) {
+async function agentKnowledgeConfig(agent) {
   const agentName = agent.name ?? agent.agent.name;
   return {
     agentId: agent.id,
     ...agentName === void 0 ? {} : { agentName },
-    sources: [
-      { kind: "static_context", count: agent.agent.staticContext.length },
-      { kind: "dynamic_context", count: agent.agent.dynamicContexts.length },
-      { kind: "dynamic_tools", count: agent.agent.dynamicTools.length }
-    ],
+    sources: await knowledgeSources(agent),
     staticContext: agent.agent.staticContext.map((document) => ({
       id: document.id,
       text: document.text,
@@ -2405,6 +2540,199 @@ function agentKnowledgeConfig(agent) {
     }))
   };
 }
+async function knowledgeSources(agent) {
+  const sources = [
+    {
+      sourceId: staticSourceId(),
+      kind: "static_context",
+      label: "Static context",
+      count: agent.agent.staticContext.length,
+      inspectable: true,
+      itemCount: agent.agent.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);
+      return {
+        sourceId: dynamicContextSourceId(index),
+        kind: "dynamic_context",
+        label: `Dynamic context ${index + 1}`,
+        count: 1,
+        registrationIndex: index,
+        topK: registration.options.topK,
+        ...registration.options.threshold === void 0 ? {} : { threshold: registration.options.threshold },
+        inspectable: inspect !== void 0,
+        ...count === void 0 ? {} : { itemCount: count }
+      };
+    })
+  );
+  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);
+      return {
+        sourceId: dynamicToolsSourceId(index),
+        kind: "dynamic_tools",
+        label: `Dynamic tools ${index + 1}`,
+        count: 1,
+        registrationIndex: index,
+        topK: registration.options.topK,
+        ...registration.options.threshold === void 0 ? {} : { threshold: registration.options.threshold },
+        inspectable: inspect !== void 0,
+        ...count === void 0 ? {} : { itemCount: count }
+      };
+    })
+  );
+  return [...sources, ...dynamicContextSources, ...dynamicToolSources];
+}
+async function inspectableCount(inspect, filter) {
+  if (inspect === void 0) {
+    return void 0;
+  }
+  const page = await inspect({ limit: 1, filter });
+  return page.totalCount;
+}
+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) {
+      return void 0;
+    }
+    const inspect = inspectFn(registration.index);
+    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
+    });
+    return {
+      agentId: agent.id,
+      sourceId,
+      kind: "dynamic_context",
+      inspectable: true,
+      items: page.items.map((item) => dynamicContextItem(item)),
+      ...page.nextCursor === void 0 ? {} : { nextCursor: page.nextCursor },
+      ...page.totalCount === void 0 ? {} : { totalCount: page.totalCount }
+    };
+  }
+  const dynamicToolsIndex = dynamicSourceIndex(sourceId, "dynamic_tools");
+  if (dynamicToolsIndex !== void 0) {
+    const registration = agent.agent.dynamicTools[dynamicToolsIndex];
+    if (registration === void 0) {
+      return void 0;
+    }
+    const inspect = inspectFn(registration.index);
+    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
+    });
+    return {
+      agentId: agent.id,
+      sourceId,
+      kind: "dynamic_tools",
+      inspectable: true,
+      items: page.items.map((item) => dynamicToolItem(item)),
+      ...page.nextCursor === void 0 ? {} : { nextCursor: page.nextCursor },
+      ...page.totalCount === void 0 ? {} : { totalCount: page.totalCount }
+    };
+  }
+  return void 0;
+}
+function inspectFn(index) {
+  if (!isRecord2(index) || typeof index.inspect !== "function") {
+    return void 0;
+  }
+  const inspect = index.inspect;
+  return (request) => inspect.call(index, request);
+}
+function staticKnowledgeItemsPage(agent, request) {
+  const start = Math.max(0, Math.trunc(Number(request.cursor ?? "0")));
+  const page = agent.agent.staticContext.slice(start, start + request.limit);
+  const nextOffset = start + page.length;
+  return {
+    agentId: agent.id,
+    sourceId: staticSourceId(),
+    kind: "static_context",
+    inspectable: true,
+    items: page.map((document) => ({
+      id: document.id,
+      kind: "static_context",
+      text: document.text,
+      ...document.additionalProps === void 0 ? {} : { metadata: jsonObjectFromRecord(document.additionalProps) }
+    })),
+    ...nextOffset < agent.agent.staticContext.length ? { nextCursor: String(nextOffset) } : {},
+    totalCount: agent.agent.staticContext.length
+  };
+}
+function nonInspectablePage(agentId, sourceId, kind) {
+  return {
+    agentId,
+    sourceId,
+    kind,
+    inspectable: false,
+    items: [],
+    message: "This source can be searched at runtime, but it does not expose browseable chunks."
+  };
+}
+function dynamicContextItem(item) {
+  const text = isRecord2(item.document) && typeof item.document.text === "string" ? item.document.text : typeof item.document === "string" ? item.document : void 0;
+  return {
+    id: item.id,
+    kind: "dynamic_context",
+    ...text === void 0 ? { document: toJsonValue2(item.document) } : { text },
+    ...item.metadata === void 0 ? {} : { metadata: jsonObjectFromRecord(item.metadata) }
+  };
+}
+function dynamicToolItem(item) {
+  const document = isRecord2(item.document) ? item.document : {};
+  const definition = isRecord2(document.definition) ? document.definition : {};
+  const toolName = typeof document.toolName === "string" ? document.toolName : typeof definition.name === "string" ? definition.name : item.id;
+  const description = typeof definition.description === "string" ? definition.description : "";
+  return {
+    id: item.id,
+    kind: "dynamic_tool",
+    toolName,
+    description,
+    parameterKeys: parameterKeys(definition.parameters),
+    document: toJsonValue2(item.document),
+    ...item.metadata === void 0 ? {} : { metadata: jsonObjectFromRecord(item.metadata) }
+  };
+}
+function parameterKeys(parameters) {
+  if (!isRecord2(parameters) || !isRecord2(parameters.properties)) {
+    return [];
+  }
+  return Object.keys(parameters.properties);
+}
+function staticSourceId() {
+  return "static-context";
+}
+function dynamicContextSourceId(index) {
+  return `dynamic-context-${index}`;
+}
+function dynamicToolsSourceId(index) {
+  return `dynamic-tools-${index}`;
+}
+function dynamicSourceIndex(sourceId, kind) {
+  const prefix = kind === "dynamic_context" ? "dynamic-context-" : "dynamic-tools-";
+  if (!sourceId.startsWith(prefix)) {
+    return void 0;
+  }
+  const index = Number(sourceId.slice(prefix.length));
+  return Number.isInteger(index) && index >= 0 ? index : void 0;
+}
 async function recentKnowledgeEvidence(traceStore, limit) {
   if (traceStore?.listTraces === void 0) {
     return [];
@@ -2610,7 +2938,7 @@ function pipelineRunReceivedLog(props) {
     message: "Pipeline run request received",
     metadata: cleanMetadata({
       stream: props.stream,
-      inputBytes: byteLength(formatUnknown(props.input)),
+      inputBytes: byteLength2(formatUnknown(props.input)),
       metadataKeys: Object.keys(props.metadata ?? {})
     })
   };
@@ -2640,7 +2968,7 @@ function pipelineRunCompletedLog(props) {
     message: "Pipeline run completed",
     metadata: cleanMetadata({
       durationMs: props.durationMs,
-      outputBytes: byteLength(formatUnknown(props.output))
+      outputBytes: byteLength2(formatUnknown(props.output))
     })
   };
 }
@@ -2726,7 +3054,7 @@ function cleanMetadata(value) {
     Object.entries(value).filter(([, item]) => item !== void 0)
   );
 }
-function byteLength(value) {
+function byteLength2(value) {
   return value === void 0 ? void 0 : new TextEncoder().encode(value).length;
 }
 function formatUnknown(value) {
@@ -4019,7 +4347,7 @@ function runCompletedLog(props) {
     metadata: cleanMetadata2({
       durationMs: props.durationMs,
       usage: usageSummary(props.usage),
-      outputBytes: byteLength2(props.output),
+      outputBytes: byteLength3(props.output),
       messageCount: props.messageCount
     })
   };
@@ -4083,7 +4411,7 @@ function logsFromStreamEvent(props) {
           turn: event.turn,
           toolName: event.toolCall.function.name,
           callId: event.toolCall.callId ?? event.toolCall.id,
-          argumentBytes: byteLength2(formatUnknown2(event.toolCall.function.arguments))
+          argumentBytes: byteLength3(formatUnknown2(event.toolCall.function.arguments))
         })
       }
     ];
@@ -4102,8 +4430,8 @@ function logsFromStreamEvent(props) {
           toolName: event.toolName,
           callId: event.toolCallId,
           internalCallId: event.internalCallId,
-          argumentBytes: byteLength2(event.args),
-          resultBytes: byteLength2(event.result)
+          argumentBytes: byteLength3(event.args),
+          resultBytes: byteLength3(event.result)
         })
       }
     ];
@@ -4156,7 +4484,7 @@ function logsFromStreamEvent(props) {
           callId: event.approval.callId,
           status: event.approval.status,
           hasReason: event.approval.reason !== void 0,
-          argumentBytes: byteLength2(event.approval.args)
+          argumentBytes: byteLength3(event.approval.args)
         })
       }
     ];
@@ -4195,7 +4523,7 @@ function logsFromStreamEvent(props) {
           callId: event.question.callId,
           status: event.question.status,
           questionCount: event.question.questions.length,
-          argumentBytes: byteLength2(event.question.args)
+          argumentBytes: byteLength3(event.question.args)
         })
       }
     ];
@@ -4249,7 +4577,7 @@ function childAgentLog(event, sessionId, runId) {
           childTurn: child.turn,
           toolName: child.toolCall.function.name,
           callId: child.toolCall.callId ?? child.toolCall.id,
-          argumentBytes: byteLength2(formatUnknown2(child.toolCall.function.arguments))
+          argumentBytes: byteLength3(formatUnknown2(child.toolCall.function.arguments))
         })
       }
     ];
@@ -4271,7 +4599,7 @@ function childAgentLog(event, sessionId, runId) {
           childTurn: child.turn,
           toolName: child.toolName,
           callId: child.toolCallId,
-          resultBytes: byteLength2(child.result)
+          resultBytes: byteLength3(child.result)
         })
       }
     ];
@@ -4309,7 +4637,7 @@ function childAgentLog(event, sessionId, runId) {
           agentId: event.agentId,
           hasAgentName: event.agentName !== void 0,
           usage: usageSummary(child.usage),
-          outputBytes: byteLength2(child.output),
+          outputBytes: byteLength3(child.output),
           messageCount: child.messages.length
         })
       }
@@ -4340,14 +4668,14 @@ function messageSummary(message) {
     return {
       role: "user",
       contentKind: "text",
-      byteLength: byteLength2(message)
+      byteLength: byteLength3(message)
     };
   }
   return {
     role: message.role,
     contentKind: Array.isArray(message.content) ? "parts" : "text",
     partCount: Array.isArray(message.content) ? message.content.length : 1,
-    byteLength: byteLength2(formatUnknown2(message.content))
+    byteLength: byteLength3(formatUnknown2(message.content))
   };
 }
 function usageSummary(value) {
@@ -4391,7 +4719,7 @@ function cleanJsonValue(value) {
 function numericValue(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : void 0;
 }
-function byteLength2(value) {
+function byteLength3(value) {
   return value === void 0 ? 0 : new TextEncoder().encode(value).byteLength;
 }
 function formatUnknown2(value) {