@outlit/cli 1.7.0 → 1.8.0

package/dist/cli.js

@@ -104,7 +104,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@outlit/cli",
-    version: "1.7.0",
+    version: "1.8.0",
     description: "CLI for Outlit customer intelligence platform",
     license: "Apache-2.0",
     repository: {
@@ -135,7 +135,7 @@ var init_package = __esm(() => {
     },
     dependencies: {
       "@clack/prompts": "^1.0.1",
-      "@outlit/tools": "^0.2.0",
+      "@outlit/tools": "^0.2.1",
       citty: "^0.2.1"
     },
     devDependencies: {
@@ -183,14 +183,15 @@ function promptInput(label, opts) {
 function isInteractive() {
   if (!process.stdin.isTTY || !process.stdout.isTTY)
     return false;
-  if (process.env.CI === "true" || process.env.CI === "1")
-    return false;
-  if (process.env.GITHUB_ACTIONS)
+  if (isCiEnvironment())
     return false;
   if (process.env.TERM === "dumb")
     return false;
   return true;
 }
+function isCiEnvironment() {
+  return process.env.CI === "true" || process.env.CI === "1" || Boolean(process.env.GITHUB_ACTIONS);
+}
 var isUnicodeSupported;
 var init_tty = __esm(() => {
   isUnicodeSupported = process.platform !== "win32" || Boolean(process.env.WT_SESSION) || process.env.TERM_PROGRAM === "vscode";
@@ -1602,7 +1603,7 @@ function createOutlitClient(options) {
     }
   };
 }
-var customerToolNames, customerSourceTypes, customerSourceTypeAliases, customerSourceTypeInputs, notificationProviderValues, customerToolContracts, customerBillingStatuses, customerFactStatuses, customerFactTypes, unsupportedCustomerFactTypes, customerFactCategories, customerIncludeSections, customerTimeframes, notificationSeverityValues, timelineChannels, timelineTimeframes, userJourneyStages, customerToolNameSet, customerSourceTypeSet, customerSourceTypeAliasMap, iso8601UtcDateTimeRegex, DEFAULT_OUTLIT_API_URL = "https://app.outlit.ai", actionToolNames, defaultAgentToolNames, sqlToolNames, analyticalAgentToolNames;
+var customerToolNames, customerSourceTypes, customerSourceTypeAliases, customerSourceTypeInputs, customerToolContracts, customerBillingStatuses, customerFactStatuses, customerFactTypes, unsupportedCustomerFactTypes, customerFactCategories, customerIncludeSections, customerTimeframes, notificationProviderValues, notificationSeverityValues, timelineChannels, timelineTimeframes, userJourneyStages, customerToolNameSet, customerSourceTypeSet, customerSourceTypeAliasMap, iso8601UtcDateTimeRegex, DEFAULT_OUTLIT_API_URL = "https://app.outlit.ai", actionToolNames, defaultAgentToolNames, sqlToolNames, analyticalAgentToolNames;
 var init_dist4 = __esm(() => {
   customerToolNames = [
     "outlit_list_customers",
@@ -1612,6 +1613,7 @@ var init_dist4 = __esm(() => {
     "outlit_list_facts",
     "outlit_get_fact",
     "outlit_get_source",
+    "outlit_list_sources",
     "outlit_search_customer_context",
     "outlit_query",
     "outlit_schema",
@@ -1634,7 +1636,6 @@ var init_dist4 = __esm(() => {
     "CRM",
     "CRM_OPPORTUNITY"
   ];
-  notificationProviderValues = ["slack"];
   customerToolContracts = {
     outlit_list_customers: {
       toolName: "outlit_list_customers",
@@ -2039,6 +2040,69 @@ var init_dist4 = __esm(() => {
         additionalProperties: false
       }
     },
+    outlit_list_sources: {
+      toolName: "outlit_list_sources",
+      description: "List concrete source records deterministically. Use this instead of semantic search when you need enumerated calls, emails, calendar events, support tickets, or opportunities.",
+      inputSchema: {
+        $schema: "https://json-schema.org/draft/2020-12/schema",
+        type: "object",
+        properties: {
+          sourceType: {
+            description: "Generic source type to list.",
+            type: "string",
+            enum: customerSourceTypeInputs
+          },
+          customer: {
+            description: "Customer ID, domain, or name to scope source listing.",
+            type: "string",
+            minLength: 1,
+            maxLength: 200
+          },
+          after: {
+            description: "ISO 8601 datetime lower bound.",
+            type: "string",
+            format: "date-time",
+            pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
+          },
+          before: {
+            description: "ISO 8601 datetime upper bound.",
+            type: "string",
+            format: "date-time",
+            pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
+          },
+          participant: {
+            description: "Participant email or name to filter source records.",
+            type: "string",
+            minLength: 1,
+            maxLength: 500
+          },
+          provider: {
+            description: "Provider identifier such as gmail, gong, or google-calendar.",
+            type: "string",
+            minLength: 1,
+            maxLength: 200
+          },
+          hasTranscript: {
+            description: "Filter call sources by transcript presence.",
+            type: "boolean"
+          },
+          limit: {
+            description: "Results per page.",
+            default: 50,
+            type: "integer",
+            minimum: 1,
+            maximum: 100
+          },
+          cursor: {
+            description: "Pagination cursor.",
+            type: "string",
+            minLength: 1,
+            maxLength: 2000
+          }
+        },
+        additionalProperties: false
+      }
+    },
     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.",
@@ -2210,7 +2274,7 @@ Returns column definitions and example queries for each view.`,
                 provider: {
                   description: "Notification provider",
                   type: "string",
-                  enum: notificationProviderValues
+                  enum: ["slack"]
                 },
                 channelId: {
                   description: "Provider-specific destination channel ID",
@@ -2321,6 +2385,7 @@ Returns column definitions and example queries for each view.`,
     "behaviorMetrics"
   ];
   customerTimeframes = ["7d", "14d", "30d", "90d"];
+  notificationProviderValues = ["slack"];
   notificationSeverityValues = ["low", "medium", "high"];
   timelineChannels = [
     "SDK",
@@ -2541,10 +2606,12 @@ function renderTable(headers, rows, emptyMessage = "(no results)") {
 function renderPaginationHint(pagination, itemCount) {
   if (itemCount === 0)
     return "";
+  const total = typeof pagination.total === "number" ? pagination.total : null;
   if (pagination.hasMore && pagination.nextCursor) {
-    return `Showing ${itemCount} of ${pagination.total} total. Next page: --cursor ${pagination.nextCursor}`;
+    const countLabel = total === null ? `${itemCount} results` : `${itemCount} of ${total} total`;
+    return `Showing ${countLabel}. Next page: --cursor ${pagination.nextCursor}`;
   }
-  return `Showing all ${pagination.total} results.`;
+  return total === null ? `Showing ${itemCount} results.` : `Showing all ${total} results.`;
 }
 var BOX;
 var init_table = __esm(() => {
@@ -2601,10 +2668,11 @@ async function pingApiKey(apiKey) {
     const message = payload?.error ?? (text.length > 0 ? text : `API error (${response.status})`);
     throw new Error(message);
   }
+  return payload;
 }
 async function validateKeyOrExit(apiKey, json) {
   try {
-    await pingApiKey(apiKey);
+    return await pingApiKey(apiKey);
   } catch (err) {
     return outputError({
       message: `API key is invalid or expired: ${errorMessage(err, "unknown error")}`,
@@ -2659,17 +2727,173 @@ var init_api = __esm(() => {
   init_table();
 });
 
+// src/lib/poll.ts
+async function pollUntil(fn, predicate, opts = {}) {
+  const intervalMs = opts.intervalMs ?? 2000;
+  const timeoutMs = opts.timeoutMs ?? 300000;
+  const start = Date.now();
+  while (Date.now() - start < timeoutMs) {
+    try {
+      const result = await fn();
+      if (predicate(result))
+        return result;
+    } catch {}
+    if (opts.spinner && opts.spinnerMessage) {
+      const elapsed = Math.floor((Date.now() - start) / 1000);
+      opts.spinner.update(`${opts.spinnerMessage} (${elapsed}s)`);
+    }
+    await sleep(intervalMs);
+  }
+  return null;
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// src/lib/cli-auth.ts
+function buildApiUrl(baseUrl, path) {
+  return new URL(path, baseUrl).toString();
+}
+function asObject(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    throw new Error("Invalid response from Outlit API");
+  }
+  return value;
+}
+async function readJsonObject(response) {
+  const text = await response.text();
+  const parsed = text ? (() => {
+    try {
+      return JSON.parse(text);
+    } catch {
+      throw new Error(text);
+    }
+  })() : {};
+  return asObject(parsed);
+}
+function errorFromPayload(payload, fallback) {
+  return typeof payload.error === "string" ? payload.error : fallback;
+}
+async function startCliAuthRequest(baseUrl = process.env.OUTLIT_API_URL ?? DEFAULT_API_URL) {
+  const response = await globalThis.fetch(buildApiUrl(baseUrl, "/api/cli-auth/start"), {
+    method: "POST",
+    headers: {
+      "User-Agent": `outlit-cli/${CLI_VERSION2}`
+    }
+  });
+  const payload = await readJsonObject(response);
+  if (!response.ok) {
+    throw new Error(errorFromPayload(payload, `CLI auth start failed (${response.status})`));
+  }
+  if (typeof payload.requestId !== "string" || typeof payload.pollToken !== "string" || typeof payload.userCode !== "string" || typeof payload.approveUrl !== "string" || typeof payload.expiresAt !== "string" || typeof payload.intervalSeconds !== "number") {
+    throw new Error("Invalid CLI auth start response from Outlit API");
+  }
+  return {
+    requestId: payload.requestId,
+    pollToken: payload.pollToken,
+    userCode: payload.userCode,
+    approveUrl: payload.approveUrl,
+    expiresAt: payload.expiresAt,
+    intervalSeconds: payload.intervalSeconds
+  };
+}
+async function pollCliAuthRequest(baseUrl, input) {
+  const response = await globalThis.fetch(buildApiUrl(baseUrl, "/api/cli-auth/poll"), {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "User-Agent": `outlit-cli/${CLI_VERSION2}`
+    },
+    body: JSON.stringify(input)
+  });
+  const payload = await readJsonObject(response);
+  if (payload.status === "invalid") {
+    return { status: "invalid" };
+  }
+  if (!response.ok) {
+    throw new Error(errorFromPayload(payload, `CLI auth poll failed (${response.status})`));
+  }
+  if (payload.status === "approved") {
+    if (typeof payload.apiKey !== "string" || typeof payload.keyPrefix !== "string") {
+      throw new Error("Invalid approved CLI auth response from Outlit API");
+    }
+    return {
+      status: "approved",
+      apiKey: payload.apiKey,
+      keyPrefix: payload.keyPrefix
+    };
+  }
+  if (payload.status === "pending" || payload.status === "failed" || payload.status === "consumed" || payload.status === "expired" || payload.status === "invalid") {
+    return payload;
+  }
+  throw new Error("Invalid CLI auth poll response from Outlit API");
+}
+async function waitForCliAuthApproval(baseUrl, request, opts = {}) {
+  const expiresAtMs = new Date(request.expiresAt).getTime();
+  const timeoutMs = opts.timeoutMs ?? Math.max(1000, expiresAtMs - Date.now());
+  const intervalMs = opts.intervalMs ?? request.intervalSeconds * 1000;
+  return pollUntil(() => pollCliAuthRequest(baseUrl, {
+    requestId: request.requestId,
+    pollToken: request.pollToken
+  }), (result) => result.status !== "pending", {
+    ...opts,
+    intervalMs,
+    timeoutMs
+  });
+}
+var init_cli_auth = __esm(() => {
+  init_config();
+});
+
 // src/commands/auth/login.ts
 var exports_login = {};
 __export(exports_login, {
   default: () => login_default
 });
+async function runBrowserAuthFlow(json) {
+  const baseUrl = process.env.OUTLIT_API_URL ?? DEFAULT_API_URL;
+  const session = await startCliAuthRequest(baseUrl);
+  const opened = isInteractive() ? openBrowser(session.approveUrl) : false;
+  process.stderr.write([
+    "",
+    "Authorize Outlit CLI in your browser:",
+    `  ${session.approveUrl}`,
+    "",
+    `Confirm this terminal code: ${session.userCode}`,
+    opened ? "Waiting for browser approval..." : "Waiting after you approve the request...",
+    ""
+  ].join(`
+`));
+  const spinner = isInteractive() ? bt2() : null;
+  spinner?.start("Waiting for browser approval...");
+  const result = await waitForCliAuthApproval(baseUrl, session, {
+    spinnerMessage: "Waiting for browser approval..."
+  });
+  if (!result) {
+    spinner?.stop("Approval timed out");
+    return outputError({
+      message: "Timed out waiting for browser approval. Run `outlit auth login --browser` again.",
+      code: "auth_timeout"
+    }, json);
+  }
+  if (result.status !== "approved") {
+    spinner?.stop("Approval did not complete");
+    const message = result.status === "failed" && result.error ? `Browser authorization failed: ${result.error}` : `Browser authorization ${result.status}. Run \`outlit auth login --browser\` again.`;
+    return outputError({
+      message,
+      code: `auth_${result.status}`
+    }, json);
+  }
+  spinner?.stop("Browser authorization approved");
+  return result.apiKey;
+}
 var login_default;
 var init_login = __esm(() => {
   init_dist3();
   init_dist();
   init_output2();
   init_api();
+  init_cli_auth();
   init_config();
   init_output();
   init_tty();
@@ -2686,6 +2910,7 @@ var init_login = __esm(() => {
         "",
         "Examples:",
         "  outlit auth login               # interactive (TTY)",
+        "  outlit auth login --browser     # browser approval, works in agent shells",
         "  outlit auth login --key ok_xxx  # non-interactive (CI, scripts, agents)"
       ].join(`
 `)
@@ -2696,14 +2921,33 @@ var init_login = __esm(() => {
         type: "string",
         description: `API key to store (required in non-interactive / CI mode).
 Format: ok_ followed by 32+ alphanumeric characters.`
+      },
+      browser: {
+        type: "boolean",
+        description: "Create a scoped CLI key through browser approval instead of pasting a key."
       }
     },
     async run({ args }) {
       const json = !!args.json;
       let apiKey = args.key;
+      const interactive = isInteractive();
+      const shouldUseBrowserAuth = args.browser || !interactive && !isCiEnvironment();
       if (!apiKey) {
-        if (!isInteractive()) {
-          return outputError({ message: "--key <apiKey> is required in non-interactive mode", code: "missing_key" }, json);
+        if (shouldUseBrowserAuth) {
+          apiKey = await runBrowserAuthFlow(json);
+        } else if (!interactive) {
+          return outputError({
+            message: "--key <apiKey> is required in non-interactive mode. For browser approval, run `outlit auth login --browser`.",
+            code: "missing_key"
+          }, json);
+        }
+      }
+      if (!apiKey) {
+        if (!interactive) {
+          return outputError({
+            message: "--key <apiKey> is required in non-interactive mode. For browser approval, run `outlit auth login --browser`.",
+            code: "missing_key"
+          }, json);
         }
         We("Outlit CLI -- Login");
         const existing = resolveApiKey();
@@ -2717,33 +2961,35 @@ Format: ok_ followed by 32+ alphanumeric characters.`
         const method = await Je({
           message: "How would you like to get your API key?",
           options: [
-            { value: "browser", label: "Open app.outlit.ai in browser" },
+            { value: "browser", label: "Authorize in browser" },
             { value: "manual", label: "Enter API key manually" }
           ]
         });
         if (Ct(method))
           cancelLogin();
         if (method === "browser") {
+          apiKey = await runBrowserAuthFlow(json);
+        } else {
           const opened = openBrowser(OUTLIT_DASHBOARD_URL);
           if (opened) {
             R2.info("Opening browser... paste your key once you have it.");
           } else {
             R2.info(`Could not open browser. Visit ${OUTLIT_DASHBOARD_URL} manually.`);
           }
+          const result = await He({
+            message: "Paste your Outlit API key:",
+            validate: (v) => {
+              if (!v)
+                return "API key is required";
+              if (!v.startsWith("ok_"))
+                return 'Outlit API keys start with "ok_"';
+              return;
+            }
+          });
+          if (Ct(result))
+            cancelLogin();
+          apiKey = result;
         }
-        const result = await He({
-          message: "Paste your Outlit API key:",
-          validate: (v) => {
-            if (!v)
-              return "API key is required";
-            if (!v.startsWith("ok_"))
-              return 'Outlit API keys start with "ok_"';
-            return;
-          }
-        });
-        if (Ct(result))
-          cancelLogin();
-        apiKey = result;
       }
       if (!apiKey.startsWith("ok_")) {
         return outputError({
@@ -2931,9 +3177,18 @@ var init_whoami = __esm(() => {
       const json = !!args.json;
       const credential = requireCredential(args["api-key"], json);
       const masked = maskKey(credential.key);
-      await validateKeyOrExit(credential.key, json);
+      const validation = await validateKeyOrExit(credential.key, json);
       if (isJsonMode(json)) {
-        return outputResult({ key: masked, source: credential.source, valid: true });
+        return outputResult({
+          key: masked,
+          source: credential.source,
+          valid: true,
+          organizationId: validation.organizationId,
+          createdById: validation.createdById,
+          organization: validation.organization,
+          createdBy: validation.createdBy,
+          apiKey: validation.apiKey
+        });
       }
       process.stdout.write(`${masked} (${credential.source})
 `);
@@ -4877,12 +5132,183 @@ var init_facts = __esm(() => {
   });
 });
 
+// src/commands/sources/list.ts
+var exports_list4 = {};
+__export(exports_list4, {
+  default: () => list_default4
+});
+function parseLimit(value, json) {
+  if (!value)
+    return;
+  const limit = Number(value);
+  if (!Number.isInteger(limit) || limit < 1 || limit > 100) {
+    outputError({
+      message: `--limit must be an integer between 1 and 100 (got: ${value})`,
+      code: "invalid_input"
+    }, json);
+    return;
+  }
+  return limit;
+}
+function parseDateArg(name, value, json) {
+  if (!value)
+    return null;
+  if (!ISO_8601_UTC_DATE_TIME_REGEX.test(value)) {
+    outputError({
+      message: `${name} must be a valid ISO 8601 UTC datetime`,
+      code: "invalid_input"
+    }, json);
+    return null;
+  }
+  const date = new Date(value);
+  if (Number.isNaN(date.getTime())) {
+    outputError({
+      message: `${name} must be a valid ISO 8601 datetime`,
+      code: "invalid_input"
+    }, json);
+    return null;
+  }
+  return date;
+}
+var sourceTypeDescription2, ISO_8601_UTC_DATE_TIME_REGEX, list_default4;
+var init_list4 = __esm(() => {
+  init_dist4();
+  init_dist();
+  init_auth();
+  init_output2();
+  init_api();
+  init_output();
+  sourceTypeDescription2 = `${customerSourceTypes.join(", ")} (aliases: ${customerSourceTypeAliases.join(", ")})`;
+  ISO_8601_UTC_DATE_TIME_REGEX = /^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$/;
+  list_default4 = defineCommand2({
+    meta: {
+      name: "list",
+      description: [
+        "List concrete source records deterministically.",
+        "",
+        "Use this when you need enumerated calls, emails, calendar events, support tickets, or opportunities rather than semantic ranking.",
+        "",
+        "Examples:",
+        "  outlit sources list --customer acme.com --source-type CALL",
+        "  outlit sources list --participant alice@acme.com --source-type CALENDAR_EVENT --json",
+        "  outlit sources list --after 2026-01-01T00:00:00Z --limit 25",
+        "",
+        `Source types: ${sourceTypeDescription2}`,
+        "",
+        AGENT_JSON_HINT
+      ].join(`
+`)
+    },
+    args: {
+      ...authArgs,
+      ...outputArgs,
+      "source-type": {
+        type: "string",
+        description: `Source type (${sourceTypeDescription2})`
+      },
+      customer: {
+        type: "string",
+        description: "Customer UUID, domain, or name to scope source listing"
+      },
+      participant: {
+        type: "string",
+        description: "Participant email or name to filter source records"
+      },
+      provider: {
+        type: "string",
+        description: "Provider identifier such as gmail, gong, or google-calendar"
+      },
+      "has-transcript": {
+        type: "boolean",
+        description: "Only list call sources with a finalized transcript"
+      },
+      after: {
+        type: "string",
+        description: "Filter to sources occurring after this ISO 8601 datetime"
+      },
+      before: {
+        type: "string",
+        description: "Filter to sources occurring before this ISO 8601 datetime"
+      },
+      limit: {
+        type: "string",
+        description: "Results per page (1-100). Default: 50."
+      },
+      cursor: {
+        type: "string",
+        description: "Pagination cursor from a previous response (pagination.nextCursor)"
+      }
+    },
+    async run({ args }) {
+      const json = !!args.json;
+      const sourceType = args["source-type"] ? normalizeCustomerSourceType(args["source-type"]) : undefined;
+      if (args["source-type"] && !sourceType) {
+        return outputError({
+          message: `--source-type must be one of ${customerSourceTypeInputs.join(", ")}`,
+          code: "invalid_input"
+        }, json);
+      }
+      if (args["has-transcript"] && sourceType && sourceType !== "CALL") {
+        return outputError({
+          message: "--has-transcript can only be used with CALL sources",
+          code: "invalid_input"
+        }, json);
+      }
+      const afterDate = parseDateArg("--after", args.after, json);
+      if (args.after && !afterDate)
+        return;
+      const beforeDate = parseDateArg("--before", args.before, json);
+      if (args.before && !beforeDate)
+        return;
+      if (afterDate && beforeDate && afterDate.getTime() > beforeDate.getTime()) {
+        return outputError({
+          message: "--after must be before or equal to --before",
+          code: "invalid_input"
+        }, json);
+      }
+      const limit = parseLimit(args.limit, json);
+      if (args.limit && !limit)
+        return;
+      const client = await getClientOrExit(args["api-key"], json);
+      const params = {};
+      if (sourceType)
+        params.sourceType = sourceType;
+      if (args.customer)
+        params.customer = args.customer;
+      if (args.participant)
+        params.participant = args.participant;
+      if (args.provider)
+        params.provider = args.provider;
+      if (args["has-transcript"])
+        params.hasTranscript = true;
+      if (args.after)
+        params.after = args.after;
+      if (args.before)
+        params.before = args.before;
+      if (limit)
+        params.limit = limit;
+      if (args.cursor)
+        params.cursor = args.cursor;
+      return runTool(client, customerToolContracts.outlit_list_sources.toolName, params, json, {
+        table: {
+          columns: [
+            { header: "TYPE", key: "sourceType" },
+            { header: "OCCURRED", key: "occurredAt" },
+            { header: "TITLE", key: "title" },
+            { header: "SOURCE ID", key: "sourceId" }
+          ]
+        }
+      });
+    }
+  });
+});
+
 // src/commands/sources/get.ts
 var exports_get3 = {};
 __export(exports_get3, {
   default: () => get_default3
 });
-var sourceTypeDescription2, get_default3;
+var sourceTypeDescription3, get_default3;
 var init_get3 = __esm(() => {
   init_dist4();
   init_dist();
@@ -4890,19 +5316,21 @@ var init_get3 = __esm(() => {
   init_output2();
   init_api();
   init_output();
-  sourceTypeDescription2 = `${customerSourceTypes.join(", ")} (aliases: ${customerSourceTypeAliases.join(", ")})`;
+  sourceTypeDescription3 = `${customerSourceTypes.join(", ")} (aliases: ${customerSourceTypeAliases.join(", ")})`;
   get_default3 = defineCommand2({
     meta: {
       name: "get",
       description: [
         "Get one exact source by source type and source id.",
+        "Returns the same normalized source envelope as `sources list`, with more detailed source-specific fields when available.",
         "",
         "Examples:",
         "  outlit sources get --source-type CALL --source-id call_123",
         "  outlit sources get --source-type OPPORTUNITY --source-id opp_123",
         "  outlit sources get --source-type SUPPORT_TICKET --source-id ticket_456 --json",
         "",
-        `Source types: ${sourceTypeDescription2}`,
+        `Source types: ${sourceTypeDescription3}`,
+        "Use `outlit sources list` when you need deterministic enumeration rather than exact lookup.",
         "",
         AGENT_JSON_HINT
       ].join(`
@@ -4913,7 +5341,7 @@ var init_get3 = __esm(() => {
       ...outputArgs,
       "source-type": {
         type: "string",
-        description: `Source type (${sourceTypeDescription2})`,
+        description: `Source type (${sourceTypeDescription3})`,
         required: true
       },
       "source-id": {
@@ -4953,9 +5381,10 @@ var init_sources = __esm(() => {
     meta: {
       name: "sources",
       description: [
-        "Fetch concrete customer sources by type and id.",
+        "List or fetch concrete customer source records.",
         "",
         "Subcommands:",
+        "  list -- list source records with deterministic filters",
         "  get  -- fetch one exact source by sourceType and sourceId",
         "",
         AGENT_JSON_HINT
@@ -4963,6 +5392,7 @@ var init_sources = __esm(() => {
 `)
     },
     subCommands: {
+      list: () => Promise.resolve().then(() => (init_list4(), exports_list4)).then((m) => m.default),
       get: () => Promise.resolve().then(() => (init_get3(), exports_get3)).then((m) => m.default)
     }
   });
@@ -4973,7 +5403,7 @@ var exports_search = {};
 __export(exports_search, {
   default: () => search_default
 });
-var sourceTypeDescription3, search_default;
+var sourceTypeDescription4, search_default;
 var init_search = __esm(() => {
   init_dist4();
   init_dist();
@@ -4982,7 +5412,7 @@ var init_search = __esm(() => {
   init_api();
   init_config();
   init_output();
-  sourceTypeDescription3 = `${customerSourceTypes.join(", ")} (aliases: ${customerSourceTypeAliases.join(", ")})`;
+  sourceTypeDescription4 = `${customerSourceTypes.join(", ")} (aliases: ${customerSourceTypeAliases.join(", ")})`;
   search_default = defineCommand2({
     meta: {
       name: "search",
@@ -4990,6 +5420,7 @@ var init_search = __esm(() => {
         "Search customer context using natural language.",
         "",
         "Performs a semantic search over grouped source and fact results.",
+        "Use `outlit sources list` when you need deterministic source enumeration rather than semantic ranking.",
         "Optionally scope to a specific customer with --customer.",
         "",
         "Examples:",
@@ -5029,7 +5460,7 @@ var init_search = __esm(() => {
       },
       "source-types": {
         type: "string",
-        description: `Comma-separated generic source type filter (${sourceTypeDescription3})`
+        description: `Comma-separated generic source type filter (${sourceTypeDescription4})`
       }
     },
     async run({ args }) {
@@ -5548,17 +5979,17 @@ var init_providers = __esm(() => {
 });
 
 // src/commands/integrations/list.ts
-var exports_list4 = {};
-__export(exports_list4, {
-  default: () => list_default4
+var exports_list5 = {};
+__export(exports_list5, {
+  default: () => list_default5
 });
-var list_default4;
-var init_list4 = __esm(() => {
+var list_default5;
+var init_list5 = __esm(() => {
   init_dist();
   init_auth();
   init_output2();
   init_api();
-  list_default4 = defineCommand2({
+  list_default5 = defineCommand2({
     meta: {
       name: "list",
       description: [
@@ -5597,29 +6028,6 @@ var init_list4 = __esm(() => {
   });
 });
 
-// src/lib/poll.ts
-async function pollUntil(fn, predicate, opts = {}) {
-  const intervalMs = opts.intervalMs ?? 2000;
-  const timeoutMs = opts.timeoutMs ?? 300000;
-  const start = Date.now();
-  while (Date.now() - start < timeoutMs) {
-    try {
-      const result = await fn();
-      if (predicate(result))
-        return result;
-    } catch {}
-    if (opts.spinner && opts.spinnerMessage) {
-      const elapsed = Math.floor((Date.now() - start) / 1000);
-      opts.spinner.update(`${opts.spinnerMessage} (${elapsed}s)`);
-    }
-    await sleep(intervalMs);
-  }
-  return null;
-}
-function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-
 // src/commands/integrations/add.ts
 var exports_add = {};
 __export(exports_add, {
@@ -6032,7 +6440,7 @@ var init_integrations = __esm(() => {
 `)
     },
     subCommands: {
-      list: () => Promise.resolve().then(() => (init_list4(), exports_list4)).then((m) => m.default),
+      list: () => Promise.resolve().then(() => (init_list5(), exports_list5)).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)
@@ -6237,8 +6645,8 @@ function generateFish() {
       }
     }
   }
-  return lines.join(`
-`) + `
+  return `${lines.join(`
+`)}
 `;
 }
 var JSON_F, API_KEY_F, LIMIT_F, CURSOR_F, COMMON, PAGINATED, ACTIVITY_ORDER, COMMANDS, cmdsWithSubs, leafCmds, SCRIPTS, completions_default;
@@ -6361,8 +6769,22 @@ var init_completions = __esm(() => {
     },
     {
       name: "sources",
-      desc: "Get a concrete source by type and id",
+      desc: "List or fetch concrete source records",
       subs: [
+        {
+          name: "list",
+          desc: "List source records",
+          flags: [
+            ...PAGINATED,
+            { name: "--source-type", desc: "Source type" },
+            { name: "--customer", desc: "Scope to customer" },
+            { name: "--participant", desc: "Filter by participant" },
+            { name: "--provider", desc: "Filter by provider" },
+            { name: "--has-transcript", desc: "Only calls with transcripts" },
+            { name: "--after", desc: "Sources after date (ISO 8601)" },
+            { name: "--before", desc: "Sources before date (ISO 8601)" }
+          ]
+        },
         {
           name: "get",
           desc: "Get one exact source record",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@outlit/cli",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "description": "CLI for Outlit customer intelligence platform",
   "license": "Apache-2.0",
   "repository": {
@@ -31,7 +31,7 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.0.1",
-    "@outlit/tools": "^0.2.0",
+    "@outlit/tools": "^0.2.1",
     "citty": "^0.2.1"
   },
   "devDependencies": {