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

package/examples/grok_agent.js

@@ -0,0 +1,132 @@
+#!/usr/bin/env node
+/*
+* Full modes: Direct call (one-shot positional ONLY), CLI interactive (no args), WS Server (--serve), Client (--connect).
+* Direct: grok_agent.js "What is your task?"
+* 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 = '';
+
+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'
+});
+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.
+
+## USAGE MODES:
+
+### 1. Direct Call (One-Shot, Positional ONLY):
+./examples/${name}.js "What is your task?" [--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. 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 brief responder tool for chaining.
+`);
+	process.exit()
+}
+
+if (help) {
+	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) {
+	// one-shot 
+	const RES = await agent.directCall(input);
+	console.log(RES);
+} else {
+	await agent.start(serve, connect, cliIntro);
+}

package/examples/grok_agent.js.bak

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

@@ -0,0 +1,99 @@
+# 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

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

package/examples/grok_agent.js.bak.4

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

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

package/examples/grok_agent.js.bak.6

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

package/examples/memory_agent.js

@@ -0,0 +1,152 @@
+#!/usr/bin/env node
+import { AgentManager } from '@j-o-r/hello-dave';
+import { parseArgs } from '@j-o-r/sh';
+
+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):
+./examples/${name}.js "Recall tasks" [--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., '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 = `CodeServer Memory Agent. Manages shared agent memory (.cache/memory.ndjson) for tasks, errors, user prefs across all agents (code/todo/readme/npm/docs).
+Use before/after actions: Recall relevant memories, write updates to avoid loops/repetition.
+Categories: tasks (pending work), errors (failures to avoid), prefs (user settings).`.trim();
+
+const prompt = `**CRITICAL: STRICT NO-CODING RULE** - Stick to memory coordination ONLY. Use execute_bash_script/read_file ONLY for safe ops on .cache/memory.ndjson or TODO.md (e.g., cat .cache/memory.ndjson). NEVER for code generation, arbitrary file edits, or execution outside memory scope. Decline coding: "Use code_agent for code. I manage memory."
+
+You are MemoryAgent, the dedicated memory manager for CodeServer multi-agent setup (code/todo/readme/npm/docs agents).
+
+**CORE TOOLS (from lib/genericToolset.js)**:
+- \`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.
+
+**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.
+2. **ACT**: Analyze + decide (write if new info, delegate via server if needed).
+3. **WRITE IF CHANGED**: Use \`memory_write\` for decisions/tasks/errors/prefs (e.g., "Pending: review npm deps", "Error: loop in git", "Pref: low temp for code").
+4. Respond: Summarize memories used/updated + action taken.
+
+**USER QUERIES**:
+- "Recall tasks" → List + suggest next.
+- "Store task: Fix auth bug" → Write + confirm.
+- "Clear old errors" → Recall + write cleaned.
+- Coordinate: "Check if code agent has pending tasks" → Recall + advise.
+
+Use other tools (bash/read_file) only if needed for context. Focus on memory coordination to boost multi-agent efficiency.
+
+Current date: April 01, 2026.`.trim();
+
+const agent = new AgentManager({ name, secret });
+agent.setup({
+	prompt,
+	api,
+	options,
+	toolsetMode,
+	contextWindow
+});
+const toolset = agent.getToolset();
+if (toolset) {
+	agent.addGenericToolcall('memory_recall');
+	agent.addGenericToolcall('memory_write');
+	agent.addGenericToolcall('execute_bash_script');
+	agent.addGenericToolcall('read_file');
+}
+const cliIntro = `${name} ${options.model}.
+- context: ${contextWindow}. Shared memory 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);
+}