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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (112) hide show
  1. package/CHANGELOG.md +32 -0
  2. package/README.md +337 -68
  3. package/README.md.bak +523 -0
  4. package/README.md.bak.1774780058 +338 -0
  5. package/README.md.bak2 +531 -0
  6. package/bin/dave.js +33 -22
  7. package/bin/spawn_agent.js +293 -0
  8. package/docs.bak.1774780058/agent-manager.md +167 -0
  9. package/docs.bak.1774780058/agent-manager.md.bak +137 -0
  10. package/docs.bak.1774780058/agent-manager.md.bak2 +157 -0
  11. package/docs.bak.1774780058/codeserver-pattern.md +191 -0
  12. package/docs.bak.1774780058/path-resolution-best-practices.md +104 -0
  13. package/docs.bak.1774780058/project-overview.md +67 -0
  14. package/docs.bak.1774780058/project-overview.md.bak +67 -0
  15. package/docs.bak.1774780058/prompt-class.md +141 -0
  16. package/docs.bak.1774780058/prompt-class.md.bak +142 -0
  17. package/docs.bak.1774780058/tools-syntax-validation.md +121 -0
  18. package/docs.bak.1774780058/tools-syntax-validation.md.bak2 +125 -0
  19. package/docs.bak.1774780058/tools-syntax-validation.md.bak3 +125 -0
  20. package/docs.bak.1774780058/tools-syntax-validation.md.bak4 +106 -0
  21. package/docs.bak.1774780058/tools-syntax-validation.md.bak_path +106 -0
  22. package/docs.bak.1774780058/toolset.md +164 -0
  23. package/docs.bak.1774780058/toolset.md.bak +94 -0
  24. package/docs.bak.1774780058/toolset.md.bak3 +161 -0
  25. package/docs.bak.1774780058/toolset.md.bak4 +161 -0
  26. package/docs.bak.1774780058/toolset.md.bak5 +161 -0
  27. package/docs.bak.1774780058/toolset.md.bak6 +163 -0
  28. package/docs.bak.1774780058/toolset.md.bak_path +163 -0
  29. package/docs.bak.1774780058/toolset.md.bak_syntax +161 -0
  30. package/docs.bak.1774780058/xai-responses.md +111 -0
  31. package/docs.bak.1774780058/xai-responses.md.bak +107 -0
  32. package/docs.bak.1774780058/xai-responses.md.bak2 +107 -0
  33. package/docs.bak.1774780058/xai_collections.md +106 -0
  34. package/examples/ask_agent.js +137 -0
  35. package/examples/code_agent.js +149 -0
  36. package/examples/codeserver.sh +47 -0
  37. package/examples/daisy_agent.js +170 -0
  38. package/examples/docs_agent.js +148 -0
  39. package/examples/gpt_agent.js +122 -0
  40. package/examples/grok_agent.js +132 -0
  41. package/examples/memory_agent.js +152 -0
  42. package/examples/npm_agent.js +202 -0
  43. package/examples/prompt_agent.js +133 -0
  44. package/examples/readme_agent.js +148 -0
  45. package/examples/test_agent.js +187 -0
  46. package/examples/todo_agent.js +175 -0
  47. package/{examples/codeDave.js → examples.bak.1774780058/code_agent.js} +40 -6
  48. package/{examples/CodeServer → examples.bak.1774780058/codeserver.sh} +9 -5
  49. package/examples.bak.1774780058/memory_agent.js +112 -0
  50. package/{examples/spawndave.js → examples.bak.1774780058/spawn_agent.js} +29 -6
  51. package/examples.bak.1774780058/test_agent.js +162 -0
  52. package/{examples/todoDave.js → examples.bak.1774780058/todo_agent.js} +8 -2
  53. package/lib/API/x.ai/responses.js +7 -9
  54. package/lib/AgentManager.js +3 -2
  55. package/lib/AgentServer.js +23 -19
  56. package/lib/ToolSet.js +4 -1
  57. package/lib/genericToolset.js +159 -26
  58. package/lib/genericToolset.js.bak_syntax +402 -0
  59. package/lib/index.js +5 -1
  60. package/lib/wsCli.js +0 -1
  61. package/package.json +5 -6
  62. package/scenarios.bak.1774780058/data/eval_node_message.json +9 -0
  63. package/scenarios.bak.1774780058/data/hist_oa.json +66 -0
  64. package/scenarios.bak.1774780058/data/o3_response1.json +96 -0
  65. package/scenarios.bak.1774780058/data/oa_reasoning_parse.json +112 -0
  66. package/scenarios.bak.1774780058/data/tool_oa.json +96 -0
  67. package/scenarios.bak.1774780058/data/tool_xai.json +59 -0
  68. package/scenarios.bak.1774780058/data/tool_xai2.json +40 -0
  69. package/scenarios.bak.1774780058/data/xai-response-1.json +59 -0
  70. package/scenarios.bak.1774780058/data/xai-response-2.json +10 -0
  71. package/scenarios.bak.1774780058/data/xai_reasoning_tools_resp.json +59 -0
  72. package/scenarios.bak.1774780058/data/xai_search_response.json +58 -0
  73. package/scenarios.bak.1774780058/environment.js +10 -0
  74. package/scenarios.bak.1774780058/example.js +17 -0
  75. package/scenarios.bak.1774780058/genericToolset.test.js +182 -0
  76. package/scenarios.bak.1774780058/grok.js +113 -0
  77. package/scenarios.bak.1774780058/memory-tools.js +51 -0
  78. package/scenarios.bak.1774780058/openai-o3.js +137 -0
  79. package/scenarios.bak.1774780058/openai-prompt.js +155 -0
  80. package/scenarios.bak.1774780058/openai-session.js +148 -0
  81. package/scenarios.bak.1774780058/openai.js +102 -0
  82. package/scenarios.bak.1774780058/prompt.js +118 -0
  83. package/scenarios.bak.1774780058/promptFishbowl.js +76 -0
  84. package/scenarios.bak.1774780058/search.brave.com.js +25 -0
  85. package/scenarios.bak.1774780058/sh.js +15 -0
  86. package/scenarios.bak.1774780058/test-wsio.js +26 -0
  87. package/scenarios.bak.1774780058/testToolset.js +42 -0
  88. package/scenarios.bak.1774780058/toolset.js +16 -0
  89. package/scenarios.bak.1774780058/toolset.test.js +141 -0
  90. package/scenarios.bak.1774780058/write_file_syntax.test.js +145 -0
  91. package/scenarios.bak.1774780058/write_file_validation/README.md +30 -0
  92. package/scenarios.bak.1774780058/write_file_validation/bad.js +3 -0
  93. package/scenarios.bak.1774780058/write_file_validation/good.js +4 -0
  94. package/scenarios.bak.1774780058/write_file_validation/test.sh +43 -0
  95. package/scenarios.bak.1774780058/wsClient.js +69 -0
  96. package/scenarios.bak.1774780058/xai_responses.integration.test.js +57 -0
  97. package/scenarios.bak.1774780058/xai_responses.test.js +154 -0
  98. package/scenarios.bak.1774780058/xaicoll.js +50 -0
  99. package/scenarios.bak.1774780058/xaifiles.js +48 -0
  100. package/types/AgentManager.d.ts +4 -3
  101. package/types/index.d.ts +3 -1
  102. package/utils/syntax_check.sh +61 -0
  103. package/utils/test.sh +46 -0
  104. /package/{examples/askDave.js → examples.bak.1774780058/ask_agent.js} +0 -0
  105. /package/{examples/coderev.js → examples.bak.1774780058/coderev_agent.js} +0 -0
  106. /package/{examples/daisy.js → examples.bak.1774780058/daisy_agent.js} +0 -0
  107. /package/{examples/docsDave.js → examples.bak.1774780058/docs_agent.js} +0 -0
  108. /package/{examples/gpt.js → examples.bak.1774780058/gpt_agent.js} +0 -0
  109. /package/{examples/grok.js → examples.bak.1774780058/grok_agent.js} +0 -0
  110. /package/{examples/npmDave.js → examples.bak.1774780058/npm_agent.js} +0 -0
  111. /package/{examples/promptDave.js → examples.bak.1774780058/prompt_agent.js} +0 -0
  112. /package/{examples/readmeDave.js → examples.bak.1774780058/readme_agent.js} +0 -0
