@anvia/studio 0.8.1 → 1.0.0-rc.10

package/README.md

@@ -19,7 +19,7 @@ pnpm --filter @anvia/studio build
 ## Usage
 
 ```ts
-import { AgentBuilder } from "@anvia/core";
+import { Agent } from "@anvia/core";
 import { OpenAIClient } from "@anvia/openai";
 import { Studio } from "@anvia/studio";
 
@@ -27,11 +27,13 @@ const client = new OpenAIClient({
   apiKey,
 });
 
-const agent = new AgentBuilder("support", client.completionModel())
-  .name("Support")
-  .description("Answers support questions.")
-  .instructions("Answer support questions clearly.")
-  .build();
+const agent = new Agent({
+  id: "support",
+  model: client.completionModel({ modelId: "gpt-5", api: "responses" }),
+  name: "Support",
+  description: "Answers support questions.",
+  instructions: "Answer support questions clearly.",
+});
 
 new Studio([agent]).start({
   port: 4021,
@@ -49,7 +51,7 @@ http://localhost:4021/ui/playground
 Studio can expose a shared model catalog and let each agent choose from registered providers:
 
 ```ts
-import { AgentBuilder } from "@anvia/core";
+import { Agent } from "@anvia/core";
 import { AnthropicClient } from "@anvia/anthropic";
 import { OpenAIClient } from "@anvia/openai";
 import { Studio } from "@anvia/studio";
@@ -57,10 +59,12 @@ import { Studio } from "@anvia/studio";
 const openai = new OpenAIClient({ apiKey: process.env.OPENAI_API_KEY });
 const anthropic = new AnthropicClient({ apiKey: process.env.ANTHROPIC_API_KEY });
 
