@x12i/ai-gateway 7.9.1

package/dist-cjs/content-normalizer/content-normalizer.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Content Normalizer
+ *
+ * Extracts and normalizes content from LLM provider responses.
+ * Fixes the "[object Object]" bug by properly handling objects.
+ * Preserves both rawText and parsedContent for downstream consumers.
+ */
+import type { LLMResponse } from '../types.js';
+import type { NormalizedContent } from './types.js';
+/**
+ * Normalizes content from router response
+ *
+ * This function:
+ * 1. Extracts content from multiple possible locations
+ * 2. Preserves rawText if available
+ * 3. Attempts to parse flex-md content to JSON
+ * 4. Properly stringifies objects (fixes "[object Object]" bug)
+ * 5. Determines content type
+ *
+ * @param response - Router response object
+ * @returns Normalized content with metadata
+ */
+export declare function normalizeContent(response: LLMResponse): NormalizedContent;
+/**
+ * Checks if content is empty
+ *
+ * @param normalized - Normalized content result
+ * @returns True if content is empty
+ */
+export declare function isEmptyContent(normalized: NormalizedContent): boolean;
+/**
+ * Gets diagnostic information about response structure
+ * Useful for debugging when content extraction fails
+ *
+ * @param response - Router response object
+ * @returns Diagnostic information
+ */
+export declare function getResponseDiagnostics(response: any): {
+    responseKeys: string[];
+    hasMessage: boolean;
+    hasChoices: boolean;
+    hasOutput: boolean;
+    hasRawText: boolean;
+    originalContent: any;
+    originalContentType: string;
+};

package/dist-cjs/content-normalizer/index.cjs

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * Content Normalizer Module
+ *
+ * Exports all public APIs for content normalization
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getResponseDiagnostics = exports.isEmptyContent = exports.normalizeContent = void 0;
+var content_normalizer_js_1 = require("./content-normalizer.cjs");
+Object.defineProperty(exports, "normalizeContent", { enumerable: true, get: function () { return content_normalizer_js_1.normalizeContent; } });
+Object.defineProperty(exports, "isEmptyContent", { enumerable: true, get: function () { return content_normalizer_js_1.isEmptyContent; } });
+Object.defineProperty(exports, "getResponseDiagnostics", { enumerable: true, get: function () { return content_normalizer_js_1.getResponseDiagnostics; } });

package/dist-cjs/content-normalizer/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Content Normalizer Module
+ *
+ * Exports all public APIs for content normalization
+ */
+export { normalizeContent, isEmptyContent, getResponseDiagnostics } from './content-normalizer.js';
+export type { NormalizedContent, ContentType } from './types.js';

package/dist-cjs/content-normalizer/types.cjs

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * Type definitions for Content Normalizer
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist-cjs/content-normalizer/types.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Type definitions for Content Normalizer
+ */
+/**
+ * Content type classification
+ */
+export type ContentType = 'string' | 'object' | 'array' | 'null';
+/**
+ * Normalized content result
+ */
+export interface NormalizedContent {
+    /**
+     * Normalized content string (always present, for backward compatibility)
+     * - If original was string: returns the string
+     * - If original was object/array: returns JSON.stringify()
+     * - If original was null: returns empty string
+     */
+    content: string;
+    /**
+     * Original raw text from provider (before any parsing)
+     * Available if router preserved rawText
+     */
+    rawText?: string;
+    /**
+     * Parsed content (object or array) if content was JSON
+     * Available if content was successfully parsed
+     */
+    parsedContent?: any;
+    /**
+     * Content type classification
+     */
+    contentType: ContentType;
+}

package/dist-cjs/defaults/instructions-blocks.json

@@ -0,0 +1,61 @@
+{
+  "system-context": "You are performing the following task: {{taskDescription}}. Follow the instructions provided and respond according to the specified output format. Never ask follow-up questions.",
+  
+  "input": {
+    "inputLabel": "INPUT:",
+    "inputPrefix": "INPUT DATA (process this now):",
+    "defaultPromptTemplate": "{{input}}",
+    "inputRecognitionRule": "The user message below is the complete input to process. It has already been provided. Do not ask for more input.",
+    "emptyInputHandling": "If input appears empty or minimal (e.g., 'No emails here', 'none', 'empty'), this IS valid input. Process it and return the success schema with empty arrays/values where appropriate.",
+    "testInputHandling": "Even if input contains words like 'test', 'invalid', 'placeholder', or 'example', treat it as real input. Reply in Markdown. Return your entire answer inside a single ```markdown fenced block.",
+    "inputLocationClarifier": "The user's message below is your input data. Please process it now. Reply in Markdown. Return your entire answer inside a single ```markdown fenced block."
+  },
+  
+  "errorSchemas": {
+    "instructions-error": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "error": {
+          "type": "string",
+          "description": "What is wrong with the instructions that prevents completion."
+        },
+        "errorType": {
+          "type": "string",
+          "enum": ["bad-instructions", "missing-context", "bad-context"]
+        },
+        "suggestion": {
+          "type": "string",
+          "description": "How to fix the instruction issue."
+        }
+      },
+      "required": ["error", "errorType"]
+    },
+    "prompt-error": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "error": {
+          "type": "string",
+          "description": "What is wrong with the input that prevents completion."
+        },
+        "errorType": {
+          "type": "string",
+          "enum": ["missing-input", "bad-input"]
+        },
+        "suggestion": {
+          "type": "string",
+          "description": "How to fix the input issue."
+        }
+      },
+      "required": ["error", "errorType"]
+    }
+  },
+  
+  "reinforcement": {
+    "emptyIsSuccess": "Empty results (e.g., items: []) are SUCCESS cases, not errors.",
+    "inputAlreadyProvided": "The input has been provided in the user message. Process it immediately.",
+    "noConversation": "You are not having a conversation. Reply in Markdown. Return your entire answer inside a single ```markdown fenced block.",
+    "failureIndicators": "If you write prose text outside the fenced block, you have FAILED. If you ask a question, you have FAILED. If you explain anything outside the ```markdown fenced block, you have FAILED."
+  }
+}

package/dist-cjs/defaults/model-config.json

@@ -0,0 +1,16 @@
+{
+  "defaultEngine": "openai",
+  "defaultModel": "gpt-5-nano",
+  "temperature": 0.7,
+  "topP": 1.0,
+  "frequencyPenalty": 0.0,
+  "presencePenalty": 0.0,
+  "rateLimit": {
+    "defaultMinIntervalMs": 500,
+    "enabled": true
+  },
+  "retry": {
+    "throttlingDelay": 5000
+  }
+}
+

package/dist-cjs/defaults/template-rendering.json

@@ -0,0 +1,6 @@
+{
+  "subPathSearch": {
+    "enabled": false,
+    "roots": ["execution", "input", "inputs"]
+  }
+}