@outlit/cli 1.6.1 → 1.6.3

package/dist/cli.js

@@ -104,7 +104,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@outlit/cli",
-    version: "1.6.1",
+    version: "1.6.3",
     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.0",
+      "@outlit/tools": "^0.1.2",
       citty: "^0.2.1"
     },
     devDependencies: {
@@ -1493,6 +1493,12 @@ var init_signup = __esm(() => {
 function isCustomerToolName(value) {
   return customerToolNameSet.has(value);
 }
+function normalizeCustomerSourceType(value) {
+  if (customerSourceTypeSet.has(value)) {
+    return value;
+  }
+  return customerSourceTypeAliasMap.get(value) ?? null;
+}
 function resolveCustomerContextSearchInput(value) {
   if (!value.query) {
     return {
@@ -1539,6 +1545,14 @@ function resolveCustomerContextSearchInput(value) {
       message: "--after must be before or equal to --before"
     };
   }
+  const invalidSourceTypes = value.sourceTypes?.filter((sourceType) => !normalizeCustomerSourceType(sourceType)) ?? [];
+  if (invalidSourceTypes.length > 0) {
+    return {
+      ok: false,
+      message: `Unknown source types: ${invalidSourceTypes.join(", ")}. Allowed: ${customerSourceTypeInputs.join(", ")}`
+    };
+  }
+  const normalizedSourceTypes = value.sourceTypes ? Array.from(new Set(value.sourceTypes.map((sourceType) => normalizeCustomerSourceType(sourceType)))).filter((sourceType) => sourceType !== null) : undefined;
   return {
     ok: true,
     request: {
@@ -1547,7 +1561,7 @@ function resolveCustomerContextSearchInput(value) {
       topK: value.topK,
       after: value.after,
       before: value.before,
-      sourceTypes: value.sourceTypes
+      sourceTypes: normalizedSourceTypes
     }
   };
 }
@@ -1587,7 +1601,7 @@ function createOutlitClient(options) {
     }
   };
 }
-var customerToolNames, customerToolContracts, customerBillingStatuses, customerFactStatuses, customerFactTypes, unsupportedCustomerFactTypes, customerFactCategories, customerIncludeSections, customerSourceTypes, customerTimeframes, timelineChannels, timelineTimeframes, userJourneyStages, schemaTables, customerToolNameSet, iso8601UtcDateTimeRegex, DEFAULT_OUTLIT_API_URL = "https://app.outlit.ai", defaultAgentToolNames, sqlToolNames, analyticalAgentToolNames;
+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 init_dist4 = __esm(() => {
   customerToolNames = [
     "outlit_list_customers",
@@ -1599,7 +1613,25 @@ var init_dist4 = __esm(() => {
     "outlit_get_source",
     "outlit_search_customer_context",
     "outlit_query",
-    "outlit_schema"
+    "outlit_schema",
+    "outlit_send_notification"
+  ];
+  customerSourceTypes = [
+    "EMAIL",
+    "CALL",
+    "CALENDAR_EVENT",
+    "SUPPORT_TICKET",
+    "OPPORTUNITY"
+  ];
+  customerSourceTypeAliases = ["CRM", "CRM_OPPORTUNITY"];
+  customerSourceTypeInputs = [
+    "EMAIL",
+    "CALL",
+    "CALENDAR_EVENT",
+    "SUPPORT_TICKET",
+    "OPPORTUNITY",
+    "CRM",
+    "CRM_OPPORTUNITY"
   ];
   customerToolContracts = {
     outlit_list_customers: {
@@ -1811,11 +1843,21 @@ var init_dist4 = __esm(() => {
             description: "Customer ID or domain"
           },
           channels: {
-            description: "Filter by event channel (e.g., EMAIL, SLACK, CALL)",
+            description: "Filter by event channel (e.g., EMAIL, SLACK, CALL, CALENDAR)",
             type: "array",
             items: {
               type: "string",
-              enum: ["SDK", "EMAIL", "SLACK", "CALL", "CRM", "BILLING", "SUPPORT", "INTERNAL"]
+              enum: [
+                "SDK",
+                "EMAIL",
+                "SLACK",
+                "CALL",
+                "CALENDAR",
+                "CRM",
+                "BILLING",
+                "SUPPORT",
+                "INTERNAL"
+              ]
             }
           },
           eventTypes: {
@@ -1882,7 +1924,7 @@ var init_dist4 = __esm(() => {
             type: "array",
             items: {
               type: "string",
-              enum: ["EMAIL", "CALL", "CALENDAR_EVENT", "SUPPORT_TICKET"]
+              enum: customerSourceTypeInputs
             }
           },
           factTypes: {
@@ -1983,7 +2025,7 @@ var init_dist4 = __esm(() => {
         properties: {
           sourceType: {
             type: "string",
-            enum: ["EMAIL", "CALL", "CALENDAR_EVENT", "SUPPORT_TICKET"]
+            enum: customerSourceTypeInputs
           },
           sourceId: {
             type: "string",
@@ -2044,7 +2086,7 @@ var init_dist4 = __esm(() => {
             type: "array",
             items: {
               type: "string",
-              enum: ["EMAIL", "CALL", "CALENDAR_EVENT", "SUPPORT_TICKET"]
+              enum: customerSourceTypeInputs
             }
           }
         },
@@ -2054,21 +2096,22 @@ var init_dist4 = __esm(() => {
     },
     outlit_query: {
       toolName: "outlit_query",
-      description: `Execute raw SQL queries against your analytics data.
+      description: `Execute read-only SQL queries against your analytics views.
 
-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, ...)
+Available views:
+- activity: Customer activity events (event_name, event_type, event_channel, customer_id, occurred_at, properties, ...)
+- customers: Customer attributes (customer_id, domain, name, billing_status, plan, mrr_cents, traits, ...)
+- users: User attributes (user_id, email, name, customer_id, traits, ...)
+- revenue: 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.
+Properties and traits are JSON strings; inspect schemas and examples before filtering nested values.
 
 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`,
+- SELECT event_name, count(*) FROM activity GROUP BY 1 ORDER BY 2 DESC LIMIT 10
+- SELECT billing_status, sum(mrr_cents)/100 as mrr FROM customers GROUP BY 1
+- SELECT * FROM activity WHERE customer_id = 'cust_123' ORDER BY occurred_at DESC LIMIT 50`,
       inputSchema: {
         $schema: "https://json-schema.org/draft/2020-12/schema",
         type: "object",
@@ -2080,7 +2123,8 @@ Example queries:
           limit: {
             description: "Max rows to return (default 1000, max 10000)",
             default: 1000,
-            type: "number",
+            type: "integer",
+            minimum: 1,
             maximum: 1e4
           }
         },
@@ -2090,22 +2134,129 @@ Example queries:
     },
     outlit_schema: {
       toolName: "outlit_schema",
-      description: `Get table schemas for available analytics tables.
+      description: `Get schemas for available analytics views.
 
 Use this to discover column names, types, and descriptions before writing SQL queries.
-Returns column definitions and example queries for each table.`,
+Returns column definitions and example queries for each view.`,
       inputSchema: {
         $schema: "https://json-schema.org/draft/2020-12/schema",
         type: "object",
         properties: {
           table: {
-            description: "Specific table to describe, or omit for all tables",
+            description: "Specific analytics view to describe. Omit to list all views.",
             type: "string",
-            enum: ["events", "customer_dimensions", "user_dimensions", "mrr_snapshots"]
+            enum: ["activity", "customers", "users", "revenue"]
           }
         },
         additionalProperties: false
       }
+    },
+    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.",
+      inputSchema: {
+        $schema: "https://json-schema.org/draft/2020-12/schema",
+        type: "object",
+        properties: {
+          title: {
+            type: "string",
+            minLength: 1,
+            maxLength: 160,
+            description: "Notification title"
+          },
+          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"
+                }
+              }
+            ],
+            $ref: "#/$defs/__schema0"
+          },
+          message: {
+            description: "Optional Slack message",
+            type: "string",
+            minLength: 1,
+            maxLength: 1200
+          },
+          severity: {
+            description: "Optional notification severity",
+            type: "string",
+            enum: ["low", "medium", "high"]
+          },
+          source: {
+            description: "Optional source label",
+            type: "string",
+            minLength: 1,
+            maxLength: 120
+          },
+          subject: {
+            description: "Optional subject line",
+            type: "string",
+            minLength: 1,
+            maxLength: 240
+          }
+        },
+        required: ["title", "payload"],
+        additionalProperties: false,
+        $defs: {
+          __schema0: {
+            anyOf: [
+              {
+                type: "string"
+              },
+              {
+                type: "number"
+              },
+              {
+                type: "boolean"
+              },
+              {
+                type: "null"
+              },
+              {
+                type: "array",
+                items: {
+                  $ref: "#/$defs/__schema0"
+                }
+              },
+              {
+                type: "object",
+                propertyNames: {
+                  type: "string"
+                },
+                additionalProperties: {
+                  $ref: "#/$defs/__schema0"
+                }
+              }
+            ]
+          }
+        }
+      }
     }
   };
   customerBillingStatuses = [
@@ -2160,13 +2311,14 @@ Returns column definitions and example queries for each table.`,
     "recentTimeline",
     "behaviorMetrics"
   ];
-  customerSourceTypes = ["EMAIL", "CALL", "CALENDAR_EVENT", "SUPPORT_TICKET"];
   customerTimeframes = ["7d", "14d", "30d", "90d"];
+  notificationSeverityValues = ["low", "medium", "high"];
   timelineChannels = [
     "SDK",
     "EMAIL",
     "SLACK",
     "CALL",
+    "CALENDAR",
     "CRM",
     "BILLING",
     "SUPPORT",
@@ -2180,14 +2332,16 @@ Returns column definitions and example queries for each table.`,
     "ENGAGED",
     "INACTIVE"
   ];
-  schemaTables = [
-    "events",
-    "customer_dimensions",
-    "user_dimensions",
-    "mrr_snapshots"
-  ];
   customerToolNameSet = new Set(customerToolNames);
+  customerSourceTypeSet = new Set(customerSourceTypes);
+  customerSourceTypeAliasMap = /* @__PURE__ */ new Map([
+    ["CRM", "OPPORTUNITY"],
+    ["CRM_OPPORTUNITY", "OPPORTUNITY"]
+  ]);
   iso8601UtcDateTimeRegex = /^(?:(?:\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))$/;
+  actionToolNames = [
+    "outlit_send_notification"
+  ];
   defaultAgentToolNames = [
     "outlit_list_customers",
     "outlit_list_users",
@@ -2196,7 +2350,8 @@ Returns column definitions and example queries for each table.`,
     "outlit_list_facts",
     "outlit_get_fact",
     "outlit_get_source",
-    "outlit_search_customer_context"
+    "outlit_search_customer_context",
+    ...actionToolNames
   ];
   sqlToolNames = [
     "outlit_schema",
@@ -4371,7 +4526,12 @@ function invalidValues(values, allowed) {
     return [];
   return values.filter((value) => !allowed.includes(value));
 }
-var list_default3;
+function normalizeSourceTypes(values) {
+  if (!values)
+    return;
+  return Array.from(new Set(values.map((value) => normalizeCustomerSourceType(value)))).filter((sourceType) => sourceType !== null);
+}
+var sourceTypeDescription, list_default3;
 var init_list3 = __esm(() => {
   init_dist4();
   init_dist();
@@ -4381,6 +4541,7 @@ var init_list3 = __esm(() => {
   init_api();
   init_config();
   init_output();
+  sourceTypeDescription = `${customerSourceTypes.join(", ")} (aliases: ${customerSourceTypeAliases.join(", ")})`;
   list_default3 = defineCommand2({
     meta: {
       name: "list",
@@ -4393,11 +4554,11 @@ var init_list3 = __esm(() => {
         "  outlit facts list acme.com",
         "  outlit facts list acme.com --status ACTIVE",
         "  outlit facts list acme.com --fact-types CHURN_RISK,EXPANSION",
-        "  outlit facts list acme.com --source-types CALL,EMAIL --after 2025-01-01T00:00:00Z",
+        "  outlit facts list acme.com --source-types CALL,OPPORTUNITY --after 2025-01-01T00:00:00Z",
         "  outlit facts list acme.com --limit 50 --json",
         "",
         `Statuses: ${customerFactStatuses.join(", ")}`,
-        `Source types: ${customerSourceTypes.join(", ")}`,
+        `Source types: ${sourceTypeDescription}`,
         `Fact categories: ${customerFactCategories.join(", ")}`,
         "",
         AGENT_JSON_HINT
@@ -4419,7 +4580,7 @@ var init_list3 = __esm(() => {
       },
       "source-types": {
         type: "string",
-        description: `Comma-separated generic source type filter (${customerSourceTypes.join(", ")})`
+        description: `Comma-separated generic source type filter (${sourceTypeDescription})`
       },
       "fact-types": {
         type: "string",
@@ -4451,13 +4612,14 @@ var init_list3 = __esm(() => {
           code: "invalid_input"
         }, json);
       }
-      const invalidSourceTypes = invalidValues(sourceTypes, customerSourceTypes);
+      const invalidSourceTypes = sourceTypes?.filter((value) => !normalizeCustomerSourceType(value)) ?? [];
       if (invalidSourceTypes.length > 0) {
         return outputError({
-          message: `Unknown source types: ${invalidSourceTypes.join(", ")}. Allowed: ${customerSourceTypes.join(", ")}`,
+          message: `Unknown source types: ${invalidSourceTypes.join(", ")}. Allowed: ${customerSourceTypeInputs.join(", ")}`,
           code: "invalid_input"
         }, json);
       }
+      const normalizedSourceTypes = normalizeSourceTypes(sourceTypes);
       const invalidFactTypes = invalidValues(factTypes, customerFactTypes);
       if (invalidFactTypes.length > 0) {
         const anomalyFactTypes = invalidFactTypes.filter((value) => unsupportedCustomerFactTypes.includes(value));
@@ -4507,8 +4669,8 @@ var init_list3 = __esm(() => {
       };
       if (statuses)
         params.status = statuses;
-      if (sourceTypes)
-        params.sourceTypes = sourceTypes;
+      if (normalizedSourceTypes)
+        params.sourceTypes = normalizedSourceTypes;
       if (factTypes)
         params.factTypes = factTypes;
       if (factCategories)
@@ -4620,7 +4782,7 @@ var exports_get3 = {};
 __export(exports_get3, {
   default: () => get_default3
 });
-var get_default3;
+var sourceTypeDescription2, get_default3;
 var init_get3 = __esm(() => {
   init_dist4();
   init_dist();
@@ -4628,6 +4790,7 @@ var init_get3 = __esm(() => {
   init_output2();
   init_api();
   init_output();
+  sourceTypeDescription2 = `${customerSourceTypes.join(", ")} (aliases: ${customerSourceTypeAliases.join(", ")})`;
   get_default3 = defineCommand2({
     meta: {
       name: "get",
@@ -4636,9 +4799,10 @@ var init_get3 = __esm(() => {
         "",
         "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: ${customerSourceTypes.join(", ")}`,
+        `Source types: ${sourceTypeDescription2}`,
         "",
         AGENT_JSON_HINT
       ].join(`
@@ -4649,7 +4813,7 @@ var init_get3 = __esm(() => {
       ...outputArgs,
       "source-type": {
         type: "string",
-        description: "Canonical source type",
+        description: `Source type (${sourceTypeDescription2})`,
         required: true
       },
       "source-id": {
@@ -4660,15 +4824,16 @@ var init_get3 = __esm(() => {
     },
     async run({ args }) {
       const json = !!args.json;
-      if (!customerSourceTypes.includes(args["source-type"])) {
+      const sourceType = normalizeCustomerSourceType(args["source-type"]);
+      if (!sourceType) {
         return outputError({
-          message: `--source-type must be one of ${customerSourceTypes.join(", ")}`,
+          message: `--source-type must be one of ${customerSourceTypeInputs.join(", ")}`,
           code: "invalid_input"
         }, json);
       }
       const client = await getClientOrExit(args["api-key"], json);
       return runTool(client, customerToolContracts.outlit_get_source.toolName, {
-        sourceType: args["source-type"],
+        sourceType,
         sourceId: args["source-id"]
       }, json);
     }
@@ -4708,7 +4873,7 @@ var exports_search = {};
 __export(exports_search, {
   default: () => search_default
 });
-var search_default;
+var sourceTypeDescription3, search_default;
 var init_search = __esm(() => {
   init_dist4();
   init_dist();
@@ -4717,6 +4882,7 @@ var init_search = __esm(() => {
   init_api();
   init_config();
   init_output();
+  sourceTypeDescription3 = `${customerSourceTypes.join(", ")} (aliases: ${customerSourceTypeAliases.join(", ")})`;
   search_default = defineCommand2({
     meta: {
       name: "search",
@@ -4731,7 +4897,7 @@ var init_search = __esm(() => {
         "  outlit search 'churn risk signals' --customer acme.com",
         "  outlit search 'expansion opportunities' --top-k 50 --json",
         "  outlit search 'support escalations' --after 2025-01-01T00:00:00Z --before 2025-03-31T23:59:59Z",
-        "  outlit search 'onboarding issues' --source-types CALL,EMAIL",
+        "  outlit search 'renewal opportunities' --source-types CALL,OPPORTUNITY",
         "",
         AGENT_JSON_HINT
       ].join(`
@@ -4763,7 +4929,7 @@ var init_search = __esm(() => {
       },
       "source-types": {
         type: "string",
-        description: `Comma-separated generic source type filter (${customerSourceTypes.join(", ")})`
+        description: `Comma-separated generic source type filter (${sourceTypeDescription3})`
       }
     },
     async run({ args }) {
@@ -4773,13 +4939,6 @@ var init_search = __esm(() => {
         return outputError({ message: "--top-k must be an integer between 1 and 50", code: "invalid_input" }, json);
       }
       const sourceTypes = args["source-types"] ? splitCsv(args["source-types"]).map((item) => item.trim()).filter(Boolean) : undefined;
-      const invalidSourceTypes = sourceTypes?.filter((value) => !customerSourceTypes.includes(value));
-      if (invalidSourceTypes && invalidSourceTypes.length > 0) {
-        return outputError({
-          message: `Unknown source types: ${invalidSourceTypes.join(", ")}. Allowed: ${customerSourceTypes.join(", ")}`,
-          code: "invalid_input"
-        }, json);
-      }
       const resolved = resolveCustomerContextSearchInput({
         query: args.query,
         customer: args.customer,
@@ -4806,7 +4965,7 @@ __export(exports_sql, {
   default: () => sql_default
 });
 import { readFileSync as readFileSync4 } from "node:fs";
-var sql_default;
+var publicSqlViews, sql_default;
 var init_sql = __esm(() => {
   init_dist4();
   init_dist();
@@ -4814,21 +4973,22 @@ var init_sql = __esm(() => {
   init_output2();
   init_api();
   init_output();
+  publicSqlViews = ["activity", "customers", "users", "revenue"];
   sql_default = defineCommand2({
     meta: {
       name: "sql",
       description: [
-        "Run a SQL query against Outlit's analytics database.",
+        "Run a SQL query against Outlit analytics views.",
         "",
         "Provide the query as a positional argument or via --query-file.",
         "When both are provided, --query-file takes precedence.",
         "",
-        `Available tables: ${schemaTables.join(", ")}`,
+        `Available views: ${publicSqlViews.join(", ")}`,
         "",
         "Examples:",
-        "  outlit sql 'SELECT * FROM events LIMIT 10'",
+        "  outlit sql 'SELECT * FROM activity LIMIT 10'",
         "  outlit sql --query-file ./my-query.sql",
-        "  outlit sql 'SELECT count(*) FROM events' --limit 1 --json",
+        "  outlit sql 'SELECT count(*) FROM activity' --limit 1 --json",
         "",
         AGENT_JSON_HINT
       ].join(`
@@ -4871,41 +5031,221 @@ var init_sql = __esm(() => {
         return outputError({ message: "Provide a SQL query or --query-file", code: "missing_input" }, json);
       }
       const limit = Number(args.limit);
-      if (!Number.isFinite(limit) || limit <= 0) {
-        return outputError({ message: "--limit must be a positive number", code: "invalid_input" }, json);
+      if (!Number.isInteger(limit) || limit < 1 || limit > 1e4) {
+        return outputError({ message: "--limit must be an integer between 1 and 10000", code: "invalid_input" }, json);
       }
       return runTool(client, customerToolContracts.outlit_query.toolName, { sql, limit }, json);
     }
   });
 });
 
+// src/commands/notify.ts
+var exports_notify = {};
+__export(exports_notify, {
+  default: () => notify_default
+});
+import { readFileSync as readFileSync5 } from "node:fs";
+function parsePayload(raw) {
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return raw;
+  }
+}
+function validateTrimmedText(value, maxLength) {
+  if (value === undefined) {
+    return;
+  }
+  const trimmed = value.trim();
+  if (trimmed.length === 0 || trimmed.length > maxLength) {
+    return null;
+  }
+  return trimmed;
+}
+function normalizeSeverity(severity) {
+  const normalized = severity.trim().toLowerCase();
+  return notificationSeverityValues.includes(normalized) ? normalized : null;
+}
+function payloadSizeIsValid(payload) {
+  const serialized = JSON.stringify(payload);
+  return typeof serialized === "string" && serialized.length <= 1e5;
+}
+var notify_default;
+var init_notify = __esm(() => {
+  init_dist4();
+  init_dist();
+  init_auth();
+  init_output2();
+  init_api();
+  init_output();
+  notify_default = defineCommand2({
+    meta: {
+      name: "notify",
+      description: [
+        "Send a Slack notification through Outlit.",
+        "",
+        "Provide the payload as a positional argument or via --payload-file.",
+        "When both are provided, --payload-file takes precedence.",
+        "",
+        "Examples:",
+        `  outlit notify --title 'Risk found' '{"customer":"acme.com"}'`,
+        "  outlit notify --title 'Risk found' --payload-file ./payload.json",
+        `  outlit notify --title 'Escalation' --severity HIGH --message 'Check this account' '{"customer":"acme.com"}'`,
+        "",
+        AGENT_JSON_HINT
+      ].join(`
+`)
+    },
+    args: {
+      ...authArgs,
+      ...outputArgs,
+      title: {
+        type: "string",
+        description: "Notification title",
+        required: false
+      },
+      payload: {
+        type: "positional",
+        description: "Notification payload as JSON or raw string",
+        required: false
+      },
+      "payload-file": {
+        type: "string",
+        description: "Path to a payload file to read (takes precedence over positional payload)"
+      },
+      message: {
+        type: "string",
+        description: "Optional Slack message"
+      },
+      severity: {
+        type: "string",
+        description: `Optional notification severity (${notificationSeverityValues.join(", ")})`
+      },
+      source: {
+        type: "string",
+        description: "Optional source label"
+      },
+      subject: {
+        type: "string",
+        description: "Optional subject line"
+      }
+    },
+    async run({ args }) {
+      const json = !!args.json;
+      const title = args.title?.trim();
+      if (!title) {
+        return outputError({ message: "Provide --title", code: "missing_input" }, json);
+      }
+      if (title.length > 160) {
+        return outputError({
+          message: "--title must be 160 characters or fewer after trimming",
+          code: "invalid_input"
+        }, json);
+      }
+      const message = validateTrimmedText(args.message, 1200);
+      if (message === null) {
+        return outputError({
+          message: "--message must be between 1 and 1200 characters after trimming",
+          code: "invalid_input"
+        }, json);
+      }
+      const source = validateTrimmedText(args.source, 120);
+      if (source === null) {
+        return outputError({
+          message: "--source must be between 1 and 120 characters after trimming",
+          code: "invalid_input"
+        }, json);
+      }
+      const subject = validateTrimmedText(args.subject, 240);
+      if (subject === null) {
+        return outputError({
+          message: "--subject must be between 1 and 240 characters after trimming",
+          code: "invalid_input"
+        }, json);
+      }
+      let severity;
+      if (args.severity) {
+        const normalized = normalizeSeverity(args.severity);
+        if (!normalized) {
+          return outputError({
+            message: `--severity must be one of: ${notificationSeverityValues.join(", ")}`,
+            code: "invalid_input"
+          }, json);
+        }
+        severity = normalized;
+      }
+      let payloadInput;
+      if (args["payload-file"]) {
+        try {
+          payloadInput = readFileSync5(args["payload-file"], "utf-8");
+        } catch (err) {
+          return outputError({
+            message: `Cannot read file: ${errorMessage(err, "unknown error")}`,
+            code: "file_error"
+          }, json);
+        }
+      } 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)) {
+        return outputError({
+          message: "Payload must serialize to 100000 characters or fewer",
+          code: "invalid_input"
+        }, json);
+      }
+      const client = await getClientOrExit(args["api-key"], json);
+      const params = {
+        title,
+        payload
+      };
+      if (message !== undefined) {
+        params.message = message;
+      }
+      if (severity) {
+        params.severity = severity;
+      }
+      if (source !== undefined) {
+        params.source = source;
+      }
+      if (subject !== undefined) {
+        params.subject = subject;
+      }
+      return runTool(client, customerToolContracts.outlit_send_notification.toolName, params, json);
+    }
+  });
+});
+
 // src/commands/schema.ts
 var exports_schema = {};
 __export(exports_schema, {
   default: () => schema_default
 });
-var schema_default;
+var publicSqlViews2, schema_default;
 var init_schema = __esm(() => {
   init_dist4();
   init_dist();
   init_auth();
   init_output2();
   init_api();
+  publicSqlViews2 = ["activity", "customers", "users", "revenue"];
   schema_default = defineCommand2({
     meta: {
       name: "schema",
       description: [
-        "Describe the analytics database schema.",
+        "Describe the available analytics views.",
         "",
-        "Without a table name, returns the full schema for all tables.",
-        "With a table name, returns detailed column info for that table.",
+        "Without a view name, returns the full schema for all views.",
+        "With a view name, returns detailed column info for that view.",
         "",
-        `Available tables: ${schemaTables.join(", ")}`,
+        `Available views: ${publicSqlViews2.join(", ")}`,
         "",
         "Examples:",
         "  outlit schema",
-        "  outlit schema events",
-        "  outlit schema customer_dimensions --json",
+        "  outlit schema activity",
+        "  outlit schema customers --json",
         "",
         AGENT_JSON_HINT
       ].join(`
@@ -4914,9 +5254,9 @@ var init_schema = __esm(() => {
     args: {
       ...authArgs,
       ...outputArgs,
-      table: {
+      view: {
         type: "positional",
-        description: `Table to describe (${schemaTables.join(", ")}). Optional.`,
+        description: `View to describe (${publicSqlViews2.join(", ")}). Optional.`,
         required: false
       }
     },
@@ -4924,8 +5264,9 @@ var init_schema = __esm(() => {
       const json = !!args.json;
       const client = await getClientOrExit(args["api-key"], json);
       const params = {};
-      if (args.table)
-        params.table = args.table;
+      const view = args.view ?? args.table;
+      if (view)
+        params.table = view;
       return runTool(client, customerToolContracts.outlit_schema.toolName, params, json);
     }
   });
@@ -5822,7 +6163,7 @@ var init_completions = __esm(() => {
           desc: "Get one exact source record",
           flags: [
             ...COMMON,
-            { name: "--source-type", desc: "Canonical source type" },
+            { name: "--source-type", desc: "Source type" },
             { name: "--source-id", desc: "Exact source ID" }
           ]
         }
@@ -5849,7 +6190,7 @@ var init_completions = __esm(() => {
         { name: "--limit", desc: "Max rows to return" }
       ]
     },
-    { name: "schema", desc: "Discover table schemas", flags: [...COMMON] },
+    { name: "schema", desc: "Discover analytics view schemas", flags: [...COMMON] },
     {
       name: "integrations",
       desc: "Manage platform integrations",
@@ -6673,10 +7014,11 @@ Usage examples:
   outlit users list --journey-stage CHAMPION
   outlit facts list acme.com --fact-types CHURN_RISK,EXPANSION
   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 sources get --source-type OPPORTUNITY --source-id opp_123
+  outlit search 'pricing objections last quarter' --source-types CALL,OPPORTUNITY
+  outlit sql 'SELECT * FROM activity LIMIT 10'
+  outlit notify --title 'Risk found' '{"customer":"acme.com"}'
+  outlit schema activity
   outlit doctor --json
 
 For AI agents: commands auto-output JSON when stdout is piped. No --json flag needed.`
@@ -6691,6 +7033,7 @@ For AI agents: commands auto-output JSON when stdout is piped. No --json flag ne
       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),
+      notify: () => Promise.resolve().then(() => (init_notify(), exports_notify)).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),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@outlit/cli",
-  "version": "1.6.1",
+  "version": "1.6.3",
   "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.0",
+    "@outlit/tools": "^0.1.2",
     "citty": "^0.2.1"
   },
   "devDependencies": {