@myvillage/cli 1.85.2 → 1.86.0

package/package.json

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

package/src/commands/agent-local.js

@@ -333,12 +333,19 @@ export async function agentRecipesListCommand() {
 
 // ── Start Agent ─────────────────────────────────────────
 
-export async function agentStartCommand(name) {
+export async function agentStartCommand(name, options = {}) {
   if (!isAuthenticated()) {
     console.log(chalk.red('  \u2717 Authentication required. Run \'myvillage login\' first.'));
     return;
   }
 
+  // Organizational village tags for this agent (grouping/filtering only \u2014 no
+  // access effect). Accept either a pre-parsed array (if a caller passes one)
+  // or a comma-separated string from the --village flag.
+  const associatedVillages = Array.isArray(options.village)
+    ? options.village.map(v => String(v).trim()).filter(Boolean)
+    : (options.village || '').split(',').map(v => v.trim()).filter(Boolean);
+
   if (!agentExists(name)) {
     // Check whether the agent exists server-side under this handle. If so,
     // this is a "different machine" situation \u2014 point them at `agent pull`
@@ -453,7 +460,7 @@ export async function agentStartCommand(name) {
           archetypes: [],
           greeting: '',
           starterPrompts: [],
-          associatedVillages: [],
+          associatedVillages,
           specialInstructions: null,
           agentProfileId: agent.id,
         });
@@ -512,7 +519,7 @@ export async function agentStartCommand(name) {
         archetypes: [],
         greeting: '',
         starterPrompts: [],
-        associatedVillages: [],
+        associatedVillages,
         specialInstructions: null,
         agentProfileId: agentConfig.man.agent_id,
       });

package/src/commands/agent.js

@@ -27,7 +27,7 @@ async function resolveAgentHandle(handle) {
 
 // ── Commands ─────────────────────────────────────────
 
-export async function agentCommand(handle) {
+export async function agentCommand(handle, options = {}) {
   if (!isAuthenticated()) {
     console.log(chalk.red('  \u2717 Authentication required. Run \'myvillage login\' first.'));
     return;
@@ -46,7 +46,8 @@ export async function agentCommand(handle) {
   const spinner = villageSpinner('Loading remote agents...').start();
 
   try {
-    const result = await listMyAgents();
+    // --village filters remote agents by an associated village id (organizational).
+    const result = await listMyAgents(options.village ? { village: options.village } : {});
     spinner.stop();
 
     const agents = result.data || result;

package/src/index.js

@@ -440,6 +440,7 @@ export function run() {
   const agentCmd = program
     .command('agent [handle]')
     .description('List your agents, or view an agent by handle')
+    .option('--village <id>', 'Filter agents by associated village ID')
     .action(agentCommand);
 
   agentCmd
@@ -510,6 +511,7 @@ export function run() {
   agentCmd
     .command('start <name>')
     .description('Start a local agent daemon')
+    .option('--village <ids>', 'Comma-separated village IDs to tag this agent with (organizational only; does not change access)')
     .action(agentStartCommand);
 
   agentCmd

package/src/utils/api.js

@@ -290,8 +290,14 @@ export async function createAgent(data) {
   return response.data;
 }
 
-export async function listMyAgents(params = {}) {
-  const client = getNetworkClient();
+export async function listMyAgents(options = {}) {
+  const client = getNetworkClient();
+  // Pass through recognized query params. `village` filters by an associated
+  // village id (organizational grouping only); existing callers may also pass
+  // excludeSystem / unlinked etc., so spread the rest through unchanged.
+  const { village, ...rest } = options;
+  const params = { ...rest };
+  if (village) params.village = village;
   const response = await client.get('/agents/my', { params });
   return response.data;
 }

package/src/utils/formatters.js

@@ -398,6 +398,8 @@ export function formatAgentList(agents) {
     if (agent.agentCategory && agent.agentCategory !== 'NETWORK' && agent.schedule) {
       console.log(`  ${chalk.dim('  ')}${chalk.dim(`Schedule: ${agent.schedule}`)}`);
     }
+    const villages = Array.isArray(agent.associatedVillages) ? agent.associatedVillages.filter(Boolean) : [];
+    console.log(`  ${chalk.dim('  ')}${chalk.dim(`Villages: ${villages.length ? villages.join(', ') : '—'}`)}`);
     console.log('');
   }
 }