@anvia/studio 1.0.2 → 1.0.5

package/README.md

@@ -1,6 +1,7 @@
 # @anvia/studio
 
-Studio UI and HTTP runtime for Anvia agents, pipelines, tools, MCPs, memory, status, and knowledge inspection.
+Studio UI and HTTP runtime for Anvia agents, pipelines, graphs, tools, MCPs, memory, status, and
+knowledge inspection.
 
 Use this package to serve local agents and pipelines over HTTP, inspect sessions, traces, tools, MCPs, Memory, Status, and Knowledge in the browser UI, and exercise tool approval workflows during development.
 
@@ -142,6 +143,7 @@ Studio exposes:
 - Realtime observability stream for session logs, pipeline logs, and completed traces
 - Eval suite runner for registered `runEvalSuite` configurations
 - Pipeline graph, logs, run history, and replay-from-history controls
+- Knowledge-graph explorer with type filters, search, node details, and bounded neighborhood expansion
 - Rich agent runtime details, direct tool invocation, static tool, dynamic tool, and MCP inspectors
 - Memory explorer for users, conversations, messages, and transcript steps backed by the session store
 - Status dashboard for storage adapters, record counts, and enabled capabilities
@@ -151,6 +153,27 @@ Studio reads MCP provenance directly from `Agent.mcpServers`. Prefixes configure
 `McpClient` remain visible in both the MCP inspector and direct tool runner, while the remote tool
 name stays available on the typed MCP registration.
 
+### Graph explorer
+
+Register any graph that implements the provider-neutral `GraphExplorer` contract. Both
+`@anvia/neo4j` and `@anvia/memgraph` graph registrations can be passed directly:
+
+```ts
+const studio = new Studio([agent], {
+  graphs: [
+    {
+      id: "support",
+      name: "Support knowledge graph",
+      graph,
+    },
+  ],
+});
+```
+
+Open `/graphs` and select nodes to inspect their public properties or expand their one-hop
+neighborhood. Studio exposes only bounded overview and expansion requests; it does not accept raw
+Cypher. Adapter explorer responses also omit stored embeddings and reserved `__anvia_*` properties.
+
 ## 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`.
@@ -174,7 +197,7 @@ SQLite storage uses dedicated `anvia_studio_*` tables so it can share an applica
 - `Studio`
 - `createInMemoryStudioStore`
 - `createSqliteSessionStore`
-- Studio session, trace, approval, pipeline, memory, status, knowledge, tool, MCP, and runtime types
+- Studio session, trace, approval, pipeline, graph, memory, status, knowledge, tool, MCP, and runtime types
 
 ## Development
 

package/dist/index.d.ts

