@myvillage/cli 1.31.0 → 1.32.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myvillage/cli",
-  "version": "1.31.0",
+  "version": "1.32.0",
   "description": "MyVillageOS CLI for community developers",
   "type": "module",
   "bin": {

package/src/agent-runtime/loop.js

@@ -431,11 +431,17 @@ Guidelines:
             durationMs: Date.now() - loopStart,
             activitySummary: { feedItemsRead, mentionsFound },
           });
-        } catch {
+        } catch (err) {
+          if (isPausedResponse(err)) throw new AgentPausedError();
           logActivity(agentDir, { type: 'error', error: 'Failed to send server heartbeat' });
         }
       }
     } catch (err) {
+      if (err instanceof AgentPausedError) {
+        logActivity(agentDir, { type: 'agent_paused', message: err.message });
+        console.log('\n[MyVillage] This agent has been paused by an admin. Exiting.\n');
+        break;
+      }
       logActivity(agentDir, {
         type: 'error',
         error: err.message,
@@ -583,9 +589,23 @@ function summarizeToolResult(tr) {
   return text.slice(0, 200);
 }
 
+class AgentPausedError extends Error {
+  constructor(message = 'Agent is paused by an admin') {
+    super(message);
+    this.name = 'AgentPausedError';
+    this.code = 'AGENT_PAUSED';
+  }
+}
+
+function isPausedResponse(err) {
+  return err?.response?.status === 409 && err?.response?.data?.code === 'AGENT_PAUSED';
+}
+
 // Pull up to 5 pending tasks and claim the first one we can win the race for.
 // Returns the claimed task or null. Errors are swallowed and logged — the loop
-// should keep running on transient backend issues.
+// should keep running on transient backend issues. A pause response (409
+// AGENT_PAUSED) is the one exception: rethrown as AgentPausedError so the
+// outer loop can shut down cleanly.
 async function pollAndClaim(villageAgentId, agentDir) {
   try {
     const result = await listAgentTasks(villageAgentId, { status: 'PENDING', limit: 5 });
@@ -595,12 +615,15 @@ async function pollAndClaim(villageAgentId, agentDir) {
       try {
         const claim = await claimAgentTask(villageAgentId, task.id);
         return claim.data || task;
-      } catch {
-        // Race lost (409) or transient — try the next task
+      } catch (err) {
+        if (isPausedResponse(err)) throw new AgentPausedError();
+        // Race lost (409 not-paused) or transient — try the next task
       }
     }
     return null;
   } catch (err) {
+    if (err instanceof AgentPausedError) throw err;
+    if (isPausedResponse(err)) throw new AgentPausedError();
     logActivity(agentDir, { type: 'error', error: `Task poll failed: ${err.message}` });
     return null;
   }