@bryan-thompson/inspector-assessment-client 1.30.1 → 1.31.0

package/lib/services/assessment/responseValidatorSchemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responseValidatorSchemas.d.ts","sourceRoot":"","sources":["../../../src/services/assessment/responseValidatorSchemas.ts"],"names":[],"mappings":"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"}

package/lib/services/assessment/responseValidatorSchemas.js

@@ -0,0 +1,244 @@
+/**
+ * Zod Schemas for Response Validation Types
+ *
+ * Runtime validation schemas for MCP tool response validation.
+ * Provides safe parsing of MCP SDK response types to replace type assertions.
+ *
+ * @module assessment/responseValidatorSchemas
+ * @see ResponseValidator.ts - Consumer of these schemas
+ * @see resultTypes.ts - ResponseMetadata interface definition
+ */
+import { z } from "zod";
+import { ZOD_SCHEMA_VERSION } from "../../lib/assessment/sharedSchemas.js";
+// Re-export schema version for consumers
+export { ZOD_SCHEMA_VERSION };
+// ============================================================================
+// Content Block Schemas
+// ============================================================================
+/**
+ * Schema for MCP content type enum values.
+ */
+export const ContentTypeSchema = z.enum([
+    "text",
+    "image",
+    "resource",
+    "resource_link",
+    "audio",
+]);
+/**
+ * Schema for a text content block.
+ */
+export const TextContentBlockSchema = z.object({
+    type: z.literal("text"),
+    text: z.string(),
+});
+/**
+ * Schema for an image content block.
+ */
+export const ImageContentBlockSchema = z.object({
+    type: z.literal("image"),
+    data: z.string(),
+    mimeType: z.string(),
+});
+/**
+ * Schema for a resource content block.
+ */
+export const ResourceContentBlockSchema = z.object({
+    type: z.union([z.literal("resource"), z.literal("resource_link")]),
+    uri: z.string().optional(),
+    mimeType: z.string().optional(),
+});
+/**
+ * Schema for an audio content block.
+ */
+export const AudioContentBlockSchema = z.object({
+    type: z.literal("audio"),
+    data: z.string(),
+    mimeType: z.string().optional(),
+});
+/**
+ * Generic content block schema that accepts any type string.
+ * Used as fallback for unknown content types.
+ */
+export const GenericContentBlockSchema = z.object({
+    type: z.string(),
+    text: z.string().optional(),
+    data: z.string().optional(),
+    mimeType: z.string().optional(),
+    uri: z.string().optional(),
+});
+/**
+ * Union of all known content block types, with fallback for unknown types.
+ */
+export const ContentBlockSchema = z.union([
+    TextContentBlockSchema,
+    ImageContentBlockSchema,
+    ResourceContentBlockSchema,
+    AudioContentBlockSchema,
+    GenericContentBlockSchema,
+]);
+/**
+ * Schema for content array in MCP responses.
+ * Uses ContentBlockSchema union for stricter type discrimination.
+ */
+export const ContentArraySchema = z.array(ContentBlockSchema);
+// ============================================================================
+// Response Metadata Schemas
+// ============================================================================
+/**
+ * Schema for output schema validation result.
+ */
+export const OutputSchemaValidationSchema = z.object({
+    hasOutputSchema: z.boolean(),
+    isValid: z.boolean(),
+    error: z.string().optional(),
+});
+/**
+ * Schema for response metadata tracking.
+ * Matches ResponseMetadata interface in resultTypes.ts.
+ */
+export const ResponseMetadataSchema = z.object({
+    contentTypes: z.array(ContentTypeSchema),
+    hasStructuredContent: z.boolean(),
+    hasMeta: z.boolean(),
+    textBlockCount: z.number().int().nonnegative(),
+    imageCount: z.number().int().nonnegative(),
+    resourceCount: z.number().int().nonnegative(),
+    outputSchemaValidation: OutputSchemaValidationSchema.optional(),
+});
+// ============================================================================
+// Validation Result Schemas
+// ============================================================================
+/**
+ * Schema for validation classification enum.
+ */
+export const ValidationClassificationSchema = z.enum([
+    "fully_working",
+    "partially_working",
+    "connectivity_only",
+    "broken",
+    "error",
+]);
+/**
+ * Schema for validation result.
+ * Matches ValidationResult interface in ResponseValidator.ts.
+ */
+export const ValidationResultSchema = z.object({
+    isValid: z.boolean(),
+    isError: z.boolean(),
+    confidence: z.number().int().min(0).max(100),
+    issues: z.array(z.string()),
+    evidence: z.array(z.string()),
+    classification: ValidationClassificationSchema,
+    responseMetadata: ResponseMetadataSchema.optional(),
+});
+// ============================================================================
+// MCP Response Schemas
+// ============================================================================
+/**
+ * Schema for MCP tool call result (CompatibilityCallToolResult).
+ * Validates the structure of tool responses from MCP SDK.
+ */
+export const MCPToolCallResultSchema = z.object({
+    content: ContentArraySchema.optional(),
+    isError: z.boolean().optional(),
+    structuredContent: z.unknown().optional(),
+    _meta: z.unknown().optional(),
+});
+// ============================================================================
+// Validation Helpers
+// ============================================================================
+/**
+ * Validate content array from MCP response.
+ *
+ * @param content - Content array to validate
+ * @returns Array of validation error messages (empty if valid)
+ */
+export function validateContentArray(content) {
+    const result = ContentArraySchema.safeParse(content);
+    if (result.success) {
+        return [];
+    }
+    return result.error.errors.map((e) => {
+        const path = e.path.length > 0 ? `${e.path.join(".")}: ` : "";
+        return `${path}${e.message}`;
+    });
+}
+/**
+ * Safely parse content array without throwing.
+ *
+ * @param content - Raw content array
+ * @returns SafeParseResult with success status and data/error
+ */
+export function safeParseContentArray(content) {
+    return ContentArraySchema.safeParse(content);
+}
+/**
+ * Safely parse MCP tool call result.
+ *
+ * @param result - Raw tool call result
+ * @returns SafeParseResult with success status and data/error
+ */
+export function safeParseMCPToolCallResult(result) {
+    return MCPToolCallResultSchema.safeParse(result);
+}
+/**
+ * Validate validation result structure.
+ *
+ * @param result - Validation result to validate
+ * @returns Array of validation error messages (empty if valid)
+ */
+export function validateValidationResult(result) {
+    const parseResult = ValidationResultSchema.safeParse(result);
+    if (parseResult.success) {
+        return [];
+    }
+    return parseResult.error.errors.map((e) => {
+        const path = e.path.length > 0 ? `${e.path.join(".")}: ` : "";
+        return `${path}${e.message}`;
+    });
+}
+/**
+ * Parse validation result with validation.
+ *
+ * @param result - Raw validation result
+ * @returns Validated result
+ * @throws ZodError if validation fails
+ */
+export function parseValidationResult(result) {
+    return ValidationResultSchema.parse(result);
+}
+/**
+ * Safely parse validation result without throwing.
+ *
+ * @param result - Raw validation result
+ * @returns SafeParseResult with success status and data/error
+ */
+export function safeParseValidationResult(result) {
+    return ValidationResultSchema.safeParse(result);
+}
+/**
+ * Validate response metadata structure.
+ *
+ * @param metadata - Response metadata to validate
+ * @returns Array of validation error messages (empty if valid)
+ */
+export function validateResponseMetadata(metadata) {
+    const result = ResponseMetadataSchema.safeParse(metadata);
+    if (result.success) {
+        return [];
+    }
+    return result.error.errors.map((e) => {
+        const path = e.path.length > 0 ? `${e.path.join(".")}: ` : "";
+        return `${path}${e.message}`;
+    });
+}
+/**
+ * Safely parse response metadata without throwing.
+ *
+ * @param metadata - Raw response metadata
+ * @returns SafeParseResult with success status and data/error
+ */
+export function safeParseResponseMetadata(metadata) {
+    return ResponseMetadataSchema.safeParse(metadata);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bryan-thompson/inspector-assessment-client",
-  "version": "1.30.1",
+  "version": "1.31.0",
   "description": "Client-side application for the Enhanced MCP Inspector with assessment capabilities",
   "license": "MIT",
   "author": "Bryan Thompson <bryan@triepod.ai>",