@mastra/server 0.0.0-sidebar-window-undefined-fix-20251029233656 → 0.0.0-standard-schema-20260123120255

package/dist/chunk-D23WBCJ6.js

@@ -0,0 +1,227 @@
+import { zodToJsonSchema } from '@mastra/core/utils/zod-to-json';
+import { z } from 'zod';
+
+// src/server/server-adapter/openapi-utils.ts
+function generateRouteOpenAPI({
+  method,
+  path,
+  summary,
+  description,
+  tags = [],
+  pathParamSchema,
+  queryParamSchema,
+  bodySchema,
+  responseSchema,
+  deprecated
+}) {
+  const route = {
+    summary: summary || `${method} ${path}`,
+    description,
+    tags,
+    deprecated,
+    responses: {
+      200: {
+        description: "Successful response"
+      }
+    }
+  };
+  if (pathParamSchema || queryParamSchema) {
+    route.requestParams = {};
+    if (pathParamSchema) {
+      route.requestParams.path = pathParamSchema;
+    }
+    if (queryParamSchema) {
+      route.requestParams.query = queryParamSchema;
+    }
+  }
+  if (bodySchema) {
+    route.requestBody = {
+      content: {
+        "application/json": {
+          schema: bodySchema
+        }
+      }
+    };
+  }
+  if (responseSchema) {
+    route.responses[200] = {
+      description: "Successful response",
+      content: {
+        "application/json": {
+          schema: responseSchema
+        }
+      }
+    };
+  }
+  return route;
+}
+function convertZodToJsonSchema(spec) {
+  const converted = {
+    summary: spec.summary,
+    description: spec.description,
+    tags: spec.tags,
+    responses: {}
+  };
+  const parameters = [];
+  if (spec.requestParams?.path) {
+    const pathSchema = zodToJsonSchema(spec.requestParams.path, "openApi3", "none");
+    const properties = pathSchema.properties || {};
+    Object.entries(properties).forEach(([name, schema]) => {
+      parameters.push({
+        name,
+        in: "path",
+        required: true,
+        description: schema.description || `The ${name} parameter`,
+        schema
+      });
+    });
+  }
+  if (spec.requestParams?.query) {
+    const querySchema = zodToJsonSchema(spec.requestParams.query, "openApi3", "none");
+    const properties = querySchema.properties || {};
+    const required = querySchema.required || [];
+    Object.entries(properties).forEach(([name, schema]) => {
+      parameters.push({
+        name,
+        in: "query",
+        required: required.includes(name),
+        description: schema.description || `Query parameter: ${name}`,
+        schema
+      });
+    });
+  }
+  if (parameters.length > 0) {
+    converted.parameters = parameters;
+  }
+  if (spec.requestBody?.content?.["application/json"]?.schema) {
+    converted.requestBody = {
+      required: true,
+      content: {
+        "application/json": {
+          schema: zodToJsonSchema(spec.requestBody.content["application/json"].schema, "openApi3", "none")
+        }
+      }
+    };
+  }
+  Object.entries(spec.responses).forEach(([statusCode, response]) => {
+    converted.responses[statusCode] = {
+      description: response.description
+    };
+    if (response.content?.["application/json"]?.schema) {
+      converted.responses[statusCode].content = {
+        "application/json": {
+          schema: zodToJsonSchema(response.content["application/json"].schema, "openApi3", "none")
+        }
+      };
+    }
+  });
+  return converted;
+}
+function generateOpenAPIDocument(routes, info) {
+  const paths = {};
+  routes.forEach((route) => {
+    if (!route.openapi) return;
+    const openapiPath = route.path.replace(/:(\w+)/g, "{$1}");
+    if (!paths[openapiPath]) {
+      paths[openapiPath] = {};
+    }
+    paths[openapiPath][route.method.toLowerCase()] = convertZodToJsonSchema(route.openapi);
+  });
+  return {
+    openapi: "3.1.0",
+    info: {
+      title: info.title,
+      version: info.version,
+      description: info.description
+    },
+    paths
+  };
+}
+function pickParams(schema, params) {
+  const keys = Object.keys(schema.shape);
+  const result = {};
+  for (const key of keys) {
+    if (key in params) {
+      result[key] = params[key];
+    }
+  }
+  return result;
+}
+function jsonQueryParam(schema) {
+  return z.union([
+    schema,
+    // Already the expected type (non-string input)
+    z.string().transform((val, ctx) => {
+      try {
+        const parsed = JSON.parse(val);
+        const result = schema.safeParse(parsed);
+        if (!result.success) {
+          for (const issue of result.error.issues) {
+            ctx.addIssue({
+              code: z.ZodIssueCode.custom,
+              message: issue.message,
+              path: issue.path
+            });
+          }
+          return z.NEVER;
+        }
+        return result.data;
+      } catch (e) {
+        ctx.addIssue({
+          code: z.ZodIssueCode.custom,
+          message: `Invalid JSON: ${e instanceof Error ? e.message : "parse error"}`
+        });
+        return z.NEVER;
+      }
+    })
+  ]);
+}
+function getZodTypeName(schema) {
+  return schema?._def?.typeName;
+}
+function isComplexType(schema) {
+  let inner = schema;
+  let typeName = getZodTypeName(inner);
+  while (typeName === "ZodOptional" || typeName === "ZodNullable") {
+    inner = inner._def.innerType;
+    typeName = getZodTypeName(inner);
+  }
+  return typeName === "ZodArray" || typeName === "ZodRecord" || typeName === "ZodObject";
+}
+function wrapSchemaForQueryParams(schema) {
+  const newShape = {};
+  const shape = schema.shape;
+  for (const [key, fieldSchema] of Object.entries(shape)) {
+    if (isComplexType(fieldSchema)) {
+      newShape[key] = jsonQueryParam(fieldSchema);
+    } else {
+      newShape[key] = fieldSchema;
+    }
+  }
+  return z.object(newShape);
+}
+function createRoute(config) {
+  const { summary, description, tags, deprecated, requiresAuth, ...baseRoute } = config;
+  const openapi = config.method !== "ALL" ? generateRouteOpenAPI({
+    method: config.method,
+    path: config.path,
+    summary,
+    description,
+    tags,
+    pathParamSchema: config.pathParamSchema,
+    queryParamSchema: config.queryParamSchema,
+    bodySchema: config.bodySchema,
+    responseSchema: config.responseSchema,
+    deprecated
+  }) : void 0;
+  return {
+    ...baseRoute,
+    openapi,
+    deprecated,
+    requiresAuth
+  };
+}
+
+export { createRoute, generateOpenAPIDocument, jsonQueryParam, pickParams, wrapSchemaForQueryParams };
+//# sourceMappingURL=chunk-D23WBCJ6.js.map
+//# sourceMappingURL=chunk-D23WBCJ6.js.map

