@integrity-labs/agt-cli 0.10.0 → 0.10.2

package/dist/bin/agt.js

@@ -1,6 +1,5 @@
 #!/usr/bin/env node
 import {
-  AGT_HOST,
   ApiError,
   CHANNEL_REGISTRY,
   DEPLOYMENT_TEMPLATES,
@@ -21,6 +20,7 @@ import {
   getChannel,
   getDefaultSlackScopes,
   getFramework,
+  getHost,
   getHostId,
   getScopesByCategory,
   getTemplate,
@@ -32,7 +32,7 @@ import {
   resolveChannels,
   serializeManifestForSlackCli,
   setActiveTeam
-} from "../chunk-UWH2MMKY.js";
+} from "../chunk-VCKY6MN2.js";
 
 // src/bin/agt.ts
 import { join as join11 } from "path";
@@ -107,7 +107,7 @@ async function whoamiCommand() {
       jsonOutput({
         ok: true,
         api_key_prefix: apiKey.slice(0, 8) + "****",
-        host: AGT_HOST ?? null,
+        host: getHost() ?? null,
         host_id: exchange.hostId,
         team: exchange.teamSlug,
         team_id: exchange.teamId,
@@ -117,7 +117,7 @@ async function whoamiCommand() {
     }
     success("Authenticated via API key");
     info(`API Key:    ${chalk3.bold(apiKey.slice(0, 8) + "****")}`);
-    info(`Host:       ${chalk3.bold(AGT_HOST ?? "not set")}`);
+    info(`Host:       ${chalk3.bold(getHost() ?? "not set")}`);
     info(`Host ID:    ${exchange.hostId}`);
     info(`Team:       ${chalk3.bold(exchange.teamSlug ?? exchange.teamId)}`);
     info(`User:       ${chalk3.bold(exchange.userEmail ?? "unknown")}`);
@@ -2172,7 +2172,7 @@ function getManagerStatus() {
 // src/commands/manager.ts
 function managerStartCommand(opts) {
   const json = isJsonMode();
-  if (!AGT_HOST) {
+  if (!getHost()) {
     const msg = "AGT_HOST is not set. Export it to point at the Augmented API (e.g. export AGT_HOST=https://your-api.example.com)";
     if (json) {
       jsonOutput({ ok: false, error: msg });
@@ -3411,9 +3411,9 @@ async function acpxCloseCommand(agent2, _opts, cmd) {
 import { execSync } from "child_process";
 import chalk19 from "chalk";
 import ora15 from "ora";
-var cliVersion = true ? "0.10.0" : "dev";
+var cliVersion = true ? "0.10.2" : "dev";
 async function fetchLatestVersion() {
-  const host2 = AGT_HOST;
+  const host2 = getHost();
   if (!host2) return null;
   try {
     const controller = new AbortController();
@@ -3583,8 +3583,234 @@ async function checkForUpdateOnStartup() {
   }
 }
 
+// src/commands/plugin.ts
+import chalk20 from "chalk";
+import ora16 from "ora";
+async function pluginListCommand() {
+  const json = isJsonMode();
+  const spinner = ora16({ text: "Fetching plugins\u2026", isSilent: json }).start();
+  try {
+    const data = await api.get("/plugins");
+    spinner.stop();
+    if (json) {
+      jsonOutput({ plugins: data });
+      return;
+    }
+    if (!data.length) {
+      info("No plugins found for this team.");
+      return;
+    }
+    console.log(chalk20.bold("\nAvailable Plugins:\n"));
+    for (const p of data) {
+      const statusColor = p.status === "published" ? chalk20.green : p.status === "archived" ? chalk20.gray : chalk20.yellow;
+      console.log(
+        `  ${chalk20.bold(p.name)} ${chalk20.dim(`(${p.slug})`)}  ${statusColor(p.status)} v${p.version}  ${chalk20.dim(`${p.skills?.length ?? 0} skills, ${p.defined_scopes?.length ?? 0} scopes`)}`
+      );
+    }
+    console.log();
+  } catch (err) {
+    spinner.stop();
+    handleError(err);
+  }
+}
+async function pluginShowCommand(slug) {
+  const json = isJsonMode();
+  const spinner = ora16({ text: "Fetching plugin\u2026", isSilent: json }).start();
+  try {
+    const all = await api.get("/plugins");
+    const plugin2 = all.find((p) => p.slug === slug);
+    if (!plugin2) {
+      spinner.stop();
+      error(`Plugin "${slug}" not found.`);
+      process.exitCode = 1;
+      return;
+    }
+    const scopes = await api.get(`/plugins/${plugin2.id}/scopes`);
+    spinner.stop();
+    if (json) {
+      jsonOutput({ plugin: plugin2, scopes });
+      return;
+    }
+    console.log(chalk20.bold(`
+${plugin2.name}`), chalk20.dim(`(${plugin2.slug})`));
+    if (plugin2.description) console.log(chalk20.dim(plugin2.description));
+    console.log();
+    console.log(`  Status:    ${plugin2.status} v${plugin2.version}`);
+    console.log(`  Category:  ${plugin2.category}`);
+    console.log(`  Toolkits:  ${plugin2.required_toolkits.join(", ") || "none"}`);
+    console.log(`  Skills:    ${plugin2.skills?.length ?? 0}`);
+    if (scopes.length > 0) {
+      console.log(chalk20.bold("\n  Permission Scopes:\n"));
+      for (const s of scopes) {
+        const roleColor = s.can_grant ? chalk20.green : chalk20.red;
+        const overrideTag = s.is_overridden ? chalk20.cyan(" [team override]") : "";
+        console.log(
+          `    ${chalk20.bold(s.id)}  ${s.name}  min: ${roleColor(s.effective_min_role)}${overrideTag}  ${s.can_grant ? chalk20.green("\u2713 grantable") : chalk20.red("\u2717 needs approval")}`
+        );
+      }
+    }
+    console.log();
+  } catch (err) {
+    spinner.stop();
+    handleError(err);
+  }
+}
+async function pluginInstallCommand(slug, options) {
+  const json = isJsonMode();
+  const spinner = ora16({ text: "Installing plugin\u2026", isSilent: json }).start();
+  try {
+    const all = await api.get("/plugins");
+    const plugin2 = all.find((p) => p.slug === slug);
+    if (!plugin2) {
+      spinner.stop();
+      error(`Plugin "${slug}" not found.`);
+      process.exitCode = 1;
+      return;
+    }
+    const agents = await api.get("/agents");
+    const agent2 = agents.find((a) => a.code_name === options.agent);
+    if (!agent2) {
+      spinner.stop();
+      error(`Agent "${options.agent}" not found.`);
+      process.exitCode = 1;
+      return;
+    }
+    const scopes = options.scopes?.split(",").map((s) => s.trim()).filter(Boolean) ?? [];
+    const result = await api.post("/plugins/install", {
+      agent_id: agent2.agent_id,
+      plugin_id: plugin2.id,
+      scopes
+    });
+    spinner.stop();
+    if (json) {
+      jsonOutput({ agent_plugin: result });
+      return;
+    }
+    success(`Installed "${plugin2.name}" on agent "${options.agent}"`);
+    if (scopes.length) {
+      info(`Granted scopes: ${scopes.join(", ")}`);
+    }
+  } catch (err) {
+    spinner.stop();
+    if (err instanceof ApiError && err.status === 403 && err.body["needs_approval"]) {
+      const needsApproval = err.body["needs_approval"];
+      error("Some scopes exceed your role ceiling:");
+      for (const s of needsApproval) {
+        console.log(chalk20.yellow(`  - ${s}`));
+      }
+      info("To request elevated scopes, use the web dashboard or contact your team admin.");
+      process.exitCode = 1;
+      return;
+    }
+    handleError(err);
+  }
+}
+async function pluginUninstallCommand(slug, options) {
+  const json = isJsonMode();
+  const spinner = ora16({ text: "Uninstalling plugin\u2026", isSilent: json }).start();
+  try {
+    const all = await api.get("/plugins");
+    const plugin2 = all.find((p) => p.slug === slug);
+    if (!plugin2) {
+      spinner.stop();
+      error(`Plugin "${slug}" not found.`);
+      process.exitCode = 1;
+      return;
+    }
+    const agents = await api.get("/agents");
+    const agent2 = agents.find((a) => a.code_name === options.agent);
+    if (!agent2) {
+      spinner.stop();
+      error(`Agent "${options.agent}" not found.`);
+      process.exitCode = 1;
+      return;
+    }
+    await api.post("/plugins/uninstall", {
+      agent_id: agent2.agent_id,
+      plugin_id: plugin2.id
+    });
+    spinner.stop();
+    success(`Uninstalled "${plugin2.name}" from agent "${options.agent}"`);
+  } catch (err) {
+    spinner.stop();
+    handleError(err);
+  }
+}
+async function pluginRequestsCommand() {
+  const json = isJsonMode();
+  const spinner = ora16({ text: "Fetching scope requests\u2026", isSilent: json }).start();
+  try {
+    const requests = await api.get("/plugins/scope-requests");
+    spinner.stop();
+    if (json) {
+      jsonOutput({ requests });
+      return;
+    }
+    if (!requests.length) {
+      info("No pending scope requests.");
+      return;
+    }
+    console.log(chalk20.bold("\nPending Scope Requests:\n"));
+    for (const r of requests) {
+      console.log(`  ${chalk20.bold(r.id)}  scopes: ${r.requested_scopes.join(", ")}`);
+      if (r.reason) console.log(`    reason: ${chalk20.dim(r.reason)}`);
+      console.log(`    status: ${r.status}  requested: ${r.created_at}`);
+      console.log();
+    }
+  } catch (err) {
+    spinner.stop();
+    handleError(err);
+  }
+}
+async function pluginApproveCommand(requestId, options) {
+  const json = isJsonMode();
+  const spinner = ora16({ text: "Approving request\u2026", isSilent: json }).start();
+  try {
+    const result = await api.put(`/plugins/scope-requests/${requestId}`, {
+      status: "approved",
+      review_notes: options.notes
+    });
+    spinner.stop();
+    if (json) {
+      jsonOutput(result);
+      return;
+    }
+    success(`Scope request ${requestId} approved. Scopes have been granted.`);
+  } catch (err) {
+    spinner.stop();
+    handleError(err);
+  }
+}
+async function pluginDenyCommand(requestId, options) {
+  const json = isJsonMode();
+  const spinner = ora16({ text: "Denying request\u2026", isSilent: json }).start();
+  try {
+    const result = await api.put(`/plugins/scope-requests/${requestId}`, {
+      status: "denied",
+      review_notes: options.reason
+    });
+    spinner.stop();
+    if (json) {
+      jsonOutput(result);
+      return;
+    }
+    success(`Scope request ${requestId} denied.`);
+  } catch (err) {
+    spinner.stop();
+    handleError(err);
+  }
+}
+function handleError(err) {
+  if (err instanceof ApiError) {
+    error(`API error (${err.status}): ${err.message}`);
+  } else {
+    error(err.message);
+  }
+  process.exitCode = 1;
+}
+
 // src/bin/agt.ts
-var cliVersion2 = true ? "0.10.0" : "dev";
+var cliVersion2 = true ? "0.10.2" : "dev";
 var program = new Command();
 program.name("agt").description("Augmented CLI \u2014 agent provisioning and management").version(cliVersion2).option("--json", "Emit machine-readable JSON output (suppress spinners and colors)").option("--skip-update-check", "Skip the automatic update check on startup");
 program.hook("preAction", (thisCommand) => {
@@ -3647,6 +3873,14 @@ acpx.command("exec <agent> <prompt>").description("One-shot execution (no sessio
 acpx.command("list-sessions <agent>").description("List active ACP sessions for an agent").action(acpxListSessionsCommand);
 acpx.command("cancel <agent>").description("Send cooperative cancel to the running ACP session").action(acpxCancelCommand);
 acpx.command("close <agent>").description("Soft-close an ACP session (preserves history)").action(acpxCloseCommand);
+var plugin = program.command("plugin").description("Manage plugins \u2014 install, configure, and control permission scopes");
+plugin.command("list").description("List available plugins for the active team").action(pluginListCommand);
+plugin.command("show <slug>").description("Show plugin details including permission scopes").action(pluginShowCommand);
+plugin.command("install <slug>").description("Install a plugin on an agent").requiredOption("--agent <code-name>", "Agent code name").option("--scopes <scopes>", "Comma-separated scope IDs to grant").action(pluginInstallCommand);
+plugin.command("uninstall <slug>").description("Remove a plugin from an agent").requiredOption("--agent <code-name>", "Agent code name").action(pluginUninstallCommand);
+plugin.command("requests").description("List pending scope approval requests for the team").action(pluginRequestsCommand);
+plugin.command("approve <request-id>").description("Approve a scope request").option("--notes <text>", "Review notes").action(pluginApproveCommand);
+plugin.command("deny <request-id>").description("Deny a scope request").option("--reason <text>", "Denial reason").action(pluginDenyCommand);
 program.command("update").description("Check for and install CLI updates").option("--force", "Update even if manager or agent sessions are running").action(updateCommand);
 var skipUpdateCheck = process.argv.includes("--skip-update-check") || process.argv.includes("--json") || process.argv[2] === "update";
 if (!skipUpdateCheck) {