@j-o-r/hello-dave 0.0.6 → 0.0.7

package/bin/spawn_agent.js

@@ -1,293 +0,0 @@
-#!/usr/bin/env node
-import { AgentManager } from '@j-o-r/hello-dave';
-import { parseArgs } from '@j-o-r/sh';
-
-const name = 'spawn_agent';
-const api = 'xai';
-let secret = '';
-
-const args = parseArgs();
-
-let input; // Directcall input (positional ONLY - NO pipe)
-if (args._.length === 1 && typeof args._[0] === 'string' && args._[0].trim() !== '') {
-	input = args._[0].trim();
-}
-
-const help = args['help'] || false;
-const connect = args['connect'] ? args['connect'] : undefined;
-const serve = args['serve'] ? parseInt(args['serve']) : undefined;
-
-/** @type {import('lib/API/x.ai/responses.js').XAIOptions} */
-const options = { tools: [] };
-options.tools.push({
-	type: 'web_search'
-});
-
-if (args['secret']) {
-	secret = args['secret'];
-}
-if (args['model'] || true) {
-	options.model = args['model'] || 'grok-4-fast-reasoning';
-}
-if (args['temperature']) {
-	options.temperature = parseFloat(args['temperature']);
-}
-if (args['tokens']) {
-	options.max_output_tokens = parseInt(args['tokens']);
-}
-if (args['top_p']) {
-	options.top_p = parseFloat(args['top_p']);
-}
-const reasoning = true;
-if (reasoning) {
-	options.reasoning = {
-		effort: 'medium',
-		summary: 'auto'
-	}
-}
-const toolsetMode = 'auto';
-const contextWindow = args['context'] ? parseInt(args['context']) : 250000;
-
-function printHelp() {
-	console.log(`
-'${name} --help' You are looking at it.
-
-## USAGE MODES:
-
-### 1. Direct Call (One-Shot, Positional ONLY):
-./examples/${name}.js "Create a code agent" [--options]
-
-### 2. Interactive CLI (no positional arg):
-./examples/${name}.js [--options]
-
-### 3. WS Server (no positional arg):
-./examples/${name}.js --serve 8080 [--secret mysecret] [--options]
-
-### 4. WS Client (no positional arg):
-./examples/${name}.js --connect ws://127.0.0.1:8080/ws --secret mysecret [--options]
-
-### 5. Hybrid (Server + Client, no positional arg):
-./examples/${name}.js --serve 8081 --connect ws://other:8080/ws [--secret ...] [--options]
-
-## SERVER OPTIONS EXPLAINED:
---serve [port]: Starts WebSocket SERVER at ws://127.0.0.1:[port]/ws. Allows other agents (--connect) to connect and use this agent as a remote TOOL (e.g., 'spawn_agent'). Runs indefinitely until Ctrl+C.
-
---connect [ws_url]: Connects as CLIENT to remote WS server at [ws_url] (e.g., ws://127.0.0.1:8080/ws). Gains access to remote agent's tools. Interactive CLI available.
-
---secret [string]: SHARED AUTH TOKEN (min 3 chars). SERVER rejects clients without matching --secret. CLIENTS must provide server's secret to connect. Use same secret for chains.
-
-Note: Server/Client/Hybrid IGNORES positional input arg (use CLI modes instead). Hybrid: This agent serves AND uses remote tools.
-
-## OPTIONS:
---model [grok-4-fast-reasoning|...] (default: grok-4-fast-reasoning)
---temperature [float] (-2 to +2)
---tokens [number] (max output tokens)
---top_p [float]
---context [number] (default: 250000)
-
-## SERVER TOOLS (when no input):
-Exposes as 'spawn_agent' tool for chaining.
-`);
-	process.exit()
-}
-
-if (help) {
-	printHelp();
-}
-
-const tool_call_name = 'spawn_agent';
-const tool_call_description = `
-Portable creator for CLI/WS agents (bin/<name>.js) + PM2 multi-agent launchers. Validates/tests/deploys. No local docs needed.
-`.trim();
-
-const REPO_URL = 'https://codeberg.org/duin/hello-dave';
-const DOCS_BASE = `${REPO_URL}/src/branch/main/docs/`;
-const EXAMPLES_URL = `${REPO_URL}/src/branch/main/examples/`;
-
-const promptParts = [
-  'You are AgentCreator, expert in @j-o-r/hello-dave. Create production-ready CLI agents (bin/<name>.js) **portably** anywhere (no local docs needed).',
-  '',
-  '**AGENT NAME RULE ⚠️**: name MUST be lowercase a-z0-9_ min 2 chars (/^[a-z_0-9_]{2,}$/). EX: myagent, codeagent, ws_tool.',
-  '',
-  '**IMPORTS CRITICAL ⚠️**: **NAMED imports ONLY** - NO default! `import { AgentManager } from \'@j-o-r/hello-dave\';` `import { parseArgs } from \'@j-o-r/sh\';`',
-  '',
-  '**PORTABILITY**: Auto-install deps: `@j-o-r/hello-dave @j-o-r/sh`. Absolute imports. NO local file refs (docs/examples).',
-  '',
-  '**MANDATORY MEMORY PROTOCOL (For EVERY query/task - NO EXCEPTIONS):**',
-  'Connected clients (todo_agent, readme_agent, npm_agent, docs_agent, **memory_agent**) are available as tools. **ALWAYS** use **memory_agent** FIRST and LAST:',
-  '1. **RECALL PHASE (Step 1 of EVERY response)**:',
-  '   - Call `memory_agent "Recall relevant memories: tasks, errors, prefs for [keywords from user query]. List recent if empty."`',
-  '   - Incorporate recalled info (e.g., avoid known errors, resume tasks, apply prefs like temp=0.2).',
-  '2. **CORE ACTION**:',
-  '   - Perform coding assistance (tools: execute_bash_script, javascript_interpreter, read_file/write_file, web_search, etc.).',
-  '   - Delegate to specialists if relevant:',
-  '     - todo_agent: Tasks/TODO.md',
-  '     - readme_agent: README.md',
-  '     - npm_agent: NPM modules/package.json',
-  '     - docs_agent: Documentation',
-  '     - memory_agent: Persistent storage',
-  '3. **WRITE PHASE (Step 3 of EVERY response)**:',
-  '   - Call `memory_agent "Store updates: [new tasks/errors/prefs/decisions from this interaction]. E.g., \'Task: [next step]\', \'Error: [issue]\', \'Pref: [setting]\'"`',
-  '   - This ensures persistence across sessions/agents, prevents loops/token burn.',
-  '',
-  '**PRIORITIES**:',
-  '- Safety: CWD-only, no escapes, validate before write.',
-  '- Efficiency: Use memories to skip repeats (e.g., "Known error: git conflict → skip").',
-  '- Step-by-step: Clear responses with code blocks.',
-  'FOLLOW MEMORY PROTOCOL RIGIDLY - it\'s how multi-agent coordination works!',
-  '',
-  '**INITIAL INSPECT** (execute_bash_script):',
-  '1. `npm ls @j-o-r/hello-dave @j-o-r/sh 2>/dev/null || echo MISSING` → If MISSING: `npm i @j-o-r/hello-dave @j-o-r/sh --save-exact`.',
-  '2. `mkdir -p bin examples`.',
-  '3. `cat package.json` (project name). `ls -la bin/`.',
-  '',
-  '**TOOL RULES (CRITICAL - NO MIX)**:',
-  '- **XAI Natives** (pre-setup): `options.tools.push({ type: \'web_search\' });` etc.',
-  '- **Generics** (post-setup): `agent.addGenericToolcall(\'read_file\');` w/ `toolsetMode: \'auto\'`.',
-  'Default: web_search + execute_bash_script/read_file/write_file.',
-  '',
-  '**PROCESS (EXACT)**:',
-  '1. INSPECT & SETUP.',
-  '2. GATHER (conversational): **name (validate /^[a-z_0-9_]{2,}$/ or reject)**, desc, api(\'xai\'), model/options, tools, custom prompt, CLI intro/help.',
-  '3. GENERATE & VALIDATE: Use blueprint. Write temp_validate.js, `node --check temp_validate.js` (PASS), grep toolsetMode/auto (1x), generics/addGeneric (≥1 if used), natives/push (≥1 if used), NO options.tools.function.read_file. rm temp.',
-  '4. REVIEW: Show ```js``` + "✅ node --check | Tools OK". Edit if needed.',
-  '5. DEPLOY: `write_file ./bin/${name}.js FULL_CODE`, `chmod +x ./bin/${name}.js`.',
-  '6. **TEST**: `execute_bash_script \'./bin/${name}.js "Briefly describe yourself and your modes (CLI/server/client)"\'` → Show output.',
-  '7. **SERVER/CLIENT GUIDE**: "Test server: ./bin/${name}.js --serve 8081 (find free port). Client: echo \'query\' | ./bin/${name}.js --connect ws://localhost:8081/ws --secret SECRET".',
-  '8. **CodeServer MULTI-AGENT**: If requested (e.g., "multi-agent", "CodeServer"), generate **self-contained Bash launcher** (PM2-managed main server + subs). Write to examples/<Name>Server (e.g., examples/CodeServer). Use blueprint below. PM2: Assume installed (`npm i -g pm2`).',
-  '',
-  '**AGENT BLUEPRINT** (COPY/REPLACE - Plain backticks ` NO ESCAPES):',
-  `\`#!/usr/bin/env node
-import { AgentManager } from '@j-o-r/hello-dave';
-import { parseArgs } from '@j-o-r/sh';
-
-const name = 'AGENTNAME';  // ← REPLACE w/ lowercase /^[a-z_0-9_]{2,}$/
-const api = 'xai';
-let secret = '';
-
-const args = parseArgs();
-const help = args['help'] || false;
-const connect = args['connect'] ? args['connect'] : undefined;
-const serve = args['serve'] ? parseInt(args['serve']) : undefined;
-
-const options = { tools: [] };
-
-// NATIVES HERE e.g. options.tools.push({ type: 'web_search' });
-
-if (args['secret']) { secret = args['secret']; }
-if (args['model'] || true) { options.model = args['model'] || 'grok-4-fast-reasoning'; }
-if (args['temperature']) { options.temperature = parseFloat(args['temperature']); } else { options.temperature = 0.8; }
-options.reasoning = { effort: 'medium', summary: 'auto' };
-
-const contextWindow = args['context'] ? parseInt(args['context']) : 500000;
-const toolsetMode = 'auto';
-
-function printHelp() {
-  console.log(\`AGENTNAME --help: AGENTDESC
-
-Full modes: CLI, WS Server (--serve), WS Client (--connect), Hybrid.
-
-Repo docs: https://codeberg.org/duin/hello-dave (agent-manager.md, codeserver-pattern.md).
-
-USAGE:
-  ./bin/AGENTNAME             # Interactive CLI
-  echo "query" | ./bin/AGENTNAME  # One-shot
-  ./bin/AGENTNAME --serve 8081    # WS Server
-  ./bin/AGENTNAME --connect ws://host:8081/ws --secret KEY  # WS Client
-  ./bin/AGENTNAME --serve 8081 --connect ws://other:8080/ws  # Hybrid
-
-OPTIONS: --model ... --secret ...
-
-EXAMPLES:
-  Chain: Server A --connect B → delegates to B.
-  Multi-Agent: Generate/use PM2 launcher (CodeServer pattern).\`);
-  process.exit();
-}
-
-if (help) printHelp();
-
-const prompt = \`You are AGENTNAME, AGENTDESC.
-
-CUSTOMPROMPT\`.trim();
-
-const agent = new AgentManager({ name, secret });
-agent.setup({ prompt, api, options, toolsetMode, contextWindow });
-
-// GENERICS HERE e.g. agent.addGenericToolcall('execute_bash_script');
-
-const cliIntro = \`🤖 AGENTNAME ready! Modes: CLI/Server/Client/Hybrid.
-
-CLIINTRO\`.trim();
-
-const toolName = 'agent_' + name;
-const toolDescription = \`AGENTDESC. Supports WS chaining/multi-agent.\`.trim();
-
-await agent.start(serve, connect, cliIntro, toolName, toolDescription);\``,
-  '',
-  '**CODE_SERVER BLUEPRINT** (Bash for multi-agent - Self-contained, like CodeServer pattern):',
-  `\`#!/bin/bash
-# Portable Multi-Agent Launcher (PM2-managed: main server + subs)
-# Run: npm i -g pm2 (once)
-if [ $# -lt 1 ] || [ $# -gt 2 ]; then
-  echo "Usage: $0 <PORT> [SECRET]  # PORT:1024-65535, SECRET:>=3 chars (def:123)"
-  exit 1
-fi
-PORT="$1"
-SECRET="\${2:-123}"
-if [ \${#SECRET} -lt 3 ]; then echo "SECRET too short"; exit 1; fi
-if ! [[ "$PORT" =~ ^[0-9]+$ ]] || [ "$PORT" -lt 1024 ] || [ "$PORT" -gt 65535 ]; then echo "Bad PORT"; exit 1; fi
-
-SCRIPT_DIR="\$( cd "\$( dirname "\${BASH_SOURCE[0]}" )" && pwd )"
-PROJECT_DIR="\$( cd "\$( dirname "\${SCRIPT_DIR}" )" && pwd )"
-FOLDER=\$(basename "$PROJECT_DIR")
-
-echo "Starting <MainAgent>Server on port \${PORT} in '\$FOLDER' w/ SECRET '\$SECRET'..."
-
-# Cleanup old PM2
-pm2 delete "\${FOLDER}_mainagent_\${PORT}" 2>/dev/null || true
-pm2 delete "\${FOLDER}_sub1agent_\${PORT}" 2>/dev/null || true  # Add per sub
-# ... more subs
-
-# Main server
-pm2 start "\${SCRIPT_DIR}/bin/mainagent.js" --name "\${FOLDER}_mainagent_\${PORT}" -- --serve "\${PORT}" --tools javascript --secret "\${SECRET}"
-# Subs as clients
-pm2 start "\${SCRIPT_DIR}/bin/sub1agent.js" --name "\${FOLDER}_sub1agent_\${PORT}" -- --connect "ws://127.0.0.1:\${PORT}/ws" --secret "\${SECRET}"
-# ... more: pm2 start ... sub2agent.js ...
-
-echo "Processes: pm2 list | grep '\${FOLDER}_\${PORT}'"
-echo "Connect: npx @j-o-r/hello-dave dave --connect ws://127.0.0.1:\${PORT}/ws --secret '\${SECRET}'"\``,
-  '',
-  'Enthusiastic, step-by-step. Match portable style. **ALWAYS validate name regex before generate/deploy.** Current date: 2026. Models: grok-4-fast-reasoning/grok-beta. CodeServer pattern: https://codeberg.org/duin/hello-dave/src/branch/main/examples/CodeServer'
-];
-
-const prompt = promptParts.join('\\n');
-
-const agent = new AgentManager({ name, secret });
-agent.setup({
-	prompt,
-	api,
-	options,
-	toolsetMode,
-	contextWindow
-});
-const toolset = agent.getToolset();
-if (toolset) {
-	agent.addGenericToolcall('execute_bash_script');
-	agent.addGenericToolcall('read_file');
-	agent.addGenericToolcall('write_file');
-	agent.addGenericToolcall('javascript_interpreter');
-}
-const cliIntro = `🤖 ${name} (${options.model}) ready! (context: ${contextWindow})
-
-Portable Agent Creator: Builds CLI/WS agents + CodeServer launchers **anywhere** (auto-deps, online docs).
-
-Examples: 
-- "Create code-review agent: name=coderev, desc=Git diff analyzer, tools=read_file execute_bash_script web_search"
-- "Generate CodeServer launcher for coderev + tododave + npmdave"`.trim();
-
-if (input) {
-	const RES = await agent.directCall(input);
-	console.log(RES);
-} else {
-	await agent.start(serve, connect, cliIntro, tool_call_name, tool_call_description);
-}

