@delofarag/ai-utils 1.4.3 → 1.6.0

package/dist/helpers/llms.js

@@ -0,0 +1,62 @@
+import { ChatGroq, ChatOllama, ChatOpenAI } from "../imports";
+/**
+ * env-var for openrouter: process.env.OPENROUTER_API_KEY
+ *
+ * env-var for chatgroq: process.env.CHATGROQ_API_KEY
+ *
+ * default llm for chatgroq: "llama-3.3-70b-versatile"
+ *
+ * default llm for openrouter: "openai/gpt-5.4-mini"
+ *
+ * default llm for local: "llama3.2:3b"
+ */
+export function getLLM(config) {
+    const type = config.type;
+    switch (config.provider) {
+        case "chatgroq":
+            return new ChatGroq({
+                apiKey: config.apikey ?? process.env.CHATGROQ_API_KEY,
+                model: config.model ?? (type === "vision"
+                    ? "meta-llama/llama-4-scout-17b-16e-instruct"
+                    : type === "stt"
+                        ? "whisper-large-v3-turbo"
+                        : type === "tts"
+                            ? "canopylabs/orpheus-v1-english"
+                            : "llama-3.3-70b-versatile")
+            });
+        case "openrouter":
+            return new ChatOpenAI({
+                apiKey: config.apikey ?? process.env.OPENROUTER_API_KEY,
+                configuration: {
+                    baseURL: config.dataSafe
+                        ? "https://eu.openrouter.ai/api/v1"
+                        : "https://openrouter.ai/api/v1",
+                },
+                model: config.model ?? (type === "image-gen"
+                    ? "google/gemini-3.1-flash-image-preview"
+                    : type === "stt"
+                        ? "google/gemini-2.5-flash"
+                        : type === "tts"
+                            ? "openai/gpt-4o-mini-tts-2025-12-15"
+                            : "openai/gpt-5.4-mini"),
+                ...(config.dataSafe
+                    ? {
+                        modelKwargs: {
+                            provider: {
+                                data_collection: "deny",
+                                zdr: true,
+                                allow_fallbacks: false,
+                            },
+                        },
+                    }
+                    : {}),
+            });
+        case "local":
+            return new ChatOllama({
+                model: config.model ?? "llama3.2:3b"
+            });
+        default:
+            throw new Error("Unknown LLM provider");
+    }
+}
+//# sourceMappingURL=llms.js.map

package/dist/helpers/llms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms.js","sourceRoot":"","sources":["../../src/helpers/llms.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAuQ5D;;;;;;;;;;GAUG;AACL,MAAM,UAAU,MAAM,CAAC,MAAiB;IACtC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAA;IAExB,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,UAAU;YACb,OAAO,IAAI,QAAQ,CAAC;gBAClB,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB;gBACrD,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,CACrB,IAAI,KAAK,QAAQ;oBACf,CAAC,CAAC,2CAA2C;oBAC7C,CAAC,CAAC,IAAI,KAAK,KAAK;wBACd,CAAC,CAAC,wBAAwB;wBAC1B,CAAC,CAAC,IAAI,KAAK,KAAK;4BACd,CAAC,CAAC,+BAA+B;4BACjC,CAAC,CAAC,yBAAyB,CAClC;aACF,CAAC,CAAC;QAEL,KAAK,YAAY;YACf,OAAO,IAAI,UAAU,CAAC;gBACpB,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB;gBACvD,aAAa,EAAE;oBACb,OAAO,EAAE,MAAM,CAAC,QAAQ;wBACtB,CAAC,CAAC,iCAAiC;wBACnC,CAAC,CAAC,8BAA8B;iBACnC;gBACD,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,CACrB,IAAI,KAAK,WAAW;oBAClB,CAAC,CAAC,uCAAuC;oBACzC,CAAC,CAAC,IAAI,KAAK,KAAK;wBACd,CAAC,CAAC,yBAAyB;wBAC3B,CAAC,CAAC,IAAI,KAAK,KAAK;4BACd,CAAC,CAAC,mCAAmC;4BACrC,CAAC,CAAC,qBAAqB,CAC9B;gBACD,GAAG,CAAC,MAAM,CAAC,QAAQ;oBACjB,CAAC,CAAC;wBACE,WAAW,EAAE;4BACX,QAAQ,EAAE;gCACR,eAAe,EAAE,MAAM;gCACvB,GAAG,EAAE,IAAI;gCACT,eAAe,EAAE,KAAK;6BACvB;yBACF;qBACF;oBACH,CAAC,CAAC,EAAE,CAAC;aACR,CAAC,CAAA;QAEJ,KAAK,OAAO;YACV,OAAO,IAAI,UAAU,CAAC;gBACpB,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,aAAa;aACrC,CAAC,CAAC;QAEL;YACE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC"}

