@delofarag/ai-utils 1.0.1 → 1.0.3

package/dist/heart/memorychain.js

@@ -0,0 +1,165 @@
+import { HumanMessage, AIMessage } from "../imports";
+import { SmartCheckpointSaver } from "../memory";
+import { Chain, DEFAULT_SCHEMA } from "./chain";
+import { MemorySaver } from "../imports";
+/**
+ * CONSTRUCTOR
+ * @example  constructor({memory, ...rest}: MemoryChainProps<T> = {}){
+        this.memory = memory ?? new SmartCheckpointSaver(new MemorySaver())
+        if ("chain" in rest){
+            this.chain = rest.chain
+        } else {
+            this.chain = new Chain<T>({
+                llm: rest.llm ?? getLLM("groq"),
+                prompt: rest.prompt ?? [["system", "Du bist ein hilfreicher Chatbot der mit dem User ein höffliches und hilfreiches Gespräch führt"]],
+                schema: (rest.schema ?? DEFAULT_SCHEMA) as unknown as T
+            })
+        }
+    }
+ *
+ * @example entweder gibst du direkt eine chain + memory:
+ * @param props.memory
+ * @param props.chain
+ *
+ * @example oder eine chain wird anhand deines llms, schemas oder prompts erstellt + memory:
+ * @param props.memory
+ * @param props.llm
+ * @param props.prompt
+ * @param props.schema
+ */
+export class MemoryChain {
+    memory;
+    chain;
+    constructor({ memory, ...rest }) {
+        // @ts-expect-error - Type incompatibility due to duplicate LangChain versions in monorepo
+        this.memory = memory ?? new SmartCheckpointSaver(new MemorySaver(), { llm: rest.llm });
+        if ("chain" in rest) {
+            this.chain = rest.chain;
+        }
+        else {
+            this.chain = new Chain({
+                llm: rest.llm,
+                prompt: rest.prompt ?? [["system", "Du bist ein hilfreicher Chatbot der mit dem User ein höffliches und hilfreiches Gespräch führt"]],
+                schema: (rest.schema ?? DEFAULT_SCHEMA)
+            });
+        }
+    }
+    async invoke(input) {
+        const config = {
+            configurable: { thread_id: input.thread_id }
+        };
+        const checkpoint = await this.memory.get(config);
+        let historyMessages = [];
+        if (checkpoint && checkpoint.channel_values && checkpoint.channel_values.messages) {
+            historyMessages = checkpoint.channel_values.messages;
+        }
+        const historyText = this.messagesToHistoryText(historyMessages);
+        const { thread_id, ...restInput } = input;
+        const invokeInput = {};
+        for (const key in restInput) {
+            if (key === "debug")
+                continue;
+            invokeInput[key] = restInput[key];
+        }
+        // Unterstütze sowohl 'input' als auch 'message' als Key
+        if (invokeInput.input && !invokeInput.message) {
+            invokeInput.message = invokeInput.input;
+            delete invokeInput.input;
+        }
+        if (historyText && invokeInput.message) {
+            invokeInput.message = `${historyText}\n\nUser: ${invokeInput.message}`;
+        }
+        const response = await this.chain.invoke(invokeInput);
+        const responseText = typeof response === 'object' && 'output' in response
+            ? response.output
+            : typeof response === 'string'
+                ? response
+                : JSON.stringify(response);
+        const userInputText = invokeInput.message || input.input || JSON.stringify(restInput);
+        await this.saveResponse(thread_id, userInputText, responseText, historyMessages);
+        return response;
+    }
+    async *stream({ input, thread_id }) {
+        const config = {
+            configurable: { thread_id }
+        };
+        const checkpoint = await this.memory.get(config);
+        let historyMessages = [];
+        if (checkpoint && checkpoint.channel_values && checkpoint.channel_values.messages) {
+            historyMessages = checkpoint.channel_values.messages;
+        }
+        const userMessage = new HumanMessage(input);
+        const allMessages = [...historyMessages, userMessage];
+        const historyText = this.messagesToHistoryText(allMessages);
+        const chunks = [];
+        try {
+            for await (const chunk of this.chain.stream({
+                message: `${historyText}\n\nUser: ${input}`
+            })) {
+                chunks.push(chunk);
+                yield chunk;
+            }
+        }
+        finally {
+            // Memory-Speicherung wird IMMER ausgeführt, auch wenn der Stream fehlschlägt
+            const responseText = chunks.join('');
+            await this.saveResponse(thread_id, input, responseText, historyMessages);
+        }
+        return chunks.join('');
+    }
+    async addContext(data) {
+        this.chain.addContext(data);
+    }
+    async setContext(vectorStore) {
+        this.chain.setContext(vectorStore);
+    }
+    async clearContext() {
+        this.chain.clearContext();
+    }
+    messagesToHistoryText(messages) {
+        return messages.map(msg => {
+            if (msg instanceof HumanMessage) {
+                return `User: ${typeof msg.content === 'string' ? msg.content : JSON.stringify(msg.content)}`;
+            }
+            else if (msg instanceof AIMessage) {
+                return `Assistant: ${typeof msg.content === 'string' ? msg.content : JSON.stringify(msg.content)}`;
+            }
+            else {
+                return `System: ${typeof msg.content === 'string' ? msg.content : JSON.stringify(msg.content)}`;
+            }
+        }).join('\n\n');
+    }
+    async saveResponse(thread_id, userInputText, responseText, historyMessages) {
+        if (!responseText || responseText.length === 0)
+            return;
+        const config = {
+            configurable: { thread_id }
+        };
+        const checkpoint = await this.memory.get(config);
+        const userMessage = new HumanMessage(userInputText);
+        const aiMessage = new AIMessage(responseText);
+        const newMessages = [...historyMessages, userMessage, aiMessage];
+        const newCheckpoint = {
+            ...checkpoint,
+            channel_values: {
+                ...(checkpoint?.channel_values || {}),
+                messages: newMessages
+            },
+            channel_versions: {
+                ...(checkpoint?.channel_versions || {}),
+                messages: newMessages.length
+            },
+            versions_seen: checkpoint?.versions_seen || {},
+            v: (checkpoint?.v || 0) + 1,
+            id: checkpoint?.id || `${thread_id}-${Date.now()}`,
+            ts: checkpoint?.ts || new Date().toISOString()
+        };
+        const metadata = {
+            source: "input",
+            step: (checkpoint?.v || 0) + 1,
+            parents: {}
+        };
+        await this.memory.put(config, newCheckpoint, metadata, { messages: newMessages.length });
+    }
+}
+//# sourceMappingURL=memorychain.js.map

