@hasna/connectors 1.3.2 → 1.3.3

package/bin/mcp.js

@@ -26,6 +26,7 @@ var __export = (target, all) => {
       set: (newValue) => all[name] = () => newValue
     });
 };
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 
 // node_modules/ajv/dist/compile/codegen/code.js
 var require_code = __commonJS((exports) => {
@@ -6490,6 +6491,895 @@ var require_dist = __commonJS((exports, module) => {
   exports.default = formatsPlugin;
 });
 
+// src/lib/installer.ts
+var exports_installer = {};
+__export(exports_installer, {
+  removeConnector: () => removeConnector,
+  installConnectors: () => installConnectors,
+  installConnector: () => installConnector,
+  getInstalledConnectors: () => getInstalledConnectors,
+  getConnectorPath: () => getConnectorPath,
+  getConnectorDocs: () => getConnectorDocs,
+  connectorExists: () => connectorExists
+});
+import { existsSync as existsSync2, cpSync, mkdirSync, readFileSync as readFileSync2, writeFileSync, readdirSync, statSync, rmSync } from "fs";
+import { homedir } from "os";
+import { join as join2, dirname as dirname2 } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+function resolveConnectorsDir() {
+  const fromBin = join2(__dirname2, "..", "connectors");
+  if (existsSync2(fromBin))
+    return fromBin;
+  const fromSrc = join2(__dirname2, "..", "..", "connectors");
+  if (existsSync2(fromSrc))
+    return fromSrc;
+  return fromBin;
+}
+function getConnectorPath(name) {
+  const connectorName = name.startsWith("connect-") ? name : `connect-${name}`;
+  return join2(CONNECTORS_DIR, connectorName);
+}
+function connectorExists(name) {
+  return existsSync2(getConnectorPath(name));
+}
+function installConnector(name, options = {}) {
+  const { targetDir = process.cwd(), overwrite = false } = options;
+  if (!/^[a-z0-9-]+$/.test(name)) {
+    return {
+      connector: name,
+      success: false,
+      error: `Invalid connector name '${name}'`
+    };
+  }
+  const connectorName = name.startsWith("connect-") ? name : `connect-${name}`;
+  const sourcePath = getConnectorPath(name);
+  const destDir = join2(targetDir, ".connectors");
+  const destPath = join2(destDir, connectorName);
+  if (!existsSync2(sourcePath)) {
+    return {
+      connector: name,
+      success: false,
+      error: `Connector '${name}' not found`
+    };
+  }
+  if (existsSync2(destPath) && !overwrite) {
+    return {
+      connector: name,
+      success: false,
+      error: `Already installed. Use --overwrite to replace.`,
+      path: destPath
+    };
+  }
+  try {
+    if (!existsSync2(destDir)) {
+      mkdirSync(destDir, { recursive: true });
+    }
+    cpSync(sourcePath, destPath, { recursive: true });
+    const homeCredDir = join2(homedir(), ".connectors", connectorName);
+    if (existsSync2(homeCredDir)) {
+      const filesToCopy = ["credentials.json", "current_profile"];
+      for (const file of filesToCopy) {
+        const src = join2(homeCredDir, file);
+        if (existsSync2(src)) {
+          cpSync(src, join2(destPath, file));
+        }
+      }
+      const profilesDir = join2(homeCredDir, "profiles");
+      if (existsSync2(profilesDir)) {
+        cpSync(profilesDir, join2(destPath, "profiles"), { recursive: true });
+      }
+    }
+    updateConnectorsIndex(destDir);
+    return {
+      connector: name,
+      success: true,
+      path: destPath
+    };
+  } catch (error2) {
+    return {
+      connector: name,
+      success: false,
+      error: error2 instanceof Error ? error2.message : "Unknown error"
+    };
+  }
+}
+function installConnectors(names, options = {}) {
+  return names.map((name) => installConnector(name, options));
+}
+function updateConnectorsIndex(connectorsDir) {
+  const indexPath = join2(connectorsDir, "index.ts");
+  const connectors = readdirSync(connectorsDir).filter((f) => f.startsWith("connect-") && !f.includes("."));
+  const exports = connectors.map((c) => {
+    const name = c.replace("connect-", "");
+    return `export * as ${name} from './${c}/src/index.js';`;
+  }).join(`
+`);
+  const content = `/**
+ * Auto-generated index of installed connectors
+ * Do not edit manually - run 'connectors install' to update
+ */
+
+${exports}
+`;
+  writeFileSync(indexPath, content);
+}
+function getInstalledConnectors(targetDir = process.cwd()) {
+  const connectorsDir = join2(targetDir, ".connectors");
+  if (!existsSync2(connectorsDir)) {
+    return [];
+  }
+  return readdirSync(connectorsDir).filter((f) => {
+    const fullPath = join2(connectorsDir, f);
+    return f.startsWith("connect-") && statSync(fullPath).isDirectory();
+  }).map((f) => f.replace("connect-", ""));
+}
+function getConnectorDocs(name) {
+  const connectorPath = getConnectorPath(name);
+  const claudeMdPath = join2(connectorPath, "CLAUDE.md");
+  if (!existsSync2(claudeMdPath))
+    return null;
+  const raw = readFileSync2(claudeMdPath, "utf-8");
+  return {
+    overview: extractSection(raw, "Project Overview"),
+    auth: extractSection(raw, "Authentication"),
+    envVars: parseEnvVarsTable(extractSection(raw, "Environment Variables")),
+    cliCommands: extractSection(raw, "CLI Commands"),
+    dataStorage: extractSection(raw, "Data Storage"),
+    raw
+  };
+}
+function extractSection(markdown, heading) {
+  const regex = new RegExp(`^##\\s+${escapeRegex2(heading)}\\s*$`, "m");
+  const match = regex.exec(markdown);
+  if (!match)
+    return "";
+  const start = match.index + match[0].length;
+  const nextHeading = markdown.slice(start).search(/^##\s/m);
+  const content = nextHeading === -1 ? markdown.slice(start) : markdown.slice(start, start + nextHeading);
+  return content.trim();
+}
+function escapeRegex2(str) {
+  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function parseEnvVarsTable(section) {
+  if (!section)
+    return [];
+  const vars = [];
+  const lines = section.split(`
+`);
+  for (const line of lines) {
+    const match = line.match(/\|\s*`([^`]+)`\s*\|\s*(.+?)\s*\|/);
+    if (match && match[1] !== "Variable") {
+      vars.push({ variable: match[1], description: match[2].trim() });
+    }
+  }
+  return vars;
+}
+function removeConnector(name, targetDir = process.cwd()) {
+  const connectorName = name.startsWith("connect-") ? name : `connect-${name}`;
+  const connectorsDir = join2(targetDir, ".connectors");
+  const connectorPath = join2(connectorsDir, connectorName);
+  if (!existsSync2(connectorPath)) {
+    return false;
+  }
+  rmSync(connectorPath, { recursive: true });
+  updateConnectorsIndex(connectorsDir);
+  return true;
+}
+var __dirname2, CONNECTORS_DIR;
+var init_installer = __esm(() => {
+  __dirname2 = dirname2(fileURLToPath2(import.meta.url));
+  CONNECTORS_DIR = resolveConnectorsDir();
+});
+
+// src/db/database.ts
+var exports_database = {};
+__export(exports_database, {
+  shortUuid: () => shortUuid,
+  now: () => now,
+  getDatabase: () => getDatabase,
+  closeDatabase: () => closeDatabase
+});
+import { Database } from "bun:sqlite";
+import { join as join6 } from "path";
+import { homedir as homedir4 } from "os";
+import { mkdirSync as mkdirSync4 } from "fs";
+function getDatabase(path) {
+  if (_db)
+    return _db;
+  const dbPath = path ?? DB_PATH;
+  mkdirSync4(join6(dbPath, ".."), { recursive: true });
+  _db = new Database(dbPath);
+  _db.run("PRAGMA journal_mode = WAL");
+  migrate(_db);
+  return _db;
+}
+function closeDatabase() {
+  _db?.close();
+  _db = null;
+}
+function now() {
+  return new Date().toISOString();
+}
+function shortUuid() {
+  return crypto.randomUUID().slice(0, 8);
+}
+function migrate(db) {
+  db.run(`
+    CREATE TABLE IF NOT EXISTS agents (
+      id TEXT PRIMARY KEY,
+      name TEXT UNIQUE NOT NULL,
+      session_id TEXT,
+      role TEXT NOT NULL DEFAULT 'agent',
+      last_seen_at TEXT NOT NULL,
+      created_at TEXT NOT NULL
+    )
+  `);
+  db.run(`
+    CREATE TABLE IF NOT EXISTS resource_locks (
+      id TEXT PRIMARY KEY,
+      resource_type TEXT NOT NULL CHECK(resource_type IN ('connector', 'agent', 'profile', 'token')),
+      resource_id TEXT NOT NULL,
+      agent_id TEXT NOT NULL,
+      lock_type TEXT NOT NULL DEFAULT 'exclusive' CHECK(lock_type IN ('advisory', 'exclusive')),
+      locked_at TEXT NOT NULL DEFAULT (datetime('now')),
+      expires_at TEXT NOT NULL
+    )
+  `);
+  db.run(`
+    CREATE UNIQUE INDEX IF NOT EXISTS idx_resource_locks_exclusive
+      ON resource_locks(resource_type, resource_id)
+      WHERE lock_type = 'exclusive'
+  `);
+  db.run(`CREATE INDEX IF NOT EXISTS idx_resource_locks_agent ON resource_locks(agent_id)`);
+  db.run(`CREATE INDEX IF NOT EXISTS idx_resource_locks_expires ON resource_locks(expires_at)`);
+  db.run(`
+    CREATE TABLE IF NOT EXISTS connector_rate_usage (
+      agent_id TEXT NOT NULL,
+      connector TEXT NOT NULL,
+      window_start TEXT NOT NULL,
+      call_count INTEGER NOT NULL DEFAULT 0,
+      PRIMARY KEY (agent_id, connector, window_start)
+    )
+  `);
+  db.run(`CREATE INDEX IF NOT EXISTS idx_rate_usage_window ON connector_rate_usage(connector, window_start)`);
+  db.run(`
+    CREATE TABLE IF NOT EXISTS connector_jobs (
+      id TEXT PRIMARY KEY,
+      name TEXT UNIQUE NOT NULL,
+      connector TEXT NOT NULL,
+      command TEXT NOT NULL,
+      args TEXT NOT NULL DEFAULT '[]',
+      cron TEXT NOT NULL,
+      enabled INTEGER NOT NULL DEFAULT 1,
+      strip INTEGER NOT NULL DEFAULT 0,
+      created_at TEXT NOT NULL,
+      last_run_at TEXT
+    )
+  `);
+  db.run(`CREATE INDEX IF NOT EXISTS idx_jobs_enabled ON connector_jobs(enabled)`);
+  db.run(`
+    CREATE TABLE IF NOT EXISTS connector_job_runs (
+      id TEXT PRIMARY KEY,
+      job_id TEXT NOT NULL REFERENCES connector_jobs(id) ON DELETE CASCADE,
+      started_at TEXT NOT NULL,
+      finished_at TEXT,
+      exit_code INTEGER,
+      raw_output TEXT,
+      stripped_output TEXT
+    )
+  `);
+  db.run(`CREATE INDEX IF NOT EXISTS idx_job_runs_job ON connector_job_runs(job_id, started_at DESC)`);
+  db.run(`
+    CREATE TABLE IF NOT EXISTS connector_workflows (
+      id TEXT PRIMARY KEY,
+      name TEXT UNIQUE NOT NULL,
+      steps TEXT NOT NULL DEFAULT '[]',
+      enabled INTEGER NOT NULL DEFAULT 1,
+      created_at TEXT NOT NULL
+    )
+  `);
+  db.run(`
+    CREATE TABLE IF NOT EXISTS connector_usage (
+      id TEXT PRIMARY KEY,
+      connector TEXT NOT NULL,
+      action TEXT NOT NULL,
+      agent_id TEXT,
+      timestamp TEXT NOT NULL
+    )
+  `);
+  db.run(`CREATE INDEX IF NOT EXISTS idx_usage_connector ON connector_usage(connector, timestamp DESC)`);
+  db.run(`
+    CREATE TABLE IF NOT EXISTS connector_promotions (
+      connector TEXT UNIQUE NOT NULL,
+      promoted_at TEXT NOT NULL
+    )
+  `);
+}
+var DB_DIR, DB_PATH, _db = null;
+var init_database = __esm(() => {
+  DB_DIR = join6(homedir4(), ".connectors");
+  DB_PATH = join6(DB_DIR, "connectors.db");
+});
+
+// src/lib/llm.ts
+var exports_llm = {};
+__export(exports_llm, {
+  setLlmStrip: () => setLlmStrip,
+  saveLlmConfig: () => saveLlmConfig,
+  maskKey: () => maskKey,
+  isStripEnabled: () => isStripEnabled,
+  getLlmConfig: () => getLlmConfig,
+  PROVIDER_DEFAULTS: () => PROVIDER_DEFAULTS,
+  LLMClient: () => LLMClient
+});
+import { existsSync as existsSync6, readFileSync as readFileSync4, writeFileSync as writeFileSync3, mkdirSync as mkdirSync5 } from "fs";
+import { join as join7 } from "path";
+import { homedir as homedir5 } from "os";
+function getLlmConfigPath() {
+  return join7(homedir5(), ".connectors", "llm.json");
+}
+function getLlmConfig() {
+  const path = getLlmConfigPath();
+  if (!existsSync6(path))
+    return null;
+  try {
+    return JSON.parse(readFileSync4(path, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+function saveLlmConfig(config2) {
+  const dir = join7(homedir5(), ".connectors");
+  mkdirSync5(dir, { recursive: true });
+  writeFileSync3(getLlmConfigPath(), JSON.stringify(config2, null, 2));
+}
+function setLlmStrip(enabled) {
+  const config2 = getLlmConfig();
+  if (!config2)
+    throw new Error("No LLM config found. Run: connectors llm set --provider <provider> --key <key>");
+  saveLlmConfig({ ...config2, strip: enabled });
+}
+function isStripEnabled() {
+  return getLlmConfig()?.strip === true;
+}
+function maskKey(key) {
+  if (key.length <= 8)
+    return "***";
+  return key.slice(0, 8) + "***";
+}
+
+class LLMClient {
+  config;
+  constructor(config2) {
+    this.config = config2;
+  }
+  static fromConfig() {
+    const config2 = getLlmConfig();
+    if (!config2)
+      return null;
+    return new LLMClient(config2);
+  }
+  async complete(prompt, content) {
+    const start = Date.now();
+    const { provider, model, api_key } = this.config;
+    if (provider === "anthropic") {
+      return this._anthropicComplete(prompt, content, start);
+    }
+    const baseUrl = PROVIDER_BASE_URLS[provider];
+    const response = await fetch(`${baseUrl}/chat/completions`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${api_key}`
+      },
+      body: JSON.stringify({
+        model,
+        messages: [
+          { role: "system", content: prompt },
+          { role: "user", content }
+        ],
+        temperature: 0,
+        max_tokens: 4096
+      })
+    });
+    if (!response.ok) {
+      const error2 = await response.text();
+      throw new Error(`LLM request failed (${provider} ${response.status}): ${error2}`);
+    }
+    const data = await response.json();
+    return {
+      content: data.choices[0].message.content,
+      provider,
+      model,
+      latency_ms: Date.now() - start
+    };
+  }
+  async _anthropicComplete(prompt, content, start) {
+    const { model, api_key } = this.config;
+    const response = await fetch("https://api.anthropic.com/v1/messages", {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "x-api-key": api_key,
+        "anthropic-version": "2023-06-01"
+      },
+      body: JSON.stringify({
+        model,
+        system: prompt,
+        messages: [{ role: "user", content }],
+        max_tokens: 4096
+      })
+    });
+    if (!response.ok) {
+      const error2 = await response.text();
+      throw new Error(`LLM request failed (anthropic ${response.status}): ${error2}`);
+    }
+    const data = await response.json();
+    return {
+      content: data.content[0].text,
+      provider: "anthropic",
+      model,
+      latency_ms: Date.now() - start
+    };
+  }
+}
+var PROVIDER_BASE_URLS, PROVIDER_DEFAULTS;
+var init_llm = __esm(() => {
+  PROVIDER_BASE_URLS = {
+    cerebras: "https://api.cerebras.ai/v1",
+    groq: "https://api.groq.com/openai/v1",
+    openai: "https://api.openai.com/v1"
+  };
+  PROVIDER_DEFAULTS = {
+    cerebras: { model: "qwen-3-32b" },
+    groq: { model: "llama-3.3-70b-versatile" },
+    openai: { model: "gpt-4o-mini" },
+    anthropic: { model: "claude-haiku-4-5-20251001" }
+  };
+});
+
+// src/lib/strip.ts
+async function maybeStrip(output, _type = "json") {
+  const config2 = getLlmConfig();
+  if (!config2?.strip)
+    return output;
+  if (!output || output.trim().length === 0)
+    return output;
+  const client = LLMClient.fromConfig();
+  if (!client)
+    return output;
+  try {
+    const result = await client.complete(STRIP_PROMPT, output);
+    return result.content.trim();
+  } catch {
+    return output;
+  }
+}
+var STRIP_PROMPT = `You are a data extraction assistant. Your job is to take raw API output and return ONLY the essential, structured data.
+
+Rules:
+- Return valid JSON only (no markdown, no explanation)
+- Remove pagination metadata, rate limit headers, empty fields, null values
+- Keep all meaningful data fields
+- If the input is already minimal, return it unchanged
+- If input is not JSON, extract key facts as a JSON object
+- Never truncate actual data values`;
+var init_strip = __esm(() => {
+  init_llm();
+});
+
+// src/db/promotions.ts
+var exports_promotions = {};
+__export(exports_promotions, {
+  promoteConnector: () => promoteConnector,
+  isPromoted: () => isPromoted,
+  getPromotedConnectors: () => getPromotedConnectors,
+  demoteConnector: () => demoteConnector
+});
+function promoteConnector(name, db) {
+  const d = db ?? getDatabase();
+  d.run("INSERT OR REPLACE INTO connector_promotions (connector, promoted_at) VALUES (?, ?)", [name, now()]);
+}
+function demoteConnector(name, db) {
+  const d = db ?? getDatabase();
+  return d.run("DELETE FROM connector_promotions WHERE connector = ?", [name]).changes > 0;
+}
+function getPromotedConnectors(db) {
+  const d = db ?? getDatabase();
+  return d.query("SELECT connector FROM connector_promotions ORDER BY promoted_at DESC").all().map((r) => r.connector);
+}
+function isPromoted(name, db) {
+  const d = db ?? getDatabase();
+  const row = d.query("SELECT 1 FROM connector_promotions WHERE connector = ?").get(name);
+  return !!row;
+}
+var init_promotions = __esm(() => {
+  init_database();
+});
+
+// src/db/usage.ts
+var exports_usage = {};
+__export(exports_usage, {
+  logUsage: () => logUsage,
+  getUsageStats: () => getUsageStats,
+  getUsageMap: () => getUsageMap,
+  getTopConnectors: () => getTopConnectors,
+  cleanOldUsage: () => cleanOldUsage
+});
+function logUsage(connector, action, agentId, db) {
+  const d = db ?? getDatabase();
+  d.run("INSERT INTO connector_usage (id, connector, action, agent_id, timestamp) VALUES (?, ?, ?, ?, ?)", [shortUuid(), connector, action, agentId ?? null, now()]);
+}
+function getUsageStats(connector, db) {
+  const d = db ?? getDatabase();
+  const total = d.query("SELECT COUNT(*) as c FROM connector_usage WHERE connector = ?").get(connector).c;
+  const d7 = new Date(Date.now() - 7 * 24 * 60 * 60 * 1000).toISOString();
+  const last7d = d.query("SELECT COUNT(*) as c FROM connector_usage WHERE connector = ? AND timestamp > ?").get(connector, d7).c;
+  const d1 = new Date(Date.now() - 24 * 60 * 60 * 1000).toISOString();
+  const last24h = d.query("SELECT COUNT(*) as c FROM connector_usage WHERE connector = ? AND timestamp > ?").get(connector, d1).c;
+  return { connector, total, last7d, last24h };
+}
+function getTopConnectors(limit = 10, days = 7, db) {
+  const d = db ?? getDatabase();
+  const since = new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString();
+  return d.query("SELECT connector, COUNT(*) as count FROM connector_usage WHERE timestamp > ? GROUP BY connector ORDER BY count DESC LIMIT ?").all(since, limit);
+}
+function getUsageMap(days = 7, db) {
+  const top = getTopConnectors(100, days, db);
+  return new Map(top.map((t) => [t.connector, t.count]));
+}
+function cleanOldUsage(days = 30, db) {
+  const d = db ?? getDatabase();
+  const cutoff = new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString();
+  return d.run("DELETE FROM connector_usage WHERE timestamp < ?", [cutoff]).changes;
+}
+var init_usage = __esm(() => {
+  init_database();
+});
+
+// src/db/jobs.ts
+var exports_jobs = {};
+__export(exports_jobs, {
+  updateJob: () => updateJob,
+  touchJobLastRun: () => touchJobLastRun,
+  listJobs: () => listJobs,
+  listJobRuns: () => listJobRuns,
+  listEnabledJobs: () => listEnabledJobs,
+  getLatestRun: () => getLatestRun,
+  getJobByName: () => getJobByName,
+  getJob: () => getJob,
+  finishJobRun: () => finishJobRun,
+  deleteJob: () => deleteJob,
+  createJobRun: () => createJobRun,
+  createJob: () => createJob
+});
+function rowToJob(row) {
+  return {
+    ...row,
+    args: JSON.parse(row.args || "[]"),
+    enabled: row.enabled === 1,
+    strip: row.strip === 1
+  };
+}
+function createJob(input, db) {
+  const d = db ?? getDatabase();
+  const id = shortUuid();
+  const ts = now();
+  d.run("INSERT INTO connector_jobs (id, name, connector, command, args, cron, enabled, strip, created_at) VALUES (?, ?, ?, ?, ?, ?, 1, ?, ?)", [id, input.name, input.connector, input.command, JSON.stringify(input.args ?? []), input.cron, input.strip ? 1 : 0, ts]);
+  return getJob(id, d);
+}
+function getJob(id, db) {
+  const d = db ?? getDatabase();
+  const row = d.query("SELECT * FROM connector_jobs WHERE id = ?").get(id);
+  return row ? rowToJob(row) : null;
+}
+function getJobByName(name, db) {
+  const d = db ?? getDatabase();
+  const row = d.query("SELECT * FROM connector_jobs WHERE name = ?").get(name);
+  return row ? rowToJob(row) : null;
+}
+function listJobs(db) {
+  const d = db ?? getDatabase();
+  return d.query("SELECT * FROM connector_jobs ORDER BY name").all().map(rowToJob);
+}
+function listEnabledJobs(db) {
+  const d = db ?? getDatabase();
+  return d.query("SELECT * FROM connector_jobs WHERE enabled = 1").all().map(rowToJob);
+}
+function updateJob(id, input, db) {
+  const d = db ?? getDatabase();
+  const sets = [];
+  const params = [];
+  if (input.name !== undefined) {
+    sets.push("name = ?");
+    params.push(input.name);
+  }
+  if (input.connector !== undefined) {
+    sets.push("connector = ?");
+    params.push(input.connector);
+  }
+  if (input.command !== undefined) {
+    sets.push("command = ?");
+    params.push(input.command);
+  }
+  if (input.args !== undefined) {
+    sets.push("args = ?");
+    params.push(JSON.stringify(input.args));
+  }
+  if (input.cron !== undefined) {
+    sets.push("cron = ?");
+    params.push(input.cron);
+  }
+  if (input.enabled !== undefined) {
+    sets.push("enabled = ?");
+    params.push(input.enabled ? 1 : 0);
+  }
+  if (input.strip !== undefined) {
+    sets.push("strip = ?");
+    params.push(input.strip ? 1 : 0);
+  }
+  if (sets.length === 0)
+    return getJob(id, d);
+  params.push(id);
+  d.run(`UPDATE connector_jobs SET ${sets.join(", ")} WHERE id = ?`, params);
+  return getJob(id, d);
+}
+function deleteJob(id, db) {
+  const d = db ?? getDatabase();
+  return d.run("DELETE FROM connector_jobs WHERE id = ?", [id]).changes > 0;
+}
+function touchJobLastRun(id, db) {
+  const d = db ?? getDatabase();
+  d.run("UPDATE connector_jobs SET last_run_at = ? WHERE id = ?", [now(), id]);
+}
+function createJobRun(jobId, db) {
+  const d = db ?? getDatabase();
+  const id = shortUuid();
+  const ts = now();
+  d.run("INSERT INTO connector_job_runs (id, job_id, started_at) VALUES (?, ?, ?)", [id, jobId, ts]);
+  return { id, job_id: jobId, started_at: ts, finished_at: null, exit_code: null, raw_output: null, stripped_output: null };
+}
+function finishJobRun(id, result, db) {
+  const d = db ?? getDatabase();
+  d.run("UPDATE connector_job_runs SET finished_at = ?, exit_code = ?, raw_output = ?, stripped_output = ? WHERE id = ?", [now(), result.exit_code, result.raw_output, result.stripped_output ?? null, id]);
+}
+function getLatestRun(jobId, db) {
+  const d = db ?? getDatabase();
+  return d.query("SELECT * FROM connector_job_runs WHERE job_id = ? ORDER BY started_at DESC LIMIT 1").get(jobId);
+}
+function listJobRuns(jobId, limit = 20, db) {
+  const d = db ?? getDatabase();
+  return d.query("SELECT * FROM connector_job_runs WHERE job_id = ? ORDER BY started_at DESC LIMIT ?").all(jobId, limit);
+}
+var init_jobs = __esm(() => {
+  init_database();
+});
+
+// src/lib/scheduler.ts
+var exports_scheduler = {};
+__export(exports_scheduler, {
+  triggerJob: () => triggerJob,
+  stopScheduler: () => stopScheduler,
+  startScheduler: () => startScheduler
+});
+import { spawn as spawn2 } from "child_process";
+function cronMatches(cron, d) {
+  const parts = cron.trim().split(/\s+/);
+  if (parts.length !== 5)
+    return false;
+  const [min, hour, dom, mon, dow] = parts;
+  function matches(field, value, min_v, max_v) {
+    if (field === "*")
+      return true;
+    if (field.startsWith("*/")) {
+      const step = parseInt(field.slice(2));
+      return value % step === 0;
+    }
+    if (field.includes("-")) {
+      const [a, b] = field.split("-").map(Number);
+      return value >= a && value <= b;
+    }
+    if (field.includes(",")) {
+      return field.split(",").map(Number).includes(value);
+    }
+    return parseInt(field) === value;
+  }
+  return matches(min, d.getMinutes(), 0, 59) && matches(hour, d.getHours(), 0, 23) && matches(dom, d.getDate(), 1, 31) && matches(mon, d.getMonth() + 1, 1, 12) && matches(dow, d.getDay(), 0, 6);
+}
+async function runConnectorCommand2(connector, command, args) {
+  return new Promise((resolve) => {
+    const cmdArgs = [connector, command, ...args, "--format", "json"];
+    const proc = spawn2("connectors", ["run", ...cmdArgs], { shell: false });
+    let output = "";
+    proc.stdout.on("data", (d) => {
+      output += d.toString();
+    });
+    proc.stderr.on("data", (d) => {
+      output += d.toString();
+    });
+    proc.on("close", (code) => resolve({ exitCode: code ?? 1, output }));
+    proc.on("error", () => resolve({ exitCode: 1, output: `Failed to spawn connectors run` }));
+    setTimeout(() => {
+      proc.kill();
+      resolve({ exitCode: 124, output: output + `
+[timeout]` });
+    }, 60000);
+  });
+}
+async function executeJob(job, db) {
+  const run = createJobRun(job.id, db);
+  try {
+    const { exitCode, output } = await runConnectorCommand2(job.connector, job.command, job.args);
+    const stripped = job.strip ? await maybeStrip(output) : undefined;
+    finishJobRun(run.id, { exit_code: exitCode, raw_output: output, stripped_output: stripped }, db);
+    touchJobLastRun(job.id, db);
+  } catch (e) {
+    finishJobRun(run.id, { exit_code: 1, raw_output: String(e) }, db);
+  }
+}
+function startScheduler(db) {
+  if (_interval)
+    return;
+  _interval = setInterval(async () => {
+    const now3 = new Date;
+    const currentMinute = now3.getMinutes() + now3.getHours() * 60;
+    if (currentMinute === _lastCheckedMinute)
+      return;
+    _lastCheckedMinute = currentMinute;
+    const jobs = listEnabledJobs(db);
+    for (const job of jobs) {
+      if (cronMatches(job.cron, now3)) {
+        executeJob(job, db).catch(() => {});
+      }
+    }
+  }, 30000);
+}
+function stopScheduler() {
+  if (_interval) {
+    clearInterval(_interval);
+    _interval = null;
+    _lastCheckedMinute = -1;
+  }
+}
+async function triggerJob(job, db) {
+  const run = createJobRun(job.id, db);
+  const { exitCode, output } = await runConnectorCommand2(job.connector, job.command, job.args);
+  const stripped = job.strip ? await maybeStrip(output) : undefined;
+  finishJobRun(run.id, { exit_code: exitCode, raw_output: output, stripped_output: stripped }, db);
+  touchJobLastRun(job.id, db);
+  return { run_id: run.id, exit_code: exitCode, output: stripped ?? output };
+}
+var _interval = null, _lastCheckedMinute = -1;
+var init_scheduler = __esm(() => {
+  init_jobs();
+  init_strip();
+});
+
+// src/db/workflows.ts
+var exports_workflows = {};
+__export(exports_workflows, {
+  updateWorkflow: () => updateWorkflow,
+  listWorkflows: () => listWorkflows,
+  getWorkflowByName: () => getWorkflowByName,
+  getWorkflow: () => getWorkflow,
+  deleteWorkflow: () => deleteWorkflow,
+  createWorkflow: () => createWorkflow
+});
+function rowToWorkflow(row) {
+  return {
+    ...row,
+    steps: JSON.parse(row.steps || "[]"),
+    enabled: row.enabled === 1
+  };
+}
+function createWorkflow(input, db) {
+  const d = db ?? getDatabase();
+  const id = shortUuid();
+  d.run("INSERT INTO connector_workflows (id, name, steps, enabled, created_at) VALUES (?, ?, ?, 1, ?)", [id, input.name, JSON.stringify(input.steps), now()]);
+  return getWorkflow(id, d);
+}
+function getWorkflow(id, db) {
+  const d = db ?? getDatabase();
+  const row = d.query("SELECT * FROM connector_workflows WHERE id = ?").get(id);
+  return row ? rowToWorkflow(row) : null;
+}
+function getWorkflowByName(name, db) {
+  const d = db ?? getDatabase();
+  const row = d.query("SELECT * FROM connector_workflows WHERE name = ?").get(name);
+  return row ? rowToWorkflow(row) : null;
+}
+function listWorkflows(db) {
+  const d = db ?? getDatabase();
+  return d.query("SELECT * FROM connector_workflows ORDER BY name").all().map(rowToWorkflow);
+}
+function updateWorkflow(id, input, db) {
+  const d = db ?? getDatabase();
+  const sets = [];
+  const params = [];
+  if (input.name !== undefined) {
+    sets.push("name = ?");
+    params.push(input.name);
+  }
+  if (input.steps !== undefined) {
+    sets.push("steps = ?");
+    params.push(JSON.stringify(input.steps));
+  }
+  if (input.enabled !== undefined) {
+    sets.push("enabled = ?");
+    params.push(input.enabled ? 1 : 0);
+  }
+  if (sets.length === 0)
+    return getWorkflow(id, d);
+  params.push(id);
+  d.run(`UPDATE connector_workflows SET ${sets.join(", ")} WHERE id = ?`, params);
+  return getWorkflow(id, d);
+}
+function deleteWorkflow(id, db) {
+  const d = db ?? getDatabase();
+  return d.run("DELETE FROM connector_workflows WHERE id = ?", [id]).changes > 0;
+}
+var init_workflows = __esm(() => {
+  init_database();
+});
+
+// src/lib/workflow-runner.ts
+var exports_workflow_runner = {};
+__export(exports_workflow_runner, {
+  runWorkflow: () => runWorkflow
+});
+import { spawn as spawn3 } from "child_process";
+async function runStep(step, previousOutput) {
+  return new Promise((resolve) => {
+    const args = [...step.args ?? []];
+    if (previousOutput && previousOutput.trim()) {
+      args.push("--input", previousOutput.trim().slice(0, 4096));
+    }
+    const cmdArgs = ["run", step.connector, step.command, ...args, "--format", "json"];
+    const proc = spawn3("connectors", cmdArgs, { shell: false });
+    let output = "";
+    proc.stdout.on("data", (d) => {
+      output += d.toString();
+    });
+    proc.stderr.on("data", (d) => {
+      output += d.toString();
+    });
+    proc.on("close", (code) => resolve({ exitCode: code ?? 1, output }));
+    proc.on("error", () => resolve({ exitCode: 1, output: "Failed to spawn connectors" }));
+    setTimeout(() => {
+      proc.kill();
+      resolve({ exitCode: 124, output: output + `
+[timeout]` });
+    }, 60000);
+  });
+}
+async function runWorkflow(workflow) {
+  const results = [];
+  let previousOutput;
+  let success = true;
+  for (let i = 0;i < workflow.steps.length; i++) {
+    const step = workflow.steps[i];
+    const { exitCode, output } = await runStep(step, previousOutput);
+    const stripped = await maybeStrip(output);
+    results.push({ step: i + 1, connector: step.connector, command: step.command, exit_code: exitCode, output: stripped });
+    if (exitCode !== 0) {
+      success = false;
+      break;
+    }
+    previousOutput = stripped;
+  }
+  return {
+    workflow_id: workflow.id,
+    workflow_name: workflow.name,
+    steps: results,
+    success,
+    final_output: results[results.length - 1]?.output ?? ""
+  };
+}
+var init_workflow_runner = __esm(() => {
+  init_strip();
+});
+
 // node_modules/zod/v3/external.js
 var exports_external = {};
 __export(exports_external, {
@@ -19394,6 +20284,94 @@ class StdioServerTransport {
 import { existsSync, readFileSync } from "fs";
 import { join, dirname } from "path";
 import { fileURLToPath } from "url";
+
+// src/lib/fuzzy.ts
+function levenshtein(a, b) {
+  const m = a.length;
+  const n = b.length;
+  if (m === 0)
+    return n;
+  if (n === 0)
+    return m;
+  let prev = new Array(n + 1);
+  let curr = new Array(n + 1);
+  for (let j = 0;j <= n; j++)
+    prev[j] = j;
+  for (let i = 1;i <= m; i++) {
+    curr[0] = i;
+    for (let j = 1;j <= n; j++) {
+      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+      curr[j] = Math.min(curr[j - 1] + 1, prev[j] + 1, prev[j - 1] + cost);
+    }
+    [prev, curr] = [curr, prev];
+  }
+  return prev[n];
+}
+function bestFuzzyScore(token, candidates, maxDistance = 2) {
+  if (token.length < 3)
+    return 0;
+  let bestDist = maxDistance + 1;
+  for (const c of candidates) {
+    if (Math.abs(token.length - c.length) > maxDistance)
+      continue;
+    const d = levenshtein(token, c);
+    if (d < bestDist)
+      bestDist = d;
+    if (d === 0)
+      return maxDistance + 1;
+  }
+  if (bestDist > maxDistance)
+    return 0;
+  return maxDistance - bestDist + 1;
+}
+
+// src/lib/synonyms.ts
+var SYNONYM_MAP = {
+  email: ["smtp", "mail", "inbox", "resend", "ses"],
+  chat: ["messaging", "im", "slack", "discord", "teams"],
+  sms: ["text", "twilio", "messaging"],
+  payment: ["billing", "invoicing", "commerce", "checkout", "stripe"],
+  payments: ["billing", "invoicing", "commerce", "checkout", "stripe"],
+  ecommerce: ["shop", "store", "commerce", "shopify"],
+  finance: ["banking", "accounting", "invoicing"],
+  crypto: ["blockchain", "web3", "wallet"],
+  ai: ["llm", "ml", "model", "gpt", "claude", "anthropic", "openai"],
+  llm: ["ai", "model", "gpt", "claude"],
+  auth: ["oauth", "sso", "login", "identity", "authentication"],
+  database: ["db", "sql", "nosql", "postgres", "mongo", "supabase"],
+  deploy: ["hosting", "infrastructure", "ci", "cd", "vercel"],
+  storage: ["files", "drive", "s3", "bucket", "upload"],
+  cloud: ["aws", "gcp", "azure", "infrastructure"],
+  api: ["rest", "graphql", "endpoint", "webhook"],
+  monitoring: ["logs", "observability", "alerting", "datadog", "sentry"],
+  ci: ["cd", "deploy", "pipeline", "github", "actions"],
+  crm: ["sales", "leads", "contacts", "hubspot", "salesforce"],
+  analytics: ["data", "metrics", "tracking", "mixpanel", "amplitude"],
+  project: ["task", "issue", "board", "jira", "linear", "asana"],
+  docs: ["documentation", "wiki", "notion", "confluence"],
+  design: ["figma", "sketch", "ui", "ux"],
+  security: ["auth", "encryption", "compliance", "vault"]
+};
+function expandQuery(tokens) {
+  const synonyms = new Set;
+  for (const token of tokens) {
+    const matches = SYNONYM_MAP[token];
+    if (matches) {
+      for (const syn of matches) {
+        if (!tokens.includes(syn))
+          synonyms.add(syn);
+      }
+    }
+    for (const [key, values] of Object.entries(SYNONYM_MAP)) {
+      if (values.includes(token) && !tokens.includes(key)) {
+        synonyms.add(key);
+      }
+    }
+  }
+  return { original: tokens, expanded: [...synonyms] };
+}
+
+// src/lib/registry.ts
 var CATEGORIES = [
   "AI & ML",
   "Developer Tools",
@@ -24279,13 +25257,6 @@ var CONNECTORS = [
     category: "Business Tools",
     tags: ["e-signature", "contracts", "digital", "documents", "legal"]
   },
-  {
-    name: "yousign",
-    displayName: "Yousign",
-    description: "eIDAS-compliant electronic signature API for EU workflows",
-    category: "Business Tools",
-    tags: ["e-signature", "eidas", "contracts", "documents", "legal", "eu"]
-  },
   {
     name: "signl4",
     displayName: "SIGNL4",
@@ -25319,9 +26290,152 @@ var CONNECTORS = [
 function getConnectorsByCategory(category) {
   return CONNECTORS.filter((c) => c.category === category);
 }
-function searchConnectors(query) {
-  const q = query.toLowerCase();
-  return CONNECTORS.filter((c) => c.name.toLowerCase().includes(q) || c.displayName.toLowerCase().includes(q) || c.description.toLowerCase().includes(q) || c.tags.some((t) => t.includes(q)));
+function searchConnectors(query, context) {
+  const tokens = query.toLowerCase().trim().split(/\s+/).filter(Boolean);
+  if (tokens.length === 0)
+    return [];
+  const limit = context?.limit ?? 20;
+  const installed = new Set(context?.installed ?? []);
+  const promoted = new Set(context?.promoted ?? []);
+  const usage = context?.usage ?? new Map;
+  const results = [];
+  for (const c of CONNECTORS) {
+    const nameLow = c.name.toLowerCase();
+    const displayLow = c.displayName.toLowerCase();
+    const descLow = c.description.toLowerCase();
+    const tagsLow = c.tags.map((t) => t.toLowerCase());
+    let score = 0;
+    const matchReasons = [];
+    let allTokensMatch = true;
+    for (const token of tokens) {
+      let tokenMatched = false;
+      if (nameLow === token) {
+        score += 100;
+        matchReasons.push(`name="${token}"`);
+        tokenMatched = true;
+      } else if (nameLow.includes(token)) {
+        score += 10;
+        matchReasons.push(`name~${token}`);
+        tokenMatched = true;
+      }
+      if (tagsLow.includes(token)) {
+        score += 8;
+        if (!tokenMatched)
+          matchReasons.push(`tag="${token}"`);
+        tokenMatched = true;
+      } else if (tagsLow.some((t) => t.includes(token))) {
+        score += 5;
+        if (!tokenMatched)
+          matchReasons.push(`tag~${token}`);
+        tokenMatched = true;
+      }
+      if (displayLow.includes(token)) {
+        score += 3;
+        if (!tokenMatched)
+          matchReasons.push(`display~${token}`);
+        tokenMatched = true;
+      }
+      if (descLow.includes(token)) {
+        score += 1;
+        if (!tokenMatched)
+          matchReasons.push(`desc~${token}`);
+        tokenMatched = true;
+      }
+      if (!tokenMatched && token.length >= 3) {
+        const nameFuzzy = bestFuzzyScore(token, [nameLow], 1);
+        if (nameFuzzy > 0) {
+          score += nameFuzzy * 6;
+          matchReasons.push(`fuzzy:name\u2248${token}`);
+          tokenMatched = true;
+        }
+        if (!tokenMatched) {
+          const tagFuzzy = bestFuzzyScore(token, tagsLow, 2);
+          if (tagFuzzy > 0) {
+            score += tagFuzzy * 3;
+            matchReasons.push(`fuzzy:tag\u2248${token}`);
+            tokenMatched = true;
+          }
+        }
+        if (!tokenMatched) {
+          const displayFuzzy = bestFuzzyScore(token, [displayLow], 2);
+          if (displayFuzzy > 0) {
+            score += displayFuzzy * 2;
+            matchReasons.push(`fuzzy:display\u2248${token}`);
+            tokenMatched = true;
+          }
+        }
+      }
+      if (!tokenMatched) {
+        allTokensMatch = false;
+        break;
+      }
+    }
+    if (!allTokensMatch)
+      continue;
+    const badges = [];
+    if (installed.has(c.name)) {
+      score += 50;
+      badges.push("installed");
+    }
+    if (promoted.has(c.name)) {
+      score += 30;
+      badges.push("promoted");
+    }
+    const usageCount = usage.get(c.name) ?? 0;
+    if (usageCount > 0) {
+      score += Math.min(usageCount * 2, 40);
+      if (usageCount >= 5)
+        badges.push("hot");
+    }
+    results.push({ ...c, score, matchReasons, badges });
+  }
+  const matchedNames = new Set(results.map((r) => r.name));
+  if (results.length < limit) {
+    const { expanded } = expandQuery(tokens);
+    if (expanded.length > 0) {
+      for (const c of CONNECTORS) {
+        if (matchedNames.has(c.name))
+          continue;
+        const nameLow2 = c.name.toLowerCase();
+        const tagsLow2 = c.tags.map((t) => t.toLowerCase());
+        const descLow2 = c.description.toLowerCase();
+        let synScore = 0;
+        const synReasons = [];
+        for (const syn of expanded) {
+          if (nameLow2.includes(syn)) {
+            synScore += 2;
+            synReasons.push(`syn:name~${syn}`);
+          } else if (tagsLow2.some((t) => t.includes(syn))) {
+            synScore += 1;
+            synReasons.push(`syn:tag~${syn}`);
+          } else if (descLow2.includes(syn)) {
+            synScore += 1;
+            synReasons.push(`syn:desc~${syn}`);
+          }
+        }
+        if (synScore > 0) {
+          const badges = [];
+          if (installed.has(c.name)) {
+            synScore += 50;
+            badges.push("installed");
+          }
+          if (promoted.has(c.name)) {
+            synScore += 30;
+            badges.push("promoted");
+          }
+          const usageCount = usage.get(c.name) ?? 0;
+          if (usageCount > 0) {
+            synScore += Math.min(usageCount * 2, 40);
+            if (usageCount >= 5)
+              badges.push("hot");
+          }
+          results.push({ ...c, score: synScore, matchReasons: synReasons, badges });
+        }
+      }
+    }
+  }
+  results.sort((a, b) => b.score - a.score);
+  return results.slice(0, limit);
 }
 function getConnector(name) {
   return CONNECTORS.find((c) => c.name === name);
@@ -25350,106 +26464,83 @@ function loadConnectorVersions() {
   }
 }
 
-// src/lib/installer.ts
-import { existsSync as existsSync2, readFileSync as readFileSync2, readdirSync, statSync } from "fs";
-import { join as join2, dirname as dirname2 } from "path";
-import { fileURLToPath as fileURLToPath2 } from "url";
-var __dirname2 = dirname2(fileURLToPath2(import.meta.url));
-function resolveConnectorsDir() {
-  const fromBin = join2(__dirname2, "..", "connectors");
-  if (existsSync2(fromBin))
-    return fromBin;
-  const fromSrc = join2(__dirname2, "..", "..", "connectors");
-  if (existsSync2(fromSrc))
-    return fromSrc;
-  return fromBin;
+// src/mcp/index.ts
+init_installer();
+
+// src/server/auth.ts
+import { existsSync as existsSync4, readFileSync as readFileSync3, writeFileSync as writeFileSync2, mkdirSync as mkdirSync3, readdirSync as readdirSync2, rmSync as rmSync2, statSync as statSync3 } from "fs";
+init_installer();
+import { homedir as homedir3 } from "os";
+import { join as join4 } from "path";
+
+// src/lib/lock.ts
+import { openSync, closeSync, unlinkSync, existsSync as existsSync3, statSync as statSync2 } from "fs";
+import { join as join3 } from "path";
+import { homedir as homedir2 } from "os";
+import { mkdirSync as mkdirSync2 } from "fs";
+var LOCK_TIMEOUT_MS = 5000;
+var LOCK_RETRY_MS = 100;
+var STALE_LOCK_MS = 30000;
+
+class LockTimeoutError extends Error {
+  connector;
+  constructor(connector) {
+    super(`Could not acquire write lock for connector "${connector}" within ${LOCK_TIMEOUT_MS}ms. Another agent may be writing. Try again shortly.`);
+    this.connector = connector;
+    this.name = "LockTimeoutError";
+  }
 }
-var CONNECTORS_DIR = resolveConnectorsDir();
-function getConnectorPath(name) {
-  const connectorName = name.startsWith("connect-") ? name : `connect-${name}`;
-  return join2(CONNECTORS_DIR, connectorName);
+function lockPath(connector) {
+  const dir = join3(homedir2(), ".connectors", `connect-${connector}`);
+  mkdirSync2(dir, { recursive: true });
+  return join3(dir, ".write.lock");
 }
-function installConnector(name, options = {}) {
-  if (!/^[a-z0-9-]+$/.test(name)) {
-    return {
-      connector: name,
-      success: false,
-      error: `Invalid connector name '${name}'`
-    };
-  }
-  const sourcePath = getConnectorPath(name);
-  if (!existsSync2(sourcePath)) {
-    return {
-      connector: name,
-      success: false,
-      error: `Connector '${name}' not found`
-    };
+function isStale(path) {
+  try {
+    const stat = statSync2(path);
+    return Date.now() - stat.mtimeMs > STALE_LOCK_MS;
+  } catch {
+    return false;
   }
-  return {
-    connector: name,
-    success: true,
-    path: sourcePath
-  };
 }
-function getInstalledConnectors() {
-  if (!existsSync2(CONNECTORS_DIR)) {
-    return [];
+function tryAcquire(path) {
+  if (existsSync3(path) && isStale(path)) {
+    try {
+      unlinkSync(path);
+    } catch {}
+  }
+  try {
+    const fd = openSync(path, "wx");
+    closeSync(fd);
+    return true;
+  } catch (e) {
+    if (e.code === "EEXIST")
+      return false;
+    throw e;
   }
-  return readdirSync(CONNECTORS_DIR).filter((f) => {
-    const fullPath = join2(CONNECTORS_DIR, f);
-    return f.startsWith("connect-") && statSync(fullPath).isDirectory();
-  }).map((f) => f.replace("connect-", ""));
-}
-function getConnectorDocs(name) {
-  const connectorPath = getConnectorPath(name);
-  const claudeMdPath = join2(connectorPath, "CLAUDE.md");
-  if (!existsSync2(claudeMdPath))
-    return null;
-  const raw = readFileSync2(claudeMdPath, "utf-8");
-  return {
-    overview: extractSection(raw, "Project Overview"),
-    auth: extractSection(raw, "Authentication"),
-    envVars: parseEnvVarsTable(extractSection(raw, "Environment Variables")),
-    cliCommands: extractSection(raw, "CLI Commands"),
-    dataStorage: extractSection(raw, "Data Storage"),
-    raw
-  };
-}
-function extractSection(markdown, heading) {
-  const regex = new RegExp(`^##\\s+${escapeRegex2(heading)}\\s*$`, "m");
-  const match = regex.exec(markdown);
-  if (!match)
-    return "";
-  const start = match.index + match[0].length;
-  const nextHeading = markdown.slice(start).search(/^##\s/m);
-  const content = nextHeading === -1 ? markdown.slice(start) : markdown.slice(start, start + nextHeading);
-  return content.trim();
-}
-function escapeRegex2(str) {
-  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-function parseEnvVarsTable(section) {
-  if (!section)
-    return [];
-  const vars = [];
-  const lines = section.split(`
-`);
-  for (const line of lines) {
-    const match = line.match(/\|\s*`([^`]+)`\s*\|\s*(.+?)\s*\|/);
-    if (match && match[1] !== "Variable") {
-      vars.push({ variable: match[1], description: match[2].trim() });
+function release(path) {
+  try {
+    unlinkSync(path);
+  } catch {}
+}
+async function withWriteLock(connector, fn) {
+  const path = lockPath(connector);
+  const deadline = Date.now() + LOCK_TIMEOUT_MS;
+  while (Date.now() < deadline) {
+    if (tryAcquire(path)) {
+      try {
+        return await fn();
+      } finally {
+        release(path);
+      }
     }
+    await new Promise((resolve) => setTimeout(resolve, LOCK_RETRY_MS));
   }
-  return vars;
-}
-function removeConnector(name) {
-  return false;
+  throw new LockTimeoutError(connector);
 }
 
 // src/server/auth.ts
-import { existsSync as existsSync3, readFileSync as readFileSync3, writeFileSync, mkdirSync, readdirSync as readdirSync2, rmSync, statSync as statSync2 } from "fs";
-import { homedir } from "os";
-import { join as join3 } from "path";
 var oauthStateStore = new Map;
 var GOOGLE_SCOPES = {
   gmail: [
@@ -25502,12 +26593,12 @@ function getAuthType(name) {
 }
 function getConnectorConfigDir(name) {
   const connectorName = name.startsWith("connect-") ? name : `connect-${name}`;
-  return join3(homedir(), ".connectors", connectorName);
+  return join4(homedir3(), ".connectors", connectorName);
 }
 function getCurrentProfile(name) {
   const configDir = getConnectorConfigDir(name);
-  const currentProfileFile = join3(configDir, "current_profile");
-  if (existsSync3(currentProfileFile)) {
+  const currentProfileFile = join4(configDir, "current_profile");
+  if (existsSync4(currentProfileFile)) {
     try {
       return readFileSync3(currentProfileFile, "utf-8").trim() || "default";
     } catch {
@@ -25521,14 +26612,14 @@ function loadProfileConfig(name) {
   const profile = getCurrentProfile(name);
   let flatConfig = {};
   let dirConfig = {};
-  const profileFile = join3(configDir, "profiles", `${profile}.json`);
-  if (existsSync3(profileFile)) {
+  const profileFile = join4(configDir, "profiles", `${profile}.json`);
+  if (existsSync4(profileFile)) {
     try {
       flatConfig = JSON.parse(readFileSync3(profileFile, "utf-8"));
     } catch {}
   }
-  const profileDirConfig = join3(configDir, "profiles", profile, "config.json");
-  if (existsSync3(profileDirConfig)) {
+  const profileDirConfig = join4(configDir, "profiles", profile, "config.json");
+  if (existsSync4(profileDirConfig)) {
     try {
       dirConfig = JSON.parse(readFileSync3(profileDirConfig, "utf-8"));
     } catch {}
@@ -25541,14 +26632,24 @@ function loadProfileConfig(name) {
 function loadTokens(name) {
   const configDir = getConnectorConfigDir(name);
   const profile = getCurrentProfile(name);
-  const tokensFile = join3(configDir, "profiles", profile, "tokens.json");
-  if (existsSync3(tokensFile)) {
+  const tokensFile = join4(configDir, "profiles", profile, "tokens.json");
+  if (existsSync4(tokensFile)) {
     try {
       return JSON.parse(readFileSync3(tokensFile, "utf-8"));
     } catch {
       return null;
     }
   }
+  const profileConfig = loadProfileConfig(name);
+  if (profileConfig.refreshToken || profileConfig.accessToken) {
+    return {
+      accessToken: profileConfig.accessToken ?? "",
+      refreshToken: profileConfig.refreshToken,
+      expiresAt: profileConfig.expiresAt ?? 0,
+      tokenType: profileConfig.tokenType,
+      scope: profileConfig.scope
+    };
+  }
   return null;
 }
 function getAuthStatus(name) {
@@ -25589,48 +26690,51 @@ function getAuthStatus(name) {
     envVarTotalCount
   };
 }
-function saveApiKey(name, key, field) {
+async function saveApiKey(name, key, field) {
+  return withWriteLock(name, () => _saveApiKey(name, key, field));
+}
+function _saveApiKey(name, key, field) {
   const configDir = getConnectorConfigDir(name);
   const profile = getCurrentProfile(name);
   const keyField = field || guessKeyField(name);
   if (keyField === "clientId" || keyField === "clientSecret") {
-    const credentialsFile = join3(configDir, "credentials.json");
-    mkdirSync(configDir, { recursive: true });
+    const credentialsFile = join4(configDir, "credentials.json");
+    mkdirSync3(configDir, { recursive: true });
     let creds = {};
-    if (existsSync3(credentialsFile)) {
+    if (existsSync4(credentialsFile)) {
       try {
         creds = JSON.parse(readFileSync3(credentialsFile, "utf-8"));
       } catch {}
     }
     creds[keyField] = key;
-    writeFileSync(credentialsFile, JSON.stringify(creds, null, 2));
+    writeFileSync2(credentialsFile, JSON.stringify(creds, null, 2));
     return;
   }
-  const profileFile = join3(configDir, "profiles", `${profile}.json`);
-  const profileDir = join3(configDir, "profiles", profile);
-  if (existsSync3(profileFile)) {
+  const profileFile = join4(configDir, "profiles", `${profile}.json`);
+  const profileDir = join4(configDir, "profiles", profile);
+  if (existsSync4(profileFile)) {
     let config2 = {};
     try {
       config2 = JSON.parse(readFileSync3(profileFile, "utf-8"));
     } catch {}
     config2[keyField] = key;
-    writeFileSync(profileFile, JSON.stringify(config2, null, 2));
+    writeFileSync2(profileFile, JSON.stringify(config2, null, 2));
     return;
   }
-  if (existsSync3(profileDir)) {
-    const configFile = join3(profileDir, "config.json");
+  if (existsSync4(profileDir)) {
+    const configFile = join4(profileDir, "config.json");
     let config2 = {};
-    if (existsSync3(configFile)) {
+    if (existsSync4(configFile)) {
       try {
         config2 = JSON.parse(readFileSync3(configFile, "utf-8"));
       } catch {}
     }
     config2[keyField] = key;
-    writeFileSync(configFile, JSON.stringify(config2, null, 2));
+    writeFileSync2(configFile, JSON.stringify(config2, null, 2));
     return;
   }
-  mkdirSync(profileDir, { recursive: true });
-  writeFileSync(join3(profileDir, "config.json"), JSON.stringify({ [keyField]: key }, null, 2));
+  mkdirSync3(profileDir, { recursive: true });
+  writeFileSync2(join4(profileDir, "config.json"), JSON.stringify({ [keyField]: key }, null, 2));
 }
 function guessKeyField(name) {
   const docs = getConnectorDocs(name);
@@ -25648,17 +26752,17 @@ function guessKeyField(name) {
 }
 
 // src/lib/runner.ts
-import { existsSync as existsSync4 } from "fs";
-import { join as join4, dirname as dirname3 } from "path";
+import { existsSync as existsSync5 } from "fs";
+import { join as join5, dirname as dirname3 } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 import { spawn } from "child_process";
 var __dirname3 = dirname3(fileURLToPath3(import.meta.url));
 function resolveConnectorsDir2() {
-  const fromBin = join4(__dirname3, "..", "connectors");
-  if (existsSync4(fromBin))
+  const fromBin = join5(__dirname3, "..", "connectors");
+  if (existsSync5(fromBin))
     return fromBin;
-  const fromSrc = join4(__dirname3, "..", "..", "connectors");
-  if (existsSync4(fromSrc))
+  const fromSrc = join5(__dirname3, "..", "..", "connectors");
+  if (existsSync5(fromSrc))
     return fromSrc;
   return fromBin;
 }
@@ -25698,9 +26802,9 @@ function buildEnvWithCredentials(connectorName, baseEnv) {
 }
 function getConnectorCliPath(name) {
   const safeName = name.replace(/[^a-z0-9-]/g, "");
-  const connectorDir = join4(CONNECTORS_DIR2, `connect-${safeName}`);
-  const cliPath = join4(connectorDir, "src", "cli", "index.ts");
-  if (existsSync4(cliPath))
+  const connectorDir = join5(CONNECTORS_DIR2, `connect-${safeName}`);
+  const cliPath = join5(connectorDir, "src", "cli", "index.ts");
+  if (existsSync5(cliPath))
     return cliPath;
   return null;
 }
@@ -25779,32 +26883,248 @@ async function getConnectorCommandHelp(name, command) {
   return result.stdout || result.stderr;
 }
 
+// src/db/agents.ts
+init_database();
+var AGENT_ACTIVE_WINDOW_MS = 30 * 60 * 1000;
+function shortUuid2() {
+  return crypto.randomUUID().slice(0, 8);
+}
+function isAgentConflict(result) {
+  return result.conflict === true;
+}
+function registerAgent(input, db) {
+  const d = db ?? getDatabase();
+  const normalizedName = input.name.trim().toLowerCase();
+  const existing = getAgentByName(normalizedName, d);
+  if (existing) {
+    const lastSeenMs = new Date(existing.last_seen_at).getTime();
+    const isActive = Date.now() - lastSeenMs < AGENT_ACTIVE_WINDOW_MS;
+    const sameSession = input.session_id && existing.session_id && input.session_id === existing.session_id;
+    const differentSession = input.session_id && existing.session_id && input.session_id !== existing.session_id;
+    if (isActive && differentSession) {
+      const minutesAgo = Math.round((Date.now() - lastSeenMs) / 60000);
+      return {
+        conflict: true,
+        existing_id: existing.id,
+        existing_name: existing.name,
+        last_seen_at: existing.last_seen_at,
+        session_hint: existing.session_id ? existing.session_id.slice(0, 8) : null,
+        working_dir: null,
+        message: `Agent "${normalizedName}" is already active (last seen ${minutesAgo}m ago). Pass session_id="${existing.session_id}" to reclaim it, or choose a different name.`
+      };
+    }
+    const updates = ["last_seen_at = ?"];
+    const params = [now()];
+    if (input.session_id && !sameSession) {
+      updates.push("session_id = ?");
+      params.push(input.session_id);
+    }
+    params.push(existing.id);
+    d.run(`UPDATE agents SET ${updates.join(", ")} WHERE id = ?`, params);
+    return getAgent(existing.id, d);
+  }
+  const id = shortUuid2();
+  const ts = now();
+  d.run(`INSERT INTO agents (id, name, session_id, role, last_seen_at, created_at)
+     VALUES (?, ?, ?, ?, ?, ?)`, [id, normalizedName, input.session_id ?? null, input.role ?? "agent", ts, ts]);
+  return getAgent(id, d);
+}
+function getAgent(id, db) {
+  const d = db ?? getDatabase();
+  return d.query("SELECT * FROM agents WHERE id = ?").get(id);
+}
+function getAgentByName(name, db) {
+  const d = db ?? getDatabase();
+  return d.query("SELECT * FROM agents WHERE LOWER(name) = ?").get(name.trim().toLowerCase());
+}
+function listAgents(db) {
+  const d = db ?? getDatabase();
+  return d.query("SELECT * FROM agents ORDER BY name").all();
+}
+
+// src/db/rate.ts
+init_database();
+var AGENT_ACTIVE_WINDOW_MS2 = 30 * 60 * 1000;
+var WINDOW_SECONDS = 60;
+function ensureRateTable(db) {
+  db.run(`
+    CREATE TABLE IF NOT EXISTS connector_rate_usage (
+      agent_id TEXT NOT NULL,
+      connector TEXT NOT NULL,
+      window_start TEXT NOT NULL,
+      call_count INTEGER NOT NULL DEFAULT 0,
+      PRIMARY KEY (agent_id, connector, window_start)
+    )
+  `);
+  db.run(`CREATE INDEX IF NOT EXISTS idx_rate_usage_window ON connector_rate_usage(connector, window_start)`);
+}
+function countActiveAgents(db) {
+  const cutoff = new Date(Date.now() - AGENT_ACTIVE_WINDOW_MS2).toISOString();
+  const row = db.query("SELECT COUNT(*) as count FROM agents WHERE last_seen_at > ?").get(cutoff);
+  return Math.max(1, row?.count ?? 1);
+}
+function currentWindowStart() {
+  const now3 = Date.now();
+  const windowMs = WINDOW_SECONDS * 1000;
+  return new Date(Math.floor(now3 / windowMs) * windowMs).toISOString();
+}
+function checkRateBudget(agentId, connector, connectorLimit, consume = true, db) {
+  const d = db ?? getDatabase();
+  ensureRateTable(d);
+  const activeAgents = countActiveAgents(d);
+  const budget = Math.max(1, Math.floor(connectorLimit / activeAgents));
+  const windowStart = currentWindowStart();
+  const windowMs = WINDOW_SECONDS * 1000;
+  const windowEnd = new Date(Math.floor(Date.now() / windowMs) * windowMs + windowMs);
+  const windowResetsIn = windowEnd.getTime() - Date.now();
+  const row = d.query("SELECT call_count FROM connector_rate_usage WHERE agent_id = ? AND connector = ? AND window_start = ?").get(agentId, connector, windowStart);
+  const used = row?.call_count ?? 0;
+  if (used >= budget) {
+    return {
+      exceeded: true,
+      connector,
+      agent_id: agentId,
+      budget,
+      used,
+      active_agents: activeAgents,
+      window_resets_in_ms: windowResetsIn,
+      message: `Rate budget exceeded for "${connector}" (${used}/${budget} calls used, ${activeAgents} active agent${activeAgents === 1 ? "" : "s"} sharing limit of ${connectorLimit}/min). Resets in ${Math.ceil(windowResetsIn / 1000)}s.`
+    };
+  }
+  if (consume) {
+    d.run(`INSERT INTO connector_rate_usage (agent_id, connector, window_start, call_count)
+       VALUES (?, ?, ?, 1)
+       ON CONFLICT(agent_id, connector, window_start) DO UPDATE SET call_count = call_count + 1`, [agentId, connector, windowStart]);
+  }
+  return {
+    connector,
+    agent_id: agentId,
+    limit: connectorLimit,
+    active_agents: activeAgents,
+    budget,
+    used: consume ? used + 1 : used,
+    remaining: consume ? budget - used - 1 : budget - used,
+    window_start: windowStart,
+    window_resets_in_ms: windowResetsIn
+  };
+}
+function getRateBudget(agentId, connector, connectorLimit, db) {
+  return checkRateBudget(agentId, connector, connectorLimit, false, db);
+}
+
+// src/mcp/index.ts
+init_strip();
+// package.json
+var package_default = {
+  name: "@hasna/connectors",
+  version: "1.3.3",
+  description: "Open source connector library - Install API connectors with a single command",
+  type: "module",
+  bin: {
+    connectors: "./bin/index.js",
+    "connectors-mcp": "./bin/mcp.js",
+    "connectors-serve": "./bin/serve.js"
+  },
+  files: [
+    "bin/",
+    "dist/",
+    "dashboard/dist/",
+    "connectors/",
+    "README.md"
+  ],
+  exports: {
+    ".": {
+      import: "./dist/index.js",
+      types: "./dist/index.d.ts"
+    }
+  },
+  main: "./dist/index.js",
+  types: "./dist/index.d.ts",
+  scripts: {
+    build: "cd dashboard && bun run build && cd .. && bun build ./src/cli/index.tsx --outdir ./bin --target bun --external ink --external react --external chalk --external conf && bun build ./src/mcp/index.ts --outfile ./bin/mcp.js --target bun && bun build ./src/server/index.ts --outfile ./bin/serve.js --target bun && bun build ./src/index.ts --outdir ./dist --target bun && tsc --emitDeclarationOnly --outDir ./dist",
+    "build:dashboard": "cd dashboard && bun run build",
+    postinstall: '[ "$SKIP_DASHBOARD" = "1" ] || [ ! -f dashboard/package.json ] || [ -d dashboard/node_modules ] || (cd dashboard && bun install)',
+    dev: "bun run ./src/cli/index.tsx",
+    typecheck: "tsc --noEmit",
+    test: "bun test",
+    "sdk:build": "cd sdk && bun run build",
+    prepublishOnly: "bun test && bun run build"
+  },
+  keywords: [
+    "connectors",
+    "api",
+    "cli",
+    "typescript",
+    "bun",
+    "figma",
+    "stripe",
+    "github",
+    "openai",
+    "mcp",
+    "model-context-protocol"
+  ],
+  author: "Hasna",
+  license: "Apache-2.0",
+  devDependencies: {
+    "@types/bun": "latest",
+    "@types/react": "^18.2.0",
+    "ink-testing-library": "^4.0.0",
+    typescript: "^5"
+  },
+  dependencies: {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    chalk: "^5.3.0",
+    commander: "^12.1.0",
+    conf: "^13.0.1",
+    "fast-xml-parser": "^5.5.3",
+    ink: "^5.0.1",
+    "ink-select-input": "^6.0.0",
+    "ink-spinner": "^5.0.0",
+    "ink-text-input": "^6.0.0",
+    open: "^11.0.0",
+    react: "^18.2.0",
+    zod: "3"
+  },
+  engines: {
+    bun: ">=1.0.0"
+  },
+  publishConfig: {
+    registry: "https://registry.npmjs.org",
+    access: "public"
+  },
+  repository: {
+    type: "git",
+    url: "git+https://github.com/hasna/connectors.git"
+  },
+  homepage: "https://github.com/hasna/connectors#readme",
+  bugs: {
+    url: "https://github.com/hasna/connectors/issues"
+  }
+};
+
 // src/mcp/index.ts
 loadConnectorVersions();
+async function stripped(text) {
+  return { content: [{ type: "text", text: await maybeStrip(text) }] };
+}
 var server = new McpServer({
   name: "connectors",
-  version: "1.1.9"
+  version: package_default.version
 });
 server.registerTool("search_connectors", {
   title: "Search Connectors",
   description: "Search connectors by name or keyword.",
   inputSchema: { query: exports_external.string() }
 }, async ({ query }) => {
-  const results = searchConnectors(query);
-  return {
-    content: [
-      {
-        type: "text",
-        text: JSON.stringify(results.map((c) => ({
-          name: c.name,
-          displayName: c.displayName,
-          version: c.version,
-          category: c.category,
-          description: c.description
-        })), null, 2)
-      }
-    ]
-  };
+  const { getInstalledConnectors: getInstalledConnectors2 } = await Promise.resolve().then(() => (init_installer(), exports_installer));
+  const { getPromotedConnectors: getPromotedConnectors2 } = await Promise.resolve().then(() => (init_promotions(), exports_promotions));
+  const { getUsageMap: getUsageMap2 } = await Promise.resolve().then(() => (init_usage(), exports_usage));
+  const results = searchConnectors(query, {
+    installed: getInstalledConnectors2(),
+    promoted: getPromotedConnectors2(),
+    usage: getUsageMap2()
+  });
+  return stripped(JSON.stringify(results.map((c) => ({ name: c.name, displayName: c.displayName, version: c.version, category: c.category, description: c.description, score: c.score, badges: c.badges })), null, 2));
 });
 server.registerTool("list_connectors", {
   title: "List Connectors",
@@ -25837,9 +27157,7 @@ server.registerTool("list_connectors", {
     category: c.category,
     description: c.description
   }));
-  return {
-    content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
-  };
+  return stripped(JSON.stringify(data, null, 2));
 });
 server.registerTool("connector_docs", {
   title: "Connector Documentation",
@@ -25881,14 +27199,14 @@ server.registerTool("connector_docs", {
 });
 server.registerTool("install_connector", {
   title: "Install Connector",
-  description: "Verify connectors are available in the global package.",
+  description: "Install connectors into .connectors/.",
   inputSchema: {
     names: exports_external.array(exports_external.string()),
     overwrite: exports_external.boolean().optional()
   }
-}, async ({ names }) => {
-  const results = names.map((name) => installConnector(name));
-  const summary = results.map((r) => r.success ? `\u2713 ${r.connector} available at ${r.path}` : `\u2717 ${r.connector}: ${r.error}`);
+}, async ({ names, overwrite }) => {
+  const results = names.map((name) => installConnector(name, { overwrite: overwrite ?? false }));
+  const summary = results.map((r) => r.success ? `\u2713 ${r.connector} \u2192 ${r.path}` : `\u2717 ${r.connector}: ${r.error}`);
   return {
     content: [
       {
@@ -25896,7 +27214,8 @@ server.registerTool("install_connector", {
         text: JSON.stringify({
           results,
           summary: summary.join(`
-`)
+`),
+          usage: results.some((r) => r.success) ? "Import from './.connectors': import { " + results.filter((r) => r.success).map((r) => r.connector).join(", ") + " } from './.connectors'" : undefined
         }, null, 2)
       }
     ]
@@ -25904,22 +27223,22 @@ server.registerTool("install_connector", {
 });
 server.registerTool("remove_connector", {
   title: "Remove Connector",
-  description: "Remove connector auth/credentials from ~/.connectors/. Does not remove the connector from the global package.",
+  description: "Remove an installed connector.",
   inputSchema: { name: exports_external.string() }
 }, async ({ name }) => {
-  removeConnector(name);
+  const removed = removeConnector(name);
   return {
     content: [
       {
         type: "text",
-        text: JSON.stringify({ name, message: "Connector auth can be cleared with configure_auth. The connector itself is part of the global package." })
+        text: JSON.stringify({ name, removed })
       }
     ]
   };
 });
 server.registerTool("list_installed", {
   title: "List Installed Connectors",
-  description: "List all connectors available in the global package.",
+  description: "List connectors installed in .connectors/.",
   inputSchema: {}
 }, async () => {
   const installed = getInstalledConnectors();
@@ -25991,7 +27310,7 @@ server.registerTool("configure_auth", {
   }
 }, async ({ name, key, field }) => {
   try {
-    saveApiKey(name, key, field);
+    await saveApiKey(name, key, field);
     return {
       content: [
         {
@@ -26087,18 +27406,11 @@ server.registerTool("run_connector_operation", {
   description: "Execute an API operation on a connector. Pass the connector name and CLI arguments. Use list_connector_operations first to discover available commands. Example: name='stripe', args=['products', 'list', '--limit', '5']",
   inputSchema: {
     name: exports_external.string().describe("Connector name (e.g. stripe, gmail, anthropic)"),
-    args: exports_external.union([exports_external.array(exports_external.string()), exports_external.string()]).describe("CLI arguments for the connector command (e.g. ['products', 'list', '--limit', '5'])"),
+    args: exports_external.array(exports_external.string()).describe("CLI arguments for the connector command (e.g. ['products', 'list', '--limit', '5'])"),
     format: exports_external.enum(["json", "pretty"]).optional().describe("Output format (default: json for structured parsing)"),
     timeout: exports_external.number().optional().describe("Timeout in milliseconds (default: 30000)")
   }
-}, async ({ name, args: rawArgs, format, timeout }) => {
-  const args = typeof rawArgs === "string" ? (() => {
-    try {
-      return JSON.parse(rawArgs);
-    } catch {
-      return [rawArgs];
-    }
-  })() : rawArgs;
+}, async ({ name, args, format, timeout }) => {
   const meta = getConnector(name);
   if (!meta) {
     return {
@@ -26106,6 +27418,10 @@ server.registerTool("run_connector_operation", {
       isError: true
     };
   }
+  try {
+    const { logUsage: logUsage2 } = await Promise.resolve().then(() => (init_usage(), exports_usage));
+    logUsage2(name, "run");
+  } catch {}
   const finalArgs = [...args];
   if (format) {
     finalArgs.push("--format", format);
@@ -26188,7 +27504,7 @@ server.registerTool("setup_connector", {
   }
   if (key) {
     try {
-      saveApiKey(name, key, field);
+      await saveApiKey(name, key, field);
     } catch (error2) {
       return {
         content: [
@@ -26274,10 +27590,142 @@ server.registerTool("describe_tools", {
 `);
   return { content: [{ type: "text", text: result }] };
 });
+server.registerTool("get_hot_connectors", { title: "Get Hot Connectors", description: "Top connectors by usage.", inputSchema: { limit: exports_external.number().optional(), days: exports_external.number().optional() } }, async ({ limit, days }) => {
+  const { getTopConnectors: getTopConnectors2 } = await Promise.resolve().then(() => (init_usage(), exports_usage));
+  const { getPromotedConnectors: getPromotedConnectors2 } = await Promise.resolve().then(() => (init_promotions(), exports_promotions));
+  const top = getTopConnectors2(limit ?? 10, days ?? 7);
+  const promoted = new Set(getPromotedConnectors2());
+  const result = top.map((t) => ({ ...t, promoted: promoted.has(t.connector) }));
+  return stripped(JSON.stringify(result, null, 2));
+});
+server.registerTool("promote_connector", { title: "Promote Connector", description: "Boost a connector in search rankings.", inputSchema: { name: exports_external.string() } }, async ({ name }) => {
+  const meta = getConnector(name);
+  if (!meta)
+    return { content: [{ type: "text", text: JSON.stringify({ error: "Connector not found" }) }], isError: true };
+  const { promoteConnector: promoteConnector2 } = await Promise.resolve().then(() => (init_promotions(), exports_promotions));
+  promoteConnector2(name);
+  return { content: [{ type: "text", text: JSON.stringify({ success: true, connector: name }) }] };
+});
+server.registerTool("demote_connector", { title: "Demote Connector", description: "Remove search ranking boost.", inputSchema: { name: exports_external.string() } }, async ({ name }) => {
+  const { demoteConnector: demoteConnector2 } = await Promise.resolve().then(() => (init_promotions(), exports_promotions));
+  const removed = demoteConnector2(name);
+  return { content: [{ type: "text", text: JSON.stringify({ success: removed, connector: name }) }] };
+});
+server.registerTool("list_jobs", { title: "List Jobs", description: "List scheduled connector jobs.", inputSchema: {} }, async () => {
+  const { listJobs: listJobs2 } = await Promise.resolve().then(() => (init_jobs(), exports_jobs));
+  const { getDatabase: getDatabase2 } = await Promise.resolve().then(() => (init_database(), exports_database));
+  return stripped(JSON.stringify(listJobs2(getDatabase2()), null, 2));
+});
+server.registerTool("get_latest_job_run", { title: "Get Latest Job Run", description: "Get the most recent run output for a job.", inputSchema: { name: exports_external.string() } }, async ({ name }) => {
+  const { getJobByName: getJobByName2, getLatestRun: getLatestRun2 } = await Promise.resolve().then(() => (init_jobs(), exports_jobs));
+  const { getDatabase: getDatabase2 } = await Promise.resolve().then(() => (init_database(), exports_database));
+  const db = getDatabase2();
+  const job = getJobByName2(name, db);
+  if (!job)
+    return { content: [{ type: "text", text: JSON.stringify({ error: `Job "${name}" not found` }) }], isError: true };
+  const run = getLatestRun2(job.id, db);
+  return stripped(JSON.stringify(run ?? { message: "No runs yet" }, null, 2));
+});
+server.registerTool("run_job", { title: "Run Job", description: "Manually trigger a scheduled job.", inputSchema: { name: exports_external.string() } }, async ({ name }) => {
+  const { getJobByName: getJobByName2 } = await Promise.resolve().then(() => (init_jobs(), exports_jobs));
+  const { getDatabase: getDatabase2 } = await Promise.resolve().then(() => (init_database(), exports_database));
+  const { triggerJob: triggerJob2 } = await Promise.resolve().then(() => (init_scheduler(), exports_scheduler));
+  const db = getDatabase2();
+  const job = getJobByName2(name, db);
+  if (!job)
+    return { content: [{ type: "text", text: JSON.stringify({ error: `Job "${name}" not found` }) }], isError: true };
+  const result = await triggerJob2(job, db);
+  return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.registerTool("list_workflows", { title: "List Workflows", description: "List connector workflows.", inputSchema: {} }, async () => {
+  const { listWorkflows: listWorkflows2 } = await Promise.resolve().then(() => (init_workflows(), exports_workflows));
+  const { getDatabase: getDatabase2 } = await Promise.resolve().then(() => (init_database(), exports_database));
+  return stripped(JSON.stringify(listWorkflows2(getDatabase2()), null, 2));
+});
+server.registerTool("run_workflow", { title: "Run Workflow", description: "Execute a connector workflow pipeline.", inputSchema: { name: exports_external.string() } }, async ({ name }) => {
+  const { getWorkflowByName: getWorkflowByName2 } = await Promise.resolve().then(() => (init_workflows(), exports_workflows));
+  const { getDatabase: getDatabase2 } = await Promise.resolve().then(() => (init_database(), exports_database));
+  const { runWorkflow: runWorkflow2 } = await Promise.resolve().then(() => (init_workflow_runner(), exports_workflow_runner));
+  const wf = getWorkflowByName2(name, getDatabase2());
+  if (!wf)
+    return { content: [{ type: "text", text: JSON.stringify({ error: `Workflow "${name}" not found` }) }], isError: true };
+  const result = await runWorkflow2(wf);
+  return stripped(JSON.stringify(result, null, 2));
+});
+server.registerTool("get_llm_config", {
+  title: "Get LLM Config",
+  description: "Get current LLM provider config and strip status.",
+  inputSchema: {}
+}, async () => {
+  const { getLlmConfig: getConfig, maskKey: mask } = await Promise.resolve().then(() => (init_llm(), exports_llm));
+  const config2 = getConfig();
+  if (!config2)
+    return { content: [{ type: "text", text: JSON.stringify({ configured: false }) }] };
+  return { content: [{ type: "text", text: JSON.stringify({ configured: true, provider: config2.provider, model: config2.model, key: mask(config2.api_key), strip: config2.strip }) }] };
+});
+server.registerTool("set_llm_strip", {
+  title: "Set LLM Strip",
+  description: "Enable or disable global output stripping.",
+  inputSchema: { enabled: exports_external.boolean() }
+}, async ({ enabled }) => {
+  const { setLlmStrip: setLlmStrip2 } = await Promise.resolve().then(() => (init_llm(), exports_llm));
+  try {
+    setLlmStrip2(enabled);
+    return { content: [{ type: "text", text: JSON.stringify({ success: true, strip: enabled }) }] };
+  } catch (e) {
+    return { content: [{ type: "text", text: JSON.stringify({ success: false, error: e instanceof Error ? e.message : String(e) }) }], isError: true };
+  }
+});
+server.registerTool("register_agent", {
+  title: "Register Agent",
+  description: "Register or heartbeat an agent. Returns agent or conflict error.",
+  inputSchema: {
+    name: exports_external.string(),
+    session_id: exports_external.string().optional(),
+    role: exports_external.string().optional()
+  }
+}, async ({ name, session_id, role }) => {
+  const result = registerAgent({ name, session_id, role });
+  if (isAgentConflict(result)) {
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+  }
+  return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.registerTool("list_agents", {
+  title: "List Agents",
+  description: "List all registered agents.",
+  inputSchema: {}
+}, async () => {
+  const agents = listAgents();
+  return { content: [{ type: "text", text: JSON.stringify(agents, null, 2) }] };
+});
+server.registerTool("check_rate_budget", {
+  title: "Check Rate Budget",
+  description: "Consume one rate budget unit for an agent+connector. Returns budget status or RateExceededError.",
+  inputSchema: {
+    agent_id: exports_external.string(),
+    connector: exports_external.string(),
+    limit: exports_external.number().describe("Connector's documented rate limit (calls/min)")
+  }
+}, async ({ agent_id, connector, limit }) => {
+  const result = checkRateBudget(agent_id, connector, limit);
+  return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.registerTool("get_rate_budget", {
+  title: "Get Rate Budget",
+  description: "Peek at rate budget status without consuming a unit.",
+  inputSchema: {
+    agent_id: exports_external.string(),
+    connector: exports_external.string(),
+    limit: exports_external.number().describe("Connector's documented rate limit (calls/min)")
+  }
+}, async ({ agent_id, connector, limit }) => {
+  const result = getRateBudget(agent_id, connector, limit);
+  return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
 async function main() {
   const transport = new StdioServerTransport;
   await server.connect(transport);
-  console.error("Connectors MCP server running on stdio");
 }
 main().catch((error2) => {
   console.error("Fatal error:", error2);