@anvia/studio 0.5.14 → 0.6.1

package/README.md

@@ -44,6 +44,68 @@ Then open:
 http://localhost:4021/ui/playground
 ```
 
+## Multi-Provider Models
+
+Studio can expose a shared model catalog and let each agent choose from registered providers:
+
+```ts
+import { AgentBuilder } from "@anvia/core";
+import { AnthropicClient } from "@anvia/anthropic";
+import { OpenAIClient } from "@anvia/openai";
+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();
+
+new Studio([agent], {
+  models: {
+    providers: [
+      {
+        id: "openai",
+        name: "OpenAI",
+        defaultModel: "gpt-5",
+        createCompletionModel: (model) => openai.completionModel(model),
+        listModels: () => openai.listModels(),
+        models: [
+          {
+            id: "gpt-5",
+            modalities: { input: ["text", "image", "document"], output: ["text"] },
+          },
+        ],
+      },
+      {
+        id: "anthropic",
+        name: "Anthropic",
+        defaultModel: "claude-sonnet-4-20250514",
+        createCompletionModel: (model) => anthropic.completionModel(model),
+      },
+    ],
+    agents: {
+      support: {
+        default: "openai:gpt-5",
+        allowed: ["openai:*", "anthropic:claude-sonnet-4-20250514"],
+      },
+    },
+  },
+}).start();
+```
+
+The playground message composer shows the allowed models for the selected agent. API callers can
+also select a model per run:
+
+```json
+{
+  "message": "Summarize this ticket",
+  "model": "anthropic:claude-sonnet-4-20250514",
+  "stream": true
+}
+```
+
 ## Browser UI
 
 Studio exposes:

package/dist/index.d.ts

@@ -1,13 +1,77 @@
 import { Hono } from 'hono';
 import { AgentTraceOptions, AgentTraceInfo, AgentObserver, AgentRunStartArgs, AgentRunObserver } from '@anvia/core/observability';
 import { PromptResponse, AgentStreamEvent } from '@anvia/core/agent';
-import { Message, JsonObject, JsonValue, ToolResultContent, Usage } from '@anvia/core/completion';
+import { Message, JsonObject, JsonValue, CompletionModelCapabilities, ToolResultContent, Usage, CompletionModel, StreamingCompletionModel } from '@anvia/core/completion';
 import { RunEvalSuiteOptions } from '@anvia/core/evals';
 import { Agent } from '@anvia/core/internal/agent';
 import { MemoryStore } from '@anvia/core/memory';
+import { ModelList } from '@anvia/core/model-listing';
 import { Pipeline, PipelineGraph } from '@anvia/core/pipeline';
 
 type StudioCapability = "agents" | "approvals" | "evals" | "memory" | "knowledge" | "mcps" | "observability" | "pipelines" | "sessions" | "status" | "tools" | "traces";
+type StudioModelRef = string | {
+    provider: string;
+    model: string;
+};
+type StudioModelModality = "text" | "image" | "document" | "audio" | "video";
+type StudioModelModalities = {
+    input: StudioModelModality[];
+    output?: StudioModelModality[];
+};
+type StudioModelDefinition = {
+    id: string;
+    name?: string;
+    description?: string;
+    modalities?: StudioModelModalities;
+    capabilities?: Partial<CompletionModelCapabilities>;
+    metadata?: JsonObject;
+};
+type StudioModelProvider = {
+    id: string;
+    name?: string;
+    defaultModel?: string;
+    models?: StudioModelDefinition[];
+    createCompletionModel(model: string): CompletionModel | StreamingCompletionModel;
+    listModels?: () => Promise<ModelList>;
+    metadata?: JsonObject;
+};
+type StudioAgentModelPolicy = {
+    default?: StudioModelRef;
+    allowed?: Array<StudioModelRef | `${string}:*`>;
+};
+type StudioModelConfig = {
+    providers: StudioModelProvider[];
+    default?: StudioModelRef;
+    agents?: Record<string, StudioAgentModelPolicy>;
+};
+type StudioModelSummary = StudioModelDefinition & {
+    ref: string;
+    providerId: string;
+    providerName?: string;
+};
+type StudioModelProviderConfig = {
+    id: string;
+    name?: string;
+    defaultModel?: string;
+    models: StudioModelSummary[];
+    metadata?: JsonObject;
+    warning?: string;
+};
+type StudioAgentModelPolicyConfig = {
+    default?: string;
+    allowed?: string[];
+};
+type StudioModelsConfig = {
+    providers: StudioModelProviderConfig[];
+    default?: string;
+    agents: Record<string, StudioAgentModelPolicyConfig>;
+};
+type StudioAgentModelsSummary = {
+    agentId: string;
+    defaultModel?: string;
+    models: StudioModelSummary[];
+    warnings?: JsonObject[];
+};
 type StudioAgent = {
     id: string;
     agent: Agent;
@@ -99,6 +163,7 @@ type StudioConfig = {
     description?: string;
     version?: string;
     agents: StudioAgentConfig[];
+    models?: StudioModelsConfig;
     pipelines: StudioPipelineConfig[];
     evals: StudioEvalSuiteConfig[];
     chat: {
@@ -163,6 +228,14 @@ type StudioTranscriptChatEntry = {
     text: string;
     tone?: "error";
     traceId?: string;
+    attachments?: StudioTranscriptAttachment[];
+};
+type StudioTranscriptAttachment = {
+    kind: "image" | "document";
+    name?: string;
+    mediaType?: string;
+    data?: string;
+    url?: string;
 };
 type StudioTranscriptReasoningEntry = {
     entryId: number;
@@ -270,6 +343,7 @@ type StudioSessionStore = MemoryStore & {
     createSession(input: StudioSessionCreateInput): StudioSessionSummary | Promise<StudioSessionSummary>;
     getSession(id: string): StudioSession | undefined | Promise<StudioSession | undefined>;
     saveSessionRunTranscript(input: StudioSessionRunTranscriptInput): StudioSession | undefined | Promise<StudioSession | undefined>;
+    updateSessionMetadata?(id: string, metadata: JsonObject | undefined): StudioSession | undefined | Promise<StudioSession | undefined>;
     appendSessionLog?(input: StudioSessionLogAppendInput): StudioSessionLogEntry | Promise<StudioSessionLogEntry>;
     listSessionLogs?(options: StudioSessionLogListOptions): StudioSessionLogEntry[] | Promise<StudioSessionLogEntry[]>;
     deleteSession?(id: string): boolean | Promise<boolean>;
@@ -478,6 +552,7 @@ type StudioOptions = {
     quickPrompts?: Record<string, string[]>;
     stores?: StudioStores;
     ui?: boolean | StudioUiOptions;
+    models?: StudioModelConfig;
 };
 type StudioServeOptions = {
     port?: number;
@@ -670,6 +745,7 @@ type AgentRunRequest = {
     stream?: boolean;
     maxTurns?: number;
     toolConcurrency?: number;
+    model?: StudioModelRef;
     metadata?: JsonObject;
     trace?: AgentTraceOptions;
 };
@@ -683,6 +759,7 @@ type StudioErrorResponse = {
         details?: JsonValue;
     };
 };
+declare function traceSummary(trace: StudioTrace): StudioTraceSummary;
 type AnviaStudio = {
     readonly app: Hono;
     fetch(request: Request): Response | Promise<Response>;
@@ -721,4 +798,4 @@ declare function createSqliteSessionStore(options?: SqliteSessionStoreOptions):
 
 declare function createInMemoryStudioStore(): 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 StudioAgentRuntimeSummary, type StudioAgentToolApprovalMetadata, type StudioAgentToolMetadata, type StudioAgentToolSource, type StudioAgentToolsSummary, type StudioCapability, type StudioCapabilityConfig, type StudioConfig, type StudioErrorCode, type StudioErrorResponse, 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 StudioMemoryConversationMessages, type StudioMemoryConversationSteps, type StudioMemoryConversationSummary, type StudioMemoryConversationsPage, type StudioMemoryUserSummary, type StudioMemoryUsersPage, 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 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 StudioTranscriptChatEntry, type StudioTranscriptChildAgentEvent, type StudioTranscriptEntry, type StudioTranscriptReasoningEntry, type StudioTranscriptToolEntry, type StudioUiOptions, createInMemoryStudioStore, 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 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 StudioEvalRunRequest, type StudioEvalRunResponse, type StudioEvalSuite, type StudioEvalSuiteConfig, type StudioKnowledgeEvidence, type StudioKnowledgeEvidenceDocument, type StudioKnowledgeItem, type StudioKnowledgeItemKind, type StudioKnowledgeItemsPage, type StudioKnowledgeSourceKind, type StudioKnowledgeSourceSummary, type StudioKnowledgeSummary, type StudioMemoryConversationMessages, type StudioMemoryConversationSteps, type StudioMemoryConversationSummary, type StudioMemoryConversationsPage, 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 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 };