@jterrazz/intelligence 4.0.3 → 4.1.0

package/README.md

@@ -15,26 +15,26 @@ npm install @jterrazz/intelligence ai zod
 Combines `generateText` + `parseObject` + error classification into a single function that returns a discriminated union result.
 
 ```typescript
-import { generateStructured, withObservability } from "@jterrazz/intelligence";
-import { z } from "zod";
+import { generateStructured, withObservability } from '@jterrazz/intelligence';
+import { z } from 'zod';
 
 const schema = z.object({
-  sentiment: z.string(),
-  score: z.number(),
+    sentiment: z.string(),
+    score: z.number(),
 });
 
 const result = await generateStructured({
-  model,
-  prompt: "Analyze this article...",
-  schema,
-  providerOptions: withObservability({ traceId: "trace-123" }),
+    model,
+    prompt: 'Analyze this article...',
+    schema,
+    providerOptions: withObservability({ traceId: 'trace-123' }),
 });
 
 if (result.success) {
-  console.log(result.data.sentiment, result.data.score);
+    console.log(result.data.sentiment, result.data.score);
 } else {
-  // Typed error with code: TIMEOUT | RATE_LIMITED | PARSING_FAILED | etc.
-  console.error(result.error.code, result.error.message);
+    // Typed error with code: TIMEOUT | RATE_LIMITED | PARSING_FAILED | etc.
+    console.error(result.error.code, result.error.message);
 }
 ```
 
@@ -44,23 +44,23 @@ Discriminated union result type for explicit error handling.
 
 ```typescript
 import {
-  generationSuccess,
-  generationFailure,
-  isSuccess,
-  isFailure,
-  unwrap,
-  unwrapOr,
-  classifyError,
-  type GenerationResult,
-} from "@jterrazz/intelligence";
+    generationSuccess,
+    generationFailure,
+    isSuccess,
+    isFailure,
+    unwrap,
+    unwrapOr,
+    classifyError,
+    type GenerationResult,
+} from '@jterrazz/intelligence';
 
 // Create results
-const success = generationSuccess({ data: "value" });
-const failure = generationFailure("TIMEOUT", "Request timed out");
+const success = generationSuccess({ data: 'value' });
+const failure = generationFailure('TIMEOUT', 'Request timed out');
 
 // Type guards
 if (isSuccess(result)) {
-  console.log(result.data);
+    console.log(result.data);
 }
 
 // Unwrap with default
@@ -68,9 +68,9 @@ const value = unwrapOr(result, defaultValue);
 
 // Classify errors automatically
 try {
-  await someOperation();
+    await someOperation();
 } catch (error) {
-  const code = classifyError(error); // TIMEOUT, RATE_LIMITED, PARSING_FAILED, etc.
+    const code = classifyError(error); // TIMEOUT, RATE_LIMITED, PARSING_FAILED, etc.
 }
 ```
 
@@ -81,26 +81,26 @@ Composable middlewares that wrap AI SDK models. Stack them together for logging,
 ### Composing Middlewares
 
 ```typescript
-import { wrapLanguageModel } from "ai";
+import { wrapLanguageModel } from 'ai';
 import {
-  createLoggingMiddleware,
-  createObservabilityMiddleware,
-  LangfuseAdapter,
-  OpenRouterMetadataAdapter,
-} from "@jterrazz/intelligence";
+    createLoggingMiddleware,
+    createObservabilityMiddleware,
+    LangfuseAdapter,
+    OpenRouterMetadataAdapter,
+} from '@jterrazz/intelligence';
 
 const model = wrapLanguageModel({
-  model: provider.model("anthropic/claude-sonnet-4-20250514"),
-  middleware: [
-    createLoggingMiddleware({ logger, include: { usage: true } }),
-    createObservabilityMiddleware({
-      observability: new LangfuseAdapter({
-        secretKey: process.env.LANGFUSE_SECRET_KEY,
-        publicKey: process.env.LANGFUSE_PUBLIC_KEY,
-      }),
-      providerMetadata: new OpenRouterMetadataAdapter(),
-    }),
-  ],
+    model: provider.model('anthropic/claude-sonnet-4-20250514'),
+    middleware: [
+        createLoggingMiddleware({ logger, include: { usage: true } }),
+        createObservabilityMiddleware({
+            observability: new LangfuseAdapter({
+                secretKey: process.env.LANGFUSE_SECRET_KEY,
+                publicKey: process.env.LANGFUSE_PUBLIC_KEY,
+            }),
+            providerMetadata: new OpenRouterMetadataAdapter(),
+        }),
+    ],
 });
 ```
 
