@x12i/ai-gateway 7.9.1

package/dist-cjs/troubleshooting-helper.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Troubleshooting Helper Toolbox
+ *
+ * Utility functions to diagnose and test AI Gateway issues
+ * Based on TROUBLESHOOTING.md guide
+ */
+import type { AIRequest, ChatRequest, EnhancedLLMResponse } from './types.js';
+/**
+ * Converts JSON Schema to simple, human-readable format for LLM instructions
+ *
+ * Supports both formats:
+ * - JSON Schema format: { "type": "object", "properties": {...} }
+ * - Simple format: { "emails": ["<string> description"] }
+ *
+ * If schema is already in simple format, returns it as-is.
+ * If schema is in JSON Schema format, converts it to simple format.
+ *
+ * Simple format example:
+ * {
+ *   "emails": [
+ *     "<string> A valid email address extracted from the input text"
+ *   ]
+ * }
+ *
+ * Format rules:
+ * - Arrays: Show as array with single example item containing type hint + description
+ * - Objects: Show nested structure recursively
+ * - Primitives: Show as type hint with description
+ * - Required fields: Implicit (just present in structure)
+ *
+ * @param schema - Schema object (JSON Schema or simple format)
+ * @returns Schema in simple format
+ */
+export declare function convertSchemaToSimpleFormat(schema: Record<string, unknown>): Record<string, unknown>;
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+export interface DiagnosticInfo {
+    request: {
+        hasJobId: boolean;
+        hasAgentId: boolean;
+        hasInstructions: boolean;
+        hasPrompt: boolean;
+        hasWorkingMemory: boolean;
+        hasConfig: boolean;
+        hasModel: boolean;
+        hasProvider: boolean;
+    };
+    response?: {
+        hasContent: boolean;
+        isJSON: boolean;
+        hasParsedContent: boolean;
+        contentType: string;
+        validationPassed?: boolean;
+        validationErrors?: string[];
+    };
+}
+/**
+ * Validates AIRequest structure
+ */
+export declare function validateAIRequest(request: Partial<AIRequest>): ValidationResult;
+/**
+ * Validates JSON string
+ */
+export declare function validateJSON(jsonString: string): ValidationResult;
+/**
+ * Extracts JSON from text (handles markdown code blocks, etc.)
+ */
+export declare function extractJSON(text: string): {
+    json: string | null;
+    method: string;
+};
+/**
+ * Validates response structure
+ */
+export declare function validateResponse(response: Partial<EnhancedLLMResponse>): ValidationResult;
+/**
+ * Collects comprehensive diagnostic information
+ */
+export declare function diagnoseRequest(request: Partial<AIRequest | ChatRequest>): DiagnosticInfo;
+/**
+ * Diagnoses response issues
+ */
+export declare function diagnoseResponse(response: Partial<EnhancedLLMResponse>): DiagnosticInfo['response'];
+/**
+ * Tests if a provider/model combination supports JSON mode
+ */
+export declare function supportsJSONMode(provider?: string, model?: string): {
+    supported: boolean;
+    notes: string;
+};
+/**
+ * Creates a test AIRequest with minimal valid structure
+ */
+export declare function createTestAIRequest(overrides?: Partial<AIRequest>): AIRequest;
+/**
+ * Creates test cases for validation
+ */
+export declare function createValidationTestCases(): Array<{
+    name: string;
+    request: Partial<AIRequest>;
+    shouldFail: boolean;
+    expectedErrors?: string[];
+}>;
+/**
+ * Runs all validation tests and returns results
+ */
+export declare function runValidationTests(): Array<{
+    name: string;
+    passed: boolean;
+    errors: string[];
+    warnings: string[];
+}>;
+/**
+ * Formats diagnostic information for display
+ */
+export declare function formatDiagnostic(diagnostic: DiagnosticInfo): string;
+/**
+ * Quick validation helper - throws if invalid
+ */
+export declare function assertValidAIRequest(request: Partial<AIRequest>): void;

package/dist-cjs/types.cjs

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Type definitions for AI Gateway
+ *
+ * Extends router types with gateway-specific enhancements
+ */
+Object.defineProperty(exports, "__esModule", { value: true });