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

package/examples/npm_agent.js.bak.3

@@ -1,2 +0,0 @@
-# Full backup of npm_agent.js before printHelp clarity update + stdin fallback
-[Full original content here - omitted for brevity, but would paste the read content]

package/examples/npm_agent.js.bak.4

@@ -1,205 +0,0 @@
-#!/usr/bin/env node
-import { AgentManager } from '@j-o-r/hello-dave';
-import { parseArgs } from '@j-o-r/sh';
-
-const name = 'npm_agent';
-const api = 'xai';
-let secret = '';
-
-let input; // Directcall input
-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'
-});
-
-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):
-./examples/${name}.js "What modules are installed?" [--options]
-
-### 2. Pipe/Stdin (One-Shot):
-echo "What modules are installed?" | ./examples/${name}.js [--options]
-
-### 3. Interactive CLI:
-./examples/${name}.js [--options]
-
-### 4. WS Server (no input):
-./examples/${name}.js --serve 8080 [--secret mysecret] [--options]
-
-### 5. WS Client (no input):
-./examples/${name}.js --connect ws://127.0.0.1:8080/ws --secret mysecret [--options]
-
-### 6. Hybrid (Server + Client):
-./examples/${name}.js --serve 8081 --connect ws://other:8080/ws [--secret ...] [--options]
-
-## 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)
---secret [string] (WS auth)
-
-## SERVER TOOLS (when no input):
-Exposes as 'npm_module_inspector' tool for chaining.
-`);
-	process.exit()
-}
-
-if (help) {
-	printHelp();
-}
-
-const tool_call_name = 'npm_module_inspector';
-const tool_call_description = `
-NPM modules expert (scoped & unscoped). Uses \`npm ls -a\` + 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 -a\` (local) + node_modules/ paths. **NEVER** run \`npm install\` or suggest installs unless NO existing/native alternative (justify HEAVILY, prefer polyfills).
-
-**Dependency Strategy**: For all coding requests, follow this order to keep dependencies minimal (prevent bloat):
-1. **Always try existing installed modules first**: Scan \`npm ls -a\` FULL TREE (all subdeps). Prioritize functions from ANY module.
-2. **Native code**: Node.js/Bash builtins ONLY if no module match.
-3. **Suggest new dep LAST/RARE**: ABSOLUTELY NO unless gap proven (no existing/native). Heavy justification + \`npm i --save-dev PKG\` (dev pref). Goal: ZERO new installs.
-
-**Auto-Cache Init (MANDATORY FIRST on EVERY query - FULL SCAN)**:
-touch ${CACHE_FILE}
-echo "## Full Tree (npm ls -a unique modules)" >> ${CACHE_FILE}
-npm ls -a --parseable 2>/dev/null | sed 's|.*/||' | sort -u | head -50 >> ${CACHE_FILE}  # All unique PKGs (top + sub)
-echo "## Top-Level (--depth=0)" >> ${CACHE_FILE}
-npm ls --depth=0 | grep -E '^[├└]──' | sed 's/^[├└ ]*── //' | sed 's/ .*//' >> ${CACHE_FILE}
-**Condensed Scan**: find node_modules/ -name package.json | sed 's|.*/||;s|/package.json||' | sort -u > ${CACHE_FILE}.allmods
-
-**Vague Query Mode** (e.g., "tests"): 
-- Full scan: \`npm ls -a | grep -i "\$QUERY" || find node_modules/ -name "*.d.ts" -o -name "*.js" | head -50 | xargs grep -lE "\$QUERY|test|assert" | sed 's|.*/||;s|\..*||' | sort -u\`
-- Output table: Module | Exports | For | Usage (from all tree).
-- Append "## QUERY: \$QUERY\nHits: list" >> ${CACHE_FILE}
-
-**Smart Cache (.cache/npm-agent-storage.md)**: Agent-owned, **auto-managed FULL TREE** (read-first, update-on-change).
-- Token Saver: Grep FIRST across all sections.
-- Init: touch .cache/npm-agent-storage.md
-
-PRIORITIZE \`npm ls -a\` (full tree) + bash inside ALL MODULE_DIRs.
-
-Tools:
-- execute_bash_script: \`npm ls -a ...\` + \`cat node_modules/\$PKG_NAME/package.json\`. Prefix ALWAYS.
-- web_search: Docs ONLY.
-- history_search: Chats.
-
-**Smart Workflow** (per query; full tree always):
-1. **Full Tree Installed/Version**:
-   PKGS=\$(npm ls -a --parseable 2>/dev/null | sed 's|.*/||' | sort -u | head -50)
-   for PKG in \$PKGS; do npm ls "\$PKG" 2>/dev/null | tail -1 | grep -o 'v[0-9].*' || echo "\$PKG ??"; done
-
-2. **Smart Cache Check**:
-   grep -A 30 "^## Full Tree" .cache/npm-agent-storage.md || echo "Cache miss"
-
-3. **Inspect if Miss** (loop top 10 hits):
-   - For each MODULE_DIR=node_modules/\$PKG: [existing inspect + enhanced types/docs grep]
-   - Vague: grep -riE "\$QUERY" node_modules/\$PKG/*.{json,md,d.ts,js} | head -20
-
-4. **Auto-Update Cache** (CONDENSED, FULL):
-   sed -i.bak "/^## Full Tree/,/^## QUERY/d" ${CACHE_FILE} && rm ${CACHE_FILE}.bak
-   cat >> ${CACHE_FILE} << EOC
-## Full Tree (npm ls -a)
-\$ALL_PKGS (50 unique)
-
-## \$PKG v\$VER
-Exports: \$EXPORTS
-For: \$KEYWORDS (test/query hits)
-Usage: import {fn} from '\$PKG';
-EOC
-
-5. **List All**: \`npm ls -a | head -50 | grep -E '^[├└]' | sed 's/^[├└ ]*── //' | cut -d@ -f1 | sort -u\`
-
-6. **Coding Help**: ESM/Bash snippets from FULL TREE. **MANDATORY**: Strategy + table + "NO new deps - use existing \$PKG".
-
-**MANDATORY**: FULL \`npm ls -a\` every time. Vague scans ALL modules. **STRICT NO INSTALLS** unless proven gap. Condensed output. 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} (FULL npm ls -a auto).
-${tool_call_name}
-`.trim();
-
-if (!input || input.trim() === '') {
-	printHelp();
-}
-
-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/npm_agent.js.bak.5

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

package/examples/npm_agent.js.bak.6

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