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

package/examples/gpt.js

@@ -1,29 +1,31 @@
 #!/usr/bin/env node
-import { fileURLToPath } from 'url';
-import path from 'path';
-import AgentManager from '../lib/AgentManager.js';
+import { AgentManager } from '@j-o-r/hello-dave';
 import { parseArgs, readIn } from '@j-o-r/sh';
-import genTools from '../lib/genericToolset.js';
 
-const name = path.basename(fileURLToPath(import.meta.url), path.extname(fileURLToPath(import.meta.url)));
+const name = 'chat_gpt';
 const api = 'gpt';
+let secret = '';
 
-const input = await readIn();
+// const input = await readIn();
 const args = parseArgs();
 const help = args['help'] || false;
 const connect = args['connect'] ? args['connect'] : undefined;
 const serve = args['serve'] ? parseInt(args['serve']) : undefined;
 
-/**
-* @type {import('lib/API/openai.com/reponses/text.js').OAOptions}
-*/
-const options = {}
+/** @type {import('@j-o-r/hello-dave/types/API/openai.com/reponses/text').OAOptions} */
+const options = {
+	tools: []
+}
+options.tools.push({
+	type: 'web_search' 
+});
+if (args['secret']) { // model gets default value
+	secret = args['secret'];
+}
 // Set properties only if provided via command line (except model which has default)
 if (args['model'] || true) { // model gets default value
-	// @ts-ignore
-	options.model = args['model'] || 'gpt-5';
+	options.model = args['model'] || 'gpt-5.4';
 }
-// temperature is NOT available for o3 / 03-mini
 if (args['temperature']) {
 	options.temperature = parseFloat(args['temperature']);
 }
