@vfarcic/dot-ai 1.0.2 → 1.1.0

package/dist/interfaces/routes/index.js

@@ -0,0 +1,347 @@
+"use strict";
+/**
+ * REST API Route Definitions
+ *
+ * Central registration of all REST API routes with their Zod schemas.
+ * This is the single source of truth for routing, OpenAPI generation, and fixture validation.
+ *
+ * PRD #354: REST API Route Registry with Auto-Generated OpenAPI and Test Fixtures
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.routeDefinitions = void 0;
+exports.registerAllRoutes = registerAllRoutes;
+exports.getRouteCount = getRouteCount;
+const zod_1 = require("zod");
+const schemas_1 = require("../schemas");
+/**
+ * Query parameter schemas for various endpoints
+ */
+const ToolDiscoveryQuerySchema = zod_1.z.object({
+    category: zod_1.z.string().optional().describe('Filter tools by category'),
+    tag: zod_1.z.string().optional().describe('Filter tools by tag'),
+    search: zod_1.z.string().optional().describe('Search tools by name or description'),
+});
+const ResourceSearchQuerySchema = zod_1.z.object({
+    q: zod_1.z.string().describe('Search query'),
+    limit: zod_1.z.coerce.number().optional().default(20).describe('Maximum results to return'),
+    offset: zod_1.z.coerce.number().optional().default(0).describe('Offset for pagination'),
+});
+const ResourceListQuerySchema = zod_1.z.object({
+    kind: zod_1.z.string().describe('Resource kind (e.g., Pod, Deployment)'),
+    apiVersion: zod_1.z.string().describe('API version (e.g., v1, apps/v1)'),
+    namespace: zod_1.z.string().optional().describe('Filter by namespace'),
+    limit: zod_1.z.coerce.number().optional().describe('Maximum results to return'),
+    offset: zod_1.z.coerce.number().optional().describe('Offset for pagination'),
+});
+const SingleResourceQuerySchema = zod_1.z.object({
+    kind: zod_1.z.string().describe('Resource kind'),
+    apiVersion: zod_1.z.string().describe('API version'),
+    name: zod_1.z.string().describe('Resource name'),
+    namespace: zod_1.z.string().optional().describe('Namespace (for namespaced resources)'),
+});
+const ResourceKindsQuerySchema = zod_1.z.object({
+    namespace: zod_1.z.string().optional().describe('Filter kinds by namespace'),
+});
+const EventsQuerySchema = zod_1.z.object({
+    name: zod_1.z.string().describe('Resource name'),
+    kind: zod_1.z.string().describe('Resource kind'),
+    namespace: zod_1.z.string().optional().describe('Resource namespace'),
+});
+const LogsQuerySchema = zod_1.z.object({
+    name: zod_1.z.string().describe('Pod name'),
+    namespace: zod_1.z.string().describe('Pod namespace'),
+    container: zod_1.z.string().optional().describe('Container name (defaults to first container)'),
+    tailLines: zod_1.z.coerce.number().optional().describe('Number of lines from end'),
+    previous: zod_1.z.coerce.boolean().optional().describe('Get logs from previous container instance'),
+});
+const VisualizationQuerySchema = zod_1.z.object({
+    reload: zod_1.z.coerce.boolean().optional().describe('Force regeneration of visualization'),
+});
+/**
+ * Path parameter schemas
+ */
+const ToolNameParamsSchema = zod_1.z.object({
+    toolName: zod_1.z.string().describe('Name of the tool to execute'),
+});
+const PromptNameParamsSchema = zod_1.z.object({
+    promptName: zod_1.z.string().describe('Name of the prompt'),
+});
+const SessionIdParamsSchema = zod_1.z.object({
+    sessionId: zod_1.z.string().describe('Session ID'),
+});
+const SourceIdentifierParamsSchema = zod_1.z.object({
+    sourceIdentifier: zod_1.z.string().describe('Source identifier (e.g., namespace/name of GitKnowledgeSource CR)'),
+});
+const KnowledgeAskBodySchema = zod_1.z.object({
+    query: zod_1.z.string().min(1).describe('The question to answer from the knowledge base'),
+    limit: zod_1.z.coerce.number().optional().default(20).describe('Maximum chunks to retrieve per search (default: 20)'),
+    uriFilter: zod_1.z.string().optional().describe('Optional: filter searches to specific document URI'),
+});
+/**
+ * OpenAPI schema placeholder - returns raw OpenAPI spec object
+ */
+const OpenApiResponseSchema = zod_1.z.object({
+    openapi: zod_1.z.string(),
+    info: zod_1.z.object({
+        title: zod_1.z.string(),
+        description: zod_1.z.string(),
+        version: zod_1.z.string(),
+    }),
+    paths: zod_1.z.record(zod_1.z.string(), zod_1.z.any()),
+}).passthrough();
+/**
+ * All route definitions for the REST API
+ */
+exports.routeDefinitions = [
+    // ============================================
+    // Tool Endpoints
+    // ============================================
+    {
+        path: '/api/v1/tools',
+        method: 'GET',
+        description: 'Discover available tools with optional filtering by category, tag, or search term',
+        tags: ['Tools'],
+        query: ToolDiscoveryQuerySchema,
+        response: schemas_1.ToolDiscoveryResponseSchema,
+        errorResponses: {
+            500: schemas_1.InternalServerErrorSchema,
+        },
+    },
+    {
+        path: '/api/v1/tools/:toolName',
+        method: 'POST',
+        description: 'Execute a tool with the provided parameters',
+        tags: ['Tools'],
+        params: ToolNameParamsSchema,
+        body: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).describe('Tool execution parameters'),
+        response: schemas_1.ToolExecutionResponseSchema,
+        errorResponses: {
+            400: schemas_1.InvalidToolRequestErrorSchema,
+            404: schemas_1.ToolNotFoundErrorSchema,
+            500: schemas_1.ToolExecutionErrorSchema,
+        },
+    },
+    // ============================================
+    // OpenAPI Endpoint
+    // ============================================
+    {
+        path: '/api/v1/openapi',
+        method: 'GET',
+        description: 'Get the OpenAPI 3.0 specification for this API',
+        tags: ['Documentation'],
+        response: OpenApiResponseSchema,
+        errorResponses: {
+            500: schemas_1.InternalServerErrorSchema,
+        },
+    },
+    // ============================================
+    // Resource Endpoints
+    // ============================================
+    {
+        path: '/api/v1/resources',
+        method: 'GET',
+        description: 'List resources filtered by kind and optional namespace',
+        tags: ['Resources'],
+        query: ResourceListQuerySchema,
+        response: schemas_1.ResourceListResponseSchema,
+        errorResponses: {
+            400: schemas_1.ResourceBadRequestErrorSchema,
+            503: schemas_1.ResourcePluginUnavailableErrorSchema,
+            500: schemas_1.InternalServerErrorSchema,
+        },
+    },
+    {
+        path: '/api/v1/resources/kinds',
+        method: 'GET',
+        description: 'List all resource kinds available in the cluster with counts',
+        tags: ['Resources'],
+        query: ResourceKindsQuerySchema,
+        response: schemas_1.ResourceKindsResponseSchema,
+        errorResponses: {
+            503: schemas_1.ResourcePluginUnavailableErrorSchema,
+            500: schemas_1.InternalServerErrorSchema,
+        },
+    },
+    {
+        path: '/api/v1/resources/search',
+        method: 'GET',
+        description: 'Search for resources using semantic search',
+        tags: ['Resources'],
+        query: ResourceSearchQuerySchema,
+        response: schemas_1.ResourceSearchResponseSchema,
+        errorResponses: {
+            400: schemas_1.ResourceBadRequestErrorSchema,
+            503: schemas_1.ResourcePluginUnavailableErrorSchema,
+            500: schemas_1.InternalServerErrorSchema,
+        },
+    },
+    {
+        path: '/api/v1/resources/sync',
+        method: 'POST',
+        description: 'Sync resources from the Kubernetes controller',
+        tags: ['Resources'],
+        body: schemas_1.ResourceSyncRequestSchema,
+        response: schemas_1.ResourceSyncResponseSchema,
+        errorResponses: {
+            400: schemas_1.ResourceBadRequestErrorSchema,
+            500: schemas_1.InternalServerErrorSchema,
+        },
+    },
+    {
+        path: '/api/v1/resource',
+        method: 'GET',
+        description: 'Get a single resource with full details including live status',
+        tags: ['Resources'],
+        query: SingleResourceQuerySchema,
+        response: schemas_1.SingleResourceResponseSchema,
+        errorResponses: {
+            400: schemas_1.ResourceBadRequestErrorSchema,
+            404: schemas_1.NotFoundErrorSchema,
+            503: schemas_1.ResourcePluginUnavailableErrorSchema,
+            500: schemas_1.InternalServerErrorSchema,
+        },
+    },
+    {
+        path: '/api/v1/namespaces',
+        method: 'GET',
+        description: 'List all namespaces in the cluster',
+        tags: ['Resources'],
+        response: schemas_1.NamespacesResponseSchema,
+        errorResponses: {
+            503: schemas_1.ResourcePluginUnavailableErrorSchema,
+            500: schemas_1.InternalServerErrorSchema,
+        },
+    },
+    // ============================================
+    // Events Endpoint
+    // ============================================
+    {
+        path: '/api/v1/events',
+        method: 'GET',
+        description: 'Get Kubernetes events for a specific resource',
+        tags: ['Observability'],
+        query: EventsQuerySchema,
+        response: schemas_1.EventsResponseSchema,
+        errorResponses: {
+            400: schemas_1.EventsBadRequestErrorSchema,
+            503: schemas_1.EventsPluginUnavailableErrorSchema,
+            500: schemas_1.InternalServerErrorSchema,
+        },
+    },
+    // ============================================
+    // Logs Endpoint
+    // ============================================
+    {
+        path: '/api/v1/logs',
+        method: 'GET',
+        description: 'Get container logs from a pod',
+        tags: ['Observability'],
+        query: LogsQuerySchema,
+        response: schemas_1.LogsResponseSchema,
+        errorResponses: {
+            400: schemas_1.LogsBadRequestErrorSchema,
+            503: schemas_1.LogsPluginUnavailableErrorSchema,
+            500: schemas_1.InternalServerErrorSchema,
+        },
+    },
+    // ============================================
+    // Prompts Endpoints
+    // ============================================
+    {
+        path: '/api/v1/prompts',
+        method: 'GET',
+        description: 'List all available prompts',
+        tags: ['Prompts'],
+        response: schemas_1.PromptsListResponseSchema,
+        errorResponses: {
+            500: schemas_1.InternalServerErrorSchema,
+        },
+    },
+    {
+        path: '/api/v1/prompts/:promptName',
+        method: 'POST',
+        description: 'Get a prompt with rendered template arguments',
+        tags: ['Prompts'],
+        params: PromptNameParamsSchema,
+        body: schemas_1.PromptGetRequestSchema,
+        response: schemas_1.PromptGetResponseSchema,
+        errorResponses: {
+            404: schemas_1.PromptNotFoundErrorSchema,
+            500: schemas_1.InternalServerErrorSchema,
+        },
+    },
+    // ============================================
+    // Visualization Endpoint
+    // ============================================
+    {
+        path: '/api/v1/visualize/:sessionId',
+        method: 'GET',
+        description: 'Get structured visualization data for a session',
+        tags: ['Visualization'],
+        params: SessionIdParamsSchema,
+        query: VisualizationQuerySchema,
+        response: schemas_1.VisualizationResponseSchema,
+        errorResponses: {
+            404: schemas_1.VisualizationNotFoundErrorSchema,
+            503: schemas_1.VisualizationServiceUnavailableErrorSchema,
+            500: schemas_1.InternalServerErrorSchema,
+        },
+    },
+    // ============================================
+    // Sessions Endpoint
+    // ============================================
+    {
+        path: '/api/v1/sessions/:sessionId',
+        method: 'GET',
+        description: 'Get raw session data for any tool type (remediate, query, recommend, etc.)',
+        tags: ['Sessions'],
+        params: SessionIdParamsSchema,
+        response: schemas_1.SessionResponseSchema,
+        errorResponses: {
+            404: schemas_1.SessionNotFoundErrorSchema,
+            500: schemas_1.InternalServerErrorSchema,
+        },
+    },
+    // ============================================
+    // Knowledge Base Endpoints (PRD #356)
+    // ============================================
+    {
+        path: '/api/v1/knowledge/source/:sourceIdentifier',
+        method: 'DELETE',
+        description: 'Delete all knowledge base chunks for a source identifier. Used by controller for GitKnowledgeSource cleanup.',
+        tags: ['Knowledge'],
+        params: SourceIdentifierParamsSchema,
+        response: schemas_1.DeleteBySourceResponseSchema,
+        errorResponses: {
+            503: schemas_1.DeleteBySourcePluginUnavailableErrorSchema,
+            500: schemas_1.DeleteBySourceErrorSchema,
+        },
+    },
+    {
+        path: '/api/v1/knowledge/ask',
+        method: 'POST',
+        description: 'Ask a question and receive an AI-synthesized answer from the knowledge base. Uses an agentic approach that can search multiple times with different phrasings for comprehensive answers.',
+        tags: ['Knowledge'],
+        body: KnowledgeAskBodySchema,
+        response: schemas_1.KnowledgeAskResponseSchema,
+        errorResponses: {
+            400: schemas_1.KnowledgeAskBadRequestErrorSchema,
+            503: schemas_1.ServiceUnavailableErrorSchema,
+            500: schemas_1.KnowledgeAskErrorSchema,
+        },
+    },
+];
+/**
+ * Register all routes with the provided registry
+ */
+function registerAllRoutes(registry) {
+    for (const route of exports.routeDefinitions) {
+        registry.register(route);
+    }
+}
+/**
+ * Get route count - useful for validation
+ */
+function getRouteCount() {
+    return exports.routeDefinitions.length;
+}

