@outlit/cli 1.3.1 → 1.5.0

package/dist/cli.js

@@ -104,7 +104,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@outlit/cli",
-    version: "1.3.1",
+    version: "1.5.0",
     description: "CLI for Outlit customer intelligence platform",
     license: "Apache-2.0",
     repository: {
@@ -120,7 +120,9 @@ var init_package = __esm(() => {
     bin: {
       outlit: "./dist/cli.js"
     },
-    files: ["dist"],
+    files: [
+      "dist"
+    ],
     scripts: {
       dev: "bun run src/cli.ts",
       "dev:watch": "bun --watch src/cli.ts",
@@ -136,15 +138,46 @@ var init_package = __esm(() => {
       "@clack/prompts": "^1.0.1"
     },
     devDependencies: {
-      typescript: "^5.5.0",
+      typescript: "^5.9.3",
       "@types/bun": "latest"
     }
   };
 });
 
 // src/lib/tty.ts
+import { execFileSync } from "node:child_process";
+import { createInterface } from "node:readline";
 function openBrowserCmd() {
-  return process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
+  return process.platform === "darwin" ? "open" : "xdg-open";
+}
+function openBrowser(url) {
+  try {
+    if (process.platform === "win32") {
+      execFileSync("cmd", ["/c", "start", "", url.replace(/&/g, "^&")], { stdio: "ignore" });
+    } else {
+      execFileSync(openBrowserCmd(), [url], { stdio: "ignore" });
+    }
+    return true;
+  } catch {
+    return false;
+  }
+}
+function promptInput(label, opts) {
+  return new Promise((resolve) => {
+    const rl = createInterface({
+      input: process.stdin,
+      output: opts?.secret ? undefined : process.stderr,
+      terminal: !opts?.secret
+    });
+    process.stderr.write(`${label}: `);
+    rl.question("", (answer) => {
+      rl.close();
+      if (opts?.secret)
+        process.stderr.write(`
+`);
+      resolve(answer.trim());
+    });
+  });
 }
 function isInteractive() {
   if (!process.stdin.isTTY || !process.stdout.isTTY)
@@ -189,6 +222,70 @@ var init_output = __esm(() => {
   init_tty();
 });
 
+// src/lib/config.ts
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+function isEnoentError(err) {
+  return err instanceof Error && err.code === "ENOENT";
+}
+function splitCsv(value) {
+  return value.split(",").map((s) => s.trim());
+}
+function getConfigDir() {
+  if (process.platform === "win32") {
+    return join(process.env.APPDATA ?? join(homedir(), "AppData", "Roaming"), "outlit");
+  }
+  return join(process.env.XDG_CONFIG_HOME ?? join(homedir(), ".config"), "outlit");
+}
+function resolveApiKey(flagValue) {
+  if (flagValue)
+    return { key: flagValue, source: "flag" };
+  const envKey = process.env.OUTLIT_API_KEY;
+  if (envKey)
+    return { key: envKey, source: "env" };
+  const credPath = join(getConfigDir(), "credentials.json");
+  if (existsSync(credPath)) {
+    try {
+      const raw = readFileSync(credPath, "utf-8");
+      const config = JSON.parse(raw);
+      if (config.apiKey)
+        return { key: config.apiKey, source: "config" };
+    } catch {}
+  }
+  return null;
+}
+function maskKey(key) {
+  if (key.length <= 9)
+    return key;
+  return `${key.slice(0, 5)}...${key.slice(-4)}`;
+}
+function requireCredential(flagApiKey, json) {
+  const credential = resolveApiKey(flagApiKey);
+  if (!credential) {
+    return outputError({
+      message: "Not authenticated. Run `outlit auth login` or pass --api-key.",
+      code: "not_authenticated"
+    }, json);
+  }
+  return credential;
+}
+function storeApiKey(apiKey) {
+  const configDir = getConfigDir();
+  mkdirSync(configDir, { recursive: true, mode: 448 });
+  const credPath = join(configDir, "credentials.json");
+  writeFileSync(credPath, JSON.stringify({ apiKey }, null, 2), { mode: 384 });
+  return credPath;
+}
+var CLI_VERSION2, DEFAULT_API_URL = "https://app.outlit.ai", OUTLIT_DASHBOARD_URL = "https://app.outlit.ai/workspace-profile", OUTLIT_SIGNUP_URL = "https://app.outlit.ai/sign-up", TICK2;
+var init_config = __esm(() => {
+  init_package();
+  init_output();
+  init_tty();
+  CLI_VERSION2 = package_default.version;
+  TICK2 = `\x1B[32m${isUnicodeSupported ? String.fromCodePoint(10003) : String.fromCodePoint(8730)}\x1B[0m`;
+});
+
 // ../../node_modules/.bun/citty@0.2.1/node_modules/citty/dist/index.mjs
 function defineCommand2(def) {
   return def;
@@ -679,7 +776,7 @@ var import_picocolors, import_sisteransi, at = (t) => t === 161 || t === 164 ||
 ` && (r && p && (i += st(r)), n && (i += it(n))), V += h.length, m = A, A = g.next();
   }
   return i;
-}, At, _, bt, z, rt = (t) => ("columns" in t) && typeof t.columns == "number" ? t.columns : 80, nt = (t) => ("rows" in t) && typeof t.rows == "number" ? t.rows : 20, Vt, yt, Mt, Wt;
+}, At, _, bt, z, rt = (t) => ("columns" in t) && typeof t.columns == "number" ? t.columns : 80, nt = (t) => ("rows" in t) && typeof t.rows == "number" ? t.rows : 20, Vt, kt, yt, Mt, Wt;
 var init_dist2 = __esm(() => {
   import_picocolors = __toESM(require_picocolors(), 1);
   import_sisteransi = __toESM(require_src(), 1);
@@ -758,6 +855,23 @@ var init_dist2 = __esm(() => {
       }
     }
   };
+  kt = class kt extends x {
+    get cursor() {
+      return this.value ? 0 : 1;
+    }
+    get _value() {
+      return this.cursor === 0;
+    }
+    constructor(e) {
+      super(e, false), this.value = !!e.initialValue, this.on("userInput", () => {
+        this.value = this._value;
+      }), this.on("confirm", (s) => {
+        this.output.write(import_sisteransi.cursor.move(0, -1)), this.value = s, this.state = "submit", this.close();
+      }), this.on("cursor", () => {
+        this.value = !this.value;
+      });
+    }
+  };
   yt = class yt extends x {
     options;
     cursor = 0;
@@ -1073,6 +1187,32 @@ var import_picocolors2, import_sisteransi2, et2, ct2 = () => process.env.CI ===
     for (const w of A)
       B2.push(w);
   return h && B2.push(g), B2;
+}, Re = (t) => {
+  const r = t.active ?? "Yes", s = t.inactive ?? "No";
+  return new kt({ active: r, inactive: s, signal: t.signal, input: t.input, output: t.output, initialValue: t.initialValue ?? true, render() {
+    const i = t.withGuide ?? _.withGuide, a = `${i ? `${import_picocolors2.default.gray(d)}
+` : ""}${W2(this.state)}  ${t.message}
+`, o = this.value ? r : s;
+    switch (this.state) {
+      case "submit": {
+        const u = i ? `${import_picocolors2.default.gray(d)}  ` : "";
+        return `${a}${u}${import_picocolors2.default.dim(o)}`;
+      }
+      case "cancel": {
+        const u = i ? `${import_picocolors2.default.gray(d)}  ` : "";
+        return `${a}${u}${import_picocolors2.default.strikethrough(import_picocolors2.default.dim(o))}${i ? `
+${import_picocolors2.default.gray(d)}` : ""}`;
+      }
+      default: {
+        const u = i ? `${import_picocolors2.default.cyan(d)}  ` : "", l = i ? import_picocolors2.default.cyan(x2) : "";
+        return `${a}${u}${this.value ? `${import_picocolors2.default.green(Q2)} ${r}` : `${import_picocolors2.default.dim(H2)} ${import_picocolors2.default.dim(r)}`}${t.vertical ? i ? `
+${import_picocolors2.default.cyan(d)}  ` : `
+` : ` ${import_picocolors2.default.dim("/")} `}${this.value ? `${import_picocolors2.default.dim(H2)} ${import_picocolors2.default.dim(s)}` : `${import_picocolors2.default.green(Q2)} ${s}`}
+${l}
+`;
+      }
+    }
+  } }).prompt();
 }, R2, Ne = (t = "", r) => {
   (r?.output ?? process.stdout).write(`${import_picocolors2.default.gray(x2)}  ${import_picocolors2.default.red(t)}
 
@@ -1304,12 +1444,12 @@ var exports_signup = {};
 __export(exports_signup, {
   default: () => signup_default
 });
-import { execFileSync } from "node:child_process";
-var OUTLIT_SIGNUP_URL = "https://app.outlit.ai/sign-up", signup_default;
+var signup_default;
 var init_signup = __esm(() => {
   init_dist3();
   init_dist();
   init_output2();
+  init_config();
   init_output();
   init_tty();
   signup_default = defineCommand2({
@@ -1335,124 +1475,19 @@ var init_signup = __esm(() => {
       if (isInteractive()) {
         We("Outlit CLI -- Sign Up");
       }
-      try {
-        if (process.platform === "win32") {
-          execFileSync("cmd", ["/c", "start", "", OUTLIT_SIGNUP_URL], { stdio: "ignore" });
+      const opened = openBrowser(OUTLIT_SIGNUP_URL);
+      if (isInteractive()) {
+        if (opened) {
+          R2.info(`Opening ${OUTLIT_SIGNUP_URL}`);
         } else {
-          execFileSync(openBrowserCmd(), [OUTLIT_SIGNUP_URL], { stdio: "ignore" });
+          R2.info(`Could not open browser. Visit ${OUTLIT_SIGNUP_URL}`);
         }
-      } catch {}
-      if (isInteractive()) {
-        R2.info(`Opening ${OUTLIT_SIGNUP_URL}`);
         Le("Once you've signed up, run `outlit auth login` to store your API key.");
       }
     }
   });
 });
 
-// src/lib/config.ts
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { dirname, join } from "node:path";
-function isEnoentError(err) {
-  return err instanceof Error && err.code === "ENOENT";
-}
-function splitCsv(value) {
-  return value.split(",").map((s) => s.trim());
-}
-function getClaudeDesktopConfigPath() {
-  const home = homedir();
-  switch (process.platform) {
-    case "win32":
-      return join(process.env.APPDATA ?? join(home, "AppData", "Roaming"), "Claude", "claude_desktop_config.json");
-    case "darwin":
-      return join(home, "Library", "Application Support", "Claude", "claude_desktop_config.json");
-    default:
-      return join(home, ".config", "Claude", "claude_desktop_config.json");
-  }
-}
-function getConfigDir() {
-  if (process.platform === "win32") {
-    return join(process.env.APPDATA ?? join(homedir(), "AppData", "Roaming"), "outlit");
-  }
-  return join(process.env.XDG_CONFIG_HOME ?? join(homedir(), ".config"), "outlit");
-}
-function resolveApiKey(flagValue) {
-  if (flagValue)
-    return { key: flagValue, source: "flag" };
-  const envKey = process.env.OUTLIT_API_KEY;
-  if (envKey)
-    return { key: envKey, source: "env" };
-  const credPath = join(getConfigDir(), "credentials.json");
-  if (existsSync(credPath)) {
-    try {
-      const raw = readFileSync(credPath, "utf-8");
-      const config = JSON.parse(raw);
-      if (config.apiKey)
-        return { key: config.apiKey, source: "config" };
-    } catch {}
-  }
-  return null;
-}
-function maskKey(key) {
-  if (key.length <= 9)
-    return key;
-  return `${key.slice(0, 5)}...${key.slice(-4)}`;
-}
-function readJsonConfig(filePath) {
-  if (!existsSync(filePath))
-    return {};
-  try {
-    return JSON.parse(readFileSync(filePath, "utf-8"));
-  } catch {
-    return {};
-  }
-}
-function requireCredential(flagApiKey, json) {
-  const credential = resolveApiKey(flagApiKey);
-  if (!credential) {
-    return outputError({
-      message: "Not authenticated. Run `outlit auth login` or pass --api-key.",
-      code: "not_authenticated"
-    }, json);
-  }
-  return credential;
-}
-function writeConfigFile(filePath, content, opts) {
-  try {
-    mkdirSync(dirname(filePath), { recursive: true });
-    writeFileSync(filePath, content);
-    return true;
-  } catch (err) {
-    return outputError({ message: errorMessage(err, `Failed to write ${opts.label}`), code: "write_error" }, opts.json);
-  }
-}
-function mergeOutlitMcpConfig(configPath, serversKey, outlitConfig, opts) {
-  const existing = readJsonConfig(configPath);
-  const existingServers = existing[serversKey] ?? {};
-  const merged = {
-    ...existing,
-    [serversKey]: { ...existingServers, outlit: outlitConfig }
-  };
-  writeConfigFile(configPath, `${JSON.stringify(merged, null, 2)}
-`, opts);
-}
-function storeApiKey(apiKey) {
-  const configDir = getConfigDir();
-  mkdirSync(configDir, { recursive: true, mode: 448 });
-  const credPath = join(configDir, "credentials.json");
-  writeFileSync(credPath, JSON.stringify({ apiKey }, null, 2), { mode: 384 });
-  return credPath;
-}
-var CLI_VERSION2, DEFAULT_MCP_URL = "https://mcp.outlit.ai/mcp", DEFAULT_API_URL = "https://app.outlit.ai", OUTLIT_DASHBOARD_URL = "https://app.outlit.ai/workspace-profile", TICK2;
-var init_config = __esm(() => {
-  init_package();
-  init_output();
-  init_tty();
-  CLI_VERSION2 = package_default.version;
-  TICK2 = `\x1B[32m${isUnicodeSupported ? String.fromCodePoint(10003) : String.fromCodePoint(8730)}\x1B[0m`;
-});
-
 // src/lib/client.ts
 function buildUrl(base, path, params) {
   const url = new URL(path, base);
@@ -1461,6 +1496,8 @@ function buildUrl(base, path, params) {
       continue;
     if (Array.isArray(value)) {
       url.searchParams.set(key, value.join(","));
+    } else if (typeof value === "object") {
+      url.searchParams.set(key, JSON.stringify(value));
     } else {
       url.searchParams.set(key, String(value));
     }
@@ -1518,10 +1555,23 @@ var init_client = __esm(() => {
     outlit_get_customer: { method: "POST", path: "/api/internal/mcp/customers" },
     outlit_list_users: { method: "GET", path: "/api/internal/mcp/users" },
     outlit_get_timeline: { method: "POST", path: "/api/internal/mcp/timeline" },
-    outlit_get_facts: { method: "POST", path: "/api/internal/mcp/facts" },
+    outlit_list_facts: { method: "POST", path: "/api/internal/mcp/facts" },
+    outlit_get_fact: { method: "POST", path: "/api/internal/mcp/facts/get" },
+    outlit_get_source: { method: "POST", path: "/api/internal/mcp/context-source" },
     outlit_schema: { method: "GET", path: "/api/internal/mcp/sql-schema" },
     outlit_query: { method: "POST", path: "/api/internal/mcp/sql" },
-    outlit_search_customer_context: { method: "POST", path: "/api/internal/mcp/context-search" }
+    outlit_search_customer_context: { method: "POST", path: "/api/internal/mcp/context-search" },
+    outlit_list_integrations: { method: "GET", path: "/api/internal/mcp/integrations" },
+    outlit_connect_integration: { method: "POST", path: "/api/internal/mcp/integrations/connect" },
+    outlit_connect_status: { method: "GET", path: "/api/internal/mcp/integrations/connect/status" },
+    outlit_disconnect_integration: {
+      method: "POST",
+      path: "/api/internal/mcp/integrations/disconnect"
+    },
+    outlit_integration_sync_status: {
+      method: "GET",
+      path: "/api/internal/mcp/integrations/sync-status"
+    }
   };
 });
 
@@ -1649,8 +1699,26 @@ async function getClientOrExit(flagApiKey, json) {
   return createClient(flagApiKey).catch((err) => outputError({ message: errorMessage(err, "Authentication failed"), code: "auth_required" }, json));
 }
 async function pingApiKey(apiKey) {
-  const client = await createClient(apiKey);
-  await client.callTool("outlit_list_customers", { limit: 1 });
+  const baseUrl = process.env.OUTLIT_API_URL ?? DEFAULT_API_URL;
+  const url = new URL("/api/internal/mcp/validate-api-key", baseUrl).toString();
+  const response = await globalThis.fetch(url, {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${apiKey}`
+    }
+  });
+  const text = await response.text();
+  const payload = text.length > 0 ? (() => {
+    try {
+      return JSON.parse(text);
+    } catch {
+      return null;
+    }
+  })() : null;
+  if (!response.ok || !payload?.valid) {
+    const message = payload?.error ?? (text.length > 0 ? text : `API error (${response.status})`);
+    throw new Error(message);
+  }
 }
 async function validateKeyOrExit(apiKey, json) {
   try {
@@ -1702,6 +1770,7 @@ async function runTool(client, toolName, params, json, opts) {
 }
 var init_api = __esm(() => {
   init_client();
+  init_config();
   init_output();
   init_spinner();
   init_table();
@@ -1712,7 +1781,6 @@ var exports_login = {};
 __export(exports_login, {
   default: () => login_default
 });
-import { execFileSync as execFileSync2 } from "node:child_process";
 var login_default;
 var init_login = __esm(() => {
   init_dist3();
@@ -1773,14 +1841,12 @@ Format: ok_ followed by 32+ alphanumeric characters.`
         if (Ct(method))
           cancelLogin();
         if (method === "browser") {
-          try {
-            if (process.platform === "win32") {
-              execFileSync2("cmd", ["/c", "start", "", OUTLIT_DASHBOARD_URL], { stdio: "ignore" });
-            } else {
-              execFileSync2(openBrowserCmd(), [OUTLIT_DASHBOARD_URL], { stdio: "ignore" });
-            }
-          } catch {}
-          R2.info("Opening browser... paste your key once you have it.");
+          const opened = openBrowser(OUTLIT_DASHBOARD_URL);
+          if (opened) {
+            R2.info("Opening browser... paste your key once you have it.");
+          } else {
+            R2.info(`Could not open browser. Visit ${OUTLIT_DASHBOARD_URL} manually.`);
+          }
         }
         const result = await He({
           message: "Paste your Outlit API key:",
@@ -1838,8 +1904,8 @@ var exports_logout = {};
 __export(exports_logout, {
   default: () => logout_default
 });
-import { rmSync } from "node:fs";
-import { join as join2 } from "node:path";
+import { rmSync as rmSync2 } from "node:fs";
+import { join as join3 } from "node:path";
 var logout_default;
 var init_logout = __esm(() => {
   init_dist();
@@ -1865,13 +1931,13 @@ var init_logout = __esm(() => {
     async run({ args }) {
       const json = !!args.json;
       const configDir = getConfigDir();
-      const credPath = join2(configDir, "credentials.json");
+      const credPath = join3(configDir, "credentials.json");
       if (process.env.OUTLIT_API_KEY) {
         process.stderr.write(`Warning: OUTLIT_API_KEY env var is still set and will continue to work after logout.
 `);
       }
       try {
-        rmSync(credPath, { force: true });
+        rmSync2(credPath, { force: true });
       } catch (err) {
         if (!isEnoentError(err)) {
           return outputError({ message: errorMessage(err, "Failed to remove credentials file"), code: "unlink_error" }, json);
@@ -2026,6 +2092,38 @@ var init_auth2 = __esm(() => {
 });
 
 // src/args/filters.ts
+function parseTraitFilterValue(value) {
+  if (value === "true")
+    return true;
+  if (value === "false")
+    return false;
+  const parsed = Number(value);
+  if (value.trim() !== "" && Number.isFinite(parsed)) {
+    return parsed;
+  }
+  return value;
+}
+function parseTraitFilters(input) {
+  if (!input)
+    return;
+  const entries = input.split(",").map((entry) => entry.trim()).filter(Boolean);
+  if (entries.length === 0)
+    return;
+  const filters = {};
+  for (const entry of entries) {
+    const separatorIndex = entry.indexOf("=");
+    if (separatorIndex <= 0 || separatorIndex === entry.length - 1) {
+      throw new Error(`Invalid trait filter "${entry}". Expected key=value.`);
+    }
+    const key = entry.slice(0, separatorIndex).trim();
+    const rawValue = entry.slice(separatorIndex + 1).trim();
+    if (!/^[A-Za-z0-9_-]{1,100}$/.test(key)) {
+      throw new Error(`Invalid trait filter key "${key}". Keys may only contain letters, numbers, underscores, and dashes.`);
+    }
+    filters[key] = parseTraitFilterValue(rawValue);
+  }
+  return filters;
+}
 function applyListFilters(params, args) {
   if (args["no-activity-in"])
     params.noActivityInLast = args["no-activity-in"];
@@ -2038,7 +2136,7 @@ function applyListFilters(params, args) {
   if (args["order-direction"])
     params.orderDirection = args["order-direction"];
 }
-var activityFilterArgs, orderArgs;
+var activityFilterArgs, orderArgs, traitFilterArgs;
 var init_filters = __esm(() => {
   activityFilterArgs = {
     "no-activity-in": {
@@ -2062,6 +2160,12 @@ var init_filters = __esm(() => {
       default: "desc"
     }
   };
+  traitFilterArgs = {
+    trait: {
+      type: "string",
+      description: "Filter by traits using key=value pairs. Separate multiple filters with commas (e.g. role=admin,active=true)"
+    }
+  };
 });
 
 // src/args/pagination.ts
@@ -2097,6 +2201,148 @@ Use this to fetch the next page of results.`
   };
 });
 
+// src/generated/tool-contracts.ts
+function resolveCustomerContextSearchInput(value) {
+  if (!value.query) {
+    return {
+      ok: false,
+      message: "A query argument is required"
+    };
+  }
+  const normalizedQuery = value.query.trim();
+  if (normalizedQuery.length < 2) {
+    return {
+      ok: false,
+      message: "Query must be at least 2 non-whitespace characters"
+    };
+  }
+  if (value.after !== undefined && value.before !== undefined && new Date(value.after).getTime() > new Date(value.before).getTime()) {
+    return {
+      ok: false,
+      message: "--after must be before or equal to --before"
+    };
+  }
+  return {
+    ok: true,
+    request: {
+      query: normalizedQuery,
+      customer: value.customer,
+      topK: value.topK,
+      after: value.after,
+      before: value.before,
+      sourceTypes: value.sourceTypes
+    }
+  };
+}
+var customerToolContracts, customerBillingStatuses, customerFactStatuses, customerIncludeSections, customerSourceTypes, customerTimeframes, timelineChannels, timelineTimeframes, userJourneyStages, schemaTables;
+var init_tool_contracts = __esm(() => {
+  customerToolContracts = {
+    outlit_list_customers: {
+      toolName: "outlit_list_customers",
+      description: "Browse and filter customers. Use this to find customers by billing status, activity recency, revenue, or name. Returns a paginated list with summary info (MRR, last activity, status)."
+    },
+    outlit_list_users: {
+      toolName: "outlit_list_users",
+      description: "Browse and filter users. Use this to find users by journey stage, activity recency, customer, or email/name. Returns a paginated list with activity info."
+    },
+    outlit_get_customer: {
+      toolName: "outlit_get_customer",
+      description: "Get full details for a single customer. Use this when you already know which customer you want to inspect. Optionally include related data (users, revenue, recent activity, engagement metrics)."
+    },
+    outlit_get_timeline: {
+      toolName: "outlit_get_timeline",
+      description: "Get the chronological activity timeline for a customer. Use this to see what happened and when — emails, calls, Slack messages, billing events, etc. Supports channel and date filtering."
+    },
+    outlit_list_facts: {
+      toolName: "outlit_list_facts",
+      description: "List structured facts known about a customer. Use filters like status, sourceTypes, and date bounds to narrow the result set. For topic-specific retrieval, use outlit_search_customer_context instead."
+    },
+    outlit_get_fact: {
+      toolName: "outlit_get_fact",
+      description: "Get one exact fact by ID. Returns the canonical fact shape and optionally expands requested related data such as evidence."
+    },
+    outlit_get_source: {
+      toolName: "outlit_get_source",
+      description: "Get one exact source record by generic sourceType and sourceId. Use this when you already know the concrete underlying source you want to inspect."
+    },
+    outlit_search_customer_context: {
+      toolName: "outlit_search_customer_context",
+      description: "Search across all known customer context using a natural-language query. Returns grouped artifact-level results for matching sources and facts. Omit customer to search across all customers in the organization."
+    },
+    outlit_query: {
+      toolName: "outlit_query",
+      description: `Execute raw SQL queries against your analytics data.
+
+Available tables:
+- events: Customer activity events (event_type, event_channel, customer_id, occurred_at, properties, ...)
+- customer_dimensions: Customer attributes (customer_id, domain, name, billing_status, plan, mrr_cents, ...)
+- user_dimensions: User attributes (user_id, email, name, customer_id, ...)
+- mrr_snapshots: Revenue snapshots over time (customer_id, snapshot_date, mrr_cents, ...)
+
+All queries are automatically filtered to your organization's data.
+Only SELECT queries are allowed.
+
+Example queries:
+- SELECT event_type, count(*) FROM events GROUP BY 1 ORDER BY 2 DESC LIMIT 10
+- SELECT billing_status, sum(mrr_cents)/100 as mrr FROM customer_dimensions GROUP BY 1
+- SELECT * FROM events WHERE customer_id = 'cust_123' ORDER BY occurred_at DESC LIMIT 50`
+    },
+    outlit_schema: {
+      toolName: "outlit_schema",
+      description: `Get table schemas for available analytics tables.
+
+Use this to discover column names, types, and descriptions before writing SQL queries.
+Returns column definitions and example queries for each table.`
+    }
+  };
+  customerBillingStatuses = [
+    "NONE",
+    "TRIALING",
+    "PAYING",
+    "PAST_DUE",
+    "CHURNED"
+  ];
+  customerFactStatuses = [
+    "ACTIVE",
+    "ACKNOWLEDGED",
+    "RESOLVED",
+    "SNOOZED",
+    "CANDIDATE"
+  ];
+  customerIncludeSections = [
+    "users",
+    "revenue",
+    "recentTimeline",
+    "behaviorMetrics"
+  ];
+  customerSourceTypes = ["EMAIL", "CALL", "CALENDAR_EVENT", "SUPPORT_TICKET"];
+  customerTimeframes = ["7d", "14d", "30d", "90d"];
+  timelineChannels = [
+    "SDK",
+    "EMAIL",
+    "SLACK",
+    "CALL",
+    "CRM",
+    "BILLING",
+    "SUPPORT",
+    "INTERNAL"
+  ];
+  timelineTimeframes = ["7d", "14d", "30d", "90d", "all"];
+  userJourneyStages = [
+    "DISCOVERED",
+    "SIGNED_UP",
+    "ACTIVATED",
+    "ENGAGED",
+    "INACTIVE"
+  ];
+  schemaTables = [
+    "events",
+    "customer_dimensions",
+    "user_dimensions",
+    "mrr_snapshots"
+  ];
+});
+
 // src/lib/format.ts
 function formatCents(value) {
   if (value == null || typeof value !== "number" || Number.isNaN(value))
@@ -2137,6 +2383,16 @@ function truncate(value, maxLen) {
     return "...".slice(0, maxLen);
   return `${str.slice(0, maxLen - 3)}...`;
 }
+function capitalize(value) {
+  if (value == null || typeof value !== "string")
+    return "--";
+  return value.charAt(0).toUpperCase() + value.slice(1);
+}
+function formatNumber(value) {
+  if (value == null || typeof value !== "number" || Number.isNaN(value))
+    return "--";
+  return value.toLocaleString("en-US");
+}
 
 // src/commands/customers/list.ts
 var exports_list = {};
@@ -2150,6 +2406,7 @@ var init_list = __esm(() => {
   init_filters();
   init_output2();
   init_pagination();
+  init_tool_contracts();
   init_api();
   init_output();
   list_default = defineCommand2({
@@ -2168,7 +2425,7 @@ var init_list = __esm(() => {
         "  outlit customers list --mrr-above 10000 --limit 50      # high-value at-risk",
         "  outlit customers list --json | jq '.items[].domain'     # pipe-friendly",
         "",
-        "Billing statuses: NONE, TRIALING, PAYING, PAST_DUE, CHURNED",
+        `Billing statuses: ${customerBillingStatuses.join(", ")}`,
         "Activity periods: 7d, 14d, 30d, 90d",
         "",
         AGENT_JSON_HINT
@@ -2180,10 +2437,11 @@ var init_list = __esm(() => {
       ...outputArgs,
       ...paginationArgs,
       ...activityFilterArgs,
+      ...traitFilterArgs,
       ...orderArgs,
       "billing-status": {
         type: "string",
-        description: "Filter by billing status (NONE, TRIALING, PAYING, PAST_DUE, CHURNED)"
+        description: `Filter by billing status (${customerBillingStatuses.join(", ")})`
       },
       "mrr-above": {
         type: "string",
@@ -2196,14 +2454,6 @@ var init_list = __esm(() => {
       search: {
         type: "string",
         description: "Search by customer name or domain"
-      },
-      status: {
-        type: "string",
-        description: "Customer status filter (PROVISIONAL, ACTIVE, CHURNED, MERGED)"
-      },
-      type: {
-        type: "string",
-        description: "Customer type filter (COMPANY, INDIVIDUAL)"
       }
     },
     async run({ args }) {
@@ -2226,16 +2476,25 @@ var init_list = __esm(() => {
         }
         params.mrrBelow = value;
       }
-      applyListFilters(params, args);
-      applyPagination(params, args, json);
-      if (args.status)
-        params.status = args.status;
-      if (args.type)
-        params.type = args.type;
-      return runTool(client, "outlit_list_customers", params, json, {
-        spinnerMessage: "Fetching customers...",
-        table: {
-          columns: [
+      if (args.trait) {
+        try {
+          const traitFilters = parseTraitFilters(args.trait);
+          if (traitFilters) {
+            params.traitFilters = traitFilters;
+          }
+        } catch (error) {
+          return outputError({
+            message: error instanceof Error ? error.message : "Invalid --trait filter",
+            code: "invalid_input"
+          }, json);
+        }
+      }
+      applyListFilters(params, args);
+      applyPagination(params, args, json);
+      return runTool(client, customerToolContracts.outlit_list_customers.toolName, params, json, {
+        spinnerMessage: "Fetching customers...",
+        table: {
+          columns: [
             { header: "Name", key: "name", format: (v) => truncate(v, 24) },
             { header: "Domain", key: "domain" },
             { header: "Billing", key: "billingStatus" },
@@ -2258,6 +2517,7 @@ var init_get = __esm(() => {
   init_dist();
   init_auth();
   init_output2();
+  init_tool_contracts();
   init_api();
   init_config();
   get_default = defineCommand2({
@@ -2274,6 +2534,9 @@ var init_get = __esm(() => {
         'Naming note: --include users returns data under the "contacts" key in',
         "the response. This is a server-side naming inconsistency, not a CLI bug.",
         "",
+        `Available include sections: ${customerIncludeSections.join(", ")}`,
+        `Timeframes: ${customerTimeframes.join(", ")}`,
+        "",
         "Examples:",
         "  outlit customers get acme.com",
         "  outlit customers get acme.com --include users,revenue",
@@ -2295,7 +2558,7 @@ var init_get = __esm(() => {
         type: "string",
         description: [
           "Comma-separated sections to include in response.",
-          "Available: users, revenue, recentTimeline, behaviorMetrics",
+          `Available: ${customerIncludeSections.join(", ")}`,
           'Note: "users" maps to "contacts" in the response (server naming).'
         ].join(`
 `)
@@ -2316,7 +2579,7 @@ var init_get = __esm(() => {
       if (args.include) {
         params.include = splitCsv(args.include);
       }
-      return runTool(client, "outlit_get_customer", params, json);
+      return runTool(client, customerToolContracts.outlit_get_customer.toolName, params, json);
     }
   });
 });
@@ -2332,6 +2595,7 @@ var init_timeline = __esm(() => {
   init_auth();
   init_output2();
   init_pagination();
+  init_tool_contracts();
   init_api();
   init_config();
   timeline_default = defineCommand2({
@@ -2346,6 +2610,8 @@ var init_timeline = __esm(() => {
         "",
         "Timeframe is used when no explicit date range is set.",
         "When --start-date or --end-date is provided, --timeframe is ignored.",
+        `Channels: ${timelineChannels.join(", ")}`,
+        `Timeframes: ${timelineTimeframes.join(", ")}`,
         "",
         "Examples:",
         "  outlit customers timeline acme.com",
@@ -2369,7 +2635,7 @@ var init_timeline = __esm(() => {
       },
       channels: {
         type: "string",
-        description: "Comma-separated list of channels to filter (e.g. EMAIL,SLACK)"
+        description: `Comma-separated list of channels to filter (${timelineChannels.join(", ")})`
       },
       "event-types": {
         type: "string",
@@ -2377,7 +2643,7 @@ var init_timeline = __esm(() => {
       },
       timeframe: {
         type: "string",
-        description: "Timeframe for events (e.g. 7d, 14d, 30d, 90d). Ignored when --start-date or --end-date is set.",
+        description: `Timeframe for events (${timelineTimeframes.join(", ")}). Ignored when --start-date or --end-date is set.`,
         default: "30d"
       },
       "start-date": {
@@ -2409,7 +2675,7 @@ var init_timeline = __esm(() => {
         params.eventTypes = splitCsv(args["event-types"]);
       }
       applyPagination(params, args, json);
-      return runTool(client, "outlit_get_timeline", params, json);
+      return runTool(client, customerToolContracts.outlit_get_timeline.toolName, params, json);
     }
   });
 });
@@ -2458,7 +2724,9 @@ var init_list2 = __esm(() => {
   init_filters();
   init_output2();
   init_pagination();
+  init_tool_contracts();
   init_api();
+  init_output();
   list_default2 = defineCommand2({
     meta: {
       name: "list",
@@ -2470,7 +2738,7 @@ var init_list2 = __esm(() => {
         "",
         "Examples:",
         "  outlit users list                                          # all users",
-        "  outlit users list --journey-stage CHAMPION                # champions only",
+        "  outlit users list --journey-stage ENGAGED                 # engaged users only",
         "  outlit users list --customer-id <uuid>                    # users for a customer",
         "  outlit users list --no-activity-in 30d                    # inactive users",
         "  outlit users list --search alice --order-by last_activity_at",
@@ -2484,9 +2752,10 @@ var init_list2 = __esm(() => {
       ...authArgs,
       ...outputArgs,
       ...paginationArgs,
+      ...traitFilterArgs,
       "journey-stage": {
         type: "string",
-        description: "Filter by journey stage (e.g. CHAMPION, AT_RISK, CHURNED)"
+        description: `Filter by journey stage (${userJourneyStages.join(", ")})`
       },
       "customer-id": {
         type: "string",
@@ -2507,9 +2776,22 @@ var init_list2 = __esm(() => {
         params.journeyStage = args["journey-stage"];
       if (args["customer-id"])
         params.customerId = args["customer-id"];
+      if (args.trait) {
+        try {
+          const traitFilters = parseTraitFilters(args.trait);
+          if (traitFilters) {
+            params.traitFilters = traitFilters;
+          }
+        } catch (error) {
+          return outputError({
+            message: error instanceof Error ? error.message : "Invalid --trait filter",
+            code: "invalid_input"
+          }, json);
+        }
+      }
       applyListFilters(params, args);
       applyPagination(params, args, json);
-      return runTool(client, "outlit_list_users", params, json, {
+      return runTool(client, customerToolContracts.outlit_list_users.toolName, params, json, {
         spinnerMessage: "Fetching users...",
         table: {
           columns: [
@@ -2553,361 +2835,177 @@ var init_users = __esm(() => {
   });
 });
 
-// src/lib/setup.ts
-import { execFileSync as execFileSync3 } from "node:child_process";
-function runMcpCliSetup(key, json, opts, exitOnError = true) {
-  try {
-    execFileSync3(opts.cliName, [
-      "mcp",
-      "add",
-      "--transport",
-      "http",
-      "outlit",
-      DEFAULT_MCP_URL,
-      "--header",
-      `Authorization: Bearer ${key}`
-    ], { stdio: "pipe" });
-  } catch (err) {
-    if (exitOnError) {
-      if (isEnoentError(err)) {
-        return outputError({ message: opts.notFoundMessage, code: opts.notFoundCode }, json);
-      }
-      opts.extraErrorHandler?.(err, json);
-      return outputError({ message: errorMessage(err, `${opts.cliName} mcp add failed`), code: "exec_error" }, json);
-    }
-    return { success: false, error: errorMessage(err, `${opts.cliName} mcp add failed`) };
-  }
-  if (exitOnError) {
-    if (isJsonMode(json)) {
-      outputResult({ success: true, agent: opts.agentId });
-      return { success: true };
-    }
-    console.log(`${TICK2} ${opts.successMessage}`);
+// src/lib/update.ts
+import { execFileSync as execFileSync3, spawn as spawn2, spawnSync as spawnSync2 } from "node:child_process";
+import { existsSync as existsSync3, mkdirSync as mkdirSync3, readFileSync as readFileSync3, realpathSync as realpathSync2, rmSync as rmSync3, writeFileSync as writeFileSync3 } from "node:fs";
+import { homedir as homedir3 } from "node:os";
+import { dirname as dirname3, join as join4 } from "node:path";
+function compareVersions2(a, b) {
+  const aParts = a.split("-")[0]?.split(".").map((part) => Number.parseInt(part, 10) || 0) ?? [];
+  const bParts = b.split("-")[0]?.split(".").map((part) => Number.parseInt(part, 10) || 0) ?? [];
+  const maxLength = Math.max(aParts.length, bParts.length);
+  for (let index = 0;index < maxLength; index++) {
+    const left = aParts[index] ?? 0;
+    const right = bParts[index] ?? 0;
+    if (left > right)
+      return 1;
+    if (left < right)
+      return -1;
   }
-  return { success: true };
+  return 0;
 }
-function runMcpFileSetup(key, json, opts, exitOnError = true) {
-  const mcpConfig = opts.mcpConfig ?? {
-    url: DEFAULT_MCP_URL,
-    headers: { Authorization: `Bearer ${key}` }
-  };
-  try {
-    mergeOutlitMcpConfig(opts.configPath, opts.serversKey, mcpConfig, { json, label: opts.label });
-  } catch (err) {
-    if (!exitOnError) {
-      return { success: false, error: errorMessage(err, `Failed to write ${opts.label}`) };
+function inferInstallerFromUserAgent2(agent) {
+  if (agent.startsWith("bun/"))
+    return "bun";
+  if (agent.startsWith("npm/"))
+    return "npm";
+  if (agent.startsWith("pnpm/"))
+    return "pnpm";
+  if (agent.startsWith("yarn/"))
+    return "yarn";
+  return null;
+}
+function isUnderPath2(path, parent) {
+  const normalizedPath = normalizeInstallerPath2(path);
+  const normalizedParent = normalizeInstallerPath2(parent);
+  return normalizedPath === normalizedParent || normalizedPath.startsWith(`${normalizedParent}/`);
+}
+function normalizeInstallerPath2(path) {
+  return path.replace(/^\/private\/tmp\//, "/tmp/");
+}
+function inferInstallerFromInstallation2(opts) {
+  const candidatePaths = [opts.argv1, opts.realExecPath].filter((value) => !!value);
+  if (opts.npmGlobalPrefix) {
+    const npmPackageRoots = [
+      join4(opts.npmGlobalPrefix, "node_modules", PACKAGE_NAME2),
+      join4(opts.npmGlobalPrefix, "lib", "node_modules", PACKAGE_NAME2)
+    ];
+    if (candidatePaths.some((path) => npmPackageRoots.some((root) => isUnderPath2(path, root)))) {
+      return "npm";
     }
-    throw err;
   }
-  if (exitOnError) {
-    if (isJsonMode(json)) {
-      outputResult({ success: true, path: opts.configPath, agent: opts.agentId });
-      return { success: true };
+  if (opts.bunGlobalBin) {
+    const bunGlobalBin = opts.bunGlobalBin;
+    if (candidatePaths.some((path) => isUnderPath2(path, bunGlobalBin))) {
+      return "bun";
     }
-    console.log(`${TICK2} ${opts.successMessage}`);
   }
-  return { success: true };
+  return null;
 }
-var init_setup = __esm(() => {
-  init_config();
-  init_output();
-});
-
-// src/commands/setup/claude-code.ts
-var exports_claude_code = {};
-__export(exports_claude_code, {
-  default: () => claude_code_default,
-  configureSafe: () => configureSafe
-});
-function configureSafe(key, json) {
-  return runMcpCliSetup(key, json, getConfig(), false).success;
-}
-var getConfig = () => ({
-  cliName: "claude",
-  agentId: "claude-code",
-  notFoundMessage: "claude CLI not found. Install from https://claude.ai/code",
-  notFoundCode: "claude_not_found",
-  successMessage: "Outlit added to Claude Code. Restart Claude Code to apply."
-}), claude_code_default;
-var init_claude_code = __esm(() => {
-  init_dist();
-  init_auth();
-  init_output2();
-  init_config();
-  init_setup();
-  claude_code_default = defineCommand2({
-    meta: {
-      name: "claude-code",
-      description: "Register Outlit MCP server with Claude Code via `claude mcp add`."
-    },
-    args: { ...authArgs, ...outputArgs },
-    run({ args }) {
-      const json = !!args.json;
-      const { key } = requireCredential(args["api-key"], json);
-      runMcpCliSetup(key, json, getConfig());
-    }
-  });
-});
-
-// src/commands/setup/claude-desktop.ts
-var exports_claude_desktop = {};
-__export(exports_claude_desktop, {
-  default: () => claude_desktop_default,
-  configureSafe: () => configureSafe2
-});
-function configureSafe2(key, json) {
-  return runMcpFileSetup(key, json, getConfig2(key), false).success;
+function readCommandOutput2(command, args) {
+  try {
+    return execFileSync3(command, args, {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"]
+    }).trim();
+  } catch {
+    return null;
+  }
 }
-var getConfig2 = (key) => {
-  const configPath = getClaudeDesktopConfigPath();
-  return {
-    agentId: "claude-desktop",
-    configPath,
-    serversKey: "mcpServers",
-    label: "Claude Desktop config",
-    successMessage: `Outlit added to Claude Desktop. Restart Claude Desktop to apply.
-  Config: ${configPath}`,
-    mcpConfig: { command: "outlit", args: ["mcp", "serve"], env: { OUTLIT_API_KEY: key } }
-  };
-}, claude_desktop_default;
-var init_claude_desktop = __esm(() => {
-  init_dist();
-  init_auth();
-  init_output2();
-  init_config();
-  init_setup();
-  claude_desktop_default = defineCommand2({
-    meta: {
-      name: "claude-desktop",
-      description: "Add Outlit MCP server to Claude Desktop config."
-    },
-    args: { ...authArgs, ...outputArgs },
-    run({ args }) {
-      const json = !!args.json;
-      const { key } = requireCredential(args["api-key"], json);
-      runMcpFileSetup(key, json, getConfig2(key));
-    }
-  });
-});
-
-// src/commands/setup/cursor.ts
-var exports_cursor = {};
-__export(exports_cursor, {
-  default: () => cursor_default,
-  configureSafe: () => configureSafe3
-});
-import { homedir as homedir2 } from "node:os";
-import { join as join3 } from "node:path";
-function configureSafe3(key, json) {
-  return runMcpFileSetup(key, json, getConfig3(), false).success;
-}
-var getConfig3 = () => ({
-  agentId: "cursor",
-  configPath: join3(homedir2(), ".cursor", "mcp.json"),
-  serversKey: "mcpServers",
-  label: "cursor mcp.json",
-  successMessage: `Outlit added to Cursor MCP config. Restart Cursor to apply.
-  Config: ~/.cursor/mcp.json`
-}), cursor_default;
-var init_cursor = __esm(() => {
-  init_dist();
-  init_auth();
-  init_output2();
-  init_config();
-  init_setup();
-  cursor_default = defineCommand2({
-    meta: {
-      name: "cursor",
-      description: "Add Outlit MCP server to ~/.cursor/mcp.json."
-    },
-    args: { ...authArgs, ...outputArgs },
-    run({ args }) {
-      const json = !!args.json;
-      const { key } = requireCredential(args["api-key"], json);
-      runMcpFileSetup(key, json, getConfig3());
-    }
-  });
-});
-
-// src/commands/setup/gemini.ts
-var exports_gemini = {};
-__export(exports_gemini, {
-  default: () => gemini_default,
-  configureSafe: () => configureSafe4
-});
-function configureSafe4(key, json) {
-  return runMcpCliSetup(key, json, getConfig4(), false).success;
-}
-var getConfig4 = () => ({
-  cliName: "gemini",
-  agentId: "gemini",
-  notFoundMessage: "gemini CLI not found. Install from https://github.com/google-gemini/gemini-cli",
-  notFoundCode: "gemini_not_found",
-  successMessage: "Outlit added to Gemini CLI. Restart Gemini CLI to apply."
-}), gemini_default;
-var init_gemini = __esm(() => {
-  init_dist();
-  init_auth();
-  init_output2();
-  init_config();
-  init_output();
-  init_setup();
-  gemini_default = defineCommand2({
-    meta: {
-      name: "gemini",
-      description: "Register Outlit MCP server with Gemini CLI via `gemini mcp add`."
-    },
-    args: { ...authArgs, ...outputArgs },
-    run({ args }) {
-      const json = !!args.json;
-      const { key } = requireCredential(args["api-key"], json);
-      runMcpCliSetup(key, json, {
-        ...getConfig4(),
-        extraErrorHandler(err, j2) {
-          const msg = err instanceof Error ? err.message.toLowerCase() : "";
-          if (msg.includes("mcp") && msg.includes("not")) {
-            outputError({
-              message: "Your Gemini CLI version does not support 'mcp add'. Run 'gemini update' or reinstall.",
-              code: "gemini_mcp_unsupported"
-            }, j2);
-          }
-        }
-      });
-    }
+function inferInstaller2() {
+  const fromAgent = inferInstallerFromUserAgent2(process.env.npm_config_user_agent ?? "");
+  if (fromAgent)
+    return fromAgent;
+  const argv1 = process.argv[1];
+  const realExecPath = argv1 ? readCommandOutput2("realpath", [argv1]) ?? safeRealPath2(argv1) : null;
+  const npmGlobalPrefix = process.env.npm_config_prefix ?? readCommandOutput2("npm", ["prefix", "-g"]);
+  const bunGlobalBin = process.env.BUN_INSTALL ? join4(process.env.BUN_INSTALL, "bin") : readCommandOutput2("bun", ["pm", "bin", "-g"]) ?? join4(homedir3(), ".bun", "bin");
+  return inferInstallerFromInstallation2({
+    argv1,
+    realExecPath,
+    npmGlobalPrefix,
+    bunGlobalBin
   });
-});
-
-// src/commands/setup/openclaw.ts
-var exports_openclaw = {};
-__export(exports_openclaw, {
-  getSkillDir: () => getSkillDir,
-  default: () => openclaw_default,
-  configureSafe: () => configureSafe5,
-  buildSkillContent: () => buildSkillContent
-});
-import { existsSync as existsSync2 } from "node:fs";
-import { homedir as homedir3 } from "node:os";
-import { join as join4 } from "node:path";
-function getSkillDir() {
-  const home = homedir3();
-  const clawdDir = join4(home, "clawd");
-  if (existsSync2(clawdDir)) {
-    return join4(clawdDir, "skills", "outlit-intelligence");
-  }
-  return join4(home, ".openclaw", "skills", "outlit-intelligence");
-}
-function buildSkillContent(maskedKey) {
-  return `---
-name: outlit-intelligence
-description: Query customer data, revenue metrics, and analytics via the Outlit CLI.
-metadata:
-  openclaw:
-    requires:
-      bins: ["outlit"]
-      env: ["OUTLIT_API_KEY"]
----
-
-# Outlit Customer Intelligence
-
-You have access to the \`outlit\` CLI for querying customer data and analytics.
-The CLI outputs structured JSON automatically in non-TTY contexts.
-
-## Authentication
-
-Set the env var before running any command:
-
-    export OUTLIT_API_KEY=${maskedKey}
-
-## List customers
-
-    outlit customers list --billing-status PAYING --no-activity-in 30d --order-by mrr_cents
-
-## Get customer details
-
-    outlit customers get acme.com --include users,revenue,recentTimeline
-
-## Get customer activity timeline
-
-    outlit customers timeline acme.com --channels EMAIL,SLACK --limit 50
-
-## List users for a customer
-
-    outlit users list --customer-id <uuid> --journey-stage ACTIVATED
-
-## Search across customer context
-
-    outlit search "budget concerns" --customer acme.com
-
-## Get facts about a customer
-
-    outlit facts acme.com --timeframe 90d
-
-## Run custom SQL
-
-    outlit sql "SELECT event_type, count(*) FROM events GROUP BY 1 ORDER BY 2 DESC LIMIT 10"
-
-## Query with a file (for complex SQL)
-
-    outlit sql --query-file /tmp/query.sql
-
-## Discover table schemas
-
-    outlit schema
-    outlit schema events
-
-## Rules
-- Always parse the JSON response before reporting to the user
-- Convert monetary values from cents to dollars (divide by 100)
-- IDs are UUIDs (e.g., "a1b2c3d4-e5f6-...")
-- Never show the raw API key to the user
-- Use --query-file for complex SQL to avoid shell escaping issues
-- All list responses include pagination.hasMore and pagination.nextCursor
-`;
 }
-function configureSafe5(key, json) {
-  const skillPath = join4(getSkillDir(), "SKILL.md");
+function safeRealPath2(filePath) {
   try {
-    writeConfigFile(skillPath, buildSkillContent(maskKey(key)), { json, label: "SKILL.md" });
-    return true;
+    return realpathSync2(filePath);
   } catch {
-    return false;
+    return null;
   }
 }
-var openclaw_default;
-var init_openclaw = __esm(() => {
-  init_dist();
-  init_auth();
-  init_output2();
+function formatUpdateCommand2(installer = inferInstaller2()) {
+  switch (installer) {
+    case "bun":
+      return "bun add -g @outlit/cli";
+    case "npm":
+      return "npm install -g @outlit/cli";
+    case "pnpm":
+      return "pnpm add -g @outlit/cli";
+    case "yarn":
+      return "yarn global add @outlit/cli";
+    default:
+      return `update ${PACKAGE_NAME2} with your package manager`;
+  }
+}
+function getUpgradeCommand(installer = inferInstaller2()) {
+  switch (installer) {
+    case "bun":
+      return {
+        command: "bun",
+        args: ["add", "-g", "@outlit/cli"],
+        displayCommand: "bun add -g @outlit/cli"
+      };
+    case "npm":
+      return {
+        command: "npm",
+        args: ["install", "-g", "@outlit/cli"],
+        displayCommand: "npm install -g @outlit/cli"
+      };
+    case "pnpm":
+      return {
+        command: "pnpm",
+        args: ["add", "-g", "@outlit/cli"],
+        displayCommand: "pnpm add -g @outlit/cli"
+      };
+    case "yarn":
+      return {
+        command: "yarn",
+        args: ["global", "add", "@outlit/cli"],
+        displayCommand: "yarn global add @outlit/cli"
+      };
+    default:
+      return null;
+  }
+}
+async function fetchLatestCliVersion2() {
+  const response = await fetch(LATEST_VERSION_URL2, { signal: AbortSignal.timeout(5000) });
+  if (!response.ok)
+    throw new Error("registry unavailable");
+  const data = await response.json();
+  if (!data.version)
+    throw new Error("registry returned no version");
+  return data.version;
+}
+function runUpgradeCommand(command) {
+  const result = spawnSync2(command.command, command.args, { stdio: "inherit" });
+  if (result.error)
+    throw result.error;
+  if (result.status !== 0 || result.signal) {
+    throw new Error(`Upgrade command failed: ${command.displayCommand}`);
+  }
+}
+var UPDATE_CHECK_INTERVAL_MS2, PACKAGE_NAME2 = "@outlit/cli", LATEST_VERSION_URL2 = "https://registry.npmjs.org/@outlit%2Fcli/latest";
+var init_update = __esm(() => {
   init_config();
-  init_output();
-  openclaw_default = defineCommand2({
-    meta: {
-      name: "openclaw",
-      description: "Write Outlit intelligence skill to ~/clawd/skills/ for OpenClaw."
-    },
-    args: { ...authArgs, ...outputArgs },
-    run({ args }) {
-      const json = !!args.json;
-      const { key } = requireCredential(args["api-key"], json);
-      const skillPath = join4(getSkillDir(), "SKILL.md");
-      const content = buildSkillContent(maskKey(key));
-      writeConfigFile(skillPath, content, { json, label: "SKILL.md" });
-      if (isJsonMode(json)) {
-        return outputResult({ success: true, path: skillPath, agent: "openclaw" });
-      }
-      console.log(`${TICK2} Outlit skill written to ${skillPath}. OpenClaw will load it automatically.`);
-    }
-  });
+  init_tty();
+  UPDATE_CHECK_INTERVAL_MS2 = 12 * 60 * 60 * 1000;
 });
 
 // src/commands/setup/skills.ts
 var exports_skills = {};
 __export(exports_skills, {
   runSkillsInstall: () => runSkillsInstall,
+  runAgentSkillsInstall: () => runAgentSkillsInstall,
+  getSkillAgentId: () => getSkillAgentId,
   detectPackageRunner: () => detectPackageRunner,
-  default: () => skills_default
+  default: () => skills_default,
+  SKILLS_REPO_URL: () => SKILLS_REPO_URL
 });
 import { execFileSync as execFileSync4 } from "node:child_process";
+function getSkillAgentId(agent) {
+  return skillAgentMap[agent];
+}
 function detectPackageRunner() {
   const whichCmd = process.platform === "win32" ? "where" : "which";
   for (const runner of ["npx", "bunx", "pnpx"]) {
@@ -2918,16 +3016,32 @@ function detectPackageRunner() {
   }
   return null;
 }
-function buildRunnerArgs(runner) {
+function buildRunnerArgs(runner, opts) {
   const args = runner === "npx" ? ["-y"] : [];
   args.push("skills", "add", SKILLS_REPO_URL);
-  for (const name of SKILL_NAMES) {
-    args.push("--skill", name);
+  for (const skillName of opts.skillNames ?? []) {
+    args.push("--skill", skillName);
+  }
+  for (const agent of opts.agents ?? []) {
+    args.push("--agent", agent);
+  }
+  if (opts.autoConfirm) {
+    args.push("-y");
+  }
+  if (opts.global !== false) {
+    args.push("-g");
   }
-  args.push("-y", "-g");
   return args;
 }
-function runSkillsInstall(json, exitOnError = true) {
+function runSkillsInstall(opts) {
+  const {
+    json,
+    exitOnError = true,
+    agents,
+    skillNames,
+    reportedAgent = "skills",
+    autoConfirm = false
+  } = opts;
   const runner = detectPackageRunner();
   if (!runner) {
     if (exitOnError) {
@@ -2938,8 +3052,11 @@ function runSkillsInstall(json, exitOnError = true) {
     }
     return { success: false, error: "No package runner found" };
   }
+  const isInteractiveInstall = (agents?.length ?? 0) === 0 && (skillNames?.length ?? 0) === 0 && !autoConfirm && !isJsonMode(json);
   try {
-    execFileSync4(runner, buildRunnerArgs(runner), { stdio: "pipe" });
+    execFileSync4(runner, buildRunnerArgs(runner, { agents, skillNames, autoConfirm }), {
+      stdio: isInteractiveInstall ? "inherit" : "pipe"
+    });
   } catch (err) {
     if (exitOnError) {
       if (isEnoentError(err)) {
@@ -2958,210 +3075,355 @@ function runSkillsInstall(json, exitOnError = true) {
   }
   if (exitOnError) {
     if (isJsonMode(json)) {
-      outputResult({ success: true, agent: "skills", runner });
+      outputResult({ success: true, agent: reportedAgent, runner });
       return { success: true, runner };
     }
-    console.log(`${TICK2} Agent skills installed (${SKILL_NAMES.join(", ")})`);
+    if (reportedAgent === "skills") {
+      console.log(`${TICK2} Outlit skills installer completed (${runner})`);
+    } else {
+      console.log(`${TICK2} Outlit skill installed for ${reportedAgent}`);
+    }
   }
   return { success: true, runner };
 }
-var SKILLS_REPO_URL = "https://github.com/OutlitAI/outlit-agent-skills", SKILL_NAMES, skills_default;
+function runAgentSkillsInstall(agent, json, exitOnError = true) {
+  return runSkillsInstall({
+    json,
+    exitOnError,
+    agents: [getSkillAgentId(agent)],
+    skillNames: [DEFAULT_SKILL_NAME],
+    reportedAgent: agent,
+    autoConfirm: true
+  });
+}
+var SKILLS_REPO_URL = "https://github.com/OutlitAI/outlit-agent-skills", DEFAULT_SKILL_NAME = "outlit", skillAgentMap, skills_default;
 var init_skills = __esm(() => {
   init_dist();
   init_output2();
   init_config();
   init_output();
-  SKILL_NAMES = ["outlit-cli", "outlit-sdk"];
+  skillAgentMap = {
+    "claude-code": "claude-code",
+    codex: "codex",
+    gemini: "gemini-cli",
+    droid: "droid",
+    opencode: "opencode",
+    pi: "pi",
+    openclaw: "openclaw"
+  };
   skills_default = defineCommand2({
     meta: {
       name: "skills",
       description: [
-        "Install Outlit agent skills for Claude Code and other AI agents.",
+        "Launch the interactive Skills installer for Outlit.",
         "",
-        "Downloads outlit-cli and outlit-sdk skills from github.com/OutlitAI/outlit-agent-skills.",
+        "Uses the Outlit skills repo and lets you choose `outlit` and optional extras like `outlit-sdk`.",
         "No API key required."
       ].join(`
 `)
     },
     args: { ...outputArgs },
     run({ args }) {
-      const json = !!args.json;
-      runSkillsInstall(json);
+      runSkillsInstall({ json: !!args.json });
     }
   });
 });
 
-// src/commands/setup/vscode.ts
-var exports_vscode = {};
-__export(exports_vscode, {
-  default: () => vscode_default,
-  configureSafe: () => configureSafe6
+// src/commands/setup/claude-code.ts
+var exports_claude_code = {};
+__export(exports_claude_code, {
+  default: () => claude_code_default
 });
-import { join as join5 } from "node:path";
-function configureSafe6(key, json) {
-  return runMcpFileSetup(key, json, getConfig5(), false).success;
-}
-var getConfig5 = () => ({
-  agentId: "vscode",
-  configPath: join5(process.cwd(), ".vscode", "mcp.json"),
-  serversKey: "servers",
-  label: ".vscode/mcp.json",
-  successMessage: "Outlit MCP config written to .vscode/mcp.json. Restart VS Code to apply."
-}), vscode_default;
-var init_vscode = __esm(() => {
+var claude_code_default;
+var init_claude_code = __esm(() => {
   init_dist();
-  init_auth();
   init_output2();
-  init_config();
-  init_setup();
-  vscode_default = defineCommand2({
+  init_skills();
+  claude_code_default = defineCommand2({
     meta: {
-      name: "vscode",
-      description: "Write Outlit MCP config to .vscode/mcp.json in the current directory."
+      name: "claude-code",
+      description: "Install the Outlit skill for Claude Code."
     },
-    args: { ...authArgs, ...outputArgs },
+    args: { ...outputArgs },
     run({ args }) {
-      const json = !!args.json;
-      const { key } = requireCredential(args["api-key"], json);
-      runMcpFileSetup(key, json, getConfig5());
+      runAgentSkillsInstall("claude-code", !!args.json);
     }
   });
 });
 
-// src/commands/setup/index.ts
-import { execFileSync as execFileSync5 } from "node:child_process";
-import { existsSync as existsSync3 } from "node:fs";
-import { homedir as homedir4 } from "node:os";
-import { join as join6 } from "node:path";
-function isCommandAvailable(cmd) {
-  try {
-    const whichCmd = process.platform === "win32" ? "where" : "which";
-    execFileSync5(whichCmd, [cmd], { stdio: "ignore" });
-    return true;
-  } catch {
-    return false;
-  }
-}
-function detectAgents() {
-  const home = homedir4();
-  const detected = [];
-  if (existsSync3(join6(home, ".cursor")))
-    detected.push("cursor");
-  if (isCommandAvailable("claude"))
-    detected.push("claude-code");
-  if (existsSync3(getClaudeDesktopConfigPath()))
-    detected.push("claude-desktop");
-  if (isCommandAvailable("code") || existsSync3(join6(process.cwd(), ".vscode")))
-    detected.push("vscode");
-  if (isCommandAvailable("gemini"))
-    detected.push("gemini");
-  if (existsSync3(join6(home, "clawd", "skills")) || existsSync3(join6(home, ".openclaw", "skills")))
-    detected.push("openclaw");
-  return detected;
-}
-var agentLabels, configurators, setup_default;
-var init_setup2 = __esm(() => {
+// src/commands/setup/codex.ts
+var exports_codex = {};
+__export(exports_codex, {
+  default: () => codex_default
+});
+var codex_default;
+var init_codex = __esm(() => {
   init_dist();
-  init_auth();
   init_output2();
-  init_config();
-  init_output();
-  init_claude_code();
-  init_claude_desktop();
-  init_cursor();
-  init_gemini();
-  init_openclaw();
   init_skills();
-  init_vscode();
-  agentLabels = {
-    cursor: { label: "Cursor", hint: "~/.cursor/" },
-    "claude-code": { label: "Claude Code", hint: "claude CLI found" },
-    "claude-desktop": { label: "Claude Desktop", hint: "config file found" },
-    vscode: { label: "VS Code", hint: "code CLI or .vscode/ found" },
-    gemini: { label: "Gemini CLI", hint: "gemini CLI found" },
-    openclaw: { label: "OpenClaw", hint: "skills directory found" }
-  };
-  configurators = {
-    cursor: configureSafe3,
-    "claude-code": configureSafe,
-    "claude-desktop": configureSafe2,
-    vscode: configureSafe6,
-    gemini: configureSafe4,
-    openclaw: configureSafe5
-  };
-  setup_default = defineCommand2({
+  codex_default = defineCommand2({
     meta: {
-      name: "setup",
-      description: [
-        "Configure Outlit for AI agent tools.",
-        "",
-        "Without a subcommand, auto-detects installed agents and configures them all.",
-        "Subcommands: cursor, claude-code, claude-desktop, vscode, gemini, openclaw, skills"
-      ].join(`
-`)
+      name: "codex",
+      description: "Install the Outlit skill for Codex."
     },
-    args: {
-      ...authArgs,
+    args: { ...outputArgs },
+    run({ args }) {
+      runAgentSkillsInstall("codex", !!args.json);
+    }
+  });
+});
+
+// src/commands/setup/gemini.ts
+var exports_gemini = {};
+__export(exports_gemini, {
+  default: () => gemini_default
+});
+var gemini_default;
+var init_gemini = __esm(() => {
+  init_dist();
+  init_output2();
+  init_skills();
+  gemini_default = defineCommand2({
+    meta: {
+      name: "gemini",
+      description: "Install the Outlit skill for Gemini CLI."
+    },
+    args: { ...outputArgs },
+    run({ args }) {
+      runAgentSkillsInstall("gemini", !!args.json);
+    }
+  });
+});
+
+// src/commands/setup/droid.ts
+var exports_droid = {};
+__export(exports_droid, {
+  default: () => droid_default
+});
+var droid_default;
+var init_droid = __esm(() => {
+  init_dist();
+  init_output2();
+  init_skills();
+  droid_default = defineCommand2({
+    meta: {
+      name: "droid",
+      description: "Install the Outlit skill for Droid."
+    },
+    args: { ...outputArgs },
+    run({ args }) {
+      runAgentSkillsInstall("droid", !!args.json);
+    }
+  });
+});
+
+// src/commands/setup/opencode.ts
+var exports_opencode = {};
+__export(exports_opencode, {
+  default: () => opencode_default
+});
+var opencode_default;
+var init_opencode = __esm(() => {
+  init_dist();
+  init_output2();
+  init_skills();
+  opencode_default = defineCommand2({
+    meta: {
+      name: "opencode",
+      description: "Install the Outlit skill for OpenCode."
+    },
+    args: { ...outputArgs },
+    run({ args }) {
+      runAgentSkillsInstall("opencode", !!args.json);
+    }
+  });
+});
+
+// src/commands/setup/pi.ts
+var exports_pi = {};
+__export(exports_pi, {
+  default: () => pi_default
+});
+var pi_default;
+var init_pi = __esm(() => {
+  init_dist();
+  init_output2();
+  init_skills();
+  pi_default = defineCommand2({
+    meta: {
+      name: "pi",
+      description: "Install the Outlit skill for Pi."
+    },
+    args: { ...outputArgs },
+    run({ args }) {
+      runAgentSkillsInstall("pi", !!args.json);
+    }
+  });
+});
+
+// src/commands/setup/openclaw.ts
+var exports_openclaw = {};
+__export(exports_openclaw, {
+  default: () => openclaw_default
+});
+var openclaw_default;
+var init_openclaw = __esm(() => {
+  init_dist();
+  init_output2();
+  init_skills();
+  openclaw_default = defineCommand2({
+    meta: {
+      name: "openclaw",
+      description: "Install the Outlit skill for OpenClaw."
+    },
+    args: { ...outputArgs },
+    run({ args }) {
+      runAgentSkillsInstall("openclaw", !!args.json);
+    }
+  });
+});
+
+// src/commands/setup/index.ts
+import { execFileSync as execFileSync5 } from "node:child_process";
+import { existsSync as existsSync4 } from "node:fs";
+import { homedir as homedir4 } from "node:os";
+import { join as join5 } from "node:path";
+function isCommandAvailable(cmd) {
+  try {
+    const whichCmd = process.platform === "win32" ? "where" : "which";
+    execFileSync5(whichCmd, [cmd], { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function getHomeDir() {
+  return process.env.HOME?.trim() || homedir4();
+}
+function detectAgents() {
+  const home = getHomeDir();
+  const configHome = process.env.XDG_CONFIG_HOME?.trim() || join5(home, ".config");
+  const detected = [];
+  if (isCommandAvailable("claude"))
+    detected.push("claude-code");
+  if (isCommandAvailable("codex"))
+    detected.push("codex");
+  if (isCommandAvailable("gemini"))
+    detected.push("gemini");
+  if (existsSync4(join5(home, ".factory")))
+    detected.push("droid");
+  if (existsSync4(join5(configHome, "opencode")))
+    detected.push("opencode");
+  if (existsSync4(join5(home, ".pi", "agent")))
+    detected.push("pi");
+  if (existsSync4(join5(home, ".openclaw")) || existsSync4(join5(home, ".clawdbot")) || existsSync4(join5(home, ".moltbot"))) {
+    detected.push("openclaw");
+  }
+  return detected;
+}
+var agentLabels, setupSubcommandNames, setup_default;
+var init_setup = __esm(() => {
+  init_dist();
+  init_output2();
+  init_config();
+  init_output();
+  init_skills();
+  agentLabels = {
+    "claude-code": { label: "Claude Code", hint: "claude CLI found" },
+    codex: { label: "Codex", hint: "codex CLI found" },
+    gemini: { label: "Gemini CLI", hint: "gemini CLI found" },
+    droid: { label: "Droid", hint: ".factory config found" },
+    opencode: { label: "OpenCode", hint: "opencode config found" },
+    pi: { label: "Pi", hint: ".pi/agent config found" },
+    openclaw: { label: "OpenClaw", hint: "OpenClaw config found" }
+  };
+  setupSubcommandNames = new Set([
+    "claude-code",
+    "codex",
+    "gemini",
+    "droid",
+    "opencode",
+    "pi",
+    "openclaw",
+    "skills"
+  ]);
+  setup_default = defineCommand2({
+    meta: {
+      name: "setup",
+      description: [
+        "Install the Outlit skill for coding agents.",
+        "",
+        "Without a subcommand, auto-detects supported coding agents and installs `outlit` for all of them.",
+        "Subcommands: claude-code, codex, gemini, droid, opencode, pi, openclaw, skills"
+      ].join(`
+`)
+    },
+    args: {
       ...outputArgs,
       yes: {
         type: "boolean",
-        description: "Configure all detected agents without prompting."
+        description: "Install for all detected coding agents without prompting."
       }
     },
     subCommands: {
-      cursor: () => Promise.resolve().then(() => (init_cursor(), exports_cursor)).then((m) => m.default),
       "claude-code": () => Promise.resolve().then(() => (init_claude_code(), exports_claude_code)).then((m) => m.default),
-      "claude-desktop": () => Promise.resolve().then(() => (init_claude_desktop(), exports_claude_desktop)).then((m) => m.default),
-      vscode: () => Promise.resolve().then(() => (init_vscode(), exports_vscode)).then((m) => m.default),
+      codex: () => Promise.resolve().then(() => (init_codex(), exports_codex)).then((m) => m.default),
       gemini: () => Promise.resolve().then(() => (init_gemini(), exports_gemini)).then((m) => m.default),
+      droid: () => Promise.resolve().then(() => (init_droid(), exports_droid)).then((m) => m.default),
+      opencode: () => Promise.resolve().then(() => (init_opencode(), exports_opencode)).then((m) => m.default),
+      pi: () => Promise.resolve().then(() => (init_pi(), exports_pi)).then((m) => m.default),
       openclaw: () => Promise.resolve().then(() => (init_openclaw(), exports_openclaw)).then((m) => m.default),
       skills: () => Promise.resolve().then(() => (init_skills(), exports_skills)).then((m) => m.default)
     },
-    async run({ args }) {
+    async run({ args, rawArgs }) {
+      const setupRawArgs = rawArgs ?? [];
+      const subcommandName = setupRawArgs.find((arg) => !arg.startsWith("-"));
+      if (subcommandName && setupSubcommandNames.has(subcommandName)) {
+        return;
+      }
       const json = !!args.json;
-      const credential = requireCredential(args["api-key"], json);
       const detected = detectAgents();
       if (detected.length === 0) {
         if (isJsonMode(json)) {
-          return outputResult({ detected: [], configured: [], failed: [], skills: null });
+          return outputResult({ detected: [], configured: [], failed: [], runner: null });
         }
-        console.log("No supported agent tools detected.");
+        console.log("No supported coding agents detected.");
         return;
       }
       if (!isJsonMode(json) && !args.yes) {
-        console.log("Detected agents:");
+        console.log("Detected coding agents:");
         for (const agentId of detected) {
           const { label, hint } = agentLabels[agentId];
           console.log(`  ${TICK2} ${label.padEnd(14)} -- ${hint}`);
         }
         console.log(`
-Configuring...`);
-      }
-      const configured = [];
-      const failed = [];
-      for (const agentId of detected) {
-        const ok = configurators[agentId](credential.key, json);
-        if (ok) {
-          configured.push(agentId);
-        } else {
-          failed.push(agentId);
-        }
-      }
-      const skills = runSkillsInstall(json, false);
-      if (!isJsonMode(json) && !skills.success) {
-        console.log(`
-  ! Agent skills installation failed: ${skills.error ?? "unknown error"}`);
-        console.log("    Run `outlit setup skills` to retry.");
+Installing Outlit skill...`);
       }
+      const install = runSkillsInstall({
+        json,
+        exitOnError: false,
+        agents: detected.map(getSkillAgentId),
+        skillNames: ["outlit"],
+        autoConfirm: true
+      });
+      const configured = install.success ? detected : [];
+      const failed = install.success ? [] : detected;
       if (isJsonMode(json)) {
-        return outputResult({ detected, configured, failed, skills });
+        return outputResult({
+          detected,
+          configured,
+          failed,
+          runner: install.runner ?? null
+        });
       }
-      if (failed.length > 0) {
+      if (!install.success) {
         console.log(`
-  ${failed.length} agent(s) failed: ${failed.join(", ")}`);
+  ! Outlit skill install failed: ${install.error ?? "unknown error"}`);
+        console.log("    Run `outlit setup skills` to retry manually.");
+        return;
       }
       console.log(`
-Done. ${configured.length}/${detected.length} agent(s) configured successfully.`);
+Done. Installed Outlit for ${configured.length} coding agent(s).`);
     }
   });
 });
@@ -3169,21 +3431,16 @@ Done. ${configured.length}/${detected.length} agent(s) configured successfully.`
 // src/commands/doctor.ts
 var exports_doctor = {};
 __export(exports_doctor, {
-  default: () => doctor_default
+  default: () => doctor_default,
+  buildAgentChecks: () => buildAgentChecks
 });
-import { existsSync as existsSync4 } from "node:fs";
+import { existsSync as existsSync5 } from "node:fs";
 import { homedir as homedir5 } from "node:os";
-import { join as join7 } from "node:path";
+import { join as join6 } from "node:path";
 async function checkCliVersion() {
   const current = CLI_VERSION2;
   try {
-    const res = await fetch("https://registry.npmjs.org/@outlit%2Fcli/latest", {
-      signal: AbortSignal.timeout(5000)
-    });
-    if (!res.ok)
-      throw new Error("registry unavailable");
-    const data = await res.json();
-    const latest = data.version ?? "unknown";
+    const latest = await fetchLatestCliVersion2();
     if (latest === current) {
       return { name: "CLI version", status: "pass", message: `v${current} (latest)` };
     }
@@ -3191,7 +3448,7 @@ async function checkCliVersion() {
       name: "CLI version",
       status: "warn",
       message: `v${current} installed, v${latest} available`,
-      detail: "Run `npm update -g @outlit/cli` to update"
+      detail: `Run \`${formatUpdateCommand2()}\` to update`
     };
   } catch {
     return {
@@ -3237,8 +3494,83 @@ async function validateApiKey(apiKey) {
     };
   }
 }
-function detectAgents2() {
-  const detected = detectAgents();
+async function checkIntegrations(apiKey) {
+  try {
+    const client = await createClient(apiKey);
+    const timeout = new Promise((_2, reject) => setTimeout(() => reject(new Error("Integrations check timed out")), 1e4));
+    const data = await Promise.race([
+      client.callTool("outlit_list_integrations", {}),
+      timeout
+    ]);
+    const items = data.items ?? [];
+    const connected = items.filter((i) => i.status === "connected").length;
+    const errors = items.filter((i) => i.status === "error").length;
+    if (errors > 0) {
+      return {
+        name: "Integrations",
+        status: "warn",
+        message: `${connected} connected, ${errors} with errors`,
+        detail: "Run `outlit integrations status` for details"
+      };
+    }
+    if (connected === 0) {
+      return {
+        name: "Integrations",
+        status: "pass",
+        message: "No integrations connected",
+        detail: "Run `outlit integrations list` to see available integrations"
+      };
+    }
+    return {
+      name: "Integrations",
+      status: "pass",
+      message: `${connected} integration(s) connected`
+    };
+  } catch {
+    return {
+      name: "Integrations",
+      status: "warn",
+      message: "Could not check integrations",
+      detail: "Integration status endpoint may not be available yet"
+    };
+  }
+}
+function getHomeDir2(options) {
+  return options?.homeDir?.trim() || process.env.HOME?.trim() || homedir5();
+}
+function getSharedSkillsDir(options) {
+  return join6(getHomeDir2(options), ".agents", "skills");
+}
+function getOpenClawHome(options) {
+  const home = getHomeDir2(options);
+  if (existsSync5(join6(home, ".openclaw")))
+    return join6(home, ".openclaw");
+  if (existsSync5(join6(home, ".clawdbot")))
+    return join6(home, ".clawdbot");
+  if (existsSync5(join6(home, ".moltbot")))
+    return join6(home, ".moltbot");
+  return join6(home, ".openclaw");
+}
+function getAgentSkillDir(agentId, options) {
+  const home = getHomeDir2(options);
+  switch (agentId) {
+    case "claude-code":
+      return join6(options?.claudeConfigDir?.trim() || process.env.CLAUDE_CONFIG_DIR?.trim() || join6(home, ".claude"), "skills");
+    case "codex":
+      return getSharedSkillsDir(options);
+    case "gemini":
+      return getSharedSkillsDir(options);
+    case "droid":
+      return join6(home, ".factory", "skills");
+    case "opencode":
+      return getSharedSkillsDir(options);
+    case "pi":
+      return join6(home, ".pi", "agent", "skills");
+    case "openclaw":
+      return join6(getOpenClawHome(options), "skills");
+  }
+}
+function buildAgentChecks(detected = detectAgents(), options) {
   if (detected.length === 0) {
     return [
       {
@@ -3249,66 +3581,15 @@ function detectAgents2() {
     ];
   }
   const results = [];
-  const home = homedir5();
   for (const agentId of detected) {
     const meta = agentChecks[agentId];
-    if (agentId === "openclaw") {
-      const openclawBase = existsSync4(join7(home, "clawd", "skills")) ? join7(home, "clawd", "skills") : join7(home, ".openclaw", "skills");
-      const hasSkill = existsSync4(join7(openclawBase, "outlit-intelligence", "SKILL.md"));
-      results.push({
-        name: meta.name,
-        status: hasSkill ? "pass" : "warn",
-        message: hasSkill ? "Installed, Outlit skill configured" : "Installed, but Outlit skill not found",
-        detail: hasSkill ? undefined : "Run `outlit setup openclaw` to configure"
-      });
-      continue;
-    }
-    if (!meta.configCheck) {
-      results.push({
-        name: meta.name,
-        status: "warn",
-        message: "Installed, but Outlit MCP not verified",
-        detail: `Run \`outlit setup ${agentId}\` to configure`
-      });
-      if (agentId === "claude-code") {
-        const skillsDir = join7(home, ".claude", "skills");
-        const hasSkills = existsSync4(join7(skillsDir, "outlit-cli")) || existsSync4(join7(skillsDir, "outlit-sdk")) || existsSync4(join7(skillsDir, "outlit-mcp"));
-        results.push({
-          name: "Agent Skills",
-          status: hasSkills ? "pass" : "warn",
-          message: hasSkills ? "Outlit agent skills installed" : "Outlit agent skills not found",
-          detail: hasSkills ? undefined : "Run `outlit setup skills` to install deeper AI agent context"
-        });
-      }
-      continue;
-    }
-    const { path, key } = meta.configCheck;
-    if (!existsSync4(path)) {
-      results.push({
-        name: meta.name,
-        status: "warn",
-        message: "Installed, but config file not found",
-        detail: `Run \`outlit setup ${agentId}\` to configure`
-      });
-      continue;
-    }
-    try {
-      const config = readJsonConfig(path);
-      const configured = !!config[key]?.outlit;
-      results.push({
-        name: meta.name,
-        status: configured ? "pass" : "warn",
-        message: configured ? "Installed, Outlit MCP configured" : "Installed, but Outlit MCP not configured",
-        detail: configured ? undefined : `Run \`outlit setup ${agentId}\` to configure`
-      });
-    } catch {
-      results.push({
-        name: meta.name,
-        status: "warn",
-        message: "Installed, but config file is malformed",
-        detail: `Check ${path} for JSON syntax errors`
-      });
-    }
+    const hasSkill = existsSync5(join6(getAgentSkillDir(agentId, options), "outlit", "SKILL.md"));
+    results.push({
+      name: meta.name,
+      status: hasSkill ? "pass" : "warn",
+      message: hasSkill ? "Outlit skill installed" : "Installed, but Outlit skill not found",
+      detail: hasSkill ? undefined : meta.missingDetail
+    });
   }
   return results;
 }
@@ -3339,10 +3620,12 @@ var init_doctor = __esm(() => {
   init_auth();
   init_output2();
   init_api();
+  init_client();
   init_config();
   init_output();
   init_tty();
-  init_setup2();
+  init_update();
+  init_setup();
   FAIL_SYMBOL2 = isUnicodeSupported ? String.fromCodePoint(10007) : "x";
   STATUS_ICONS = {
     pass: TICK2,
@@ -3359,7 +3642,7 @@ var init_doctor = __esm(() => {
         "  1. CLI version -- compares against npm registry",
         "  2. API key -- checks presence and format (ok_ prefix)",
         "  3. API validation -- makes a live test call to verify the key works",
-        "  4. Agent detection -- detects OpenClaw, Cursor, Claude Desktop, VS Code",
+        "  4. Agent detection -- detects supported coding agents and whether the Outlit skill is installed",
         "",
         "Exit code: 0 if all checks pass or warn, 1 if any check fails.",
         "",
@@ -3383,7 +3666,11 @@ var init_doctor = __esm(() => {
       const credential = resolveApiKey(args["api-key"]);
       checks.push(checkApiKeyPresence(credential));
       if (credential) {
-        checks.push(await validateApiKey(credential.key));
+        const apiCheck = await validateApiKey(credential.key);
+        checks.push(apiCheck);
+        if (apiCheck.status !== "fail") {
+          checks.push(await checkIntegrations(credential.key));
+        }
       } else {
         checks.push({
           name: "API validation",
@@ -3391,60 +3678,149 @@ var init_doctor = __esm(() => {
           message: "Skipped -- no API key found"
         });
       }
-      checks.push(...detectAgents2());
+      checks.push(...buildAgentChecks());
       const hasFail = checks.some((c) => c.status === "fail");
       if (isJsonMode(json)) {
         outputResult({ ok: !hasFail, checks });
       } else {
         printChecks(checks);
       }
-      process.exit(hasFail ? 1 : 0);
+      if (hasFail)
+        process.exit(1);
     }
   });
   agentChecks = {
-    cursor: {
-      name: "Cursor",
-      configCheck: { path: join7(homedir5(), ".cursor", "mcp.json"), key: "mcpServers" }
+    "claude-code": {
+      name: "Claude Code",
+      missingDetail: "Run `outlit setup claude-code` to install the Outlit skill"
+    },
+    codex: {
+      name: "Codex",
+      missingDetail: "Run `outlit setup codex` to install the Outlit skill"
     },
-    "claude-code": { name: "Claude Code" },
-    "claude-desktop": {
-      name: "Claude Desktop",
-      configCheck: { path: getClaudeDesktopConfigPath(), key: "mcpServers" }
+    gemini: {
+      name: "Gemini CLI",
+      missingDetail: "Run `outlit setup gemini` to install the Outlit skill"
     },
-    vscode: {
-      name: "VS Code",
-      configCheck: { path: join7(process.cwd(), ".vscode", "mcp.json"), key: "servers" }
+    droid: {
+      name: "Droid",
+      missingDetail: "Run `outlit setup droid` to install the Outlit skill"
     },
-    gemini: { name: "Gemini CLI" },
-    openclaw: { name: "OpenClaw" }
+    opencode: {
+      name: "OpenCode",
+      missingDetail: "Run `outlit setup opencode` to install the Outlit skill"
+    },
+    pi: {
+      name: "Pi",
+      missingDetail: "Run `outlit setup pi` to install the Outlit skill"
+    },
+    openclaw: {
+      name: "OpenClaw",
+      missingDetail: "Run `outlit setup openclaw` to install the Outlit skill"
+    }
   };
 });
 
-// src/commands/facts.ts
-var exports_facts = {};
-__export(exports_facts, {
-  default: () => facts_default
+// src/commands/upgrade.ts
+var exports_upgrade = {};
+__export(exports_upgrade, {
+  default: () => upgrade_default
 });
-var facts_default;
-var init_facts = __esm(() => {
+var upgrade_default;
+var init_upgrade = __esm(() => {
+  init_dist();
+  init_config();
+  init_output();
+  init_update();
+  upgrade_default = defineCommand2({
+    meta: {
+      name: "upgrade",
+      description: [
+        "Upgrade the Outlit CLI using the same package manager it was installed with.",
+        "",
+        "Checks npm for the latest published version first.",
+        "If the current version is already latest, no install command is run.",
+        "",
+        "Examples:",
+        "  outlit upgrade"
+      ].join(`
+`)
+    },
+    async run() {
+      const upgradeCommand = getUpgradeCommand();
+      if (!upgradeCommand) {
+        return outputError({
+          message: "Could not determine how Outlit CLI was installed. Update it manually with your package manager, for example `bun add -g @outlit/cli` or `npm install -g @outlit/cli`.",
+          code: "unknown_installer"
+        }, false);
+      }
+      let latestVersion;
+      try {
+        latestVersion = await fetchLatestCliVersion2();
+      } catch {
+        return outputError({
+          message: "Could not check for CLI updates. Try again later or update manually.",
+          code: "update_check_failed"
+        }, false);
+      }
+      if (compareVersions2(CLI_VERSION2, latestVersion) >= 0) {
+        console.log(`Outlit CLI is already up to date (v${CLI_VERSION2})`);
+        return;
+      }
+      try {
+        runUpgradeCommand(upgradeCommand);
+      } catch (err) {
+        return outputError({
+          message: errorMessage(err, `Failed to run ${upgradeCommand.displayCommand}`),
+          code: "upgrade_failed"
+        }, false);
+      }
+    }
+  });
+});
+
+// src/commands/facts/list.ts
+var exports_list3 = {};
+__export(exports_list3, {
+  default: () => list_default3
+});
+function parseCsvArg(value) {
+  if (!value)
+    return;
+  const items = splitCsv(value).map((item) => item.trim()).filter(Boolean);
+  return items.length > 0 ? items : undefined;
+}
+function invalidValues(values, allowed) {
+  if (!values)
+    return [];
+  return values.filter((value) => !allowed.includes(value));
+}
+var list_default3;
+var init_list3 = __esm(() => {
   init_dist();
   init_auth();
   init_output2();
   init_pagination();
+  init_tool_contracts();
   init_api();
-  facts_default = defineCommand2({
+  init_config();
+  init_output();
+  list_default3 = defineCommand2({
     meta: {
-      name: "facts",
+      name: "list",
       description: [
-        "Retrieve facts for a customer.",
+        "List structured facts for a customer.",
         "",
-        "Returns a list of facts (signals, events, and derived insights) for the",
-        "specified customer within the given timeframe.",
+        "Filter by fact status, source type, or occurrence date range.",
         "",
         "Examples:",
-        "  outlit facts acme.com",
-        "  outlit facts acme.com --timeframe 90d",
-        "  outlit facts acme.com --limit 50 --json",
+        "  outlit facts list acme.com",
+        "  outlit facts list acme.com --status ACTIVE",
+        "  outlit facts list acme.com --source-types CALL,EMAIL --after 2025-01-01T00:00:00Z",
+        "  outlit facts list acme.com --limit 50 --json",
+        "",
+        `Statuses: ${customerFactStatuses.join(", ")}`,
+        `Source types: ${customerSourceTypes.join(", ")}`,
         "",
         AGENT_JSON_HINT
       ].join(`
@@ -3459,51 +3835,817 @@ var init_facts = __esm(() => {
         description: "Customer UUID or domain to retrieve facts for",
         required: true
       },
-      timeframe: {
+      status: {
         type: "string",
-        description: "Lookback window (e.g. 7d, 30d, 90d). Default: 30d.",
-        default: "30d"
+        description: `Comma-separated fact statuses (${customerFactStatuses.join(", ")})`
+      },
+      "source-types": {
+        type: "string",
+        description: `Comma-separated generic source type filter (${customerSourceTypes.join(", ")})`
+      },
+      after: {
+        type: "string",
+        description: "Filter to facts occurring after this ISO 8601 datetime"
+      },
+      before: {
+        type: "string",
+        description: "Filter to facts occurring before this ISO 8601 datetime"
       }
     },
     async run({ args }) {
       const json = !!args.json;
-      const client = await getClientOrExit(args["api-key"], json);
-      const params = {
-        customer: args.customer,
-        timeframe: args.timeframe
-      };
-      applyPagination(params, args, json);
-      return runTool(client, "outlit_get_facts", params, json);
-    }
-  });
-});
-
-// src/commands/search.ts
-var exports_search = {};
-__export(exports_search, {
+      const statuses = parseCsvArg(args.status);
+      const sourceTypes = parseCsvArg(args["source-types"]);
+      const invalidStatuses = invalidValues(statuses, customerFactStatuses);
+      if (invalidStatuses.length > 0) {
+        return outputError({
+          message: `Unknown fact statuses: ${invalidStatuses.join(", ")}. Allowed: ${customerFactStatuses.join(", ")}`,
+          code: "invalid_input"
+        }, json);
+      }
+      const invalidSourceTypes = invalidValues(sourceTypes, customerSourceTypes);
+      if (invalidSourceTypes.length > 0) {
+        return outputError({
+          message: `Unknown source types: ${invalidSourceTypes.join(", ")}. Allowed: ${customerSourceTypes.join(", ")}`,
+          code: "invalid_input"
+        }, json);
+      }
+      const afterDate = args.after ? new Date(args.after) : null;
+      const beforeDate = args.before ? new Date(args.before) : null;
+      if (afterDate && Number.isNaN(afterDate.getTime())) {
+        return outputError({
+          message: "--after must be a valid ISO 8601 datetime",
+          code: "invalid_input"
+        }, json);
+      }
+      if (beforeDate && Number.isNaN(beforeDate.getTime())) {
+        return outputError({
+          message: "--before must be a valid ISO 8601 datetime",
+          code: "invalid_input"
+        }, json);
+      }
+      if (afterDate && beforeDate && afterDate.getTime() > beforeDate.getTime()) {
+        return outputError({
+          message: "--after must be before or equal to --before",
+          code: "invalid_input"
+        }, json);
+      }
+      const client = await getClientOrExit(args["api-key"], json);
+      const params = {
+        customer: args.customer
+      };
+      if (statuses)
+        params.status = statuses;
+      if (sourceTypes)
+        params.sourceTypes = sourceTypes;
+      if (args.after)
+        params.after = args.after;
+      if (args.before)
+        params.before = args.before;
+      applyPagination(params, args, json);
+      return runTool(client, customerToolContracts.outlit_list_facts.toolName, params, json);
+    }
+  });
+});
+
+// src/commands/facts/get.ts
+var exports_get2 = {};
+__export(exports_get2, {
+  default: () => get_default2
+});
+function parseCsvArg2(value) {
+  if (!value)
+    return;
+  const items = splitCsv(value).map((item) => item.trim()).filter(Boolean);
+  return items.length > 0 ? items : undefined;
+}
+var get_default2;
+var init_get2 = __esm(() => {
+  init_dist();
+  init_auth();
+  init_output2();
+  init_tool_contracts();
+  init_api();
+  init_config();
+  get_default2 = defineCommand2({
+    meta: {
+      name: "get",
+      description: [
+        "Get one exact fact by ID.",
+        "",
+        "Use --include evidence to request best-effort evidence expansion.",
+        "",
+        "Examples:",
+        "  outlit facts get --fact-id fact_123",
+        "  outlit facts get --fact-id fact_123 --include evidence",
+        "",
+        AGENT_JSON_HINT
+      ].join(`
+`)
+    },
+    args: {
+      ...authArgs,
+      ...outputArgs,
+      "fact-id": {
+        type: "string",
+        description: "Fact ID to fetch",
+        required: true
+      },
+      include: {
+        type: "string",
+        description: "Comma-separated best-effort expansions (for example: evidence)"
+      }
+    },
+    async run({ args }) {
+      const json = !!args.json;
+      const client = await getClientOrExit(args["api-key"], json);
+      const params = {
+        factId: args["fact-id"]
+      };
+      const include = parseCsvArg2(args.include);
+      if (include)
+        params.include = include;
+      return runTool(client, customerToolContracts.outlit_get_fact.toolName, params, json);
+    }
+  });
+});
+
+// src/commands/facts/index.ts
+var exports_facts = {};
+__export(exports_facts, {
+  default: () => facts_default
+});
+var facts_default;
+var init_facts = __esm(() => {
+  init_dist();
+  init_output2();
+  facts_default = defineCommand2({
+    meta: {
+      name: "facts",
+      description: [
+        "Query structured customer facts.",
+        "",
+        "Subcommands:",
+        "  list  -- list facts for a customer with filters",
+        "  get   -- fetch one exact fact by id",
+        "",
+        AGENT_JSON_HINT
+      ].join(`
+`)
+    },
+    subCommands: {
+      list: () => Promise.resolve().then(() => (init_list3(), exports_list3)).then((m) => m.default),
+      get: () => Promise.resolve().then(() => (init_get2(), exports_get2)).then((m) => m.default)
+    }
+  });
+});
+
+// src/commands/sources/get.ts
+var exports_get3 = {};
+__export(exports_get3, {
+  default: () => get_default3
+});
+var get_default3;
+var init_get3 = __esm(() => {
+  init_dist();
+  init_auth();
+  init_output2();
+  init_tool_contracts();
+  init_api();
+  init_output();
+  get_default3 = defineCommand2({
+    meta: {
+      name: "get",
+      description: [
+        "Get one exact source by source type and source id.",
+        "",
+        "Examples:",
+        "  outlit sources get --source-type CALL --source-id call_123",
+        "  outlit sources get --source-type SUPPORT_TICKET --source-id ticket_456 --json",
+        "",
+        `Source types: ${customerSourceTypes.join(", ")}`,
+        "",
+        AGENT_JSON_HINT
+      ].join(`
+`)
+    },
+    args: {
+      ...authArgs,
+      ...outputArgs,
+      "source-type": {
+        type: "string",
+        description: "Canonical source type",
+        required: true
+      },
+      "source-id": {
+        type: "string",
+        description: "Exact source id",
+        required: true
+      }
+    },
+    async run({ args }) {
+      const json = !!args.json;
+      if (!customerSourceTypes.includes(args["source-type"])) {
+        return outputError({
+          message: `--source-type must be one of ${customerSourceTypes.join(", ")}`,
+          code: "invalid_input"
+        }, json);
+      }
+      const client = await getClientOrExit(args["api-key"], json);
+      return runTool(client, customerToolContracts.outlit_get_source.toolName, {
+        sourceType: args["source-type"],
+        sourceId: args["source-id"]
+      }, json);
+    }
+  });
+});
+
+// src/commands/sources/index.ts
+var exports_sources = {};
+__export(exports_sources, {
+  default: () => sources_default
+});
+var sources_default;
+var init_sources = __esm(() => {
+  init_dist();
+  init_output2();
+  sources_default = defineCommand2({
+    meta: {
+      name: "sources",
+      description: [
+        "Fetch concrete customer sources by type and id.",
+        "",
+        "Subcommands:",
+        "  get  -- fetch one exact source by sourceType and sourceId",
+        "",
+        AGENT_JSON_HINT
+      ].join(`
+`)
+    },
+    subCommands: {
+      get: () => Promise.resolve().then(() => (init_get3(), exports_get3)).then((m) => m.default)
+    }
+  });
+});
+
+// src/commands/search.ts
+var exports_search = {};
+__export(exports_search, {
   default: () => search_default
 });
 var search_default;
 var init_search = __esm(() => {
+  init_dist();
+  init_auth();
+  init_output2();
+  init_tool_contracts();
+  init_api();
+  init_config();
+  init_output();
+  search_default = defineCommand2({
+    meta: {
+      name: "search",
+      description: [
+        "Search customer context using natural language.",
+        "",
+        "Performs a semantic search over grouped source and fact results.",
+        "Optionally scope to a specific customer with --customer.",
+        "",
+        "Examples:",
+        "  outlit search 'pricing objections last quarter'",
+        "  outlit search 'churn risk signals' --customer acme.com",
+        "  outlit search 'expansion opportunities' --top-k 50 --json",
+        "  outlit search 'support escalations' --after 2025-01-01T00:00:00Z --before 2025-03-31T23:59:59Z",
+        "  outlit search 'onboarding issues' --source-types CALL,EMAIL",
+        "",
+        AGENT_JSON_HINT
+      ].join(`
+`)
+    },
+    args: {
+      ...authArgs,
+      ...outputArgs,
+      query: {
+        type: "positional",
+        description: "Natural language search query",
+        required: true
+      },
+      customer: {
+        type: "string",
+        description: "Scope search to a specific customer (UUID or domain)"
+      },
+      "top-k": {
+        type: "string",
+        description: "Maximum number of results to return (1–50). Default: 20."
+      },
+      after: {
+        type: "string",
+        description: "Filter to events occurring after this datetime (ISO 8601, e.g. 2025-01-01T00:00:00Z)"
+      },
+      before: {
+        type: "string",
+        description: "Filter to events occurring before this datetime (ISO 8601, e.g. 2025-03-31T23:59:59Z)"
+      },
+      "source-types": {
+        type: "string",
+        description: `Comma-separated generic source type filter (${customerSourceTypes.join(", ")})`
+      }
+    },
+    async run({ args }) {
+      const json = !!args.json;
+      const topK = args["top-k"] ? Number(args["top-k"]) : undefined;
+      if (topK !== undefined && (!Number.isFinite(topK) || !Number.isInteger(topK) || topK < 1 || topK > 50)) {
+        return outputError({ message: "--top-k must be an integer between 1 and 50", code: "invalid_input" }, json);
+      }
+      const sourceTypes = args["source-types"] ? splitCsv(args["source-types"]).map((item) => item.trim()).filter(Boolean) : undefined;
+      const invalidSourceTypes = sourceTypes?.filter((value) => !customerSourceTypes.includes(value));
+      if (invalidSourceTypes && invalidSourceTypes.length > 0) {
+        return outputError({
+          message: `Unknown source types: ${invalidSourceTypes.join(", ")}. Allowed: ${customerSourceTypes.join(", ")}`,
+          code: "invalid_input"
+        }, json);
+      }
+      const resolved = resolveCustomerContextSearchInput({
+        query: args.query,
+        customer: args.customer,
+        topK,
+        after: args.after,
+        before: args.before,
+        sourceTypes
+      });
+      if (!resolved.ok) {
+        return outputError({
+          message: resolved.message,
+          code: "invalid_input"
+        }, json);
+      }
+      const client = await getClientOrExit(args["api-key"], json);
+      return runTool(client, customerToolContracts.outlit_search_customer_context.toolName, resolved.request, json);
+    }
+  });
+});
+
+// src/commands/sql.ts
+var exports_sql = {};
+__export(exports_sql, {
+  default: () => sql_default
+});
+import { readFileSync as readFileSync4 } from "node:fs";
+var sql_default;
+var init_sql = __esm(() => {
+  init_dist();
+  init_auth();
+  init_output2();
+  init_tool_contracts();
+  init_api();
+  init_output();
+  sql_default = defineCommand2({
+    meta: {
+      name: "sql",
+      description: [
+        "Run a SQL query against Outlit's analytics database.",
+        "",
+        "Provide the query as a positional argument or via --query-file.",
+        "When both are provided, --query-file takes precedence.",
+        "",
+        `Available tables: ${schemaTables.join(", ")}`,
+        "",
+        "Examples:",
+        "  outlit sql 'SELECT * FROM events LIMIT 10'",
+        "  outlit sql --query-file ./my-query.sql",
+        "  outlit sql 'SELECT count(*) FROM events' --limit 1 --json",
+        "",
+        AGENT_JSON_HINT
+      ].join(`
+`)
+    },
+    args: {
+      ...authArgs,
+      ...outputArgs,
+      query: {
+        type: "positional",
+        description: "SQL query string to execute",
+        required: false
+      },
+      "query-file": {
+        type: "string",
+        description: "Path to a .sql file to read the query from (takes precedence over positional)"
+      },
+      limit: {
+        type: "string",
+        description: "Maximum number of rows to return. Default: 1000.",
+        default: "1000"
+      }
+    },
+    async run({ args }) {
+      const json = !!args.json;
+      const client = await getClientOrExit(args["api-key"], json);
+      let sql;
+      if (args["query-file"]) {
+        try {
+          sql = readFileSync4(args["query-file"], "utf-8");
+        } catch (err) {
+          return outputError({
+            message: `Cannot read file: ${errorMessage(err, "unknown error")}`,
+            code: "file_error"
+          }, json);
+        }
+      } else if (args.query) {
+        sql = args.query;
+      } else {
+        return outputError({ message: "Provide a SQL query or --query-file", code: "missing_input" }, json);
+      }
+      const limit = Number(args.limit);
+      if (!Number.isFinite(limit) || limit <= 0) {
+        return outputError({ message: "--limit must be a positive number", code: "invalid_input" }, json);
+      }
+      return runTool(client, customerToolContracts.outlit_query.toolName, { sql, limit }, json);
+    }
+  });
+});
+
+// src/commands/schema.ts
+var exports_schema = {};
+__export(exports_schema, {
+  default: () => schema_default
+});
+var schema_default;
+var init_schema = __esm(() => {
+  init_dist();
+  init_auth();
+  init_output2();
+  init_tool_contracts();
+  init_api();
+  schema_default = defineCommand2({
+    meta: {
+      name: "schema",
+      description: [
+        "Describe the analytics database schema.",
+        "",
+        "Without a table name, returns the full schema for all tables.",
+        "With a table name, returns detailed column info for that table.",
+        "",
+        `Available tables: ${schemaTables.join(", ")}`,
+        "",
+        "Examples:",
+        "  outlit schema",
+        "  outlit schema events",
+        "  outlit schema customer_dimensions --json",
+        "",
+        AGENT_JSON_HINT
+      ].join(`
+`)
+    },
+    args: {
+      ...authArgs,
+      ...outputArgs,
+      table: {
+        type: "positional",
+        description: `Table to describe (${schemaTables.join(", ")}). Optional.`,
+        required: false
+      }
+    },
+    async run({ args }) {
+      const json = !!args.json;
+      const client = await getClientOrExit(args["api-key"], json);
+      const params = {};
+      if (args.table)
+        params.table = args.table;
+      return runTool(client, customerToolContracts.outlit_schema.toolName, params, json);
+    }
+  });
+});
+
+// src/lib/providers.ts
+function resolveProvider(input) {
+  const normalized = input.toLowerCase().trim();
+  const provider = INTEGRATION_PROVIDERS[normalized];
+  if (provider)
+    return { provider, cliName: normalized };
+  const suggestion = findClosestMatch(normalized);
+  const base = `Unknown integration: "${input}". Available: ${PROVIDER_NAMES.join(", ")}`;
+  if (suggestion) {
+    return { error: `${base}
+
+  Did you mean "${suggestion}"?`, suggestion };
+  }
+  return { error: base };
+}
+function resolveProviderOrExit(input, json) {
+  const result = resolveProvider(input);
+  if ("error" in result) {
+    return outputError({ message: result.error, code: "unknown_provider" }, json);
+  }
+  return result;
+}
+function findClosestMatch(input) {
+  return PROVIDER_NAMES.find((name) => name.startsWith(input) || input.startsWith(name)) ?? null;
+}
+var INTEGRATION_PROVIDERS, PROVIDER_NAMES;
+var init_providers = __esm(() => {
+  init_output();
+  INTEGRATION_PROVIDERS = {
+    slack: { id: "slack", name: "Slack", category: "communication", authType: "oauth" },
+    gmail: { id: "google-mail", name: "Gmail", category: "communication", authType: "oauth" },
+    "google-calendar": {
+      id: "google-calendar",
+      name: "Google Calendar",
+      category: "calendar",
+      authType: "oauth"
+    },
+    pylon: {
+      id: "pylon",
+      name: "Pylon",
+      category: "support",
+      authType: "api_key",
+      configFields: [{ key: "apiKey", label: "API Key", secret: true }]
+    },
+    stripe: {
+      id: "brex-api-key",
+      name: "Stripe",
+      category: "billing",
+      authType: "api_key",
+      configFields: [{ key: "apiKey", label: "API Key", secret: true }]
+    },
+    fireflies: {
+      id: "fireflies",
+      name: "Fireflies",
+      category: "calls",
+      authType: "api_key",
+      configFields: [{ key: "apiKey", label: "API Key", secret: true }]
+    },
+    posthog: {
+      id: "posthog",
+      name: "PostHog",
+      category: "analytics",
+      authType: "api_key",
+      configFields: [
+        { key: "apiKey", label: "API Key", secret: true },
+        { key: "region", label: "Region (us or eu)" },
+        { key: "projectId", label: "Project ID" }
+      ]
+    },
+    supabase: {
+      id: "supabase",
+      name: "Supabase",
+      category: "data",
+      authType: "api_key",
+      configFields: [
+        { key: "projectUrl", label: "Project URL" },
+        { key: "serviceRoleKey", label: "Service Role Key", secret: true }
+      ]
+    },
+    clerk: {
+      id: "clerk",
+      name: "Clerk",
+      category: "auth",
+      authType: "api_key",
+      configFields: [{ key: "secretKey", label: "Secret Key", secret: true }]
+    }
+  };
+  PROVIDER_NAMES = Object.keys(INTEGRATION_PROVIDERS).sort();
+});
+
+// src/commands/integrations/list.ts
+var exports_list4 = {};
+__export(exports_list4, {
+  default: () => list_default4
+});
+var list_default4;
+var init_list4 = __esm(() => {
+  init_dist();
+  init_auth();
+  init_output2();
+  init_api();
+  list_default4 = defineCommand2({
+    meta: {
+      name: "list",
+      description: [
+        "List available integrations and their connection status.",
+        "",
+        "Shows all supported third-party integrations with whether they",
+        "are connected, available, or in an error state.",
+        "",
+        "Examples:",
+        "  outlit integrations list",
+        "  outlit integrations list --json",
+        "",
+        AGENT_JSON_HINT
+      ].join(`
+`)
+    },
+    args: {
+      ...authArgs,
+      ...outputArgs
+    },
+    async run({ args }) {
+      const json = !!args.json;
+      const client = await getClientOrExit(args["api-key"], json);
+      return runTool(client, "outlit_list_integrations", {}, json, {
+        spinnerMessage: "Fetching integrations...",
+        table: {
+          columns: [
+            { header: "Name", key: "name", format: (v) => truncate(v, 24) },
+            { header: "Category", key: "category", format: capitalize },
+            { header: "Status", key: "status" },
+            { header: "Last Synced", key: "lastDataReceivedAt", format: relativeDate }
+          ]
+        }
+      });
+    }
+  });
+});
+
+// src/lib/poll.ts
+async function pollUntil(fn, predicate, opts = {}) {
+  const intervalMs = opts.intervalMs ?? 2000;
+  const timeoutMs = opts.timeoutMs ?? 300000;
+  const start = Date.now();
+  while (Date.now() - start < timeoutMs) {
+    try {
+      const result = await fn();
+      if (predicate(result))
+        return result;
+    } catch {}
+    if (opts.spinner && opts.spinnerMessage) {
+      const elapsed = Math.floor((Date.now() - start) / 1000);
+      opts.spinner.update(`${opts.spinnerMessage} (${elapsed}s)`);
+    }
+    await sleep(intervalMs);
+  }
+  return null;
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// src/commands/integrations/add.ts
+var exports_add = {};
+__export(exports_add, {
+  default: () => add_default
+});
+async function addApiKeyProvider(client, provider, cliName, json, rawConfig) {
+  const fields = provider.configFields ?? [];
+  let config;
+  if (rawConfig) {
+    try {
+      const parsed = JSON.parse(rawConfig);
+      if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        return outputError({ message: "Invalid JSON in --config. Expected a JSON object.", code: "invalid_config" }, json);
+      }
+      config = parsed;
+    } catch {
+      return outputError({ message: "Invalid JSON in --config. Expected a JSON object.", code: "invalid_config" }, json);
+    }
+    const missing = fields.filter((f) => !config[f.key]);
+    if (missing.length > 0) {
+      return outputError({
+        message: `Missing required fields: ${missing.map((f) => f.key).join(", ")}`,
+        code: "invalid_config"
+      }, json);
+    }
+  } else if (isInteractive() && !isJsonMode(json)) {
+    console.log(`
+  Configure ${provider.name}:
+`);
+    config = {};
+    for (const field of fields) {
+      config[field.key] = await promptInput(`  ${field.label}`, { secret: field.secret });
+    }
+    console.log();
+  } else {
+    return outputResult({
+      status: "config_required",
+      provider: cliName,
+      message: `${provider.name} requires API key configuration. Pass --config with the required fields.`,
+      requiredFields: fields.map((f) => ({ key: f.key, label: f.label }))
+    });
+  }
+  const spinner = createSpinner(`Connecting ${provider.name}...`);
+  try {
+    await client.callTool("outlit_connect_integration", {
+      provider: provider.id,
+      config
+    });
+    spinner.stop(`${provider.name} connected successfully!`);
+    if (isJsonMode(json)) {
+      return outputResult({
+        status: "connected",
+        provider: cliName
+      });
+    }
+    console.log(`    Use \`outlit integrations status ${cliName}\` to check sync progress.`);
+  } catch (err) {
+    spinner.fail(`Failed to connect ${provider.name}`);
+    return outputError({ message: errorMessage(err, "Failed to connect integration"), code: "api_error" }, json);
+  }
+}
+async function addOAuthProvider(client, provider, cliName, json, force) {
+  const spinner = createSpinner(`Connecting ${provider.name}...`);
+  let connectData;
+  try {
+    connectData = await client.callTool("outlit_connect_integration", {
+      provider: provider.id
+    });
+  } catch (err) {
+    spinner.fail(`Failed to initiate ${provider.name} connection`);
+    return outputError({ message: errorMessage(err, "Failed to start connection flow"), code: "api_error" }, json);
+  }
+  if (connectData.alreadyConnected && !force) {
+    spinner.stop(`${provider.name} is already connected`);
+    if (isJsonMode(json)) {
+      return outputResult({
+        status: "already_connected",
+        provider: cliName,
+        message: `${provider.name} is already connected. Use --force to reconnect.`
+      });
+    }
+    console.log(`
+  ${provider.name} is already connected.`);
+    console.log(`  To reconnect, run: outlit integrations add ${cliName} --force`);
+    return;
+  }
+  const integrationsUrl = `${client.baseUrl}/integrations`;
+  spinner.update(`Opening browser for ${provider.name} authentication...`);
+  const opened = openBrowser(integrationsUrl);
+  if (!opened) {
+    spinner.stop("Could not open browser automatically");
+    if (isJsonMode(json)) {
+      return outputResult({
+        status: "browser_failed",
+        provider: cliName,
+        url: integrationsUrl,
+        sessionId: connectData.sessionId
+      });
+    }
+    console.log(`
+  Open this URL in your browser to connect ${provider.name}:`);
+    console.log(`  ${integrationsUrl}
+`);
+  } else {
+    spinner.stop(`Browser opened for ${provider.name} authentication`);
+  }
+  if (isJsonMode(json)) {
+    return outputResult({
+      status: "awaiting_auth",
+      provider: cliName,
+      sessionId: connectData.sessionId
+    });
+  }
+  await waitForConnection(client, connectData.sessionId, provider, cliName);
+}
+async function waitForConnection(client, sessionId, provider, cliName) {
+  const spinner = createSpinner(`Waiting for ${provider.name} authentication...`);
+  const result = await pollUntil(() => client.callTool("outlit_connect_status", { sessionId }).then((r) => r), (r) => r.status !== "pending", {
+    intervalMs: 2000,
+    timeoutMs: 300000,
+    spinner,
+    spinnerMessage: `Waiting for ${provider.name} authentication...`
+  });
+  if (!result || result.status === "expired") {
+    spinner.fail("Connection timed out");
+    console.log(`
+  The authentication session expired.`);
+    console.log(`  Run \`outlit integrations add ${cliName}\` to try again.`);
+    process.exit(1);
+  }
+  if (result.status === "failed") {
+    spinner.fail(`${provider.name} connection failed`);
+    if (result.error)
+      console.log(`
+  ${result.error}`);
+    process.exit(1);
+  }
+  spinner.stop(`${provider.name} connected successfully!`);
+  console.log(`    Sync will begin automatically.`);
+  console.log(`    Use \`outlit integrations status ${cliName}\` to check progress.`);
+}
+var add_default;
+var init_add = __esm(() => {
   init_dist();
   init_auth();
   init_output2();
   init_api();
   init_output();
-  search_default = defineCommand2({
+  init_providers();
+  init_spinner();
+  init_tty();
+  add_default = defineCommand2({
     meta: {
-      name: "search",
+      name: "add",
       description: [
-        "Search customer context using natural language.",
+        "Connect a new integration.",
         "",
-        "Performs a semantic search over customer events and signals.",
-        "Optionally scope to a specific customer with --customer.",
+        "For OAuth providers (Slack, Gmail, etc.), opens the browser for authentication.",
+        "For API-key providers (Stripe, PostHog, etc.), accepts credentials via --config or interactive prompts.",
         "",
         "Examples:",
-        "  outlit search 'pricing objections last quarter'",
-        "  outlit search 'churn risk signals' --customer acme.com",
-        "  outlit search 'expansion opportunities' --top-k 50 --json",
-        "  outlit search 'support escalations' --after 2025-01-01 --before 2025-03-31",
+        "  outlit integrations add slack",
+        `  outlit integrations add stripe --config '{"apiKey": "rk_xxx"}'`,
+        "  outlit integrations add posthog --json          # outputs required fields as JSON",
+        "  outlit integrations add slack --force            # reconnect if already connected",
+        "",
+        `Providers: ${PROVIDER_NAMES.join(", ")}`,
         "",
         AGENT_JSON_HINT
       ].join(`
@@ -3512,79 +4654,61 @@ var init_search = __esm(() => {
     args: {
       ...authArgs,
       ...outputArgs,
-      query: {
+      provider: {
         type: "positional",
-        description: "Natural language search query",
+        description: "Integration provider to connect",
         required: true
       },
-      customer: {
-        type: "string",
-        description: "Scope search to a specific customer (UUID or domain)"
-      },
-      "top-k": {
-        type: "string",
-        description: "Maximum number of results to return. Default: 20.",
-        default: "20"
-      },
-      after: {
-        type: "string",
-        description: "Filter to events occurring after this date (ISO 8601, e.g. 2025-01-01)"
+      force: {
+        type: "boolean",
+        description: "Reconnect even if the integration is already connected."
       },
-      before: {
+      config: {
         type: "string",
-        description: "Filter to events occurring before this date (ISO 8601, e.g. 2025-03-31)"
+        description: `JSON configuration for API-key integrations (e.g. '{"apiKey": "sk_xxx"}')`
       }
     },
     async run({ args }) {
       const json = !!args.json;
       const client = await getClientOrExit(args["api-key"], json);
-      const topK = Number(args["top-k"]);
-      if (!Number.isFinite(topK) || topK <= 0) {
-        return outputError({ message: "--top-k must be a positive number", code: "invalid_input" }, json);
+      const { provider, cliName } = resolveProviderOrExit(args.provider, json);
+      if (provider.authType === "api_key") {
+        await addApiKeyProvider(client, provider, cliName, json, args.config);
+      } else {
+        await addOAuthProvider(client, provider, cliName, json, !!args.force);
       }
-      const params = {
-        query: args.query,
-        topK
-      };
-      if (args.customer)
-        params.customer = args.customer;
-      if (args.after)
-        params.occurredAfter = args.after;
-      if (args.before)
-        params.occurredBefore = args.before;
-      return runTool(client, "outlit_search_customer_context", params, json);
     }
   });
 });
 
-// src/commands/sql.ts
-var exports_sql = {};
-__export(exports_sql, {
-  default: () => sql_default
+// src/commands/integrations/remove.ts
+var exports_remove = {};
+__export(exports_remove, {
+  default: () => remove_default
 });
-import { readFileSync as readFileSync2 } from "node:fs";
-var sql_default;
-var init_sql = __esm(() => {
+var remove_default;
+var init_remove = __esm(() => {
+  init_dist3();
   init_dist();
   init_auth();
   init_output2();
   init_api();
   init_output();
-  sql_default = defineCommand2({
+  init_providers();
+  init_spinner();
+  init_tty();
+  remove_default = defineCommand2({
     meta: {
-      name: "sql",
+      name: "remove",
       description: [
-        "Run a SQL query against Outlit's analytics database.",
-        "",
-        "Provide the query as a positional argument or via --query-file.",
-        "When both are provided, --query-file takes precedence.",
+        "Disconnect an integration and remove all synced data.",
         "",
-        "Available tables: events, customer_dimensions, user_dimensions, mrr_snapshots",
+        "This permanently deletes all data that was synced from the integration",
+        "(e.g., opportunities, contacts, messages). The action cannot be undone.",
         "",
         "Examples:",
-        "  outlit sql 'SELECT * FROM events LIMIT 10'",
-        "  outlit sql --query-file ./my-query.sql",
-        "  outlit sql 'SELECT count(*) FROM events' --limit 1 --json",
+        "  outlit integrations remove posthog",
+        "  outlit integrations remove slack --yes     # skip confirmation prompt",
         "",
         AGENT_JSON_HINT
       ].join(`
@@ -3593,74 +4717,84 @@ var init_sql = __esm(() => {
     args: {
       ...authArgs,
       ...outputArgs,
-      query: {
+      provider: {
         type: "positional",
-        description: "SQL query string to execute",
-        required: false
-      },
-      "query-file": {
-        type: "string",
-        description: "Path to a .sql file to read the query from (takes precedence over positional)"
+        description: "Integration provider to disconnect",
+        required: true
       },
-      limit: {
-        type: "string",
-        description: "Maximum number of rows to return. Default: 1000.",
-        default: "1000"
+      yes: {
+        type: "boolean",
+        description: "Skip confirmation prompt (required in non-interactive mode)."
       }
     },
     async run({ args }) {
       const json = !!args.json;
+      const { provider, cliName } = resolveProviderOrExit(args.provider, json);
       const client = await getClientOrExit(args["api-key"], json);
-      let sql;
-      if (args["query-file"]) {
-        try {
-          sql = readFileSync2(args["query-file"], "utf-8");
-        } catch (err) {
+      if (!args.yes) {
+        if (!isInteractive() || json) {
           return outputError({
-            message: `Cannot read file: ${errorMessage(err, "unknown error")}`,
-            code: "file_error"
+            message: `Disconnecting ${provider.name} requires confirmation. Use --yes to confirm in non-interactive or JSON mode.`,
+            code: "confirmation_required"
           }, json);
         }
-      } else if (args.query) {
-        sql = args.query;
-      } else {
-        return outputError({ message: "Provide a SQL query or --query-file", code: "missing_input" }, json);
+        R2.warn(`This will disconnect ${provider.name} and delete all synced data.
+This action cannot be undone.`);
+        const confirmed = await Re({ message: `Disconnect ${provider.name}?` });
+        if (Ct(confirmed) || !confirmed) {
+          Ne("Cancelled.");
+          return;
+        }
       }
-      const limit = Number(args.limit);
-      if (!Number.isFinite(limit) || limit <= 0) {
-        return outputError({ message: "--limit must be a positive number", code: "invalid_input" }, json);
+      const spinner = createSpinner(`Disconnecting ${provider.name}...`);
+      try {
+        const result = await client.callTool("outlit_disconnect_integration", {
+          provider: provider.id
+        });
+        if (result.success) {
+          spinner.stop(`${provider.name} disconnected. All synced data has been removed.`);
+          if (isJsonMode(json)) {
+            return outputResult({ success: true, provider: cliName });
+          }
+        } else {
+          spinner.fail(`Failed to disconnect ${provider.name}`);
+          return outputError({
+            message: result.message ?? `Failed to disconnect ${provider.name}`,
+            code: "disconnect_failed"
+          }, json);
+        }
+      } catch (err) {
+        spinner.fail(`Failed to disconnect ${provider.name}`);
+        return outputError({ message: errorMessage(err, "Disconnect request failed"), code: "api_error" }, json);
       }
-      return runTool(client, "outlit_query", { sql, limit }, json);
     }
   });
 });
 
-// src/commands/schema.ts
-var exports_schema = {};
-__export(exports_schema, {
-  default: () => schema_default
+// src/commands/integrations/status.ts
+var exports_status2 = {};
+__export(exports_status2, {
+  default: () => status_default2
 });
-var schema_default;
-var init_schema = __esm(() => {
+var status_default2;
+var init_status2 = __esm(() => {
   init_dist();
   init_auth();
   init_output2();
   init_api();
-  schema_default = defineCommand2({
+  init_providers();
+  status_default2 = defineCommand2({
     meta: {
-      name: "schema",
+      name: "status",
       description: [
-        "Describe the analytics database schema.",
-        "",
-        "Without a table name, returns the full schema for all tables.",
-        "With a table name, returns detailed column info for that table.",
+        "Show sync status for connected integrations.",
         "",
-        "Available tables: events, customer_dimensions, user_dimensions, mrr_snapshots",
+        "Without a provider name, shows a summary of all connected integrations.",
+        "With a provider name, shows detailed per-model sync status.",
         "",
         "Examples:",
-        "  outlit schema",
-        "  outlit schema events",
-        "  outlit schema customer_dimensions --json",
+        "  outlit integrations status              # summary of all",
+        "  outlit integrations status stripe    # detailed Stripe sync status",
         "",
         AGENT_JSON_HINT
       ].join(`
@@ -3669,19 +4803,78 @@ var init_schema = __esm(() => {
     args: {
       ...authArgs,
       ...outputArgs,
-      table: {
+      provider: {
         type: "positional",
-        description: "Table to describe (events, customer_dimensions, user_dimensions, mrr_snapshots). Optional.",
+        description: "Provider name to show detailed status for (optional)",
         required: false
       }
     },
     async run({ args }) {
       const json = !!args.json;
       const client = await getClientOrExit(args["api-key"], json);
-      const params = {};
-      if (args.table)
-        params.table = args.table;
-      return runTool(client, "outlit_schema", params, json);
+      if (args.provider) {
+        const { provider } = resolveProviderOrExit(args.provider, json);
+        return runTool(client, "outlit_integration_sync_status", { provider: provider.id }, json, {
+          spinnerMessage: "Fetching sync status...",
+          table: {
+            columns: [
+              { header: "Model", key: "model" },
+              { header: "Status", key: "status" },
+              { header: "Records", key: "recordCount", format: formatNumber },
+              { header: "Last Synced", key: "lastSyncedAt", format: relativeDate }
+            ],
+            itemsKey: "syncs"
+          }
+        });
+      }
+      return runTool(client, "outlit_list_integrations", { connectedOnly: true }, json, {
+        spinnerMessage: "Fetching integration status...",
+        table: {
+          columns: [
+            { header: "Name", key: "name", format: (v) => truncate(v, 24) },
+            { header: "Category", key: "category", format: capitalize },
+            { header: "Sync Status", key: "syncStatus" },
+            { header: "Last Synced", key: "lastDataReceivedAt", format: relativeDate }
+          ]
+        }
+      });
+    }
+  });
+});
+
+// src/commands/integrations/index.ts
+var exports_integrations = {};
+__export(exports_integrations, {
+  default: () => integrations_default
+});
+var integrations_default;
+var init_integrations = __esm(() => {
+  init_dist();
+  init_providers();
+  integrations_default = defineCommand2({
+    meta: {
+      name: "integrations",
+      description: [
+        "Manage platform integrations (communication, analytics, billing, etc.).",
+        "",
+        "Connect third-party services like Slack, Stripe, and PostHog",
+        "to sync data into your Outlit workspace.",
+        "",
+        "Commands:",
+        "  list                List available integrations and connection status",
+        "  add <provider>      Connect a new integration (opens browser for OAuth)",
+        "  remove <provider>   Disconnect an integration and remove synced data",
+        "  status [provider]   Show sync status for connected integrations",
+        "",
+        `Providers: ${PROVIDER_NAMES.join(", ")}`
+      ].join(`
+`)
+    },
+    subCommands: {
+      list: () => Promise.resolve().then(() => (init_list4(), exports_list4)).then((m) => m.default),
+      add: () => Promise.resolve().then(() => (init_add(), exports_add)).then((m) => m.default),
+      remove: () => Promise.resolve().then(() => (init_remove(), exports_remove)).then((m) => m.default),
+      status: () => Promise.resolve().then(() => (init_status2(), exports_status2)).then((m) => m.default)
     }
   });
 });
@@ -3756,7 +4949,10 @@ function zshDescribe(items) {
 function generateZsh() {
   const topLevel = zshDescribe(COMMANDS);
   const subCases = cmdsWithSubs.map((c) => {
-    const items = [...c.subs.map((s) => ({ name: s.name, desc: s.desc })), ...(c.flags ?? []).map((f) => ({ name: f.name, desc: f.desc }))];
+    const items = [
+      ...c.subs.map((s) => ({ name: s.name, desc: s.desc })),
+      ...(c.flags ?? []).map((f) => ({ name: f.name, desc: f.desc }))
+    ];
     return `    ${c.name})
       completions=(${zshDescribe(items)})
       _describe 'subcommand' completions
@@ -3887,7 +5083,6 @@ function generateFish() {
 var JSON_F, API_KEY_F, LIMIT_F, CURSOR_F, COMMON, PAGINATED, ACTIVITY_ORDER, COMMANDS, cmdsWithSubs, leafCmds, SCRIPTS, completions_default;
 var init_completions = __esm(() => {
   init_dist();
-  init_output2();
   init_output();
   JSON_F = { name: "--json", desc: "Force JSON output" };
   API_KEY_F = { name: "--api-key", desc: "Outlit API key" };
@@ -3907,7 +5102,11 @@ var init_completions = __esm(() => {
       desc: "Manage authentication",
       subs: [
         { name: "signup", desc: "Create an Outlit account", flags: [JSON_F] },
-        { name: "login", desc: "Store API key", flags: [JSON_F, { name: "--key", desc: "API key to store" }] },
+        {
+          name: "login",
+          desc: "Store API key",
+          flags: [JSON_F, { name: "--key", desc: "API key to store" }]
+        },
         { name: "logout", desc: "Remove stored key", flags: [JSON_F] },
         { name: "status", desc: "Check auth state", flags: [...COMMON] },
         { name: "whoami", desc: "Print masked key", flags: [...COMMON] }
@@ -3923,12 +5122,11 @@ var init_completions = __esm(() => {
           flags: [
             ...PAGINATED,
             ...ACTIVITY_ORDER,
+            { name: "--trait", desc: "Filter by trait key=value pairs" },
             { name: "--billing-status", desc: "Filter by billing status" },
             { name: "--mrr-above", desc: "MRR above threshold (cents)" },
             { name: "--mrr-below", desc: "MRR below threshold (cents)" },
-            { name: "--search", desc: "Search name or domain" },
-            { name: "--status", desc: "Customer status filter" },
-            { name: "--type", desc: "Customer type filter" }
+            { name: "--search", desc: "Search name or domain" }
           ]
         },
         {
@@ -3964,6 +5162,7 @@ var init_completions = __esm(() => {
           flags: [
             ...PAGINATED,
             ...ACTIVITY_ORDER,
+            { name: "--trait", desc: "Filter by trait key=value pairs" },
             { name: "--journey-stage", desc: "Filter by journey stage" },
             { name: "--customer-id", desc: "Filter by customer UUID" },
             { name: "--search", desc: "Search name or email" }
@@ -3974,7 +5173,43 @@ var init_completions = __esm(() => {
     {
       name: "facts",
       desc: "Get customer facts",
-      flags: [...PAGINATED, { name: "--timeframe", desc: "Lookback window (7d, 30d, 90d)" }]
+      subs: [
+        {
+          name: "list",
+          desc: "List customer facts",
+          flags: [
+            ...PAGINATED,
+            { name: "--status", desc: "Filter by fact status" },
+            { name: "--source-types", desc: "Filter by source types" },
+            { name: "--after", desc: "Facts after date (ISO 8601)" },
+            { name: "--before", desc: "Facts before date (ISO 8601)" }
+          ]
+        },
+        {
+          name: "get",
+          desc: "Get a single fact by ID",
+          flags: [
+            ...COMMON,
+            { name: "--fact-id", desc: "Fact ID to fetch" },
+            { name: "--include", desc: "Best-effort expansions" }
+          ]
+        }
+      ]
+    },
+    {
+      name: "sources",
+      desc: "Get a concrete source by type and id",
+      subs: [
+        {
+          name: "get",
+          desc: "Get one exact source record",
+          flags: [
+            ...COMMON,
+            { name: "--source-type", desc: "Canonical source type" },
+            { name: "--source-id", desc: "Exact source ID" }
+          ]
+        }
+      ]
     },
     {
       name: "search",
@@ -3984,7 +5219,8 @@ var init_completions = __esm(() => {
         { name: "--customer", desc: "Scope to customer (UUID or domain)" },
         { name: "--top-k", desc: "Max results" },
         { name: "--after", desc: "Events after date (ISO 8601)" },
-        { name: "--before", desc: "Events before date (ISO 8601)" }
+        { name: "--before", desc: "Events before date (ISO 8601)" },
+        { name: "--source-types", desc: "Broad source type filter" }
       ]
     },
     {
@@ -3997,21 +5233,46 @@ var init_completions = __esm(() => {
       ]
     },
     { name: "schema", desc: "Discover table schemas", flags: [...COMMON] },
+    {
+      name: "integrations",
+      desc: "Manage platform integrations",
+      subs: [
+        { name: "list", desc: "List integrations and status", flags: [...COMMON] },
+        {
+          name: "add",
+          desc: "Connect an integration",
+          flags: [
+            ...COMMON,
+            { name: "--config", desc: "JSON config for API-key providers" },
+            { name: "--force", desc: "Reconnect if already connected" }
+          ]
+        },
+        {
+          name: "remove",
+          desc: "Disconnect an integration",
+          flags: [...COMMON, { name: "--yes", desc: "Skip confirmation" }]
+        },
+        { name: "status", desc: "Show sync status", flags: [...COMMON] }
+      ]
+    },
     {
       name: "setup",
-      desc: "Configure AI agent tools",
-      flags: [...COMMON, { name: "--yes", desc: "Skip prompts" }],
+      desc: "Install Outlit skills for coding agents",
+      flags: [JSON_F, { name: "--yes", desc: "Skip prompts" }],
       subs: [
-        { name: "cursor", desc: "Configure Cursor", flags: [...COMMON] },
-        { name: "claude-code", desc: "Configure Claude Code", flags: [...COMMON] },
-        { name: "claude-desktop", desc: "Configure Claude Desktop", flags: [...COMMON] },
-        { name: "vscode", desc: "Configure VS Code", flags: [...COMMON] },
-        { name: "gemini", desc: "Configure Gemini CLI", flags: [...COMMON] },
-        { name: "openclaw", desc: "Configure OpenClaw", flags: [...COMMON] }
+        { name: "claude-code", desc: "Install the Outlit skill for Claude Code", flags: [JSON_F] },
+        { name: "codex", desc: "Install the Outlit skill for Codex", flags: [JSON_F] },
+        { name: "gemini", desc: "Install the Outlit skill for Gemini CLI", flags: [JSON_F] },
+        { name: "droid", desc: "Install the Outlit skill for Droid", flags: [JSON_F] },
+        { name: "opencode", desc: "Install the Outlit skill for OpenCode", flags: [JSON_F] },
+        { name: "pi", desc: "Install the Outlit skill for Pi", flags: [JSON_F] },
+        { name: "openclaw", desc: "Install the Outlit skill for OpenClaw", flags: [JSON_F] },
+        { name: "skills", desc: "Launch the interactive Outlit skills installer", flags: [JSON_F] }
       ]
     },
+    { name: "upgrade", desc: "Upgrade the CLI", flags: [] },
     { name: "doctor", desc: "Diagnose environment", flags: [...COMMON] },
-    { name: "completions", desc: "Generate shell completions", flags: [JSON_F] }
+    { name: "completions", desc: "Generate shell completions", flags: [] }
   ];
   cmdsWithSubs = COMMANDS.filter((c) => c.subs?.length);
   leafCmds = COMMANDS.filter((c) => !c.subs?.length && c.flags?.length);
@@ -4038,7 +5299,6 @@ var init_completions = __esm(() => {
 `)
     },
     args: {
-      ...outputArgs,
       shell: {
         type: "positional",
         description: "Shell to generate completions for (bash, zsh, fish)",
@@ -4046,14 +5306,13 @@ var init_completions = __esm(() => {
       }
     },
     run({ args }) {
-      const json = !!args.json;
       const shell = args.shell;
       const generate = SCRIPTS[shell];
       if (!generate) {
         return outputError({
           message: `Unknown shell: ${shell}. Supported: bash, zsh, fish`,
           code: "unknown_shell"
-        }, json);
+        }, false);
       }
       process.stdout.write(generate());
     }
@@ -4064,13 +5323,13 @@ var init_completions = __esm(() => {
 var exports_setup = {};
 __export(exports_setup, {
   isCommandAvailable: () => isCommandAvailable2,
-  detectAgents: () => detectAgents3,
+  detectAgents: () => detectAgents2,
   default: () => setup_default2
 });
 import { execFileSync as execFileSync6 } from "node:child_process";
-import { existsSync as existsSync5 } from "node:fs";
+import { existsSync as existsSync6 } from "node:fs";
 import { homedir as homedir6 } from "node:os";
-import { join as join8 } from "node:path";
+import { join as join7 } from "node:path";
 function isCommandAvailable2(cmd) {
   try {
     const whichCmd = process.platform === "win32" ? "where" : "which";
@@ -4080,126 +5339,133 @@ function isCommandAvailable2(cmd) {
     return false;
   }
 }
-function detectAgents3() {
-  const home = homedir6();
+function getHomeDir3() {
+  return process.env.HOME?.trim() || homedir6();
+}
+function detectAgents2() {
+  const home = getHomeDir3();
+  const configHome = process.env.XDG_CONFIG_HOME?.trim() || join7(home, ".config");
   const detected = [];
-  if (existsSync5(join8(home, ".cursor")))
-    detected.push("cursor");
   if (isCommandAvailable2("claude"))
     detected.push("claude-code");
-  if (existsSync5(getClaudeDesktopConfigPath()))
-    detected.push("claude-desktop");
-  if (isCommandAvailable2("code") || existsSync5(join8(process.cwd(), ".vscode")))
-    detected.push("vscode");
+  if (isCommandAvailable2("codex"))
+    detected.push("codex");
   if (isCommandAvailable2("gemini"))
     detected.push("gemini");
-  if (existsSync5(join8(home, "clawd", "skills")) || existsSync5(join8(home, ".openclaw", "skills")))
+  if (existsSync6(join7(home, ".factory")))
+    detected.push("droid");
+  if (existsSync6(join7(configHome, "opencode")))
+    detected.push("opencode");
+  if (existsSync6(join7(home, ".pi", "agent")))
+    detected.push("pi");
+  if (existsSync6(join7(home, ".openclaw")) || existsSync6(join7(home, ".clawdbot")) || existsSync6(join7(home, ".moltbot"))) {
     detected.push("openclaw");
+  }
   return detected;
 }
-var agentLabels2, configurators2, setup_default2;
-var init_setup3 = __esm(() => {
+var agentLabels2, setupSubcommandNames2, setup_default2;
+var init_setup2 = __esm(() => {
   init_dist();
-  init_auth();
   init_output2();
   init_config();
   init_output();
-  init_claude_code();
-  init_claude_desktop();
-  init_cursor();
-  init_gemini();
-  init_openclaw();
   init_skills();
-  init_vscode();
   agentLabels2 = {
-    cursor: { label: "Cursor", hint: "~/.cursor/" },
     "claude-code": { label: "Claude Code", hint: "claude CLI found" },
-    "claude-desktop": { label: "Claude Desktop", hint: "config file found" },
-    vscode: { label: "VS Code", hint: "code CLI or .vscode/ found" },
+    codex: { label: "Codex", hint: "codex CLI found" },
     gemini: { label: "Gemini CLI", hint: "gemini CLI found" },
-    openclaw: { label: "OpenClaw", hint: "skills directory found" }
-  };
-  configurators2 = {
-    cursor: configureSafe3,
-    "claude-code": configureSafe,
-    "claude-desktop": configureSafe2,
-    vscode: configureSafe6,
-    gemini: configureSafe4,
-    openclaw: configureSafe5
+    droid: { label: "Droid", hint: ".factory config found" },
+    opencode: { label: "OpenCode", hint: "opencode config found" },
+    pi: { label: "Pi", hint: ".pi/agent config found" },
+    openclaw: { label: "OpenClaw", hint: "OpenClaw config found" }
   };
+  setupSubcommandNames2 = new Set([
+    "claude-code",
+    "codex",
+    "gemini",
+    "droid",
+    "opencode",
+    "pi",
+    "openclaw",
+    "skills"
+  ]);
   setup_default2 = defineCommand2({
     meta: {
       name: "setup",
       description: [
-        "Configure Outlit for AI agent tools.",
+        "Install the Outlit skill for coding agents.",
         "",
-        "Without a subcommand, auto-detects installed agents and configures them all.",
-        "Subcommands: cursor, claude-code, claude-desktop, vscode, gemini, openclaw, skills"
+        "Without a subcommand, auto-detects supported coding agents and installs `outlit` for all of them.",
+        "Subcommands: claude-code, codex, gemini, droid, opencode, pi, openclaw, skills"
       ].join(`
 `)
     },
     args: {
-      ...authArgs,
       ...outputArgs,
       yes: {
         type: "boolean",
-        description: "Configure all detected agents without prompting."
+        description: "Install for all detected coding agents without prompting."
       }
     },
     subCommands: {
-      cursor: () => Promise.resolve().then(() => (init_cursor(), exports_cursor)).then((m) => m.default),
       "claude-code": () => Promise.resolve().then(() => (init_claude_code(), exports_claude_code)).then((m) => m.default),
-      "claude-desktop": () => Promise.resolve().then(() => (init_claude_desktop(), exports_claude_desktop)).then((m) => m.default),
-      vscode: () => Promise.resolve().then(() => (init_vscode(), exports_vscode)).then((m) => m.default),
+      codex: () => Promise.resolve().then(() => (init_codex(), exports_codex)).then((m) => m.default),
       gemini: () => Promise.resolve().then(() => (init_gemini(), exports_gemini)).then((m) => m.default),
+      droid: () => Promise.resolve().then(() => (init_droid(), exports_droid)).then((m) => m.default),
+      opencode: () => Promise.resolve().then(() => (init_opencode(), exports_opencode)).then((m) => m.default),
+      pi: () => Promise.resolve().then(() => (init_pi(), exports_pi)).then((m) => m.default),
       openclaw: () => Promise.resolve().then(() => (init_openclaw(), exports_openclaw)).then((m) => m.default),
       skills: () => Promise.resolve().then(() => (init_skills(), exports_skills)).then((m) => m.default)
     },
-    async run({ args }) {
+    async run({ args, rawArgs }) {
+      const setupRawArgs = rawArgs ?? [];
+      const subcommandName = setupRawArgs.find((arg) => !arg.startsWith("-"));
+      if (subcommandName && setupSubcommandNames2.has(subcommandName)) {
+        return;
+      }
       const json = !!args.json;
-      const credential = requireCredential(args["api-key"], json);
-      const detected = detectAgents3();
+      const detected = detectAgents2();
       if (detected.length === 0) {
         if (isJsonMode(json)) {
-          return outputResult({ detected: [], configured: [], failed: [], skills: null });
+          return outputResult({ detected: [], configured: [], failed: [], runner: null });
         }
-        console.log("No supported agent tools detected.");
+        console.log("No supported coding agents detected.");
         return;
       }
       if (!isJsonMode(json) && !args.yes) {
-        console.log("Detected agents:");
+        console.log("Detected coding agents:");
         for (const agentId of detected) {
           const { label, hint } = agentLabels2[agentId];
           console.log(`  ${TICK2} ${label.padEnd(14)} -- ${hint}`);
         }
         console.log(`
-Configuring...`);
-      }
-      const configured = [];
-      const failed = [];
-      for (const agentId of detected) {
-        const ok = configurators2[agentId](credential.key, json);
-        if (ok) {
-          configured.push(agentId);
-        } else {
-          failed.push(agentId);
-        }
-      }
-      const skills = runSkillsInstall(json, false);
-      if (!isJsonMode(json) && !skills.success) {
-        console.log(`
-  ! Agent skills installation failed: ${skills.error ?? "unknown error"}`);
-        console.log("    Run `outlit setup skills` to retry.");
+Installing Outlit skill...`);
       }
+      const install = runSkillsInstall({
+        json,
+        exitOnError: false,
+        agents: detected.map(getSkillAgentId),
+        skillNames: ["outlit"],
+        autoConfirm: true
+      });
+      const configured = install.success ? detected : [];
+      const failed = install.success ? [] : detected;
       if (isJsonMode(json)) {
-        return outputResult({ detected, configured, failed, skills });
+        return outputResult({
+          detected,
+          configured,
+          failed,
+          runner: install.runner ?? null
+        });
       }
-      if (failed.length > 0) {
+      if (!install.success) {
         console.log(`
-  ${failed.length} agent(s) failed: ${failed.join(", ")}`);
+  ! Outlit skill install failed: ${install.error ?? "unknown error"}`);
+        console.log("    Run `outlit setup skills` to retry manually.");
+        return;
       }
       console.log(`
-Done. ${configured.length}/${detected.length} agent(s) configured successfully.`);
+Done. Installed Outlit for ${configured.length} coding agent(s).`);
     }
   });
 });
@@ -4556,11 +5822,226 @@ init_tty();
 var CLI_VERSION = package_default.version;
 var TICK = `\x1B[32m${isUnicodeSupported ? String.fromCodePoint(10003) : String.fromCodePoint(8730)}\x1B[0m`;
 
+// src/lib/update.ts
+init_config();
+init_tty();
+import { execFileSync as execFileSync2, spawn, spawnSync } from "node:child_process";
+import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync2, realpathSync, rmSync, writeFileSync as writeFileSync2 } from "node:fs";
+import { homedir as homedir2 } from "node:os";
+import { dirname as dirname2, join as join2 } from "node:path";
+var UPDATE_CHECK_INTERVAL_MS = 12 * 60 * 60 * 1000;
+var PACKAGE_NAME = "@outlit/cli";
+var LATEST_VERSION_URL = "https://registry.npmjs.org/@outlit%2Fcli/latest";
+var INTERNAL_UPDATE_FLAG = "--internal-update-check";
+function getUpdateCachePath() {
+  return join2(getConfigDir(), "update-check.json");
+}
+function readCachedUpdateState() {
+  const cachePath = getUpdateCachePath();
+  if (!existsSync2(cachePath))
+    return null;
+  try {
+    return JSON.parse(readFileSync2(cachePath, "utf8"));
+  } catch {
+    return null;
+  }
+}
+function writeCachedUpdateState(state) {
+  const cachePath = getUpdateCachePath();
+  mkdirSync2(dirname2(cachePath), { recursive: true });
+  writeFileSync2(cachePath, `${JSON.stringify(state, null, 2)}
+`);
+}
+function isUpdateCheckDue(state) {
+  if (!state?.lastCheckedAt)
+    return true;
+  return Date.now() - state.lastCheckedAt >= UPDATE_CHECK_INTERVAL_MS;
+}
+function compareVersions(a, b) {
+  const aParts = a.split("-")[0]?.split(".").map((part) => Number.parseInt(part, 10) || 0) ?? [];
+  const bParts = b.split("-")[0]?.split(".").map((part) => Number.parseInt(part, 10) || 0) ?? [];
+  const maxLength = Math.max(aParts.length, bParts.length);
+  for (let index = 0;index < maxLength; index++) {
+    const left = aParts[index] ?? 0;
+    const right = bParts[index] ?? 0;
+    if (left > right)
+      return 1;
+    if (left < right)
+      return -1;
+  }
+  return 0;
+}
+function inferInstallerFromUserAgent(agent) {
+  if (agent.startsWith("bun/"))
+    return "bun";
+  if (agent.startsWith("npm/"))
+    return "npm";
+  if (agent.startsWith("pnpm/"))
+    return "pnpm";
+  if (agent.startsWith("yarn/"))
+    return "yarn";
+  return null;
+}
+function isUnderPath(path, parent) {
+  const normalizedPath = normalizeInstallerPath(path);
+  const normalizedParent = normalizeInstallerPath(parent);
+  return normalizedPath === normalizedParent || normalizedPath.startsWith(`${normalizedParent}/`);
+}
+function normalizeInstallerPath(path) {
+  return path.replace(/^\/private\/tmp\//, "/tmp/");
+}
+function inferInstallerFromInstallation(opts) {
+  const candidatePaths = [opts.argv1, opts.realExecPath].filter((value) => !!value);
+  if (opts.npmGlobalPrefix) {
+    const npmPackageRoots = [
+      join2(opts.npmGlobalPrefix, "node_modules", PACKAGE_NAME),
+      join2(opts.npmGlobalPrefix, "lib", "node_modules", PACKAGE_NAME)
+    ];
+    if (candidatePaths.some((path) => npmPackageRoots.some((root) => isUnderPath(path, root)))) {
+      return "npm";
+    }
+  }
+  if (opts.bunGlobalBin) {
+    const bunGlobalBin = opts.bunGlobalBin;
+    if (candidatePaths.some((path) => isUnderPath(path, bunGlobalBin))) {
+      return "bun";
+    }
+  }
+  return null;
+}
+function readCommandOutput(command, args) {
+  try {
+    return execFileSync2(command, args, {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"]
+    }).trim();
+  } catch {
+    return null;
+  }
+}
+function inferInstaller() {
+  const fromAgent = inferInstallerFromUserAgent(process.env.npm_config_user_agent ?? "");
+  if (fromAgent)
+    return fromAgent;
+  const argv1 = process.argv[1];
+  const realExecPath = argv1 ? readCommandOutput("realpath", [argv1]) ?? safeRealPath(argv1) : null;
+  const npmGlobalPrefix = process.env.npm_config_prefix ?? readCommandOutput("npm", ["prefix", "-g"]);
+  const bunGlobalBin = process.env.BUN_INSTALL ? join2(process.env.BUN_INSTALL, "bin") : readCommandOutput("bun", ["pm", "bin", "-g"]) ?? join2(homedir2(), ".bun", "bin");
+  return inferInstallerFromInstallation({
+    argv1,
+    realExecPath,
+    npmGlobalPrefix,
+    bunGlobalBin
+  });
+}
+function safeRealPath(filePath) {
+  try {
+    return realpathSync(filePath);
+  } catch {
+    return null;
+  }
+}
+function formatUpdateCommand(installer = inferInstaller()) {
+  switch (installer) {
+    case "bun":
+      return "bun add -g @outlit/cli";
+    case "npm":
+      return "npm install -g @outlit/cli";
+    case "pnpm":
+      return "pnpm add -g @outlit/cli";
+    case "yarn":
+      return "yarn global add @outlit/cli";
+    default:
+      return `update ${PACKAGE_NAME} with your package manager`;
+  }
+}
+function getCachedUpdateNotice(state = readCachedUpdateState()) {
+  if (!state?.latestVersion)
+    return null;
+  if (compareVersions(CLI_VERSION2, state.latestVersion) >= 0)
+    return null;
+  return {
+    currentVersion: CLI_VERSION2,
+    latestVersion: state.latestVersion,
+    command: formatUpdateCommand(state.installer)
+  };
+}
+function shouldCheckForUpdates() {
+  if (process.env.OUTLIT_NO_UPDATE_NOTIFIER)
+    return false;
+  return isInteractive();
+}
+function shouldShowUpdateNotice(argv = process.argv) {
+  return shouldCheckForUpdates() && !argv.includes("--json") && !argv.includes(INTERNAL_UPDATE_FLAG);
+}
+function printCachedUpdateNotice(argv = process.argv, notify = console.error) {
+  if (!shouldShowUpdateNotice(argv))
+    return false;
+  const notice = getCachedUpdateNotice();
+  if (!notice)
+    return false;
+  notify(`Outlit CLI update available: ${notice.currentVersion} -> ${notice.latestVersion}
+Update with: ${notice.command}`);
+  return true;
+}
+function scheduleBackgroundUpdateCheck(argv = process.argv, spawnProcess = spawn) {
+  if (!shouldShowUpdateNotice(argv))
+    return false;
+  if (!isUpdateCheckDue(readCachedUpdateState()))
+    return false;
+  const runtimePath = argv[0];
+  const scriptPath = argv[1];
+  if (!runtimePath || !scriptPath)
+    return false;
+  const child = spawnProcess(runtimePath, [scriptPath, INTERNAL_UPDATE_FLAG], {
+    detached: true,
+    stdio: "ignore"
+  });
+  child.unref?.();
+  return true;
+}
+function initializeUpdateNotifier(opts) {
+  const argv = opts?.argv ?? process.argv;
+  printCachedUpdateNotice(argv, opts?.notify);
+  scheduleBackgroundUpdateCheck(argv, opts?.spawn);
+}
+async function fetchLatestCliVersion() {
+  const response = await fetch(LATEST_VERSION_URL, { signal: AbortSignal.timeout(5000) });
+  if (!response.ok)
+    throw new Error("registry unavailable");
+  const data = await response.json();
+  if (!data.version)
+    throw new Error("registry returned no version");
+  return data.version;
+}
+async function runInternalUpdateCheck(opts) {
+  const fetchLatestVersion = opts?.fetchLatestVersion ?? fetchLatestCliVersion;
+  const installer = opts?.installer ?? inferInstaller();
+  try {
+    const latestVersion = await fetchLatestVersion();
+    writeCachedUpdateState({
+      lastCheckedAt: Date.now(),
+      latestVersion,
+      ...installer ? { installer } : {}
+    });
+  } catch {
+    writeCachedUpdateState({
+      lastCheckedAt: Date.now(),
+      ...installer ? { installer } : {}
+    });
+  }
+}
+
 // src/cli.ts
 if (process.argv.includes("-v")) {
   console.log(CLI_VERSION);
   process.exit(0);
 }
+if (process.argv.includes(INTERNAL_UPDATE_FLAG)) {
+  await runInternalUpdateCheck();
+  process.exit(0);
+}
+initializeUpdateNotifier();
 var main = defineCommand({
   meta: {
     name: "outlit",
@@ -4572,8 +6053,10 @@ Usage examples:
   outlit customers get acme.com --include users,revenue
   outlit customers timeline acme.com --timeframe 90d
   outlit users list --journey-stage CHAMPION
-  outlit facts acme.com --timeframe 90d
-  outlit search 'pricing objections last quarter'
+  outlit facts list acme.com --source-types CALL --after 2025-01-01T00:00:00Z
+  outlit facts get --fact-id fact_123 --include evidence
+  outlit sources get --source-type CALL --source-id call_123
+  outlit search 'pricing objections last quarter' --source-types CALL,EMAIL
   outlit sql 'SELECT * FROM events LIMIT 10'
   outlit schema events
   outlit doctor --json
@@ -4585,12 +6068,15 @@ For AI agents: commands auto-output JSON when stdout is piped. No --json flag ne
     customers: () => Promise.resolve().then(() => (init_customers(), exports_customers)).then((m) => m.default),
     users: () => Promise.resolve().then(() => (init_users(), exports_users)).then((m) => m.default),
     doctor: () => Promise.resolve().then(() => (init_doctor(), exports_doctor)).then((m) => m.default),
+    upgrade: () => Promise.resolve().then(() => (init_upgrade(), exports_upgrade)).then((m) => m.default),
     facts: () => Promise.resolve().then(() => (init_facts(), exports_facts)).then((m) => m.default),
+    sources: () => Promise.resolve().then(() => (init_sources(), exports_sources)).then((m) => m.default),
     search: () => Promise.resolve().then(() => (init_search(), exports_search)).then((m) => m.default),
     sql: () => Promise.resolve().then(() => (init_sql(), exports_sql)).then((m) => m.default),
     schema: () => Promise.resolve().then(() => (init_schema(), exports_schema)).then((m) => m.default),
+    integrations: () => Promise.resolve().then(() => (init_integrations(), exports_integrations)).then((m) => m.default),
     completions: () => Promise.resolve().then(() => (init_completions(), exports_completions)).then((m) => m.default),
-    setup: () => Promise.resolve().then(() => (init_setup3(), exports_setup)).then((m) => m.default)
+    setup: () => Promise.resolve().then(() => (init_setup2(), exports_setup)).then((m) => m.default)
   }
 });
 runMain(main);