@delofarag/ai-utils 1.6.0 → 1.7.1

package/dist/heart/tools/ToolRegistry.js

@@ -1,5 +1,5 @@
 import { DynamicStructuredTool } from "@langchain/core/tools";
-import { z } from "zod/v3";
+import { z } from "zod/v4";
 export class ToolRegistry {
     tools;
     constructor(tools) {
@@ -14,8 +14,7 @@ export class ToolRegistry {
             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;
+            throw new Error(`unter ${name} wurde kein Tool gefunden`);
         }
         return tools[0];
     }

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

@@ -1 +1 @@
-{"version":3,"file":"ToolRegistry.js","sourceRoot":"","sources":["../../../src/heart/tools/ToolRegistry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ToolRegistry.js","sourceRoot":"","sources":["../../../src/heart/tools/ToolRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAE7D,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAmB1B,MAAM,OAAO,YAAY;IACb,KAAK,CAAiB;IAC9B,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,CAAqB,CAAA;QACxH,IAAI,IAAI,CAAC,oBAAoB,EAAE,EAAC,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAA;QACxF,CAAC;IACL,CAAC;IAEM,OAAO,CAAC,IAAyB;QACpC,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,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,2BAA2B,CAAC,CAAA;QAC7D,CAAC;QACD,OAAO,KAAK,CAAC,CAAC,CAA6B,CAAA;IAC/C,CAAC;IAEM,QAAQ,CAAC,GAAG,KAA4B;QAC3C,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;AAED,MAAM,CAAC,GAAG,IAAI,YAAY,CAAC;IACvB;QACI,IAAI,EAAC,aAAa;QAClB,WAAW,EAAC,2BAA2B;QACvC,MAAM,EAAC,CAAC,CAAC,MAAM,CAAC;YACZ,IAAI,EAAC,CAAC,CAAC,MAAM,EAAE;SAClB,CAAC;QACF,IAAI,EAAC,KAAK,EAAC,EAAC,IAAI,EAAe,EAAC,EAAE;YAC9B,OAAO,kBAAkB,IAAI,WAAW,CAAA;QAC5C,CAAC;KACJ;IACD;QACI,IAAI,EAAC,UAAU;QACf,WAAW,EAAC,cAAc;QAC1B,MAAM,EAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACnB,IAAI,EAAC,KAAK,IAAE,EAAE;YACV,OAAO,eAAe,IAAI,IAAI,EAAE,CAAC,kBAAkB,EAAE,EAAE,CAAA;QAC3D,CAAC;KACJ;CACJ,CAAC,CAAA;AAEF,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAA"}

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

@@ -1,4 +1,4 @@
-import { z } from "zod/v3";
+import { z } from "zod/v4";
 import { ToolRegistry } from "../ToolRegistry";
 import { ZodiosToolRegistry } from "./ZodiosToolRegistry";
 import { DynamicStructuredTool } from "@langchain/core/tools";

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

@@ -1,5 +1,5 @@
 import { DynamicStructuredTool } from "../../../imports";
-import { z } from 'zod/v3';
+import { z } from "zod/v4";
 /**
  * needs testing!!!
  */

package/dist/helpers/chatbot.d.ts

@@ -1,10 +1,18 @@
-import type { Agent } from "../heart/agent";
-type SessionStreamable = Agent<any>;
+import type { DeepAgentStreamChunkWithTools, DeepAgentUserDecision } from "./deepagent/interruptTypes";
+type SessionStreamable = {
+    stream(input: {
+        input?: string;
+        thread_id: string;
+        decision?: DeepAgentUserDecision;
+        showToolCalls?: true;
+    }): AsyncIterable<DeepAgentStreamChunkWithTools>;
+};
 type SessionProps = {
     streamable: SessionStreamable;
     breakword?: string;
     numberOfMessages?: number;
     id?: string;
+    isDeepAgent?: boolean;
 };
 /**
  * die session funktion für ein streamable, wird hauptsächlich für testing eines agenten verwendet
@@ -14,7 +22,7 @@ type SessionProps = {
  * @param id die id der session
  * @returns void
  */
-export declare function session({ streamable, breakword, numberOfMessages, id }: SessionProps): Promise<void>;
+export declare function session({ streamable, breakword, numberOfMessages, id, isDeepAgent, }: SessionProps): Promise<void>;
 type StreamResponseInit = ResponseInit & {
     encoder?: TextEncoder;
 };

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

@@ -1 +1 @@
-{"version":3,"file":"chatbot.d.ts","sourceRoot":"","sources":["../../src/helpers/chatbot.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAE3C,KAAK,iBAAiB,GAAG,KAAK,CAAC,GAAG,CAAC,CAAA;AAEnC,KAAK,YAAY,GAAG;IAChB,UAAU,EAAE,iBAAiB,CAAA;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,EAAE,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED;;;;;;;GAOG;AACH,wBAAsB,OAAO,CAAC,EAC1B,UAAU,EACV,SAAkB,EAClB,gBAA2C,EAC3C,EAAoB,EACvB,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA6B9B;AAED,KAAK,kBAAkB,GAAG,YAAY,GAAG;IACrC,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB,CAAC;AAEJ;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC5B,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,IAAI,GAAE,kBAAuB,GAC5B,QAAQ,CA4BV"}
+{"version":3,"file":"chatbot.d.ts","sourceRoot":"","sources":["../../src/helpers/chatbot.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,6BAA6B,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAEtG,KAAK,iBAAiB,GAAG;IACrB,MAAM,CAAC,KAAK,EAAE;QACV,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,SAAS,EAAE,MAAM,CAAA;QACjB,QAAQ,CAAC,EAAE,qBAAqB,CAAA;QAChC,aAAa,CAAC,EAAE,IAAI,CAAA;KACvB,GAAG,aAAa,CAAC,6BAA6B,CAAC,CAAA;CACnD,CAAA;AAED,KAAK,YAAY,GAAG;IAChB,UAAU,EAAE,iBAAiB,CAAA;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,WAAW,CAAC,EAAE,OAAO,CAAA;CACxB,CAAA;AAuBD;;;;;;;GAOG;AACH,wBAAsB,OAAO,CAAC,EAC1B,UAAU,EACV,SAAkB,EAClB,gBAA2C,EAC3C,EAAoB,EACpB,WAAmB,GACtB,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAqD9B;AAED,KAAK,kBAAkB,GAAG,YAAY,GAAG;IACrC,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB,CAAC;AAEJ;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC5B,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,IAAI,GAAE,kBAAuB,GAC5B,QAAQ,CA4BV"}

package/dist/helpers/chatbot.js

@@ -1,5 +1,23 @@
 import { input } from "@delofarag/base-utils/server";
 import { logChunk } from "./helpers";
+import { isInterrupt } from "../client/index";
+function parseDeepAgentDecision(message) {
+    const normalized = message.trim().toLowerCase();
+    if (!normalized)
+        return undefined;
+    if (normalized.startsWith("reject:")) {
+        return { type: "reject", message: message.slice("reject:".length).trim() };
+    }
+    const approveWords = ["approve", "approved", "aprove", "yes", "y", "ja", "ok", "okay"];
+    if (approveWords.includes(normalized) || normalized.includes("darf") || normalized.includes("klar")) {
+        return "approve";
+    }
+    const rejectWords = ["reject", "rejected", "no", "n", "nein"];
+    if (rejectWords.includes(normalized)) {
+        return "reject";
+    }
+    return undefined;
+}
 /**
  * die session funktion für ein streamable, wird hauptsächlich für testing eines agenten verwendet
  * @param streamable das streamable welches die session führt
@@ -8,21 +26,42 @@ import { logChunk } from "./helpers";
  * @param id die id der session
  * @returns void
  */
-export async function session({ streamable, breakword = "exit", numberOfMessages = Number.POSITIVE_INFINITY, id = `${Date.now()}` }) {
+export async function session({ streamable, breakword = "exit", numberOfMessages = Number.POSITIVE_INFINITY, id = `${Date.now()}`, isDeepAgent = false, }) {
     let messages = 0;
+    let pendingInterrupt = false;
     while (true) {
         try {
             const message = await input("You: ");
             if (message === breakword) {
                 break;
             }
-            const response = streamable.stream({
-                input: message,
-                thread_id: id
-            });
+            const deepAgentStreamOpts = isDeepAgent ? { showToolCalls: true } : {};
+            const decision = pendingInterrupt && isDeepAgent
+                ? parseDeepAgentDecision(message)
+                : undefined;
+            if (pendingInterrupt && isDeepAgent && !decision) {
+                console.log("Pending interrupt. Bitte antworte mit approve oder reject.");
+                continue;
+            }
+            const streamInput = decision !== undefined
+                ? {
+                    thread_id: id,
+                    decision,
+                    ...deepAgentStreamOpts,
+                }
+                : {
+                    input: message,
+                    thread_id: id,
+                    ...deepAgentStreamOpts,
+                };
+            pendingInterrupt = false;
+            const response = streamable.stream(streamInput);
             console.log("Assistant: ");
             for await (const chunk of response) {
                 logChunk(chunk);
+                if (isDeepAgent && isInterrupt(chunk)) {
+                    pendingInterrupt = true;
+                }
             }
             console.log("");
         }

package/dist/helpers/chatbot.js.map

@@ -1 +1 @@
-{"version":3,"file":"chatbot.js","sourceRoot":"","sources":["../../src/helpers/chatbot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAA;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAYpC;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,EAC1B,UAAU,EACV,SAAS,GAAG,MAAM,EAClB,gBAAgB,GAAG,MAAM,CAAC,iBAAiB,EAC3C,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,EACT;IACX,IAAI,QAAQ,GAAG,CAAC,CAAA;IAEhB,OAAO,IAAI,EAAE,CAAC;QACV,IAAI,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,CAAA;YACpC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBACxB,MAAK;YACT,CAAC;YAED,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC;gBAC/B,KAAK,EAAE,OAAO;gBACd,SAAS,EAAE,EAAE;aAChB,CAAC,CAAA;YACF,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;YAC1B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;gBACjC,QAAQ,CAAC,KAAK,CAAC,CAAA;YACnB,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACnB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAA;QAC/B,CAAC;QAED,QAAQ,GAAG,QAAQ,GAAG,CAAC,CAAA;QACvB,IAAI,QAAQ,GAAG,gBAAgB,EAAE,CAAC;YAC9B,OAAO,CAAC,GAAG,CAAC,oBAAoB,gBAAgB,4BAA4B,CAAC,CAAA;YAC7E,MAAK;QACT,CAAC;IACL,CAAC;AACL,CAAC;AAMD;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAC1B,QAA0B,EAC1B,OAA2B,EAAE;IAE7B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,WAAW,EAAE,CAAC;IAElD,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,YAAY,EAAE,GAAG,IAAI,CAAC;IAE7D,MAAM,MAAM,GAAG,IAAI,cAAc,CAAa;QAC5C,KAAK,CAAC,KAAK,CAAC,UAAU;YACpB,IAAI,CAAC;gBACH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;oBACnC,UAAU,CAAC,OAAO,CAChB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAC7C,CAAC;gBACJ,CAAC;gBAED,UAAU,CAAC,KAAK,EAAE,CAAC;YACrB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,IAAI,QAAQ,CAAC,MAAM,EAAE;QAC1B,GAAG,YAAY;QACf,OAAO,EAAE;YACP,cAAc,EAAE,sBAAsB;YACtC,GAAG,OAAO;SACX;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"chatbot.js","sourceRoot":"","sources":["../../src/helpers/chatbot.ts"],"names":[],"mappings":"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"}

package/dist/helpers/deepagent/backend.d.ts

@@ -0,0 +1,92 @@
+import { StateBackend, FilesystemBackend, CompositeBackend, type CreateDeepAgentParams, type LocalShellBackendOptions } from "../../imports";
+import type { ExecuteCapableDeepAgentBackend } from "./interruptOn";
+/** Native deepagents-Backend — Instanz oder Factory, kein Promise. */
+export type DeepAgentBackend = NonNullable<CreateDeepAgentParams["backend"]>;
+type Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+export type CreateLocalShellBackendOptions = Prettify<Omit<LocalShellBackendOptions, "rootDir"> & {
+    route?: string;
+    rootDir: string;
+}>;
+/**
+ * erstellt einfach den StateBackend von langchain
+ * @example
+ * export function createStateBackend() {
+    return new StateBackend()
+}
+ */
+export declare function createStateBackend(): StateBackend;
+/**
+ * erstellt ein reines Filesystembackend, nimm lieber 'createWorkspaceBackend()'
+ * @example
+ * export function createFilesystemBackend({
+    rootDir = process.cwd(),
+    virtualMode = true,
+    maxFileSizeMb,
+}: {
+    rootDir?: string
+    virtualMode?: boolean
+    maxFileSizeMb?: number
+} = {}): FilesystemBackend {
+    return new FilesystemBackend({ rootDir, virtualMode, maxFileSizeMb })
+}
+ */
+export declare function createFilesystemBackend({ rootDir, virtualMode, maxFileSizeMb, }?: {
+    rootDir?: string;
+    virtualMode?: boolean;
+    maxFileSizeMb?: number;
+}): FilesystemBackend;
+/**
+ * erstellt ein Filesystembackend mit einem normalem Statebackend damit dein workspace nicht beschmutzt wird
+ * @example
+ * export function createWorkspaceBackend({
+    rootDir = process.cwd(),
+    route = "/workspace/",
+    virtualMode = true,
+}: {
+    rootDir?: string
+    route?: string
+    virtualMode?: boolean
+} = {}): FilesystemBackend {
+    const normalizedRoute = route.endsWith("/") ? route : `${route}/`
+    return new CompositeBackend(
+        new StateBackend(),
+        {
+            [normalizedRoute]: new FilesystemBackend({ rootDir, virtualMode }),
+        }
+    )
+}
+ */
+export declare function createWorkspaceBackend({ rootDir, virtualMode, route, }: {
+    rootDir: string;
+    route?: string;
+    virtualMode?: boolean;
+}): CompositeBackend;
+/**
+ * LocalShell unter route (default /workspace/) + StateBackend für interne Agent-Dateien.
+ * execute() läuft weiter auf dem Host — nur für Dev.
+ * @example
+ * export async function createLocalShellBackend({
+    rootDir,
+    route = "/workspace/",
+    virtualMode = true,
+    ...options
+}: CreateLocalShellBackendOptions) {
+    const normalizedRoute = route.endsWith("/") ? route : `${route}/`
+    const shellBackend = await LocalShellBackend.create({
+        rootDir,
+        virtualMode,
+        ...options,
+    })
+    return new CompositeBackend(
+        new StateBackend(),
+        {
+            [normalizedRoute]: shellBackend,
+        }
+    )
+}
+ */
+export declare function createLocalShellBackend({ rootDir, route, virtualMode, ...options }: CreateLocalShellBackendOptions): Promise<CompositeBackend & ExecuteCapableDeepAgentBackend>;
+export {};
+//# sourceMappingURL=backend.d.ts.map

package/dist/helpers/deepagent/backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../../src/helpers/deepagent/backend.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,YAAY,EACZ,iBAAiB,EAEjB,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAChC,MAAM,eAAe,CAAA;AACtB,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,eAAe,CAAA;AAEnE,sEAAsE;AACtE,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAAA;AAE5E,KAAK,QAAQ,CAAC,CAAC,IAAI;KACd,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CACvB,GAAG,EAAE,CAAA;AAEN,MAAM,MAAM,8BAA8B,GAAG,QAAQ,CACjD,IAAI,CAAC,wBAAwB,EAAE,SAAS,CAAC,GAAG;IACxC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAClB,CACJ,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CAEjD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CAAC,EACpC,OAAuB,EACvB,WAAkB,EAClB,aAAa,GAChB,GAAE;IACC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,CAAA;CACpB,GAAG,iBAAiB,CAEzB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,sBAAsB,CAAC,EACnC,OAAO,EACP,WAAkB,EAClB,KAAqB,GACxB,EAAE;IACC,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,OAAO,CAAA;CACxB,GAAG,gBAAgB,CAQnB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,uBAAuB,CAAC,EAC1C,OAAO,EACP,KAAqB,EACrB,WAAkB,EAClB,GAAG,OAAO,EACb,EAAE,8BAA8B,GAAG,OAAO,CAAC,gBAAgB,GAAG,8BAA8B,CAAC,CAc7F"}

package/dist/helpers/deepagent/backend.js

@@ -0,0 +1,93 @@
+import { StateBackend, FilesystemBackend, LocalShellBackend, CompositeBackend, } from "../../imports";
+/**
+ * erstellt einfach den StateBackend von langchain
+ * @example
+ * export function createStateBackend() {
+    return new StateBackend()
+}
+ */
+export function createStateBackend() {
+    return new StateBackend();
+}
+/**
+ * erstellt ein reines Filesystembackend, nimm lieber 'createWorkspaceBackend()'
+ * @example
+ * export function createFilesystemBackend({
+    rootDir = process.cwd(),
+    virtualMode = true,
+    maxFileSizeMb,
+}: {
+    rootDir?: string
+    virtualMode?: boolean
+    maxFileSizeMb?: number
+} = {}): FilesystemBackend {
+    return new FilesystemBackend({ rootDir, virtualMode, maxFileSizeMb })
+}
+ */
+export function createFilesystemBackend({ rootDir = process.cwd(), virtualMode = true, maxFileSizeMb, } = {}) {
+    return new FilesystemBackend({ rootDir, virtualMode, maxFileSizeMb });
+}
+/**
+ * erstellt ein Filesystembackend mit einem normalem Statebackend damit dein workspace nicht beschmutzt wird
+ * @example
+ * export function createWorkspaceBackend({
+    rootDir = process.cwd(),
+    route = "/workspace/",
+    virtualMode = true,
+}: {
+    rootDir?: string
+    route?: string
+    virtualMode?: boolean
+} = {}): FilesystemBackend {
+    const normalizedRoute = route.endsWith("/") ? route : `${route}/`
+    return new CompositeBackend(
+        new StateBackend(),
+        {
+            [normalizedRoute]: new FilesystemBackend({ rootDir, virtualMode }),
+        }
+    )
+}
+ */
+export function createWorkspaceBackend({ rootDir, virtualMode = true, route = "/workspace/", }) {
+    const normalizedRoute = route.endsWith("/") ? route : `${route}/`;
+    return new CompositeBackend(new StateBackend(), {
+        [normalizedRoute]: new FilesystemBackend({ rootDir, virtualMode }),
+    });
+}
+/**
+ * LocalShell unter route (default /workspace/) + StateBackend für interne Agent-Dateien.
+ * execute() läuft weiter auf dem Host — nur für Dev.
+ * @example
+ * export async function createLocalShellBackend({
+    rootDir,
+    route = "/workspace/",
+    virtualMode = true,
+    ...options
+}: CreateLocalShellBackendOptions) {
+    const normalizedRoute = route.endsWith("/") ? route : `${route}/`
+    const shellBackend = await LocalShellBackend.create({
+        rootDir,
+        virtualMode,
+        ...options,
+    })
+    return new CompositeBackend(
+        new StateBackend(),
+        {
+            [normalizedRoute]: shellBackend,
+        }
+    )
+}
+ */
+export async function createLocalShellBackend({ rootDir, route = "/workspace/", virtualMode = true, ...options }) {
+    const normalizedRoute = route.endsWith("/") ? route : `${route}/`;
+    const shellBackend = await LocalShellBackend.create({
+        rootDir,
+        virtualMode,
+        ...options,
+    });
+    const backend = new CompositeBackend(new StateBackend(), {
+        [normalizedRoute]: shellBackend,
+    });
+    return Object.assign(backend, { __deepAgentExecute: true });
+}
+//# sourceMappingURL=backend.js.map

package/dist/helpers/deepagent/backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.js","sourceRoot":"","sources":["../../../src/helpers/deepagent/backend.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,GAGnB,MAAM,eAAe,CAAA;AAiBtB;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB;IAC9B,OAAO,IAAI,YAAY,EAAE,CAAA;AAC7B,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,uBAAuB,CAAC,EACpC,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,EACvB,WAAW,GAAG,IAAI,EAClB,aAAa,MAKb,EAAE;IACF,OAAO,IAAI,iBAAiB,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC,CAAA;AACzE,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,sBAAsB,CAAC,EACnC,OAAO,EACP,WAAW,GAAG,IAAI,EAClB,KAAK,GAAG,aAAa,GAKxB;IACG,MAAM,eAAe,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAA;IACjE,OAAO,IAAI,gBAAgB,CACvB,IAAI,YAAY,EAAE,EAClB;QACI,CAAC,eAAe,CAAC,EAAE,IAAI,iBAAiB,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;KACrE,CACJ,CAAA;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,EAC1C,OAAO,EACP,KAAK,GAAG,aAAa,EACrB,WAAW,GAAG,IAAI,EAClB,GAAG,OAAO,EACmB;IAC7B,MAAM,eAAe,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAA;IACjE,MAAM,YAAY,GAAG,MAAM,iBAAiB,CAAC,MAAM,CAAC;QAChD,OAAO;QACP,WAAW;QACX,GAAG,OAAO;KACb,CAAC,CAAA;IACF,MAAM,OAAO,GAAG,IAAI,gBAAgB,CAChC,IAAI,YAAY,EAAE,EAClB;QACI,CAAC,eAAe,CAAC,EAAE,YAAY;KAClC,CACJ,CAAA;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,kBAAkB,EAAE,IAAa,EAAE,CAAC,CAAA;AACxE,CAAC"}

package/dist/helpers/deepagent/interruptOn.d.ts

@@ -0,0 +1,93 @@
+import { Command, type HITLRequest, type HITLResponse, type HitlUserDecision } from "../../imports";
+import type { CreateDeepAgentParams, DynamicStructuredTool } from "../../imports";
+import type { LocalShellBackend } from "deepagents";
+import type { DenoSandbox } from "@langchain/deno";
+import type { DaytonaSandbox } from "@langchain/daytona";
+import type { DeepAgentInterrupt, DeepAgentInterruptConfig, DeepAgentUserDecision } from "./interruptTypes";
+export type { DeepAgentAllowedDecision, DeepAgentInterrupt, DeepAgentInterruptSingle, DeepAgentInterruptBatch, DeepAgentStreamChunk, DeepAgentUserDecision, DeepAgentRunInputBase, DeepAgentHitlFields, DeepAgentInterruptConfig, DeepAgentInterruptToolCall, DeepAgentInterruptQuestion, } from "./interruptTypes";
+/** Immer verfügbare Filesystem-Tools von DeepAgents (Middleware). */
+export declare const DEEP_AGENT_FILESYSTEM_TOOLS: readonly ["ls", "read_file", "write_file", "edit_file", "glob", "grep"];
+/** Shell-Tool — nur wenn Backend `execute()` unterstützt (LocalShell, Deno, Daytona). */
+export declare const DEEP_AGENT_EXECUTE_TOOL: "execute";
+export type DeepAgentFilesystemTool = (typeof DEEP_AGENT_FILESYSTEM_TOOLS)[number];
+export type DeepAgentExecuteTool = typeof DEEP_AGENT_EXECUTE_TOOL;
+type ExecuteCapableBackend = LocalShellBackend | DenoSandbox | DaytonaSandbox;
+/** Von `createLocalShellBackend()` etc. — aktiviert `execute` im interruptOn-Autocomplete. */
+export type ExecuteCapableDeepAgentBackend = {
+    readonly __deepAgentExecute?: true;
+};
+/** Runtime: `execute` nur bei Shell/Sandbox-Backend — nicht bei `createWorkspaceBackend()` / Composite+StateBackend. */
+export type BackendSupportsExecute<TBackend> = TBackend extends ExecuteCapableBackend | ExecuteCapableDeepAgentBackend ? true : false;
+type LiteralToolName<TName extends string> = string extends TName ? never : TName;
+export type ToolNamesOf<TTools extends readonly {
+    name: string;
+}[]> = {
+    [K in keyof TTools]: TTools[K] extends {
+        name: infer TName extends string;
+    } ? LiteralToolName<TName> : never;
+}[number];
+/** Alle Tool-Namen die der Agent haben kann — Keys für `interruptOn`. */
+export type DeepAgentInterruptableToolName<TTools extends readonly {
+    name: string;
+}[] = readonly [], TBackend = unknown> = DeepAgentFilesystemTool | ToolNamesOf<TTools> | (BackendSupportsExecute<TBackend> extends true ? DeepAgentExecuteTool : never);
+export type InterruptOnFor<TToolName extends string> = {
+    [K in TToolName]?: DeepAgentInterruptConfig;
+};
+/** Untyped fallback — prefer `InterruptOnFor<DeepAgentInterruptableToolName<...>>` via DeepAgent generics. */
+export type InterruptOn = InterruptOnFor<string>;
+/**
+ * Human-in-the-Loop (`interruptOn`-Prop) — pausiert den Agent **vor** Tool-Ausführung.
+ *
+ * Keys = Tool-Namen die der Agent hat (Autocomplete via DeepAgent-Generics):
+ * - immer: `ls`, `read_file`, `write_file`, `edit_file`, `glob`, `grep`
+ * - plus deine `tools: []` (`.name`, z.B. aus ToolRegistry)
+ * - plus `execute` nur bei Shell/Sandbox-Backend (LocalShell, Deno, Daytona)
+ *
+ * Tools die **nicht** im Objekt stehen, laufen ohne Pause.
+ *
+ * @example
+ * new DeepAgent({
+ *     tools: [pingTool] as const,
+ *     checkpointer: new MemorySaver(),
+ *     interruptOn: {
+ *         ping: {
+ *             decisions: ["approve", "reject"],
+ *             question: "Ping ausführen?",
+ *         },
+ *         write_file: {
+ *             decisions: ["approve", "edit", "reject"],
+ *             question: (call) =>
+ *                 `Datei schreiben?\n\nPfad: ${call.args.path ?? "?"}`,
+ *         },
+ *     },
+ * })
+ *
+ * `question` als Function: wird von LangGraph **vor** der Pause mit dem
+ * geplanten Tool-Call aufgerufen — `call.name` + `call.args`.
+ */
+export declare function mapInterruptOnToNative(interruptOn: InterruptOnFor<string> | undefined): NonNullable<CreateDeepAgentParams["interruptOn"]> | undefined;
+export type InferInterruptOn<TTools extends readonly DynamicStructuredTool[] = readonly DynamicStructuredTool[], TBackend = unknown> = InterruptOnFor<DeepAgentInterruptableToolName<TTools, TBackend>>;
+type InterruptResult = {
+    __interrupt__?: Array<{
+        value: HITLRequest;
+    }>;
+};
+/**
+ * Prüft ob ein Agent-Result pausiert hat (Human-in-the-Loop).
+ */
+export declare function isInterruptResult(result: unknown): result is InterruptResult & {
+    __interrupt__: NonNullable<InterruptResult["__interrupt__"]>;
+};
+export declare function getHitlRequest(result: InterruptResult): HITLRequest | undefined;
+export declare function approveDecision(): HitlUserDecision;
+export declare function rejectDecision(message?: string): HitlUserDecision;
+export declare function editDecision(name: string, args: Record<string, unknown>): HitlUserDecision;
+export declare function approveAll(count: number): HITLResponse;
+export declare function createResumeCommand(decisions: HitlUserDecision[] | HITLResponse): Command;
+export declare function mapHitlToInterrupt(hitl: HITLRequest): DeepAgentInterrupt;
+export declare function mapResultToInterrupt(result: unknown): DeepAgentInterrupt | undefined;
+export declare function userDecisionToHitl(decision: DeepAgentUserDecision, toolName?: string): HitlUserDecision;
+export declare function expandResumeDecisions(decision: DeepAgentUserDecision | undefined, decisions: DeepAgentUserDecision[] | undefined, pendingCount: number, defaultToolName?: string): HitlUserDecision[];
+export declare function getPendingInterruptCount(agent: any, config: Record<string, unknown> | undefined): Promise<number>;
+export declare function extractInterruptFromStreamUpdate(data: unknown): DeepAgentInterrupt | undefined;
+//# sourceMappingURL=interruptOn.d.ts.map

package/dist/helpers/deepagent/interruptOn.d.ts.map

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

package/dist/helpers/deepagent/interruptOn.js

@@ -0,0 +1,190 @@
+import { Command } from "../../imports";
+/** Immer verfügbare Filesystem-Tools von DeepAgents (Middleware). */
+export const DEEP_AGENT_FILESYSTEM_TOOLS = [
+    "ls",
+    "read_file",
+    "write_file",
+    "edit_file",
+    "glob",
+    "grep",
+];
+/** Shell-Tool — nur wenn Backend `execute()` unterstützt (LocalShell, Deno, Daytona). */
+export const DEEP_AGENT_EXECUTE_TOOL = "execute";
+/**
+ * Human-in-the-Loop (`interruptOn`-Prop) — pausiert den Agent **vor** Tool-Ausführung.
+ *
+ * Keys = Tool-Namen die der Agent hat (Autocomplete via DeepAgent-Generics):
+ * - immer: `ls`, `read_file`, `write_file`, `edit_file`, `glob`, `grep`
+ * - plus deine `tools: []` (`.name`, z.B. aus ToolRegistry)
+ * - plus `execute` nur bei Shell/Sandbox-Backend (LocalShell, Deno, Daytona)
+ *
+ * Tools die **nicht** im Objekt stehen, laufen ohne Pause.
+ *
+ * @example
+ * new DeepAgent({
+ *     tools: [pingTool] as const,
+ *     checkpointer: new MemorySaver(),
+ *     interruptOn: {
+ *         ping: {
+ *             decisions: ["approve", "reject"],
+ *             question: "Ping ausführen?",
+ *         },
+ *         write_file: {
+ *             decisions: ["approve", "edit", "reject"],
+ *             question: (call) =>
+ *                 `Datei schreiben?\n\nPfad: ${call.args.path ?? "?"}`,
+ *         },
+ *     },
+ * })
+ *
+ * `question` als Function: wird von LangGraph **vor** der Pause mit dem
+ * geplanten Tool-Call aufgerufen — `call.name` + `call.args`.
+ */
+export function mapInterruptOnToNative(interruptOn) {
+    if (!interruptOn)
+        return undefined;
+    return Object.fromEntries(Object.entries(interruptOn)
+        .filter((entry) => entry[1] !== undefined)
+        .map(([tool, config]) => [
+        tool,
+        {
+            allowedDecisions: config.decisions,
+            description: config.question,
+        },
+    ]));
+}
+/**
+ * Prüft ob ein Agent-Result pausiert hat (Human-in-the-Loop).
+ */
+export function isInterruptResult(result) {
+    return (typeof result === "object"
+        && result !== null
+        && "__interrupt__" in result
+        && Array.isArray(result.__interrupt__)
+        && (result.__interrupt__?.length ?? 0) > 0);
+}
+export function getHitlRequest(result) {
+    return result.__interrupt__?.[0]?.value;
+}
+export function approveDecision() {
+    return { type: "approve" };
+}
+export function rejectDecision(message) {
+    return message ? { type: "reject", message } : { type: "reject" };
+}
+export function editDecision(name, args) {
+    return { type: "edit", editedAction: { name, args } };
+}
+export function approveAll(count) {
+    return {
+        decisions: Array.from({ length: count }, () => approveDecision()),
+    };
+}
+export function createResumeCommand(decisions) {
+    const resume = Array.isArray(decisions)
+        ? { decisions }
+        : decisions;
+    return new Command({ resume });
+}
+export function mapHitlToInterrupt(hitl) {
+    const requests = hitl.actionRequests ?? [];
+    const reviews = hitl.reviewConfigs ?? [];
+    if (requests.length <= 1) {
+        const action = requests[0];
+        const review = reviews[0];
+        return {
+            kind: "interrupt",
+            question: action?.description ?? `Tool: ${action?.name ?? "unknown"}`,
+            decisions: (review?.allowedDecisions ?? ["approve", "reject"]),
+            ...(action?.name ? { toolName: action.name } : {}),
+            ...(action?.args ? { args: action.args } : {}),
+        };
+    }
+    return {
+        kind: "interrupt",
+        items: requests.map((action, i) => ({
+            question: action.description ?? `Tool: ${action.name}`,
+            decisions: (reviews[i]?.allowedDecisions ?? ["approve", "reject"]),
+            toolName: action.name,
+            args: (action.args ?? {}),
+        })),
+    };
+}
+export function mapResultToInterrupt(result) {
+    if (!isInterruptResult(result))
+        return undefined;
+    const hitl = getHitlRequest(result);
+    if (!hitl)
+        return undefined;
+    return mapHitlToInterrupt(hitl);
+}
+export function userDecisionToHitl(decision, toolName) {
+    if (decision === "approve")
+        return approveDecision();
+    if (decision === "reject")
+        return rejectDecision();
+    if (decision.type === "reject")
+        return rejectDecision(decision.message);
+    if (!toolName) {
+        throw new Error("toolName is required for edit decisions");
+    }
+    return editDecision(toolName, decision.args);
+}
+export function expandResumeDecisions(decision, decisions, pendingCount, defaultToolName) {
+    if (decisions) {
+        if (decisions.length !== pendingCount) {
+            throw new Error(`Expected ${pendingCount} decisions, got ${decisions.length}`);
+        }
+        return decisions.map((d) => userDecisionToHitl(d, defaultToolName));
+    }
+    const single = decision ?? "approve";
+    return Array.from({ length: pendingCount }, () => userDecisionToHitl(single, defaultToolName));
+}
+export async function getPendingInterruptCount(agent, config) {
+    if (!agent?.getState || !config)
+        return 1;
+    try {
+        const state = await agent.getState(config);
+        const tasks = state?.tasks ?? [];
+        for (const task of tasks) {
+            const interrupts = task?.interrupts ?? [];
+            if (interrupts.length > 0) {
+                const value = interrupts[0]?.value ?? interrupts[0];
+                if (value?.actionRequests?.length)
+                    return value.actionRequests.length;
+            }
+        }
+        const values = state?.values;
+        if (values?.__interrupt__?.length) {
+            const hitl = values.__interrupt__[0]?.value;
+            if (hitl?.actionRequests?.length)
+                return hitl.actionRequests.length;
+        }
+    }
+    catch {
+        return 1;
+    }
+    return 1;
+}
+export function extractInterruptFromStreamUpdate(data) {
+    if (!data || typeof data !== "object")
+        return undefined;
+    const record = data;
+    if ("__interrupt__" in record && Array.isArray(record.__interrupt__)) {
+        const hitl = record.__interrupt__[0]?.value;
+        if (hitl)
+            return mapHitlToInterrupt(hitl);
+    }
+    for (const value of Object.values(record)) {
+        if (!value || typeof value !== "object")
+            continue;
+        const nested = value;
+        if ("__interrupt__" in nested && Array.isArray(nested.__interrupt__)) {
+            const hitl = nested.__interrupt__[0]?.value;
+            if (hitl)
+                return mapHitlToInterrupt(hitl);
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=interruptOn.js.map