@miruzero/zero-agent 0.3.1 → 0.3.3

package/README.md

@@ -1,34 +1,19 @@
-# Zero Agent
+# Zero Agent
 
 Local worker agent for Zero MCP multi-device execution.
 
-## One-command start
-
-For a normal user, start with npm/npx and let the agent create local files automatically:
+## Quick start
 
 ```powershell
-npx @miruzero/zero-agent@latest start --name TON --code ZERO-XXXX
+npx @miruzero/zero-agent@latest start --once
 ```
 
-Or inside this package:
-
-```powershell
-npm start
-```
-
-On first start, the agent creates:
-
-```text
-%USERPROFILE%\.zero-agent\device.json
-%USERPROFILE%\.zero-agent\start-zero-agent.cmd
-%APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup\MiruZeroAgent.vbs
-%USERPROFILE%\.zero-agent\logs\zero-agent.log
-```
+On first run, `start` creates local config, a launcher, and a Windows user-logon autostart file automatically.
 
 ## Commands
 
 ```powershell
-zero-agent setup --server https://zero.miru.work --name TON --code ZERO-XXXX
+zero-agent setup --name TON --code ZERO-XXXX
 zero-agent start --once
 zero-agent start
 zero-agent status
@@ -38,15 +23,17 @@ zero-agent tools
 zero-agent capabilities
 ```
 
-## State
+## Autostart
 
 Default state path:
 
 ```text
 %USERPROFILE%\.zero-agent\device.json
+%USERPROFILE%\.zero-agent\start-zero-agent.cmd
+%APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup\MiruZeroAgent.vbs
 ```
 
-Device names default to the local PC hostname. Use --name only when you want a custom display name.
+The launcher uses `npx -y @miruzero/zero-agent@<current-version> start` so the user-logon agent does not depend on a stale global install.
 
 Device tokens are local secrets and must not be printed or committed.
 
@@ -55,4 +42,4 @@ Device tokens are local secrets and must not be printed or committed.
 ```powershell
 npm test
 npm pack --dry-run
-```
+```

package/package.json

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

package/src/autostart.js

@@ -1,9 +1,10 @@
-'use strict';
+'use strict';
 
 const fs = require('node:fs');
 const os = require('node:os');
 const path = require('node:path');
 const config = require('./config');
+const pkg = require('../package.json');
 
 const DEFAULT_INTERVAL = 30000;
 
@@ -23,7 +24,6 @@ const startupDir = (env = process.env) => {
   const appData = env.APPDATA || path.join(os.homedir(), 'AppData', 'Roaming');
   return path.join(appData, 'Microsoft', 'Windows', 'Start Menu', 'Programs', 'Startup');
 };
-
 const paths = (env = process.env) => {
   const home = config.agentHome(env);
   return {
@@ -34,8 +34,11 @@ const paths = (env = process.env) => {
   };
 };
 
+const packageSpec = () => pkg.name + '@' + pkg.version;
+
 const launcherContent = ({ interval = DEFAULT_INTERVAL, roots, logFile }, env = process.env) => {
   const home = config.agentHome(env);
+  const spec = packageSpec();
   return [
     '@echo off',
     'setlocal',
@@ -45,8 +48,8 @@ const launcherContent = ({ interval = DEFAULT_INTERVAL, roots, logFile }, env =
     'set "ZERO_AGENT_INTERVAL=' + Number(interval || DEFAULT_INTERVAL) + '"',
     '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 zero-agent >> ' + q(winPath(logFile)),
-    'zero-agent start --interval %ZERO_AGENT_INTERVAL% >> ' + q(winPath(logFile)) + ' 2>&1',
+    'echo [%date% %time%] starting ' + spec + ' >> ' + q(winPath(logFile)),
+    'npx -y ' + spec + ' start --interval %ZERO_AGENT_INTERVAL% >> ' + q(winPath(logFile)) + ' 2>&1',
     ''
   ].join('\r\n');
 };
@@ -74,8 +77,8 @@ const autostart = {
   DEFAULT_INTERVAL,
   defaultRoots,
   paths,
-  prepare
+  prepare,
+  launcherContent
 };
 
-Object.assign(exports, autostart);
-
+Object.assign(exports, autostart);

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

@@ -135,11 +135,22 @@ const grepFiles = (args, env) => {
 
 const handlers = { listDirectory, getFileInfo, readFile, globFiles, grepFiles };
 
-exports.execute = (tool, args = {}, env = process.env) => {
+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: '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']) }
+];
+
+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);