@gencode/agents 0.0.1

package/dist/tools/exec.js

@@ -0,0 +1,125 @@
+import path from "node:path";
+import { Type } from "@mariozechner/pi-ai";
+const execSchema = Type.Object({
+    command: Type.String({ description: "Shell command to execute" }),
+    workdir: Type.Optional(Type.String({ description: "Working directory (relative to workspace root)" })),
+    env: Type.Optional(Type.Record(Type.String(), Type.String())),
+    timeout: Type.Optional(Type.Number({ description: "Timeout in seconds (default: 1800)" })),
+    yieldMs: Type.Optional(Type.Number({ description: "Wait this many milliseconds before returning running state" })),
+    background: Type.Optional(Type.Boolean({ description: "Return immediately with running session" })),
+});
+const DEFAULT_TIMEOUT_SECONDS = 1800;
+const DEFAULT_YIELD_MS = 10_000;
+const MAX_YIELD_MS = 120_000;
+function clamp(value, min, max) {
+    return Math.max(min, Math.min(max, value));
+}
+function normalizeTimeoutSeconds(value) {
+    if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
+        return DEFAULT_TIMEOUT_SECONDS;
+    }
+    return Math.floor(value);
+}
+function normalizeYieldMs(value) {
+    if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
+        return DEFAULT_YIELD_MS;
+    }
+    return clamp(Math.floor(value), 0, MAX_YIELD_MS);
+}
+function resolveWorkdir(workspaceDir, requested) {
+    if (!requested?.trim()) {
+        return workspaceDir;
+    }
+    const resolved = path.isAbsolute(requested)
+        ? path.normalize(requested)
+        : path.normalize(path.join(workspaceDir, requested));
+    if (!resolved.startsWith(workspaceDir + path.sep) && resolved !== workspaceDir) {
+        throw new Error(`workdir escapes workspace: ${requested}`);
+    }
+    return resolved;
+}
+function formatRunningText(snapshot) {
+    const tail = snapshot.outputTail.trim();
+    const lead = tail.length > 0 ? `${tail}\n\n` : "";
+    return `${lead}Process is running in the background. sessionId=${snapshot.sessionId}\nUse process(action="poll"|"log", sessionId) to continue.`;
+}
+function formatCompletedText(snapshot) {
+    const output = snapshot.outputTail.trim();
+    const base = output.length > 0 ? output : "(no output)";
+    const exitLine = snapshot.exitCode === undefined ? "" : `\nExit code: ${snapshot.exitCode === null ? "null" : snapshot.exitCode}`;
+    return `${base}${exitLine}`;
+}
+export function createExecTool(options) {
+    return {
+        name: "exec",
+        label: "Exec",
+        description: "Execute shell commands with optional background continuation. Use process tool to poll logs and status.",
+        parameters: execSchema,
+        async execute(_toolCallId, params) {
+            if (!params.command?.trim()) {
+                return {
+                    content: [{ type: "text", text: "Error: command is required." }],
+                    details: { status: "failed" },
+                };
+            }
+            let cwd;
+            try {
+                cwd = resolveWorkdir(options.workspaceDir, params.workdir);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                return {
+                    content: [{ type: "text", text: `Error: ${message}` }],
+                    details: { status: "failed" },
+                };
+            }
+            const timeoutSec = normalizeTimeoutSeconds(params.timeout);
+            const snapshot = options.registry.start({
+                command: params.command,
+                cwd,
+                env: params.env,
+                timeoutSec,
+                scopeKey: options.scopeKey,
+            });
+            const backgroundRequested = params.background === true;
+            const hasYield = typeof params.yieldMs === "number" && Number.isFinite(params.yieldMs);
+            let latest = snapshot;
+            if (!backgroundRequested && !hasYield) {
+                const waited = await options.registry.wait(snapshot.sessionId, options.scopeKey, undefined);
+                if (waited) {
+                    latest = waited;
+                }
+            }
+            else if (!backgroundRequested) {
+                const waited = await options.registry.wait(snapshot.sessionId, options.scopeKey, normalizeYieldMs(params.yieldMs));
+                if (waited) {
+                    latest = waited;
+                }
+            }
+            if (latest.status === "running") {
+                return {
+                    content: [{ type: "text", text: formatRunningText(latest) }],
+                    details: {
+                        status: "running",
+                        sessionId: latest.sessionId,
+                        command: latest.command,
+                        cwd: latest.cwd,
+                        pid: latest.pid,
+                    },
+                };
+            }
+            return {
+                content: [{ type: "text", text: formatCompletedText(latest) }],
+                details: {
+                    status: latest.status,
+                    sessionId: latest.sessionId,
+                    command: latest.command,
+                    cwd: latest.cwd,
+                    exitCode: latest.exitCode,
+                    exitSignal: latest.exitSignal,
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=exec.js.map

package/dist/tools/exec.js.map

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

package/dist/tools/files.d.ts

@@ -0,0 +1,37 @@
+import type { TObject, TString, TNumber, TOptional } from "@sinclair/typebox";
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+declare const readFileSchema: TObject<{
+    path: TString;
+    offset: TOptional<TNumber>;
+    limit: TOptional<TNumber>;
+}>;
+type ReadFileResult = {
+    content: string;
+    lines: number;
+    truncated: boolean;
+};
+export declare function createReadFileTool(workspaceDir: string): AgentTool<typeof readFileSchema, ReadFileResult>;
+declare const writeFileSchema: TObject<{
+    path: TString;
+    content: TString;
+}>;
+export declare function createWriteFileTool(workspaceDir: string): AgentTool<typeof writeFileSchema, {
+    path: string;
+}>;
+declare const editFileSchema: TObject<{
+    path: TString;
+    old_string: TString;
+    new_string: TString;
+}>;
+export declare function createEditFileTool(workspaceDir: string): AgentTool<typeof editFileSchema, {
+    path: string;
+    occurrences: number;
+}>;
+declare const listDirSchema: TObject<{
+    path: TOptional<TString>;
+}>;
+export declare function createListDirTool(workspaceDir: string): AgentTool<typeof listDirSchema, {
+    entries: string[];
+}>;
+export {};
+//# sourceMappingURL=files.d.ts.map

package/dist/tools/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/tools/files.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,OAAO,EACP,OAAO,EACP,OAAO,EACP,SAAS,EACV,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,6BAA6B,CAAC;AAwB9E,QAAA,MAAM,cAAc,EAAE,OAAO,CAAC;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IAC3B,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;CAC3B,CAIC,CAAC;AAEH,KAAK,cAAc,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC;AAE7E,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,GACnB,SAAS,CAAC,OAAO,cAAc,EAAE,cAAc,CAAC,CAqDlD;AAID,QAAA,MAAM,eAAe,EAAE,OAAO,CAAC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAGhE,CAAC;AAEH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,GACnB,SAAS,CAAC,OAAO,eAAe,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAgCrD;AAID,QAAA,MAAM,cAAc,EAAE,OAAO,CAAC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAIvF,CAAC;AAEH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,GACnB,SAAS,CAAC,OAAO,cAAc,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CA2CzE;AAID,QAAA,MAAM,aAAa,EAAE,OAAO,CAAC;IAAE,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,CAAA;CAAE,CAEvD,CAAC;AAEH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,GACnB,SAAS,CAAC,OAAO,aAAa,EAAE;IAAE,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAkCxD"}

package/dist/tools/files.js

@@ -0,0 +1,191 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { Type } from "@mariozechner/pi-ai";
+/** Maximum file size to read (5 MB) */
+const MAX_READ_BYTES = 5 * 1024 * 1024;
+/** Maximum lines to return from a read */
+const MAX_READ_LINES = 2000;
+/**
+ * Validates that a requested path stays within the allowed root.
+ * Returns the resolved absolute path, or throws if it escapes the root.
+ */
+function resolveSecurePath(requestedPath, rootDir) {
+    const resolved = path.isAbsolute(requestedPath)
+        ? path.normalize(requestedPath)
+        : path.normalize(path.join(rootDir, requestedPath));
+    // if (!resolved.startsWith(rootDir + path.sep) && resolved !== rootDir) {
+    //   throw new Error(`Path escapes workspace: ${requestedPath}`);
+    // }
+    return resolved;
+}
+// ─── Read File Tool ───────────────────────────────────────────────────────────
+const readFileSchema = Type.Object({
+    path: Type.String({ description: "File path (relative to workspace or absolute)" }),
+    offset: Type.Optional(Type.Number({ description: "Line offset (1-based, default: 1)" })),
+    limit: Type.Optional(Type.Number({ description: "Maximum lines to read (default: 2000)" })),
+});
+export function createReadFileTool(workspaceDir) {
+    return {
+        name: "read_file",
+        label: "Read File",
+        description: "Read the contents of a file",
+        parameters: readFileSchema,
+        async execute(_toolCallId, params) {
+            let filePath;
+            try {
+                filePath = resolveSecurePath(params.path, workspaceDir);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                return { content: [{ type: "text", text: `Error: ${msg}` }], details: { content: "", lines: 0, truncated: false } };
+            }
+            let raw;
+            try {
+                raw = await fs.readFile(filePath);
+            }
+            catch (err) {
+                const code = err.code;
+                const msg = code === "ENOENT" ? `File not found: ${params.path}` : String(err);
+                return { content: [{ type: "text", text: `Error: ${msg}` }], details: { content: "", lines: 0, truncated: false } };
+            }
+            if (raw.length > MAX_READ_BYTES) {
+                const truncated = raw.slice(0, MAX_READ_BYTES).toString("utf-8");
+                return {
+                    content: [{ type: "text", text: `${truncated}\n[...file truncated at ${MAX_READ_BYTES} bytes]` }],
+                    details: { content: truncated, lines: 0, truncated: true },
+                };
+            }
+            const text = raw.toString("utf-8");
+            const allLines = text.split("\n");
+            const offset = Math.max(1, params.offset ?? 1);
+            const limit = Math.min(MAX_READ_LINES, params.limit ?? MAX_READ_LINES);
+            const selectedLines = allLines.slice(offset - 1, offset - 1 + limit);
+            const truncated = selectedLines.length < allLines.length - (offset - 1);
+            const numbered = selectedLines
+                .map((line, idx) => `${(offset + idx).toString().padStart(4)} ${line}`)
+                .join("\n");
+            const suffix = truncated ? `\n[...${allLines.length - (offset - 1 + selectedLines.length)} more lines]` : "";
+            return {
+                content: [{ type: "text", text: numbered + suffix }],
+                details: { content: selectedLines.join("\n"), lines: selectedLines.length, truncated },
+            };
+        },
+    };
+}
+// ─── Write File Tool ──────────────────────────────────────────────────────────
+const writeFileSchema = Type.Object({
+    path: Type.String({ description: "File path (relative to workspace or absolute)" }),
+    content: Type.String({ description: "File content to write" }),
+});
+export function createWriteFileTool(workspaceDir) {
+    return {
+        name: "write_file",
+        label: "Write File",
+        description: "Create or overwrite a file with the given content",
+        parameters: writeFileSchema,
+        async execute(_toolCallId, params) {
+            let filePath;
+            try {
+                filePath = resolveSecurePath(params.path, workspaceDir);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                return { content: [{ type: "text", text: `Error: ${msg}` }], details: { path: params.path } };
+            }
+            try {
+                await fs.mkdir(path.dirname(filePath), { recursive: true });
+                await fs.writeFile(filePath, params.content, "utf-8");
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                return { content: [{ type: "text", text: `Error writing file: ${msg}` }], details: { path: filePath } };
+            }
+            return {
+                content: [{ type: "text", text: `File written: ${params.path}` }],
+                details: { path: filePath },
+            };
+        },
+    };
+}
+// ─── Edit File Tool ───────────────────────────────────────────────────────────
+const editFileSchema = Type.Object({
+    path: Type.String({ description: "File path (relative to workspace or absolute)" }),
+    old_string: Type.String({ description: "Exact text to replace" }),
+    new_string: Type.String({ description: "Replacement text" }),
+});
+export function createEditFileTool(workspaceDir) {
+    return {
+        name: "edit_file",
+        label: "Edit File",
+        description: "Replace the first occurrence of old_string with new_string in a file",
+        parameters: editFileSchema,
+        async execute(_toolCallId, params) {
+            let filePath;
+            try {
+                filePath = resolveSecurePath(params.path, workspaceDir);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                return { content: [{ type: "text", text: `Error: ${msg}` }], details: { path: params.path, occurrences: 0 } };
+            }
+            let content;
+            try {
+                content = await fs.readFile(filePath, "utf-8");
+            }
+            catch (err) {
+                const code = err.code;
+                const msg = code === "ENOENT" ? `File not found: ${params.path}` : String(err);
+                return { content: [{ type: "text", text: `Error: ${msg}` }], details: { path: filePath, occurrences: 0 } };
+            }
+            if (!content.includes(params.old_string)) {
+                return {
+                    content: [{ type: "text", text: `Error: old_string not found in ${params.path}` }],
+                    details: { path: filePath, occurrences: 0 },
+                };
+            }
+            const newContent = content.replace(params.old_string, params.new_string);
+            await fs.writeFile(filePath, newContent, "utf-8");
+            return {
+                content: [{ type: "text", text: `File edited: ${params.path}` }],
+                details: { path: filePath, occurrences: 1 },
+            };
+        },
+    };
+}
+// ─── List Directory Tool ──────────────────────────────────────────────────────
+const listDirSchema = Type.Object({
+    path: Type.Optional(Type.String({ description: "Directory path (default: workspace root)" })),
+});
+export function createListDirTool(workspaceDir) {
+    return {
+        name: "list_dir",
+        label: "List Directory",
+        description: "List the contents of a directory",
+        parameters: listDirSchema,
+        async execute(_toolCallId, params) {
+            const targetPath = params.path ?? ".";
+            let dirPath;
+            try {
+                dirPath = resolveSecurePath(targetPath, workspaceDir);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                return { content: [{ type: "text", text: `Error: ${msg}` }], details: { entries: [] } };
+            }
+            let entries;
+            try {
+                const dirents = await fs.readdir(dirPath, { withFileTypes: true });
+                entries = dirents.map((d) => `${d.name}${d.isDirectory() ? "/" : ""}`);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                return { content: [{ type: "text", text: `Error: ${msg}` }], details: { entries: [] } };
+            }
+            return {
+                content: [{ type: "text", text: entries.join("\n") || "(empty directory)" }],
+                details: { entries },
+            };
+        },
+    };
+}
+//# sourceMappingURL=files.js.map

package/dist/tools/files.js.map

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

package/dist/tools/image.d.ts

@@ -0,0 +1,14 @@
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+declare const imageSchema: import("@sinclair/typebox").TObject<{
+    image: import("@sinclair/typebox").TString;
+    prompt: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    model: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    maxBytesMb: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>;
+type ImageResult = {
+    implemented: boolean;
+    error?: string;
+};
+export declare function createImageTool(): AgentTool<typeof imageSchema, ImageResult>;
+export {};
+//# sourceMappingURL=image.d.ts.map

package/dist/tools/image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../../src/tools/image.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,6BAA6B,CAAC;AAE9E,QAAA,MAAM,WAAW;;;;;EAKf,CAAC;AAEH,KAAK,WAAW,GAAG;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAgB,eAAe,IAAI,SAAS,CAAC,OAAO,WAAW,EAAE,WAAW,CAAC,CAqB5E"}

package/dist/tools/image.js

@@ -0,0 +1,26 @@
+import { Type } from "@mariozechner/pi-ai";
+const imageSchema = Type.Object({
+    image: Type.String({ description: "Image path or URL" }),
+    prompt: Type.Optional(Type.String({ description: "Prompt for image analysis" })),
+    model: Type.Optional(Type.String({ description: "Optional model override" })),
+    maxBytesMb: Type.Optional(Type.Number({ description: "Optional size cap in MB" })),
+});
+export function createImageTool() {
+    return {
+        name: "image",
+        label: "Image",
+        description: "Analyze an image with the configured image model. (Not implemented in AIMax yet.)",
+        parameters: imageSchema,
+        async execute(_toolCallId, _params) {
+            const result = {
+                implemented: false,
+                error: "image tool not implemented (awaiting third-party integration).",
+            };
+            return {
+                content: [{ type: "text", text: `Error: ${result.error}` }],
+                details: result,
+            };
+        },
+    };
+}
+//# sourceMappingURL=image.js.map

package/dist/tools/image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.js","sourceRoot":"","sources":["../../src/tools/image.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAe,MAAM,qBAAqB,CAAC;AAGxD,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC;IAC9B,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACxD,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,2BAA2B,EAAE,CAAC,CAAC;IAChF,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,yBAAyB,EAAE,CAAC,CAAC;IAC7E,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,yBAAyB,EAAE,CAAC,CAAC;CACnF,CAAC,CAAC;AAOH,MAAM,UAAU,eAAe;IAC7B,OAAO;QACL,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,OAAO;QACd,WAAW,EACT,mFAAmF;QACrF,UAAU,EAAE,WAAW;QACvB,KAAK,CAAC,OAAO,CACX,WAAmB,EACnB,OAAmC;YAEnC,MAAM,MAAM,GAAgB;gBAC1B,WAAW,EAAE,KAAK;gBAClB,KAAK,EAAE,gEAAgE;aACxE,CAAC;YACF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;gBAC3D,OAAO,EAAE,MAAM;aAChB,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,35 @@
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+import { type MemoryToolOptions } from "./memory.js";
+import type { SubagentRegistry } from "../subagent/registry.js";
+import type { AgentRunParams, AgentRunResult } from "../types.js";
+import type { ToolLoopDetectionConfig } from "../loop-detection/tool-loop-detection.js";
+/** Optional context for enabling subagent tools */
+export type SubagentToolsContext = {
+    registry: SubagentRegistry;
+    parentSessionId: string;
+    /** Depth of the current agent (root = 0) */
+    depth: number;
+    channel: AgentRunParams["channel"];
+    llm: AgentRunParams["llm"];
+    loopDetection?: ToolLoopDetectionConfig;
+    memoryOptions?: MemoryToolOptions;
+    /** Callback that runs a child agent; injected to avoid circular imports */
+    spawnFn: (params: AgentRunParams) => Promise<AgentRunResult>;
+};
+/**
+ * Creates the full set of agent tools for a given data directory.
+ * File and exec/process tools are scoped to the workspace directory.
+ * Memory tools are scoped to the data directory's .aimax root
+ * (MEMORY.md + memory/*.md).
+ * Subagent tools (sessions_spawn, subagents) are included when ctx is provided.
+ */
+export declare function createAgentTools(dataDir: string, ctx?: SubagentToolsContext): AgentTool[];
+export { createBashTool } from "./bash.js";
+export { createExecTool, createProcessTool } from "./bash.js";
+export { createReadFileTool, createWriteFileTool, createEditFileTool, createListDirTool, } from "./files.js";
+export { createApplyPatchTool } from "./apply-patch.js";
+export { createMemorySearchTool, createMemoryGetTool, createMemoryAppendTool, } from "./memory.js";
+export { createImageTool } from "./image.js";
+export { createSessionsSpawnTool } from "./subagent-spawn.js";
+export { createSubagentsTool } from "./subagents.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAU7D,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AAGrB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AAGxF,mDAAmD;AACnD,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IACnC,GAAG,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;IAC3B,aAAa,CAAC,EAAE,uBAAuB,CAAC;IACxC,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,2EAA2E;IAC3E,OAAO,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;CAC9D,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,oBAAoB,GAAG,SAAS,EAAE,CA0CzF;AAED,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,53 @@
+import { createExecTool, createProcessTool } from "./bash.js";
+import { createProcessRegistry } from "./process-registry.js";
+import { createReadFileTool, createWriteFileTool, createEditFileTool, createListDirTool, } from "./files.js";
+import { createApplyPatchTool } from "./apply-patch.js";
+import { createMemorySearchTool, createMemoryGetTool, createMemoryAppendTool, } from "./memory.js";
+import { createSessionsSpawnTool } from "./subagent-spawn.js";
+import { createSubagentsTool } from "./subagents.js";
+import path from "node:path";
+/**
+ * Creates the full set of agent tools for a given data directory.
+ * File and exec/process tools are scoped to the workspace directory.
+ * Memory tools are scoped to the data directory's .aimax root
+ * (MEMORY.md + memory/*.md).
+ * Subagent tools (sessions_spawn, subagents) are included when ctx is provided.
+ */
+export function createAgentTools(dataDir, ctx) {
+    const workspaceDir = path.join(dataDir, "workspace");
+    const memoryOptions = ctx?.memoryOptions;
+    const processRegistry = createProcessRegistry();
+    const tools = [
+        createExecTool({
+            workspaceDir,
+            registry: processRegistry,
+            scopeKey: workspaceDir,
+        }),
+        createProcessTool({
+            registry: processRegistry,
+            scopeKey: workspaceDir,
+        }),
+        createReadFileTool(workspaceDir),
+        createWriteFileTool(workspaceDir),
+        createEditFileTool(workspaceDir),
+        createListDirTool(workspaceDir),
+        createApplyPatchTool(workspaceDir),
+        createMemorySearchTool(dataDir, memoryOptions),
+        createMemoryGetTool(dataDir, memoryOptions),
+        createMemoryAppendTool(dataDir, memoryOptions),
+    ];
+    if (ctx) {
+        tools.push(createSessionsSpawnTool(ctx.registry, ctx.parentSessionId, ctx.depth, dataDir, ctx.channel, ctx.llm, ctx.loopDetection, ctx.spawnFn), createSubagentsTool(ctx.registry, ctx.parentSessionId));
+    }
+    // Double-cast to handle TypeScript variance issues with generic AgentTool<T> types
+    return tools;
+}
+export { createBashTool } from "./bash.js";
+export { createExecTool, createProcessTool } from "./bash.js";
+export { createReadFileTool, createWriteFileTool, createEditFileTool, createListDirTool, } from "./files.js";
+export { createApplyPatchTool } from "./apply-patch.js";
+export { createMemorySearchTool, createMemoryGetTool, createMemoryAppendTool, } from "./memory.js";
+export { createImageTool } from "./image.js";
+export { createSessionsSpawnTool } from "./subagent-spawn.js";
+export { createSubagentsTool } from "./subagents.js";
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,GAEvB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAIrD,OAAO,IAAI,MAAM,WAAW,CAAC;AAgB7B;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,GAA0B;IAC1E,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACrD,MAAM,aAAa,GAAG,GAAG,EAAE,aAAa,CAAC;IACzC,MAAM,eAAe,GAAG,qBAAqB,EAAE,CAAC;IAChD,MAAM,KAAK,GAAgB;QACzB,cAAc,CAAC;YACb,YAAY;YACZ,QAAQ,EAAE,eAAe;YACzB,QAAQ,EAAE,YAAY;SACvB,CAAC;QACF,iBAAiB,CAAC;YAChB,QAAQ,EAAE,eAAe;YACzB,QAAQ,EAAE,YAAY;SACvB,CAAC;QACF,kBAAkB,CAAC,YAAY,CAAC;QAChC,mBAAmB,CAAC,YAAY,CAAC;QACjC,kBAAkB,CAAC,YAAY,CAAC;QAChC,iBAAiB,CAAC,YAAY,CAAC;QAC/B,oBAAoB,CAAC,YAAY,CAAC;QAClC,sBAAsB,CAAC,OAAO,EAAE,aAAa,CAAC;QAC9C,mBAAmB,CAAC,OAAO,EAAE,aAAa,CAAC;QAC3C,sBAAsB,CAAC,OAAO,EAAE,aAAa,CAAC;KAC/C,CAAC;IAEF,IAAI,GAAG,EAAE,CAAC;QACR,KAAK,CAAC,IAAI,CACR,uBAAuB,CACrB,GAAG,CAAC,QAAQ,EACZ,GAAG,CAAC,eAAe,EACnB,GAAG,CAAC,KAAK,EACT,OAAO,EACP,GAAG,CAAC,OAAO,EACX,GAAG,CAAC,GAAG,EACP,GAAG,CAAC,aAAa,EACjB,GAAG,CAAC,OAAO,CACZ,EACD,mBAAmB,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,eAAe,CAAC,CACvD,CAAC;IACJ,CAAC;IAED,mFAAmF;IACnF,OAAO,KAA+B,CAAC;AACzC,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/tools/memory.d.ts

@@ -0,0 +1,41 @@
+import type { TObject, TString, TNumber } from "@sinclair/typebox";
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+import type { MemoryChangedHandler } from "../memory/provider.js";
+export type MemoryToolOptions = {
+    providerId?: string;
+    pluginId?: string;
+    sessionId?: string;
+    onMemoryChanged?: MemoryChangedHandler;
+};
+declare const memorySearchSchema: TObject<{
+    query: TString;
+}>;
+type SearchResult = {
+    matches: Array<{
+        file: string;
+        start_line: number;
+        end_line: number;
+        score: number;
+        text: string;
+        source: string;
+        citation?: string;
+    }>;
+};
+export declare function createMemorySearchTool(dataDir: string, options?: MemoryToolOptions): AgentTool<typeof memorySearchSchema, SearchResult>;
+declare const memoryGetSchema: TObject<{
+    file: TString;
+    start_line: TNumber;
+    end_line: TNumber;
+}>;
+type GetResult = {
+    lines: string[] | null;
+};
+export declare function createMemoryGetTool(dataDir: string, options?: MemoryToolOptions): AgentTool<typeof memoryGetSchema, GetResult>;
+declare const memoryAppendSchema: TObject<{
+    content: TString;
+}>;
+export declare function createMemoryAppendTool(dataDir: string, options?: MemoryToolOptions): AgentTool<typeof memoryAppendSchema, {
+    appended: boolean;
+}>;
+export {};
+//# sourceMappingURL=memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/tools/memory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,6BAA6B,CAAC;AAO9E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAElE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,oBAAoB,CAAC;CACxC,CAAC;AAIF,QAAA,MAAM,kBAAkB,EAAE,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,CAElD,CAAC;AAEH,KAAK,YAAY,GAAG;IAClB,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;CACJ,CAAC;AAEF,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,iBAAiB,GAC1B,SAAS,CAAC,OAAO,kBAAkB,EAAE,YAAY,CAAC,CA6CpD;AAID,QAAA,MAAM,eAAe,EAAE,OAAO,CAAC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAItF,CAAC;AAEH,KAAK,SAAS,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;CAAE,CAAC;AAE5C,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,iBAAiB,GAC1B,SAAS,CAAC,OAAO,eAAe,EAAE,SAAS,CAAC,CAuC9C;AAID,QAAA,MAAM,kBAAkB,EAAE,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAEpD,CAAC;AAEH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,iBAAiB,GAC1B,SAAS,CAAC,OAAO,kBAAkB,EAAE;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CA8B7D"}