@imdigitalashish/zpi 0.1.1

package/dist/core/tools/ls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ls.d.ts","sourceRoot":"","sources":["../../../src/core/tools/ls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,KAAK,MAAM,EAAQ,MAAM,mBAAmB,CAAC;AAItD,OAAO,EAAiC,KAAK,gBAAgB,EAAgB,MAAM,eAAe,CAAC;AAEnG,QAAA,MAAM,QAAQ;;;EAGZ,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,QAAQ,CAAC,CAAC;AAIlD,MAAM,WAAW,aAAa;IAC7B,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC5B,2BAA2B;IAC3B,MAAM,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAC7D,qDAAqD;IACrD,IAAI,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,OAAO,CAAA;KAAE,CAAC,GAAG;QAAE,WAAW,EAAE,MAAM,OAAO,CAAA;KAAE,CAAC;IACzG,6BAA6B;IAC7B,OAAO,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC;CAChE;AAQD,MAAM,WAAW,aAAa;IAC7B,yEAAyE;IACzE,UAAU,CAAC,EAAE,YAAY,CAAC;CAC1B;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC,OAAO,QAAQ,CAAC,CAyH7F;AAED,wEAAwE;AACxE,eAAO,MAAM,MAAM;;;QAA8B,CAAC","sourcesContent":["import type { AgentTool } from \"@mariozechner/pi-agent-core\";\r\nimport { type Static, Type } from \"@sinclair/typebox\";\r\nimport { existsSync, readdirSync, statSync } from \"fs\";\r\nimport nodePath from \"path\";\r\nimport { resolveToCwd } from \"./path-utils.js\";\r\nimport { DEFAULT_MAX_BYTES, formatSize, type TruncationResult, truncateHead } from \"./truncate.js\";\r\n\r\nconst lsSchema = Type.Object({\r\n\tpath: Type.Optional(Type.String({ description: \"Directory to list (default: current directory)\" })),\r\n\tlimit: Type.Optional(Type.Number({ description: \"Maximum number of entries to return (default: 500)\" })),\r\n});\r\n\r\nexport type LsToolInput = Static<typeof lsSchema>;\r\n\r\nconst DEFAULT_LIMIT = 500;\r\n\r\nexport interface LsToolDetails {\r\n\ttruncation?: TruncationResult;\r\n\tentryLimitReached?: number;\r\n}\r\n\r\n/**\r\n * Pluggable operations for the ls tool.\r\n * Override these to delegate directory listing to remote systems (e.g., SSH).\r\n */\r\nexport interface LsOperations {\r\n\t/** Check if path exists */\r\n\texists: (absolutePath: string) => Promise<boolean> | boolean;\r\n\t/** Get file/directory stats. Throws if not found. */\r\n\tstat: (absolutePath: string) => Promise<{ isDirectory: () => boolean }> | { isDirectory: () => boolean };\r\n\t/** Read directory entries */\r\n\treaddir: (absolutePath: string) => Promise<string[]> | string[];\r\n}\r\n\r\nconst defaultLsOperations: LsOperations = {\r\n\texists: existsSync,\r\n\tstat: statSync,\r\n\treaddir: readdirSync,\r\n};\r\n\r\nexport interface LsToolOptions {\r\n\t/** Custom operations for directory listing. Default: local filesystem */\r\n\toperations?: LsOperations;\r\n}\r\n\r\nexport function createLsTool(cwd: string, options?: LsToolOptions): AgentTool<typeof lsSchema> {\r\n\tconst ops = options?.operations ?? defaultLsOperations;\r\n\r\n\treturn {\r\n\t\tname: \"ls\",\r\n\t\tlabel: \"ls\",\r\n\t\tdescription: `List directory contents. Returns entries sorted alphabetically, with '/' suffix for directories. Includes dotfiles. Output is truncated to ${DEFAULT_LIMIT} entries or ${DEFAULT_MAX_BYTES / 1024}KB (whichever is hit first).`,\r\n\t\tparameters: lsSchema,\r\n\t\texecute: async (\r\n\t\t\t_toolCallId: string,\r\n\t\t\t{ path, limit }: { path?: string; limit?: number },\r\n\t\t\tsignal?: AbortSignal,\r\n\t\t) => {\r\n\t\t\treturn new Promise((resolve, reject) => {\r\n\t\t\t\tif (signal?.aborted) {\r\n\t\t\t\t\treject(new Error(\"Operation aborted\"));\r\n\t\t\t\t\treturn;\r\n\t\t\t\t}\r\n\r\n\t\t\t\tconst onAbort = () => reject(new Error(\"Operation aborted\"));\r\n\t\t\t\tsignal?.addEventListener(\"abort\", onAbort, { once: true });\r\n\r\n\t\t\t\t(async () => {\r\n\t\t\t\t\ttry {\r\n\t\t\t\t\t\tconst dirPath = resolveToCwd(path || \".\", cwd);\r\n\t\t\t\t\t\tconst effectiveLimit = limit ?? DEFAULT_LIMIT;\r\n\r\n\t\t\t\t\t\t// Check if path exists\r\n\t\t\t\t\t\tif (!(await ops.exists(dirPath))) {\r\n\t\t\t\t\t\t\treject(new Error(`Path not found: ${dirPath}`));\r\n\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t// Check if path is a directory\r\n\t\t\t\t\t\tconst stat = await ops.stat(dirPath);\r\n\t\t\t\t\t\tif (!stat.isDirectory()) {\r\n\t\t\t\t\t\t\treject(new Error(`Not a directory: ${dirPath}`));\r\n\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t// Read directory entries\r\n\t\t\t\t\t\tlet entries: string[];\r\n\t\t\t\t\t\ttry {\r\n\t\t\t\t\t\t\tentries = await ops.readdir(dirPath);\r\n\t\t\t\t\t\t} catch (e: any) {\r\n\t\t\t\t\t\t\treject(new Error(`Cannot read directory: ${e.message}`));\r\n\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t// Sort alphabetically (case-insensitive)\r\n\t\t\t\t\t\tentries.sort((a, b) => a.toLowerCase().localeCompare(b.toLowerCase()));\r\n\r\n\t\t\t\t\t\t// Format entries with directory indicators\r\n\t\t\t\t\t\tconst results: string[] = [];\r\n\t\t\t\t\t\tlet entryLimitReached = false;\r\n\r\n\t\t\t\t\t\tfor (const entry of entries) {\r\n\t\t\t\t\t\t\tif (results.length >= effectiveLimit) {\r\n\t\t\t\t\t\t\t\tentryLimitReached = true;\r\n\t\t\t\t\t\t\t\tbreak;\r\n\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\tconst fullPath = nodePath.join(dirPath, entry);\r\n\t\t\t\t\t\t\tlet suffix = \"\";\r\n\r\n\t\t\t\t\t\t\ttry {\r\n\t\t\t\t\t\t\t\tconst entryStat = await ops.stat(fullPath);\r\n\t\t\t\t\t\t\t\tif (entryStat.isDirectory()) {\r\n\t\t\t\t\t\t\t\t\tsuffix = \"/\";\r\n\t\t\t\t\t\t\t\t}\r\n\t\t\t\t\t\t\t} catch {\r\n\t\t\t\t\t\t\t\t// Skip entries we can't stat\r\n\t\t\t\t\t\t\t\tcontinue;\r\n\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\tresults.push(entry + suffix);\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\r\n\r\n\t\t\t\t\t\tif (results.length === 0) {\r\n\t\t\t\t\t\t\tresolve({ content: [{ type: \"text\", text: \"(empty directory)\" }], details: undefined });\r\n\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t// Apply byte truncation (no line limit since we already have entry limit)\r\n\t\t\t\t\t\tconst rawOutput = results.join(\"\\n\");\r\n\t\t\t\t\t\tconst truncation = truncateHead(rawOutput, { maxLines: Number.MAX_SAFE_INTEGER });\r\n\r\n\t\t\t\t\t\tlet output = truncation.content;\r\n\t\t\t\t\t\tconst details: LsToolDetails = {};\r\n\r\n\t\t\t\t\t\t// Build notices\r\n\t\t\t\t\t\tconst notices: string[] = [];\r\n\r\n\t\t\t\t\t\tif (entryLimitReached) {\r\n\t\t\t\t\t\t\tnotices.push(`${effectiveLimit} entries limit reached. Use limit=${effectiveLimit * 2} for more`);\r\n\t\t\t\t\t\t\tdetails.entryLimitReached = effectiveLimit;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tif (truncation.truncated) {\r\n\t\t\t\t\t\t\tnotices.push(`${formatSize(DEFAULT_MAX_BYTES)} limit reached`);\r\n\t\t\t\t\t\t\tdetails.truncation = truncation;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tif (notices.length > 0) {\r\n\t\t\t\t\t\t\toutput += `\\n\\n[${notices.join(\". \")}]`;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tresolve({\r\n\t\t\t\t\t\t\tcontent: [{ type: \"text\", text: output }],\r\n\t\t\t\t\t\t\tdetails: Object.keys(details).length > 0 ? details : undefined,\r\n\t\t\t\t\t\t});\r\n\t\t\t\t\t} catch (e: any) {\r\n\t\t\t\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\r\n\t\t\t\t\t\treject(e);\r\n\t\t\t\t\t}\r\n\t\t\t\t})();\r\n\t\t\t});\r\n\t\t},\r\n\t};\r\n}\r\n\r\n/** Default ls tool using process.cwd() - for backwards compatibility */\r\nexport const lsTool = createLsTool(process.cwd());\r\n"]}

