@ducci/jarvis 1.0.18 → 1.0.20

package/docs/system-prompt.md

@@ -53,6 +53,14 @@ The `exec` tool runs real shell commands on the server. Use it responsibly:
 - **Prefer targeted reads.** Use `grep`, `head`, or `tail` instead of `cat` on files you haven't seen before. Large file output is truncated anyway — a targeted command gives you better signal.
 - **Avoid commands with unbounded runtime.** If a command could run indefinitely or scan an unknown-size tree, scope it first.
 
+## Tool Creation
+
+When building a custom tool with `save_tool`:
+
+- **Prefer npm packages** over reimplementing functionality from scratch. If a well-known package exists for the task (e.g. an API SDK, a parser, a utility library), use it.
+- **Installing an npm package**: use the `npm_install` tool — it handles the correct install directory automatically. Then create the tool with `save_tool`. The tool code can `require('<package-name>')` directly.
+- **Available bindings in tool code**: `args`, `fs`, `path`, `process`, `require`, `__jarvisDir` (absolute path to the jarvis server directory).
+
 ## logSummary Guidelines
 
 The `logSummary` is written for a human observer, not for the user. It must:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ducci/jarvis",
-  "version": "1.0.18",
+  "version": "1.0.20",
   "description": "A fully automated agent system that lives on a server.",
   "main": "./src/index.js",
   "type": "module",

package/src/server/tools.js

@@ -1,9 +1,11 @@
 import fs from 'fs';
 import { createRequire } from 'module';
 import path from 'path';
+import { fileURLToPath } from 'url';
 import { PATHS } from './config.js';
 
 const _require = createRequire(import.meta.url);
+const __jarvisDir = path.dirname(fileURLToPath(import.meta.url));
 const AsyncFunction = Object.getPrototypeOf(async function () {}).constructor;
 
 const TOOL_TIMEOUT_MS = 60_000;
@@ -122,7 +124,7 @@ const SEED_TOOLS = {
       type: 'function',
       function: {
         name: 'save_tool',
-        description: 'Create or update a custom tool and make it available immediately in this session. Use this to build reusable JS tools for tasks you repeat. The tool code runs in Node.js and has access to: args, fs, path, process, require.',
+        description: 'Create or update a custom tool and make it available immediately in this session. Use this to build reusable JS tools for tasks you repeat. The tool code runs in Node.js and has access to: args, fs, path, process, require, __jarvisDir. To update an existing tool, first call get_tool to read its current code and parameters, then call save_tool with your modifications.',
         parameters: {
           type: 'object',
           properties: {
@@ -140,7 +142,7 @@ const SEED_TOOLS = {
             },
             code: {
               type: 'string',
-              description: 'The body of an async function. Must end with a return statement — the returned value becomes the tool result. Available bindings: args (your tool parameters), fs (node:fs), path (node:path), process, require. Do NOT wrap in a function declaration. Example: const raw = await fs.promises.readFile(args.filePath, "utf8"); const data = JSON.parse(raw); return { count: data.length, first: data[0] };',
+              description: 'The body of an async function. Must end with a return statement — the returned value becomes the tool result. Available bindings: args (your tool parameters), fs (node:fs), path (node:path), process, require, __jarvisDir (absolute path to the jarvis server directory — use path.resolve(__jarvisDir, "../..") to get the project root for npm installs). Do NOT wrap in a function declaration. Example: const raw = await fs.promises.readFile(args.filePath, "utf8"); const data = JSON.parse(raw); return { count: data.length, first: data[0] };',
             },
           },
           required: ['name', 'description', 'parameters', 'code'],
@@ -149,6 +151,26 @@ const SEED_TOOLS = {
     },
     code: `const toolsFile = path.join(process.env.HOME, '.jarvis/data/tools/tools.json'); const raw = await fs.promises.readFile(toolsFile, 'utf8').catch(() => '{}'); const tools = JSON.parse(raw); tools[args.name] = { definition: { type: 'function', function: { name: args.name, description: args.description, parameters: args.parameters } }, code: args.code }; await fs.promises.writeFile(toolsFile, JSON.stringify(tools, null, 2), 'utf8'); return { status: 'ok', saved: args.name };`,
   },
+  get_tool: {
+    definition: {
+      type: 'function',
+      function: {
+        name: 'get_tool',
+        description: 'Read the full definition and code of a single tool by name. Use this before updating an existing tool so you understand its current implementation.',
+        parameters: {
+          type: 'object',
+          properties: {
+            name: {
+              type: 'string',
+              description: 'The tool name to retrieve.',
+            },
+          },
+          required: ['name'],
+        },
+      },
+    },
+    code: `const toolsFile = path.join(process.env.HOME, '.jarvis/data/tools/tools.json'); const raw = await fs.promises.readFile(toolsFile, 'utf8').catch(() => '{}'); const tools = JSON.parse(raw); const tool = tools[args.name]; if (!tool) return { status: 'not_found', name: args.name }; return { status: 'ok', name: args.name, definition: tool.definition, code: tool.code };`,
+  },
   list_tools: {
     definition: {
       type: 'function',
@@ -164,6 +186,41 @@ const SEED_TOOLS = {
     },
     code: `const toolsFile = path.join(process.env.HOME, '.jarvis/data/tools/tools.json'); const raw = await fs.promises.readFile(toolsFile, 'utf8').catch(() => '{}'); const tools = JSON.parse(raw); const list = Object.entries(tools).map(([name, t]) => ({ name, description: t.definition.function.description })); return { status: 'ok', tools: list };`,
   },
+  npm_install: {
+    definition: {
+      type: 'function',
+      function: {
+        name: 'npm_install',
+        description: 'Install an npm package into the jarvis project so it can be used in tool code via require(). Always use this instead of exec to install packages.',
+        parameters: {
+          type: 'object',
+          properties: {
+            packageName: {
+              type: 'string',
+              description: 'The npm package name to install, e.g. "@perplexity-ai/sdk" or "axios".',
+            },
+          },
+          required: ['packageName'],
+        },
+      },
+    },
+    code: `
+      const { exec } = require('child_process');
+      const { promisify } = require('util');
+      const execAsync = promisify(exec);
+      const projectRoot = path.resolve(__jarvisDir, '../..');
+      try {
+        const { stdout, stderr } = await execAsync('npm install ' + args.packageName, {
+          cwd: projectRoot,
+          encoding: 'utf8',
+          timeout: 60000,
+        });
+        return { status: 'ok', packageName: args.packageName, stdout, stderr };
+      } catch (e) {
+        return { status: 'error', packageName: args.packageName, stderr: e.stderr || e.message };
+      }
+    `,
+  },
   get_recent_sessions: {
     definition: {
       type: 'function',
@@ -255,7 +312,7 @@ export async function executeTool(tools, name, toolArgs) {
     throw new Error(`Unknown tool: ${name}`);
   }
 
-  const fn = new AsyncFunction('args', 'fs', 'path', 'process', 'require', tool.code);
+  const fn = new AsyncFunction('args', 'fs', 'path', 'process', 'require', '__jarvisDir', tool.code);
 
   const timeout = new Promise((_, reject) =>
     setTimeout(
@@ -264,5 +321,5 @@ export async function executeTool(tools, name, toolArgs) {
     )
   );
 
-  return await Promise.race([fn(toolArgs, fs, path, process, _require), timeout]);
+  return await Promise.race([fn(toolArgs, fs, path, process, _require, __jarvisDir), timeout]);
 }