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

package/docs.bak.1774780058/xai-responses.md.bak

@@ -1,107 +0,0 @@
-# xAI Responses API Integration (`lib/API/x.ai/responses.js`)
-
-## Overview
-This module provides a seamless wrapper for the [xAI Responses API](https://docs.x.ai/docs/api-reference#create-new-response) (formerly Grok API), adapted for the hello-dave framework. It integrates directly with `Prompt.js` and `ToolSet.js`, enabling tool-using agents via `AgentManager`.
-
-Key adaptations:
-- **Unified Interface**: Uses `Prompt` messages/history for input; parses `output` into assistant/tool responses.
-- **Recursive Tool Calls**: Automatically handles `function_call` → execute tools → `function_call_output` loops (up to `GLOBAL.max_recursive_requests`).
-- **Tool Support**: Converts `ToolSet` to xAI `function` tools; supports native xAI tools like `web_search`, `x_search`.
-- **Reasoning & Search**: Configurable `reasoning.effort` (`low`/`medium`/`high`), `search_parameters`.
-- **Streaming**: Not yet implemented (future).
-- **Auth**: Requires `XAIKEY` env var.
-
-Default model: `grok-4-fast-reasoning`. Supports: `grok-4-fast-reasoning`, `grok-4-fast-non-reasoning`, etc.
-
-## Usage in AgentManager
-```javascript
-import AgentManager from '../lib/AgentManager.js';
-
-const agent = new AgentManager({ name: 'weather-agent', secret: 'optional-ws-secret' });
-agent.setup({
-  prompt: 'You are a precise weather expert. Use tools for real-time data.',
-  api: 'xai',
-  options: { model: 'grok-4-fast-reasoning', reasoning: { effort: 'high' } },
-  toolsetMode: 'auto',  // Adds generic tools like web_search
-  contextWindow: 128000
-});
-agent.addGenericToolcall('web_search');  // Optional: Add extras
-
-// CLI mode
-agent.start();  // Interactive chat
-
-// Or direct call
-const response = await agent.directCall('Weather in Amsterdam today?');
-console.log(response);  // Handles search/tools automatically
-```
-
-Under the hood:
-1. `Prompt.setAdaptor(API.text['xai'], toolset, options)` → uses `responses.request()`.
-2. Converts history to xAI `input[]` (system/user/assistant/tool).
-3. POST to `https://api.x.ai/v1/responses`.
-4. Parses `output` → adds text/reasoning/tools to `Prompt`.
-5. If tools needed, `ToolSet.execute()` → recurse until complete.
-
-## Options (XAIOptions)
-| Property | Type | Default | Description |
-|----------|------|---------|-------------|
-| `model` | string | `'grok-4-fast-non-reasoning'` | e.g., `'grok-4-fast-reasoning'` |
-| `input` | `XAIInput[]` | `[{role: 'system', content: 'Be precise'}]` | Messages/history |
-| `reasoning.effort` | `'low'\|'medium'\|'high'` | `'medium'` | Reasoning depth |
-| `reasoning.summary` | `'auto'\|'concise'\|'detailed'` | `'auto'` | Reasoning output style |
-| `temperature` | number | `1` (0-2) | Sampling |
-| `parallel_tool_calls` | boolean | `true` | Parallel functions |
-| `tool_choice` | `'auto'` | `'auto'` | Tool selection |
-| `tools` | `XAIFunctionTool[]` | `[]` | From `ToolSet` |
-| `store` | boolean | `false` | Persist response (still bills tokens) |
-| `max_output_tokens` | number | `4000` | Limit |
-| `search_parameters` | object | - | `{max_search_results: 4, mode: 'auto', return_citations: true}` |
-
-**Tool Types**:
-- `function`: From `ToolSet` (name, description, parameters JSONSchema).
-- Native: `web_search`, `x_search` (filters: dates, domains, etc.).
-
-## Example Request (Generated Internally)
-```json
-{
-  \"model\": \"grok-4-fast-reasoning\",
-  \"input\": [
-    {\"role\": \"system\", \"content\": \"You are a precise weather expert.\"},
-    {\"role\": \"user\", \"content\": \"Weather in Amsterdam today?\"}
-  ],
-  \"parallel_tool_calls\": true,
-  \"reasoning\": {\"effort\": \"high\"},
-  \"search_parameters\": {\"mode\": \"auto\", \"return_citations\": true},
-  \"tools\": [{"type\": "function", "name": "web_search", ...}]
-}
-```
-
-## Example Response (Parsed to Prompt)
-- **Text + Citations**: Added as `assistant` text + `log` annotations (URLs).
-- **Function Calls**: `assistant` with `function_request` → `ToolSet.execute()`.
-- **Reasoning**: Prepended as `reasoning` multimodal text.
-
-Sample parsed:
-```
-Today is [date]. Weather: Cloudy, 5°C... [citations]
-```
-Tokens: `input_tokens`, `output_tokens` (incl. `reasoning_tokens`) logged in `Prompt.records`.
-
-## Advanced: Custom Tools
-Extend `ToolSet` before `setup()`:
-```javascript
-const ts = new ToolSet('required');
-ts.add('get_weather', 'Get weather for a location', {
-  type: 'object',
-  properties: { location: {type: 'string'} },
-  required: ['location']
-}, async (params) => `Weather: ${params.location} - 20°C`);  // Handler
-agent.setup({ ..., toolsetMode: ts });
-```
-
-## Errors & Limits
-- `Max recursive calls`: `GLOBAL.max_recursive_requests`.
-- Missing `XAIKEY`: Throws.
-- Invalid last message: Must end in `user`/`tool`.
-
-See `lib/API/x.ai/responses.js` source for full JSDoc/types. Cross-links: [Prompt](../prompt-class.md), [ToolSet](../toolset.md), [AgentManager](agent-manager.md) (TBD)."

package/docs.bak.1774780058/xai-responses.md.bak2

@@ -1,107 +0,0 @@
-# xAI Responses API Integration (`lib/API/x.ai/responses.js`)
-
-## Overview
-This module provides a seamless wrapper for the [xAI Responses API](https://docs.x.ai/docs/api-reference#create-new-response) (formerly Grok API), adapted for the hello-dave framework. It integrates directly with `Prompt.js` and `ToolSet.js`, enabling tool-using agents via `AgentManager`.
-
-Key adaptations:
-- **Unified Interface**: Uses `Prompt` messages/history for input; parses `output` into assistant/tool responses.
-- **Recursive Tool Calls**: Automatically handles `function_call` → execute tools → `function_call_output` loops (up to `GLOBAL.max_recursive_requests`).
-- **Tool Support**: Converts `ToolSet` to xAI `function` tools; supports native xAI tools like `web_search`, `x_search`.
-- **Reasoning & Search**: Configurable `reasoning.effort` (`low`/`medium`/`high`), `search_parameters`.
-- **Streaming**: Not yet implemented (future).
-- **Auth**: Requires `XAIKEY` env var.
-
-Default model: `grok-4-fast-reasoning`. Supports: `grok-4-fast-reasoning`, `grok-4-fast-non-reasoning`, etc.
-
-## Usage in AgentManager
-```javascript
-import AgentManager from '../lib/AgentManager.js';
-
-const agent = new AgentManager({ name: 'weatheragent', secret: 'optional-ws-secret' });
-agent.setup({
-  prompt: 'You are a precise weather expert. Use tools for real-time data.',
-  api: 'xai',
-  options: { model: 'grok-4-fast-reasoning', reasoning: { effort: 'high' } },
-  toolsetMode: 'auto',  // Adds generic tools like web_search
-  contextWindow: 128000
-});
-agent.addGenericToolcall('web_search');  // Optional: Add extras
-
-// CLI mode
-agent.start();  // Interactive chat
-
-// Or direct call
-const response = await agent.directCall('Weather in Amsterdam today?');
-console.log(response);  // Handles search/tools automatically
-```
-
-Under the hood:
-1. `Prompt.setAdaptor(API.text['xai'], toolset, options)` → uses `responses.request()`.
-2. Converts history to xAI `input[]` (system/user/assistant/tool).
-3. POST to `https://api.x.ai/v1/responses`.
-4. Parses `output` → adds text/reasoning/tools to `Prompt`.
-5. If tools needed, `ToolSet.execute()` → recurse until complete.
-
-## Options (XAIOptions)
-| Property | Type | Default | Description |
-|----------|------|---------|-------------|
-| `model` | string | `'grok-4-fast-non-reasoning'` | e.g., `'grok-4-fast-reasoning'` |
-| `input` | `XAIInput[]` | `[{role: 'system', content: 'Be precise'}]` | Messages/history |
-| `reasoning.effort` | `'low'\|'medium'\|'high'` | `'medium'` | Reasoning depth |
-| `reasoning.summary` | `'auto'\|'concise'\|'detailed'` | `'auto'` | Reasoning output style |
-| `temperature` | number | `1` (0-2) | Sampling |
-| `parallel_tool_calls` | boolean | `true` | Parallel functions |
-| `tool_choice` | `'auto'` | `'auto'` | Tool selection |
-| `tools` | `XAIFunctionTool[]` | `[]` | From `ToolSet` |
-| `store` | boolean | `false` | Persist response (still bills tokens) |
-| `max_output_tokens` | number | `4000` | Limit |
-| `search_parameters` | object | - | `{max_search_results: 4, mode: 'auto', return_citations: true}` |
-
-**Tool Types**:
-- `function`: From `ToolSet` (name, description, parameters JSONSchema).
-- Native: `web_search`, `x_search` (filters: dates, domains, etc.).
-
-## Example Request (Generated Internally)
-```json
-{
-  "model": "grok-4-fast-reasoning",
-  "input": [
-    {"role": "system", "content": "You are a precise weather expert."},
-    {"role": "user", "content": "Weather in Amsterdam today?"}
-  ],
-  "parallel_tool_calls": true,
-  "reasoning": {"effort": "high"},
-  "search_parameters": {"mode": "auto", "return_citations": true},
-  "tools": [{"type": "function", "name": "web_search", ...}]
-}
-```
-
-## Example Response (Parsed to Prompt)
-- **Text + Citations**: Added as `assistant` text + `log` annotations (URLs).
-- **Function Calls**: `assistant` with `function_request` → `ToolSet.execute()`.
-- **Reasoning**: Prepended as `reasoning` multimodal text.
-
-Sample parsed:
-```
-Today is [date]. Weather: Cloudy, 5°C... [citations]
-```
-Tokens: `input_tokens`, `output_tokens` (incl. `reasoning_tokens`) logged in `Prompt.records`.
-
-## Advanced: Custom Tools
-Extend `ToolSet` before `setup()`:
-```javascript
-const ts = new ToolSet('required');
-ts.add('get_weather', 'Get weather for a location', {
-  type: 'object',
-  properties: { location: {type: 'string'} },
-  required: ['location']
-}, async (params) => `Weather: ${params.location} - 20°C`);  // Handler
-agent.setup({ ..., toolsetMode: ts });
-```
-
-## Errors & Limits
-- `Max recursive calls`: `GLOBAL.max_recursive_requests`.
-- Missing `XAIKEY`: Throws.
-- Invalid last message: Must end in `user`/`tool`.
-
-See `lib/API/x.ai/responses.js` source for full JSDoc/types. Cross-links: [Prompt](../prompt-class.md), [ToolSet](../toolset.md), [AgentManager](agent-manager.md) (TBD).

package/docs.bak.1774780058/xai_collections.md

@@ -1,106 +0,0 @@
-[x.ai collections](https://docs.x.ai/docs/guides/using-collections/api)
-
-
-Creating a collection:
-
-```bash
-curl https://management-api.x.ai/v1/collections \
-  -X POST \
-  -H "Content-Type: application/json" \
-  -H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY" \
-  -d '{"collection_name": "SEC Filings"}'
-```
-
-Listing collections:
-```bash
-curl https://management-api.x.ai/v1/collections \
-  -H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY"
-```
-
-Viewing collection configuration:
-```bash
-'curl https://management-api.x.ai/v1/collections/collection_dbc087b1-6c99-493d-86c6-b401fee34a9d \
-  -H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY"
-```
-
-Updating collection configuration
-```bash
-curl https://management-api.x.ai/v1/collections/collection_dbc087b1-6c99-493d-86c6-b401fee34a9d \
-  -X PUT \
-  -H "Content-Type: application/json" \
-  -H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY" \
-  -d '{"collection_name": "SEC Filings (New)"}'
-```
-
-Uploading documents:
-
-```bash
-# Step 1: Upload file
-curl https://api.x.ai/v1/files \
-  -H "Authorization: Bearer $XAI_API_KEY" \
-  -F file=@tesla-20241231.html
-
-# Step 2: Add file to collection (use file_id from step 1)
-curl -X POST https://management-api.x.ai/v1/collections/$COLLECTION_ID/documents/$FILE_ID \
-  -H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY"
-
-```
-
-Uploading with metadata fields
-
-```bash
-curl https://management-api.x.ai/v1/collections/collection_dbc087b1-6c99-493d-86c6-b401fee34a9d/documents \
-  -H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY" \
-  -F "name=paper.pdf" \
-  -F "data=@paper.pdf" \
-  -F "content_type=application/pdf" \
-  -F 'fields={"author": "Sandra Kim", "year": "2024", "title": "Q3 Revenue Analysis"}'
-
-```
-
-Searching documents
-
-```bash
-curl https://api.x.ai/v1/documents/search \
-  -H "Content-Type: application/json" \
-  -H "Authorization: Bearer $XAI_API_KEY" \
-  -d '{
-    "query": "What were the key revenue drivers based on the SEC filings?",
-    "source": {
-      "collection_ids": ["collection_dbc087b1-6c99-493d-86c6-b401fee34a9d"]
-    }
-  }'
-```
-
-```bash
-curl https://api.x.ai/v1/documents/search \
-  -H "Content-Type: application/json" \
-  -H "Authorization: Bearer $XAI_API_KEY" \
-  -d '{
-      "query": "What were the key revenue drivers based on the SEC filings?",
-      "source": {
-          "collection_ids": [
-              "collection_dbc087b1-6c99-493d-86c6-b401fee34a9d"
-          ]
-      },
-      "retrieval_mode": {"type": "hybrid"}
-}'
-```
-
-
-Deleting a document:
-
-```bash
-curl https://management-api.x.ai/v1/collections/collection_dbc087b1-6c99-493d-86c6-b401fee34a9d/documents/file_55a709d4-8edc-4f83-84d9-9f04fe49f832 \
-  -X DELETE \
-  -H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY"
-
-```
-
-Deleting a collection
-
-```bash
-curl https://management-api.x.ai/v1/collections/collection_dbc087b1-6c99-493d-86c6-b401fee34a9d \
-  -X DELETE \
-  -H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY"
-```

package/examples.bak.1774780058/ask_agent.js

@@ -1,114 +0,0 @@
-#!/usr/bin/env node
-import { AgentManager }  from '@j-o-r/hello-dave';
-import { parseArgs } from '@j-o-r/sh';
-
-const name = 'ask_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'
-});
-options.tools.push({
-	type: 'x_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: '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]
---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 = `
-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
-});
-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 = `
-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();
-
-await agent.start(serve, connect, cliIntro, "search_agent", description);

package/examples.bak.1774780058/code_agent.js

@@ -1,149 +0,0 @@
-#!/usr/bin/env node
-import { AgentManager } from '@j-o-r/hello-dave';
-import { parseArgs } from '@j-o-r/sh';
-
-const name = 'code_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']) { 
-	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-1-fast-reasoning';
-}
-// if (args['temperature']) {
-	options.temperature = 0.2;
-// }
-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'] : 'medium';
-if (reasoning) {
-	options.reasoning = {
-		// @ts-ignore
-		effort:reasoning,
-		summary: 'auto'
-	}
-}
-const toolsetMode = 'auto';
-const contextWindow = args['context'] ? parseInt(args['context']) : 2565000;
-
-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 [string] : model name 
---top_p [float]: number > 0, 0.1 means no top_p
---reasoning [low|medium|high]
---tools [javascript,bash,nushell,ssh] 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 agent = new AgentManager({ name, secret});
-const sys = (await agent.environment()).system;
-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 code execution and for writing and reading files, stay in the current working folder. Provide clear, step-by-step responses, examples, and ensure safety compliance.
----env
-\${sys}
----
-
-**MANDATORY MEMORY PROTOCOL (For EVERY query/task - NO EXCEPTIONS):**
-
-Connected clients (todo_agent, readme_agent, npm_agent, docs_agent, **memory_agent**) are available as tools. **ALWAYS** use **memory_agent** FIRST and LAST:
-
-1. **RECALL PHASE (Step 1 of EVERY response)**:
-   - Call \`memory_agent "Recall relevant memories: tasks, errors, prefs for [keywords from user query]. List recent if empty."\`
-   - Incorporate recalled info (e.g., avoid known errors, resume tasks, apply prefs like temp=0.2).
-
-2. **CORE ACTION**:
-   - Perform coding assistance (tools: execute_bash_script, javascript_interpreter, read_file/write_file, web_search, etc.).
-   - Delegate to specialists if relevant:
-     - todo_agent: Tasks/TODO.md
-     - readme_agent: README.md
-     - npm_agent: NPM modules/package.json
-     - docs_agent: Documentation
-     - memory_agent: Persistent storage
-
-3. **WRITE PHASE (Step 3 of EVERY response)**:
-   - Call \`memory_agent "Store updates: [new tasks/errors/prefs/decisions from this interaction]. E.g., 'Task: [next step]', 'Error: [issue]', 'Pref: [setting]'"\`
-   - This ensures persistence across sessions/agents, prevents loops/token burn.
-
-**EXAMPLE FLOW**:
-User: "Fix bug in main.js"
-- 1. memory_agent "Recall: tasks errors code bugs main.js"
-- 2. read_file main.js → analyze/fix → write_file
-- 3. memory_agent "Write: Task completed: fixed main.js bug. New task: add tests."
-
-**PRIORITIES**:
-- Safety: CWD-only, no escapes, validate before write.
-- Efficiency: Use memories to skip repeats (e.g., "Known error: git conflict → skip").
-- Step-by-step: Clear responses with code blocks.
-- Current date: March 27, 2026.
-
-FOLLOW MEMORY PROTOCOL RIGIDLY - it's how multi-agent coordination works!
-`.trim();
-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 addTools = (args['tools']) ? args['tools'].split(',') : [''];
-	if (addTools.includes('ssh')) {
-		agent.addGenericToolcall('execute_remote_script');
-	}
-}
-const cliIntro = `
-${name} ${options.model}
-- context: ${contextWindow}
-- **Memory Protocol ACTIVE**: Auto-recalls/writes via memory_agent for every query!
-`.trim();
-const description = `
-Main CodeServer hub: Coding expert + delegates to todo/readme/npm/docs/memory agents.
-ALWAYS uses memory_agent for persistent tasks/errors/prefs.
-`.trim();
-
-await agent.start(serve, connect, cliIntro, "code_agent", description);

