@hmawla/co-assistant 1.0.2 → 1.0.3

package/README.md

@@ -320,7 +320,10 @@ All configured via `.env` (the setup wizard handles this):
 | `co-assistant start -v` | Start with verbose logging |
 | `co-assistant model` | Show current AI model |
 | `co-assistant model <name>` | Switch AI model |
-| `co-assistant plugin list` | List discovered plugins |
+| `co-assistant plugin list` | List discovered plugins in local `plugins/` |
+| `co-assistant plugin available` | List bundled first-party plugins |
+| `co-assistant plugin install <id>` | Install a bundled plugin into `plugins/` |
+| `co-assistant plugin install --all` | Install all bundled plugins |
 | `co-assistant plugin enable <name>` | Enable a plugin |
 | `co-assistant plugin disable <name>` | Disable a plugin |
 | `co-assistant plugin configure <name>` | Set up plugin credentials |
@@ -385,6 +388,24 @@ Both files are injected as system-level context on every message:
 | **Gmail** | Search emails, read email, send email, send reply |
 | **Google Calendar** | List events, create event, update event, delete event |
 
+### Install Plugins
+
+Co-Assistant ships with first-party plugins (Gmail, Google Calendar). If you installed via npm, they aren't in your working directory yet — install them with:
+
+```bash
+# See what's available
+co-assistant plugin available
+
+# Install a specific plugin
+co-assistant plugin install gmail
+
+# Install all bundled plugins at once
+co-assistant plugin install --all
+
+# Overwrite an existing plugin (e.g. after an update)
+co-assistant plugin install gmail --force
+```
+
 ### Enable a Plugin
 
 ```bash

package/dist/cli/index.js

@@ -3409,7 +3409,7 @@ ${question}`);
   }
 }
 async function promptFilePath(question) {
-  const { existsSync: existsSync9, readFileSync: readFileSync6 } = await import("fs");
+  const { existsSync: existsSync9, readFileSync: readFileSync7 } = await import("fs");
   const { resolve } = await import("path");
   while (true) {
     const raw = await ask(`${question}: `);
@@ -3423,7 +3423,7 @@ async function promptFilePath(question) {
       continue;
     }
     try {
-      return readFileSync6(filePath, "utf-8");
+      return readFileSync7(filePath, "utf-8");
     } catch {
       console.log(`  \u26A0 Could not read file: ${filePath}`);
     }
@@ -3968,8 +3968,45 @@ Configuring plugin: ${manifest.id}`);
 }
 
 // src/cli/commands/plugin.ts
-import { existsSync as existsSync7, mkdirSync as mkdirSync4, writeFileSync as writeFileSync5 } from "fs";
+import {
+  existsSync as existsSync7,
+  mkdirSync as mkdirSync4,
+  writeFileSync as writeFileSync5,
+  readdirSync as readdirSync3,
+  readFileSync as readFileSync6,
+  cpSync
+} from "fs";
 import path4 from "path";
+import { fileURLToPath } from "url";
+function getPackagePluginsDir() {
+  const thisFile = fileURLToPath(import.meta.url);
+  const pkgRoot = path4.resolve(path4.dirname(thisFile), "..", "..", "..");
+  const pluginsDir = path4.join(pkgRoot, "plugins");
+  if (!existsSync7(pluginsDir)) {
+    const altRoot = path4.resolve(path4.dirname(thisFile), "..", "..");
+    const altDir = path4.join(altRoot, "plugins");
+    if (existsSync7(altDir)) return altDir;
+  }
+  return pluginsDir;
+}
+function discoverBundledPlugins() {
+  const pkgPluginsDir = getPackagePluginsDir();
+  if (!existsSync7(pkgPluginsDir)) return [];
+  const entries = readdirSync3(pkgPluginsDir, { withFileTypes: true });
+  const results = [];
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    const manifestPath = path4.join(pkgPluginsDir, entry.name, "plugin.json");
+    if (!existsSync7(manifestPath)) continue;
+    try {
+      const raw = readFileSync6(manifestPath, "utf-8");
+      const manifest = JSON.parse(raw);
+      results.push({ ...manifest, sourcePath: path4.join(pkgPluginsDir, entry.name) });
+    } catch {
+    }
+  }
+  return results;
+}
 async function loadRegistry() {
   const registry = createPluginRegistry();
   const manifests = await registry.discoverPlugins();
@@ -4187,9 +4224,77 @@ Edit \`tools.ts\` to add or modify the tools this plugin exposes.
   writeFileSync5(path4.join(pluginDir, "README.md"), readmeContent, "utf-8");
   console.log(`\u2713 Plugin '${pluginId}' scaffolded at plugins/${pluginId}/`);
 }
+async function handleAvailable() {
+  const bundled = discoverBundledPlugins();
+  if (bundled.length === 0) {
+    console.log("\n\u{1F4E6} No bundled first-party plugins found.\n");
+    return;
+  }
+  const localPluginsDir = path4.join(process.cwd(), "plugins");
+  console.log("\n\u{1F4E6} Available First-Party Plugins:\n");
+  for (const plugin of bundled) {
+    const localDir = path4.join(localPluginsDir, plugin.id);
+    const installed = existsSync7(path4.join(localDir, "plugin.json"));
+    const status = installed ? "\u2705 Installed" : "\u2B07\uFE0F  Not installed";
+    console.log(`  ${plugin.id} (v${plugin.version}) \u2014 ${plugin.name}`);
+    console.log(`    ${plugin.description}`);
+    console.log(`    ${status}
+`);
+  }
+  console.log("  Install with: co-assistant plugin install <id>");
+  console.log("  Install all:  co-assistant plugin install --all\n");
+}
+async function handleInstall(pluginId, options) {
+  const bundled = discoverBundledPlugins();
+  if (bundled.length === 0) {
+    console.error("\u2717 No bundled first-party plugins found in the package.");
+    process.exit(1);
+  }
+  let toInstall;
+  if (options.all) {
+    toInstall = bundled;
+  } else if (pluginId) {
+    const match = bundled.find((p) => p.id === pluginId);
+    if (!match) {
+      console.error(`\u2717 Plugin '${pluginId}' is not a bundled first-party plugin.`);
+      console.error(`  Available: ${bundled.map((p) => p.id).join(", ")}`);
+      process.exit(1);
+    }
+    toInstall = [match];
+  } else {
+    console.error("\u2717 Specify a plugin ID or use --all to install all plugins.");
+    console.error(`  Available: ${bundled.map((p) => p.id).join(", ")}`);
+    process.exit(1);
+  }
+  const localPluginsDir = path4.join(process.cwd(), "plugins");
+  mkdirSync4(localPluginsDir, { recursive: true });
+  let installed = 0;
+  let skipped = 0;
+  for (const plugin of toInstall) {
+    const destDir = path4.join(localPluginsDir, plugin.id);
+    const alreadyExists = existsSync7(path4.join(destDir, "plugin.json"));
+    if (alreadyExists && !options.force) {
+      console.log(`  \u23ED ${plugin.id} \u2014 already installed (use --force to overwrite)`);
+      skipped++;
+      continue;
+    }
+    cpSync(plugin.sourcePath, destDir, { recursive: true });
+    console.log(`  \u2705 ${plugin.id} \u2014 installed to plugins/${plugin.id}/`);
+    installed++;
+  }
+  console.log(`
+\u2713 ${installed} installed, ${skipped} skipped`);
+  if (installed > 0) {
+    console.log("\nNext steps:");
+    console.log("  co-assistant plugin configure <id>   # Set up credentials");
+    console.log("  co-assistant plugin enable <id>      # Enable the plugin\n");
+  }
+}
 function registerPluginCommand(program2) {
   const plugin = program2.command("plugin").description("Manage plugins");
-  plugin.command("list").description("List all available plugins").action(handleList);
+  plugin.command("list").description("List all plugins in the local plugins/ directory").action(handleList);
+  plugin.command("available").description("List bundled first-party plugins and their install status").action(handleAvailable);
+  plugin.command("install").description("Install a first-party plugin from the package").argument("[id]", "Plugin ID to install (omit with --all)").option("--all", "Install all available first-party plugins").option("--force", "Overwrite existing plugins").action(handleInstall);
   plugin.command("enable").description("Enable a plugin").argument("<id>", "Plugin ID to enable").action(handleEnable);
   plugin.command("disable").description("Disable a plugin").argument("<id>", "Plugin ID to disable").action(handleDisable);
   plugin.command("info").description("Show detailed information about a plugin").argument("<id>", "Plugin ID to inspect").action(handleInfo);