@vfarcic/dot-ai 1.0.3 → 1.1.0

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

@@ -0,0 +1,373 @@
+/**
+ * Visualization Response Schemas
+ *
+ * Schemas for the /api/v1/visualize/:sessionId endpoint.
+ * PRD #354: REST API Route Registry with Auto-Generated OpenAPI and Test Fixtures
+ */
+import { z } from 'zod';
+/**
+ * Visualization types supported by the API
+ * PRD #320: Added 'diff' type for before/after comparisons
+ * PRD #328: Added 'bar-chart' type for metrics visualization
+ */
+export declare const VisualizationTypeSchema: z.ZodEnum<{
+    code: "code";
+    mermaid: "mermaid";
+    cards: "cards";
+    table: "table";
+    diff: "diff";
+    "bar-chart": "bar-chart";
+}>;
+export type VisualizationType = z.infer<typeof VisualizationTypeSchema>;
+/**
+ * Code visualization content
+ */
+export declare const CodeContentSchema: z.ZodObject<{
+    language: z.ZodString;
+    code: z.ZodString;
+}, z.core.$strip>;
+export type CodeContent = z.infer<typeof CodeContentSchema>;
+/**
+ * Table visualization content
+ */
+export declare const TableContentSchema: z.ZodObject<{
+    headers: z.ZodArray<z.ZodString>;
+    rows: z.ZodArray<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type TableContent = z.infer<typeof TableContentSchema>;
+/**
+ * Card item in cards visualization
+ */
+export declare const CardItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type CardItem = z.infer<typeof CardItemSchema>;
+/**
+ * Cards visualization content
+ */
+export declare const CardsContentSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>>;
+export type CardsContent = z.infer<typeof CardsContentSchema>;
+/**
+ * Diff visualization content (PRD #320)
+ */
+export declare const DiffContentSchema: z.ZodObject<{
+    before: z.ZodObject<{
+        language: z.ZodString;
+        code: z.ZodString;
+    }, z.core.$strip>;
+    after: z.ZodObject<{
+        language: z.ZodString;
+        code: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type DiffContent = z.infer<typeof DiffContentSchema>;
+/**
+ * Bar chart data item (PRD #328)
+ */
+export declare const BarChartDataItemSchema: z.ZodObject<{
+    label: z.ZodString;
+    value: z.ZodNumber;
+    max: z.ZodOptional<z.ZodNumber>;
+    status: z.ZodOptional<z.ZodEnum<{
+        error: "error";
+        warning: "warning";
+        ok: "ok";
+    }>>;
+}, z.core.$strip>;
+export type BarChartDataItem = z.infer<typeof BarChartDataItemSchema>;
+/**
+ * Bar chart visualization content (PRD #328)
+ */
+export declare const BarChartContentSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        value: z.ZodNumber;
+        max: z.ZodOptional<z.ZodNumber>;
+        status: z.ZodOptional<z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+            ok: "ok";
+        }>>;
+    }, z.core.$strip>>;
+    unit: z.ZodOptional<z.ZodString>;
+    orientation: z.ZodOptional<z.ZodEnum<{
+        horizontal: "horizontal";
+        vertical: "vertical";
+    }>>;
+}, z.core.$strip>;
+export type BarChartContent = z.infer<typeof BarChartContentSchema>;
+/**
+ * Visualization content union type
+ * Content varies based on visualization type
+ */
+export declare const VisualizationContentSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    language: z.ZodString;
+    code: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    headers: z.ZodArray<z.ZodString>;
+    rows: z.ZodArray<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>, z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>>, z.ZodObject<{
+    before: z.ZodObject<{
+        language: z.ZodString;
+        code: z.ZodString;
+    }, z.core.$strip>;
+    after: z.ZodObject<{
+        language: z.ZodString;
+        code: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        value: z.ZodNumber;
+        max: z.ZodOptional<z.ZodNumber>;
+        status: z.ZodOptional<z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+            ok: "ok";
+        }>>;
+    }, z.core.$strip>>;
+    unit: z.ZodOptional<z.ZodString>;
+    orientation: z.ZodOptional<z.ZodEnum<{
+        horizontal: "horizontal";
+        vertical: "vertical";
+    }>>;
+}, z.core.$strip>]>;
+export type VisualizationContent = z.infer<typeof VisualizationContentSchema>;
+/**
+ * Individual visualization item
+ */
+export declare const VisualizationSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    type: z.ZodEnum<{
+        code: "code";
+        mermaid: "mermaid";
+        cards: "cards";
+        table: "table";
+        diff: "diff";
+        "bar-chart": "bar-chart";
+    }>;
+    content: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        language: z.ZodString;
+        code: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        headers: z.ZodArray<z.ZodString>;
+        rows: z.ZodArray<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>, z.ZodObject<{
+        before: z.ZodObject<{
+            language: z.ZodString;
+            code: z.ZodString;
+        }, z.core.$strip>;
+        after: z.ZodObject<{
+            language: z.ZodString;
+            code: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        data: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            value: z.ZodNumber;
+            max: z.ZodOptional<z.ZodNumber>;
+            status: z.ZodOptional<z.ZodEnum<{
+                error: "error";
+                warning: "warning";
+                ok: "ok";
+            }>>;
+        }, z.core.$strip>>;
+        unit: z.ZodOptional<z.ZodString>;
+        orientation: z.ZodOptional<z.ZodEnum<{
+            horizontal: "horizontal";
+            vertical: "vertical";
+        }>>;
+    }, z.core.$strip>]>;
+}, z.core.$strip>;
+export type Visualization = z.infer<typeof VisualizationSchema>;
+/**
+ * Visualization endpoint response data
+ * PRD #320: Added toolsUsed for test validation
+ */
+export declare const VisualizationResponseDataSchema: z.ZodObject<{
+    title: z.ZodString;
+    visualizations: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        type: z.ZodEnum<{
+            code: "code";
+            mermaid: "mermaid";
+            cards: "cards";
+            table: "table";
+            diff: "diff";
+            "bar-chart": "bar-chart";
+        }>;
+        content: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            language: z.ZodString;
+            code: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            headers: z.ZodArray<z.ZodString>;
+            rows: z.ZodArray<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>, z.ZodObject<{
+            before: z.ZodObject<{
+                language: z.ZodString;
+                code: z.ZodString;
+            }, z.core.$strip>;
+            after: z.ZodObject<{
+                language: z.ZodString;
+                code: z.ZodString;
+            }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
+            data: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                value: z.ZodNumber;
+                max: z.ZodOptional<z.ZodNumber>;
+                status: z.ZodOptional<z.ZodEnum<{
+                    error: "error";
+                    warning: "warning";
+                    ok: "ok";
+                }>>;
+            }, z.core.$strip>>;
+            unit: z.ZodOptional<z.ZodString>;
+            orientation: z.ZodOptional<z.ZodEnum<{
+                horizontal: "horizontal";
+                vertical: "vertical";
+            }>>;
+        }, z.core.$strip>]>;
+    }, z.core.$strip>>;
+    insights: z.ZodArray<z.ZodString>;
+    toolsUsed: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type VisualizationResponseData = z.infer<typeof VisualizationResponseDataSchema>;
+/**
+ * Full visualization endpoint response
+ */
+export declare const VisualizationResponseSchema: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        title: z.ZodString;
+        visualizations: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            type: z.ZodEnum<{
+                code: "code";
+                mermaid: "mermaid";
+                cards: "cards";
+                table: "table";
+                diff: "diff";
+                "bar-chart": "bar-chart";
+            }>;
+            content: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                language: z.ZodString;
+                code: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                headers: z.ZodArray<z.ZodString>;
+                rows: z.ZodArray<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>, z.ZodObject<{
+                before: z.ZodObject<{
+                    language: z.ZodString;
+                    code: z.ZodString;
+                }, z.core.$strip>;
+                after: z.ZodObject<{
+                    language: z.ZodString;
+                    code: z.ZodString;
+                }, z.core.$strip>;
+            }, z.core.$strip>, z.ZodObject<{
+                data: z.ZodArray<z.ZodObject<{
+                    label: z.ZodString;
+                    value: z.ZodNumber;
+                    max: z.ZodOptional<z.ZodNumber>;
+                    status: z.ZodOptional<z.ZodEnum<{
+                        error: "error";
+                        warning: "warning";
+                        ok: "ok";
+                    }>>;
+                }, z.core.$strip>>;
+                unit: z.ZodOptional<z.ZodString>;
+                orientation: z.ZodOptional<z.ZodEnum<{
+                    horizontal: "horizontal";
+                    vertical: "vertical";
+                }>>;
+            }, z.core.$strip>]>;
+        }, z.core.$strip>>;
+        insights: z.ZodArray<z.ZodString>;
+        toolsUsed: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+    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>;
+export type VisualizationResponse = z.infer<typeof VisualizationResponseSchema>;
+/**
+ * Visualization endpoint error responses
+ */
+export declare const VisualizationNotFoundErrorSchema: 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<{
+        code: z.ZodLiteral<"SESSION_NOT_FOUND">;
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodAny>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const VisualizationServiceUnavailableErrorSchema: 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<{
+        code: z.ZodLiteral<"AI_NOT_CONFIGURED">;
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodAny>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const VisualizationInternalErrorSchema: 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<{
+        code: z.ZodLiteral<"VISUALIZATION_ERROR">;
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodAny>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+//# sourceMappingURL=visualization.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"visualization.d.ts","sourceRoot":"","sources":["../../../src/interfaces/schemas/visualization.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;;;;;EAOlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;iBAG5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;iBAG7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;iBAKzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;kBAA0B,CAAC;AAE1D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;iBAG5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;iBAKjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;iBAIhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAOrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAK9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAK1C,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAA+D,CAAC;AAExG,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;iBAM3C,CAAC;AAEH,eAAO,MAAM,0CAA0C;;;;;;;;;;;;;iBAMrD,CAAC;AAEH,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;iBAM3C,CAAC"}

package/dist/interfaces/schemas/visualization.js

@@ -0,0 +1,134 @@
+"use strict";
+/**
+ * Visualization Response Schemas
+ *
+ * Schemas for the /api/v1/visualize/:sessionId endpoint.
+ * PRD #354: REST API Route Registry with Auto-Generated OpenAPI and Test Fixtures
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VisualizationInternalErrorSchema = exports.VisualizationServiceUnavailableErrorSchema = exports.VisualizationNotFoundErrorSchema = exports.VisualizationResponseSchema = exports.VisualizationResponseDataSchema = exports.VisualizationSchema = exports.VisualizationContentSchema = exports.BarChartContentSchema = exports.BarChartDataItemSchema = exports.DiffContentSchema = exports.CardsContentSchema = exports.CardItemSchema = exports.TableContentSchema = exports.CodeContentSchema = exports.VisualizationTypeSchema = void 0;
+const zod_1 = require("zod");
+const common_1 = require("./common");
+/**
+ * Visualization types supported by the API
+ * PRD #320: Added 'diff' type for before/after comparisons
+ * PRD #328: Added 'bar-chart' type for metrics visualization
+ */
+exports.VisualizationTypeSchema = zod_1.z.enum([
+    'mermaid',
+    'cards',
+    'code',
+    'table',
+    'diff',
+    'bar-chart',
+]);
+/**
+ * Code visualization content
+ */
+exports.CodeContentSchema = zod_1.z.object({
+    language: zod_1.z.string().describe('Programming language for syntax highlighting'),
+    code: zod_1.z.string().describe('Code content'),
+});
+/**
+ * Table visualization content
+ */
+exports.TableContentSchema = zod_1.z.object({
+    headers: zod_1.z.array(zod_1.z.string()).describe('Column headers'),
+    rows: zod_1.z.array(zod_1.z.array(zod_1.z.string())).describe('Table rows'),
+});
+/**
+ * Card item in cards visualization
+ */
+exports.CardItemSchema = zod_1.z.object({
+    id: zod_1.z.string().describe('Unique card identifier'),
+    title: zod_1.z.string().describe('Card title'),
+    description: zod_1.z.string().optional().describe('Card description'),
+    tags: zod_1.z.array(zod_1.z.string()).optional().describe('Tags/labels for the card'),
+});
+/**
+ * Cards visualization content
+ */
+exports.CardsContentSchema = zod_1.z.array(exports.CardItemSchema);
+/**
+ * Diff visualization content (PRD #320)
+ */
+exports.DiffContentSchema = zod_1.z.object({
+    before: exports.CodeContentSchema.describe('Code before changes'),
+    after: exports.CodeContentSchema.describe('Code after changes'),
+});
+/**
+ * Bar chart data item (PRD #328)
+ */
+exports.BarChartDataItemSchema = zod_1.z.object({
+    label: zod_1.z.string().describe('Data point label (e.g., "node-1", "kube-system")'),
+    value: zod_1.z.number().describe('Numeric value'),
+    max: zod_1.z.number().optional().describe('Maximum value for percentage calculation'),
+    status: zod_1.z.enum(['error', 'warning', 'ok']).optional().describe('Status for color-coding'),
+});
+/**
+ * Bar chart visualization content (PRD #328)
+ */
+exports.BarChartContentSchema = zod_1.z.object({
+    data: zod_1.z.array(exports.BarChartDataItemSchema).describe('Chart data points'),
+    unit: zod_1.z.string().optional().describe('Unit label (e.g., "Gi", "cores", "%")'),
+    orientation: zod_1.z.enum(['horizontal', 'vertical']).optional().describe('Chart orientation'),
+});
+/**
+ * Visualization content union type
+ * Content varies based on visualization type
+ */
+exports.VisualizationContentSchema = zod_1.z.union([
+    zod_1.z.string(), // mermaid diagram code
+    exports.CodeContentSchema, // code block
+    exports.TableContentSchema, // table
+    exports.CardsContentSchema, // array of cards
+    exports.DiffContentSchema, // diff view
+    exports.BarChartContentSchema, // bar chart
+]);
+/**
+ * Individual visualization item
+ */
+exports.VisualizationSchema = zod_1.z.object({
+    id: zod_1.z.string().describe('Unique visualization identifier'),
+    label: zod_1.z.string().describe('Display label'),
+    type: exports.VisualizationTypeSchema.describe('Visualization type'),
+    content: exports.VisualizationContentSchema.describe('Visualization content (varies by type)'),
+});
+/**
+ * Visualization endpoint response data
+ * PRD #320: Added toolsUsed for test validation
+ */
+exports.VisualizationResponseDataSchema = zod_1.z.object({
+    title: zod_1.z.string().describe('Title of the visualization'),
+    visualizations: zod_1.z.array(exports.VisualizationSchema).describe('Array of visualizations'),
+    insights: zod_1.z.array(zod_1.z.string()).describe('AI-generated insights about the data'),
+    toolsUsed: zod_1.z.array(zod_1.z.string()).optional().describe('Tools called during visualization generation'),
+});
+/**
+ * Full visualization endpoint response
+ */
+exports.VisualizationResponseSchema = (0, common_1.createSuccessResponseSchema)(exports.VisualizationResponseDataSchema);
+/**
+ * Visualization endpoint error responses
+ */
+exports.VisualizationNotFoundErrorSchema = common_1.NotFoundErrorSchema.extend({
+    error: zod_1.z.object({
+        code: zod_1.z.literal('SESSION_NOT_FOUND'),
+        message: zod_1.z.string(),
+        details: zod_1.z.any().optional(),
+    }),
+});
+exports.VisualizationServiceUnavailableErrorSchema = common_1.ServiceUnavailableErrorSchema.extend({
+    error: zod_1.z.object({
+        code: zod_1.z.literal('AI_NOT_CONFIGURED'),
+        message: zod_1.z.string(),
+        details: zod_1.z.any().optional(),
+    }),
+});
+exports.VisualizationInternalErrorSchema = common_1.InternalServerErrorSchema.extend({
+    error: zod_1.z.object({
+        code: zod_1.z.literal('VISUALIZATION_ERROR'),
+        message: zod_1.z.string(),
+        details: zod_1.z.any().optional(),
+    }),
+});

package/dist/mcp/server.js

@@ -47,6 +47,7 @@ const mcp_js_1 = require("../interfaces/mcp.js");
 const index_js_1 = require("../core/index.js");
 const index_js_2 = require("../core/tracing/index.js");
 const index_js_3 = require("../core/telemetry/index.js");
+const plugin_registry_js_1 = require("../core/plugin-registry.js");
 const fs_1 = require("fs");
 const path_1 = __importDefault(require("path"));
 const plugin_manager_js_1 = require("../core/plugin-manager.js");
@@ -98,7 +99,7 @@ async function main() {
                 fs.unlinkSync(testFile);
                 process.stderr.write(`Session directory validated: ${sessionDir}\n`);
             }
-            catch (writeError) {
+            catch {
                 process.stderr.write(`FATAL: Session directory is not writable: ${sessionDir}\n`);
                 process.stderr.write('Solution: Fix directory permissions or use a different directory\n');
                 process.exit(1);
@@ -160,10 +161,10 @@ async function main() {
         else {
             process.stderr.write('No plugins configured (mount plugins.json at /etc/dot-ai/plugins.json to enable)\n');
         }
-        // PRD #343: Set plugin manager for telemetry before first use
-        // This enables cluster ID generation via plugin instead of direct K8s client
+        // PRD #359: Initialize unified plugin registry for all plugin tool invocations
+        // This replaces scattered plugin manager passing (telemetry, vector tools, etc.)
         if (pluginConfigs.length > 0) {
-            (0, index_js_3.setTelemetryPluginManager)(pluginManager);
+            (0, plugin_registry_js_1.initializePluginRegistry)(pluginManager);
         }
         // Create and configure MCP server
         const mcpServer = new mcp_js_1.MCPServer(dotAI, {

package/dist/tools/answer-question.d.ts

@@ -23,7 +23,7 @@ export declare const ANSWERQUESTION_TOOL_INPUT_SCHEMA: {
 export declare function handleAnswerQuestionTool(args: {
     solutionId: string;
     stage: 'required' | 'basic' | 'advanced' | 'open';
-    answers: Record<string, any>;
+    answers: Record<string, unknown>;
     interaction_id?: string;
 }, dotAI: DotAI, logger: Logger, requestId: string): Promise<{
     content: {

package/dist/tools/answer-question.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"answer-question.d.ts","sourceRoot":"","sources":["../../src/tools/answer-question.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAOhD,eAAO,MAAM,wBAAwB,mBAAmB,CAAC;AACzD,eAAO,MAAM,+BAA+B,8HAA4H,CAAC;AAGzK,eAAO,MAAM,gCAAgC;;;;;;;;;;CAK5C,CAAC;AAwhBF;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,EACtI,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,CAAC,CAqVxD"}
+{"version":3,"file":"answer-question.d.ts","sourceRoot":"","sources":["../../src/tools/answer-question.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAuEhD,eAAO,MAAM,wBAAwB,mBAAmB,CAAC;AACzD,eAAO,MAAM,+BAA+B,8HAA4H,CAAC;AAGzK,eAAO,MAAM,gCAAgC;;;;;;;;;;CAK5C,CAAC;AAyhBF;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,EAC1I,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,CAAC,CAqVxD"}

package/dist/tools/answer-question.js

@@ -140,7 +140,7 @@ function getCurrentStage(solution) {
     const basicComplete = !hasBasic || solution.questions.basic.every((q) => q.answer !== undefined);
     const advancedComplete = !hasAdvanced || solution.questions.advanced.every((q) => q.answer !== undefined);
     // For Helm solutions, treat open as always complete (skip it)
-    const openComplete = isHelm || !hasOpen || solution.questions.open.answer !== undefined;
+    const openComplete = isHelm || !hasOpen || solution.questions.open?.answer !== undefined;
     // Determine current stage
     if (!requiredComplete) {
         // For Helm: skip open in nextStage calculation
@@ -257,11 +257,11 @@ function validateStageTransition(currentStage, requestedStage, solution) {
 function getQuestionsForStage(solution, stage) {
     switch (stage) {
         case 'required':
-            return solution.questions.required || [];
+            return (solution.questions.required || []);
         case 'basic':
-            return solution.questions.basic || [];
+            return (solution.questions.basic || []);
         case 'advanced':
-            return solution.questions.advanced || [];
+            return (solution.questions.advanced || []);
         case 'open':
             return solution.questions.open ? [solution.questions.open] : [];
         default:
@@ -310,7 +310,8 @@ function getStageGuidance(stage, isHelm = false) {
  */
 async function analyzeResourceNeeds(currentSolution, openResponse, context, interaction_id) {
     // Get available resources from solution or use defaults
-    const availableResources = currentSolution.availableResources || {
+    const solutionWithResources = currentSolution;
+    const availableResources = solutionWithResources.availableResources || {
         resources: [],
         custom: []
     };
@@ -318,7 +319,7 @@ async function analyzeResourceNeeds(currentSolution, openResponse, context, inte
     const availableResourceTypes = [
         ...(availableResources.resources || []),
         ...(availableResources.custom || [])
-    ].map((r) => r.kind || r);
+    ].map((r) => (typeof r === 'object' ? r.kind : r) || r);
     const analysisPrompt = (0, shared_prompt_loader_1.loadPrompt)('resource-analysis', {
         current_solution: JSON.stringify(currentSolution, null, 2),
         user_request: openResponse,
@@ -563,7 +564,7 @@ async function handleAnswerQuestionTool(args, dotAI, logger, requestId) {
             // Handle open question
             const openAnswer = args.answers.open;
             if (openAnswer && solution.questions.open) {
-                solution.questions.open.answer = openAnswer;
+                solution.questions.open.answer = String(openAnswer);
             }
         }
         else {
@@ -600,7 +601,7 @@ async function handleAnswerQuestionTool(args, dotAI, logger, requestId) {
                         solutionId: args.solutionId,
                         openAnswer
                     });
-                    solution = await enhanceSolutionWithOpenAnswer(solution, openAnswer, { requestId, logger, dotAI }, args.interaction_id);
+                    solution = await enhanceSolutionWithOpenAnswer(solution, String(openAnswer), { requestId, logger, dotAI }, args.interaction_id);
                     // Save enhanced solution
                     sessionManager.replaceSession(args.solutionId, solution);
                     logger.info('Enhanced solution saved', {

package/dist/tools/deploy-manifests.d.ts

@@ -5,7 +5,6 @@
 import { z } from 'zod';
 import { DotAI } from '../core/index';
 import { Logger } from '../core/error-handling';
-import type { PluginManager } from '../core/plugin-manager';
 export declare const DEPLOYMANIFESTS_TOOL_NAME = "deployManifests";
 export declare const DEPLOYMANIFESTS_TOOL_DESCRIPTION = "Deploy Kubernetes manifests from generated solution with kubectl apply --wait";
 export declare const DEPLOYMANIFESTS_TOOL_INPUT_SCHEMA: {
@@ -16,10 +15,13 @@ export declare const DEPLOYMANIFESTS_TOOL_INPUT_SCHEMA: {
  * Direct MCP tool handler for deployManifests functionality
  * PRD #343: pluginManager required for kubectl operations
  */
+/**
+ * PRD #359: Uses unified plugin registry for kubectl operations
+ */
 export declare function handleDeployManifestsTool(args: {
     solutionId: string;
     timeout?: number;
-}, dotAI: DotAI, logger: Logger, requestId: string, pluginManager: PluginManager): Promise<{
+}, dotAI: DotAI, logger: Logger, requestId: string): Promise<{
     content: {
         type: 'text';
         text: string;

package/dist/tools/deploy-manifests.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deploy-manifests.d.ts","sourceRoot":"","sources":["../../src/tools/deploy-manifests.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAKhD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAsB5D,eAAO,MAAM,yBAAyB,oBAAoB,CAAC;AAC3D,eAAO,MAAM,gCAAgC,kFAAkF,CAAC;AAGhI,eAAO,MAAM,iCAAiC;;;CAG7C,CAAC;AAEF;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EAC9C,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,aAAa,GAC3B,OAAO,CAAC;IAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,CAAC,CAsOxD"}
+{"version":3,"file":"deploy-manifests.d.ts","sourceRoot":"","sources":["../../src/tools/deploy-manifests.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAmChD,eAAO,MAAM,yBAAyB,oBAAoB,CAAC;AAC3D,eAAO,MAAM,gCAAgC,kFAAkF,CAAC;AAGhI,eAAO,MAAM,iCAAiC;;;CAG7C,CAAC;AAEF;;;GAGG;AACH;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EAC9C,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,CAAC,CAsOxD"}