@j-o-r/hello-dave 0.0.4 → 0.0.5

package/bin/dave.js

@@ -26,6 +26,8 @@ FLAGS:
     echo "predict the weather" | bin/dave.js --connect 'ws://...' --secret '123'  # user_request
     echo "user_info" | bin/dave.js --connect 'ws://...' --secret '123'           # user_info
     echo "user_reset" | bin/dave.js --connect 'ws://...' --secret '123'          # user_reset
+--code [port] [secret] : Launch CodeServer PM2 cluster via examples/codeserver.sh
+  Usage: bin/dave.js --code 8080 --secret 123
 --ask : Launches a CLI and ask questions about whatever is on your mind
         XAIKEY required: export XAIKEY=xai-...
 `);
@@ -36,23 +38,25 @@ FLAGS:
 const keys = Object.keys(args);
 if (
 	!(
-		keys.indexOf('help') > 0 ||
-		keys.indexOf('clear') > 0 ||
-		keys.indexOf('search') > 0 ||
-		keys.indexOf('list') > 0 ||
-		keys.indexOf('inspect') > 0 ||
-		keys.indexOf('connect') > 0 ||
-		keys.indexOf('ask') > 0
+		keys.indexOf('--help') > -1 ||
+		keys.indexOf('--clear') > -1 ||
+		keys.indexOf('--search') > -1 ||
+		keys.indexOf('--list') > -1 ||
+		keys.indexOf('--inspect') > -1 ||
+		keys.indexOf('--connect') > -1 ||
+		keys.indexOf('--spawn') > -1 ||
+		keys.indexOf('--code') > -1 ||
+		keys.indexOf('--ask') > -1
 	)
 ) {
 	printHelp(1);
 }
 
-if (args.help) {
+if (args['--help']) {
 	printHelp();
 }
 
-if (args.clear) {
+if (args['--clear']) {
 	const clear_sessions = path.resolve(__dirname, '..', 'utils', 'clear_sessions.sh')
 	const y = await cli.yesNo('Delete entire cache? (y/n) ');
 	if (y) {
@@ -61,33 +65,33 @@ if (args.clear) {
 	  console.log(res);
 	}
 	process.exit();
-} else if (args.search) {
+} else if (args['--search']) {
 	const history_search = path.resolve(__dirname, '..', 'utils', 'search_sessions.sh')
-	if (typeof args.search !== 'string') {
+	if (typeof args['--search'] !== 'string') {
 		printHelp(1)
 	}
-	const res = await SH`${history_search} "${bashEscape(args.search)}"`.run();
+	const res = await SH`${history_search} "${bashEscape(args['--search'])}"`.run();
 	console.log(res);
 	process.exit();
-} else if (args.list) {
+} else if (args['--list']) {
 	const list = path.resolve(__dirname, '..', 'utils', 'list_sessions.sh');
 	const res = await SH`${list}`.run();
 	console.log(res);
 	process.exit();
-} else if (args.inspect) {
+} else if (args['--inspect']) {
 	const format = path.resolve(__dirname, '..', 'utils', 'format_log.js')
-	if (typeof args.inspect !== 'string') {
+	if (typeof args['--inspect'] !== 'string') {
 		printHelp(1)
 	}
 	try {
-		const res = await SH`${format} "${bashEscape(args.inspect)}"`.run();
+		const res = await SH`${format} "${bashEscape(args['--inspect'])}"`.run();
 		console.log(res);
 	} catch (e) {
 		console.error(e);
 		process.exit(1);
 	}
-} else if (args.connect) {
-	let secret = args.secret ? args.secret : '';
+} else if (args['--connect']) {
+	let secret = args['--secret'] ? args['--secret'] : '';
 
 	if (typeof pipedInput === 'string' && pipedInput.trim() !== '') {
 		// Piped input mode: use wsIO for one-shot actions
@@ -102,7 +106,7 @@ if (args.clear) {
 		}
 
 		try {
-			const response = await wsIO(args.connect, secret, action, input);
+			const response = await wsIO(args['--connect'], secret, action, input);
 			console.log(response.content);
 		} catch (e) {
 			console.error(`Error: ${e.message}`);
@@ -110,9 +114,16 @@ if (args.clear) {
 		}
 	} else {
 		// No piped input: interactive wsCli mode
-		wsCli(args.connect, secret);
+		wsCli(args['--connect'], secret);
 	}
-} else if (args.ask) {
+} else if (args['--code']) {
+	const port = parseInt(args['--code'] || '8080');
+	const secret = args['--secret'] ? args['--secret'].trim() : '123';
+	const server = path.resolve(__dirname, '..', 'examples', 'codeserver.sh');
+  const RES = await SH`${server} ${port} ${bashEscape(secret)}`.run();
+  console.log(RES);
+	process.exit(0);
+} else if (args['--ask']) {
 	const name = 'ask_dave';
 	const api = 'xai';
 	let secret = '';
@@ -124,7 +135,7 @@ if (args.clear) {
 	};
 	options.tools.push({ type: 'web_search' });
 	options.tools.push({ type: 'x_search' });
-	options.model = args.model || args['model'] || 'grok-4-1-fast-reasoning';
+	options.model = args['--model'] || args.model || 'grok-4-1-fast-reasoning';
 	options.temperature = 0.2;
 	options.reasoning = { effort: 'medium', summary: 'auto' };
 

package/examples/gpt_agent.js

@@ -27,10 +27,7 @@ if (args['secret']) {
 	secret = args['secret'];
 }
 if (args['model'] || true) {
-	options.model = args['model'] || 'gpt-5.4';
-}
-if (args['temperature']) {
-	options.temperature = parseFloat(args['temperature']);
+	options.model = args['model'] || 'gpt-5.4-mini';
 }
 if (args['tokens']) {
 	options.max_output_tokens = parseInt(args['tokens']);
@@ -45,7 +42,7 @@ if (reasoning) {
 		summary: 'auto'
 	}
 }
-const contextWindow = args['context'] ? parseInt(args['context']) : 100000;
+const contextWindow = args['context'] ? parseInt(args['context']) : 200000;
 const toolsetMode = 'auto';
 
 function printHelp() {
@@ -122,4 +119,4 @@ if (input) {
 	console.log(RES);
 } else {
 	await agent.start(serve, connect, cliIntro, tool_call_name, tool_call_description);
-}
+}

package/lib/ToolSet.js

@@ -71,8 +71,11 @@ class ToolSet {
 	* @param {function(object): Promise<*>} method - Async function to call
 	*/
 	add(name, description, parameters, method) {
+		if (typeof name !== 'string') {
+			throw new Error('Tool name must be a string');
+		}
 		if (!isValidName(name)) {
-			throw new Error('Invalid name /[a-z_0-9]{2,}/');
+			throw new Error(`Invalid tool name '${name}': must match /^[#!a-z_0-9]{2,}$/`);
 		}
 		if (this.has(name)) {
 			// throw new Error('Function already defined');

package/lib/index.js

@@ -11,6 +11,8 @@ import AgentClient from './AgentClient.js';
 import Session from './Session.js';
 import Prompt from './Prompt.js';
 import Cli from './Cli.js';
+import wsCli from '../lib/wsCli.js';
+import wsIO from '../lib/wsIO.js';
 
 const API = {
 	text:{
@@ -32,5 +34,7 @@ export {
   API,
   Cli,
   env,
-  GLOBAL
+  GLOBAL,
+  wsCli,
+  wsIO
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@j-o-r/hello-dave",
   "type": "module",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "ESM toolkit for building AI agents with unified access to Grok (XAI), OpenAI, and Anthropic endpoints",
   "main": "./lib/index.js",
   "types": "./types/index.d.ts",
@@ -14,7 +14,7 @@
   },
   "bin": {
     "dave": "bin/dave.js",
-    "createAgent": "examples/spawn_agent.js"
+    "createAgent": "bin/spawn_agent.js"
   },
   "scripts": {
     "release": "npm run types && npm pack --pack-destination=release",
@@ -39,7 +39,7 @@
       "types": "./types/index.d.ts",
       "default": "./lib/index.js"
     },
-    "./*": "lib/*.js"
+    "./lib/*": "./lib/*"
   },
   "author": "Jorrit Duin <j-o-r@duin.work>",
   "bugs": {

package/types/index.d.ts

@@ -17,8 +17,10 @@ export namespace API {
 import Cli from './Cli.js';
 import { env } from './fafs.js';
 import { GLOBAL } from './fafs.js';
+import wsCli from '../lib/wsCli.js';
+import wsIO from '../lib/wsIO.js';
 import { request as gpt } from './API/openai.com/reponses/text.js';
 import { request as xai } from './API/x.ai/responses.js';
 import { request as claude } from './API/anthropic.com/text.js';
 import { request as brave } from './API/brave.com/search.js';
-export { AgentManager, AgentServer, AgentClient, Prompt, ToolSet, Session, Cli, env, GLOBAL };
+export { AgentManager, AgentServer, AgentClient, Prompt, ToolSet, Session, Cli, env, GLOBAL, wsCli, wsIO };

package/examples/coderev_agent.js

@@ -1,136 +0,0 @@
-#!/usr/bin/env node
-import { AgentManager } from '@j-o-r/hello-dave';
-import { parseArgs } from '@j-o-r/sh';
-
-const name = 'coderev_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']);
-}
-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']) : 500000;
-
-function printHelp() {
-	console.log(`
-'${name} --help' You are looking at it.
-
-## USAGE MODES:
-
-### 1. Direct Call (One-Shot, Positional ONLY):
-./examples/${name}.js "Paste git diff here" [--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., 'coderev_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: 500000)
-
-## SERVER TOOLS (when no input):
-Exposes as 'coderev_agent' tool for chaining.
-`);
-	process.exit();
-}
-
-if (help) {
-	printHelp();
-}
-
-const tool_call_name = 'coderev_agent';
-const tool_call_description = `
-Git diff analyzer. Supports WS chaining.
-`.trim();
-
-const prompt = `
-You are coderev, a Git diff analyzer.
-
-Analyze git diffs provided in queries, review code changes for bugs, improvements, best practices, security issues, and provide actionable suggestions. Use read_file to access specific files, execute_bash_script for git commands or other shell tasks, and web_search for looking up coding standards or references if needed. Be thorough, constructive, and reference specific lines in diffs when possible.
-
-Respond in a structured format: Summary, Issues Found, Suggestions, Overall Rating (1-10).
-`.trim();
-
-const agent = new AgentManager({ name, secret });
-agent.setup({
-	prompt,
-	api,
-	options,
-	toolsetMode,
-	contextWindow
-});
-const toolset = agent.getToolset();
-if (toolset) {
-	agent.addGenericToolcall('read_file');
-	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/examples/grok_agent.js.bak

@@ -1,98 +0,0 @@
-#!/usr/bin/env node
-/*
-* ONE SHOT , direct call example
-* ```bash
-* echo "What is your task?" | examples/grok.js
-* ```
-*/
-import { AgentManager }  from '@j-o-r/hello-dave';
-import { parseArgs, readIn } from '@j-o-r/sh';
-
-const name = 'ask_grok';
-const api = 'xai';
-let secret = '';
-
-const input = await readIn();
-const args = parseArgs();
-const help = args['help'] || false;
-
-/** @type {import('lib/API/x.ai/responses.js').XAIOptions} */
-const options = {
-	tools: []
-}
-options.tools.push({
-	type: 'web_search'
-});
-options.tools.push({
-	type: 'x_search'
-});
-
-// Set properties only if provided via command line (except model which has default)
-if (args['model'] || true) { // model gets default value
-	// @ts-ignore   || grok-4-1-fast-non-reasoning
-	options.model = args['model'] || 'grok-4.20-multi-agent-0309';
-}
-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 // args['reasoning'] ? args['reasoning'] : null;
-if (reasoning) {
-	options.reasoning = {
-		effort: 'medium',
-		summary: 'auto'
-	}
-}
-// Large context on grok-4-fast
-const contextWindow = args['context'] ? parseInt(args['context']) : 1900000;
-const toolsetMode = 'auto';
-
-function printHelp() {
-	console.log(`
-'${name} --help' You are looking at it.
-'
-OPTIONS: 
---tokens [number]: max generated tokens 
---context [number] : truncate message history to context-windows size default 130000
---temperature [float] : -2 / +2
---model ['grok-4-1-fast-reasoning'|'grok-4-1-fast-non-reasoning'|'grok-code-fast-1'|'grok-4-fast-reasoning'|'grok-4-fast-non-reasoning']
---top_p [float]: number > 0, 0.1 means no top_p
---reasoning [low|high]
-
-USAGE:
-
-\`\`\`bash
-echo "What is ..." | grok.js
-\`\`\`
-
-`);
-	process.exit()
-}
-if (help) {
-	printHelp();
-}
-
-if (!input || input.trim() === '') {
-	printHelp();
-}
-
-const prompt = `
-Respond briefly and directly, using minimal words. Reason step-by-step first. Focus solely on core point; avoid elaboration or follow-ups. If unclear, ask clarifying questions before proceeding.
- `.trim();
-
-const agent = new AgentManager({ name, secret });
-agent.setup({
-	prompt,
-	api,
-	options,
-	toolsetMode,
-	contextWindow
-});
-
-const res = await agent.directCall(input);
-console.log(res);

package/examples/grok_agent.js.bak.2

@@ -1,99 +0,0 @@
-# Backup of current grok_agent.js before fix
-#!/usr/bin/env node
-/*
-* ONE SHOT , direct call example
-* ```bash
-* echo \"What is your task?\" | examples/grok_agent.js
-* ```
-*/
-import { AgentManager }  from '@j-o-r/hello-dave';
-import { parseArgs, readIn } from '@j-o-r/sh';
-
-const name = 'grok_agent';
-const api = 'xai';
-let secret = '';
-
-const input = await readIn();
-const args = parseArgs();
-const help = args['help'] || false;
-
-/** @type {import('lib/API/x.ai/responses.js').XAIOptions} */
-const options = {
-	tools: []
-}
-options.tools.push({
-	type: 'web_search'
-});
-options.tools.push({
-	type: 'x_search'
-});
-
-// Set properties only if provided via command line (except model which has default)
-if (args['model'] || true) { // model gets default value
-	// @ts-ignore   || grok-4-1-fast-non-reasoning
-	options.model = args['model'] || 'grok-4.20-multi-agent-0309';
-}
-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 // args['reasoning'] ? args['reasoning'] : null;
-if (reasoning) {
-	options.reasoning = {
-		effort: 'medium',
-		summary: 'auto'
-	}
-}
-// Large context on grok-4-fast
-const contextWindow = args['context'] ? parseInt(args['context']) : 1900000;
-const toolsetMode = 'auto';
-
-function printHelp() {
-	console.log(`
-'${name} --help' You are looking at it.
-'
-OPTIONS: 
---tokens [number]: max generated tokens 
---context [number] : truncate message history to context-windows size default 130000
---temperature [float] : -2 / +2
---model ['grok-4-1-fast-reasoning'|'grok-4-1-fast-non-reasoning'|'grok-code-fast-1'|'grok-4-fast-reasoning'|'grok-4-fast-non-reasoning']
---top_p [float]: number > 0, 0.1 means no top_p
---reasoning [low|high]
-
-USAGE:
-
-\`\`\`bash
-echo \"What is ...\" | grok_agent.js
-\`\`\`
-
-`);
-	process.exit()
-}
-if (help) {
-	printHelp();
-}
-
-if (!input || input.trim() === '') {
-	printHelp();
-}
-
-const prompt = `
-Respond briefly and directly, using minimal words. Reason step-by-step first. Focus solely on core point; avoid elaboration or follow-ups. If unclear, ask clarifying questions before proceeding.
- `.trim();
-
-const agent = new AgentManager({ name, secret });
-agent.setup({
-	prompt,
-	api,
-	options,
-	toolsetMode,
-	contextWindow
-});
-
-const res = await agent.directCall(input);
-console.log(res);

package/examples/grok_agent.js.bak.3

@@ -1 +0,0 @@
-# Full backup of grok_agent.js before printHelp clarity update

package/examples/grok_agent.js.bak.4

@@ -1,124 +0,0 @@
-#!/usr/bin/env node
-/*
-* Full modes: Direct call (one-shot), CLI interactive, WS Server (--serve), Client (--connect).
-* Direct: grok_agent.js "What is your task?"
-* Pipe/Stdin: echo "What is your task?" | grok_agent.js
-* CLI: grok_agent.js
-* Server: grok_agent.js --serve 8080
-*/
-import { AgentManager } from '@j-o-r/hello-dave';
-import { parseArgs } from '@j-o-r/sh';
-
-const name = 'grok_agent';
-const api = 'xai';
-let secret = '';
-
-let input; // Directcall input (positional or fallback to readIn for pipe)
-const args = parseArgs();
-
-if (args._.length === 1 && typeof args._[0] === 'string' && args._[0].trim() !== '') {
-	input = args._[0].trim();
-} else {
-	// Fallback for piped stdin (async readIn)
-	const { readIn } = await import('@j-o-r/sh');
-	input = await readIn();
-}
-
-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'
-});
-options.tools.push({
-	type: 'x_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.
-
-## Direct call mode, one shot:
-grok_agent.js "What is your task?"  --[options]
-echo "What is your task?" | grok_agent.js
-
-## Cli mode (interactive)
-grok_agent.js --[options]
-
-## SERVER TOOLS (server mode): (only when no input is provided)
---serve [number]: create a Agent server on port number ws://127.0.0.1:[serve]/ws
---connect [url]: connect to a Server Agent e.g ws://127.0.0.1:8080/ws (https://my.domain/ws) ...
---secret [string] : limit access to websocket server with a secret
-
-OPTIONS: 
---tokens [number]: max generated tokens 
---context [number] : truncate message history to context-windows size default 250000
---temperature [float] : -2 / +2
---model [grok-4-fast-reasoning|grok-beta|...] 
---top_p [float]: number > 0, 0.1 means no top_p
---reasoning 
-`);
-	process.exit()
-}
-
-if (help) {
-	printHelp();
-}
-
-if (!input || input.trim() === '') {
-	printHelp();
-}
-
-const prompt = `
-Respond briefly and directly, using minimal words. Reason step-by-step first. Focus solely on core point; avoid elaboration or follow-ups. If unclear, ask clarifying questions before proceeding.
-`.trim();
-
-const agent = new AgentManager({ name, secret });
-agent.setup({
-	prompt,
-	api,
-	options,
-	toolsetMode,
-	contextWindow
-});
-
-const cliIntro = `
-${name} ${options.model}.
-- context: ${contextWindow}. Tools: web_search, x_search.
-Brief responder ready for CLI/Server/Client modes.
-`.trim();
-
-if (input) {
-	const RES = await agent.directCall(input);
-	console.log(RES);
-} else {
-	await agent.start(serve, connect, cliIntro);
-}

package/examples/grok_agent.js.bak.5

@@ -1 +0,0 @@
-Full backup before CLI no-args fix

package/examples/grok_agent.js.bak.6

@@ -1 +0,0 @@
-# Backup before adding serve/connect/secret explanations to printHelp