@dugleelabs/copair 1.3.0 → 1.4.0

package/dist/index.js

@@ -1,8 +1,11 @@
 #!/usr/bin/env node
 
-// src/index.ts
+// src/bootstrap.ts
 import { join as join15 } from "path";
 import { existsSync as existsSync18, readFileSync as readFileSync10 } from "fs";
+import { createRequire as createRequire3 } from "module";
+import { resolve as resolve10, dirname as dirname7 } from "path";
+import { fileURLToPath as fileURLToPath3 } from "url";
 
 // src/cli/args.ts
 import { Command } from "commander";
@@ -18,7 +21,7 @@ var pkg = (() => {
     } catch {
     }
   }
-  return { name: "copair", version: "0.1.0" };
+  return { name: "copair", version: process.env["COPAIR_VERSION"] ?? "0.0.0-dev" };
 })();
 function parseArgs(argv = process.argv) {
   const program = new Command();
@@ -1201,6 +1204,7 @@ var Agent = class {
   _model;
   formatter;
   textFilter;
+  pluginManager;
   constructor(provider, model, toolRegistry, executor, options = {}) {
     this.provider = provider;
     this._model = model;
@@ -1212,6 +1216,7 @@ var Agent = class {
     this.options = options;
     this.formatter = resolveFormatter(provider.name, model, options.toolCallFormat);
     this.textFilter = buildStreamingFilter(this.formatter);
+    this.pluginManager = options.pluginManager;
   }
   get model() {
     return this._model;
@@ -1265,6 +1270,7 @@ ${summary}`
     this.conversation.appendText("user", userInput);
     let totalUsage = null;
     let lastInputTokens = 0;
+    const meta = {};
     let agentWebSearchFailed = false;
     while (true) {
       const messages = await this.contextWindow.checkAndTruncate(
@@ -1284,10 +1290,33 @@ ${summary}`
       const webSearchHint = allTools.some((t) => t.name === "web_search") ? "When the user asks you to search the web, or requests current/up-to-date information, you MUST call the web_search tool. Never answer such queries from training knowledge alone \u2014 always invoke the tool and base your response on its results." : void 0;
       const systemPrompt = [INJECTION_PREAMBLE, this.options.systemPrompt, toolSystemPrompt, webSearchHint].filter(Boolean).join("\n\n") || void 0;
       logger.debug("agent", `System prompt (${systemPrompt?.length ?? 0} chars): preamble=${systemPrompt?.includes("CONTEXT DATA") ?? false} knowledge=${systemPrompt?.includes("<knowledge") ?? false}`);
-      const stream = this.provider.chat(messages, tools, {
+      let activeProvider = this.provider;
+      let activeMessages = messages;
+      let activeTools = tools;
+      let activeSystemPrompt = systemPrompt;
+      if (this.pluginManager) {
+        const preEvent = await this.pluginManager.preRequest({
+          messages,
+          tools,
+          systemPrompt: systemPrompt ?? "",
+          provider: this.provider,
+          model: this._model,
+          meta
+        });
+        activeMessages = preEvent.messages;
+        activeTools = preEvent.tools;
+        activeSystemPrompt = preEvent.systemPrompt || void 0;
+        activeProvider = this.pluginManager.interceptProvider({
+          currentProvider: this.provider,
+          model: this._model,
+          messages: activeMessages,
+          tokenCount: 0
+        });
+      }
+      const stream = activeProvider.chat(activeMessages, activeTools, {
         model: this._model,
         stream: true,
-        systemPrompt,
+        systemPrompt: activeSystemPrompt,
         maxTokens: this.options.maxTokens,
         temperature: this.options.temperature
       });
@@ -1320,6 +1349,23 @@ ${summary}`
           outputTokens: totalUsage.outputTokens + usage.outputTokens
         } : { ...usage };
       }
+      if (this.pluginManager) {
+        await this.pluginManager.postRequest({
+          messages: activeMessages,
+          response: {
+            text: cleanedText ?? "",
+            toolCalls: toolCalls.map((tc) => ({
+              id: tc.id,
+              name: tc.name,
+              input: JSON.parse(tc.arguments || "{}")
+            })),
+            usage: usage ?? null
+          },
+          provider: activeProvider,
+          model: this._model,
+          meta
+        });
+      }
       if (toolCalls.length === 0) {
         if (cleanedText && cleanedText.trim()) {
           this.conversation.appendText("assistant", cleanedText);
@@ -1514,6 +1560,7 @@ var CopairConfigSchema = z.object({
   permissions: PermissionsConfigSchema.default(() => PermissionsConfigSchema.parse({})),
   feature_flags: FeatureFlagsSchema.default({ model_routing: false }),
   mcp_servers: z.array(McpServerConfigSchema).default([]),
+  plugins: z.array(z.string()).optional().default([]),
   web_search: WebSearchConfigSchema.optional(),
   identity: IdentityConfigSchema.default({ name: "Copair", email: "copair[bot]@noreply.dugleelabs.io" }),
   context: ContextConfigSchema.default(() => ContextConfigSchema.parse({})),
@@ -2873,7 +2920,7 @@ var McpClientManager = class {
       env
     });
     const client = new Client(
-      { name: "copair", version: "0.1.0" },
+      { name: "copair", version: process.env["COPAIR_VERSION"] ?? "0.0.0-dev" },
       { capabilities: {} }
     );
     await client.connect(transport);
@@ -3144,18 +3191,18 @@ async function presentSessionPicker(sessions) {
   console.log(`  ${sessions.length + 1}. Start fresh`);
   process.stdout.write(`
 Select [1-${sessions.length + 1}]: `);
-  return new Promise((resolve10) => {
+  return new Promise((resolve11) => {
     const rl = createInterface({ input: process.stdin, terminal: false });
     rl.once("line", (line) => {
       rl.close();
       const choice = parseInt(line.trim(), 10);
       if (choice >= 1 && choice <= sessions.length) {
-        resolve10(sessions[choice - 1].id);
+        resolve11(sessions[choice - 1].id);
       } else {
-        resolve10(null);
+        resolve11(null);
       }
     });
-    rl.once("close", () => resolve10(null));
+    rl.once("close", () => resolve11(null));
   });
 }
 var SessionManager = class _SessionManager {
@@ -3518,7 +3565,7 @@ import { existsSync as existsSync6 } from "fs";
 // src/commands/interpolate.ts
 import { execSync as execSync6 } from "child_process";
 async function interpolate(template, args, context) {
-  const resolve10 = (key) => {
+  const resolve11 = (key) => {
     if (key.startsWith("env.")) {
       return process.env[key.slice(4)] ?? "";
     }
@@ -3529,10 +3576,10 @@ async function interpolate(template, args, context) {
     return null;
   };
   let result = template.replace(/\{\{([^}]+)\}\}/g, (_match, key) => {
-    return resolve10(key.trim()) ?? _match;
+    return resolve11(key.trim()) ?? _match;
   });
   result = result.replace(/\$([A-Z][A-Z0-9_]*)/g, (_match, key) => {
-    return resolve10(key) ?? _match;
+    return resolve11(key) ?? _match;
   });
   return result;
 }
@@ -4316,8 +4363,8 @@ var SessionSummarizer = class {
     return text.trim();
   }
   timeout() {
-    return new Promise((resolve10) => {
-      setTimeout(() => resolve10(null), this.timeoutMs);
+    return new Promise((resolve11) => {
+      setTimeout(() => resolve11(null), this.timeoutMs);
     });
   }
 };
@@ -4362,7 +4409,7 @@ var pkg2 = (() => {
     } catch {
     }
   }
-  return { name: "copair", version: "0.1.0" };
+  return { name: "copair", version: process.env["COPAIR_VERSION"] ?? "0.0.0-dev" };
 })();
 var CACHE_DIR = resolve7(process.env["HOME"] ?? "~", ".copair");
 var CACHE_FILE = join5(CACHE_DIR, "version-check.json");
@@ -4594,7 +4641,7 @@ var ApprovalGate = class {
   }
   /** Bridge-based approval: emit event and await response from ink UI. */
   bridgePrompt(toolName, input, key) {
-    return new Promise((resolve10) => {
+    return new Promise((resolve11) => {
       const summary = formatSummary(toolName, input);
       const warning = typeof input._sensitivePathWarning === "string" ? input._sensitivePathWarning : void 0;
       this.bridge.emit("approval-request", {
@@ -4608,29 +4655,29 @@ var ApprovalGate = class {
         switch (answer) {
           case "allow":
             void this.auditLog?.append({ event: "approval", tool: toolName, approved_by: "user", outcome: "allowed" });
-            resolve10(true);
+            resolve11(true);
             break;
           case "always":
             this.alwaysAllow.add(key);
             void this.auditLog?.append({ event: "approval", tool: toolName, approved_by: "user", outcome: "allowed", detail: "always" });
-            resolve10(true);
+            resolve11(true);
             break;
           case "all":
             this.bridge.approveAllForTurn = true;
             void this.auditLog?.append({ event: "approval", tool: toolName, approved_by: "user", outcome: "allowed", detail: "approve-all" });
-            resolve10(true);
+            resolve11(true);
             break;
           case "similar": {
             const similarKey = similarSessionKey(toolName, input);
             this.alwaysAllow.add(similarKey);
             void this.auditLog?.append({ event: "approval", tool: toolName, approved_by: "user", outcome: "allowed", detail: "similar" });
-            resolve10(true);
+            resolve11(true);
             break;
           }
           case "deny":
           default:
             void this.auditLog?.append({ event: "denial", tool: toolName, outcome: "denied", detail: "user denied" });
-            resolve10(false);
+            resolve11(false);
             break;
         }
       });
@@ -6354,10 +6401,18 @@ import chalk6 from "chalk";
 // package.json
 var package_default = {
   name: "@dugleelabs/copair",
-  version: "1.3.0",
+  version: "1.4.0",
   description: "Model-agnostic AI coding agent for the terminal",
   type: "module",
-  main: "dist/index.js",
+  main: "dist/api.js",
+  types: "dist/api.d.ts",
+  exports: {
+    ".": {
+      import: "./dist/api.js",
+      types: "./dist/api.d.ts"
+    },
+    "./cli": "./dist/index.js"
+  },
   bin: {
     copair: "dist/index.js"
   },
@@ -6368,6 +6423,7 @@ var package_default = {
     lint: "eslint src/",
     "lint:fix": "eslint src/ --fix",
     dev: "tsup --watch",
+    "build:sea": "node scripts/build-sea.mjs",
     prepublishOnly: "pnpm lint && pnpm test && pnpm build"
   },
   files: [
@@ -6392,7 +6448,7 @@ var package_default = {
     url: "https://github.com/dugleelabs/copair.git"
   },
   engines: {
-    node: ">=20.0.0"
+    node: ">=22.0.0"
   },
   pnpm: {
     onlyBuiltDependencies: [
@@ -6405,7 +6461,9 @@ var package_default = {
     "@types/node": "^25.5.0",
     "@types/react": "^19.2.14",
     "@types/which": "^3.0.4",
+    esbuild: "^0.28.0",
     eslint: "^10.0.3",
+    postject: "1.0.0-alpha.6",
     tsup: "^8.5.1",
     typescript: "^5.9.3",
     "typescript-eslint": "^8.57.1",
@@ -7193,7 +7251,162 @@ async function runAuditCommand(argv) {
   printEntries(entries, !!opts.json);
 }
 
-// src/index.ts
+// src/core/plugin-manager.ts
+var PluginManager = class {
+  plugins = [];
+  /**
+   * Register a plugin instance. Called during bootstrap
+   * (either from config.yaml or programmatic API).
+   */
+  register(plugin) {
+    this.plugins.push(plugin);
+    logger.debug("PluginManager", `Registered plugin: ${plugin.name}@${plugin.version}`);
+  }
+  /**
+   * Load plugins from config.yaml `plugins` array.
+   * Each entry is a package name or local path resolved via import().
+   */
+  async loadFromConfig(pluginPaths) {
+    const start = performance.now();
+    for (const path of pluginPaths) {
+      try {
+        const mod = await import(path);
+        const plugin = mod.default ?? mod;
+        if (!plugin.name || !plugin.version) {
+          logger.warn("PluginManager", `Plugin at "${path}" missing name or version, skipping`);
+          continue;
+        }
+        this.register(plugin);
+      } catch (err) {
+        logger.warn("PluginManager", `Failed to load plugin "${path}": ${err}`);
+      }
+    }
+    logger.debug("PluginManager", `loadFromConfig completed in ${(performance.now() - start).toFixed(1)}ms (${pluginPaths.length} paths)`);
+  }
+  /** Initialize all plugins (called once during bootstrap). */
+  async initialize(context) {
+    const start = performance.now();
+    for (const plugin of this.plugins) {
+      try {
+        await plugin.initialize?.(context);
+        logger.debug("PluginManager", `Initialized plugin: ${plugin.name}`);
+      } catch (err) {
+        logger.warn("PluginManager", `Plugin "${plugin.name}" initialize failed: ${err}`);
+      }
+    }
+    logger.debug("PluginManager", `initialize completed in ${(performance.now() - start).toFixed(1)}ms (${this.plugins.length} plugins)`);
+  }
+  /**
+   * Run preRequest hooks in registration order.
+   * Each plugin receives the (possibly modified) event from the prior plugin.
+   */
+  async preRequest(event) {
+    let current = event;
+    for (const plugin of this.plugins) {
+      try {
+        if (plugin.preRequest) {
+          current = await plugin.preRequest(current);
+        }
+      } catch (err) {
+        logger.warn("PluginManager", `Plugin "${plugin.name}" preRequest failed: ${err}`);
+      }
+    }
+    return current;
+  }
+  /** Run postRequest hooks (observation only). */
+  async postRequest(event) {
+    for (const plugin of this.plugins) {
+      try {
+        await plugin.postRequest?.(event);
+      } catch (err) {
+        logger.warn("PluginManager", `Plugin "${plugin.name}" postRequest failed: ${err}`);
+      }
+    }
+  }
+  /**
+   * Run providerInterceptor hooks. First plugin to return
+   * a non-undefined provider wins (short-circuit).
+   */
+  interceptProvider(event) {
+    for (const plugin of this.plugins) {
+      try {
+        const override = plugin.providerInterceptor?.(event);
+        if (override) return override;
+      } catch (err) {
+        logger.warn("PluginManager", `Plugin "${plugin.name}" providerInterceptor failed: ${err}`);
+      }
+    }
+    return event.currentProvider;
+  }
+  // ── P1 hooks (stubbed, wired later) ──
+  async preToolCall(event) {
+    let current = event;
+    for (const plugin of this.plugins) {
+      try {
+        if (plugin.preToolCall) {
+          current = await plugin.preToolCall(current);
+        }
+      } catch (err) {
+        logger.warn("PluginManager", `Plugin "${plugin.name}" preToolCall failed: ${err}`);
+      }
+    }
+    return current;
+  }
+  async postToolCall(event) {
+    for (const plugin of this.plugins) {
+      try {
+        await plugin.postToolCall?.(event);
+      } catch (err) {
+        logger.warn("PluginManager", `Plugin "${plugin.name}" postToolCall failed: ${err}`);
+      }
+    }
+  }
+  async sessionStart(event) {
+    for (const plugin of this.plugins) {
+      try {
+        await plugin.sessionStart?.(event);
+      } catch (err) {
+        logger.warn("PluginManager", `Plugin "${plugin.name}" sessionStart failed: ${err}`);
+      }
+    }
+  }
+  async sessionEnd(event) {
+    for (const plugin of this.plugins) {
+      try {
+        await plugin.sessionEnd?.(event);
+      } catch (err) {
+        logger.warn("PluginManager", `Plugin "${plugin.name}" sessionEnd failed: ${err}`);
+      }
+    }
+  }
+  /** Destroy all plugins on shutdown. */
+  async destroy() {
+    for (const plugin of this.plugins) {
+      try {
+        await plugin.destroy?.();
+      } catch (err) {
+        logger.warn("PluginManager", `Plugin "${plugin.name}" destroy failed: ${err}`);
+      }
+    }
+  }
+  /** Get the count of registered plugins. */
+  get count() {
+    return this.plugins.length;
+  }
+};
+
+// src/bootstrap.ts
+var _dir3 = dirname7(fileURLToPath3(import.meta.url));
+var _require2 = createRequire3(import.meta.url);
+var _pkg = (() => {
+  for (const rel of ["../package.json", "../../package.json"]) {
+    try {
+      return _require2(resolve10(_dir3, rel));
+    } catch {
+    }
+  }
+  return { version: process.env["COPAIR_VERSION"] ?? "0.0.0-dev" };
+})();
 function detectTestFramework(cwd) {
   const patterns = [
     "vitest.config.ts",
@@ -7263,8 +7476,13 @@ Continue from where we left off.`
   );
   return true;
 }
-async function main() {
-  const cliOpts = parseArgs();
+async function bootstrapCLI(options = {}) {
+  const rawArgv = options.argv ?? process.argv;
+  if (rawArgv[2] === "audit") {
+    await runAuditCommand(rawArgv.slice(3));
+    return;
+  }
+  const cliOpts = parseArgs(options.argv);
   if (cliOpts.debug) {
     logger.setLevel(3 /* DEBUG */);
   } else if (cliOpts.verbose) {
@@ -7288,17 +7506,29 @@ async function main() {
     config,
     cliOpts.model
   );
+  const pluginManager = new PluginManager();
+  for (const plugin of options.plugins ?? []) {
+    pluginManager.register(plugin);
+  }
+  await pluginManager.loadFromConfig(config.plugins ?? []);
   const providerRegistry = new ProviderRegistry();
   providerRegistry.register("openai", createOpenAIProvider);
   providerRegistry.register("anthropic", createAnthropicProvider);
   providerRegistry.register("google", createGoogleProvider);
   providerRegistry.register("openai-compatible", createOpenAICompatibleProvider);
-  const providerType = getProviderType(providerName, providerConfig);
-  const provider = providerRegistry.resolve(providerType, resolveProviderConfig(providerConfig, config.network?.provider_timeout_ms), modelAlias);
   const toolRegistry = createDefaultToolRegistry(config);
   const allowList = loadAllowList();
   const gate = new ApprovalGate(config.permissions.mode, allowList);
   const executor = new ToolExecutor(toolRegistry, gate);
+  await pluginManager.initialize({
+    config,
+    providerRegistry,
+    toolRegistry,
+    version: _pkg.version,
+    edition: options.edition ?? "community"
+  });
+  const providerType = getProviderType(providerName, providerConfig);
+  const provider = providerRegistry.resolve(providerType, resolveProviderConfig(providerConfig, config.network?.provider_timeout_ms), modelAlias);
   const agentBridge = new AgentBridge();
   gate.setBridge(agentBridge);
   const mcpManager = new McpClientManager();
@@ -7329,6 +7559,7 @@ async function main() {
   setKnowledgeBase(knowledgeBase);
   const agent = new Agent(provider, modelAlias, toolRegistry, executor, {
     bridge: agentBridge,
+    pluginManager,
     systemPrompt: `You are Copair, an AI coding assistant.
 
 Environment:
@@ -7434,6 +7665,7 @@ Environment:
     await auditLog.append({ event: "session_end", outcome: "allowed" });
     await sessionManager.close(messages, summarizer);
     await mcpManager.shutdown();
+    await pluginManager.destroy();
     appHandle?.unmount();
     console.log("\nGoodbye!");
     process.exit(0);
@@ -7445,8 +7677,6 @@ Environment:
     completionEngine,
     initialContext: {
       hasTestFramework: detectTestFramework(cwd),
-      // Session picker already ran before ink — user chose resume or fresh.
-      // No need to re-suggest resuming.
       sessionCount: 0
     },
     onHistoryAppend: (entry) => {
@@ -7549,16 +7779,10 @@ Environment:
   }
   await appHandle.waitForExit().then(doExit);
 }
-if (process.argv[2] === "audit") {
-  runAuditCommand(process.argv.slice(3)).catch((err) => {
-    process.stderr.write(`audit: ${err.message}
-`);
-    process.exit(1);
-  });
-} else {
-  main().catch((err) => {
-    console.error(`Error: ${err.message}`);
-    process.exit(1);
-  });
-}
+
+// src/index.ts
+bootstrapCLI({ edition: "community" }).catch((err) => {
+  console.error(`Error: ${err.message}`);
+  process.exit(1);
+});
 //# sourceMappingURL=index.js.map