@anvia/studio 0.1.3 → 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Indra Zulfi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { Message, JsonObject, AgentTraceOptions, PromptResponse, AgentStreamEvent, JsonValue, Usage, AgentTraceInfo, Agent, MemoryStore, AgentObserver, AgentRunStartArgs, AgentRunObserver } from '@anvia/core';
 import { Hono } from 'hono';
+import { Message, JsonObject, AgentTraceOptions, PromptResponse, AgentStreamEvent, JsonValue, Agent, Pipeline, Usage, AgentTraceInfo, PipelineGraph, MemoryStore, AgentObserver, AgentRunStartArgs, AgentRunObserver } from '@anvia/core';
 
-type StudioCapability = "agents" | "approvals" | "knowledge" | "observability" | "sessions" | "traces";
+type StudioCapability = "agents" | "approvals" | "knowledge" | "mcps" | "observability" | "pipelines" | "sessions" | "tools" | "traces";
 type StudioAgent = {
     id: string;
     agent: Agent;
@@ -10,6 +10,7 @@ type StudioAgent = {
     quickPrompts?: string[];
     metadata?: JsonObject;
 };
+type StudioTarget = Agent | Pipeline<unknown, unknown>;
 type StudioAgentConfig = {
     id: string;
     name?: string;
@@ -17,6 +18,27 @@ type StudioAgentConfig = {
     quickPrompts: string[];
     metadata?: JsonObject;
 };
+type StudioPipeline = {
+    id: string;
+    pipeline: Pipeline<unknown, unknown>;
+    name?: string;
+    description?: string;
+    metadata?: JsonObject;
+};
+type StudioPipelineConfig = {
+    id: string;
+    name?: string;
+    description?: string;
+    metadata?: JsonObject;
+    stageCount: number;
+    edgeCount: number;
+    hasParallelStages: boolean;
+    agentCount: number;
+    extractorCount: number;
+};
+type StudioPipelineDetail = StudioPipelineConfig & {
+    graph: PipelineGraph;
+};
 type StudioCapabilityConfig = {
     enabled: boolean;
     reason?: string;
@@ -27,12 +49,47 @@ type StudioConfig = {
     description?: string;
     version?: string;
     agents: StudioAgentConfig[];
+    pipelines: StudioPipelineConfig[];
     chat: {
         quickPrompts: Record<string, string[]>;
     };
     capabilities: Partial<Record<StudioCapability, StudioCapabilityConfig>>;
     unsupportedCapabilities: StudioCapability[];
 };
+type StudioAgentToolSource = "static" | "dynamic";
+type StudioAgentToolApprovalMetadata = {
+    required: boolean;
+    reason?: string;
+    rejectMessage?: string;
+};
+type StudioAgentToolMetadata = {
+    agentId: string;
+    name: string;
+    description: string;
+    parameters: JsonObject;
+    source: StudioAgentToolSource;
+    approval: StudioAgentToolApprovalMetadata;
+};
+type StudioAgentToolsSummary = {
+    agentId: string;
+    tools: StudioAgentToolMetadata[];
+};
+type StudioAgentMcpToolMetadata = {
+    name: string;
+    description: string;
+    parameters: JsonObject;
+    source: StudioAgentToolSource;
+};
+type StudioAgentMcpServerMetadata = {
+    agentId: string;
+    name: string;
+    toolCount: number;
+    tools: StudioAgentMcpToolMetadata[];
+};
+type StudioAgentMcpsSummary = {
+    agentId: string;
+    servers: StudioAgentMcpServerMetadata[];
+};
 type StudioTranscriptChatEntry = {
     entryId: number;
     kind: "message";
@@ -110,12 +167,42 @@ type StudioSessionRunTranscriptInput = {
     status: StudioSessionRunStatus;
     error?: JsonValue;
 };
+type StudioSessionLogLevel = "debug" | "info" | "warn" | "error";
+type StudioSessionLogCategory = "session" | "run" | "memory" | "prompt" | "model" | "tool" | "approval" | "question" | "api";
+type StudioSessionLogEntry = {
+    id: string;
+    sessionId: string;
+    runId?: string;
+    sequence: number;
+    timestamp: string;
+    level: StudioSessionLogLevel;
+    category: StudioSessionLogCategory;
+    event: string;
+    message: string;
+    metadata?: JsonObject;
+};
+type StudioSessionLogAppendInput = {
+    sessionId: string;
+    runId?: string;
+    level: StudioSessionLogLevel;
+    category: StudioSessionLogCategory;
+    event: string;
+    message: string;
+    metadata?: JsonObject;
+};
+type StudioSessionLogListOptions = {
+    sessionId: string;
+    limit: number;
+    after?: number;
+};
 type StudioSessionStore = MemoryStore & {
     readonly kind?: string;
     listSessions(options: StudioSessionListOptions): StudioSessionSummary[] | Promise<StudioSessionSummary[]>;
     createSession(input: StudioSessionCreateInput): StudioSessionSummary | Promise<StudioSessionSummary>;
     getSession(id: string): StudioSession | undefined | Promise<StudioSession | undefined>;
     saveSessionRunTranscript(input: StudioSessionRunTranscriptInput): StudioSession | undefined | Promise<StudioSession | undefined>;
+    appendSessionLog?(input: StudioSessionLogAppendInput): StudioSessionLogEntry | Promise<StudioSessionLogEntry>;
+    listSessionLogs?(options: StudioSessionLogListOptions): StudioSessionLogEntry[] | Promise<StudioSessionLogEntry[]>;
     deleteSession?(id: string): boolean | Promise<boolean>;
 };
 type StudioTraceStatus = "running" | "success" | "error";
@@ -212,6 +299,8 @@ type StudioKnowledgeSummary = {
 type StudioStores = {
     sessions?: StudioSessionStore | false;
     traces?: StudioTraceStore;
+    pipelineLogs?: StudioPipelineLogStore | false;
+    pipelineRuns?: StudioPipelineRunStore | false;
 };
 type StudioUiOptions = {
     path?: string;
@@ -310,6 +399,95 @@ type StudioToolQuestionResultEvent = {
     type: "tool_question_result";
     question: StudioToolQuestion;
 };
+type StudioSessionLogEvent = {
+    type: "session_log";
+    log: StudioSessionLogEntry;
+};
+type StudioPipelineLogLevel = "debug" | "info" | "warn" | "error";
+type StudioPipelineLogCategory = "pipeline" | "run" | "stage" | "parallel" | "agent" | "extractor" | "api";
+type StudioPipelineLogEntry = {
+    id: string;
+    pipelineId: string;
+    runId?: string;
+    sequence: number;
+    timestamp: string;
+    level: StudioPipelineLogLevel;
+    category: StudioPipelineLogCategory;
+    event: string;
+    message: string;
+    metadata?: JsonObject;
+};
+type StudioPipelineLogAppendInput = {
+    pipelineId: string;
+    runId?: string;
+    level: StudioPipelineLogLevel;
+    category: StudioPipelineLogCategory;
+    event: string;
+    message: string;
+    metadata?: JsonObject;
+};
+type StudioPipelineLogListOptions = {
+    pipelineId: string;
+    limit: number;
+    after?: number;
+};
+type StudioPipelineLogStore = {
+    appendPipelineLog(input: StudioPipelineLogAppendInput): StudioPipelineLogEntry | Promise<StudioPipelineLogEntry>;
+    listPipelineLogs(options: StudioPipelineLogListOptions): StudioPipelineLogEntry[] | Promise<StudioPipelineLogEntry[]>;
+};
+type StudioPipelineLogEvent = {
+    type: "pipeline_log";
+    log: StudioPipelineLogEntry;
+};
+type StudioPipelineFinalEvent = {
+    type: "pipeline_final";
+    runId: string;
+    pipelineId: string;
+    output: JsonValue;
+};
+type StudioPipelineRunStatus = "running" | "success" | "error";
+type StudioPipelineRunRecord = {
+    runId: string;
+    pipelineId: string;
+    status: StudioPipelineRunStatus;
+    input: JsonValue;
+    output?: JsonValue;
+    error?: JsonValue;
+    metadata?: JsonObject;
+    startedAt: string;
+    endedAt?: string;
+    durationMs?: number;
+};
+type StudioPipelineRunSaveInput = {
+    runId: string;
+    pipelineId: string;
+    status: StudioPipelineRunStatus;
+    input: JsonValue;
+    output?: JsonValue;
+    error?: JsonValue;
+    metadata?: JsonObject;
+    startedAt: string;
+    endedAt?: string;
+    durationMs?: number;
+};
+type StudioPipelineRunListOptions = {
+    pipelineId: string;
+    limit: number;
+};
+type StudioPipelineRunStore = {
+    savePipelineRun(input: StudioPipelineRunSaveInput): StudioPipelineRunRecord | Promise<StudioPipelineRunRecord>;
+    listPipelineRuns(options: StudioPipelineRunListOptions): StudioPipelineRunRecord[] | Promise<StudioPipelineRunRecord[]>;
+};
+type StudioPipelineRunRequest = {
+    input: JsonValue;
+    stream?: boolean;
+    metadata?: JsonObject;
+};
+type StudioPipelineRunResponse = {
+    runId: string;
+    pipelineId: string;
+    output: JsonValue;
+};
 type AgentRunRequest = {
     message: string | Message;
     history?: Message[];
@@ -321,7 +499,7 @@ type AgentRunRequest = {
     trace?: AgentTraceOptions;
 };
 type AgentRunResponse = PromptResponse;
-type AgentRunStreamEvent = AgentStreamEvent | StudioToolApprovalRequestEvent | StudioToolApprovalResultEvent | StudioToolQuestionRequestEvent | StudioToolQuestionResultEvent;
+type AgentRunStreamEvent = AgentStreamEvent | StudioToolApprovalRequestEvent | StudioToolApprovalResultEvent | StudioToolQuestionRequestEvent | StudioToolQuestionResultEvent | StudioSessionLogEvent | StudioPipelineLogEvent | StudioPipelineFinalEvent;
 type StudioErrorCode = "bad_request" | "conflict" | "not_found" | "unsupported_capability" | "internal_error";
 type StudioErrorResponse = {
     error: {
@@ -352,7 +530,7 @@ declare class Studio implements AnviaStudio {
     private studio;
     private server;
     private sigintHandler;
-    constructor(agents?: Agent[], options?: StudioOptions);
+    constructor(targets?: StudioTarget[], options?: StudioOptions);
     get app(): Hono;
     fetch(request: Request): Response | Promise<Response>;
     config(): StudioConfig;
@@ -364,6 +542,6 @@ declare class Studio implements AnviaStudio {
 type SqliteSessionStoreOptions = {
     path?: string;
 };
-declare function createSqliteSessionStore(options?: SqliteSessionStoreOptions): StudioSessionStore & StudioTraceStore;
+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 StudioCapability, type StudioCapabilityConfig, type StudioConfig, type StudioErrorCode, type StudioErrorResponse, type StudioKnowledgeEvidence, type StudioKnowledgeEvidenceDocument, type StudioKnowledgeSourceKind, type StudioKnowledgeSourceSummary, type StudioKnowledgeSummary, type StudioOptions, type StudioServeOptions, type StudioSession, type StudioSessionCreateInput, type StudioSessionListOptions, type StudioSessionRunStatus, type StudioSessionRunTranscriptInput, type StudioSessionStore, type StudioSessionSummary, type StudioSessionTraceListOptions, type StudioStaticKnowledgeDocument, type StudioStores, 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 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 };