@delofarag/ai-utils 1.6.0 → 1.7.0

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

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

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

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

@@ -0,0 +1,65 @@
+import type { InvokeInputBase } from "../../heart/chain";
+export type DeepAgentAllowedDecision = "approve" | "edit" | "reject";
+export type DeepAgentInterruptSingle = {
+    kind: "interrupt";
+    question: string;
+    decisions: DeepAgentAllowedDecision[];
+    toolName?: string;
+    args?: Record<string, unknown>;
+};
+export type DeepAgentInterruptBatch = {
+    kind: "interrupt";
+    items: Array<{
+        question: string;
+        decisions: DeepAgentAllowedDecision[];
+        toolName: string;
+        args: Record<string, unknown>;
+    }>;
+};
+export type DeepAgentInterrupt = DeepAgentInterruptSingle | DeepAgentInterruptBatch;
+export type DeepAgentToolEvent = {
+    kind: "tool";
+    phase: "start";
+    toolName: string;
+    args?: Record<string, unknown>;
+} | {
+    kind: "tool";
+    phase: "end";
+    toolName: string;
+    output?: string;
+};
+export type DeepAgentStreamChunk = string | DeepAgentInterrupt;
+export type DeepAgentStreamChunkWithTools = DeepAgentStreamChunk | DeepAgentToolEvent;
+export type DeepAgentUserDecision = "approve" | "reject" | {
+    type: "reject";
+    message: string;
+} | {
+    type: "edit";
+    args: Record<string, unknown>;
+};
+/** Basis-Input für invoke/stream — immer (mit/ohne interruptOn). */
+export type DeepAgentRunInputBase = InvokeInputBase & {
+    thread_id?: string;
+    context?: Record<string, unknown>;
+};
+/** HITL-Felder — nur im Typ wenn interruptOn konfiguriert. */
+export type DeepAgentHitlFields = {
+    decision?: DeepAgentUserDecision;
+    decisions?: DeepAgentUserDecision[];
+};
+/** stream()-only — Return-Typ enthält dann DeepAgentToolEvent. */
+export type DeepAgentShowToolCallsField = {
+    showToolCalls: true;
+};
+/** Tool-Call der an `question`-Functions übergeben wird (vor der Pause). */
+export type DeepAgentInterruptToolCall = {
+    name: string;
+    args: Record<string, unknown>;
+};
+export type DeepAgentInterruptQuestion = string | ((toolCall: DeepAgentInterruptToolCall) => string | Promise<string>);
+/** User-Config pro Tool für `interruptOn` auf DeepAgent. */
+export type DeepAgentInterruptConfig = {
+    decisions: DeepAgentAllowedDecision[];
+    question: DeepAgentInterruptQuestion;
+};
+//# sourceMappingURL=interruptTypes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interruptTypes.d.ts","sourceRoot":"","sources":["../../../src/helpers/deepagent/interruptTypes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAExD,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAA;AAEpE,MAAM,MAAM,wBAAwB,GAAG;IACnC,IAAI,EAAE,WAAW,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,wBAAwB,EAAE,CAAA;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IAClC,IAAI,EAAE,WAAW,CAAA;IACjB,KAAK,EAAE,KAAK,CAAC;QACT,QAAQ,EAAE,MAAM,CAAA;QAChB,SAAS,EAAE,wBAAwB,EAAE,CAAA;QACrC,QAAQ,EAAE,MAAM,CAAA;QAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAChC,CAAC,CAAA;CACL,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG,wBAAwB,GAAG,uBAAuB,CAAA;AAEnF,MAAM,MAAM,kBAAkB,GACxB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAClF;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAEvE,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,kBAAkB,CAAA;AAE9D,MAAM,MAAM,6BAA6B,GAAG,oBAAoB,GAAG,kBAAkB,CAAA;AAErF,MAAM,MAAM,qBAAqB,GAC3B,SAAS,GACT,QAAQ,GACR;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAA;AAErD,oEAAoE;AACpE,MAAM,MAAM,qBAAqB,GAAG,eAAe,GAAG;IAClD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACpC,CAAA;AAED,8DAA8D;AAC9D,MAAM,MAAM,mBAAmB,GAAG;IAC9B,QAAQ,CAAC,EAAE,qBAAqB,CAAA;IAChC,SAAS,CAAC,EAAE,qBAAqB,EAAE,CAAA;CACtC,CAAA;AAED,kEAAkE;AAClE,MAAM,MAAM,2BAA2B,GAAG;IACtC,aAAa,EAAE,IAAI,CAAA;CACtB,CAAA;AAED,4EAA4E;AAC5E,MAAM,MAAM,0BAA0B,GAAG;IACrC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,0BAA0B,GAChC,MAAM,GACN,CAAC,CAAC,QAAQ,EAAE,0BAA0B,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;AAE1E,4DAA4D;AAC5D,MAAM,MAAM,wBAAwB,GAAG;IACnC,SAAS,EAAE,wBAAwB,EAAE,CAAA;IACrC,QAAQ,EAAE,0BAA0B,CAAA;CACvC,CAAA"}