@@ -0,0 +1,133 @@
1
+ #!/usr/bin/env node
2
+ import { AgentManager } from '@j-o-r/hello-dave';
3
+ import { parseArgs } from '@j-o-r/sh';
4
+
5
+ const name = 'prompt_agent';
6
+ const api = 'xai';
7
+ let secret = '';
8
+
9
+ const args = parseArgs();
10
+
11
+ let input; // Directcall input (positional ONLY - NO pipe)
12
+ if (args._.length === 1 && typeof args._[0] === 'string' && args._[0].trim() !== '') {
13
+ input = args._[0].trim();
14
+ }
15
+
16
+ const help = args['help'] || false;
17
+ const connect = args['connect'] ? args['connect'] : undefined;
18
+ const serve = args['serve'] ? parseInt(args['serve']) : undefined;
19
+
20
+ /** @type {import('lib/API/x.ai/responses.js').XAIOptions} */
21
+ const options = { tools: [] };
22
+ options.tools.push({
23
+ type: 'web_search'
24
+ });
25
+
26
+ if (args['secret']) {
27
+ secret = args['secret'];
28
+ }
29
+ if (args['model'] || true) {
30
+ options.model = args['model'] || 'grok-4-fast-reasoning';
31
+ }
32
+ if (args['temperature']) {
33
+ options.temperature = parseFloat(args['temperature']);
34
+ }
35
+ if (args['tokens']) {
36
+ options.max_output_tokens = parseInt(args['tokens']);
37
+ }
38
+ if (args['top_p']) {
39
+ options.top_p = parseFloat(args['top_p']);
40
+ }
41
+ const reasoning = true;
42
+ if (reasoning) {
43
+ options.reasoning = {
44
+ effort: 'medium',
45
+ summary: 'auto'
46
+ }
47
+ }
48
+ const toolsetMode = 'auto';
49
+ const contextWindow = args['context'] ? parseInt(args['context']) : 250000;
50
+
51
+ function printHelp() {
52
+ console.log(`'${name} --help' You are looking at it.
53
+
54
+ ## USAGE MODES:
55
+
56
+ ### 1. Direct Call (One-Shot, Positional ONLY):
57
+ ./examples/${name}.js "Optimize this prompt: [prompt]" [--options]
58
+
59
+ ### 2. Interactive CLI (no positional arg):
60
+ ./examples/${name}.js [--options]
61
+
62
+ ### 3. WS Server (no positional arg):
63
+ ./examples/${name}.js --serve 8080 [--secret mysecret] [--options]
64
+
65
+ ### 4. WS Client (no positional arg):
66
+ ./examples/${name}.js --connect ws://127.0.0.1:8080/ws --secret mysecret [--options]
67
+
68
+ ### 5. Hybrid (Server + Client, no positional arg):
69
+ ./examples/${name}.js --serve 8081 --connect ws://other:8080/ws [--secret ...] [--options]
70
+
71
+ ## SERVER OPTIONS EXPLAINED:
72
+ --serve [port]: Starts WebSocket SERVER at ws://127.0.0.1:[port]/ws. Allows other agents (--connect) to connect and use this agent as a remote TOOL (e.g., 'prompt_agent'). Runs indefinitely until Ctrl+C.
73
+
74
+ --connect [ws_url]: Connects as CLIENT to remote WS server at [ws_url] (e.g., ws://127.0.0.1:8080/ws). Gains access to remote agent's tools. Interactive CLI available.
75
+
76
+ --secret [string]: SHARED AUTH TOKEN (min 3 chars). SERVER rejects clients without matching --secret. CLIENTS must provide server's secret to connect. Use same secret for chains.
77
+
78
+ Note: Server/Client/Hybrid IGNORES positional input arg (use CLI modes instead). Hybrid: This agent serves AND uses remote tools.
79
+
80
+ ## OPTIONS:
81
+ --model [grok-4-fast-reasoning|...] (default: grok-4-fast-reasoning)
82
+ --temperature [float] (-2 to +2)
83
+ --tokens [number] (max output tokens)
84
+ --top_p [float]
85
+ --context [number] (default: 250000)
86
+
87
+ ## SERVER TOOLS (when no input):
88
+ Exposes as 'prompt_agent' tool for chaining.
89
+ `);
90
+ process.exit();
91
+ }
92
+
93
+ if (help) {
94
+ printHelp();
95
+ }
96
+
97
+ const tool_call_name = 'prompt_agent';
98
+ const tool_call_description = `Prompt optimizer. Analyzes prompts for clarity, brevity, ethics, token efficiency. Approves good ones or rewrites with summary/questions.`.trim();
99
+
100
+ const prompt = `**CRITICAL: STRICT NO-CODING RULE** - Stick to prompt optimization ONLY. NEVER:
101
+ - Use execute_bash_script, javascript_interpreter, write_file, read_file, syntax_check.
102
+ - Generate, execute, or edit code.
103
+ If asked to code, decline: "For code tasks, use code_agent.js. I optimize prompts only."
104
+
105
+ 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.
106
+
107
+ Current date: April 01, 2026.`.trim();
108
+
109
+ const agent = new AgentManager({ name, secret });
110
+ agent.setup({
111
+ prompt,
112
+ api,
113
+ options,
114
+ toolsetMode,
115
+ contextWindow
116
+ });
117
+ const toolset = agent.getToolset();
118
+ if (toolset) {
119
+ agent.addGenericToolcall('history_search');
120
+ agent.addGenericToolcall('open_link');
121
+ agent.addGenericToolcall('send_email');
122
+ // Removed execute_bash_script and javascript_interpreter for NO-CODING compliance
123
+ }
124
+ const cliIntro = `${name} ${options.model}.
125
+ - context: ${contextWindow}.
126
+ ${tool_call_name}`.trim();
127
+
128
+ if (input) {
129
+ const RES = await agent.directCall(input);
130
+ console.log(RES);
131
+ } else {
132
+ await agent.start(serve, connect, cliIntro, tool_call_name, tool_call_description);
133
+ }
@@ -0,0 +1,148 @@
1
+ #!/usr/bin/env node
2
+ import { AgentManager } from '@j-o-r/hello-dave';
3
+ import { parseArgs, readIn } from '@j-o-r/sh';
4
+
5
+ const name = 'readme_agent';
6
+ const api = 'xai';
7
+ let secret = '';
8
+
9
+ const args = parseArgs();
10
+ const help = args['help'] || false;
11
+ const connect = args['connect'] ? args['connect'] : undefined;
12
+ const serve = args['serve'] ? parseInt(args['serve']) : undefined;
13
+
14
+ /** @type {import('lib/API/x.ai/responses.js').XAIOptions} */
15
+ const options = { tools : []};
16
+ options.tools.push({
17
+ type: 'web_search'
18
+ });
19
+ if (args['secret']) { // model gets default value
20
+ secret = args['secret'];
21
+ }
22
+ // Set properties only if provided via command line (except model which has default)
23
+ if (args['model'] || true) { // model gets default value
24
+ // @ts-ignore
25
+ options.model = args['model'] || 'grok-4-fast-reasoning';
26
+ }
27
+ if (args['temperature']) {
28
+ options.temperature = parseFloat(args['temperature']);
29
+ }
30
+ if (args['tokens']) {
31
+ options.max_output_tokens = parseInt(args['tokens']);
32
+ }
33
+ if (args['top_p']) {
34
+ options.top_p = parseFloat(args['top_p']);
35
+ }
36
+ const reasoning = args['reasoning'] ? args['reasoning'] : null;
37
+ if (reasoning) {
38
+ options.reasoning = {
39
+ // @ts-ignore
40
+ effort: reasoning,
41
+ summary: 'auto'
42
+ }
43
+ }
44
+
45
+ const toolsetMode = 'auto';
46
+ const contextWindow = args['context'] ? parseInt(args['context']) : 250000;
47
+
48
+ // Copy from the generic toolset
49
+ function printHelp() {
50
+ console.log(`
51
+ '${name} --help' You are looking at it.
52
+
53
+ OPTIONS:
54
+ --tokens [number]: max generated tokens
55
+ --context [number] : truncate message history to context-windows size default 130000
56
+ --temperature [float] : -2 / +2
57
+ --model [grok-4|grok-3|grok-3-mini|grok-3-mini-fast|grok-code-fast-1]
58
+ --top_p [float]: number > 0, 0.1 means no top_p
59
+ --reasoning [low|high]
60
+ --tools [javascript,bash] comma seperated list
61
+
62
+ SERVER TOOLS:
63
+ --serve [number]: create a Agent server on port number ws://127.0.0.1:[serve]/ws
64
+ --connect [url]: connect to a Server Agent e.g ws://127.0.0.1:8080/ws (https://my.domain/ws) ...
65
+ --secret [string] : limit access to websocket server with a secret
66
+ `);
67
+ process.exit()
68
+ }
69
+
70
+ if (help) {
71
+ printHelp();
72
+ }
73
+
74
+ const tool_call_description = `
75
+ Project README manager. Maintains README.md with comprehensive project documentation.
76
+ Inspects current README.md, updates sections (installation, usage, etc.), generates content based on project files and user input.
77
+ Suggests improvements, adds badges, TOC, etc.
78
+ `.trim();
79
+ const tool_call_name = 'readme_agent';
80
+ const prompt = `
81
+ You are an expert README.md manager for this project. README.md should follow best practices with sections like:
82
+
83
+ # Project Title
84
+ ![Badges]
85
+
86
+ ## Table of Contents
87
+
88
+ ## Description
89
+ ## Features
90
+ ## Installation
91
+ ## Usage
92
+ ## Examples
93
+ ## Development
94
+ ## Contributing
95
+ ## License
96
+
97
+ **CRITICAL: STRICT NO-CODING RULE** - Stick to README management ONLY. NEVER:
98
+ - Use coding tools (e.g., javascript_interpreter, read_file, write_file, syntax_check, npm_module_inspector).
99
+ - Generate, execute, or edit code (JS/Python/Bash beyond safe README ops).
100
+ - Misuse bash for anything beyond safe README.md ops (e.g., cat README.md, echo > README.md, cp README.md README.md.bak, ls, git status).
101
+ If asked to code or edit non-README files, decline: "For coding or other tasks, use specialized agents like code_agent. I'll handle README.md only."
102
+
103
+ ALWAYS:
104
+
105
+ 1. Inspect the current README.md if it exists (use \`cat README.md\` or similar).
106
+
107
+ 2. Inspect key project files safely: \`cat package.json\`, \`ls -la\`, \`ls bin/\`, \`ls lib/\`, \`git status\`, etc.
108
+
109
+ 3. Understand the user input:
110
+ - "add installation instructions"
111
+ - "generate usage examples"
112
+ - "add table of contents"
113
+ - "update description to: ..."
114
+ - "suggest improvements"
115
+ - "include npm badges"
116
+ - "make it more professional"
117
+
118
+ 4. Update README.md with changes. Ensure excellent Markdown formatting, accuracy based on project. Backup first if overwriting: \`cp README.md README.md.bak\`.
119
+
120
+ 5. Write the FULL updated content to ./README.md using safe bash (e.g., echo "content" > README.md).
121
+
122
+ 6. In your response, summarize:
123
+ - Changes made
124
+ - Preview of key sections (e.g., first 20 lines)
125
+ - Any suggestions for further enhancements
126
+
127
+ 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.
128
+
129
+ Use execute_bash_script ONLY for safe README ops and inspections. Use web_search for best practices if needed.
130
+ `.trim();
131
+ const agent = new AgentManager({ name, secret });
132
+ agent.setup({
133
+ prompt,
134
+ api,
135
+ options,
136
+ toolsetMode,
137
+ contextWindow
138
+ });
139
+ const toolset = agent.getToolset();
140
+ if (toolset) {
141
+ agent.addGenericToolcall('execute_bash_script');
142
+ }
143
+ const cliIntro = `
144
+ ${name} ${options.model}.
145
+ - context: ${contextWindow}
146
+ `.trim();
147
+
148
+ await agent.start(serve, connect, cliIntro, tool_call_name, tool_call_description);
@@ -0,0 +1,187 @@
1
+ #!/usr/bin/env node
2
+ import { AgentManager } from '@j-o-r/hello-dave';
3
+ import { parseArgs } from '@j-o-r/sh';
4
+
5
+ const name = 'test_agent';
6
+ const api = 'xai';
7
+ let secret = '';
8
+
9
+ const args = parseArgs();
10
+
11
+ let input; // Directcall input (positional ONLY - NO pipe)
12
+ if (args._.length === 1 && typeof args._[0] === 'string' && args._[0].trim() !== '') {
13
+ input = args._[0].trim();
14
+ }
15
+
16
+ const help = args['help'] || false;
17
+ const connect = args['connect'] ? args['connect'] : undefined;
18
+ const serve = args['serve'] ? parseInt(args['serve']) : undefined;
19
+
20
+ /** @type {import('lib/API/x.ai/responses.js').XAIOptions} */
21
+ const options = { tools: [] };
22
+ options.tools.push({
23
+ type: 'web_search'
24
+ });
25
+
26
+ if (args['secret']) {
27
+ secret = args['secret'];
28
+ }
29
+ if (args['model'] || true) {
30
+ options.model = args['model'] || 'grok-4-fast-reasoning';
31
+ }
32
+ if (args['temperature']) {
33
+ options.temperature = parseFloat(args['temperature']);
34
+ }
35
+ if (args['tokens']) {
36
+ options.max_output_tokens = parseInt(args['tokens']);
37
+ }
38
+ if (args['top_p']) {
39
+ options.top_p = parseFloat(args['top_p']);
40
+ }
41
+ const reasoning = true;
42
+ if (reasoning) {
43
+ options.reasoning = {
44
+ effort: 'medium',
45
+ summary: 'auto'
46
+ }
47
+ }
48
+ const toolsetMode = 'auto';
49
+ const contextWindow = args['context'] ? parseInt(args['context']) : 250000;
50
+
51
+ function printHelp() {
52
+ console.log(`
53
+ '${name} --help' You are looking at it.
54
+
55
+ ## USAGE MODES:
56
+
57
+ ### 1. Direct Call (One-Shot, Positional ONLY):
58
+ ./examples/${name}.js "Generate test for toolset.js" [--options]
59
+
60
+ ### 2. Interactive CLI (no positional arg):
61
+ ./examples/${name}.js [--options]
62
+
63
+ ### 3. WS Server (no positional arg):
64
+ ./examples/${name}.js --serve 8080 [--secret mysecret] [--options]
65
+
66
+ ### 4. WS Client (no positional arg):
67
+ ./examples/${name}.js --connect ws://127.0.0.1:8080/ws --secret mysecret [--options]
68
+
69
+ ### 5. Hybrid (Server + Client, no positional arg):
70
+ ./examples/${name}.js --serve 8081 --connect ws://other:8080/ws [--secret ...] [--options]
71
+
72
+ ## SERVER OPTIONS EXPLAINED:
73
+ --serve [port]: Starts WebSocket SERVER at ws://127.0.0.1:[port]/ws. Allows other agents (--connect) to connect and use this agent as a remote TOOL (e.g., 'test_agent'). Runs indefinitely until Ctrl+C.
74
+
75
+ --connect [ws_url]: Connects as CLIENT to remote WS server at [ws_url] (e.g., ws://127.0.0.1:8080/ws). Gains access to remote agent's tools. Interactive CLI available.
76
+
77
+ --secret [string]: SHARED AUTH TOKEN (min 3 chars). SERVER rejects clients without matching --secret. CLIENTS must provide server's secret to connect. Use same secret for chains.
78
+
79
+ Note: Server/Client/Hybrid IGNORES positional input arg (use CLI modes instead). Hybrid: This agent serves AND uses remote tools.
80
+
81
+ ## OPTIONS:
82
+ --model [grok-4-fast-reasoning|...] (default: grok-4-fast-reasoning)
83
+ --temperature [float] (-2 to +2)
84
+ --tokens [number] (max output tokens)
85
+ --top_p [float]
86
+ --context [number] (default: 250000)
87
+
88
+ ## SERVER TOOLS (when no input):
89
+ Exposes as 'test_agent' tool for chaining.
90
+ `);
91
+ process.exit()
92
+ }
93
+
94
+ if (help) {
95
+ printHelp();
96
+ }
97
+
98
+ const tool_call_name = 'test_agent';
99
+ const tool_call_description = `
100
+ TestDave: Generates executable tests (Test class) for project files/utils/agents in ./scenarios/*.test.js.
101
+ Uses memories, delegates to code/npm/etc. agents.
102
+ `.trim();
103
+
104
+ const prompt = `You are TestAgent, the specialized testing agent for CodeServer projects. Your sole responsibility is to create, manage, and execute tests using the lightweight 'Test' class from '@j-o-r/sh' (already installed).
105
+
106
+ **CORE MISSION**:
107
+ - Write executable test scripts in ./scenarios/ folder with the extension *.test.js (e.g., scenarios/toolset.test.js).
108
+ - Tests must use: \`import { Test, assert, jsType } from '@j-o-r/sh';\`
109
+ - Structure: shebang \`#!/usr/bin/env node\`, fluent Test API (\`const t = new Test(); t.add('desc', () => { assert... }); await t.run();\`), exit(1) on errors.
110
+ - After write_file to scenarios/MODULE.test.js, ensure executable: \`chmod +x scenarios/MODULE.test.js\`
111
+ - Leverage project utilities: test existing files (examples/*.js, toolset.js, agents, SH commands, etc.) using read_file, execute_bash_script (ls/cat), npm_module_inspector.
112
+
113
+ **WHAT TO TEST** (discover dynamically):
114
+ 1. Project scripts: e.g., parseArgs, AgentManager flows, toolsets.
115
+ 2. Utilities: SH commands, async hooks, promise tracking.
116
+ 3. Agents: code_agent, npm_agent, memory_agent integrations.
117
+ 4. Existing: genericToolset.test.js patterns, sh.js, etc.
118
+ - Query: "Write test for toolset.js" → read_file toolset.js → generate scenarios/toolset.test.js.
119
+
120
+ **Test Example** (from @j-o-r/sh docs):
121
+ \`\`\`
122
+ #!/usr/bin/env node
123
+ import { Test, assert, jsType } from '@j-o-r/sh';
124
+
125
+ const t = new Test();
126
+ t.add('Basic assert', () => assert.strictEqual(1 + 1, 2));
127
+ t.add('Type check', () => assert.strictEqual(jsType([]), 'Array'));
128
+ t.add('Async test', async () => {
129
+ const p = Promise.resolve('ok');
130
+ assert.strictEqual(await p, 'ok');
131
+ });
132
+ const report = await t.run();
133
+ process.exit(report.errors > 0 ? 1 : 0);
134
+ \`\`\`
135
+
136
+ **WORKFLOW** (per user request, e.g., "test parseArgs"):
137
+ 1. Recall memories (tasks/errors for testing).
138
+ 2. Inspect target: read_file, execute_bash_script \`ls lib/\`, npm_module_inspector.
139
+ 3. Generate test: Plan tests (coverage: happy path, errors, async), write to scenarios/{target}.test.js (e.g., scenarios/parseArgs.test.js).
140
+ 4. Validate: execute_bash_script \`node scenarios/{target}.test.js\` or \`./scenarios/{target}.test.js\`.
141
+ 5. Report results, store outcomes.
142
+
143
+ **MANDATORY MEMORY PROTOCOL** (ALWAYS FIRST/LAST):
144
+ 1. RECALL: memory_agent "Recall relevant memories: tasks, errors, prefs for [test target, e.g., toolset.js]."
145
+ 2. CORE: Write/Run tests in scenarios/*.test.js.
146
+ 3. WRITE: memory_agent "Store updates: Task: [next test], Error: [test fail], Pref: [coverage style]."
147
+
148
+ **PRIORITIES**:
149
+ - Safety: CWD-only, validate syntax before write (write_file auto-checks).
150
+ - Coverage: assertions (strictEqual, ok, throws), types (jsType), async (promises).
151
+ - Executable: shebang + chmod +x scenarios/*.test.js.
152
+ - Reuse: Import project utils (e.g., import {parseArgs} from './toolset.js').
153
+ - Current date: April 01, 2026.
154
+
155
+ FOLLOW RIGIDLY: Memory first/last, scenarios/*.test.js only, Test class exclusively.
156
+ `.trim();
157
+
158
+ const agent = new AgentManager({ name, secret });
159
+ agent.setup({
160
+ prompt,
161
+ api,
162
+ options,
163
+ toolsetMode,
164
+ contextWindow
165
+ });
166
+ const toolset = agent.getToolset();
167
+ if (toolset) {
168
+ agent.addGenericToolcall('history_search');
169
+ agent.addGenericToolcall('memory_recall');
170
+ agent.addGenericToolcall('memory_write');
171
+ agent.addGenericToolcall('javascript_interpreter');
172
+ agent.addGenericToolcall('execute_bash_script');
173
+ agent.addGenericToolcall('read_file');
174
+ agent.addGenericToolcall('write_file');
175
+ }
176
+ const cliIntro = `
177
+ ${name} ${options.model}.
178
+ - context: ${contextWindow}.
179
+ ${tool_call_name}
180
+ `.trim();
181
+
182
+ if (input) {
183
+ const RES = await agent.directCall(input);
184
+ console.log(RES);
185
+ } else {
186
+ await agent.start(serve, connect, cliIntro, tool_call_name, tool_call_description);
187
+ }
@@ -0,0 +1,175 @@
1
+ #!/usr/bin/env node
2
+ import { AgentManager } from '@j-o-r/hello-dave';
3
+ import { parseArgs } from '@j-o-r/sh';
4
+
5
+ const name = 'todo_agent';
6
+ const api = 'xai';
7
+ let secret = '';
8
+
9
+ const args = parseArgs();
10
+
11
+ let input; // Directcall input (positional ONLY - NO pipe)
12
+ if (args._.length === 1 && typeof args._[0] === 'string' && args._[0].trim() !== '') {
13
+ input = args._[0].trim();
14
+ }
15
+
16
+ const help = args['help'] || false;
17
+ const connect = args['connect'] ? args['connect'] : undefined;
18
+ const serve = args['serve'] ? parseInt(args['serve']) : undefined;
19
+
20
+ /** @type {import('lib/API/x.ai/responses.js').XAIOptions} */
21
+ const options = { tools: [] };
22
+ options.tools.push({
23
+ type: 'web_search'
24
+ });
25
+
26
+ if (args['secret']) {
27
+ secret = args['secret'];
28
+ }
29
+ if (args['model'] || true) {
30
+ options.model = args['model'] || 'grok-4-fast-reasoning';
31
+ }
32
+ if (args['temperature']) {
33
+ options.temperature = parseFloat(args['temperature']);
34
+ }
35
+ if (args['tokens']) {
36
+ options.max_output_tokens = parseInt(args['tokens']);
37
+ }
38
+ if (args['top_p']) {
39
+ options.top_p = parseFloat(args['top_p']);
40
+ }
41
+ const reasoning = true;
42
+ if (reasoning) {
43
+ options.reasoning = {
44
+ effort: 'medium',
45
+ summary: 'auto'
46
+ }
47
+ }
48
+ const toolsetMode = 'auto';
49
+ const contextWindow = args['context'] ? parseInt(args['context']) : 250000;
50
+
51
+ function printHelp() {
52
+ console.log(`
53
+ '${name} --help' You are looking at it.
54
+
55
+ ## USAGE MODES:
56
+
57
+ ### 1. Direct Call (One-Shot, Positional ONLY):
58
+ ./examples/${name}.js "List tasks" [--options]
59
+
60
+ ### 2. Interactive CLI (no positional arg):
61
+ ./examples/${name}.js [--options]
62
+
63
+ ### 3. WS Server (no positional arg):
64
+ ./examples/${name}.js --serve 8080 [--secret mysecret] [--options]
65
+
66
+ ### 4. WS Client (no positional arg):
67
+ ./examples/${name}.js --connect ws://127.0.0.1:8080/ws --secret mysecret [--options]
68
+
69
+ ### 5. Hybrid (Server + Client, no positional arg):
70
+ ./examples/${name}.js --serve 8081 --connect ws://other:8080/ws [--secret ...] [--options]
71
+
72
+ ## SERVER OPTIONS EXPLAINED:
73
+ --serve [port]: Starts WebSocket SERVER at ws://127.0.0.1:[port]/ws. Allows other agents (--connect) to connect and use this agent as a remote TOOL (e.g., 'todo_agent'). Runs indefinitely until Ctrl+C.
74
+
75
+ --connect [ws_url]: Connects as CLIENT to remote WS server at [ws_url] (e.g., ws://127.0.0.1:8080/ws). Gains access to remote agent's tools. Interactive CLI available.
76
+
77
+ --secret [string]: SHARED AUTH TOKEN (min 3 chars). SERVER rejects clients without matching --secret. CLIENTS must provide server's secret to connect. Use same secret for chains.
78
+
79
+ Note: Server/Client/Hybrid IGNORES positional input arg (use CLI modes instead). Hybrid: This agent serves AND uses remote tools.
80
+
81
+ ## OPTIONS:
82
+ --model [grok-4-fast-reasoning|...] (default: grok-4-fast-reasoning)
83
+ --temperature [float] (-2 to +2)
84
+ --tokens [number] (max output tokens)
85
+ --top_p [float]
86
+ --context [number] (default: 250000)
87
+
88
+ ## SERVER TOOLS (when no input):
89
+ Exposes as 'todo_agent' tool for chaining.
90
+ `);
91
+ process.exit()
92
+ }
93
+
94
+ if (help) {
95
+ printHelp();
96
+ }
97
+
98
+ const tool_call_name = 'todo_agent';
99
+ const tool_call_description = `
100
+ Project TODO list manager. Maintains TODO.md with tasks in Markdown checklists.
101
+ Inspects current TODO.md, adds/checks/completes tasks based on input, updates the file.
102
+ Suggests next actions, stores future important tasks.
103
+ `.trim();
104
+
105
+ const prompt = `
106
+ You are an expert TODO manager for this project. TODO.md stores tasks in Markdown format with checklists:
107
+
108
+ ## TODO (high priority pending)
109
+ - [ ] Task 1
110
+
111
+ ## In Progress
112
+ - [ ] Task 2
113
+
114
+ ## Later (future tasks)
115
+ - [ ] Important task to do later
116
+
117
+ ## Done
118
+ - [x] Completed task
119
+
120
+ **CRITICAL: STRICT NO-CODING RULE** - Stick to TODO management ONLY. NEVER:
121
+ - Use coding tools (e.g., javascript_interpreter, write_file, read_file, syntax_check).
122
+ - Generate, execute, or edit code.
123
+ - Misuse bash for anything beyond safe TODO.md ops (e.g., cat TODO.md, echo > TODO.md).
124
+ If asked to code, decline: "For coding, use other agents. I'll handle TODOs only."
125
+ Delegate complex tasks via suggestions; use memory_agent if available for persistence.
126
+
127
+ ALWAYS:
128
+
129
+ 1. Inspect the current TODO.md file if it exists (use \`cat TODO.md\` or similar).
130
+
131
+ 2. Understand the user input:
132
+ - Add new tasks: "add task: Fix bug in foo.js"
133
+ - Complete: "done: task X" or mark specific
134
+ - Check status: "status" or "what's next?"
135
+ - Prioritize/reorganize
136
+ - Archive old done tasks if too many
137
+
138
+ 3. Update TODO.md with changes. Keep it organized, add dates if useful (e.g., - [ ] 2026-02-24: Task).
139
+
140
+ 4. Write the FULL updated content to ./TODO.md.
141
+
142
+ 5. In your response, summarize:
143
+ - Current status (pending count, next suggested)
144
+ - Changes made
145
+ - Updated TODO.md preview (first 10 lines or key sections)
146
+
147
+ If no TODO.md, create one inspecting the project (package.json, README.md, git status) for initial tasks like "Review code", "Add tests", etc.
148
+
149
+ Use tools to inspect files as needed (ls, cat, git log, etc.).
150
+ `.trim();
151
+
152
+ const agent = new AgentManager({ name, secret });
153
+ agent.setup({
154
+ prompt,
155
+ api,
156
+ options,
157
+ toolsetMode,
158
+ contextWindow
159
+ });
160
+ const toolset = agent.getToolset();
161
+ if (toolset) {
162
+ agent.addGenericToolcall('execute_bash_script');
163
+ }
164
+ const cliIntro = `
165
+ ${name} ${options.model}.
166
+ - context: ${contextWindow}. TODO manager ready.
167
+ ${tool_call_name}
168
+ `.trim();
169
+
170
+ if (input) {
171
+ const RES = await agent.directCall(input);
172
+ console.log(RES);
173
+ } else {
174
+ await agent.start(serve, connect, cliIntro, tool_call_name, tool_call_description);
175
+ }