@mastra/server 1.51.0-alpha.6 → 1.51.0-alpha.7

package/dist/{chunk-VTA32BYJ.cjs → chunk-D43AYAW2.cjs}

@@ -15,15 +15,19 @@ function getAgentControllerOrThrow(mastra, controllerId) {
   }
   return controller;
 }
-async function getSession(controller, resourceId, tags) {
+async function getSession(controller, resourceId, options) {
   await controller.init();
-  return controller.createSession({ resourceId, id: resourceId, ownerId: controller.id, tags });
+  const { tags, scope } = options ?? {};
+  const id = scope ? `${resourceId}::${scope}` : resourceId;
+  return controller.createSession({ resourceId, id, ownerId: controller.id, tags, scope });
 }
 var controllerIdPathParams = v4.z.object({ controllerId: v4.z.string() });
 var sessionPathParams = v4.z.object({ controllerId: v4.z.string(), resourceId: v4.z.string() });
+var sessionScopeQuerySchema = v4.z.object({ sessionScope: v4.z.string().optional() });
 var createSessionBodySchema = v4.z.object({
   resourceId: v4.z.string(),
-  tags: v4.z.record(v4.z.string(), v4.z.string()).optional()
+  tags: v4.z.record(v4.z.string(), v4.z.string()).optional(),
+  sessionScope: v4.z.string().optional()
 });
 var sendMessageBodySchema = v4.z.object({ message: v4.z.string() });
 var steerBodySchema = v4.z.object({ message: v4.z.string() });
@@ -52,9 +56,10 @@ var cloneThreadBodySchema = v4.z.object({
   sourceThreadId: v4.z.string().optional(),
   title: v4.z.string().optional()
 });
-var listMessagesQuerySchema = v4.z.object({ limit: v4.z.coerce.number().optional() });
+var listMessagesQuerySchema = v4.z.object({ limit: v4.z.coerce.number().optional(), sessionScope: v4.z.string().optional() });
 var listThreadsQuerySchema = v4.z.object({
   limit: v4.z.coerce.number().optional(),
+  sessionScope: v4.z.string().optional(),
   tags: v4.z.preprocess((value) => {
     if (typeof value !== "string" || value.length === 0) return void 0;
     try {
@@ -111,6 +116,8 @@ var sessionStateResponseSchema = v4.z.object({
   threadId: v4.z.string().optional(),
   modeId: v4.z.string(),
   modelId: v4.z.string(),
+  /** Whether the agent is currently executing a run (for initial UI hydration). */
+  running: v4.z.boolean().optional(),
   omProgress: omProgressSummarySchema.optional(),
   tokenUsage: v4.z.record(v4.z.string(), v4.z.unknown()).optional(),
   settings: sessionSettingsSchema.optional()
@@ -125,7 +132,9 @@ var listThreadsResponseSchema = v4.z.object({
       title: v4.z.string().optional(),
       updatedAt: v4.z.string().optional(),
       /** The session scoping tags stamped on this thread (e.g. `{ projectPath }`). */
-      tags: v4.z.record(v4.z.string(), v4.z.string()).optional()
+      tags: v4.z.record(v4.z.string(), v4.z.string()).optional(),
+      /** Whether a run is currently executing on this thread ('active') or not ('idle'). */
+      state: v4.z.enum(["active", "idle"]).optional()
     })
   )
 });
@@ -215,10 +224,10 @@ var CREATE_AGENT_CONTROLLER_SESSION_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   tags: ["AgentController"],
   requiresAuth: true,
   requiresPermission: "agent-controller:execute",
-  handler: async ({ mastra, controllerId, resourceId, tags }) => {
+  handler: async ({ mastra, controllerId, resourceId, sessionScope, tags }) => {
     try {
       const controller = getAgentControllerOrThrow(mastra, controllerId);
-      const session = await getSession(controller, resourceId, tags);
+      const session = await getSession(controller, resourceId, { tags, scope: sessionScope });
       return {
         controllerId,
         resourceId,
@@ -243,15 +252,16 @@ var STREAM_AGENT_CONTROLLER_SESSION_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   streamFormat: "sse",
   sseFlushOnConnect: true,
   pathParamSchema: sessionPathParams,
+  queryParamSchema: sessionScopeQuerySchema,
   summary: "Stream controller session events",
   description: "Subscribes to a session\u2019s event bus and streams events to the client over SSE.",
   tags: ["AgentController", "Streaming"],
   requiresAuth: true,
   requiresPermission: "agent-controller:read",
-  handler: async ({ mastra, controllerId, resourceId, abortSignal }) => {
+  handler: async ({ mastra, controllerId, resourceId, sessionScope, abortSignal }) => {
     try {
       const controller = getAgentControllerOrThrow(mastra, controllerId);
-      const session = await getSession(controller, resourceId);
+      const session = await getSession(controller, resourceId, { scope: sessionScope });
       let cleanedUp = false;
       let heartbeat;
       let unsubscribe;
@@ -317,6 +327,7 @@ var SEND_AGENT_CONTROLLER_MESSAGE_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   path: "/agent-controller/:controllerId/sessions/:resourceId/messages",
   responseType: "json",
   pathParamSchema: sessionPathParams,
+  queryParamSchema: sessionScopeQuerySchema,
   bodySchema: sendMessageBodySchema,
   responseSchema: ackResponseSchema,
   summary: "Send a message to a controller session",
@@ -324,10 +335,10 @@ var SEND_AGENT_CONTROLLER_MESSAGE_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   tags: ["AgentController", "Streaming"],
   requiresAuth: true,
   requiresPermission: "agent-controller:execute",
-  handler: async ({ mastra, controllerId, resourceId, message, requestContext }) => {
+  handler: async ({ mastra, controllerId, resourceId, sessionScope, message, requestContext }) => {
     try {
       const controller = getAgentControllerOrThrow(mastra, controllerId);
-      const session = await getSession(controller, resourceId);
+      const session = await getSession(controller, resourceId, { scope: sessionScope });
       void session.sendMessage({ content: message, requestContext });
       return { ok: true };
     } catch (error) {
@@ -340,16 +351,17 @@ var ABORT_AGENT_CONTROLLER_SESSION_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   path: "/agent-controller/:controllerId/sessions/:resourceId/abort",
   responseType: "json",
   pathParamSchema: sessionPathParams,
+  queryParamSchema: sessionScopeQuerySchema,
   responseSchema: ackResponseSchema,
   summary: "Abort a controller session run",
   description: "Aborts the in-flight run for the session, if any.",
   tags: ["AgentController"],
   requiresAuth: true,
   requiresPermission: "agent-controller:execute",
-  handler: async ({ mastra, controllerId, resourceId }) => {
+  handler: async ({ mastra, controllerId, resourceId, sessionScope }) => {
     try {
       const controller = getAgentControllerOrThrow(mastra, controllerId);
-      const session = await getSession(controller, resourceId);
+      const session = await getSession(controller, resourceId, { scope: sessionScope });
       session.abort();
       return { ok: true };
     } catch (error) {
@@ -362,6 +374,7 @@ var AGENT_CONTROLLER_TOOL_APPROVAL_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   path: "/agent-controller/:controllerId/sessions/:resourceId/tool-approval",
   responseType: "json",
   pathParamSchema: sessionPathParams,
+  queryParamSchema: sessionScopeQuerySchema,
   bodySchema: toolApprovalBodySchema,
   responseSchema: ackResponseSchema,
   summary: "Respond to a controller tool approval",
@@ -369,10 +382,10 @@ var AGENT_CONTROLLER_TOOL_APPROVAL_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   tags: ["AgentController"],
   requiresAuth: true,
   requiresPermission: "agent-controller:execute",
-  handler: async ({ mastra, controllerId, resourceId, toolCallId, approved, requestContext }) => {
+  handler: async ({ mastra, controllerId, resourceId, sessionScope, toolCallId, approved, requestContext }) => {
     try {
       const controller = getAgentControllerOrThrow(mastra, controllerId);
-      const session = await getSession(controller, resourceId);
+      const session = await getSession(controller, resourceId, { scope: sessionScope });
       session.respondToToolApproval({ toolCallId, decision: approved ? "approve" : "decline", requestContext });
       return { ok: true };
     } catch (error) {
@@ -385,6 +398,7 @@ var AGENT_CONTROLLER_TOOL_SUSPENSION_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   path: "/agent-controller/:controllerId/sessions/:resourceId/tool-suspension",
   responseType: "json",
   pathParamSchema: sessionPathParams,
+  queryParamSchema: sessionScopeQuerySchema,
   bodySchema: toolSuspensionBodySchema,
   responseSchema: ackResponseSchema,
   summary: "Respond to a suspended controller tool",
@@ -392,10 +406,10 @@ var AGENT_CONTROLLER_TOOL_SUSPENSION_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   tags: ["AgentController"],
   requiresAuth: true,
   requiresPermission: "agent-controller:execute",
-  handler: async ({ mastra, controllerId, resourceId, toolCallId, resumeData, requestContext }) => {
+  handler: async ({ mastra, controllerId, resourceId, sessionScope, toolCallId, resumeData, requestContext }) => {
     try {
       const controller = getAgentControllerOrThrow(mastra, controllerId);
-      const session = await getSession(controller, resourceId);
+      const session = await getSession(controller, resourceId, { scope: sessionScope });
       await session.respondToToolSuspension({ toolCallId, resumeData, requestContext });
       return { ok: true };
     } catch (error) {
@@ -408,6 +422,7 @@ var STEER_AGENT_CONTROLLER_SESSION_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   path: "/agent-controller/:controllerId/sessions/:resourceId/steer",
   responseType: "json",
   pathParamSchema: sessionPathParams,
+  queryParamSchema: sessionScopeQuerySchema,
   bodySchema: steerBodySchema,
   responseSchema: ackResponseSchema,
   summary: "Steer the in-flight run",
@@ -415,10 +430,10 @@ var STEER_AGENT_CONTROLLER_SESSION_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   tags: ["AgentController"],
   requiresAuth: true,
   requiresPermission: "agent-controller:execute",
-  handler: async ({ mastra, controllerId, resourceId, message, requestContext }) => {
+  handler: async ({ mastra, controllerId, resourceId, sessionScope, message, requestContext }) => {
     try {
       const controller = getAgentControllerOrThrow(mastra, controllerId);
-      const session = await getSession(controller, resourceId);
+      const session = await getSession(controller, resourceId, { scope: sessionScope });
       void session.steer({ content: message, requestContext });
       return { ok: true };
     } catch (error) {
@@ -431,6 +446,7 @@ var SWITCH_AGENT_CONTROLLER_MODE_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   path: "/agent-controller/:controllerId/sessions/:resourceId/mode",
   responseType: "json",
   pathParamSchema: sessionPathParams,
+  queryParamSchema: sessionScopeQuerySchema,
   bodySchema: switchModeBodySchema,
   responseSchema: ackResponseSchema,
   summary: "Switch the session mode",
@@ -438,10 +454,10 @@ var SWITCH_AGENT_CONTROLLER_MODE_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   tags: ["AgentController"],
   requiresAuth: true,
   requiresPermission: "agent-controller:execute",
-  handler: async ({ mastra, controllerId, resourceId, modeId }) => {
+  handler: async ({ mastra, controllerId, resourceId, sessionScope, modeId }) => {
     try {
       const controller = getAgentControllerOrThrow(mastra, controllerId);
-      const session = await getSession(controller, resourceId);
+      const session = await getSession(controller, resourceId, { scope: sessionScope });
       await session.mode.switch({ modeId });
       return { ok: true };
     } catch (error) {
@@ -454,6 +470,7 @@ var SWITCH_AGENT_CONTROLLER_MODEL_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   path: "/agent-controller/:controllerId/sessions/:resourceId/model",
   responseType: "json",
   pathParamSchema: sessionPathParams,
+  queryParamSchema: sessionScopeQuerySchema,
   bodySchema: switchModelBodySchema,
   responseSchema: ackResponseSchema,
   summary: "Switch the session model",
@@ -461,10 +478,10 @@ var SWITCH_AGENT_CONTROLLER_MODEL_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   tags: ["AgentController"],
   requiresAuth: true,
   requiresPermission: "agent-controller:execute",
-  handler: async ({ mastra, controllerId, resourceId, modelId, scope, modeId }) => {
+  handler: async ({ mastra, controllerId, resourceId, sessionScope, modelId, scope, modeId }) => {
     try {
       const controller = getAgentControllerOrThrow(mastra, controllerId);
-      const session = await getSession(controller, resourceId);
+      const session = await getSession(controller, resourceId, { scope: sessionScope });
       await session.model.switch({ modelId, scope, modeId });
       return { ok: true };
     } catch (error) {
@@ -477,6 +494,7 @@ var SWITCH_AGENT_CONTROLLER_THREAD_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   path: "/agent-controller/:controllerId/sessions/:resourceId/thread",
   responseType: "json",
   pathParamSchema: sessionPathParams,
+  queryParamSchema: sessionScopeQuerySchema,
   bodySchema: switchThreadBodySchema,
   responseSchema: ackResponseSchema,
   summary: "Switch the session thread",
@@ -484,10 +502,10 @@ var SWITCH_AGENT_CONTROLLER_THREAD_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   tags: ["AgentController"],
   requiresAuth: true,
   requiresPermission: "agent-controller:execute",
-  handler: async ({ mastra, controllerId, resourceId, threadId }) => {
+  handler: async ({ mastra, controllerId, resourceId, sessionScope, threadId }) => {
     try {
       const controller = getAgentControllerOrThrow(mastra, controllerId);
-      const session = await getSession(controller, resourceId);
+      const session = await getSession(controller, resourceId, { scope: sessionScope });
       await session.thread.switch({ threadId });
       return { ok: true };
     } catch (error) {
@@ -500,16 +518,17 @@ var GET_AGENT_CONTROLLER_SESSION_STATE_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   path: "/agent-controller/:controllerId/sessions/:resourceId",
   responseType: "json",
   pathParamSchema: sessionPathParams,
+  queryParamSchema: sessionScopeQuerySchema,
   responseSchema: sessionStateResponseSchema,
   summary: "Get session state",
   description: "Returns the current mode, model, and thread for the session (for initial UI hydration).",
   tags: ["AgentController"],
   requiresAuth: true,
   requiresPermission: "agent-controller:read",
-  handler: async ({ mastra, controllerId, resourceId }) => {
+  handler: async ({ mastra, controllerId, resourceId, sessionScope }) => {
     try {
       const controller = getAgentControllerOrThrow(mastra, controllerId);
-      const session = await getSession(controller, resourceId);
+      const session = await getSession(controller, resourceId, { scope: sessionScope });
       const ds = session.displayState.get();
       const om = ds.omProgress;
       const reflectionSavings = om.buffered.reflection.inputObservationTokens - om.buffered.reflection.observationTokens;
@@ -521,6 +540,7 @@ var GET_AGENT_CONTROLLER_SESSION_STATE_ROUTE = chunk7YBYLB2K_cjs.createRoute({
         threadId: session.thread.getId() ?? void 0,
         modeId: session.mode.get(),
         modelId: session.model.get(),
+        running: ds.isRunning === true,
         omProgress: {
           status: om.status,
           pendingTokens: om.pendingTokens,
@@ -579,10 +599,10 @@ var LIST_AGENT_CONTROLLER_THREADS_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   tags: ["AgentController"],
   requiresAuth: true,
   requiresPermission: "agent-controller:read",
-  handler: async ({ mastra, controllerId, resourceId, limit, tags }) => {
+  handler: async ({ mastra, controllerId, resourceId, sessionScope, limit, tags }) => {
     try {
       const controller = getAgentControllerOrThrow(mastra, controllerId);
-      const session = await getSession(controller, resourceId);
+      const session = await getSession(controller, resourceId, { scope: sessionScope });
       const threads = await session.thread.list();
       const getTags = (t) => {
         const metadata = t.metadata ?? {};
@@ -601,6 +621,7 @@ var LIST_AGENT_CONTROLLER_THREADS_ROUTE = chunk7YBYLB2K_cjs.createRoute({
       const sorted = [...scoped].sort((a, b) => toTime(b) - toTime(a));
       const max = Number(limit);
       const limited = Number.isFinite(max) && max > 0 ? sorted.slice(0, max) : sorted;
+      const agent = controller.getCurrentAgent(session);
       return {
         threads: limited.map((t) => {
           const threadTags = getTags(t);
@@ -608,7 +629,8 @@ var LIST_AGENT_CONTROLLER_THREADS_ROUTE = chunk7YBYLB2K_cjs.createRoute({
             id: t.id,
             title: t.title,
             tags: Object.keys(threadTags).length > 0 ? threadTags : void 0,
-            updatedAt: t.updatedAt instanceof Date ? t.updatedAt.toISOString() : void 0
+            updatedAt: t.updatedAt instanceof Date ? t.updatedAt.toISOString() : void 0,
+            state: agent.getActiveThreadRunId({ resourceId, threadId: t.id }) ? "active" : "idle"
           };
         })
       };
@@ -622,6 +644,7 @@ var SEND_AGENT_CONTROLLER_NOTIFICATION_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   path: "/agent-controller/:controllerId/sessions/:resourceId/notifications",
   responseType: "json",
   pathParamSchema: sessionPathParams,
+  queryParamSchema: sessionScopeQuerySchema,
   bodySchema: sendNotificationBodySchema,
   responseSchema: v4.z.object({
     accepted: v4.z.boolean(),
@@ -638,6 +661,7 @@ var SEND_AGENT_CONTROLLER_NOTIFICATION_ROUTE = chunk7YBYLB2K_cjs.createRoute({
     mastra,
     controllerId,
     resourceId,
+    sessionScope,
     source,
     kind,
     summary,
@@ -651,7 +675,7 @@ var SEND_AGENT_CONTROLLER_NOTIFICATION_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   }) => {
     try {
       const controller = getAgentControllerOrThrow(mastra, controllerId);
-      const session = await getSession(controller, resourceId);
+      const session = await getSession(controller, resourceId, { scope: sessionScope });
       const result = await session.sendNotificationSignal({
         source,
         kind,
@@ -680,6 +704,7 @@ var CREATE_AGENT_CONTROLLER_THREAD_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   path: "/agent-controller/:controllerId/sessions/:resourceId/threads",
   responseType: "json",
   pathParamSchema: sessionPathParams,
+  queryParamSchema: sessionScopeQuerySchema,
   bodySchema: createThreadBodySchema,
   responseSchema: threadResponseSchema,
   summary: "Create a new thread",
@@ -687,10 +712,10 @@ var CREATE_AGENT_CONTROLLER_THREAD_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   tags: ["AgentController", "Threads"],
   requiresAuth: true,
   requiresPermission: "agent-controller:execute",
-  handler: async ({ mastra, controllerId, resourceId, title }) => {
+  handler: async ({ mastra, controllerId, resourceId, sessionScope, title }) => {
     try {
       const controller = getAgentControllerOrThrow(mastra, controllerId);
-      const session = await getSession(controller, resourceId);
+      const session = await getSession(controller, resourceId, { scope: sessionScope });
       const thread = await session.thread.create({ title });
       return {
         id: thread.id,
@@ -709,16 +734,17 @@ var DELETE_AGENT_CONTROLLER_THREAD_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   path: "/agent-controller/:controllerId/sessions/:resourceId/threads/:threadId",
   responseType: "json",
   pathParamSchema: threadPathParams,
+  queryParamSchema: sessionScopeQuerySchema,
   responseSchema: ackResponseSchema,
   summary: "Delete a thread",
   description: "Deletes a thread. If the deleted thread is the active one, the session is unbound.",
   tags: ["AgentController", "Threads"],
   requiresAuth: true,
   requiresPermission: "agent-controller:execute",
-  handler: async ({ mastra, controllerId, resourceId, threadId }) => {
+  handler: async ({ mastra, controllerId, resourceId, sessionScope, threadId }) => {
     try {
       const controller = getAgentControllerOrThrow(mastra, controllerId);
-      const session = await getSession(controller, resourceId);
+      const session = await getSession(controller, resourceId, { scope: sessionScope });
       await session.thread.delete({ threadId });
       return { ok: true };
     } catch (error) {
@@ -731,6 +757,7 @@ var RENAME_AGENT_CONTROLLER_THREAD_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   path: "/agent-controller/:controllerId/sessions/:resourceId/threads/:threadId",
   responseType: "json",
   pathParamSchema: threadPathParams,
+  queryParamSchema: sessionScopeQuerySchema,
   bodySchema: renameThreadBodySchema,
   responseSchema: ackResponseSchema,
   summary: "Rename a thread",
@@ -738,10 +765,10 @@ var RENAME_AGENT_CONTROLLER_THREAD_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   tags: ["AgentController", "Threads"],
   requiresAuth: true,
   requiresPermission: "agent-controller:execute",
-  handler: async ({ mastra, controllerId, resourceId, threadId, title }) => {
+  handler: async ({ mastra, controllerId, resourceId, sessionScope, threadId, title }) => {
     try {
       const controller = getAgentControllerOrThrow(mastra, controllerId);
-      const session = await getSession(controller, resourceId);
+      const session = await getSession(controller, resourceId, { scope: sessionScope });
       if (session.thread.getId() !== threadId) {
         await session.thread.switch({ threadId });
       }
@@ -757,6 +784,7 @@ var CLONE_AGENT_CONTROLLER_THREAD_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   path: "/agent-controller/:controllerId/sessions/:resourceId/threads/clone",
   responseType: "json",
   pathParamSchema: sessionPathParams,
+  queryParamSchema: sessionScopeQuerySchema,
   bodySchema: cloneThreadBodySchema,
   responseSchema: threadResponseSchema,
   summary: "Clone a thread",
@@ -764,10 +792,10 @@ var CLONE_AGENT_CONTROLLER_THREAD_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   tags: ["AgentController", "Threads"],
   requiresAuth: true,
   requiresPermission: "agent-controller:execute",
-  handler: async ({ mastra, controllerId, resourceId, sourceThreadId, title }) => {
+  handler: async ({ mastra, controllerId, resourceId, sessionScope, sourceThreadId, title }) => {
     try {
       const controller = getAgentControllerOrThrow(mastra, controllerId);
-      const session = await getSession(controller, resourceId);
+      const session = await getSession(controller, resourceId, { scope: sessionScope });
       const thread = await session.thread.clone({ sourceThreadId, title });
       return {
         id: thread.id,
@@ -793,10 +821,10 @@ var LIST_AGENT_CONTROLLER_THREAD_MESSAGES_ROUTE = chunk7YBYLB2K_cjs.createRoute(
   tags: ["AgentController", "Threads"],
   requiresAuth: true,
   requiresPermission: "agent-controller:read",
-  handler: async ({ mastra, controllerId, resourceId, threadId, limit }) => {
+  handler: async ({ mastra, controllerId, resourceId, sessionScope, threadId, limit }) => {
     try {
       const controller = getAgentControllerOrThrow(mastra, controllerId);
-      const session = await getSession(controller, resourceId);
+      const session = await getSession(controller, resourceId, { scope: sessionScope });
       const messages = await session.thread.listMessages({ threadId, limit });
       return {
         messages: messages.map((m) => ({
@@ -816,6 +844,7 @@ var FOLLOW_UP_AGENT_CONTROLLER_SESSION_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   path: "/agent-controller/:controllerId/sessions/:resourceId/follow-up",
   responseType: "json",
   pathParamSchema: sessionPathParams,
+  queryParamSchema: sessionScopeQuerySchema,
   bodySchema: followUpBodySchema,
   responseSchema: ackResponseSchema,
   summary: "Queue a follow-up message",
@@ -823,10 +852,10 @@ var FOLLOW_UP_AGENT_CONTROLLER_SESSION_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   tags: ["AgentController"],
   requiresAuth: true,
   requiresPermission: "agent-controller:execute",
-  handler: async ({ mastra, controllerId, resourceId, message, requestContext }) => {
+  handler: async ({ mastra, controllerId, resourceId, sessionScope, message, requestContext }) => {
     try {
       const controller = getAgentControllerOrThrow(mastra, controllerId);
-      const session = await getSession(controller, resourceId);
+      const session = await getSession(controller, resourceId, { scope: sessionScope });
       void session.followUp({ content: message, requestContext });
       return { ok: true };
     } catch (error) {
@@ -893,16 +922,17 @@ var GET_AGENT_CONTROLLER_OM_RECORD_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   path: "/agent-controller/:controllerId/sessions/:resourceId/om",
   responseType: "json",
   pathParamSchema: sessionPathParams,
+  queryParamSchema: sessionScopeQuerySchema,
   responseSchema: omRecordResponseSchema,
   summary: "Get observational memory record",
   description: "Returns the current observational memory record for the session\u2019s thread/resource.",
   tags: ["AgentController"],
   requiresAuth: true,
   requiresPermission: "agent-controller:read",
-  handler: async ({ mastra, controllerId, resourceId }) => {
+  handler: async ({ mastra, controllerId, resourceId, sessionScope }) => {
     try {
       const controller = getAgentControllerOrThrow(mastra, controllerId);
-      const session = await getSession(controller, resourceId);
+      const session = await getSession(controller, resourceId, { scope: sessionScope });
       const record = await controller.getObservationalMemoryRecord(session);
       return { record: record ?? void 0 };
     } catch (error) {
@@ -915,6 +945,7 @@ var SET_AGENT_CONTROLLER_RESOURCE_ID_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   path: "/agent-controller/:controllerId/sessions/:resourceId/resource",
   responseType: "json",
   pathParamSchema: sessionPathParams,
+  queryParamSchema: sessionScopeQuerySchema,
   bodySchema: v4.z.object({ newResourceId: v4.z.string() }),
   responseSchema: ackResponseSchema,
   summary: "Change the session resource ID",
@@ -922,10 +953,10 @@ var SET_AGENT_CONTROLLER_RESOURCE_ID_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   tags: ["AgentController"],
   requiresAuth: true,
   requiresPermission: "agent-controller:execute",
-  handler: async ({ mastra, controllerId, resourceId, newResourceId }) => {
+  handler: async ({ mastra, controllerId, resourceId, sessionScope, newResourceId }) => {
     try {
       const controller = getAgentControllerOrThrow(mastra, controllerId);
-      const session = await getSession(controller, resourceId);
+      const session = await getSession(controller, resourceId, { scope: sessionScope });
       await controller.setResourceId(session, { resourceId: newResourceId });
       return { ok: true };
     } catch (error) {
@@ -938,16 +969,17 @@ var GET_AGENT_CONTROLLER_RESOURCE_IDS_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   path: "/agent-controller/:controllerId/sessions/:resourceId/resources",
   responseType: "json",
   pathParamSchema: sessionPathParams,
+  queryParamSchema: sessionScopeQuerySchema,
   responseSchema: v4.z.object({ resourceIds: v4.z.array(v4.z.string()) }),
   summary: "Get known resource IDs",
   description: "Lists the resource IDs known to this session (from threads).",
   tags: ["AgentController"],
   requiresAuth: true,
   requiresPermission: "agent-controller:read",
-  handler: async ({ mastra, controllerId, resourceId }) => {
+  handler: async ({ mastra, controllerId, resourceId, sessionScope }) => {
     try {
       const controller = getAgentControllerOrThrow(mastra, controllerId);
-      const session = await getSession(controller, resourceId);
+      const session = await getSession(controller, resourceId, { scope: sessionScope });
       const resourceIds = await controller.getKnownResourceIds(session);
       return { resourceIds };
     } catch (error) {
@@ -985,16 +1017,17 @@ var GET_AGENT_CONTROLLER_GOAL_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   path: "/agent-controller/:controllerId/sessions/:resourceId/goal",
   responseType: "json",
   pathParamSchema: sessionPathParams,
+  queryParamSchema: sessionScopeQuerySchema,
   responseSchema: goalResponseSchema,
   summary: "Get the current goal",
   description: "Returns the active/paused/done goal objective for the session\u2019s thread, if any.",
   tags: ["AgentController", "Goals"],
   requiresAuth: true,
   requiresPermission: "agent-controller:read",
-  handler: async ({ mastra, controllerId, resourceId }) => {
+  handler: async ({ mastra, controllerId, resourceId, sessionScope }) => {
     try {
       const controller = getAgentControllerOrThrow(mastra, controllerId);
-      const session = await getSession(controller, resourceId);
+      const session = await getSession(controller, resourceId, { scope: sessionScope });
       const threadId = session.thread.getId();
       if (!threadId) return { goal: void 0 };
       const agent = getAgentForSession(controller, session);
@@ -1010,6 +1043,7 @@ var SET_AGENT_CONTROLLER_GOAL_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   path: "/agent-controller/:controllerId/sessions/:resourceId/goal",
   responseType: "json",
   pathParamSchema: sessionPathParams,
+  queryParamSchema: sessionScopeQuerySchema,
   bodySchema: setGoalBodySchema,
   responseSchema: goalResponseSchema,
   summary: "Set a goal",
@@ -1017,10 +1051,10 @@ var SET_AGENT_CONTROLLER_GOAL_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   tags: ["AgentController", "Goals"],
   requiresAuth: true,
   requiresPermission: "agent-controller:execute",
-  handler: async ({ mastra, controllerId, resourceId, objective, judgeModelId, maxRuns }) => {
+  handler: async ({ mastra, controllerId, resourceId, sessionScope, objective, judgeModelId, maxRuns }) => {
     try {
       const controller = getAgentControllerOrThrow(mastra, controllerId);
-      const session = await getSession(controller, resourceId);
+      const session = await getSession(controller, resourceId, { scope: sessionScope });
       const threadId = session.thread.getId();
       if (!threadId) throw new chunk64ITUOXI_cjs.HTTPException(400, { message: "session has no active thread" });
       const agent = getAgentForSession(controller, session);
@@ -1041,6 +1075,7 @@ var UPDATE_AGENT_CONTROLLER_GOAL_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   path: "/agent-controller/:controllerId/sessions/:resourceId/goal",
   responseType: "json",
   pathParamSchema: sessionPathParams,
+  queryParamSchema: sessionScopeQuerySchema,
   bodySchema: updateGoalBodySchema,
   responseSchema: goalResponseSchema,
   summary: "Update goal options",
@@ -1048,10 +1083,10 @@ var UPDATE_AGENT_CONTROLLER_GOAL_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   tags: ["AgentController", "Goals"],
   requiresAuth: true,
   requiresPermission: "agent-controller:execute",
-  handler: async ({ mastra, controllerId, resourceId, judgeModelId, maxRuns, status }) => {
+  handler: async ({ mastra, controllerId, resourceId, sessionScope, judgeModelId, maxRuns, status }) => {
     try {
       const controller = getAgentControllerOrThrow(mastra, controllerId);
-      const session = await getSession(controller, resourceId);
+      const session = await getSession(controller, resourceId, { scope: sessionScope });
       const threadId = session.thread.getId();
       if (!threadId) throw new chunk64ITUOXI_cjs.HTTPException(400, { message: "session has no active thread" });
       const agent = getAgentForSession(controller, session);
@@ -1072,16 +1107,17 @@ var CLEAR_AGENT_CONTROLLER_GOAL_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   path: "/agent-controller/:controllerId/sessions/:resourceId/goal",
   responseType: "json",
   pathParamSchema: sessionPathParams,
+  queryParamSchema: sessionScopeQuerySchema,
   responseSchema: ackResponseSchema,
   summary: "Clear the goal",
   description: "Removes the active goal from the session\u2019s thread.",
   tags: ["AgentController", "Goals"],
   requiresAuth: true,
   requiresPermission: "agent-controller:execute",
-  handler: async ({ mastra, controllerId, resourceId }) => {
+  handler: async ({ mastra, controllerId, resourceId, sessionScope }) => {
     try {
       const controller = getAgentControllerOrThrow(mastra, controllerId);
-      const session = await getSession(controller, resourceId);
+      const session = await getSession(controller, resourceId, { scope: sessionScope });
       const threadId = session.thread.getId();
       if (!threadId) throw new chunk64ITUOXI_cjs.HTTPException(400, { message: "session has no active thread" });
       const agent = getAgentForSession(controller, session);
@@ -1097,16 +1133,17 @@ var GET_AGENT_CONTROLLER_PERMISSIONS_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   path: "/agent-controller/:controllerId/sessions/:resourceId/permissions",
   responseType: "json",
   pathParamSchema: sessionPathParams,
+  queryParamSchema: sessionScopeQuerySchema,
   responseSchema: permissionRulesResponseSchema,
   summary: "Get permission rules",
   description: "Returns the current permission rules (per-category and per-tool policies) for the session.",
   tags: ["AgentController", "Permissions"],
   requiresAuth: true,
   requiresPermission: "agent-controller:read",
-  handler: async ({ mastra, controllerId, resourceId }) => {
+  handler: async ({ mastra, controllerId, resourceId, sessionScope }) => {
     try {
       const controller = getAgentControllerOrThrow(mastra, controllerId);
-      const session = await getSession(controller, resourceId);
+      const session = await getSession(controller, resourceId, { scope: sessionScope });
       const rules = session.permissions.getRules();
       return {
         categories: rules.categories,
@@ -1122,6 +1159,7 @@ var SET_AGENT_CONTROLLER_CATEGORY_PERMISSION_ROUTE = chunk7YBYLB2K_cjs.createRou
   path: "/agent-controller/:controllerId/sessions/:resourceId/permissions/category",
   responseType: "json",
   pathParamSchema: sessionPathParams,
+  queryParamSchema: sessionScopeQuerySchema,
   bodySchema: setCategoryPermissionBodySchema,
   responseSchema: ackResponseSchema,
   summary: "Set permission for a tool category",
@@ -1129,10 +1167,10 @@ var SET_AGENT_CONTROLLER_CATEGORY_PERMISSION_ROUTE = chunk7YBYLB2K_cjs.createRou
   tags: ["AgentController", "Permissions"],
   requiresAuth: true,
   requiresPermission: "agent-controller:execute",
-  handler: async ({ mastra, controllerId, resourceId, category, policy }) => {
+  handler: async ({ mastra, controllerId, resourceId, sessionScope, category, policy }) => {
     try {
       const controller = getAgentControllerOrThrow(mastra, controllerId);
-      const session = await getSession(controller, resourceId);
+      const session = await getSession(controller, resourceId, { scope: sessionScope });
       await session.permissions.setForCategory({ category, policy });
       return { ok: true };
     } catch (error) {
@@ -1145,6 +1183,7 @@ var SET_AGENT_CONTROLLER_TOOL_PERMISSION_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   path: "/agent-controller/:controllerId/sessions/:resourceId/permissions/tool",
   responseType: "json",
   pathParamSchema: sessionPathParams,
+  queryParamSchema: sessionScopeQuerySchema,
   bodySchema: setToolPermissionBodySchema,
   responseSchema: ackResponseSchema,
   summary: "Set permission for a specific tool",
@@ -1152,10 +1191,10 @@ var SET_AGENT_CONTROLLER_TOOL_PERMISSION_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   tags: ["AgentController", "Permissions"],
   requiresAuth: true,
   requiresPermission: "agent-controller:execute",
-  handler: async ({ mastra, controllerId, resourceId, toolName, policy }) => {
+  handler: async ({ mastra, controllerId, resourceId, sessionScope, toolName, policy }) => {
     try {
       const controller = getAgentControllerOrThrow(mastra, controllerId);
-      const session = await getSession(controller, resourceId);
+      const session = await getSession(controller, resourceId, { scope: sessionScope });
       await session.permissions.setForTool({ toolName, policy });
       return { ok: true };
     } catch (error) {
@@ -1169,6 +1208,7 @@ var SET_AGENT_CONTROLLER_SESSION_STATE_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   path: "/agent-controller/:controllerId/sessions/:resourceId/state",
   responseType: "json",
   pathParamSchema: sessionPathParams,
+  queryParamSchema: sessionScopeQuerySchema,
   bodySchema: setSessionStateBodySchema,
   responseSchema: ackResponseSchema,
   summary: "Set session state",
@@ -1176,10 +1216,10 @@ var SET_AGENT_CONTROLLER_SESSION_STATE_ROUTE = chunk7YBYLB2K_cjs.createRoute({
   tags: ["AgentController"],
   requiresAuth: true,
   requiresPermission: "agent-controller:execute",
-  handler: async ({ mastra, controllerId, resourceId, state }) => {
+  handler: async ({ mastra, controllerId, resourceId, sessionScope, state }) => {
     try {
       const controller = getAgentControllerOrThrow(mastra, controllerId);
-      const session = await getSession(controller, resourceId);
+      const session = await getSession(controller, resourceId, { scope: sessionScope });
       await session.state.set(state);
       return { ok: true };
     } catch (error) {
@@ -1222,5 +1262,5 @@ exports.SWITCH_AGENT_CONTROLLER_MODEL_ROUTE = SWITCH_AGENT_CONTROLLER_MODEL_ROUT
 exports.SWITCH_AGENT_CONTROLLER_MODE_ROUTE = SWITCH_AGENT_CONTROLLER_MODE_ROUTE;
 exports.SWITCH_AGENT_CONTROLLER_THREAD_ROUTE = SWITCH_AGENT_CONTROLLER_THREAD_ROUTE;
 exports.UPDATE_AGENT_CONTROLLER_GOAL_ROUTE = UPDATE_AGENT_CONTROLLER_GOAL_ROUTE;
-//# sourceMappingURL=chunk-VTA32BYJ.cjs.map
-//# sourceMappingURL=chunk-VTA32BYJ.cjs.map
+//# sourceMappingURL=chunk-D43AYAW2.cjs.map
+//# sourceMappingURL=chunk-D43AYAW2.cjs.map