@delofarag/ai-utils 1.4.3 → 1.5.0

package/dist/helpers.d.ts

@@ -14,15 +14,15 @@ export type ChatGroqModel = AutoComplete<"groq/compound" | "groq/compound-mini"
 export type OpenRouterModel = AutoComplete<"anthropic/claude-haiku-4.5" | "anthropic/claude-opus-4" | "anthropic/claude-opus-4.1" | "anthropic/claude-opus-4.5" | "anthropic/claude-opus-4.6" | "anthropic/claude-opus-4.6-fast" | "anthropic/claude-opus-4.7" | "anthropic/claude-sonnet-4" | "anthropic/claude-sonnet-4.5" | "anthropic/claude-sonnet-4.6" | "arcee-ai/trinity-large-preview:free" | "arcee-ai/trinity-large-thinking" | "arcee-ai/trinity-mini" | "bytedance-seed/seed-2.0-lite" | "bytedance-seed/seed-2.0-mini" | "deepseek/deepseek-r1" | "deepseek/deepseek-r1-0528" | "deepseek/deepseek-r1-distill-llama-70b" | "deepseek/deepseek-r1-distill-qwen-32b" | "deepseek/deepseek-v3.1-terminus" | "deepseek/deepseek-v3.2" | "deepseek/deepseek-v3.2-exp" | "deepseek/deepseek-v3.2-speciale" | "google/gemini-2.5-flash" | "google/gemini-2.5-flash-image" | "google/gemini-2.5-flash-lite" | "google/gemini-2.5-flash-lite-preview-09-2025" | "google/gemini-2.5-pro" | "google/gemini-2.5-pro-preview" | "google/gemini-2.5-pro-preview-05-06" | "google/gemini-3-flash-preview" | "google/gemini-3-pro-image-preview" | "google/gemini-3.1-flash-image-preview" | "google/gemini-3.1-flash-lite-preview" | "google/gemini-3.1-pro-preview" | "google/gemini-3.1-pro-preview-customtools" | "google/gemma-4-26b-a4b-it" | "google/gemma-4-26b-a4b-it:free" | "google/gemma-4-31b-it" | "google/gemma-4-31b-it:free" | "inception/mercury-2" | "liquid/lfm-2-24b-a2b" | "liquid/lfm-2.5-1.2b-instruct:free" | "liquid/lfm-2.5-1.2b-thinking:free" | "meta-llama/llama-3.3-70b-instruct" | "meta-llama/llama-3.3-70b-instruct:free" | "meta-llama/llama-4-maverick" | "meta-llama/llama-4-scout" | "meta-llama/llama-guard-4-12b" | "minimax/minimax-m2" | "minimax/minimax-m2-her" | "minimax/minimax-m2.1" | "minimax/minimax-m2.5" | "minimax/minimax-m2.5:free" | "minimax/minimax-m2.7" | "mistralai/devstral-2512" | "mistralai/devstral-medium" | "mistralai/devstral-small" | "mistralai/mistral-large-2512" | "mistralai/mistral-small-2603" | "moonshotai/kimi-k2" | "moonshotai/kimi-k2-0905" | "moonshotai/kimi-k2-thinking" | "moonshotai/kimi-k2.5" | "nvidia/nemotron-3-nano-30b-a3b" | "nvidia/nemotron-3-nano-30b-a3b:free" | "nvidia/nemotron-3-super-120b-a12b" | "nvidia/nemotron-3-super-120b-a12b:free" | "openai/gpt-4.1" | "openai/gpt-4.1-mini" | "openai/gpt-4.1-nano" | "openai/gpt-5" | "openai/gpt-5-chat" | "openai/gpt-5-codex" | "openai/gpt-5-image" | "openai/gpt-5-image-mini" | "openai/gpt-5-mini" | "openai/gpt-5-nano" | "openai/gpt-5-pro" | "openai/gpt-5.1" | "openai/gpt-5.1-chat" | "openai/gpt-5.1-codex" | "openai/gpt-5.1-codex-max" | "openai/gpt-5.1-codex-mini" | "openai/gpt-5.2" | "openai/gpt-5.2-chat" | "openai/gpt-5.2-codex" | "openai/gpt-5.2-pro" | "openai/gpt-5.3-chat" | "openai/gpt-5.3-codex" | "openai/gpt-5.4" | "openai/gpt-5.4-mini" | "openai/gpt-5.4-nano" | "openai/gpt-5.4-pro" | "openai/gpt-oss-120b" | "openai/gpt-oss-120b:free" | "openai/gpt-oss-20b" | "openai/gpt-oss-20b:free" | "openai/gpt-oss-safeguard-20b" | "qwen/qwen3-coder" | "qwen/qwen3-coder-30b-a3b-instruct" | "qwen/qwen3-coder-flash" | "qwen/qwen3-coder-next" | "qwen/qwen3-coder-plus" | "qwen/qwen3-coder:free" | "qwen/qwen3-max" | "qwen/qwen3-max-thinking" | "qwen/qwen3.5-122b-a10b" | "qwen/qwen3.5-27b" | "qwen/qwen3.5-35b-a3b" | "qwen/qwen3.5-397b-a17b" | "qwen/qwen3.5-9b" | "qwen/qwen3.5-flash-02-23" | "qwen/qwen3.5-plus-02-15" | "qwen/qwen3.6-plus" | "rekaai/reka-edge" | "xiaomi/mimo-v2-flash" | "xiaomi/mimo-v2-omni" | "xiaomi/mimo-v2-pro" | "z-ai/glm-5" | "z-ai/glm-5-turbo" | "z-ai/glm-5.1" | "z-ai/glm-5v-turbo">;
 export type LocalModel = AutoComplete<"llama3.2:3b">;
 export type LLMConfig = {
-    type: "groq";
+    provider: "chatgroq";
     model?: ChatGroqModel;
     apikey?: string;
 } | {
-    type: "openrouter";
+    provider: "openrouter";
     model?: OpenRouterModel;
     apikey?: string;
 } | {
-    type: "local";
+    provider: "local";
     model?: string;
 };
 /**

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-export * from "./helpers";
-export * from "./memory";
-export * from "./rag";
-export { DynamicStructuredTool } from "./imports";
+export * from "./helpers/helpers";
+export * from "./helpers/memory";
+export * from "./helpers/rag";
+export { DynamicStructuredTool, MemorySaver } from "./imports";
 export * from "./heart/agent";
 export * from "./heart/chain";
 export * from "./heart/memorychain";
@@ -10,16 +10,17 @@ export { tavilySearchTool, TavilySearch } from "./heart/tools/Tavily";
 export * from "./heart/tools/RAGTool";
 export * from "./heart/tools/zodios/CombinedRegistry";
 export * from "./heart/tools/zodios/ZodiosToolRegistry";
-export * from "./magic-funcs/answerers/ask";
-export * from "./magic-funcs/answerers/websearch";
 export * from "./magic-funcs/evaluators/classify";
 export * from "./magic-funcs/evaluators/decide";
-export * from "./magic-funcs/optimizers/promptify";
-export * from "./magic-funcs/optimizers/ragify";
 export * from "./magic-funcs/parsers/extract";
 export * from "./magic-funcs/parsers/rewrite";
 export * from "./magic-funcs/parsers/structure";
 export * from "./magic-funcs/parsers/summarize";
 export * from "./heart/tools/Tavily";
-export * from "./chatbot";
+export * from "./helpers/chatbot";
+export * from "./helpers/llms";
+export * from "./modalities/speech/stt/stt";
+export * from "./modalities/speech/tts/tts";
+export * from "./modalities/vision/vision";
+export * from "./modalities/image-gen/generateImages";
 //# 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,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA;AACxB,cAAc,OAAO,CAAA;AACrB,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAA;AACjD,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,qBAAqB,CAAA;AACnC,cAAc,4BAA4B,CAAA;AAC1C,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACrE,cAAc,uBAAuB,CAAA;AACrC,cAAc,uCAAuC,CAAA;AACrD,cAAc,yCAAyC,CAAA;AACvD,cAAc,6BAA6B,CAAA;AAC3C,cAAc,mCAAmC,CAAA;AACjD,cAAc,mCAAmC,CAAA;AACjD,cAAc,iCAAiC,CAAA;AAC/C,cAAc,oCAAoC,CAAA;AAClD,cAAc,iCAAiC,CAAA;AAC/C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,sBAAsB,CAAA;AACpC,cAAc,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAC9D,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,qBAAqB,CAAA;AACnC,cAAc,4BAA4B,CAAA;AAC1C,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACrE,cAAc,uBAAuB,CAAA;AACrC,cAAc,uCAAuC,CAAA;AACrD,cAAc,yCAAyC,CAAA;AACvD,cAAc,mCAAmC,CAAA;AACjD,cAAc,iCAAiC,CAAA;AAC/C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA;AACjC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,6BAA6B,CAAA;AAC3C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,uCAAuC,CAAA"}

package/dist/index.js

@@ -1,7 +1,7 @@
-export * from "./helpers";
-export * from "./memory";
-export * from "./rag";
-export { DynamicStructuredTool } from "./imports";
+export * from "./helpers/helpers";
+export * from "./helpers/memory";
+export * from "./helpers/rag";
+export { DynamicStructuredTool, MemorySaver } from "./imports";
 export * from "./heart/agent";
 export * from "./heart/chain";
 export * from "./heart/memorychain";
@@ -10,16 +10,17 @@ export { tavilySearchTool, TavilySearch } from "./heart/tools/Tavily";
 export * from "./heart/tools/RAGTool";
 export * from "./heart/tools/zodios/CombinedRegistry";
 export * from "./heart/tools/zodios/ZodiosToolRegistry";
-export * from "./magic-funcs/answerers/ask";
-export * from "./magic-funcs/answerers/websearch";
 export * from "./magic-funcs/evaluators/classify";
 export * from "./magic-funcs/evaluators/decide";
-export * from "./magic-funcs/optimizers/promptify";
-export * from "./magic-funcs/optimizers/ragify";
 export * from "./magic-funcs/parsers/extract";
 export * from "./magic-funcs/parsers/rewrite";
 export * from "./magic-funcs/parsers/structure";
 export * from "./magic-funcs/parsers/summarize";
 export * from "./heart/tools/Tavily";
-export * from "./chatbot";
+export * from "./helpers/chatbot";
+export * from "./helpers/llms";
+export * from "./modalities/speech/stt/stt";
+export * from "./modalities/speech/tts/tts";
+export * from "./modalities/vision/vision";
+export * from "./modalities/image-gen/generateImages";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA;AACxB,cAAc,OAAO,CAAA;AACrB,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAA;AACjD,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,qBAAqB,CAAA;AACnC,cAAc,4BAA4B,CAAA;AAC1C,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACrE,cAAc,uBAAuB,CAAA;AACrC,cAAc,uCAAuC,CAAA;AACrD,cAAc,yCAAyC,CAAA;AACvD,cAAc,6BAA6B,CAAA;AAC3C,cAAc,mCAAmC,CAAA;AACjD,cAAc,mCAAmC,CAAA;AACjD,cAAc,iCAAiC,CAAA;AAC/C,cAAc,oCAAoC,CAAA;AAClD,cAAc,iCAAiC,CAAA;AAC/C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,sBAAsB,CAAA;AACpC,cAAc,WAAW,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAC9D,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,qBAAqB,CAAA;AACnC,cAAc,4BAA4B,CAAA;AAC1C,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACrE,cAAc,uBAAuB,CAAA;AACrC,cAAc,uCAAuC,CAAA;AACrD,cAAc,yCAAyC,CAAA;AACvD,cAAc,mCAAmC,CAAA;AACjD,cAAc,iCAAiC,CAAA;AAC/C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA;AACjC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,6BAA6B,CAAA;AAC3C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,uCAAuC,CAAA"}

package/dist/magic-funcs/answerers/ask.d.ts

@@ -1,6 +1,22 @@
 import { BaseChatModel } from "../../imports";
-export declare function ask(input: string | {
-    llm: BaseChatModel;
+/**
+ * Stellt eine einfache Frage an ein LLM und gibt eine Textantwort zurueck.
+ *
+ * Sinnvoll fuer schnelle Q&A-Use-Cases ohne zusaetzliche Struktur oder Tools.
+ *
+ * @param params.llm Optionales Chat-LLM. Default: `getLLM({ provider: "openrouter" })`.
+ * @param params.question Die Frage, die beantwortet werden soll.
+ * @returns Die Modellantwort als String.
+ *
+ * @example
+ * ```ts
+ * const answer = await ask({
+ *   question: "Was ist der Unterschied zwischen RAM und ROM?"
+ * })
+ * ```
+ */
+export declare function ask({ llm, question }: {
+    llm?: BaseChatModel;
     question: string;
 }): Promise<unknown>;
 //# sourceMappingURL=ask.d.ts.map