package/examples.bak.1774780058/coderev_agent.js

@@ -1,72 +0,0 @@
-#!/usr/bin/env node
-import { AgentManager } from '@j-o-r/hello-dave';
-import { parseArgs } from '@j-o-r/sh';
-
-const name = 'coderev';  // ← REPLACE w/ lowercase /^[a-z_0-9_]{2,}$/
-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: [] };
-
-// NATIVES HERE e.g. options.tools.push({ type: 'web_search' });
-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']); } else { options.temperature = 0.8; }
-// tokens, top_p, reasoning...
-
-options.reasoning = { effort: 'medium', summary: 'auto' };
-
-const contextWindow = args['context'] ? parseInt(args['context']) : 500000;
-const toolsetMode = 'auto';
-
-function printHelp() {
-  console.log(`coderev --help: Git diff analyzer
-
-Full AgentManager modes (docs/agent-manager.md):
-
-USAGE:
-  ./bin/coderev             # Interactive CLI
-  echo "query" | ./bin/coderev  # One-shot pipe
-  ./bin/coderev --serve 8081    # WS Server: Expose as tool
-  ./bin/coderev --connect ws://host:8081/ws --secret KEY  # WS Client: Attach/gain tools
-  ./bin/coderev --serve 8081 --connect ws://other:8080/ws  # Hybrid
-
-OPTIONS: --model ... --secret ...
-
-EXAMPLES:
-  Test server: Start server, then client query above.
-  Chain: Server A --connect B → A calls B as tool.`);
-  process.exit();
-}
-
-if (help) printHelp();
-
-const prompt = `You are coderev, a Git diff analyzer.
-
-Analyze git diffs provided in queries, review code changes for bugs, improvements, best practices, security issues, and provide actionable suggestions. Use read_file to access specific files, execute_bash_script for git commands or other shell tasks, and web_search for looking up coding standards or references if needed. Be thorough, constructive, and reference specific lines in diffs when possible.
-
-Respond in a structured format: Summary, Issues Found, Suggestions, Overall Rating (1-10).`.trim();
-
-const agent = new AgentManager({ name, secret });
-agent.setup({ prompt, api, options, toolsetMode, contextWindow });
-
-// GENERICS HERE e.g. agent.addGenericToolcall('execute_bash_script');
-agent.addGenericToolcall('read_file');
-agent.addGenericToolcall('execute_bash_script');
-
-const cliIntro = `🤖 coderev ready! Modes: CLI/Server/Client (docs/agent-manager.md)
-
-I'm here to analyze your git diffs and code changes. Paste a diff or describe changes, and I'll review them step-by-step!`.trim();
-
-const toolName = 'agent_' + name;
-const toolDescription = `Git diff analyzer. Supports WS chaining.`.trim();
-
-await agent.start(serve, connect, cliIntro, toolName, toolDescription);