@miruzero/zero-agent 0.3.2 → 0.3.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miruzero/zero-agent",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "MiruZero local worker agent for multi-device tool execution.",
   "type": "commonjs",
   "bin": {

package/src/autostart.js

@@ -35,10 +35,12 @@ const paths = (env = process.env) => {
 };
 
 const packageSpec = () => pkg.name + '@' + pkg.version;
+const packageBin = () => path.join(__dirname, '..', 'bin', 'zero-agent.js');
 
 const launcherContent = ({ interval = DEFAULT_INTERVAL, roots, logFile }, env = process.env) => {
   const home = config.agentHome(env);
   const spec = packageSpec();
+  const bin = packageBin();
   return [
     '@echo off',
     'setlocal',
@@ -49,7 +51,7 @@ const launcherContent = ({ interval = DEFAULT_INTERVAL, roots, logFile }, env =
     'rem interval=' + Number(interval || DEFAULT_INTERVAL) + 'ms',
     'if not exist ' + q(winPath(path.dirname(logFile))) + ' mkdir ' + q(winPath(path.dirname(logFile))),
     'echo [%date% %time%] starting ' + spec + ' >> ' + q(winPath(logFile)),
-    'npx -y ' + spec + ' start --interval %ZERO_AGENT_INTERVAL% >> ' + q(winPath(logFile)) + ' 2>&1',
+    'node ' + q(winPath(bin)) + ' start --interval %ZERO_AGENT_INTERVAL% >> ' + q(winPath(logFile)) + ' 2>&1',
     ''
   ].join('\r\n');
 };

package/src/capabilities.js

@@ -3,6 +3,7 @@
 const crypto = require('node:crypto');
 const fs = require('node:fs');
 const path = require('node:path');
+const localTools = require('./local-tools');
 
 const defaultMcpRoot = () => path.resolve(__dirname, '../..');
 const mcpRoot = (env = process.env) => path.resolve(env.ZERO_MCP_ROOT || defaultMcpRoot());
@@ -55,8 +56,17 @@ const safeInternalTools = (provider) => {
     return [{ name: '__scan_error__', description: error.message, inputSchema: null }];
   }
 };
+const builtInLocalProvider = () => ({
+  name: 'zero-agent-local',
+  type: 'internal',
+  description: 'Built-in safe local filesystem tools exposed by zero-agent.',
+  status: 'present',
+  tools: localTools.listTools(),
+  tool_count: localTools.listTools().length
+});
+
 const buildCapabilities = (env = process.env) => {
-  const providers = manifestProviders(env).map((provider) => {
+  const providers = [builtInLocalProvider(), ...manifestProviders(env).map((provider) => {
     const tools = provider.type === 'internal' ? safeInternalTools(provider) : [];
     return {
       name: provider.name,
@@ -67,7 +77,7 @@ const buildCapabilities = (env = process.env) => {
       tool_count: tools.length,
       mcp_stdio_live_scan: provider.type === 'mcp-stdio' ? false : undefined
     };
-  });
+  })];
   const payload = {
     agent_version: require('../package.json').version,
     mcp_root: mcpRoot(env),
@@ -80,4 +90,5 @@ const buildCapabilities = (env = process.env) => {
   return payload;
 };
 
-module.exports = { mcpRoot, providersDir, manifestProviders, buildCapabilities };
+const capabilities = { mcpRoot, providersDir, manifestProviders, buildCapabilities };
+Object.assign(exports, capabilities);

package/src/local-tools.js

@@ -101,6 +101,20 @@ const readFile = (args, env) => {
   return { ok: true, path: file, totalLines: lines.length, offset: start, length: slice.length, content: numbered(slice, start) };
 };
 
+const readFiles = (args = {}, env) => {
+  const requests = Array.isArray(args.files) && args.files.length
+    ? args.files.map((item) => ({ path: item.path, offset: item.offset, length: item.length }))
+    : (Array.isArray(args.paths) ? args.paths : []).map((inputPath) => ({ path: inputPath, offset: args.offset, length: args.length }));
+  if (!requests.length) throw err('INVALID_PATHS', 'paths or files must contain at least one file');
+  if (requests.length > 50) throw err('TOO_MANY_PATHS', 'readFiles supports up to 50 files');
+  const files = requests.map((request) => {
+    try { return readFile(request, env); }
+    catch (error) { return { ok: false, path: String(request.path), error: { code: error.code || 'READ_FAILED', message: error.message || String(error) } }; }
+  });
+  const succeeded = files.filter((item) => item.ok).length;
+  return { ok: succeeded === files.length, count: files.length, succeeded, failed: files.length - succeeded, files };
+};
+
 const globFiles = (args, env) => {
   const root = resolveAllowed(args.path, env);
   const rx = wildcard(args.pattern || '*');
@@ -133,13 +147,25 @@ const grepFiles = (args, env) => {
   return { ok: true, path: root, pattern: args.pattern, matches };
 };
 
-const handlers = { listDirectory, getFileInfo, readFile, globFiles, grepFiles };
+const handlers = { listDirectory, getFileInfo, readFile, readFiles, globFiles, grepFiles };
+
+const schemaObject = (properties, required = []) => ({ type: 'object', properties, required });
+const toolSchemas = [
+  { name: 'listDirectory', description: 'List files and folders inside ZERO_AGENT_ROOTS.', inputSchema: schemaObject({ path: { type: 'string' }, depth: { type: 'number' } }, ['path']) },
+  { name: 'getFileInfo', description: 'Get metadata for a file or directory inside ZERO_AGENT_ROOTS.', inputSchema: schemaObject({ path: { type: 'string' } }, ['path']) },
+  { name: 'readFile', description: 'Read a UTF-8 text file inside ZERO_AGENT_ROOTS with line pagination.', inputSchema: schemaObject({ path: { type: 'string' }, offset: { type: 'number' }, length: { type: 'number' } }, ['path']) },
+  { name: 'readFiles', description: 'Read multiple UTF-8 text files inside ZERO_AGENT_ROOTS. Accept paths[] or files[].', inputSchema: schemaObject({ paths: { type: 'array', items: { type: 'string' }, minItems: 1, maxItems: 50 }, files: { type: 'array', minItems: 1, maxItems: 50, items: schemaObject({ path: { type: 'string' }, offset: { type: 'number' }, length: { type: 'number' } }, ['path']) }, offset: { type: 'number' }, length: { type: 'number' } }) },
+  { name: 'globFiles', description: 'Find files by wildcard pattern inside ZERO_AGENT_ROOTS.', inputSchema: schemaObject({ path: { type: 'string' }, pattern: { type: 'string' }, maxResults: { type: 'number' } }, ['path']) },
+  { name: 'grepFiles', description: 'Search text files inside ZERO_AGENT_ROOTS.', inputSchema: schemaObject({ path: { type: 'string' }, pattern: { type: 'string' }, literal: { type: 'boolean' }, filePattern: { type: 'string' }, maxResults: { type: 'number' } }, ['path', 'pattern']) }
+];
 
-exports.execute = (tool, args = {}, env = process.env) => {
+const execute = (tool, args = {}, env = process.env) => {
   const cleanTool = String(tool || '').replace(/^command\./, '');
   const handler = handlers[cleanTool];
   if (!handler) throw err('UNKNOWN_AGENT_TOOL', 'unknown or unsafe agent tool: ' + tool);
   return handler(args, env);
 };
+const listTools = () => toolSchemas.map((tool) => ({ ...tool }));
 
-exports._private = { rootsFor, resolveAllowed, wildcard };
+const localTools = { execute, listTools, _private: { rootsFor, resolveAllowed, wildcard } };
+Object.assign(exports, localTools);