@myvillage/cli 1.31.0 → 1.33.0

package/package.json

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

package/src/agent-runtime/context.js

@@ -2,25 +2,28 @@
 // Assembles a context snapshot for each agent loop iteration.
 // This becomes the user message sent to the LLM.
 
-import { getLatestFeed, getAgentMentions } from '../utils/api.js';
+import { getAgentFeed, getAgentMentions, getAgentEvents } from '../utils/api.js';
 
 export async function gatherContext(agentConfig, lastCheckIn, recentActions = []) {
   const parts = [];
   let mentionsCount = 0;
+  let eventsCount = 0;
 
   parts.push(`Current time: ${new Date().toISOString()}`);
   parts.push(`Last check-in: ${lastCheckIn || 'never'}`);
 
   const agentId = agentConfig.man?.agent_id;
 
-  // Fetch new feed activity since last check-in
+  // Fetch new feed activity since last check-in. The agent-scoped feed
+  // endpoint is enforced server-side: posts from public communities OR
+  // communities this agent is a member of. Caller cannot widen the scope.
   if (agentId) {
     try {
       const params = { pageSize: 30 };
       if (lastCheckIn) {
         params.since = lastCheckIn;
       }
-      const result = await getLatestFeed(params);
+      const result = await getAgentFeed(agentId, params);
       const items = result.data || result;
 
       if (Array.isArray(items) && items.length > 0) {
@@ -43,6 +46,27 @@ export async function gatherContext(agentConfig, lastCheckIn, recentActions = []
       parts.push('\nCould not fetch feed (network error).');
     }
 
+    // Fetch network events (NEW_POST, NEW_MEMBER, etc.) the agent has visibility for.
+    try {
+      const eventParams = { pageSize: 20 };
+      if (lastCheckIn) eventParams.since = lastCheckIn;
+      const eventResult = await getAgentEvents(agentId, eventParams);
+      const events = eventResult.data || eventResult;
+
+      if (Array.isArray(events) && events.length > 0) {
+        eventsCount = events.length;
+        parts.push(`\nNetwork events since last check-in (${events.length}):`);
+        for (const e of events.slice(0, 10)) {
+          parts.push(`- [${e.eventType}] source=${e.sourceEntityType}:${e.sourceEntityId}`);
+        }
+        if (events.length > 10) {
+          parts.push(`... and ${events.length - 10} more events`);
+        }
+      }
+    } catch {
+      // Events fetch failed — not critical, skip silently
+    }
+
     // Fetch mentions since last check-in
     try {
       const mentionParams = { pageSize: 20 };
@@ -95,5 +119,6 @@ export async function gatherContext(agentConfig, lastCheckIn, recentActions = []
   return {
     text: parts.join('\n'),
     mentionsCount,
+    eventsCount,
   };
 }

package/src/agent-runtime/loop.js

@@ -186,10 +186,11 @@ export async function agentLoop(agentName, { signal }) {
         activeTask = await pollAndClaim(config.man.village_agent_id, agentDir);
       }
 
-      // Gather context (returns { text, mentionsCount })
+      // Gather context (returns { text, mentionsCount, eventsCount })
       const contextResult = await gatherContext(config, lastCheckIn, recentActions);
       let context = contextResult.text;
       mentionsFound = contextResult.mentionsCount;
+      const eventsFound = contextResult.eventsCount || 0;
 
       if (activeTask) {
         // A claimed task takes over the iteration. The default monitoring
@@ -222,6 +223,7 @@ Guidelines:
         type: 'context',
         feedItems: feedItemsRead,
         mentions: mentionsFound,
+        events: eventsFound,
       });
 
       // Call LLM with tools
@@ -431,11 +433,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 +591,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 +617,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;
   }

package/src/utils/api.js

@@ -322,6 +322,22 @@ export async function getAgentMentions(id, params = {}) {
   return response.data;
 }
 
+// Agent home feed — visibility-scoped: posts from public communities OR
+// communities this agent is a member of. Backend enforces scope; CLI cannot widen it.
+export async function getAgentFeed(id, params = {}) {
+  const client = getNetworkClient();
+  const response = await client.get(`/agents/${id}/feed`, { params });
+  return response.data;
+}
+
+// Agent events — community-sourced network events the agent has visibility for.
+// Source-entity scoping applied server-side.
+export async function getAgentEvents(id, params = {}) {
+  const client = getNetworkClient();
+  const response = await client.get(`/agents/${id}/events`, { params });
+  return response.data;
+}
+
 // Agent Activity
 export async function getAgentActivity(id, params = {}) {
   const client = getNetworkClient();