@@ -109,22 +109,22 @@ const model = wrapLanguageModel({
 Logs AI SDK requests with timing, usage, and optional content.
 
 ```typescript
-import { wrapLanguageModel, generateText } from "ai";
-import { createLoggingMiddleware } from "@jterrazz/intelligence";
+import { wrapLanguageModel, generateText } from 'ai';
+import { createLoggingMiddleware } from '@jterrazz/intelligence';
 
 const model = wrapLanguageModel({
-  model: provider.model("anthropic/claude-sonnet-4-20250514"),
-  middleware: createLoggingMiddleware({
-    logger,
-    include: {
-      params: false, // Log request params
-      content: false, // Log response content
-      usage: true, // Log token usage (default: true)
-    },
-  }),
+    model: provider.model('anthropic/claude-sonnet-4-20250514'),
+    middleware: createLoggingMiddleware({
+        logger,
+        include: {
+            params: false, // Log request params
+            content: false, // Log response content
+            usage: true, // Log token usage (default: true)
+        },
+    }),
 });
 
-await generateText({ model, prompt: "Hello!" });
+await generateText({ model, prompt: 'Hello!' });
 // Logs: ai.generate.start, ai.generate.complete (with durationMs, usage, etc.)
 ```
 
@@ -133,32 +133,32 @@ await generateText({ model, prompt: "Hello!" });
 Sends generation data to observability platforms (Langfuse, etc.).
 
 ```typescript
-import { wrapLanguageModel, generateText } from "ai";
+import { wrapLanguageModel, generateText } from 'ai';
 import {
-  createObservabilityMiddleware,
-  withObservability,
-  LangfuseAdapter,
-} from "@jterrazz/intelligence";
+    createObservabilityMiddleware,
+    withObservability,
+    LangfuseAdapter,
+} from '@jterrazz/intelligence';
 
 const observability = new LangfuseAdapter({
-  secretKey: process.env.LANGFUSE_SECRET_KEY,
-  publicKey: process.env.LANGFUSE_PUBLIC_KEY,
+    secretKey: process.env.LANGFUSE_SECRET_KEY,
+    publicKey: process.env.LANGFUSE_PUBLIC_KEY,
 });
 
 const model = wrapLanguageModel({
-  model: provider.model("anthropic/claude-sonnet-4-20250514"),
-  middleware: createObservabilityMiddleware({ observability }),
+    model: provider.model('anthropic/claude-sonnet-4-20250514'),
+    middleware: createObservabilityMiddleware({ observability }),
 });
 
 // Use withObservability() helper for type-safe metadata
 await generateText({
-  model,
-  prompt: "Analyze this...",
-  providerOptions: withObservability({
-    traceId: "trace-123",
-    name: "analyzer",
-    metadata: { userId: "user-1" },
-  }),
+    model,
+    prompt: 'Analyze this...',
+    providerOptions: withObservability({
+        traceId: 'trace-123',
+        name: 'analyzer',
+        metadata: { userId: 'user-1' },
+    }),
 });
 ```
 
@@ -192,12 +192,12 @@ class AnthropicMetadataAdapter implements ProviderMetadataPort {
 Extracts and validates JSON from messy AI outputs (markdown blocks, malformed syntax).
 
 ````typescript
-import { parseObject } from "@jterrazz/intelligence";
-import { z } from "zod";
+import { parseObject } from '@jterrazz/intelligence';
+import { z } from 'zod';
 
 const schema = z.object({
-  title: z.string(),
-  tags: z.array(z.string()),
+    title: z.string(),
+    tags: z.array(z.string()),
 });
 
 const text = '```json\n{"title": "Hello", "tags": ["ai"]}\n```';
@@ -210,16 +210,16 @@ const result = parseObject(text, schema);
 Creates system prompt instructions for models without native structured output.
 
 ```typescript
-import { generateText } from "ai";
-import { createSchemaPrompt, parseObject } from "@jterrazz/intelligence";
-import { z } from "zod";
+import { generateText } from 'ai';
+import { createSchemaPrompt, parseObject } from '@jterrazz/intelligence';
+import { z } from 'zod';
 
 const schema = z.object({ summary: z.string(), score: z.number() });
 
 const { text } = await generateText({
-  model,
-  prompt: "Analyze this article...",
-  system: createSchemaPrompt(schema),
+    model,
+    prompt: 'Analyze this article...',
+    system: createSchemaPrompt(schema),
 });
 
 const result = parseObject(text, schema);
@@ -230,7 +230,7 @@ const result = parseObject(text, schema);
 Removes invisible characters, normalizes typography, cleans AI artifacts.
 
 ```typescript
-import { parseText } from "@jterrazz/intelligence";
+import { parseText } from '@jterrazz/intelligence';
 
 const clean = parseText(messyAiOutput);
 // Removes: BOM, zero-width chars, citation markers
@@ -242,22 +242,22 @@ const clean = parseText(messyAiOutput);
 ### `createOpenRouterProvider` - OpenRouter for AI SDK
 
 ```typescript
-import { generateText } from "ai";
-import { createOpenRouterProvider } from "@jterrazz/intelligence";
+import { generateText } from 'ai';
+import { createOpenRouterProvider } from '@jterrazz/intelligence';
 
 const provider = createOpenRouterProvider({
-  apiKey: process.env.OPENROUTER_API_KEY,
+    apiKey: process.env.OPENROUTER_API_KEY,
 });
 
 const { text } = await generateText({
-  model: provider.model("anthropic/claude-sonnet-4-20250514"),
-  prompt: "Hello!",
+    model: provider.model('anthropic/claude-sonnet-4-20250514'),
+    prompt: 'Hello!',
 });
 
 // With reasoning models
-const reasoningModel = provider.model("anthropic/claude-sonnet-4-20250514", {
-  maxTokens: 16000,
-  reasoning: { effort: "high" },
+const reasoningModel = provider.model('anthropic/claude-sonnet-4-20250514', {
+    maxTokens: 16000,
+    reasoning: { effort: 'high' },
 });
 ```
 

package/dist/index.cjs

@@ -1,10 +1,11 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_parse_text = require("./parse-text.cjs");
 let langfuse = require("langfuse");
 let ai = require("ai");
 let jsonrepair = require("jsonrepair");
 let zod_v4 = require("zod/v4");
 let _openrouter_ai_sdk_provider = require("@openrouter/ai-sdk-provider");
 let _ai_sdk_openai = require("@ai-sdk/openai");
-
 //#region src/logging/logging.middleware.ts
 /**
 * Creates middleware that logs AI SDK requests and responses.
@@ -78,7 +79,6 @@ function createLoggingMiddleware(options) {
 		}
 	};
 }
-
 //#endregion
 //#region src/observability/observability.middleware.ts
 /**
@@ -150,7 +150,6 @@ function createObservabilityMiddleware(options) {
 		}
 	};
 }
-
 //#endregion
 //#region src/observability/langfuse.adapter.ts
 /**
@@ -208,7 +207,6 @@ var LangfuseAdapter = class {
 		});
 	}
 };
-
 //#endregion
 //#region src/observability/noop.adapter.ts
 /**
@@ -221,7 +219,6 @@ var NoopObservabilityAdapter = class {
 	async shutdown() {}
 	trace(_params) {}
 };
-
 //#endregion
 //#region src/result/result.ts
 /**
@@ -284,7 +281,6 @@ function unwrap(result) {
 function unwrapOr(result, defaultValue) {
 	return result.success ? result.data : defaultValue;
 }
-
 //#endregion
 //#region src/parsing/parse-object.ts
 const MARKDOWN_CODE_BLOCK_RE = /```(?:json)?\r?\n([^`]*?)\r?\n```/g;
@@ -294,6 +290,8 @@ const MARKDOWN_CODE_BLOCK_RE = /```(?:json)?\r?\n([^`]*?)\r?\n```/g;
 */
 var ParseObjectError = class extends Error {
 	name = "ParseObjectError";
+	cause;
+	text;
 	constructor(message, cause, text) {
 		super(message);
 		this.cause = cause;
@@ -435,7 +433,6 @@ function parseObject(text, schema) {
 		throw error;
 	}
 }
-
 //#endregion
 //#region src/generation/generate-structured.ts
 /**
@@ -465,7 +462,6 @@ async function generateStructured(options) {
 		return generationFailure(classifyError(error), error instanceof Error ? error.message : "Unknown error", error);
 	}
 }
-
 //#endregion
 //#region src/parsing/create-schema-prompt.ts
 /**
@@ -521,57 +517,6 @@ ${schemaJson}
 Your response must be parseable JSON that validates against this schema. Do not include any text outside the JSON.
 </OUTPUT_FORMAT>`;
 }
-
-//#endregion
-//#region src/parsing/parse-text.ts
-const INVISIBLE_CHARS_RE = /[\u00AD\u180E\u200B-\u200C\u200E-\u200F\u202A-\u202E\u2060-\u2064\u2066-\u2069\uFEFF]/g;
-const ASCII_CTRL_RE = /[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F]/g;
-const SPACE_LIKE_RE = /[\u00A0\u1680\u2000-\u200A\u202F\u205F\u3000]/g;
-const MULTIPLE_SPACES_RE = / {2,}/g;
-const CR_RE = /\r\n?/g;
-const CITATION_RE = / *\(oaicite:\d+\)\{index=\d+\}/g;
-const EM_DASH_SEPARATOR_RE = /\s*[—–―‒]\s*/g;
-const TYPOGRAPHY_REPLACEMENTS = [
-	{
-		pattern: /[\u2018\u2019\u201A]/g,
-		replacement: "'"
-	},
-	{
-		pattern: /[\u201C\u201D\u201E]/g,
-		replacement: "\""
-	},
-	{
-		pattern: /\u2026/g,
-		replacement: "..."
-	},
-	{
-		pattern: /[\u2022\u25AA-\u25AB\u25B8-\u25B9\u25CF]/g,
-		replacement: "-"
-	}
-];
-/**
-* Parses and sanitizes text by removing AI artifacts and normalizing typography.
-*
-* @param text - The text to parse
-* @param options - Parsing options
-* @returns The cleaned text
-*/
-function parseText(text, options = {}) {
-	const { normalizeEmDashesToCommas = true, collapseSpaces = true } = options;
-	if (!text) return "";
-	let result = text;
-	result = result.replace(CR_RE, "\n");
-	result = result.replace(CITATION_RE, "");
-	result = result.normalize("NFKC");
-	result = result.replace(INVISIBLE_CHARS_RE, "");
-	result = result.replace(ASCII_CTRL_RE, "");
-	if (normalizeEmDashesToCommas) result = result.replace(EM_DASH_SEPARATOR_RE, ", ");
-	result = result.replace(SPACE_LIKE_RE, " ");
-	for (const { pattern, replacement } of TYPOGRAPHY_REPLACEMENTS) result = result.replace(pattern, replacement);
-	if (collapseSpaces) result = result.replace(MULTIPLE_SPACES_RE, " ").trim();
-	return result;
-}
-
 //#endregion
 //#region src/provider/openrouter.provider.ts
 /**
@@ -594,7 +539,6 @@ function createOpenRouterProvider(config) {
 		});
 	} };
 }
-
 //#endregion
 //#region src/provider/openrouter-metadata.adapter.ts
 /**
@@ -617,7 +561,6 @@ var OpenRouterMetadataAdapter = class {
 		};
 	}
 };
-
 //#endregion
 //#region src/provider/openai-compatible.provider.ts
 /**
@@ -633,7 +576,6 @@ function createOpenAICompatibleProvider(config) {
 		return openai(config.modelMapping?.[name] ?? name);
 	} };
 }
-
 //#endregion
 //#region src/provider/openai-compatible-metadata.adapter.ts
 /**
@@ -652,7 +594,6 @@ var OpenAICompatibleMetadataAdapter = class {
 		} };
 	}
 };
-
 //#endregion
 exports.LangfuseAdapter = LangfuseAdapter;
 exports.NoopObservabilityAdapter = NoopObservabilityAdapter;
@@ -671,8 +612,9 @@ exports.generationSuccess = generationSuccess;
 exports.isFailure = isFailure;
 exports.isSuccess = isSuccess;
 exports.parseObject = parseObject;
-exports.parseText = parseText;
+exports.parseText = require_parse_text.parseText;
 exports.unwrap = unwrap;
 exports.unwrapOr = unwrapOr;
 exports.withObservability = withObservability;
+
 //# sourceMappingURL=index.cjs.map