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

package/examples.bak.1774780058/npm_agent.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.bak.1774780058/prompt_agent.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);

package/examples.bak.1774780058/readme_agent.js

@@ -0,0 +1,144 @@
+#!/usr/bin/env node
+import { AgentManager } from '@j-o-r/hello-dave';
+import { parseArgs, readIn } from '@j-o-r/sh';
+
+const name = 'readme_dave';
+const api = 'xai';
+let secret = '';
+
+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 = args['reasoning'] ? args['reasoning'] : null;
+if (reasoning) {
+if (reasoning) {
+	options.reasoning = {
+		// @ts-ignore
+		effort: reasoning,
+		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 [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 tool_call_description = `
+Project README manager. Maintains README.md with comprehensive project documentation.
+Inspects current README.md, updates sections (installation, usage, etc.), generates content based on project files and user input.
+Suggests improvements, adds badges, TOC, etc.
+`.trim();
+const tool_call_name = 'readme_agent';
+const prompt = `
+You are an expert README.md manager for this project. README.md should follow best practices with sections like:
+
+# Project Title
+![Badges]
+
+## Table of Contents
+
+## Description
+## Features
+## Installation
+## Usage
+## Examples
+## Development
+## Contributing
+## License
+
+ALWAYS:
+
+1. Inspect the current README.md if it exists (\`cat README.md\` or similar).
+
+2. Inspect key project files: \`cat package.json\`, \`ls -la\`, \`ls bin/\`, \`ls lib/\`, \`git status\`, etc.
+
+3. Understand the user input: 
+   - "add installation instructions"
+   - "generate usage examples"
+   - "add table of contents"
+   - "update description to: ..."
+   - "suggest improvements"
+   - "include npm badges"
+   - "make it more professional"
+
+4. Update README.md with changes. Ensure excellent Markdown formatting, accuracy based on project.
+
+5. Write the FULL updated content to ./README.md.
+
+6. In your response, summarize:
+   - Changes made
+   - Preview of key sections (e.g., first 20 lines)
+   - Any suggestions for further enhancements
+
+If no README.md exists, create a comprehensive one by analyzing the entire project: package.json, code structure, scripts, etc. Infer project name, description, usage from files.
+
+Use tools to read files, list directories, etc., as needed.
+`.trim();
+const agent = new AgentManager({ name, secret });
+agent.setup({
+	prompt,
+	api,
+	options,
+	toolsetMode,
+	contextWindow
+});
+const toolset = agent.getToolset();
+if (toolset) {
+	agent.addGenericToolcall('execute_bash_script');
+}
+const cliIntro = `
+${name} ${options.model}.
+- context: ${contextWindow}
+`.trim();
+
+await agent.start(serve, connect, cliIntro, tool_call_name, tool_call_description);