@j-o-r/hello-dave 0.0.0

package/examples/claude.js

@@ -0,0 +1,143 @@
+#!/usr/bin/env node
+import { fileURLToPath } from 'url';
+import path from 'path';
+import AgentManager from '../lib/AgentManager.js';
+import { parseArgs, readIn } from '@j-o-r/sh';
+import genTools from '../lib/genericToolset.js';
+import { env } from '../lib/index.js';
+
+const name = path.basename(fileURLToPath(import.meta.url), path.extname(fileURLToPath(import.meta.url)));
+const api = 'claude';
+
+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/anthropic.com/text.js').ANTHOptions} */
+const options = {}
+// 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'] || 'claude-sonnet-4-0';
+}
+if (args['temperature']) {
+	options.temperature = parseFloat(args['temperature']);
+}
+if (args['tokens']) {
+	options.max_tokens = parseInt(args['tokens']);
+}
+if (args['top_p']) {
+	options.top_p = parseFloat(args['top_p']);
+}
+if (args['top_k']) {
+	options.top_k = parseInt(args['top_k']);
+}
+
+const thinking = args['thinking'] ? parseInt(args['thinking']) : 0;
+if (thinking > 0) {
+	options.thinking = {
+		type: "enabled",
+		budget_tokens: thinking
+	}
+}
+const search = args['search'] ? parseInt(args['search']) : 7;
+if (search > 0) {
+	const userInfo = await env();
+	options.search = {
+		type: 'web_search_20250305',
+		name: 'web_search',
+		max_uses: search,
+		user_location: {
+			type: 'approximate',
+			timezone: userInfo.timezone,
+			region: userInfo.region,
+			city: userInfo.city,
+			country: userInfo.country
+		}
+	}
+}
+const toolsetMode = (args.tools || serve) ? 'auto' : undefined;
+const contextWindow = args['context'] ? parseInt(args['context']) : 190000;
+
+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 190000
+--temperature [float] : -2 / +2
+--model [claude-sonnet-4-0|other models]
+--top_p [float]: number > 0, 0.1 means no top_p
+--top_k [number]: number > 0 and < 2048
+--thinking [number]: thinking tokens (default: 0)
+--search [number]: number of search requests (default: 7)
+--tools [javascript,bash] comma seperated list
+--connect [address]: connect to server
+--serve [port]: start server on port
+e.g.
+claude.js --model claude-sonnet-4-0 --tokens 4000 --context 10000 --thinking 2000
+
+`);
+	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 });
+agent.setup({
+	prompt,
+	api,
+	options,
+	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 ? options.search.max_uses : 'disabled'}
+`.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);
+}

package/examples/gpt.js

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+import { fileURLToPath } from 'url';
+import path from 'path';
+import AgentManager from '../lib/AgentManager.js';
+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 = 'gpt';
+
+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 = {}
+// 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';
+}
+// temperature is NOT available for o3 / 03-mini
+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 (args['search'] || true) {
+	// always enable search
+	// @ts-ignore
+	// options.search = args['search'] || 'medium';
+}
+
+const reasoning = args['reasoning'] ? args['reasoning'] : null;
+
+if (reasoning) {
+	// @ts-ignore
+	options.reasoning=  {effort: reasoning, summary: 'auto'}
+}
+
+const toolsetMode = (args.tools || serve) ? 'auto' : undefined;
+const contextWindow = args['context'] ? parseInt(args['context']) : 399000;
+
+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]
+--tools [javascript,bash] comma seperated list
+e.g.
+gpt --model o3-mini  --tokens 4000 --context 10000
+
+`);
+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 });
+agent.setup({
+	prompt,
+	api,
+	options,
+	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);
+		}
+	}
+}
+
+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 
+`.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);
+}

package/examples/gpt_code.js

