@delofarag/ai-utils 1.7.3 → 1.8.2

package/README.md

@@ -7,7 +7,7 @@ Ein praktisches Utility-Package für LLM-Apps mit LangChain:
 - RAG-Helper (FAISS, Supabase, In-Memory)
 - Tooling (`ToolRegistry`, `CombinedToolRegistry`, `ZodiosToolRegistry`, `createRAGTool`, `tavilySearchTool`)
 - Magic-Funcs (Parser, Evaluator, Optimizer, Answerer)
-- Modalities (STT, TTS, Vision, Image Generation)
+- Modalities (Vision, Image Generation)
 
 ---
 
@@ -20,7 +20,7 @@ Im Package gilt als Standard-LLM-Default für die allgemeine Nutzung:
 
 Wenn du nichts explizit setzt, orientiere dich an diesem Default in deinen Aufrufen.
 
-Für modality-spezifische Flows (`stt`, `tts`, `vision`, `image-gen`) wird zusätzlich mit `type` gearbeitet, damit passende Modelle gewählt werden können.
+Für kostenlose Modelle gibt es bei `provider: "openrouter"` die Option `free: true` — sie wählt dynamisch das beste aktuell kostenlose `:free`-Model (siehe Schnellstart).
 
 ---
 
@@ -76,13 +76,37 @@ const llmGroq = getLLM({ provider: "chatgroq", model: "llama-3.3-70b-versatile"
 const llmLocal = getLLM({ provider: "local", model: "llama3.2:3b" })
 ```
 
-Modality-spezifisch:
+Kostenloses Model (OpenRouter):
 
 ```ts
-getLLM({ provider: "openrouter", type: "stt" })
-getLLM({ provider: "openrouter", type: "tts" })
-getLLM({ provider: "openrouter", type: "vision" })
-getLLM({ provider: "openrouter", type: "image-gen" })
+// free: true → getLLM wird async und wählt live das beste aktuell
+// kostenlose :free-Model mit Tool-Support. Doppel-Ranking: Intelligenz
+// (sort=intelligence-high-to-low) UND Latenz (sort=latency-low-to-high),
+// kombiniert per Rang-Summe — schlau, aber kein lahmer Reasoning-Brocken.
+// Kein model-Prop erlaubt.
+const llm = await getLLM({ provider: "openrouter", free: true })
+
+console.log(llm.model) // z.B. "openai/gpt-oss-120b:free"
+```
+
+Verschwindet das gewählte Model später oder ist es nicht mehr gratis (400/402/403/404), heilt sich die Instanz selbst: nächstbestes `:free`-Model holen, `model` tauschen, Request transparent wiederholen.
+
+**Free-Limits & `FreeLimitError`:** OpenRouter begrenzt `:free`-Models account-weit auf 20 Requests/Minute und 50 Requests/Tag (bzw. 1000/Tag ab 10 gekauften Credits). Weil ein Model-Wechsel dagegen nicht hilft, wird bei 429 nicht geheilt, sondern ein typisierter `FreeLimitError` geworfen — sauber filterbar fürs Frontend:
+
+```ts
+import { FreeLimitError } from "@delofarag/ai-utils"
+
+try {
+    await llm.invoke(messages)
+} catch (e) {
+    if (e instanceof FreeLimitError && e.scope === "day") {
+        // e.code === "FREE_LIMIT_EXCEEDED" (überlebt auch JSON-Serialisierung)
+        // e.retryAfterSeconds → Sekunden bis zum Reset, falls der Server sie liefert
+        showToast("Sie haben Ihre Free-Requests für heute verbraucht.")
+    } else if (e instanceof FreeLimitError && e.scope === "minute") {
+        showToast("Kurz durchatmen — max. 20 Free-Requests pro Minute.")
+    }
+}
 ```
 
 EU-Datenrouting (OpenRouter):
@@ -899,42 +923,6 @@ const short = await summarize({
 
 ## Modalities
 
-### STT
-
-- `stt(...)`
-- `createSTTPhoneSocketSession(...)` für live phone socket chunks (Twilio/Telnyx-style)
-
-```ts
-import { stt } from "@delofarag/ai-utils"
-
-const result = await stt({
-    audio: "./call.wav",
-    prompt: "Transcribe in German."
-})
-```
-
-### TTS
-
-- `tts(...)`
-- `streamTTSOverPhoneSocket(...)` für chunked outbound audio
-
-```ts
-import { tts, streamTTSOverPhoneSocket } from "@delofarag/ai-utils"
-
-const speech = await tts({
-    text: "Willkommen beim Support.",
-    model: "nova"
-})
-
-await streamTTSOverPhoneSocket({
-    text: "Einen Moment bitte.",
-    model: "nova",
-    onChunk: async (chunk) => {
-        // socket send
-    }
-})
-```
-
 ### Vision
 
 ```ts
@@ -1036,7 +1024,7 @@ Top-level Exports (`@delofarag/ai-utils`):
 - Memory (`MemorySaver`, `SmartCheckpointSaver`, `SupabaseCheckpointSaver`, `chatSummarizer`)
 - Tools (`ToolRegistry`, `CombinedToolRegistry`, `ZodiosToolRegistry`, `Tavily`, `RAGTool`)
 - Magic-Funcs (answerers/evaluators/parsers/optimizers)
-- Modalities (`stt`, `tts`, `vision`, `generateImages`)
+- Modalities (`vision`, `generateImages`)
 
 Client-Subpath (`@delofarag/ai-utils/client`) — ohne LangChain-Bundle, für Frontend:
 

package/dist/heart/agent.d.ts

@@ -1,5 +1,5 @@
 import { z } from "zod/v4";
-import type { InvokeInputBase, OutputSchema } from "./chain";
+import { type InvokeInputBase, type OutputSchema, type ReasoningEvent } from "./chain";
 import { DynamicStructuredTool } from "../imports";
 import { BaseChatModel } from "../imports";
 import { BaseCheckpointSaver } from "../imports";
@@ -16,6 +16,12 @@ interface AgentProps<T extends OutputSchema | undefined = undefined> {
      * die Tools per getTools() geladen und der Client am Ende wieder geschlossen.
      */
     mcpServer?: MCPServersInput;
+    /**
+     * Rein deskriptiver Freitext: wofür der Agent da ist, was er macht.
+     * Der Agent selbst nutzt das NICHT — es dient nur als Kontext für externe
+     * Tools (z.B. die agent-tui `/eval`-Bewertung).
+     */
+    describe?: string;
 }
 /**
  * CONSTRUCTOR:
@@ -49,15 +55,16 @@ interface AgentProps<T extends OutputSchema | undefined = undefined> {
  * @param output - Zod-Schema: beschreibt die Struktur des Rückgabewerts von .invoke()
  */
 export declare class Agent<T extends OutputSchema | undefined = undefined> {
-    private prompt;
-    private tools;
-    private llm;
-    private output;
-    private agent;
-    private checkpointer;
-    private mcpServer;
+    prompt: Array<["system", string]>;
+    tools: DynamicStructuredTool[];
+    llm: BaseChatModel;
+    output: T | undefined;
+    agent: any;
+    checkpointer: BaseCheckpointSaver | undefined;
+    mcpServer: MCPServersInput | undefined;
+    describe: string | undefined;
     private should_use_output;
-    constructor({ prompt, llm, tools, output, checkpointer, mcpServer, }: AgentProps<T>);
+    constructor({ prompt, llm, tools, output, checkpointer, mcpServer, describe, }: AgentProps<T>);
     /** bruder ich weiss functional overloading tot aber muss hier sein! so kann sicher gesagt werden: wenn kein output gesetzt = string, wenn doch = z.infer<output>! */
     invoke(this: Agent<undefined>, invokeInput: InvokeInputBase & {
         thread_id?: string;
@@ -65,6 +72,11 @@ export declare class Agent<T extends OutputSchema | undefined = undefined> {
     invoke<U extends OutputSchema>(this: Agent<U>, invokeInput: InvokeInputBase & {
         thread_id?: string;
     }): Promise<z.infer<U>>;
+    stream(invokeInput: InvokeInputBase & {
+        thread_id?: string;
+        stream_delay?: number;
+        showReasoning: true;
+    }): AsyncGenerator<string | ReasoningEvent, void, unknown>;
     stream(invokeInput: InvokeInputBase & {
         thread_id?: string;
         stream_delay?: number;

package/dist/heart/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/heart/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAC5D,OAAO,EAAE,qBAAqB,EAAC,MAAM,YAAY,CAAA;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAMhD,OAAO,EAAuC,KAAK,eAAe,EAAE,MAAM,aAAa,CAAA;AAqBvF,UAAU,UAAU,CAAC,CAAC,SAAS,YAAY,GAAG,SAAS,GAAG,SAAS;IAC/D,KAAK,EAAE,qBAAqB,EAAE,CAAA;IAC9B,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,GAAG,CAAC,EAAE,aAAa,CAAA;IACnB,MAAM,CAAC,EAAE,CAAC,CAAA;IACV,YAAY,CAAC,EAAE,mBAAmB,CAAA;IAClC;;;;OAIG;IACH,SAAS,CAAC,EAAE,eAAe,CAAA;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,KAAK,CAAC,CAAC,SAAS,YAAY,GAAG,SAAS,GAAG,SAAS;IAC7D,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,GAAG,CAAe;IAC1B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,YAAY,CAAiC;IACrD,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,iBAAiB,CAAgB;gBAE7B,EACR,MAA6C,EAC7C,GAAoE,EACpE,KAAK,EACL,MAAM,EACN,YAAY,EACZ,SAAS,GACZ,EAAE,UAAU,CAAC,CAAC,CAAC;IAoBhB,qKAAqK;IACxJ,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,eAAe,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IACtG,MAAM,CAAC,CAAC,SAAS,YAAY,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,eAAe,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAgDzH,MAAM,CAAC,WAAW,EAAE,eAAe,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC;IA+DlI,OAAO,CAAC,IAAI,EAAC,qBAAqB;IAIzC,IAAW,YAAY,IAAI,MAAM,EAAE,CAElC;CACJ"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/heart/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,OAAO,EAAyB,KAAK,eAAe,EAAE,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,SAAS,CAAA;AAC7G,OAAO,EAAE,qBAAqB,EAAC,MAAM,YAAY,CAAA;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAMhD,OAAO,EAAuC,KAAK,eAAe,EAAE,MAAM,aAAa,CAAA;AAqBvF,UAAU,UAAU,CAAC,CAAC,SAAS,YAAY,GAAG,SAAS,GAAG,SAAS;IAC/D,KAAK,EAAE,qBAAqB,EAAE,CAAA;IAC9B,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,GAAG,CAAC,EAAE,aAAa,CAAA;IACnB,MAAM,CAAC,EAAE,CAAC,CAAA;IACV,YAAY,CAAC,EAAE,mBAAmB,CAAA;IAClC;;;;OAIG;IACH,SAAS,CAAC,EAAE,eAAe,CAAA;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,KAAK,CAAC,CAAC,SAAS,YAAY,GAAG,SAAS,GAAG,SAAS;IACtD,MAAM,EAAE,KAAK,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAA;IACjC,KAAK,EAAE,qBAAqB,EAAE,CAAA;IAC9B,GAAG,EAAE,aAAa,CAAA;IAClB,MAAM,EAAE,CAAC,GAAG,SAAS,CAAA;IACrB,KAAK,EAAE,GAAG,CAAA;IACV,YAAY,EAAE,mBAAmB,GAAG,SAAS,CAAA;IAC7C,SAAS,EAAE,eAAe,GAAG,SAAS,CAAA;IACtC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,OAAO,CAAC,iBAAiB,CAAgB;gBAE7B,EACR,MAA6C,EAC7C,GAAoE,EACpE,KAAK,EACL,MAAM,EACN,YAAY,EACZ,SAAS,EACT,QAAQ,GACX,EAAE,UAAU,CAAC,CAAC,CAAC;IAqBhB,qKAAqK;IACxJ,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,eAAe,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IACtG,MAAM,CAAC,CAAC,SAAS,YAAY,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,eAAe,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAgDhI,MAAM,CAAC,WAAW,EAAE,eAAe,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,IAAI,CAAA;KAAE,GAAG,cAAc,CAAC,MAAM,GAAG,cAAc,EAAE,IAAI,EAAE,OAAO,CAAC;IACjK,MAAM,CAAC,WAAW,EAAE,eAAe,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC;IAqE3H,OAAO,CAAC,IAAI,EAAC,qBAAqB;IAIzC,IAAW,YAAY,IAAI,MAAM,EAAE,CAElC;CACJ"}

package/dist/heart/agent.js

@@ -1,8 +1,9 @@
 import { PromptTemplate } from "@langchain/core/prompts";
+import { extractReasoningDelta } from "./chain";
 import { createReactAgent } from "../imports";
 import { HumanMessage } from "../imports";
 import { structure } from "../magic-funcs/parsers/structure";
-import { getLLM } from "../helpers/llms";
+import { getLLM } from "../helpers/llm/llms";
 import { buildMcpClient, buildMcpPromptBlock } from "./tools/MCP";
 async function resolveSystemPromptBlocks(blocks, promptVars) {
     if (!promptVars || Object.keys(promptVars).length === 0) {
@@ -59,8 +60,9 @@ export class Agent {
     agent;
     checkpointer;
     mcpServer;
+    describe;
     should_use_output = true;
-    constructor({ prompt = `Du bist ein hilfreicher Assistent.`, llm = getLLM({ provider: "openrouter", model: "openai/gpt-5.4-mini" }), tools, output, checkpointer, mcpServer, }) {
+    constructor({ prompt = `Du bist ein hilfreicher Assistent.`, llm = getLLM({ provider: "openrouter", model: "openai/gpt-5.4-mini" }), tools, output, checkpointer, mcpServer, describe, }) {
         this.prompt = typeof prompt === "string" ? [["system", prompt]] : Array.isArray(prompt) ? prompt.map((p) => {
             if (typeof p === "string") {
                 return ["system", p];
@@ -79,6 +81,7 @@ export class Agent {
         this.output = output;
         this.checkpointer = checkpointer;
         this.mcpServer = mcpServer;
+        this.describe = describe;
     }
     async invoke(invokeInput) {
         const { thread_id, debug, promptVars, ...variables } = invokeInput;
@@ -126,7 +129,7 @@ export class Agent {
         this.should_use_output = false;
         const mcpClient = buildMcpClient(this.mcpServer);
         try {
-            const { thread_id, promptVars, ...variables } = invokeInput;
+            const { thread_id, promptVars, showReasoning, ...variables } = invokeInput;
             if (this.checkpointer && !thread_id)
                 throw new Error("thread_id is required when using checkpointer, else no state is stored");
             if (!this.checkpointer && thread_id)
@@ -157,6 +160,11 @@ export class Agent {
                 if (node === "tools" || messageType === "tool") {
                     continue;
                 }
+                if (showReasoning) {
+                    const reasoning = extractReasoningDelta(messageChunk);
+                    if (reasoning)
+                        yield { kind: "reasoning", text: reasoning };
+                }
                 const raw = messageChunk?.content;
                 if (typeof raw === "string") {
                     if (raw.length > 0)

package/dist/heart/agent.js.map

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

package/dist/heart/chain.d.ts

@@ -14,6 +14,17 @@ export interface InvokeInputBase {
     promptVars?: Record<string, any>;
     [key: string]: any;
 }
+/** Reasoning-Delta im Stream — kommt nur bei `showReasoning: true` und nur, wenn das Model Reasoning liefert. */
+export type ReasoningEvent = {
+    kind: "reasoning";
+    text: string;
+};
+/**
+ * Liest das Reasoning-Delta aus einem LangChain-Message-Chunk: `reasoning_content`
+ * (mappt @langchain/openai selbst) bzw. OpenRouters `delta.reasoning` aus der
+ * Roh-Response (nur vorhanden, wenn das LLM mit `__includeRawResponse` gebaut wurde).
+ */
+export declare function extractReasoningDelta(messageChunk: any): string | undefined;
 interface ChainProps<T extends OutputSchema> {
     prompt?: string | Array<string | MessagesPlaceholder<any>>;
     llm?: BaseChatModel;
@@ -52,6 +63,10 @@ export declare class Chain<T extends OutputSchema = typeof DEFAULT_OUTPUT_SCHEMA
     private output;
     constructor({ prompt, llm, output, vectorStore }?: ChainProps<T>);
     invoke(input: InvokeInputBase): Promise<z.infer<T>>;
+    stream(input: Record<string, any> & {
+        debug?: boolean;
+        showReasoning: true;
+    }): AsyncGenerator<string | ReasoningEvent, void, unknown>;
     stream(input: Record<string, any> & {
         debug?: boolean;
     }): AsyncGenerator<string, void, unknown>;

package/dist/heart/chain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chain.d.ts","sourceRoot":"","sources":["../../src/heart/chain.ts"],"names":[],"mappings":"AACA,OAAO,EACH,aAAa,EAGb,mBAAmB,EACnB,WAAW,EAGd,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAG1B,wEAAwE;AACxE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAA;AAEpD,eAAO,MAAM,qBAAqB;;iBAEhC,CAAA;AAEF;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CACrB;AAED,UAAU,UAAU,CAAC,CAAC,SAAS,YAAY;IACvC,MAAM,CAAC,EAAC,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAA;IACzD,GAAG,CAAC,EAAC,aAAa,CAAA;IAClB,MAAM,CAAC,EAAC,CAAC,CAAC;IACV,WAAW,CAAC,EAAE,WAAW,CAAA;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,KAAK,CAAC,CAAC,SAAS,YAAY,GAAG,OAAO,qBAAqB;IACpE,OAAO,CAAC,MAAM,CAA+D;IAC7E,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,sBAAsB,CAAY;IAC1C,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,GAAG,CAAc;IACzB,OAAO,CAAC,MAAM,CAAE;gBAEJ,EACR,MAA4C,EAC5C,GAAoE,EACpE,MAAmD,EACnD,WAAuB,EAC1B,GAAC,UAAU,CAAC,CAAC,CAAM;IAcP,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IA4ClD,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC;IAuD7G,8EAA8E;IACjE,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC;IAWjC,UAAU,CAAC,WAAW,EAAE,WAAW;IAKnC,YAAY;CAKtB"}
+{"version":3,"file":"chain.d.ts","sourceRoot":"","sources":["../../src/heart/chain.ts"],"names":[],"mappings":"AACA,OAAO,EACH,aAAa,EAGb,mBAAmB,EACnB,WAAW,EAGd,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAG1B,wEAAwE;AACxE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAA;AAEpD,eAAO,MAAM,qBAAqB;;iBAEhC,CAAA;AAEF;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CACrB;AAED,iHAAiH;AACjH,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEhE;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,GAAG,GAAG,MAAM,GAAG,SAAS,CAQ3E;AAED,UAAU,UAAU,CAAC,CAAC,SAAS,YAAY;IACvC,MAAM,CAAC,EAAC,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAA;IACzD,GAAG,CAAC,EAAC,aAAa,CAAA;IAClB,MAAM,CAAC,EAAC,CAAC,CAAC;IACV,WAAW,CAAC,EAAE,WAAW,CAAA;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,KAAK,CAAC,CAAC,SAAS,YAAY,GAAG,OAAO,qBAAqB;IACpE,OAAO,CAAC,MAAM,CAA+D;IAC7E,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,sBAAsB,CAAY;IAC1C,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,GAAG,CAAc;IACzB,OAAO,CAAC,MAAM,CAAE;gBAEJ,EACR,MAA4C,EAC5C,GAAoE,EACpE,MAAmD,EACnD,WAAuB,EAC1B,GAAC,UAAU,CAAC,CAAC,CAAM;IAcP,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IA4CzD,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,aAAa,EAAE,IAAI,CAAA;KAAE,GAAG,cAAc,CAAC,MAAM,GAAG,cAAc,EAAE,IAAI,EAAE,OAAO,CAAC;IACrI,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC;IAiEtG,8EAA8E;IACjE,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC;IAWjC,UAAU,CAAC,WAAW,EAAE,WAAW;IAKnC,YAAY;CAKtB"}

package/dist/heart/chain.js

@@ -1,10 +1,25 @@
 import { StructuredOutputParser, ChatPromptTemplate, createRetrievalChain, createStuffDocumentsChain, } from "../imports";
 import { turn_to_docs, baseSplitter } from "../helpers/rag";
 import { z } from "zod/v4";
-import { getLLM } from "../helpers/llms";
+import { getLLM } from "../helpers/llm/llms";
 export const DEFAULT_OUTPUT_SCHEMA = z.object({
     output: z.string().describe("Dein Output zur anfrage des Users")
 });
+/**
+ * Liest das Reasoning-Delta aus einem LangChain-Message-Chunk: `reasoning_content`
+ * (mappt @langchain/openai selbst) bzw. OpenRouters `delta.reasoning` aus der
+ * Roh-Response (nur vorhanden, wenn das LLM mit `__includeRawResponse` gebaut wurde).
+ */
+export function extractReasoningDelta(messageChunk) {
+    const kwargs = messageChunk?.additional_kwargs;
+    if (typeof kwargs?.reasoning_content === "string" && kwargs.reasoning_content.length > 0) {
+        return kwargs.reasoning_content;
+    }
+    const raw = kwargs?.__raw_response?.choices?.[0]?.delta?.reasoning;
+    if (typeof raw === "string" && raw.length > 0)
+        return raw;
+    return undefined;
+}
 /**
  * CONSTRUCTOR:
  * @example
@@ -102,6 +117,8 @@ export class Chain {
         for (const key in input) {
             if (key === "debug")
                 continue;
+            if (key === "showReasoning")
+                continue;
             if (key === "thread_id") {
                 console.error("eine normale chain hat keine memory, deswegen wird thread_id ignoriert");
                 continue;
@@ -128,6 +145,11 @@ export class Chain {
             const streamChain = true_prompt.pipe(this.llm);
             const stream = await streamChain.stream({ ...invokeInput, context: contextText });
             for await (const chunk of stream) {
+                if (input.showReasoning) {
+                    const reasoning = extractReasoningDelta(chunk);
+                    if (reasoning)
+                        yield { kind: "reasoning", text: reasoning };
+                }
                 if (chunk && typeof chunk === 'object' && 'content' in chunk) {
                     yield chunk.content;
                 }
@@ -143,6 +165,11 @@ export class Chain {
                 console.log("created normal chain (streaming)");
             const stream = await streamChain.stream(invokeInput);
             for await (const chunk of stream) {
+                if (input.showReasoning) {
+                    const reasoning = extractReasoningDelta(chunk);
+                    if (reasoning)
+                        yield { kind: "reasoning", text: reasoning };
+                }
                 if (chunk && typeof chunk === 'object' && 'content' in chunk) {
                     yield chunk.content;
                 }

package/dist/heart/chain.js.map

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

package/dist/heart/deepAgent.d.ts

@@ -2,7 +2,7 @@ import { z } from "zod/v4";
 import type { OutputSchema } from "./chain";
 import { DynamicStructuredTool, BaseChatModel, BaseCheckpointSaver, type AgentMiddleware, type BaseStore, type CreateDeepAgentParams, type SubAgent, type FilesystemPermission } from "../imports";
 import { type MCPServersInput } from "./tools/MCP";
-import type { DeepAgentInterrupt, DeepAgentRunInputBase, DeepAgentHitlFields, DeepAgentShowToolCallsField, DeepAgentToolEvent } from "../helpers/deepagent/interruptTypes";
+import type { DeepAgentInterrupt, DeepAgentRunInputBase, DeepAgentHitlFields, DeepAgentShowToolCallsField, DeepAgentShowReasoningField, DeepAgentShowSubagentsField, DeepAgentToolEvent, DeepAgentReasoningEvent, DeepAgentSubagentEvent } from "../helpers/deepagent/interruptTypes";
 import { type DeepAgentInterruptableToolName, type InterruptOnFor } from "../helpers/deepagent/interruptOn";
 import type { DeepAgentBackend } from "../helpers/deepagent/backend";
 interface DeepAgentProps<T extends OutputSchema | undefined = undefined, TTools extends readonly DynamicStructuredTool[] = readonly [], TBackend extends DeepAgentBackend | undefined = undefined> {
@@ -29,6 +29,12 @@ interface DeepAgentProps<T extends OutputSchema | undefined = undefined, TTools
      * (Neuaufbau pro Aufruf), damit close() den Client nicht für Folge-Calls killt.
      */
     mcpServer?: MCPServersInput;
+    /**
+     * Rein deskriptiver Freitext: wofür der Agent da ist, was er macht.
+     * Der Agent selbst nutzt das NICHT — es dient nur als Kontext für externe
+     * Tools (z.B. die agent-tui `/eval`-Bewertung).
+     */
+    describe?: string;
 }
 /**
  * @example
@@ -69,26 +75,27 @@ interface DeepAgentProps<T extends OutputSchema | undefined = undefined, TTools
     }
  */
 export declare class DeepAgent<T extends OutputSchema | undefined = undefined, const TTools extends readonly DynamicStructuredTool[] = readonly [], TBackend extends DeepAgentBackend | undefined = undefined, THasInterrupt extends boolean = false> {
-    private prompt;
-    private tools;
-    private llm;
-    private output;
-    private agent;
+    prompt: Array<["system", string]>;
+    tools: TTools;
+    llm: BaseChatModel;
+    output: T | undefined;
+    agent: any;
     private agentCacheDirty;
-    private checkpointer;
-    private agentsMd;
-    private subagents;
-    private backend;
-    private permissions;
-    private skills;
-    private middleware;
-    private interruptOn;
-    private store;
-    private name;
-    private contextSchema;
-    private mcpServer;
+    checkpointer: BaseCheckpointSaver | boolean;
+    agentsMd: string[] | undefined;
+    subagents: SubAgent[] | undefined;
+    backend: TBackend | undefined;
+    permissions: FilesystemPermission[] | undefined;
+    skills: string[] | undefined;
+    middleware: AgentMiddleware[] | undefined;
+    interruptOn: InterruptOnFor<DeepAgentInterruptableToolName<TTools, TBackend>> | undefined;
+    store: BaseStore | undefined;
+    name: string | undefined;
+    contextSchema: CreateDeepAgentParams["contextSchema"];
+    mcpServer: MCPServersInput | undefined;
+    describe: string | undefined;
     private should_use_output;
-    constructor({ prompt, llm, tools, output, checkpointer, agentsMd, subagents, backend, permissions, skills, middleware, interruptOn, store, name, contextSchema, mcpServer, }?: DeepAgentProps<T, TTools, TBackend>);
+    constructor({ prompt, llm, tools, output, checkpointer, agentsMd, subagents, backend, permissions, skills, middleware, interruptOn, store, name, contextSchema, mcpServer, describe, }?: DeepAgentProps<T, TTools, TBackend>);
     static create<const TTools extends readonly DynamicStructuredTool[], TBackend extends DeepAgentBackend | undefined = undefined>(props: DeepAgentProps<undefined, TTools, TBackend> & {
         interruptOn: InterruptOnFor<DeepAgentInterruptableToolName<TTools, TBackend>>;
     }): DeepAgent<undefined, TTools, TBackend, true>;
@@ -112,10 +119,18 @@ export declare class DeepAgent<T extends OutputSchema | undefined = undefined, c
     invoke<U extends OutputSchema>(this: DeepAgent<U, TTools, TBackend, true>, invokeInput: DeepAgentRunInputBase & DeepAgentHitlFields): Promise<z.infer<U> | DeepAgentInterrupt>;
     invoke(this: DeepAgent<undefined, TTools, TBackend, false>, invokeInput: DeepAgentRunInputBase): Promise<string>;
     invoke<U extends OutputSchema>(this: DeepAgent<U, TTools, TBackend, false>, invokeInput: DeepAgentRunInputBase): Promise<z.infer<U>>;
-    stream(this: DeepAgent<T, TTools, TBackend, true>, invokeInput: DeepAgentRunInputBase & DeepAgentHitlFields): AsyncGenerator<string | DeepAgentInterrupt, void, unknown>;
+    stream(this: DeepAgent<T, TTools, TBackend, true>, invokeInput: DeepAgentRunInputBase & DeepAgentHitlFields & DeepAgentShowToolCallsField & DeepAgentShowReasoningField & DeepAgentShowSubagentsField): AsyncGenerator<string | DeepAgentInterrupt | DeepAgentToolEvent | DeepAgentReasoningEvent | DeepAgentSubagentEvent, void, unknown>;
+    stream(this: DeepAgent<T, TTools, TBackend, true>, invokeInput: DeepAgentRunInputBase & DeepAgentHitlFields & DeepAgentShowToolCallsField & DeepAgentShowReasoningField): AsyncGenerator<string | DeepAgentInterrupt | DeepAgentToolEvent | DeepAgentReasoningEvent, void, unknown>;
     stream(this: DeepAgent<T, TTools, TBackend, true>, invokeInput: DeepAgentRunInputBase & DeepAgentHitlFields & DeepAgentShowToolCallsField): AsyncGenerator<string | DeepAgentInterrupt | DeepAgentToolEvent, void, unknown>;
-    stream(this: DeepAgent<T, TTools, TBackend, false>, invokeInput: DeepAgentRunInputBase): AsyncGenerator<string, void, unknown>;
+    stream(this: DeepAgent<T, TTools, TBackend, true>, invokeInput: DeepAgentRunInputBase & DeepAgentHitlFields & DeepAgentShowReasoningField): AsyncGenerator<string | DeepAgentInterrupt | DeepAgentReasoningEvent, void, unknown>;
+    stream(this: DeepAgent<T, TTools, TBackend, true>, invokeInput: DeepAgentRunInputBase & DeepAgentHitlFields & DeepAgentShowSubagentsField): AsyncGenerator<string | DeepAgentInterrupt | DeepAgentSubagentEvent, void, unknown>;
+    stream(this: DeepAgent<T, TTools, TBackend, true>, invokeInput: DeepAgentRunInputBase & DeepAgentHitlFields): AsyncGenerator<string | DeepAgentInterrupt, void, unknown>;
+    stream(this: DeepAgent<T, TTools, TBackend, false>, invokeInput: DeepAgentRunInputBase & DeepAgentShowToolCallsField & DeepAgentShowReasoningField & DeepAgentShowSubagentsField): AsyncGenerator<string | DeepAgentToolEvent | DeepAgentReasoningEvent | DeepAgentSubagentEvent, void, unknown>;
+    stream(this: DeepAgent<T, TTools, TBackend, false>, invokeInput: DeepAgentRunInputBase & DeepAgentShowToolCallsField & DeepAgentShowReasoningField): AsyncGenerator<string | DeepAgentToolEvent | DeepAgentReasoningEvent, void, unknown>;
     stream(this: DeepAgent<T, TTools, TBackend, false>, invokeInput: DeepAgentRunInputBase & DeepAgentShowToolCallsField): AsyncGenerator<string | DeepAgentToolEvent, void, unknown>;
+    stream(this: DeepAgent<T, TTools, TBackend, false>, invokeInput: DeepAgentRunInputBase & DeepAgentShowReasoningField): AsyncGenerator<string | DeepAgentReasoningEvent, void, unknown>;
+    stream(this: DeepAgent<T, TTools, TBackend, false>, invokeInput: DeepAgentRunInputBase & DeepAgentShowSubagentsField): AsyncGenerator<string | DeepAgentSubagentEvent, void, unknown>;
+    stream(this: DeepAgent<T, TTools, TBackend, false>, invokeInput: DeepAgentRunInputBase): AsyncGenerator<string, void, unknown>;
     addTool(tool: DynamicStructuredTool): void;
     get currentTools(): string[];
 }

package/dist/heart/deepAgent.d.ts.map

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

package/dist/heart/deepAgent.js

@@ -1,6 +1,6 @@
 import { PromptTemplate } from "@langchain/core/prompts";
 import { createDeepAgent, HumanMessage, MemorySaver, } from "../imports";
-import { getLLM } from "../helpers/llms";
+import { getLLM } from "../helpers/llm/llms";
 import { structure } from "../magic-funcs/parsers/structure";
 import { buildMcpClient, buildMcpPromptBlock } from "./tools/MCP";
 import { createResumeCommand, expandResumeDecisions, getPendingInterruptCount, mapInterruptOnToNative, mapResultToInterrupt, } from "../helpers/deepagent/interruptOn";
@@ -81,8 +81,9 @@ export class DeepAgent {
     name;
     contextSchema;
     mcpServer;
+    describe;
     should_use_output = true;
-    constructor({ prompt = `Du bist ein hilfreicher Deep Agent.`, llm = getLLM({ provider: "openrouter", model: "openai/gpt-5.4-mini" }), tools = [], output, checkpointer = new MemorySaver(), agentsMd, subagents, backend, permissions, skills, middleware, interruptOn, store, name, contextSchema, mcpServer, } = {}) {
+    constructor({ prompt = `Du bist ein hilfreicher Deep Agent.`, llm = getLLM({ provider: "openrouter", model: "openai/gpt-5.4-mini" }), tools = [], output, checkpointer = new MemorySaver(), agentsMd, subagents, backend, permissions, skills, middleware, interruptOn, store, name, contextSchema, mcpServer, describe, } = {}) {
         this.prompt = typeof prompt === "string"
             ? [["system", prompt]]
             : prompt.map((p) => ["system", p]);
@@ -101,6 +102,7 @@ export class DeepAgent {
         this.name = name;
         this.contextSchema = contextSchema;
         this.mcpServer = mcpServer;
+        this.describe = describe;
     }
     static create(props) {
         return new DeepAgent(props);
@@ -206,7 +208,7 @@ export class DeepAgent {
         return this.mapInvokeResult(result);
     }
     async *runResumeStream(input) {
-        const { thread_id, context, decision, decisions, showToolCalls = false, mcpTools = [] } = input;
+        const { thread_id, context, decision, decisions, showToolCalls = false, showReasoning = false, showSubagents = false, mcpTools = [] } = input;
         this.should_use_output = false;
         const seenToolStarts = new Set();
         try {
@@ -221,6 +223,8 @@ export class DeepAgent {
                 for (const mapped of mapNativeStreamChunk(chunk, {
                     interruptOn: true,
                     showToolCalls,
+                    showReasoning,
+                    showSubagents,
                     seenToolStarts,
                 })) {
                     if (typeof mapped === "object" && mapped !== null && mapped.kind === "interrupt") {
@@ -235,7 +239,7 @@ export class DeepAgent {
             this.should_use_output = true;
         }
     }
-    async *runNativeStream(agent, input, config, showToolCalls) {
+    async *runNativeStream(agent, input, config, showToolCalls, showReasoning, showSubagents) {
         const streamMode = this.interruptOn || showToolCalls
             ? ["messages", "updates"]
             : "messages";
@@ -245,6 +249,8 @@ export class DeepAgent {
             for (const mapped of mapNativeStreamChunk(chunk, {
                 interruptOn: Boolean(this.interruptOn),
                 showToolCalls,
+                showReasoning,
+                showSubagents,
                 seenToolStarts,
             })) {
                 if (typeof mapped === "object" && mapped !== null && mapped.kind === "interrupt") {
@@ -290,7 +296,7 @@ export class DeepAgent {
         }
     }
     async *stream(invokeInput) {
-        const { thread_id, decision, decisions, context, promptVars, showToolCalls, ...variables } = invokeInput;
+        const { thread_id, decision, decisions, context, promptVars, showToolCalls, showReasoning, showSubagents, ...variables } = invokeInput;
         const isResume = decision !== undefined || decisions !== undefined;
         this.should_use_output = false;
         const mcpClient = buildMcpClient(this.mcpServer);
@@ -304,6 +310,8 @@ export class DeepAgent {
                     decision,
                     decisions,
                     showToolCalls: showToolCalls === true,
+                    showReasoning: showReasoning === true,
+                    showSubagents: showSubagents === true,
                     mcpTools,
                 });
                 return;
@@ -317,7 +325,7 @@ export class DeepAgent {
             const systemPrompt = this.systemPromptWithMcp(resolvedPrompt);
             const agent = await this.ensureAgent(systemPrompt, mcpTools);
             const config = this.buildConfig(thread_id, context);
-            yield* this.runNativeStream(agent, { messages: humanMessages }, config, showToolCalls === true);
+            yield* this.runNativeStream(agent, { messages: humanMessages }, config, showToolCalls === true, showReasoning === true, showSubagents === true);
         }
         finally {
             this.should_use_output = true;