@myvillage/cli 1.10.2 → 1.18.0

package/src/commands/agent-client.js

@@ -0,0 +1,435 @@
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import { existsSync, readFileSync, writeFileSync, appendFileSync } from 'fs';
+import { villageSpinner, brand } from '../utils/brand.js';
+import { isAuthenticated } from '../utils/auth.js';
+import {
+  listMyAgents,
+  registerClientAgent as apiRegisterClientAgent,
+  listClientAgentConfigs as apiListClientAgentConfigs,
+  getClientAgentConfig as apiGetClientAgentConfig,
+  updateClientAgentConfig as apiUpdateClientAgentConfig,
+  deactivateClientAgent as apiDeactivateClientAgent,
+  rotateClientAgentKey as apiRotateClientAgentKey,
+} from '../utils/api.js';
+import { formatClientAgentConfig, formatClientAgentList } from '../utils/formatters.js';
+
+// ── Schedule Presets ────────────────────────────────────
+
+const SCHEDULE_PRESETS = [
+  { name: 'Daily at 9am', value: '0 9 * * *' },
+  { name: 'Weekly Monday 9am', value: '0 9 * * 1' },
+  { name: 'Monthly 1st at 9am', value: '0 9 1 * *' },
+  { name: 'Custom cron expression', value: 'CUSTOM' },
+  { name: 'None (manual only)', value: '' },
+];
+
+const WORKFLOW_TYPES = [
+  { name: 'Submission Processor — classify submissions, draft outreach', value: 'SUBMISSION_PROCESSOR' },
+  { name: 'Digest Generator — weekly/daily activity summaries', value: 'DIGEST_GENERATOR' },
+  { name: 'Member Matcher — match new signups with existing members', value: 'MEMBER_MATCHER' },
+  { name: 'Stale Data Detector — flag inactive members', value: 'STALE_DATA_DETECTOR' },
+  { name: 'Custom', value: 'CUSTOM' },
+];
+
+// ── Helpers ─────────────────────────────────────────────
+
+function displayApiKey(apiKey, clientId) {
+  console.log('');
+  console.log(chalk.yellow.bold('  ⚠  IMPORTANT: Save your API key now — it will not be shown again!'));
+  console.log('');
+  console.log(`  ${chalk.dim('Client ID:')} ${brand.teal(clientId)}`);
+  console.log(`  ${chalk.dim('API Key:')}   ${brand.gold(apiKey)}`);
+  console.log('');
+}
+
+async function promptSaveToEnvFile(apiKey, clientId) {
+  const { saveToFile } = await inquirer.prompt([{
+    type: 'confirm',
+    name: 'saveToFile',
+    message: 'Save API key to a .env file?',
+    default: false,
+  }]);
+
+  if (saveToFile) {
+    const { filePath } = await inquirer.prompt([{
+      type: 'input',
+      name: 'filePath',
+      message: 'File path:',
+      default: '.env.local',
+    }]);
+
+    const lines = `\n# MyVillageOS Client Agent\nMYVILLAGE_AGENT_API_KEY=${apiKey}\nMYVILLAGE_AGENT_CLIENT_ID=${clientId}\n`;
+
+    if (existsSync(filePath)) {
+      appendFileSync(filePath, lines);
+    } else {
+      writeFileSync(filePath, lines.trimStart());
+    }
+    console.log(brand.green(`  ✓ API key saved to ${filePath}\n`));
+  }
+}
+
+async function resolveAgentId(handle) {
+  const result = await listMyAgents();
+  const agents = result.data || result;
+  if (!Array.isArray(agents) || agents.length === 0) return null;
+
+  const match = agents.find(a =>
+    a.handle === handle || a.handle === handle.replace(/^@/, '')
+  );
+  return match || null;
+}
+
+// ── Register Client ─────────────────────────────────────
+
+export async function agentRegisterClientCommand(options) {
+  if (!isAuthenticated()) {
+    console.log(chalk.red('  ✗ Authentication required. Run \'myvillage login\' first.\n'));
+    return;
+  }
+
+  try {
+    const isNonInteractive = options.agent && options.clientId && options.name && options.url;
+
+    let data;
+
+    if (isNonInteractive) {
+      // Resolve agent handle to ID
+      const spinner = villageSpinner('Resolving agent...').start();
+      const agent = await resolveAgentId(options.agent);
+      if (!agent) {
+        spinner.fail(`Agent "${options.agent}" not found.`);
+        return;
+      }
+      spinner.succeed(`Found agent @${agent.handle}`);
+
+      data = {
+        villageAgentId: agent.villageAgent?.id || agent.villageAgentId || agent.id,
+        clientId: options.clientId.toLowerCase(),
+        clientName: options.name,
+        baseUrl: options.url,
+        workflowType: (options.workflow || 'SUBMISSION_PROCESSOR').toUpperCase(),
+        schedule: options.schedule || null,
+        timezone: options.timezone || 'America/Chicago',
+      };
+    } else {
+      // Interactive mode
+      const agentSpinner = villageSpinner('Loading your agents...').start();
+      const agentResult = await listMyAgents();
+      const agents = agentResult.data || agentResult;
+      agentSpinner.stop();
+
+      if (!Array.isArray(agents) || agents.length === 0) {
+        console.log(brand.teal('\n  No agents found. Create one first with: myvillage agent create\n'));
+        return;
+      }
+
+      const answers = await inquirer.prompt([
+        {
+          type: 'list',
+          name: 'selectedAgent',
+          message: 'Which agent should manage this client?',
+          choices: agents.map(a => ({
+            name: `@${a.handle} — ${a.displayName || a.handle}`,
+            value: a,
+          })),
+        },
+        {
+          type: 'input',
+          name: 'clientId',
+          message: 'Client identifier (lowercase, no spaces):',
+          validate: input => /^[a-z0-9_-]{3,40}$/.test(input) || 'Must be 3-40 chars: lowercase letters, numbers, hyphens, underscores.',
+          filter: input => input.toLowerCase().replace(/[^a-z0-9_-]/g, ''),
+        },
+        {
+          type: 'input',
+          name: 'clientName',
+          message: 'Client display name:',
+          validate: input => input.trim().length > 0 || 'Name is required.',
+        },
+        {
+          type: 'input',
+          name: 'baseUrl',
+          message: 'Client base URL:',
+          validate: input => {
+            try {
+              new URL(input);
+              return true;
+            } catch {
+              return 'Must be a valid URL (e.g., https://maywood-chatkit.vercel.app)';
+            }
+          },
+        },
+        {
+          type: 'list',
+          name: 'workflowType',
+          message: 'Workflow type:',
+          choices: WORKFLOW_TYPES,
+        },
+        {
+          type: 'list',
+          name: 'schedulePreset',
+          message: 'Schedule:',
+          choices: SCHEDULE_PRESETS,
+        },
+      ]);
+
+      let schedule = answers.schedulePreset;
+      if (schedule === 'CUSTOM') {
+        const { customCron } = await inquirer.prompt([{
+          type: 'input',
+          name: 'customCron',
+          message: 'Cron expression (e.g., 0 9 * * 1):',
+          validate: input => input.trim().split(/\s+/).length === 5 || 'Must be a 5-field cron expression.',
+        }]);
+        schedule = customCron;
+      }
+
+      const { confirm } = await inquirer.prompt([{
+        type: 'confirm',
+        name: 'confirm',
+        message: `Register "${answers.clientName}" (${answers.clientId}) with @${answers.selectedAgent.handle}?`,
+        default: true,
+      }]);
+
+      if (!confirm) {
+        console.log(chalk.dim('\n  Cancelled.\n'));
+        return;
+      }
+
+      const selectedAgent = answers.selectedAgent;
+      data = {
+        villageAgentId: selectedAgent.villageAgent?.id || selectedAgent.villageAgentId || selectedAgent.id,
+        clientId: answers.clientId,
+        clientName: answers.clientName,
+        baseUrl: answers.baseUrl,
+        workflowType: answers.workflowType,
+        schedule: schedule || null,
+        timezone: options.timezone || 'America/Chicago',
+      };
+    }
+
+    const regSpinner = villageSpinner('Registering client agent...').start();
+    const result = await apiRegisterClientAgent(data);
+    regSpinner.succeed('Client agent registered!');
+
+    displayApiKey(result.apiKey, data.clientId);
+
+    if (!isNonInteractive) {
+      await promptSaveToEnvFile(result.apiKey, data.clientId);
+    } else if (options.envFile) {
+      const lines = `\n# MyVillageOS Client Agent\nMYVILLAGE_AGENT_API_KEY=${result.apiKey}\nMYVILLAGE_AGENT_CLIENT_ID=${data.clientId}\n`;
+      if (existsSync(options.envFile)) {
+        appendFileSync(options.envFile, lines);
+      } else {
+        writeFileSync(options.envFile, lines.trimStart());
+      }
+      console.log(brand.green(`  ✓ API key saved to ${options.envFile}\n`));
+    }
+  } catch (err) {
+    const message = err.response?.data?.error || err.response?.data?.message || err.message;
+    console.log(chalk.red(`\n  ✗ Failed to register client agent: ${message}\n`));
+  }
+}
+
+// ── List Clients ────────────────────────────────────────
+
+export async function agentListClientsCommand() {
+  if (!isAuthenticated()) {
+    console.log(chalk.red('  ✗ Authentication required. Run \'myvillage login\' first.\n'));
+    return;
+  }
+
+  try {
+    const spinner = villageSpinner('Loading client agent configs...').start();
+    const result = await apiListClientAgentConfigs();
+    spinner.stop();
+
+    const configs = result.data || result;
+    formatClientAgentList(Array.isArray(configs) ? configs : []);
+  } catch (err) {
+    const message = err.response?.data?.error || err.response?.data?.message || err.message;
+    console.log(chalk.red(`\n  ✗ Failed to list client agents: ${message}\n`));
+  }
+}
+
+// ── View Client ─────────────────────────────────────────
+
+export async function agentViewClientCommand(configId) {
+  if (!isAuthenticated()) {
+    console.log(chalk.red('  ✗ Authentication required. Run \'myvillage login\' first.\n'));
+    return;
+  }
+
+  try {
+    const spinner = villageSpinner('Loading client agent config...').start();
+    const result = await apiGetClientAgentConfig(configId);
+    spinner.stop();
+
+    const config = result.data || result;
+    formatClientAgentConfig(config);
+  } catch (err) {
+    const message = err.response?.data?.error || err.response?.data?.message || err.message;
+    console.log(chalk.red(`\n  ✗ Failed to load client agent config: ${message}\n`));
+  }
+}
+
+// ── Edit Client ─────────────────────────────────────────
+
+export async function agentEditClientCommand(configId) {
+  if (!isAuthenticated()) {
+    console.log(chalk.red('  ✗ Authentication required. Run \'myvillage login\' first.\n'));
+    return;
+  }
+
+  try {
+    const spinner = villageSpinner('Loading client agent config...').start();
+    const result = await apiGetClientAgentConfig(configId);
+    spinner.stop();
+
+    const config = result.data || result;
+
+    console.log(chalk.dim(`\n  Editing: ${config.clientName} (${config.clientId})\n`));
+
+    // Match current schedule to a preset
+    const currentPresetMatch = SCHEDULE_PRESETS.find(p => p.value === config.schedule);
+    const currentPreset = currentPresetMatch ? currentPresetMatch.value : (config.schedule ? 'CUSTOM' : '');
+
+    const answers = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'clientName',
+        message: 'Client name:',
+        default: config.clientName,
+      },
+      {
+        type: 'input',
+        name: 'baseUrl',
+        message: 'Base URL:',
+        default: config.baseUrl,
+        validate: input => {
+          try { new URL(input); return true; } catch { return 'Must be a valid URL.'; }
+        },
+      },
+      {
+        type: 'list',
+        name: 'workflowType',
+        message: 'Workflow type:',
+        choices: WORKFLOW_TYPES,
+        default: config.workflowType,
+      },
+      {
+        type: 'list',
+        name: 'schedulePreset',
+        message: 'Schedule:',
+        choices: SCHEDULE_PRESETS,
+        default: currentPreset,
+      },
+      {
+        type: 'input',
+        name: 'timezone',
+        message: 'Timezone:',
+        default: config.timezone || 'America/Chicago',
+      },
+      {
+        type: 'confirm',
+        name: 'isActive',
+        message: 'Active?',
+        default: config.isActive,
+      },
+    ]);
+
+    let schedule = answers.schedulePreset;
+    if (schedule === 'CUSTOM') {
+      const { customCron } = await inquirer.prompt([{
+        type: 'input',
+        name: 'customCron',
+        message: 'Cron expression:',
+        default: config.schedule || '',
+        validate: input => input.trim().split(/\s+/).length === 5 || 'Must be a 5-field cron expression.',
+      }]);
+      schedule = customCron;
+    }
+
+    const updateData = {
+      clientName: answers.clientName,
+      baseUrl: answers.baseUrl,
+      workflowType: answers.workflowType,
+      schedule: schedule || null,
+      timezone: answers.timezone,
+      isActive: answers.isActive,
+    };
+
+    const saveSpinner = villageSpinner('Saving changes...').start();
+    await apiUpdateClientAgentConfig(configId, updateData);
+    saveSpinner.succeed('Client agent config updated!');
+    console.log('');
+  } catch (err) {
+    const message = err.response?.data?.error || err.response?.data?.message || err.message;
+    console.log(chalk.red(`\n  ✗ Failed to update client agent config: ${message}\n`));
+  }
+}
+
+// ── Deactivate Client ───────────────────────────────────
+
+export async function agentDeactivateClientCommand(configId) {
+  if (!isAuthenticated()) {
+    console.log(chalk.red('  ✗ Authentication required. Run \'myvillage login\' first.\n'));
+    return;
+  }
+
+  try {
+    const { confirm } = await inquirer.prompt([{
+      type: 'confirm',
+      name: 'confirm',
+      message: `Deactivate client agent config ${configId}? This will stop all automated workflows.`,
+      default: false,
+    }]);
+
+    if (!confirm) {
+      console.log(chalk.dim('\n  Cancelled.\n'));
+      return;
+    }
+
+    const spinner = villageSpinner('Deactivating...').start();
+    await apiDeactivateClientAgent(configId);
+    spinner.succeed('Client agent deactivated.');
+    console.log('');
+  } catch (err) {
+    const message = err.response?.data?.error || err.response?.data?.message || err.message;
+    console.log(chalk.red(`\n  ✗ Failed to deactivate: ${message}\n`));
+  }
+}
+
+// ── Rotate Client Key ───────────────────────────────────
+
+export async function agentRotateClientKeyCommand(configId) {
+  if (!isAuthenticated()) {
+    console.log(chalk.red('  ✗ Authentication required. Run \'myvillage login\' first.\n'));
+    return;
+  }
+
+  try {
+    const { confirm } = await inquirer.prompt([{
+      type: 'confirm',
+      name: 'confirm',
+      message: `Rotate API key for ${configId}? The current key will be invalidated immediately.`,
+      default: false,
+    }]);
+
+    if (!confirm) {
+      console.log(chalk.dim('\n  Cancelled.\n'));
+      return;
+    }
+
+    const spinner = villageSpinner('Rotating API key...').start();
+    const result = await apiRotateClientAgentKey(configId);
+    spinner.succeed('API key rotated!');
+
+    displayApiKey(result.apiKey, configId);
+  } catch (err) {
+    const message = err.response?.data?.error || err.response?.data?.message || err.message;
+    console.log(chalk.red(`\n  ✗ Failed to rotate API key: ${message}\n`));
+  }
+}

