@nodetool-ai/agents 0.7.0-rc.11

package/dist/tools/workspace-tools.js

@@ -0,0 +1,152 @@
+/**
+ * Workspace-scoped file tools — T-AG-1.
+ *
+ * Read, write, and list files relative to a workspace root directory.
+ * All paths are sandboxed to prevent traversal outside the workspace.
+ */
+import { readFile, writeFile, mkdir, readdir, stat, access } from "node:fs/promises";
+import { resolve, join, dirname } from "node:path";
+import { Tool } from "./base-tool.js";
+function resolveSandboxed(workspaceRoot, userPath) {
+    const root = resolve(workspaceRoot);
+    const resolved = resolve(root, userPath);
+    if (!resolved.startsWith(root + "/") && resolved !== root) {
+        throw new Error("Path traversal not allowed");
+    }
+    return resolved;
+}
+export class WorkspaceReadTool extends Tool {
+    name = "workspace_read";
+    description = "Read a file relative to the agent workspace root.";
+    inputSchema = {
+        type: "object",
+        properties: {
+            path: {
+                type: "string",
+                description: "File path relative to workspace"
+            }
+        },
+        required: ["path"]
+    };
+    workspaceRoot;
+    constructor(workspaceRoot) {
+        super();
+        this.workspaceRoot = workspaceRoot;
+    }
+    async process(_context, params) {
+        const rawPath = params.path;
+        if (typeof rawPath !== "string")
+            return { success: false, error: "path must be a string" };
+        let filePath;
+        try {
+            filePath = resolveSandboxed(this.workspaceRoot, rawPath);
+        }
+        catch {
+            return { success: false, error: "Path traversal not allowed" };
+        }
+        try {
+            await access(filePath);
+            const content = await readFile(filePath, "utf-8");
+            return { success: true, path: rawPath, content };
+        }
+        catch {
+            return { success: false, error: `File not found: ${rawPath}` };
+        }
+    }
+}
+export class WorkspaceWriteTool extends Tool {
+    name = "workspace_write";
+    description = "Write a file relative to the agent workspace root.";
+    inputSchema = {
+        type: "object",
+        properties: {
+            path: {
+                type: "string",
+                description: "File path relative to workspace"
+            },
+            content: { type: "string", description: "Content to write" }
+        },
+        required: ["path", "content"]
+    };
+    workspaceRoot;
+    constructor(workspaceRoot) {
+        super();
+        this.workspaceRoot = workspaceRoot;
+    }
+    async process(_context, params) {
+        const rawPath = params.path;
+        const content = params.content;
+        if (typeof rawPath !== "string")
+            return { success: false, error: "path must be a string" };
+        if (typeof content !== "string")
+            return { success: false, error: "content must be a string" };
+        let filePath;
+        try {
+            filePath = resolveSandboxed(this.workspaceRoot, rawPath);
+        }
+        catch {
+            return { success: false, error: "Path traversal not allowed" };
+        }
+        try {
+            await mkdir(dirname(filePath), { recursive: true });
+            await writeFile(filePath, content, "utf-8");
+            return { success: true, path: rawPath };
+        }
+        catch (e) {
+            return {
+                success: false,
+                error: `Failed to write: ${e instanceof Error ? e.message : String(e)}`
+            };
+        }
+    }
+}
+export class WorkspaceListTool extends Tool {
+    name = "workspace_list";
+    description = "List directory contents relative to the agent workspace root.";
+    inputSchema = {
+        type: "object",
+        properties: {
+            path: {
+                type: "string",
+                description: "Directory path relative to workspace"
+            }
+        },
+        required: ["path"]
+    };
+    workspaceRoot;
+    constructor(workspaceRoot) {
+        super();
+        this.workspaceRoot = workspaceRoot;
+    }
+    async process(_context, params) {
+        const rawPath = params.path;
+        if (typeof rawPath !== "string")
+            return { success: false, error: "path must be a string" };
+        let dirPath;
+        try {
+            dirPath = resolveSandboxed(this.workspaceRoot, rawPath);
+        }
+        catch {
+            return { success: false, error: "Path traversal not allowed" };
+        }
+        try {
+            const dirEntries = await readdir(dirPath, { withFileTypes: true });
+            const entries = await Promise.all(dirEntries.map(async (entry) => {
+                let size = 0;
+                try {
+                    const info = await stat(join(dirPath, entry.name));
+                    size = info.size;
+                }
+                catch {
+                    /* ignore */
+                }
+                return { name: entry.name, size, is_dir: entry.isDirectory() };
+            }));
+            return { success: true, entries };
+        }
+        catch {
+            return { success: false, error: `Directory not found: ${rawPath}` };
+        }
+    }
+}
+//# sourceMappingURL=workspace-tools.js.map