package/dist/heart/memorychain.js.map

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

package/dist/heart/tools/BasicToolRegistry.d.ts

@@ -0,0 +1,22 @@
+import { DynamicStructuredTool } from "@langchain/core/tools";
+import type { ExtractToolNames } from "./CombinedRegistry";
+import { z } from "zod/v3";
+export interface Tool {
+    name: string;
+    description: string;
+    schema: z.AnyZodObject;
+    func: (...args: any[]) => any;
+}
+/**
+ * vergiss nicht 'as const' am ende des input-arrays zu verwenden für perekten autocomplete!!!
+ */
+export declare class ToolRegistry<T extends Tool[]> {
+    private tools;
+    constructor(tools: T);
+    getTool(name: ExtractToolNames<T>): DynamicStructuredTool | undefined;
+    getTools(...names: ExtractToolNames<T>[]): (DynamicStructuredTool<import("@langchain/core/tools").ToolSchemaBase, any, any, any> | undefined)[];
+    private turnToTool;
+    private checkDuplicatedTools;
+    get allTools(): DynamicStructuredTool[];
+}
+//# sourceMappingURL=BasicToolRegistry.d.ts.map

package/dist/heart/tools/BasicToolRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BasicToolRegistry.d.ts","sourceRoot":"","sources":["../../../src/heart/tools/BasicToolRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,MAAM,WAAW,IAAI;IACjB,IAAI,EAAC,MAAM,CAAA;IACX,WAAW,EAAC,MAAM,CAAA;IAClB,MAAM,EAAC,CAAC,CAAC,YAAY,CAAA;IACrB,IAAI,EAAC,CAAC,GAAG,IAAI,EAAC,GAAG,EAAE,KAAK,GAAG,CAAA;CAC9B;AAED;;GAEG;AACH,qBAAa,YAAY,CAAC,CAAC,SAAS,IAAI,EAAE;IACtC,OAAO,CAAC,KAAK,CAAwB;gBACzB,KAAK,EAAC,CAAC;IAOZ,OAAO,CAAC,IAAI,EAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,qBAAqB,GAAG,SAAS;IAYpE,QAAQ,CAAC,GAAG,KAAK,EAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE;IAI9C,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,oBAAoB;IAO5B,IAAW,QAAQ,IAAG,qBAAqB,EAAE,CAE5C;CACJ"}