package/dist/chunk-D23WBCJ6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server/server-adapter/openapi-utils.ts","../src/server/server-adapter/routes/route-builder.ts"],"names":[],"mappings":"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","file":"chunk-D23WBCJ6.js","sourcesContent":["import { zodToJsonSchema } from '@mastra/core/utils/zod-to-json';\nimport type { ZodSchema } from 'zod';\nimport type { ServerRoute } from './routes';\n\ninterface RouteOpenAPIConfig {\n  method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';\n  path: string;\n  summary?: string;\n  description?: string;\n  tags?: string[];\n  pathParamSchema?: ZodSchema;\n  queryParamSchema?: ZodSchema;\n  bodySchema?: ZodSchema;\n  responseSchema?: ZodSchema;\n  deprecated?: boolean;\n}\n\ninterface OpenAPIRoute {\n  summary?: string;\n  description?: string;\n  tags?: string[];\n  deprecated?: boolean;\n  requestParams?: {\n    path?: ZodSchema;\n    query?: ZodSchema;\n  };\n  requestBody?: {\n    content: {\n      'application/json': {\n        schema: ZodSchema;\n      };\n    };\n  };\n  responses: {\n    [statusCode: string]: {\n      description: string;\n      content?: {\n        'application/json': {\n          schema: ZodSchema;\n        };\n      };\n    };\n  };\n}\n\n/**\n * Generates OpenAPI specification for a single route\n * Extracts path parameters, query parameters, request body, and response schemas\n */\nexport function generateRouteOpenAPI({\n  method,\n  path,\n  summary,\n  description,\n  tags = [],\n  pathParamSchema,\n  queryParamSchema,\n  bodySchema,\n  responseSchema,\n  deprecated,\n}: RouteOpenAPIConfig): OpenAPIRoute {\n  const route: OpenAPIRoute = {\n    summary: summary || `${method} ${path}`,\n    description,\n    tags,\n    deprecated,\n    responses: {\n      200: {\n        description: 'Successful response',\n      },\n    },\n  };\n\n  // Add path and query parameters\n  if (pathParamSchema || queryParamSchema) {\n    route.requestParams = {};\n\n    if (pathParamSchema) {\n      route.requestParams.path = pathParamSchema;\n    }\n\n    if (queryParamSchema) {\n      route.requestParams.query = queryParamSchema;\n    }\n  }\n\n  // Add request body with raw Zod schema\n  if (bodySchema) {\n    route.requestBody = {\n      content: {\n        'application/json': {\n          schema: bodySchema,\n        },\n      },\n    };\n  }\n\n  // Add response schema with raw Zod schema\n  if (responseSchema) {\n    route.responses[200] = {\n      description: 'Successful response',\n      content: {\n        'application/json': {\n          schema: responseSchema,\n        },\n      },\n    };\n  }\n\n  return route;\n}\n\n/**\n * Converts an OpenAPI route spec with Zod schemas to one with JSON Schema\n */\nfunction convertZodToJsonSchema(spec: OpenAPIRoute): any {\n  const converted: any = {\n    summary: spec.summary,\n    description: spec.description,\n    tags: spec.tags,\n    responses: {},\n  };\n\n  const parameters: any[] = [];\n\n  // Convert path parameters\n  if (spec.requestParams?.path) {\n    const pathSchema = zodToJsonSchema(spec.requestParams.path as any, 'openApi3', 'none') as any;\n    const properties = pathSchema.properties || {};\n\n    Object.entries(properties).forEach(([name, schema]) => {\n      parameters.push({\n        name,\n        in: 'path',\n        required: true,\n        description: (schema as any).description || `The ${name} parameter`,\n        schema,\n      });\n    });\n  }\n\n  // Convert query parameters\n  if (spec.requestParams?.query) {\n    const querySchema = zodToJsonSchema(spec.requestParams.query as any, 'openApi3', 'none') as any;\n    const properties = querySchema.properties || {};\n    const required = querySchema.required || [];\n\n    Object.entries(properties).forEach(([name, schema]) => {\n      parameters.push({\n        name,\n        in: 'query',\n        required: required.includes(name),\n        description: (schema as any).description || `Query parameter: ${name}`,\n        schema,\n      });\n    });\n  }\n\n  if (parameters.length > 0) {\n    converted.parameters = parameters;\n  }\n\n  // Convert request body\n  if (spec.requestBody?.content?.['application/json']?.schema) {\n    converted.requestBody = {\n      required: true,\n      content: {\n        'application/json': {\n          schema: zodToJsonSchema(spec.requestBody.content['application/json'].schema as any, 'openApi3', 'none'),\n        },\n      },\n    };\n  }\n\n  // Convert response schemas\n  Object.entries(spec.responses).forEach(([statusCode, response]) => {\n    converted.responses[statusCode] = {\n      description: response.description,\n    };\n\n    if (response.content?.['application/json']?.schema) {\n      converted.responses[statusCode].content = {\n        'application/json': {\n          schema: zodToJsonSchema(response.content['application/json'].schema as any, 'openApi3', 'none'),\n        },\n      };\n    }\n  });\n\n  return converted;\n}\n\n/**\n * Generates a complete OpenAPI 3.1.0 document from server routes\n * @param routes - Array of ServerRoute objects with OpenAPI specifications\n * @param info - API metadata (title, version, description)\n * @returns Complete OpenAPI 3.1.0 document\n */\nexport function generateOpenAPIDocument(\n  routes: ServerRoute[],\n  info: { title: string; version: string; description?: string },\n): any {\n  const paths: Record<string, any> = {};\n\n  // Build paths object from routes\n  // Convert Express-style :param to OpenAPI-style {param}\n  routes.forEach(route => {\n    if (!route.openapi) return;\n\n    const openapiPath = route.path.replace(/:(\\w+)/g, '{$1}');\n    if (!paths[openapiPath]) {\n      paths[openapiPath] = {};\n    }\n\n    // Convert Zod schemas to JSON Schema\n    paths[openapiPath][route.method.toLowerCase()] = convertZodToJsonSchema(route.openapi);\n  });\n\n  return {\n    openapi: '3.1.0',\n    info: {\n      title: info.title,\n      version: info.version,\n      description: info.description,\n    },\n    paths,\n  };\n}\n","import { z } from 'zod';\nimport type { ZodObject, ZodRawShape, ZodTypeAny } from 'zod';\nimport { generateRouteOpenAPI } from '../openapi-utils';\nimport type { InferParams, ResponseType, ServerRoute, ServerRouteHandler } from './index';\n\n/**\n * Extracts parameters matching a Zod schema's shape from a params object.\n * Useful for separating schema-defined params from ServerContext in handlers.\n *\n * @example\n * ```typescript\n * const querySchema = z.object({ page: z.number(), name: z.string() });\n *\n * handler: async (params) => {\n *   const query = pickParams(querySchema, params);\n *   // query is typed as { page: number, name: string }\n * }\n * ```\n */\nexport function pickParams<T extends z.ZodRawShape, P extends Record<string, unknown>>(\n  schema: z.ZodObject<T>,\n  params: P,\n): z.infer<z.ZodObject<T>> {\n  const keys = Object.keys(schema.shape);\n  const result = {} as z.infer<z.ZodObject<T>>;\n  for (const key of keys) {\n    if (key in params) {\n      (result as any)[key] = params[key];\n    }\n  }\n  return result;\n}\n\n/**\n * Wraps a Zod schema to accept either the expected type OR a JSON string.\n * Used for complex query parameters (arrays, objects) that are serialized as JSON in URLs.\n *\n * - If input is already the expected type, passes through to schema validation\n * - If input is a string, attempts JSON.parse then validates\n * - Provides clear error messages for JSON parse failures\n *\n * @example\n * ```typescript\n * const tagsSchema = jsonQueryParam(z.array(z.string()));\n * // Accepts: [\"tag1\", \"tag2\"] OR '[\"tag1\", \"tag2\"]'\n *\n * const dateRangeSchema = jsonQueryParam(z.object({ gte: z.coerce.date() }));\n * // Accepts: { gte: \"2024-01-01\" } OR '{\"gte\": \"2024-01-01\"}'\n * ```\n */\nexport function jsonQueryParam<T extends ZodTypeAny>(schema: T): z.ZodType<z.infer<T>> {\n  return z.union([\n    schema, // Already the expected type (non-string input)\n    z.string().transform((val, ctx) => {\n      try {\n        const parsed = JSON.parse(val);\n        const result = schema.safeParse(parsed);\n        if (!result.success) {\n          for (const issue of result.error.issues) {\n            ctx.addIssue({\n              code: z.ZodIssueCode.custom,\n              message: issue.message,\n              path: issue.path,\n            });\n          }\n          return z.NEVER;\n        }\n        return result.data;\n      } catch (e) {\n        ctx.addIssue({\n          code: z.ZodIssueCode.custom,\n          message: `Invalid JSON: ${e instanceof Error ? e.message : 'parse error'}`,\n        });\n        return z.NEVER;\n      }\n    }),\n  ]) as z.ZodType<z.infer<T>>;\n}\n\n/**\n * Gets the type name from a Zod schema's internal definition.\n * Works across zod v3 and v4 by checking _def.typeName.\n */\nfunction getZodTypeName(schema: ZodTypeAny): string | undefined {\n  return (schema as any)?._def?.typeName;\n}\n\n/**\n * Checks if a Zod schema represents a complex type that needs JSON parsing from query strings.\n * Complex types: arrays, objects, records (these can't be represented as simple strings)\n * Simple types: strings, numbers, booleans, enums (can use z.coerce for conversion)\n *\n * Uses _def.typeName string comparison instead of instanceof to support both zod v3 and v4,\n * since instanceof checks fail across different zod versions in bundled code.\n */\nfunction isComplexType(schema: ZodTypeAny): boolean {\n  // Unwrap all optional/nullable layers to check the inner type\n  // Note: .partial() can create nested optionals (e.g., ZodOptional<ZodOptional<ZodObject>>)\n  let inner: ZodTypeAny = schema;\n  let typeName = getZodTypeName(inner);\n\n  while (typeName === 'ZodOptional' || typeName === 'ZodNullable') {\n    // Access innerType directly from _def to avoid version-specific method differences\n    inner = (inner as any)._def.innerType;\n    typeName = getZodTypeName(inner);\n  }\n\n  // Complex types that need JSON parsing\n  return typeName === 'ZodArray' || typeName === 'ZodRecord' || typeName === 'ZodObject';\n}\n\n/**\n * Wraps a Zod object schema for HTTP query parameter handling.\n * Automatically detects complex fields (arrays, objects, records) and wraps them\n * with jsonQueryParam() to accept JSON strings from query parameters.\n *\n * Simple fields (strings, numbers, booleans, enums) are left unchanged and should\n * use z.coerce for string-to-type conversion.\n *\n * @example\n * ```typescript\n * // Base schema (for internal/storage use)\n * const tracesFilterSchema = z.object({\n *   tags: z.array(z.string()).optional(),\n *   startedAt: dateRangeSchema.optional(),\n *   perPage: z.coerce.number().optional(),\n * });\n *\n * // HTTP schema (accepts JSON strings for complex fields)\n * const httpTracesFilterSchema = wrapSchemaForQueryParams(tracesFilterSchema);\n *\n * // Now accepts:\n * // ?tags=[\"tag1\",\"tag2\"]&startedAt={\"gte\":\"2024-01-01\"}&perPage=10\n * ```\n */\nexport function wrapSchemaForQueryParams<T extends ZodRawShape>(schema: ZodObject<T>): ZodObject<ZodRawShape> {\n  const newShape: Record<string, ZodTypeAny> = {};\n\n  // schema.shape is Readonly in Zod v4, so we need to create a mutable copy\n  const shape = schema.shape as unknown as Record<string, ZodTypeAny>;\n  for (const [key, fieldSchema] of Object.entries(shape)) {\n    if (isComplexType(fieldSchema)) {\n      // Wrap complex types to accept JSON strings\n      newShape[key] = jsonQueryParam(fieldSchema);\n    } else {\n      // Keep simple types as-is\n      newShape[key] = fieldSchema;\n    }\n  }\n\n  return z.object(newShape);\n}\n\ninterface RouteConfig<\n  TPathSchema extends z.ZodTypeAny | undefined = undefined,\n  TQuerySchema extends z.ZodTypeAny | undefined = undefined,\n  TBodySchema extends z.ZodTypeAny | undefined = undefined,\n  TResponseSchema extends z.ZodTypeAny | undefined = undefined,\n  TResponseType extends ResponseType = 'json',\n> {\n  method: ServerRoute['method'];\n  path: string;\n  responseType: TResponseType;\n  streamFormat?: 'sse' | 'stream'; // Only used when responseType is 'stream'\n  handler: ServerRouteHandler<\n    InferParams<TPathSchema, TQuerySchema, TBodySchema>,\n    TResponseSchema extends z.ZodTypeAny ? z.infer<TResponseSchema> : unknown,\n    TResponseType\n  >;\n  pathParamSchema?: TPathSchema;\n  queryParamSchema?: TQuerySchema;\n  bodySchema?: TBodySchema;\n  responseSchema?: TResponseSchema;\n  summary?: string;\n  description?: string;\n  tags?: string[];\n  deprecated?: boolean;\n  maxBodySize?: number;\n  requiresAuth?: boolean; // Explicit auth requirement for this route\n}\n\n/**\n * Creates a server route with auto-generated OpenAPI specification and type-safe handler inference.\n *\n * The handler parameters are automatically inferred from the provided schemas:\n * - pathParamSchema: Infers path parameter types (e.g., :agentId)\n * - queryParamSchema: Infers query parameter types\n * - bodySchema: Infers request body types\n * - Runtime context (mastra, requestContext, tools, taskStore) is always available\n *\n * @param config - Route configuration including schemas, handler, and metadata\n * @returns Complete ServerRoute with OpenAPI spec\n *\n * @example\n * ```typescript\n * export const getAgentRoute = createRoute({\n *   method: 'GET',\n *   path: '/agents/:agentId',\n *   responseType: 'json',\n *   pathParamSchema: z.object({ agentId: z.string() }),\n *   responseSchema: serializedAgentSchema,\n *   handler: async ({ agentId, mastra, requestContext }) => {\n *     // agentId is typed as string\n *     // mastra, requestContext, tools, taskStore are always available\n *     return mastra.getAgentById(agentId);\n *   },\n *   summary: 'Get agent by ID',\n *   description: 'Returns details for a specific agent',\n *   tags: ['Agents'],\n * });\n * ```\n */\nexport function createRoute<\n  TPathSchema extends z.ZodTypeAny | undefined = undefined,\n  TQuerySchema extends z.ZodTypeAny | undefined = undefined,\n  TBodySchema extends z.ZodTypeAny | undefined = undefined,\n  TResponseSchema extends z.ZodTypeAny | undefined = undefined,\n  TResponseType extends ResponseType = 'json',\n>(\n  config: RouteConfig<TPathSchema, TQuerySchema, TBodySchema, TResponseSchema, TResponseType>,\n): ServerRoute<\n  InferParams<TPathSchema, TQuerySchema, TBodySchema>,\n  TResponseSchema extends z.ZodTypeAny ? z.infer<TResponseSchema> : unknown,\n  TResponseType\n> {\n  const { summary, description, tags, deprecated, requiresAuth, ...baseRoute } = config;\n\n  // Generate OpenAPI specification from the route config\n  // Skip OpenAPI generation for 'ALL' method as it doesn't map to OpenAPI\n  const openapi =\n    config.method !== 'ALL'\n      ? generateRouteOpenAPI({\n          method: config.method as 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH',\n          path: config.path,\n          summary,\n          description,\n          tags,\n          pathParamSchema: config.pathParamSchema,\n          queryParamSchema: config.queryParamSchema,\n          bodySchema: config.bodySchema,\n          responseSchema: config.responseSchema,\n          deprecated,\n        })\n      : undefined;\n\n  return {\n    ...baseRoute,\n    openapi: openapi as any,\n    deprecated,\n    requiresAuth,\n  };\n}\n"]}

package/dist/chunk-DOU5IGJB.js

@@ -0,0 +1,242 @@
+import { tracingOptionsSchema, coreMessageSchema, messageResponseSchema } from './chunk-HT4LP3BO.js';
+import z from 'zod';
+
+var agentIdPathParams = z.object({
+  agentId: z.string().describe("Unique identifier for the agent")
+});
+var toolIdPathParams = z.object({
+  toolId: z.string().describe("Unique identifier for the tool")
+});
+var agentToolPathParams = agentIdPathParams.extend({
+  toolId: z.string().describe("Unique identifier for the tool")
+});
+var modelConfigIdPathParams = agentIdPathParams.extend({
+  modelConfigId: z.string().describe("Unique identifier for the model configuration")
+});
+var serializedProcessorSchema = z.object({
+  id: z.string(),
+  name: z.string().optional()
+});
+var serializedToolSchema = z.object({
+  id: z.string(),
+  description: z.string().optional(),
+  inputSchema: z.string().optional(),
+  outputSchema: z.string().optional(),
+  requireApproval: z.boolean().optional()
+});
+var serializedWorkflowSchema = z.object({
+  name: z.string(),
+  steps: z.record(
+    z.string(),
+    z.object({
+      id: z.string(),
+      description: z.string().optional()
+    })
+  ).optional()
+});
+var serializedAgentDefinitionSchema = z.object({
+  id: z.string(),
+  name: z.string()
+});
+var systemMessageSchema = z.union([
+  z.string(),
+  z.array(z.string()),
+  z.any(),
+  // CoreSystemMessage or SystemModelMessage
+  z.array(z.any())
+]);
+var modelConfigSchema = z.object({
+  model: z.object({
+    modelId: z.string(),
+    provider: z.string(),
+    modelVersion: z.string()
+  })
+  // Additional fields from AgentModelManagerConfig can be added here
+});
+var serializedAgentSchema = z.object({
+  name: z.string(),
+  description: z.string().optional(),
+  instructions: systemMessageSchema.optional(),
+  tools: z.record(z.string(), serializedToolSchema),
+  agents: z.record(z.string(), serializedAgentDefinitionSchema),
+  workflows: z.record(z.string(), serializedWorkflowSchema),
+  inputProcessors: z.array(serializedProcessorSchema),
+  outputProcessors: z.array(serializedProcessorSchema),
+  provider: z.string().optional(),
+  modelId: z.string().optional(),
+  modelVersion: z.string().optional(),
+  modelList: z.array(modelConfigSchema).optional(),
+  defaultOptions: z.record(z.string(), z.any()).optional(),
+  defaultGenerateOptionsLegacy: z.record(z.string(), z.any()).optional(),
+  defaultStreamOptionsLegacy: z.record(z.string(), z.any()).optional()
+});
+serializedAgentSchema.extend({
+  id: z.string()
+});
+var providerSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  label: z.string().optional(),
+  description: z.string().optional()
+});
+var providersResponseSchema = z.object({
+  providers: z.array(providerSchema)
+});
+var listAgentsResponseSchema = z.record(z.string(), serializedAgentSchema);
+var listToolsResponseSchema = z.record(z.string(), serializedToolSchema);
+var agentMemoryOptionSchema = z.object({
+  thread: z.union([z.string(), z.object({ id: z.string() }).passthrough()]),
+  resource: z.string(),
+  options: z.record(z.string(), z.any()).optional(),
+  readOnly: z.boolean().optional()
+});
+var toolChoiceSchema = z.union([
+  z.enum(["auto", "none", "required"]),
+  z.object({ type: z.literal("tool"), toolName: z.string() })
+]);
+var agentExecutionBodySchema = z.object({
+  // REQUIRED
+  messages: z.union([
+    z.array(coreMessageSchema),
+    // Array of messages
+    z.string()
+    // Single user message shorthand
+  ]),
+  // Message Configuration
+  instructions: systemMessageSchema.optional(),
+  system: systemMessageSchema.optional(),
+  context: z.array(coreMessageSchema).optional(),
+  // Memory & Persistence
+  memory: agentMemoryOptionSchema.optional(),
+  runId: z.string().optional(),
+  savePerStep: z.boolean().optional(),
+  // Request Context (handler-specific field - merged with server's requestContext)
+  requestContext: z.record(z.string(), z.any()).optional(),
+  // Execution Control
+  maxSteps: z.number().optional(),
+  stopWhen: z.any().optional(),
+  // Model Configuration
+  providerOptions: z.object({
+    anthropic: z.record(z.string(), z.any()).optional(),
+    google: z.record(z.string(), z.any()).optional(),
+    openai: z.record(z.string(), z.any()).optional(),
+    xai: z.record(z.string(), z.any()).optional()
+  }).optional(),
+  modelSettings: z.any().optional(),
+  // Tool Configuration
+  activeTools: z.array(z.string()).optional(),
+  toolsets: z.record(z.string(), z.any()).optional(),
+  clientTools: z.record(z.string(), z.any()).optional(),
+  toolChoice: toolChoiceSchema.optional(),
+  requireToolApproval: z.boolean().optional(),
+  // Evaluation
+  scorers: z.union([
+    z.record(z.string(), z.any()),
+    z.record(
+      z.string(),
+      z.object({
+        scorer: z.string(),
+        sampling: z.any().optional()
+      })
+    )
+  ]).optional(),
+  returnScorerData: z.boolean().optional(),
+  // Observability
+  tracingOptions: tracingOptionsSchema.optional(),
+  // Structured Output
+  output: z.any().optional(),
+  // Zod schema, JSON schema, or structured output object
+  structuredOutput: z.object({
+    schema: z.object({}).passthrough(),
+    model: z.union([z.string(), z.any()]).optional(),
+    instructions: z.string().optional(),
+    jsonPromptInjection: z.boolean().optional(),
+    errorStrategy: z.enum(["strict", "warn", "fallback"]).optional(),
+    fallbackValue: z.any().optional()
+  }).optional()
+}).passthrough();
+var agentExecutionLegacyBodySchema = agentExecutionBodySchema.extend({
+  resourceId: z.string().optional(),
+  resourceid: z.string().optional(),
+  // lowercase variant
+  threadId: z.string().optional()
+});
+var executeToolDataBodySchema = z.object({
+  data: z.custom((x) => x !== void 0, { message: "data is required" })
+});
+var executeToolBodySchema = executeToolDataBodySchema.extend({
+  requestContext: z.record(z.string(), z.any()).optional()
+});
+var executeToolContextBodySchema = executeToolDataBodySchema.extend({
+  requestContext: z.record(z.string(), z.any()).optional()
+});
+var voiceSpeakersResponseSchema = z.array(
+  z.object({
+    voiceId: z.string()
+  }).passthrough()
+  // Allow provider-specific fields like name, language, etc.
+);
+var toolCallActionBodySchema = z.object({
+  runId: z.string(),
+  requestContext: z.record(z.string(), z.any()).optional(),
+  toolCallId: z.string(),
+  format: z.string().optional()
+});
+var networkToolCallActionBodySchema = z.object({
+  runId: z.string(),
+  requestContext: z.record(z.string(), z.any()).optional(),
+  format: z.string().optional()
+});
+var approveToolCallBodySchema = toolCallActionBodySchema;
+var declineToolCallBodySchema = toolCallActionBodySchema;
+var approveNetworkToolCallBodySchema = networkToolCallActionBodySchema;
+var declineNetworkToolCallBodySchema = networkToolCallActionBodySchema;
+var toolCallResponseSchema = z.object({
+  fullStream: z.any()
+  // ReadableStream
+});
+var updateAgentModelBodySchema = z.object({
+  modelId: z.string(),
+  provider: z.string()
+});
+var reorderAgentModelListBodySchema = z.object({
+  reorderedModelIds: z.array(z.string())
+});
+var updateAgentModelInModelListBodySchema = z.object({
+  model: z.object({
+    modelId: z.string(),
+    provider: z.string()
+  }).optional(),
+  maxRetries: z.number().optional(),
+  enabled: z.boolean().optional()
+});
+var modelManagementResponseSchema = messageResponseSchema;
+var generateSpeechBodySchema = z.object({
+  text: z.string(),
+  speakerId: z.string().optional()
+});
+var transcribeSpeechBodySchema = z.object({
+  audio: z.any(),
+  // Buffer
+  options: z.record(z.string(), z.any()).optional()
+});
+var transcribeSpeechResponseSchema = z.object({
+  text: z.string()
+});
+var getListenerResponseSchema = z.any();
+var generateResponseSchema = z.any();
+var streamResponseSchema = z.any();
+var speakResponseSchema = z.any();
+var executeToolResponseSchema = z.any();
+var enhanceInstructionsBodySchema = z.object({
+  instructions: z.string().describe("The current agent instructions to enhance"),
+  comment: z.string().describe("User comment describing how to enhance the instructions")
+});
+var enhanceInstructionsResponseSchema = z.object({
+  explanation: z.string().describe("Explanation of the changes made"),
+  new_prompt: z.string().describe("The enhanced instructions")
+});
+
+export { agentExecutionBodySchema, agentExecutionLegacyBodySchema, agentIdPathParams, agentToolPathParams, approveNetworkToolCallBodySchema, approveToolCallBodySchema, declineNetworkToolCallBodySchema, declineToolCallBodySchema, enhanceInstructionsBodySchema, enhanceInstructionsResponseSchema, executeToolBodySchema, executeToolContextBodySchema, executeToolResponseSchema, generateResponseSchema, generateSpeechBodySchema, getListenerResponseSchema, listAgentsResponseSchema, listToolsResponseSchema, modelConfigIdPathParams, modelManagementResponseSchema, providersResponseSchema, reorderAgentModelListBodySchema, serializedAgentSchema, serializedToolSchema, speakResponseSchema, streamResponseSchema, toolCallResponseSchema, toolIdPathParams, transcribeSpeechBodySchema, transcribeSpeechResponseSchema, updateAgentModelBodySchema, updateAgentModelInModelListBodySchema, voiceSpeakersResponseSchema };
+//# sourceMappingURL=chunk-DOU5IGJB.js.map
+//# sourceMappingURL=chunk-DOU5IGJB.js.map

package/dist/chunk-DOU5IGJB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server/schemas/agents.ts"],"names":[],"mappings":";;;AAIO,IAAM,iBAAA,GAAoB,EAAE,MAAA,CAAO;AAAA,EACxC,OAAA,EAAS,CAAA,CAAE,MAAA,EAAO,CAAE,SAAS,iCAAiC;AAChE,CAAC;AAEM,IAAM,gBAAA,GAAmB,EAAE,MAAA,CAAO;AAAA,EACvC,MAAA,EAAQ,CAAA,CAAE,MAAA,EAAO,CAAE,SAAS,gCAAgC;AAC9D,CAAC;AAEM,IAAM,mBAAA,GAAsB,kBAAkB,MAAA,CAAO;AAAA,EAC1D,MAAA,EAAQ,CAAA,CAAE,MAAA,EAAO,CAAE,SAAS,gCAAgC;AAC9D,CAAC;AAEM,IAAM,uBAAA,GAA0B,kBAAkB,MAAA,CAAO;AAAA,EAC9D,aAAA,EAAe,CAAA,CAAE,MAAA,EAAO,CAAE,SAAS,+CAA+C;AACpF,CAAC;AAKM,IAAM,yBAAA,GAA4B,EAAE,MAAA,CAAO;AAAA,EAChD,EAAA,EAAI,EAAE,MAAA,EAAO;AAAA,EACb,IAAA,EAAM,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AACnB,CAAC,CAAA;AAMM,IAAM,oBAAA,GAAuB,EAAE,MAAA,CAAO;AAAA,EAC3C,EAAA,EAAI,EAAE,MAAA,EAAO;AAAA,EACb,WAAA,EAAa,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EACjC,WAAA,EAAa,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EACjC,YAAA,EAAc,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAClC,eAAA,EAAiB,CAAA,CAAE,OAAA,EAAQ,CAAE,QAAA;AAC/B,CAAC;AAKM,IAAM,wBAAA,GAA2B,EAAE,MAAA,CAAO;AAAA,EAC/C,IAAA,EAAM,EAAE,MAAA,EAAO;AAAA,EACf,OAAO,CAAA,CACJ,MAAA;AAAA,IACC,EAAE,MAAA,EAAO;AAAA,IACT,EAAE,MAAA,CAAO;AAAA,MACP,EAAA,EAAI,EAAE,MAAA,EAAO;AAAA,MACb,WAAA,EAAa,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AAAS,KAClC;AAAA,IAEF,QAAA;AACL,CAAC,CAAA;AAKM,IAAM,+BAAA,GAAkC,EAAE,MAAA,CAAO;AAAA,EACtD,EAAA,EAAI,EAAE,MAAA,EAAO;AAAA,EACb,IAAA,EAAM,EAAE,MAAA;AACV,CAAC,CAAA;AAMD,IAAM,mBAAA,GAAsB,EAAE,KAAA,CAAM;AAAA,EAClC,EAAE,MAAA,EAAO;AAAA,EACT,CAAA,CAAE,KAAA,CAAM,CAAA,CAAE,MAAA,EAAQ,CAAA;AAAA,EAClB,EAAE,GAAA,EAAI;AAAA;AAAA,EACN,CAAA,CAAE,KAAA,CAAM,CAAA,CAAE,GAAA,EAAK;AACjB,CAAC,CAAA;AAKD,IAAM,iBAAA,GAAoB,EAAE,MAAA,CAAO;AAAA,EACjC,KAAA,EAAO,EAAE,MAAA,CAAO;AAAA,IACd,OAAA,EAAS,EAAE,MAAA,EAAO;AAAA,IAClB,QAAA,EAAU,EAAE,MAAA,EAAO;AAAA,IACnB,YAAA,EAAc,EAAE,MAAA;AAAO,GACxB;AAAA;AAEH,CAAC,CAAA;AAKM,IAAM,qBAAA,GAAwB,EAAE,MAAA,CAAO;AAAA,EAC5C,IAAA,EAAM,EAAE,MAAA,EAAO;AAAA,EACf,WAAA,EAAa,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EACjC,YAAA,EAAc,oBAAoB,QAAA,EAAS;AAAA,EAC3C,OAAO,CAAA,CAAE,MAAA,CAAO,CAAA,CAAE,MAAA,IAAU,oBAAoB,CAAA;AAAA,EAChD,QAAQ,CAAA,CAAE,MAAA,CAAO,CAAA,CAAE,MAAA,IAAU,+BAA+B,CAAA;AAAA,EAC5D,WAAW,CAAA,CAAE,MAAA,CAAO,CAAA,CAAE,MAAA,IAAU,wBAAwB,CAAA;AAAA,EACxD,eAAA,EAAiB,CAAA,CAAE,KAAA,CAAM,yBAAyB,CAAA;AAAA,EAClD,gBAAA,EAAkB,CAAA,CAAE,KAAA,CAAM,yBAAyB,CAAA;AAAA,EACnD,QAAA,EAAU,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC9B,OAAA,EAAS,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC7B,YAAA,EAAc,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAClC,SAAA,EAAW,CAAA,CAAE,KAAA,CAAM,iBAAiB,EAAE,QAAA,EAAS;AAAA,EAC/C,cAAA,EAAgB,CAAA,CAAE,MAAA,CAAO,CAAA,CAAE,MAAA,IAAU,CAAA,CAAE,GAAA,EAAK,CAAA,CAAE,QAAA,EAAS;AAAA,EACvD,4BAAA,EAA8B,CAAA,CAAE,MAAA,CAAO,CAAA,CAAE,MAAA,IAAU,CAAA,CAAE,GAAA,EAAK,CAAA,CAAE,QAAA,EAAS;AAAA,EACrE,0BAAA,EAA4B,CAAA,CAAE,MAAA,CAAO,CAAA,CAAE,MAAA,IAAU,CAAA,CAAE,GAAA,EAAK,CAAA,CAAE,QAAA;AAC5D,CAAC;AAK0C,sBAAsB,MAAA,CAAO;AAAA,EACtE,EAAA,EAAI,EAAE,MAAA;AACR,CAAC;AAKM,IAAM,cAAA,GAAiB,EAAE,MAAA,CAAO;AAAA,EACrC,EAAA,EAAI,EAAE,MAAA,EAAO;AAAA,EACb,IAAA,EAAM,EAAE,MAAA,EAAO;AAAA,EACf,KAAA,EAAO,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC3B,WAAA,EAAa,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AAC1B,CAAC,CAAA;AAKM,IAAM,uBAAA,GAA0B,EAAE,MAAA,CAAO;AAAA,EAC9C,SAAA,EAAW,CAAA,CAAE,KAAA,CAAM,cAAc;AACnC,CAAC;AAMM,IAAM,2BAA2B,CAAA,CAAE,MAAA,CAAO,CAAA,CAAE,MAAA,IAAU,qBAAqB;AAM3E,IAAM,0BAA0B,CAAA,CAAE,MAAA,CAAO,CAAA,CAAE,MAAA,IAAU,oBAAoB;AAShF,IAAM,uBAAA,GAA0B,EAAE,MAAA,CAAO;AAAA,EACvC,QAAQ,CAAA,CAAE,KAAA,CAAM,CAAC,CAAA,CAAE,MAAA,IAAU,CAAA,CAAE,MAAA,CAAO,EAAE,EAAA,EAAI,EAAE,MAAA,EAAO,EAAG,CAAA,CAAE,WAAA,EAAa,CAAC,CAAA;AAAA,EACxE,QAAA,EAAU,EAAE,MAAA,EAAO;AAAA,EACnB,OAAA,EAAS,CAAA,CAAE,MAAA,CAAO,CAAA,CAAE,MAAA,IAAU,CAAA,CAAE,GAAA,EAAK,CAAA,CAAE,QAAA,EAAS;AAAA,EAChD,QAAA,EAAU,CAAA,CAAE,OAAA,EAAQ,CAAE,QAAA;AACxB,CAAC,CAAA;AAKD,IAAM,gBAAA,GAAmB,EAAE,KAAA,CAAM;AAAA,EAC/B,EAAE,IAAA,CAAK,CAAC,MAAA,EAAQ,MAAA,EAAQ,UAAU,CAAC,CAAA;AAAA,EACnC,CAAA,CAAE,MAAA,CAAO,EAAE,IAAA,EAAM,CAAA,CAAE,OAAA,CAAQ,MAAM,CAAA,EAAG,QAAA,EAAU,CAAA,CAAE,MAAA,EAAO,EAAG;AAC5D,CAAC,CAAA;AAWM,IAAM,wBAAA,GAA2B,EACrC,MAAA,CAAO;AAAA;AAAA,EAEN,QAAA,EAAU,EAAE,KAAA,CAAM;AAAA,IAChB,CAAA,CAAE,MAAM,iBAAiB,CAAA;AAAA;AAAA,IACzB,EAAE,MAAA;AAAO;AAAA,GACV,CAAA;AAAA;AAAA,EAGD,YAAA,EAAc,oBAAoB,QAAA,EAAS;AAAA,EAC3C,MAAA,EAAQ,oBAAoB,QAAA,EAAS;AAAA,EACrC,OAAA,EAAS,CAAA,CAAE,KAAA,CAAM,iBAAiB,EAAE,QAAA,EAAS;AAAA;AAAA,EAG7C,MAAA,EAAQ,wBAAwB,QAAA,EAAS;AAAA,EACzC,KAAA,EAAO,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC3B,WAAA,EAAa,CAAA,CAAE,OAAA,EAAQ,CAAE,QAAA,EAAS;AAAA;AAAA,EAGlC,cAAA,EAAgB,CAAA,CAAE,MAAA,CAAO,CAAA,CAAE,MAAA,IAAU,CAAA,CAAE,GAAA,EAAK,CAAA,CAAE,QAAA,EAAS;AAAA;AAAA,EAGvD,QAAA,EAAU,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC9B,QAAA,EAAU,CAAA,CAAE,GAAA,EAAI,CAAE,QAAA,EAAS;AAAA;AAAA,EAG3B,eAAA,EAAiB,EACd,MAAA,CAAO;AAAA,IACN,SAAA,EAAW,CAAA,CAAE,MAAA,CAAO,CAAA,CAAE,MAAA,IAAU,CAAA,CAAE,GAAA,EAAK,CAAA,CAAE,QAAA,EAAS;AAAA,IAClD,MAAA,EAAQ,CAAA,CAAE,MAAA,CAAO,CAAA,CAAE,MAAA,IAAU,CAAA,CAAE,GAAA,EAAK,CAAA,CAAE,QAAA,EAAS;AAAA,IAC/C,MAAA,EAAQ,CAAA,CAAE,MAAA,CAAO,CAAA,CAAE,MAAA,IAAU,CAAA,CAAE,GAAA,EAAK,CAAA,CAAE,QAAA,EAAS;AAAA,IAC/C,GAAA,EAAK,CAAA,CAAE,MAAA,CAAO,CAAA,CAAE,MAAA,IAAU,CAAA,CAAE,GAAA,EAAK,CAAA,CAAE,QAAA;AAAS,GAC7C,EACA,QAAA,EAAS;AAAA,EACZ,aAAA,EAAe,CAAA,CAAE,GAAA,EAAI,CAAE,QAAA,EAAS;AAAA;AAAA,EAGhC,aAAa,CAAA,CAAE,KAAA,CAAM,EAAE,MAAA,EAAQ,EAAE,QAAA,EAAS;AAAA,EAC1C,QAAA,EAAU,CAAA,CAAE,MAAA,CAAO,CAAA,CAAE,MAAA,IAAU,CAAA,CAAE,GAAA,EAAK,CAAA,CAAE,QAAA,EAAS;AAAA,EACjD,WAAA,EAAa,CAAA,CAAE,MAAA,CAAO,CAAA,CAAE,MAAA,IAAU,CAAA,CAAE,GAAA,EAAK,CAAA,CAAE,QAAA,EAAS;AAAA,EACpD,UAAA,EAAY,iBAAiB,QAAA,EAAS;AAAA,EACtC,mBAAA,EAAqB,CAAA,CAAE,OAAA,EAAQ,CAAE,QAAA,EAAS;AAAA;AAAA,EAG1C,OAAA,EAAS,EACN,KAAA,CAAM;AAAA,IACL,EAAE,MAAA,CAAO,CAAA,CAAE,QAAO,EAAG,CAAA,CAAE,KAAK,CAAA;AAAA,IAC5B,CAAA,CAAE,MAAA;AAAA,MACA,EAAE,MAAA,EAAO;AAAA,MACT,EAAE,MAAA,CAAO;AAAA,QACP,MAAA,EAAQ,EAAE,MAAA,EAAO;AAAA,QACjB,QAAA,EAAU,CAAA,CAAE,GAAA,EAAI,CAAE,QAAA;AAAS,OAC5B;AAAA;AACH,GACD,EACA,QAAA,EAAS;AAAA,EACZ,gBAAA,EAAkB,CAAA,CAAE,OAAA,EAAQ,CAAE,QAAA,EAAS;AAAA;AAAA,EAGvC,cAAA,EAAgB,qBAAqB,QAAA,EAAS;AAAA;AAAA,EAG9C,MAAA,EAAQ,CAAA,CAAE,GAAA,EAAI,CAAE,QAAA,EAAS;AAAA;AAAA,EACzB,gBAAA,EAAkB,EACf,MAAA,CAAO;AAAA,IACN,QAAQ,CAAA,CAAE,MAAA,CAAO,EAAE,EAAE,WAAA,EAAY;AAAA,IACjC,KAAA,EAAO,CAAA,CAAE,KAAA,CAAM,CAAC,CAAA,CAAE,MAAA,EAAO,EAAG,CAAA,CAAE,GAAA,EAAK,CAAC,CAAA,CAAE,QAAA,EAAS;AAAA,IAC/C,YAAA,EAAc,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,IAClC,mBAAA,EAAqB,CAAA,CAAE,OAAA,EAAQ,CAAE,QAAA,EAAS;AAAA,IAC1C,aAAA,EAAe,EAAE,IAAA,CAAK,CAAC,UAAU,MAAA,EAAQ,UAAU,CAAC,CAAA,CAAE,QAAA,EAAS;AAAA,IAC/D,aAAA,EAAe,CAAA,CAAE,GAAA,EAAI,CAAE,QAAA;AAAS,GACjC,EACA,QAAA;AACL,CAAC,EACA,WAAA;AAMI,IAAM,8BAAA,GAAiC,yBAAyB,MAAA,CAAO;AAAA,EAC5E,UAAA,EAAY,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAChC,UAAA,EAAY,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA;AAAA,EAChC,QAAA,EAAU,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AACvB,CAAC;AAQD,IAAM,yBAAA,GAA4B,EAAE,MAAA,CAAO;AAAA,EACzC,IAAA,EAAM,EAAE,MAAA,CAAgB,CAAA,CAAA,KAAK,MAAM,MAAA,EAAW,EAAE,OAAA,EAAS,kBAAA,EAAoB;AAC/E,CAAC,CAAA;AAEM,IAAM,qBAAA,GAAwB,0BAA0B,MAAA,CAAO;AAAA,EACpE,cAAA,EAAgB,CAAA,CAAE,MAAA,CAAO,CAAA,CAAE,MAAA,IAAU,CAAA,CAAE,GAAA,EAAK,CAAA,CAAE,QAAA;AAChD,CAAC;AAEM,IAAM,4BAAA,GAA+B,0BAA0B,MAAA,CAAO;AAAA,EAC3E,cAAA,EAAgB,CAAA,CAAE,MAAA,CAAO,CAAA,CAAE,MAAA,IAAU,CAAA,CAAE,GAAA,EAAK,CAAA,CAAE,QAAA;AAChD,CAAC;AAMM,IAAM,8BAA8B,CAAA,CAAE,KAAA;AAAA,EAC3C,EACG,MAAA,CAAO;AAAA,IACN,OAAA,EAAS,EAAE,MAAA;AAAO,GACnB,EACA,WAAA;AAAY;AACjB;AAUA,IAAM,wBAAA,GAA2B,EAAE,MAAA,CAAO;AAAA,EACxC,KAAA,EAAO,EAAE,MAAA,EAAO;AAAA,EAChB,cAAA,EAAgB,CAAA,CAAE,MAAA,CAAO,CAAA,CAAE,MAAA,IAAU,CAAA,CAAE,GAAA,EAAK,CAAA,CAAE,QAAA,EAAS;AAAA,EACvD,UAAA,EAAY,EAAE,MAAA,EAAO;AAAA,EACrB,MAAA,EAAQ,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AACrB,CAAC,CAAA;AACD,IAAM,+BAAA,GAAkC,EAAE,MAAA,CAAO;AAAA,EAC/C,KAAA,EAAO,EAAE,MAAA,EAAO;AAAA,EAChB,cAAA,EAAgB,CAAA,CAAE,MAAA,CAAO,CAAA,CAAE,MAAA,IAAU,CAAA,CAAE,GAAA,EAAK,CAAA,CAAE,QAAA,EAAS;AAAA,EACvD,MAAA,EAAQ,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AACrB,CAAC,CAAA;AAKM,IAAM,yBAAA,GAA4B;AAKlC,IAAM,yBAAA,GAA4B;AAKlC,IAAM,gCAAA,GAAmC;AAKzC,IAAM,gCAAA,GAAmC;AAKzC,IAAM,sBAAA,GAAyB,EAAE,MAAA,CAAO;AAAA,EAC7C,UAAA,EAAY,EAAE,GAAA;AAAI;AACpB,CAAC;AASM,IAAM,0BAAA,GAA6B,EAAE,MAAA,CAAO;AAAA,EACjD,OAAA,EAAS,EAAE,MAAA,EAAO;AAAA,EAClB,QAAA,EAAU,EAAE,MAAA;AACd,CAAC;AAKM,IAAM,+BAAA,GAAkC,EAAE,MAAA,CAAO;AAAA,EACtD,iBAAA,EAAmB,CAAA,CAAE,KAAA,CAAM,CAAA,CAAE,QAAQ;AACvC,CAAC;AAKM,IAAM,qCAAA,GAAwC,EAAE,MAAA,CAAO;AAAA,EAC5D,KAAA,EAAO,EACJ,MAAA,CAAO;AAAA,IACN,OAAA,EAAS,EAAE,MAAA,EAAO;AAAA,IAClB,QAAA,EAAU,EAAE,MAAA;AAAO,GACpB,EACA,QAAA,EAAS;AAAA,EACZ,UAAA,EAAY,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAChC,OAAA,EAAS,CAAA,CAAE,OAAA,EAAQ,CAAE,QAAA;AACvB,CAAC;AAKM,IAAM,6BAAA,GAAgC;AAStC,IAAM,wBAAA,GAA2B,EAAE,MAAA,CAAO;AAAA,EAC/C,IAAA,EAAM,EAAE,MAAA,EAAO;AAAA,EACf,SAAA,EAAW,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AACxB,CAAC;AAKM,IAAM,0BAAA,GAA6B,EAAE,MAAA,CAAO;AAAA,EACjD,KAAA,EAAO,EAAE,GAAA,EAAI;AAAA;AAAA,EACb,OAAA,EAAS,CAAA,CAAE,MAAA,CAAO,CAAA,CAAE,MAAA,IAAU,CAAA,CAAE,GAAA,EAAK,CAAA,CAAE,QAAA;AACzC,CAAC;AAKM,IAAM,8BAAA,GAAiC,EAAE,MAAA,CAAO;AAAA,EACrD,IAAA,EAAM,EAAE,MAAA;AACV,CAAC;AAKM,IAAM,yBAAA,GAA4B,EAAE,GAAA;AAMpC,IAAM,sBAAA,GAAyB,EAAE,GAAA;AACjC,IAAM,oBAAA,GAAuB,EAAE,GAAA;AAC/B,IAAM,mBAAA,GAAsB,EAAE,GAAA;AAC9B,IAAM,yBAAA,GAA4B,EAAE,GAAA;AASpC,IAAM,6BAAA,GAAgC,EAAE,MAAA,CAAO;AAAA,EACpD,YAAA,EAAc,CAAA,CAAE,MAAA,EAAO,CAAE,SAAS,2CAA2C,CAAA;AAAA,EAC7E,OAAA,EAAS,CAAA,CAAE,MAAA,EAAO,CAAE,SAAS,yDAAyD;AACxF,CAAC;AAKM,IAAM,iCAAA,GAAoC,EAAE,MAAA,CAAO;AAAA,EACxD,WAAA,EAAa,CAAA,CAAE,MAAA,EAAO,CAAE,SAAS,iCAAiC,CAAA;AAAA,EAClE,UAAA,EAAY,CAAA,CAAE,MAAA,EAAO,CAAE,SAAS,2BAA2B;AAC7D,CAAC","file":"chunk-DOU5IGJB.js","sourcesContent":["import z from 'zod';\nimport { tracingOptionsSchema, coreMessageSchema, messageResponseSchema } from './common';\n\n// Path parameter schemas\nexport const agentIdPathParams = z.object({\n  agentId: z.string().describe('Unique identifier for the agent'),\n});\n\nexport const toolIdPathParams = z.object({\n  toolId: z.string().describe('Unique identifier for the tool'),\n});\n\nexport const agentToolPathParams = agentIdPathParams.extend({\n  toolId: z.string().describe('Unique identifier for the tool'),\n});\n\nexport const modelConfigIdPathParams = agentIdPathParams.extend({\n  modelConfigId: z.string().describe('Unique identifier for the model configuration'),\n});\n\n/**\n * Schema for serialized processor metadata\n */\nexport const serializedProcessorSchema = z.object({\n  id: z.string(),\n  name: z.string().optional(),\n});\n\n/**\n * Schema for serialized tool with JSON schemas\n * Uses passthrough() to allow additional tool properties beyond core fields\n */\nexport const serializedToolSchema = z.object({\n  id: z.string(),\n  description: z.string().optional(),\n  inputSchema: z.string().optional(),\n  outputSchema: z.string().optional(),\n  requireApproval: z.boolean().optional(),\n});\n\n/**\n * Schema for serialized workflow with steps\n */\nexport const serializedWorkflowSchema = z.object({\n  name: z.string(),\n  steps: z\n    .record(\n      z.string(),\n      z.object({\n        id: z.string(),\n        description: z.string().optional(),\n      }),\n    )\n    .optional(),\n});\n\n/**\n * Schema for serialized agent definition (referenced by other agents)\n */\nexport const serializedAgentDefinitionSchema = z.object({\n  id: z.string(),\n  name: z.string(),\n});\n\n/**\n * Schema for SystemMessage type\n * Can be string, string[], or various message objects\n */\nconst systemMessageSchema = z.union([\n  z.string(),\n  z.array(z.string()),\n  z.any(), // CoreSystemMessage or SystemModelMessage\n  z.array(z.any()),\n]);\n\n/**\n * Schema for model configuration in model list\n */\nconst modelConfigSchema = z.object({\n  model: z.object({\n    modelId: z.string(),\n    provider: z.string(),\n    modelVersion: z.string(),\n  }),\n  // Additional fields from AgentModelManagerConfig can be added here\n});\n\n/**\n * Main schema for serialized agent representation\n */\nexport const serializedAgentSchema = z.object({\n  name: z.string(),\n  description: z.string().optional(),\n  instructions: systemMessageSchema.optional(),\n  tools: z.record(z.string(), serializedToolSchema),\n  agents: z.record(z.string(), serializedAgentDefinitionSchema),\n  workflows: z.record(z.string(), serializedWorkflowSchema),\n  inputProcessors: z.array(serializedProcessorSchema),\n  outputProcessors: z.array(serializedProcessorSchema),\n  provider: z.string().optional(),\n  modelId: z.string().optional(),\n  modelVersion: z.string().optional(),\n  modelList: z.array(modelConfigSchema).optional(),\n  defaultOptions: z.record(z.string(), z.any()).optional(),\n  defaultGenerateOptionsLegacy: z.record(z.string(), z.any()).optional(),\n  defaultStreamOptionsLegacy: z.record(z.string(), z.any()).optional(),\n});\n\n/**\n * Schema for agent with ID\n */\nexport const serializedAgentWithIdSchema = serializedAgentSchema.extend({\n  id: z.string(),\n});\n\n/**\n * Schema for individual provider information\n */\nexport const providerSchema = z.object({\n  id: z.string(),\n  name: z.string(),\n  label: z.string().optional(),\n  description: z.string().optional(),\n});\n\n/**\n * Schema for providers endpoint response\n */\nexport const providersResponseSchema = z.object({\n  providers: z.array(providerSchema),\n});\n\n/**\n * Schema for list agents endpoint response\n * Returns a record of agent ID to serialized agent\n */\nexport const listAgentsResponseSchema = z.record(z.string(), serializedAgentSchema);\n\n/**\n * Schema for list tools endpoint response\n * Returns a record of tool ID to serialized tool\n */\nexport const listToolsResponseSchema = z.record(z.string(), serializedToolSchema);\n\n// ============================================================================\n// Agent Execution Body Schemas\n// ============================================================================\n\n/**\n * Schema for agent memory option\n */\nconst agentMemoryOptionSchema = z.object({\n  thread: z.union([z.string(), z.object({ id: z.string() }).passthrough()]),\n  resource: z.string(),\n  options: z.record(z.string(), z.any()).optional(),\n  readOnly: z.boolean().optional(),\n});\n\n/**\n * Schema for tool choice configuration\n */\nconst toolChoiceSchema = z.union([\n  z.enum(['auto', 'none', 'required']),\n  z.object({ type: z.literal('tool'), toolName: z.string() }),\n]);\n\n/**\n * Comprehensive body schema for agent generate and stream endpoints\n * Validates common fields while using passthrough for complex nested objects\n *\n * EXCLUDED FIELDS (not serializable):\n * - Callbacks: onStepFinish, onFinish, onChunk, onError, onAbort, prepareStep\n * - Class instances: inputProcessors, outputProcessors\n * - Non-serializable: abortSignal, tracingContext\n */\nexport const agentExecutionBodySchema = z\n  .object({\n    // REQUIRED\n    messages: z.union([\n      z.array(coreMessageSchema), // Array of messages\n      z.string(), // Single user message shorthand\n    ]),\n\n    // Message Configuration\n    instructions: systemMessageSchema.optional(),\n    system: systemMessageSchema.optional(),\n    context: z.array(coreMessageSchema).optional(),\n\n    // Memory & Persistence\n    memory: agentMemoryOptionSchema.optional(),\n    runId: z.string().optional(),\n    savePerStep: z.boolean().optional(),\n\n    // Request Context (handler-specific field - merged with server's requestContext)\n    requestContext: z.record(z.string(), z.any()).optional(),\n\n    // Execution Control\n    maxSteps: z.number().optional(),\n    stopWhen: z.any().optional(),\n\n    // Model Configuration\n    providerOptions: z\n      .object({\n        anthropic: z.record(z.string(), z.any()).optional(),\n        google: z.record(z.string(), z.any()).optional(),\n        openai: z.record(z.string(), z.any()).optional(),\n        xai: z.record(z.string(), z.any()).optional(),\n      })\n      .optional(),\n    modelSettings: z.any().optional(),\n\n    // Tool Configuration\n    activeTools: z.array(z.string()).optional(),\n    toolsets: z.record(z.string(), z.any()).optional(),\n    clientTools: z.record(z.string(), z.any()).optional(),\n    toolChoice: toolChoiceSchema.optional(),\n    requireToolApproval: z.boolean().optional(),\n\n    // Evaluation\n    scorers: z\n      .union([\n        z.record(z.string(), z.any()),\n        z.record(\n          z.string(),\n          z.object({\n            scorer: z.string(),\n            sampling: z.any().optional(),\n          }),\n        ),\n      ])\n      .optional(),\n    returnScorerData: z.boolean().optional(),\n\n    // Observability\n    tracingOptions: tracingOptionsSchema.optional(),\n\n    // Structured Output\n    output: z.any().optional(), // Zod schema, JSON schema, or structured output object\n    structuredOutput: z\n      .object({\n        schema: z.object({}).passthrough(),\n        model: z.union([z.string(), z.any()]).optional(),\n        instructions: z.string().optional(),\n        jsonPromptInjection: z.boolean().optional(),\n        errorStrategy: z.enum(['strict', 'warn', 'fallback']).optional(),\n        fallbackValue: z.any().optional(),\n      })\n      .optional(),\n  })\n  .passthrough(); // Allow additional fields for forward compatibility\n\n/**\n * Legacy body schema for deprecated endpoints that still use threadId/resourceId\n * Used by /agents/:agentId/generate-legacy and /agents/:agentId/stream-legacy\n */\nexport const agentExecutionLegacyBodySchema = agentExecutionBodySchema.extend({\n  resourceId: z.string().optional(),\n  resourceid: z.string().optional(), // lowercase variant\n  threadId: z.string().optional(),\n});\n\n/**\n * Body schema for tool execute endpoint\n * Simple schema - tool validates its own input data\n * Note: Using z.custom() instead of z.any()/z.any() because those are treated as optional by Zod\n */\n\nconst executeToolDataBodySchema = z.object({\n  data: z.custom<unknown>(x => x !== undefined, { message: 'data is required' }),\n});\n\nexport const executeToolBodySchema = executeToolDataBodySchema.extend({\n  requestContext: z.record(z.string(), z.any()).optional(),\n});\n\nexport const executeToolContextBodySchema = executeToolDataBodySchema.extend({\n  requestContext: z.record(z.string(), z.any()).optional(),\n});\n\n/**\n * Response schema for voice speakers endpoint\n * Flexible to accommodate provider-specific metadata\n */\nexport const voiceSpeakersResponseSchema = z.array(\n  z\n    .object({\n      voiceId: z.string(),\n    })\n    .passthrough(), // Allow provider-specific fields like name, language, etc.\n);\n\n// ============================================================================\n// Tool Approval Schemas\n// ============================================================================\n\n/**\n * Base schema for tool approval/decline operations\n * Both approve and decline use the same parameters\n */\nconst toolCallActionBodySchema = z.object({\n  runId: z.string(),\n  requestContext: z.record(z.string(), z.any()).optional(),\n  toolCallId: z.string(),\n  format: z.string().optional(),\n});\nconst networkToolCallActionBodySchema = z.object({\n  runId: z.string(),\n  requestContext: z.record(z.string(), z.any()).optional(),\n  format: z.string().optional(),\n});\n\n/**\n * Body schema for approving tool call\n */\nexport const approveToolCallBodySchema = toolCallActionBodySchema;\n\n/**\n * Body schema for declining tool call\n */\nexport const declineToolCallBodySchema = toolCallActionBodySchema;\n\n/**\n * Body schema for approving network tool call\n */\nexport const approveNetworkToolCallBodySchema = networkToolCallActionBodySchema;\n\n/**\n * Body schema for declining network tool call\n */\nexport const declineNetworkToolCallBodySchema = networkToolCallActionBodySchema;\n\n/**\n * Response schema for tool approval/decline\n */\nexport const toolCallResponseSchema = z.object({\n  fullStream: z.any(), // ReadableStream\n});\n\n// ============================================================================\n// Model Management Schemas\n// ============================================================================\n\n/**\n * Body schema for updating agent model\n */\nexport const updateAgentModelBodySchema = z.object({\n  modelId: z.string(),\n  provider: z.string(),\n});\n\n/**\n * Body schema for reordering agent model list\n */\nexport const reorderAgentModelListBodySchema = z.object({\n  reorderedModelIds: z.array(z.string()),\n});\n\n/**\n * Body schema for updating model in model list\n */\nexport const updateAgentModelInModelListBodySchema = z.object({\n  model: z\n    .object({\n      modelId: z.string(),\n      provider: z.string(),\n    })\n    .optional(),\n  maxRetries: z.number().optional(),\n  enabled: z.boolean().optional(),\n});\n\n/**\n * Response schema for model management operations\n */\nexport const modelManagementResponseSchema = messageResponseSchema;\n\n// ============================================================================\n// Voice Schemas\n// ============================================================================\n\n/**\n * Body schema for generating speech\n */\nexport const generateSpeechBodySchema = z.object({\n  text: z.string(),\n  speakerId: z.string().optional(),\n});\n\n/**\n * Body schema for transcribing speech\n */\nexport const transcribeSpeechBodySchema = z.object({\n  audio: z.any(), // Buffer\n  options: z.record(z.string(), z.any()).optional(),\n});\n\n/**\n * Response schema for transcribe speech\n */\nexport const transcribeSpeechResponseSchema = z.object({\n  text: z.string(),\n});\n\n/**\n * Response schema for get listener\n */\nexport const getListenerResponseSchema = z.any(); // Listener info structure varies\n\n/**\n * Response schema for agent generation endpoints\n * These return AI SDK types which have complex structures\n */\nexport const generateResponseSchema = z.any(); // AI SDK GenerateResult type\nexport const streamResponseSchema = z.any(); // AI SDK StreamResult type\nexport const speakResponseSchema = z.any(); // Voice synthesis result\nexport const executeToolResponseSchema = z.any(); // Tool execution result varies by tool\n\n// ============================================================================\n// Instruction Enhancement Schemas\n// ============================================================================\n\n/**\n * Body schema for enhancing agent instructions\n */\nexport const enhanceInstructionsBodySchema = z.object({\n  instructions: z.string().describe('The current agent instructions to enhance'),\n  comment: z.string().describe('User comment describing how to enhance the instructions'),\n});\n\n/**\n * Response schema for enhanced instructions\n */\nexport const enhanceInstructionsResponseSchema = z.object({\n  explanation: z.string().describe('Explanation of the changes made'),\n  new_prompt: z.string().describe('The enhanced instructions'),\n});\n"]}