@memoryblock/tools 0.1.0-beta

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 memoryblock
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/base.d.ts

@@ -0,0 +1,17 @@
+import type { ToolDefinition, ToolContext, ToolExecutionResult } from 'memoryblock';
+/**
+ * Base Tool interface. All built-in and plugin tools must implement this.
+ */
+export interface Tool {
+    readonly definition: ToolDefinition;
+    execute(params: Record<string, unknown>, context: ToolContext): Promise<ToolExecutionResult>;
+}
+/**
+ * Helper to create a JSON Schema object for tool parameters.
+ */
+export declare function createSchema(properties: Record<string, {
+    type: string;
+    description: string;
+    enum?: string[];
+}>, required?: string[]): Record<string, unknown>;
+//# sourceMappingURL=base.d.ts.map

package/dist/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../src/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEpF;;GAEG;AACH,MAAM,WAAW,IAAI;IACjB,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAChG;AAED;;GAEG;AACH,wBAAgB,YAAY,CACxB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,EAClF,QAAQ,GAAE,MAAM,EAAO,GACxB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOzB"}

package/dist/base.js

@@ -0,0 +1,12 @@
+/**
+ * Helper to create a JSON Schema object for tool parameters.
+ */
+export function createSchema(properties, required = []) {
+    return {
+        type: 'object',
+        properties,
+        required,
+        additionalProperties: false,
+    };
+}
+//# sourceMappingURL=base.js.map

package/dist/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../src/base.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,MAAM,UAAU,YAAY,CACxB,UAAkF,EAClF,WAAqB,EAAE;IAEvB,OAAO;QACH,IAAI,EAAE,QAAQ;QACd,UAAU;QACV,QAAQ;QACR,oBAAoB,EAAE,KAAK;KAC9B,CAAC;AACN,CAAC"}

package/dist/core/channels.d.ts

@@ -0,0 +1,9 @@
+import type { Tool } from '../base.js';
+/**
+ * send_channel_message tool allows the monitor to proactively dispatch
+ * a message to a specific bound channel (e.g. Telegram or CLI), rather
+ * than just passively replying to the channel that initiated the turn.
+ */
+export declare const dispatchMessageTool: Tool;
+export declare const channelTools: Tool[];
+//# sourceMappingURL=channels.d.ts.map

package/dist/core/channels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.d.ts","sourceRoot":"","sources":["../../src/core/channels.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGvC;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,IAmCjC,CAAC;AAEF,eAAO,MAAM,YAAY,QAAwB,CAAC"}

package/dist/core/channels.js

@@ -0,0 +1,39 @@
+import { createSchema } from '../base.js';
+/**
+ * send_channel_message tool allows the monitor to proactively dispatch
+ * a message to a specific bound channel (e.g. Telegram or CLI), rather
+ * than just passively replying to the channel that initiated the turn.
+ */
+export const dispatchMessageTool = {
+    definition: {
+        name: 'send_channel_message',
+        description: 'Send a message proactively to a specific active channel (e.g., "telegram" or "cli"). Use this if the founder asks you to send them a message somewhere else.',
+        parameters: createSchema({
+            channel: { type: 'string', description: 'The exact name of the target channel (e.g., "telegram", "cli").' },
+            content: { type: 'string', description: 'The message content to send.' },
+        }, ['channel', 'content']),
+        requiresApproval: false,
+    },
+    async execute(params, context) {
+        const target = params.channel;
+        const content = params.content;
+        if (!context.dispatchMessage) {
+            return { content: 'Message dispatching is not supported in the current execution context.', isError: true };
+        }
+        try {
+            await context.dispatchMessage(target, content);
+            return {
+                content: `Message successfully dispatched proactively to channel: ${target}`,
+                isError: false,
+            };
+        }
+        catch (err) {
+            return {
+                content: `Failed to dispatch message to channel '${target}': ${err.message}`,
+                isError: true,
+            };
+        }
+    },
+};
+export const channelTools = [dispatchMessageTool];
+//# sourceMappingURL=channels.js.map