package/dist/heart/tools/BasicToolRegistry.js

@@ -0,0 +1,45 @@
+import { DynamicStructuredTool } from "@langchain/core/tools";
+/**
+ * vergiss nicht 'as const' am ende des input-arrays zu verwenden für perekten autocomplete!!!
+ */
+export class ToolRegistry {
+    tools;
+    constructor(tools) {
+        this.tools = tools.map(tool => tool instanceof DynamicStructuredTool ? tool : this.turnToTool(tool));
+        if (this.checkDuplicatedTools()) {
+            throw new Error(`Error! mehrere tools wurden unter den gleichen Namen registriert!`);
+        }
+    }
+    getTool(name) {
+        const tools = this.tools.filter(tool => tool.name.toLowerCase() === name.toLowerCase());
+        if (tools.length > 1) {
+            throw new Error(`Error! mehrere tools wurden unter den gleichen Namen ${name} registriert!`);
+        }
+        if (tools.length !== 1) {
+            console.error(`unter ${name} wurde kein Tool gefunden`);
+            return;
+        }
+        return tools[0];
+    }
+    getTools(...names) {
+        return names.map(name => this.getTool(name));
+    }
+    turnToTool(tool) {
+        return new DynamicStructuredTool({
+            name: tool.name,
+            description: tool.description,
+            schema: tool.schema,
+            func: tool.func
+        });
+    }
+    checkDuplicatedTools() {
+        const dublikaes = this.tools.filter((tool, index) => {
+            return this.tools.indexOf(tool) !== index;
+        });
+        return dublikaes.length > 0 ? true : false;
+    }
+    get allTools() {
+        return this.tools;
+    }
+}
+//# sourceMappingURL=BasicToolRegistry.js.map

package/dist/heart/tools/BasicToolRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BasicToolRegistry.js","sourceRoot":"","sources":["../../../src/heart/tools/BasicToolRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAW7D;;GAEG;AACH,MAAM,OAAO,YAAY;IACb,KAAK,CAAwB;IACrC,YAAY,KAAO;QACf,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,YAAY,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAA;QACpG,IAAI,IAAI,CAAC,oBAAoB,EAAE,EAAC,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAA;QACxF,CAAC;IACL,CAAC;IAEM,OAAO,CAAC,IAAwB;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,CAAA;QACvF,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,wDAAwD,IAAI,eAAe,CAAC,CAAA;QAChG,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAC,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,SAAS,IAAI,2BAA2B,CAAC,CAAA;YACvD,OAAM;QACV,CAAC;QACD,OAAO,KAAK,CAAC,CAAC,CAAC,CAAA;IACnB,CAAC;IAEM,QAAQ,CAAC,GAAG,KAA2B;QAC1C,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;IAChD,CAAC;IAEO,UAAU,CAAC,IAAS;QACxB,OAAO,IAAI,qBAAqB,CAAC;YAC7B,IAAI,EAAC,IAAI,CAAC,IAAI;YACd,WAAW,EAAC,IAAI,CAAC,WAAW;YAC5B,MAAM,EAAC,IAAI,CAAC,MAAM;YAClB,IAAI,EAAC,IAAI,CAAC,IAAI;SACjB,CAAC,CAAA;IAEN,CAAC;IAEO,oBAAoB;QACxB,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAC,KAAK,EAAC,EAAE;YAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,KAAK,CAAA;QAC7C,CAAC,CAAC,CAAA;QACF,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAA;IAC9C,CAAC;IAED,IAAW,QAAQ;QACf,OAAO,IAAI,CAAC,KAAK,CAAA;IACrB,CAAC;CACJ"}

