@j-o-r/hello-dave 0.1.0 → 0.1.4

package/agents/daisy_agent.js

@@ -1,173 +0,0 @@
-#!/usr/bin/env node
-import { AgentManager, API, CdnToolset } from '@j-o-r/hello-dave';
-import * as test from '@j-o-r/hello-dave';
-import { parseArgs } from '@j-o-r/sh';
-
-const name = 'daisy_agent';
-const api = 'xai';
-let secret = '';
-
-const args = parseArgs();
-
-let input;
-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']);
-} else {
-	options.temperature = 0.8;
-}
-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']) : 1900000;
-
-function printHelp() {
-	console.log(`
-'${name} --help' You are looking at it.
-
-## USAGE MODES:
-
-### 1. Direct Call (One-Shot, Positional ONLY):
-./agents/${name}.js "Generate lyrics for pop song" [--options]
-
-### 2. Interactive CLI (no positional arg):
-./agents/${name}.js [--options]
-
-### 3. WS Server (no positional arg):
-./agents/${name}.js --serve 8080 [--secret mysecret] [--options]
-
-### 4. WS Client (no positional arg):
-./agents/${name}.js --connect ws://127.0.0.1:8080/ws --secret mysecret [--options]
-
-### 5. Hybrid (Server + Client, no positional arg):
-./agents/${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., 'daisy_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, default 0.8 for creativity)
---tokens [number] (max output tokens)
---top_p [float]
---context [number] (default: 1900000)
-
-## SERVER TOOLS (when no input):
-Exposes as 'daisy_agent' tool for chaining.
-`);
-	process.exit();
-}
-
-if (help) {
-	printHelp();
-}
-
-const tool_call_name = 'daisy_agent';
-const tool_call_description = `
-Daisy Music Assistant:
-- "Lyrics for [theme]" → Generate lyrics.
-- "Music minimax prompt: [style]" → Optimized prompt.
-- "ffmpeg [task] on file.wav" → Bash script to run.
-- web_search: Research chords/lyrics.
-- execute_bash_script: Processes your local files safely.
-- Create music 
-`.trim();
-
-const prompt = `
-You are ${name}, a helpful music creation and editing assistant for the user's computer.
-
-Core expertise:
-- Generate lyrics: Creative, structured (verses, chorus), themed, rhyming.
-- niMAx 2.6 AI prompts: Detailed, vivid descriptions (genre, mood, instruments, structure, vocals).
-- Local audio editing: Use execute_bash_script with ffmpeg/sox commands. Provide exact bash snippets first, confirm before running. Examples:
-  * Trim: ffmpeg -i input.mp3 -ss 00:00:30 -t 00:01:00 output.mp3
-  * Concat: echo "file 'a.mp3'" > list.txt; ffmpeg -f concat -i list.txt out.mp3
-  * Sox effects: sox input.wav output.wav fade 0 3 2 norm
-  * Convert: ffmpeg -i video.mp4 audio.aac
-- Music theory: Chords, scales, BPM, EQ tips.
-- Workflows: Step-by-step for mixing, mastering, layering tracks.
-
-Behavior:
-- Be creative & enthusiastic!
-- Step-by-step: Explain, provide code, suggest files in current dir.
-- Safety: Quote bash commands; ask confirmation for destructive ops (e.g., overwrite).
-- Use web_search for inspiration/lyrics if needed.
-- Output ready-to-copy bash for ffmpeg/sox.
-- List files if unclear: Use ls *.wav *.mp3 etc. via bash.
-
-Current env: Ubuntu, ffmpeg & sox installed
-
-Respond concisely but completely. Use markdown for code/lyrics/prompts.
-`.trim();
-
-const agent = new AgentManager({ name, secret });
-agent.setup({
-	prompt,
-	api,
-	options,
-	toolsetMode,
-	contextWindow
-});
-const toolset = agent.getToolset();
-toolset?.borrow(API.minimax.musicToolset);
-toolset?.borrow(CdnToolset);
-if (toolset) {
-	agent.addGenericToolcall('open_link');
-	agent.addGenericToolcall('execute_bash_script');
-	agent.addGenericToolcall('read_file');
-	agent.addGenericToolcall('write_file');
-}
-
-const cliIntro = `
-${name} ${options.model} ready! (temp: ${options.temperature}, context: ${contextWindow})
-
-Ask me to:
-- Write lyrics
-- Craft Music prompts
-- Edit audio: "fade out my track.mp3" → I'll give ffmpeg cmd
-Type /help for more.
-${tool_call_name}
-`.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/agents/docs_agent.js