package/dist/core/channels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.js","sourceRoot":"","sources":["../../src/core/channels.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAS;IACrC,UAAU,EAAE;QACR,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE,8JAA8J;QAC3K,UAAU,EAAE,YAAY,CACpB;YACI,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iEAAiE,EAAE;YAC3G,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;SAC3E,EACD,CAAC,SAAS,EAAE,SAAS,CAAC,CACzB;QACD,gBAAgB,EAAE,KAAK;KAC1B;IAED,KAAK,CAAC,OAAO,CAAC,MAA+B,EAAE,OAAoB;QAC/D,MAAM,MAAM,GAAG,MAAM,CAAC,OAAiB,CAAC;QACxC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAiB,CAAC;QAEzC,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;YAC3B,OAAO,EAAE,OAAO,EAAE,wEAAwE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAChH,CAAC;QAED,IAAI,CAAC;YACD,MAAM,OAAO,CAAC,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAC/C,OAAO;gBACH,OAAO,EAAE,2DAA2D,MAAM,EAAE;gBAC5E,OAAO,EAAE,KAAK;aACjB,CAAC;QACN,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,OAAO;gBACH,OAAO,EAAE,0CAA0C,MAAM,MAAO,GAAa,CAAC,OAAO,EAAE;gBACvF,OAAO,EAAE,IAAI;aAChB,CAAC;QACN,CAAC;IACL,CAAC;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,mBAAmB,CAAC,CAAC"}

package/dist/core/identity.d.ts

@@ -0,0 +1,5 @@
+import type { Tool } from '../base.js';
+export declare const updateMonitorIdentityTool: Tool;
+export declare const updateFounderInfoTool: Tool;
+export declare const identityTools: Tool[];
+//# sourceMappingURL=identity.d.ts.map

package/dist/core/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/core/identity.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAWvC,eAAO,MAAM,yBAAyB,EAAE,IAqDvC,CAAC;AAGF,eAAO,MAAM,qBAAqB,EAAE,IAiDnC,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,IAAI,EAG/B,CAAC"}

package/dist/core/identity.js

