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

package/{examples → agents}/gpt_agent.js

@@ -52,19 +52,19 @@ function printHelp() {
 ## USAGE MODES:
 
 ### 1. Direct Call (One-Shot, Positional ONLY):
-./examples/${name}.js "Your query" [--options]
+./agents/${name}.js "Your query" [--options]
 
 ### 2. Interactive CLI (no positional arg):
-./examples/${name}.js [--options]
+./agents/${name}.js [--options]
 
 ### 3. WS Server (no positional arg):
-./examples/${name}.js --serve 8080 [--secret mysecret] [--options]
+./agents/${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]
+./agents/${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]
+./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., 'gpt_agent'). Runs indefinitely until Ctrl+C.

package/{examples → agents}/grok_agent.js

@@ -64,19 +64,19 @@ function printHelp() {
 ## USAGE MODES:
 
 ### 1. Direct Call (One-Shot, Positional ONLY):
-./examples/${name}.js "What is your task?" [--options]
+./agents/${name}.js "What is your task?" [--options]
 
 ### 2. Interactive CLI (no positional arg):
-./examples/${name}.js [--options]
+./agents/${name}.js [--options]
 
 ### 3. WS Server (no positional arg):
-./examples/${name}.js --serve 8080 [--secret mysecret] [--options]
+./agents/${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]
+./agents/${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]
+./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. Runs indefinitely until Ctrl+C.

package/{examples → agents}/memory_agent.js

@@ -56,19 +56,19 @@ function printHelp() {
 ## USAGE MODES:
 
 ### 1. Direct Call (One-Shot, Positional ONLY):
-./examples/${name}.js "Recall tasks" [--options]
+./agents/${name}.js "Recall tasks" [--options]
 
 ### 2. Interactive CLI (no positional arg):
-./examples/${name}.js [--options]
+./agents/${name}.js [--options]
 
 ### 3. WS Server (no positional arg):
-./examples/${name}.js --serve 8080 [--secret mysecret] [--options]
+./agents/${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]
+./agents/${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]
+./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.

package/{examples → agents}/npm_agent.js

@@ -55,19 +55,19 @@ function printHelp() {
 ## USAGE MODES:
 
 ### 1. Direct Call (One-Shot, Positional ONLY):
-./examples/${name}.js "What modules are installed?" [--options]
+./agents/${name}.js "What modules are installed?" [--options]
 
 ### 2. Interactive CLI (no positional arg):
-./examples/${name}.js [--options]
+./agents/${name}.js [--options]
 
 ### 3. WS Server (no positional arg):
-./examples/${name}.js --serve 8080 [--secret mysecret] [--options]
+./agents/${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]
+./agents/${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]
+./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., 'npm_module_inspector'). Runs indefinitely until Ctrl+C.

package/{examples → agents}/prompt_agent.js

@@ -54,19 +54,19 @@ function printHelp() {
 ## USAGE MODES:
 
 ### 1. Direct Call (One-Shot, Positional ONLY):
-./examples/${name}.js "Optimize this prompt: [prompt]" [--options]
+./agents/${name}.js "Optimize this prompt: [prompt]" [--options]
 
 ### 2. Interactive CLI (no positional arg):
-./examples/${name}.js [--options]
+./agents/${name}.js [--options]
 
 ### 3. WS Server (no positional arg):
-./examples/${name}.js --serve 8080 [--secret mysecret] [--options]
+./agents/${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]
+./agents/${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]
+./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., 'prompt_agent'). Runs indefinitely until Ctrl+C.

package/agents/spawn_agent.js

@@ -0,0 +1,137 @@
+#!/usr/bin/env node
+import { AgentManager } from '@j-o-r/hello-dave';
+import { parseArgs } from '@j-o-r/sh';
+import fs from 'fs';  // Added for local fallback
+
+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',...}
+
+## 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
+
+Live prompt: 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() {
+  // Priority 1: Remote
+    const promptUrl = `${REPO_URL}/raw/branch/main/docs/prompt/spawn_agent.md`;
+    const response = await fetch(promptUrl);
+    if (!response.ok) {
+      throw new Error(`HTTP ${response.status}`);
+    }
+    return await response.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.
+
+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/{examples → agents}/test_agent.js

@@ -55,19 +55,19 @@ function printHelp() {
 ## USAGE MODES:
 
 ### 1. Direct Call (One-Shot, Positional ONLY):
-./examples/${name}.js "Generate test for toolset.js" [--options]
+./agents/${name}.js "Generate test for toolset.js" [--options]
 
 ### 2. Interactive CLI (no positional arg):
-./examples/${name}.js [--options]
+./agents/${name}.js [--options]
 
 ### 3. WS Server (no positional arg):
-./examples/${name}.js --serve 8080 [--secret mysecret] [--options]
+./agents/${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]
+./agents/${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]
+./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., 'test_agent'). Runs indefinitely until Ctrl+C.
@@ -108,7 +108,7 @@ const prompt = `You are TestAgent, the specialized testing agent for CodeServer
 - Tests must use: \`import { Test, assert, jsType } from '@j-o-r/sh';\`
 - Structure: shebang \`#!/usr/bin/env node\`, fluent Test API (\`const t = new Test(); t.add('desc', () => { assert... }); await t.run();\`), exit(1) on errors.
 - After write_file to scenarios/MODULE.test.js, ensure executable: \`chmod +x scenarios/MODULE.test.js\`
-- Leverage project utilities: test existing files (examples/*.js, toolset.js, agents, SH commands, etc.) using read_file, execute_bash_script (ls/cat), npm_module_inspector.
+- Leverage project utilities: test existing files (agents/*.js, toolset.js, agents, SH commands, etc.) using read_file, execute_bash_script (ls/cat), npm_module_inspector.
 
 **WHAT TO TEST** (discover dynamically):
 1. Project scripts: e.g., parseArgs, AgentManager flows, toolsets.

package/{examples → agents}/todo_agent.js

@@ -55,19 +55,19 @@ function printHelp() {
 ## USAGE MODES:
 
 ### 1. Direct Call (One-Shot, Positional ONLY):
-./examples/${name}.js "List tasks" [--options]
+./agents/${name}.js "List tasks" [--options]
 
 ### 2. Interactive CLI (no positional arg):
-./examples/${name}.js [--options]
+./agents/${name}.js [--options]
 
 ### 3. WS Server (no positional arg):
-./examples/${name}.js --serve 8080 [--secret mysecret] [--options]
+./agents/${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]
+./agents/${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]
+./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.

package/bin/codeDave

@@ -0,0 +1,58 @@
+#!/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'"

package/bin/dave.js

@@ -1,9 +1,7 @@
 #!/usr/bin/env -S node
 import path from 'node:path';
 import cli from '@j-o-r/cli';
-import wsCli from '../lib/wsCli.js';
-import wsIO from '../lib/wsIO.js';
-import { AgentManager } from '@j-o-r/hello-dave';
+import { AgentManager, wsCli, wsIO } from '@j-o-r/hello-dave';
 import { SH, parseArgs, readIn, bashEscape } from '@j-o-r/sh';
 import { fileURLToPath } from 'node:url';
 
@@ -31,7 +29,7 @@ FLAGS:
   Remote:       bin/dave.js --ask --connect 'ws://localhost:8080' --secret '123'
   Piped local:  echo "predict the weather" | bin/dave.js --ask
   Piped remote: echo "predict the weather" | bin/dave.js --ask --connect 'ws://...' --secret '123'
---code [port] [--secret "..."] : Launch CodeServer PM2 cluster via examples/codeserver.sh
+--code [port] [--secret "..."] : Launch CodeServer PM2 cluster via agents/codeserver.sh
   Usage: bin/dave.js --code 8080 --secret 123
 `);
 	process.exit(exitCode)
@@ -193,4 +191,4 @@ ${name} (${options.model}).
 	const RES = await SH`${server} ${port} ${bashEscape(secret)}`.run();
 	console.log(RES);
 	process.exit(0);
-}
+}