package/dist/heart/tools/CombinedRegistry.d.ts

@@ -0,0 +1,41 @@
+import { type Tool } from "./BasicToolRegistry";
+import type { DynamicStructuredTool } from "@langchain/core/tools";
+import { Zodios, type ApiOf } from "zodios";
+export type ExtractToolNames<T extends readonly {
+    name: string;
+}[]> = {
+    [K in keyof T]: T[K] extends {
+        name: string;
+    } ? T[K]['name'] : never;
+}[number];
+type ExtractToolNamesFromZodiosApi<Api extends readonly any[]> = {
+    [K in keyof Api]: Api[K] extends {
+        name: infer N;
+    } ? N extends string ? N : Api[K] extends {
+        method: infer M;
+        path: infer P;
+    } ? `call api ${M & string} ${P & string}` : never : Api[K] extends {
+        method: infer M;
+        path: infer P;
+    } ? `call api ${M & string} ${P & string}` : never;
+}[number];
+type ExtractToolNamesFromInput<T extends readonly (Tool | Zodios<any>)[]> = {
+    [K in keyof T]: T[K] extends Tool ? T[K]['name'] : T[K] extends Zodios<infer Api> ? ExtractToolNamesFromZodiosApi<ApiOf<T[K]>> : never;
+}[number];
+/**
+ * needs testing!!!
+ */
+/**
+ * vergiss nicht 'as const' am ende des input-arrays zu verwenden für perekten autocomplete!!!
+ */
+export declare class CombinedToolRegistry<T extends readonly (Tool | Zodios<any>)[]> {
+    private BaseToolRegistry;
+    private ZodiosToolRegistry;
+    private tools;
+    constructor(input: T);
+    getTool(name: ExtractToolNamesFromInput<T>): DynamicStructuredTool | undefined;
+    getTools(...names: ExtractToolNamesFromInput<T>[]): DynamicStructuredTool[];
+    get allTools(): DynamicStructuredTool[];
+}
+export {};
+//# sourceMappingURL=CombinedRegistry.d.ts.map

package/dist/heart/tools/CombinedRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CombinedRegistry.d.ts","sourceRoot":"","sources":["../../../src/heart/tools/CombinedRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAG7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAClE,OAAO,EAAE,MAAM,EAAE,KAAK,KAAK,EAAE,MAAM,QAAQ,CAAA;AAG3C,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,SAAS;IAAC,IAAI,EAAC,MAAM,CAAA;CAAC,EAAE,IAAI;KAC9D,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;QAAC,IAAI,EAAC,MAAM,CAAA;KAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,KAAK;CACpE,CAAC,MAAM,CAAC,CAAA;AAET,KAAK,6BAA6B,CAAC,GAAG,SAAS,SAAS,GAAG,EAAE,IAAI;KAC5D,CAAC,IAAI,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,SAAS;QAAC,IAAI,EAAE,MAAM,CAAC,CAAA;KAAC,GAC1C,CAAC,SAAS,MAAM,GACZ,CAAC,GACD,GAAG,CAAC,CAAC,CAAC,SAAS;QAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,CAAA;KAAC,GAC/C,YAAY,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,MAAM,EAAE,GACtC,KAAK,GACT,GAAG,CAAC,CAAC,CAAC,SAAS;QAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,CAAA;KAAC,GAC/C,YAAY,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,MAAM,EAAE,GACtC,KAAK;CACd,CAAC,MAAM,CAAC,CAAA;AAET,KAAK,yBAAyB,CAAC,CAAC,SAAS,SAAS,CAAC,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI;KACvE,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,GAC3B,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GACZ,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,GAAG,CAAC,GAC9B,6BAA6B,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAC1C,KAAK;CACd,CAAC,MAAM,CAAC,CAAA;AAET;;GAEG;AACH;;GAEG;AACH,qBAAa,oBAAoB,CAAC,CAAC,SAAS,SAAS,CAAC,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE;IACvE,OAAO,CAAC,gBAAgB,CAAiC;IACzD,OAAO,CAAC,kBAAkB,CAA4C;IACtE,OAAO,CAAC,KAAK,CAAwB;gBAEzB,KAAK,EAAE,CAAC;IAyBpB,OAAO,CAAC,IAAI,EAAE,yBAAyB,CAAC,CAAC,CAAC,GAAG,qBAAqB,GAAG,SAAS;IAI9E,QAAQ,CAAC,GAAG,KAAK,EAAE,yBAAyB,CAAC,CAAC,CAAC,EAAE,GAAG,qBAAqB,EAAE;IAI3E,IAAI,QAAQ,IAAI,qBAAqB,EAAE,CAEtC;CACJ"}