@@ -0,0 +1,108 @@
+import { promises as fsp } from 'node:fs';
+import { join } from 'node:path';
+import { createSchema } from '../base.js';
+// Resolve workspace root natively without pulling in core directly to avoid cycles
+import { homedir } from 'node:os';
+function getWsRoot() {
+    const custom = process.env.MEMORYBLOCK_WS_DIR;
+    return custom ? custom : join(homedir(), '.memoryblock', 'ws');
+}
+// ===== update_monitor_identity =====
+export const updateMonitorIdentityTool = {
+    definition: {
+        name: 'update_monitor_identity',
+        description: 'Update the monitor name and emoji for this block. This changes how you are identified in the system and UI.',
+        parameters: createSchema({
+            name: { type: 'string', description: 'Your new chosen name (e.g. "Ana", "Nexus").' },
+            emoji: { type: 'string', description: 'A single emoji representing your persona (e.g. "🤖", "🦊").' },
+        }, ['name', 'emoji']),
+        requiresApproval: true,
+    },
+    async execute(params, context) {
+        try {
+            // 1. Update config.json
+            const configPath = join(context.blockPath, 'config.json');
+            const configRaw = await fsp.readFile(configPath, 'utf8');
+            const config = JSON.parse(configRaw);
+            config.monitorName = params.name;
+            config.monitorEmoji = params.emoji;
+            await fsp.writeFile(configPath, JSON.stringify(config, null, 2), 'utf8');
+            // 2. Update monitor.md to reflect the new identity explicitly
+            const monitorPath = join(context.blockPath, 'monitor.md');
+            let monitorContent = '';
+            try {
+                monitorContent = await fsp.readFile(monitorPath, 'utf8');
+            }
+            catch {
+                // file doesn't exist yet, that's fine
+            }
+            const header = `# Identity\nName: ${params.name}\nEmoji: ${params.emoji}\n\n`;
+            // Basic replacement logic if it already has an Identity header
+            if (monitorContent.includes('# Identity')) {
+                monitorContent = monitorContent.replace(/# Identity[\s\S]*?(?=\n#|$)/, header);
+            }
+            else {
+                monitorContent = header + monitorContent;
+            }
+            await fsp.writeFile(monitorPath, monitorContent, 'utf8');
+            return {
+                content: `Successfully updated monitor identity to ${params.emoji} ${params.name}. The system will reflect this change on the next interaction.`,
+                isError: false
+            };
+        }
+        catch (err) {
+            return { content: `Failed to update monitor identity: ${err.message}`, isError: true };
+        }
+    },
+};
+// ===== update_founder_info =====
+export const updateFounderInfoTool = {
+    definition: {
+        name: 'update_founder_info',
+        description: 'Update the global founder profile. Use this when the user tells you about themselves (name, work, preferences). This data is globally shared across all your blocks.',
+        parameters: createSchema({
+            info: { type: 'string', description: 'The new information to append or update about the founder.' },
+            mode: { type: 'string', description: 'Either "append" (add new facts) or "rewrite" (completely rewrite the profile).' },
+        }, ['info', 'mode']),
+        requiresApproval: false,
+    },
+    async execute(params, _context) {
+        try {
+            const wsRoot = getWsRoot();
+            const founderPath = join(wsRoot, 'founder.md');
+            let content = '';
+            try {
+                content = await fsp.readFile(founderPath, 'utf8');
+            }
+            catch {
+                // file doesn't exist yet, that's fine
+            }
+            const newInfo = params.info;
+            const mode = params.mode;
+            if (mode === 'rewrite') {
+                content = `# Founder Profile\n\n${newInfo}\n`;
+            }
+            else {
+                // append intelligently
+                if (!content.includes('# Founder Profile')) {
+                    content = `# Founder Profile\n\n`;
+                }
+                const timestamp = new Date().toISOString().split('T')[0];
+                content += `\n- [${timestamp}]: ${newInfo}`;
+            }
+            await fsp.writeFile(founderPath, content.trim() + '\n', 'utf8');
+            return {
+                content: `Successfully updated global founder profile at ${founderPath}.`,
+                isError: false
+            };
+        }
+        catch (err) {
+            return { content: `Failed to update founder profile: ${err.message}`, isError: true };
+        }
+    },
+};
+export const identityTools = [
+    updateMonitorIdentityTool,
+    updateFounderInfoTool,
+];
+//# sourceMappingURL=identity.js.map

package/dist/core/identity.js.map

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

package/dist/dev/index.d.ts

@@ -0,0 +1,7 @@
+import type { Tool } from '../base.js';
+export declare const runLintTool: Tool;
+export declare const runBuildTool: Tool;
+export declare const runTestTool: Tool;
+/** All dev tools. */
+export declare const devTools: Tool[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dev/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAoDvC,eAAO,MAAM,WAAW,EAAE,IAezB,CAAC;AAGF,eAAO,MAAM,YAAY,EAAE,IAiB1B,CAAC;AAGF,eAAO,MAAM,WAAW,EAAE,IAoBzB,CAAC;AAEF,qBAAqB;AACrB,eAAO,MAAM,QAAQ,EAAE,IAAI,EAA6C,CAAC"}

package/dist/dev/index.js

@@ -0,0 +1,113 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { promises as fsp } from 'node:fs';
+import { join } from 'node:path';
+import { createSchema } from '../base.js';
+const execFileAsync = promisify(execFile);
+const DEV_TIMEOUT = 120_000; // 2 minutes for builds
+const MAX_OUTPUT = 50_000;
+/** Find the project root by looking for package.json. */
+async function findProjectRoot(startDir) {
+    let dir = startDir;
+    for (let i = 0; i < 10; i++) {
+        try {
+            await fsp.access(join(dir, 'package.json'));
+            return dir;
+        }
+        catch {
+            const parent = join(dir, '..');
+            if (parent === dir)
+                break;
+            dir = parent;
+        }
+    }
+    return startDir;
+}
+function truncateOutput(output) {
+    if (output.length > MAX_OUTPUT) {
+        return output.slice(0, MAX_OUTPUT) + `\n...(truncated, ${output.length} total chars)`;
+    }
+    return output;
+}
+async function runCommand(command, cwd) {
+    try {
+        const { stdout, stderr } = await execFileAsync('/bin/sh', ['-c', command], {
+            cwd,
+            timeout: DEV_TIMEOUT,
+            maxBuffer: 2 * 1024 * 1024,
+            env: { ...process.env, HOME: process.env.HOME, FORCE_COLOR: '0' },
+        });
+        let output = '';
+        if (stdout)
+            output += stdout;
+        if (stderr)
+            output += (output ? '\n--- stderr ---\n' : '') + stderr;
+        return { content: truncateOutput(output || '(no output)'), isError: false };
+    }
+    catch (err) {
+        const e = err;
+        let msg = e.message;
+        if (e.stdout)
+            msg += '\n' + e.stdout.slice(0, 10_000);
+        if (e.stderr)
+            msg += '\n' + e.stderr.slice(0, 10_000);
+        return { content: truncateOutput(`Command failed: ${msg}`), isError: true };
+    }
+}
+// ===== run_lint =====
+export const runLintTool = {
+    definition: {
+        name: 'run_lint',
+        description: 'Run ESLint.',
+        parameters: createSchema({ path: { type: 'string', description: 'Target path.' } }, []),
+        requiresApproval: false,
+    },
+    async execute(params, context) {
+        const projectRoot = await findProjectRoot(context.workingDir || context.blockPath);
+        const target = params.path || '.';
+        return runCommand(`npx eslint ${target} --no-color 2>&1 || true`, projectRoot);
+    },
+};
+// ===== run_build =====
+export const runBuildTool = {
+    definition: {
+        name: 'run_build',
+        description: 'Run build command.',
+        parameters: createSchema({}, []),
+        requiresApproval: false,
+    },
+    async execute(_params, context) {
+        const projectRoot = await findProjectRoot(context.workingDir || context.blockPath);
+        // Try pnpm first, fall back to npm
+        try {
+            await fsp.access(join(projectRoot, 'pnpm-workspace.yaml'));
+            return runCommand('pnpm run build 2>&1', projectRoot);
+        }
+        catch {
+            return runCommand('npm run build 2>&1', projectRoot);
+        }
+    },
+};
+// ===== run_test =====
+export const runTestTool = {
+    definition: {
+        name: 'run_test',
+        description: 'Run tests.',
+        parameters: createSchema({ filter: { type: 'string', description: 'Test filter.' } }, []),
+        requiresApproval: false,
+    },
+    async execute(params, context) {
+        const projectRoot = await findProjectRoot(context.workingDir || context.blockPath);
+        const filter = params.filter || '';
+        try {
+            await fsp.access(join(projectRoot, 'pnpm-workspace.yaml'));
+            return runCommand(`pnpm test ${filter} 2>&1 || true`, projectRoot);
+        }
+        catch {
+            return runCommand(`npm test ${filter} 2>&1 || true`, projectRoot);
+        }
+    },
+};
+/** All dev tools. */
+export const devTools = [runLintTool, runBuildTool, runTestTool];
+//# sourceMappingURL=index.js.map

package/dist/dev/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/dev/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,QAAQ,IAAI,GAAG,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAC1C,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,uBAAuB;AACpD,MAAM,UAAU,GAAG,MAAM,CAAC;AAE1B,yDAAyD;AACzD,KAAK,UAAU,eAAe,CAAC,QAAgB;IAC3C,IAAI,GAAG,GAAG,QAAQ,CAAC;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1B,IAAI,CAAC;YACD,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC;YAC5C,OAAO,GAAG,CAAC;QACf,CAAC;QAAC,MAAM,CAAC;YACL,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC/B,IAAI,MAAM,KAAK,GAAG;gBAAE,MAAM;YAC1B,GAAG,GAAG,MAAM,CAAC;QACjB,CAAC;IACL,CAAC;IACD,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED,SAAS,cAAc,CAAC,MAAc;IAClC,IAAI,MAAM,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;QAC7B,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG,oBAAoB,MAAM,CAAC,MAAM,eAAe,CAAC;IAC1F,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,OAAe,EAAE,GAAW;IAClD,IAAI,CAAC;QACD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE;YACvE,GAAG;YACH,OAAO,EAAE,WAAW;YACpB,SAAS,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;YAC1B,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE;SACpE,CAAC,CAAC;QACH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM;YAAE,MAAM,IAAI,MAAM,CAAC;QAC7B,IAAI,MAAM;YAAE,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC;QACpE,OAAO,EAAE,OAAO,EAAE,cAAc,CAAC,MAAM,IAAI,aAAa,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAChF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,MAAM,CAAC,GAAG,GAAmD,CAAC;QAC9D,IAAI,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC;QACpB,IAAI,CAAC,CAAC,MAAM;YAAE,GAAG,IAAI,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QACtD,IAAI,CAAC,CAAC,MAAM;YAAE,GAAG,IAAI,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QACtD,OAAO,EAAE,OAAO,EAAE,cAAc,CAAC,mBAAmB,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAChF,CAAC;AACL,CAAC;AAED,uBAAuB;AACvB,MAAM,CAAC,MAAM,WAAW,GAAS;IAC7B,UAAU,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,aAAa;QAC1B,UAAU,EAAE,YAAY,CACpB,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,EAAE,EACzD,EAAE,CACL;QACD,gBAAgB,EAAE,KAAK;KAC1B;IACD,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO;QACzB,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;QACnF,MAAM,MAAM,GAAI,MAAM,CAAC,IAAe,IAAI,GAAG,CAAC;QAC9C,OAAO,UAAU,CAAC,cAAc,MAAM,0BAA0B,EAAE,WAAW,CAAC,CAAC;IACnF,CAAC;CACJ,CAAC;AAEF,wBAAwB;AACxB,MAAM,CAAC,MAAM,YAAY,GAAS;IAC9B,UAAU,EAAE;QACR,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,oBAAoB;QACjC,UAAU,EAAE,YAAY,CAAC,EAAE,EAAE,EAAE,CAAC;QAChC,gBAAgB,EAAE,KAAK;KAC1B;IACD,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO;QAC1B,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;QACnF,mCAAmC;QACnC,IAAI,CAAC;YACD,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,qBAAqB,CAAC,CAAC,CAAC;YAC3D,OAAO,UAAU,CAAC,qBAAqB,EAAE,WAAW,CAAC,CAAC;QAC1D,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,UAAU,CAAC,oBAAoB,EAAE,WAAW,CAAC,CAAC;QACzD,CAAC;IACL,CAAC;CACJ,CAAC;AAEF,uBAAuB;AACvB,MAAM,CAAC,MAAM,WAAW,GAAS;IAC7B,UAAU,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,YAAY;QACzB,UAAU,EAAE,YAAY,CACpB,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,EAAE,EAC3D,EAAE,CACL;QACD,gBAAgB,EAAE,KAAK;KAC1B;IACD,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO;QACzB,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;QACnF,MAAM,MAAM,GAAI,MAAM,CAAC,MAAiB,IAAI,EAAE,CAAC;QAC/C,IAAI,CAAC;YACD,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,qBAAqB,CAAC,CAAC,CAAC;YAC3D,OAAO,UAAU,CAAC,aAAa,MAAM,eAAe,EAAE,WAAW,CAAC,CAAC;QACvE,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,UAAU,CAAC,YAAY,MAAM,eAAe,EAAE,WAAW,CAAC,CAAC;QACtE,CAAC;IACL,CAAC;CACJ,CAAC;AAEF,qBAAqB;AACrB,MAAM,CAAC,MAAM,QAAQ,GAAW,CAAC,WAAW,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC"}

package/dist/fs/index.d.ts

@@ -0,0 +1,11 @@
+import type { Tool } from '../base.js';
+export declare const readFileTool: Tool;
+export declare const writeFileTool: Tool;
+export declare const listDirectoryTool: Tool;
+export declare const createDirectoryTool: Tool;
+export declare const searchFilesTool: Tool;
+export declare const replaceInFileTool: Tool;
+export declare const fileInfoTool: Tool;
+/** All built-in FS tools. */
+export declare const fsTools: Tool[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fs/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAsCvC,eAAO,MAAM,YAAY,EAAE,IA6B1B,CAAC;AAGF,eAAO,MAAM,aAAa,EAAE,IA0B3B,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,IAsB/B,CAAC;AAGF,eAAO,MAAM,mBAAmB,EAAE,IAmBjC,CAAC;AAGF,eAAO,MAAM,eAAe,EAAE,IAyC7B,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,IAyC/B,CAAC;AAGF,eAAO,MAAM,YAAY,EAAE,IA0B1B,CAAC;AAEF,6BAA6B;AAC7B,eAAO,MAAM,OAAO,EAAE,IAAI,EAGzB,CAAC"}

package/dist/fs/index.js

@@ -0,0 +1,240 @@
+import { promises as fsp } from 'node:fs';
+import { join, resolve, relative, isAbsolute } from 'node:path';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { createSchema } from '../base.js';
+const execFileAsync = promisify(execFile);
+// Security: files that must never be read
+const BLOCKED_PATTERNS = ['.env', 'auth.json', '.memoryblock/auth.json'];
+function isBlockedPath(filePath) {
+    const normalized = filePath.replace(/\\/g, '/');
+    return BLOCKED_PATTERNS.some((p) => normalized.endsWith(p) || normalized.includes(`/${p}`));
+}
+/** Resolve a path. Scope is determined by block permissions. */
+function resolvePath(context, targetPath) {
+    const base = context.workingDir || context.blockPath;
+    const resolved = isAbsolute(targetPath) ? targetPath : resolve(base, targetPath);
+    const scope = context.permissions?.scope || 'block';
+    if (scope === 'system') {
+        // Unrestricted — still block sensitive files
+        return resolved;
+    }
+    // Determine allowed root based on scope
+    const allowedRoot = scope === 'workspace' && context.workspacePath
+        ? context.workspacePath
+        : context.blockPath;
+    const rel = relative(allowedRoot, resolved);
+    if (rel.startsWith('..') || isAbsolute(rel)) {
+        const label = scope === 'workspace' ? 'workspace' : 'block directory';
+        throw new Error(`Access denied: path "${targetPath}" is outside the ${label}. Current scope: ${scope}.`);
+    }
+    return resolved;
+}
+// ===== read_file =====
+export const readFileTool = {
+    definition: {
+        name: 'read_file',
+        description: 'Read the contents of a file.',
+        parameters: createSchema({ path: { type: 'string', description: 'Path to the file.' } }, ['path']),
+        requiresApproval: false,
+    },
+    async execute(params, context) {
+        const filePath = resolvePath(context, params.path);
+        if (isBlockedPath(filePath)) {
+            return { content: 'Access denied: this file is protected.', isError: true };
+        }
+        try {
+            const content = await fsp.readFile(filePath, 'utf-8');
+            // Truncate extremely large files to save tokens
+            if (content.length > 100_000) {
+                return {
+                    content: content.slice(0, 100_000) + `\n...(truncated, ${content.length} total chars. Use search_files to find specific content.)`,
+                    isError: false,
+                };
+            }
+            return { content, isError: false };
+        }
+        catch (err) {
+            return { content: `Failed to read file: ${err.message}`, isError: true };
+        }
+    },
+};
+// ===== write_file =====
+export const writeFileTool = {
+    definition: {
+        name: 'write_file',
+        description: 'Write content to a file. Creates parent directories if needed.',
+        parameters: createSchema({
+            path: { type: 'string', description: 'Path to the file.' },
+            content: { type: 'string', description: 'Content to write.' },
+        }, ['path', 'content']),
+        requiresApproval: false,
+    },
+    async execute(params, context) {
+        const filePath = resolvePath(context, params.path);
+        if (isBlockedPath(filePath)) {
+            return { content: 'Access denied: this file is protected.', isError: true };
+        }
+        try {
+            await fsp.mkdir(join(filePath, '..'), { recursive: true });
+            await fsp.writeFile(filePath, params.content, 'utf-8');
+            return { content: `Written: ${params.path}`, isError: false };
+        }
+        catch (err) {
+            return { content: `Failed to write: ${err.message}`, isError: true };
+        }
+    },
+};
+// ===== list_directory =====
+export const listDirectoryTool = {
+    definition: {
+        name: 'list_directory',
+        description: 'List files and directories in a path.',
+        parameters: createSchema({ path: { type: 'string', description: 'Path to list. Defaults to workspace root.' } }, []),
+        requiresApproval: false,
+    },
+    async execute(params, context) {
+        const dirPath = resolvePath(context, params.path || '.');
+        try {
+            const entries = await fsp.readdir(dirPath, { withFileTypes: true });
+            const listing = entries
+                .map((e) => `${e.isDirectory() ? '📁' : '📄'} ${e.name}`)
+                .join('\n');
+            return { content: listing || '(empty directory)', isError: false };
+        }
+        catch (err) {
+            return { content: `Failed to list: ${err.message}`, isError: true };
+        }
+    },
+};
+// ===== create_directory =====
+export const createDirectoryTool = {
+    definition: {
+        name: 'create_directory',
+        description: 'Create a directory.',
+        parameters: createSchema({ path: { type: 'string', description: 'Path of the directory to create.' } }, ['path']),
+        requiresApproval: false,
+    },
+    async execute(params, context) {
+        const dirPath = resolvePath(context, params.path);
+        try {
+            await fsp.mkdir(dirPath, { recursive: true });
+            return { content: `Created: ${params.path}`, isError: false };
+        }
+        catch (err) {
+            return { content: `Failed to create: ${err.message}`, isError: true };
+        }
+    },
+};
+// ===== search_files =====
+export const searchFilesTool = {
+    definition: {
+        name: 'search_files',
+        description: 'Search for text in files using grep. Returns matching lines with file paths and line numbers.',
+        parameters: createSchema({
+            query: { type: 'string', description: 'Text to search for.' },
+            path: { type: 'string', description: 'Directory to search in. Defaults to workspace root.' },
+            include: { type: 'string', description: 'File glob pattern to include, e.g. "*.ts".' },
+        }, ['query']),
+        requiresApproval: false,
+    },
+    async execute(params, context) {
+        const searchDir = resolvePath(context, params.path || '.');
+        const query = params.query;
+        const include = params.include;
+        try {
+            const args = ['-rnI', '--color=never', '-m', '50'];
+            if (include)
+                args.push('--include', include);
+            args.push(query, searchDir);
+            const { stdout } = await execFileAsync('grep', args, {
+                timeout: 15_000,
+                maxBuffer: 512 * 1024,
+            });
+            const output = stdout.trim();
+            if (!output)
+                return { content: 'No matches found.', isError: false };
+            // Truncate if too many results
+            if (output.length > 20_000) {
+                return { content: output.slice(0, 20_000) + '\n...(truncated)', isError: false };
+            }
+            return { content: output, isError: false };
+        }
+        catch (err) {
+            const e = err;
+            if (e.code === 1)
+                return { content: 'No matches found.', isError: false };
+            return { content: `Search failed: ${e.message}`, isError: true };
+        }
+    },
+};
+// ===== replace_in_file =====
+export const replaceInFileTool = {
+    definition: {
+        name: 'replace_in_file',
+        description: 'Find and replace text in a file.',
+        parameters: createSchema({
+            path: { type: 'string', description: 'File path.' },
+            find: { type: 'string', description: 'Text to find.' },
+            replace: { type: 'string', description: 'Replacement text.' },
+            all: { type: 'string', description: 'Replace all? "true"/"false".' },
+        }, ['path', 'find', 'replace']),
+        requiresApproval: false,
+    },
+    async execute(params, context) {
+        const filePath = resolvePath(context, params.path);
+        if (isBlockedPath(filePath)) {
+            return { content: 'Access denied: this file is protected.', isError: true };
+        }
+        try {
+            const content = await fsp.readFile(filePath, 'utf-8');
+            const find = params.find;
+            const replace = params.replace;
+            const replaceAll = params.all === 'true';
+            if (!content.includes(find)) {
+                return { content: `Text not found in ${params.path}. Check exact whitespace/formatting.`, isError: true };
+            }
+            const updated = replaceAll
+                ? content.split(find).join(replace)
+                : content.replace(find, replace);
+            await fsp.writeFile(filePath, updated, 'utf-8');
+            const count = replaceAll ? content.split(find).length - 1 : 1;
+            return { content: `Replaced ${count} occurrence(s) in ${params.path}`, isError: false };
+        }
+        catch (err) {
+            return { content: `Failed: ${err.message}`, isError: true };
+        }
+    },
+};
+// ===== file_info =====
+export const fileInfoTool = {
+    definition: {
+        name: 'file_info',
+        description: 'Get file metadata: size, modified date, type.',
+        parameters: createSchema({ path: { type: 'string', description: 'Path to the file or directory.' } }, ['path']),
+        requiresApproval: false,
+    },
+    async execute(params, context) {
+        const filePath = resolvePath(context, params.path);
+        try {
+            const stat = await fsp.stat(filePath);
+            const info = [
+                `Path: ${params.path}`,
+                `Type: ${stat.isDirectory() ? 'directory' : 'file'}`,
+                `Size: ${stat.size} bytes (${(stat.size / 1024).toFixed(1)} KB)`,
+                `Modified: ${stat.mtime.toISOString()}`,
+                `Created: ${stat.birthtime.toISOString()}`,
+            ].join('\n');
+            return { content: info, isError: false };
+        }
+        catch (err) {
+            return { content: `Failed: ${err.message}`, isError: true };
+        }
+    },
+};
+/** All built-in FS tools. */
+export const fsTools = [
+    readFileTool, writeFileTool, listDirectoryTool, createDirectoryTool,
+    searchFilesTool, replaceInFileTool, fileInfoTool,
+];
+//# sourceMappingURL=index.js.map