@outlit/cli 1.7.0 → 1.7.1

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.7.1",
     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: {
@@ -1602,7 +1602,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 +1612,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 +1635,6 @@ var init_dist4 = __esm(() => {
     "CRM",
     "CRM_OPPORTUNITY"
   ];
-  notificationProviderValues = ["slack"];
   customerToolContracts = {
     outlit_list_customers: {
       toolName: "outlit_list_customers",
@@ -2039,6 +2039,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 +2273,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 +2384,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 +2605,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 +2667,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")}`,
@@ -2931,9 +2998,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 +4953,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 +5137,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 +5162,7 @@ var init_get3 = __esm(() => {
       ...outputArgs,
       "source-type": {
         type: "string",
-        description: `Source type (${sourceTypeDescription2})`,
+        description: `Source type (${sourceTypeDescription3})`,
         required: true
       },
       "source-id": {
@@ -4953,9 +5202,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 +5213,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 +5224,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 +5233,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 +5241,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 +5281,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 +5800,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: [
@@ -6032,7 +6284,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 +6489,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 +6613,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.7.1",
   "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": {