package/src/commands/agent-grant.js

@@ -0,0 +1,131 @@
+import chalk from 'chalk';
+import { isAuthenticated } from '../utils/auth.js';
+import { readAgentConfig } from '../utils/local-agent.js';
+import { getPlatformClient } from '../utils/api.js';
+
+const VALID_PROVIDERS = ['google', 'microsoft', 'zoom'];
+
+function ensureAuthed() {
+  if (!isAuthenticated()) {
+    console.log(chalk.red("  ✗ Authentication required. Run 'myvillage login' first."));
+    return false;
+  }
+  return true;
+}
+
+function resolveAgentId(name) {
+  const config = readAgentConfig(name);
+  if (!config) {
+    console.log(chalk.red(`  ✗ Local agent "${name}" not found`));
+    return null;
+  }
+  const agentId = config?.man?.agent_id;
+  if (!agentId) {
+    console.log(
+      chalk.red(
+        `  ✗ Agent "${name}" has not been registered on the platform yet. ` +
+          `Run 'myvillage agent start ${name}' once to register it.`,
+      ),
+    );
+    return null;
+  }
+  return agentId;
+}
+
+function normalizeProvider(provider) {
+  const lc = (provider || '').toLowerCase();
+  if (!VALID_PROVIDERS.includes(lc)) {
+    console.log(
+      chalk.red(`  ✗ Invalid provider "${provider}". Must be one of: ${VALID_PROVIDERS.join(', ')}`),
+    );
+    return null;
+  }
+  return lc.toUpperCase();
+}
+
+function printApiError(err, fallback) {
+  const status = err?.response?.status;
+  const data = err?.response?.data;
+  const code = data?.code ? ` (${data.code})` : '';
+  const message = data?.error || err?.message || fallback;
+  console.log(chalk.red(`  ✗ ${message}${code}${status ? ` [HTTP ${status}]` : ''}`));
+}
+
+// ── List grants ────────────────────────────────────────────
+
+export async function agentGrantsCommand(name) {
+  if (!ensureAuthed()) return;
+  const agentId = resolveAgentId(name);
+  if (!agentId) return;
+
+  const client = getPlatformClient();
+  try {
+    const response = await client.get(`/agents/${agentId}/credential-grants`);
+    const grants = response.data?.data ?? [];
+    if (grants.length === 0) {
+      console.log(chalk.dim(`  No active credential grants for agent "${name}".`));
+      console.log(chalk.dim(`  Grant one with: myvillage agent grant ${name} <google|microsoft|zoom>`));
+      return;
+    }
+    console.log(chalk.bold(`Active credential grants for "${name}" (${agentId}):\n`));
+    for (const g of grants) {
+      const granted = new Date(g.grantedAt).toISOString().slice(0, 10);
+      console.log(`  - ${chalk.cyan(g.provider)}  granted ${granted}`);
+    }
+  } catch (err) {
+    printApiError(err, 'Failed to list grants');
+  }
+}
+
+// ── Grant a provider ───────────────────────────────────────
+
+export async function agentGrantCommand(name, provider) {
+  if (!ensureAuthed()) return;
+  const agentId = resolveAgentId(name);
+  if (!agentId) return;
+  const upperProvider = normalizeProvider(provider);
+  if (!upperProvider) return;
+
+  const client = getPlatformClient();
+  try {
+    await client.post(`/agents/${agentId}/credential-grants`, { provider: upperProvider });
+    console.log(
+      chalk.green(`  ✓ Granted ${upperProvider} to agent "${name}".`) +
+        chalk.dim(`\n    The agent can now use ${upperProvider}-backed tools (e.g. gmail_send).`),
+    );
+  } catch (err) {
+    if (err?.response?.status === 404 && err?.response?.data?.code === 'CREDENTIAL_NOT_CONNECTED') {
+      console.log(
+        chalk.yellow(
+          `  ⚠ You haven't connected ${upperProvider} yet. ` +
+            `Connect it from the mobile app or web portal, then re-run this command.`,
+        ),
+      );
+      return;
+    }
+    printApiError(err, 'Failed to grant provider');
+  }
+}
+
+// ── Revoke a provider ──────────────────────────────────────
+
+export async function agentRevokeCommand(name, provider) {
+  if (!ensureAuthed()) return;
+  const agentId = resolveAgentId(name);
+  if (!agentId) return;
+  const upperProvider = normalizeProvider(provider);
+  if (!upperProvider) return;
+
+  const client = getPlatformClient();
+  try {
+    await client.delete(`/agents/${agentId}/credential-grants/${upperProvider}`);
+    console.log(
+      chalk.green(`  ✓ Revoked ${upperProvider} from agent "${name}".`) +
+        chalk.dim(
+          `\n    Tools using ${upperProvider} will fail within ~60 seconds (cache TTL).`,
+        ),
+    );
+  } catch (err) {
+    printApiError(err, 'Failed to revoke provider');
+  }
+}