package/dist/helpers/memory.d.ts

@@ -0,0 +1,107 @@
+import { SupabaseTable } from "@delofarag/supabase-utils";
+import { BaseCheckpointSaver, BaseChatModel, type Checkpoint, type CheckpointMetadata, type LangGraphRunnableConfig, type RunnableConfig, type CheckpointTuple, type CheckpointListOptions, type PendingWrite, type ChannelVersions } from "../imports";
+/** Rolle einer Chat-Message im Checkpoint (Nach Json aus der DB oft Plain-Objects). */
+export type CheckpointChatRole = "human" | "ai" | "system" | "tool" | "other";
+export interface SupabaseCheckpointRow {
+    thread_id: string;
+    checkpoint: Checkpoint;
+    metadata: CheckpointMetadata;
+    created_at?: string;
+    updated_at?: string;
+}
+/** Nachrichten-Channel aus einem gespeicherten Checkpoint (meist `channel_values.messages`). */
+export declare function getMessagesArrayFromCheckpoint(checkpoint: Checkpoint | undefined | null): unknown[];
+export declare function checkpointMessageBody(message: unknown): string;
+/** Erkennung Human / AI / System / Tool — funktioniert mit LangChain-Klassen und serialisierten JSON-Objekten. */
+export declare function checkpointMessageRole(message: unknown): CheckpointChatRole;
+/**
+ * Für Prompts/System-Kontext: klare Labels, Reihenfolge wie im Checkpoint-Channel `messages`,
+ * ohne extra DB-Spalte `conversation`.
+ */
+export declare function formatCheckpointMessagesForLLM(messages: unknown[]): string;
+/**
+ * needs testing!!!
+ */
+export declare class SupabaseCheckpointSaver extends BaseCheckpointSaver {
+    private table;
+    constructor(supabaseTable: SupabaseTable<SupabaseCheckpointRow>);
+    /** Messages aus gespeicherter `checkpoint`-Spalte (`channel_values.messages`). */
+    getCheckpointMessages(threadId: string): Promise<unknown[]>;
+    /** Lesbarer Kontext für Prompts (aus Checkpoint, keine `conversation`-Spalte). */
+    getConversationAsLLMContext(threadId: string): Promise<string>;
+    put(config: LangGraphRunnableConfig, checkpoint: Checkpoint, metadata: CheckpointMetadata, newVersions: ChannelVersions): Promise<RunnableConfig>;
+    get(config: LangGraphRunnableConfig): Promise<Checkpoint | undefined>;
+    list(config: LangGraphRunnableConfig, options?: CheckpointListOptions): AsyncGenerator<CheckpointTuple>;
+    delete(config: LangGraphRunnableConfig): Promise<void>;
+    getTuple(config: LangGraphRunnableConfig): Promise<CheckpointTuple | undefined>;
+    putWrites(_config: RunnableConfig, _writes: PendingWrite[], _taskId: string): Promise<void>;
+    deleteThread(threadId: string): Promise<void>;
+}
+interface SmartCheckpointSaverOptions {
+    messagesBeforeSummary?: number;
+    maxSummaries?: number;
+    llm?: BaseChatModel;
+    debug?: boolean;
+}
+/**
+ * CONSTRUCTOR:
+ * @example
+ * constructor(
+        checkpointSaver: BaseCheckpointSaver,
+        {
+            messagesBeforeSummary = 12,
+            maxSummaries = 7,
+            llm = getLLM({ provider:"openrouter", model: "openai/gpt-5.4-mini"}),
+            debug = false
+        }: SmartCheckpointSaverOptions = {}
+    ) {
+        super()
+        this.checkpointSaver = checkpointSaver
+        this.messagesBeforeSummary = messagesBeforeSummary
+        this.maxSummaries = maxSummaries
+        this.llm = llm
+        this.debug = debug
+    }
+ */
+export declare class SmartCheckpointSaver extends BaseCheckpointSaver {
+    private checkpointSaver;
+    private messagesBeforeSummary;
+    private maxSummaries;
+    private llm;
+    private debug;
+    private lastDebugState;
+    constructor(checkpointSaver: BaseCheckpointSaver, { messagesBeforeSummary, maxSummaries, llm, debug }?: SmartCheckpointSaverOptions);
+    private getMessageRole;
+    private getMessageContent;
+    /**
+     * Zählt User/AI Messages (ignoriert System-Messages)
+     */
+    private countChatMessages;
+    /**
+     * Findet alle System-Messages die Zusammenfassungen sind
+     */
+    private findSummaryMessages;
+    /**
+     * Konvertiert Messages zu Text für Summarization
+     */
+    private messagesToText;
+    private applySmartSummarization;
+    put(config: LangGraphRunnableConfig, checkpoint: Checkpoint, metadata: CheckpointMetadata, newVersions: ChannelVersions): Promise<RunnableConfig>;
+    get(config: LangGraphRunnableConfig): Promise<Checkpoint | undefined>;
+    list(config: LangGraphRunnableConfig, options?: CheckpointListOptions): AsyncGenerator<CheckpointTuple>;
+    delete(config: LangGraphRunnableConfig): Promise<void>;
+    getTuple(config: LangGraphRunnableConfig): Promise<CheckpointTuple | undefined>;
+    putWrites(config: RunnableConfig, writes: PendingWrite[], taskId: string): Promise<void>;
+    deleteThread(threadId: string): Promise<void>;
+}
+/**
+ * fasst eine Chat-Konversation zwischen User und Assistant zusammen
+ */
+export declare function chatSummarizer({ conversation, fokuss, llm, maxWords }: {
+    conversation: string;
+    fokuss?: string;
+    llm: BaseChatModel;
+    maxWords?: number;
+}): Promise<string>;
+export {};
+//# sourceMappingURL=memory.d.ts.map

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

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

