@hardlydifficult/ai-msg 1.0.0 → 1.0.2

package/README.md

@@ -1,8 +1,6 @@
 # @hardlydifficult/ai-msg
 
-Opinionated utilities for extracting structured output from AI text responses.
-
-LLM responses often wrap structured data in markdown code blocks, preamble text, or trailing commentary. This package reliably extracts JSON and code blocks from messy AI output.
+Extract structured data from AI model responses: JSON, typed schemas, code blocks, and multimodal content.
 
 ## Installation
 
@@ -10,43 +8,53 @@ LLM responses often wrap structured data in markdown code blocks, preamble text,
 npm install @hardlydifficult/ai-msg
 ```
 
-For typed extraction with Zod validation:
-
-```bash
-npm install @hardlydifficult/ai-msg zod
-```
+## API
 
-## Usage
+### `extractJson(text: string, sentinel?: string): unknown[]`
 
-### `extractJson(text): unknown | null`
+Extract JSON objects/arrays from AI response text. Uses a three-pass strategy:
 
-Extracts the first valid JSON value from text using a three-pass strategy:
+1. Parse the entire text as JSON
+2. Extract from fenced code blocks (json-tagged first, then any)
+3. Find balanced `{}`/`[]` in prose
 
-1. Direct `JSON.parse` of the trimmed text
-2. Search markdown code blocks (json-tagged first, then any)
-3. Find balanced `{}` or `[]` substrings in prose
+Pass a `sentinel` string to return `[]` when the response contains it (useful for "no results" markers).
 
-```typescript
+````typescript
 import { extractJson } from "@hardlydifficult/ai-msg";
 
-extractJson('{"key": "value"}');
-// { key: "value" }
-
 extractJson('Here is the result:\n```json\n{"key": "value"}\n```\nDone.');
-// { key: "value" }
+// [{ key: "value" }]
 
-extractJson('The answer is {"key": "value"} as shown.');
-// { key: "value" }
+extractJson('First {"a": 1} then {"b": 2} done.');
+// [{ a: 1 }, { b: 2 }]
 
-extractJson("no json here");
-// null
-```
+extractJson("NO_FINDINGS: scan completed.", "NO_FINDINGS");
+// []
+````
 
-### `extractCodeBlock(text, lang?): string[]`
+### `extractTyped<T>(text: string, schema: SchemaLike<T>, sentinel?: string): T[]`
 
-Extracts all markdown code blocks from text. Optionally filters by language tag.
+Extract and validate JSON against a schema. Works with Zod 3, Zod 4, or any object with a `safeParse` method. Only returns entries that pass validation.
 
 ```typescript
+import { extractTyped } from "@hardlydifficult/ai-msg";
+import { z } from "zod";
+
+const Person = z.object({ name: z.string(), age: z.number() });
+
+extractTyped('{"name": "Alice", "age": 30}', Person);
+// [{ name: "Alice", age: 30 }]
+
+extractTyped('{"name": "Alice", "age": "thirty"}', Person);
+// [] — fails validation
+```
+
+### `extractCodeBlock(text: string, lang?: string): string[]`
+
+Extract fenced code block contents. Optionally filter by language tag.
+
+````typescript
 import { extractCodeBlock } from "@hardlydifficult/ai-msg";
 
 extractCodeBlock("```ts\nconst x = 1;\n```");
@@ -54,24 +62,22 @@ extractCodeBlock("```ts\nconst x = 1;\n```");
 
 extractCodeBlock("```json\n{}\n```\n```ts\nconst x = 1;\n```", "json");
 // ["{}"]
+````
 
-extractCodeBlock("no code blocks");
-// []
-```
-
-### `extractTyped<T>(text, schema): T | null`
+### `extractTextContent(content: string | { type: string; text?: string }[]): string`
 
-Extracts JSON from text and validates it against a Zod schema. Requires `zod` as a peer dependency.
+Extract plain text from a message content field. Handles both plain strings and multimodal content arrays (AI SDK format).
 
 ```typescript
-import { extractTyped } from "@hardlydifficult/ai-msg";
-import { z } from "zod";
+import { extractTextContent } from "@hardlydifficult/ai-msg";
 
-const Person = z.object({ name: z.string(), age: z.number() });
+extractTextContent("hello"); // "hello"
+extractTextContent([
+  { type: "text", text: "hello" },
+  { type: "image_url", url: "..." },
+]); // "hello"
+```
 
