@delofarag/ai-utils 1.4.2 → 1.5.0

package/dist/helpers/rag.d.ts

@@ -0,0 +1,42 @@
+import { SupabaseVectorStore, OllamaEmbeddings, RecursiveCharacterTextSplitter, FaissStore, MemoryVectorStore, Document, Embeddings, ChatPromptTemplate, BaseChatModel, VectorStore } from "../imports";
+import { SupabaseClient } from "@delofarag/supabase-utils";
+interface SupabaseStoreConfig {
+    table_name?: string;
+    RPC_function?: string;
+    supabase?: SupabaseClient;
+}
+export declare const baseEmbeddings: OllamaEmbeddings;
+export declare const baseSplitter: RecursiveCharacterTextSplitter;
+export declare function turn_to_docs<T>(docs: T[]): Document<Record<string, any>>[];
+/** nur für demos */
+export declare function createRAMVectoreStore(data: string[], { embeddings }?: {
+    embeddings?: Embeddings;
+}): Promise<MemoryVectorStore>;
+export declare function createSupabaseVectoreStore(data: string[], { supabase, table_name, RPC_function, }?: SupabaseStoreConfig): Promise<SupabaseVectorStore>;
+export declare function getSupabaseVectorStore({ supabase, table_name, RPC_function }?: SupabaseStoreConfig): SupabaseVectorStore;
+export declare function createFaissStore(data: string[], { save_path, embeddings }?: {
+    save_path?: string;
+    embeddings?: Embeddings;
+}): Promise<FaissStore>;
+export declare function loadFaissStore({ path, embeddings }: {
+    path: string;
+    embeddings?: Embeddings;
+}): Promise<FaissStore>;
+export declare function createRAGChain({ vectorStore, llm, prompt, num_of_results_from_vdb }: {
+    vectorStore: VectorStore;
+    llm: BaseChatModel;
+    prompt?: ChatPromptTemplate;
+    num_of_results_from_vdb?: number;
+}): Promise<import("@langchain/core/runnables").Runnable<{
+    input: string;
+    chat_history?: import("@langchain/core/messages").BaseMessage[] | string;
+} & {
+    [key: string]: unknown;
+}, {
+    context: Document[];
+    answer: string;
+} & {
+    [key: string]: unknown;
+}, import("@langchain/core/runnables").RunnableConfig<Record<string, any>>>>;
+export {};
+//# sourceMappingURL=rag.d.ts.map

package/dist/helpers/rag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rag.d.ts","sourceRoot":"","sources":["../../src/helpers/rag.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,mBAAmB,EACnB,gBAAgB,EAChB,8BAA8B,EAC9B,UAAU,EACV,iBAAiB,EACjB,QAAQ,EACR,UAAU,EAGV,kBAAkB,EAClB,aAAa,EACb,WAAW,EAEd,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAG1D,UAAU,mBAAmB;IACzB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,cAAc,CAAA;CAC5B;AAED,eAAO,MAAM,cAAc,kBAEzB,CAAA;AAEF,eAAO,MAAM,YAAY,gCAGvB,CAAA;AAEF,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAC,GAAG,CAAC,CAAC,EAAE,CAKzE;AAED,oBAAoB;AACpB,wBAAsB,qBAAqB,CACvC,IAAI,EAAE,MAAM,EAAE,EACd,EACI,UAA2B,EAC9B,GAAE;IAAE,UAAU,CAAC,EAAE,UAAU,CAAA;CAAO,8BAKtC;AAED,wBAAsB,0BAA0B,CAC5C,IAAI,EAAC,MAAM,EAAE,EACb,EACI,QAAmJ,EACnJ,UAAwB,EACxB,YAAgC,GACnC,GAAC,mBAAwB,gCAY7B;AAGD,wBAAgB,sBAAsB,CAAC,EACnC,QAAmJ,EACnJ,UAAwB,EACxB,YAAgC,EACnC,GAAE,mBAAwB,uBAM1B;AAED,wBAAsB,gBAAgB,CAClC,IAAI,EAAC,MAAM,EAAE,EACb,EACI,SAAuB,EACvB,UAA2B,EAC9B,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,UAAU,CAAA;CAAM,uBAWzD;AAED,wBAAsB,cAAc,CAAC,EAAC,IAAI,EAAE,UAA2B,EAAC,EAAE;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,UAAU,CAAA;CAAC,uBAEhH;AAED,wBAAsB,cAAc,CAAC,EACjC,WAAW,EACX,GAAG,EACH,MAAM,EACN,uBAA2B,EAC9B,EAAE;IACC,WAAW,EAAE,WAAW,CAAC;IACzB,GAAG,EAAE,aAAa,CAAC;IACnB,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,uBAAuB,CAAC,EAAE,MAAM,CAAA;CACnC;;;;;;;;;;6EAiBA"}