package/dist/heart/tools/CombinedRegistry.js

@@ -0,0 +1,46 @@
+import { ToolRegistry } from "./BasicToolRegistry";
+import { ZodiosToolRegistry } from "./ZodiosToolRegistry";
+import { Zodios } from "zodios";
+/**
+ * needs testing!!!
+ */
+/**
+ * vergiss nicht 'as const' am ende des input-arrays zu verwenden für perekten autocomplete!!!
+ */
+export class CombinedToolRegistry {
+    BaseToolRegistry;
+    ZodiosToolRegistry;
+    tools;
+    constructor(input) {
+        //getting and checking the tools
+        const baseTools = input.filter((tool) => {
+            return typeof tool === "object" && tool !== null && "name" in tool && "description" in tool && "schema" in tool && "func" in tool;
+        });
+        if (baseTools.length > 0) {
+            this.BaseToolRegistry = new ToolRegistry(baseTools);
+        }
+        //getting and checking the zodios clients
+        const zodiosClients = input.filter((item) => {
+            return item instanceof Zodios;
+        });
+        if (zodiosClients.length > 1) {
+            throw new Error("Only one Zodios client can be registered");
+        }
+        const zodiosClient = zodiosClients[0];
+        if (zodiosClient) {
+            this.ZodiosToolRegistry = new ZodiosToolRegistry(zodiosClient);
+        }
+        //combining the tools
+        this.tools = [...(this.BaseToolRegistry?.allTools || []), ...(this.ZodiosToolRegistry?.allTools || [])];
+    }
+    getTool(name) {
+        return this.tools.find((tool) => tool.name === name);
+    }
+    getTools(...names) {
+        return names.map((name) => this.getTool(name)).filter((tool) => tool !== undefined);
+    }
+    get allTools() {
+        return this.tools;
+    }
+}
+//# sourceMappingURL=CombinedRegistry.js.map

package/dist/heart/tools/CombinedRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CombinedRegistry.js","sourceRoot":"","sources":["../../../src/heart/tools/CombinedRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAa,MAAM,qBAAqB,CAAA;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAGzD,OAAO,EAAE,MAAM,EAAc,MAAM,QAAQ,CAAA;AA2B3C;;GAEG;AACH;;GAEG;AACH,MAAM,OAAO,oBAAoB;IACrB,gBAAgB,CAAiC;IACjD,kBAAkB,CAA4C;IAC9D,KAAK,CAAwB;IAErC,YAAY,KAAQ;QAChB,gCAAgC;QAChC,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAC,EAAE;YACnC,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,aAAa,IAAI,IAAI,IAAI,QAAQ,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,CAAA;QACrI,CAAC,CAAC,CAAA;QACF,IAAG,SAAS,CAAC,MAAM,GAAG,CAAC,EAAC,CAAC;YACrB,IAAI,CAAC,gBAAgB,GAAG,IAAI,YAAY,CAAC,SAAS,CAAC,CAAA;QACvD,CAAC;QAED,yCAAyC;QACzC,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;YACxC,OAAO,IAAI,YAAY,MAAM,CAAA;QACjC,CAAC,CAAC,CAAA;QACF,IAAG,aAAa,CAAC,MAAM,GAAG,CAAC,EAAC,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAA;QAC/D,CAAC;QACD,MAAM,YAAY,GAAG,aAAa,CAAC,CAAC,CAAC,CAAA;QACrC,IAAI,YAAY,EAAE,CAAC;YACf,IAAI,CAAC,kBAAkB,GAAG,IAAI,kBAAkB,CAAC,YAAY,CAAC,CAAA;QAClE,CAAC;QAED,qBAAqB;QACrB,IAAI,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,QAAQ,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAA;IAC3G,CAAC;IAED,OAAO,CAAC,IAAkC;QACtC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAA;IACxD,CAAC;IAED,QAAQ,CAAC,GAAG,KAAqC;QAC7C,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAiC,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAA;IACtH,CAAC;IAED,IAAI,QAAQ;QACR,OAAO,IAAI,CAAC,KAAK,CAAA;IACrB,CAAC;CACJ"}

