@miruzero/zero-agent 0.3.0 → 0.3.2

package/README.md

@@ -2,11 +2,18 @@
 
 Local worker agent for Zero MCP multi-device execution.
 
+## Quick start
+
+```powershell
+npx @miruzero/zero-agent@latest start --once
+```
+
+On first run, `start` creates local config, a launcher, and a Windows user-logon autostart file automatically.
+
 ## Commands
 
 ```powershell
-zero-agent init --server https://zero.miru.work
-zero-agent pair --server https://zero.miru.work --code ZERO-XXXX
+zero-agent setup --name TON --code ZERO-XXXX
 zero-agent start --once
 zero-agent start
 zero-agent status
@@ -16,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.
 

package/package.json

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

package/src/autostart.js

@@ -0,0 +1,84 @@
+'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;
+
+const q = (value) => '"' + String(value).replace(/"/g, '""') + '"';
+const winPath = (value) => String(value).replace(/\//g, '\\');
+
+const defaultRoots = (env = process.env) => {
+  if (env.ZERO_AGENT_ROOTS) return env.ZERO_AGENT_ROOTS;
+  const home = env.USERPROFILE || os.homedir();
+  return [
+    path.join(home, 'Desktop', 'zero'),
+    path.join(home, 'Downloads')
+  ].join(path.delimiter);
+};
+
+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 {
+    home,
+    launcherFile: path.join(home, 'start-zero-agent.cmd'),
+    startupFile: path.join(startupDir(env), 'MiruZeroAgent.vbs'),
+    logFile: path.join(config.logDir(env), 'zero-agent.log')
+  };
+};
+
+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',
+    'set "ZERO_TRACE=1"',
+    'set "ZERO_AGENT_HOME=' + winPath(home) + '"',
+    'set "ZERO_AGENT_ROOTS=' + winPath(roots) + '"',
+    '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 ' + spec + ' >> ' + q(winPath(logFile)),
+    'npx -y ' + spec + ' start --interval %ZERO_AGENT_INTERVAL% >> ' + q(winPath(logFile)) + ' 2>&1',
+    ''
+  ].join('\r\n');
+};
+
+const vbsContent = (launcherFile) => [
+  'Set WshShell = CreateObject("WScript.Shell")',
+  'WshShell.Run Chr(34) & "' + winPath(launcherFile).replace(/"/g, '""') + '" & Chr(34), 0, False',
+  ''
+].join('\r\n');
+
+const prepare = (options = {}, env = process.env) => {
+  config.ensureDirs(env);
+  const p = paths(env);
+  const interval = Number(options.interval || env.ZERO_AGENT_INTERVAL || DEFAULT_INTERVAL);
+  const roots = options.roots || defaultRoots(env);
+  fs.mkdirSync(path.dirname(p.launcherFile), { recursive: true });
+  fs.mkdirSync(path.dirname(p.startupFile), { recursive: true });
+  fs.mkdirSync(path.dirname(p.logFile), { recursive: true });
+  fs.writeFileSync(p.launcherFile, launcherContent({ interval, roots, logFile: p.logFile }, env), 'utf8');
+  fs.writeFileSync(p.startupFile, vbsContent(p.launcherFile), 'utf8');
+  return { ok: true, interval, roots, ...p };
+};
+
+const autostart = {
+  DEFAULT_INTERVAL,
+  defaultRoots,
+  paths,
+  prepare,
+  launcherContent
+};
+
+Object.assign(exports, autostart);

package/src/cli.js

@@ -4,6 +4,7 @@ const childProcess = require('node:child_process');
 const os = require('node:os');
 const pkg = require('../package.json');
 const config = require('./config');
+const autostart = require('./autostart');
 const caps = require('./capabilities');
 const agent = require('./agent');
 const { parseArgs } = require('./args');
@@ -14,7 +15,7 @@ Usage:
   zero-agent setup [--server <url>] [--name <device>] [--code <pairing-code>] [--no-global]
   zero-agent init --server <url> [--name <device>]
   zero-agent pair --server <url> --code <pairing-code> [--name <device>]
-  zero-agent start [--once] [--interval <ms>]
+  zero-agent start [--once] [--interval <ms>] [--code <pairing-code>] [--name <device>]
   zero-agent status
   zero-agent devices
   zero-agent doctor
@@ -27,6 +28,42 @@ const printJson = (value) => console.log(JSON.stringify(value, null, 2));
 const okMark = (ok) => ok ? 'OK' : 'FAIL';
 const DEFAULT_SERVER = 'https://zero.miru.work';
 
+const autostartInterval = (parsed) => Number(parsed.interval || autostart.DEFAULT_INTERVAL);
+
+const printAutostartInfo = (prepared) => {
+  console.log('Autostart file');
+  console.log(prepared.startupFile);
+  console.log('ตัวนี้จะรันตอน user logon และเปิด:');
+  console.log(prepared.launcherFile);
+  console.log('Launcher');
+  console.log(prepared.launcherFile);
+  console.log('ตั้งค่า:');
+  console.log('ZERO_TRACE=1');
+  console.log('ZERO_AGENT_ROOTS=' + prepared.roots);
+  console.log('interval=' + prepared.interval + 'ms');
+  console.log('log=' + prepared.logFile);
+};
+
+const ensureLocalBootstrap = async (parsed, env) => {
+  let device = config.loadDevice(env);
+  if (!device) {
+    const init = agent.initDevice({ name: parsed.name, server: parsed.server || DEFAULT_SERVER }, env);
+    console.log('autoInit=OK file=' + init.file);
+    device = config.loadDevice(env);
+  }
+  const prepared = autostart.prepare({ interval: autostartInterval(parsed) }, env);
+  console.log('autoSetup=OK launcher=' + prepared.launcherFile);
+  if (parsed.code && (!device || !device.device_id)) {
+    const paired = await agent.pairDevice({
+      name: parsed.name || device?.name,
+      server: parsed.server || device?.server || DEFAULT_SERVER,
+      code: parsed.code
+    }, env);
+    console.log('autoPair=OK file=' + paired.file);
+  }
+  return prepared;
+};
+
 const runGlobalInstall = (parsed, env) => {
   if (parsed['no-global'] || env.ZERO_AGENT_SKIP_GLOBAL_INSTALL === '1') {
     console.log('globalInstall=SKIPPED');
@@ -53,6 +90,8 @@ const runSetup = async (parsed, env) => {
   runGlobalInstall(parsed, env);
   const init = agent.initDevice({ name, server }, env);
   console.log('init=OK file=' + init.file);
+  const prepared = autostart.prepare({ interval: autostartInterval(parsed) }, env);
+  printAutostartInfo(prepared);
   if (!parsed.code) {
     console.log('pairing=NEEDS_CODE');
     console.log('Next: zero-agent pair --server ' + server + ' --code ZERO-XXXXXX --name ' + init.device.name);
@@ -122,7 +161,7 @@ const printLoopResult = (result) => {
     status: device?.status || null,
     name: device?.name || null,
     host: device?.host || null,
-    providers: device?.provider_count || null,
+    providers: device?.provider_count ?? null,
     last_seen: device?.last_seen || null,
     task: taskState
   }));
@@ -176,11 +215,12 @@ async function run(argv = [], env = process.env) {
     return 0;
   }
   if (command === 'start') {
+    await ensureLocalBootstrap(parsed, env);
     if (parsed.once) {
       printJson(await runStartOnce(env));
       return 0;
     }
-    const interval = Number(parsed.interval || 10000);
+    const interval = Number(parsed.interval || autostart.DEFAULT_INTERVAL);
     printStartBanner(env);
     console.log('⏱️  Heartbeat interval: ' + interval + 'ms');
     console.log('🟢 Device ready; press Ctrl+C to stop');