@anvia/studio 0.7.34 → 0.7.35

package/dist/index.d.ts

@@ -635,6 +635,59 @@ type StudioMemoryConversationSteps = {
     conversation: StudioMemoryConversationSummary;
     steps: StudioTranscriptEntry[];
 };
+type StudioMemorySourceKind = "agent" | "studio";
+type StudioMemorySourceSummary = {
+    ref: string;
+    kind: StudioMemorySourceKind;
+    label: string;
+    agentIds: string[];
+    available: boolean;
+    storeKind?: string;
+    reason?: string;
+};
+type StudioMemorySourcesPage = {
+    sources: StudioMemorySourceSummary[];
+};
+type StudioMemorySourceConversationSummary = {
+    ref: string;
+    sessionId: string;
+    userId: string;
+    agentIds: string[];
+    title?: string;
+    createdAt: string;
+    updatedAt: string;
+    messageCount: number;
+    metadata?: JsonObject;
+};
+type StudioMemorySourceConversationsPage = {
+    source: StudioMemorySourceSummary;
+    conversations: StudioMemorySourceConversationSummary[];
+    total: number;
+};
+type StudioMemorySourceUsersPage = {
+    source: StudioMemorySourceSummary;
+    users: StudioMemoryUserSummary[];
+    total: number;
+};
+type StudioMemoryMessageRecord = {
+    position: number;
+    runId: string;
+    turn: number;
+    createdAt: string;
+    message: Message;
+};
+type StudioMemorySourceConversationMessages = {
+    source: StudioMemorySourceSummary;
+    conversation: StudioMemorySourceConversationSummary;
+    messages: Message[];
+    records: StudioMemoryMessageRecord[];
+    transcript: StudioTranscriptEntry[];
+};
+type StudioMemorySourceConversationSteps = {
+    source: StudioMemorySourceSummary;
+    conversation: StudioMemorySourceConversationSummary;
+    steps: StudioTranscriptEntry[];
+};
 type StudioStatusSummary = {
     runner: {
         id: string;
@@ -942,4 +995,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 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 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 };

package/dist/index.js

@@ -3830,6 +3830,8 @@ function capabilityConfig(_options, agents, pipelines, stores, sandboxCount = 0)
   };
   if (stores.sessions !== void 0) {
     capabilities.sessions = { enabled: true };
+  }
+  if (stores.sessions !== void 0 || agents.some((agent) => agent.agent.memory !== void 0)) {
     capabilities.memory = { enabled: true };
   }
   if (stores.traces !== void 0) {
@@ -4384,13 +4386,137 @@ async function agentMcpMetadata(agent) {
 
 // src/runtime/memory.ts
 var DEFAULT_USER_ID = "default";
+var USER_DISCOVERY_LIMIT = 1e3;
+function createStudioMemorySourceRegistry(agents, sessionStore) {
+  const sources = [];
+  const byStore = /* @__PURE__ */ new Map();
+  const agentsWithoutMemory = [];
+  for (const agent of agents) {
+    const store = agent.agent.memory?.store;
+    if (store === void 0) {
+      agentsWithoutMemory.push(agent);
+      continue;
+    }
+    const existing = byStore.get(store);
+    if (existing !== void 0) {
+      existing.summary.agentIds.push(agent.id);
+      existing.summary.label = "Shared agent memory";
+      continue;
+    }
+    const ref = `agent-memory-${sources.length + 1}`;
+    const label = `${agent.name ?? agent.agent.name ?? agent.id} memory`;
+    const kind = storeKind(store);
+    const source = store.inspector === void 0 ? unavailableAgentSource(ref, label, agent.id, kind) : agentMemorySource(ref, label, agent.id, kind, store.inspector);
+    sources.push(source);
+    byStore.set(store, source);
+  }
+  if (sessionStore !== void 0 && (agentsWithoutMemory.length > 0 || agents.length === 0)) {
+    sources.push(
+      studioSessionSource(
+        sessionStore,
+        agentsWithoutMemory.map((agent) => agent.id)
+      )
+    );
+  }
+  const byRef = new Map(sources.map((source) => [source.summary.ref, source]));
+  return {
+    size: sources.length,
+    list: () => sources.map((source) => ({ ...source.summary, agentIds: [...source.summary.agentIds] })),
+    get: (ref) => byRef.get(ref)
+  };
+}
 function registerMemoryRoutes(app, props) {
+  registerMemorySourceRoutes(app, props.sources);
+  if (props.sessionStore !== void 0) {
+    registerLegacyMemoryRoutes(app, props.sessionStore);
+  }
+}
+function registerMemorySourceRoutes(app, registry) {
+  app.get(
+    "/memory/sources",
+    (c) => c.json({ sources: registry.list() })
+  );
+  app.get("/memory/sources/:sourceRef/users", async (c) => {
+    const limit = parseLimit(c.req.query("limit"));
+    if (limit === void 0) {
+      return errorResponse(c, 400, "bad_request", "limit must be a positive integer");
+    }
+    const source = registry.get(c.req.param("sourceRef"));
+    if (source === void 0) {
+      return errorResponse(c, 404, "not_found", "Memory source not found");
+    }
+    if (!source.summary.available) return unavailableSourceResponse(c, source.summary);
+    const conversations = await source.listConversations({ limit: USER_DISCOVERY_LIMIT });
+    const userPage = memoryUsers(conversations, limit);
+    return c.json({
+      source: source.summary,
+      users: userPage.users,
+      total: userPage.total
+    });
+  });
+  app.get("/memory/sources/:sourceRef/conversations", async (c) => {
+    const limit = parseLimit(c.req.query("limit"));
+    if (limit === void 0) {
+      return errorResponse(c, 400, "bad_request", "limit must be a positive integer");
+    }
+    const source = registry.get(c.req.param("sourceRef"));
+    if (source === void 0) {
+      return errorResponse(c, 404, "not_found", "Memory source not found");
+    }
+    if (!source.summary.available) return unavailableSourceResponse(c, source.summary);
+    const userId = optionalQueryString(c.req.query("userId"));
+    const listOptions = { limit };
+    if (userId !== void 0) listOptions.userId = userId;
+    const conversations = await source.listConversations(listOptions);
+    return c.json({
+      source: source.summary,
+      conversations,
+      total: conversations.length
+    });
+  });
+  app.get("/memory/sources/:sourceRef/conversations/:conversationRef/messages", async (c) => {
+    const source = registry.get(c.req.param("sourceRef"));
+    if (source === void 0) {
+      return errorResponse(c, 404, "not_found", "Memory source not found");
+    }
+    if (!source.summary.available) return unavailableSourceResponse(c, source.summary);
+    const detail = await source.getConversation(c.req.param("conversationRef"));
+    if (detail === void 0) {
+      return errorResponse(c, 404, "not_found", "Conversation not found");
+    }
+    const messages = detail.records.map((record) => record.message);
+    return c.json({
+      source: source.summary,
+      conversation: detail.conversation,
+      messages,
+      records: detail.records,
+      transcript: transcriptFromMessages(messages)
+    });
+  });
+  app.get("/memory/sources/:sourceRef/conversations/:conversationRef/steps", async (c) => {
+    const source = registry.get(c.req.param("sourceRef"));
+    if (source === void 0) {
+      return errorResponse(c, 404, "not_found", "Memory source not found");
+    }
+    if (!source.summary.available) return unavailableSourceResponse(c, source.summary);
+    const detail = await source.getConversation(c.req.param("conversationRef"));
+    if (detail === void 0) {
+      return errorResponse(c, 404, "not_found", "Conversation not found");
+    }
+    return c.json({
+      source: source.summary,
+      conversation: detail.conversation,
+      steps: transcriptFromMessages(detail.records.map((record) => record.message))
+    });
+  });
+}
+function registerLegacyMemoryRoutes(app, sessionStore) {
   app.get("/memory/users", async (c) => {
     const limit = parseLimit(c.req.query("limit"));
     if (limit === void 0) {
       return errorResponse(c, 400, "bad_request", "limit must be a positive integer");
     }
-    const sessions = await props.sessionStore.listSessions({ limit: 100 });
+    const sessions = await sessionStore.listSessions({ limit: 100 });
     const users = /* @__PURE__ */ new Map();
     for (const session of sessions) {
       const userId = sessionUserId(session);
@@ -4405,9 +4531,7 @@ function registerMemoryRoutes(app, props) {
         continue;
       }
       existing.conversationCount += 1;
-      if (!existing.agentIds.includes(session.agentId)) {
-        existing.agentIds.push(session.agentId);
-      }
+      if (!existing.agentIds.includes(session.agentId)) existing.agentIds.push(session.agentId);
       if (new Date(session.updatedAt).getTime() > new Date(existing.lastInteractionAt).getTime()) {
         existing.lastInteractionAt = session.updatedAt;
       }
@@ -4426,7 +4550,7 @@ function registerMemoryRoutes(app, props) {
     const userId = optionalQueryString(c.req.query("userId"));
     const listInput = { limit: 100 };
     if (agentId !== void 0) listInput.agentId = agentId;
-    const sessions = await props.sessionStore.listSessions(listInput);
+    const sessions = await sessionStore.listSessions(listInput);
     const conversations = sessions.map(memoryConversationSummary).filter((session) => userId === void 0 || session.userId === userId).slice(0, limit);
     return c.json({
       conversations,
@@ -4434,7 +4558,7 @@ function registerMemoryRoutes(app, props) {
     });
   });
   app.get("/memory/conversations/:conversationId/messages", async (c) => {
-    const session = await props.sessionStore.getSession(c.req.param("conversationId"));
+    const session = await sessionStore.getSession(c.req.param("conversationId"));
     if (session === void 0) {
       return errorResponse(c, 404, "not_found", "Conversation not found");
     }
@@ -4445,7 +4569,7 @@ function registerMemoryRoutes(app, props) {
     });
   });
   app.get("/memory/conversations/:conversationId/steps", async (c) => {
-    const session = await props.sessionStore.getSession(c.req.param("conversationId"));
+    const session = await sessionStore.getSession(c.req.param("conversationId"));
     if (session === void 0) {
       return errorResponse(c, 404, "not_found", "Conversation not found");
     }
@@ -4455,6 +4579,149 @@ function registerMemoryRoutes(app, props) {
     });
   });
 }
+function agentMemorySource(ref, label, agentId, storeKindValue, inspector) {
+  const summary = {
+    ref,
+    kind: "agent",
+    label,
+    agentIds: [agentId],
+    available: true
+  };
+  if (storeKindValue !== void 0) summary.storeKind = storeKindValue;
+  return {
+    summary,
+    async listConversations(options) {
+      const inspectorOptions = {
+        limit: options.userId === DEFAULT_USER_ID ? USER_DISCOVERY_LIMIT : options.limit
+      };
+      if (options.userId !== void 0 && options.userId !== DEFAULT_USER_ID) {
+        inspectorOptions.userId = options.userId;
+      }
+      const conversations = await inspector.listConversations(inspectorOptions);
+      return conversations.map((conversation) => sourceConversationSummary(conversation, summary.agentIds)).filter(
+        (conversation) => options.userId === void 0 || conversation.userId === options.userId
+      ).slice(0, options.limit);
+    },
+    async getConversation(conversationRef) {
+      const conversation = await inspector.getConversation(conversationRef);
+      return conversation === void 0 ? void 0 : inspectorConversationDetail(conversation, summary.agentIds);
+    }
+  };
+}
+function unavailableAgentSource(ref, label, agentId, storeKindValue) {
+  const summary = {
+    ref,
+    kind: "agent",
+    label,
+    agentIds: [agentId],
+    available: false,
+    reason: "This memory store does not expose the optional inspector capability."
+  };
+  if (storeKindValue !== void 0) summary.storeKind = storeKindValue;
+  return {
+    summary,
+    listConversations: async () => [],
+    getConversation: async () => void 0
+  };
+}
+function studioSessionSource(sessionStore, agentIds) {
+  const summary = {
+    ref: "studio-sessions",
+    kind: "studio",
+    label: "Studio sessions",
+    agentIds: [...agentIds],
+    available: true,
+    storeKind: sessionStore.kind ?? "studio"
+  };
+  const allowedAgents = new Set(agentIds);
+  const restrictAgents = allowedAgents.size > 0;
+  return {
+    summary,
+    async listConversations(options) {
+      const sessions = await sessionStore.listSessions({ limit: USER_DISCOVERY_LIMIT });
+      return sessions.filter((session) => !restrictAgents || allowedAgents.has(session.agentId)).map(studioSourceConversationSummary).filter(
+        (conversation) => options.userId === void 0 || conversation.userId === options.userId
+      ).slice(0, options.limit);
+    },
+    async getConversation(conversationRef) {
+      const session = await sessionStore.getSession(conversationRef);
+      if (session === void 0 || restrictAgents && !allowedAgents.has(session.agentId)) {
+        return void 0;
+      }
+      return {
+        conversation: studioSourceConversationSummary(session),
+        records: session.messages.map((message, position) => ({
+          position,
+          runId: "studio-session",
+          turn: 0,
+          createdAt: session.updatedAt,
+          message
+        }))
+      };
+    }
+  };
+}
+function sourceConversationSummary(conversation, agentIds) {
+  const summary = {
+    ref: conversation.ref,
+    sessionId: conversation.sessionId,
+    userId: conversation.userId ?? DEFAULT_USER_ID,
+    agentIds: [...agentIds],
+    createdAt: conversation.createdAt,
+    updatedAt: conversation.updatedAt,
+    messageCount: conversation.messageCount
+  };
+  if (conversation.metadata !== void 0) summary.metadata = conversation.metadata;
+  return summary;
+}
+function inspectorConversationDetail(conversation, agentIds) {
+  return {
+    conversation: sourceConversationSummary(conversation, agentIds),
+    records: conversation.messages
+  };
+}
+function studioSourceConversationSummary(session) {
+  const summary = {
+    ref: session.id,
+    sessionId: session.id,
+    userId: sessionUserId(session),
+    agentIds: [session.agentId],
+    createdAt: session.createdAt,
+    updatedAt: session.updatedAt,
+    messageCount: session.messageCount
+  };
+  if (session.title !== void 0) summary.title = session.title;
+  if (session.metadata !== void 0) summary.metadata = session.metadata;
+  return summary;
+}
+function memoryUsers(conversations, limit) {
+  const users = /* @__PURE__ */ new Map();
+  for (const conversation of conversations) {
+    const existing = users.get(conversation.userId);
+    if (existing === void 0) {
+      users.set(conversation.userId, {
+        userId: conversation.userId,
+        conversationCount: 1,
+        agentIds: [...conversation.agentIds],
+        lastInteractionAt: conversation.updatedAt
+      });
+      continue;
+    }
+    existing.conversationCount += 1;
+    for (const agentId of conversation.agentIds) {
+      if (!existing.agentIds.includes(agentId)) existing.agentIds.push(agentId);
+    }
+    if (new Date(conversation.updatedAt).getTime() > new Date(existing.lastInteractionAt).getTime()) {
+      existing.lastInteractionAt = conversation.updatedAt;
+    }
+  }
+  return {
+    users: [...users.values()].sort(
+      (left, right) => new Date(right.lastInteractionAt).getTime() - new Date(left.lastInteractionAt).getTime()
+    ).slice(0, limit),
+    total: users.size
+  };
+}
 function memoryConversationSummary(session) {
   const summary = {
     id: session.id,
@@ -4472,6 +4739,19 @@ function sessionUserId(session) {
   const userId = session.metadata?.userId;
   return typeof userId === "string" && userId.trim().length > 0 ? userId : DEFAULT_USER_ID;
 }
+function storeKind(store) {
+  const kind = store.kind;
+  return typeof kind === "string" && kind.length > 0 ? kind : void 0;
+}
+function unavailableSourceResponse(c, source) {
+  return errorResponse(
+    c,
+    501,
+    "unsupported_capability",
+    source.reason ?? "Memory source is not inspectable",
+    { sourceRef: source.ref }
+  );
+}
 
 // src/runtime/pipeline-logs.ts
 async function appendPipelineLog(store, input) {
@@ -6609,6 +6889,7 @@ function createStudioApp(options) {
   const approvalRuntime = createApprovalRuntime();
   const questionRuntime = createQuestionRuntime();
   const sandboxRegistry = createStudioSandboxRegistry(agents);
+  const memorySources = createStudioMemorySourceRegistry(agents, stores.sessions);
   const app = new HonoApp();
   const uiOptions = isStudioUiEnabled(options.ui) ? resolveStudioUiOptions(options.ui) : void 0;
   if (uiOptions !== void 0 && !uiOptions.protectShell) {
@@ -6682,10 +6963,13 @@ function createStudioApp(options) {
     approvalRuntime,
     questionRuntime
   });
-  if (stores.sessions !== void 0) {
+  if (memorySources.size > 0 || stores.sessions !== void 0) {
     registerMemoryRoutes(app, {
+      sources: memorySources,
       sessionStore: stores.sessions
     });
+  }
+  if (stores.sessions !== void 0) {
     const sessionOptions = {
       agentMap,
       sessionStore: stores.sessions