package/dist/helpers/deepagent/interruptTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=interruptTypes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interruptTypes.js","sourceRoot":"","sources":["../../../src/helpers/deepagent/interruptTypes.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,58 @@
+import type { FilesystemPermission } from "../../imports";
+/**
+ * Statische Filesystem-Regeln für DeepAgent (`permissions`-Prop).
+ *
+ * Das ist **kein** `interruptOn` — kein User-Dialog, keine Pause.
+ * Regeln gelten nur für Filesystem-Tools: `ls`, `read_file`, `write_file`,
+ * `edit_file`, `glob`, `grep`. Custom-Tools (z.B. `getCandidates`) sind nicht betroffen.
+ *
+ * Auswertung: Regeln in Reihenfolge, erste passende Regel gewinnt.
+ * Kein Match → Zugriff erlaubt (permissive default).
+ *
+ * Pfade: absolute Globs ab `/` (z.B. `/workspace/**`, `/**`).
+ */
+/**
+ * Erlaubt Lesen (`read`) auf den angegebenen Pfad-Globs.
+ * Betrifft: `ls`, `read_file`, `glob`, `grep`.
+ *
+ * @example
+ * allowRead(["/candidates/**", "/workspace/**"])
+ */
+export declare function allowRead(paths: string[]): FilesystemPermission;
+/**
+ * Blockiert Lesen (`read`) auf den angegebenen Pfad-Globs.
+ * Betrifft: `ls`, `read_file`, `glob`, `grep`.
+ *
+ * @example
+ * denyRead(["/secrets/**", "/**"])
+ */
+export declare function denyRead(paths: string[]): FilesystemPermission;
+/**
+ * Erlaubt Schreiben (`write`) auf den angegebenen Pfad-Globs.
+ * Betrifft: `write_file`, `edit_file`.
+ *
+ * @example
+ * allowWrite(["/workspace/**"])
+ */
+export declare function allowWrite(paths: string[]): FilesystemPermission;
+/**
+ * Blockiert Schreiben (`write`) auf den angegebenen Pfad-Globs.
+ * Betrifft: `write_file`, `edit_file`.
+ *
+ * @example
+ * denyWrite(["/**"])
+ */
+export declare function denyWrite(paths: string[]): FilesystemPermission;
+/**
+ * Standard-Preset: lesen + schreiben nur unter `route` (default `/workspace/`),
+ * überall sonst lesen und schreiben verboten.
+ *
+ * Sinnvoll zusammen mit `createWorkspaceBackend()` — Agent darf nur
+ * im Workspace arbeiten, interne State-Pfade bleiben unberührt.
+ *
+ * @example
+ * permissions: workspacePermissions()
+ * permissions: workspacePermissions("/projects/my-app/")
+ */
+export declare function workspacePermissions(route?: string): FilesystemPermission[];
+//# sourceMappingURL=permissions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../../src/helpers/deepagent/permissions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAEzD;;;;;;;;;;;GAWG;AAEH;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,oBAAoB,CAE/D;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,oBAAoB,CAE9D;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,oBAAoB,CAEhE;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,oBAAoB,CAE/D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,SAAgB,GAAG,oBAAoB,EAAE,CAOlF"}