package/dist/heart/tools/ZodiosToolRegistry.d.ts

@@ -0,0 +1,22 @@
+import type { Zodios, ZodiosEndpointDescription, ApiOf } from "zodios";
+import { DynamicStructuredTool } from "../../imports";
+import { Prettify } from "../../helpers";
+import type { ExtractToolNames } from "./CombinedRegistry";
+export type ZodiosEndpointWithAlias<R> = Prettify<ZodiosEndpointDescription<R> & {
+    name?: string;
+}>;
+/**
+ * needs testing!!!
+ */
+export declare class ZodiosToolRegistry<Z extends Zodios<any>> {
+    private apiSchema;
+    private tools;
+    private zodiosClient;
+    constructor(zodiosClient: Z);
+    getTool(name: ExtractToolNames<ApiOf<Z>>): DynamicStructuredTool | undefined;
+    getTools(...names: ExtractToolNames<ApiOf<Z>>[]): (DynamicStructuredTool | undefined)[];
+    get allTools(): DynamicStructuredTool[];
+    private turnApiIntoTools;
+    private buildToolSchema;
+}
+//# sourceMappingURL=ZodiosToolRegistry.d.ts.map

package/dist/heart/tools/ZodiosToolRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZodiosToolRegistry.d.ts","sourceRoot":"","sources":["../../../src/heart/tools/ZodiosToolRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,yBAAyB,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAErD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAE1D,MAAM,MAAM,uBAAuB,CAAC,CAAC,IAAI,QAAQ,CAAC,yBAAyB,CAAC,CAAC,CAAC,GAAG;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAA;CAChB,CAAC,CAAA;AAEF;;GAEG;AACH,qBAAa,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,CAAC;IACjD,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,YAAY,CAAG;gBACX,YAAY,EAAE,CAAC;IAMpB,OAAO,CAAC,IAAI,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,qBAAqB,GAAG,SAAS;IAa5E,QAAQ,CAAC,GAAG,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,qBAAqB,GAAG,SAAS,CAAC,EAAE;IAI9F,IAAI,QAAQ,IAAI,qBAAqB,EAAE,CAEtC;IAED,OAAO,CAAC,gBAAgB;IAoBxB,OAAO,CAAC,eAAe;CAkC1B"}

package/dist/heart/tools/ZodiosToolRegistry.js

@@ -0,0 +1,80 @@
+import { DynamicStructuredTool } from "../../imports";
+import { z } from 'zod/v3';
+/**
+ * needs testing!!!
+ */
+export class ZodiosToolRegistry {
+    apiSchema;
+    tools;
+    zodiosClient;
+    constructor(zodiosClient) {
+        this.zodiosClient = zodiosClient;
+        this.apiSchema = zodiosClient.api;
+        this.tools = this.turnApiIntoTools();
+    }
+    getTool(name) {
+        const tools = this.tools.filter((tool) => tool.name?.toLowerCase() === name.toLowerCase());
+        if (tools.length > 1) {
+            throw new Error(`Error! es wurden unter dem gleichen namen ${name} mehrere tools registriert!`);
+        }
+        const tool = tools[0];
+        if (!tool) {
+            console.error(`Tool ${name} not found`);
+            return undefined;
+        }
+        return tool;
+    }
+    getTools(...names) {
+        return names.map(name => this.getTool(name));
+    }
+    get allTools() {
+        return this.tools;
+    }
+    turnApiIntoTools() {
+        return this.apiSchema.map((endpoint) => {
+            return new DynamicStructuredTool({
+                name: endpoint.name || `call api ${endpoint.method} ${endpoint.path}`,
+                description: endpoint.description || `calls the api ${endpoint.method} ${endpoint.path}`,
+                schema: this.buildToolSchema(endpoint),
+                func: async (input) => {
+                    return this.zodiosClient.request({
+                        method: endpoint.method,
+                        url: endpoint.path,
+                        params: input?.params,
+                        queries: input?.queries,
+                        headers: input?.headers,
+                        data: input?.body,
+                    });
+                },
+            });
+        });
+    }
+    buildToolSchema(endpoint) {
+        const queries = {};
+        const headers = {};
+        let body;
+        for (const param of endpoint.parameters ?? []) {
+            if (param.type === "Query") {
+                queries[param.name] = param.schema;
+            }
+            if (param.type === "Header") {
+                headers[param.name] = param.schema;
+            }
+            if (param.type === "Body") {
+                body = param.schema;
+            }
+        }
+        const schemaShape = {};
+        if (Object.keys(queries).length > 0) {
+            schemaShape.queries = z.object(queries).optional();
+        }
+        if (Object.keys(headers).length > 0) {
+            schemaShape.headers = z.object(headers).optional();
+        }
+        if (body) {
+            schemaShape.body = body.optional();
+        }
+        return z.object(schemaShape);
+    }
+}
+//# sourceMappingURL=ZodiosToolRegistry.js.map