package/dist/helpers/memory.js

@@ -0,0 +1,497 @@
+import { createSimpleChain } from "./helpers";
+import { getLLM } from "./llms";
+import { BaseCheckpointSaver, HumanMessage, AIMessage, SystemMessage, StringOutputParser, ChatPromptTemplate } from "../imports";
+import { ToolMessage, } from "@langchain/core/messages";
+/** Nachrichten-Channel aus einem gespeicherten Checkpoint (meist `channel_values.messages`). */
+export function getMessagesArrayFromCheckpoint(checkpoint) {
+    if (!checkpoint?.channel_values)
+        return [];
+    const msgs = checkpoint.channel_values.messages;
+    return Array.isArray(msgs) ? msgs : [];
+}
+export function checkpointMessageBody(message) {
+    if (message === null || message === undefined)
+        return "";
+    const m = message;
+    const rawContent = m.content ??
+        (m.kwargs && typeof m.kwargs === "object"
+            ? m.kwargs.content
+            : undefined) ??
+        "";
+    if (typeof rawContent === "string")
+        return rawContent;
+    if (Array.isArray(rawContent))
+        return rawContent
+            .map((part) => typeof part === "object" && part !== null && "text" in part
+            ? String(part.text ?? "")
+            : JSON.stringify(part))
+            .join("");
+    return JSON.stringify(rawContent);
+}
+/** Erkennung Human / AI / System / Tool — funktioniert mit LangChain-Klassen und serialisierten JSON-Objekten. */
+export function checkpointMessageRole(message) {
+    if (message === null || message === undefined || typeof message !== "object")
+        return "other";
+    const m = message;
+    if (m instanceof HumanMessage)
+        return "human";
+    if (m instanceof AIMessage)
+        return "ai";
+    if (m instanceof SystemMessage)
+        return "system";
+    if (m instanceof ToolMessage)
+        return "tool";
+    const raw = message;
+    const kw = raw.kwargs && typeof raw.kwargs === "object" ? raw.kwargs : {};
+    const t = typeof raw._getType === "function"
+        ? raw._getType()
+        : typeof raw.type === "string"
+            ? raw.type
+            : undefined;
+    if (t === "human" || t === "user")
+        return "human";
+    if (t === "ai" || t === "assistant")
+        return "ai";
+    if (t === "system")
+        return "system";
+    if (t === "tool")
+        return "tool";
+    const idArr = raw.id;
+    const idLast = Array.isArray(idArr) ? idArr[idArr.length - 1] : undefined;
+    if (idLast === "HumanMessage")
+        return "human";
+    if (idLast === "AIMessage" || idLast === "AIMessageChunk")
+        return "ai";
+    if (idLast === "SystemMessage")
+        return "system";
+    if (idLast === "ToolMessage")
+        return "tool";
+    const role = (kw.role ?? raw.role);
+    if (role === "human" || role === "user")
+        return "human";
+    if (role === "ai" || role === "assistant")
+        return "ai";
+    if (role === "system")
+        return "system";
+    if (role === "tool")
+        return "tool";
+    return "other";
+}
+function checkpointToolDisplayName(message) {
+    if (message === null || message === undefined || typeof message !== "object")
+        return undefined;
+    if (message instanceof ToolMessage)
+        return message.name ?? undefined;
+    const raw = message;
+    const kw = raw.kwargs && typeof raw.kwargs === "object" ? raw.kwargs : {};
+    const name = typeof raw.name === "string"
+        ? raw.name
+        : typeof kw.name === "string"
+            ? kw.name
+            : undefined;
+    return name || undefined;
+}
+/**
+ * Für Prompts/System-Kontext: klare Labels, Reihenfolge wie im Checkpoint-Channel `messages`,
+ * ohne extra DB-Spalte `conversation`.
+ */
+export function formatCheckpointMessagesForLLM(messages) {
+    if (!messages.length)
+        return "";
+    const blocks = [];
+    for (const msg of messages) {
+        const role = checkpointMessageRole(msg);
+        const body = checkpointMessageBody(msg).trim();
+        let heading;
+        if (role === "human")
+            heading = "**User** (human message)";
+        else if (role === "ai")
+            heading = "**Assistant** (AI message)";
+        else if (role === "system")
+            heading = "**System**";
+        else if (role === "tool") {
+            const toolName = checkpointToolDisplayName(msg);
+            heading = toolName ? `**Tool**: \`${toolName}\`` : "**Tool result**";
+        }
+        else
+            heading = "**Other / unknown role**";
+        if (!body)
+            continue;
+        blocks.push(`${heading}\n\n${body}`);
+    }
+    return blocks.join("\n\n---\n\n");
+}
+/**
+ * needs testing!!!
+ */
+export class SupabaseCheckpointSaver extends BaseCheckpointSaver {
+    table;
+    constructor(supabaseTable) {
+        super();
+        this.table = supabaseTable;
+    }
+    /** Messages aus gespeicherter `checkpoint`-Spalte (`channel_values.messages`). */
+    async getCheckpointMessages(threadId) {
+        const rows = await this.table.select({
+            columns: ["checkpoint"],
+            where: [{ column: "thread_id", is: threadId }],
+            limited_to: 1,
+        });
+        const ck = rows[0]?.checkpoint;
+        return getMessagesArrayFromCheckpoint(ck);
+    }
+    /** Lesbarer Kontext für Prompts (aus Checkpoint, keine `conversation`-Spalte). */
+    async getConversationAsLLMContext(threadId) {
+        const messages = await this.getCheckpointMessages(threadId);
+        return formatCheckpointMessagesForLLM(messages);
+    }
+    async put(config, checkpoint, metadata, newVersions) {
+        if (!checkpoint)
+            return config;
+        const threadId = config.configurable?.thread_id || "default";
+        const now = new Date().toISOString();
+        const existingRows = await this.table.select({
+            columns: ["created_at"],
+            where: [{ column: "thread_id", is: threadId }],
+            limited_to: 1,
+        });
+        const existing = existingRows[0];
+        const createdAt = existing?.created_at || now;
+        await this.table.upsert({
+            where: [{ column: "thread_id", is: threadId }],
+            upsert: {
+                checkpoint: checkpoint,
+                metadata: metadata,
+                created_at: createdAt,
+                updated_at: now,
+            },
+            onConflict: "thread_id",
+        });
+        const checkpoint_ns = config.configurable?.checkpoint_ns ?? "";
+        return {
+            configurable: {
+                thread_id: threadId,
+                checkpoint_ns,
+                checkpoint_id: checkpoint.id,
+            },
+        };
+    }
+    async get(config) {
+        const threadId = config.configurable?.thread_id || "default";
+        const rows = await this.table.select({
+            columns: ["checkpoint"],
+            where: [{ column: "thread_id", is: threadId }],
+            limited_to: 1,
+        });
+        return rows[0]?.checkpoint;
+    }
+    async *list(config, options) {
+        const threadId = config.configurable?.thread_id;
+        if (!threadId)
+            return;
+        const data = await this.table.select({
+            columns: ["checkpoint", "metadata"],
+            where: [{ column: "thread_id", is: threadId }],
+        });
+        const checkpoint_ns = config.configurable?.checkpoint_ns ?? "";
+        for (const row of data || []) {
+            const ckpt = row.checkpoint;
+            if (!ckpt)
+                continue;
+            yield {
+                config: {
+                    configurable: {
+                        thread_id: threadId,
+                        checkpoint_ns,
+                        checkpoint_id: ckpt.id,
+                    },
+                },
+                checkpoint: ckpt,
+                metadata: (row.metadata ?? {}),
+            };
+        }
+    }
+    async delete(config) {
+        const threadId = config.configurable?.thread_id || "default";
+        await this.table.delete({
+            where: [{ column: "thread_id", is: threadId }]
+        });
+    }
+    async getTuple(config) {
+        const threadId = config.configurable?.thread_id || "default";
+        const checkpoint_ns = config.configurable?.checkpoint_ns ?? "";
+        const rows = await this.table.select({
+            columns: ["checkpoint", "metadata"],
+            where: [{ column: "thread_id", is: threadId }],
+            limited_to: 1,
+        });
+        const row = rows[0];
+        const checkpoint = row?.checkpoint;
+        if (!checkpoint)
+            return undefined;
+        return {
+            config: {
+                configurable: {
+                    thread_id: threadId,
+                    checkpoint_ns,
+                    checkpoint_id: checkpoint.id,
+                },
+            },
+            checkpoint,
+            metadata: (row.metadata ?? {}),
+        };
+    }
+    async putWrites(_config, _writes, _taskId) {
+        // pending writes brauchen wir nicht separat zu persistieren -
+        // der finale Checkpoint kommt sowieso über put() rein
+        return;
+    }
+    async deleteThread(threadId) {
+        await this.table.delete({
+            where: [{ column: "thread_id", is: threadId }]
+        });
+    }
+}
+/**
+ * CONSTRUCTOR:
+ * @example
+ * constructor(
+        checkpointSaver: BaseCheckpointSaver,
+        {
+            messagesBeforeSummary = 12,
+            maxSummaries = 7,
+            llm = getLLM({ provider:"openrouter", model: "openai/gpt-5.4-mini"}),
+            debug = false
+        }: SmartCheckpointSaverOptions = {}
+    ) {
+        super()
+        this.checkpointSaver = checkpointSaver
+        this.messagesBeforeSummary = messagesBeforeSummary
+        this.maxSummaries = maxSummaries
+        this.llm = llm
+        this.debug = debug
+    }
+ */
+export class SmartCheckpointSaver extends BaseCheckpointSaver {
+    checkpointSaver;
+    messagesBeforeSummary;
+    maxSummaries;
+    llm;
+    debug;
+    lastDebugState;
+    constructor(checkpointSaver, { messagesBeforeSummary = 12, maxSummaries = 7, llm = getLLM({ provider: "openrouter", model: "openai/gpt-5.4-mini" }), debug = false } = {}) {
+        super();
+        this.checkpointSaver = checkpointSaver;
+        this.messagesBeforeSummary = messagesBeforeSummary;
+        this.maxSummaries = maxSummaries;
+        this.llm = llm;
+        this.debug = debug;
+    }
+    getMessageRole(message) {
+        const r = checkpointMessageRole(message);
+        if (r === "tool" || r === "other")
+            return "other";
+        return r;
+    }
+    getMessageContent(message) {
+        return checkpointMessageBody(message);
+    }
+    /**
+     * Zählt User/AI Messages (ignoriert System-Messages)
+     */
+    countChatMessages(messages) {
+        return messages.filter(msg => {
+            const role = this.getMessageRole(msg);
+            return role === "human" || role === "ai";
+        }).length;
+    }
+    /**
+     * Findet alle System-Messages die Zusammenfassungen sind
+     */
+    findSummaryMessages(messages) {
+        const summaries = [];
+        messages.forEach((msg, index) => {
+            if (this.getMessageRole(msg) === "system" && this.getMessageContent(msg).includes("Zusammenfassung")) {
+                summaries.push({ index, message: msg });
+            }
+        });
+        return summaries;
+    }
+    /**
+     * Konvertiert Messages zu Text für Summarization
+     */
+    messagesToText(messages) {
+        return messages.map(msg => {
+            const role = this.getMessageRole(msg);
+            const label = role === "human" ? "User" : role === "ai" ? "Assistant" : "System";
+            return `${label}: ${this.getMessageContent(msg)}`;
+        }).join('\n\n');
+    }
+    async applySmartSummarization(checkpoint) {
+        // Guard: Wenn checkpoint undefined ist, gib ihn zurück
+        if (!checkpoint) {
+            return checkpoint;
+        }
+        // Messages sind in channel_values gespeichert
+        const channelValues = checkpoint.channel_values || {};
+        const messages = channelValues.messages || [];
+        // Finde alle Zusammenfassungs-System-Messages
+        const summaryMessages = this.findSummaryMessages(messages);
+        // Finde den Index der letzten Zusammenfassung (falls vorhanden)
+        const lastSummaryIndex = summaryMessages.length > 0
+            ? summaryMessages[summaryMessages.length - 1].index
+            : -1;
+        // Finde die Messages NACH der letzten Zusammenfassung
+        const messagesAfterLastSummary = messages.slice(lastSummaryIndex + 1);
+        const chatMessagesAfterLastSummary = messagesAfterLastSummary.filter(msg => {
+            const role = this.getMessageRole(msg);
+            return role === "human" || role === "ai";
+        });
+        const lastChatMessageRole = chatMessagesAfterLastSummary.length > 0
+            ? this.getMessageRole(chatMessagesAfterLastSummary[chatMessagesAfterLastSummary.length - 1])
+            : "other";
+        // Zähle nur User/AI Messages NACH der letzten Zusammenfassung
+        const chatMessageCount = chatMessagesAfterLastSummary.length;
+        if (this.debug) {
+            const missingUntilNextSummary = Math.max(0, this.messagesBeforeSummary - chatMessageCount);
+            const debugState = `${summaryMessages.length}:${chatMessageCount}:${missingUntilNextSummary}:${lastChatMessageRole}`;
+            if (debugState !== this.lastDebugState) {
+                console.log(`[SmartCheckpointSaver] Chat messages since last summary: ${chatMessageCount}`);
+                console.log(`[SmartCheckpointSaver] Messages until next summary: ${missingUntilNextSummary}`);
+                this.lastDebugState = debugState;
+            }
+        }
+        // Wenn noch nicht genug Messages nach der letzten Zusammenfassung, keine Summarization
+        if (chatMessageCount < this.messagesBeforeSummary || lastChatMessageRole !== "ai") {
+            return checkpoint;
+        }
+        // Finde die Indizes der letzten X User/AI Messages NACH der letzten Zusammenfassung die zusammengefasst werden sollen
+        const indicesToSummarize = [];
+        const messagesToSummarize = [];
+        let chatCount = 0;
+        // Gehe rückwärts durch Messages NACH der letzten Zusammenfassung
+        for (let i = messagesAfterLastSummary.length - 1; i >= 0 && chatCount < this.messagesBeforeSummary; i--) {
+            const msg = messagesAfterLastSummary[i];
+            const role = this.getMessageRole(msg);
+            if (role === "human" || role === "ai") {
+                const originalIndex = lastSummaryIndex + 1 + i; // Original-Index im messages Array
+                indicesToSummarize.unshift(originalIndex); // Am Anfang einfügen für korrekte Reihenfolge
+                messagesToSummarize.unshift(msg); // Am Anfang einfügen für korrekte Reihenfolge
+                chatCount++;
+            }
+        }
+        if (messagesToSummarize.length === 0) {
+            return checkpoint;
+        }
+        // Erstelle Zusammenfassung
+        const conversationText = this.messagesToText(messagesToSummarize);
+        const summary = await chatSummarizer({
+            conversation: conversationText,
+            llm: this.llm,
+            maxWords: 150
+        });
+        if (this.debug) {
+            console.log(`Summary erstellt beim SmartCheckpointSaver: ${summary}`);
+        }
+        // Erstelle neue System-Message mit Zusammenfassung
+        const summarySystemMessage = new SystemMessage(`Zusammenfassung der vorherigen Konversation:\n${summary}`);
+        // Entferne die Messages die zusammengefasst wurden (verwende Indizes)
+        const remainingMessages = messages.filter((_, index) => !indicesToSummarize.includes(index));
+        // Finde die Position der letzten Zusammenfassung im remainingMessages Array
+        // (Die Indizes haben sich verschoben, aber die letzte Zusammenfassung sollte noch da sein)
+        const remainingSummaryMessages = this.findSummaryMessages(remainingMessages);
+        const lastSummaryIndexInRemaining = remainingSummaryMessages.length > 0
+            ? remainingSummaryMessages[remainingSummaryMessages.length - 1].index
+            : -1;
+        // Füge Zusammenfassung direkt nach der letzten Zusammenfassung ein
+        // Wenn keine Zusammenfassung vorhanden, füge am Anfang ein (nach System-Messages)
+        let newMessages;
+        if (lastSummaryIndexInRemaining >= 0) {
+            const beforeSummary = remainingMessages.slice(0, lastSummaryIndexInRemaining + 1);
+            const afterSummary = remainingMessages.slice(lastSummaryIndexInRemaining + 1);
+            newMessages = [...beforeSummary, summarySystemMessage, ...afterSummary];
+        }
+        else {
+            // Keine Zusammenfassung vorhanden: Füge nach System-Messages ein
+            const systemMessages = remainingMessages.filter((msg) => this.getMessageRole(msg) === "system");
+            const nonSystemMessages = remainingMessages.filter((msg) => this.getMessageRole(msg) !== "system");
+            newMessages = [...systemMessages, summarySystemMessage, ...nonSystemMessages];
+        }
+        // Prüfe ob zu viele Zusammenfassungen vorhanden sind
+        const allSummaries = this.findSummaryMessages(newMessages);
+        if (allSummaries.length > this.maxSummaries) {
+            // Entferne die älteste Zusammenfassung
+            const oldestSummary = allSummaries[0];
+            const finalMessages = newMessages.filter((_, index) => index !== oldestSummary.index);
+            return {
+                ...checkpoint,
+                channel_values: {
+                    ...channelValues,
+                    messages: finalMessages
+                }
+            };
+        }
+        return {
+            ...checkpoint,
+            channel_values: {
+                ...channelValues,
+                messages: newMessages
+            }
+        };
+    }
+    async put(config, checkpoint, metadata, newVersions) {
+        // Guard: Wenn checkpoint undefined ist, gib ihn direkt weiter
+        if (!checkpoint) {
+            return await this.checkpointSaver.put(config, checkpoint, metadata, newVersions);
+        }
+        // Wende Smart Summarization an
+        const optimizedCheckpoint = await this.applySmartSummarization(checkpoint);
+        // Speichere im unterliegenden CheckpointSaver
+        return await this.checkpointSaver.put(config, optimizedCheckpoint, metadata, newVersions);
+    }
+    async get(config) {
+        return await this.checkpointSaver.get(config);
+    }
+    async *list(config, options) {
+        yield* this.checkpointSaver.list(config, options);
+    }
+    async delete(config) {
+        const threadId = config.configurable?.thread_id || "default";
+        return await this.checkpointSaver.deleteThread(threadId);
+    }
+    async getTuple(config) {
+        return await this.checkpointSaver.getTuple(config);
+    }
+    async putWrites(config, writes, taskId) {
+        // putWrites wird für Channel-Updates verwendet, nicht für vollständige Checkpoints
+        // Summarization wird nur in put() angewendet, wo vollständige Checkpoints gespeichert werden
+        // Daher delegieren wir direkt an den unterliegenden Saver
+        await this.checkpointSaver.putWrites(config, writes, taskId);
+    }
+    async deleteThread(threadId) {
+        return await this.checkpointSaver.deleteThread(threadId);
+    }
+}
+/**
+ * fasst eine Chat-Konversation zwischen User und Assistant zusammen
+ */
+export async function chatSummarizer({ 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 = createSimpleChain(prompt, llm, new StringOutputParser());
+    const result = await chain.invoke({ conversation });
+    return typeof result === "string" ? result : String(result);
+}
+//# sourceMappingURL=memory.js.map