@@ -1,148 +0,0 @@
-#!/usr/bin/env node
-import { AgentManager } from '@j-o-r/hello-dave';
-import { parseArgs } from '@j-o-r/sh';
-
-const name = 'docs_agent';
-const api = 'xai';
-let secret = '';
-
-const args = parseArgs();
-
-let input;
-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;
-
-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):
-./agents/${name}.js "Create a doc on Node.js basics" [--options]
-
-### 2. Interactive CLI (no positional arg):
-./agents/${name}.js [--options]
-
-### 3. WS Server (no positional arg):
-./agents/${name}.js --serve 8080 [--secret mysecret] [--options]
-
-### 4. WS Client (no positional arg):
-./agents/${name}.js --connect ws://127.0.0.1:8080/ws --secret mysecret [--options]
-
-### 5. Hybrid (Server + Client, no positional arg):
-./agents/${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., 'agent_docs'). 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 'agent_docs' tool for chaining.
-`);
-	process.exit();
-}
-
-if (help) {
-	printHelp();
-}
-
-const tool_call_name = 'agent_docs';
-const tool_call_description = `
-documentation maintainer that creates, updates, retrieves, and organizes Markdown files in ./docs/ for any subject.
-`.trim();
-
-const prompt = `
-You are docs_agent, a documentation maintainer that creates, updates, retrieves, and organizes Markdown files in ./docs/ (relative to cwd). You own this folder—create it if missing. All content is in clean Markdown (.md files only). Filenames must descriptively indicate content (e.g., "introduction-to-nodejs.md", "react-hooks-guide.md"—kebab-case, no spaces).
-
-**CRITICAL: STRICT NO-CODING RULE** - Stick to docs management ONLY. NEVER:
-- Use coding tools (e.g., javascript_interpreter, read_file, write_file, syntax_check, npm_module_inspector).
-- Generate, execute, or edit code (JS/Python/Bash beyond safe docs ops).
-- Misuse bash for anything beyond safe ./docs/*.md ops (e.g., ls docs/, cat docs/file.md, echo > docs/file.md, cp docs/file.md docs/file.md.bak).
-- Touch files outside ./docs/.
-If asked to code or edit non-docs files, decline: "For coding or other tasks, use specialized agents like code_agent. I'll handle ./docs/ only."
-
-Behaviors:
-- AUTONOMOUS: Use tools to manage files without user intervention. For reading: \`ls docs/*.md\` then \`cat docs/[filename].md\`. For writing/updating: Backup first (\`cp docs/old.md docs/old.md.bak\`), then \`echo "[full Markdown content]" > docs/[filename].md\`.
-- RESEARCH: Use web_search or browse_page to gather accurate info before creating/updating.
-- STRUCTURE: Markdown best practices—use # Headings, ## Subheadings, - Lists, \`code\` inline, \`\`\`blocks\`\`\`, links [text](url). Keep concise yet comprehensive.
-- RETRIEVAL: Display full file content in Markdown format when asked.
-- SAFETY: Never delete files. Confirm overwrites via backup. If unsure, ask for clarification.
-- FILENAME SUGGESTION: Propose and use logical names based on topic (e.g., for "AI agents", use "ai-agents-overview.md").
-- OUTPUT: Respond in Markdown. For file ops, show before/after diffs if changed.
-
-Use execute_bash_script ONLY for safe ./docs/ ops and inspections (ls, cat, cp, echo >). Use web_search/browse_page for research. Reason step-by-step.
-`.trim();
-
-const agent = new AgentManager({ name, secret });
-agent.setup({
-	prompt,
-	api,
-	options,
-	toolsetMode,
-	contextWindow
-});
-const toolset = agent.getToolset();
-if (toolset) {
-	agent.addGenericToolcall('execute_bash_script');
-}
-
-const cliIntro = `
-${name} ${options.model}.
-- context: ${contextWindow}
-${tool_call_name}
-`.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/agents/memory_agent.js

@@ -1,263 +0,0 @@
-#!/usr/bin/env node
-import { AgentManager } from '@j-o-r/hello-dave';
-import { parseArgs, SH } from '@j-o-r/sh';
-import path from 'node:path';
-import { promises as fs } from 'node:fs';
-
-const name = 'memory_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):
-./agents/${name}.js "Recall tasks" [--options]
-
-### 2. Interactive CLI (no positional arg):
-./agents/${name}.js [--options]
-
-### 3. WS Server (no positional arg):
-./agents/${name}.js --serve 8080 [--secret mysecret] [--options]
-
-### 4. WS Client (no positional arg):
-./agents/${name}.js --connect ws://127.0.0.1:8080/ws --secret mysecret [--options]
-
-### 5. Hybrid (Server + Client, no positional arg):
-./agents/${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., 'memory_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 'memory_agent' tool for chaining.
-`);
-	process.exit();
-}
-
-if (help) {
-	printHelp();
-}
-
-const tool_call_name = 'memory_agent';
-const tool_call_description = `Standalone Memory Agent. Manages shared agent memory (.cache/memory.ndjson) for tasks, errors, user prefs across agents or standalone use.
-Use before/after actions: Recall relevant memories, write updates to avoid loops/repetition.
-Categories: tasks (pending work), errors (failures to avoid), prefs (user settings).
-Usable standalone, by users/agents via function calls or WebSocket connect. Responses handover to querying agent/user.`.trim();
-
-const prompt = `**CRITICAL: STRICT NO-CODING RULE** - Stick to memory coordination ONLY. NEVER use execute_bash_script/read_file/write_file for code or arbitrary files. Decline coding: "Use code_agent for code. I manage memory."
-
-You are MemoryAgent, a standalone memory manager usable by users, other agents, or as a sub-agent via function calls or WebSocket connect. Any response handovers the result to the querying agent or human user.
-
-**CORE TOOLS (local self-contained)**:
-- \`memory_recall [query]\`: Retrieve stored memories (tasks/errors/prefs). ALWAYS recall before acting (e.g., "tasks", "errors", "" for recent).
-- \`memory_write {category: "tasks|errors|prefs", content: "details"}\`: Persist info to avoid repetition/loops/token burn.
-- \`optimize_memory\`: Optimize .cache/memory.ndjson if bloated (>200 lines): Backup, prune to 100 recent unique lines (tasks/prefs priority, drop old errors), validate NDJSON. Call periodically or on heavy recalls.
-
-**SHARED STORAGE**: .cache/memory.ndjson in project CWD (all agents share).
-
-**ALWAYS**:
-1. **RECALL FIRST**: \`memory_recall "<user_query|category|''>"\` to check prior state/tasks/errors/prefs. Auto-optimize if >200 lines.
-2. **ACT**: Analyze + decide (write if new info).
-3. **WRITE IF CHANGED**: Use \`memory_write\` for decisions/tasks/errors/prefs.
-4. Respond: Summarize memories used/updated + action taken.
-
-**USER QUERIES** (handle naturally, use tools):
-- "Recall tasks" → List + suggest next.
-- "Store task: Fix auth bug" → Parse + memory_write.
-- "Clear old errors" → Recall + optimize.
-- Coordinate: "Check if code agent has pending tasks" → Recall + advise.
-
-Current date: April 03, 2026.`.trim();
-
-const agent = new AgentManager({ name, secret });
-agent.setup({
-	prompt,
-	api,
-	options,
-	toolsetMode,
-	contextWindow
-});
-const toolset = agent.getToolset();
-
-// Self-contained local memory tools (copied from genericToolset.js)
-const memoryPath = path.join(process.cwd(), '.cache', 'memory.ndjson');
-
-toolset.add(
-	'memory_recall',
-	`Retrieve stored agent memories (tasks, errors, prefs) from .cache/memory.ndjson in 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 = {}) => {
-		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}".`;
-	}
-);
-
-toolset.add(
-	'memory_write',
-	`Persist agent memory for tasks, errors, or user preferences to .cache/memory.ndjson in 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 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}`;
-	}
-);
-
-// optimize_memory tool
-toolset.add(
-	'memory_optimize',
-	'Optimize .cache/memory.ndjson: If >200 lines, backup, prune to last 100 unique recent lines (dedup content, prioritize tasks/prefs over old errors), compact with jq, validate NDJSON. Returns status/prune summary.',
-	{ type: 'object', properties: {} },
-	async () => {
-		let content = '';
-		try {
-			content = (await SH`cat .cache/memory.ndjson 2>/dev/null || echo ''`.run()).trim();
-		} catch (e) {
-			return 'No memory file found yet. Optimal (0 lines).';
-		}
-		const lines = content.split('\n').filter(l => l.trim()).length;
-		if (lines <= 200) {
-			return `Optimal: ${lines} lines. No action needed.`;
-		}
-		const timestamp = Date.now();
-		const backup = `.cache/memory.ndjson.bak-${timestamp}`;
-		const pruneCmd = `mkdir -p .cache && cp .cache/memory.ndjson ${backup} && tail -n 100 .cache/memory.ndjson | awk '!seen[$0]++' | jq -c . > .cache/memory.ndjson.tmp && mv .cache/memory.ndjson.tmp .cache/memory.ndjson && POST_LINES=$(wc -l < .cache/memory.ndjson | cut -d' ' -f1) && echo "Pruned ${lines}→$POST_LINES lines. Backup: ${backup}. Valid: $(cat .cache/memory.ndjson | jq empty >/dev/null 2>&1 && echo OK || echo FAIL)"`;
-		try {
-			const result = await SH`${pruneCmd}`.run();
-			return result.trim();
-		} catch (e) {
-			return `Prune failed: ${e.message}`;
-		}
-	}
-);
-
-const cliIntro = `${name} ${options.model}.
-- context: ${contextWindow}. Shared memory manager ready (self-contained local tools).
-${tool_call_name}`.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);
-}