@@ -6,10 +6,11 @@ import { JsonObject, Message, JsonValue, CompletionModelCapabilities, ToolResult
 import { MemoryStore, MemoryAppendOptions, MemoryErrorOptions, MemoryScope } from '@anvia/core/memory';
 import { ModelList } from '@anvia/core/model-listing';
 import { Pipeline, PipelineGraph } from '@anvia/core/pipeline';
+import { GraphExplorer } from '@anvia/graph';
 
 declare function traceSummary(trace: StudioTrace): StudioTraceSummary;
 
-type StudioCapability = "agents" | "interactions" | "evals" | "memory" | "knowledge" | "mcps" | "observability" | "pipelines" | "sandboxes" | "sessions" | "status" | "tools" | "traces";
+type StudioCapability = "agents" | "interactions" | "evals" | "graphs" | "memory" | "knowledge" | "mcps" | "observability" | "pipelines" | "sandboxes" | "sessions" | "status" | "tools" | "traces";
 type AgentTraceInfo = {
     observer: string;
     traceId?: string | undefined;
@@ -147,6 +148,43 @@ type StudioPipelineConfig = {
 type StudioPipelineDetail = StudioPipelineConfig & {
     graph: PipelineGraph;
 };
+type StudioGraphRegistration = {
+    id: string;
+    graph: GraphExplorer;
+    name?: string;
+    description?: string;
+};
+type StudioGraphConfig = {
+    id: string;
+    name?: string;
+    description?: string;
+    nodeTypes: Array<{
+        name: string;
+        description: string;
+    }>;
+    relationshipTypes: Array<{
+        name: string;
+        description: string;
+        from: string;
+        to: string;
+    }>;
+};
+type StudioGraphExploreRequest = {
+    mode: "overview";
+    nodeTypes?: string[];
+    relationships?: string[];
+    maxNodes?: number;
+    maxRelationships?: number;
+} | {
+    mode: "expand";
+    nodeIds: string[];
+    nodeTypes?: string[];
+    relationships?: string[];
+    direction?: "outgoing" | "incoming" | "both";
+    maxDepth?: number;
+    maxNodes?: number;
+    maxRelationships?: number;
+};
 type StudioEvalSuite<Input = any, _Output = any, _Expected = any> = {
     name: string;
     cases: Array<Input>;
@@ -210,6 +248,7 @@ type StudioConfig = {
     agents: StudioAgentConfig[];
     models?: StudioModelsConfig;
     pipelines: StudioPipelineConfig[];
+    graphs: StudioGraphConfig[];
     evals: StudioEvalSuiteConfig[];
     chat: {
         quickPrompts: Record<string, string[]>;
@@ -842,6 +881,7 @@ type StudioOptions = {
     ui?: boolean | StudioUiOptions;
     models?: StudioModelConfig;
     sandboxes?: readonly StudioSandboxRegistration[];
+    graphs?: readonly StudioGraphRegistration[];
 };
 type StudioServeOptions = {
     port?: number;
@@ -1072,4 +1112,4 @@ declare function createSqliteSessionStore(options?: SqliteSessionStoreOptions):
 
 declare function createInMemoryStudioStore(): StudioSessionStore & StudioTraceStore & StudioPipelineLogStore & StudioPipelineRunStore;
 
-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 };
+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 StudioGraphConfig, type StudioGraphExploreRequest, type StudioGraphRegistration, 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 };

package/dist/index.js

@@ -674,6 +674,7 @@ function registerStudioUi(app, options) {
   app.get(`${options.path}/tools`, (c) => redirectWithQuery(c, "/tools"));
   app.get(`${options.path}/mcps`, (c) => redirectWithQuery(c, "/mcps"));
   app.get(`${options.path}/pipelines`, (c) => redirectWithQuery(c, "/pipelines"));
+  app.get(`${options.path}/graphs`, (c) => redirectWithQuery(c, "/graphs"));
   app.get(`${options.path}/sandboxes`, (c) => redirectWithQuery(c, "/sandboxes"));
   app.get(
     `${options.path}/sandboxes/:sandboxRef`,
@@ -698,6 +699,7 @@ function registerStudioUi(app, options) {
     app.get("/tools", async (c) => c.html(await renderShell()));
     app.get("/mcps", async (c) => c.html(await renderShell()));
     app.get("/pipelines", shellWhenHtml(renderShell));
+    app.get("/graphs", shellWhenHtml(renderShell));
     app.get("/sandboxes", shellWhenHtml(renderShell));
     app.get("/sandboxes/:sandboxRef", shellWhenHtml(renderShell));
     app.get("/memory", async (c) => c.html(await renderShell()));
@@ -791,8 +793,9 @@ function renderLegacyStudioUiShell(props) {
     '<meta charset="utf-8">',
     '<meta name="viewport" content="width=device-width, initial-scale=1">',
     `<title>${title}</title>`,
-    '<script>(()=>{try{const t=localStorage.getItem("anvia-studio-theme");const d=t==="dark"||(t!=="light"&&matchMedia("(prefers-color-scheme: dark)").matches);document.documentElement.classList.toggle("dark",d);document.documentElement.style.colorScheme=d?"dark":"light"}catch{}})();</script>',
-    `<link rel="icon" type="image/svg+xml" href="${escapeHtml(props.compatUiPath)}/assets/favicon.svg">`,
+    '<meta name="theme-color" content="#09090b">',
+    `<link data-anvia-favicon rel="icon" type="image/svg+xml" href="${escapeHtml(props.compatUiPath)}/assets/favicon-dark.svg">`,
+    '<script>(()=>{let m="dark";try{const t=localStorage.getItem("anvia-theme");const l=localStorage.getItem("anvia-studio-theme");if(t==="light"||(t!=="dark"&&l==="light"))m="light"}catch{}const r=document.documentElement;r.classList.toggle("dark",m==="dark");r.dataset.theme=m;r.style.colorScheme=m;document.querySelector(\'meta[name="theme-color"]\')?.setAttribute("content",m==="dark"?"#09090b":"#f4f4f5");const f=document.querySelector("link[data-anvia-favicon]");if(f)f.href=f.href.replace("favicon-dark.svg",`favicon-${m}.svg`)})();</script>',
     `<link rel="stylesheet" href="${escapeHtml(props.stylesheet)}">`,
     "</head>",
     "<body>",
@@ -1009,6 +1012,18 @@ function unsupportedCapability(c, capability) {
     { capability }
   );
 }
+async function parseJsonBody(c, validate) {
+  let body;
+  try {
+    body = await c.req.json();
+  } catch {
+    return { error: errorResponse(c, 400, "bad_request", "Request body must be JSON") };
+  }
+  if (!isObject(body)) {
+    return { error: errorResponse(c, 400, "bad_request", "Request body must be an object") };
+  }
+  return validate(body);
+}
 
 // src/runtime/models.ts
 var STUDIO_MODEL_METADATA_KEY = "studioModel";
@@ -4218,12 +4233,33 @@ function pipelineConfig(pipeline) {
   if (pipeline.metadata !== void 0) config.metadata = pipeline.metadata;
   return config;
 }
+function graphConfig(registration) {
+  const config = {
+    id: registration.id,
+    nodeTypes: Object.entries(registration.graph.schema.nodes).map(([name, definition]) => ({
+      name,
+      description: definition.description
+    })),
+    relationshipTypes: Object.entries(registration.graph.schema.relationships).map(
+      ([name, definition]) => ({
+        name,
+        description: definition.description,
+        from: definition.from,
+        to: definition.to
+      })
+    )
+  };
+  if (registration.name !== void 0) config.name = registration.name;
+  if (registration.description !== void 0) config.description = registration.description;
+  return config;
+}
 function buildConfig(options, agents, pipelines, stores, sandboxCount = 0) {
   const models = options.models === void 0 ? void 0 : studioModelsConfig(createStudioModelRegistry(options.models), agents);
   const config = {
     id: runnerId(options),
     agents: agents.map(agentConfig),
     pipelines: pipelines.map(pipelineConfig),
+    graphs: options.graphs.map(graphConfig),
     evals: options.evals.map(evalConfig),
     chat: {
       quickPrompts: Object.fromEntries(agents.map((agent) => [agent.id, agent.quickPrompts ?? []]))
@@ -4255,6 +4291,9 @@ function capabilityConfig(_options, agents, pipelines, stores, sandboxCount = 0)
   if (pipelines.length > 0) {
     capabilities.pipelines = { enabled: true };
   }
+  if (_options.graphs.length > 0) {
+    capabilities.graphs = { enabled: true };
+  }
   if (_options.evals.length > 0) {
     capabilities.evals = { enabled: true };
   }
@@ -4352,6 +4391,110 @@ async function parseEvalRunRequest(c) {
   return request;
 }
 
+// src/runtime/graphs.ts
+import { resolveGraphExploreOptions } from "@anvia/graph/explore";
+function registerGraphRoutes(app, registrations) {
+  const graphs = graphRegistry(registrations);
+  app.get("/graphs", (c) => c.json({ graphs: [...graphs.values()].map(graphConfig) }));
+  app.post("/graphs/:graphId/explore", async (c) => {
+    const registration = graphs.get(c.req.param("graphId"));
+    if (registration === void 0) {
+      return errorResponse(c, 404, "not_found", "Graph not found");
+    }
+    const body = await parseJsonBody(c, (value) => parseExploreRequest(c, value));
+    if ("error" in body) return body.error;
+    const input = exploreOptionsWithSignal(body, c.req.raw.signal);
+    let options;
+    try {
+      options = resolveGraphExploreOptions(registration.graph.schema, input);
+    } catch (error) {
+      return errorResponse(
+        c,
+        400,
+        "bad_request",
+        error instanceof Error ? error.message : "Invalid graph exploration request"
+      );
+    }
+    return c.json(await registration.graph.explore(options));
+  });
+}
+function graphRegistry(registrations) {
+  const graphs = /* @__PURE__ */ new Map();
+  for (const registration of registrations) {
+    if (typeof registration.id !== "string" || registration.id.length === 0) {
+      throw new TypeError("Studio graph id must be a non-empty string.");
+    }
+    if (graphs.has(registration.id)) {
+      throw new TypeError(`Duplicate Studio graph id: ${registration.id}.`);
+    }
+    graphs.set(registration.id, registration);
+  }
+  return graphs;
+}
+function parseExploreRequest(c, value) {
+  if (!isObject(value) || value.mode !== "overview" && value.mode !== "expand") {
+    return { error: errorResponse(c, 400, "bad_request", "mode must be overview or expand") };
+  }
+  const common = parseCommonOptions(c, value);
+  if ("error" in common) return common;
+  if (value.mode === "overview") return { ...common, mode: "overview" };
+  const nodeIds = stringList(value.nodeIds);
+  if (nodeIds === void 0) {
+    return { error: errorResponse(c, 400, "bad_request", "nodeIds must be a string array") };
+  }
+  const request = {
+    ...common,
+    mode: "expand",
+    nodeIds
+  };
+  if (value.direction === "outgoing" || value.direction === "incoming" || value.direction === "both") {
+    request.direction = value.direction;
+  } else if (value.direction !== void 0) {
+    return {
+      error: errorResponse(c, 400, "bad_request", "direction must be outgoing, incoming, or both")
+    };
+  }
+  if (typeof value.maxDepth === "number") request.maxDepth = value.maxDepth;
+  else if (value.maxDepth !== void 0) {
+    return { error: errorResponse(c, 400, "bad_request", "maxDepth must be a number") };
+  }
+  return request;
+}
+function parseCommonOptions(c, value) {
+  const request = {};
+  for (const [key, label] of [
+    ["nodeTypes", "nodeTypes"],
+    ["relationships", "relationships"]
+  ]) {
+    const selected = value[key];
+    if (selected === void 0) continue;
+    const values = stringList(selected);
+    if (values === void 0) {
+      return { error: errorResponse(c, 400, "bad_request", `${label} must be a string array`) };
+    }
+    request[key] = values;
+  }
+  for (const [key, label] of [
+    ["maxNodes", "maxNodes"],
+    ["maxRelationships", "maxRelationships"]
+  ]) {
+    const selected = value[key];
+    if (selected === void 0) continue;
+    if (typeof selected !== "number") {
+      return { error: errorResponse(c, 400, "bad_request", `${label} must be a number`) };
+    }
+    request[key] = selected;
+  }
+  return request;
+}
+function exploreOptionsWithSignal(request, abortSignal) {
+  return { ...request, abortSignal };
+}
+function stringList(value) {
+  if (!Array.isArray(value) || !value.every((item) => typeof item === "string")) return void 0;
+  return value;
+}
+
 // src/runtime/interactions.ts
 import {
   assertAgentInteractionResponse
@@ -7111,7 +7254,8 @@ function studioOptionsFromTargets(targets, options) {
   const runtimeOptions = {
     agents: inferStudioAgents(agents, options.quickPrompts ?? {}),
     pipelines: inferStudioPipelines(pipelines),
-    evals: options.evals ?? []
+    evals: options.evals ?? [],
+    graphs: options.graphs === void 0 ? [] : [...options.graphs]
   };
   if (options.models !== void 0) runtimeOptions.models = options.models;
   if (options.stores !== void 0) runtimeOptions.stores = options.stores;
@@ -7252,6 +7396,7 @@ function createStudioApp(options) {
     evals: options.evals,
     evalMap
   });
+  registerGraphRoutes(app, options.graphs);
   const knowledgeOptions = { agents };
   if (stores.traces !== void 0) knowledgeOptions.traceStore = stores.traces;
   registerKnowledgeRoutes(app, knowledgeOptions);