package/dist/core/tools/ls.js

@@ -0,0 +1,118 @@
+import { Type } from "@sinclair/typebox";
+import { existsSync, readdirSync, statSync } from "fs";
+import nodePath from "path";
+import { resolveToCwd } from "./path-utils.js";
+import { DEFAULT_MAX_BYTES, formatSize, truncateHead } from "./truncate.js";
+const lsSchema = Type.Object({
+    path: Type.Optional(Type.String({ description: "Directory to list (default: current directory)" })),
+    limit: Type.Optional(Type.Number({ description: "Maximum number of entries to return (default: 500)" })),
+});
+const DEFAULT_LIMIT = 500;
+const defaultLsOperations = {
+    exists: existsSync,
+    stat: statSync,
+    readdir: readdirSync,
+};
+export function createLsTool(cwd, options) {
+    const ops = options?.operations ?? defaultLsOperations;
+    return {
+        name: "ls",
+        label: "ls",
+        description: `List directory contents. Returns entries sorted alphabetically, with '/' suffix for directories. Includes dotfiles. Output is truncated to ${DEFAULT_LIMIT} entries or ${DEFAULT_MAX_BYTES / 1024}KB (whichever is hit first).`,
+        parameters: lsSchema,
+        execute: async (_toolCallId, { path, limit }, signal) => {
+            return new Promise((resolve, reject) => {
+                if (signal?.aborted) {
+                    reject(new Error("Operation aborted"));
+                    return;
+                }
+                const onAbort = () => reject(new Error("Operation aborted"));
+                signal?.addEventListener("abort", onAbort, { once: true });
+                (async () => {
+                    try {
+                        const dirPath = resolveToCwd(path || ".", cwd);
+                        const effectiveLimit = limit ?? DEFAULT_LIMIT;
+                        // Check if path exists
+                        if (!(await ops.exists(dirPath))) {
+                            reject(new Error(`Path not found: ${dirPath}`));
+                            return;
+                        }
+                        // Check if path is a directory
+                        const stat = await ops.stat(dirPath);
+                        if (!stat.isDirectory()) {
+                            reject(new Error(`Not a directory: ${dirPath}`));
+                            return;
+                        }
+                        // Read directory entries
+                        let entries;
+                        try {
+                            entries = await ops.readdir(dirPath);
+                        }
+                        catch (e) {
+                            reject(new Error(`Cannot read directory: ${e.message}`));
+                            return;
+                        }
+                        // Sort alphabetically (case-insensitive)
+                        entries.sort((a, b) => a.toLowerCase().localeCompare(b.toLowerCase()));
+                        // Format entries with directory indicators
+                        const results = [];
+                        let entryLimitReached = false;
+                        for (const entry of entries) {
+                            if (results.length >= effectiveLimit) {
+                                entryLimitReached = true;
+                                break;
+                            }
+                            const fullPath = nodePath.join(dirPath, entry);
+                            let suffix = "";
+                            try {
+                                const entryStat = await ops.stat(fullPath);
+                                if (entryStat.isDirectory()) {
+                                    suffix = "/";
+                                }
+                            }
+                            catch {
+                                // Skip entries we can't stat
+                                continue;
+                            }
+                            results.push(entry + suffix);
+                        }
+                        signal?.removeEventListener("abort", onAbort);
+                        if (results.length === 0) {
+                            resolve({ content: [{ type: "text", text: "(empty directory)" }], details: undefined });
+                            return;
+                        }
+                        // Apply byte truncation (no line limit since we already have entry limit)
+                        const rawOutput = results.join("\n");
+                        const truncation = truncateHead(rawOutput, { maxLines: Number.MAX_SAFE_INTEGER });
+                        let output = truncation.content;
+                        const details = {};
+                        // Build notices
+                        const notices = [];
+                        if (entryLimitReached) {
+                            notices.push(`${effectiveLimit} entries limit reached. Use limit=${effectiveLimit * 2} for more`);
+                            details.entryLimitReached = effectiveLimit;
+                        }
+                        if (truncation.truncated) {
+                            notices.push(`${formatSize(DEFAULT_MAX_BYTES)} limit reached`);
+                            details.truncation = truncation;
+                        }
+                        if (notices.length > 0) {
+                            output += `\n\n[${notices.join(". ")}]`;
+                        }
+                        resolve({
+                            content: [{ type: "text", text: output }],
+                            details: Object.keys(details).length > 0 ? details : undefined,
+                        });
+                    }
+                    catch (e) {
+                        signal?.removeEventListener("abort", onAbort);
+                        reject(e);
+                    }
+                })();
+            });
+        },
+    };
+}
+/** Default ls tool using process.cwd() - for backwards compatibility */
+export const lsTool = createLsTool(process.cwd());
+//# sourceMappingURL=ls.js.map