-const agent = new AgentBuilder("support", openai.completionModel("gpt-5"))
-  .name("Support")
-  .instructions("Answer support questions clearly.")
-  .build();
+const agent = new Agent({
+  id: "support",
+  model: openai.completionModel({ modelId: "gpt-5", api: "responses" }),
+  name: "Support",
+  instructions: "Answer support questions clearly.",
+});
 
 new Studio([agent], {
   models: {
@@ -68,8 +72,9 @@ new Studio([agent], {
       {
         id: "openai",
         name: "OpenAI",
-        defaultModel: "gpt-5",
-        createCompletionModel: (model) => openai.completionModel(model),
+        defaultModelId: "gpt-5",
+        createCompletionModel: ({ modelId }) =>
+          openai.completionModel({ modelId, api: "responses" }),
         listModels: () => openai.listModels(),
         models: [
           {
@@ -81,14 +86,14 @@ new Studio([agent], {
       {
         id: "anthropic",
         name: "Anthropic",
-        defaultModel: "claude-sonnet-4-20250514",
-        createCompletionModel: (model) => anthropic.completionModel(model),
+        defaultModelId: "claude-sonnet-4-20250514",
+        createCompletionModel: ({ modelId }) => anthropic.completionModel({ modelId }),
       },
     ],
     agents: {
       support: {
-        default: "openai:gpt-5",
-        allowed: ["openai:*", "anthropic:claude-sonnet-4-20250514"],
+        defaultModelRef: { providerId: "openai", modelId: "gpt-5" },
+        allowed: ["openai:*", { providerId: "anthropic", modelId: "claude-sonnet-4-20250514" }],
       },
     },
   },
@@ -100,8 +105,11 @@ also select a model per run:
 
 ```json
 {
-  "message": "Summarize this ticket",
-  "model": "anthropic:claude-sonnet-4-20250514",
+  "messages": [{ "role": "user", "content": "Summarize this ticket" }],
+  "model": {
+    "providerId": "anthropic",
+    "modelId": "claude-sonnet-4-20250514"
+  },
   "stream": true
 }
 ```
@@ -120,6 +128,10 @@ Studio exposes:
 - Status dashboard for storage adapters, record counts, and enabled capabilities
 - Knowledge tabs for static context, dynamic context, dynamic tools, and retrieval log
 
+Studio reads MCP provenance directly from `Agent.mcpServers`. Prefixes configured by an
+`McpClient` remain visible in both the MCP inspector and direct tool runner, while the remote tool
+name stays available on the typed MCP registration.
+
 ## Session Storage
 
 Studio uses an in-memory store by default. Sessions, traces, and pipeline run history are available while the process is running, but they do not create local files unless you pass an explicit SQLite store. If you omit the port, Studio uses `RUNNER_PORT` and then falls back to `4021`.
@@ -152,3 +164,41 @@ pnpm --filter @anvia/studio typecheck
 pnpm --filter @anvia/studio test
 pnpm --filter @anvia/studio build
 ```
+## Browser sandbox views
+
+Sandbox registrations may include explicit noVNC views. Studio resolves the upstream only through the
+inspector's loopback-published port and exposes an authorized, same-origin WebSocket bridge. Studio's
+programmatic noVNC client renders the desktop directly, so the stock noVNC splash, toolbar, and password
+prompt are not part of the UI.
+
+```ts
+const studio = new Studio([agent], {
+  sandboxes: [
+    {
+      inspector: browser.inspector({ files: true, ports: true, processes: true }),
+      views: [
+        {
+          id: "desktop",
+          label: "Browser",
+          source: browser.desktop,
+          access: { mode: "local" },
+          authentication: { type: "password", password },
+        },
+      ],
+    },
+  ],
+});
+```
+
+Local mode requires a loopback connection and a same-origin browser request. Remotely reachable Studio
+instances must instead provide `{ mode: "authorize", authorize }`; the application callback runs for
+the viewer connection, WebSocket upgrade, and every takeover operation. Studio does not provide or infer
+an application authentication system. View credentials are omitted from sandbox discovery metadata and
+URLs and returned only by the authorized, non-cacheable viewer-connection endpoint.
+
+When a registered agent emits a matching browser tool call, Playground replaces its Sessions sidebar
+with a larger resizable desktop panel. The embedded desktop remains view-only until the user explicitly
+takes control. That lease blocks Anvia browser tools, is renewed by the UI, and expires when abandoned.
+It is a coordination boundary rather than a replacement for application authorization. The Sandboxes
+page continues to expose the registered view as inspectable runtime metadata. Closing the Playground
+panel restores Sessions without forgetting the current browser; use **Open browser** to show it again.

package/dist/index.d.ts

@@ -1,15 +1,17 @@
 import { Hono } from 'hono';
 import { AgentObserver, AgentRunStartArgs, AgentRunObserver } from '@anvia/core/observability';
-import { Message, JsonObject, JsonValue, CompletionModelCapabilities, ToolResultContent, Usage, CompletionModel, StreamingCompletionModel } from '@anvia/core/completion';
-import { Agent } from '@anvia/core/internal/agent';
+import { AgentResult, AgentSuspendedResult, AgentStreamEvent, Agent } from '@anvia/core/agent';
+import { AgentInteractionResponse } from '@anvia/core/agent/interactions';
+import { JsonObject, Message, JsonValue, CompletionModelCapabilities, ToolResultContentPart, Usage, CompletionModel, StreamingCompletionModel } from '@anvia/core/completion';
+import { MemoryStore, MemoryAppendOptions, MemoryErrorOptions, MemoryScope } from '@anvia/core/memory';
 import { ModelList } from '@anvia/core/model-listing';
 import { Pipeline, PipelineGraph } from '@anvia/core/pipeline';
-import { PromptResponse, AgentStreamEvent } from '@anvia/core/request';
 
 declare function traceSummary(trace: StudioTrace): StudioTraceSummary;
 
-type StudioCapability = "agents" | "approvals" | "evals" | "memory" | "knowledge" | "mcps" | "observability" | "pipelines" | "sandboxes" | "sessions" | "status" | "tools" | "traces";
+type StudioCapability = "agents" | "interactions" | "evals" | "memory" | "knowledge" | "mcps" | "observability" | "pipelines" | "sandboxes" | "sessions" | "status" | "tools" | "traces";
 type AgentTraceInfo = {
+    observer: string;
     traceId?: string | undefined;
     observationId?: string | undefined;
 };
@@ -17,15 +19,14 @@ type AgentTraceOptions = {
     name?: string | undefined;
     userId?: string | undefined;
     sessionId?: string | undefined;
-    metadata?: Record<string, unknown> | undefined;
+    metadata?: JsonObject | undefined;
     tags?: string[] | undefined;
     version?: string | undefined;
     traceId?: string | undefined;
-    failOnObserverError?: boolean | undefined;
 };
-type StudioModelRef = string | {
-    provider: string;
-    model: string;
+type StudioModelRef = {
+    providerId: string;
+    modelId: string;
 };
 type StudioModelModality = "text" | "image" | "document" | "audio" | "video";
 type StudioModelModalities = {
@@ -43,19 +44,23 @@ type StudioModelDefinition = {
 type StudioModelProvider = {
     id: string;
     name?: string;
-    defaultModel?: string;
+    defaultModelId?: string;
     models?: StudioModelDefinition[];
-    createCompletionModel(model: string): CompletionModel | StreamingCompletionModel;
-    listModels?: () => Promise<ModelList>;
+    createCompletionModel(options: {
+        modelId: string;
+    }): CompletionModel | StreamingCompletionModel;
+    listModels?: (options?: {
+        abortSignal?: AbortSignal | undefined;
+    }) => Promise<ModelList>;
     metadata?: JsonObject;
 };
 type StudioAgentModelPolicy = {
-    default?: StudioModelRef;
+    defaultModelRef?: StudioModelRef;
     allowed?: Array<StudioModelRef | `${string}:*`>;
 };
 type StudioModelConfig = {
     providers: StudioModelProvider[];
-    default?: StudioModelRef;
+    defaultModelRef?: StudioModelRef;
     agents?: Record<string, StudioAgentModelPolicy>;
 };
 type StudioModelSummary = StudioModelDefinition & {
@@ -66,23 +71,23 @@ type StudioModelSummary = StudioModelDefinition & {
 type StudioModelProviderConfig = {
     id: string;
     name?: string;
-    defaultModel?: string;
+    defaultModelId?: string;
     models: StudioModelSummary[];
     metadata?: JsonObject;
     warning?: string;
 };
 type StudioAgentModelPolicyConfig = {
-    default?: string;
+    defaultModelRef?: string;
     allowed?: string[];
 };
 type StudioModelsConfig = {
     providers: StudioModelProviderConfig[];
-    default?: string;
+    defaultModelRef?: string;
     agents: Record<string, StudioAgentModelPolicyConfig>;
 };
 type StudioAgentModelsSummary = {
     agentId: string;
-    defaultModel?: string;
+    defaultModelRef?: string;
     models: StudioModelSummary[];
     warnings?: JsonObject[];
 };
@@ -116,7 +121,7 @@ type StudioAgentRuntimeSummary = {
     dynamicContextCount: number;
     observerCount: number;
     hasMemory: boolean;
-    hasHook: boolean;
+    hasLifecycle: boolean;
     hasOutputSchema: boolean;
     defaultMaxTurns?: number;
     metadata?: JsonObject;
@@ -149,7 +154,7 @@ type StudioEvalSuite<Input = any, _Output = any, _Expected = any> = {
     metrics: any[];
     concurrency?: number;
     reporters?: any[];
-    failOnReporterError?: boolean;
+    reporterErrorPolicy?: "collect" | "throw";
     id?: string;
     description?: string;
     metadata?: JsonObject;
@@ -232,9 +237,128 @@ type StudioAgentToolsSummary = {
     tools: StudioAgentToolMetadata[];
 };
 type StudioSandboxCapabilities = {
-    files: true;
+    files: boolean;
     ports: boolean;
     processes: boolean;
+    views: boolean;
+};
+type StudioSandboxInspectorFileEntry = Readonly<{
+    path: string;
+    type: StudioSandboxFileType;
+    size?: number;
+}>;
+type StudioSandboxInspectorPort = Readonly<{
+    containerPort: number;
+    host: string;
+    hostPort: number;
+    protocol: string;
+}>;
+type StudioSandboxInspectorProcess = Readonly<{
+    id: string;
+    command: string;
+    args: readonly string[];
+    cwd?: string;
+    status: StudioSandboxProcessStatus;
+    exitCode?: number;
+    startedAt: string;
+    endedAt?: string;
+}>;
+type StudioSandboxInspector = Readonly<{
+    id: string;
+    provider: string;
+    workdir: string;
+    listFiles?: (options?: Readonly<{
+        path?: string;
+        abortSignal?: AbortSignal;
+    }>) => Promise<readonly StudioSandboxInspectorFileEntry[]>;
+    readFile?: (options: Readonly<{
+        path: string;
+        abortSignal?: AbortSignal;
+    }>) => Promise<Uint8Array>;
+    publishedPorts?: readonly StudioSandboxInspectorPort[];
+    listProcesses?: (options?: Readonly<{
+        abortSignal?: AbortSignal;
+    }>) => Promise<readonly StudioSandboxInspectorProcess[]>;
+    readProcessLogs?: (options: Readonly<{
+        processId: string;
+        tailBytes?: number;
+        abortSignal?: AbortSignal;
+    }>) => Promise<StudioSandboxInspectorProcessLogs>;
+}>;
+type StudioSandboxInspectorProcessLogs = Readonly<{
+    stdout: Uint8Array;
+    stderr: Uint8Array;
+    stdoutTruncated: boolean;
+    stderrTruncated: boolean;
+}>;
+type StudioSandboxViewControlSnapshot = Readonly<{
+    mode: "agent" | "human";
+    ownerId?: string;
+    expiresAt?: string;
+}>;
+type StudioSandboxViewControlLease = Readonly<{
+    id: string;
+    ownerId: string;
+    expiresAt: string;
+    renew(options: Readonly<{
+        leaseTimeoutMs: number;
+    }>): StudioSandboxViewControlSnapshot;
+    release(): void;
+}>;
+type StudioSandboxViewControl = Readonly<{
+    snapshot(): StudioSandboxViewControlSnapshot;
+    acquireHumanControl(options: Readonly<{
+        ownerId: string;
+        leaseTimeoutMs: number;
+        abortSignal?: AbortSignal;
+    }>): Promise<StudioSandboxViewControlLease>;
+}>;
+type StudioSandboxViewSource = Readonly<{
+    protocol: "novnc";
+    containerPort: number;
+    control: StudioSandboxViewControl;
+}>;
+type StudioSandboxViewAuthorizeArgs = Readonly<{
+    request: Request;
+    sandboxRef: string;
+    viewId: string;
+}>;
+type StudioSandboxViewAccess = Readonly<{
+    mode: "local";
+}> | Readonly<{
+    mode: "authorize";
+    authorize(args: StudioSandboxViewAuthorizeArgs): boolean | Promise<boolean>;
+}>;
+type StudioSandboxViewAuthentication = Readonly<{
+    type: "none";
+}> | Readonly<{
+    type: "password";
+    password: string;
+}>;
+type StudioSandboxViewRegistration = Readonly<{
+    id: string;
+    label: string;
+    source: StudioSandboxViewSource;
+    access: StudioSandboxViewAccess;
+    authentication: StudioSandboxViewAuthentication;
+}>;
+type StudioSandboxRegistration = Readonly<{
+    inspector: StudioSandboxInspector;
+    agentIds?: readonly string[];
+    toolNames?: readonly string[];
+    views?: readonly StudioSandboxViewRegistration[];
+}>;
+type StudioSandboxViewSummary = {
+    id: string;
+    label: string;
+    protocol: "novnc";
+};
+type StudioSandboxViewConnection = {
+    sandboxRef: string;
+    viewId: string;
+    protocol: "novnc";
+    websocketPath: string;
+    authentication: StudioSandboxViewAuthentication;
 };
 type StudioSandboxSummary = {
     ref: string;
@@ -243,6 +367,7 @@ type StudioSandboxSummary = {
     workdir: string;
     agentIds: string[];
     toolNames: string[];
+    views: StudioSandboxViewSummary[];
     capabilities: StudioSandboxCapabilities;
 };
 type StudioSandboxesSummary = {
@@ -354,7 +479,7 @@ type StudioTranscriptToolEntry = {
     callId?: string;
     args?: string;
     result?: string;
-    structuredResult?: ToolResultContent[];
+    structuredResult?: readonly ToolResultContentPart[];
     childEvents?: StudioTranscriptChildAgentEvent[];
     approval?: StudioToolApprovalTranscript;
     question?: StudioToolQuestionTranscript;
@@ -378,7 +503,7 @@ type StudioTranscriptChildAgentEvent = {
     callId?: string;
     args?: string;
     result?: string;
-    structuredResult?: ToolResultContent[];
+    structuredResult?: readonly ToolResultContentPart[];
 };
 type StudioTranscriptEntry = StudioTranscriptChatEntry | StudioTranscriptReasoningEntry | StudioTranscriptToolEntry;
 type StudioSessionSummary = {
@@ -404,7 +529,7 @@ type StudioSessionListOptions = {
     agentId?: string;
     limit: number;
 };
-type StudioSessionRunStatus = "running" | "success" | "error" | "cancelled";
+type StudioSessionRunStatus = "running" | "success" | "suspended" | "error" | "cancelled";
 type StudioSessionRunTranscriptInput = {
     id: string;
     runId: string;
@@ -441,29 +566,10 @@ type StudioSessionLogListOptions = {
     limit: number;
     after?: number;
 };
-type StudioMemoryContext = {
-    sessionId: string;
-    userId?: string | undefined;
-    metadata?: JsonObject | undefined;
-};
-type StudioMemoryAppendInput = {
-    context: StudioMemoryContext;
-    runId: string;
-    turn: number;
-    messages: Message[];
-};
-type StudioMemoryErrorInput = {
-    context: StudioMemoryContext;
-    runId: string;
-    error: unknown;
-    messages: Message[];
-};
-type StudioMemoryStore = {
-    load(context: StudioMemoryContext): Promise<Message[]>;
-    append(input: StudioMemoryAppendInput): Promise<void>;
-    clear(context: StudioMemoryContext): Promise<void>;
-    recordError?(input: StudioMemoryErrorInput): Promise<void>;
-};
+type StudioMemoryScope = MemoryScope;
+type StudioMemoryAppendOptions = MemoryAppendOptions;
+type StudioMemoryErrorOptions = MemoryErrorOptions;
+type StudioMemoryStore = MemoryStore;
 type StudioSessionStore = StudioMemoryStore & {
     readonly kind?: string;
     listSessions(options: StudioSessionListOptions): StudioSessionSummary[] | Promise<StudioSessionSummary[]>;
@@ -475,7 +581,7 @@ type StudioSessionStore = StudioMemoryStore & {
     listSessionLogs?(options: StudioSessionLogListOptions): StudioSessionLogEntry[] | Promise<StudioSessionLogEntry[]>;
     deleteSession?(id: string): boolean | Promise<boolean>;
 };
-type StudioTraceStatus = "running" | "success" | "error";
+type StudioTraceStatus = "running" | "success" | "suspended" | "error";
 type StudioTraceObservationKind = "agent" | "generation" | "tool";
 type StudioTraceObservation = {
     id: string;
@@ -494,6 +600,7 @@ type StudioTraceObservation = {
 };
 type StudioTraceSummary = {
     id: string;
+    runId?: string;
     sessionId: string;
     name?: string;
     status: StudioTraceStatus;
@@ -547,7 +654,7 @@ type StudioKnowledgeSourceSummary = {
     count: number;
     registrationIndex?: number;
     topK?: number;
-    threshold?: number;
+    minScore?: number;
     inspectable?: boolean;
     itemCount?: number;
 };
@@ -734,6 +841,7 @@ type StudioOptions = {
     stores?: StudioStores;
     ui?: boolean | StudioUiOptions;
     models?: StudioModelConfig;
+    sandboxes?: readonly StudioSandboxRegistration[];
 };
 type StudioServeOptions = {
     port?: number;
@@ -745,25 +853,7 @@ type StudioServeLifecycleOptions = Omit<StudioServeOptions, "handleSignals"> & {
     signal?: AbortSignal;
     onShutdown?: () => void | Promise<void>;
 };
-type StudioToolApprovalDecision = {
-    approved: boolean;
-    reason?: string;
-};
 type StudioToolApprovalStatus = "pending" | "approved" | "rejected" | "timed_out" | "cancelled";
-type StudioToolApproval = {
-    id: string;
-    runId: string;
-    agentId: string;
-    sessionId?: string;
-    toolName: string;
-    callId?: string;
-    internalCallId: string;
-    args: string;
-    status: StudioToolApprovalStatus;
-    requestedAt: string;
-    resolvedAt?: string;
-    reason?: string;
-};
 type StudioToolApprovalTranscript = {
     id: string;
     status: StudioToolApprovalStatus;
@@ -771,14 +861,6 @@ type StudioToolApprovalTranscript = {
     resolvedAt?: string;
     reason?: string;
 };
-type StudioToolApprovalRequestEvent = {
-    type: "tool_approval_request";
-    approval: StudioToolApproval;
-};
-type StudioToolApprovalResultEvent = {
-    type: "tool_approval_result";
-    approval: StudioToolApproval;
-};
 type StudioToolQuestionChoice = {
     label: string;
     value: string;
@@ -787,6 +869,7 @@ type StudioToolQuestionPrompt = {
     id: string;
     question: string;
     choices: StudioToolQuestionChoice[];
+    allowCustom: boolean;
 };
 type StudioToolQuestionAnswer = {
     questionId: string;
@@ -795,22 +878,6 @@ type StudioToolQuestionAnswer = {
     custom?: boolean;
 };
 type StudioToolQuestionStatus = "pending" | "answered" | "cancelled";
-type StudioToolQuestion = {
-    id: string;
-    runId: string;
-    agentId: string;
-    sessionId?: string;
-    toolName: string;
-    callId?: string;
-    internalCallId: string;
-    args: string;
-    questions: StudioToolQuestionPrompt[];
-    status: StudioToolQuestionStatus;
-    requestedAt: string;
-    answeredAt?: string;
-    cancelledAt?: string;
-    answers?: StudioToolQuestionAnswer[];
-};
 type StudioToolQuestionTranscript = {
     id: string;
     status: StudioToolQuestionStatus;
@@ -820,14 +887,6 @@ type StudioToolQuestionTranscript = {
     questions: StudioToolQuestionPrompt[];
     answers?: StudioToolQuestionAnswer[];
 };
-type StudioToolQuestionRequestEvent = {
-    type: "tool_question_request";
-    question: StudioToolQuestion;
-};
-type StudioToolQuestionResultEvent = {
-    type: "tool_question_result";
-    question: StudioToolQuestion;
-};
 type StudioSessionLogEvent = {
     type: "session_log";
     log: StudioSessionLogEntry;
@@ -926,30 +985,33 @@ type StudioPipelineRunResponse = {
     pipelineId: string;
     output: JsonValue;
 };
-type AgentRunRequest = {
-    message: string | Message;
-    history?: Message[];
-    sessionId?: string;
+type AgentRunRequestBase = {
     stream?: boolean;
-    maxTurns?: number;
-    toolConcurrency?: number;
-    model?: StudioModelRef;
     metadata?: JsonObject;
     trace?: AgentTraceOptions;
 };
-type AgentRunUIRequest = {
-    messages: Message[];
+type AgentRunRequest = (AgentRunRequestBase & {
+    type: "messages";
+    messages: readonly Message[];
     sessionId?: string;
-    stream?: boolean;
     maxTurns?: number;
     toolConcurrency?: number;
     model?: StudioModelRef;
-    metadata?: JsonObject;
-    trace?: AgentTraceOptions;
-};
-type AgentRunResponse = PromptResponse;
-type AgentRunStreamEvent = AgentStreamEvent | StudioToolApprovalRequestEvent | StudioToolApprovalResultEvent | StudioToolQuestionRequestEvent | StudioToolQuestionResultEvent | StudioSessionLogEvent | StudioPipelineLogEvent | StudioPipelineFinalEvent;
-type StudioErrorCode = "bad_request" | "conflict" | "not_found" | "payload_too_large" | "unsupported_capability" | "internal_error";
+    interactionId?: never;
+    response?: never;
+}) | (AgentRunRequestBase & {
+    type: "interaction_response";
+    interactionId: string;
+    response: AgentInteractionResponse;
+    messages?: never;
+    sessionId?: never;
+    maxTurns?: never;
+    toolConcurrency?: never;
+    model?: never;
+});
+type AgentRunResponse = Exclude<AgentResult, AgentSuspendedResult> | Omit<AgentSuspendedResult, "continuation" | "messages">;
+type AgentRunStreamEvent = AgentStreamEvent | StudioSessionLogEvent | StudioPipelineLogEvent | StudioPipelineFinalEvent;
+type StudioErrorCode = "bad_request" | "conflict" | "forbidden" | "not_found" | "payload_too_large" | "unsupported_capability" | "internal_error";
 type StudioErrorResponse = {
     error: {
         code: StudioErrorCode;
@@ -979,6 +1041,7 @@ declare class Studio implements AnviaStudio {
     private readonly options;
     private studio;
     private server;
+    private websocketServer;
     private sigintHandler;
     constructor(targets?: StudioTarget[], options?: StudioOptions);
     get app(): Hono;
@@ -998,4 +1061,4 @@ declare function createSqliteSessionStore(options?: SqliteSessionStoreOptions):
 
 declare function createInMemoryStudioStore(): StudioSessionStore & StudioTraceStore & StudioPipelineLogStore & StudioPipelineRunStore;
 
-export { type AgentRunRequest, type AgentRunResponse, type AgentRunStreamEvent, type AgentRunUIRequest, type AgentTraceInfo, type AgentTraceOptions, type AnviaStudio, type SqliteSessionStoreOptions, Studio, type StudioAgent, type StudioAgentConfig, type StudioAgentKnowledgeConfig, type StudioAgentMcpServerMetadata, type StudioAgentMcpToolMetadata, type StudioAgentMcpsSummary, type StudioAgentModelPolicy, type StudioAgentModelPolicyConfig, type StudioAgentModelsSummary, type StudioAgentRuntimeSummary, type StudioAgentToolApprovalMetadata, type StudioAgentToolMetadata, type StudioAgentToolSource, type StudioAgentToolsSummary, type StudioCapability, type StudioCapabilityConfig, type StudioConfig, type StudioErrorCode, type StudioErrorResponse, type StudioEvalCasePreview, type StudioEvalMetricSummary, type StudioEvalRunRequest, type StudioEvalRunResponse, type StudioEvalSuite, type StudioEvalSuiteConfig, type StudioKnowledgeEvidence, type StudioKnowledgeEvidenceDocument, type StudioKnowledgeItem, type StudioKnowledgeItemKind, type StudioKnowledgeItemsPage, type StudioKnowledgeSourceKind, type StudioKnowledgeSourceSummary, type StudioKnowledgeSummary, type StudioMemoryAppendInput, type StudioMemoryContext, type StudioMemoryConversationMessages, type StudioMemoryConversationSteps, type StudioMemoryConversationSummary, type StudioMemoryConversationsPage, type StudioMemoryErrorInput, type StudioMemoryMessageRecord, type StudioMemorySourceConversationMessages, type StudioMemorySourceConversationSteps, type StudioMemorySourceConversationSummary, type StudioMemorySourceConversationsPage, type StudioMemorySourceKind, type StudioMemorySourceSummary, type StudioMemorySourceUsersPage, type StudioMemorySourcesPage, type StudioMemoryStore, type StudioMemoryUserSummary, type StudioMemoryUsersPage, type StudioModelConfig, type StudioModelDefinition, type StudioModelModalities, type StudioModelModality, type StudioModelProvider, type StudioModelProviderConfig, type StudioModelRef, type StudioModelSummary, type StudioModelsConfig, type StudioObservabilityEvent, type StudioObservabilityEventType, 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 StudioPipelineReplayRequest, type StudioPipelineRunGetOptions, type StudioPipelineRunListOptions, type StudioPipelineRunRecord, type StudioPipelineRunRequest, type StudioPipelineRunResponse, type StudioPipelineRunSaveInput, type StudioPipelineRunStatus, type StudioPipelineRunStore, type StudioSandboxCapabilities, type StudioSandboxFileEntry, type StudioSandboxFileType, type StudioSandboxFilesResponse, type StudioSandboxPort, type StudioSandboxPortsResponse, type StudioSandboxProcess, type StudioSandboxProcessLogsResponse, type StudioSandboxProcessStatus, type StudioSandboxProcessesResponse, type StudioSandboxSummary, type StudioSandboxesSummary, type StudioServeLifecycleOptions, 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 StudioStatusSummary, 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 StudioToolRunRequest, type StudioToolRunResponse, type StudioTrace, type StudioTraceListOptions, type StudioTraceObservation, type StudioTraceObservationKind, StudioTraceObserver, type StudioTraceObserverOptions, type StudioTraceStatus, type StudioTraceStore, type StudioTraceSummary, type StudioTranscriptAttachment, type StudioTranscriptChatEntry, type StudioTranscriptChildAgentEvent, type StudioTranscriptEntry, type StudioTranscriptReasoningEntry, type StudioTranscriptToolEntry, type StudioUiOptions, createInMemoryStudioStore, createSqliteSessionStore, traceSummary };
+export { type AgentRunRequest, type AgentRunResponse, type AgentRunStreamEvent, type AgentTraceInfo, type AgentTraceOptions, type AnviaStudio, type SqliteSessionStoreOptions, Studio, type StudioAgent, type StudioAgentConfig, type StudioAgentKnowledgeConfig, type StudioAgentMcpServerMetadata, type StudioAgentMcpToolMetadata, type StudioAgentMcpsSummary, type StudioAgentModelPolicy, type StudioAgentModelPolicyConfig, type StudioAgentModelsSummary, type StudioAgentRuntimeSummary, type StudioAgentToolApprovalMetadata, type StudioAgentToolMetadata, type StudioAgentToolSource, type StudioAgentToolsSummary, type StudioCapability, type StudioCapabilityConfig, type StudioConfig, type StudioErrorCode, type StudioErrorResponse, type StudioEvalCasePreview, type StudioEvalMetricSummary, type StudioEvalRunRequest, type StudioEvalRunResponse, type StudioEvalSuite, type StudioEvalSuiteConfig, type StudioKnowledgeEvidence, type StudioKnowledgeEvidenceDocument, type StudioKnowledgeItem, type StudioKnowledgeItemKind, type StudioKnowledgeItemsPage, type StudioKnowledgeSourceKind, type StudioKnowledgeSourceSummary, type StudioKnowledgeSummary, type StudioMemoryAppendOptions, type StudioMemoryConversationMessages, type StudioMemoryConversationSteps, type StudioMemoryConversationSummary, type StudioMemoryConversationsPage, type StudioMemoryErrorOptions, type StudioMemoryMessageRecord, type StudioMemoryScope, type StudioMemorySourceConversationMessages, type StudioMemorySourceConversationSteps, type StudioMemorySourceConversationSummary, type StudioMemorySourceConversationsPage, type StudioMemorySourceKind, type StudioMemorySourceSummary, type StudioMemorySourceUsersPage, type StudioMemorySourcesPage, type StudioMemoryStore, type StudioMemoryUserSummary, type StudioMemoryUsersPage, type StudioModelConfig, type StudioModelDefinition, type StudioModelModalities, type StudioModelModality, type StudioModelProvider, type StudioModelProviderConfig, type StudioModelRef, type StudioModelSummary, type StudioModelsConfig, type StudioObservabilityEvent, type StudioObservabilityEventType, 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 StudioPipelineReplayRequest, type StudioPipelineRunGetOptions, type StudioPipelineRunListOptions, type StudioPipelineRunRecord, type StudioPipelineRunRequest, type StudioPipelineRunResponse, type StudioPipelineRunSaveInput, type StudioPipelineRunStatus, type StudioPipelineRunStore, type StudioSandboxCapabilities, type StudioSandboxFileEntry, type StudioSandboxFileType, type StudioSandboxFilesResponse, type StudioSandboxInspector, type StudioSandboxInspectorFileEntry, type StudioSandboxInspectorPort, type StudioSandboxInspectorProcess, type StudioSandboxInspectorProcessLogs, type StudioSandboxPort, type StudioSandboxPortsResponse, type StudioSandboxProcess, type StudioSandboxProcessLogsResponse, type StudioSandboxProcessStatus, type StudioSandboxProcessesResponse, type StudioSandboxRegistration, type StudioSandboxSummary, type StudioSandboxViewAccess, type StudioSandboxViewAuthentication, type StudioSandboxViewAuthorizeArgs, type StudioSandboxViewConnection, type StudioSandboxViewControl, type StudioSandboxViewControlLease, type StudioSandboxViewControlSnapshot, type StudioSandboxViewRegistration, type StudioSandboxViewSource, type StudioSandboxViewSummary, type StudioSandboxesSummary, type StudioServeLifecycleOptions, 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 StudioStatusSummary, type StudioStores, type StudioTarget, type StudioToolApprovalStatus, type StudioToolApprovalTranscript, type StudioToolQuestionAnswer, type StudioToolQuestionChoice, type StudioToolQuestionPrompt, type StudioToolQuestionStatus, type StudioToolQuestionTranscript, type StudioToolRunRequest, type StudioToolRunResponse, type StudioTrace, type StudioTraceListOptions, type StudioTraceObservation, type StudioTraceObservationKind, StudioTraceObserver, type StudioTraceObserverOptions, type StudioTraceStatus, type StudioTraceStore, type StudioTraceSummary, type StudioTranscriptAttachment, type StudioTranscriptChatEntry, type StudioTranscriptChildAgentEvent, type StudioTranscriptEntry, type StudioTranscriptReasoningEntry, type StudioTranscriptToolEntry, type StudioUiOptions, createInMemoryStudioStore, createSqliteSessionStore, traceSummary };