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

package/utils/format_log.js

@@ -1,33 +1,111 @@
 #!/usr/bin/env -S node
-// Formatted output of hello-dave cache files [*.ndjson]
-import { CacheSync } from "@j-o-r/cache";
+// Formatted output of @j-o-r/hello-dave cache files [*.ndjson]
+import { open } from 'node:fs/promises';
 import path from 'node:path';
-import { parseArgs, readIn } from '@j-o-r/sh';
 
-const args = parseArgs();
-if (args._.length !== 1) {
-	console.log(
-		`File as an argument`.trim()
-	)
+const DEFAULT_LAST = 20;
+const CHUNK_SIZE = 64 * 1024;
+
+/**
+ * Print command usage and exit.
+ * @param {number} code Process exit code.
+ * @returns {never}
+ */
+function usage(code = 0) {
+  const script = path.basename(process.argv[1] ?? 'format_log.js');
+  console.log(`Usage: ${script} [--last 20|-n 20] <file.ndjson>`);
+  process.exit(code);
 }
-const filePath = args._[0]; // or any relative/absolute path
 
-// folder
-const folder = path.resolve(path.dirname(filePath)); // 'a/b'
+/**
+ * Parse CLI arguments.
+ * @param {string[]} argv Raw CLI arguments.
+ * @returns {{ filePath: string, last: number }} Parsed arguments.
+ */
+function parseCliArgs(argv) {
+  let last = DEFAULT_LAST;
+  const files = [];
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
 
-// filename without extension
-const { name } = path.parse(filePath); // name = 'c'
-// or: const name2 = path.basename(filePath, path.extname(filePath));
+    if (arg === '--help' || arg === '-h') usage(0);
 
-// extension (including dot)
-const ext = path.extname(filePath).slice(1); // '.txt'
+    if (arg === '--last' || arg === '-n') {
+      const value = argv[i + 1];
+      if (!value) usage(1);
+      last = Number.parseInt(value, 10);
+      i += 1;
+      continue;
+    }
 
-console.log({ folder, name, ext });
+    if (arg.startsWith('--last=')) {
+      last = Number.parseInt(arg.slice('--last='.length), 10);
+      continue;
+    }
 
-const c = new CacheSync(folder, false, ext);
-const content = c.read(name);
-if (!content) {
-	console.error(`Not Found: ${filePath}`);
-	process.exit(1);
+    files.push(arg);
+  }
+
+  if (files.length !== 1 || !Number.isSafeInteger(last) || last < 1) usage(1);
+  return { filePath: files[0], last };
 }
-console.log(JSON.stringify(content, null, '  '));
+
+/**
+ * Read the last non-empty lines from a text file without loading the whole file.
+ * @param {string} filePath Path to the text/NDJSON file.
+ * @param {number} count Number of bottom entries to read.
+ * @returns {Promise<string[]>} Last non-empty lines in original order.
+ */
+async function readLastLines(filePath, count) {
+  const file = await open(filePath, 'r');
+
+  try {
+    const { size } = await file.stat();
+    const chunks = [];
+    let position = size;
+    let newlineCount = 0;
+
+    while (position > 0 && newlineCount <= count) {
+      const readSize = Math.min(CHUNK_SIZE, position);
+      position -= readSize;
+
+      const buffer = Buffer.allocUnsafe(readSize);
+      await file.read(buffer, 0, readSize, position);
+      chunks.unshift(buffer);
+
+      for (let i = 0; i < readSize; i += 1) {
+        if (buffer[i] === 0x0a) newlineCount += 1;
+      }
+    }
+
+    return Buffer.concat(chunks)
+      .toString('utf8')
+      .split(/\r?\n/u)
+      .filter((line) => line.trim() !== '')
+      .slice(-count);
+  } finally {
+    await file.close();
+  }
+}
+
+/**
+ * Parse NDJSON lines as JSON objects.
+ * @param {string[]} lines NDJSON lines.
+ * @returns {unknown[]} Parsed events.
+ */
+function parseNdjsonLines(lines) {
+  return lines.map((line, index) => {
+    try {
+      return JSON.parse(line);
+    } catch (error) {
+      throw new Error(`Invalid JSON on selected line ${index + 1}: ${error.message}`);
+    }
+  });
+}
+
+const { filePath, last } = parseCliArgs(process.argv.slice(2));
+const fullPath = path.resolve(filePath);
+const lines = await readLastLines(fullPath, last);
+const events = parseNdjsonLines(lines);
+console.log(JSON.stringify(events, null, 2));

package/utils/launch_agent.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+/**
+ * utils/launch_agent.js
+ *
+ * Tiny CLI wrapper.
+ *
+ * All logic lives in AgentLauncher.
+ *
+ * Usage:
+ *   node utils/launch_agent.js weather_agent
+ *   node utils/launch_agent.js weather_agent "What is the weather in Miami?"
+ */
+
+import AgentLauncher from '../lib/AgentLauncher.js';
+
+const launcher = new AgentLauncher({ from: import.meta.url });
+await launcher.load();
+await launcher.run();

package/utils/list_sessions.sh

@@ -1,7 +1,7 @@
 #!/bin/bash
 # List unique sessions (once) per agent across all apps hierarchically, with latest mod timestamp.
 # Strips trailing _[0-9]+, converts _+ to spaces, trims. Picks newest mtime per base name.
-# FIXED: Reset assoc array per agent; skip empty agents.
+# Only prints app folders that contain at least one session log.
 
 CACHE_BASE=".cache"
 shopt -s nullglob
@@ -10,13 +10,16 @@ for app_dir in "$CACHE_BASE"/*/; do
   if [[ ! -d "$app_dir" ]]; then
     continue
   fi
+
   app_name=$(basename "$app_dir")
-  echo "$app_name:"
   has_sessions=false
+  app_output=""
+
   for sessions_dir in "$app_dir"/*/sessions/; do
     if [[ ! -d "$sessions_dir" ]]; then
       continue
     fi
+
     agent=$(basename "$(dirname "$sessions_dir")")
 
     unset timestamps || true
@@ -33,14 +36,19 @@ for app_dir in "$CACHE_BASE"/*/; do
     done
 
     if [[ ${#timestamps[@]} -gt 0 ]]; then
-      echo "  $agent:"
-      for base in "${!timestamps[@]}"; do
+      session_output=$(for base in "${!timestamps[@]}"; do
         echo "    - $base ... (${timestamps[$base]})"
-      done | sort
+      done | sort)
+
+      app_output+="  $agent:"$'\n'
+      app_output+="$session_output"$'\n'
       has_sessions=true
     fi
   done
+
   if [[ "$has_sessions" == true ]]; then
+    echo "$app_name:"
+    printf '%s' "$app_output"
     echo
   fi
 done

package/utils/search_sessions.sh

@@ -31,7 +31,17 @@ while [ $# -gt 0 ]; do
   esac
 done
 
-# 1st pass: matching sessions/files
+# Helper: does this file contain the query (case-insensitive)?
+has_query() {
+  grep -qiE "$QUERY" "$1" 2>/dev/null
+}
+
+# Helper: does this file contain a user or assistant role line?
+has_user_or_assistant_role() {
+  grep -qiE '"role"\s*:\s*"(user|assistant)"' "$1" 2>/dev/null
+}
+
+# 1st pass: find sessions that have at least one matching file
 declare -a matching_sessions=()
 total_files=0
 scanned=0
@@ -45,40 +55,52 @@ while IFS= read -r -d '' sess_dir <&3; do
   for file in "$sess_dir"/*.ndjson; do
     base=$(basename "$file" .ndjson)
     has_match=false
-    # Filename
-    if echo "$base" | grep -qiE "$QUERY"; then
-      has_match=true
-    # Content (role-filtered if enabled)
-    elif ! $BRIEF && [ "$ROLE_FILTER" = true ] && \
-         awk -v q="$QUERY" 'tolower($0) ~ tolower(q) && /"role"\s*:\s*"(user|assistant)"/ {exit 0} END{exit !NR}' "$file" 2>/dev/null; then
-      has_match=true
-    elif ! $BRIEF && [ "$ROLE_FILTER" = false ] && grep -qiE -m1 "$QUERY" "$file" 2>/dev/null; then
+
+    # 1. Filename match (also try normalized query with _ for spaces)
+    norm_query=$(echo "$QUERY" | tr ' ' '_')
+    if echo "$base" | grep -qiE "$QUERY" || echo "$base" | grep -qiE "$norm_query"; then
       has_match=true
+    # 2. Content match
+    elif ! $BRIEF; then
+      if has_query "$file"; then
+        if [ "$ROLE_FILTER" = true ]; then
+          if has_user_or_assistant_role "$file"; then
+            has_match=true
+          fi
+        else
+          has_match=true
+        fi
+      fi
     fi
+
     [ "$has_match" = true ] && ((files_matched++))
   done
   shopt -u nullglob
+
   [ $files_matched -gt 0 ] || continue
   matching_sessions+=("$sess_dir")
   ((total_files += files_matched))
-done 3< <(find .cache -mindepth 3 -maxdepth 5 -type d -name sessions -print0 2>/dev/null | sort -rz | head -"$LIMIT")
+done 3< <(find .cache -mindepth 3 -maxdepth 5 -type d -name sessions -print0 2>/dev/null | sort -rz)
+
+# Respect --limit on the number of sessions we will print
+if [ ${#matching_sessions[@]} -gt "$LIMIT" ]; then
+  matching_sessions=("${matching_sessions[@]:0:$LIMIT}")
+fi
 
 [ $total_files -eq 0 ] && exit 0
 
-echo "🔍 $QUERY: $total_files files / ${#matching_sessions[@]} sessions (limit=$LIMIT)"
+echo "🔍 $QUERY: $total_files files / ${#matching_sessions[@]} sessions (scanned $scanned, limit=$LIMIT)"
 echo ===
 
-# 2nd pass: condensed output
+# 2nd pass: condensed output for the (limited) matching sessions
 for sess_dir in "${matching_sessions[@]}"; do
   app=$(basename "$(dirname "$(dirname "$sess_dir")")")
   prompt=$(basename "$(dirname "$sess_dir")")
   time=$(stat -c %Y "$sess_dir" 2>/dev/null | xargs -I{} date -d "@{}" '+%H:%M' 2>/dev/null || echo ??)
 
-  echo "📁 $app/$prompt ($time)"
-  echo ---
-
   dir_count=0
-  all_snips=""  # Condense all files' snippets here
+  all_snips=""
+  file_lines=""
   shopt -s nullglob
   for file in "$sess_dir"/*.ndjson; do
     [ -f "$file" ] || continue
@@ -86,16 +108,22 @@ for sess_dir in "${matching_sessions[@]}"; do
     name=$(echo "$base" | sed 's/__/ /g; s/_[0-9]*$//' | fold -w30 | sed -E 's/(.{27}).*/\1.../') || name="$base..."
 
     printed=false
-    # Filename
-    if echo "$base" | grep -qiE "$QUERY"; then
-      echo "  💾 $name"
+
+    # Filename match (same logic as pass 1)
+    norm_query=$(echo "$QUERY" | tr ' ' '_')
+    if echo "$base" | grep -qiE "$QUERY" || echo "$base" | grep -qiE "$norm_query"; then
+      file_lines+="  💾 $name"$'\n'
       printed=true
     fi
 
-    # Content snippets (role-filtered awk)
-    if ! $BRIEF; then
+    # Content snippets
+    if ! $BRIEF && has_query "$file"; then
       if [ "$ROLE_FILTER" = true ]; then
-        snips=$(awk -v q="$QUERY" 'tolower($0) ~ tolower(q) && /"role"\s*:\s*"(user|assistant)"/ { print substr($0, 1, 100) }' "$file" 2>/dev/null | head -"$MAX_SNIP" | paste -sd'; ')
+        # Only extract from user/assistant lines that also contain the query
+        snips=$(awk -v q="$QUERY" '
+          tolower($0) ~ tolower(q) && /"role"\s*:\s*"(user|assistant)"/ {
+            print substr($0, 1, 100)
+          }' "$file" 2>/dev/null | head -"$MAX_SNIP" | paste -sd'; ')
       else
         snips=$(grep -iE "$QUERY" "$file" 2>/dev/null | cut -c1-100 | head -"$MAX_SNIP" | paste -sd'; ')
       fi
@@ -104,17 +132,25 @@ for sess_dir in "${matching_sessions[@]}"; do
         printed=true
       }
     fi
+
     [ "$printed" = true ] && ((dir_count++))
   done
   shopt -u nullglob
 
-  # Condensed session block
-  [ -n "$all_snips" ] && {
-    echo "  📄 Session ($dir_count files): $(echo "$all_snips" | fold -w90 | sed ':a;N;$!ba;s/\n/ /g' | cut -c1-180)"
+  # Only print the session block if it actually contributed matches
+  if [ $dir_count -gt 0 ]; then
+    echo "📁 $app/$prompt ($time)"
+    echo ---
+
+    [ -n "$file_lines" ] && echo -n "$file_lines"
+
+    [ -n "$all_snips" ] && {
+      echo "  📄 Session ($dir_count files): $(echo "$all_snips" | fold -w90 | sed ':a;N;$!ba;s/\n/ /g' | cut -c1-180)"
+      echo
+    }
+    echo "  ($dir_count files)"
     echo
-  }
-  echo "  ($dir_count files)"
-  echo
+  fi
 done
 
-echo "✅ $total_files files / ${#matching_sessions[@]} sessions (scanned $scanned)"
+echo "✅ $total_files files / ${#matching_sessions[@]} sessions (scanned $scanned)"

package/utils/toolsets.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+/**
+ * utils/toolsets.js
+ *
+ * Thin CLI wrapper around lib/toolsetLoader.js.
+ */
+
+import { listToolsets, parseToolsetArgs, renderToolsetList, renderToolsetsHelp } from '../lib/toolsetLoader.js';
+
+/**
+ * Run the toolsets utility CLI.
+ *
+ * @returns {void}
+ */
+function main() {
+  const { filters, json, help } = parseToolsetArgs(process.argv.slice(2));
+
+  if (help) {
+    console.log(renderToolsetsHelp('utils/toolsets.js'));
+    return;
+  }
+
+  const result = listToolsets({ filters });
+
+  if (json) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+
+  console.log(renderToolsetList(result));
+}
+
+main();

package/README.md.bak.1779452127

@@ -1,240 +0,0 @@
-# hello-dave
-
-[![License: Apache-2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
-[![Node.js >=20](https://img.shields.io/badge/Node.js-%3E=20-green.svg)](https://nodejs.org/)
-[![Version: v0.0.8](https://img.shields.io/badge/Version-v0.0.8-green.svg)](https://codeberg.org/duin/hello-dave)
-[![PM2 Compatible](https://img.shields.io/badge/PM2-Compatible-orange.svg)](https://pm2.keymetrics.io/)
-
-## Table of Contents
-
-- [Description](#description)
-- [Features](#features)
-- [Folder Structure](#folder-structure)
-- [Installation](#installation)
-- [Usage](#usage)
-- [Usage Examples](#usage-examples)
-- [Development](#development)
-- [Contributing](#contributing)
-- [License](#license)
-
-## Description
-
-**hello-dave** is an ESM (ECMAScript Modules) toolkit for building AI agents with unified access to endpoints from Grok (xAI), OpenAI, and Anthropic. It provides CLI tools for interacting with agents locally or via WebSocket servers, along with pre-built agent scripts for various tasks like code generation, documentation, testing, and more.
-
-The project emphasizes modular agent management, tool integration (e.g., web search, file operations), and session handling with memory and caching. With v0.0.8, enhanced portability allows spawning agents in isolated environments like `/tmp` while maintaining tool functionality relative to the current working directory (CWD).
-
-## Features
-
-- **Unified API Access**: Seamless integration with xAI (Grok), OpenAI, and Anthropic models.
-- **CLI Tools**: `dave` for querying agents, `agentDave` for spawning servers, `codeDave` for code servers.
-- **Agent Scripts**: Specialized agents for code, docs, npm, todo, readme, memory, and more.
-- **WebSocket Support**: Connect to remote agent servers for interactive or one-shot interactions.
-- **Toolsets**: Built-in tools for search, file I/O, email, and custom toolcalls.
-- **Session Management**: Cache history, search sessions, reset, and inspect logs.
-- **ESM-First**: Modern Node.js modules with TypeScript definitions.
-- **Portable Agent Spawning**: `spawn_agent.js` enables creating and deploying agents anywhere (project dirs or fresh `/tmp`). Supports auto-deploy in existing projects (detects `./agents/*.js`), manual code+bash in isolated setups. Tools adapt to CWD for portability. Hybrid modes combine server/client for chaining. See [docs/prompt/spawn_agent.md](docs/prompt/spawn_agent.md) for blueprint and validation.
-- **Multi-Agent Clusters**: PM2-powered CodeServer for scalable, clustered agent deployments (e.g., code_agent + todo_agent). Defaults to port 9000/secret '123'. See [docs/multi-agent-clusters.md](docs/multi-agent-clusters.md) for configuration.
-
-## Folder Structure
-
-- **bin/**: Executables for CLI tools.
-  - `dave.js`: Main CLI for asking agents or connecting to WebSocket servers.
-  - `spawn_agent.js`: Spawns agent instances (binary: `agentDave`).
-  - `codeDave`: Launches code servers (via PM2 clusters). References [docs/multi-agent-clusters.md](docs/multi-agent-clusters.md) for setup and scaling.
-
-- **agents/**: Agent scripts (`*_agent.js`) for specific tasks. These can be run directly with `node agents/<script>.js`.
-  - `ask_agent.js`: General query agent.
-  - `code_agent.js`: Code generation and execution agent (serves as main server in code clusters).
-  - `daisy_agent.js`: Specialized agent (details in script).
-  - `docs_agent.js`: Documentation-focused agent.
-  - `gpt_agent.js`: OpenAI GPT integration agent.
-  - `grok_agent.js`: xAI Grok-specific agent.
-  - `memory_agent.js`: Agent with enhanced memory and context handling.
-  - `npm_agent.js`: NPM package management agent.
-  - `prompt_agent.js`: Prompt engineering and testing agent.
-  - `readme_agent.js`: README.md management agent.
-  - `spawn_agent.js`: Agent spawner (also in bin/). Creates portable CLI/WS agents + PM2 launchers. Validates/tests/deploys to `./agents/<name>.js`. Supports hybrid server/client modes. Portable to `/tmp` (tools follow CWD). Blueprint: [docs/prompt/spawn_agent.md](docs/prompt/spawn_agent.md).
-  - `test_agent.js`: Testing and validation agent.
-  - `todo_agent.js`: TODO list and task management agent.
-  - `codeserver.sh`: Shell script for launching PM2-based code server clusters (uses agents above). See [docs/multi-agent-clusters.md](docs/multi-agent-clusters.md).
-
-- **lib/**: Core library modules (e.g., `index.js`, `wsCli.js`, `wsIO.js`, API integrations).
-- **scenarios/**: Test and example scenarios (e.g., toolset tests, integration scripts).
-- **types/**: TypeScript definitions.
-- **utils/**: Utility scripts (e.g., session management, testing).
-- **docs/**: Additional documentation, including agent blueprints (e.g., [prompt/spawn_agent.md](docs/prompt/spawn_agent.md)) and multi-agent guides (e.g., [multi-agent-clusters.md](docs/multi-agent-clusters.md)).
-- **release/**: Build artifacts.
-
-Other files: `package.json`, `CHANGELOG.md`, `TODO.md`, `LICENSE`.
-
-## Installation
-
-1. **Prerequisites**: Node.js >= 20. PM2 for multi-agent clusters: `npm install -g pm2`.
-
-2. **Local Development**:
-   ```bash
-   git clone https://codeberg.org/duin/hello-dave.git
-   cd hello-dave
-   npm install
-   ```
-
-3. **Global CLI Installation** (for `dave`, `agentDave`, `codeDave`):
-   ```bash
-   npm install -g .
-   # Or link for dev: npm run link-self
-   ```
-
-4. **API Keys**: Set environment variables (e.g., `XAIKEY` for xAI, `OPENAI_API_KEY` for OpenAI).
-
-## Usage
-
-### CLI Tools
-
-- **dave**: Interact with agents locally or remotely.
-  - Local query: `dave --ask "Predict the weather"`
-  - One-shot remote: `echo "Hello" | dave --connect 'ws://127.0.0.1:8080' --secret '123'`
-  - Interactive remote: `dave --connect 'ws://127.0.0.1:8080' --secret '123'`
-  - Other: `dave --list` (sessions), `dave --clear` (cache), `dave --help`.
-
-- **agentDave**: Spawn an agent server (powered by `spawn_agent.js`).
-  ```bash
-  agentDave --serve 8080 --secret '123'  # Starts WebSocket server
-  ```
-
-- **codeDave**: Launch a PM2 code server cluster.
-  ```bash
-  codeDave 8080 --secret '123'  # Or: dave --code 8080 --secret '123'
-  ```
-
-### Running Agents
-
-Run agent scripts directly:
-```bash
-node agents/spawn_agent.js --serve 8080 --secret '123'  # Spawn server
-node agents/code_agent.js --connect 'ws://127.0.0.1:8080' --secret '123'  # Client mode
-```
-
-For full options, see script headers or run with `--help`.
-
-### Programmatic Usage
-
-Import and use in your Node.js app:
-```javascript
-import { AgentManager } from '@j-o-r/hello-dave';
-// Setup and run agent...
-```
-
-### spawn_agent.js Specifics (v0.0.8 Portability Ready)
-
-`spawn_agent.js` (executable as `agentDave`) creates and deploys portable agents in CLI, WebSocket server, client, or **hybrid** modes (server + client for tool chaining). It fetches live prompts from [docs/prompt/spawn_agent.md](docs/prompt/spawn_agent.md) and validates new agents via blueprint (temp files, syntax checks, grep for modes/tools).
-
-- **Modes**:
-  - **Direct (One-Shot)**: Positional input, e.g., `node agents/spawn_agent.js "Create a tester"`.
-  - **Interactive CLI**: No input; runs REPL-like session.
-  - **Server**: `--serve <port>` – Exposes as remote tool (e.g., for other agents to call `spawn_agent`).
-  - **Client**: `--connect <ws_url>` – Connects to remote server for tool access.
-  - **Hybrid**: `--serve <port> --connect <ws_url>` – Serves locally while using remote tools.
-
-- **Portability**:
-  - **In Project**: Auto-deploys to `./agents/<name>.js` if `./agents/*.js` exist (uses existing structure).
-  - **Fresh /tmp**: Manual code generation + bash setup (e.g., `mkdir /tmp/myproj/agents; cd /tmp/myproj; node spawn_agent.js ...`). Tools (e.g., `read_file`) follow CWD, ensuring isolation without fixed paths.
-  - Works in any dir; no repo deps beyond Node.js + npm installs.
-
-- **Custom Tools**: Specify in prompt, e.g., "name=coderev, tools=read_file,web_search,execute_bash_script".
-
-For validation/testing: See blueprint in [docs/prompt/spawn_agent.md](docs/prompt/spawn_agent.md) (includes bash examples like `node agents/NEW_AGENT.js --help` or server connect tests).
-
-### CodeServer & PM2 Multi-Agent (v0.0.8)
-
-CodeServer (via `bin/codeDave` or `agents/codeserver.sh`) launches scalable, PM2-clustered multi-agent environments for collaborative tasks (e.g., code generation + task management). It deploys agents like `code_agent`, `todo_agent`, and `readme_agent` on a WebSocket server, enabling chaining and load balancing.
-
-- **Defaults**: Port 9000, secret '123' (customizable via args).
-- **Prerequisites**: Install PM2 globally (`npm install -g pm2`).
-- **Quickstart**:
-  ```bash
-  codeDave 9000 --secret 123  # Launches PM2 cluster on ws://127.0.0.1:9000/ws
-  pm2 list  # Verify processes (e.g., code_agent, todo_agent instances)
-  echo "task" | bin/dave.js --connect ws://127.0.0.1:9000/ws --secret 123  # One-shot query to cluster
-  ```
-  This starts the cluster, lists running agents, and sends a test task (response routed to available agents).
-
-- **Scaling & Management**: Use PM2 commands (e.g., `pm2 scale <app> 4`, `pm2 stop all`). For ecosystem config, PM2 JSON files, or agent orchestration, see the [full guide in docs/multi-agent-clusters.md](docs/multi-agent-clusters.md).
-
-- **Integration**: Combine with `spawn_agent.js` for dynamic agent addition to clusters (e.g., spawn new agents and connect via `--connect ws://127.0.0.1:9000/ws`).
-
-## Usage Examples
-
-- **Direct Spawn (Project)**:
-  ```bash
-  cd hello-dave  # Or any project with ./agents/
-  node agents/spawn_agent.js "Create code-review agent: name=coderev, desc=Git diff analyzer, tools=read_file,execute_bash_script,web_search"
-  # Deploys to ./agents/coderev_agent.js; test: node agents/coderev_agent.js "Review this diff"
-  ```
-
-- **/tmp Workflow (Portable, Fresh Setup)**:
-  ```bash
-  mkdir -p /tmp/myportable/agents
-  cd /tmp/myportable
-  # Copy or fetch spawn_agent.js (e.g., curl from repo or npm install @j-o-r/hello-dave)
-  npm init -y && npm i @j-o-r/hello-dave @j-o-r/sh
-  node spawn_agent.js "Create todo agent: name=todo, desc=Task manager, tools=read_file,write_file"
-  # Deploys to ./agents/todo_agent.js; tools use /tmp/myportable as CWD
-  node agents/todo_agent.js --serve 8081 --secret abc  # Test server mode
-  ```
-
-- **Hybrid Mode with Custom Tools**:
-  ```bash
-  node agents/spawn_agent.js --serve 8081 --connect ws://127.0.0.1:8080/ws --secret abc "Spawn a docs agent with custom email tool"
-  # Serves on 8081 (exposes new agent), connects to 8080 (gains remote tools like email)
-  # Test: In another term, node agents/spawn_agent.js --connect ws://127.0.0.1:8081/ws --secret abc "Use the new docs agent"
-  ```
-
-- **Spawn a Server**:
-  ```bash
-  node agents/spawn_agent.js --serve 8080 --secret '123'
-  # Then connect: echo "Task" | dave --connect 'ws://127.0.0.1:8080' --secret '123'
-  ```
-
-- **Launch Code Cluster** (includes multiple agents):
-  ```bash
-  node agents/codeserver.sh 9000 '123'  # Or use codeDave 9000 --secret 123
-  # Connects code_agent, todo_agent, readme_agent, etc., to the server on ws://127.0.0.1:9000/ws.
-  # Test: pm2 list; echo "Optimize this code" | dave --connect ws://127.0.0.1:9000/ws --secret 123
-  # For advanced config: See [docs/multi-agent-clusters.md](docs/multi-agent-clusters.md).
-  ```
-
-- **Local Agent Query** (no server):
-  ```bash
-  dave --ask --model 'grok-4-1-fast-reasoning' "Write a function"
-  ```
-
-- **Custom Agent**:
-  ```bash
-  node agents/docs_agent.js --connect 'ws://127.0.0.1:8080' --secret '123'
-  ```
-
-See `scenarios/` for more test scenarios.
-
-## Development
-
-- **Build Types**: `npm run types`
-- **Test**: `npm run tests` (runs `utils/test.sh`)
-- **Release**: `npm run release` then `npm run publish`
-- **Local Linking**: `npm run link-self` / `npm run unlink-self`
-
-Use `git status` and `ls` to inspect changes. Ensure ESM compatibility.
-
-## Contributing
-
-Contributions welcome! Fork the repo, create a branch, and submit a pull request to https://codeberg.org/duin/hello-dave.
-
-- Report bugs: https://codeberg.org/duin/hello-dave/issues
-- Follow Apache-2.0 license.
-
-## License
-
-This project is licensed under the Apache-2.0 License - see the [LICENSE](LICENSE) file for details.
-
----
-*Repository: https://codeberg.org/duin/hello-dave*
----

package/agents/codeserver.sh

@@ -1,47 +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 paths relative to THIS script's location (portable from anywhere)
-SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
-PROJECT_DIR="$( cd "$( dirname "${SCRIPT_DIR}" )" && pwd )"
-FOLDER=$(basename "$PROJECT_DIR")
-
-echo "Starting CodeServer 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
-
-# Spawn main Agent / server (absolute paths to scripts)
-pm2 start "${SCRIPT_DIR}/code_agent.js" --name "${FOLDER}_code_${PORT}" -- --serve "${PORT}" --tools javascript --secret "${SECRET}"
-# Attach clients
-pm2 start "${SCRIPT_DIR}/todo_agent.js"   --name "${FOLDER}_todo_${PORT}"   -- --connect "ws://127.0.0.1:${PORT}/ws" --secret "${SECRET}"
-pm2 start "${SCRIPT_DIR}/readme_agent.js" --name "${FOLDER}_readme_${PORT}" -- --connect "ws://127.0.0.1:${PORT}/ws" --secret "${SECRET}"
-pm2 start "${SCRIPT_DIR}/npm_agent.js"    --name "${FOLDER}_npm_${PORT}"    -- --connect "ws://127.0.0.1:${PORT}/ws" --secret "${SECRET}"
-pm2 start "${SCRIPT_DIR}/docs_agent.js"   --name "${FOLDER}_docs_${PORT}"   -- --connect "ws://127.0.0.1:${PORT}/ws" --secret "${SECRET}"
-pm2 start "${SCRIPT_DIR}/test_agent.js"   --name "${FOLDER}_test_${PORT}"   -- --connect "ws://127.0.0.1:${PORT}/ws" --secret "${SECRET}"
-pm2 start "${SCRIPT_DIR}/memory_agent.js"   --name "${FOLDER}_memory_${PORT}"   -- --connect "ws://127.0.0.1:${PORT}/ws" --secret "${SECRET}"
-
-echo "CodeServer 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'"