package/dist/core/tools/ls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ls.js","sourceRoot":"","sources":["../../../src/core/tools/ls.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentTool } from \"@mariozechner/pi-agent-core\";\r\nimport { type Static, Type } from \"@sinclair/typebox\";\r\nimport { existsSync, readdirSync, statSync } from \"fs\";\r\nimport nodePath from \"path\";\r\nimport { resolveToCwd } from \"./path-utils.js\";\r\nimport { DEFAULT_MAX_BYTES, formatSize, type TruncationResult, truncateHead } from \"./truncate.js\";\r\n\r\nconst lsSchema = Type.Object({\r\n\tpath: Type.Optional(Type.String({ description: \"Directory to list (default: current directory)\" })),\r\n\tlimit: Type.Optional(Type.Number({ description: \"Maximum number of entries to return (default: 500)\" })),\r\n});\r\n\r\nexport type LsToolInput = Static<typeof lsSchema>;\r\n\r\nconst DEFAULT_LIMIT = 500;\r\n\r\nexport interface LsToolDetails {\r\n\ttruncation?: TruncationResult;\r\n\tentryLimitReached?: number;\r\n}\r\n\r\n/**\r\n * Pluggable operations for the ls tool.\r\n * Override these to delegate directory listing to remote systems (e.g., SSH).\r\n */\r\nexport interface LsOperations {\r\n\t/** Check if path exists */\r\n\texists: (absolutePath: string) => Promise<boolean> | boolean;\r\n\t/** Get file/directory stats. Throws if not found. */\r\n\tstat: (absolutePath: string) => Promise<{ isDirectory: () => boolean }> | { isDirectory: () => boolean };\r\n\t/** Read directory entries */\r\n\treaddir: (absolutePath: string) => Promise<string[]> | string[];\r\n}\r\n\r\nconst defaultLsOperations: LsOperations = {\r\n\texists: existsSync,\r\n\tstat: statSync,\r\n\treaddir: readdirSync,\r\n};\r\n\r\nexport interface LsToolOptions {\r\n\t/** Custom operations for directory listing. Default: local filesystem */\r\n\toperations?: LsOperations;\r\n}\r\n\r\nexport function createLsTool(cwd: string, options?: LsToolOptions): AgentTool<typeof lsSchema> {\r\n\tconst ops = options?.operations ?? defaultLsOperations;\r\n\r\n\treturn {\r\n\t\tname: \"ls\",\r\n\t\tlabel: \"ls\",\r\n\t\tdescription: `List directory contents. Returns entries sorted alphabetically, with '/' suffix for directories. Includes dotfiles. Output is truncated to ${DEFAULT_LIMIT} entries or ${DEFAULT_MAX_BYTES / 1024}KB (whichever is hit first).`,\r\n\t\tparameters: lsSchema,\r\n\t\texecute: async (\r\n\t\t\t_toolCallId: string,\r\n\t\t\t{ path, limit }: { path?: string; limit?: number },\r\n\t\t\tsignal?: AbortSignal,\r\n\t\t) => {\r\n\t\t\treturn new Promise((resolve, reject) => {\r\n\t\t\t\tif (signal?.aborted) {\r\n\t\t\t\t\treject(new Error(\"Operation aborted\"));\r\n\t\t\t\t\treturn;\r\n\t\t\t\t}\r\n\r\n\t\t\t\tconst onAbort = () => reject(new Error(\"Operation aborted\"));\r\n\t\t\t\tsignal?.addEventListener(\"abort\", onAbort, { once: true });\r\n\r\n\t\t\t\t(async () => {\r\n\t\t\t\t\ttry {\r\n\t\t\t\t\t\tconst dirPath = resolveToCwd(path || \".\", cwd);\r\n\t\t\t\t\t\tconst effectiveLimit = limit ?? DEFAULT_LIMIT;\r\n\r\n\t\t\t\t\t\t// Check if path exists\r\n\t\t\t\t\t\tif (!(await ops.exists(dirPath))) {\r\n\t\t\t\t\t\t\treject(new Error(`Path not found: ${dirPath}`));\r\n\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t// Check if path is a directory\r\n\t\t\t\t\t\tconst stat = await ops.stat(dirPath);\r\n\t\t\t\t\t\tif (!stat.isDirectory()) {\r\n\t\t\t\t\t\t\treject(new Error(`Not a directory: ${dirPath}`));\r\n\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t// Read directory entries\r\n\t\t\t\t\t\tlet entries: string[];\r\n\t\t\t\t\t\ttry {\r\n\t\t\t\t\t\t\tentries = await ops.readdir(dirPath);\r\n\t\t\t\t\t\t} catch (e: any) {\r\n\t\t\t\t\t\t\treject(new Error(`Cannot read directory: ${e.message}`));\r\n\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t// Sort alphabetically (case-insensitive)\r\n\t\t\t\t\t\tentries.sort((a, b) => a.toLowerCase().localeCompare(b.toLowerCase()));\r\n\r\n\t\t\t\t\t\t// Format entries with directory indicators\r\n\t\t\t\t\t\tconst results: string[] = [];\r\n\t\t\t\t\t\tlet entryLimitReached = false;\r\n\r\n\t\t\t\t\t\tfor (const entry of entries) {\r\n\t\t\t\t\t\t\tif (results.length >= effectiveLimit) {\r\n\t\t\t\t\t\t\t\tentryLimitReached = true;\r\n\t\t\t\t\t\t\t\tbreak;\r\n\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\tconst fullPath = nodePath.join(dirPath, entry);\r\n\t\t\t\t\t\t\tlet suffix = \"\";\r\n\r\n\t\t\t\t\t\t\ttry {\r\n\t\t\t\t\t\t\t\tconst entryStat = await ops.stat(fullPath);\r\n\t\t\t\t\t\t\t\tif (entryStat.isDirectory()) {\r\n\t\t\t\t\t\t\t\t\tsuffix = \"/\";\r\n\t\t\t\t\t\t\t\t}\r\n\t\t\t\t\t\t\t} catch {\r\n\t\t\t\t\t\t\t\t// Skip entries we can't stat\r\n\t\t\t\t\t\t\t\tcontinue;\r\n\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\tresults.push(entry + suffix);\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\r\n\r\n\t\t\t\t\t\tif (results.length === 0) {\r\n\t\t\t\t\t\t\tresolve({ content: [{ type: \"text\", text: \"(empty directory)\" }], details: undefined });\r\n\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t// Apply byte truncation (no line limit since we already have entry limit)\r\n\t\t\t\t\t\tconst rawOutput = results.join(\"\\n\");\r\n\t\t\t\t\t\tconst truncation = truncateHead(rawOutput, { maxLines: Number.MAX_SAFE_INTEGER });\r\n\r\n\t\t\t\t\t\tlet output = truncation.content;\r\n\t\t\t\t\t\tconst details: LsToolDetails = {};\r\n\r\n\t\t\t\t\t\t// Build notices\r\n\t\t\t\t\t\tconst notices: string[] = [];\r\n\r\n\t\t\t\t\t\tif (entryLimitReached) {\r\n\t\t\t\t\t\t\tnotices.push(`${effectiveLimit} entries limit reached. Use limit=${effectiveLimit * 2} for more`);\r\n\t\t\t\t\t\t\tdetails.entryLimitReached = effectiveLimit;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tif (truncation.truncated) {\r\n\t\t\t\t\t\t\tnotices.push(`${formatSize(DEFAULT_MAX_BYTES)} limit reached`);\r\n\t\t\t\t\t\t\tdetails.truncation = truncation;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tif (notices.length > 0) {\r\n\t\t\t\t\t\t\toutput += `\\n\\n[${notices.join(\". \")}]`;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tresolve({\r\n\t\t\t\t\t\t\tcontent: [{ type: \"text\", text: output }],\r\n\t\t\t\t\t\t\tdetails: Object.keys(details).length > 0 ? details : undefined,\r\n\t\t\t\t\t\t});\r\n\t\t\t\t\t} catch (e: any) {\r\n\t\t\t\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\r\n\t\t\t\t\t\treject(e);\r\n\t\t\t\t\t}\r\n\t\t\t\t})();\r\n\t\t\t});\r\n\t\t},\r\n\t};\r\n}\r\n\r\n/** Default ls tool using process.cwd() - for backwards compatibility */\r\nexport const lsTool = createLsTool(process.cwd());\r\n"]}

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

