@mastra/server 1.82.0-alpha.1 → 1.82.0-alpha.3

package/dist/background-tasks-Kcx2YtW0.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"background-tasks-Kcx2YtW0.cjs","names":["z","paginationNumber","getContextResourceId","HTTPException","createRoute"],"sources":["../src/server/schemas/background-tasks.ts","../src/server/handlers/background-tasks.ts"],"sourcesContent":["import { z } from 'zod';\nimport { paginationNumber } from './common';\n\nexport const backgroundTaskStatusSchema = z.enum([\n  'pending',\n  'running',\n  'suspended',\n  'completed',\n  'failed',\n  'cancelled',\n  'timed_out',\n]);\n\nexport const backgroundTaskStreamQuerySchema = z.object({\n  agentId: z.string().optional(),\n  runId: z.string().optional(),\n  threadId: z.string().optional(),\n  resourceId: z.string().optional(),\n  taskId: z.string().optional(),\n});\n\nexport const backgroundTaskDateColumnSchema = z.enum(['createdAt', 'startedAt', 'suspendedAt', 'completedAt']);\n\nexport const listBackgroundTasksQuerySchema = z.object({\n  agentId: z.string().optional(),\n  status: backgroundTaskStatusSchema.optional(),\n  runId: z.string().optional(),\n  threadId: z.string().optional(),\n  resourceId: z.string().optional(),\n  toolName: z.string().optional(),\n  toolCallId: z.string().optional(),\n  fromDate: z.coerce.date().optional(),\n  toDate: z.coerce.date().optional(),\n  dateFilterBy: backgroundTaskDateColumnSchema.optional(),\n  orderBy: backgroundTaskDateColumnSchema.optional(),\n  orderDirection: z.enum(['asc', 'desc']).optional(),\n  page: paginationNumber().optional(),\n  perPage: paginationNumber().optional(),\n});\n\nexport const backgroundTaskIdPathParams = z.object({\n  backgroundTaskId: z.string(),\n});\n\nexport const backgroundTaskResponseSchema = z.object({\n  id: z.string(),\n  status: backgroundTaskStatusSchema,\n  toolName: z.string(),\n  toolCallId: z.string(),\n  args: z.record(z.string(), z.unknown()),\n  agentId: z.string(),\n  threadId: z.string().optional(),\n  resourceId: z.string().optional(),\n  runId: z.string(),\n  result: z.unknown().optional(),\n  error: z.object({ message: z.string(), stack: z.string().optional() }).optional(),\n  createdAt: z.date(),\n  startedAt: z.date().optional(),\n  completedAt: z.date().optional(),\n  retryCount: z.number(),\n  maxRetries: z.number(),\n  timeoutMs: z.number(),\n  suspendPayload: z.unknown().optional(),\n});\n\nexport const listBackgroundTaskResponseSchema = z.object({\n  tasks: z.array(backgroundTaskResponseSchema),\n  total: z.number(),\n});\n\nexport const backgroundTaskStreamResponseSchema = z.unknown();\n","import { HTTPException } from '../http-exception';\nimport {\n  backgroundTaskResponseSchema,\n  backgroundTaskStreamQuerySchema,\n  backgroundTaskStreamResponseSchema,\n  listBackgroundTaskResponseSchema,\n  listBackgroundTasksQuerySchema,\n  backgroundTaskIdPathParams,\n} from '../schemas/background-tasks';\nimport { createRoute } from '../server-adapter/routes/route-builder';\nimport { getContextResourceId } from './utils';\n\n/**\n * Resolves the resource filter for a background-task request. A resource-scoped caller\n * is pinned to its own resource and may not request another one; a privileged caller\n * (no resource in the request context) keeps the client-provided filter.\n */\nfunction resolveResourceScope(\n  requestContext: Parameters<typeof getContextResourceId>[0],\n  clientResourceId: string | undefined,\n): { resourceId: string | undefined; scoped: boolean } {\n  const contextResourceId = getContextResourceId(requestContext);\n  if (contextResourceId === undefined) return { resourceId: clientResourceId, scoped: false };\n  // An empty resource id must not be mistaken for a privileged (unscoped) caller, and\n  // storage filters ignore empty strings, so it cannot be scoped safely either.\n  if (contextResourceId === '') {\n    throw new HTTPException(403, { message: 'Access denied: authenticated resourceId is empty' });\n  }\n  if (clientResourceId !== undefined && clientResourceId !== contextResourceId) {\n    throw new HTTPException(403, { message: 'Access denied: resourceId does not match the authenticated resource' });\n  }\n  return { resourceId: contextResourceId, scoped: true };\n}\n\nexport const BACKGROUND_TASK_STREAM_ROUTE = createRoute({\n  method: 'GET',\n  path: '/background-tasks/stream',\n  responseType: 'stream' as const,\n  streamFormat: 'sse' as const,\n  queryParamSchema: backgroundTaskStreamQuerySchema,\n  responseSchema: backgroundTaskStreamResponseSchema,\n  summary: 'Stream background task events via SSE',\n  description: 'Real-time Server-Sent Events stream of background task completion/failure events.',\n  tags: ['Background Tasks'],\n  requiresAuth: true,\n  handler: async ({\n    mastra,\n    agentId,\n    runId,\n    threadId,\n    resourceId: clientResourceId,\n    taskId,\n    abortSignal,\n    requestContext,\n  }) => {\n    const { resourceId, scoped } = resolveResourceScope(requestContext, clientResourceId);\n    const bgManager = mastra.backgroundTaskManager;\n    if (!bgManager) {\n      // Background tasks are not enabled — return an empty stream that stays\n      // open until the client disconnects. This avoids spamming the logs with\n      // false-positive errors when clients (e.g. the studio UI) optimistically\n      // subscribe to the stream.\n      return new ReadableStream({\n        start(controller) {\n          abortSignal?.addEventListener('abort', () => {\n            try {\n              controller.close();\n            } catch {\n              // Already closed\n            }\n          });\n        },\n      });\n    }\n\n    return bgManager.stream({ agentId, runId, threadId, resourceId, taskId, abortSignal, allResources: !scoped });\n  },\n});\n\nexport const LIST_BACKGROUND_TASKS_ROUTE = createRoute({\n  method: 'GET',\n  path: '/background-tasks',\n  responseType: 'json' as const,\n  queryParamSchema: listBackgroundTasksQuerySchema,\n  responseSchema: listBackgroundTaskResponseSchema,\n  summary: 'List background tasks',\n  description: 'Returns background tasks filtered by status, agent, run, etc.',\n  tags: ['Background Tasks'],\n  requiresAuth: true,\n  handler: async ({ mastra, requestContext, ...params }) => {\n    const { resourceId } = resolveResourceScope(requestContext, params.resourceId);\n    const bgManager = mastra.backgroundTaskManager;\n    if (!bgManager) {\n      // Background tasks not enabled — there are no tasks to return.\n      return { tasks: [], total: 0 };\n    }\n\n    return bgManager.listTasks({ ...params, resourceId });\n  },\n});\n\nexport const GET_BACKGROUND_TASK_ROUTE = createRoute({\n  method: 'GET',\n  path: '/background-tasks/:backgroundTaskId',\n  responseType: 'json' as const,\n  pathParamSchema: backgroundTaskIdPathParams,\n  responseSchema: backgroundTaskResponseSchema,\n  summary: 'Get a background task by ID',\n  description: 'Returns a background task by ID.',\n  tags: ['Background Tasks'],\n  requiresAuth: true,\n  handler: async ({ mastra, backgroundTaskId, requestContext }) => {\n    const { resourceId, scoped } = resolveResourceScope(requestContext, undefined);\n    const bgManager = mastra.backgroundTaskManager;\n    if (!bgManager) {\n      // Background tasks not enabled — the task can't exist.\n      throw new HTTPException(404, { message: 'Background task not found' });\n    }\n\n    const task = await bgManager.getTask(backgroundTaskId);\n    // Report another resource's task as missing so its existence is not disclosed.\n    if (!task || (scoped && task.resourceId !== resourceId)) {\n      throw new HTTPException(404, { message: 'Background task not found' });\n    }\n    return task;\n  },\n});\n"],"mappings":"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"}