@j-o-r/hello-dave 0.1.1 → 0.1.5

package/agents/spawn_agent.js

@@ -1,160 +0,0 @@
-#!/usr/bin/env node
-import { AgentManager } from '@j-o-r/hello-dave';
-import { parseArgs } from '@j-o-r/sh';
-import fs from 'fs';
-import path from 'path';
-import { createRequire } from 'module';
-
-const name = 'spawn_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']);
-}
-if (true) {
-        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):
-./${name}.js "Create a code agent" [--options]
-
-### 2. Interactive CLI (no positional arg):
-./${name}.js [--options]
-
-### 3. WS Server (no positional arg):
-./${name}.js --serve 8080 [--secret mysecret] [--options]
-
-### 4. WS Client (no positional arg):
-./${name}.js --connect ws://127.0.0.1:8080/ws --secret mysecret [--options]
-
-### 5. Hybrid (Server + Client, no positional arg):
-./${name}.js --serve 8081 --connect ws://other:8080/ws [--secret ...] [--options]
-
-## PORTABILITY NOTES:
-- **Tools follow YOUR CWD** (e.g., cd /tmp/proj && ./spawn_agent.js → tools in /tmp/proj).
-- **Hybrid Modes**: PROJECT (agents/*.js exist): Auto-deploy/test. FRESH (empty agents/): Code + manual bash.
-- **Custom Tools**: natives=web_search, generics=read_file, custom={type:'git_diff',...}
-- **Prompt**: Loaded with priority to local file inside the @j-o-r/hello-dave npm module (docs/prompt/spawn_agent.md), fallback to live repo fetch.
-
-## OPTIONS:
---model [grok-4-fast-reasoning|...] (default: grok-4-fast-reasoning)
---temperature [float] (0.8)
---tokens [number]
---top_p [float]
---context [number] (250k)
-
-## Examples:
-"Create coderev: desc=Git analyzer, natives=web_search, generics=read_file execute_bash_script, custom=options.tools.push({type:'git_diff',description:'...',parameters:{...}})"
-`);
-        process.exit();
-}
-
-if (help) {
-        printHelp();
-}
-
-const tool_call_name = 'spawn_agent';
-const tool_call_description = `Portable creator for CLI/WS agents + PM2 launchers. Tools use exec CWD (/tmp OK). PROJECT (agents/*.js >0): Full auto. FRESH: Manual code/bash.
-
-Test new agent: ./agents/NEW.js --help | 'describe' | --serve 8081 --secret abc
-
-Custom ex: natives=[{type:'mytool'}], generics=read_file
-
-Prompt priority: local relative to @j-o-r/hello-dave module or live https://codeberg.org/duin/hello-dave/raw/branch/main/docs/prompt/spawn_agent.md`.trim();
-
-const REPO_URL = 'https://codeberg.org/duin/hello-dave';
-
-async function fetchLivePrompt() {
-  const promptFile = 'docs/prompt/spawn_agent.md';
-
-  // Priority 1: Local relative to the installed @j-o-r/hello-dave module (best for npm/offline)
-  try {
-    const require = createRequire(import.meta.url);
-    const packageJsonPath = require.resolve('@j-o-r/hello-dave/package.json');
-    const moduleRoot = path.dirname(packageJsonPath);
-    const localPromptPath = path.join(moduleRoot, promptFile);
-    if (fs.existsSync(localPromptPath)) {
-      const localPrompt = fs.readFileSync(localPromptPath, 'utf8');
-      console.log(`[spawn_agent] Loaded prompt locally from module: ${localPromptPath}`);
-      return localPrompt;
-    }
-  } catch (localErr) {
-    console.warn('[spawn_agent] Local module prompt load skipped:', localErr.message);
-  }
-
-  // Priority 2: Live remote (for latest updates)
-  const promptUrl = `${REPO_URL}/raw/branch/main/${promptFile}`;
-  console.log(`[spawn_agent] Fetching live prompt: ${promptUrl}`);
-  const response = await fetch(promptUrl);
-  if (!response.ok) {
-    throw new Error(`HTTP ${response.status}`);
-  }
-  const text = await response.text();
-  console.log('[spawn_agent] Loaded live prompt from Codeberg');
-  return text;
-}
-
-const agent = new AgentManager({ name, secret });
-
-const prompt = await fetchLivePrompt();
-
-agent.setup({
-  prompt,
-  api,
-  options,
-  toolsetMode,
-  contextWindow
-});
-
-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 Creator: PROJECT (agents/*.js exist): Auto. FRESH (empty): Manual code.
-Prompt: local in @j-o-r/hello-dave module preferred.
-
-Ex: "Create testagent: desc=Tester, natives=web_search"`.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/stability.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 = 'stability';
-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.stability.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/todo_agent.js

@@ -1,175 +0,0 @@
-#!/usr/bin/env node
-import { AgentManager } from '@j-o-r/hello-dave';
-import { parseArgs } from '@j-o-r/sh';
-
-const name = 'todo_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 "List 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., 'todo_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 'todo_agent' tool for chaining.
-`);
-	process.exit()
-}
-
-if (help) {
-	printHelp();
-}
-
-const tool_call_name = 'todo_agent';
-const tool_call_description = `
-Project TODO list manager. Maintains TODO.md with tasks in Markdown checklists.
-Inspects current TODO.md, adds/checks/completes tasks based on input, updates the file.
-Suggests next actions, stores future important tasks.
-`.trim();
-
-const prompt = `
-You are an expert TODO manager for this project. TODO.md stores tasks in Markdown format with checklists:
-
-## TODO (high priority pending)
-- [ ] Task 1
-
-## In Progress
-- [ ] Task 2
-
-## Later (future tasks)
-- [ ] Important task to do later
-
-## Done
-- [x] Completed task
-
-**CRITICAL: STRICT NO-CODING RULE** - Stick to TODO management ONLY. NEVER:
-- Use coding tools (e.g., javascript_interpreter, write_file, read_file, syntax_check).
-- Generate, execute, or edit code.
-- Misuse bash for anything beyond safe TODO.md ops (e.g., cat TODO.md, echo > TODO.md).
-If asked to code, decline: "For coding, use other agents. I'll handle TODOs only."
-Delegate complex tasks via suggestions; use memory_agent if available for persistence.
-
-ALWAYS:
-
-1. Inspect the current TODO.md file if it exists (use \`cat TODO.md\` or similar).
-
-2. Understand the user input: 
-   - Add new tasks: "add task: Fix bug in foo.js"
-   - Complete: "done: task X" or mark specific
-   - Check status: "status" or "what's next?"
-   - Prioritize/reorganize
-   - Archive old done tasks if too many
-
-3. Update TODO.md with changes. Keep it organized, add dates if useful (e.g., - [ ] 2026-02-24: Task).
-
-4. Write the FULL updated content to ./TODO.md.
-
-5. In your response, summarize:
-   - Current status (pending count, next suggested)
-   - Changes made
-   - Updated TODO.md preview (first 10 lines or key sections)
-
-If no TODO.md, create one inspecting the project (package.json, README.md, git status) for initial tasks like "Review code", "Add tests", etc.
-
-Use tools to inspect files as needed (ls, cat, git log, etc.).
-`.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}. TODO manager ready.
-${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/bin/codeDave

@@ -1,58 +0,0 @@
-#!/bin/bash
-if [ $# -lt 1 ] || [ $# -gt 2 ]; then
-  echo "Usage: $0 <PORT> [SECRET]  # PORT: 1024-65535, SECRET: optional (defaults to '123')"
-  exit 1
-fi
-
-PORT="$1"
-SECRET="${2:-123}"
-
-if [ -z "$SECRET" ] || [ ${#SECRET} -lt 3 ]; then
-  echo "Error: SECRET must be at least 3 characters: '$SECRET'"
-  exit 1
-fi
-
-if ! [[ "$PORT" =~ ^[0-9]+$ ]] || [ "$PORT" -lt 1024 ] || [ "$PORT" -gt 65535 ]; then
-  echo "Error: Invalid port number: $PORT. Must be between 1024 and 65535."
-  exit 1
-fi
-
-# Compute canonical paths relative to THIS script's real location (resolves symlinks for global npm installs)
-SOURCE="${BASH_SOURCE[0]}"
-while [ -h "$SOURCE" ]; do
-  DIR="$( cd -P "$( dirname "$SOURCE" )" >/dev/null 2>&1 && pwd )"
-  SOURCE="$(readlink "$SOURCE")"
-  [[ $SOURCE != /* ]] && SOURCE="$DIR/$SOURCE"
-done
-SCRIPT_DIR="$( cd -P "$( dirname "$SOURCE" )" >/dev/null 2>&1 && pwd )"
-PROJECT_DIR="$( cd -P "$( dirname "$SCRIPT_DIR" )" >/dev/null 2>&1 && pwd )"
-
-# FOLDER: basename of CURRENT WORKING DIRECTORY (pwd) for per-project PM2 prefixes (e.g., myproject_code_8080)
-# This allows multi-project usage without name conflicts; PROJECT_DIR remains package location for agents/
-FOLDER=$(basename "$(pwd)")
-
-echo "Starting codeDave on port ${PORT} in folder '${FOLDER}' (SCRIPT_DIR: ${SCRIPT_DIR}) with SECRET '${SECRET}'..."
-
-# Delete existing processes with folder_port suffix
-pm2 delete "${FOLDER}_code_${PORT}" 2>/dev/null || true
-pm2 delete "${FOLDER}_todo_${PORT}"  2>/dev/null || true
-pm2 delete "${FOLDER}_readme_${PORT}" 2>/dev/null || true
-pm2 delete "${FOLDER}_npm_${PORT}" 2>/dev/null || true
-pm2 delete "${FOLDER}_docs_${PORT}" 2>/dev/null || true
-pm2 delete "${FOLDER}_test_${PORT}" 2>/dev/null || true
-pm2 delete "${FOLDER}_memory_${PORT}" 2>/dev/null || true
-pm2 delete "${FOLDER}_spawn_${PORT}" 2>/dev/null || true
-
-# Spawn main Agent / server (absolute paths to scripts)
-pm2 start "${PROJECT_DIR}/agents/code_agent.js" --name "${FOLDER}_code_${PORT}" -- --serve "${PORT}" --tools javascript --secret "${SECRET}"
-# Attach clients
-pm2 start "${PROJECT_DIR}/agents/todo_agent.js"   --name "${FOLDER}_todo_${PORT}"   -- --connect "ws://127.0.0.1:${PORT}/ws" --secret "${SECRET}"
-pm2 start "${PROJECT_DIR}/agents/readme_agent.js" --name "${FOLDER}_readme_${PORT}" -- --connect "ws://127.0.0.1:${PORT}/ws" --secret "${SECRET}"
-pm2 start "${PROJECT_DIR}/agents/npm_agent.js"    --name "${FOLDER}_npm_${PORT}"    -- --connect "ws://127.0.0.1:${PORT}/ws" --secret "${SECRET}"
-pm2 start "${PROJECT_DIR}/agents/docs_agent.js"   --name "${FOLDER}_docs_${PORT}"   -- --connect "ws://127.0.0.1:${PORT}/ws" --secret "${SECRET}"
-pm2 start "${PROJECT_DIR}/agents/test_agent.js"   --name "${FOLDER}_test_${PORT}"   -- --connect "ws://127.0.0.1:${PORT}/ws" --secret "${SECRET}"
-pm2 start "${PROJECT_DIR}/agents/memory_agent.js" --name "${FOLDER}_memory_${PORT}" -- --connect "ws://127.0.0.1:${PORT}/ws" --secret "${SECRET}"
-# pm2 start "${PROJECT_DIR}/agents/spawn_agent.js"  --name "${FOLDER}_spawn_${PORT}"    -- --connect "ws://127.0.0.1:${PORT}/ws" --secret "${SECRET}"
-
-echo "codeDave processes spawned with prefix '${FOLDER}_' and suffix _${PORT}. Check with: pm2 list | grep '${FOLDER}_${PORT}'"
-echo "dave --connect ws://127.0.0.1:${PORT}/ws --secret '$SECRET'"