@@ -0,0 +1,45 @@
+/**
+ * Built-in memory tools: memory_write, memory_read, memory_update, memory_delete
+ */
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+export interface MemoryToolContext {
+    cwd: string;
+    sessionId: string;
+}
+export declare function setMemoryToolContext(ctx: MemoryToolContext): void;
+declare const memoryWriteSchema: import("@sinclair/typebox").TObject<{
+    type: import("@sinclair/typebox").TUnsafe<"episodic" | "procedural" | "semantic">;
+    name: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    trigger: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    steps: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    summary: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    details: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    category: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnsafe<"architecture" | "convention" | "fact" | "preference">>;
+    text: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    tags: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    reflection_mistakes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    reflection_lessons: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+}>;
+declare const memoryReadSchema: import("@sinclair/typebox").TObject<{
+    type: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnsafe<"all" | "episodic" | "procedural" | "semantic">>;
+    id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    query: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+declare const memoryUpdateSchema: import("@sinclair/typebox").TObject<{
+    id: import("@sinclair/typebox").TString;
+    text: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    steps: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    trigger: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    tags: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+}>;
+declare const memoryDeleteSchema: import("@sinclair/typebox").TObject<{
+    id: import("@sinclair/typebox").TString;
+}>;
+export declare const memoryWriteTool: AgentTool<typeof memoryWriteSchema>;
+export declare const memoryReadTool: AgentTool<typeof memoryReadSchema>;
+export declare const memoryUpdateTool: AgentTool<typeof memoryUpdateSchema>;
+export declare const memoryDeleteTool: AgentTool<typeof memoryDeleteSchema>;
+/** All memory tools */
+export declare const memoryTools: AgentTool<any>[];
+export {};
+//# sourceMappingURL=memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/core/tools/memory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAiB7D,MAAM,WAAW,iBAAiB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CAClB;AAID,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI,CAEjE;AAMD,QAAA,MAAM,iBAAiB;;;;;;;;;;;;EAsBrB,CAAC;AAIH,QAAA,MAAM,gBAAgB;;;;EAIpB,CAAC;AAIH,QAAA,MAAM,kBAAkB;;;;;;EAMtB,CAAC;AAIH,QAAA,MAAM,kBAAkB;;EAEtB,CAAC;AAQH,eAAO,MAAM,eAAe,EAAE,SAAS,CAAC,OAAO,iBAAiB,CAuH/D,CAAC;AAMF,eAAO,MAAM,cAAc,EAAE,SAAS,CAAC,OAAO,gBAAgB,CAyG7D,CAAC;AAMF,eAAO,MAAM,gBAAgB,EAAE,SAAS,CAAC,OAAO,kBAAkB,CAqDjE,CAAC;AAMF,eAAO,MAAM,gBAAgB,EAAE,SAAS,CAAC,OAAO,kBAAkB,CA6BjE,CAAC;AAEF,uBAAuB;AACvB,eAAO,MAAM,WAAW,EAAE,SAAS,CAAC,GAAG,CAAC,EAA0E,CAAC","sourcesContent":["/**\r\n * Built-in memory tools: memory_write, memory_read, memory_update, memory_delete\r\n */\r\n\r\nimport type { AgentTool } from \"@mariozechner/pi-agent-core\";\r\nimport { StringEnum } from \"@mariozechner/pi-ai\";\r\nimport { type Static, Type } from \"@sinclair/typebox\";\r\nimport {\r\n\ttype EpisodicMemory,\r\n\tformatEpisodicForDisplay,\r\n\tformatProceduralForDisplay,\r\n\tformatSemanticForDisplay,\r\n\tgenerateId,\r\n\tloadStore,\r\n\tnowISO,\r\n\ttype ProceduralMemory,\r\n\ttype SemanticMemory,\r\n\tsaveStore,\r\n\tsearchMemories,\r\n} from \"../memory.js\";\r\n\r\nexport interface MemoryToolContext {\r\n\tcwd: string;\r\n\tsessionId: string;\r\n}\r\n\r\nlet memoryContext: MemoryToolContext = { cwd: process.cwd(), sessionId: `session_${Date.now()}` };\r\n\r\nexport function setMemoryToolContext(ctx: MemoryToolContext): void {\r\n\tmemoryContext = ctx;\r\n}\r\n\r\n// ---------------------------------------------------------------------------\r\n// Schemas\r\n// ---------------------------------------------------------------------------\r\n\r\nconst memoryWriteSchema = Type.Object({\r\n\ttype: StringEnum([\"procedural\", \"episodic\", \"semantic\"] as const),\r\n\tname: Type.Optional(Type.String({ description: \"Name for procedural memories (e.g., 'deploy-service')\" })),\r\n\ttrigger: Type.Optional(\r\n\t\tType.String({ description: \"When to invoke this procedure (e.g., 'user asks to deploy a service')\" }),\r\n\t),\r\n\tsteps: Type.Optional(Type.Array(Type.String(), { description: \"Steps for procedural memory\" })),\r\n\tsummary: Type.Optional(Type.String({ description: \"Summary for episodic memory\" })),\r\n\tdetails: Type.Optional(Type.Array(Type.String(), { description: \"Details for episodic memory\" })),\r\n\tcategory: Type.Optional(\r\n\t\tStringEnum([\"preference\", \"architecture\", \"convention\", \"fact\"] as const, {\r\n\t\t\tdescription: \"Category for semantic memory\",\r\n\t\t}),\r\n\t),\r\n\ttext: Type.Optional(Type.String({ description: \"Text content for semantic memory\" })),\r\n\ttags: Type.Optional(Type.Array(Type.String(), { description: \"Tags for searchability\" })),\r\n\treflection_mistakes: Type.Optional(\r\n\t\tType.Array(Type.String(), { description: \"Mistakes made (for episodic reflection)\" }),\r\n\t),\r\n\treflection_lessons: Type.Optional(\r\n\t\tType.Array(Type.String(), { description: \"Lessons learned (for episodic reflection)\" }),\r\n\t),\r\n});\r\n\r\ntype MemoryWriteInput = Static<typeof memoryWriteSchema>;\r\n\r\nconst memoryReadSchema = Type.Object({\r\n\ttype: Type.Optional(StringEnum([\"procedural\", \"episodic\", \"semantic\", \"all\"] as const)),\r\n\tid: Type.Optional(Type.String({ description: \"Specific memory ID to retrieve\" })),\r\n\tquery: Type.Optional(Type.String({ description: \"Search query to find relevant memories\" })),\r\n});\r\n\r\ntype MemoryReadInput = Static<typeof memoryReadSchema>;\r\n\r\nconst memoryUpdateSchema = Type.Object({\r\n\tid: Type.String({ description: \"Memory ID to update\" }),\r\n\ttext: Type.Optional(Type.String({ description: \"New text (for semantic memories)\" })),\r\n\tsteps: Type.Optional(Type.Array(Type.String(), { description: \"New steps (for procedural memories)\" })),\r\n\ttrigger: Type.Optional(Type.String({ description: \"New trigger (for procedural memories)\" })),\r\n\ttags: Type.Optional(Type.Array(Type.String(), { description: \"Replace tags\" })),\r\n});\r\n\r\ntype MemoryUpdateInput = Static<typeof memoryUpdateSchema>;\r\n\r\nconst memoryDeleteSchema = Type.Object({\r\n\tid: Type.String({ description: \"Memory ID to delete (e.g., 'proc_001', 'sem_003')\" }),\r\n});\r\n\r\ntype MemoryDeleteInput = Static<typeof memoryDeleteSchema>;\r\n\r\n// ---------------------------------------------------------------------------\r\n// memory_write\r\n// ---------------------------------------------------------------------------\r\n\r\nexport const memoryWriteTool: AgentTool<typeof memoryWriteSchema> = {\r\n\tname: \"memory_write\",\r\n\tlabel: \"Write Memory\",\r\n\tdescription:\r\n\t\t\"Save a memory to the persistent memory system. Use this automatically when: \" +\r\n\t\t\"(1) the user teaches you a multi-step workflow — save as 'procedural', \" +\r\n\t\t\"(2) the user states a preference, rule, or fact — save as 'semantic', \" +\r\n\t\t\"(3) a significant task completes — save as 'episodic'. \" +\r\n\t\t\"Do NOT ask the user for permission to save unless there is a conflict with an existing memory.\",\r\n\tparameters: memoryWriteSchema,\r\n\texecute: async (_toolCallId: string, params: MemoryWriteInput) => {\r\n\t\tconst { cwd, sessionId } = memoryContext;\r\n\t\tconst tags = params.tags ?? [];\r\n\r\n\t\tif (params.type === \"procedural\") {\r\n\t\t\tif (!params.name || !params.trigger || !params.steps?.length) {\r\n\t\t\t\treturn {\r\n\t\t\t\t\tcontent: [{ type: \"text\", text: \"Error: procedural memory requires name, trigger, and steps.\" }],\r\n\t\t\t\t\tdetails: {},\r\n\t\t\t\t};\r\n\t\t\t}\r\n\t\t\tconst store = loadStore<ProceduralMemory>(cwd, \"procedural.json\");\r\n\t\t\tconst existing = store.memories.find((m) => m.name === params.name);\r\n\t\t\tif (existing) {\r\n\t\t\t\texisting.steps = params.steps;\r\n\t\t\t\texisting.trigger = params.trigger;\r\n\t\t\t\texisting.tags = [...new Set([...existing.tags, ...tags])];\r\n\t\t\t\texisting.updated = nowISO();\r\n\t\t\t\tsaveStore(cwd, \"procedural.json\", store);\r\n\t\t\t\treturn {\r\n\t\t\t\t\tcontent: [{ type: \"text\", text: `Updated procedural memory [${existing.id}] \"${params.name}\".` }],\r\n\t\t\t\t\tdetails: { action: \"updated\", id: existing.id },\r\n\t\t\t\t};\r\n\t\t\t}\r\n\t\t\tconst id = generateId(\"proc\", store);\r\n\t\t\tstore.memories.push({\r\n\t\t\t\tid,\r\n\t\t\t\tname: params.name,\r\n\t\t\t\ttrigger: params.trigger,\r\n\t\t\t\tsteps: params.steps,\r\n\t\t\t\ttags,\r\n\t\t\t\tcreated: nowISO(),\r\n\t\t\t\tupdated: nowISO(),\r\n\t\t\t\tsourceSession: sessionId,\r\n\t\t\t});\r\n\t\t\tsaveStore(cwd, \"procedural.json\", store);\r\n\t\t\treturn {\r\n\t\t\t\tcontent: [{ type: \"text\", text: `Saved procedural memory [${id}] \"${params.name}\".` }],\r\n\t\t\t\tdetails: { action: \"created\", id },\r\n\t\t\t};\r\n\t\t}\r\n\r\n\t\tif (params.type === \"episodic\") {\r\n\t\t\tif (!params.summary) {\r\n\t\t\t\treturn {\r\n\t\t\t\t\tcontent: [{ type: \"text\", text: \"Error: episodic memory requires a summary.\" }],\r\n\t\t\t\t\tdetails: {},\r\n\t\t\t\t};\r\n\t\t\t}\r\n\t\t\tconst store = loadStore<EpisodicMemory>(cwd, \"episodic.json\");\r\n\t\t\tconst id = generateId(\"ep\", store);\r\n\t\t\tconst reflection =\r\n\t\t\t\tparams.reflection_mistakes?.length || params.reflection_lessons?.length\r\n\t\t\t\t\t? { mistakes: params.reflection_mistakes ?? [], lessons: params.reflection_lessons ?? [] }\r\n\t\t\t\t\t: undefined;\r\n\t\t\tstore.memories.push({\r\n\t\t\t\tid,\r\n\t\t\t\tsummary: params.summary,\r\n\t\t\t\tdetails: params.details ?? [],\r\n\t\t\t\treflection,\r\n\t\t\t\ttags,\r\n\t\t\t\tdate: new Date().toISOString().split(\"T\")[0],\r\n\t\t\t\tsourceSession: sessionId,\r\n\t\t\t});\r\n\t\t\tsaveStore(cwd, \"episodic.json\", store);\r\n\t\t\treturn {\r\n\t\t\t\tcontent: [{ type: \"text\", text: `Saved episodic memory [${id}] \"${params.summary}\".` }],\r\n\t\t\t\tdetails: { action: \"created\", id },\r\n\t\t\t};\r\n\t\t}\r\n\r\n\t\tif (params.type === \"semantic\") {\r\n\t\t\tif (!params.text || !params.category) {\r\n\t\t\t\treturn {\r\n\t\t\t\t\tcontent: [{ type: \"text\", text: \"Error: semantic memory requires text and category.\" }],\r\n\t\t\t\t\tdetails: {},\r\n\t\t\t\t};\r\n\t\t\t}\r\n\t\t\tconst store = loadStore<SemanticMemory>(cwd, \"semantic.json\");\r\n\t\t\tconst existing = store.memories.find(\r\n\t\t\t\t(m) => m.category === params.category && m.text.toLowerCase() === params.text!.toLowerCase(),\r\n\t\t\t);\r\n\t\t\tif (existing) {\r\n\t\t\t\treturn {\r\n\t\t\t\t\tcontent: [{ type: \"text\", text: `This semantic memory already exists [${existing.id}].` }],\r\n\t\t\t\t\tdetails: { action: \"duplicate\", id: existing.id },\r\n\t\t\t\t};\r\n\t\t\t}\r\n\t\t\tconst id = generateId(\"sem\", store);\r\n\t\t\tstore.memories.push({\r\n\t\t\t\tid,\r\n\t\t\t\tcategory: params.category,\r\n\t\t\t\ttext: params.text,\r\n\t\t\t\ttags,\r\n\t\t\t\tcreated: nowISO(),\r\n\t\t\t\tsourceSession: sessionId,\r\n\t\t\t});\r\n\t\t\tsaveStore(cwd, \"semantic.json\", store);\r\n\t\t\treturn {\r\n\t\t\t\tcontent: [{ type: \"text\", text: `Saved semantic memory [${id}] (${params.category}): \"${params.text}\".` }],\r\n\t\t\t\tdetails: { action: \"created\", id },\r\n\t\t\t};\r\n\t\t}\r\n\r\n\t\treturn {\r\n\t\t\tcontent: [{ type: \"text\", text: `Unknown memory type: ${params.type}` }],\r\n\t\t\tdetails: {},\r\n\t\t};\r\n\t},\r\n};\r\n\r\n// ---------------------------------------------------------------------------\r\n// memory_read\r\n// ---------------------------------------------------------------------------\r\n\r\nexport const memoryReadTool: AgentTool<typeof memoryReadSchema> = {\r\n\tname: \"memory_read\",\r\n\tlabel: \"Read Memory\",\r\n\tdescription:\r\n\t\t\"Read memories from the persistent memory system. Use this when you need to recall \" +\r\n\t\t\"past workflows, user preferences, or what happened in previous sessions. \" +\r\n\t\t\"You can read all memories of a type, a specific memory by ID, or search by query.\",\r\n\tparameters: memoryReadSchema,\r\n\texecute: async (_toolCallId: string, params: MemoryReadInput) => {\r\n\t\tconst { cwd } = memoryContext;\r\n\r\n\t\tif (params.id) {\r\n\t\t\tconst allStores: Array<{ file: string; format: (m: any) => string }> = [\r\n\t\t\t\t{ file: \"procedural.json\", format: formatProceduralForDisplay },\r\n\t\t\t\t{ file: \"episodic.json\", format: formatEpisodicForDisplay },\r\n\t\t\t\t{ file: \"semantic.json\", format: formatSemanticForDisplay },\r\n\t\t\t];\r\n\t\t\tfor (const { file, format } of allStores) {\r\n\t\t\t\tconst store = loadStore<{ id: string }>(cwd, file);\r\n\t\t\t\tconst found = store.memories.find((m) => m.id === params.id);\r\n\t\t\t\tif (found) {\r\n\t\t\t\t\treturn {\r\n\t\t\t\t\t\tcontent: [{ type: \"text\", text: format(found) }],\r\n\t\t\t\t\t\tdetails: { found: true },\r\n\t\t\t\t\t};\r\n\t\t\t\t}\r\n\t\t\t}\r\n\t\t\treturn {\r\n\t\t\t\tcontent: [{ type: \"text\", text: `No memory found with ID \"${params.id}\".` }],\r\n\t\t\t\tdetails: { found: false },\r\n\t\t\t};\r\n\t\t}\r\n\r\n\t\tif (params.query) {\r\n\t\t\tconst results: string[] = [];\r\n\t\t\tconst type = params.type ?? \"all\";\r\n\r\n\t\t\tif (type === \"all\" || type === \"procedural\") {\r\n\t\t\t\tconst store = loadStore<ProceduralMemory>(cwd, \"procedural.json\");\r\n\t\t\t\tconst matches = searchMemories(\r\n\t\t\t\t\tstore.memories,\r\n\t\t\t\t\tparams.query,\r\n\t\t\t\t\t(m) => `${m.name} ${m.trigger} ${m.steps.join(\" \")}`,\r\n\t\t\t\t);\r\n\t\t\t\tresults.push(...matches.map(formatProceduralForDisplay));\r\n\t\t\t}\r\n\t\t\tif (type === \"all\" || type === \"episodic\") {\r\n\t\t\t\tconst store = loadStore<EpisodicMemory>(cwd, \"episodic.json\");\r\n\t\t\t\tconst matches = searchMemories(store.memories, params.query, (m) => `${m.summary} ${m.details.join(\" \")}`);\r\n\t\t\t\tresults.push(...matches.map(formatEpisodicForDisplay));\r\n\t\t\t}\r\n\t\t\tif (type === \"all\" || type === \"semantic\") {\r\n\t\t\t\tconst store = loadStore<SemanticMemory>(cwd, \"semantic.json\");\r\n\t\t\t\tconst matches = searchMemories(store.memories, params.query, (m) => `${m.category} ${m.text}`);\r\n\t\t\t\tresults.push(...matches.map(formatSemanticForDisplay));\r\n\t\t\t}\r\n\r\n\t\t\tif (results.length === 0) {\r\n\t\t\t\treturn {\r\n\t\t\t\t\tcontent: [{ type: \"text\", text: `No memories found matching \"${params.query}\".` }],\r\n\t\t\t\t\tdetails: { count: 0 },\r\n\t\t\t\t};\r\n\t\t\t}\r\n\t\t\treturn {\r\n\t\t\t\tcontent: [{ type: \"text\", text: results.join(\"\\n\\n\") }],\r\n\t\t\t\tdetails: { count: results.length },\r\n\t\t\t};\r\n\t\t}\r\n\r\n\t\tconst type = params.type ?? \"all\";\r\n\t\tconst results: string[] = [];\r\n\r\n\t\tif (type === \"all\" || type === \"procedural\") {\r\n\t\t\tconst store = loadStore<ProceduralMemory>(cwd, \"procedural.json\");\r\n\t\t\tif (store.memories.length > 0) {\r\n\t\t\t\tresults.push(\"=== Procedural Memories ===\");\r\n\t\t\t\tresults.push(...store.memories.map(formatProceduralForDisplay));\r\n\t\t\t}\r\n\t\t}\r\n\t\tif (type === \"all\" || type === \"episodic\") {\r\n\t\t\tconst store = loadStore<EpisodicMemory>(cwd, \"episodic.json\");\r\n\t\t\tif (store.memories.length > 0) {\r\n\t\t\t\tresults.push(\"=== Episodic Memories ===\");\r\n\t\t\t\tresults.push(...store.memories.map(formatEpisodicForDisplay));\r\n\t\t\t}\r\n\t\t}\r\n\t\tif (type === \"all\" || type === \"semantic\") {\r\n\t\t\tconst store = loadStore<SemanticMemory>(cwd, \"semantic.json\");\r\n\t\t\tif (store.memories.length > 0) {\r\n\t\t\t\tresults.push(\"=== Semantic Memories ===\");\r\n\t\t\t\tresults.push(...store.memories.map(formatSemanticForDisplay));\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\tif (results.length === 0) {\r\n\t\t\treturn {\r\n\t\t\t\tcontent: [{ type: \"text\", text: \"No memories stored yet.\" }],\r\n\t\t\t\tdetails: { count: 0 },\r\n\t\t\t};\r\n\t\t}\r\n\t\treturn {\r\n\t\t\tcontent: [{ type: \"text\", text: results.join(\"\\n\\n\") }],\r\n\t\t\tdetails: { count: results.length },\r\n\t\t};\r\n\t},\r\n};\r\n\r\n// ---------------------------------------------------------------------------\r\n// memory_update\r\n// ---------------------------------------------------------------------------\r\n\r\nexport const memoryUpdateTool: AgentTool<typeof memoryUpdateSchema> = {\r\n\tname: \"memory_update\",\r\n\tlabel: \"Update Memory\",\r\n\tdescription:\r\n\t\t\"Update an existing memory. Use this when the user confirms a change to a \" +\r\n\t\t\"previously stored preference, procedure step, or fact. Always ask for \" +\r\n\t\t\"confirmation before updating if there is a conflict.\",\r\n\tparameters: memoryUpdateSchema,\r\n\texecute: async (_toolCallId: string, params: MemoryUpdateInput) => {\r\n\t\tconst { cwd } = memoryContext;\r\n\r\n\t\tconst procStore = loadStore<ProceduralMemory>(cwd, \"procedural.json\");\r\n\t\tconst proc = procStore.memories.find((m) => m.id === params.id);\r\n\t\tif (proc) {\r\n\t\t\tif (params.steps) proc.steps = params.steps;\r\n\t\t\tif (params.trigger) proc.trigger = params.trigger;\r\n\t\t\tif (params.tags) proc.tags = params.tags;\r\n\t\t\tproc.updated = nowISO();\r\n\t\t\tsaveStore(cwd, \"procedural.json\", procStore);\r\n\t\t\treturn {\r\n\t\t\t\tcontent: [{ type: \"text\", text: `Updated procedural memory [${params.id}].` }],\r\n\t\t\t\tdetails: { updated: true },\r\n\t\t\t};\r\n\t\t}\r\n\r\n\t\tconst semStore = loadStore<SemanticMemory>(cwd, \"semantic.json\");\r\n\t\tconst sem = semStore.memories.find((m) => m.id === params.id);\r\n\t\tif (sem) {\r\n\t\t\tif (params.text) sem.text = params.text;\r\n\t\t\tif (params.tags) sem.tags = params.tags;\r\n\t\t\tsaveStore(cwd, \"semantic.json\", semStore);\r\n\t\t\treturn {\r\n\t\t\t\tcontent: [{ type: \"text\", text: `Updated semantic memory [${params.id}].` }],\r\n\t\t\t\tdetails: { updated: true },\r\n\t\t\t};\r\n\t\t}\r\n\r\n\t\tconst epStore = loadStore<EpisodicMemory>(cwd, \"episodic.json\");\r\n\t\tconst ep = epStore.memories.find((m) => m.id === params.id);\r\n\t\tif (ep) {\r\n\t\t\tif (params.tags) ep.tags = params.tags;\r\n\t\t\tsaveStore(cwd, \"episodic.json\", epStore);\r\n\t\t\treturn {\r\n\t\t\t\tcontent: [{ type: \"text\", text: `Updated episodic memory [${params.id}].` }],\r\n\t\t\t\tdetails: { updated: true },\r\n\t\t\t};\r\n\t\t}\r\n\r\n\t\treturn {\r\n\t\t\tcontent: [{ type: \"text\", text: `No memory found with ID \"${params.id}\".` }],\r\n\t\t\tdetails: { updated: false },\r\n\t\t};\r\n\t},\r\n};\r\n\r\n// ---------------------------------------------------------------------------\r\n// memory_delete\r\n// ---------------------------------------------------------------------------\r\n\r\nexport const memoryDeleteTool: AgentTool<typeof memoryDeleteSchema> = {\r\n\tname: \"memory_delete\",\r\n\tlabel: \"Delete Memory\",\r\n\tdescription:\r\n\t\t\"Delete a specific memory by ID. Use this when the user asks to remove a memory \" +\r\n\t\t\"or when a memory is confirmed to be outdated.\",\r\n\tparameters: memoryDeleteSchema,\r\n\texecute: async (_toolCallId: string, params: MemoryDeleteInput) => {\r\n\t\tconst { cwd } = memoryContext;\r\n\t\tconst files = [\"procedural.json\", \"episodic.json\", \"semantic.json\"] as const;\r\n\r\n\t\tfor (const file of files) {\r\n\t\t\tconst store = loadStore<{ id: string }>(cwd, file);\r\n\t\t\tconst idx = store.memories.findIndex((m) => m.id === params.id);\r\n\t\t\tif (idx !== -1) {\r\n\t\t\t\tstore.memories.splice(idx, 1);\r\n\t\t\t\tsaveStore(cwd, file, store);\r\n\t\t\t\treturn {\r\n\t\t\t\t\tcontent: [{ type: \"text\", text: `Deleted memory [${params.id}] from ${file.replace(\".json\", \"\")}.` }],\r\n\t\t\t\t\tdetails: { deleted: true },\r\n\t\t\t\t};\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\treturn {\r\n\t\t\tcontent: [{ type: \"text\", text: `No memory found with ID \"${params.id}\".` }],\r\n\t\t\tdetails: { deleted: false },\r\n\t\t};\r\n\t},\r\n};\r\n\r\n/** All memory tools */\r\nexport const memoryTools: AgentTool<any>[] = [memoryWriteTool, memoryReadTool, memoryUpdateTool, memoryDeleteTool];\r\n"]}

package/dist/core/tools/memory.js

@@ -0,0 +1,346 @@
+/**
+ * Built-in memory tools: memory_write, memory_read, memory_update, memory_delete
+ */
+import { StringEnum } from "@mariozechner/pi-ai";
+import { Type } from "@sinclair/typebox";
+import { formatEpisodicForDisplay, formatProceduralForDisplay, formatSemanticForDisplay, generateId, loadStore, nowISO, saveStore, searchMemories, } from "../memory.js";
+let memoryContext = { cwd: process.cwd(), sessionId: `session_${Date.now()}` };
+export function setMemoryToolContext(ctx) {
+    memoryContext = ctx;
+}
+// ---------------------------------------------------------------------------
+// Schemas
+// ---------------------------------------------------------------------------
+const memoryWriteSchema = Type.Object({
+    type: StringEnum(["procedural", "episodic", "semantic"]),
+    name: Type.Optional(Type.String({ description: "Name for procedural memories (e.g., 'deploy-service')" })),
+    trigger: Type.Optional(Type.String({ description: "When to invoke this procedure (e.g., 'user asks to deploy a service')" })),
+    steps: Type.Optional(Type.Array(Type.String(), { description: "Steps for procedural memory" })),
+    summary: Type.Optional(Type.String({ description: "Summary for episodic memory" })),
+    details: Type.Optional(Type.Array(Type.String(), { description: "Details for episodic memory" })),
+    category: Type.Optional(StringEnum(["preference", "architecture", "convention", "fact"], {
+        description: "Category for semantic memory",
+    })),
+    text: Type.Optional(Type.String({ description: "Text content for semantic memory" })),
+    tags: Type.Optional(Type.Array(Type.String(), { description: "Tags for searchability" })),
+    reflection_mistakes: Type.Optional(Type.Array(Type.String(), { description: "Mistakes made (for episodic reflection)" })),
+    reflection_lessons: Type.Optional(Type.Array(Type.String(), { description: "Lessons learned (for episodic reflection)" })),
+});
+const memoryReadSchema = Type.Object({
+    type: Type.Optional(StringEnum(["procedural", "episodic", "semantic", "all"])),
+    id: Type.Optional(Type.String({ description: "Specific memory ID to retrieve" })),
+    query: Type.Optional(Type.String({ description: "Search query to find relevant memories" })),
+});
+const memoryUpdateSchema = Type.Object({
+    id: Type.String({ description: "Memory ID to update" }),
+    text: Type.Optional(Type.String({ description: "New text (for semantic memories)" })),
+    steps: Type.Optional(Type.Array(Type.String(), { description: "New steps (for procedural memories)" })),
+    trigger: Type.Optional(Type.String({ description: "New trigger (for procedural memories)" })),
+    tags: Type.Optional(Type.Array(Type.String(), { description: "Replace tags" })),
+});
+const memoryDeleteSchema = Type.Object({
+    id: Type.String({ description: "Memory ID to delete (e.g., 'proc_001', 'sem_003')" }),
+});
+// ---------------------------------------------------------------------------
+// memory_write
+// ---------------------------------------------------------------------------
+export const memoryWriteTool = {
+    name: "memory_write",
+    label: "Write Memory",
+    description: "Save a memory to the persistent memory system. Use this automatically when: " +
+        "(1) the user teaches you a multi-step workflow — save as 'procedural', " +
+        "(2) the user states a preference, rule, or fact — save as 'semantic', " +
+        "(3) a significant task completes — save as 'episodic'. " +
+        "Do NOT ask the user for permission to save unless there is a conflict with an existing memory.",
+    parameters: memoryWriteSchema,
+    execute: async (_toolCallId, params) => {
+        const { cwd, sessionId } = memoryContext;
+        const tags = params.tags ?? [];
+        if (params.type === "procedural") {
+            if (!params.name || !params.trigger || !params.steps?.length) {
+                return {
+                    content: [{ type: "text", text: "Error: procedural memory requires name, trigger, and steps." }],
+                    details: {},
+                };
+            }
+            const store = loadStore(cwd, "procedural.json");
+            const existing = store.memories.find((m) => m.name === params.name);
+            if (existing) {
+                existing.steps = params.steps;
+                existing.trigger = params.trigger;
+                existing.tags = [...new Set([...existing.tags, ...tags])];
+                existing.updated = nowISO();
+                saveStore(cwd, "procedural.json", store);
+                return {
+                    content: [{ type: "text", text: `Updated procedural memory [${existing.id}] "${params.name}".` }],
+                    details: { action: "updated", id: existing.id },
+                };
+            }
+            const id = generateId("proc", store);
+            store.memories.push({
+                id,
+                name: params.name,
+                trigger: params.trigger,
+                steps: params.steps,
+                tags,
+                created: nowISO(),
+                updated: nowISO(),
+                sourceSession: sessionId,
+            });
+            saveStore(cwd, "procedural.json", store);
+            return {
+                content: [{ type: "text", text: `Saved procedural memory [${id}] "${params.name}".` }],
+                details: { action: "created", id },
+            };
+        }
+        if (params.type === "episodic") {
+            if (!params.summary) {
+                return {
+                    content: [{ type: "text", text: "Error: episodic memory requires a summary." }],
+                    details: {},
+                };
+            }
+            const store = loadStore(cwd, "episodic.json");
+            const id = generateId("ep", store);
+            const reflection = params.reflection_mistakes?.length || params.reflection_lessons?.length
+                ? { mistakes: params.reflection_mistakes ?? [], lessons: params.reflection_lessons ?? [] }
+                : undefined;
+            store.memories.push({
+                id,
+                summary: params.summary,
+                details: params.details ?? [],
+                reflection,
+                tags,
+                date: new Date().toISOString().split("T")[0],
+                sourceSession: sessionId,
+            });
+            saveStore(cwd, "episodic.json", store);
+            return {
+                content: [{ type: "text", text: `Saved episodic memory [${id}] "${params.summary}".` }],
+                details: { action: "created", id },
+            };
+        }
+        if (params.type === "semantic") {
+            if (!params.text || !params.category) {
+                return {
+                    content: [{ type: "text", text: "Error: semantic memory requires text and category." }],
+                    details: {},
+                };
+            }
+            const store = loadStore(cwd, "semantic.json");
+            const existing = store.memories.find((m) => m.category === params.category && m.text.toLowerCase() === params.text.toLowerCase());
+            if (existing) {
+                return {
+                    content: [{ type: "text", text: `This semantic memory already exists [${existing.id}].` }],
+                    details: { action: "duplicate", id: existing.id },
+                };
+            }
+            const id = generateId("sem", store);
+            store.memories.push({
+                id,
+                category: params.category,
+                text: params.text,
+                tags,
+                created: nowISO(),
+                sourceSession: sessionId,
+            });
+            saveStore(cwd, "semantic.json", store);
+            return {
+                content: [{ type: "text", text: `Saved semantic memory [${id}] (${params.category}): "${params.text}".` }],
+                details: { action: "created", id },
+            };
+        }
+        return {
+            content: [{ type: "text", text: `Unknown memory type: ${params.type}` }],
+            details: {},
+        };
+    },
+};
+// ---------------------------------------------------------------------------
+// memory_read
+// ---------------------------------------------------------------------------
+export const memoryReadTool = {
+    name: "memory_read",
+    label: "Read Memory",
+    description: "Read memories from the persistent memory system. Use this when you need to recall " +
+        "past workflows, user preferences, or what happened in previous sessions. " +
+        "You can read all memories of a type, a specific memory by ID, or search by query.",
+    parameters: memoryReadSchema,
+    execute: async (_toolCallId, params) => {
+        const { cwd } = memoryContext;
+        if (params.id) {
+            const allStores = [
+                { file: "procedural.json", format: formatProceduralForDisplay },
+                { file: "episodic.json", format: formatEpisodicForDisplay },
+                { file: "semantic.json", format: formatSemanticForDisplay },
+            ];
+            for (const { file, format } of allStores) {
+                const store = loadStore(cwd, file);
+                const found = store.memories.find((m) => m.id === params.id);
+                if (found) {
+                    return {
+                        content: [{ type: "text", text: format(found) }],
+                        details: { found: true },
+                    };
+                }
+            }
+            return {
+                content: [{ type: "text", text: `No memory found with ID "${params.id}".` }],
+                details: { found: false },
+            };
+        }
+        if (params.query) {
+            const results = [];
+            const type = params.type ?? "all";
+            if (type === "all" || type === "procedural") {
+                const store = loadStore(cwd, "procedural.json");
+                const matches = searchMemories(store.memories, params.query, (m) => `${m.name} ${m.trigger} ${m.steps.join(" ")}`);
+                results.push(...matches.map(formatProceduralForDisplay));
+            }
+            if (type === "all" || type === "episodic") {
+                const store = loadStore(cwd, "episodic.json");
+                const matches = searchMemories(store.memories, params.query, (m) => `${m.summary} ${m.details.join(" ")}`);
+                results.push(...matches.map(formatEpisodicForDisplay));
+            }
+            if (type === "all" || type === "semantic") {
+                const store = loadStore(cwd, "semantic.json");
+                const matches = searchMemories(store.memories, params.query, (m) => `${m.category} ${m.text}`);
+                results.push(...matches.map(formatSemanticForDisplay));
+            }
+            if (results.length === 0) {
+                return {
+                    content: [{ type: "text", text: `No memories found matching "${params.query}".` }],
+                    details: { count: 0 },
+                };
+            }
+            return {
+                content: [{ type: "text", text: results.join("\n\n") }],
+                details: { count: results.length },
+            };
+        }
+        const type = params.type ?? "all";
+        const results = [];
+        if (type === "all" || type === "procedural") {
+            const store = loadStore(cwd, "procedural.json");
+            if (store.memories.length > 0) {
+                results.push("=== Procedural Memories ===");
+                results.push(...store.memories.map(formatProceduralForDisplay));
+            }
+        }
+        if (type === "all" || type === "episodic") {
+            const store = loadStore(cwd, "episodic.json");
+            if (store.memories.length > 0) {
+                results.push("=== Episodic Memories ===");
+                results.push(...store.memories.map(formatEpisodicForDisplay));
+            }
+        }
+        if (type === "all" || type === "semantic") {
+            const store = loadStore(cwd, "semantic.json");
+            if (store.memories.length > 0) {
+                results.push("=== Semantic Memories ===");
+                results.push(...store.memories.map(formatSemanticForDisplay));
+            }
+        }
+        if (results.length === 0) {
+            return {
+                content: [{ type: "text", text: "No memories stored yet." }],
+                details: { count: 0 },
+            };
+        }
+        return {
+            content: [{ type: "text", text: results.join("\n\n") }],
+            details: { count: results.length },
+        };
+    },
+};
+// ---------------------------------------------------------------------------
+// memory_update
+// ---------------------------------------------------------------------------
+export const memoryUpdateTool = {
+    name: "memory_update",
+    label: "Update Memory",
+    description: "Update an existing memory. Use this when the user confirms a change to a " +
+        "previously stored preference, procedure step, or fact. Always ask for " +
+        "confirmation before updating if there is a conflict.",
+    parameters: memoryUpdateSchema,
+    execute: async (_toolCallId, params) => {
+        const { cwd } = memoryContext;
+        const procStore = loadStore(cwd, "procedural.json");
+        const proc = procStore.memories.find((m) => m.id === params.id);
+        if (proc) {
+            if (params.steps)
+                proc.steps = params.steps;
+            if (params.trigger)
+                proc.trigger = params.trigger;
+            if (params.tags)
+                proc.tags = params.tags;
+            proc.updated = nowISO();
+            saveStore(cwd, "procedural.json", procStore);
+            return {
+                content: [{ type: "text", text: `Updated procedural memory [${params.id}].` }],
+                details: { updated: true },
+            };
+        }
+        const semStore = loadStore(cwd, "semantic.json");
+        const sem = semStore.memories.find((m) => m.id === params.id);
+        if (sem) {
+            if (params.text)
+                sem.text = params.text;
+            if (params.tags)
+                sem.tags = params.tags;
+            saveStore(cwd, "semantic.json", semStore);
+            return {
+                content: [{ type: "text", text: `Updated semantic memory [${params.id}].` }],
+                details: { updated: true },
+            };
+        }
+        const epStore = loadStore(cwd, "episodic.json");
+        const ep = epStore.memories.find((m) => m.id === params.id);
+        if (ep) {
+            if (params.tags)
+                ep.tags = params.tags;
+            saveStore(cwd, "episodic.json", epStore);
+            return {
+                content: [{ type: "text", text: `Updated episodic memory [${params.id}].` }],
+                details: { updated: true },
+            };
+        }
+        return {
+            content: [{ type: "text", text: `No memory found with ID "${params.id}".` }],
+            details: { updated: false },
+        };
+    },
+};
+// ---------------------------------------------------------------------------
+// memory_delete
+// ---------------------------------------------------------------------------
+export const memoryDeleteTool = {
+    name: "memory_delete",
+    label: "Delete Memory",
+    description: "Delete a specific memory by ID. Use this when the user asks to remove a memory " +
+        "or when a memory is confirmed to be outdated.",
+    parameters: memoryDeleteSchema,
+    execute: async (_toolCallId, params) => {
+        const { cwd } = memoryContext;
+        const files = ["procedural.json", "episodic.json", "semantic.json"];
+        for (const file of files) {
+            const store = loadStore(cwd, file);
+            const idx = store.memories.findIndex((m) => m.id === params.id);
+            if (idx !== -1) {
+                store.memories.splice(idx, 1);
+                saveStore(cwd, file, store);
+                return {
+                    content: [{ type: "text", text: `Deleted memory [${params.id}] from ${file.replace(".json", "")}.` }],
+                    details: { deleted: true },
+                };
+            }
+        }
+        return {
+            content: [{ type: "text", text: `No memory found with ID "${params.id}".` }],
+            details: { deleted: false },
+        };
+    },
+};
+/** All memory tools */
+export const memoryTools = [memoryWriteTool, memoryReadTool, memoryUpdateTool, memoryDeleteTool];
+//# sourceMappingURL=memory.js.map