@memoryblock/tools 0.1.0-beta

package/dist/fs/index.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export { ToolRegistry } from './registry.js';
+export type { Tool } from './base.js';
+export { createSchema } from './base.js';
+export { fsTools } from './fs/index.js';
+export { shellTools, isSafeCommand } from './shell/index.js';
+export { devTools } from './dev/index.js';
+export { identityTools } from './core/identity.js';
+export { channelTools } from './core/channels.js';
+import { ToolRegistry } from './registry.js';
+/**
+ * Create a ToolRegistry pre-loaded with all built-in tools.
+ */
+export declare function createDefaultRegistry(): ToolRegistry;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,YAAY,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAO7C;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,YAAY,CAWpD"}

package/dist/index.js

@@ -0,0 +1,32 @@
+export { ToolRegistry } from './registry.js';
+export { createSchema } from './base.js';
+export { fsTools } from './fs/index.js';
+export { shellTools, isSafeCommand } from './shell/index.js';
+export { devTools } from './dev/index.js';
+export { identityTools } from './core/identity.js';
+export { channelTools } from './core/channels.js';
+import { ToolRegistry } from './registry.js';
+import { fsTools } from './fs/index.js';
+import { shellTools } from './shell/index.js';
+import { devTools } from './dev/index.js';
+import { identityTools } from './core/identity.js';
+import { channelTools } from './core/channels.js';
+/**
+ * Create a ToolRegistry pre-loaded with all built-in tools.
+ */
+export function createDefaultRegistry() {
+    const registry = new ToolRegistry();
+    // Core built-in tools
+    for (const tool of fsTools)
+        registry.register(tool);
+    for (const tool of shellTools)
+        registry.register(tool);
+    for (const tool of devTools)
+        registry.register(tool);
+    for (const tool of identityTools)
+        registry.register(tool);
+    for (const tool of channelTools)
+        registry.register(tool);
+    return registry;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACjC,MAAM,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;IAEpC,sBAAsB;IACtB,KAAK,MAAM,IAAI,IAAI,OAAO;QAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACpD,KAAK,MAAM,IAAI,IAAI,UAAU;QAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACvD,KAAK,MAAM,IAAI,IAAI,QAAQ;QAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACrD,KAAK,MAAM,IAAI,IAAI,aAAa;QAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC1D,KAAK,MAAM,IAAI,IAAI,YAAY;QAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAEzD,OAAO,QAAQ,CAAC;AACpB,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,33 @@
+import type { ToolDefinition, ToolContext, ToolExecutionResult } from 'memoryblock';
+import type { Tool } from './base.js';
+/**
+ * Central tool registry. Manages built-in tools and dynamically loaded plugin tools.
+ * Implements the LIST_TOOLS_AVAILABLE discovery pattern for token optimization.
+ * All execution passes through ToolSandbox for permission enforcement.
+ */
+export declare class ToolRegistry {
+    private tools;
+    /** Register a tool. */
+    register(tool: Tool): void;
+    /** Check if a tool exists. */
+    has(name: string): boolean;
+    /** Get all tool definitions (for LIST_TOOLS_AVAILABLE). */
+    listTools(): ToolDefinition[];
+    /**
+     * Get the LIST_TOOLS_AVAILABLE meta-tool definition.
+     * This is the only tool exposed to the LLM on first contact.
+     */
+    getDiscoveryTool(): ToolDefinition;
+    /**
+     * Execute a tool by name.
+     * All calls pass through ToolSandbox BEFORE execution.
+     * Implements graceful degradation — never throws.
+     */
+    execute(name: string, params: Record<string, unknown>, context: ToolContext): Promise<ToolExecutionResult>;
+    /**
+     * Load plugin tools from a dynamic import path.
+     * Uses try/catch for graceful degradation — never crashes if plugin is missing.
+     */
+    loadPlugin(pluginPath: string): Promise<void>;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEpF,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGtC;;;;GAIG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,KAAK,CAA2B;IAExC,uBAAuB;IACvB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAI1B,8BAA8B;IAC9B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,2DAA2D;IAC3D,SAAS,IAAI,cAAc,EAAE;IAI7B;;;OAGG;IACH,gBAAgB,IAAI,cAAc;IASlC;;;;OAIG;IACG,OAAO,CACT,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,WAAW,GACrB,OAAO,CAAC,mBAAmB,CAAC;IAsC/B;;;OAGG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAetD"}

package/dist/registry.js

@@ -0,0 +1,96 @@
+import { log } from 'memoryblock';
+import { ToolSandbox } from './sandbox.js';
+/**
+ * Central tool registry. Manages built-in tools and dynamically loaded plugin tools.
+ * Implements the LIST_TOOLS_AVAILABLE discovery pattern for token optimization.
+ * All execution passes through ToolSandbox for permission enforcement.
+ */
+export class ToolRegistry {
+    tools = new Map();
+    /** Register a tool. */
+    register(tool) {
+        this.tools.set(tool.definition.name, tool);
+    }
+    /** Check if a tool exists. */
+    has(name) {
+        return this.tools.has(name);
+    }
+    /** Get all tool definitions (for LIST_TOOLS_AVAILABLE). */
+    listTools() {
+        return Array.from(this.tools.values()).map((t) => t.definition);
+    }
+    /**
+     * Get the LIST_TOOLS_AVAILABLE meta-tool definition.
+     * This is the only tool exposed to the LLM on first contact.
+     */
+    getDiscoveryTool() {
+        return {
+            name: 'list_tools_available',
+            description: 'Discover all tools available to you. Call this first to see your capabilities.',
+            parameters: { type: 'object', properties: {}, required: [], additionalProperties: false },
+            requiresApproval: false,
+        };
+    }
+    /**
+     * Execute a tool by name.
+     * All calls pass through ToolSandbox BEFORE execution.
+     * Implements graceful degradation — never throws.
+     */
+    async execute(name, params, context) {
+        // Handle the meta-tool
+        if (name === 'list_tools_available') {
+            const tools = this.listTools();
+            const listing = tools.map((t) => `- **${t.name}**: ${t.description}`).join('\n');
+            return {
+                content: `You have ${tools.length} tools available:\n\n${listing}\n\nCall any tool by name with the required parameters.`,
+                isError: false,
+            };
+        }
+        const tool = this.tools.get(name);
+        if (!tool) {
+            // Graceful degradation — never crash
+            return {
+                content: `Tool "${name}" not found. Use list_tools_available to see available tools.`,
+                isError: true,
+            };
+        }
+        // ===== SANDBOX GATE =====
+        // Validate BEFORE execution. If denied, the tool never runs.
+        const denied = ToolSandbox.validate(name, params, context);
+        if (denied) {
+            return denied;
+        }
+        try {
+            return await tool.execute(params, context);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: `Tool "${name}" failed: ${message}`,
+                isError: true,
+            };
+        }
+    }
+    /**
+     * Load plugin tools from a dynamic import path.
+     * Uses try/catch for graceful degradation — never crashes if plugin is missing.
+     */
+    async loadPlugin(pluginPath) {
+        try {
+            const mod = await import(pluginPath);
+            if (mod.tools && Array.isArray(mod.tools)) {
+                for (const tool of mod.tools) {
+                    this.register(tool);
+                }
+            }
+            else if (mod.default && typeof mod.default === 'object' && 'definition' in mod.default) {
+                this.register(mod.default);
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            log.warn(`Failed to load plugin "${pluginPath}": ${message}`);
+        }
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/sandbox.d.ts

@@ -0,0 +1,33 @@
+/**
+ * ToolSandbox — central enforcement layer for tool execution.
+ *
+ * Every tool.execute() call passes through this gate.
+ * It intercepts params, scans for file paths, validates them against
+ * the block's permission scope, and blocks disallowed operations.
+ *
+ * This class is designed as a drop-in replaceable module. Any future
+ * enforcement backend can substitute this class as long as it exposes
+ * the same static validate() and validateCommand() interface.
+ */
+import type { ToolContext, ToolExecutionResult } from 'memoryblock';
+export declare class ToolSandbox {
+    /**
+     * Validate a tool call BEFORE execution.
+     * Returns null if allowed, or an error ToolExecutionResult if denied.
+     */
+    static validate(toolName: string, params: Record<string, unknown>, context: ToolContext): ToolExecutionResult | null;
+    /**
+     * Scan params for file path values and validate against scope.
+     */
+    private static scanPaths;
+    /**
+     * Check if any string param references a sensitive file.
+     */
+    private static scanSensitive;
+    /**
+     * Scan a shell command string for path traversal attempts.
+     * Returns an error message if the command looks like it's escaping scope.
+     */
+    static validateCommand(command: string, context: ToolContext): string | null;
+}
+//# sourceMappingURL=sandbox.d.ts.map

package/dist/sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../src/sandbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAqB,MAAM,aAAa,CAAC;AAmBvF,qBAAa,WAAW;IAEpB;;;OAGG;IACH,MAAM,CAAC,QAAQ,CACX,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,WAAW,GACrB,mBAAmB,GAAG,IAAI;IA+B7B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS;IAsCxB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAa5B;;;OAGG;IACH,MAAM,CAAC,eAAe,CAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,WAAW,GACrB,MAAM,GAAG,IAAI;CA+BnB"}

package/dist/sandbox.js

@@ -0,0 +1,136 @@
+/**
+ * ToolSandbox — central enforcement layer for tool execution.
+ *
+ * Every tool.execute() call passes through this gate.
+ * It intercepts params, scans for file paths, validates them against
+ * the block's permission scope, and blocks disallowed operations.
+ *
+ * This class is designed as a drop-in replaceable module. Any future
+ * enforcement backend can substitute this class as long as it exposes
+ * the same static validate() and validateCommand() interface.
+ */
+import { resolve, relative, isAbsolute } from 'node:path';
+// Patterns that look like file paths in tool params
+const PATH_PARAM_NAMES = ['path', 'file', 'filePath', 'directory', 'dir', 'target', 'source', 'destination'];
+// Sensitive files that should never be accessible regardless of scope
+const SENSITIVE_PATTERNS = [
+    'auth.json',
+    '.env',
+    '.memoryblock/auth.json',
+    'id_rsa',
+    'id_ed25519',
+    '.ssh/config',
+    '.aws/credentials',
+];
+// Shell tools that need special handling
+const SHELL_TOOL_NAMES = ['execute_command', 'run_lint', 'run_build', 'run_test'];
+export class ToolSandbox {
+    /**
+     * Validate a tool call BEFORE execution.
+     * Returns null if allowed, or an error ToolExecutionResult if denied.
+     */
+    static validate(toolName, params, context) {
+        const perms = context.permissions || { scope: 'block', allowShell: false, allowNetwork: true, maxTimeout: 120_000 };
+        // 1. Shell access check
+        if (SHELL_TOOL_NAMES.includes(toolName)) {
+            if (!perms.allowShell && perms.scope !== 'system') {
+                return {
+                    content: `Denied: "${toolName}" requires shell access. Current scope: "${perms.scope}". Run \`mblk permissions ${context.blockName} --allow-shell\` to grant access.`,
+                    isError: true,
+                };
+            }
+        }
+        // 2. Scan all params for file paths and validate
+        const pathViolation = ToolSandbox.scanPaths(params, context, perms);
+        if (pathViolation) {
+            return { content: pathViolation, isError: true };
+        }
+        // 3. Check for sensitive file access in any string param
+        const sensitiveHit = ToolSandbox.scanSensitive(params);
+        if (sensitiveHit) {
+            return {
+                content: `Denied: access to "${sensitiveHit}" is blocked for security.`,
+                isError: true,
+            };
+        }
+        return null; // Allowed
+    }
+    /**
+     * Scan params for file path values and validate against scope.
+     */
+    static scanPaths(params, context, perms) {
+        if (perms.scope === 'system')
+            return null; // No path restrictions
+        for (const [key, value] of Object.entries(params)) {
+            if (typeof value !== 'string')
+                continue;
+            // Check named path params
+            const isPathParam = PATH_PARAM_NAMES.some(p => key.toLowerCase().includes(p.toLowerCase()));
+            // Also check any string that looks like an absolute path
+            const looksLikePath = isPathParam || value.startsWith('/') || value.startsWith('~');
+            if (!looksLikePath)
+                continue;
+            const resolved = isAbsolute(value)
+                ? value
+                : resolve(context.workingDir || context.blockPath, value);
+            const allowedRoot = perms.scope === 'workspace' && context.workspacePath
+                ? context.workspacePath
+                : context.blockPath;
+            const rel = relative(allowedRoot, resolved);
+            if (rel.startsWith('..') || isAbsolute(rel)) {
+                const label = perms.scope === 'workspace' ? 'workspace' : 'block directory';
+                return `Denied: "${key}" points to "${value}" which is outside the ${label}. Scope: "${perms.scope}".`;
+            }
+        }
+        return null;
+    }
+    /**
+     * Check if any string param references a sensitive file.
+     */
+    static scanSensitive(params) {
+        for (const value of Object.values(params)) {
+            if (typeof value !== 'string')
+                continue;
+            const normalized = value.replace(/\\/g, '/');
+            for (const pattern of SENSITIVE_PATTERNS) {
+                if (normalized.endsWith(pattern) || normalized.includes(`/${pattern}`)) {
+                    return pattern;
+                }
+            }
+        }
+        return null;
+    }
+    /**
+     * Scan a shell command string for path traversal attempts.
+     * Returns an error message if the command looks like it's escaping scope.
+     */
+    static validateCommand(command, context) {
+        const perms = context.permissions || { scope: 'block', allowShell: false, allowNetwork: true, maxTimeout: 120_000 };
+        if (perms.scope === 'system')
+            return null;
+        // Check for common escape patterns in shell commands
+        const escapePatterns = [
+            /\bcd\s+\//, // cd /absolute
+            /\bcat\s+\//, // cat /etc/passwd
+            /\bls\s+\//, // ls / (outside block)
+            />\s*\//, // redirect to absolute path
+            /\|\s*tee\s+\//, // pipe to absolute path
+        ];
+        // Only flag these in block scope — workspace/system allow broader access
+        if (perms.scope === 'block') {
+            for (const pattern of escapePatterns) {
+                if (pattern.test(command)) {
+                    return `Denied: command appears to access paths outside the block directory. Scope: "block".`;
+                }
+            }
+        }
+        // Check for sensitive file access in any scope
+        for (const sensitive of SENSITIVE_PATTERNS) {
+            if (command.includes(sensitive)) {
+                return `Denied: command references sensitive file "${sensitive}".`;
+            }
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=sandbox.js.map

package/dist/sandbox.js.map

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

package/dist/shell/index.d.ts

@@ -0,0 +1,8 @@
+import type { Tool } from '../base.js';
+declare function isSafeCommand(command: string): boolean;
+export declare const executeCommandTool: Tool;
+/** Check if a command is safe (export for use in approval logic). */
+export { isSafeCommand };
+/** All built-in shell tools. */
+export declare const shellTools: Tool[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shell/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAgBvC,iBAAS,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAG/C;AAGD,eAAO,MAAM,kBAAkB,EAAE,IAgEhC,CAAC;AAEF,qEAAqE;AACrE,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB,gCAAgC;AAChC,eAAO,MAAM,UAAU,EAAE,IAAI,EAAyB,CAAC"}

package/dist/shell/index.js

@@ -0,0 +1,85 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { createSchema } from '../base.js';
+const execFileAsync = promisify(execFile);
+const DEFAULT_TIMEOUT = 120_000; // 2 minutes
+const MAX_OUTPUT = 50_000;
+// Commands that are safe to auto-execute without approval
+const SAFE_PREFIXES = [
+    'ls', 'cat', 'head', 'tail', 'wc', 'find', 'grep', 'which', 'echo', 'pwd',
+    'node --version', 'bun --version', 'pnpm --version', 'npm --version',
+    'git status', 'git log', 'git diff', 'git branch',
+    'tsc --noEmit', 'npx eslint', 'pnpm lint', 'npm run lint',
+    'pnpm build', 'npm run build', 'pnpm test', 'npm test',
+];
+function isSafeCommand(command) {
+    const trimmed = command.trim();
+    return SAFE_PREFIXES.some((prefix) => trimmed.startsWith(prefix));
+}
+// ===== execute_command =====
+export const executeCommandTool = {
+    definition: {
+        name: 'execute_command',
+        description: 'Run shell command (Safe cmds run auto).',
+        parameters: createSchema({
+            command: { type: 'string', description: 'Command.' },
+            timeout: { type: 'string', description: 'Timeout (ms).' },
+        }, ['command']),
+        // Dynamic approval: overridden at dispatch time based on command safety
+        requiresApproval: true,
+    },
+    async execute(params, context) {
+        const command = params.command;
+        const scope = context.permissions?.scope || 'block';
+        // Permission check: shell access must be explicitly granted
+        if (!context.permissions?.allowShell && scope !== 'system') {
+            return {
+                content: `Shell access denied. Current permission scope: "${scope}". Set allowShell: true or scope: "system" via \`mblk permissions ${context.blockName} --allow-shell\`.`,
+                isError: true,
+            };
+        }
+        const timeout = context.permissions?.maxTimeout
+            || (params.timeout ? parseInt(params.timeout, 10) : DEFAULT_TIMEOUT);
+        // Determine cwd based on scope
+        let cwd = context.workingDir || context.blockPath;
+        if (scope === 'block') {
+            cwd = context.blockPath;
+        }
+        else if (scope === 'workspace' && context.workspacePath) {
+            // Allow commands within workspace, but default cwd to block
+            cwd = context.workingDir || context.blockPath;
+        }
+        // scope === 'system' — use whatever workingDir is set
+        try {
+            const { stdout, stderr } = await execFileAsync('/bin/sh', ['-c', command], {
+                cwd,
+                timeout,
+                maxBuffer: 2 * 1024 * 1024,
+                env: { ...process.env, HOME: process.env.HOME },
+            });
+            let output = '';
+            if (stdout)
+                output += stdout;
+            if (stderr)
+                output += (output ? '\n--- stderr ---\n' : '') + stderr;
+            if (output.length > MAX_OUTPUT) {
+                output = output.slice(0, MAX_OUTPUT) + `\n...(truncated, ${output.length} total chars)`;
+            }
+            return { content: output || '(no output)', isError: false };
+        }
+        catch (err) {
+            const error = err;
+            let message = error.message;
+            if (error.stdout)
+                message += `\nstdout: ${error.stdout.slice(0, 5000)}`;
+            if (error.stderr)
+                message += `\nstderr: ${error.stderr.slice(0, 5000)}`;
+            return { content: `Command failed: ${message}`, isError: true };
+        }
+    },
+};
+/** Check if a command is safe (export for use in approval logic). */
+export { isSafeCommand };
+/** All built-in shell tools. */
+export const shellTools = [executeCommandTool];
+//# sourceMappingURL=index.js.map

package/dist/shell/index.js.map

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

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@memoryblock/tools",
+  "version": "0.1.0-beta",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "memoryblock": "0.1.0-beta"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json"
+  }
+}

package/src/base.ts

@@ -0,0 +1,24 @@
+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 function createSchema(
+    properties: Record<string, { type: string; description: string; enum?: string[] }>,
+    required: string[] = [],
+): Record<string, unknown> {
+    return {
+        type: 'object',
+        properties,
+        required,
+        additionalProperties: false,
+    };
+}

package/src/core/channels.ts

@@ -0,0 +1,47 @@
+import type { ToolExecutionResult, ToolContext } from 'memoryblock';
+import type { Tool } from '../base.js';
+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: Tool = {
+    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: Record<string, unknown>, context: ToolContext): Promise<ToolExecutionResult> {
+        const target = params.channel as string;
+        const content = params.content as string;
+
+        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 as Error).message}`,
+                isError: true,
+            };
+        }
+    },
+};
+
+export const channelTools = [dispatchMessageTool];