@@ -33,41 +35,38 @@ if (args['tokens']) {
 if (args['top_p']) {
 	options.top_p = parseFloat(args['top_p']);
 }
-if (args['search'] || true) {
-	// always enable search
-	// @ts-ignore
-	// options.search = args['search'] || 'medium';
-}
-
-const reasoning = args['reasoning'] ? args['reasoning'] : null;
-
+const reasoning = true // args['reasoning'] ? args['reasoning'] : null;
 if (reasoning) {
-	// @ts-ignore
-	options.reasoning=  {effort: reasoning, summary: 'auto'}
+	options.reasoning = {
+		effort: 'medium',
+		summary: 'auto'
+	}
 }
+// Large context on grok-4-fast
+const contextWindow = args['context'] ? parseInt(args['context']) : 100000;
+const toolsetMode = 'auto';
 
-const toolsetMode = (args.tools || serve) ? 'auto' : undefined;
-const contextWindow = args['context'] ? parseInt(args['context']) : 399000;
-
-function printHelp () {
+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
---temperature [float] : default 0.4  
---model [gpt-5|gpt-5-mini|gpt-5-nano|gpt-4.1|o3|o3-mini|o4-mini|o1|o3-pro]
---search [low|medium|high]
---reasoning [low|medium|high]
+--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]
 --tools [javascript,bash] comma seperated list
-e.g.
-gpt --model o3-mini  --tokens 4000 --context 10000
+
+SERVER TOOLS:
+--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
 
 `);
-process.exit()
+	process.exit()
 }
-
 if (help) {
 	printHelp();
 }
@@ -76,7 +75,7 @@ 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 });
+const agent = new AgentManager({ name, secret });
 agent.setup({
 	prompt,
 	api,
@@ -84,44 +83,27 @@ agent.setup({
 	toolsetMode,
 	contextWindow
 });
-const tools = [];
-const toolset = agent.getToolset();
-if (args['tools']) {
-	const addTools = args['tools'].split(',') || [];
-	if (addTools.includes('javascript')) {
-		let tool = genTools.get('javascript_interpreter');
-		if (tool) {
-		  tools.push('javascript_interpreter');
-		  toolset.add('javascript_interpreter', tool.description, tool.parameters, tool.method);
-		}
-	}
-	if (addTools.includes('bash')) {
-		let tool = genTools.get('execute_bash_script');
-		if (tool) {
-		  tools.push('execute_bash_script');
-		  toolset.add('execute_bash_script', tool.description, tool.parameters, tool.method);
-		}
-	}
-}
-
+// agent.addGenericToolcall('open_link');
+// agent.addGenericToolcall('send_email');
+// agent.addGenericToolcall('history_search');
+// 
+// const addTools = (args['tools']) ? args['tools'].split(',') : ['bash'];
+// if (addTools.includes('javascript')) {
+// 	agent.addGenericToolcall('javascript_interpreter');
+// }
+// if (addTools.includes('bash')) {
+// 	agent.addGenericToolcall('execute_bash_script');
+// }
+// if (addTools.includes('ssh')) {
+// 	agent.addGenericToolcall('execute_remote_script');
+// }
 const cliIntro = `
 ${name} ${options.model}.
 - context: ${contextWindow}
 `.trim();
-
 const description = `
-Generic helper and smart AI for difficult tasks. Natural language, math and reasoning - the perfect jack of all trades 
+Guide for this smart online AI Agent:
+- query: Formulate ONE efficient, comprehensive search query in natural language, combining multiple sources/subjects/domains; mention optional sources if needed. Avoid multiple queries—consolidate into a single one.
 `.trim();
 
-if (input === '' && serve) {
-	agent.enableServer(name, description, serve);
-}
-if (input !== '') {
-	// Direct input output
-	const res = await agent.directCall(input);
-	console.log(res);
-} else if(connect) {
-	agent.attach(name, description, connect)
-} else {
-	agent.startCli(cliIntro);
-}
+await agent.start(serve, connect, cliIntro, "search_agent", description);

package/examples/grok.js

@@ -1,45 +1,56 @@
 #!/usr/bin/env node
-import { fileURLToPath } from 'url';
-import path from 'path';
-import AgentManager from '../lib/AgentManager.js';
+/*
+* 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';
-import genTools from '../lib/genericToolset.js';
 
-const name = path.basename(fileURLToPath(import.meta.url), path.extname(fileURLToPath(import.meta.url)));
-const api = 'grok';
+const name = 'ask_grok';
+const api = 'xai';
+let secret = '';
 
 const input = await readIn();
 const args = parseArgs();
 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/text.js').XOptions} */
-const options = {}
+/** @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
-	options.model = args['model'] || 'grok-4';
+	// @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_completion_tokens = parseInt(args['tokens']);
+	options.max_output_tokens = parseInt(args['tokens']);
 }
 if (args['top_p']) {
 	options.top_p = parseFloat(args['top_p']);
 }
-
-options.search_parameters = { mode: 'auto' }
-// @ts-ignore
-const reasoning = args['reasoning'] ? args['reasoning'] : null;
+const reasoning = true // args['reasoning'] ? args['reasoning'] : null;
 if (reasoning) {
-	// @ts-ignore
-	options.reasoning_effort = reasoning
+	options.reasoning = {
+		effort: 'medium',
+		summary: 'auto'
+	}
 }
-const toolsetMode = (args.tools || serve) ? 'auto' : undefined;
-const contextWindow = args['context'] ? parseInt(args['context']) : 250000;
+// Large context on grok-4-fast
+const contextWindow = args['context'] ? parseInt(args['context']) : 1900000;
+const toolsetMode = 'auto';
 
 function printHelp() {
 	console.log(`
@@ -49,25 +60,32 @@ OPTIONS:
 --tokens [number]: max generated tokens 
 --context [number] : truncate message history to context-windows size default 130000
 --temperature [float] : -2 / +2
---model [grok-4|grok-3|grok-3-mini|grok-3-mini-fast]
+--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]
---tools [javascript,bash] comma seperated list
-e.g.
-grok.js --model grok-3-mini --tokens 4000 --context 10000
+
+USAGE:
+
+\`\`\`bash
+echo "What is ..." | grok.js
+\`\`\`
 
 `);
 	process.exit()
 }