package/dist/helpers/rag.js

@@ -0,0 +1,66 @@
+import { SupabaseVectorStore, OllamaEmbeddings, RecursiveCharacterTextSplitter, FaissStore, MemoryVectorStore, Document, createStuffDocumentsChain, createRetrievalChain } from "../imports";
+import { createClient } from "@supabase/supabase-js";
+export const baseEmbeddings = new OllamaEmbeddings({
+    model: "nomic-embed-text"
+});
+export const baseSplitter = new RecursiveCharacterTextSplitter({
+    chunkSize: 500,
+    chunkOverlap: 50
+});
+export function turn_to_docs(docs) {
+    return docs.map(doc => new Document({
+        pageContent: typeof doc === "string" ? doc : JSON.stringify(doc, null, 2),
+        metadata: {}
+    }));
+}
+/** nur für demos */
+export async function createRAMVectoreStore(data, { embeddings = baseEmbeddings } = {}) {
+    const docs = turn_to_docs(data);
+    const splitted_docs = await baseSplitter.splitDocuments(docs);
+    return await MemoryVectorStore.fromDocuments(splitted_docs, embeddings);
+}
+export async function createSupabaseVectoreStore(data, { supabase = createClient(process.env.NEXT_PUBLIC_SUPABASE_URL, process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY || process.env.SUPABASE_SERVICE_ROLE_KEY), table_name = "documents", RPC_function = "match_documents", } = {}) {
+    const docs = turn_to_docs(data);
+    const splitted_docs = await baseSplitter.splitDocuments(docs);
+    return await SupabaseVectorStore.fromDocuments(splitted_docs, baseEmbeddings, {
+        client: supabase,
+        tableName: table_name,
+        queryName: RPC_function
+    });
+}
+// Bestehenden Supabase Store holen (ohne neue Docs)
+export function getSupabaseVectorStore({ supabase = createClient(process.env.NEXT_PUBLIC_SUPABASE_URL, process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY || process.env.SUPABASE_SERVICE_ROLE_KEY), table_name = "documents", RPC_function = "match_documents" } = {}) {
+    return new SupabaseVectorStore(baseEmbeddings, {
+        client: supabase,
+        tableName: table_name,
+        queryName: RPC_function
+    });
+}
+export async function createFaissStore(data, { save_path = "faiss_rag", embeddings = baseEmbeddings } = {}) {
+    const docs = turn_to_docs(data);
+    const splitted_docs = await baseSplitter.splitDocuments(docs);
+    const vectore_store = await FaissStore.fromDocuments(splitted_docs, embeddings);
+    if (save_path) {
+        await vectore_store.save(save_path);
+    }
+    return vectore_store;
+}
+export async function loadFaissStore({ path, embeddings = baseEmbeddings }) {
+    return await FaissStore.load(path, embeddings);
+}
+export async function createRAGChain({ vectorStore, llm, prompt, num_of_results_from_vdb = 4 }) {
+    const model = llm;
+    const retriever = vectorStore.asRetriever({ k: num_of_results_from_vdb });
+    // Document Chain: Kombiniert Docs in den Prompt
+    const documentChain = await createStuffDocumentsChain({
+        llm: model,
+        prompt: prompt
+    });
+    // Retrieval Chain: Verbindet Retriever mit Document Chain
+    const retrievalChain = await createRetrievalChain({
+        retriever: retriever,
+        combineDocsChain: documentChain
+    });
+    return retrievalChain;
+}
+//# sourceMappingURL=rag.js.map

package/dist/helpers/rag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rag.js","sourceRoot":"","sources":["../../src/helpers/rag.ts"],"names":[],"mappings":"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"}

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,26 +1,26 @@
-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/chatbot";
 export * from "./heart/memorychain";
 export * from "./heart/tools/ToolRegistry";
 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 "./session";
+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,iBAAiB,CAAA;AAC/B,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,26 +1,26 @@
-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/chatbot";
 export * from "./heart/memorychain";
 export * from "./heart/tools/ToolRegistry";
 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 "./session";
+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,iBAAiB,CAAA;AAC/B,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"}