@outlit/cli 1.6.4 → 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.6.4",
+    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.1.3",
+      "@outlit/tools": "^0.2.1",
       citty: "^0.2.1"
     },
     devDependencies: {
@@ -1494,11 +1494,11 @@ function isCustomerToolName(value) {
   return customerToolNameSet.has(value);
 }
 function normalizeCustomerSourceType(value) {
-  const normalizedValue = value.trim().toUpperCase();
-  if (customerSourceTypeSet.has(normalizedValue)) {
-    return normalizedValue;
+  const normalized = value.trim().toUpperCase();
+  if (customerSourceTypeSet.has(normalized)) {
+    return normalized;
   }
-  return customerSourceTypeAliasMap.get(normalizedValue) ?? null;
+  return customerSourceTypeAliasMap.get(normalized) ?? null;
 }
 function resolveCustomerContextSearchInput(value) {
   if (!value.query) {
@@ -1602,7 +1602,7 @@ function createOutlitClient(options) {
     }
   };
 }
-var customerToolNames, customerSourceTypes, customerSourceTypeAliases, customerSourceTypeInputs, 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",
@@ -2038,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.",
@@ -2154,7 +2218,7 @@ Returns column definitions and example queries for each view.`,
     },
     outlit_send_notification: {
       toolName: "outlit_send_notification",
-      description: "Send or post a Slack notification. Use only when the user explicitly asks you to send, post, or notify. The payload is rendered as a Slack code block.",
+      description: "Send or post a notification. Use only when the user explicitly asks you to send, post, or notify. Slack is the default notifier when destinations are omitted.",
       inputSchema: {
         $schema: "https://json-schema.org/draft/2020-12/schema",
         type: "object",
@@ -2165,41 +2229,18 @@ Returns column definitions and example queries for each view.`,
             maxLength: 160,
             description: "Notification title"
           },
+          markdown: {
+            description: "Markdown notification body rendered for the target provider",
+            type: "string",
+            minLength: 1,
+            maxLength: 1e5
+          },
           payload: {
-            description: "JSON-compatible payload rendered in Slack as a code block. Serialized size must be 100,000 characters or fewer.",
-            anyOf: [
-              {
-                type: "string"
-              },
-              {
-                type: "number"
-              },
-              {
-                type: "boolean"
-              },
-              {
-                type: "null"
-              },
-              {
-                type: "array",
-                items: {
-                  $ref: "#/$defs/__schema0"
-                }
-              },
-              {
-                type: "object",
-                propertyNames: {
-                  type: "string"
-                },
-                additionalProperties: {
-                  $ref: "#/$defs/__schema0"
-                }
-              }
-            ],
+            description: "Optional JSON-compatible payload. Serialized size must be 100,000 characters or fewer.",
             $ref: "#/$defs/__schema0"
           },
           message: {
-            description: "Optional Slack message",
+            description: "Optional summary message",
             type: "string",
             minLength: 1,
             maxLength: 1200
@@ -2220,9 +2261,39 @@ Returns column definitions and example queries for each view.`,
             type: "string",
             minLength: 1,
             maxLength: 240
+          },
+          destinations: {
+            description: "Optional explicit notification destinations. Omit to use the default notifier.",
+            minItems: 1,
+            maxItems: 10,
+            type: "array",
+            items: {
+              type: "object",
+              properties: {
+                provider: {
+                  description: "Notification provider",
+                  type: "string",
+                  enum: ["slack"]
+                },
+                channelId: {
+                  description: "Provider-specific destination channel ID",
+                  type: "string",
+                  minLength: 1,
+                  maxLength: 240
+                },
+                label: {
+                  description: "Optional destination label",
+                  type: "string",
+                  minLength: 1,
+                  maxLength: 120
+                }
+              },
+              required: ["provider"],
+              additionalProperties: false
+            }
           }
         },
-        required: ["title", "payload"],
+        required: ["title"],
         additionalProperties: false,
         $defs: {
           __schema0: {
@@ -2313,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",
@@ -2533,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(() => {
@@ -2593,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")}`,
@@ -2923,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})
 `);
@@ -4869,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();
@@ -4882,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(`
@@ -4905,7 +5162,7 @@ var init_get3 = __esm(() => {
       ...outputArgs,
       "source-type": {
         type: "string",
-        description: `Source type (${sourceTypeDescription2})`,
+        description: `Source type (${sourceTypeDescription3})`,
         required: true
       },
       "source-id": {
@@ -4945,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
@@ -4955,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)
     }
   });
