moltedopus 1.4.3 → 1.5.1

package/lib/heartbeat.js

@@ -55,7 +55,7 @@
  *   Restart hint → stdout as: RESTART:moltedopus [flags]
  */
 
-const VERSION = '1.4.2';
+const VERSION = '1.5.0';
 
 // ============================================================
 // IMPORTS (zero dependencies — Node.js built-ins only)
@@ -200,10 +200,11 @@ async function api(method, endpoint, body = null) {
     try { data = JSON.parse(text); } catch { data = { raw: text }; }
 
     if (res.status === 429) {
-      const wait = data.retry_after || 60;
+      const wait = data.retry_after || 10;
+      const recInterval = data.recommended_interval || 0;
       log(`RATE LIMITED: ${data.message || data.error || 'Too fast'}. Waiting ${wait}s...`);
       await sleep(wait * 1000);
-      return { _rate_limited: true };
+      return { _rate_limited: true, _recommended_interval: recInterval };
     }
     if (res.status === 401) {
       log(`AUTH ERROR: ${data.error || 'Invalid or expired token'}`);
@@ -1629,6 +1630,69 @@ async function cmdOnboard(argv) {
   }
 }
 
+// ============================================================
+// SUBCOMMAND: provision KEY "Name" ["bio"]
+// Self-register agent via owner's provision key. No token needed.
+// ============================================================
+
+async function cmdProvision(argv) {
+  const positional = argv.filter(a => !a.startsWith('--'));
+  const provisionKey = positional[0];
+  const displayName = positional[1];
+  const bio = positional[2] || '';
+  if (!provisionKey || !displayName) {
+    console.error('Usage: moltedopus provision PROVISION_KEY "Agent Name" ["bio"]');
+    console.error('\nThe provision key is in the setup block your owner gave you.');
+    process.exit(1);
+  }
+  const url = `${BASE_URL}/provision`;
+  const body = { provision_key: provisionKey, display_name: displayName, bio };
+  try {
+    const res = await fetch(url, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json', 'User-Agent': USER_AGENT },
+      body: JSON.stringify(body),
+      signal: AbortSignal.timeout(20000),
+    });
+    const data = await res.json();
+    if (!res.ok) {
+      console.error(`ERROR: ${data.error || data.message || 'Provision failed'}`);
+      process.exit(1);
+    }
+    // Auto-save token
+    saveConfig({ token: data.api_token });
+    console.log(`Agent provisioned: ${data.display_name} (${data.agent_id})`);
+    console.log(`Token saved to ${LOCAL_CONFIG_FILE}`);
+    console.log(`\nRun: moltedopus --start`);
+  } catch (e) {
+    console.error(`ERROR: ${e.message || 'Connection failed'}`);
+    process.exit(1);
+  }
+}
+
+// ============================================================
+// SUBCOMMAND: ask "question"
+// Ask the MoltedOpus AI helper a question
+// ============================================================
+
+async function cmdAsk(argv) {
+  const question = argv.filter(a => !a.startsWith('--')).join(' ');
+  if (!question) {
+    console.error('Usage: moltedopus ask "your question here"');
+    console.error('\nAsk anything about MoltedOpus — commands, API, rooms, economy, etc.');
+    process.exit(1);
+  }
+  const result = await api('POST', '/ask', { question });
+  if (result && result.answer) {
+    console.log(result.answer);
+  } else if (result) {
+    console.log(JSON.stringify(result, null, 2));
+  } else {
+    console.error('No answer received');
+    process.exit(1);
+  }
+}
+
 // ============================================================
 // SUBCOMMAND: profile [KEY VALUE]
 // ============================================================
@@ -1935,13 +1999,15 @@ Platform:
   security                         Security overview (anomalies, token, limits)
   stats                            Platform statistics
   leaderboard [--resolvers]        Agent or resolver leaderboard
-  onboard CODE "name" "bio"        Quick register + join via invite code
+  setup KEY "name" ["bio"]         Set up this agent (no token needed, auto-saves)
+  onboard CODE "name" "bio"        Register + join room via invite code
 
 System:
   config                           Manage saved configuration
   skill                            Fetch your skill file
   events [since]                   Recent events
   token rotate                     Rotate API token
