@outlit/cli 1.4.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.4.1",
+    version: "1.5.0",
     description: "CLI for Outlit customer intelligence platform",
     license: "Apache-2.0",
     repository: {
@@ -222,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;
@@ -1375,109 +1439,6 @@ Note: JSON is also auto-enabled when stdout is piped (e.g. in CI, scripts, or AI
   };
 });
 
-// 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", 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`;
-});
-
 // src/commands/auth/signup.ts
 var exports_signup = {};
 __export(exports_signup, {
@@ -1594,7 +1555,9 @@ 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" },
@@ -1736,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 {
@@ -1789,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();
@@ -1922,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();
@@ -1949,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);
@@ -2219,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))
@@ -2282,6 +2406,7 @@ var init_list = __esm(() => {
   init_filters();
   init_output2();
   init_pagination();
+  init_tool_contracts();
   init_api();
   init_output();
   list_default = defineCommand2({
@@ -2300,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
@@ -2316,7 +2441,7 @@ var init_list = __esm(() => {
       ...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",
@@ -2329,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 }) {
@@ -2374,11 +2491,7 @@ var init_list = __esm(() => {
       }
       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, {
+      return runTool(client, customerToolContracts.outlit_list_customers.toolName, params, json, {
         spinnerMessage: "Fetching customers...",
         table: {
           columns: [
@@ -2404,6 +2517,7 @@ var init_get = __esm(() => {
   init_dist();
   init_auth();
   init_output2();
+  init_tool_contracts();
   init_api();
   init_config();
   get_default = defineCommand2({
@@ -2420,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",
@@ -2441,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(`
 `)
@@ -2462,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);
     }
   });
 });
@@ -2478,6 +2595,7 @@ var init_timeline = __esm(() => {
   init_auth();
   init_output2();
   init_pagination();
+  init_tool_contracts();
   init_api();
   init_config();
   timeline_default = defineCommand2({
@@ -2492,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",
@@ -2515,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",
@@ -2523,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": {
@@ -2555,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);
     }
   });
 });
@@ -2604,6 +2724,7 @@ var init_list2 = __esm(() => {
   init_filters();
   init_output2();
   init_pagination();
+  init_tool_contracts();
   init_api();
   init_output();
   list_default2 = defineCommand2({
@@ -2617,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",
@@ -2634,7 +2755,7 @@ var init_list2 = __esm(() => {
       ...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",
@@ -2670,7 +2791,7 @@ var init_list2 = __esm(() => {
       }
       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: [
@@ -2714,376 +2835,213 @@ var init_users = __esm(() => {
   });
 });
 
-// src/lib/setup.ts
-import { execFileSync as execFileSync2 } from "node:child_process";
-function runMcpCliSetup(key, json, opts, exitOnError = true) {
-  try {
-    execFileSync2(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);
+// 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 0;
+}
+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";
     }
-    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 };
+  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;
 }
-function runMcpFileSetup(key, json, opts, exitOnError = true) {
-  const mcpConfig = opts.mcpConfig ?? {
-    url: DEFAULT_MCP_URL,
-    headers: { Authorization: `Bearer ${key}` }
-  };
+function readCommandOutput2(command, args) {
   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}`) };
-    }
-    throw err;
+    return execFileSync3(command, args, {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"]
+    }).trim();
+  } catch {
+    return null;
   }
-  if (exitOnError) {
-    if (isJsonMode(json)) {
-      outputResult({ success: true, path: opts.configPath, agent: opts.agentId });
-      return { success: true };
-    }
-    console.log(`${TICK2} ${opts.successMessage}`);
+}
+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
+  });
+}
+function safeRealPath2(filePath) {
+  try {
+    return realpathSync2(filePath);
+  } catch {
+    return null;
   }
-  return { success: true };
 }
-var init_setup = __esm(() => {
+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();
+  init_tty();
+  UPDATE_CHECK_INTERVAL_MS2 = 12 * 60 * 60 * 1000;
 });
 
-// src/commands/setup/claude-code.ts
-var exports_claude_code = {};
-__export(exports_claude_code, {
-  default: () => claude_code_default,
-  configureSafe: () => configureSafe
+// src/commands/setup/skills.ts
+var exports_skills = {};
+__export(exports_skills, {
+  runSkillsInstall: () => runSkillsInstall,
+  runAgentSkillsInstall: () => runAgentSkillsInstall,
+  getSkillAgentId: () => getSkillAgentId,
+  detectPackageRunner: () => detectPackageRunner,
+  default: () => skills_default,
+  SKILLS_REPO_URL: () => SKILLS_REPO_URL
 });
-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;
-}
-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);
-          }
-        }
-      });
-    }
-  });
-});
-
-// src/commands/setup/openclaw.ts
-var exports_openclaw = {};
-__export(exports_openclaw, {
-  getSkillDir: () => getSkillDir,
-  default: () => openclaw_default,
-  configureSafe: () => configureSafe5,
-  buildSkillContent: () => buildSkillContent
-});
-import { homedir as homedir3 } from "node:os";
-import { join as join4 } from "node:path";
-function getSkillDir() {
-  const home = homedir3();
-  return join4(home, ".openclaw", "skills", "outlit");
-}
-function buildSkillContent(maskedKey) {
-  return `---
-name: outlit
-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");
-  try {
-    writeConfigFile(skillPath, buildSkillContent(maskKey(key)), { json, label: "SKILL.md" });
-    return true;
-  } catch {
-    return false;
-  }
+import { execFileSync as execFileSync4 } from "node:child_process";
+function getSkillAgentId(agent) {
+  return skillAgentMap[agent];
 }
-var openclaw_default;
-var init_openclaw = __esm(() => {
-  init_dist();
-  init_auth();
-  init_output2();
-  init_config();
-  init_output();
-  openclaw_default = defineCommand2({
-    meta: {
-      name: "openclaw",
-      description: "Write Outlit skill to ~/.openclaw/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.`);
-    }
-  });
-});
-
-// src/commands/setup/skills.ts
-var exports_skills = {};
-__export(exports_skills, {
-  runSkillsInstall: () => runSkillsInstall,
-  detectPackageRunner: () => detectPackageRunner,
-  default: () => skills_default
-});
-import { execFileSync as execFileSync3 } from "node:child_process";
 function detectPackageRunner() {
   const whichCmd = process.platform === "win32" ? "where" : "which";
   for (const runner of ["npx", "bunx", "pnpx"]) {
     try {
-      execFileSync3(whichCmd, [runner], { stdio: "ignore" });
+      execFileSync4(whichCmd, [runner], { stdio: "ignore" });
       return runner;
     } catch {}
   }
   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) {
@@ -3094,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 {
-    execFileSync3(runner, buildRunnerArgs(runner), { stdio: "pipe" });
+    execFileSync4(runner, buildRunnerArgs(runner, { agents, skillNames, autoConfirm }), {
+      stdio: isInteractiveInstall ? "inherit" : "pipe"
+    });
   } catch (err) {
     if (exitOnError) {
       if (isEnoentError(err)) {
@@ -3114,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/codex.ts
+var exports_codex = {};
+__export(exports_codex, {
+  default: () => codex_default
+});
+var codex_default;
+var init_codex = __esm(() => {
+  init_dist();
+  init_output2();
+  init_skills();
+  codex_default = defineCommand2({
+    meta: {
+      name: "codex",
+      description: "Install the Outlit skill for Codex."
+    },
+    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 execFileSync4 } from "node:child_process";
-import { existsSync as existsSync2 } from "node:fs";
+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 join6 } from "node:path";
+import { join as join5 } from "node:path";
 function isCommandAvailable(cmd) {
   try {
     const whichCmd = process.platform === "win32" ? "where" : "which";
-    execFileSync4(whichCmd, [cmd], { stdio: "ignore" });
+    execFileSync5(whichCmd, [cmd], { stdio: "ignore" });
     return true;
   } catch {
     return false;
   }
 }
+function getHomeDir() {
+  return process.env.HOME?.trim() || homedir4();
+}
 function detectAgents() {
-  const home = homedir4();
+  const home = getHomeDir();
+  const configHome = process.env.XDG_CONFIG_HOME?.trim() || join5(home, ".config");
   const detected = [];
-  if (existsSync2(join6(home, ".cursor")))
-    detected.push("cursor");
   if (isCommandAvailable("claude"))
     detected.push("claude-code");
-  if (existsSync2(getClaudeDesktopConfigPath()))
-    detected.push("claude-desktop");
-  if (isCommandAvailable("code") || existsSync2(join6(process.cwd(), ".vscode")))
-    detected.push("vscode");
+  if (isCommandAvailable("codex"))
+    detected.push("codex");
   if (isCommandAvailable("gemini"))
     detected.push("gemini");
-  if (existsSync2(join6(home, ".openclaw", "skills")))
+  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, configurators, setup_default;
-var init_setup2 = __esm(() => {
+var agentLabels, setupSubcommandNames, setup_default;
+var init_setup = __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" },
+    codex: { label: "Codex", hint: "codex CLI 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
+    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: [
-        "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 && 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).`);
     }
   });
 });
@@ -3325,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 existsSync3 } 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)` };
     }
@@ -3347,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 {
@@ -3434,8 +3535,42 @@ async function checkIntegrations(apiKey) {
     };
   }
 }
-function detectAgents2() {
-  const detected = detectAgents();
+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 [
       {
@@ -3446,66 +3581,15 @@ function detectAgents2() {
     ];
   }
   const results = [];
-  const home = homedir5();
   for (const agentId of detected) {
     const meta = agentChecks[agentId];
-    if (agentId === "openclaw") {
-      const openclawBase = join7(home, ".openclaw", "skills");
-      const hasSkill = existsSync3(join7(openclawBase, "outlit", "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 `clawhub install outlit` 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 = existsSync3(join7(skillsDir, "outlit-cli")) || existsSync3(join7(skillsDir, "outlit-sdk")) || existsSync3(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 (!existsSync3(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;
 }
@@ -3540,7 +3624,8 @@ var init_doctor = __esm(() => {
   init_config();
   init_output();
   init_tty();
-  init_setup2();
+  init_update();
+  init_setup();
   FAIL_SYMBOL2 = isUnicodeSupported ? String.fromCodePoint(10007) : "x";
   STATUS_ICONS = {
     pass: TICK2,
@@ -3557,73 +3642,335 @@ 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.",
         "",
-        "JSON output format:",
-        '  { "ok": boolean, "checks": [{ "name", "status", "message", "detail?" }] }',
+        "JSON output format:",
+        '  { "ok": boolean, "checks": [{ "name", "status", "message", "detail?" }] }',
+        "",
+        "Examples:",
+        "  outlit doctor",
+        "  outlit doctor --json",
+        `  outlit doctor --json | jq '.checks[] | select(.status == "fail")'`,
+        "",
+        "For AI agents: use outlit doctor --json to get structured diagnostics."
+      ].join(`
+`)
+    },
+    args: { ...authArgs, ...outputArgs },
+    async run({ args }) {
+      const json = !!args.json;
+      const checks = [];
+      checks.push(await checkCliVersion());
+      const credential = resolveApiKey(args["api-key"]);
+      checks.push(checkApiKeyPresence(credential));
+      if (credential) {
+        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",
+          status: "fail",
+          message: "Skipped -- no API key found"
+        });
+      }
+      checks.push(...buildAgentChecks());
+      const hasFail = checks.some((c) => c.status === "fail");
+      if (isJsonMode(json)) {
+        outputResult({ ok: !hasFail, checks });
+      } else {
+        printChecks(checks);
+      }
+      if (hasFail)
+        process.exit(1);
+    }
+  });
+  agentChecks = {
+    "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"
+    },
+    gemini: {
+      name: "Gemini CLI",
+      missingDetail: "Run `outlit setup gemini` to install the Outlit skill"
+    },
+    droid: {
+      name: "Droid",
+      missingDetail: "Run `outlit setup droid` to install the Outlit skill"
+    },
+    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/upgrade.ts
+var exports_upgrade = {};
+__export(exports_upgrade, {
+  default: () => upgrade_default
+});
+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();
+  init_config();
+  init_output();
+  list_default3 = defineCommand2({
+    meta: {
+      name: "list",
+      description: [
+        "List structured facts for a customer.",
+        "",
+        "Filter by fact status, source type, or occurrence date range.",
+        "",
+        "Examples:",
+        "  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(`
+`)
+    },
+    args: {
+      ...authArgs,
+      ...outputArgs,
+      ...paginationArgs,
+      customer: {
+        type: "positional",
+        description: "Customer UUID or domain to retrieve facts for",
+        required: true
+      },
+      status: {
+        type: "string",
+        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 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 doctor",
-        "  outlit doctor --json",
-        `  outlit doctor --json | jq '.checks[] | select(.status == "fail")'`,
+        "  outlit facts get --fact-id fact_123",
+        "  outlit facts get --fact-id fact_123 --include evidence",
         "",
-        "For AI agents: use outlit doctor --json to get structured diagnostics."
+        AGENT_JSON_HINT
       ].join(`
 `)
     },
-    args: { ...authArgs, ...outputArgs },
+    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 checks = [];
-      checks.push(await checkCliVersion());
-      const credential = resolveApiKey(args["api-key"]);
-      checks.push(checkApiKeyPresence(credential));
-      if (credential) {
-        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",
-          status: "fail",
-          message: "Skipped -- no API key found"
-        });
-      }
-      checks.push(...detectAgents2());
-      const hasFail = checks.some((c) => c.status === "fail");
-      if (isJsonMode(json)) {
-        outputResult({ ok: !hasFail, checks });
-      } else {
-        printChecks(checks);
-      }
-      if (hasFail)
-        process.exit(1);
+      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);
     }
   });
-  agentChecks = {
-    cursor: {
-      name: "Cursor",
-      configCheck: { path: join7(homedir5(), ".cursor", "mcp.json"), key: "mcpServers" }
-    },
-    "claude-code": { name: "Claude Code" },
-    "claude-desktop": {
-      name: "Claude Desktop",
-      configCheck: { path: getClaudeDesktopConfigPath(), key: "mcpServers" }
-    },
-    vscode: {
-      name: "VS Code",
-      configCheck: { path: join7(process.cwd(), ".vscode", "mcp.json"), key: "servers" }
-    },
-    gemini: { name: "Gemini CLI" },
-    openclaw: { name: "OpenClaw" }
-  };
 });
 
-// src/commands/facts.ts
+// src/commands/facts/index.ts
 var exports_facts = {};
 __export(exports_facts, {
   default: () => facts_default
@@ -3631,23 +3978,52 @@ __export(exports_facts, {
 var facts_default;
 var init_facts = __esm(() => {
   init_dist();
-  init_auth();
   init_output2();
-  init_pagination();
-  init_api();
   facts_default = defineCommand2({
     meta: {
       name: "facts",
       description: [
-        "Retrieve facts for a customer.",
+        "Query structured customer facts.",
         "",
-        "Returns a list of facts (signals, events, and derived insights) for the",
-        "specified customer within the given timeframe.",
+        "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 facts acme.com",
-        "  outlit facts acme.com --timeframe 90d",
-        "  outlit facts acme.com --limit 50 --json",
+        "  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(`
@@ -3656,27 +4032,58 @@ var init_facts = __esm(() => {
     args: {
       ...authArgs,
       ...outputArgs,
-      ...paginationArgs,
-      customer: {
-        type: "positional",
-        description: "Customer UUID or domain to retrieve facts for",
+      "source-type": {
+        type: "string",
+        description: "Canonical source type",
         required: true
       },
-      timeframe: {
+      "source-id": {
         type: "string",
-        description: "Lookback window (e.g. 7d, 30d, 90d). Default: 30d.",
-        default: "30d"
+        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);
-      const params = {
-        customer: args.customer,
-        timeframe: args.timeframe
-      };
-      applyPagination(params, args, json);
-      return runTool(client, "outlit_get_facts", params, 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)
     }
   });
 });
@@ -3691,25 +4098,25 @@ 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 or direct source lookup.",
+        "Search customer context using natural language.",
         "",
-        "Performs a semantic search over customer facts, emails, and transcripts.",
+        "Performs a semantic search over grouped source and fact results.",
         "Optionally scope to a specific customer with --customer.",
-        "Use --source-type and --source-id for direct source lookup (query becomes optional).",
         "",
         "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 search 'onboarding issues' --source-types call_transcript,email",
-        "  outlit search --source-type call_transcript --source-id call_123",
+        "  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(`
@@ -3720,8 +4127,8 @@ var init_search = __esm(() => {
       ...outputArgs,
       query: {
         type: "positional",
-        description: "Natural language search query. Optional when --source-type and --source-id are provided.",
-        required: false
+        description: "Natural language search query",
+        required: true
       },
       customer: {
         type: "string",
@@ -3729,75 +4136,51 @@ var init_search = __esm(() => {
       },
       "top-k": {
         type: "string",
-        description: "Maximum number of results to return (1–50). Default: 20.",
-        default: "20"
+        description: "Maximum number of results to return (1–50). Default: 20."
       },
       after: {
         type: "string",
-        description: "Filter to events occurring after this date (ISO 8601, e.g. 2025-01-01)"
+        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 date (ISO 8601, e.g. 2025-03-31)"
+        description: "Filter to events occurring before this datetime (ISO 8601, e.g. 2025-03-31T23:59:59Z)"
       },
       "source-types": {
         type: "string",
-        description: "Comma-separated broad source type filter"
-      },
-      "source-type": {
-        type: "string",
-        description: "Exact source type for direct lookup (must pair with --source-id)"
-      },
-      "source-id": {
-        type: "string",
-        description: "Exact source ID for direct lookup (must pair with --source-type)"
+        description: `Comma-separated generic source type filter (${customerSourceTypes.join(", ")})`
       }
     },
     async run({ args }) {
       const json = !!args.json;
-      const topK = Number(args["top-k"]);
-      if (!Number.isFinite(topK) || topK < 1 || topK > 50) {
+      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 sourceType = args["source-type"];
-      const sourceId = args["source-id"];
-      const sourceTypes = args["source-types"];
-      if (sourceType && !sourceId || !sourceType && sourceId) {
+      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: "--source-type and --source-id must be provided together",
+          message: `Unknown source types: ${invalidSourceTypes.join(", ")}. Allowed: ${customerSourceTypes.join(", ")}`,
           code: "invalid_input"
         }, json);
       }
-      if (!args.query && !sourceType) {
-        return outputError({
-          message: "A query argument or --source-type and --source-id are required",
-          code: "invalid_input"
-        }, json);
-      }
-      if (sourceTypes && sourceType) {
+      const resolved = resolveCustomerContextSearchInput({
+        query: args.query,
+        customer: args.customer,
+        topK,
+        after: args.after,
+        before: args.before,
+        sourceTypes
+      });
+      if (!resolved.ok) {
         return outputError({
-          message: "--source-types cannot be combined with --source-type/--source-id",
+          message: resolved.message,
           code: "invalid_input"
         }, json);
       }
       const client = await getClientOrExit(args["api-key"], json);
-      const parseCsv = (value) => value.split(",").map((item) => item.trim()).filter(Boolean);
-      const params = { topK };
-      if (args.query)
-        params.query = args.query;
-      if (args.customer)
-        params.customer = args.customer;
-      if (args.after)
-        params.occurredAfter = args.after;
-      if (args.before)
-        params.occurredBefore = args.before;
-      if (sourceTypes)
-        params.sourceTypes = parseCsv(sourceTypes);
-      if (sourceType)
-        params.sourceType = sourceType;
-      if (sourceId)
-        params.sourceId = sourceId;
-      return runTool(client, "outlit_search_customer_context", params, json);
+      return runTool(client, customerToolContracts.outlit_search_customer_context.toolName, resolved.request, json);
     }
   });
 });
@@ -3807,12 +4190,13 @@ var exports_sql = {};
 __export(exports_sql, {
   default: () => sql_default
 });
-import { readFileSync as readFileSync2 } from "node:fs";
+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({
@@ -3824,7 +4208,7 @@ var init_sql = __esm(() => {
         "Provide the query as a positional argument or via --query-file.",
         "When both are provided, --query-file takes precedence.",
         "",
-        "Available tables: events, customer_dimensions, user_dimensions, mrr_snapshots",
+        `Available tables: ${schemaTables.join(", ")}`,
         "",
         "Examples:",
         "  outlit sql 'SELECT * FROM events LIMIT 10'",
@@ -3859,7 +4243,7 @@ var init_sql = __esm(() => {
       let sql;
       if (args["query-file"]) {
         try {
-          sql = readFileSync2(args["query-file"], "utf-8");
+          sql = readFileSync4(args["query-file"], "utf-8");
         } catch (err) {
           return outputError({
             message: `Cannot read file: ${errorMessage(err, "unknown error")}`,
@@ -3875,7 +4259,7 @@ var init_sql = __esm(() => {
       if (!Number.isFinite(limit) || limit <= 0) {
         return outputError({ message: "--limit must be a positive number", code: "invalid_input" }, json);
       }
-      return runTool(client, "outlit_query", { sql, limit }, json);
+      return runTool(client, customerToolContracts.outlit_query.toolName, { sql, limit }, json);
     }
   });
 });
@@ -3890,6 +4274,7 @@ var init_schema = __esm(() => {
   init_dist();
   init_auth();
   init_output2();
+  init_tool_contracts();
   init_api();
   schema_default = defineCommand2({
     meta: {
@@ -3900,7 +4285,7 @@ var init_schema = __esm(() => {
         "Without a table name, returns the full schema for all tables.",
         "With a table name, returns detailed column info for that table.",
         "",
-        "Available tables: events, customer_dimensions, user_dimensions, mrr_snapshots",
+        `Available tables: ${schemaTables.join(", ")}`,
         "",
         "Examples:",
         "  outlit schema",
@@ -3916,7 +4301,7 @@ var init_schema = __esm(() => {
       ...outputArgs,
       table: {
         type: "positional",
-        description: "Table to describe (events, customer_dimensions, user_dimensions, mrr_snapshots). Optional.",
+        description: `Table to describe (${schemaTables.join(", ")}). Optional.`,
         required: false
       }
     },
@@ -3926,7 +4311,7 @@ var init_schema = __esm(() => {
       const params = {};
       if (args.table)
         params.table = args.table;
-      return runTool(client, "outlit_schema", params, json);
+      return runTool(client, customerToolContracts.outlit_schema.toolName, params, json);
     }
   });
 });
@@ -4022,17 +4407,17 @@ var init_providers = __esm(() => {
 });
 
 // src/commands/integrations/list.ts
-var exports_list3 = {};
-__export(exports_list3, {
-  default: () => list_default3
+var exports_list4 = {};
+__export(exports_list4, {
+  default: () => list_default4
 });
-var list_default3;
-var init_list3 = __esm(() => {
+var list_default4;
+var init_list4 = __esm(() => {
   init_dist();
   init_auth();
   init_output2();
   init_api();
-  list_default3 = defineCommand2({
+  list_default4 = defineCommand2({
     meta: {
       name: "list",
       description: [
@@ -4486,7 +4871,7 @@ var init_integrations = __esm(() => {
 `)
     },
     subCommands: {
-      list: () => Promise.resolve().then(() => (init_list3(), exports_list3)).then((m) => m.default),
+      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)
@@ -4741,9 +5126,7 @@ var init_completions = __esm(() => {
             { 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" }
           ]
         },
         {
@@ -4790,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",
@@ -4800,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" }
       ]
     },
     {
@@ -4837,17 +5257,20 @@ var init_completions = __esm(() => {
     },
     {
       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: [] }
   ];
@@ -4900,142 +5323,149 @@ var init_completions = __esm(() => {
 var exports_setup = {};
 __export(exports_setup, {
   isCommandAvailable: () => isCommandAvailable2,
-  detectAgents: () => detectAgents3,
+  detectAgents: () => detectAgents2,
   default: () => setup_default2
 });
-import { execFileSync as execFileSync5 } from "node:child_process";
-import { existsSync as existsSync4 } from "node:fs";
+import { execFileSync as execFileSync6 } from "node:child_process";
+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";
-    execFileSync5(whichCmd, [cmd], { stdio: "ignore" });
+    execFileSync6(whichCmd, [cmd], { stdio: "ignore" });
     return true;
   } catch {
     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 (existsSync4(join8(home, ".cursor")))
-    detected.push("cursor");
   if (isCommandAvailable2("claude"))
     detected.push("claude-code");
-  if (existsSync4(getClaudeDesktopConfigPath()))
-    detected.push("claude-desktop");
-  if (isCommandAvailable2("code") || existsSync4(join8(process.cwd(), ".vscode")))
-    detected.push("vscode");
+  if (isCommandAvailable2("codex"))
+    detected.push("codex");
   if (isCommandAvailable2("gemini"))
     detected.push("gemini");
-  if (existsSync4(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).`);
     }
   });
 });
@@ -5392,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",
@@ -5408,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
@@ -5421,13 +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);