-
 if (help) {
 	printHelp();
 }
+
+if (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 });
+const agent = new AgentManager({ name, secret });
 agent.setup({
 	prompt,
 	api,
@@ -75,45 +93,6 @@ agent.setup({
 	toolsetMode,
 	contextWindow
 });
-const tools = [];
-const toolset = agent.getToolset();
-if (toolset && args['tools']) {
-	const addTools = args['tools'].split(',') || [];
-	if (addTools.includes('javascript')) {
-		let tool = genTools.get('javascript_interpreter');
-		if (tool) {
-		  tools.push('javascript_interpreter');
-		  toolset.add('javascript_interpreter', tool.description, tool.parameters, tool.method);
-		}
-	}
-	if (addTools.includes('bash')) {
-		let tool = genTools.get('execute_bash_script');
-		if (tool) {
-		  tools.push('execute_bash_script');
-		  toolset.add('execute_bash_script', tool.description, tool.parameters, tool.method);
-		}
-	}
-}
-
-const cliIntro = `
-${name} ${options.model}.
-- search  ${options.search_parameters.mode}
-`.trim();
-
-const description = `
-Generic helper and smart AI for difficult tasks. Natural language, math and reasoning - the perfect jack of all trades 
-`.trim();
 
-if (input === '' && serve) {
-	agent.enableServer(name, description, serve);
-}
-if (input !== '') {
-	// Direct input output
-	const res = await agent.directCall(input);
-	console.log(res);
-} else if(connect) {
-	agent.attach(name, description, connect)
-} else if(!serve) {
-	// Mix a cli with a server is a thing we need to test
-	agent.startCli(cliIntro);
-}
+const res = await agent.directCall(input);
+console.log(res);

package/examples/npmDave.js

@@ -0,0 +1,175 @@
+#!/usr/bin/env node
+import { AgentManager } from '@j-o-r/hello-dave';
+import { parseArgs } from '@j-o-r/sh';
+
+const name = 'npm_dave';
+const api = 'xai';
+let secret = '';
+
+const input = ''; //await readIn();
+const args = parseArgs();
+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']) { // model gets default value
+	secret = args['secret'];
+}
+// Set properties only if provided via command line (except model which has default)
+if (args['model'] || true) { // model gets default value
+	// @ts-ignore
+	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; // args['reasoning'] ? args['reasoning'] : null;
+if (reasoning) {
+	options.reasoning = {
+		effort: 'medium',
+		summary: 'auto'
+	}
+}
+const toolsetMode = 'auto';
+const contextWindow = args['context'] ? parseInt(args['context']) : 250000;
+
+// Copy from the generic toolset
+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|grok-3|grok-3-mini|grok-3-mini-fast|grok-code-fast-1]
+--top_p [float]: number > 0, 0.1 means no top_p
+--reasoning 
+--tools [javascript,bash] comma seperated list
+
+SERVER TOOLS:
+--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
+
+`);
+	process.exit()
+}
+
+if (help) {
+	printHelp();
+}
+const tool_call_name = 'npm_module_inspector';
+const tool_call_description = `
+NPM modules expert (scoped & unscoped). Uses \`npm ls\` + bash **exclusively inside ./node_modules/**.
+**Smart Cache**: .cache/npm-agent-storage.md (auto-read/update, token-efficient, auto-refreshes on changes). Agent-owned.
+`.trim();
+
+const CACHE_FILE='.cache/npm-agent-storage.md';
+
+const prompt = `
+You are a coding assistant specializing in Bash and JavaScript (ESM/ESNext), with support for other languages.
+Your role: Help users code with external NPM modules installed in the project's ./node_modules/ (dynamic CWD).
+Scoped (@j-o-r/cli) == unscoped (gpt-3-encoder) priority.
+
+CWD dynamic (pwd; project root w/ package.json/node_modules).
+
+CRITICAL: **NEVER** inspect/read **OUTSIDE** ./node_modules/. NO project files. **ONLY** \`npm ls\` (local) + node_modules/ paths.
+
+**Smart Cache (${CACHE_FILE})**: Agent-owned, hidden, **auto-managed** (read-first, update-on-change, NO user confirm).
+- **Token Saver**: Grep cache **FIRST** (if match version → use, skip inspect).
+- **Auto-Update**: ALWAYS check \`npm ls \$PKG_NAME\`; if version changed/missing → inspect + **silently rewrite** section.
+- Init: \`touch ${CACHE_FILE}\`
+
+PRIORITIZE \`npm ls --depth=1\` (versions/tree) + bash **inside** MODULE_DIR.
+
+Tools:
+- execute_bash_script: \`npm ls ...\` + \`cat node_modules/\$PKG_NAME/package.json\`. **node_modules/ prefix ALWAYS**.
+- web_search: Docs supplement.
+- history_search: Chats.
+
+**Smart Workflow** (per query; e.g., "@j-o-r/cli"):
+1. **Confirm Installed/Version**:
+   \`CURRENT_VERSION=\$(npm ls "\$PKG_NAME" --depth=0 2>/dev/null | grep -o ' @[0-9].*' | sed 's/ @//') || echo "Not installed"\`
+
+2. **Smart Cache Check** (token-efficient):
+   - Init: \`touch ${CACHE_FILE}\`
+   - Exact match? \`grep -A 30 "^## \$PKG_NAME v\$CURRENT_VERSION " ${CACHE_FILE} || echo "Cache miss/outdated"\`
+   - If hit: Use cache summary (paste relevant sections). **Skip** full inspect.
+   - List all: \`grep "^## " ${CACHE_FILE} | sed 's/^## //' || echo "Empty cache"\`
+
+3. **Inspect if Cache Miss/Outdated** (set MODULE_DIR=node_modules/\$PKG_NAME):
+   - Path: \`[ -d "node_modules/\$PKG_NAME" ] && echo "OK" || echo "Dir missing"\`
+   - Desc: \`grep '"description"' "node_modules/\$PKG_NAME/package.json" | sed 's/.*"description": "\\([^"]*\\)".*/\\1/' || echo "No desc"\`
+   - Entrypoints: \`grep -E '"(main|module|types|exports)"' "node_modules/\$PKG_NAME/package.json" || echo "None"\`
+   - README: \`head -50 "node_modules/\$PKG_NAME/README.md" 2>/dev/null || echo "No README"\`
+   - Types/Exports: \`find "node_modules/\$PKG_NAME" -name "*.d.ts" 2>/dev/null | head -8 | xargs grep -hE "export (interface|type|function|class|const)" | head -25 || find "node_modules/\$PKG_NAME" -name "*.{ts,js,mjs,cjs}" 2>/dev/null | head -8 | xargs grep -hE "export " | head -25 || echo "No exports"\`
+   - Examples: \`grep -rniE "example|usage|demo" "node_modules/\$PKG_NAME/" 2>/dev/null | head -15 || echo "No examples"\`
+   - Subdeps: \`npm ls "\$PKG_NAME" --depth=1\`
+
+4. **Auto-Update Cache** (**ALWAYS after inspect**, silent, replace section):
+   \`sed -i.bak "/^## \$PKG_NAME /,/^## \\|^$/d" ${CACHE_FILE} && rm ${CACHE_FILE}.bak 2>/dev/null; cat >> ${CACHE_FILE} << 'EOC'
+## \$PKG_NAME v\$CURRENT_VERSION
+
+### Overview
+\$DESC
+
+### Installation
+Installed (\$CURRENT_VERSION). import {example} from '\$PKG_NAME'; // ESM
+
+### Usage Examples
+\$EXAMPLES
+
+### API Reference
+\$EXPORTS
+
+### Dependencies
+\$SUBDEPS
+
+### Notes
+Best practices/gotchas from README/types.
+EOC\`
+
+5. **List All Modules** (top-level, cached/versions):
+   \`npm ls --depth=0 | grep -E '^[├└]──' | sed 's/^[├└ ]*── //' | sed 's/ .*//' || echo "npm ls --depth=0"\`
+
+6. **Coding Help**: ESM snippets, errors (\`npm ls --why=\$PKG_NAME\`), best practices (cache + local + web).
+
+**MANDATORY**: Cache-first. Auto-update **every time** version changes/miss. **No asks**. Scoped=unscoped. Portable.
+`.trim();
+
+const agent = new AgentManager({ name, secret });
+agent.setup({
+	prompt,
+	api,
+	options,
+	toolsetMode,
+	contextWindow
+});
+const toolset = agent.getToolset();
+if (toolset) {
+	agent.addGenericToolcall('history_search');
+	agent.addGenericToolcall('javascript_interpreter');
+	agent.addGenericToolcall('execute_bash_script');
+	agent.addGenericToolcall('read_file');
+	agent.addGenericToolcall('write_file');
+}
+const cliIntro = `
+${name} ${options.model}.
+- context: ${contextWindow}. Smart cache: ${CACHE_FILE} (auto).
+${tool_call_name}
+`.trim();
+
+await agent.start(serve, connect, cliIntro, tool_call_name, tool_call_description);

package/examples/promptDave.js

@@ -0,0 +1,112 @@
+#!/usr/bin/env node
+import { AgentManager } from '@j-o-r/hello-dave';
+import { parseArgs, readIn } from '@j-o-r/sh';
+
+const name = 'prompt_dave';
+const api = 'xai';
+let secret = '';
+
+const input = ''; // await readIn();
+const args = parseArgs();
+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']) { // model gets default value
+	secret = args['secret'];
+}
+// 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-1-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 // args['reasoning'] ? args['reasoning'] : null;
+if (reasoning) {
+	// options.reasoning_effort = 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|grok-3|grok-3-mini|grok-3-mini-fast|grok-code-fast-1]
+--top_p [float]: number > 0, 0.1 means no top_p
+--reasoning [low|high]
+--tools [javascript,bash] comma seperated list
+
+SERVER TOOLS:
+--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
+
+
+`);
+	process.exit()
+}
+if (help) {
+	printHelp();
+}
+
+const prompt = `
+You are a prompt optimizer. Check for: 1) Clarity and specificity. 2) Brevity, non-ambiguity, ethics. 3) Token efficiency. If good, say "Approved." If not, rewrite concisely or ask 1-2 questions. Output: - Summary. - Rewritten prompt (if needed). - Questions (if unclear). Be efficient.
+`.trim();
+
+const agent = new AgentManager({ name, secret });
+agent.setup({
+	prompt,
+	api,
+	options,
+	toolsetMode,
+	contextWindow
+});
+agent.addGenericToolcall('open_link');
+agent.addGenericToolcall('send_email');
+agent.addGenericToolcall('history_search');
+
+const addTools = (args['tools']) ? args['tools'].split(',') : ['bash'];
+if (addTools.includes('javascript')) {
+	agent.addGenericToolcall('javascript_interpreter');
+}
+if (addTools.includes('bash')) {
+	agent.addGenericToolcall('execute_bash_script');
+}
+if (addTools.includes('ssh')) {
+	agent.addGenericToolcall('execute_remote_script');
+}
+const cliIntro = `
+${name} ${options.model}.
+- context: ${contextWindow}
+`.trim();
+
+const description = `
+Given a specific prompt, inspect and adjust it for better readability and clarity.
+`.trim();
+await agent.start(serve, connect, cliIntro, "prompt_engineer_agent", description);