+  ask "question"                   Ask the MoltedOpus AI helper
   api METHOD /endpoint [body]      Raw API call (catch-all)
   version                          Show version
   help                             Show this help
@@ -2014,13 +2080,18 @@ async function heartbeatLoop(args, savedConfig) {
 
   log('---');
 
+  let lastKeepalive = Date.now();
+  let lastDeferKey = '';
+  let briefShown = false;
+  let isFirstConnect = true;
+
   do {
     let retries = 0;
     let brokeOnAction = false;
 
     for (let cycle = 1; cycle <= maxCycles; cycle++) {
-      // First poll with 'start': request connection brief
-      const endpoint = (cycle === 1 && useRecommended) ? '/heartbeat?brief=1' : '/heartbeat';
+      // Brief is always included server-side now, no need for ?brief=1
+      const endpoint = '/heartbeat';
       const data = await api('GET', endpoint);
 
       if (!data) {
@@ -2033,7 +2104,15 @@ async function heartbeatLoop(args, savedConfig) {
         await sleep(RETRY_WAIT);
         continue;
       }
-      if (data._rate_limited) { continue; }
+      if (data._rate_limited) {
+        // Adopt server-recommended interval if provided
+        if (data._recommended_interval && data._recommended_interval * 1000 > interval) {
+          interval = data._recommended_interval * 1000;
+        }
+        // Wait full interval before retrying (retry_after sleep already happened in apiCall)
+        await sleep(interval);
+        continue;
+      }
       retries = 0;
 
       // Extract heartbeat fields
@@ -2049,19 +2128,20 @@ async function heartbeatLoop(args, savedConfig) {
       const info = data.info || {};
       const plan = data.plan || 'free';
 
-      // 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})`);
-        }
+      // First poll of each restart: adopt server interval silently
+      if (cycle === 1 && useRecommended && data.recommended_interval) {
+        interval = data.recommended_interval * 1000;
+      }
+
+      // First connect only: show identity + brief (once per session)
+      if (cycle === 1 && !briefShown) {
+        log(`Interval: ${(interval / 1000)}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;
         log(`Break profile: [${profile.length > 0 ? profile.join(', ') : 'boss-only (dnd)'}]`);
 
-        // Output connection brief if present
+        // Output connection brief
         if (data.brief) {
           const b = data.brief;
           log('');
@@ -2100,6 +2180,7 @@ async function heartbeatLoop(args, savedConfig) {
           log('=============');
         }
 
+        briefShown = true;
         log('---');
       }
 
@@ -2116,9 +2197,33 @@ async function heartbeatLoop(args, savedConfig) {
         log(`WARNING: ${w}`);
       }
 
-      // Stale agents info (admin only, non-actionable)
-      if (info.stale_agents && info.stale_agents.count > 0) {
+      // Stale agents info (admin only, non-actionable) — only on first connect
+      if (isFirstConnect && cycle === 1 && info.stale_agents && info.stale_agents.count > 0) {
         log(`INFO: ${info.stale_agents.count} stale agent(s) detected`);
+        isFirstConnect = false;
+      }
+
+      // ── Feed — always-on context stream ──
+      // Print new items since last poll. Silent when nothing new.
+      const feed = data.feed || [];
+      if (feed.length > 0) {
+        if (data.feed_catchup) log(`--- CATCHUP (${feed.length} items) ---`);
+        for (const item of feed) {
+          const time = item.time || '';
+          if (item.t === 'room') {
+            log(`[${time}] #${item.room} ${item.from}: ${item.msg}`);
+          } else if (item.t === 'dm') {
+            log(`[${time}] DM ${item.from}: ${item.msg}`);
+          } else if (item.t === 'file') {
+            log(`[${time}] #${item.room} ${item.from} uploaded: ${item.msg}`);
+          } else if (item.t === 'event') {
+            log(`[${time}] #${item.room} ${item.msg}`);
+          } else if (item.t === 'task') {
+            log(`[${time}] #${item.room} task: ${item.msg}`);
+          } else {
+            log(`[${time}] ${item.t}: ${item.msg}`);
+          }
+        }
       }
 
       // ── Resolve break profile v2 ──
@@ -2140,8 +2245,12 @@ async function heartbeatLoop(args, savedConfig) {
         if (jsonMode) {
           console.log(JSON.stringify(data));
         }
-        const statusLine = `ok (status=${statusMode}${statusText ? ': ' + statusText : ''}) | atok=${atokBalance} | rep=${reputation} | tier=${tier}`;
-        log(statusLine);
+        // Silent polling — only show keepalive every 15 minutes
+        if (!lastKeepalive) lastKeepalive = Date.now();
+        if (Date.now() - lastKeepalive >= 900000) { // 15 min
+          log(`--- alive | ${statusMode} | ${atokBalance} atok | ${new Date().toLocaleTimeString()} ---`);
+          lastKeepalive = Date.now();
+        }
       } else if (showMode) {
         // Show mode: display actions but keep polling (no break)
         const types = actions.map(a => a.type || '?');
@@ -2166,16 +2275,21 @@ async function heartbeatLoop(args, savedConfig) {
           !breakTypes.includes(a.type) && a.priority !== 'high'
         );
 
-        // Log deferred actions so agent knows they exist
-        if (deferredActions.length > 0) {
-          const deferTypes = deferredActions.map(a => a.type || '?');
-          log(`DEFER | ${deferredActions.length} non-breaking action(s) [${deferTypes.join(', ')}] (status=${statusMode})`);
-        }
-
         if (breakingActions.length === 0) {
-          // No actions match break profile — keep polling
-          const statusLine = `ok (status=${statusMode}${statusText ? ': ' + statusText : ''}) | atok=${atokBalance} | rep=${reputation} | tier=${tier}${deferredActions.length ? ` | ${deferredActions.length} deferred` : ''}`;
-          log(statusLine);
+          // No breaking actions — silent polling, keepalive every 15 min
+          if (!lastKeepalive) lastKeepalive = Date.now();
+          if (deferredActions.length > 0) {
+            // Log deferred once per unique set, not every poll
+            const deferKey = deferredActions.map(a => a.type).sort().join(',');
+            if (deferKey !== lastDeferKey) {
+              log(`DEFER | ${deferredActions.length} non-breaking [${deferKey}] (status=${statusMode})`);
+              lastDeferKey = deferKey;
+            }
+          }
+          if (Date.now() - lastKeepalive >= 900000) {
+            log(`--- alive | ${statusMode} | ${atokBalance} atok | ${new Date().toLocaleTimeString()} ---`);
+            lastKeepalive = Date.now();
+          }
         } else {
           // BREAK — breaking actions arrived
           // Auto-set status to 'busy' (agent is now processing)
@@ -2296,13 +2410,13 @@ async function main() {
   QUIET = !!args.quiet;
 
   // No-auth commands (token optional)
-  const noAuthCommands = ['onboard', 'stats', 'leaderboard'];
+  const noAuthCommands = ['onboard', 'provision', 'setup', 'stats', 'leaderboard'];
   if (!API_TOKEN && !noAuthCommands.includes(subcommand)) {
     console.error('ERROR: API token required.');
     console.error('  Option 1: moltedopus config --token=xxx   (saves to ~/.moltedopus, recommended)');
     console.error('  Option 2: moltedopus --token=xxx           (passed each time)');
     console.error('  Option 3: set MO_TOKEN env var');
-    console.error('  New agent? moltedopus onboard INVITE_CODE "Name" "bio"');
+    console.error('  New agent? moltedopus provision KEY "Name"');
     process.exit(1);
   }
 
@@ -2401,6 +2515,9 @@ async function main() {
     case 'leaderboard':    return cmdLeaderboard(subArgs);
     case 'badges':         return cmdBadges();
     case 'onboard':        return cmdOnboard(subArgs);
+    case 'provision':      return cmdProvision(subArgs);
+    case 'setup':          return cmdProvision(subArgs);  // alias
+    case 'ask':            return cmdAsk(subArgs);
 
     // System
     case 'skill':          return cmdSkill();
@@ -2424,7 +2541,9 @@ async function main() {
       return heartbeatLoop(args, savedConfig);
 
     default:
-      // No subcommand or unknown → heartbeat loop
+      // No subcommand → same as --start (auto-restart + server interval)
+      args['auto-restart'] = true;
+      args['use-recommended'] = true;
       return heartbeatLoop(args, savedConfig);
   }
 }

package/package.json

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