-extractTyped('{"name": "Alice", "age": 30}', Person);
-// { name: "Alice", age: 30 }
+### `toPlainTextMessages(messages: MultimodalMessage[]): { role, content }[]`
 
-extractTyped('{"name": "Alice", "age": "thirty"}', Person);
-// null
-```
+Convert multimodal messages to plain text messages by flattening content arrays.

package/dist/extractJson.d.ts

@@ -1,2 +1,2 @@
-export declare function extractJson(text: string): unknown;
+export declare function extractJson(text: string, sentinel?: string): unknown[];
 //# sourceMappingURL=extractJson.d.ts.map

package/dist/extractJson.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extractJson.d.ts","sourceRoot":"","sources":["../src/extractJson.ts"],"names":[],"mappings":"AAWA,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAuCjD"}
+{"version":3,"file":"extractJson.d.ts","sourceRoot":"","sources":["../src/extractJson.ts"],"names":[],"mappings":"AAWA,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE,CAgDtE"}

package/dist/extractJson.js

@@ -11,40 +11,49 @@ function tryParse(text) {
         return undefined;
     }
 }
-function extractJson(text) {
+function extractJson(text, sentinel) {
+    // Sentinel check — if the text contains the sentinel, treat as "no findings"
+    if (sentinel !== undefined && text.includes(sentinel)) {
+        return [];
+    }
     // Pass 1: try the whole text
     const direct = tryParse(text.trim());
     if (direct !== undefined) {
-        return direct;
+        return [direct];
     }
     // Pass 2: code blocks — json-tagged first, then any
+    const fromBlocks = [];
     for (const block of (0, extractCodeBlock_js_1.extractCodeBlock)(text, "json")) {
         const parsed = tryParse(block.trim());
         if (parsed !== undefined) {
-            return parsed;
+            fromBlocks.push(parsed);
         }
     }
-    for (const block of (0, extractCodeBlock_js_1.extractCodeBlock)(text)) {
-        const parsed = tryParse(block.trim());
-        if (parsed !== undefined) {
-            return parsed;
+    if (fromBlocks.length === 0) {
+        for (const block of (0, extractCodeBlock_js_1.extractCodeBlock)(text)) {
+            const parsed = tryParse(block.trim());
+            if (parsed !== undefined) {
+                fromBlocks.push(parsed);
+            }
         }
     }
-    // Pass 3: balanced braces / brackets
-    const obj = (0, findBalanced_js_1.findBalanced)(text, "{", "}");
-    if (obj !== null) {
-        const parsed = tryParse(obj);
+    if (fromBlocks.length > 0) {
+        return fromBlocks;
+    }
+    // Pass 3: all balanced braces / brackets in prose
+    const results = [];
+    for (const match of (0, findBalanced_js_1.findAllBalanced)(text, "{", "}")) {
+        const parsed = tryParse(match);
         if (parsed !== undefined) {
-            return parsed;
+            results.push(parsed);
         }
     }
-    const arr = (0, findBalanced_js_1.findBalanced)(text, "[", "]");
-    if (arr !== null) {
-        const parsed = tryParse(arr);
+    for (const match of (0, findBalanced_js_1.findAllBalanced)(text, "[", "]")) {
+        const parsed = tryParse(match);
         if (parsed !== undefined) {
-            return parsed;
+            results.push(parsed);
         }
     }
-    return null;
+    return results;
 }
 //# sourceMappingURL=extractJson.js.map

package/dist/extractJson.js.map

@@ -1 +1 @@
-{"version":3,"file":"extractJson.js","sourceRoot":"","sources":["../src/extractJson.ts"],"names":[],"mappings":";;AAWA,kCAuCC;AAlDD,+DAAyD;AACzD,uDAAiD;AAEjD,SAAS,QAAQ,CAAC,IAAY;IAC5B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAgB,WAAW,CAAC,IAAY;IACtC,6BAA6B;IAC7B,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACrC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,oDAAoD;IACpD,KAAK,MAAM,KAAK,IAAI,IAAA,sCAAgB,EAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;QACnD,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACtC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,IAAA,sCAAgB,EAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACtC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAED,qCAAqC;IACrC,MAAM,GAAG,GAAG,IAAA,8BAAY,EAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IACzC,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAAG,IAAA,8BAAY,EAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IACzC,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"extractJson.js","sourceRoot":"","sources":["../src/extractJson.ts"],"names":[],"mappings":";;AAWA,kCAgDC;AA3DD,+DAAyD;AACzD,uDAAoD;AAEpD,SAAS,QAAQ,CAAC,IAAY;IAC5B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAgB,WAAW,CAAC,IAAY,EAAE,QAAiB;IACzD,6EAA6E;IAC7E,IAAI,QAAQ,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,6BAA6B;IAC7B,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACrC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,CAAC,MAAM,CAAC,CAAC;IAClB,CAAC;IAED,oDAAoD;IACpD,MAAM,UAAU,GAAc,EAAE,CAAC;IACjC,KAAK,MAAM,KAAK,IAAI,IAAA,sCAAgB,EAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;QACnD,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACtC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,KAAK,MAAM,KAAK,IAAI,IAAA,sCAAgB,EAAC,IAAI,CAAC,EAAE,CAAC;YAC3C,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACtC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,kDAAkD;IAClD,MAAM,OAAO,GAAc,EAAE,CAAC;IAC9B,KAAK,MAAM,KAAK,IAAI,IAAA,iCAAe,EAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;QACpD,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,IAAA,iCAAe,EAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;QACpD,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/extractTyped.d.ts

@@ -1,3 +1,15 @@
-import { type ZodType } from "zod";
-export declare function extractTyped<T>(text: string, schema: ZodType<T>): T | null;
+/**
+ * Any schema with a safeParse method (e.g. Zod 3, Zod 4, or custom).
+ * Using a structural type avoids coupling to a specific Zod version.
+ */
+export interface SchemaLike<T> {
+    safeParse(data: unknown): {
+        success: true;
+        data: T;
+    } | {
+        success: false;
+        error?: unknown;
+    };
+}
+export declare function extractTyped<T>(text: string, schema: SchemaLike<T>, sentinel?: string): T[];
 //# sourceMappingURL=extractTyped.d.ts.map

package/dist/extractTyped.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extractTyped.d.ts","sourceRoot":"","sources":["../src/extractTyped.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AAInC,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAQ1E"}
+{"version":3,"file":"extractTyped.d.ts","sourceRoot":"","sources":["../src/extractTyped.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,SAAS,CACP,IAAI,EAAE,OAAO,GACZ;QAAE,OAAO,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,CAAC,CAAA;KAAE,GAAG;QAAE,OAAO,EAAE,KAAK,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACrE;AAED,wBAAgB,YAAY,CAAC,CAAC,EAC5B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,CAAC,EAAE,CAUL"}

package/dist/extractTyped.js

@@ -2,12 +2,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.extractTyped = extractTyped;
 const extractJson_js_1 = require("./extractJson.js");
-function extractTyped(text, schema) {
-    const json = (0, extractJson_js_1.extractJson)(text);
-    if (json === null) {
-        return null;
+function extractTyped(text, schema, sentinel) {
+    const results = (0, extractJson_js_1.extractJson)(text, sentinel);
+    const validated = [];
+    for (const json of results) {
+        const result = schema.safeParse(json);
+        if (result.success) {
+            validated.push(result.data);
+        }
     }
-    const result = schema.safeParse(json);
-    return result.success ? result.data : null;
+    return validated;
 }
 //# sourceMappingURL=extractTyped.js.map

package/dist/extractTyped.js.map

@@ -1 +1 @@
-{"version":3,"file":"extractTyped.js","sourceRoot":"","sources":["../src/extractTyped.ts"],"names":[],"mappings":";;AAIA,oCAQC;AAVD,qDAA+C;AAE/C,SAAgB,YAAY,CAAI,IAAY,EAAE,MAAkB;IAC9D,MAAM,IAAI,GAAG,IAAA,4BAAW,EAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACtC,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"extractTyped.js","sourceRoot":"","sources":["../src/extractTyped.ts"],"names":[],"mappings":";;AAYA,oCAcC;AA1BD,qDAA+C;AAY/C,SAAgB,YAAY,CAC1B,IAAY,EACZ,MAAqB,EACrB,QAAiB;IAEjB,MAAM,OAAO,GAAG,IAAA,4BAAW,EAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAQ,EAAE,CAAC;IAC1B,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/findBalanced.d.ts

@@ -1,2 +1,3 @@
 export declare function findBalanced(text: string, openChar: string, closeChar: string): string | null;
+export declare function findAllBalanced(text: string, openChar: string, closeChar: string): string[];
 //# sourceMappingURL=findBalanced.d.ts.map

package/dist/findBalanced.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"findBalanced.d.ts","sourceRoot":"","sources":["../src/findBalanced.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI,CA6Cf"}
+{"version":3,"file":"findBalanced.d.ts","sourceRoot":"","sources":["../src/findBalanced.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI,CA6Cf;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,MAAM,EAAE,CAiBV"}

package/dist/findBalanced.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.findBalanced = findBalanced;
+exports.findAllBalanced = findAllBalanced;
 function findBalanced(text, openChar, closeChar) {
     const start = text.indexOf(openChar);
     if (start === -1) {
@@ -40,4 +41,19 @@ function findBalanced(text, openChar, closeChar) {
     }
     return null;
 }
+function findAllBalanced(text, openChar, closeChar) {
+    const results = [];
+    let offset = 0;
+    while (offset < text.length) {
+        const remaining = text.slice(offset);
+        const match = findBalanced(remaining, openChar, closeChar);
+        if (match === null) {
+            break;
+        }
+        results.push(match);
+        const matchStart = remaining.indexOf(openChar);
+        offset += matchStart + match.length;
+    }
+    return results;
+}
 //# sourceMappingURL=findBalanced.js.map

package/dist/findBalanced.js.map

@@ -1 +1 @@
-{"version":3,"file":"findBalanced.js","sourceRoot":"","sources":["../src/findBalanced.ts"],"names":[],"mappings":";;AAAA,oCAiDC;AAjDD,SAAgB,YAAY,CAC1B,IAAY,EACZ,QAAgB,EAChB,SAAiB;IAEjB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEnB,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,GAAG,KAAK,CAAC;YAChB,SAAS;QACX,CAAC;QAED,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;YAChB,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACf,QAAQ,GAAG,CAAC,QAAQ,CAAC;YACrB,SAAS;QACX,CAAC;QAED,IAAI,QAAQ,EAAE,CAAC;YACb,SAAS;QACX,CAAC;QAED,IAAI,EAAE,KAAK,QAAQ,EAAE,CAAC;YACpB,KAAK,EAAE,CAAC;QACV,CAAC;aAAM,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;YAC5B,KAAK,EAAE,CAAC;YACR,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;gBAChB,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"findBalanced.js","sourceRoot":"","sources":["../src/findBalanced.ts"],"names":[],"mappings":";;AAAA,oCAiDC;AAED,0CAqBC;AAxED,SAAgB,YAAY,CAC1B,IAAY,EACZ,QAAgB,EAChB,SAAiB;IAEjB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEnB,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,GAAG,KAAK,CAAC;YAChB,SAAS;QACX,CAAC;QAED,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;YAChB,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACf,QAAQ,GAAG,CAAC,QAAQ,CAAC;YACrB,SAAS;QACX,CAAC;QAED,IAAI,QAAQ,EAAE,CAAC;YACb,SAAS;QACX,CAAC;QAED,IAAI,EAAE,KAAK,QAAQ,EAAE,CAAC;YACpB,KAAK,EAAE,CAAC;QACV,CAAC;aAAM,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;YAC5B,KAAK,EAAE,CAAC;YACR,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;gBAChB,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAgB,eAAe,CAC7B,IAAY,EACZ,QAAgB,EAChB,SAAiB;IAEjB,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf,OAAO,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACrC,MAAM,KAAK,GAAG,YAAY,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;QAC3D,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,MAAM;QACR,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,MAAM,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC/C,MAAM,IAAI,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC;IACtC,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export { extractCodeBlock } from "./extractCodeBlock.js";
 export { extractJson } from "./extractJson.js";
-export { extractTyped } from "./extractTyped.js";
+export { extractTyped, type SchemaLike } from "./extractTyped.js";
+export { extractTextContent, toPlainTextMessages, type MultimodalMessage, } from "./multimodal.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,iBAAiB,GACvB,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -1,10 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.extractTyped = exports.extractJson = exports.extractCodeBlock = void 0;
+exports.toPlainTextMessages = exports.extractTextContent = exports.extractTyped = exports.extractJson = exports.extractCodeBlock = void 0;
 var extractCodeBlock_js_1 = require("./extractCodeBlock.js");
 Object.defineProperty(exports, "extractCodeBlock", { enumerable: true, get: function () { return extractCodeBlock_js_1.extractCodeBlock; } });
 var extractJson_js_1 = require("./extractJson.js");
 Object.defineProperty(exports, "extractJson", { enumerable: true, get: function () { return extractJson_js_1.extractJson; } });
 var extractTyped_js_1 = require("./extractTyped.js");
 Object.defineProperty(exports, "extractTyped", { enumerable: true, get: function () { return extractTyped_js_1.extractTyped; } });
+var multimodal_js_1 = require("./multimodal.js");
+Object.defineProperty(exports, "extractTextContent", { enumerable: true, get: function () { return multimodal_js_1.extractTextContent; } });
+Object.defineProperty(exports, "toPlainTextMessages", { enumerable: true, get: function () { return multimodal_js_1.toPlainTextMessages; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,6DAAyD;AAAhD,uHAAA,gBAAgB,OAAA;AACzB,mDAA+C;AAAtC,6GAAA,WAAW,OAAA;AACpB,qDAAiD;AAAxC,+GAAA,YAAY,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,6DAAyD;AAAhD,uHAAA,gBAAgB,OAAA;AACzB,mDAA+C;AAAtC,6GAAA,WAAW,OAAA;AACpB,qDAAkE;AAAzD,+GAAA,YAAY,OAAA;AACrB,iDAIyB;AAHvB,mHAAA,kBAAkB,OAAA;AAClB,oHAAA,mBAAmB,OAAA"}

package/dist/multimodal.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Structural type for messages that may contain multimodal content.
+ * Compatible with AI SDK message formats and ChatMessage from @ai/shared.
+ */
+export interface MultimodalMessage {
+    role: "system" | "user" | "assistant";
+    content: string | {
+        type: string;
+        text?: string;
+    }[];
+}
+/**
+ * Extract text content from a message content field.
+ * Handles both plain string and multimodal content arrays.
+ */
+export declare function extractTextContent(content: MultimodalMessage["content"]): string;
+/**
+ * Convert multimodal messages to plain text messages.
+ * Flattens any multimodal content arrays to plain text strings.
+ */
+export declare function toPlainTextMessages(messages: MultimodalMessage[]): {
+    role: "system" | "user" | "assistant";
+    content: string;
+}[];
+//# sourceMappingURL=multimodal.d.ts.map

package/dist/multimodal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multimodal.d.ts","sourceRoot":"","sources":["../src/multimodal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACrD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,iBAAiB,CAAC,SAAS,CAAC,GACpC,MAAM,CAWR;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,iBAAiB,EAAE,GAC5B;IAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,CAK9D"}

package/dist/multimodal.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractTextContent = extractTextContent;
+exports.toPlainTextMessages = toPlainTextMessages;
+/**
+ * Extract text content from a message content field.
+ * Handles both plain string and multimodal content arrays.
+ */
+function extractTextContent(content) {
+    if (typeof content === "string") {
+        return content;
+    }
+    return content
+        .filter((c) => c.type === "text" && typeof c.text === "string")
+        .map((c) => c.text)
+        .join("\n");
+}
+/**
+ * Convert multimodal messages to plain text messages.
+ * Flattens any multimodal content arrays to plain text strings.
+ */
+function toPlainTextMessages(messages) {
+    return messages.map((m) => ({
+        role: m.role,
+        content: extractTextContent(m.content),
+    }));
+}
+//# sourceMappingURL=multimodal.js.map

package/dist/multimodal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multimodal.js","sourceRoot":"","sources":["../src/multimodal.ts"],"names":[],"mappings":";;AAaA,gDAaC;AAMD,kDAOC;AA9BD;;;GAGG;AACH,SAAgB,kBAAkB,CAChC,OAAqC;IAErC,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,OAAO;SACX,MAAM,CACL,CAAC,CAAC,EAAuC,EAAE,CACzC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAClD;SACA,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAClB,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,SAAgB,mBAAmB,CACjC,QAA6B;IAE7B,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1B,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,OAAO,CAAC;KACvC,CAAC,CAAC,CAAC;AACN,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hardlydifficult/ai-msg",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
@@ -14,14 +14,6 @@
     "lint": "tsc --noEmit",
     "clean": "rm -rf dist"
   },
-  "peerDependencies": {
-    "zod": ">=3.0.0"
-  },
-  "peerDependenciesMeta": {
-    "zod": {
-      "optional": true
-    }
-  },
   "devDependencies": {
     "typescript": "5.8.3",
     "vitest": "1.6.1",