@@ -4965,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();
@@ -4974,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",
@@ -4982,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:",
@@ -5021,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 }) {
@@ -5162,7 +5422,33 @@ function payloadSizeIsValid(payload) {
   const serialized = JSON.stringify(payload);
   return typeof serialized === "string" && serialized.length <= 1e5;
 }
-var notify_default;
+function parseDestinations(raw) {
+  if (raw === undefined) {
+    return;
+  }
+  const destinations = raw.split(",").map((entry) => entry.trim());
+  if (destinations.length > MAX_DESTINATION_COUNT || destinations.some((entry) => entry.length === 0)) {
+    return null;
+  }
+  const parsed = [];
+  for (const destination of destinations) {
+    const [providerInput, ...channelParts] = destination.split(":");
+    const provider = providerInput?.trim().toLowerCase();
+    const channelId = channelParts.join(":").trim();
+    if (!notificationProviderValues.includes(provider)) {
+      return null;
+    }
+    if (channelId.length > MAX_DESTINATION_CHANNEL_ID_LENGTH) {
+      return null;
+    }
+    parsed.push({
+      provider,
+      ...channelId.length > 0 ? { channelId } : {}
+    });
+  }
+  return parsed;
+}
+var MAX_DESTINATION_COUNT = 10, MAX_DESTINATION_CHANNEL_ID_LENGTH = 240, notify_default;
 var init_notify = __esm(() => {
   init_dist4();
   init_dist();
@@ -5174,14 +5460,16 @@ var init_notify = __esm(() => {
     meta: {
       name: "notify",
       description: [
-        "Send a Slack notification through Outlit.",
+        "Send a notification through Outlit to the organization's configured notifier.",
         "",
-        "Provide the payload as a positional argument or via --payload-file.",
-        "When both are provided, --payload-file takes precedence.",
+        "Use --markdown or --markdown-file for the human-readable body; Outlit renders it for the destination platform.",
+        "Add a JSON or raw payload when useful for structured context. When --destination is omitted, Outlit uses the default notifier.",
         "",
         "Examples:",
+        "  outlit notify --title 'Risk found' --markdown '**Risk found**\\n\\n- Customer: acme.com'",
         `  outlit notify --title 'Risk found' '{"customer":"acme.com"}'`,
         "  outlit notify --title 'Risk found' --payload-file ./payload.json",
+        "  outlit notify --title 'Escalation' --markdown '**Check this account**' --destination slack:C123",
         `  outlit notify --title 'Escalation' --severity HIGH --message 'Check this account' '{"customer":"acme.com"}'`,
         "",
         AGENT_JSON_HINT
@@ -5205,9 +5493,17 @@ var init_notify = __esm(() => {
         type: "string",
         description: "Path to a payload file to read (takes precedence over positional payload)"
       },
+      markdown: {
+        type: "string",
+        description: "Markdown body rendered for the destination platform."
+      },
+      "markdown-file": {
+        type: "string",
+        description: "Path to a markdown file to render for the destination platform."
+      },
       message: {
         type: "string",
-        description: "Optional Slack message"
+        description: "Optional summary message"
       },
       severity: {
         type: "string",
@@ -5220,6 +5516,10 @@ var init_notify = __esm(() => {
       subject: {
         type: "string",
         description: "Optional subject line"
+      },
+      destination: {
+        type: "string",
+        description: "Optional comma-separated destinations in provider[:channelId] form. Supported provider: slack"
       }
     },
     async run({ args }) {
@@ -5234,6 +5534,24 @@ var init_notify = __esm(() => {
           code: "invalid_input"
         }, json);
       }
+      let markdownInput = args.markdown;
+      if (args["markdown-file"]) {
+        try {
+          markdownInput = readFileSync5(args["markdown-file"], "utf-8");
+        } catch (err) {
+          return outputError({
+            message: `Cannot read markdown file: ${errorMessage(err, "unknown error")}`,
+            code: "file_error"
+          }, json);
+        }
+      }
+      const markdown = validateTrimmedText(markdownInput, 1e5);
+      if (markdown === null) {
+        return outputError({
+          message: "--markdown must be between 1 and 100000 characters after trimming",
+          code: "invalid_input"
+        }, json);
+      }
       const message = validateTrimmedText(args.message, 1200);
       if (message === null) {
         return outputError({
@@ -5266,6 +5584,13 @@ var init_notify = __esm(() => {
         }
         severity = normalized;
       }
+      const destinations = parseDestinations(args.destination);
+      if (destinations === null) {
+        return outputError({
+          message: `--destination must use provider[:channelId] with provider one of: ${notificationProviderValues.join(", ")}`,
+          code: "invalid_input"
+        }, json);
+      }
       let payloadInput;
       if (args["payload-file"]) {
         try {
@@ -5278,11 +5603,15 @@ var init_notify = __esm(() => {
         }
       } else if (typeof args.payload === "string" && args.payload.trim().length > 0) {
         payloadInput = args.payload;
-      } else {
-        return outputError({ message: "Provide a payload or --payload-file", code: "missing_input" }, json);
       }
-      const payload = parsePayload(payloadInput);
-      if (!payloadSizeIsValid(payload)) {
+      if (!payloadInput && markdown === undefined) {
+        return outputError({
+          message: "Provide --markdown, --markdown-file, a payload, or --payload-file",
+          code: "missing_input"
+        }, json);
+      }
+      const payload = payloadInput === undefined ? undefined : parsePayload(payloadInput);
+      if (payload !== undefined && !payloadSizeIsValid(payload)) {
         return outputError({
           message: "Payload must serialize to 100000 characters or fewer",
           code: "invalid_input"
@@ -5290,9 +5619,14 @@ var init_notify = __esm(() => {
       }
       const client = await getClientOrExit(args["api-key"], json);
       const params = {
-        title,
-        payload
+        title
       };
+      if (markdown !== undefined) {
+        params.markdown = markdown;
+      }
+      if (payload !== undefined) {
+        params.payload = payload;
+      }
       if (message !== undefined) {
         params.message = message;
       }
@@ -5305,6 +5639,9 @@ var init_notify = __esm(() => {
       if (subject !== undefined) {
         params.subject = subject;
       }
+      if (destinations !== undefined) {
+        params.destinations = destinations;
+      }
       return runTool(client, customerToolContracts.outlit_send_notification.toolName, params, json);
     }
   });
@@ -5463,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: [
@@ -5947,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)
@@ -6152,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;
@@ -6276,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.6.4",
+  "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.1.3",
+    "@outlit/tools": "^0.2.1",
     "citty": "^0.2.1"
   },
   "devDependencies": {