package/dist/magic-funcs/answerers/ask.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ask.d.ts","sourceRoot":"","sources":["../../../src/magic-funcs/answerers/ask.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAA0C,MAAM,eAAe,CAAA;AAErF,wBAAsB,GAAG,CAAC,KAAK,EAAC,MAAM,GAAG;IAAC,GAAG,EAAC,aAAa,CAAC;IAAC,QAAQ,EAAC,MAAM,CAAA;CAAC,oBAY1E"}
+{"version":3,"file":"ask.d.ts","sourceRoot":"","sources":["../../../src/magic-funcs/answerers/ask.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAA0C,MAAM,eAAe,CAAA;AAErF;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,GAAG,CAAC,EACtB,GAAwC,EACxC,QAAQ,EACX,EAAE;IACC,GAAG,CAAC,EAAE,aAAa,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;CACnB,oBAOE"}

package/dist/magic-funcs/answerers/ask.js

@@ -1,17 +1,28 @@
-import { createSimpleChain, getLLM } from "../../helpers";
+import { createSimpleChain } from "../../helpers/helpers";
+import { getLLM } from "../../helpers/llms";
 import { ChatPromptTemplate, StringOutputParser } from "../../imports";
-export async function ask(input) {
-    const llm = typeof input === "string" ? getLLM({ type: "groq", apikey: process.env.CHATGROQ_API_KEY ?? "" }) : input.llm;
+/**
+ * Stellt eine einfache Frage an ein LLM und gibt eine Textantwort zurueck.
+ *
+ * Sinnvoll fuer schnelle Q&A-Use-Cases ohne zusaetzliche Struktur oder Tools.
+ *
+ * @param params.llm Optionales Chat-LLM. Default: `getLLM({ provider: "openrouter" })`.
+ * @param params.question Die Frage, die beantwortet werden soll.
+ * @returns Die Modellantwort als String.
+ *
+ * @example
+ * ```ts
+ * const answer = await ask({
+ *   question: "Was ist der Unterschied zwischen RAM und ROM?"
+ * })
+ * ```
+ */
+export async function ask({ llm = getLLM({ provider: "openrouter" }), question }) {
     const prompt = ChatPromptTemplate.fromMessages([
         ["system", `Du bist ein hilfreicher Assistent.`],
         ["human", "{input}"]
     ]);
     const chain = createSimpleChain(prompt, llm, new StringOutputParser());
-    if (typeof input === "string") {
-        return await chain.invoke({ input });
-    }
-    else {
-        return await chain.invoke({ input: input.question });
-    }
+    return await chain.invoke({ input: question });
 }
 //# sourceMappingURL=ask.js.map

package/dist/magic-funcs/answerers/ask.js.map

@@ -1 +1 @@
-{"version":3,"file":"ask.js","sourceRoot":"","sources":["../../../src/magic-funcs/answerers/ask.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AACzD,OAAO,EAAiB,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAErF,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,KAAmD;IACzE,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EAAC,IAAI,EAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE,EAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAA;IACrH,MAAM,MAAM,GAAG,kBAAkB,CAAC,YAAY,CAAC;QAC7C,CAAC,QAAQ,EAAE,oCAAoC,CAAC;QAChD,CAAC,OAAO,EAAE,SAAS,CAAC;KACrB,CAAC,CAAA;IACF,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,kBAAkB,EAAE,CAAC,CAAA;IACtE,IAAG,OAAO,KAAK,KAAK,QAAQ,EAAC,CAAC;QAC5B,OAAO,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;IACtC,CAAC;SAAM,CAAC;QACN,OAAO,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAC,CAAC,CAAA;IACrD,CAAC;AACH,CAAC"}
+{"version":3,"file":"ask.js","sourceRoot":"","sources":["../../../src/magic-funcs/answerers/ask.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAC3C,OAAO,EAAiB,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAErF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,EACtB,GAAG,GAAG,MAAM,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,EACxC,QAAQ,EAIX;IACG,MAAM,MAAM,GAAG,kBAAkB,CAAC,YAAY,CAAC;QAC7C,CAAC,QAAQ,EAAE,oCAAoC,CAAC;QAChD,CAAC,OAAO,EAAE,SAAS,CAAC;KACrB,CAAC,CAAA;IACF,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,kBAAkB,EAAE,CAAC,CAAA;IACtE,OAAO,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAA;AAChD,CAAC"}

package/dist/magic-funcs/answerers/websearch.d.ts

@@ -1,2 +1,17 @@
+/**
+ * Fuehrt eine Websuche via Tavily aus und gibt die zusammengefasste Antwort zurueck.
+ *
+ * Die Query wird vorher in ein Tavily-Topic klassifiziert (`general`, `news`, `finance`),
+ * damit passend gesucht wird.
+ *
+ * @param query Suchanfrage als Freitext.
+ * @returns Tavily-Antworttext (falls vorhanden).
+ * @throws Wenn `TAVILY_API_KEY` nicht gesetzt ist.
+ *
+ * @example
+ * ```ts
+ * const answer = await websearch("Aktuelle Nachrichten zu OpenAI in der EU")
+ * ```
+ */
 export declare function websearch(query: string): Promise<string | undefined>;
 //# sourceMappingURL=websearch.d.ts.map

package/dist/magic-funcs/answerers/websearch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"websearch.d.ts","sourceRoot":"","sources":["../../../src/magic-funcs/answerers/websearch.ts"],"names":[],"mappings":"AAGA,wBAAsB,SAAS,CAAC,KAAK,EAAC,MAAM,+BAczC"}
+{"version":3,"file":"websearch.d.ts","sourceRoot":"","sources":["../../../src/magic-funcs/answerers/websearch.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAC,MAAM,+BAczC"}

package/dist/magic-funcs/answerers/websearch.js

@@ -1,5 +1,20 @@
 import { classify } from "../evaluators/classify";
 import { TavilySearch } from "../../heart/tools/Tavily";
+/**
+ * Fuehrt eine Websuche via Tavily aus und gibt die zusammengefasste Antwort zurueck.
+ *
+ * Die Query wird vorher in ein Tavily-Topic klassifiziert (`general`, `news`, `finance`),
+ * damit passend gesucht wird.
+ *
+ * @param query Suchanfrage als Freitext.
+ * @returns Tavily-Antworttext (falls vorhanden).
+ * @throws Wenn `TAVILY_API_KEY` nicht gesetzt ist.
+ *
+ * @example
+ * ```ts
+ * const answer = await websearch("Aktuelle Nachrichten zu OpenAI in der EU")
+ * ```
+ */
 export async function websearch(query) {
     if (!process.env.TAVILY_API_KEY)
         throw new Error("TAVILY_API_KEY is not set for websearch() call");

package/dist/magic-funcs/answerers/websearch.js.map

@@ -1 +1 @@
-{"version":3,"file":"websearch.js","sourceRoot":"","sources":["../../../src/magic-funcs/answerers/websearch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAEvD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAY;IACxC,IAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc;QAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAA;IACjG,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC;QAC3B,IAAI,EAAC,KAAK;QACV,OAAO,EAAC,CAAC,SAAS,EAAC,MAAM,EAAC,SAAS,CAAU;QAC7C,OAAO,EAAC,yIAAyI;KAClJ,CAAC,CAAA;IACF,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC;QAC9B,UAAU,EAAC,EAAE;QACb,YAAY,EAAC,OAAO,CAAC,GAAG,CAAC,cAAe;QACxC,aAAa,EAAC,IAAI;QAClB,KAAK,EAAC,KAAK,CAAC,KAAK;KAClB,CAAC,CAAA;IACF,OAAO,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAA;AAChD,CAAC"}
+{"version":3,"file":"websearch.js","sourceRoot":"","sources":["../../../src/magic-funcs/answerers/websearch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAEvD;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAY;IACxC,IAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc;QAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAA;IACjG,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC;QAC3B,IAAI,EAAC,KAAK;QACV,OAAO,EAAC,CAAC,SAAS,EAAC,MAAM,EAAC,SAAS,CAAU;QAC7C,OAAO,EAAC,yIAAyI;KAClJ,CAAC,CAAA;IACF,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC;QAC9B,UAAU,EAAC,EAAE;QACb,YAAY,EAAC,OAAO,CAAC,GAAG,CAAC,cAAe;QACxC,aAAa,EAAC,IAAI;QAClB,KAAK,EAAC,KAAK,CAAC,KAAK;KAClB,CAAC,CAAA;IACF,OAAO,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAA;AAChD,CAAC"}

package/dist/magic-funcs/evaluators/classify.d.ts

@@ -13,7 +13,26 @@ declare function createClassificationSchema<T extends readonly [string, ...strin
     confidence: z.ZodNumber;
     reasoning: z.ZodString;
 }> extends infer T_2 ? { [k_1 in keyof T_2]: T_2[k_1]; } : never>;
-export declare function classify<T extends readonly [string, ...string[]]>({ llm, data, classes, context }: {
+/**
+ * Klassifiziert Input in genau eine vordefinierte Klasse und liefert Confidence + Begruendung.
+ *
+ * Sinnvoll fuer Routing, Labeling, Topic-Erkennung oder Vorentscheidungen in Flows.
+ *
+ * @param params.llm Optionales Chat-LLM.
+ * @param params.data Zu klassifizierender Input (String oder Objekt).
+ * @param params.classes Erlaubte Klassen als konstantes Tuple.
+ * @param params.context Optionaler Zusatzkontext fuer die Entscheidung.
+ * @returns Objekt mit `class`, `confidence` (0-100) und `reasoning`.
+ *
+ * @example
+ * ```ts
+ * const result = await classify({
+ *   data: "Der Kunde moechte kuendigen und ist unzufrieden.",
+ *   classes: ["support", "sales", "churn"] as const
+ * })
+ * ```
+ */
+export declare function classify<const T extends readonly [string, ...string[]]>({ llm, data, classes, context }: {
     llm?: BaseChatModel;
     data: any;
     classes: T;

package/dist/magic-funcs/evaluators/classify.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../../../src/magic-funcs/evaluators/classify.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAE7C,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAI1B,iBAAS,0BAA0B,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC;;;;;;;;;;;;kEAUrF;AAED,wBAAsB,QAAQ,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,EAAE,EACvE,GAAuE,EACvE,IAAI,EACJ,OAAO,EACP,OAAO,EACR,EAAE;IACD,GAAG,CAAC,EAAE,aAAa,CAAA;IACnB,IAAI,EAAE,GAAG,CAAC;IACV,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAiDrE"}
+{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../../../src/magic-funcs/evaluators/classify.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAE7C,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAK1B,iBAAS,0BAA0B,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC;;;;;;;;;;;;kEAUrF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,QAAQ,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,EAAE,EAC7E,GAAiH,EACjH,IAAI,EACJ,OAAO,EACP,OAAO,EACR,EAAE;IACD,GAAG,CAAC,EAAE,aAAa,CAAA;IACnB,IAAI,EAAE,GAAG,CAAC;IACV,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAiDrE"}

package/dist/magic-funcs/evaluators/classify.js

@@ -1,8 +1,8 @@
-import { createSimpleChain } from "../../helpers";
+import { createSimpleChain } from "../../helpers/helpers";
 import { ChatPromptTemplate } from "../../imports";
 import { z } from "zod/v3";
-import { getLLM } from "../../helpers";
 import { StructuredOutputParser } from "../../imports";
+import { getLLM } from "../../helpers/llms";
 function createClassificationSchema(classes) {
     return z.object({
         class: z.enum(classes),
@@ -14,7 +14,26 @@ function createClassificationSchema(classes) {
             .describe("Kurze Begründung basierend auf dem Input")
     });
 }
-export async function classify({ llm = getLLM({ type: "groq", apikey: process.env.CHATGROQ_API_KEY ?? "" }), data, classes, context }) {
+/**
+ * Klassifiziert Input in genau eine vordefinierte Klasse und liefert Confidence + Begruendung.
+ *
+ * Sinnvoll fuer Routing, Labeling, Topic-Erkennung oder Vorentscheidungen in Flows.
+ *
+ * @param params.llm Optionales Chat-LLM.
+ * @param params.data Zu klassifizierender Input (String oder Objekt).
+ * @param params.classes Erlaubte Klassen als konstantes Tuple.
+ * @param params.context Optionaler Zusatzkontext fuer die Entscheidung.
+ * @returns Objekt mit `class`, `confidence` (0-100) und `reasoning`.
+ *
+ * @example
+ * ```ts
+ * const result = await classify({
+ *   data: "Der Kunde moechte kuendigen und ist unzufrieden.",
+ *   classes: ["support", "sales", "churn"] as const
+ * })
+ * ```
+ */
+export async function classify({ llm = getLLM({ provider: "openrouter", apikey: process.env.OPENROUTER_API_KEY ?? "", model: "openai/gpt-5.4-mini" }), data, classes, context }) {
     const inputString = typeof data === "string"
         ? data
         : JSON.stringify(data, null, 2);

package/dist/magic-funcs/evaluators/classify.js.map

@@ -1 +1 @@
-{"version":3,"file":"classify.js","sourceRoot":"","sources":["../../../src/magic-funcs/evaluators/classify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAEjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAC1B,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AACtC,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AAEtD,SAAS,0BAA0B,CAA2C,OAAU;IACpF,OAAO,CAAC,CAAC,MAAM,CAAC;QACd,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;QACtB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;aACnB,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,GAAG,CAAC;aACR,QAAQ,CAAC,+BAA+B,CAAC;QAC5C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;aAClB,QAAQ,CAAC,0CAA0C,CAAC;KACxD,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAA2C,EACvE,GAAG,GAAG,MAAM,CAAC,EAAC,IAAI,EAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE,EAAC,CAAC,EACvE,IAAI,EACJ,OAAO,EACP,OAAO,EAMR;IAEC,MAAM,WAAW,GACf,OAAO,IAAI,KAAK,QAAQ;QACtB,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IAEnC,MAAM,MAAM,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAA;IAClD,MAAM,MAAM,GAAG,sBAAsB,CAAC,aAAa,CAAC,MAAM,CAAC,CAAA;IAE3D,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,YAAY,CAAC;QACnD,CAAC,QAAQ,EAAE;;;;;UAKP,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;UAgBrC,OAAO,CAAC,CAAC,CAAC;;UAEV,OAAO;SACR,CAAC,CAAC,CAAC,EAAE;;;;SAIL,CAAC;QACJ,CAAC,OAAO,EAAE,SAAS,CAAC;KACrB,CAAC,CAAC,OAAO,CAAC;QACT,mBAAmB,EAAE,MAAM,CAAC,qBAAqB,EAAE;KACpD,CAAC,CAAA;IAEF,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;IAEzD,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;AAC7B,CAAC"}
+{"version":3,"file":"classify.js","sourceRoot":"","sources":["../../../src/magic-funcs/evaluators/classify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAEzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAE3C,SAAS,0BAA0B,CAA2C,OAAU;IACpF,OAAO,CAAC,CAAC,MAAM,CAAC;QACd,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;QACtB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;aACnB,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,GAAG,CAAC;aACR,QAAQ,CAAC,+BAA+B,CAAC;QAC5C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;aAClB,QAAQ,CAAC,0CAA0C,CAAC;KACxD,CAAC,CAAA;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAiD,EAC7E,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,OAAO,EACP,OAAO,EAMR;IAEC,MAAM,WAAW,GACf,OAAO,IAAI,KAAK,QAAQ;QACtB,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IAEnC,MAAM,MAAM,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAA;IAClD,MAAM,MAAM,GAAG,sBAAsB,CAAC,aAAa,CAAC,MAAM,CAAC,CAAA;IAE3D,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,YAAY,CAAC;QACnD,CAAC,QAAQ,EAAE;;;;;UAKP,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;UAgBrC,OAAO,CAAC,CAAC,CAAC;;UAEV,OAAO;SACR,CAAC,CAAC,CAAC,EAAE;;;;SAIL,CAAC;QACJ,CAAC,OAAO,EAAE,SAAS,CAAC;KACrB,CAAC,CAAC,OAAO,CAAC;QACT,mBAAmB,EAAE,MAAM,CAAC,qBAAqB,EAAE;KACpD,CAAC,CAAA;IAEF,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;IAEzD,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;AAC7B,CAAC"}

package/dist/magic-funcs/evaluators/decide.d.ts

@@ -13,6 +13,24 @@ declare const decideSchema: z.ZodObject<{
     decision: "yes" | "no" | "unclear";
     reason: string;
 }>;
+/**
+ * Trifft eine strukturierte Ja/Nein/Unklar-Entscheidung fuer ein gegebenes Kriterium.
+ *
+ * Sinnvoll fuer Gate-Checks, Policy-Validierung oder automatische Freigabeentscheidungen.
+ *
+ * @param params.llm Optionales Chat-LLM.
+ * @param params.material Material/Datengrundlage fuer die Entscheidung.
+ * @param params.kriteria_to_decide Kriterium, nach dem entschieden werden soll.
+ * @returns Objekt mit `decision`, `reason` und `confidence`.
+ *
+ * @example
+ * ```ts
+ * const result = await decide({
+ *   material: "Der User hat AGB akzeptiert und Email bestaetigt.",
+ *   kriteria_to_decide: "Ist der User onboarding-ready?"
+ * })
+ * ```
+ */
 export declare function decide({ llm, material, kriteria_to_decide }: {
     llm?: BaseChatModel;
     material: any;

package/dist/magic-funcs/evaluators/decide.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decide.d.ts","sourceRoot":"","sources":["../../../src/magic-funcs/evaluators/decide.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAM7C,QAAA,MAAM,YAAY;;;;;;;;;;;;EAad,CAAA;AAEF,wBAAsB,MAAM,CAAC,EAC3B,GAAuE,EACvE,QAAQ,EACR,kBAAkB,EACnB,EAAE;IACD,GAAG,CAAC,EAAE,aAAa,CAAA;IACnB,QAAQ,EAAE,GAAG,CAAA;IACb,kBAAkB,EAAE,MAAM,CAAA;CAC3B,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC,CAoCxC"}
+{"version":3,"file":"decide.d.ts","sourceRoot":"","sources":["../../../src/magic-funcs/evaluators/decide.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAO7C,QAAA,MAAM,YAAY;;;;;;;;;;;;EAad,CAAA;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,MAAM,CAAC,EAC3B,GAAiH,EACjH,QAAQ,EACR,kBAAkB,EACnB,EAAE;IACD,GAAG,CAAC,EAAE,aAAa,CAAA;IACnB,QAAQ,EAAE,GAAG,CAAA;IACb,kBAAkB,EAAE,MAAM,CAAA;CAC3B,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC,CAoCxC"}

package/dist/magic-funcs/evaluators/decide.js

@@ -1,8 +1,8 @@
 import { z } from "zod/v3";
 import { ChatPromptTemplate } from "../../imports";
-import { getLLM } from "../../helpers";
 import { StructuredOutputParser } from "../../imports";
-import { createSimpleChain } from "../../helpers";
+import { createSimpleChain } from "../../helpers/helpers";
+import { getLLM } from "../../helpers/llms";
 const decideSchema = z.object({
     decision: z.enum(["yes", "no", "unclear"])
         .describe("Ergebnis der Entscheidung basierend auf dem Kriterium"),
@@ -15,7 +15,25 @@ const decideSchema = z.object({
         "decision='unclear' → confidence=0. " +
         "decision='yes' oder 'no' → confidence > 0")
 });
-export async function decide({ llm = getLLM({ type: "groq", apikey: process.env.CHATGROQ_API_KEY ?? "" }), material, kriteria_to_decide }) {
+/**
+ * Trifft eine strukturierte Ja/Nein/Unklar-Entscheidung fuer ein gegebenes Kriterium.
+ *
+ * Sinnvoll fuer Gate-Checks, Policy-Validierung oder automatische Freigabeentscheidungen.
+ *
+ * @param params.llm Optionales Chat-LLM.
+ * @param params.material Material/Datengrundlage fuer die Entscheidung.
+ * @param params.kriteria_to_decide Kriterium, nach dem entschieden werden soll.
+ * @returns Objekt mit `decision`, `reason` und `confidence`.
+ *
+ * @example
+ * ```ts
+ * const result = await decide({
+ *   material: "Der User hat AGB akzeptiert und Email bestaetigt.",
+ *   kriteria_to_decide: "Ist der User onboarding-ready?"
+ * })
+ * ```
+ */
+export async function decide({ llm = getLLM({ provider: "openrouter", apikey: process.env.OPENROUTER_API_KEY ?? "", model: "openai/gpt-5.4-mini" }), material, kriteria_to_decide }) {
     const inputString = typeof material === "string"
         ? material
         : JSON.stringify(material, null, 2);

package/dist/magic-funcs/evaluators/decide.js.map

@@ -1 +1 @@
-{"version":3,"file":"decide.js","sourceRoot":"","sources":["../../../src/magic-funcs/evaluators/decide.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AACtC,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAEjD,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;SACvC,QAAQ,CAAC,uDAAuD,CAAC;IACpE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;SACf,QAAQ,CAAC,iFAAiF,CAAC;IAC9F,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;SACnB,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,CACP,uCAAuC;QACvC,qCAAqC;QACrC,2CAA2C,CAC5C;CACJ,CAAC,CAAA;AAEF,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,EAC3B,GAAG,GAAG,MAAM,CAAC,EAAC,IAAI,EAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE,EAAC,CAAC,EACvE,QAAQ,EACR,kBAAkB,EAKnB;IAEC,MAAM,WAAW,GACf,OAAO,QAAQ,KAAK,QAAQ;QAC1B,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IAEvC,MAAM,UAAU,GAAG,sBAAsB,CAAC,aAAa,CAAC,YAAY,CAAC,CAAA;IACrE,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,YAAY,CAAC;QACnD,CAAC,QAAQ,EAAE;;;;;;;;;;;;;;;UAeP,kBAAkB;;;;SAInB,CAAC;QACJ,CAAC,OAAO,EAAE,SAAS,CAAC;KACrB,CAAC,CAAC,OAAO,CAAC;QACT,mBAAmB,EAAE,UAAU,CAAC,qBAAqB,EAAE;KACxD,CAAC,CAAA;IACF,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,UAAU,CAAC,CAAA;IACxD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAA;IACzD,OAAO,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;AACnC,CAAC"}
+{"version":3,"file":"decide.js","sourceRoot":"","sources":["../../../src/magic-funcs/evaluators/decide.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAElD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAE3C,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;SACvC,QAAQ,CAAC,uDAAuD,CAAC;IACpE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;SACf,QAAQ,CAAC,iFAAiF,CAAC;IAC9F,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;SACnB,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,CACP,uCAAuC;QACvC,qCAAqC;QACrC,2CAA2C,CAC5C;CACJ,CAAC,CAAA;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,EAC3B,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,QAAQ,EACR,kBAAkB,EAKnB;IAEC,MAAM,WAAW,GACf,OAAO,QAAQ,KAAK,QAAQ;QAC1B,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IAEvC,MAAM,UAAU,GAAG,sBAAsB,CAAC,aAAa,CAAC,YAAY,CAAC,CAAA;IACrE,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,YAAY,CAAC;QACnD,CAAC,QAAQ,EAAE;;;;;;;;;;;;;;;UAeP,kBAAkB;;;;SAInB,CAAC;QACJ,CAAC,OAAO,EAAE,SAAS,CAAC;KACrB,CAAC,CAAC,OAAO,CAAC;QACT,mBAAmB,EAAE,UAAU,CAAC,qBAAqB,EAAE;KACxD,CAAC,CAAA;IACF,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,UAAU,CAAC,CAAA;IACxD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAA;IACzD,OAAO,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;AACnC,CAAC"}

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

@@ -1,4 +1,22 @@
 import { BaseChatModel } from "../../imports";
+/**
+ * Erzeugt aus einer Nutzeranforderung einen robusten System-Prompt fuer Agents.
+ *
+ * Sinnvoll wenn aus vagen Anforderungen ein klarer, wiederverwendbarer Prompt entstehen soll.
+ *
+ * @param params.llm Optionales Chat-LLM.
+ * @param params.request Urspruengliche Nutzeranfrage.
+ * @param params.agentRole Optionaler Rollen-Kontext fuer den Ziel-Agenten.
+ * @returns Finaler System-Prompt als String.
+ *
+ * @example
+ * ```ts
+ * const systemPrompt = await promptify({
+ *   request: "Baue einen Assistenten fuer technische Kundentickets.",
+ *   agentRole: "Senior Support Engineer"
+ * })
+ * ```
+ */
 export declare function promptify({ llm, request, agentRole, }: {
     llm?: BaseChatModel;
     request: string;

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

@@ -1 +1 @@
-{"version":3,"file":"promptify.d.ts","sourceRoot":"","sources":["../../../src/magic-funcs/optimizers/promptify.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAK7C,wBAAsB,SAAS,CAAC,EAC5B,GAAuE,EACvE,OAAO,EACP,SAAS,GACV,EAAE;IACD,GAAG,CAAC,EAAE,aAAa,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,GAAG,OAAO,CAAC,MAAM,CAAC,CA6ClB"}
+{"version":3,"file":"promptify.d.ts","sourceRoot":"","sources":["../../../src/magic-funcs/optimizers/promptify.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAK7C;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,SAAS,CAAC,EAC5B,GAAkF,EAClF,OAAO,EACP,SAAS,GACV,EAAE;IACD,GAAG,CAAC,EAAE,aAAa,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,GAAG,OAAO,CAAC,MAAM,CAAC,CA6ClB"}

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

@@ -1,8 +1,26 @@
-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 promptify({ llm = getLLM({ type: "groq", apikey: process.env.CHATGROQ_API_KEY ?? "" }), request, agentRole, }) {
+/**
+ * Erzeugt aus einer Nutzeranforderung einen robusten System-Prompt fuer Agents.
+ *
+ * Sinnvoll wenn aus vagen Anforderungen ein klarer, wiederverwendbarer Prompt entstehen soll.
+ *
+ * @param params.llm Optionales Chat-LLM.
+ * @param params.request Urspruengliche Nutzeranfrage.
+ * @param params.agentRole Optionaler Rollen-Kontext fuer den Ziel-Agenten.
+ * @returns Finaler System-Prompt als String.
+ *
+ * @example
+ * ```ts
+ * const systemPrompt = await promptify({
+ *   request: "Baue einen Assistenten fuer technische Kundentickets.",
+ *   agentRole: "Senior Support Engineer"
+ * })
+ * ```
+ */
+export async function promptify({ llm = getLLM({ provider: "chatgroq", apikey: process.env.CHATGROQ_API_KEY ?? "" }), request, agentRole, }) {
     const prompt = ChatPromptTemplate.fromMessages([
         ["system", `
         Du bist ein Prompt-Engineering-Experte für KI-Agenten.

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

@@ -1 +1 @@
-{"version":3,"file":"promptify.js","sourceRoot":"","sources":["../../../src/magic-funcs/optimizers/promptify.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,SAAS,CAAC,EAC5B,GAAG,GAAG,MAAM,CAAC,EAAC,IAAI,EAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE,EAAC,CAAC,EACvE,OAAO,EACP,SAAS,GAMV;IAEC,MAAM,MAAM,GAAG,kBAAkB,CAAC,YAAY,CAAC;QAC7C,CAAC,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;UA0BP,SAAS,CAAC,CAAC,CAAC;;YAEV,SAAS;SACZ,CAAC,CAAC,CAAC,EAAE;;;;;SAKL,CAAC;QACJ,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,OAAO,EAAE,CAAC,CAAA;IAErD,OAAO,MAAgB,CAAA;AACzB,CAAC"}
+{"version":3,"file":"promptify.js","sourceRoot":"","sources":["../../../src/magic-funcs/optimizers/promptify.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;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,EAC5B,GAAG,GAAG,MAAM,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE,EAAE,CAAC,EAClF,OAAO,EACP,SAAS,GAMV;IAEC,MAAM,MAAM,GAAG,kBAAkB,CAAC,YAAY,CAAC;QAC7C,CAAC,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;UA0BP,SAAS,CAAC,CAAC,CAAC;;YAEV,SAAS;SACZ,CAAC,CAAC,CAAC,EAAE;;;;;SAKL,CAAC;QACJ,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,OAAO,EAAE,CAAC,CAAA;IAErD,OAAO,MAAgB,CAAA;AACzB,CAAC"}

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);