package/dist/interfaces/schemas/common.d.ts

@@ -0,0 +1,177 @@
+/**
+ * Common REST API Response Schemas
+ *
+ * Base schemas used by all REST API endpoints.
+ * PRD #354: REST API Route Registry with Auto-Generated OpenAPI and Test Fixtures
+ */
+import { z } from 'zod';
+/**
+ * Response metadata schema
+ */
+export declare const MetaSchema: z.ZodObject<{
+    timestamp: z.ZodString;
+    requestId: z.ZodOptional<z.ZodString>;
+    version: z.ZodString;
+}, z.core.$strip>;
+export type Meta = z.infer<typeof MetaSchema>;
+/**
+ * Error details schema
+ */
+export declare const ErrorDetailsSchema: z.ZodObject<{
+    code: z.ZodString;
+    message: z.ZodString;
+    details: z.ZodOptional<z.ZodAny>;
+}, z.core.$strip>;
+export type ErrorDetails = z.infer<typeof ErrorDetailsSchema>;
+/**
+ * Base REST API response schema
+ * All endpoint responses extend this structure
+ */
+export declare const RestApiResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    data: z.ZodOptional<z.ZodAny>;
+    error: z.ZodOptional<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodAny>;
+    }, z.core.$strip>>;
+    meta: z.ZodOptional<z.ZodObject<{
+        timestamp: z.ZodString;
+        requestId: z.ZodOptional<z.ZodString>;
+        version: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type RestApiResponse = z.infer<typeof RestApiResponseSchema>;
+/**
+ * Success response factory - creates a typed success response schema
+ */
+export declare function createSuccessResponseSchema<T extends z.ZodTypeAny>(dataSchema: T): z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: T;
+    error: z.ZodOptional<z.ZodUndefined>;
+    meta: z.ZodOptional<z.ZodObject<{
+        timestamp: z.ZodString;
+        requestId: z.ZodOptional<z.ZodString>;
+        version: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Error response schema for failed requests
+ */
+export declare const ErrorResponseSchema: z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    data: z.ZodOptional<z.ZodUndefined>;
+    error: z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodAny>;
+    }, z.core.$strip>;
+    meta: z.ZodOptional<z.ZodObject<{
+        timestamp: z.ZodString;
+        requestId: z.ZodOptional<z.ZodString>;
+        version: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ErrorResponse = z.infer<typeof ErrorResponseSchema>;
+/**
+ * Common error response schemas by HTTP status
+ */
+export declare const NotFoundErrorSchema: z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    data: z.ZodOptional<z.ZodUndefined>;
+    meta: z.ZodOptional<z.ZodObject<{
+        timestamp: z.ZodString;
+        requestId: z.ZodOptional<z.ZodString>;
+        version: z.ZodString;
+    }, z.core.$strip>>;
+    error: z.ZodObject<{
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodAny>;
+        code: z.ZodLiteral<"NOT_FOUND">;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const BadRequestErrorSchema: z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    data: z.ZodOptional<z.ZodUndefined>;
+    meta: z.ZodOptional<z.ZodObject<{
+        timestamp: z.ZodString;
+        requestId: z.ZodOptional<z.ZodString>;
+        version: z.ZodString;
+    }, z.core.$strip>>;
+    error: z.ZodObject<{
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodAny>;
+        code: z.ZodEnum<{
+            BAD_REQUEST: "BAD_REQUEST";
+            INVALID_REQUEST: "INVALID_REQUEST";
+            MISSING_PARAMETER: "MISSING_PARAMETER";
+            INVALID_PARAMETER: "INVALID_PARAMETER";
+            VALIDATION_ERROR: "VALIDATION_ERROR";
+        }>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const MethodNotAllowedErrorSchema: z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    data: z.ZodOptional<z.ZodUndefined>;
+    meta: z.ZodOptional<z.ZodObject<{
+        timestamp: z.ZodString;
+        requestId: z.ZodOptional<z.ZodString>;
+        version: z.ZodString;
+    }, z.core.$strip>>;
+    error: z.ZodObject<{
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodAny>;
+        code: z.ZodLiteral<"METHOD_NOT_ALLOWED">;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const ServiceUnavailableErrorSchema: z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    data: z.ZodOptional<z.ZodUndefined>;
+    meta: z.ZodOptional<z.ZodObject<{
+        timestamp: z.ZodString;
+        requestId: z.ZodOptional<z.ZodString>;
+        version: z.ZodString;
+    }, z.core.$strip>>;
+    error: z.ZodObject<{
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodAny>;
+        code: z.ZodEnum<{
+            AI_NOT_CONFIGURED: "AI_NOT_CONFIGURED";
+            PLUGIN_UNAVAILABLE: "PLUGIN_UNAVAILABLE";
+            VECTOR_DB_UNAVAILABLE: "VECTOR_DB_UNAVAILABLE";
+            SERVICE_UNAVAILABLE: "SERVICE_UNAVAILABLE";
+        }>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const InternalServerErrorSchema: z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    data: z.ZodOptional<z.ZodUndefined>;
+    meta: z.ZodOptional<z.ZodObject<{
+        timestamp: z.ZodString;
+        requestId: z.ZodOptional<z.ZodString>;
+        version: z.ZodString;
+    }, z.core.$strip>>;
+    error: z.ZodObject<{
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodAny>;
+        code: z.ZodEnum<{
+            INTERNAL_ERROR: "INTERNAL_ERROR";
+            DISCOVERY_ERROR: "DISCOVERY_ERROR";
+            EXECUTION_ERROR: "EXECUTION_ERROR";
+            OPENAPI_ERROR: "OPENAPI_ERROR";
+            SYNC_ERROR: "SYNC_ERROR";
+            RESOURCE_KINDS_ERROR: "RESOURCE_KINDS_ERROR";
+            SEARCH_ERROR: "SEARCH_ERROR";
+            LIST_RESOURCES_ERROR: "LIST_RESOURCES_ERROR";
+            NAMESPACES_ERROR: "NAMESPACES_ERROR";
+            RESOURCE_ERROR: "RESOURCE_ERROR";
+            EVENTS_ERROR: "EVENTS_ERROR";
+            LOGS_ERROR: "LOGS_ERROR";
+            PROMPTS_LIST_ERROR: "PROMPTS_LIST_ERROR";
+            PROMPT_GET_ERROR: "PROMPT_GET_ERROR";
+            VISUALIZATION_ERROR: "VISUALIZATION_ERROR";
+            SESSION_RETRIEVAL_ERROR: "SESSION_RETRIEVAL_ERROR";
+        }>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+//# sourceMappingURL=common.d.ts.map

package/dist/interfaces/schemas/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/interfaces/schemas/common.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,UAAU;;;;iBAIrB,CAAC;AAEH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAE9C;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;iBAI7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;iBAKhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,CAAC;;;;;;;;;kBAOhF;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;iBAK9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;iBAI9B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;iBAIhC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;iBAItC,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;iBAIxC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqBpC,CAAC"}

package/dist/interfaces/schemas/common.js

@@ -0,0 +1,102 @@
+"use strict";
+/**
+ * Common REST API Response Schemas
+ *
+ * Base schemas used by all REST API endpoints.
+ * PRD #354: REST API Route Registry with Auto-Generated OpenAPI and Test Fixtures
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InternalServerErrorSchema = exports.ServiceUnavailableErrorSchema = exports.MethodNotAllowedErrorSchema = exports.BadRequestErrorSchema = exports.NotFoundErrorSchema = exports.ErrorResponseSchema = exports.RestApiResponseSchema = exports.ErrorDetailsSchema = exports.MetaSchema = void 0;
+exports.createSuccessResponseSchema = createSuccessResponseSchema;
+const zod_1 = require("zod");
+/**
+ * Response metadata schema
+ */
+exports.MetaSchema = zod_1.z.object({
+    timestamp: zod_1.z.string().describe('ISO 8601 timestamp of the response'),
+    requestId: zod_1.z.string().optional().describe('Unique request identifier for tracing'),
+    version: zod_1.z.string().describe('API version'),
+});
+/**
+ * Error details schema
+ */
+exports.ErrorDetailsSchema = zod_1.z.object({
+    code: zod_1.z.string().describe('Machine-readable error code'),
+    message: zod_1.z.string().describe('Human-readable error message'),
+    details: zod_1.z.any().optional().describe('Additional error context'),
+});
+/**
+ * Base REST API response schema
+ * All endpoint responses extend this structure
+ */
+exports.RestApiResponseSchema = zod_1.z.object({
+    success: zod_1.z.boolean().describe('Whether the request was successful'),
+    data: zod_1.z.any().optional().describe('Response payload'),
+    error: exports.ErrorDetailsSchema.optional().describe('Error information if success is false'),
+    meta: exports.MetaSchema.optional().describe('Response metadata'),
+});
+/**
+ * Success response factory - creates a typed success response schema
+ */
+function createSuccessResponseSchema(dataSchema) {
+    return zod_1.z.object({
+        success: zod_1.z.literal(true),
+        data: dataSchema,
+        error: zod_1.z.undefined().optional(),
+        meta: exports.MetaSchema.optional(),
+    });
+}
+/**
+ * Error response schema for failed requests
+ */
+exports.ErrorResponseSchema = zod_1.z.object({
+    success: zod_1.z.literal(false),
+    data: zod_1.z.undefined().optional(),
+    error: exports.ErrorDetailsSchema,
+    meta: exports.MetaSchema.optional(),
+});
+/**
+ * Common error response schemas by HTTP status
+ */
+exports.NotFoundErrorSchema = exports.ErrorResponseSchema.extend({
+    error: exports.ErrorDetailsSchema.extend({
+        code: zod_1.z.literal('NOT_FOUND'),
+    }),
+});
+exports.BadRequestErrorSchema = exports.ErrorResponseSchema.extend({
+    error: exports.ErrorDetailsSchema.extend({
+        code: zod_1.z.enum(['BAD_REQUEST', 'INVALID_REQUEST', 'MISSING_PARAMETER', 'INVALID_PARAMETER', 'VALIDATION_ERROR']),
+    }),
+});
+exports.MethodNotAllowedErrorSchema = exports.ErrorResponseSchema.extend({
+    error: exports.ErrorDetailsSchema.extend({
+        code: zod_1.z.literal('METHOD_NOT_ALLOWED'),
+    }),
+});
+exports.ServiceUnavailableErrorSchema = exports.ErrorResponseSchema.extend({
+    error: exports.ErrorDetailsSchema.extend({
+        code: zod_1.z.enum(['AI_NOT_CONFIGURED', 'PLUGIN_UNAVAILABLE', 'VECTOR_DB_UNAVAILABLE', 'SERVICE_UNAVAILABLE']),
+    }),
+});
+exports.InternalServerErrorSchema = exports.ErrorResponseSchema.extend({
+    error: exports.ErrorDetailsSchema.extend({
+        code: zod_1.z.enum([
+            'INTERNAL_ERROR',
+            'DISCOVERY_ERROR',
+            'EXECUTION_ERROR',
+            'OPENAPI_ERROR',
+            'SYNC_ERROR',
+            'RESOURCE_KINDS_ERROR',
+            'SEARCH_ERROR',
+            'LIST_RESOURCES_ERROR',
+            'NAMESPACES_ERROR',
+            'RESOURCE_ERROR',
+            'EVENTS_ERROR',
+            'LOGS_ERROR',
+            'PROMPTS_LIST_ERROR',
+            'PROMPT_GET_ERROR',
+            'VISUALIZATION_ERROR',
+            'SESSION_RETRIEVAL_ERROR',
+        ]),
+    }),
+});