@stndrds/cli 1.0.0-alpha.277 → 1.0.0-alpha.278

package/dist/bin.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/program.ts
-import chalk8 from "chalk";
+import chalk9 from "chalk";
 import { Command } from "commander";
 
 // src/client.ts
@@ -250,13 +250,25 @@ function registerBundlesCommand(program) {
 }
 
 // src/commands/connectors.ts
+import { ValidationError } from "@stndrds/schema";
 import chalk3 from "chalk";
-var PROVIDERS = ["gmail", "outlook"];
+var PROVIDER_IDS = {
+  gmail: true,
+  outlook: true,
+  "google-calendar": true,
+  "outlook-calendar": true
+};
+var PROVIDERS = Object.keys(PROVIDER_IDS);
 function resolveScope(scope) {
   return scope === "actor" ? "actor" : "tenant";
 }
 function registerConnectorsCommand(program) {
-  const connectors = program.command("connectors").description("Manage email connectors (Gmail / Outlook OAuth connections)");
+  const connectors = program.command("connectors").description("Manage email and calendar connectors (OAuth connections)");
+  connectors.command("providers").description("List the connector providers this deployment holds credentials for").action(async (_opts, cmd) => {
+    const client = getClientFromCommand(cmd);
+    const result = await client.get("/connectors/providers");
+    formatOutput(result, getFormat(cmd));
+  });
   connectors.command("list").description("List connector connections").option("--scope <scope>", "connection scope (tenant or actor)", "tenant").action(async (opts, cmd) => {
     const client = getClientFromCommand(cmd);
     const result = await client.get("/connectors/connections", {
@@ -264,9 +276,12 @@ function registerConnectorsCommand(program) {
     });
     formatOutput(result, getFormat(cmd));
   });
-  connectors.command("connect").description("Start an OAuth flow and return the authorization URL to open").requiredOption("--provider <provider>", "connector provider (gmail or outlook)").option("--scope <scope>", "connection scope (tenant or actor)", "tenant").action(async (opts, cmd) => {
+  connectors.command("connect").description("Start an OAuth flow and return the authorization URL to open").requiredOption(
+    "--provider <provider>",
+    `connector provider (${PROVIDERS.join(", ")}); run "connectors providers" for the ones this deployment configured`
+  ).option("--scope <scope>", "connection scope (tenant or actor)", "tenant").action(async (opts, cmd) => {
     if (!PROVIDERS.includes(opts.provider)) {
-      throw new Error(`--provider must be one of: ${PROVIDERS.join(", ")}`);
+      throw new ValidationError(`--provider must be one of: ${PROVIDERS.join(", ")}`, []);
     }
     const client = getClientFromCommand(cmd);
     const result = await client.post("/connectors/auth/start", {
@@ -429,8 +444,155 @@ function registerKeysCommand(program) {
   });
 }
 
-// src/commands/pull.ts
+// src/commands/mcp.ts
+import { RESOURCE_VISIBILITIES, ValidationError as ValidationError2 } from "@stndrds/schema";
 import chalk5 from "chalk";
+var AUTH_TYPES = ["none", "header"];
+function buildAuth(opts) {
+  const type = opts.authType ?? "none";
+  if (!AUTH_TYPES.includes(type)) {
+    throw new ValidationError2(`--auth-type must be one of: ${AUTH_TYPES.join(", ")}`, []);
+  }
+  if (type === "none") {
+    return { type: "none" };
+  }
+  if (!(opts.headerName && opts.secret)) {
+    throw new ValidationError2('--auth-type "header" requires both --header-name and --secret.', []);
+  }
+  return { type: "header", headerName: opts.headerName, secret: opts.secret };
+}
+function resolveVisibility(visibility) {
+  if (visibility === void 0) {
+    return "workspace";
+  }
+  if (!RESOURCE_VISIBILITIES.includes(visibility)) {
+    throw new ValidationError2(
+      `--visibility must be one of: ${RESOURCE_VISIBILITIES.join(", ")}`,
+      []
+    );
+  }
+  return visibility;
+}
+function registerMcpCommand(program) {
+  const mcp = program.command("mcp").description("Manage MCP servers mounted into this workspace's agents");
+  mcp.command("list").description("List connected MCP servers").action(async (_opts, cmd) => {
+    const client = getClientFromCommand(cmd);
+    const result = await client.get("/mcp-servers");
+    formatOutput(result, getFormat(cmd));
+  });
+  mcp.command("catalog").description("List the vendored MCP catalog entries available to connect").action(async (_opts, cmd) => {
+    const client = getClientFromCommand(cmd);
+    const result = await client.get("/mcp-servers/catalog");
+    formatOutput(result, getFormat(cmd));
+  });
+  mcp.command("connect").description("Connect a remote MCP server and mount its tools").requiredOption("--slug <slug>", "unique slug for the server").requiredOption("--name <name>", "display name").requiredOption("--url <url>", "remote MCP endpoint URL").option("--visibility <visibility>", "workspace or private", "workspace").option("--catalog-entry <id>", "catalog entry ID this server instantiates").option("--auth-type <type>", "none or header", "none").option("--header-name <name>", 'header name when --auth-type is "header"').option("--secret <secret>", 'header value when --auth-type is "header"').action(async (opts, cmd) => {
+    const auth = buildAuth(opts);
+    const visibility = resolveVisibility(opts.visibility);
+    const client = getClientFromCommand(cmd);
+    const result = await client.post("/mcp-servers", {
+      slug: opts.slug,
+      name: opts.name,
+      url: opts.url,
+      visibility,
+      catalogEntryId: opts.catalogEntry ?? null,
+      auth
+    });
+    formatOutput(result, getFormat(cmd));
+  });
+  mcp.command("refresh").description("Re-discover a server's tools and refresh its status").argument("<id>", "MCP server ID").action(async (id, _opts, cmd) => {
+    const client = getClientFromCommand(cmd);
+    const result = await client.post(`/mcp-servers/${id}/refresh`);
+    formatOutput(result, getFormat(cmd));
+  });
+  mcp.command("trust").description("Mark a server trusted so its tools run without per-call approval").argument("<id>", "MCP server ID").option("--revoke", "revoke trust instead of granting it").action(async (id, opts, cmd) => {
+    const trusted = !opts.revoke;
+    const client = getClientFromCommand(cmd);
+    await client.post(`/mcp-servers/${id}/trust`, { trusted });
+    process.stdout.write(
+      `${chalk5.green("\u2713")} MCP server ${id} ${trusted ? "trusted" : "untrusted"}.
+`
+    );
+  });
+  mcp.command("disconnect").description("Disconnect (delete) an MCP server").argument("<id>", "MCP server ID").option("--yes", "disconnect without confirmation").action(async (id, opts, cmd) => {
+    if (!opts.yes) {
+      throw new ValidationError2(
+        'Disconnecting an MCP server is explicit. Re-run with "--yes" to confirm.',
+        []
+      );
+    }
+    const client = getClientFromCommand(cmd);
+    await client.delete(`/mcp-servers/${id}`);
+    process.stdout.write(`${chalk5.green("\u2713")} MCP server ${id} disconnected.
+`);
+  });
+}
+
+// src/commands/meetings.ts
+import { ValidationError as ValidationError3 } from "@stndrds/schema";
+var ORDERS = ["asc", "desc"];
+function parseOrder(order) {
+  if (ORDERS.includes(order)) return order;
+  throw new ValidationError3(`--order must be one of: ${ORDERS.join(", ")}`, []);
+}
+function parseCount(flag, value) {
+  const parsed = Number(value);
+  if (!Number.isInteger(parsed) || parsed < 0) {
+    throw new ValidationError3(`${flag} must be a non-negative integer`, []);
+  }
+  return parsed;
+}
+function buildQuery(opts) {
+  const query = {};
+  if (opts.search !== void 0) query.search = opts.search;
+  if (opts.since !== void 0) query.since = opts.since;
+  if (opts.before !== void 0) query.before = opts.before;
+  if (opts.addresses !== void 0) query.addresses = parseCsvList(opts.addresses);
+  if (opts.record !== void 0) query.recordId = opts.record;
+  if (opts.order !== void 0) query.order = parseOrder(opts.order);
+  if (opts.limit !== void 0) query.limit = parseCount("--limit", opts.limit);
+  if (opts.offset !== void 0) query.offset = parseCount("--offset", opts.offset);
+  return query;
+}
+function withQueryOptions(command) {
+  return command.option("--search <text>", "match title, description and location").option("--since <iso>", "inclusive ISO lower bound on the start").option("--before <iso>", "exclusive ISO upper bound on the start").option("--addresses <emails>", "comma-separated participant addresses to restrict to").option("--record <id>", "only meetings linked to this record").option("--order <order>", "asc for what is coming next, desc to read history").option("--limit <n>", "max meetings to return").option("--offset <n>", "number of meetings to skip");
+}
+function registerMeetingsCommand(program) {
+  const meetings = program.command("meetings").description("Read calendar meetings and the records each one concerns");
+  withQueryOptions(
+    meetings.command("list").description("List meetings, newest window first by default")
+  ).action(async (opts, cmd) => {
+    const client = getClientFromCommand(cmd);
+    const result = await client.post("/meetings/search", buildQuery(opts));
+    formatOutput(result, getFormat(cmd));
+  });
+  meetings.command("get").description("Get one meeting, with its participants and linked records").argument("<id>", "meeting ID").action(async (id, _opts, cmd) => {
+    const client = getClientFromCommand(cmd);
+    const result = await client.get(`/meetings/${id}`);
+    formatOutput(result, getFormat(cmd));
+  });
+  withQueryOptions(
+    meetings.command("for-record").description("List the meetings a record's email addresses appear in").argument("<recordId>", "record ID").option(
+      "--email-attributes <ids>",
+      "comma-separated email attribute IDs to match participants on"
+    )
+  ).action(
+    async (recordId, opts, cmd) => {
+      const client = getClientFromCommand(cmd);
+      const result = await client.post(`/meetings/records/${recordId}`, {
+        // The API defaults an absent list to none, which matches nothing —
+        // send the key only when the caller named the attributes.
+        ...opts.emailAttributes !== void 0 && {
+          emailAttributeIds: parseCsvList(opts.emailAttributes)
+        },
+        query: buildQuery(opts)
+      });
+      formatOutput(result, getFormat(cmd));
+    }
+  );
+}
+
+// src/commands/pull.ts
+import chalk6 from "chalk";
 
 // src/drift/reconciliation-prompt.ts
 var PREAMBLE = [
@@ -515,7 +677,7 @@ function registerPullCommand(program) {
     try {
       client = getClientFromCommand(cmd);
     } catch (error) {
-      console.error(chalk5.red(`\u2717 ${messageOf(error)}`));
+      console.error(chalk6.red(`\u2717 ${messageOf(error)}`));
       process.exit(2);
       return;
     }
@@ -525,14 +687,14 @@ function registerPullCommand(program) {
         console.info(JSON.stringify(state, null, 2));
         process.exit(0);
       } catch (error) {
-        console.error(chalk5.red(`\u2717 ${messageOf(error)}`));
+        console.error(chalk6.red(`\u2717 ${messageOf(error)}`));
         process.exit(2);
       }
       return;
     }
     const result = await runPullCommand(client);
     if (result.exitCode === 2) {
-      console.error(chalk5.red(`\u2717 ${result.errorMessage}`));
+      console.error(chalk6.red(`\u2717 ${result.errorMessage}`));
       process.exit(2);
       return;
     }
@@ -628,7 +790,7 @@ function registerRecordsCommand(program) {
 // src/commands/root.ts
 import { stdin as input, stdout as output } from "process";
 import { createInterface } from "readline/promises";
-import chalk6 from "chalk";
+import chalk7 from "chalk";
 
 // src/config.ts
 import { mkdir, readFile as readFile3, rm, writeFile } from "fs/promises";
@@ -768,7 +930,7 @@ function registerRootCommands(program) {
     await client.get("/api-keys");
     await upsertProfile({ name: opts.name, apiUrl: opts.url, apiKey });
     process.stdout.write(
-      `${chalk6.green("\u2713")} Standards instance "${opts.name}" saved and selected.
+      `${chalk7.green("\u2713")} Standards instance "${opts.name}" saved and selected.
 `
     );
     process.stdout.write(`  API URL: ${opts.url}
@@ -780,7 +942,7 @@ function registerRootCommands(program) {
   });
   program.command("use").description("Select the active Standards instance").argument("<name>", "instance name").action(async (name) => {
     await setCurrentProfile(name);
-    process.stdout.write(`${chalk6.green("\u2713")} Standards instance "${name}" selected.
+    process.stdout.write(`${chalk7.green("\u2713")} Standards instance "${name}" selected.
 `);
   });
   program.command("instances").description("List configured Standards instances").action(async (_opts, cmd) => {
@@ -799,7 +961,7 @@ function registerRootCommands(program) {
   });
   program.command("logout").description("Remove a Standards instance from local CLI config").argument("[name]", "instance name, defaults to current").action(async (name) => {
     await removeProfile(name);
-    process.stdout.write(`${chalk6.green("\u2713")} Standards instance removed.
+    process.stdout.write(`${chalk7.green("\u2713")} Standards instance removed.
 `);
   });
 }
@@ -820,7 +982,7 @@ function registerSchemaCommand(program) {
 }
 
 // src/commands/search.ts
-import chalk7 from "chalk";
+import chalk8 from "chalk";
 function registerSearchCommand(program) {
   const search = program.command("search").description("Maintain the Standards search index");
   search.command("reindex").description("Clear the tenant search index and re-inject every record").option("--yes", "reindex without confirmation").action(async (opts, cmd) => {
@@ -838,7 +1000,7 @@ function registerSearchCommand(program) {
     const client = getClientFromCommand(cmd);
     await client.post("/admin/search/full-reindex", { tenantId: tenant });
     process.stdout.write(
-      `${chalk7.green("\u2713")} Full reindex accepted for tenant ${tenant}. It runs in the background \u2014 follow the server logs for progress.
+      `${chalk8.green("\u2713")} Full reindex accepted for tenant ${tenant}. It runs in the background \u2014 follow the server logs for progress.
 `
     );
   });
@@ -863,6 +1025,8 @@ function createProgram() {
   registerAuthCommand(program);
   registerBundlesCommand(program);
   registerConnectorsCommand(program);
+  registerMcpCommand(program);
+  registerMeetingsCommand(program);
   registerSearchCommand(program);
   program.hook("preAction", async (_thisCommand, actionCommand) => {
     const raw = program.opts();
@@ -877,7 +1041,7 @@ function createProgram() {
     program.setOptionValue("tenant", raw.tenant);
     if (!(resolved.apiKey || isPublicCommand(actionCommand))) {
       console.error(
-        chalk8.red(
+        chalk9.red(
           `\u2717 Error: No Standards instance configured. Run "standards login" or pass --api-key.`
         )
       );
@@ -891,12 +1055,12 @@ async function runProgram(argv = process.argv) {
   await program.parseAsync(argv).catch((error) => {
     if (error instanceof ApiClientError) {
       if (error.statusCode > 0) {
-        console.error(chalk8.red(`\u2717 Error (${error.statusCode}): ${error.message}`));
+        console.error(chalk9.red(`\u2717 Error (${error.statusCode}): ${error.message}`));
       } else {
-        console.error(chalk8.red(`\u2717 Error: ${error.message}`));
+        console.error(chalk9.red(`\u2717 Error: ${error.message}`));
       }
     } else if (error instanceof Error) {
-      console.error(chalk8.red(`\u2717 Error: ${error.message}`));
+      console.error(chalk9.red(`\u2717 Error: ${error.message}`));
     }
     process.exit(1);
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stndrds/cli",
-  "version": "1.0.0-alpha.277",
+  "version": "1.0.0-alpha.278",
   "description": "CLI tool to interact with Standards API",
   "type": "module",
   "bin": {
@@ -13,7 +13,7 @@
     "chalk": "^5.4.1",
     "cli-table3": "^0.6.5",
     "commander": "^13.1.0",
-    "@stndrds/schema": "1.0.0-alpha.277"
+    "@stndrds/schema": "1.0.0-alpha.278"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",