package/dist/heart/tools/ZodiosToolRegistry.js.map

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

package/dist/helpers.d.ts

@@ -0,0 +1,31 @@
+import { BaseChatModel, BaseOutputParser, ChatPromptTemplate } from "./imports";
+import { z } from "zod/v3";
+export type LLMKind = "groq" | "localOllama" | "vision";
+export type Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+export declare function logChunk(chunk: string): void;
+export declare function createChain(prompt: ChatPromptTemplate, llm: BaseChatModel, parser?: BaseOutputParser | null): import("@langchain/core/dist/runnables/base").Runnable<any, unknown, import("@langchain/core/dist/runnables/types").RunnableConfig<Record<string, any>>>;
+export declare function wait(ms: number): Promise<unknown>;
+export declare function stream(text: string | Array<any>, wait_in_between?: number): AsyncGenerator<string, void, unknown>;
+export type LLMConfig = {
+    chatgroqApiKey?: string;
+    openrouterApiKey?: string;
+};
+export declare function getLLM(kind?: LLMKind, config?: LLMConfig): any;
+export declare function structure<T extends z.ZodObject<any, any>>({ data, into, llm, retries }: {
+    data: any;
+    into: T;
+    llm: BaseChatModel;
+    retries?: number;
+}): Promise<z.infer<T>>;
+/**
+ * fasst eine Chat-Konversation zwischen User und Assistant zusammen
+ */
+export declare function summarize({ conversation, fokuss, llm, maxWords }: {
+    conversation: string;
+    fokuss?: string;
+    llm: BaseChatModel;
+    maxWords?: number;
+}): Promise<string>;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAoC,kBAAkB,EAA8C,MAAM,WAAW,CAAC;AAC9J,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,aAAa,GAAG,QAAQ,CAAA;AAEvD,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;KACvB,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CACrB,GAAG,EAAE,CAAC;AAEP,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,QAQrC;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,kBAAkB,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,GAAE,gBAAgB,GAAG,IAAW,4JAEjH;AAED,wBAAsB,IAAI,CAAC,EAAE,EAAC,MAAM,oBAEnC;AAED,wBAAuB,MAAM,CAAC,IAAI,EAAC,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,EAAC,eAAe,GAAC,MAAY,yCAKlF;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B,CAAA;AAED,wBAAgB,MAAM,CAAC,IAAI,GAAE,OAAgB,EAAE,MAAM,CAAC,EAAE,SAAS,OA+BhE;AAED,wBAAsB,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAC7D,IAAI,EACJ,IAAI,EACJ,GAAG,EACH,OAAW,EACd,EAAC;IACE,IAAI,EAAE,GAAG,CAAC;IACV,IAAI,EAAE,CAAC,CAAC;IACR,GAAG,EAAE,aAAa,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;CACnB,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CA4BtB;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,EAC5B,YAAY,EACZ,MAAM,EACN,GAAG,EACH,QAAc,EACjB,EAAE;IACC,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,aAAa,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoBlB"}

package/dist/helpers.js