@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+import { fileURLToPath } from 'url';
+import path from 'path';
+import AgentManager from '../lib/AgentManager.js';
+import { parseArgs, readIn } from '@j-o-r/sh';
+import genTools from '../lib/genericToolset.js';
+import { systemInfo } from '../lib/fafs.js';
+
+const name = path.basename(fileURLToPath(import.meta.url), path.extname(fileURLToPath(import.meta.url)));
+const api = 'gpt';
+
+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 = {}
+// 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';
+}
+// temperature is NOT available for o3 / 03-mini
+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 (args['search'] || true) {
+	// always enable search
+	// @ts-ignore
+	options.search = args['search'] || 'medium';
+}
+const reasoning = args['reasoning'] ? args['reasoning'] : null;
+if (reasoning) {
+	// @ts-ignore
+	options.reasoning=  {effort: reasoning, summary: 'auto'}
+}
+
+const toolsetMode = 'auto';
+const contextWindow = args['context'] ? parseInt(args['context']) : 399000;
+
+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]
+--tools [javascript,bash] comma seperated list
+e.g.
+gpt --model o3-mini  --tokens 4000 --context 10000
+
+`);
+process.exit()
+}
+
+if (help) {
+	printHelp();
+}
+
+const sys = await systemInfo();
+const prompt = `
+You are a coding assistant specializing in Bash and JavaScript (ESM/ESNext), with support for other languages. Assist by executing, reading, creating, querying, explaining, or helping with code. Use tools like 'execute_bash_script' for safe Bash execution. For writing and reading files, stay in the current working folder. Provide clear, step-by-step responses, examples, and ensure safety compliance.
+---env
+${sys}
+---
+ `.trim();
+
+const agent = new AgentManager({ name });
+agent.setup({
+	prompt,
+	api,
+	options,
+	toolsetMode,
+	contextWindow
+});
+
+const toolset = agent.getToolset();
+if (toolset) {
+	const addTools = (args['tools']) ?  args['tools'].split(',') : [];
+	if (addTools.includes('javascript')) {
+		let tool = genTools.get('javascript_interpreter');
+		if (tool) {
+			toolset.add('javascript_interpreter', tool.description, tool.parameters, tool.method);
+		}
+	}
+	let tool = genTools.get('execute_bash_script');
+	if (tool) {
+		toolset.add('execute_bash_script', tool.description, tool.parameters, tool.method);
+	}
+}
+const cliIntro = `
+${name} ${options.model}.
+- search  ${options.search}
+- context: ${contextWindow}
+`.trim();
+
+const description = `
+Gateway coding assistant Agent for Bash, JavaScript (ESM/ESNext), and other languages. Handles execution, reading, creation, querying, explaining, and code help, with safety and folder restrictions.
+`.trim();
+if (input === '' && serve) {
+	agent.enableServer('code', description, serve);
+}
+if (input !== '') {
+	// Direct input output
+	const res = await agent.directCall(input);
+	console.log(res);
+} else if(connect) {
+	agent.attach('code', description, connect)
+} else {
+	agent.startCli(cliIntro);
+}

package/examples/gpt_note_keeping.js

@@ -0,0 +1,117 @@
+#!/usr/bin/env node
+import { fileURLToPath } from 'url';
+import path from 'path';
+import AgentManager from '../lib/AgentManager.js';
+import { systemInfo } from '../lib/fafs.js';
+import { parseArgs, readIn } from '@j-o-r/sh';
+import toolsPool from '../lib/genericToolset.js';
+
+const name = path.basename(fileURLToPath(import.meta.url), path.extname(fileURLToPath(import.meta.url)));
+const api = 'gpt';  // Using GPT API for general AI assistance, adjust if needed
+
+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 = {}
+// 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-mini';
+}
+// temperature is NOT available for o3 / 03-mini
+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']);
+}
+// always enable search
+// @ts-ignore
+options.search = args['search'] || 'medium';
+
+const reasoning = args['reasoning'] ? args['reasoning'] : null;
+
+if (reasoning) {
+  // @ts-ignore
+  options.reasoning = { effort: reasoning, summary: 'auto' }
+}
+
+const toolsetMode = 'auto';
+const contextWindow = args['context'] ? parseInt(args['context']) : 399000;
+
+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]
+--reasoning [low|medium|high]
+e.g.
+gpt --model o3-mini  --tokens 4000 --context 10000
+
+`);
+  process.exit()
+}
+
+if (help) {
+  printHelp();
+}
+const sys = await systemInfo();
+
+// You are an AI note-keeping assistant for Markdown notes in extended context. Use/create 'notes' folder in cwd. Search via tools like grep. Create/update/delete .md files safely. Goals: track progress, manage todos, capture requirements, document processes, store links/bookmarks/remarks. Respond concisely, step-by-step, no unnecessary follow-ups.
+const prompt = `
+You are an AI note-keeping assistant for Markdown notes. Use/create 'notes' folder in cwd. Search via grep. Safely create/update/delete .md files. Goals: track progress, manage todos, capture requirements, document processes, store links/remarks. Respond concisely, step-by-step; organize in logical folders, no unnecessary follow-ups.
+---env
+${sys}
+---
+`.trim();
+const agent = new AgentManager({ name });
+agent.setup({
+  prompt,
+  api,
+  options,
+  toolsetMode,
+  contextWindow
+});
+const toolset = agent.getToolset();
+
+if (toolset) {
+  let tool = toolsPool.get('execute_bash_script');
+  if (tool) {
+    toolset.add('execute_bash_script', tool.description, tool.parameters, tool.method);
+  }
+}
+
+const cliIntro = `
+${name} ${options.model}.
+- search  ${options.search}
+- context: ${contextWindow}
+`.trim();
+const description = `
+AI-assisted note-keeping tool for Markdown notes. Support: search, create, update, delete. Track progress, todos, requirements, docs, links, bookmarks, remarks. Use as extended memory for task progress, decisions, state. On startup, query notes for last known state/context. Save notes regularly.
+`.trim();
+
+if (input === '' && serve) {
+  agent.enableServer('memory', description, serve);
+}
+if (input !== '') {
+  // Direct input output
+  const res = await agent.directCall(input);
+  console.log(res);
+} else if (connect) {
+  agent.attach('memory', description, connect)
+} else {
+  agent.startCli(cliIntro);
+}

package/examples/grok.js

@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+import { fileURLToPath } from 'url';
+import path from 'path';
+import AgentManager from '../lib/AgentManager.js';
+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 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 = {}
+// 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';
+}
+if (args['temperature']) {
+	options.temperature = parseFloat(args['temperature']);
+}
+if (args['tokens']) {
+	options.max_completion_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;
+if (reasoning) {
+	// @ts-ignore
+	options.reasoning_effort = reasoning
+}
+const toolsetMode = (args.tools || serve) ? 'auto' : undefined;
+const contextWindow = args['context'] ? parseInt(args['context']) : 250000;
+
+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]
+--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
+
+`);
+	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 });
+agent.setup({
+	prompt,
+	api,
+	options,
+	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);
+}