@delofarag/ai-utils 1.4.2 → 1.5.0

package/dist/magic-funcs/optimizers/ragify.d.ts

@@ -1,4 +1,20 @@
 import { BaseChatModel } from "../../imports";
+/**
+ * Optimiert Input zu einem dichten, RAG-freundlichen Kontexttext.
+ *
+ * Sinnvoll vor Embedding/Indexing, um Redundanz zu reduzieren und Fakten klar zu strukturieren.
+ *
+ * @param params.llm Optionales Chat-LLM.
+ * @param params.data Rohtext, der fuer RAG optimiert werden soll.
+ * @returns Strukturierter Kontext als String.
+ *
+ * @example
+ * ```ts
+ * const context = await ragify({
+ *   data: "Langer Meeting- und Projektext mit vielen Wiederholungen..."
+ * })
+ * ```
+ */
 export declare function ragify({ llm, data, }: {
     llm?: BaseChatModel;
     data: string;

package/dist/magic-funcs/optimizers/ragify.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ragify.d.ts","sourceRoot":"","sources":["../../../src/magic-funcs/optimizers/ragify.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAK7C,wBAAsB,MAAM,CAAC,EACzB,GAAuE,EACvE,IAAI,GACL,EAAE;IACD,GAAG,CAAC,EAAE,aAAa,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;CACb,GAAG,OAAO,CAAC,MAAM,CAAC,CAqClB"}
+{"version":3,"file":"ragify.d.ts","sourceRoot":"","sources":["../../../src/magic-funcs/optimizers/ragify.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAK7C;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,MAAM,CAAC,EACzB,GAAkF,EAClF,IAAI,GACL,EAAE;IACD,GAAG,CAAC,EAAE,aAAa,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;CACb,GAAG,OAAO,CAAC,MAAM,CAAC,CAqClB"}

package/dist/magic-funcs/optimizers/ragify.js

@@ -1,8 +1,24 @@
-import { getLLM } from "../../helpers";
+import { getLLM } from "../../helpers/llms";
 import { ChatPromptTemplate } from "../../imports";
-import { createSimpleChain } from "../../helpers";
+import { createSimpleChain } from "../../helpers/helpers";
 import { StringOutputParser } from "../../imports";
-export async function ragify({ llm = getLLM({ type: "groq", apikey: process.env.CHATGROQ_API_KEY ?? "" }), data, }) {
+/**
+ * Optimiert Input zu einem dichten, RAG-freundlichen Kontexttext.
+ *
+ * Sinnvoll vor Embedding/Indexing, um Redundanz zu reduzieren und Fakten klar zu strukturieren.
+ *
+ * @param params.llm Optionales Chat-LLM.
+ * @param params.data Rohtext, der fuer RAG optimiert werden soll.
+ * @returns Strukturierter Kontext als String.
+ *
+ * @example
+ * ```ts
+ * const context = await ragify({
+ *   data: "Langer Meeting- und Projektext mit vielen Wiederholungen..."
+ * })
+ * ```
+ */
+export async function ragify({ llm = getLLM({ provider: "chatgroq", apikey: process.env.CHATGROQ_API_KEY ?? "" }), data, }) {
     const prompt = ChatPromptTemplate.fromMessages([
         ["system", `
         Du bist ein RAG-Kontext-Optimierer.

package/dist/magic-funcs/optimizers/ragify.js.map

@@ -1 +1 @@
-{"version":3,"file":"ragify.js","sourceRoot":"","sources":["../../../src/magic-funcs/optimizers/ragify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAEtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAElD,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,EACzB,GAAG,GAAG,MAAM,CAAC,EAAC,IAAI,EAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE,EAAC,CAAC,EACvE,IAAI,GAIL;IAEC,MAAM,MAAM,GAAG,kBAAkB,CAAC,YAAY,CAAC;QAC7C,CAAC,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;aA0BJ,CAAC;QACR,CAAC,OAAO,EAAE,SAAS,CAAC;KACrB,CAAC,CAAA;IAEF,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,kBAAkB,EAAE,CAAC,CAAA;IACtE,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IAElD,OAAO,MAAgB,CAAA;AACzB,CAAC"}
+{"version":3,"file":"ragify.js","sourceRoot":"","sources":["../../../src/magic-funcs/optimizers/ragify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAE3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAElD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,EACzB,GAAG,GAAG,MAAM,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE,EAAE,CAAC,EAClF,IAAI,GAIL;IAEC,MAAM,MAAM,GAAG,kBAAkB,CAAC,YAAY,CAAC;QAC7C,CAAC,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;aA0BJ,CAAC;QACR,CAAC,OAAO,EAAE,SAAS,CAAC;KACrB,CAAC,CAAA;IAEF,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,kBAAkB,EAAE,CAAC,CAAA;IACtE,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IAElD,OAAO,MAAgB,CAAA;AACzB,CAAC"}

package/dist/magic-funcs/parsers/extract.d.ts

@@ -1,5 +1,28 @@
 import { BaseChatModel } from "../../imports";
 import { z } from "zod/v3";
+/**
+ * Extrahiert strukturierte Daten aus unstrukturiertem Input anhand eines Zod-Schemas.
+ *
+ * Sinnvoll fuer Information Extraction aus Texten, Notizen, Tickets oder Logs.
+ *
+ * @param params.llm Optionales Chat-LLM.
+ * @param params.data Eingabedaten (String oder Objekt).
+ * @param params.goal Optionales Extraktionsziel zur Fokussierung.
+ * @param params.schema Zod-Schema der gewuenschten Ausgabe.
+ * @returns Geparstes Ergebnis als `z.infer<T>`.
+ *
+ * @example
+ * ```ts
+ * const result = await extract({
+ *   data: "Max Mustermann, 32, Berlin",
+ *   schema: z.object({
+ *     name: z.string(),
+ *     age: z.number(),
+ *     city: z.string()
+ *   })
+ * })
+ * ```
+ */
 export declare function extract<T extends z.ZodObject<any>>({ llm, data, goal, schema }: {
     llm?: BaseChatModel;
     data: any;

package/dist/magic-funcs/parsers/extract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../../src/magic-funcs/parsers/extract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAE7C,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAI1B,wBAAsB,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,EACtD,GAAuE,EACvE,IAAI,EACJ,IAAI,EACJ,MAAM,EACP,EAAE;IACD,GAAG,CAAC,EAAE,aAAa,CAAA;IACnB,IAAI,EAAE,GAAG,CAAA;IACT,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,CAAC,CAAA;CACV,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAiCtB"}
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../../src/magic-funcs/parsers/extract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAE7C,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAK1B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,EACtD,GAAiH,EACjH,IAAI,EACJ,IAAI,EACJ,MAAM,EACP,EAAE;IACD,GAAG,CAAC,EAAE,aAAa,CAAA;IACnB,IAAI,EAAE,GAAG,CAAA;IACT,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,CAAC,CAAA;CACV,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAiCtB"}

package/dist/magic-funcs/parsers/extract.js

@@ -1,8 +1,31 @@
-import { createSimpleChain } from "../../helpers";
+import { createSimpleChain } from "../../helpers/helpers";
 import { ChatPromptTemplate } from "../../imports";
-import { getLLM } from "../../helpers";
 import { StructuredOutputParser } from "../../imports";
-export async function extract({ llm = getLLM({ type: "groq", apikey: process.env.CHATGROQ_API_KEY ?? "" }), data, goal, schema }) {
+import { getLLM } from "../../helpers/llms";
+/**
+ * Extrahiert strukturierte Daten aus unstrukturiertem Input anhand eines Zod-Schemas.
+ *
+ * Sinnvoll fuer Information Extraction aus Texten, Notizen, Tickets oder Logs.
+ *
+ * @param params.llm Optionales Chat-LLM.
+ * @param params.data Eingabedaten (String oder Objekt).
+ * @param params.goal Optionales Extraktionsziel zur Fokussierung.
+ * @param params.schema Zod-Schema der gewuenschten Ausgabe.
+ * @returns Geparstes Ergebnis als `z.infer<T>`.
+ *
+ * @example
+ * ```ts
+ * const result = await extract({
+ *   data: "Max Mustermann, 32, Berlin",
+ *   schema: z.object({
+ *     name: z.string(),
+ *     age: z.number(),
+ *     city: z.string()
+ *   })
+ * })
+ * ```
+ */
+export async function extract({ llm = getLLM({ provider: "openrouter", apikey: process.env.OPENROUTER_API_KEY ?? "", model: "openai/gpt-5.4-mini" }), data, goal, schema }) {
     const inputString = typeof data === "string"
         ? data
         : JSON.stringify(data, null, 2);

package/dist/magic-funcs/parsers/extract.js.map

@@ -1 +1 @@
-{"version":3,"file":"extract.js","sourceRoot":"","sources":["../../../src/magic-funcs/parsers/extract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAEjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAElD,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AACtC,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AAEtD,MAAM,CAAC,KAAK,UAAU,OAAO,CAA6B,EACtD,GAAG,GAAG,MAAM,CAAC,EAAC,IAAI,EAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE,EAAC,CAAC,EACvE,IAAI,EACJ,IAAI,EACJ,MAAM,EAMP;IAEC,MAAM,WAAW,GAAG,OAAO,IAAI,KAAK,QAAQ;QAC1C,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IAEjC,MAAM,MAAM,GAAG,sBAAsB,CAAC,aAAa,CAAC,MAAM,CAAC,CAAA;IAC3D,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,YAAY,CAAC;QACnD,CAAC,QAAQ,EAAE;;;;YAIL,IAAI,CAAC,CAAC,CAAC;;;aAGN,IAAI,GAAG;gBACZ,CAAC;oBACA,mFAAmF;;;;;;;;;;aAU/E,CAAC;QACR,CAAC,OAAO,EAAE,SAAS,CAAC;KACrB,CAAC,CAAC,OAAO,CAAC,EAAE,mBAAmB,EAAE,MAAM,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAA;IACnE,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAA;IACpD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAA;IACzD,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;AAC7B,CAAC"}
+{"version":3,"file":"extract.js","sourceRoot":"","sources":["../../../src/magic-funcs/parsers/extract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAEzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAGlD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAE3C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAA6B,EACtD,GAAG,GAAG,MAAM,CAAC,EAAC,QAAQ,EAAC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE,EAAE,KAAK,EAAE,qBAAqB,EAAC,CAAC,EACjH,IAAI,EACJ,IAAI,EACJ,MAAM,EAMP;IAEC,MAAM,WAAW,GAAG,OAAO,IAAI,KAAK,QAAQ;QAC1C,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IAEjC,MAAM,MAAM,GAAG,sBAAsB,CAAC,aAAa,CAAC,MAAM,CAAC,CAAA;IAC3D,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,YAAY,CAAC;QACnD,CAAC,QAAQ,EAAE;;;;YAIL,IAAI,CAAC,CAAC,CAAC;;;aAGN,IAAI,GAAG;gBACZ,CAAC;oBACA,mFAAmF;;;;;;;;;;aAU/E,CAAC;QACR,CAAC,OAAO,EAAE,SAAS,CAAC;KACrB,CAAC,CAAC,OAAO,CAAC,EAAE,mBAAmB,EAAE,MAAM,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAA;IACnE,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAA;IACpD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAA;IACzD,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;AAC7B,CAAC"}

package/dist/magic-funcs/parsers/rewrite.d.ts

@@ -1,4 +1,23 @@
 import { BaseChatModel } from "../../imports";
+/**
+ * Schreibt Input nach einer konkreten Anweisung um.
+ *
+ * Sinnvoll fuer Stiltransformation, Formatumwandlung, Tonalitaetswechsel oder Reduktion.
+ *
+ * @param params.data Eingabedaten (String oder Objekt).
+ * @param params.instruction Konkrete Transformationsanweisung.
+ * @param params.llm Optionales Chat-LLM.
+ * @param params.retries Anzahl der Wiederholungen bei Fehlern.
+ * @returns Transformierter Output als String.
+ *
+ * @example
+ * ```ts
+ * const result = await rewrite({
+ *   data: "Bitte sehr freundlich schreiben.",
+ *   instruction: "Formuliere als kurze, professionelle E-Mail."
+ * })
+ * ```
+ */
 export declare function rewrite({ data, instruction, llm, retries }: {
     data: any;
     instruction: string;

package/dist/magic-funcs/parsers/rewrite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rewrite.d.ts","sourceRoot":"","sources":["../../../src/magic-funcs/parsers/rewrite.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAG7C,wBAAsB,OAAO,CAAC,EAC5B,IAAI,EACJ,WAAW,EACX,GAA0E,EAC1E,OAAW,EACZ,EAAE;IACD,IAAI,EAAE,GAAG,CAAA;IACT,WAAW,EAAE,MAAM,CAAA;IACnB,GAAG,CAAC,EAAE,aAAa,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkClB"}
+{"version":3,"file":"rewrite.d.ts","sourceRoot":"","sources":["../../../src/magic-funcs/parsers/rewrite.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAI7C;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,OAAO,CAAC,EAC5B,IAAI,EACJ,WAAW,EACX,GAAmH,EACnH,OAAW,EACZ,EAAE;IACD,IAAI,EAAE,GAAG,CAAA;IACT,WAAW,EAAE,MAAM,CAAA;IACnB,GAAG,CAAC,EAAE,aAAa,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkClB"}

package/dist/magic-funcs/parsers/rewrite.js

@@ -1,7 +1,27 @@
 import { StringOutputParser } from "@langchain/core/output_parsers";
-import { createSimpleChain, getLLM } from "../../helpers";
+import { createSimpleChain } from "../../helpers/helpers";
 import { ChatPromptTemplate } from "../../imports";
-export async function rewrite({ data, instruction, llm = getLLM({ type: "groq", apikey: process.env.CHATGROQ_API_KEY ?? "" }), retries = 2 }) {
+import { getLLM } from "../../helpers/llms";
+/**
+ * Schreibt Input nach einer konkreten Anweisung um.
+ *
+ * Sinnvoll fuer Stiltransformation, Formatumwandlung, Tonalitaetswechsel oder Reduktion.
+ *
+ * @param params.data Eingabedaten (String oder Objekt).
+ * @param params.instruction Konkrete Transformationsanweisung.
+ * @param params.llm Optionales Chat-LLM.
+ * @param params.retries Anzahl der Wiederholungen bei Fehlern.
+ * @returns Transformierter Output als String.
+ *
+ * @example
+ * ```ts
+ * const result = await rewrite({
+ *   data: "Bitte sehr freundlich schreiben.",
+ *   instruction: "Formuliere als kurze, professionelle E-Mail."
+ * })
+ * ```
+ */
+export async function rewrite({ data, instruction, llm = getLLM({ provider: "openrouter", apikey: process.env.OPENROUTER_API_KEY ?? "", model: "openai/gpt-5.4-mini" }), retries = 2 }) {
     const inputString = typeof data === "string" ? data : JSON.stringify(data, null, 2);
     const prompt = ChatPromptTemplate.fromMessages([
         [

package/dist/magic-funcs/parsers/rewrite.js.map

@@ -1 +1 @@
-{"version":3,"file":"rewrite.js","sourceRoot":"","sources":["../../../src/magic-funcs/parsers/rewrite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAEzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAElD,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,EAC5B,IAAI,EACJ,WAAW,EACX,GAAG,GAAG,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE,EAAE,CAAC,EAC1E,OAAO,GAAG,CAAC,EAMZ;IACC,MAAM,WAAW,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IAEnF,MAAM,MAAM,GAAG,kBAAkB,CAAC,YAAY,CAAC;QAC7C;YACE,QAAQ;YACR;;;;;;;;yFAQmF;SACpF;QACD,CAAC,OAAO,EAAE,SAAS,CAAC;KACrB,CAAC,CAAA;IAEF,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,kBAAkB,EAAE,CAAC,CAAA;IAEtE,IAAI,SAAS,GAAiB,IAAI,CAAA;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,CAAA;YACtE,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QAC7D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAc,CAAA;YAC1B,IAAI,CAAC,GAAG,OAAO,EAAE,CAAC;gBAChB,OAAO,CAAC,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAA;YACrE,CAAC;QACH,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,0BAA0B,OAAO,GAAG,CAAC,0BAA0B,SAAS,EAAE,OAAO,EAAE,CAAC,CAAA;AACtG,CAAC"}
+{"version":3,"file":"rewrite.js","sourceRoot":"","sources":["../../../src/magic-funcs/parsers/rewrite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAEzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAE3C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,EAC5B,IAAI,EACJ,WAAW,EACX,GAAG,GAAG,MAAM,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE,EAAE,KAAK,EAAE,qBAAqB,EAAC,CAAC,EACnH,OAAO,GAAG,CAAC,EAMZ;IACC,MAAM,WAAW,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IAEnF,MAAM,MAAM,GAAG,kBAAkB,CAAC,YAAY,CAAC;QAC7C;YACE,QAAQ;YACR;;;;;;;;yFAQmF;SACpF;QACD,CAAC,OAAO,EAAE,SAAS,CAAC;KACrB,CAAC,CAAA;IAEF,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,kBAAkB,EAAE,CAAC,CAAA;IAEtE,IAAI,SAAS,GAAiB,IAAI,CAAA;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,CAAA;YACtE,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QAC7D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAc,CAAA;YAC1B,IAAI,CAAC,GAAG,OAAO,EAAE,CAAC;gBAChB,OAAO,CAAC,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAA;YACrE,CAAC;QACH,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,0BAA0B,OAAO,GAAG,CAAC,0BAA0B,SAAS,EAAE,OAAO,EAAE,CAAC,CAAA;AACtG,CAAC"}

package/dist/magic-funcs/parsers/structure.d.ts

@@ -1,6 +1,28 @@
 import { BaseChatModel } from "../../imports";
 import type { OutputSchema } from "../../heart/chain";
 import { z } from "zod/v3";
+/**
+ * Bringt beliebigen Input in ein vorgegebenes Zod-Schema.
+ *
+ * Sinnvoll wenn Modelloutput robust als JSON-Struktur benoetigt wird.
+ *
+ * @param params.data Rohdaten, die strukturiert werden sollen.
+ * @param params.into Ziel-Schema (`z.object(...)` oder `z.record(...)`).
+ * @param params.llm Optionales Chat-LLM.
+ * @param params.retries Anzahl der Wiederholungsversuche bei Parsing-Fehlern.
+ * @returns Valider, schema-konformer Output als `z.infer<T>`.
+ *
+ * @example
+ * ```ts
+ * const result = await structure({
+ *   data: "Titel: Demo, Prioritaet: hoch",
+ *   into: z.object({
+ *     title: z.string(),
+ *     priority: z.enum(["niedrig", "mittel", "hoch"])
+ *   })
+ * })
+ * ```
+ */
 export declare function structure<T extends OutputSchema>({ data, into, llm, retries }: {
     data: any;
     into: T;

package/dist/magic-funcs/parsers/structure.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"structure.d.ts","sourceRoot":"","sources":["../../../src/magic-funcs/parsers/structure.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAA0B,MAAM,eAAe,CAAA;AAErE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,wBAAsB,SAAS,CAAC,CAAC,SAAS,YAAY,EAAE,EACpD,IAAI,EACJ,IAAI,EACJ,GAAuE,EACvE,OAAW,EACd,EAAC;IACE,IAAI,EAAE,GAAG,CAAC;IACV,IAAI,EAAE,CAAC,CAAC;IACR,GAAG,CAAC,EAAE,aAAa,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;CACnB,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CA8BtB"}
+{"version":3,"file":"structure.d.ts","sourceRoot":"","sources":["../../../src/magic-funcs/parsers/structure.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAA0B,MAAM,eAAe,CAAA;AAErE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAG1B;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,SAAS,CAAC,CAAC,SAAS,YAAY,EAAE,EACpD,IAAI,EACJ,IAAI,EACJ,GAAiH,EACjH,OAAW,EACd,EAAC;IACE,IAAI,EAAE,GAAG,CAAC;IACV,IAAI,EAAE,CAAC,CAAC;IACR,GAAG,CAAC,EAAE,aAAa,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;CACnB,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CA8BtB"}

package/dist/magic-funcs/parsers/structure.js

@@ -1,9 +1,32 @@
-import { createSimpleChain, getLLM } from "../../helpers";
+import { createSimpleChain } from "../../helpers/helpers";
 import { StructuredOutputParser } from "../../imports";
 import { ChatPromptTemplate } from "../../imports";
-export async function structure({ data, into, llm = getLLM({ type: "groq", apikey: process.env.CHATGROQ_API_KEY ?? "" }), retries = 2 }) {
-    if (!process.env.CHATGROQ_API_KEY)
-        throw new Error("CHATGROQ_API_KEY is not set for structure() call");
+import { getLLM } from "../../helpers/llms";
+/**
+ * Bringt beliebigen Input in ein vorgegebenes Zod-Schema.
+ *
+ * Sinnvoll wenn Modelloutput robust als JSON-Struktur benoetigt wird.
+ *
+ * @param params.data Rohdaten, die strukturiert werden sollen.
+ * @param params.into Ziel-Schema (`z.object(...)` oder `z.record(...)`).
+ * @param params.llm Optionales Chat-LLM.
+ * @param params.retries Anzahl der Wiederholungsversuche bei Parsing-Fehlern.
+ * @returns Valider, schema-konformer Output als `z.infer<T>`.
+ *
+ * @example
+ * ```ts
+ * const result = await structure({
+ *   data: "Titel: Demo, Prioritaet: hoch",
+ *   into: z.object({
+ *     title: z.string(),
+ *     priority: z.enum(["niedrig", "mittel", "hoch"])
+ *   })
+ * })
+ * ```
+ */
+export async function structure({ data, into, llm = getLLM({ provider: "openrouter", apikey: process.env.OPENROUTER_API_KEY ?? "", model: "openai/gpt-5.4-mini" }), retries = 2 }) {
+    if (!process.env.OPENROUTER_API_KEY)
+        throw new Error("OPENROUTER_API_KEY is not set for structure() call");
     const inputString = typeof data === "string" ? data : JSON.stringify(data, null, 2);
     const jsonParser = StructuredOutputParser.fromZodSchema(into);
     const prompt = await ChatPromptTemplate.fromMessages([

package/dist/magic-funcs/parsers/structure.js.map

@@ -1 +1 @@
-{"version":3,"file":"structure.js","sourceRoot":"","sources":["../../../src/magic-funcs/parsers/structure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AACzD,OAAO,EAAiB,sBAAsB,EAAE,MAAM,eAAe,CAAA;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAIlD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAyB,EACpD,IAAI,EACJ,IAAI,EACJ,GAAG,GAAG,MAAM,CAAC,EAAC,IAAI,EAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE,EAAC,CAAC,EACvE,OAAO,GAAG,CAAC,EAMd;IACG,IAAG,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB;QAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAA;IACrG,MAAM,WAAW,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IACnF,MAAM,UAAU,GAAG,sBAAsB,CAAC,aAAa,CAAC,IAAI,CAAC,CAAA;IAC7D,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,YAAY,CAAC;QACjD,CAAC,QAAQ,EAAE;;;;;;;kCAOe,CAAC;QAC3B,CAAC,OAAO,EAAE,SAAS,CAAC;KACvB,CAAC,CAAC,OAAO,CAAC,EAAE,mBAAmB,EAAE,UAAU,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAA;IACvE,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,UAAU,CAAC,CAAA;IAExD,IAAI,SAAS,GAAiB,IAAI,CAAA;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAA;YACzD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QAC7B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,SAAS,GAAG,KAAc,CAAA;YAC1B,IAAI,CAAC,GAAG,OAAO,EAAE,CAAC;gBACd,OAAO,CAAC,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAA;YACzE,CAAC;QACL,CAAC;IACL,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,4BAA4B,OAAO,GAAG,CAAC,qBAAqB,SAAS,EAAE,OAAO,EAAE,CAAC,CAAA;AACrG,CAAC"}
+{"version":3,"file":"structure.js","sourceRoot":"","sources":["../../../src/magic-funcs/parsers/structure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAAiB,sBAAsB,EAAE,MAAM,eAAe,CAAA;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAGlD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAE3C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAyB,EACpD,IAAI,EACJ,IAAI,EACJ,GAAG,GAAG,MAAM,CAAC,EAAC,QAAQ,EAAC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE,EAAE,KAAK,EAAE,qBAAqB,EAAC,CAAC,EACjH,OAAO,GAAG,CAAC,EAMd;IACG,IAAG,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB;QAAE,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAA;IACzG,MAAM,WAAW,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IACnF,MAAM,UAAU,GAAG,sBAAsB,CAAC,aAAa,CAAC,IAAI,CAAC,CAAA;IAC7D,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,YAAY,CAAC;QACjD,CAAC,QAAQ,EAAE;;;;;;;kCAOe,CAAC;QAC3B,CAAC,OAAO,EAAE,SAAS,CAAC;KACvB,CAAC,CAAC,OAAO,CAAC,EAAE,mBAAmB,EAAE,UAAU,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAA;IACvE,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,UAAU,CAAC,CAAA;IAExD,IAAI,SAAS,GAAiB,IAAI,CAAA;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAA;YACzD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QAC7B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,SAAS,GAAG,KAAc,CAAA;YAC1B,IAAI,CAAC,GAAG,OAAO,EAAE,CAAC;gBACd,OAAO,CAAC,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAA;YACzE,CAAC;QACL,CAAC;IACL,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,4BAA4B,OAAO,GAAG,CAAC,qBAAqB,SAAS,EAAE,OAAO,EAAE,CAAC,CAAA;AACrG,CAAC"}

package/dist/magic-funcs/parsers/summarize.d.ts

@@ -1,4 +1,24 @@
 import { BaseChatModel } from "../../imports";
+/**
+ * Fasst Input kompakt und faktengetreu zusammen.
+ *
+ * Sinnvoll fuer Report-Kuerzung, Ticket-Digests, Meeting-Recaps oder Vorverarbeitung.
+ *
+ * @param params.llm Optionales Chat-LLM.
+ * @param params.data Zu zusammenfassender Input.
+ * @param params.fokuss Optionaler Fokusbereich fuer die Zusammenfassung.
+ * @param params.maxWords Maximal erlaubte Wortanzahl.
+ * @returns Zusammenfassung als String.
+ *
+ * @example
+ * ```ts
+ * const summary = await summarize({
+ *   data: longText,
+ *   fokuss: "Risiken und naechste Schritte",
+ *   maxWords: 80
+ * })
+ * ```
+ */
 export declare function summarize({ llm, data, fokuss, maxWords }: {
     llm?: BaseChatModel;
     data: any;

package/dist/magic-funcs/parsers/summarize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../../../src/magic-funcs/parsers/summarize.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAI7C,wBAAsB,SAAS,CAAC,EAC5B,GAAuE,EACvE,IAAI,EACJ,MAAM,EACN,QAAc,EACf,EAAC;IACA,GAAG,CAAC,EAAC,aAAa,CAAC;IACnB,IAAI,EAAC,GAAG,CAAC;IACT,MAAM,CAAC,EAAC,MAAM,CAAC;IACf,QAAQ,CAAC,EAAC,MAAM,CAAA;CACjB,GAAE,OAAO,CAAC,MAAM,CAAC,CAwCjB"}
+{"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../../../src/magic-funcs/parsers/summarize.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAI7C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,SAAS,CAAC,EAC5B,GAAiH,EACjH,IAAI,EACJ,MAAM,EACN,QAAc,EACf,EAAC;IACA,GAAG,CAAC,EAAC,aAAa,CAAC;IACnB,IAAI,EAAC,GAAG,CAAC;IACT,MAAM,CAAC,EAAC,MAAM,CAAC;IACf,QAAQ,CAAC,EAAC,MAAM,CAAA;CACjB,GAAE,OAAO,CAAC,MAAM,CAAC,CAwCjB"}

package/dist/magic-funcs/parsers/summarize.js

@@ -1,8 +1,28 @@
 import { StringOutputParser } from "@langchain/core/output_parsers";
-import { createSimpleChain } from "../../helpers";
+import { createSimpleChain } from "../../helpers/helpers";
 import { ChatPromptTemplate } from "../../imports";
-import { getLLM } from "../../helpers";
-export async function summarize({ llm = getLLM({ type: "groq", apikey: process.env.CHATGROQ_API_KEY ?? "" }), data, fokuss, maxWords = 150 }) {
+import { getLLM } from "../../helpers/llms";
+/**
+ * Fasst Input kompakt und faktengetreu zusammen.
+ *
+ * Sinnvoll fuer Report-Kuerzung, Ticket-Digests, Meeting-Recaps oder Vorverarbeitung.
+ *
+ * @param params.llm Optionales Chat-LLM.
+ * @param params.data Zu zusammenfassender Input.
+ * @param params.fokuss Optionaler Fokusbereich fuer die Zusammenfassung.
+ * @param params.maxWords Maximal erlaubte Wortanzahl.
+ * @returns Zusammenfassung als String.
+ *
+ * @example
+ * ```ts
+ * const summary = await summarize({
+ *   data: longText,
+ *   fokuss: "Risiken und naechste Schritte",
+ *   maxWords: 80
+ * })
+ * ```
+ */
+export async function summarize({ llm = getLLM({ provider: "openrouter", apikey: process.env.OPENROUTER_API_KEY ?? "", model: "openai/gpt-5.4-mini" }), data, fokuss, maxWords = 150 }) {
     const inputString = typeof data === "string" ? data : JSON.stringify(data, null, 2);
     const prompt = ChatPromptTemplate.fromMessages([
         ["system", `

package/dist/magic-funcs/parsers/summarize.js.map

@@ -1 +1 @@
-{"version":3,"file":"summarize.js","sourceRoot":"","sources":["../../../src/magic-funcs/parsers/summarize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAEjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAEtC,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,EAC5B,GAAG,GAAG,MAAM,CAAC,EAAC,IAAI,EAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE,EAAC,CAAC,EACvE,IAAI,EACJ,MAAM,EACN,QAAQ,GAAG,GAAG,EAMf;IACG,MAAM,WAAW,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IACnF,MAAM,MAAM,GAAG,kBAAkB,CAAC,YAAY,CAAC;QAC7C,CAAC,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;sBAqBG,QAAQ;;;YAGlB,MAAM,CAAC,CAAC,CAAC;;cAEP,MAAM;;WAET,CAAC,CAAC,CAAC,EAAE;;;WAGL,CAAC;QACF,CAAC,OAAO,EAAC,SAAS,CAAC;KACtB,CAAC,CAAA;IACF,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,EAAC,GAAG,EAAC,IAAI,kBAAkB,EAAE,CAAC,CAAA;IACpE,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,EAAC,WAAW,EAAE,CAAC,CAAA;IACxD,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;AAC/D,CAAC"}
+{"version":3,"file":"summarize.js","sourceRoot":"","sources":["../../../src/magic-funcs/parsers/summarize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAEzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAE3C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,EAC5B,GAAG,GAAG,MAAM,CAAC,EAAC,QAAQ,EAAC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE,EAAE,KAAK,EAAE,qBAAqB,EAAC,CAAC,EACjH,IAAI,EACJ,MAAM,EACN,QAAQ,GAAG,GAAG,EAMf;IACG,MAAM,WAAW,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IACnF,MAAM,MAAM,GAAG,kBAAkB,CAAC,YAAY,CAAC;QAC7C,CAAC,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;sBAqBG,QAAQ;;;YAGlB,MAAM,CAAC,CAAC,CAAC;;cAEP,MAAM;;WAET,CAAC,CAAC,CAAC,EAAE;;;WAGL,CAAC;QACF,CAAC,OAAO,EAAC,SAAS,CAAC;KACtB,CAAC,CAAA;IACF,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,EAAC,GAAG,EAAC,IAAI,kBAAkB,EAAE,CAAC,CAAA;IACpE,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,EAAC,WAAW,EAAE,CAAC,CAAA;IACxD,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;AAC/D,CAAC"}

package/dist/memory.d.ts

@@ -35,7 +35,7 @@ interface SmartCheckpointSaverOptions {
         {
             messagesBeforeSummary = 12,
             maxSummaries = 7,
-            llm = getLLM({ type:"groq" }),
+            llm = getLLM({ provider:"chatgroq" }),
             debug = false
         }: SmartCheckpointSaverOptions = {}
     ) {

package/dist/modalities/image-gen/generateImages.d.ts

@@ -0,0 +1,56 @@
+import { OpenRouterImageGenModel } from "../../helpers/llms";
+import { LLMInstance } from "../openrouter";
+import { ImageConfig, ImageGenModalities } from "./helpers";
+type ImageGenOptions = {
+    llm?: LLMInstance;
+    prompt: string;
+    modalities?: ImageGenModalities;
+    imageConfig?: ImageConfig;
+    model?: OpenRouterImageGenModel;
+};
+/**
+ * Generates images from a text prompt using OpenRouter image-generation models.
+ *
+ * Internally this function calls OpenRouter through the chat-completions-compatible
+ * interface with `modalities` and optional `image_config`. If no `llm` is provided,
+ * it creates one with `getLLM({ provider: "openrouter", type: "image-gen" })` and
+ * reads `process.env.OPENROUTER_API_KEY`.
+ *
+ * Make sure `OPENROUTER_API_KEY` is set in your `.env`.
+ *
+ * @param params.llm Optional LLM instance from `getLLM(...)`.
+ * @param params.prompt Image generation prompt (for example: "create a cat in watercolor style").
+ * @param params.modalities Output modalities for the model call.
+ * @param params.imageConfig Optional image generation settings (for example aspect ratio/size).
+ * @param params.model Optional model override for this call.
+ * @returns Promise containing extracted image URLs/data URLs, optional text, and raw response.
+ *
+ * @example
+ * CONFIG:
+ * ```ts
+ * generateImages({
+ *     llm = getLLM({ provider: "openrouter", type: "image-gen" }),
+ *     modalities = ["image", "text"],
+ *     imageConfig = { aspect_ratio: "1:1", image_size: "2K" },
+ *     model,
+ *     prompt
+ * })
+ * ```
+ *
+ * @example
+ * ```ts
+ * const result = await generateImages({
+ *     prompt: "Generate a cozy cat illustration",
+ *     imageConfig: { aspect_ratio: "1:1", image_size: "2K" }
+ * });
+ *
+ * console.log(result.images[0]);
+ * ```
+ */
+export declare function generateImages({ llm, modalities, imageConfig, model, prompt }: ImageGenOptions): Promise<{
+    images: string[];
+    text?: string;
+    raw: unknown;
+}>;
+export {};
+//# sourceMappingURL=generateImages.d.ts.map

package/dist/modalities/image-gen/generateImages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateImages.d.ts","sourceRoot":"","sources":["../../../src/modalities/image-gen/generateImages.ts"],"names":[],"mappings":"AACA,OAAO,EAAU,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AACpE,OAAO,EAAE,WAAW,EAAwB,MAAM,eAAe,CAAA;AACjE,OAAO,EAAoB,WAAW,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAE7E,KAAK,eAAe,GAAG;IACnB,GAAG,CAAC,EAAE,WAAW,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,kBAAkB,CAAA;IAC/B,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,KAAK,CAAC,EAAE,uBAAuB,CAAA;CAClC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAsB,cAAc,CAAC,EACjC,GAA2D,EAC3D,UAA8B,EAC9B,WAAuD,EACvD,KAAK,EACL,MAAM,EACT,EAAE,eAAe,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,CAAC,CAyB9E"}

package/dist/modalities/image-gen/generateImages.js

@@ -0,0 +1,66 @@
+import { HumanMessage } from "../../imports";
+import { getLLM } from "../../helpers/llms";
+import { getOpenRouterRuntime } from "../openrouter";
+import { extractImageUrls } from "./helpers";
+/**
+ * Generates images from a text prompt using OpenRouter image-generation models.
+ *
+ * Internally this function calls OpenRouter through the chat-completions-compatible
+ * interface with `modalities` and optional `image_config`. If no `llm` is provided,
+ * it creates one with `getLLM({ provider: "openrouter", type: "image-gen" })` and
+ * reads `process.env.OPENROUTER_API_KEY`.
+ *
+ * Make sure `OPENROUTER_API_KEY` is set in your `.env`.
+ *
+ * @param params.llm Optional LLM instance from `getLLM(...)`.
+ * @param params.prompt Image generation prompt (for example: "create a cat in watercolor style").
+ * @param params.modalities Output modalities for the model call.
+ * @param params.imageConfig Optional image generation settings (for example aspect ratio/size).
+ * @param params.model Optional model override for this call.
+ * @returns Promise containing extracted image URLs/data URLs, optional text, and raw response.
+ *
+ * @example
+ * CONFIG:
+ * ```ts
+ * generateImages({
+ *     llm = getLLM({ provider: "openrouter", type: "image-gen" }),
+ *     modalities = ["image", "text"],
+ *     imageConfig = { aspect_ratio: "1:1", image_size: "2K" },
+ *     model,
+ *     prompt
+ * })
+ * ```
+ *
+ * @example
+ * ```ts
+ * const result = await generateImages({
+ *     prompt: "Generate a cozy cat illustration",
+ *     imageConfig: { aspect_ratio: "1:1", image_size: "2K" }
+ * });
+ *
+ * console.log(result.images[0]);
+ * ```
+ */
+export async function generateImages({ llm = getLLM({ provider: "openrouter", type: "image-gen" }), modalities = ["image", "text"], imageConfig = { aspect_ratio: "1:1", image_size: "2K" }, model, prompt }) {
+    const runtime = getOpenRouterRuntime(llm);
+    const runtimeLLM = model && model !== runtime.model
+        ? getLLM({
+            provider: "openrouter",
+            type: "image-gen",
+            model,
+            apikey: runtime.apiKey
+        })
+        : llm;
+    const response = await runtimeLLM.invoke([new HumanMessage(prompt)], {
+        modalities,
+        image_config: imageConfig
+    });
+    const images = extractImageUrls(response);
+    const text = typeof response.content === "string" ? response.content : undefined;
+    return {
+        images,
+        text,
+        raw: response
+    };
+}
+//# sourceMappingURL=generateImages.js.map

package/dist/modalities/image-gen/generateImages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateImages.js","sourceRoot":"","sources":["../../../src/modalities/image-gen/generateImages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,EAAE,MAAM,EAA2B,MAAM,oBAAoB,CAAA;AACpE,OAAO,EAAe,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACjE,OAAO,EAAE,gBAAgB,EAAmC,MAAM,WAAW,CAAA;AAU7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,EACjC,GAAG,GAAG,MAAM,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAC3D,UAAU,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,EAC9B,WAAW,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,EACvD,KAAK,EACL,MAAM,EACQ;IACd,MAAM,OAAO,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAA;IACzC,MAAM,UAAU,GACZ,KAAK,IAAI,KAAK,KAAK,OAAO,CAAC,KAAK;QAC5B,CAAC,CAAC,MAAM,CAAC;YACH,QAAQ,EAAE,YAAY;YACtB,IAAI,EAAE,WAAW;YACjB,KAAK;YACL,MAAM,EAAE,OAAO,CAAC,MAAM;SACzB,CAAC;QACJ,CAAC,CAAC,GAAG,CAAA;IAEb,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC,EAAE;QACjE,UAAU;QACV,YAAY,EAAE,WAAW;KACrB,CAAC,CAAA;IAET,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAA;IACzC,MAAM,IAAI,GAAG,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;IAEhF,OAAO;QACH,MAAM;QACN,IAAI;QACJ,GAAG,EAAE,QAAQ;KAChB,CAAA;AACL,CAAC"}

package/dist/modalities/image-gen/helpers.d.ts

@@ -0,0 +1,15 @@
+import { AutoComplete } from "../../helpers/llms";
+export type ImageGenModalities = ["image"] | ["image", "text"] | ["text", "image"];
+export type ImageAspectRatio = AutoComplete<"1:1" | "2:3" | "3:2" | "3:4" | "4:3" | "4:5" | "5:4" | "9:16" | "16:9" | "21:9" | "1:4" | "4:1" | "1:8" | "8:1">;
+export type ImageSize = AutoComplete<"0.5K" | "1K" | "2K" | "4K">;
+export type ImageConfig = {
+    aspect_ratio?: ImageAspectRatio;
+    image_size?: ImageSize;
+    font_inputs?: {
+        font_url: string;
+        text: string;
+    }[];
+    super_resolution_references?: string[];
+};
+export declare function extractImageUrls(raw: unknown): string[];
+//# sourceMappingURL=helpers.d.ts.map

package/dist/modalities/image-gen/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/modalities/image-gen/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAElF,MAAM,MAAM,gBAAgB,GAAG,YAAY,CACrC,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,MAAM,GACN,MAAM,GACN,MAAM,GACN,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,CACV,CAAA;AAED,MAAM,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAA;AAEjE,MAAM,MAAM,WAAW,GAAG;IACtB,YAAY,CAAC,EAAE,gBAAgB,CAAA;IAC/B,UAAU,CAAC,EAAE,SAAS,CAAA;IACtB,WAAW,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAClD,2BAA2B,CAAC,EAAE,MAAM,EAAE,CAAA;CACzC,CAAA;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CAkBvD"}

package/dist/modalities/image-gen/helpers.js

@@ -0,0 +1,17 @@
+export function extractImageUrls(raw) {
+    const maybeRaw = raw;
+    const images = maybeRaw?.additional_kwargs?.images ?? maybeRaw?.response_metadata?.images ?? maybeRaw?.images;
+    if (Array.isArray(images)) {
+        return images
+            .map((entry) => entry?.image_url?.url)
+            .filter((url) => typeof url === "string");
+    }
+    const content = maybeRaw?.content;
+    if (Array.isArray(content)) {
+        return content
+            .map((entry) => entry?.image_url?.url)
+            .filter((url) => typeof url === "string");
+    }
+    return [];
+}
+//# sourceMappingURL=helpers.js.map

package/dist/modalities/image-gen/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/modalities/image-gen/helpers.ts"],"names":[],"mappings":"AA8BA,MAAM,UAAU,gBAAgB,CAAC,GAAY;IACzC,MAAM,QAAQ,GAAG,GAAU,CAAA;IAC3B,MAAM,MAAM,GAAG,QAAQ,EAAE,iBAAiB,EAAE,MAAM,IAAI,QAAQ,EAAE,iBAAiB,EAAE,MAAM,IAAI,QAAQ,EAAE,MAAM,CAAA;IAE7G,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,OAAO,MAAM;aACR,GAAG,CAAC,CAAC,KAAU,EAAE,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,CAAC;aAC1C,MAAM,CAAC,CAAC,GAAY,EAAiB,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAA;IACzE,CAAC;IAED,MAAM,OAAO,GAAG,QAAQ,EAAE,OAAO,CAAA;IACjC,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,OAAO,OAAO;aACT,GAAG,CAAC,CAAC,KAAU,EAAE,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,CAAC;aAC1C,MAAM,CAAC,CAAC,GAAY,EAAiB,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAA;IACzE,CAAC;IAED,OAAO,EAAE,CAAA;AACb,CAAC"}

package/dist/modalities/openrouter.d.ts

@@ -0,0 +1,11 @@
+import { getLLM } from "../helpers/llms";
+export type LLMInstance = ReturnType<typeof getLLM>;
+type OpenRouterRuntime = {
+    apiKey: string;
+    baseURL: string;
+    model: string;
+};
+export declare function isOpenRouterLLM(llm: LLMInstance): boolean;
+export declare function getOpenRouterRuntime(llm: LLMInstance): OpenRouterRuntime;
+export {};
+//# sourceMappingURL=openrouter.d.ts.map

package/dist/modalities/openrouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openrouter.d.ts","sourceRoot":"","sources":["../../src/modalities/openrouter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAExC,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,MAAM,CAAC,CAAA;AAEnD,KAAK,iBAAiB,GAAG;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;CAChB,CAAA;AAMD,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAYzD;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,WAAW,GAAG,iBAAiB,CAiCxE"}

package/dist/modalities/openrouter.js

@@ -0,0 +1,39 @@
+function readMaybeString(value) {
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+export function isOpenRouterLLM(llm) {
+    const maybeLLM = llm;
+    const baseURL = readMaybeString(maybeLLM?.clientConfig?.baseURL) ??
+        readMaybeString(maybeLLM?.configuration?.baseURL) ??
+        readMaybeString(maybeLLM?.fields?.configuration?.baseURL);
+    if (!baseURL) {
+        return false;
+    }
+    return baseURL.includes("openrouter.ai/api/v1");
+}
+export function getOpenRouterRuntime(llm) {
+    const maybeLLM = llm;
+    const baseURL = readMaybeString(maybeLLM?.clientConfig?.baseURL) ??
+        readMaybeString(maybeLLM?.configuration?.baseURL) ??
+        readMaybeString(maybeLLM?.fields?.configuration?.baseURL) ??
+        "https://openrouter.ai/api/v1";
+    const apiKey = readMaybeString(maybeLLM?.apiKey) ??
+        readMaybeString(maybeLLM?.clientConfig?.apiKey) ??
+        readMaybeString(maybeLLM?.fields?.apiKey) ??
+        process.env.OPENROUTER_API_KEY;
+    const model = readMaybeString(maybeLLM?.model) ??
+        readMaybeString(maybeLLM?.modelName) ??
+        "openrouter/auto";
+    if (!baseURL.includes("openrouter.ai/api/v1")) {
+        throw new Error("Provided llm is not configured for OpenRouter baseURL");
+    }
+    if (!apiKey) {
+        throw new Error("OpenRouter apiKey is missing on llm instance and env");
+    }
+    return {
+        apiKey,
+        baseURL,
+        model
+    };
+}
+//# sourceMappingURL=openrouter.js.map

package/dist/modalities/openrouter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openrouter.js","sourceRoot":"","sources":["../../src/modalities/openrouter.ts"],"names":[],"mappings":"AAUA,SAAS,eAAe,CAAC,KAAc;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;AAC5E,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAgB;IAC5C,MAAM,QAAQ,GAAG,GAAU,CAAA;IAC3B,MAAM,OAAO,GACT,eAAe,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,CAAC;QAChD,eAAe,CAAC,QAAQ,EAAE,aAAa,EAAE,OAAO,CAAC;QACjD,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,CAAA;IAE7D,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,OAAO,KAAK,CAAA;IAChB,CAAC;IAED,OAAO,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAA;AACnD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,GAAgB;IACjD,MAAM,QAAQ,GAAG,GAAU,CAAA;IAE3B,MAAM,OAAO,GACT,eAAe,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,CAAC;QAChD,eAAe,CAAC,QAAQ,EAAE,aAAa,EAAE,OAAO,CAAC;QACjD,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC;QACzD,8BAA8B,CAAA;IAElC,MAAM,MAAM,GACR,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC;QACjC,eAAe,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,CAAC;QAC/C,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAA;IAElC,MAAM,KAAK,GACP,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC;QAChC,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC;QACpC,iBAAiB,CAAA;IAErB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAA;IAC5E,CAAC;IAED,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAA;IAC3E,CAAC;IAED,OAAO;QACH,MAAM;QACN,OAAO;QACP,KAAK;KACR,CAAA;AACL,CAAC"}

package/dist/modalities/speech/VoiceEngine.d.ts

@@ -0,0 +1,3 @@
+export declare class VoiceEngine {
+}
+//# sourceMappingURL=VoiceEngine.d.ts.map

package/dist/modalities/speech/VoiceEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VoiceEngine.d.ts","sourceRoot":"","sources":["../../../src/modalities/speech/VoiceEngine.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAW;CAEvB"}