@@ -0,0 +1,105 @@
+import { ChatGroq, ChatOllama, ChatOpenAI, ChatPromptTemplate, StringOutputParser, StructuredOutputParser } from "./imports";
+export function logChunk(chunk) {
+    const flushed = process.stdout.write(chunk);
+    if (!flushed) {
+        process.stdout.once('drain', () => { });
+    }
+    else {
+        // Explizit flushen, damit Output sofort sichtbar ist
+        process.stdout.write('', () => { });
+    }
+}
+export function createChain(prompt, llm, parser = null) {
+    return parser ? prompt.pipe(llm).pipe(parser) : prompt.pipe(llm);
+}
+export async function wait(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+export async function* stream(text, wait_in_between = 100) {
+    for (const chunk of text) {
+        yield chunk + " ";
+        await wait(wait_in_between);
+    }
+}
+export function getLLM(kind = "groq", config) {
+    switch (kind) {
+        case "groq":
+            if (!config?.chatgroqApiKey) {
+                throw new Error("chatgroqApiKey is required in config for groq LLM");
+            }
+            return new ChatGroq({
+                apiKey: config.chatgroqApiKey,
+                model: "llama-3.3-70b-versatile"
+            });
+        case "vision":
+            if (!config?.openrouterApiKey) {
+                throw new Error("openrouterApiKey is required in config for vision LLM");
+            }
+            return new ChatOpenAI({
+                apiKey: config.openrouterApiKey,
+                configuration: {
+                    baseURL: "https://openrouter.ai/api/v1",
+                },
+                model: "openai/gpt-4o-mini"
+            });
+        case "localOllama":
+            return new ChatOllama({
+                model: "llama3.2:3b"
+            });
+        default:
+            throw new Error("Unknown LLM kind");
+    }
+}
+export async function structure({ data, into, llm, retries = 2 }) {
+    const inputString = typeof data === "string" ? data : JSON.stringify(data, null, 2);
+    const jsonParser = StructuredOutputParser.fromZodSchema(into);
+    const prompt = await ChatPromptTemplate.fromMessages([
+        ["system", `Du bist ein JSON-Formatierer. 
+            REGELN:
+            - Gib NUR valides JSON zurück, KEIN anderer Text
+            - Keine Markdown Code-Blöcke (\`\`\`json)
+            - Halte dich EXAKT an das Schema
+
+            Schema:
+            {format_instructions}`],
+        ["human", "{input}"]
+    ]).partial({ format_instructions: jsonParser.getFormatInstructions() });
+    const chain = createChain(prompt, llm, jsonParser);
+    let lastError = null;
+    for (let i = 0; i <= retries; i++) {
+        try {
+            const result = await chain.invoke({ input: inputString });
+            return into.parse(result);
+        }
+        catch (error) {
+            lastError = error;
+            if (i < retries) {
+                console.warn(`structure() Versuch ${i + 1} fehlgeschlagen, retry...`);
+            }
+        }
+    }
+    throw new Error(`structure() failed after ${retries + 1} attempts, Error: ${lastError?.message}`);
+}
+/**
+ * fasst eine Chat-Konversation zwischen User und Assistant zusammen
+ */
+export async function summarize({ conversation, fokuss, llm, maxWords = 150 }) {
+    const focusMessage = fokuss
+        ? [["system", `Fokussiere dich besonders auf die folgenden Themen:\n${fokuss}`]]
+        : [];
+    const prompt = ChatPromptTemplate.fromMessages([
+        ["system", `Du fasst eine Chat-Konversation zwischen User und Assistant zusammen.
+          WICHTIG:
+          - Behalte ALLE wichtigen Fakten: Namen, Präferenzen, Entscheidungen, Vereinbarungen
+          - Behalte chronologischen Kontext wo relevant für Verständnis
+          - Fasse auf max. ${maxWords} Wörter zusammen
+          - Format: Kurze, prägnante Zusammenfassung ohne Bullet-Points
+          - Ignoriere Small-Talk, fokussiere auf inhaltliche Punkte`],
+        ...focusMessage,
+        ["human", "{conversation}"]
+    ]);
+    const chain = createChain(prompt, llm, new StringOutputParser());
+    const result = await chain.invoke({ conversation });
+    return typeof result === "string" ? result : String(result);
+}
+//# sourceMappingURL=helpers.js.map

package/dist/helpers.js.map

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