package/lib/genericToolset.js.bak_syntax

@@ -1,402 +0,0 @@
-import { SH, bashEscape } from '@j-o-r/sh'
-import { ToolSet, env } from './index.js'
-import path from 'node:path';
-import { promises as fs } from 'node:fs';
-import { fileURLToPath } from 'node:url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-const user = await env();
-const environment = ` 
-Name: ${user.name}
-System: ${user.system}
-City: ${user.city}
-Region: ${user.region}
-Country: ${user.country}
-Timezone: ${user.timezone}
-ExternalIp: ${user.external_ip}  
-`.trim();
-const tools = new ToolSet('auto');
-
-/**
-* reduce the error output to essential info only, if possible
-* @param {string} errorStr
-* @returns {string}
-*/
-const getJSError = (errorStr) => {
-	let result = '';
-	const linematch = errorStr.match(/\[eval\]:(\d+)/);
-	const lineNumber = linematch ? linematch[1] : '';
-	const match = errorStr.split(/\" \"\[eval\]:\d+/s);
-	if (match.length > 1) {
-		// Remove last 10 lines
-		const res = match[1].split('\n').slice(0, -10).join('\n');
-		result = `Error: line ${lineNumber}\n${res} `
-	} else {
-		result = errorStr;
-	}
-	return result;
-}
-
-tools.add(
-	'javascript_interpreter',
-	`Execute ESM ES6 javascript on \`node\`.`,
-	{
-		type: 'object',
-		properties: {
-			script: {
-				type: 'string',
-				description: `ES6 ESM Javascript eval. 'console.log' to capture the response. cwd: ${user.cwd}`,
-			}
-		},
-		required: ['script']
-	},
-	async (params) => {
-		let response = '';
-		try {
-			const delim = `JS_STDIN_${Date.now().toString(36)}_${Math.random().toString(36).slice(2,6)}`;
-			response = await SH`cat <<'${delim}' | node --input-type=module -
-${params.script}
-${delim}
-`.run();
-		} catch (e) {
-			const errorStr = e.toString();
-			response = getJSError(errorStr);
-		}
-		return response;
-	}
-);
-tools.add(
-	'get_user_env', // name
-	'Get the user location, name and OS environment', // desciption
-	{
-		type: 'object',
-		properties: {
-		}
-	},
-	async (_params) => {
-		return environment;
-	}
-);
-
-tools.add(
-	'execute_bash_script',
-	'Execute a bash script or command. (char escaping not needed)',
-	{
-		type: 'object',
-		properties: {
-			bash_script: { type: 'string', description: `RAW bash script (LITERAL TEXT: NO ESCAPING—output $, |, <, >, &, ", ', \\, \` , newlines, $(()), [[ ]] verbatim. Heredoc delimiter handles safely. EX: echo "$((1+1)) | grep \'<&>\"hi$USER\"\' && ls -la\`. (${user.system})` }
-		},
-		required: ['bash_script']
-	},
-	async (params) => {
-		const delim = `END_SCRIPT_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
-		return await SH`bash <<'${delim}'
-${params.bash_script}
-${delim}
-`.run()
-	}
-);
-
-tools.add(
-	'send_email',
-	'Send an email.',
-	{
-		type: 'object',
-		properties: {
-			to: { type: 'string', description: 'Recipient email' },
-			subject: { type: 'string', description: 'Subject' },
-			body: { type: 'string', description: 'Message body' }
-		},
-		required: ['to', 'subject', 'body']
-	},
-	async (params) => {
-		const delim = `END_EMAIL_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
-		return await SH`msmtp ${params.to} <<'${delim}'
-To: ${params.to}
-Subject: ${params.subject}
-
-${params.body}
-${delim}
-`.run();
-	}
-);
-tools.add(
-	'open_link',
-	'Open an url or file in the local user environment. (xdg-open)',
-	{
-		type: 'object',
-		properties: {
-			url: { type: 'string', description: 'file | URL' }
-		},
-		required: ['url']
-	},
-	async (params) => {
-		return await SH`xdg-open ${[params.url]}`.run();
-	}
-);
-tools.add(
-	'execute_remote_script',
-	'Execute bash script on a remote machine via SSH.',
-	{
-		type: 'object',
-		properties: {
-			url: { type: 'string', description: 'SSH URL, e.g., ssh://user@host or ssh://user@host:port' },
-			script: { type: 'string', description: 'RAW script code to execute remotely (no escaping needed)' }
-		},
-		required: ['url', 'script']
-	},
-	async (params) => {
-		const { url, script } = params;
-		if (!url.startsWith('ssh://')) throw new Error('Invalid SSH URL');
-		const withoutProto = url.slice(6);
-		const parts = withoutProto.split(':');
-		let port = 22;
-		let userHost = withoutProto;
-		if (parts.length > 1) {
-			userHost = parts[0];
-			port = parseInt(parts[1]);
-		}
-		const [user, host] = userHost.split('@');
-		if (!user || !host) throw new Error('Invalid SSH URL format: use ssh://user@host[:port]');
-
-		const delim = `END_SCRIPT_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
-		return await SH`ssh -p ${port} ${user}@${host} bash <<'${delim}'
-${script}
-${delim}
-`.run();
-
-	}
-);
-tools.add(
-  'history_search',
-  `Search previous LLM chat sessions or list them hierarchically.
-Example query: "(todo|task)" or "package.json".
-Searches filenames & content in .cache/[app]/[prompt]/sessions/*.ndjson (case-insensitive regex, with context).
-Omit query (or use empty string) to list sessions (see utils/list_sessions.sh).`,
-  {
-    type: 'object',
-    properties: {
-      query: {
-        type: 'string',
-        description: `Search query or regex (quoted for multi-word/regex). Omit or empty for list mode.`
-      }
-    },
-    required: []
-  },
-  async (params) => {
-    const history_search = path.resolve(__dirname, '..', 'utils', 'search_sessions.sh');
-    const list_sessions = path.resolve(__dirname, '..', 'utils', 'list_sessions.sh');
-    if (typeof params.query === 'string' && params.query.trim() !== '') {
-      const escapedQuery = bashEscape(params.query);
-      return await SH`${history_search} "${escapedQuery}"`.run();
-    } else {
-      return await SH`${list_sessions}`.run();
-    }
-  }
-);
-tools.add(
-	'read_file',
-	'Read the raw content of a file strictly within the current working directory (CWD). Paths must be relative (no leading /, no ..).',
-	{
-		type: 'object',
-		properties: {
-			file: {
-				type: 'string',
-				description: `Relative path to the file within CWD, e.g., 'path/to/file.txt' (no escaping needed). cwd: ${user.cwd}`
-			}
-		},
-		required: ['file']
-	},
-	async (params) => {
-		const file = params.file?.trim();
-		if (typeof file !== 'string' || !file) {
-			throw new Error('Valid relative file path required.');
-		}
-		if (file.startsWith('/') || file.includes('..') || file.includes('\\\\')) {
-			throw new Error('Path must be relative within CWD only (no `/`, `..`, or `\\\\`).');
-		}
-		const resolvedPath = path.resolve(process.cwd(), file);
-		if (!resolvedPath.startsWith(process.cwd())) {
-			throw new Error(`Path '${file}' escapes CWD scope.`);
-		}
-		try {
-			const content = await fs.readFile(resolvedPath, 'utf8');
-			return content;
-		} catch (e) {
-			throw new Error(`Failed to read '${file}': ${e.message}`);
-		}
-	}
-);
-
-tools.add(
-	'write_file',
-	'Write raw content to a file strictly within the current working directory (CWD). Paths must be relative (no leading /, no ..). Content written as-is (no escaping). **AUTO-VALIDATES** JS/Python/Bash/JSON/etc. via `utils/syntax_check.sh`; chmod +x shebangs. Retries syntax errors force LLM fix.',
-	{
-		type: 'object',
-		properties: {
-			file: {
-				type: 'string',
-				description: `Relative path to the file within CWD, e.g., 'path/to/file.txt' (no escaping needed).`
-			},
-			content: {
-				type: 'string',
-				description: `Raw content to write (as-is, no char escaping needed; supports newlines, $, |, <, >, &, ", ', \\, etc.).`
-			}
-		},
-		required: ['file', 'content']
-	},
-	async (params) => {
-		const file = params.file?.trim();
-		const content = params.content ?? '';
-		if (typeof file !== 'string' || !file) {
-			throw new Error('Valid relative file path required.');
-		}
-		if (file.startsWith('/') || file.includes('..') || file.includes('\\\\')) {
-			throw new Error('Path must be relative within CWD only (no `/`, `..`, or `\\\\`).');
-		}
-		const resolvedPath = path.resolve(process.cwd(), file);
-		if (!resolvedPath.startsWith(process.cwd())) {
-			throw new Error(`Path '${file}' escapes CWD scope.`);
-		}
-		try {
-			await fs.writeFile(resolvedPath, content, 'utf8');
-			
-			// AUTO-VALIDATE: Multi-lang syntax check via utils/syntax_check.sh + chmod shebang
-			const syntaxChecker = path.resolve(process.cwd(), 'utils/syntax_check.sh');
-			const hasShebang = content.startsWith('#!');
-			
-			let validationMsg = '';
-			try {
-				await SH`${syntaxChecker} ${[resolvedPath]}`.run();
-				validationMsg = ' ✓ Multi-lang syntax OK';
-			} catch (e) {
-				const errPreview = content.slice(0, 1000).split('\n').slice(0, 20).join('\n');
-				throw new Error(`❌ SYNTAX ERROR in '${file}' (syntax_check.sh failed):\n${e.message}\n\nPREVIEW:\n${errPreview}\n\n... Fix syntax (quotes/backticks) and retry write_file.`);
-			}
-			if (hasShebang) {
-				await SH`chmod +x ${[resolvedPath]}`.run();
-				validationMsg += ' ✓ chmod +x';
-			}
-			
-			return `Successfully wrote to '${file}' (${Buffer.byteLength(content, 'utf8')} bytes).${validationMsg}`;
-		} catch (e) {
-			throw new Error(`Failed to write '${file}': ${e.message}`);
-		}
-	}
-);
-
-tools.add(
-  'syntax_check',
-  'Standalone syntax validation for files (JS/Python/Bash/JSON/etc.) via utils/syntax_check.sh. Detects lang from ext/shebang.',
-  {
-    type: 'object',
-    properties: {
-      file: {
-        type: 'string',
-        description: `Relative path to the file within CWD.`
-      }
-    },
-    required: ['file']
-  },
-  async (params) => {
-    const file = params.file?.trim();
-    if (typeof file !== 'string' || !file) {
-      throw new Error('Valid relative file path required.');
-    }
-    const resolvedPath = path.resolve(process.cwd(), file);
-    if (!resolvedPath.startsWith(process.cwd())) {
-      throw new Error(`Path '${file}' escapes CWD scope.`);
-    }
-    const syntaxChecker = path.resolve(process.cwd(), 'utils/syntax_check.sh');
-    return await SH`${syntaxChecker} ${[resolvedPath]}`.run();
-  }
-);
-
-tools.add(
-  'memory_write',
-  `Persist agent memory for tasks, errors, or user preferences to .cache/memory.ndjson in CWD (${user.cwd}). Use to store decisions, tasks, errors, or prefs for later recall. Agent should use this to avoid repeating work or token burn on loops.`,
-  {
-    type: 'object',
-    properties: {
-      category: {
-        type: 'string',
-        enum: ['tasks', 'errors', 'prefs'],
-        description: 'Category: one of "tasks", "errors", "prefs"'
-      },
-      content: {
-        type: 'string',
-        description: 'Detailed content (e.g., "Pending task: implement runWithMemory optimization", "Error: loop burning tokens", "Pref: temperature=0.2 for decisions")'
-      }
-    },
-    required: ['category', 'content']
-  },
-  async ({category, content}) => {
-    if (!['tasks', 'errors', 'prefs'].includes(category)) {
-      throw new Error(`Invalid category '${category}'. Must be 'tasks', 'errors', or 'prefs'.`);
-    }
-    const memoryPath = path.join(process.cwd(), '.cache', 'memory.ndjson');
-    const dir = path.dirname(memoryPath);
-    try {
-      await fs.mkdir(dir, { recursive: true });
-    } catch (e) {
-      // Dir likely exists
-    }
-    const entry = {
-      timestamp: new Date().toISOString(),
-      category,
-      content: content.trim()
-    };
-    await fs.appendFile(memoryPath, JSON.stringify(entry) + '\n', 'utf8');
-    return `✓ Memory stored: [${category}] ${content.length > 50 ? content.slice(0, 47) + '...' : content}`;
-  }
-);
-
-tools.add(
-  'memory_recall',
-  `Retrieve stored agent memories (tasks, errors, prefs) from .cache/memory.ndjson in CWD (${user.cwd}). Use before acting to check prior decisions/tasks/errors/prefs. Query by keyword or category; empty lists recent.`,
-  {
-    type: 'object',
-    properties: {
-      query: {
-        type: 'string',
-        description: 'Keyword, category (tasks/errors/prefs), or phrase to filter (case-insensitive). Empty/omit lists last 20.'
-      }
-    },
-    required: []
-  },
-  async (params = {}) => {
-    const memoryPath = path.join(process.cwd(), '.cache', 'memory.ndjson');
-    let content;
-    try {
-      content = await fs.readFile(memoryPath, 'utf8');
-    } catch (e) {
-      return 'No memories stored yet. Use memory_write first.';
-    }
-    const lines = content.trim().split('\n').filter(l => l.trim());
-    const memories = [];
-    for (const line of lines) {
-      try {
-        memories.push(JSON.parse(line));
-      } catch {
-        // Skip invalid lines
-      }
-    }
-    if (!params.query || !params.query.toString().trim()) {
-      const recent = memories.slice(-20).reverse();
-      return recent.length 
-        ? 'Recent memories:\n' + recent.map(m => `• ${m.timestamp.slice(0, 19).replace('T', ' ')} [${m.category}] ${m.content}`).join('\n')
-        : 'No memories stored.';
-    }
-    const q = params.query.toString().toLowerCase();
-    const matches = memories.filter(m => 
-      m.category.toLowerCase().includes(q) || m.content.toLowerCase().includes(q)
-    );
-    return matches.length 
-      ? `Matches for "${params.query}":\n` + matches.slice(0, 20).map(m => `• ${m.timestamp.slice(0, 19).replace('T', ' ')} [${m.category}] ${m.content}`).join('\n')
-      : `No memories match "${params.query}".`;
-  }
-);
-
-export default tools