package/dist/tools/workspace-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-tools.js","sourceRoot":"","sources":["../../src/tools/workspace-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,QAAQ,EACR,SAAS,EACT,KAAK,EACL,OAAO,EACP,IAAI,EACJ,MAAM,EACP,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAY,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7D,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEtC,SAAS,gBAAgB,CAAC,aAAqB,EAAE,QAAgB;IAC/D,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACzC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,OAAO,iBAAkB,SAAQ,IAAI;IAChC,IAAI,GAAG,gBAAgB,CAAC;IACxB,WAAW,GAAG,mDAAmD,CAAC;IAClE,WAAW,GAAG;QACrB,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAiB;gBACvB,WAAW,EAAE,iCAAiC;aAC/C;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB,CAAC;IAEM,aAAa,CAAS;IAC9B,YAAY,aAAqB;QAC/B,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,OAAO,CACX,QAA2B,EAC3B,MAA+B;QAE/B,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC;QAC5B,IAAI,OAAO,OAAO,KAAK,QAAQ;YAC7B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC;QAE5D,IAAI,QAAgB,CAAC;QACrB,IAAI,CAAC;YACH,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,4BAA4B,EAAE,CAAC;QACjE,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;YACvB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAClD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,OAAO,EAAE,EAAE,CAAC;QACjE,CAAC;IACH,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,IAAI;IACjC,IAAI,GAAG,iBAAiB,CAAC;IACzB,WAAW,GAAG,oDAAoD,CAAC;IACnE,WAAW,GAAG;QACrB,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAiB;gBACvB,WAAW,EAAE,iCAAiC;aAC/C;YACD,OAAO,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,WAAW,EAAE,kBAAkB,EAAE;SACtE;QACD,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;KAC9B,CAAC;IAEM,aAAa,CAAS;IAC9B,YAAY,aAAqB;QAC/B,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,OAAO,CACX,QAA2B,EAC3B,MAA+B;QAE/B,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC;QAC5B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC/B,IAAI,OAAO,OAAO,KAAK,QAAQ;YAC7B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC;QAC5D,IAAI,OAAO,OAAO,KAAK,QAAQ;YAC7B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,0BAA0B,EAAE,CAAC;QAE/D,IAAI,QAAgB,CAAC;QACrB,IAAI,CAAC;YACH,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,4BAA4B,EAAE,CAAC;QACjE,CAAC;QAED,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACpD,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAC1C,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,oBAAoB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;aACxE,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,IAAI;IAChC,IAAI,GAAG,gBAAgB,CAAC;IACxB,WAAW,GAClB,+DAA+D,CAAC;IACzD,WAAW,GAAG;QACrB,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAiB;gBACvB,WAAW,EAAE,sCAAsC;aACpD;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB,CAAC;IAEM,aAAa,CAAS;IAC9B,YAAY,aAAqB;QAC/B,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,OAAO,CACX,QAA2B,EAC3B,MAA+B;QAE/B,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC;QAC5B,IAAI,OAAO,OAAO,KAAK,QAAQ;YAC7B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC;QAE5D,IAAI,OAAe,CAAC;QACpB,IAAI,CAAC;YACH,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QAC1D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,4BAA4B,EAAE,CAAC;QACjE,CAAC;QAED,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YACnE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;gBAC7B,IAAI,IAAI,GAAG,CAAC,CAAC;gBACb,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;oBACnD,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;gBACnB,CAAC;gBAAC,MAAM,CAAC;oBACP,YAAY;gBACd,CAAC;gBACD,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACjE,CAAC,CAAC,CACH,CAAC;YACF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,wBAAwB,OAAO,EAAE,EAAE,CAAC;QACtE,CAAC;IACH,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Core type definitions for the agent system.
+ */
+/**
+ * Agent execution mode:
+ * - "loop": Simple iterative LLM + tool calling loop (like SimpleAgent)
+ * - "plan": LLM creates a task plan, then executes steps (like Agent)
+ * - "multi-agent": Multiple sub-agents running in parallel (like TeamExecutor)
+ */
+export type AgentMode = "loop" | "plan" | "multi-agent";
+/**
+ * Configuration for a sub-agent in multi-agent mode.
+ * Used when auto-specializing agents from an objective.
+ */
+export interface SubAgentConfig {
+    /** Human-readable name for the sub-agent. */
+    name: string;
+    /** Role description for the sub-agent. */
+    role: string;
+    /** Skill tags for task matching. */
+    skills: string[];
+    /** Tool names this sub-agent can use (beyond team tools). */
+    tools?: string[];
+    /** Override model for this sub-agent. If not set, uses the parent agent's model. */
+    model?: string;
+    /** Override provider for this sub-agent. If not set, uses the parent agent's provider. */
+    provider?: string;
+}
+export interface Step {
+    id: string;
+    instructions: string;
+    completed: boolean;
+    startTime?: number;
+    endTime?: number;
+    dependsOn: string[];
+    tools?: string[];
+    outputSchema?: string;
+    logs: string[];
+    /** Step execution mode: discover produces a list, process fans out over it, aggregate collects. */
+    mode?: "discover" | "process" | "aggregate";
+    /** Template with {field} placeholders, rendered per item for process-mode fan-out. */
+    perItemInstructions?: string;
+    /** JSON schema string applied to each ephemeral step's output in process mode. */
+    perItemSchema?: string;
+}
+export interface Task {
+    id: string;
+    title: string;
+    description?: string;
+    steps: Step[];
+    /** Task IDs this task depends on. Used in multi-task plans for inter-task ordering. */
+    dependsOn?: string[];
+    /** Whether this task has been completed. Set by ParallelTaskExecutor. */
+    completed?: boolean;
+}
+/**
+ * A plan with multiple tasks that can be executed in parallel.
+ * Tasks form a DAG via their `dependsOn` arrays. Independent tasks
+ * run concurrently as sub-agents, each with their own StepExecutor chain.
+ */
+export interface TaskPlan {
+    title: string;
+    tasks: Task[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,CAAC;AAExD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,oFAAoF;IACpF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,mGAAmG;IACnG,IAAI,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,WAAW,CAAC;IAC5C,sFAAsF;IACtF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kFAAkF;IAClF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,uFAAuF;IACvF,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,yEAAyE;IACzE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,IAAI,EAAE,CAAC;CACf"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Core type definitions for the agent system.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/utils/json-parser.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Utility for extracting JSON from LLM text output.
+ */
+/**
+ * Attempt to extract a JSON value from a text string.
+ *
+ * Strategies (in order):
+ * 1. Direct JSON.parse of the trimmed text.
+ * 2. Extract from a fenced ```json code block.
+ * 3. Find the first balanced { ... } substring.
+ *
+ * Returns null if no valid JSON can be extracted.
+ */
+export declare function extractJSON(text: string): unknown | null;
+//# sourceMappingURL=json-parser.d.ts.map

package/dist/utils/json-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-parser.d.ts","sourceRoot":"","sources":["../../src/utils/json-parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CA6DxD"}

package/dist/utils/json-parser.js

@@ -0,0 +1,78 @@
+/**
+ * Utility for extracting JSON from LLM text output.
+ */
+/**
+ * Attempt to extract a JSON value from a text string.
+ *
+ * Strategies (in order):
+ * 1. Direct JSON.parse of the trimmed text.
+ * 2. Extract from a fenced ```json code block.
+ * 3. Find the first balanced { ... } substring.
+ *
+ * Returns null if no valid JSON can be extracted.
+ */
+export function extractJSON(text) {
+    const trimmed = text.trim();
+    // Strategy 1: direct parse
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        // continue
+    }
+    // Strategy 2: fenced code block
+    const fenceMatch = trimmed.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);
+    if (fenceMatch?.[1]) {
+        try {
+            return JSON.parse(fenceMatch[1].trim());
+        }
+        catch {
+            // continue
+        }
+    }
+    // Strategy 3: balanced braces or brackets
+    for (const [open, close] of [
+        ["{", "}"],
+        ["[", "]"]
+    ]) {
+        const startIdx = trimmed.indexOf(open);
+        if (startIdx === -1)
+            continue;
+        let depth = 0;
+        let inString = false;
+        let escape = false;
+        for (let i = startIdx; i < trimmed.length; i++) {
+            const ch = trimmed[i];
+            if (escape) {
+                escape = false;
+                continue;
+            }
+            if (ch === "\\") {
+                escape = true;
+                continue;
+            }
+            if (ch === '"') {
+                inString = !inString;
+                continue;
+            }
+            if (inString)
+                continue;
+            if (ch === open)
+                depth++;
+            if (ch === close) {
+                depth--;
+                if (depth === 0) {
+                    const candidate = trimmed.slice(startIdx, i + 1);
+                    try {
+                        return JSON.parse(candidate);
+                    }
+                    catch {
+                        // continue searching
+                    }
+                }
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=json-parser.js.map

package/dist/utils/json-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-parser.js","sourceRoot":"","sources":["../../src/utils/json-parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAE5B,2BAA2B;IAC3B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,WAAW;IACb,CAAC;IAED,gCAAgC;IAChC,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACvE,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpB,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,WAAW;QACb,CAAC;IACH,CAAC;IAED,0CAA0C;IAC1C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI;QAC1B,CAAC,GAAG,EAAE,GAAG,CAAC;QACV,CAAC,GAAG,EAAE,GAAG,CAAC;KACF,EAAE,CAAC;QACX,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,QAAQ,KAAK,CAAC,CAAC;YAAE,SAAS;QAC9B,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,IAAI,MAAM,GAAG,KAAK,CAAC;QACnB,KAAK,IAAI,CAAC,GAAG,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/C,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YACtB,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,GAAG,KAAK,CAAC;gBACf,SAAS;YACX,CAAC;YACD,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;gBAChB,MAAM,GAAG,IAAI,CAAC;gBACd,SAAS;YACX,CAAC;YACD,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;gBACf,QAAQ,GAAG,CAAC,QAAQ,CAAC;gBACrB,SAAS;YACX,CAAC;YACD,IAAI,QAAQ;gBAAE,SAAS;YACvB,IAAI,EAAE,KAAK,IAAI;gBAAE,KAAK,EAAE,CAAC;YACzB,IAAI,EAAE,KAAK,KAAK,EAAE,CAAC;gBACjB,KAAK,EAAE,CAAC;gBACR,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;oBAChB,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;oBACjD,IAAI,CAAC;wBACH,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;oBAC/B,CAAC;oBAAC,MAAM,CAAC;wBACP,qBAAqB;oBACvB,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/utils/remove-base64-images.d.ts

@@ -0,0 +1,12 @@
+/**
+ * removeBase64Images — T-AG-7.
+ *
+ * Strips image content blocks where the data is base64-encoded.
+ */
+import type { MessageContent } from "@nodetool-ai/runtime";
+/**
+ * Remove base64 image content blocks from a message content array.
+ * Preserves text content, audio content, and images with real URLs.
+ */
+export declare function removeBase64Images(content: MessageContent[]): MessageContent[];
+//# sourceMappingURL=remove-base64-images.d.ts.map

package/dist/utils/remove-base64-images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-base64-images.d.ts","sourceRoot":"","sources":["../../src/utils/remove-base64-images.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,cAAc,EAAuB,MAAM,sBAAsB,CAAC;AAShF;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,cAAc,EAAE,GACxB,cAAc,EAAE,CAKlB"}

package/dist/utils/remove-base64-images.js

@@ -0,0 +1,20 @@
+function isBase64Image(content) {
+    const { uri, data } = content.image;
+    if (uri && uri.startsWith("data:image/"))
+        return true;
+    if (data != null)
+        return true;
+    return false;
+}
+/**
+ * Remove base64 image content blocks from a message content array.
+ * Preserves text content, audio content, and images with real URLs.
+ */
+export function removeBase64Images(content) {
+    return content.filter((item) => {
+        if (item.type !== "image_url")
+            return true;
+        return !isBase64Image(item);
+    });
+}
+//# sourceMappingURL=remove-base64-images.js.map

package/dist/utils/remove-base64-images.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-base64-images.js","sourceRoot":"","sources":["../../src/utils/remove-base64-images.ts"],"names":[],"mappings":"AAOA,SAAS,aAAa,CAAC,OAA4B;IACjD,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC;IACpC,IAAI,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC;QAAE,OAAO,IAAI,CAAC;IACtD,IAAI,IAAI,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAC9B,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAyB;IAEzB,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QAC7B,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW;YAAE,OAAO,IAAI,CAAC;QAC3C,OAAO,CAAC,aAAa,CAAC,IAA2B,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/wrap-generators-parallel.d.ts

@@ -0,0 +1,11 @@
+/**
+ * wrapGeneratorsParallel — T-AG-8.
+ *
+ * Merges multiple async generators into one, yielding items in arrival order.
+ */
+/**
+ * Yield items from all generators concurrently in arrival order.
+ * Uses Promise.race to return whichever generator produces a value first.
+ */
+export declare function wrapGeneratorsParallel<T>(generators: AsyncGenerator<T>[]): AsyncGenerator<T>;
+//# sourceMappingURL=wrap-generators-parallel.d.ts.map

package/dist/utils/wrap-generators-parallel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrap-generators-parallel.d.ts","sourceRoot":"","sources":["../../src/utils/wrap-generators-parallel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,wBAAuB,sBAAsB,CAAC,CAAC,EAC7C,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,GAC9B,cAAc,CAAC,CAAC,CAAC,CAqCnB"}

package/dist/utils/wrap-generators-parallel.js

@@ -0,0 +1,38 @@
+/**
+ * wrapGeneratorsParallel — T-AG-8.
+ *
+ * Merges multiple async generators into one, yielding items in arrival order.
+ */
+/**
+ * Yield items from all generators concurrently in arrival order.
+ * Uses Promise.race to return whichever generator produces a value first.
+ */
+export async function* wrapGeneratorsParallel(generators) {
+    if (generators.length === 0)
+        return;
+    const slots = generators.map((gen, index) => {
+        const slot = {
+            gen,
+            index,
+            done: false,
+            promise: gen.next().then((result) => ({ index, result }))
+        };
+        return slot;
+    });
+    while (true) {
+        const activeSlots = slots.filter((s) => !s.done);
+        if (activeSlots.length === 0)
+            break;
+        const { index, result } = await Promise.race(activeSlots.map((s) => s.promise));
+        const slot = slots[index];
+        if (result.done) {
+            slot.done = true;
+        }
+        else {
+            yield result.value;
+            // Advance this generator
+            slot.promise = slot.gen.next().then((r) => ({ index, result: r }));
+        }
+    }
+}
+//# sourceMappingURL=wrap-generators-parallel.js.map

package/dist/utils/wrap-generators-parallel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrap-generators-parallel.js","sourceRoot":"","sources":["../../src/utils/wrap-generators-parallel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,sBAAsB,CAC3C,UAA+B;IAE/B,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IASpC,MAAM,KAAK,GAAW,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAClD,MAAM,IAAI,GAAS;YACjB,GAAG;YACH,KAAK;YACL,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;SAC1D,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM;QAEpC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,IAAI,CAC1C,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAClC,CAAC;QAEF,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACnB,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,CAAC,KAAK,CAAC;YACnB,yBAAyB;YACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@nodetool-ai/agents",
+  "version": "0.7.0-rc.11",
+  "description": "Agent system for planning and executing multi-step LLM tasks",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "node ../../scripts/build-typescript-workspace.mjs",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@jitl/quickjs-ng-wasmfile-release-sync": "^0.31.0",
+    "@llamaindex/liteparse": "^1.5.2",
+    "@nodetool-ai/config": "^0.7.0-rc.11",
+    "@nodetool-ai/kernel": "^0.7.0-rc.11",
+    "@nodetool-ai/models": "^0.7.0-rc.11",
+    "@nodetool-ai/node-sdk": "^0.7.0-rc.11",
+    "@nodetool-ai/protocol": "^0.7.0-rc.11",
+    "@nodetool-ai/runtime": "^0.7.0-rc.11",
+    "@sebastianwessel/quickjs": "^3.0.1",
+    "@types/mailparser": "^3.4.6",
+    "imapflow": "^1.2.12",
+    "js-tiktoken": "^1.0.18",
+    "mailparser": "^3.9.3"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.2",
+    "vitest": "^4.1.2"
+  },
+  "exports": {
+    ".": {
+      "nodetool-dev": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./tool": {
+      "nodetool-dev": "./src/tools/base-tool.ts",
+      "types": "./dist/tools/base-tool.d.ts",
+      "import": "./dist/tools/base-tool.js",
+      "default": "./dist/tools/base-tool.js"
+    }
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nodetool-ai/nodetool.git",
+    "directory": "packages/agents"
+  },
+  "homepage": "https://nodetool.ai",
+  "bugs": {
+    "url": "https://github.com/nodetool-ai/nodetool/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}