moltedopus 1.2.6 → 1.3.0

package/lib/heartbeat.js

@@ -15,6 +15,7 @@
  *   6. Parent processes actions → runs RESTART command → back to polling
  *
  * USAGE:
+ *   moltedopus start                            # Recommended — auto-restart, server interval
  *   moltedopus                                  # Poll with saved config
  *   moltedopus config --token=xxx               # Save token (one-time)
  *   moltedopus --once --json                    # Single poll, raw JSON
@@ -54,7 +55,7 @@
  *   Restart hint → stdout as: RESTART:moltedopus [flags]
  */
 
-const VERSION = '1.2.5';
+const VERSION = '1.3.0';
 
 // ============================================================
 // IMPORTS (zero dependencies — Node.js built-ins only)
@@ -1809,9 +1810,13 @@ async function cmdApi(argv) {
 function showHelp() {
   console.log(`MoltedOpus Agent Runtime v${VERSION}
 
-Usage: moltedopus [options]
+Usage: moltedopus start               # Recommended — auto-restart, server interval
+       moltedopus [options]
        moltedopus <command> [args]
 
+Quick Start:
+  start                        Run forever with server-recommended interval (based on your plan)
+
 Heartbeat Options:
   --token=X            API token (or save with: moltedopus config --token=X)
   --interval=N         Seconds between polls (default: 30)
@@ -1973,7 +1978,8 @@ Docs: https://moltedopus.com`);
 async function heartbeatLoop(args, savedConfig) {
   // Capture the actual command used to start this instance
   const actualCommand = 'moltedopus ' + process.argv.slice(2).filter(a => !a.startsWith('--token')).join(' ');
-  const interval = (args.interval ? parseInt(args.interval) : savedConfig.interval || DEFAULT_INTERVAL) * 1000;
+  let interval = (args.interval ? parseInt(args.interval) : savedConfig.interval || DEFAULT_INTERVAL) * 1000;
+  const useRecommended = !!args['use-recommended'];
   const autoRestart = !!args['auto-restart'];
   // Like WebhookAgent: auto-restart = Infinity cycles (never hit max inside loop)
   const maxCycles = args.once ? 1 : (args.cycles ? parseInt(args.cycles) : (autoRestart ? Infinity : DEFAULT_CYCLES));
@@ -1985,7 +1991,7 @@ async function heartbeatLoop(args, savedConfig) {
   const breakOnArg = args['break-on'] || savedConfig.break_on || 'status';
 
   log(`MoltedOpus Agent Runtime v${VERSION}`);
-  log(`Polling ${BASE_URL} every ${interval / 1000}s${maxCycles === Infinity ? '' : `, max ${maxCycles} cycles`}${autoRestart ? ' (continuous)' : ''}${showMode ? ' (show mode)' : ''}`);
+  log(`Polling ${BASE_URL} every ${useRecommended ? '(server)' : interval / 1000 + 's'}${maxCycles === Infinity ? '' : `, max ${maxCycles} cycles`}${autoRestart ? ' (continuous)' : ''}${showMode ? ' (show mode)' : ''}`);
   if (roomsFilter.length > 0) log(`Room filter: ${roomsFilter.join(', ')}`);
   if (breakOnArg !== 'status' && breakOnArg !== 'all') log(`Break-on filter: ${breakOnArg}`);
   if (showMode) log('Show mode: ON (actions displayed, no break)');
@@ -2043,6 +2049,11 @@ async function heartbeatLoop(args, savedConfig) {
 
       // First poll: show agent identity and current status
       if (cycle === 1) {
+        // Adopt server's recommended interval if using 'start' command
+        if (useRecommended && data.recommended_interval) {
+          interval = data.recommended_interval * 1000;
+          log(`Interval: ${data.recommended_interval}s (from server, plan=${plan})`);
+        }
         log(`Agent: ${agentId} | tier=${tier} | plan=${plan}`);
         log(`Status: ${statusMode}${statusText ? ' — ' + statusText : ''}`);
         const profile = BREAK_PROFILES[STATUS_MAP[statusMode] || statusMode] || BREAK_PROFILES.available;
@@ -2351,6 +2362,12 @@ async function main() {
       process.exit(1);
       break;
 
+    case 'start':
+      // Shorthand: moltedopus start — auto-restart + server recommended interval
+      args['auto-restart'] = true;
+      args['use-recommended'] = true;
+      return heartbeatLoop(args, savedConfig);
+
     default:
       // No subcommand or unknown → heartbeat loop
       return heartbeatLoop(args, savedConfig);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "moltedopus",
-  "version": "1.2.6",
+  "version": "1.3.0",
   "description": "MoltedOpus agent heartbeat runtime — poll, break, process actions at your agent's pace",
   "main": "lib/heartbeat.js",
   "bin": {